diff --git a/.gitattributes b/.gitattributes index d0f6ad06464..d44a1f75076 100644 --- a/.gitattributes +++ b/.gitattributes @@ -51,6 +51,8 @@ tests/roots/test-pycode/cp_1251_coded.py dos # Non UTF-8 encodings tests/roots/test-pycode/cp_1251_coded.py working-tree-encoding=windows-1251 +tests/roots/test-root/wrongenc.inc working-tree-encoding=iso-8859 +tests/roots/test-warnings/wrongenc.inc working-tree-encoding=iso-8859 # Generated files # https://github.com/github/linguist/blob/master/docs/overrides.md @@ -62,4 +64,5 @@ tests/roots/test-pycode/cp_1251_coded.py working-tree-encoding=windows-1251 tests/js/fixtures/**/*.js generated sphinx/search/minified-js/*.js generated +sphinx/search/_stopwords/ generated sphinx/themes/bizstyle/static/css3-mediaqueries.js generated diff --git a/.github/dependabot.yml b/.github/dependabot.yml index 47a31bc9d65..acd0c7a6cff 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -8,3 +8,11 @@ updates: directory: "/" schedule: interval: "daily" + - package-ecosystem: "uv" + directory: "/" + schedule: + interval: "daily" + groups: + all-dependencies: + patterns: + - "*" diff --git a/.github/workflows/builddoc.yml b/.github/workflows/builddoc.yml index 7f8471deecb..e709d3dbb26 100644 --- a/.github/workflows/builddoc.yml +++ b/.github/workflows/builddoc.yml @@ -21,22 +21,22 @@ jobs: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Install graphviz run: sudo apt-get install --no-install-recommends --yes graphviz - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install .[docs] + run: uv pip install . --group docs - name: Render the documentation run: > sphinx-build diff --git a/.github/workflows/create-release.yml b/.github/workflows/create-release.yml index 6f3ebf264a8..0c6bdbefbcd 100644 --- a/.github/workflows/create-release.yml +++ b/.github/workflows/create-release.yml @@ -27,31 +27,27 @@ jobs: attestations: write # for actions/attest id-token: write # for actions/attest & PyPI trusted publishing steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install build dependencies (pypa/build, twine) - run: | - uv pip install build "twine>=5.1" - # resolution fails without betterproto - uv pip install pypi-attestations==0.0.21 betterproto==2.0.0b6 + run: uv pip install --group package - name: Build distribution run: python -m build - name: Check distribution - run: | - twine check dist/* + run: twine check dist/* - name: Create Sigstore attestations for built distributions uses: actions/attest@v1 @@ -85,44 +81,15 @@ jobs: BUNDLE_PATH: "${{ steps.attest.outputs.bundle-path }}" - name: Upload attestation bundles - uses: actions/upload-artifact@v4 + uses: actions/upload-artifact@v6 with: name: attestation-bundles path: /tmp/attestation-bundles/ - - name: Mint PyPI API token - id: mint-token - uses: actions/github-script@v7 - with: - # language=JavaScript - script: | - // retrieve the ambient OIDC token - const oidc_request_token = process.env.ACTIONS_ID_TOKEN_REQUEST_TOKEN; - const oidc_request_url = process.env.ACTIONS_ID_TOKEN_REQUEST_URL; - const oidc_resp = await fetch(`${oidc_request_url}&audience=pypi`, { - headers: {Authorization: `bearer ${oidc_request_token}`}, - }); - const oidc_token = (await oidc_resp.json()).value; - - // exchange the OIDC token for an API token - const mint_resp = await fetch('https://pypi.org/_/oidc/github/mint-token', { - method: 'post', - body: `{"token": "${oidc_token}"}` , - headers: {'Content-Type': 'application/json'}, - }); - const api_token = (await mint_resp.json()).token; - - // mask the newly minted API token, so that we don't accidentally leak it - core.setSecret(api_token) - core.setOutput('api-token', api_token) - - name: Upload to PyPI env: TWINE_NON_INTERACTIVE: "true" - TWINE_USERNAME: "__token__" - TWINE_PASSWORD: "${{ steps.mint-token.outputs.api-token }}" - run: | - twine upload dist/* --attestations + run: twine upload dist/* --attestations github-release: runs-on: ubuntu-latest @@ -130,20 +97,18 @@ jobs: environment: release if: github.repository_owner == 'sphinx-doc' permissions: - contents: write # for softprops/action-gh-release to create GitHub release + contents: write # needed to create a GitHub release steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - - name: Get release version - id: get_version - uses: actions/github-script@v7 - with: - script: core.setOutput('version', context.ref.replace("refs/tags/v", "")) - name: Create GitHub release - uses: softprops/action-gh-release@v2 if: startsWith(github.ref, 'refs/tags/') - with: - name: "Sphinx ${{ steps.get_version.outputs.version }}" - body: "Changelog: https://www.sphinx-doc.org/en/master/changes.html" + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + TAG: ${{ github.ref_name }} + run: >- + gh release create "${TAG}" + --title "Sphinx ${TAG#v}" + --notes "Changelog: https://www.sphinx-doc.org/en/master/changes.html" diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml index a3b5cf7ae52..7a073f7f39e 100644 --- a/.github/workflows/lint.yml +++ b/.github/workflows/lint.yml @@ -23,7 +23,7 @@ jobs: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false @@ -42,20 +42,20 @@ jobs: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install ".[lint,test]" + run: uv pip install -r pyproject.toml --group package --group test --group types - name: Type check with mypy run: mypy @@ -63,41 +63,63 @@ jobs: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install ".[lint,test]" + run: uv pip install -r pyproject.toml --group package --group test --group types - name: Type check with pyright run: pyright + ty: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v6 + with: + persist-credentials: false + - name: Set up Python + uses: actions/setup-python@v6 + with: + python-version: "3" + - name: Install uv + uses: astral-sh/setup-uv@v7 + with: + version: latest + enable-cache: false + - name: Install dependencies + run: uv pip install -r pyproject.toml --group package --group test --group types + - run: echo "$(which python)" + - name: Type check with ty + run: ty check --color=always --python="$(which python)" + docs-lint: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install --upgrade sphinx-lint + run: uv pip install --group lint - name: Lint documentation with sphinx-lint run: make doclinter @@ -105,21 +127,39 @@ jobs: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install --upgrade twine build + run: uv pip install --group package - name: Lint with twine run: | python -m build . twine check dist/* + + prettier: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v6 + - name: Set up Node.js + uses: actions/setup-node@v6 + with: + node-version: "20" + cache: "npm" + - run: > + npx prettier@3.5 + --check + "sphinx/themes/**/*.js" + "!sphinx/themes/bizstyle/static/css3-mediaqueries*.js" + "tests/js/**/*.{js,mjs}" + "!tests/js/fixtures/**" diff --git a/.github/workflows/lock.yml b/.github/workflows/lock.yml index e9d58e4896a..04831b72dcc 100644 --- a/.github/workflows/lock.yml +++ b/.github/workflows/lock.yml @@ -15,7 +15,7 @@ jobs: issues: write pull-requests: write steps: - - uses: actions/github-script@v7 + - uses: actions/github-script@v8 with: retries: 3 # language=JavaScript diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 1758254c633..235f44ced16 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -4,11 +4,13 @@ on: push: paths: - ".github/workflows/main.yml" + - ".pytest.toml" - "sphinx/**" - "tests/**" pull_request: paths: - ".github/workflows/main.yml" + - ".pytest.toml" - "sphinx/**" - "tests/**" @@ -34,19 +36,21 @@ jobs: fail-fast: false matrix: python: - - "3.11" - "3.12" - "3.13" + - "3.13t" + - "3.14" + - "3.14t" docutils: - - "0.20" - "0.21" + - "0.22" # include: # # test every supported Docutils version for the latest supported Python -# - python: "3.13" -# docutils: "0.20" +# - python: "3.14" +# docutils: "0.21" steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Mount the test roots as read-only @@ -54,7 +58,7 @@ jobs: mkdir -p ./tests/roots-read-only sudo mount -v --bind --read-only ./tests/roots ./tests/roots-read-only - name: Set up Python ${{ matrix.python }} - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: ${{ matrix.python }} - name: Check Python version @@ -62,14 +66,18 @@ jobs: - name: Install graphviz run: sudo apt-get install --no-install-recommends --yes graphviz - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install .[test] + run: uv pip install . --group test + env: + UV_PYTHON: "python${{ matrix.python }}" - name: Install Docutils ${{ matrix.docutils }} run: uv pip install --upgrade "docutils~=${{ matrix.docutils }}.0" + env: + UV_PYTHON: "python${{ matrix.python }}" - name: Test with pytest run: python -m pytest -n logical --dist=worksteal -vv --durations 25 env: @@ -83,13 +91,13 @@ jobs: fail-fast: false matrix: python: - - "3.14" + - "3.15" docutils: - - "0.20" - "0.21" + - "0.22" steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python ${{ matrix.python }} (deadsnakes) @@ -103,7 +111,7 @@ jobs: - name: Install dependencies run: | python -m pip install --upgrade pip - python -m pip install .[test] + python -m pip install . --group test - name: Install Docutils ${{ matrix.docutils }} run: python -m pip install --upgrade "docutils~=${{ matrix.docutils }}.0" - name: Test with pytest @@ -111,38 +119,6 @@ jobs: env: PYTHONWARNINGS: "error" # treat all warnings as errors - free-threaded: - runs-on: ubuntu-latest - name: Python ${{ matrix.python }} (free-threaded) - timeout-minutes: 15 - strategy: - fail-fast: false - matrix: - python: - - "3.13" - - steps: - - uses: actions/checkout@v4 - with: - persist-credentials: false - - name: Set up Python ${{ matrix.python }} (deadsnakes) - uses: deadsnakes/action@v3.2.0 - with: - python-version: ${{ matrix.python }} - nogil: true - - name: Check Python version - run: python --version --version - - name: Install graphviz - run: sudo apt-get install --no-install-recommends --yes graphviz - - name: Install dependencies - run: | - python -m pip install --upgrade pip - python -m pip install .[test] - - name: Test with pytest - run: python -m pytest -n logical --dist=worksteal -vv --durations 25 - env: - PYTHONWARNINGS: "error" # treat all warnings as errors - deadsnakes-free-threaded: runs-on: ubuntu-latest name: Python ${{ matrix.python }} (free-threaded) @@ -151,10 +127,10 @@ jobs: fail-fast: false matrix: python: - - "3.14" + - "3.15" steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python ${{ matrix.python }} (deadsnakes) @@ -169,7 +145,7 @@ jobs: - name: Install dependencies run: | python -m pip install --upgrade pip - python -m pip install .[test] + python -m pip install . --group test - name: Test with pytest run: python -m pytest -n logical --dist=worksteal -vv --durations 25 env: @@ -181,11 +157,19 @@ jobs: timeout-minutes: 15 steps: - - uses: actions/checkout@v4 + # https://github.com/actions/runner-images/issues/8755 + # On standard runners, the D: drive is much faster. + - name: Set %TMP% and %TEMP% to D:\\Temp + run: | + mkdir "D:\\Tmp" + echo "TMP=D:\\Tmp" >> $env:GITHUB_ENV + echo "TEMP=D:\\Tmp" >> $env:GITHUB_ENV + + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Check Python version @@ -193,12 +177,12 @@ jobs: - name: Install graphviz run: choco install --no-progress graphviz - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install .[test] + run: uv pip install . --group test - name: Test with pytest run: python -m pytest -vv --durations 25 env: @@ -210,11 +194,11 @@ jobs: timeout-minutes: 15 steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Check Python version @@ -222,12 +206,12 @@ jobs: - name: Install graphviz run: brew install graphviz - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install .[test] + run: uv pip install . --group test - name: Test with pytest run: python -m pytest -vv --durations 25 env: @@ -245,11 +229,11 @@ jobs: mkdir /tmp/epubcheck && cd /tmp/epubcheck wget --no-verbose https://github.com/w3c/epubcheck/releases/download/v${EPUBCHECK_VERSION}/epubcheck-${EPUBCHECK_VERSION}.zip unzip epubcheck-${EPUBCHECK_VERSION}.zip - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Check Python version @@ -257,12 +241,12 @@ jobs: - name: Install graphviz run: sudo apt-get install --no-install-recommends --yes graphviz - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install .[test] + run: uv pip install . --group test - name: Install Docutils' HEAD run: uv pip install "docutils @ git+https://repo.or.cz/docutils.git#subdirectory=docutils" - name: Test with pytest @@ -278,11 +262,11 @@ jobs: timeout-minutes: 15 steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Check Python version @@ -290,13 +274,13 @@ jobs: - name: Install graphviz run: sudo apt-get install --no-install-recommends --yes graphviz - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies run: | - uv pip install .[test] --resolution lowest-direct + uv pip install . --group test --resolution lowest-direct uv pip install alabaster==1.0.0 - name: Test with pytest run: python -m pytest -n logical --dist=worksteal -vv --durations 25 @@ -311,22 +295,24 @@ jobs: image: ghcr.io/sphinx-doc/sphinx-ci steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Check Python version run: python --version --version - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install .[test] + run: uv pip install . --group test + - name: Install Docutils' HEAD + run: uv pip install "docutils @ git+https://repo.or.cz/docutils.git#subdirectory=docutils" - name: Test with pytest run: python -m pytest -vv --durations 25 env: @@ -340,11 +326,11 @@ jobs: timeout-minutes: 15 steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Check Python version @@ -352,12 +338,12 @@ jobs: - name: Install graphviz run: sudo apt-get install --no-install-recommends --yes graphviz - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install .[test] pytest-cov + run: uv pip install . --group test pytest-cov - name: Test with pytest run: python -m pytest -vv --cov . --cov-append --cov-config pyproject.toml env: diff --git a/.github/workflows/nodejs.yml b/.github/workflows/nodejs.yml index 84727288fde..0f26b2ae00a 100644 --- a/.github/workflows/nodejs.yml +++ b/.github/workflows/nodejs.yml @@ -33,11 +33,11 @@ jobs: node-version: "20" steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Use Node.js ${{ env.node-version }} - uses: actions/setup-node@v4 + uses: actions/setup-node@v6 with: node-version: ${{ env.node-version }} cache: "npm" diff --git a/.github/workflows/transifex.yml b/.github/workflows/transifex.yml index 09437cb7ece..209b00cf709 100644 --- a/.github/workflows/transifex.yml +++ b/.github/workflows/transifex.yml @@ -23,11 +23,11 @@ jobs: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Install transifex client @@ -36,12 +36,12 @@ jobs: curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash shell: bash - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install --upgrade babel jinja2 + run: uv pip install --group translations - name: Extract translations from source code run: python utils/babel_runner.py extract - name: Push translations to transifex.com @@ -59,11 +59,11 @@ jobs: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 with: persist-credentials: false - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: "3" - name: Install transifex client @@ -72,12 +72,12 @@ jobs: curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash shell: bash - name: Install uv - uses: astral-sh/setup-uv@v5 + uses: astral-sh/setup-uv@v7 with: version: latest enable-cache: false - name: Install dependencies - run: uv pip install --upgrade babel jinja2 + run: uv pip install --group translations - name: Extract translations from source code run: python utils/babel_runner.py extract - name: Pull translations from transifex.com diff --git a/.gitignore b/.gitignore index 35fd23178f5..5a50535097e 100644 --- a/.gitignore +++ b/.gitignore @@ -3,6 +3,7 @@ *.so *.swp +.auto/ .dir-locals.el .cache/ .idea diff --git a/.prettierrc.toml b/.prettierrc.toml new file mode 100644 index 00000000000..1799612bfdd --- /dev/null +++ b/.prettierrc.toml @@ -0,0 +1,2 @@ +# https://prettier.io/docs/options +experimentalOperatorPosition = "start" diff --git a/.pytest.toml b/.pytest.toml new file mode 100644 index 00000000000..3d4c9798028 --- /dev/null +++ b/.pytest.toml @@ -0,0 +1,31 @@ +# https://docs.pytest.org/en/stable/reference/reference.html#configuration-options + +[pytest] +minversion = "9.0" + +# https://docs.pytest.org/en/stable/reference/reference.html#command-line-flags +addopts = [ + "-ra", + "--import-mode=prepend", +# "--pythonwarnings=error", +] + +empty_parameter_set_mark = "xfail" +filterwarnings = [ + "all", + "ignore::DeprecationWarning:docutils.io", + "ignore:Distutils was imported before Setuptools:UserWarning:_distutils_hack", + "ignore:Setuptools is replacing distutils:UserWarning:_distutils_hack", + "ignore::DeprecationWarning:pyximport.pyximport", + "ignore::ImportWarning:importlib._bootstrap", +] +log_cli_level = "INFO" +markers = [ + "apidoc", +] +testpaths = ["tests"] + +strict_config = true +strict_markers = true +#strict_parametrization_ids = true +strict_xfail = true diff --git a/.ruff.toml b/.ruff.toml index f82928eca65..256928e8a34 100644 --- a/.ruff.toml +++ b/.ruff.toml @@ -1,4 +1,4 @@ -target-version = "py311" # Pin Ruff to Python 3.11 +target-version = "py312" # Pin Ruff to Python 3.12 line-length = 88 output-format = "full" @@ -275,6 +275,7 @@ select = [ logger-objects = [ "sphinx.ext.apidoc._shared.LOGGER", + "sphinx.ext.autodoc._shared.LOGGER", "sphinx.ext.intersphinx._shared.LOGGER", ] diff --git a/AUTHORS.rst b/AUTHORS.rst index ff92ab7eab7..4646facb231 100644 --- a/AUTHORS.rst +++ b/AUTHORS.rst @@ -53,9 +53,11 @@ Contributors * Eric Larson -- better error messages * Eric N. Vander Weele -- autodoc improvements * Eric Wieser -- autodoc improvements +* Erik Bedard -- config options for :mod:`sphinx.ext.duration` * Etienne Desautels -- apidoc module * Ezio Melotti -- collapsible sidebar JavaScript * Filip Vavera -- napoleon todo directive +* Florian Best -- log improvements * Glenn Matthews -- python domain signature improvements * Gregory Szorc -- performance improvements * Henrique Bastos -- SVG support for graphviz extension @@ -63,6 +65,7 @@ Contributors * Hong Xu -- svg support in imgmath extension and various bug fixes * Horst Gutmann -- internationalization support * Hugo van Kemenade -- support FORCE_COLOR and NO_COLOR +* Ian Hunt-Isaak -- typealias reference improvement * Ian Lee -- quickstart improvements * Jacob Mason -- websupport library (GSOC project) * James Addison -- linkcheck and HTML search improvements @@ -83,10 +86,12 @@ Contributors * Louis Maddox -- better docstrings * Łukasz Langa -- partial support for autodoc * Marco Buttu -- doctest extension (pyversion option) +* Mark Ostroth -- semantic HTML contributions * Martin Hans -- autodoc improvements * Martin Larralde -- additional napoleon admonitions * Martin Liška -- option directive and role improvements * Martin Mahner -- nature theme +* Martin Matouš -- initial support for PEP 695 * Matthew Fernandez -- todo extension fix * Matthew Woodcraft -- text output improvements * Matthias Geier -- style improvements @@ -97,16 +102,23 @@ Contributors * Pauli Virtanen -- autodoc improvements, autosummary extension * Rafael Fontenelle -- internationalisation * \A. Rafey Khan -- improved intersphinx typing +* Rui Pinheiro -- Python 3.14 forward references support * Roland Meister -- epub builder * Sebastian Wiesner -- image handling, distutils support * Slawek Figiel -- additional warning suppression * Stefan Seefeld -- toctree improvements * Stefan van der Walt -- autosummary extension +* Steve Piercy -- documentation improvements +* Szymon Karpinski -- intersphinx improvements * \T. Powers -- HTML output improvements * Taku Shimizu -- epub3 builder +* Tamika Nomara -- bug fixes * Thomas Lamb -- linkcheck builder * Thomas Waldmann -- apidoc module fixes +* Till Hoffmann -- doctest option to exit after first failed test * Tim Hoffmann -- theme improvements +* Valentin Heinisch -- warning types improvement +* Victor Wheeler -- documentation improvements * Vince Salvino -- JavaScript search improvements * Will Maier -- directory HTML builder * Zac Hatfield-Dodds -- doctest reporting improvements, intersphinx performance diff --git a/CHANGES.rst b/CHANGES.rst index c257b3b11b1..a71b6c6fef1 100644 --- a/CHANGES.rst +++ b/CHANGES.rst @@ -1,9 +1,13 @@ -Release 8.3.0 (in development) +Release 9.1.0 (in development) ============================== Dependencies ------------ +* #14153: Drop Python 3.11 support. +* #12555: Drop Docutils 0.20 support. + Patch by Adam Turner + Incompatible changes -------------------- @@ -16,5 +20,8 @@ Features added Bugs fixed ---------- +* #14189: autodoc: Fix duplicate ``:no-index-entry:`` for modules. + Patch by Adam Turner + Testing ------- diff --git a/EXAMPLES.rst b/EXAMPLES.rst index 42d42a515f8..46657ee6d39 100644 --- a/EXAMPLES.rst +++ b/EXAMPLES.rst @@ -323,6 +323,7 @@ Documentation using PyData Sphinx Theme * `Binder `__ * `Bokeh `__ * `CuPy `__ +* `DAMASK `__ * `EnOSlib `__ * `Fairlearn `__ * `Feature-engine `__ diff --git a/doc/changes/5.3.rst b/doc/changes/5.3.rst index b2a2e5a78f1..171b0792bbe 100644 --- a/doc/changes/5.3.rst +++ b/doc/changes/5.3.rst @@ -8,7 +8,10 @@ Release 5.3.0 (released Oct 16, 2022) * #10759: LaTeX: add :confval:`latex_table_style` and support the ``'booktabs'``, ``'borderless'``, and ``'colorrows'`` styles. - (thanks to Stefan Wiehler for initial pull requests #6666, #6671) + (thanks to Stefan Wiehler for initial pull requests #6666, #6671). + Using the ``'booktabs'`` style solves #6740 (Removing LaTeX + column borders for automatic colspec). + Patch by Jean-François B. * #10840: One can cross-reference including an option value like ``:option:`--module=foobar```, ``:option:`--module[=foobar]```, or ``:option:`--module foobar```. diff --git a/doc/changes/7.3.rst b/doc/changes/7.3.rst index b544a722041..c9395c18c4a 100644 --- a/doc/changes/7.3.rst +++ b/doc/changes/7.3.rst @@ -86,7 +86,7 @@ Dependencies * #11858: Increase the minimum supported version of Alabaster to 0.7.14. Patch by Adam Turner. -* #11411: Support `Docutils 0.21`_. Patch by Adam Turner. +* #12267: Support `Docutils 0.21`_. Patch by Adam Turner. .. _Docutils 0.21: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-21-2024-04-09 * #12012: Use ``types-docutils`` instead of ``docutils-stubs``. diff --git a/doc/changes/9.0.rst b/doc/changes/9.0.rst new file mode 100644 index 00000000000..af51f075f0b --- /dev/null +++ b/doc/changes/9.0.rst @@ -0,0 +1,244 @@ +========== +Sphinx 9.0 +========== + + +Release 9.0.4 (released Dec 04, 2025) +===================================== + +Bugs fixed +---------- + +* #14143: Fix spurious build warnings when translators reorder references + in strings, or use translated display text in references. + Patch by Matt Wang. + +Release 9.0.3 (released Dec 04, 2025) +===================================== + +Bugs fixed +---------- + +* #14142: autodoc: Restore some missing exports in :mod:`!sphinx.ext.autodoc`. + Patch by Adam Turner. + +Release 9.0.2 (released Dec 03, 2025) +===================================== + +Bugs fixed +---------- + +* #14142: autodoc: Restore :mod:`!sphinx.ext.autodoc.mock`. + Patch by Adam Turner. + +Release 9.0.1 (released Dec 01, 2025) +===================================== + +Bugs fixed +---------- + +* #13942: autodoc: Restore the mapping interface for options objects. + Patch by Adam Turner. +* #13942: autodoc: Deprecate the mapping interface for options objects. + Patch by Adam Turner. +* #13387: Update translations. + +Release 9.0.0 (released Nov 30, 2025) +===================================== + +Dependencies +------------ + +* #13786: Support `Docutils 0.22`_. Patch by Adam Turner. + + .. _Docutils 0.22: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-22-2026-07-29 + +Incompatible changes +-------------------- + +* #13639: :py:meth:`!SphinxComponentRegistry.create_source_parser` no longer + has an *app* parameter, instead taking *config* and *env*. + Patch by Adam Turner. +* #13679: Non-decodable characters in source files now raise an error. + Such bytes have been replaced with '?' along with logging a warning + since Sphinx 2.0. + Patch by Adam Turner. +* #13751, #14089: :mod:`sphinx.ext.autodoc` has been substantially rewritten, + and there may be some incompatible changes in edge cases, especially when + extensions interact with autodoc internals. + The :confval:`autodoc_use_legacy_class_based` option has been added to + use the legacy (pre-9.0) implementation of autodoc. + Patches by Adam Turner. +* #13355: Don't include escaped title content in the search index. + Patch by Will Lachance. + +Deprecated +---------- + +* 13627: Deprecate remaining public :py:attr:`!.app` attributes, + including ``builder.app``, ``env.app``, ``events.app``, + and ``SphinxTransform.app``. + Patch by Adam Turner. +* #13637: Deprecate the :py:meth:`!set_application` method + of :py:class:`~sphinx.parsers.Parser` objects. + Patch by Adam Turner. +* #13644: Deprecate the :py:attr:`!Parser.config` and :py:attr:`!env` attributes. + Patch by Adam Turner. +* #13665: Deprecate support for non-UTF 8 source encodings, + scheduled for removal in Sphinx 10. + Patch by Adam Turner. +* #13682: Deprecate :py:mod:`!sphinx.io`. + Sphinx no longer uses the :py:mod:`!sphinx.io` classes, + having replaced them with standard Python I/O. + The entire :py:mod:`!sphinx.io` module will be removed in Sphinx 10. + Patch by Adam Turner. +* #13631: :func:`!sphinx.environment.adapters.toctree.global_toctree_for_doc` + and :meth:`!sphinx.environment.BuildEnvironment.get_and_resolve_doctree` + will require a *tags* keyword argument from Sphinx 11. + It may optionally be passed from Sphinx 9 onwards. + Patch by Adam Turner. + +Features added +-------------- + +* #13332: Add :confval:`doctest_fail_fast` option to exit after the first failed + test. + Patch by Till Hoffmann. +* #13439: linkcheck: Permit warning on every redirect with + ``linkcheck_allowed_redirects = {}``. + Patch by Adam Turner and James Addison. +* #13497: Support C domain objects in the table of contents. +* #13500: LaTeX: add support for ``fontawesome6`` package. + Patch by Jean-François B. +* #13509: autodoc: Detect :py:func:`typing_extensions.overload ` + and :py:func:`~typing.final` decorators. + Patch by Spencer Brown. +* #13535: html search: Update to the latest version of Snowball (v3.0.1). + Patch by Adam Turner. +* #13647: LaTeX: allow more cases of table nesting. + Patch by Jean-François B. +* #13657: LaTeX: support CSS3 length units. + Patch by Jean-François B. +* #13684: intersphinx: Add a file-based cache for remote inventories. + The location of the cache directory must not be relied upon externally, + as it may change without notice or warning in future releases. + Patch by Adam Turner. +* #13805: LaTeX: add support for ``fontawesome7`` package. + Patch by Jean-François B. +* #13508: autodoc: Initial support for :pep:`695` type aliases. + Patch by Martin Matouš, Jeremy Maitin-Shepard, and Adam Turner. +* #14023: Add the new :confval:`mathjax_config_path` option + to load MathJax configuration from a file. + Patch by Randolf Scholz and Adam Turner. +* #14046: linkcheck: Add the :confval:`linkcheck_case_insensitive_urls` option + to allow case-insensitive URL comparison for specific URL patterns. + This is useful for links to websites that normalise URL casing (e.g. GitHub) + or case-insensitive servers. + Patch by Fazeel Usmani and James Addison. +* #14075: autosummary: Provide more context in import exception stack traces. + Patch by Philipp A. +* #13468: Add config options to :mod:`sphinx.ext.duration`. + Patch by Erik Bedard and Adam Turner. +* #14022: Use MathJax v4 by default in the :mod:`sphinx.ext.mathjax` extension, + from v3 previously. + To keep using an older version, set the :confval:`mathjax_path` option. + Also add the new :confval:`mathjax4_config` option to configure MathJax v4. + Note that MathJax v3 is mostly compatible with MathJax v4, so existing + :confval:`mathjax3_config` settings should not need to change. + Patch by Matthias Geier. +* #14029: intersphinx: Fix error in format string interpolation. + Patch by Matthieu de Cibeins. +* #13894: Add ``source_code_parser`` type to :confval:`suppress_warnings` + for grouping issues related to the C and C++ parsers. + Patch by Valentin H. + +Bugs fixed +---------- + +* #13926: multiple py:type directives for the same canonical type no + longer result in spurious duplicate object description warnings. + Patch by Jeremy Maitin-Shepard. +* #1327: LaTeX: tables using longtable raise error if + :rst:dir:`tabularcolumns` specifies automatic widths + (``L``, ``R``, ``C``, or ``J``). + Patch by Jean-François B. +* #3447: LaTeX: when assigning longtable class to table for PDF, it may render + "horizontally" and overflow in right margin. + Patch by Jean-François B. +* #8828: LaTeX: adding a footnote to a longtable cell causes table to occupy + full width. + Patch by Jean-François B. +* #11498: LaTeX: Table in cell fails to build if it has many rows. + Patch by Jean-François B. +* #11515: LaTeX: longtable does not allow nested table. + Patch by Jean-François B. +* #11973: LaTeX: links in table captions do not work in PDF. + Patch by Jean-François B. +* #12821: LaTeX: URLs/links in section titles should render in PDF. + Patch by Jean-François B. +* #13369: Correctly parse and cross-reference unpacked type annotations. + Patch by Alicia Garcia-Raboso. +* #13528: Add tilde ``~`` prefix support for :rst:role:`py:deco`. + Patch by Shengyu Zhang and Adam Turner. +* #13597: LaTeX: table nested in a merged cell leads to invalid LaTeX mark-up + and PDF cannot be built. + Patch by Jean-François B. +* #13619: LaTeX: possible duplicated footnotes in PDF from object signatures + (typically if :confval:`latex_show_urls` ``= 'footnote'``). + Patch by Jean-François B. +* #13635: LaTeX: if a cell contains a table, row coloring is turned off for + the next table cells. + Patch by Jean-François B. +* #13685: gettext: Correctly ignore trailing backslashes. + Patch by Bénédikt Tran. +* #13712: intersphinx: Don't add "v" prefix to non-numeric versions. + Patch by Szymon Karpinski. +* #13688: HTML builder: Replace ```` with + ```` for attribute type annotations + to improve `semantic HTML structure + `__. + Patch by Mark Ostroth. +* #13812 (discussion): LaTeX: long :rst:dir:`confval` value does not wrap at + spaces in PDF. + Patch by Jean-François B. +* #10785: Autodoc: Allow type aliases defined in the project to be properly + cross-referenced when used as type annotations. This makes it possible + for objects documented as ``:py:data:`` to be hyperlinked in function signatures. +* #13858: doctest: doctest blocks are now correctly added to a group defined by the + configuration variable ``doctest_test_doctest_blocks``. +* #13885: Coverage builder: Fix TypeError when warning about missing modules. + Patch by Damien Ayers. +* #13929: Duplicate equation label warnings now have a new warning + sub-type, ``ref.equation``. + Patch by Jared Dillard. +* #13935: autoclass: parent class members no longer considered + directly defined in certain cases, depending on autodoc processing + order. + Patch by Jeremy Maitin-Shepard. +* #13939: LaTeX: page break can separate admonition title from contents. + Patch by Jean-François B. +* #14004: Fix :confval:`autodoc_type_aliases` when they appear in PEP 604 + union syntax (``Alias | Type``). + Patch by Tamika Nomara. +* #14059: LaTeX: Footnotes cause pdflatex error with French language + (since late June 2025 upstream change to LaTeX ``babel-french``). + Patch by Jean-François B. +* #13916: HTML Search: do not clear text fragments from the URL on page load. + Patch by Harmen Stoppels. +* #13944: autodoc: show traceback during import in human readable representation. + Patch by Florian Best. +* #14006: Support images with data URIs that aren't base64-encoded. + Patch by Shengyu Zhang and Adam Turner. +* #12797: Fix ``Some type variables (...) are not listed in Generic[...]`` + TypeError when inheriting from both Generic and autodoc mocked class. + Patch by Ikor Jefocur and Daniel Sperber. +* #13945: autodoc: Fix handling of undefined names in annotations by using + the ``FORWARDREF`` :mod:`annotationlib` format. + Patch by Rui Pinheiro and Adam Turner. +* #14067: EPUB: unify path separators in manifest items to forward slashes; + resolve duplicates in the manifest on Windows. + Patch by Akihiro Takizawa. +* #13741: text builder: fix an infinite loop when processing CSV tables. + Patch by Bénédikt Tran. +* #13217: Remove extra parentheses from :rst:dir:`js:function` arguments and errors. + Patch by Shengyu Zhang. diff --git a/doc/changes/index.rst b/doc/changes/index.rst index a1748f2cdd4..cc79f1a7065 100644 --- a/doc/changes/index.rst +++ b/doc/changes/index.rst @@ -24,6 +24,7 @@ Prior releases .. toctree:: :maxdepth: 2 + 9.0 8.2 8.1 8.0 diff --git a/doc/conf.py b/doc/conf.py index 9cf2f9b4856..8e9e5241caf 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -181,11 +181,18 @@ 'template template Wrapper::Outer::Inner', ), ('cpp:identifier', 'MyContainer'), - ('js:func', 'SomeError'), - ('js:func', 'number'), - ('js:func', 'string'), + ('js:class', 'SomeError'), + ('js:class', 'number'), + ('js:class', 'string'), ('py:attr', 'srcline'), + # sphinx.application.Sphinx.connect ('py:class', '_AutodocProcessDocstringListener'), + # sphinx.application.Sphinx.connect + ('py:class', '_AutodocBeforeProcessSignatureListener'), + # sphinx.application.Sphinx.connect + ('py:class', '_AutodocProcessSignatureListener'), + ('py:class', '_AutodocProcessBasesListener'), # sphinx.application.Sphinx.connect + ('py:class', '_AutodocSkipMemberListener'), # sphinx.application.Sphinx.connect ('py:class', '_ConfigRebuild'), # sphinx.application.Sphinx.add_config_value # sphinx.application.Sphinx.add_html_math_renderer ('py:class', '_MathsBlockRenderers'), @@ -231,6 +238,7 @@ ('py:class', 'pygments.lexer.Lexer'), ('py:class', 'sphinx.directives.ObjDescT'), ('py:class', 'sphinx.domains.IndexEntry'), + # sphinx.application.Sphinx.add_autodocumenter ('py:class', 'sphinx.ext.autodoc.Documenter'), ('py:class', 'sphinx.errors.NoUri'), ('py:class', 'sphinx.roles.XRefRole'), @@ -297,14 +305,12 @@ def linkify_issues_in_changelog( ) -> None: """Linkify issue references like #123 in changelog to GitHub.""" if docname == 'changes': + linkified_changelog = re.sub(r'(?:PR)?#([0-9]+)\b', _linkify, source[0]) + source[0] = linkified_changelog - def linkify(match: re.Match[str]) -> str: - url = 'https://github.com/sphinx-doc/sphinx/issues/' + match[1] - return f'`{match[0]} <{url}>`_' - - linkified_changelog = re.sub(r'(?:PR)?#([0-9]+)\b', linkify, source[0]) - source[0] = linkified_changelog +def _linkify(match: re.Match[str], /) -> str: + return f'`{match[0]} `__' REDIRECT_TEMPLATE = """ diff --git a/doc/development/html_themes/templating.rst b/doc/development/html_themes/templating.rst index e7c1d11f453..77b43882f86 100644 --- a/doc/development/html_themes/templating.rst +++ b/doc/development/html_themes/templating.rst @@ -6,6 +6,32 @@ Templating ========== +What Is Templating? +------------------- + +Templating is a method of generating HTML pages by combining static templates +with variable data. +The template files contain the static parts of the desired HTML output +and include special syntax describing how variable content will be inserted. +For example, this can be used to insert the current date in the footer of each page, +or to surround the main content of the document with a scaffold of HTML for layout +and formatting purposes. +Doing so only requires an understanding of HTML and the templating syntax. +Knowledge of Python can be helpful, but is not required. + +Templating uses an inheritance mechanism which allows child templates files +(e.g. in a theme) to override as much (or as little) of their 'parents' as desired. +Likewise, content authors can use their own local templates to override as much (or +as little) of the theme templates as desired. + +The result is that the Sphinx core, without needing to be changed, provides basic +HTML generation, independent of the structure and appearance of the final output, +while granting a great deal of flexibility to theme and content authors. + + +Sphinx Templating +----------------- + Sphinx uses the `Jinja `_ templating engine for its HTML templates. Jinja is a text-based engine, inspired by Django templates, so anyone having used Django will already be familiar with it. It diff --git a/doc/development/tutorials/examples/autodoc_intenum.py b/doc/development/tutorials/examples/autodoc_intenum.py index 2dd8d6324e6..ebddcbbd4d9 100644 --- a/doc/development/tutorials/examples/autodoc_intenum.py +++ b/doc/development/tutorials/examples/autodoc_intenum.py @@ -3,7 +3,7 @@ from enum import IntEnum from typing import TYPE_CHECKING -from sphinx.ext.autodoc import ClassDocumenter, bool_option +from sphinx.ext.autodoc import ClassDocumenter, Documenter, bool_option if TYPE_CHECKING: from typing import Any @@ -23,7 +23,7 @@ class IntEnumDocumenter(ClassDocumenter): @classmethod def can_document_member( - cls, member: Any, membername: str, isattr: bool, parent: Any + cls, member: Any, membername: str, isattr: bool, parent: Documenter ) -> bool: try: return issubclass(member, IntEnum) diff --git a/doc/development/tutorials/examples/recipe.py b/doc/development/tutorials/examples/recipe.py index 9848629216a..da52fa2df67 100644 --- a/doc/development/tutorials/examples/recipe.py +++ b/doc/development/tutorials/examples/recipe.py @@ -165,7 +165,7 @@ def add_recipe(self, signature, ingredients): name, signature, 'Recipe', - self.env.docname, + self.env.current_document.docname, anchor, 0, )) diff --git a/doc/development/tutorials/examples/todo.py b/doc/development/tutorials/examples/todo.py index a8aa1ec4a1d..c9993eda198 100644 --- a/doc/development/tutorials/examples/todo.py +++ b/doc/development/tutorials/examples/todo.py @@ -44,7 +44,7 @@ def run(self): self.env.todo_all_todos = [] self.env.todo_all_todos.append({ - 'docname': self.env.docname, + 'docname': self.env.current_document.docname, 'lineno': self.lineno, 'todo': todo_node.deepcopy(), 'target': targetnode, diff --git a/doc/development/tutorials/extending_build.rst b/doc/development/tutorials/extending_build.rst index 4d3606a0a33..9894d656fed 100644 --- a/doc/development/tutorials/extending_build.rst +++ b/doc/development/tutorials/extending_build.rst @@ -143,7 +143,7 @@ Looking first at the ``TodolistDirective`` directive: .. literalinclude:: examples/todo.py :language: python :linenos: - :lines: 24-27 + :pyobject: TodolistDirective It's very simple, creating and returning an instance of our ``todolist`` node class. The ``TodolistDirective`` directive itself has neither content nor @@ -153,7 +153,7 @@ directive: .. literalinclude:: examples/todo.py :language: python :linenos: - :lines: 30-53 + :pyobject: TodoDirective Several important things are covered here. First, as you can see, we're now subclassing the :class:`~sphinx.util.docutils.SphinxDirective` helper class @@ -168,16 +168,16 @@ new unique integer on each call and therefore leads to unique target names. The target node is instantiated without any text (the first two arguments). On creating admonition node, the content body of the directive are parsed using -``self.state.nested_parse``. The first argument gives the content body, and -the second one gives content offset. The third argument gives the parent node -of parsed result, in our case the ``todo`` node. Following this, the ``todo`` -node is added to the environment. This is needed to be able to create a list of -all todo entries throughout the documentation, in the place where the author -puts a ``todolist`` directive. For this case, the environment attribute -``todo_all_todos`` is used (again, the name should be unique, so it is prefixed -by the extension name). It does not exist when a new environment is created, so -the directive must check and create it if necessary. Various information about -the todo entry's location are stored along with a copy of the node. +``self.parse_content_to_nodes()``. +Following this, the ``todo`` node is added to the environment. +This is needed to be able to create a list of all todo entries throughout +the documentation, in the place where the author puts a ``todolist`` directive. +For this case, the environment attribute ``todo_all_todos`` is used +(again, the name should be unique, so it is prefixed by the extension name). +It does not exist when a new environment is created, so the directive must +check and create it if necessary. +Various information about the todo entry's location are stored along with +a copy of the node. In the last line, the nodes that should be put into the doctree are returned: the target node and the admonition node. @@ -211,7 +211,7 @@ the :event:`env-purge-doc` event: .. literalinclude:: examples/todo.py :language: python :linenos: - :lines: 56-61 + :pyobject: purge_todos Since we store information from source files in the environment, which is persistent, it may become out of date when the source file changes. Therefore, @@ -229,7 +229,7 @@ to be merged: .. literalinclude:: examples/todo.py :language: python :linenos: - :lines: 64-68 + :pyobject: merge_todos The other handler belongs to the :event:`doctree-resolved` event: @@ -237,12 +237,13 @@ The other handler belongs to the :event:`doctree-resolved` event: .. literalinclude:: examples/todo.py :language: python :linenos: - :lines: 71-113 + :pyobject: process_todo_nodes -The :event:`doctree-resolved` event is emitted at the end of :ref:`phase 3 -(resolving) ` and allows custom resolving to be done. The handler -we have written for this event is a bit more involved. If the -``todo_include_todos`` config value (which we'll describe shortly) is false, +The :event:`doctree-resolved` event is emitted for each document that is +about to be written at the end of :ref:`phase 3 (resolving) ` +and allows custom resolving to be done on that document. +The handler we have written for this event is a bit more involved. +If the ``todo_include_todos`` config value (which we'll describe shortly) is false, all ``todo`` and ``todolist`` nodes are removed from the documents. If not, ``todo`` nodes just stay where and how they are. ``todolist`` nodes are replaced by a list of todo entries, complete with backlinks to the location @@ -266,17 +267,17 @@ the other parts of our extension. Let's look at our ``setup`` function: .. literalinclude:: examples/todo.py :language: python :linenos: - :lines: 116- + :pyobject: setup The calls in this function refer to the classes and functions we added earlier. What the individual calls do is the following: * :meth:`~Sphinx.add_config_value` lets Sphinx know that it should recognize the - new *config value* ``todo_include_todos``, whose default value should be - ``False`` (this also tells Sphinx that it is a boolean value). + new *config value* ``todo_include_todos``, whose default value is ``False`` + (which also tells Sphinx that it is a boolean value). - If the third argument was ``'html'``, HTML documents would be full rebuild if the - config value changed its value. This is needed for config values that + If the third argument was ``'html'``, HTML documents would be fully rebuilt + if the config value changed its value. This is needed for config values that influence reading (build :ref:`phase 1 (reading) `). * :meth:`~Sphinx.add_node` adds a new *node class* to the build system. It also diff --git a/doc/extdev/appapi.rst b/doc/extdev/appapi.rst index abf202e19b3..c7b17e796a4 100644 --- a/doc/extdev/appapi.rst +++ b/doc/extdev/appapi.rst @@ -106,6 +106,13 @@ package. Emitting events --------------- +.. attention:: + + Extension developers should prefer using the event manager (``events``) + object directly, via :meth:`.EventManager.emit` + and :meth:`.EventManager.emit_firstresult`, + which have identical behaviour to the methods below. + .. class:: Sphinx :no-index: diff --git a/doc/extdev/deprecated.rst b/doc/extdev/deprecated.rst index ad05b054d99..b7583b0e37d 100644 --- a/doc/extdev/deprecated.rst +++ b/doc/extdev/deprecated.rst @@ -22,6 +22,36 @@ The following is a list of deprecated interfaces. - Removed - Alternatives + * - ``sphinx.io`` (entire module) + - 9.0 + - 11.0 + - ``docutils.io`` or standard Python I/O + + * - ``sphinx.builders.Builder.app`` + - 9.0 + - 11.0 + - N/A + + * - ``sphinx.environment.BuildEnvironment.app`` + - 9.0 + - 11.0 + - N/A + + * - ``sphinx.transforms.Transform.app`` + - 9.0 + - 11.0 + - N/A + + * - ``sphinx.transforms.post_transforms.SphinxPostTransform.app`` + - 9.0 + - 11.0 + - N/A + + * - ``sphinx.events.EventManager.app`` + - 9.0 + - 11.0 + - N/A + * - ``sphinx.builders.singlehtml.SingleFileHTMLBuilder.fix_refuris`` - 8.2 - 10.0 diff --git a/doc/extdev/event_callbacks.rst b/doc/extdev/event_callbacks.rst index 04eae51be1d..7ce7ad4cf22 100644 --- a/doc/extdev/event_callbacks.rst +++ b/doc/extdev/event_callbacks.rst @@ -7,7 +7,7 @@ Connecting callback functions to events is a simple way to extend Sphinx, by hooking into the build process at various points. Use :meth:`.Sphinx.connect` in an extension's ``setup`` function, -or a ``setup`` function in your projects :file:`conf.py`, +or a ``setup`` function in your project's :file:`conf.py`, to connect functions to the events: .. code-block:: python @@ -22,7 +22,7 @@ to connect functions to the events: Extensions can add their own events by using :meth:`.Sphinx.add_event`, and calling them them with - :meth:`.Sphinx.emit` or :meth:`.Sphinx.emit_firstresult`. + :meth:`.EventManager.emit` or :meth:`.EventManager.emit_firstresult`. Core events overview -------------------- @@ -70,8 +70,8 @@ Below is an overview of the core event that happens during a build. 14. apply post-transforms (by priority): docutils.document -> docutils.document 15. event.doctree-resolved(app, doctree, docname) - In the event that any reference nodes fail to resolve, the following may emit: - - event.missing-reference(env, node, contnode) - - event.warn-missing-reference(domain, node) + - event.missing-reference(app, env, node, contnode) + - event.warn-missing-reference(app, domain, node) 16. Generate output files 17. event.build-finished(app, exception) diff --git a/doc/extdev/eventapi.rst b/doc/extdev/eventapi.rst new file mode 100644 index 00000000000..7db6ac9fa10 --- /dev/null +++ b/doc/extdev/eventapi.rst @@ -0,0 +1,9 @@ +.. _event-api: + +Event Manager API +----------------- + +.. module:: sphinx.events + +.. autoclass:: EventManager + :members: diff --git a/doc/extdev/index.rst b/doc/extdev/index.rst index 2eff8f0738d..149a85edd67 100644 --- a/doc/extdev/index.rst +++ b/doc/extdev/index.rst @@ -49,11 +49,9 @@ extension. These are: **Application** The application object (usually called ``app``) is an instance of - :class:`.Sphinx`. It controls most high-level functionality, such as the - setup of extensions, event dispatching and producing output (logging). - - If you have the environment object, the application is available as - ``env.app``. + :class:`.Sphinx`. + It controls most high-level functionality, such as loading config, + initialising the environment, and the setup of extensions. **Environment** The build environment object (usually called ``env``) is an instance of @@ -67,6 +65,8 @@ extension. These are: If you have the application or builder object, the environment is available as ``app.env`` or ``builder.env``. + In :class:`.SphinxDirective`, :class:`.SphinxRole`, or :class:`.SphinxTransform` + subclasses, the environment is available as ``self.env``. **Builder** The builder object (usually called ``builder``) is an instance of a specific @@ -82,7 +82,17 @@ extension. These are: configuration values set in :file:`conf.py` as attributes. It is an instance of :class:`.Config`. - The config is available as ``app.config`` or ``env.config``. + The config is available as ``env.config``, ``builder.config``, or ``app.config``. + In :class:`.SphinxDirective`, :class:`.SphinxRole`, or :class:`.SphinxTransform` + subclasses, the environment is available as ``self.config``. + +**Events** + The event manager object (usually called ``events``) manages and dispatches + Sphinx's events system. + It is an instance of :class:`.EventManager`. + + The event manager is available as ``env.events``, ``builder.events``, + or ``app.events``. To see an example of use of these objects, refer to :ref:`the tutorials `. @@ -232,6 +242,7 @@ disposal when developing Sphinx extensions. Some are core to Sphinx projectapi envapi builderapi + eventapi collectorapi markupapi domainapi diff --git a/doc/extdev/markupapi.rst b/doc/extdev/markupapi.rst index 7aa632446da..184bd2bd8e4 100644 --- a/doc/extdev/markupapi.rst +++ b/doc/extdev/markupapi.rst @@ -173,9 +173,9 @@ The methods are used as follows: def run(self) -> list[Node]: container = docutils.nodes.Element() # either - nested_parse_with_titles(self.state, self.result, container) + nested_parse_with_titles(self.state, self.result, container, self.content_offset) # or - self.state.nested_parse(self.result, 0, container) + self.state.nested_parse(self.result, self.content_offset, container) parsed = container.children return parsed diff --git a/doc/extdev/utils.rst b/doc/extdev/utils.rst index 9e10a0ded85..26974b00691 100644 --- a/doc/extdev/utils.rst +++ b/doc/extdev/utils.rst @@ -32,13 +32,6 @@ components (e.g. :class:`.Config`, :class:`.BuildEnvironment` and so on) easily. :members: -Utility components ------------------- - -.. autoclass:: sphinx.events.EventManager - :members: - - Utility functions ----------------- diff --git a/doc/internals/contributing.rst b/doc/internals/contributing.rst index 4b8ca84a945..5a4f10c37bb 100644 --- a/doc/internals/contributing.rst +++ b/doc/internals/contributing.rst @@ -93,17 +93,29 @@ These are the basic steps needed to start developing on Sphinx. git clone https://github.com//sphinx cd sphinx -#. Setup a virtual environment. +#. Install uv and set up your environment. - This is not necessary for unit testing, thanks to :program:`tox`, - but it is necessary if you wish to run :program:`sphinx-build` locally - or run unit tests without the help of :program:`tox`: + We recommend using :program:`uv` for dependency management. + Install it with: .. code-block:: shell - virtualenv ~/.venv - . ~/.venv/bin/activate - pip install -e . + python -m pip install -U uv + + Then, set up your environment: + + .. code-block:: shell + + uv sync + + **Alternative:** If you prefer not to use :program:`uv`, you can use + :program:`pip`: + + .. code-block:: shell + + python -m venv .venv + . .venv/bin/activate + python -m pip install -e . #. Create a new working branch. Choose any name you like. @@ -138,6 +150,10 @@ These are the basic steps needed to start developing on Sphinx. #. Wait for a core developer or contributor to review your changes. + You may be asked to address comments on the review. If so, please avoid + force pushing to the branch. Sphinx uses the *squash merge* strategy when + merging PRs, so follow-up commits will all be combined. + Coding style ~~~~~~~~~~~~ @@ -163,8 +179,9 @@ Style and type checks can be run as follows: .. code-block:: shell - ruff check . - mypy + uv run ruff check + uv run ruff format + uv run mypy Unit tests @@ -184,24 +201,31 @@ of targets and allows testing against multiple different Python environments: tox -av -* To run unit tests for a specific Python version, such as Python 3.13: +* To run unit tests for a specific Python version, such as Python 3.14: .. code-block:: shell - tox -e py313 + tox -e py314 * Arguments to :program:`pytest` can be passed via :program:`tox`, e.g., in order to run a particular test: .. code-block:: shell - tox -e py313 tests/test_module.py::test_new_feature + tox -e py314 tests/test_module.py::test_new_feature You can also test by installing dependencies in your local environment: .. code-block:: shell - pip install .[test] + uv run pytest + +Or with :program:`pip`: + + .. code-block:: shell + + python -m pip install . --group test + pytest To run JavaScript tests, use :program:`npm`: @@ -276,15 +300,34 @@ To do so, use `sphinx-autobuild`_ to run the following command: .. _sphinx-autobuild: https://github.com/sphinx-doc/sphinx-autobuild Translations -~~~~~~~~~~~~ +------------ The parts of messages in Sphinx that go into builds are translated into several locales. The translations are kept as gettext ``.po`` files translated from the master template :file:`sphinx/locale/sphinx.pot`. +These Sphinx core messages are translated using the online `Transifex +`__ platform. + +Translated strings from the platform are pulled into the Sphinx repository +by a maintainer before a new release. + +We do not accept pull requests altering the translation files directly. +Instead, please contribute translations via the Transifex platform. + +Translations notes for maintainers +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The `transifex CLI `__ (``tx``) +can be used to pull translations in ``.po`` format from Transifex. +To do this, go to :file:`sphinx/locale` and then run ``tx pull -f -l LANG`` +where ``LANG`` is an existing language identifier. +It is good practice to run ``python utils/babel_runner.py update`` afterwards +to make sure the ``.po`` file has the canonical Babel formatting. + Sphinx uses `Babel `_ to extract messages and maintain the catalog files. The :file:`utils` directory contains a helper -script, ``babel_runner.py``. +script, :file:`utils/babel_runner.py`. * Use ``python babel_runner.py extract`` to update the ``.pot`` template. * Use ``python babel_runner.py update`` to update all existing language @@ -297,19 +340,10 @@ When an updated ``.po`` file is submitted, run ``python babel_runner.py compile`` to commit both the source and the compiled catalogs. -When a new locale is submitted, add a new directory with the ISO 639-1 language +When a new locale is added, add a new directory with the ISO 639-1 language identifier and put ``sphinx.po`` in there. Don't forget to update the possible values for :confval:`language` in :file:`doc/usage/configuration.rst`. -The Sphinx core messages can also be translated on `Transifex -`_. There ``tx`` client tool, -which is provided by the ``transifex_client`` Python package, can be used to -pull translations in ``.po`` format from Transifex. To do this, go to -:file:`sphinx/locale` and then run ``tx pull -f -l LANG`` where ``LANG`` is an -existing language identifier. It is good practice to run -``python babel_runner.py update`` afterwards to make sure the ``.po`` file has the -canonical Babel formatting. - Debugging tips -------------- @@ -337,13 +371,15 @@ Updating generated files ------------------------ * JavaScript stemming algorithms in :file:`sphinx/search/non-minified-js/*.js` - are generated using `snowball `_ - by cloning the repository, executing ``make dist_libstemmer_js`` and then - unpacking the tarball which is generated in :file:`dist` directory. + and stopword files in :file:`sphinx/search/_stopwords/` + are generated from the `Snowball project`_ + by running :file:`utils/generate_snowball.py`. Minified files in :file:`sphinx/search/minified-js/*.js` are generated from - non-minified ones using :program:`uglifyjs` (installed via npm), with ``-m`` - option to enable mangling. + non-minified ones using :program:`uglifyjs` (installed via npm). + See :file:`sphinx/search/minified-js/README.rst`. + + .. _Snowball project: https://snowballstem.org/ * The :file:`searchindex.js` files found in the :file:`tests/js/fixtures/*` directories diff --git a/doc/latex.rst b/doc/latex.rst index fce61480941..edb2f0c18cb 100644 --- a/doc/latex.rst +++ b/doc/latex.rst @@ -500,7 +500,7 @@ Keys that don't need to be overridden unless in special cases are: .. hint:: If the key value is set to - :code-tex:`r'\\newcommand\sphinxbackoftitlepage{}\\sphinxmaketitle'`, then ```` will be typeset on back of title page (``'manual'`` docclass only). @@ -1006,18 +1006,20 @@ The color used in the above example is available from having passed the ``iconpackage`` - The name of the LaTeX package used for icons in the admonition titles. It - defaults to ``fontawesome5`` or to fall-back ``fontawesome``. In case - neither one is available the option value will automatically default to - ``none``, which means that no attempt at loading a package is done. - Independently of this setting, arbitrary LaTeX code can be associated to - each admonition type via ``div._icon-title`` keys which are - described in the :ref:`additionalcss` section. If these keys are not - used, Sphinx will either apply its default choices of icons (if - ``fontawesome{5,}`` is available) or not draw the icon at all. Notice that - if fall-back ``fontawesome`` is used the common icon for :dudir:`caution` - and :dudir:`danger` will default to "bolt" not "radiation", which is only - found in ``fontawesome5``. + The name of the LaTeX package used for rendering icons in the admonition + titles. Its default is set dynamically to either ``fontawesome7``, + ``fontawesome6``, + ``fontawesome5``, ``fontawesome``, or ``none``, in decreasing order of + priority and depending on whether + packages with those names exist in the used LaTeX installation. The LaTeX + code for each admonition icon will use ``\faIcon`` command if with + ``fontawesome{5,6,7}`` and + ``\faicon`` if with ``fontawesome``. + If no "Font Awesome" related package is found (or if the option is set + forcefully to ``none``) the icons are silently dropped. User can set this + option to some specific package and must configure then the + ``div.note_title-icon`` and similar keys to use then that LaTeX package + interface (see the :ref:`additionalcss` section about this). .. versionadded:: 7.4.0 @@ -1410,17 +1412,21 @@ The next keys, for admonitions, :dudir:`topic`, contents_, and (it applies only to the icon, not to the title of the admonition). - ``div._title-icon``: the LaTeX code responsible for producing the - icon. For example, the default for :dudir:`note` is - ``div.note_title-icon=\faIcon{info-circle}``. This uses a command from the - LaTeX ``fontawesome5`` package, which is loaded automatically if available. - - If neither ``fontawesome5`` nor fall-back ``fontawesome`` (for which the - associated command is :code-tex:`\\faicon`, not :code-tex:`\\faIcon`) are - found, or if the ``iconpackage`` key of :ref:`'sphinxsetup' - ` is set to load some other user-chosen package, or no - package at all, all the ``title-icons`` default to empty LaTeX code. It is - up to user to employ this interface to inject the icon (or anything else) - into the PDF output. + icon for the given ````. + For example the default for :dudir:`note` is + ``div.note_title-icon=\faIcon{info-circle}`` with ``fontawesome5``, but + ``div.note_title-icon=\faIcon{circle-info}`` with ``fontawesome6`` + and ``fontawesome7``. + If you want to modify the icons used by Sphinx, employ in these keys + the ``\faIcon`` LaTeX command if one of ``fontawesome5``, ``6`` or ``7`` is + on your LaTeX installation. + If your system only provides the + ``fontawesome`` package use its command ``\faicon`` (not ``\faIcon``) + in order to modify the choice of icons. The ``iconpackage`` key of + ``'sphinxsetup'`` can be used to force usage of one among + ``fontawesome{,5,6,7}`` or be the name of some other icon-providing package. + In that latter case you must configure the ``div._title-icon`` keys + to use the LaTeX commands appropriate to that custom icon package. .. note:: @@ -1694,7 +1700,7 @@ Macros .. hint:: If adding to preamble the loading of ``tocloft`` package, also add to - preamble :code-tex:`\\renewcommand\sphinxtableofcontentshook{}` else it + preamble :code-tex:`\\renewcommand\\sphinxtableofcontentshook{}` else it will reset :code-tex:`\\l@section` and :code-tex:`\\l@subsection` cancelling ``tocloft`` customization. diff --git a/doc/man/sphinx-build.rst b/doc/man/sphinx-build.rst index 63af7e49b4c..6815d10a424 100644 --- a/doc/man/sphinx-build.rst +++ b/doc/man/sphinx-build.rst @@ -58,6 +58,9 @@ Options *info* Build Texinfo files and run them through :program:`makeinfo`. + *help* + Output a list of valid builder targets, and exit. + .. note:: The default output directory locations when using *make-mode* @@ -272,13 +275,13 @@ Options From Sphinx 8.1, :option:`!--keep-going` is always enabled. Previously, it was only applicable whilst using :option:`--fail-on-warning`, which by default exited :program:`sphinx-build` on the first warning. - Using :option:`!--keep-going` runs :program:`!sphinx-build` to completion + Using :option:`!--keep-going` runs :program:`sphinx-build` to completion and exits with exit status 1 if errors are encountered. .. versionadded:: 1.8 .. versionchanged:: 8.1 :program:`sphinx-build` no longer exits on the first warning, - meaning that in effect :option:`!--fail-on-warning` is always enabled. + meaning that in effect :option:`!--keep-going` is always enabled. The option is retained for compatibility, but may be removed at some later date. diff --git a/doc/tutorial/deploying.rst b/doc/tutorial/deploying.rst index 1873d6783f2..e3dcb0593ab 100644 --- a/doc/tutorial/deploying.rst +++ b/doc/tutorial/deploying.rst @@ -175,7 +175,7 @@ After you have published your sources on GitHub, create a file named contents: .. code-block:: yaml - :caption: .github/workflows/ + :caption: .github/workflows/sphinx.yml name: "Sphinx: Render docs" @@ -222,13 +222,14 @@ following contents: furo==2021.11.16 -And finally, you are ready to `enable GitHub Pages on your repository`_. For +And finally, you are ready to `publish GitHub Pages from a branch`_. For that, go to :guilabel:`Settings`, then :guilabel:`Pages` on the left sidebar, -select the ``gh-pages`` branch in the "Source" dropdown menu, and click +select the ``Deploy from a branch`` item in the "Source" dropdown menu, +select the ``gh-page`` branch in the "Branch" dropdown menu, and click :guilabel:`Save`. After a few minutes, you should be able to see your HTML at the designated URL. -.. _enable GitHub Pages on your repository: https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site +.. _publish GitHub Pages from a branch: https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-from-a-branch GitLab Pages ~~~~~~~~~~~~ @@ -248,7 +249,7 @@ After you have published your sources on GitLab, create a file named pages: stage: deploy - image: python:3.12-slim + image: python:3.14-slim before_script: - apt-get update && apt-get install make --no-install-recommends -y - python -m pip install sphinx furo diff --git a/doc/tutorial/first-steps.rst b/doc/tutorial/first-steps.rst index fd5c631353e..dccf1838de3 100644 --- a/doc/tutorial/first-steps.rst +++ b/doc/tutorial/first-steps.rst @@ -73,6 +73,7 @@ shown right after the corresponding link, in parentheses. You can change that behavior by adding the following code at the end of your ``conf.py``: .. code-block:: python + :caption: docs/source/conf.py # EPUB options epub_show_urls = 'footnote' diff --git a/doc/usage/advanced/intl.rst b/doc/usage/advanced/intl.rst index 4d52c34debe..4ae26f943fb 100644 --- a/doc/usage/advanced/intl.rst +++ b/doc/usage/advanced/intl.rst @@ -375,10 +375,11 @@ Contributing to Sphinx reference translation The recommended way for new contributors to translate Sphinx reference is to join the translation team on Transifex. -There is a `sphinx translation page`_ for Sphinx (master) documentation. +There is a `Sphinx translation page`_ for Sphinx (master) documentation. 1. Login to Transifex_ service. -2. Go to `sphinx translation page`_. +2. Go to the `"Sphinx's documentation" translation project + `__. 3. Click ``Request language`` and fill form. 4. Wait acceptance by Transifex sphinx translation maintainers. 5. (After acceptance) Translate on Transifex. @@ -414,7 +415,7 @@ percentage of nodes that have been translated on a per-document basis. .. _`sphinx-intl`: https://pypi.org/project/sphinx-intl/ .. _Transifex: https://app.transifex.com/ .. _Weblate's documentation: https://docs.weblate.org/en/latest/devel/sphinx.html -.. _`sphinx translation page`: https://app.transifex.com/sphinx-doc/sphinx-doc/ +.. _`Sphinx translation page`: https://explore.transifex.com/sphinx-doc/sphinx-doc/ .. _`Transifex Client documentation`: https://developers.transifex.com/docs/using-the-client .. _`Transifex API token`: https://app.transifex.com/user/settings/api/ .. _`sphinx-intl update-txconfig-resources documentation`: https://sphinx-intl.readthedocs.io/en/master/refs.html#sphinx-intl-update-txconfig-resources diff --git a/doc/usage/advanced/websupport/index.rst b/doc/usage/advanced/websupport/index.rst index 08166405196..7edef89895e 100644 --- a/doc/usage/advanced/websupport/index.rst +++ b/doc/usage/advanced/websupport/index.rst @@ -8,6 +8,20 @@ Sphinx Web Support Sphinx provides a Python API to easily integrate Sphinx documentation into your web application. To learn more read the :ref:`websupportquickstart`. +.. _Pocoo: https://www.pocoo.org +.. _sphinx-websupport-app: https://github.com/shimizukawa/sphinx-websupport-app + +.. note:: + + **Historical context**: Web Support originated from the `Pocoo`_ community, + the original creators of Sphinx, Jinja, Flask, Pygments, and more. Web + Support was part of a plan to create a forum application that tied together + Jinja, Flask, Sphinx, etc. The core goal behind Web Support was to enable a + user editing and suggestion layer on top of documentation. While the concept + has merit, the feature has seen limited adoption and development over the + years. As of 2025, there are few real-world examples of its use. See + `sphinx-websupport-app`_ for one such example. + .. toctree:: quickstart diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst index 75e08d7654b..70de2ca3c14 100644 --- a/doc/usage/configuration.rst +++ b/doc/usage/configuration.rst @@ -1157,6 +1157,9 @@ Options for source files The recommended encoding is ``'utf-8-sig'``. .. versionadded:: 0.5 + .. deprecated:: 9.0 + Support for source encodings other than UTF-8 is deprecated. + Sphinx 11 will only support UTF-8 files. .. confval:: source_suffix :type: :code-py:`dict[str, str] | Sequence[str] | str` @@ -1391,6 +1394,7 @@ Options for warning control * ``ref.any`` * ``ref.citation`` * ``ref.doc`` + * ``ref.equation`` * ``ref.footnote`` * ``ref.keyword`` * ``ref.numref`` @@ -1398,6 +1402,8 @@ Options for warning control * ``ref.python`` * ``ref.ref`` * ``ref.term`` + * ``source_code_parser.c`` + * ``source_code_parser.cpp`` * ``toc.circular`` * ``toc.duplicate_entry`` * ``toc.empty_glob`` @@ -1416,6 +1422,7 @@ Options for warning control * ``autosectionlabel.`` * ``autosummary`` * ``autosummary.import_cycle`` + * ``duration`` * ``intersphinx.external`` You can choose from these types. You can also give only the first @@ -1481,6 +1488,9 @@ Options for warning control ``ref.any``, ``toc.duplicate_entry``, ``toc.empty_glob``, and ``toc.not_included``. + .. versionadded:: 9.0 + ``duration``. + Builder options =============== @@ -3083,7 +3093,7 @@ These options influence LaTeX output. the :code-tex:`\\rowcolors` LaTeX command becomes a no-op (this command has limitations and has never correctly supported all types of tables Sphinx produces in LaTeX). - Please update your project to use the + Please use the :ref:`latex table color configuration ` keys instead. To customise the styles for a table, @@ -3096,7 +3106,7 @@ These options influence LaTeX output. The latter two can be combined with any of the first three. The ``standard`` class produces tables with both horizontal and vertical lines - (as has been the default so far with Sphinx). + (as had been the default prior to Sphinx 6.0.0). A single-row multi-column merged cell will obey the row colour, if it is set. @@ -3642,7 +3652,6 @@ and which failures and redirects it ignores. .. confval:: linkcheck_allowed_redirects :type: :code-py:`dict[str, str]` - :default: :code-py:`{}` A dictionary that maps a pattern of the source URI to a pattern of the canonical URI. @@ -3668,6 +3677,11 @@ and which failures and redirects it ignores. .. versionadded:: 4.1 + .. versionchanged:: 9.0 + Setting :confval:`!linkcheck_allowed_redirects` to an empty dictionary + may now be used to warn on all redirects encountered + by the *linkcheck* builder. + .. confval:: linkcheck_anchors :type: :code-py:`bool` :default: :code-py:`True` @@ -3805,6 +3819,42 @@ and the number of workers to use. .. versionadded:: 7.3 +.. confval:: linkcheck_case_insensitive_urls + :type: :code-py:`Set[str] | Sequence[str]` + :default: :code-py:`()` + + A collection of regular expressions that match URLs for which the *linkcheck* + builder should perform case-insensitive comparisons. This is useful for + links to websites that are case-insensitive or normalise URL casing. + + By default, *linkcheck* requires the destination URL to match the + documented URL case-sensitively. + For example, a link to ``http://example.org/PATH`` that redirects to + ``http://example.org/path`` will be reported as ``redirected``. + + If the URL matches a pattern contained in + :confval:`!linkcheck_case_insensitive_urls`, + it would instead be reported as ``working``. + + For example, to treat all GitHub URLs as case-insensitive: + + .. code-block:: python + + linkcheck_case_insensitive_urls = [ + r'https://github\.com/.*', + ] + + Or, to treat all URLs as case-insensitive: + + .. code-block:: python + + linkcheck_case_insensitive_urls = ['.*'] + + .. note:: URI fragments (HTML anchors) are not affected by this option. + They are always checked with case-sensitive comparisons. + + .. versionadded:: 9.0 + .. confval:: linkcheck_rate_limit_timeout :type: :code-py:`int` :default: :code-py:`300` diff --git a/doc/usage/domains/index.rst b/doc/usage/domains/index.rst index cc3f272646c..acb0f2ee97b 100644 --- a/doc/usage/domains/index.rst +++ b/doc/usage/domains/index.rst @@ -35,6 +35,71 @@ easier to write. This section describes what the domains that are included with Sphinx provide. The domain API is documented as well, in the section :ref:`domain-api`. +Built-in domains +---------------- + +The following domains are included within Sphinx: + +.. toctree:: + :maxdepth: 1 + + standard + c + cpp + javascript + mathematics + python + restructuredtext + + +Third-party domains +------------------- + +Several third-party domains are available as extensions, including: + +* `Ada `__ +* `Antlr4 `__ +* `Bazel `__ +* `BibTex `__ +* `Bison/YACC `__ +* `Chapel `__ +* `CMake `__ +* `Common Lisp `__ +* `Erlang `__ +* `Fortran `__ +* `GraphQL `__ +* `Go `__ +* `HTTP `__ +* `Hy `__ +* `Lua `__ +* `MATLAB `__ +* `PHP `__ +* `Ruby `__ +* `Rust `__ +* `Verilog `__ +* `VHDL `__ +* `Visual Basic `__ + +Other domains may be found on the Python Package Index +(via the `Framework :: Sphinx :: Domain`__ classifier), +`GitHub `__, or +`GitLab `__. + +__ https://pypi.org/search/?c=Framework+%3A%3A+Sphinx+%3A%3A+Domain + +.. NOTE: The following all seem unmaintained, last released 2018 or earlier. + The links are preserved in this comment for reference. + + * `CoffeeScript `__ + * `DotNET `__ + * `dqn `__ + * `Jinja `__ + * `JSON `__ + * `Lasso `__ + * `Operation `__ + * `Scala `__ + * `Lua `__ + .. _basic-domain-markup: @@ -174,40 +239,3 @@ In short: component of the target. For example, ``:py:meth:`~queue.Queue.get``` will refer to ``queue.Queue.get`` but only display ``get`` as the link text. - -Built-in domains ----------------- - -The following domains are included within Sphinx: - -.. toctree:: - :maxdepth: 1 - - standard - c - cpp - javascript - mathematics - python - restructuredtext - -More domains ------------- - -There are several third-party domains available as extensions, including: - -* `Ada `__ -* `Chapel `__ -* `CoffeeScript `__ -* `Common Lisp `__ -* `dqn `__ -* `Erlang `__ -* `Go `__ -* `HTTP `__ -* `Jinja `__ -* `Lasso `__ -* `MATLAB `__ -* `Operation `__ -* `PHP `__ -* `Ruby `__ -* `Scala `__ diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst index 1b873f0d819..17445b19635 100644 --- a/doc/usage/extensions/autodoc.rst +++ b/doc/usage/extensions/autodoc.rst @@ -966,11 +966,63 @@ Automatically document attributes or data ``:no-value:`` has no effect. +Automatically document type aliases +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. rst:directive:: autotype + + .. versionadded:: 9.0 + + Document a :pep:`695` type alias (the :keyword:`type` statement). + By default, the directive only inserts the docstring of the alias itself: + + The directive can also contain content of its own, + which will be inserted into the resulting non-auto directive source + after the docstring (but before any automatic member documentation). + + Therefore, you can also mix automatic and non-automatic member documentation. + + .. rubric:: Options + + .. rst:directive:option:: no-index + :type: + + Do not generate an index entry for the documented class + or any auto-documented members. + + .. rst:directive:option:: no-index-entry + :type: + + Do not generate an index entry for the documented class + or any auto-documented members. + Unlike ``:no-index:``, cross-references are still created. + + Configuration ------------- There are also config values that you can set: +.. confval:: autodoc_use_legacy_class_based + :type: :code-py:`bool` + :default: :code-py:`False` + + If true, autodoc will use the legacy class-based implementation. + This is the behaviour prior to Sphinx 9.0. + It is based on the ``Documenter`` class hierarchy. + + This setting is provided for backwards compatibility if your documentation + or an extension you use uses or monkeypatches the legacy class-based API + in Python code. + If this is the case, set ``autodoc_use_legacy_class_based = True`` + in your :file:`conf.py`. + Please also add a comment to `the tracking issue on GitHub + `__ so that the maintainers + are aware of your use case, for possible future improvements. + + .. note:: The legacy class-based implementation does not support + PEP 695 type aliases. + .. confval:: autoclass_content :type: :code-py:`str` :default: :code-py:`'class'` @@ -1326,7 +1378,7 @@ Docstring preprocessing autodoc provides the following additional events: -.. event:: autodoc-process-docstring (app, what, name, obj, options, lines) +.. event:: autodoc-process-docstring (app, obj_type, name, obj, options, lines) .. versionadded:: 0.4 @@ -1335,15 +1387,14 @@ autodoc provides the following additional events: can modify **in place** to change what Sphinx puts into the output. :param app: the Sphinx application object - :param what: the type of the object which the docstring belongs to (one of - ``'module'``, ``'class'``, ``'exception'``, ``'function'``, ``'method'``, - ``'attribute'``) + :param obj_type: the type of the object which the docstring belongs to (one of + ``'module'``, ``'class'``, ``'exception'``, ``'function'``, ``'decorator'``, + ``'method'``, ``'property'``, ``'attribute'``, ``'data'``, or ``'type'``) :param name: the fully qualified name of the object :param obj: the object itself :param options: the options given to the directive: an object with attributes - ``inherited_members``, ``undoc_members``, ``show_inheritance`` and - ``no-index`` that are true if the flag option of same name was given to the - auto directive + corresponding to the options used in the auto directive, e.g. + ``inherited_members``, ``undoc_members``, or ``show_inheritance``. :param lines: the lines of the docstring, see above .. event:: autodoc-before-process-signature (app, obj, bound_method) @@ -1357,7 +1408,7 @@ autodoc provides the following additional events: :param obj: the object itself :param bound_method: a boolean indicates an object is bound method or not -.. event:: autodoc-process-signature (app, what, name, obj, options, signature, return_annotation) +.. event:: autodoc-process-signature (app, obj_type, name, obj, options, signature, return_annotation) .. versionadded:: 0.5 @@ -1366,20 +1417,19 @@ autodoc provides the following additional events: what Sphinx puts into the output. :param app: the Sphinx application object - :param what: the type of the object which the docstring belongs to (one of - ``'module'``, ``'class'``, ``'exception'``, ``'function'``, ``'method'``, - ``'attribute'``) + :param obj_type: the type of the object which the docstring belongs to (one of + ``'module'``, ``'class'``, ``'exception'``, ``'function'``, ``'decorator'``, + ``'method'``, ``'property'``, ``'attribute'``, ``'data'``, or ``'type'``) :param name: the fully qualified name of the object :param obj: the object itself :param options: the options given to the directive: an object with attributes - ``inherited_members``, ``undoc_members``, ``show_inheritance`` and - ``no-index`` that are true if the flag option of same name was given to the - auto directive + corresponding to the options used in the auto directive, e.g. + ``inherited_members``, ``undoc_members``, or ``show_inheritance``. :param signature: function signature, as a string of the form ``'(parameter_1, parameter_2)'``, or ``None`` if introspection didn't succeed and signature wasn't specified in the directive. :param return_annotation: function return annotation as a string of the form - ``' -> annotation'``, or ``None`` if there is no return annotation + ``'annotation'``, or ``''`` if there is no return annotation. The :mod:`sphinx.ext.autodoc` module provides factory functions for commonly needed docstring processing in event :event:`autodoc-process-docstring`: @@ -1387,17 +1437,17 @@ needed docstring processing in event :event:`autodoc-process-docstring`: .. autofunction:: cut_lines .. autofunction:: between -.. event:: autodoc-process-bases (app, name, obj, options, bases) +.. event:: autodoc-process-bases (app, name, obj, _unused, bases) Emitted when autodoc has read and processed a class to determine the base-classes. *bases* is a list of classes that the event handler can modify **in place** to change what Sphinx puts into the output. It's - emitted only if ``show-inheritance`` option given. + emitted only if the ``show-inheritance`` option is given. :param app: the Sphinx application object :param name: the fully qualified name of the object :param obj: the object itself - :param options: the options given to the class directive + :param _unused: unused placeholder :param bases: the list of base classes signature. see above. .. versionadded:: 4.1 @@ -1413,7 +1463,7 @@ Skipping members autodoc allows the user to define a custom method for determining whether a member should be included in the documentation by using the following event: -.. event:: autodoc-skip-member (app, what, name, obj, skip, options) +.. event:: autodoc-skip-member (app, obj_type, name, obj, skip, options) .. versionadded:: 0.5 @@ -1427,14 +1477,13 @@ member should be included in the documentation by using the following event: autodoc and other enabled extensions. :param app: the Sphinx application object - :param what: the type of the object which the docstring belongs to (one of - ``'module'``, ``'class'``, ``'exception'``, ``'function'``, ``'method'``, - ``'attribute'``) + :param obj_type: the type of the object which the docstring belongs to (one of + ``'module'``, ``'class'``, ``'exception'``, ``'function'``, ``'decorator'``, + ``'method'``, ``'property'``, ``'attribute'``, ``'data'``, or ``'type'``) :param name: the fully qualified name of the object :param obj: the object itself :param skip: a boolean indicating if autodoc will skip this member if the user handler does not override the decision :param options: the options given to the directive: an object with attributes - ``inherited_members``, ``undoc_members``, ``show_inheritance`` and - ``no-index`` that are true if the flag option of same name was given to the - auto directive + corresponding to the options used in the auto directive, e.g. + ``inherited_members``, ``undoc_members``, or ``show_inheritance``. diff --git a/doc/usage/extensions/autosectionlabel.rst b/doc/usage/extensions/autosectionlabel.rst index 1e9e1dba722..161b285a290 100644 --- a/doc/usage/extensions/autosectionlabel.rst +++ b/doc/usage/extensions/autosectionlabel.rst @@ -8,6 +8,9 @@ .. versionadded:: 1.4 +.. role:: code-py(code) + :language: Python + By default, cross-references to sections use labels (see :rst:role:`ref`). This extension allows you to instead refer to sections by their title. diff --git a/doc/usage/extensions/autosummary.rst b/doc/usage/extensions/autosummary.rst index 456faee1830..3b993348a78 100644 --- a/doc/usage/extensions/autosummary.rst +++ b/doc/usage/extensions/autosummary.rst @@ -107,7 +107,7 @@ The :mod:`sphinx.ext.autosummary` extension does this in two parts: How to display signatures. Valid values are - ``long`` (*default*): use a long signature. This is still cut off so that name - plus signature do not exceeed a certain length. + plus signature do not exceed a certain length. - ``short``: Function and class signatures are displayed as ``(…)`` if they have arguments and as ``()`` if they don't have arguments. - ``none``: do not show signatures. @@ -412,3 +412,27 @@ the title of a page. Stub pages are generated also based on these directives. .. _`escape filter`: https://jinja.palletsprojects.com/en/3.0.x/templates/#jinja-filters.escape + +Autolink role +------------- + +.. rst:role:: autolink + + The ``:autolink:`` role functions as ``:py:obj:`` when the referenced *name* + can be resolved to a Python object, and otherwise it becomes simple emphasis. + + There are some known design flaws. + For example, in the case of multiple objects having the same name, + :rst:role:`!autolink` could resolve to the wrong object. + It will fail silently if the referenced object is not found, + for example due to a spelling mistake or renaming. + This is sometimes unwanted behaviour. + + Some users choose to configure their :confval:`default_role` to ``autolink`` + for 'smart' referencing using the default interpreted text role (```content```). + + .. seealso:: + + :rst:role:`any` + + :rst:role:`py:obj` diff --git a/doc/usage/extensions/doctest.rst b/doc/usage/extensions/doctest.rst index 60c67827967..a418f1bf744 100644 --- a/doc/usage/extensions/doctest.rst +++ b/doc/usage/extensions/doctest.rst @@ -116,10 +116,10 @@ a comma-separated list of group names. Specify the required Python version for the example to be tested. For instance, in the following case the example will be tested only for Python versions greater - than 3.12:: + than 3.14:: .. doctest:: - :pyversion: > 3.12 + :pyversion: > 3.14 The following operands are supported: @@ -452,3 +452,11 @@ The doctest extension uses the following configuration values: Also, removal of ```` and ``# doctest:`` options only works in :rst:dir:`doctest` blocks, though you may set :confval:`trim_doctest_flags` to achieve that in all code blocks with Python console content. + +.. confval:: doctest_fail_fast + :type: :code-py:`bool` + :default: :code-py:`False` + + Exit when the first failure is encountered. + + .. versionadded:: 9.0 diff --git a/doc/usage/extensions/duration.rst b/doc/usage/extensions/duration.rst index 1213811daf0..eb7d66ccaaa 100644 --- a/doc/usage/extensions/duration.rst +++ b/doc/usage/extensions/duration.rst @@ -6,6 +6,87 @@ .. versionadded:: 2.4 -This extension measures durations of Sphinx processing and show its -result at end of the build. It is useful for inspecting what document -is slowly built. +This extension measures durations of Sphinx processing when reading +documents and is useful for inspecting what document is slowly built. +Durations are printed to console at the end of the build and saved +to a JSON file in the output directory by default. + +Enable this extension by adding ``'sphinx.ext.duration'`` to +the :confval:`extensions` list in your :file:`conf.py`: + +.. code-block:: python + + extensions = [ + ... + 'sphinx.ext.duration', + ] + + +Configuration +------------- + +.. confval:: duration_print_total + :type: :code-py:`bool` + :default: :code-py:`True` + + Show the total reading duration in the build summary, e.g.: + + .. code-block:: text + + ====================== total reading duration ========================== + Total time reading 31 files: 0m 3.142s + + .. versionadded:: 9.0 + +.. confval:: duration_print_slowest + :type: :code-py:`bool` + :default: :code-py:`True` + + Show the slowest durations in the build summary. + The durations are sorted in order from slowest to fastest. + This prints up to :confval:`duration_n_slowest` durations, e.g.: + + .. code-block:: text + + ====================== slowest 5 reading durations ======================= + 0.012s spam + 0.011s ham + 0.011s eggs + 0.006s lobster + 0.005s beans + + .. versionadded:: 9.0 + +.. confval:: duration_n_slowest + :type: :code-py:`int` + :default: :code-py:`5` + + Maximum number of slowest durations to show in the build summary + when :confval:`duration_print_slowest` is enabled. + By default, only the ``5`` slowest durations are shown. + Set this to ``0`` to show all durations. + + .. versionadded:: 9.0 + +.. confval:: duration_write_json + :type: :code-py:`str | None` + :default: :code-py:`'sphinx-reading-durations.json'` + + Write all reading durations to a JSON file in the output directory + The file contents are a map of the document names to reading durations, + where document names are strings and durations are floats in seconds. + Set this value to an empty string or ``None`` to disable writing the file, + or set it to a relative path to customize it. + + This may be useful for testing and setting a limit on reading times. + + .. versionadded:: 9.0 + +.. confval:: duration_limit + :type: :code-py:`float | int | None` + :default: :code-py:`None` + + Set a duration limit (in seconds) for reading a document. + If any duration exceeds this value, a warning is emitted. + + .. versionadded:: 9.0 diff --git a/doc/usage/extensions/math.rst b/doc/usage/extensions/math.rst index 6fa8ab851f8..f79ce23a5bf 100644 --- a/doc/usage/extensions/math.rst +++ b/doc/usage/extensions/math.rst @@ -196,12 +196,15 @@ are built: .. module:: sphinx.ext.mathjax :synopsis: Render math using JavaScript via MathJax. -.. warning:: - Version 4.0 changes the version of MathJax used to version 3. You may need to - override ``mathjax_path`` to - ``https://cdn.jsdelivr.net/npm/mathjax@2/MathJax.js?config=TeX-AMS-MML_HTMLorMML`` - or update your configuration options for version 3 - (see :confval:`mathjax3_config`). +.. attention:: + + The default version of MathJax changed + from version 2 to version 3 in Sphinx 4.0, and + from version 3 to version 4 in Sphinx 9.0. + + You may need to override :confval:`mathjax_path` to load an older version, + or update your :confval:`configuration options `. + In general, MathJax v3 and v4 options are compatible. .. versionadded:: 1.1 @@ -217,10 +220,17 @@ Sphinx but is set to automatically include it from a third-party site. You should use the math :rst:dir:`directive ` and :rst:role:`role `, not the native MathJax ``$$``, ``\(``, etc. +.. tip:: + + MathJax configuration can be supplied in a JavaScript file + by using the :confval:`mathjax_config_path` option. + This is useful for more complex configurations that are hard to express + only using a Python dictionary, for example JavaScript functions. + .. confval:: mathjax_path :type: :code-py:`str` - :default: :code-py:`'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js'` + :default: :code-py:`'https://cdn.jsdelivr.net/npm/mathjax@4/tex-mml-chtml.js'` The path to the JavaScript file to include in the HTML files in order to load MathJax. @@ -245,6 +255,24 @@ Sphinx but is set to automatically include it from a third-party site. You can also give a full ``https://`` URL different from the CDN URL. + .. versionchanged:: 4.0 + The default version of MathJax is now version 3. + To keep using MathJax v2, you must explicitly load it via this option. + For example: + + .. code-block:: python + + mathjax_path = 'https://cdn.jsdelivr.net/npm/mathjax@2/MathJax.js?config=TeX-AMS-MML_HTMLorMML' + + .. versionchanged:: 9.0 + The default version of MathJax is now version 4. + To keep using MathJax v3, you must explicitly load it via this option. + For example: + + .. code-block:: python + + mathjax_path = 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js' + .. confval:: mathjax_options :type: :code-py:`dict[str, Any]` :default: :code-py:`{}` @@ -263,16 +291,38 @@ Sphinx but is set to automatically include it from a third-party site. Allow to change the loading method (async or defer) of MathJax if "async" or "defer" key is set. -.. confval:: mathjax3_config +.. confval:: mathjax4_config :type: :code-py:`dict[str, Any] | None` :default: :code-py:`None` - The configuration options for MathJax v3 (which is used by default). + The configuration options for MathJax v4 (which is used by default). The given dictionary is assigned to the JavaScript variable ``window.MathJax``. For more information, please read `Configuring MathJax`__. - __ https://docs.mathjax.org/en/latest/web/configuration.html#configuration + __ https://docs.mathjax.org/en/stable/web/configuration.html#configuration + + + For help converting your old MathJax configuration to to the new + :confval:`mathjax4_config`, see `Converting your old Configuration to v4`__. + + __ https://docs.mathjax.org/en/stable/web/ + configuration.html#converting-your-old-configuration-to-v4 + + .. versionadded:: 9.0 + +.. confval:: mathjax3_config + :type: :code-py:`dict[str, Any] | None` + :default: :code-py:`None` + + The configuration options for MathJax v3 (which can be loaded via + :confval:`mathjax_path`). + If given, the dictionary is converted to a JSON object + and assigned to the JavaScript variable ``window.MathJax``. + + For more information, please read `Configuring MathJax`__. + + __ https://docs.mathjax.org/en/v3.2/web/configuration.html#configuration .. versionadded:: 4.0 @@ -285,7 +335,7 @@ Sphinx but is set to automatically include it from a third-party site. The value is used as a parameter of ``MathJax.Hub.Config()``. For more information, please read `Using in-line configuration options`__. - __ https://docs.mathjax.org/en/v2.7-latest/ + __ https://docs.mathjax.org/en/v2.7/ configuration.html#using-in-line-configuration-options For example:: @@ -295,6 +345,12 @@ Sphinx but is set to automatically include it from a third-party site. 'jax': ['input/TeX', 'output/HTML-CSS'], } + For help converting your old MathJax configuration to to the new + :confval:`mathjax3_config`, see `Converting Your v2 Configuration to v3`__. + + __ https://docs.mathjax.org/en/v3.2/web/ + configuration.html#converting-your-v2-configuration-to-v3 + .. versionadded:: 4.0 :confval:`mathjax_config` has been renamed to :confval:`mathjax2_config`. @@ -305,12 +361,6 @@ Sphinx but is set to automatically include it from a third-party site. Former name of :confval:`mathjax2_config`. - For help converting your old MathJax configuration to to the new - :confval:`mathjax3_config`, see `Converting Your v2 Configuration to v3`__. - - __ https://docs.mathjax.org/en/latest/web/ - configuration.html#converting-your-v2-configuration-to-v3 - .. versionadded:: 1.8 .. versionchanged:: 4.0 @@ -318,14 +368,47 @@ Sphinx but is set to automatically include it from a third-party site. This has been renamed to :confval:`mathjax2_config`. :confval:`mathjax_config` is still supported for backwards compatibility. -:mod:`sphinx.ext.jsmath` -- Render math via JavaScript ------------------------------------------------------- +.. confval:: mathjax_config_path + :type: :code-py:`str` + :default: :code-py:`''` + + If given, this must be the path of a JavaScript (:file:`.js`) file + (path relative to the :term:`configuration directory`) + that contains the configuration options for MathJax. + Example: + + .. code-block:: python + + mathjax_config_path = 'mathjax-config.js' + + .. important:: The user is responsible for ensuring that the given file + is compatible with the version of MathJax being used. -.. module:: sphinx.ext.jsmath + For more information, please read `Configuring MathJax`__. + + __ https://docs.mathjax.org/en/latest/web/configuration.html#configuration + + .. versionadded:: 9.0 + +:mod:`sphinxcontrib.jsmath` -- Render math via JavaScript +--------------------------------------------------------- + +.. module:: sphinxcontrib.jsmath :synopsis: Render math using JavaScript via JSMath. This extension works just as the MathJax extension does, but uses the older -package jsMath_. It provides this config value: +package jsMath_. jsMath is no longer actively developed, but it has the +advantage that the size of the JavaScript package is much smaller than +MathJax. + +.. versionadded:: 0.5 + The :mod:`!sphinx.ext.jsmath` extension. +.. versionchanged:: 2.0 + :mod:`!sphinx.ext.jsmath` was moved to :mod:`sphinxcontrib.jsmath`. +.. versionremoved:: 4.0 + The alias from :mod:`!sphinx.ext.jsmath` to :mod:`sphinxcontrib.jsmath`. + +Config value: .. confval:: jsmath_path :type: :code-py:`str` @@ -337,7 +420,7 @@ package jsMath_. It provides this config value: The path can be absolute or relative; if it is relative, it is relative to the ``_static`` directory of the built docs. - For example, if you put JSMath into the static path of the Sphinx docs, this + For example, if you put jsMath into the static path of the Sphinx docs, this value would be ``jsMath/easy/load.js``. If you host more than one Sphinx documentation set on one server, it is advisable to install jsMath in a shared location. @@ -347,5 +430,5 @@ package jsMath_. It provides this config value: .. _dvisvgm: https://dvisvgm.de/ .. _dvisvgm FAQ: https://dvisvgm.de/FAQ .. _MathJax: https://www.mathjax.org/ -.. _jsMath: https://www.math.union.edu/~dpvc/jsmath/ +.. _jsMath: https://www.math.union.edu/~dpvc/jsMath/ .. _LaTeX preview package: https://www.gnu.org/software/auctex/preview-latex.html diff --git a/doc/usage/installation.rst b/doc/usage/installation.rst index 8b0aca1cab3..f3d9f8aea60 100644 --- a/doc/usage/installation.rst +++ b/doc/usage/installation.rst @@ -56,7 +56,7 @@ Run the following command:: Or, if writing documentation for a Python package, place the dependencies in the `pyproject.toml file`__:: - $ pip install .[docs] + $ pip install . --group docs __ https://pip.pypa.io/en/stable/reference/requirements-file-format/ __ https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#dependencies-optional-dependencies @@ -152,18 +152,18 @@ Install either ``python3x-sphinx`` using :command:`port`: :: - $ sudo port install py313-sphinx + $ sudo port install py314-sphinx To set up the executable paths, use the ``port select`` command: :: - $ sudo port select --set python python313 - $ sudo port select --set sphinx py313-sphinx + $ sudo port select --set python python314 + $ sudo port select --set sphinx py314-sphinx For more information, refer to the `package overview`__. -__ https://www.macports.org/ports.php?by=library&substr=py313-sphinx +__ https://www.macports.org/ports.php?by=library&substr=py314-sphinx Windows ~~~~~~~ diff --git a/doc/usage/referencing.rst b/doc/usage/referencing.rst index 2597c9ce597..571d3c798bc 100644 --- a/doc/usage/referencing.rst +++ b/doc/usage/referencing.rst @@ -136,8 +136,8 @@ There is also a way to directly link to documents: .. rst:role:: doc - Link to the specified document; the document name can be specified in - absolute or relative fashion. For example, if the reference + Link to the specified document; the document name can be a relative or absolute + path and is always case-sensitive, even on Windows. For example, if the reference ``:doc:`parrot``` occurs in the document ``sketches/index``, then the link refers to ``sketches/parrot``. If the reference is ``:doc:`/people``` or ``:doc:`../people```, the link refers to ``people``. diff --git a/doc/usage/restructuredtext/basics.rst b/doc/usage/restructuredtext/basics.rst index 5d60ea81de4..8f408f45e38 100644 --- a/doc/usage/restructuredtext/basics.rst +++ b/doc/usage/restructuredtext/basics.rst @@ -208,11 +208,39 @@ Hyperlinks External links ~~~~~~~~~~~~~~ -Use ```Link text `_`` for inline web links. If the -link text should be the web address, you don't need special markup at all, the -parser finds links and mail addresses in ordinary text. +URLs and email addresses in text are automatically linked and do not need +explicit markup at all. +For example, https://domain.invalid/ is written with no special markup +in the source of this document, and is recognised as an external hyperlink. -.. important:: There must be a space between the link text and the opening \< for the URL. +To create text with a link, the best approach is generally to put the URL +below the paragraph as follows (:duref:`ref `):: + + This is a paragraph that contains `a link`_. + + .. _a link: https://domain.invalid/ + +This keeps the paragraph more readable in source code. + +Alternatively, you can embed the URL within the prose for an 'inline link'. +This can lead to longer lines, but has the benefit of keeping the link text +and the URL pointed to in the same place. +This uses the following syntax: ```Link text `__`` +(:duref:`ref `). + +.. important:: + + There must be a space between the link text + and the opening angle bracket ('``<``') for the URL. + +.. tip:: + + Use two trailing underscores when embedding the URL. + Technically, a single underscore works as well, + but that would create a named reference instead of an anonymous one. + Named references typically do not have a benefit when the URL is embedded. + Moreover, they have the disadvantage that you must make sure that you + do not use the same "Link text" for another link in your document. You can also separate the link and the target definition (:duref:`ref `), like this:: @@ -618,10 +646,11 @@ configurations: Source encoding --------------- -Since the easiest way to include special characters like em dashes or copyright -signs in reStructuredText is to directly write them as Unicode characters, one has to -specify an encoding. Sphinx assumes source files to be encoded in UTF-8 by -default; you can change this with the :confval:`source_encoding` config value. +Sphinx supports source files that are encoded in UTF-8. +This means that the full range of Unicode__ characters may be used +directly in reStructuredText. + +__ https://www.unicode.org/ Gotchas diff --git a/doc/usage/restructuredtext/directives.rst b/doc/usage/restructuredtext/directives.rst index 33269b522a6..4b0d9d128e4 100644 --- a/doc/usage/restructuredtext/directives.rst +++ b/doc/usage/restructuredtext/directives.rst @@ -473,8 +473,8 @@ and the generic :rst:dir:`admonition` directive. .. seealso:: - Module :py:mod:`zipfile` - Documentation of the :py:mod:`zipfile` standard module. + Python's :py:mod:`zipfile` module + Documentation of Python's standard :py:mod:`zipfile` module. `GNU tar manual, Basic Tar Format `_ Documentation for tar archive files, including GNU tar extensions. @@ -537,7 +537,8 @@ Describing changes between versions pair: changes; in version pair: removed; in version -.. rst:directive:: .. versionadded:: version [brief explanation] +.. rst:directive:: .. version-added:: version [brief explanation] + .. versionadded:: version [brief explanation] This directive documents the version of the project which added the described feature. @@ -551,56 +552,75 @@ Describing changes between versions There must be no blank line between the directive head and the explanation; this is to make these blocks visually continuous in the markup. + .. version-changed:: 9.0 + The :rst:dir:`versionadded` directive was renamed to :rst:dir:`version-added`. + The previous name is retained as an alias. + Example:: - .. versionadded:: 2.5 + .. version-added:: 2.5 The *spam* parameter. - .. versionadded:: 2.5 + .. version-added:: 2.5 The *spam* parameter. -.. rst:directive:: .. versionchanged:: version [brief explanation] +.. rst:directive:: .. version-changed:: version [brief explanation] + .. versionchanged:: version [brief explanation] - Similar to :rst:dir:`versionadded`, but describes when and what changed in + Similar to :rst:dir:`version-added`, but describes when and what changed in the named feature in some way (new parameters, changed side effects, etc.). + .. version-changed:: 9.0 + The :rst:dir:`versionchanged` directive was renamed to :rst:dir:`version-changed`. + The previous name is retained as an alias. + Example:: - .. versionchanged:: 2.8 + .. version-changed:: 2.8 The *spam* parameter is now of type *boson*. - .. versionchanged:: 2.8 + .. version-changed:: 2.8 The *spam* parameter is now of type *boson*. -.. rst:directive:: .. deprecated:: version [brief explanation] +.. rst:directive:: .. version-deprecated:: version [brief explanation] + .. deprecated:: version [brief explanation] - Similar to :rst:dir:`versionadded`, but describes when the feature was + Similar to :rst:dir:`version-added`, but describes when the feature was deprecated. A *brief* explanation can also be given, for example to tell the reader what to use instead. + .. version-changed:: 9.0 + The :rst:dir:`deprecated` directive was renamed to :rst:dir:`version-deprecated`. + The previous name is retained as an alias + Example:: - .. deprecated:: 3.1 + .. version-deprecated:: 3.1 Use :py:func:`spam` instead. - .. deprecated:: 3.1 + .. version-deprecated:: 3.1 Use :py:func:`!spam` instead. -.. rst:directive:: .. versionremoved:: version [brief explanation] +.. rst:directive:: .. version-removed:: version [brief explanation] + .. versionremoved:: version [brief explanation] - Similar to :rst:dir:`versionadded`, but describes when the feature was removed. + Similar to :rst:dir:`version-added`, but describes when the feature was removed. An explanation may be provided to tell the reader what to use instead, or why the feature was removed. - .. versionadded:: 7.3 + .. version-added:: 7.3 + + .. version-changed:: 9.0 + The :rst:dir:`versionremoved` directive was renamed to :rst:dir:`version-removed`. + The previous name is retained as an alias. Example:: - .. versionremoved:: 4.0 + .. version-removed:: 4.0 The :py:func:`spam` function is more flexible, and should be used instead. - .. versionremoved:: 4.0 + .. version-removed:: 4.0 The :py:func:`!spam` function is more flexible, and should be used instead. @@ -971,7 +991,7 @@ __ https://pygments.org/docs/lexers :type: text Explicitly specify the encoding of the file. - This overwrites the default encoding (:confval:`source_encoding`). + This overwrites the default encoding (UTF-8). For example: .. code-block:: rst @@ -1472,11 +1492,20 @@ Check the :confval:`latex_table_style`. complex contents such as multiple paragraphs, blockquotes, lists, literal blocks, will render correctly to LaTeX output. +.. versionchanged:: 9.0 + The partial support of the LaTeX builder for nesting a table in another + has been extended. + Formerly Sphinx would raise an error if ``longtable`` class was specified + for a table containing a nested table, and some cases would not raise an + error at Sphinx level but fail at LaTeX level during PDF build. This is a + complex topic in LaTeX rendering and the output can sometimes be improved + via the :rst:dir:`tabularcolumns` directive. + .. rst:directive:: .. tabularcolumns:: column spec - This directive influences only the LaTeX output for the next table in - source. The mandatory argument is a column specification (known as an - "alignment preamble" in LaTeX idiom). Please refer to a LaTeX + This directive influences only the LaTeX output, and only for the next + table in source. The mandatory argument is a column specification (known + as an "alignment preamble" in LaTeX idiom). Please refer to a LaTeX documentation, such as the `wiki page`_, for basics of such a column specification. @@ -1484,52 +1513,85 @@ Check the :confval:`latex_table_style`. .. versionadded:: 0.3 + Sphinx renders tables with at most 30 rows using ``tabulary`` (or + ``tabular`` if at least one cell contains either a code-block or a nested + table), and those with more rows with ``longtable``. The advantage of + using ``tabulary`` is that it tries to compute automatically (internally to + LaTeX) suitable column widths. + + The ``tabulary`` algorithm often works well, but in some cases when a cell + contains long paragraphs, the column will be given a large width and other + columns whose cells contain only single words may end up too narrow. The + :rst:dir:`tabularcolumns` can help solve this via providing to LaTeX a + custom "alignment preamble" (aka "colspec"). For example ``lJJ`` will be + suitable for a three-columns table whose first column contains only single + words and the other two have cells with long paragraphs. + .. note:: - :rst:dir:`tabularcolumns` conflicts with ``:widths:`` option of table - directives. If both are specified, ``:widths:`` option will be ignored. + Of course, a fully automated solution would be better, and it is still + hoped for, but it is an intrinsic aspect of ``tabulary``, and the latter + is in use by Sphinx ever since ``0.3``... It looks as if solving the + problem of squeezed columns could require substantial changes to that + LaTeX package. And no good alternative appears to exist, as of 2025. - Sphinx will render tables with more than 30 rows with ``longtable``. - Besides the ``l``, ``r``, ``c`` and ``p{width}`` column specifiers, one can - also use ``\X{a}{b}`` (new in version 1.5) which configures the column - width to be a fraction ``a/b`` of the total line width and ``\Y{f}`` (new - in version 1.6) where ``f`` is a decimal: for example ``\Y{0.2}`` means that - the column will occupy ``0.2`` times the line width. + .. hint:: - When this directive is used for a table with at most 30 rows, Sphinx will - render it with ``tabulary``. One can then use specific column types ``L`` - (left), ``R`` (right), ``C`` (centered) and ``J`` (justified). They have - the effect of a ``p{width}`` (i.e. each cell is a LaTeX ``\parbox``) with - the specified internal text alignment and an automatically computed - ``width``. + A way to solve the issue for all tables at once, is to inject in the + LaTeX preamble (see :confval:`latex_elements`) a command such as + ``\setlength{\tymin}{1cm}`` which causes all columns to be at least + ``1cm`` wide (not counting inter-column whitespace). Currently, Sphinx + configures ``\tymin`` to allow room for three characters at least. - .. warning:: + Here is a more sophisticated "colspec", for a 4-columns table: - - Cells that contain list-like elements such as object descriptions, - blockquotes or any kind of lists are not compatible with the ``LRCJ`` - column types. The column type must then be some ``p{width}`` with an - explicit ``width`` (or ``\X{a}{b}`` or ``\Y{f}``). + .. code-block:: latex - - Literal blocks do not work with ``tabulary`` at all. Sphinx will - fall back to ``tabular`` or ``longtable`` environments and generate a - suitable column specification. + .. tabularcolumns:: >{\raggedright}\Y{.4}>{\centering}\Y{.1}>{\sphinxcolorblend{!95!red}\centering\noindent\bfseries\color{red}}\Y{.12}>{\raggedright\arraybackslash}\Y{.38} -In absence of the :rst:dir:`tabularcolumns` directive, and for a table with at -most 30 rows and no problematic cells as described in the above warning, -Sphinx uses ``tabulary`` and the ``J`` column-type for every column. + This is used in Sphinx own PDF docs at :ref:`dev-deprecated-apis`. + Regarding column widths, this "colspec" achieves the same as would + ``:widths:`` option set to ``40 10 12 38`` but it injects extra effects. -.. versionchanged:: 1.6 + .. note:: - Formerly, the ``L`` column-type was used (text is flushed-left). To revert - to this, include ``\newcolumntype{T}{L}`` in the LaTeX preamble, as in fact - Sphinx uses ``T`` and sets it by default to be an alias of ``J``. + In case both :rst:dir:`tabularcolumns` and ``:widths:`` option of table + directives are used, ``:widths:`` option will be ignored by the LaTeX + builder. Of course it is obeyed by other builders. -.. hint:: + Literal blocks do not work at all with ``tabulary`` and Sphinx will then + fall back to ``tabular`` LaTeX environment. It will employ the + :rst:dir:`tabularcolumns` specification in that case only if it contains no + usage of the ``tabulary`` specific column types (which are ``L``, ``R``, + ``C`` and ``J``). + + Besides the LaTeX ``l``, ``r``, ``c`` and ``p{width}`` column specifiers, + and the ``tabulary`` specific ``L``, ``R``, ``C`` and ``J``, one can also + use (with all table types) ``\X{a}{b}`` which configures the column width + to be a fraction ``a/b`` of the total line width and ``\Y{f}`` where ``f`` + is a decimal: for example ``\Y{0.2}`` means that the column will occupy + ``0.2`` times the line width. + +.. versionchanged:: 1.6 - A frequent issue with ``tabulary`` is that columns with little contents - appear to be "squeezed". One can add to the LaTeX preamble for example - ``\setlength{\tymin}{40pt}`` to ensure a minimal column width of ``40pt``, - the ``tabulary`` default of ``10pt`` being too small. + Sphinx uses ``J`` (justified) by default with ``tabulary``, not ``L`` + (flushed-left). To revert, include ``\newcolumntype{T}{L}`` in the LaTeX + preamble, as in fact Sphinx uses ``T`` and sets it by default to be an + alias of ``J``. + +.. versionchanged:: 9.0 + + Formerly, Sphinx did not use ``tabulary`` if the table had at least one + cell containing "problematic" elements such as lists, object descriptions, + blockquotes (etc...) because such contents are not out-of-the-box + compatible with ``tabulary``. At ``9.0`` a technique, which was already + in use for merged cells, was extended to such cases, and the sole + "problematic" contents are code-blocks and nested tables. So tables + containing (only) cells with multiple paragraphs, bullet or enumerated + lists, or line blocks, will now better fit to their contents (if not + rendered by ``longtable``). Cells with object descriptions or admonitions + will still have a tendency to induce the table to fill the full text area + width, but columns in that table with no such contents will be tighter. .. hint:: @@ -1664,7 +1726,7 @@ There is this directive: Multiple production lists with the same *production_group* thus define rules in the same scope. This can also be used to split the description of a long or complex grammar - accross multiple ``productionlist`` directives with the same *production_group*. + across multiple ``productionlist`` directives with the same *production_group*. The definition can contain token names which are marked as interpreted text, (e.g. "``sum ::= `integer` "+" `integer```"), diff --git a/package-lock.json b/package-lock.json index 7f582fb94cb..9daf18d1a4f 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,26 +1,28 @@ { "name": "sphinx", - "lockfileVersion": 2, + "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "sphinx", "devDependencies": { - "jasmine-browser-runner": "^2.5.0", - "jasmine-core": "^5.2.0" + "jasmine-browser-runner": "^3.0.0", + "jasmine-core": "^5.12.0" } }, "node_modules/@bazel/runfiles": { - "version": "5.8.1", - "resolved": "https://registry.npmjs.org/@bazel/runfiles/-/runfiles-5.8.1.tgz", - "integrity": "sha512-NDdfpdQ6rZlylgv++iMn5FkObC/QlBQvipinGLSOguTYpRywmieOyJ29XHvUilspwTFSILWpoE9CqMGkHXug1g==", - "dev": true + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/@bazel/runfiles/-/runfiles-6.5.0.tgz", + "integrity": "sha512-RzahvqTkfpY2jsDxo8YItPX+/iZ6hbiikw1YhE0bA9EKBR5Og8Pa6FHn9PO9M0zaXRVsr0GFQLKbB/0rzy9SzA==", + "dev": true, + "license": "Apache-2.0" }, "node_modules/@isaacs/cliui": { "version": "8.0.2", "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz", "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==", "dev": true, + "license": "ISC", "dependencies": { "string-width": "^5.1.2", "string-width-cjs": "npm:string-width@^4.2.0", @@ -33,182 +35,104 @@ "node": ">=12" } }, - "node_modules/@isaacs/cliui/node_modules/ansi-regex": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.0.1.tgz", - "integrity": "sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA==", - "dev": true, - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/chalk/ansi-regex?sponsor=1" - } - }, - "node_modules/@isaacs/cliui/node_modules/ansi-styles": { - "version": "6.2.1", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz", - "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==", - "dev": true, - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" - } - }, - "node_modules/@isaacs/cliui/node_modules/emoji-regex": { - "version": "9.2.2", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", - "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==", - "dev": true - }, - "node_modules/@isaacs/cliui/node_modules/string-width": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", - "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==", - "dev": true, - "dependencies": { - "eastasianwidth": "^0.2.0", - "emoji-regex": "^9.2.2", - "strip-ansi": "^7.0.1" - }, - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/@isaacs/cliui/node_modules/strip-ansi": { - "version": "7.1.0", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz", - "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==", - "dev": true, - "dependencies": { - "ansi-regex": "^6.0.1" - }, - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/chalk/strip-ansi?sponsor=1" - } - }, - "node_modules/@isaacs/cliui/node_modules/wrap-ansi": { - "version": "8.1.0", - "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz", - "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==", - "dev": true, - "dependencies": { - "ansi-styles": "^6.1.0", - "string-width": "^5.0.1", - "strip-ansi": "^7.0.1" - }, - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/chalk/wrap-ansi?sponsor=1" - } - }, "node_modules/@pkgjs/parseargs": { "version": "0.11.0", "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz", "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==", "dev": true, + "license": "MIT", "optional": true, "engines": { "node": ">=14" } }, "node_modules/accepts": { - "version": "1.3.8", - "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz", - "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==", + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz", + "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==", "dev": true, + "license": "MIT", "dependencies": { - "mime-types": "~2.1.34", - "negotiator": "0.6.3" + "mime-types": "^3.0.0", + "negotiator": "^1.0.0" }, "engines": { "node": ">= 0.6" } }, "node_modules/ansi-regex": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", - "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz", + "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==", "dev": true, + "license": "MIT", "engines": { - "node": ">=8" + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" } }, "node_modules/ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", "dev": true, - "dependencies": { - "color-convert": "^2.0.1" - }, + "license": "MIT", "engines": { - "node": ">=8" + "node": ">=12" }, "funding": { "url": "https://github.com/chalk/ansi-styles?sponsor=1" } }, - "node_modules/array-flatten": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz", - "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==", - "dev": true - }, "node_modules/async": { - "version": "3.2.5", - "resolved": "https://registry.npmjs.org/async/-/async-3.2.5.tgz", - "integrity": "sha512-baNZyqaaLhyLVKm/DlvdW051MSgO6b8eVfIezl9E5PqWxFgzLm/wQntEW4zOytVburDEr0JlALEpdOFwvErLsg==", - "dev": true + "version": "3.2.6", + "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", + "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", + "dev": true, + "license": "MIT" }, "node_modules/balanced-match": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/body-parser": { - "version": "1.20.3", - "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.3.tgz", - "integrity": "sha512-7rAxByjUMqQ3/bHJy7D6OGXvx/MMc4IqBn/X0fcM1QUcAItpZrBEYhWGem+tzXH90c+G01ypMcYJBO9Y30203g==", + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.2.1.tgz", + "integrity": "sha512-nfDwkulwiZYQIGwxdy0RUmowMhKcFVcYXUU7m4QlKYim1rUtg83xm2yjZ40QjDuc291AJjjeSc9b++AWHSgSHw==", "dev": true, + "license": "MIT", "dependencies": { - "bytes": "3.1.2", - "content-type": "~1.0.5", - "debug": "2.6.9", - "depd": "2.0.0", - "destroy": "1.2.0", - "http-errors": "2.0.0", - "iconv-lite": "0.4.24", - "on-finished": "2.4.1", - "qs": "6.13.0", - "raw-body": "2.5.2", - "type-is": "~1.6.18", - "unpipe": "1.0.0" + "bytes": "^3.1.2", + "content-type": "^1.0.5", + "debug": "^4.4.3", + "http-errors": "^2.0.0", + "iconv-lite": "^0.7.0", + "on-finished": "^2.4.1", + "qs": "^6.14.0", + "raw-body": "^3.0.1", + "type-is": "^2.0.1" }, "engines": { - "node": ">= 0.8", - "npm": "1.2.8000 || >= 1.4.16" + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" } }, "node_modules/brace-expansion": { - "version": "1.1.11", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", - "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==", + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz", + "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==", "dev": true, + "license": "MIT", "dependencies": { - "balanced-match": "^1.0.0", - "concat-map": "0.0.1" + "balanced-match": "^1.0.0" } }, "node_modules/bytes": { @@ -216,43 +140,40 @@ "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.8" } }, - "node_modules/call-bind": { - "version": "1.0.7", - "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.7.tgz", - "integrity": "sha512-GHTSNSYICQ7scH7sZ+M2rFopRoLh8t2bLSW6BbgrtLsahOIB5iyAVJf9GjWK3cYTDaMj4XdBpM1cA6pIS0Kv2w==", + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", "dev": true, + "license": "MIT", "dependencies": { - "es-define-property": "^1.0.0", "es-errors": "^1.3.0", - "function-bind": "^1.1.2", - "get-intrinsic": "^1.2.4", - "set-function-length": "^1.2.1" + "function-bind": "^1.1.2" }, "engines": { "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" } }, - "node_modules/chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "node_modules/call-bound": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz", + "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==", "dev": true, + "license": "MIT", "dependencies": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" + "call-bind-apply-helpers": "^1.0.2", + "get-intrinsic": "^1.3.0" }, "engines": { - "node": ">=10" + "node": ">= 0.4" }, "funding": { - "url": "https://github.com/chalk/chalk?sponsor=1" + "url": "https://github.com/sponsors/ljharb" } }, "node_modules/color-convert": { @@ -260,6 +181,7 @@ "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", "dev": true, + "license": "MIT", "dependencies": { "color-name": "~1.1.4" }, @@ -271,24 +193,21 @@ "version": "1.1.4", "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "dev": true - }, - "node_modules/concat-map": { - "version": "0.0.1", - "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/content-disposition": { - "version": "0.5.4", - "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz", - "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==", + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.0.1.tgz", + "integrity": "sha512-oIXISMynqSqm241k6kcQ5UwttDILMK4BiurCfGEREw6+X9jkkpEe5T9FZaApyLGGOnFuyMWZpdolTXMtvEJ08Q==", "dev": true, - "dependencies": { - "safe-buffer": "5.2.1" - }, + "license": "MIT", "engines": { - "node": ">= 0.6" + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" } }, "node_modules/content-type": { @@ -296,36 +215,44 @@ "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz", "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.6" } }, "node_modules/cookie": { - "version": "0.7.1", - "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.1.tgz", - "integrity": "sha512-6DnInpx7SJ2AK3+CTUE/ZM0vWTUboZCegxhC2xiIydHR9jNuTAASBrfEpHhiGOZw/nX51bHt6YQl8jsGo4y/0w==", + "version": "0.7.2", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz", + "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.6" } }, "node_modules/cookie-signature": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz", - "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==", - "dev": true + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.2.2.tgz", + "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.6.0" + } }, "node_modules/core-util-is": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz", "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/cross-spawn": { - "version": "7.0.3", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz", - "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==", + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", "dev": true, + "license": "MIT", "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", @@ -336,29 +263,21 @@ } }, "node_modules/debug": { - "version": "2.6.9", - "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", - "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", - "dev": true, - "dependencies": { - "ms": "2.0.0" - } - }, - "node_modules/define-data-property": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz", - "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==", + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", "dev": true, + "license": "MIT", "dependencies": { - "es-define-property": "^1.0.0", - "es-errors": "^1.3.0", - "gopd": "^1.0.1" + "ms": "^2.1.3" }, "engines": { - "node": ">= 0.4" + "node": ">=6.0" }, - "funding": { - "url": "https://github.com/sponsors/ljharb" + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } } }, "node_modules/depd": { @@ -366,37 +285,46 @@ "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz", "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.8" } }, - "node_modules/destroy": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz", - "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==", + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, "engines": { - "node": ">= 0.8", - "npm": "1.2.8000 || >= 1.4.16" + "node": ">= 0.4" } }, "node_modules/eastasianwidth": { "version": "0.2.0", "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz", "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/ee-first": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/ejs": { "version": "3.1.10", "resolved": "https://registry.npmjs.org/ejs/-/ejs-3.1.10.tgz", "integrity": "sha512-UeJmFfOrAQS8OJWPZ4qtgHyWExa088/MtK5UEyoJGFH67cDEXkZSviOiKRCZ4Xij0zxI3JECgYs3oKx+AizQBA==", "dev": true, + "license": "Apache-2.0", "dependencies": { "jake": "^10.8.5" }, @@ -408,28 +336,28 @@ } }, "node_modules/emoji-regex": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", - "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", - "dev": true + "version": "9.2.2", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", + "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==", + "dev": true, + "license": "MIT" }, "node_modules/encodeurl": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz", "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.8" } }, "node_modules/es-define-property": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.0.tgz", - "integrity": "sha512-jxayLKShrEqqzJ0eumQbVhTYQM27CfT1T35+gCgDFoL82JLsXqTJ76zv6A0YLOgEnLUMvLzsDsGIrl8NFpT2gQ==", + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", "dev": true, - "dependencies": { - "get-intrinsic": "^1.2.4" - }, + "license": "MIT", "engines": { "node": ">= 0.4" } @@ -439,6 +367,20 @@ "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", + "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, "engines": { "node": ">= 0.4" } @@ -447,57 +389,60 @@ "version": "1.0.3", "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/etag": { "version": "1.8.1", "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.6" } }, "node_modules/express": { - "version": "4.21.1", - "resolved": "https://registry.npmjs.org/express/-/express-4.21.1.tgz", - "integrity": "sha512-YSFlK1Ee0/GC8QaO91tHcDxJiE/X4FbpAyQWkxAvG6AXCuR65YzK8ua6D9hvi/TzUfZMpc+BwuM1IPw8fmQBiQ==", - "dev": true, - "dependencies": { - "accepts": "~1.3.8", - "array-flatten": "1.1.1", - "body-parser": "1.20.3", - "content-disposition": "0.5.4", - "content-type": "~1.0.4", - "cookie": "0.7.1", - "cookie-signature": "1.0.6", - "debug": "2.6.9", - "depd": "2.0.0", - "encodeurl": "~2.0.0", - "escape-html": "~1.0.3", - "etag": "~1.8.1", - "finalhandler": "1.3.1", - "fresh": "0.5.2", - "http-errors": "2.0.0", - "merge-descriptors": "1.0.3", - "methods": "~1.1.2", - "on-finished": "2.4.1", - "parseurl": "~1.3.3", - "path-to-regexp": "0.1.10", - "proxy-addr": "~2.0.7", - "qs": "6.13.0", - "range-parser": "~1.2.1", - "safe-buffer": "5.2.1", - "send": "0.19.0", - "serve-static": "1.16.2", - "setprototypeof": "1.2.0", - "statuses": "2.0.1", - "type-is": "~1.6.18", - "utils-merge": "1.0.1", - "vary": "~1.1.2" - }, - "engines": { - "node": ">= 0.10.0" + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/express/-/express-5.1.0.tgz", + "integrity": "sha512-DT9ck5YIRU+8GYzzU5kT3eHGA5iL+1Zd0EutOmTE9Dtk+Tvuzd23VBU+ec7HPNSTxXYO55gPV/hq4pSBJDjFpA==", + "dev": true, + "license": "MIT", + "dependencies": { + "accepts": "^2.0.0", + "body-parser": "^2.2.0", + "content-disposition": "^1.0.0", + "content-type": "^1.0.5", + "cookie": "^0.7.1", + "cookie-signature": "^1.2.1", + "debug": "^4.4.0", + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "etag": "^1.8.1", + "finalhandler": "^2.1.0", + "fresh": "^2.0.0", + "http-errors": "^2.0.0", + "merge-descriptors": "^2.0.0", + "mime-types": "^3.0.0", + "on-finished": "^2.4.1", + "once": "^1.4.0", + "parseurl": "^1.3.3", + "proxy-addr": "^2.0.7", + "qs": "^6.14.0", + "range-parser": "^1.2.1", + "router": "^2.2.0", + "send": "^1.1.0", + "serve-static": "^2.2.0", + "statuses": "^2.0.1", + "type-is": "^2.0.1", + "vary": "^1.1.2" + }, + "engines": { + "node": ">= 18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" } }, "node_modules/filelist": { @@ -505,24 +450,17 @@ "resolved": "https://registry.npmjs.org/filelist/-/filelist-1.0.4.tgz", "integrity": "sha512-w1cEuf3S+DrLCQL7ET6kz+gmlJdbq9J7yXCSjK/OZCPA+qEN1WyF4ZAf0YYJa4/shHJra2t/d/r8SV4Ji+x+8Q==", "dev": true, + "license": "Apache-2.0", "dependencies": { "minimatch": "^5.0.1" } }, - "node_modules/filelist/node_modules/brace-expansion": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", - "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", - "dev": true, - "dependencies": { - "balanced-match": "^1.0.0" - } - }, "node_modules/filelist/node_modules/minimatch": { "version": "5.1.6", "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.6.tgz", "integrity": "sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g==", "dev": true, + "license": "ISC", "dependencies": { "brace-expansion": "^2.0.1" }, @@ -531,30 +469,31 @@ } }, "node_modules/finalhandler": { - "version": "1.3.1", - "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.1.tgz", - "integrity": "sha512-6BN9trH7bp3qvnrRyzsBz+g3lZxTNZTbVO2EV1CS0WIcDbawYVdYvGflME/9QP0h0pYlCDBCTjYa9nZzMDpyxQ==", + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.0.tgz", + "integrity": "sha512-/t88Ty3d5JWQbWYgaOGCCYfXRwV1+be02WqYYlL6h0lEiUAMPM8o8qKGO01YIkOHzka2up08wvgYD0mDiI+q3Q==", "dev": true, + "license": "MIT", "dependencies": { - "debug": "2.6.9", - "encodeurl": "~2.0.0", - "escape-html": "~1.0.3", - "on-finished": "2.4.1", - "parseurl": "~1.3.3", - "statuses": "2.0.1", - "unpipe": "~1.0.0" + "debug": "^4.4.0", + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "on-finished": "^2.4.1", + "parseurl": "^1.3.3", + "statuses": "^2.0.1" }, "engines": { "node": ">= 0.8" } }, "node_modules/foreground-child": { - "version": "3.3.0", - "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.0.tgz", - "integrity": "sha512-Ld2g8rrAyMYFXBhEqMz8ZAHBi4J4uS1i/CxGMDnjyFWddMXLVcDp051DZfu+t7+ab7Wv6SMqpWmyFIj5UbfFvg==", + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz", + "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==", "dev": true, + "license": "ISC", "dependencies": { - "cross-spawn": "^7.0.0", + "cross-spawn": "^7.0.6", "signal-exit": "^4.0.1" }, "engines": { @@ -569,17 +508,19 @@ "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz", "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.6" } }, "node_modules/fresh": { - "version": "0.5.2", - "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz", - "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==", + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz", + "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==", "dev": true, + "license": "MIT", "engines": { - "node": ">= 0.6" + "node": ">= 0.8" } }, "node_modules/function-bind": { @@ -587,21 +528,28 @@ "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", "dev": true, + "license": "MIT", "funding": { "url": "https://github.com/sponsors/ljharb" } }, "node_modules/get-intrinsic": { - "version": "1.2.4", - "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.2.4.tgz", - "integrity": "sha512-5uYhsJH8VJBTv7oslg4BznJYhDoRI6waYCxMmCdnTrcCrHA/fCFKoTFz2JKKE0HdDFUF7/oQuhzumXJK7paBRQ==", + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", "dev": true, + "license": "MIT", "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", "function-bind": "^1.1.2", - "has-proto": "^1.0.1", - "has-symbols": "^1.0.3", - "hasown": "^2.0.0" + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" }, "engines": { "node": ">= 0.4" @@ -610,44 +558,47 @@ "url": "https://github.com/sponsors/ljharb" } }, - "node_modules/gopd": { + "node_modules/get-proto": { "version": "1.0.1", - "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.0.1.tgz", - "integrity": "sha512-d65bNlIadxvpb/A2abVdlqKqV563juRnZ1Wtk6s1sIR8uNsXR70xqIzVqxVf1eTqDunwT2MkczEeaezCKTZhwA==", + "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", "dev": true, + "license": "MIT", "dependencies": { - "get-intrinsic": "^1.1.3" + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", - "dev": true, "engines": { - "node": ">=8" + "node": ">= 0.4" } }, - "node_modules/has-property-descriptors": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz", - "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==", + "node_modules/glob": { + "version": "10.5.0", + "resolved": "https://registry.npmjs.org/glob/-/glob-10.5.0.tgz", + "integrity": "sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==", "dev": true, + "license": "ISC", "dependencies": { - "es-define-property": "^1.0.0" + "foreground-child": "^3.1.0", + "jackspeak": "^3.1.2", + "minimatch": "^9.0.4", + "minipass": "^7.1.2", + "package-json-from-dist": "^1.0.0", + "path-scurry": "^1.11.1" + }, + "bin": { + "glob": "dist/esm/bin.mjs" }, "funding": { - "url": "https://github.com/sponsors/ljharb" + "url": "https://github.com/sponsors/isaacs" } }, - "node_modules/has-proto": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.0.3.tgz", - "integrity": "sha512-SJ1amZAJUiZS+PhsVLf5tGydlaVB8EdFpaSO4gmiUKUOxk8qzn5AIy4ZeJUmh22znIdk/uMAUT2pl3FxzVUH+Q==", + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.4" }, @@ -656,10 +607,11 @@ } }, "node_modules/has-symbols": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.0.3.tgz", - "integrity": "sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==", + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.4" }, @@ -672,6 +624,7 @@ "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", "dev": true, + "license": "MIT", "dependencies": { "function-bind": "^1.1.2" }, @@ -680,50 +633,63 @@ } }, "node_modules/http-errors": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz", - "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz", + "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==", "dev": true, + "license": "MIT", "dependencies": { - "depd": "2.0.0", - "inherits": "2.0.4", - "setprototypeof": "1.2.0", - "statuses": "2.0.1", - "toidentifier": "1.0.1" + "depd": "~2.0.0", + "inherits": "~2.0.4", + "setprototypeof": "~1.2.0", + "statuses": "~2.0.2", + "toidentifier": "~1.0.1" }, "engines": { "node": ">= 0.8" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" } }, "node_modules/iconv-lite": { - "version": "0.4.24", - "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz", - "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==", + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.0.tgz", + "integrity": "sha512-cf6L2Ds3h57VVmkZe+Pn+5APsT7FpqJtEhhieDCvrE2MK5Qk9MyffgQyuxQTm6BChfeZNtcOLHp9IcWRVcIcBQ==", "dev": true, + "license": "MIT", "dependencies": { - "safer-buffer": ">= 2.1.2 < 3" + "safer-buffer": ">= 2.1.2 < 3.0.0" }, "engines": { "node": ">=0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" } }, "node_modules/immediate": { "version": "3.0.6", "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz", "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/inherits": { "version": "2.0.4", "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/ipaddr.js": { "version": "1.9.1", "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz", "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.10" } @@ -733,27 +699,38 @@ "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } }, + "node_modules/is-promise": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz", + "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==", + "dev": true, + "license": "MIT" + }, "node_modules/isarray": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/isexe": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", - "integrity": "sha1-6PvzdNxVb/iUehDcsFctYz8s+hA=", - "dev": true + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC" }, "node_modules/jackspeak": { "version": "3.4.3", "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz", "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==", "dev": true, + "license": "BlueOak-1.0.0", "dependencies": { "@isaacs/cliui": "^8.0.2" }, @@ -765,15 +742,15 @@ } }, "node_modules/jake": { - "version": "10.9.2", - "resolved": "https://registry.npmjs.org/jake/-/jake-10.9.2.tgz", - "integrity": "sha512-2P4SQ0HrLQ+fw6llpLnOaGAvN2Zu6778SJMrCUwns4fOoG9ayrTiZk3VV8sCPkVZF8ab0zksVpS8FDY5pRCNBA==", + "version": "10.9.4", + "resolved": "https://registry.npmjs.org/jake/-/jake-10.9.4.tgz", + "integrity": "sha512-wpHYzhxiVQL+IV05BLE2Xn34zW1S223hvjtqk0+gsPrwd/8JNLXJgZZM/iPFsYc1xyphF+6M6EvdE5E9MBGkDA==", "dev": true, + "license": "Apache-2.0", "dependencies": { - "async": "^3.2.3", - "chalk": "^4.0.2", + "async": "^3.2.6", "filelist": "^1.0.4", - "minimatch": "^3.1.2" + "picocolors": "^1.1.1" }, "bin": { "jake": "bin/cli.js" @@ -783,13 +760,14 @@ } }, "node_modules/jasmine-browser-runner": { - "version": "2.5.0", - "resolved": "https://registry.npmjs.org/jasmine-browser-runner/-/jasmine-browser-runner-2.5.0.tgz", - "integrity": "sha512-CzdvpeZunUu6x1u8G6/vPnfcKVpDaBFfk3tIvm1hoA+EfceQ8FRvsy4o8hEcKYyMt556XFRnP5PjYsxFU8z7Xw==", + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/jasmine-browser-runner/-/jasmine-browser-runner-3.0.0.tgz", + "integrity": "sha512-bLfESBhOAdd/8Lkcmi1RO3abPkYxtTMGGLs+ikX/Qv0aQMs0tw7aFWTVKEXDJ+2IEZs+qtBldaRHSA7BaMonUQ==", "dev": true, + "license": "MIT", "dependencies": { "ejs": "^3.1.6", - "express": "^4.19.2", + "express": "^5.0.0", "glob": "^10.0.0", "selenium-webdriver": "^4.12.0" }, @@ -797,64 +775,23 @@ "jasmine-browser-runner": "bin/jasmine-browser-runner" }, "peerDependencies": { - "jasmine-core": "^5.0.0" - } - }, - "node_modules/jasmine-browser-runner/node_modules/brace-expansion": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", - "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", - "dev": true, - "dependencies": { - "balanced-match": "^1.0.0" - } - }, - "node_modules/jasmine-browser-runner/node_modules/glob": { - "version": "10.4.5", - "resolved": "https://registry.npmjs.org/glob/-/glob-10.4.5.tgz", - "integrity": "sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg==", - "dev": true, - "dependencies": { - "foreground-child": "^3.1.0", - "jackspeak": "^3.1.2", - "minimatch": "^9.0.4", - "minipass": "^7.1.2", - "package-json-from-dist": "^1.0.0", - "path-scurry": "^1.11.1" - }, - "bin": { - "glob": "dist/esm/bin.mjs" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, - "node_modules/jasmine-browser-runner/node_modules/minimatch": { - "version": "9.0.5", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz", - "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==", - "dev": true, - "dependencies": { - "brace-expansion": "^2.0.1" - }, - "engines": { - "node": ">=16 || 14 >=14.17" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" + "jasmine-core": "^5.5.0" } }, "node_modules/jasmine-core": { - "version": "5.2.0", - "resolved": "https://registry.npmjs.org/jasmine-core/-/jasmine-core-5.2.0.tgz", - "integrity": "sha512-tSAtdrvWybZkQmmaIoDgnvHG8ORUNw5kEVlO5CvrXj02Jjr9TZrmjFq7FUiOUzJiOP2wLGYT6PgrQgQF4R1xiw==", - "dev": true + "version": "5.12.1", + "resolved": "https://registry.npmjs.org/jasmine-core/-/jasmine-core-5.12.1.tgz", + "integrity": "sha512-P/UbRZ0LKwXe7wEpwDheuhunPwITn4oPALhrJEQJo6756EwNGnsK/TSQrWojBB4cQDQ+VaxWYws9tFNDuiMh2Q==", + "dev": true, + "license": "MIT", + "peer": true }, "node_modules/jszip": { "version": "3.10.1", "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.1.tgz", "integrity": "sha512-xXDvecyTpGLrqFrvkrUSoxxfJI5AH7U8zxxtVclpsUtMCq4JQ290LY8AW5c7Ggnr/Y/oK+bQMbqK2qmtk3pN4g==", "dev": true, + "license": "(MIT OR GPL-3.0-or-later)", "dependencies": { "lie": "~3.3.0", "pako": "~1.0.2", @@ -867,6 +804,7 @@ "resolved": "https://registry.npmjs.org/lie/-/lie-3.3.0.tgz", "integrity": "sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==", "dev": true, + "license": "MIT", "dependencies": { "immediate": "~3.0.5" } @@ -875,78 +813,83 @@ "version": "10.4.3", "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz", "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==", - "dev": true + "dev": true, + "license": "ISC" }, - "node_modules/media-typer": { - "version": "0.3.0", - "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz", - "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==", + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", "dev": true, + "license": "MIT", "engines": { - "node": ">= 0.6" + "node": ">= 0.4" } }, - "node_modules/merge-descriptors": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz", - "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==", + "node_modules/media-typer": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.0.tgz", + "integrity": "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==", "dev": true, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" + "license": "MIT", + "engines": { + "node": ">= 0.8" } }, - "node_modules/methods": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", - "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", + "node_modules/merge-descriptors": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz", + "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==", "dev": true, + "license": "MIT", "engines": { - "node": ">= 0.6" - } - }, - "node_modules/mime": { - "version": "1.6.0", - "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", - "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", - "dev": true, - "bin": { - "mime": "cli.js" + "node": ">=18" }, - "engines": { - "node": ">=4" + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/mime-db": { - "version": "1.51.0", - "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.51.0.tgz", - "integrity": "sha512-5y8A56jg7XVQx2mbv1lu49NR4dokRnhZYTtL+KGfaa27uq4pSTXkwQkFJl4pkRMyNFz/EtYDSkiiEHx3F7UN6g==", + "version": "1.54.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz", + "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.6" } }, "node_modules/mime-types": { - "version": "2.1.34", - "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.34.tgz", - "integrity": "sha512-6cP692WwGIs9XXdOO4++N+7qjqv0rqxxVvJ3VHPh/Sc9mVZcQP+ZGhkKiTvWMQRr2tbHkJP/Yn7Y0npb3ZBs4A==", + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz", + "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==", "dev": true, + "license": "MIT", "dependencies": { - "mime-db": "1.51.0" + "mime-db": "^1.54.0" }, "engines": { - "node": ">= 0.6" + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" } }, "node_modules/minimatch": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", - "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz", + "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==", "dev": true, + "license": "ISC", "dependencies": { - "brace-expansion": "^1.1.7" + "brace-expansion": "^2.0.1" }, "engines": { - "node": "*" + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" } }, "node_modules/minipass": { @@ -954,30 +897,34 @@ "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.2.tgz", "integrity": "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==", "dev": true, + "license": "ISC", "engines": { "node": ">=16 || 14 >=14.17" } }, "node_modules/ms": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", - "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", - "dev": true + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" }, "node_modules/negotiator": { - "version": "0.6.3", - "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz", - "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==", + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.0.0.tgz", + "integrity": "sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.6" } }, "node_modules/object-inspect": { - "version": "1.13.2", - "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.2.tgz", - "integrity": "sha512-IRZSRuzJiynemAXPYtPe5BoI/RESNYR7TYm50MC5Mqbd3Jmw5y790sErYw3V6SryFJD64b74qQQs9wn5Bg/k3g==", + "version": "1.13.4", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz", + "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.4" }, @@ -990,6 +937,7 @@ "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz", "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", "dev": true, + "license": "MIT", "dependencies": { "ee-first": "1.1.1" }, @@ -997,23 +945,36 @@ "node": ">= 0.8" } }, + "node_modules/once": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", + "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", + "dev": true, + "license": "ISC", + "dependencies": { + "wrappy": "1" + } + }, "node_modules/package-json-from-dist": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.0.tgz", - "integrity": "sha512-dATvCeZN/8wQsGywez1mzHtTlP22H8OEfPrVMLNr4/eGa+ijtLn/6M5f0dY8UKNrC2O9UCU6SSoG3qRKnt7STw==", - "dev": true + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz", + "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==", + "dev": true, + "license": "BlueOak-1.0.0" }, "node_modules/pako": { "version": "1.0.11", "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz", "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==", - "dev": true + "dev": true, + "license": "(MIT AND Zlib)" }, "node_modules/parseurl": { "version": "1.3.3", "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.8" } @@ -1023,6 +984,7 @@ "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -1032,6 +994,7 @@ "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz", "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==", "dev": true, + "license": "BlueOak-1.0.0", "dependencies": { "lru-cache": "^10.2.0", "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0" @@ -1044,22 +1007,36 @@ } }, "node_modules/path-to-regexp": { - "version": "0.1.10", - "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.10.tgz", - "integrity": "sha512-7lf7qcQidTku0Gu3YDPc8DJ1q7OOucfa/BSsIwjuh56VU7katFvuM8hULfkwB3Fns/rsVF7PwPKVw1sl5KQS9w==", - "dev": true + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.3.0.tgz", + "integrity": "sha512-7jdwVIRtsP8MYpdXSwOS0YdD0Du+qOoF/AEPIt88PcCFrZCzx41oxku1jD88hZBwbNUIEfpqvuhjFaMAqMTWnA==", + "dev": true, + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" }, "node_modules/process-nextick-args": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz", "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/proxy-addr": { "version": "2.0.7", "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==", "dev": true, + "license": "MIT", "dependencies": { "forwarded": "0.2.0", "ipaddr.js": "1.9.1" @@ -1069,12 +1046,13 @@ } }, "node_modules/qs": { - "version": "6.13.0", - "resolved": "https://registry.npmjs.org/qs/-/qs-6.13.0.tgz", - "integrity": "sha512-+38qI9SOr8tfZ4QmJNplMUxqjbe7LKvvZgWdExBOmd+egZTtjLB67Gu0HRX3u/XOq7UU2Nx6nsjvS16Z9uwfpg==", + "version": "6.14.0", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.0.tgz", + "integrity": "sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { - "side-channel": "^1.0.6" + "side-channel": "^1.1.0" }, "engines": { "node": ">=0.6" @@ -1088,23 +1066,25 @@ "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz", "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.6" } }, "node_modules/raw-body": { - "version": "2.5.2", - "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz", - "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==", + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-3.0.2.tgz", + "integrity": "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==", "dev": true, + "license": "MIT", "dependencies": { - "bytes": "3.1.2", - "http-errors": "2.0.0", - "iconv-lite": "0.4.24", - "unpipe": "1.0.0" + "bytes": "~3.1.2", + "http-errors": "~2.0.1", + "iconv-lite": "~0.7.0", + "unpipe": "~1.0.0" }, "engines": { - "node": ">= 0.8" + "node": ">= 0.10" } }, "node_modules/readable-stream": { @@ -1112,6 +1092,7 @@ "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", "dev": true, + "license": "MIT", "dependencies": { "core-util-is": "~1.0.0", "inherits": "~2.0.3", @@ -1122,162 +1103,122 @@ "util-deprecate": "~1.0.1" } }, - "node_modules/readable-stream/node_modules/safe-buffer": { + "node_modules/router": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz", + "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "debug": "^4.4.0", + "depd": "^2.0.0", + "is-promise": "^4.0.0", + "parseurl": "^1.3.3", + "path-to-regexp": "^8.0.0" + }, + "engines": { + "node": ">= 18" + } + }, + "node_modules/safe-buffer": { "version": "5.1.2", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "dev": true - }, - "node_modules/safe-buffer": { - "version": "5.2.1", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", - "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", "dev": true, - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ] + "license": "MIT" }, "node_modules/safer-buffer": { "version": "2.1.2", "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/selenium-webdriver": { - "version": "4.23.0", - "resolved": "https://registry.npmjs.org/selenium-webdriver/-/selenium-webdriver-4.23.0.tgz", - "integrity": "sha512-DdvtInpnMt95Td8VApvmAw7oSydBD9twIRXqoMyRoGMvL1dAnMFxdrwnW6L0d/pF/uoNTjbVUarwGZ9wIGNStA==", + "version": "4.38.0", + "resolved": "https://registry.npmjs.org/selenium-webdriver/-/selenium-webdriver-4.38.0.tgz", + "integrity": "sha512-5/UXXFSQmn7FGQkbcpAqvfhzflUdMWtT7QqpEgkFD6Q6rDucxB5EUfzgjmr6JbUj30QodcW3mDXehzoeS/Vy5w==", "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/SeleniumHQ" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/selenium" + } + ], + "license": "Apache-2.0", "dependencies": { - "@bazel/runfiles": "^5.8.1", + "@bazel/runfiles": "^6.3.1", "jszip": "^3.10.1", - "tmp": "^0.2.3", - "ws": "^8.17.1" + "tmp": "^0.2.5", + "ws": "^8.18.3" }, "engines": { - "node": ">= 14.21.0" - } - }, - "node_modules/selenium-webdriver/node_modules/ws": { - "version": "8.18.0", - "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.0.tgz", - "integrity": "sha512-8VbfWfHLbbwu3+N6OKsOMpBdT4kXPDDB9cJk2bJ6mh9ucxdlnNvH1e+roYkKmN9Nxw2yjz7VzeO9oOz2zJ04Pw==", - "dev": true, - "engines": { - "node": ">=10.0.0" - }, - "peerDependencies": { - "bufferutil": "^4.0.1", - "utf-8-validate": ">=5.0.2" - }, - "peerDependenciesMeta": { - "bufferutil": { - "optional": true - }, - "utf-8-validate": { - "optional": true - } + "node": ">= 20.0.0" } }, "node_modules/send": { - "version": "0.19.0", - "resolved": "https://registry.npmjs.org/send/-/send-0.19.0.tgz", - "integrity": "sha512-dW41u5VfLXu8SJh5bwRmyYUbAoSB3c9uQh6L8h/KtsFREPWpbX1lrljJo186Jc4nmci/sGUZ9a0a0J2zgfq2hw==", + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/send/-/send-1.2.0.tgz", + "integrity": "sha512-uaW0WwXKpL9blXE2o0bRhoL2EGXIrZxQ2ZQ4mgcfoBxdFmQold+qWsD2jLrfZ0trjKL6vOw0j//eAwcALFjKSw==", "dev": true, + "license": "MIT", "dependencies": { - "debug": "2.6.9", - "depd": "2.0.0", - "destroy": "1.2.0", - "encodeurl": "~1.0.2", - "escape-html": "~1.0.3", - "etag": "~1.8.1", - "fresh": "0.5.2", - "http-errors": "2.0.0", - "mime": "1.6.0", - "ms": "2.1.3", - "on-finished": "2.4.1", - "range-parser": "~1.2.1", - "statuses": "2.0.1" + "debug": "^4.3.5", + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "etag": "^1.8.1", + "fresh": "^2.0.0", + "http-errors": "^2.0.0", + "mime-types": "^3.0.1", + "ms": "^2.1.3", + "on-finished": "^2.4.1", + "range-parser": "^1.2.1", + "statuses": "^2.0.1" }, "engines": { - "node": ">= 0.8.0" - } - }, - "node_modules/send/node_modules/encodeurl": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz", - "integrity": "sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w==", - "dev": true, - "engines": { - "node": ">= 0.8" + "node": ">= 18" } }, - "node_modules/send/node_modules/ms": { - "version": "2.1.3", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", - "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", - "dev": true - }, "node_modules/serve-static": { - "version": "1.16.2", - "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.2.tgz", - "integrity": "sha512-VqpjJZKadQB/PEbEwvFdO43Ax5dFBZ2UECszz8bQ7pi7wt//PWe1P6MN7eCnjsatYtBT6EuiClbjSWP2WrIoTw==", - "dev": true, - "dependencies": { - "encodeurl": "~2.0.0", - "escape-html": "~1.0.3", - "parseurl": "~1.3.3", - "send": "0.19.0" - }, - "engines": { - "node": ">= 0.8.0" - } - }, - "node_modules/set-function-length": { - "version": "1.2.2", - "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz", - "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==", + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.0.tgz", + "integrity": "sha512-61g9pCh0Vnh7IutZjtLGGpTA355+OPn2TyDv/6ivP2h/AdAVX9azsoxmg2/M6nZeQZNYBEwIcsne1mJd9oQItQ==", "dev": true, + "license": "MIT", "dependencies": { - "define-data-property": "^1.1.4", - "es-errors": "^1.3.0", - "function-bind": "^1.1.2", - "get-intrinsic": "^1.2.4", - "gopd": "^1.0.1", - "has-property-descriptors": "^1.0.2" + "encodeurl": "^2.0.0", + "escape-html": "^1.0.3", + "parseurl": "^1.3.3", + "send": "^1.2.0" }, "engines": { - "node": ">= 0.4" + "node": ">= 18" } }, "node_modules/setimmediate": { "version": "1.0.5", "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz", "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/setprototypeof": { "version": "1.2.0", "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/shebang-command": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", "dev": true, + "license": "MIT", "dependencies": { "shebang-regex": "^3.0.0" }, @@ -1290,20 +1231,79 @@ "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } }, "node_modules/side-channel": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.0.6.tgz", - "integrity": "sha512-fDW/EZ6Q9RiO8eFG8Hj+7u/oW+XrPTIChwCOM2+th2A6OblDtYYIpve9m+KvI9Z4C9qSEXlaGR6bTEYHReuglA==", + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz", + "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3", + "side-channel-list": "^1.0.0", + "side-channel-map": "^1.0.1", + "side-channel-weakmap": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-list": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz", + "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-map": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz", + "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-weakmap": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz", + "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==", "dev": true, + "license": "MIT", "dependencies": { - "call-bind": "^1.0.7", + "call-bound": "^1.0.2", "es-errors": "^1.3.0", - "get-intrinsic": "^1.2.4", - "object-inspect": "^1.13.1" + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3", + "side-channel-map": "^1.0.1" }, "engines": { "node": ">= 0.4" @@ -1317,6 +1317,7 @@ "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", "dev": true, + "license": "ISC", "engines": { "node": ">=14" }, @@ -1325,10 +1326,11 @@ } }, "node_modules/statuses": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz", - "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==", + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz", + "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.8" } @@ -1338,28 +1340,27 @@ "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", "dev": true, + "license": "MIT", "dependencies": { "safe-buffer": "~5.1.0" } }, - "node_modules/string_decoder/node_modules/safe-buffer": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", - "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "dev": true - }, "node_modules/string-width": { - "version": "4.2.3", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", - "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", + "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==", "dev": true, + "license": "MIT", "dependencies": { - "emoji-regex": "^8.0.0", - "is-fullwidth-code-point": "^3.0.0", - "strip-ansi": "^6.0.1" + "eastasianwidth": "^0.2.0", + "emoji-regex": "^9.2.2", + "strip-ansi": "^7.0.1" }, "engines": { - "node": ">=8" + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/string-width-cjs": { @@ -1368,6 +1369,7 @@ "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", "dev": true, + "license": "MIT", "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", @@ -1377,11 +1379,29 @@ "node": ">=8" } }, - "node_modules/strip-ansi": { + "node_modules/string-width-cjs/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/string-width-cjs/node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "dev": true, + "license": "MIT" + }, + "node_modules/string-width-cjs/node_modules/strip-ansi": { "version": "6.0.1", "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", "dev": true, + "license": "MIT", "dependencies": { "ansi-regex": "^5.0.1" }, @@ -1389,12 +1409,29 @@ "node": ">=8" } }, + "node_modules/strip-ansi": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.2.tgz", + "integrity": "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, "node_modules/strip-ansi-cjs": { "name": "strip-ansi", "version": "6.0.1", "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", "dev": true, + "license": "MIT", "dependencies": { "ansi-regex": "^5.0.1" }, @@ -1402,23 +1439,22 @@ "node": ">=8" } }, - "node_modules/supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "node_modules/strip-ansi-cjs/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", "dev": true, - "dependencies": { - "has-flag": "^4.0.0" - }, + "license": "MIT", "engines": { "node": ">=8" } }, "node_modules/tmp": { - "version": "0.2.3", - "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.2.3.tgz", - "integrity": "sha512-nZD7m9iCPC5g0pYmcaxogYKggSfLsdxl8of3Q/oIbqCqLLIO9IAF0GWjX1z9NZRHPiXv8Wex4yDCaZsgEw0Y8w==", + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.2.5.tgz", + "integrity": "sha512-voyz6MApa1rQGUxT3E+BK7/ROe8itEx7vD8/HEvt4xwXucvQ5G5oeEiHkmHZJuBO21RpOf+YYm9MOivj709jow==", "dev": true, + "license": "MIT", "engines": { "node": ">=14.14" } @@ -1428,18 +1464,21 @@ "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.6" } }, "node_modules/type-is": { - "version": "1.6.18", - "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz", - "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.0.1.tgz", + "integrity": "sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw==", "dev": true, + "license": "MIT", "dependencies": { - "media-typer": "0.3.0", - "mime-types": "~2.1.24" + "content-type": "^1.0.5", + "media-typer": "^1.1.0", + "mime-types": "^3.0.0" }, "engines": { "node": ">= 0.6" @@ -1450,6 +1489,7 @@ "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz", "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.8" } @@ -1458,22 +1498,15 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", - "dev": true - }, - "node_modules/utils-merge": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz", - "integrity": "sha1-n5VxD1CiZ5R7LMwSR0HBAoQn5xM=", "dev": true, - "engines": { - "node": ">= 0.4.0" - } + "license": "MIT" }, "node_modules/vary": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz", "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.8" } @@ -1483,6 +1516,7 @@ "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", "dev": true, + "license": "ISC", "dependencies": { "isexe": "^2.0.0" }, @@ -1493,12 +1527,31 @@ "node": ">= 8" } }, + "node_modules/wrap-ansi": { + "version": "8.1.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz", + "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.1.0", + "string-width": "^5.0.1", + "strip-ansi": "^7.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, "node_modules/wrap-ansi-cjs": { "name": "wrap-ansi", "version": "7.0.0", "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", "dev": true, + "license": "MIT", "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", @@ -1510,1136 +1563,95 @@ "funding": { "url": "https://github.com/chalk/wrap-ansi?sponsor=1" } - } - }, - "dependencies": { - "@bazel/runfiles": { - "version": "5.8.1", - "resolved": "https://registry.npmjs.org/@bazel/runfiles/-/runfiles-5.8.1.tgz", - "integrity": "sha512-NDdfpdQ6rZlylgv++iMn5FkObC/QlBQvipinGLSOguTYpRywmieOyJ29XHvUilspwTFSILWpoE9CqMGkHXug1g==", - "dev": true - }, - "@isaacs/cliui": { - "version": "8.0.2", - "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz", - "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==", - "dev": true, - "requires": { - "string-width": "^5.1.2", - "string-width-cjs": "npm:string-width@^4.2.0", - "strip-ansi": "^7.0.1", - "strip-ansi-cjs": "npm:strip-ansi@^6.0.1", - "wrap-ansi": "^8.1.0", - "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0" - }, - "dependencies": { - "ansi-regex": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.0.1.tgz", - "integrity": "sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA==", - "dev": true - }, - "ansi-styles": { - "version": "6.2.1", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz", - "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==", - "dev": true - }, - "emoji-regex": { - "version": "9.2.2", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", - "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==", - "dev": true - }, - "string-width": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", - "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==", - "dev": true, - "requires": { - "eastasianwidth": "^0.2.0", - "emoji-regex": "^9.2.2", - "strip-ansi": "^7.0.1" - } - }, - "strip-ansi": { - "version": "7.1.0", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz", - "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==", - "dev": true, - "requires": { - "ansi-regex": "^6.0.1" - } - }, - "wrap-ansi": { - "version": "8.1.0", - "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz", - "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==", - "dev": true, - "requires": { - "ansi-styles": "^6.1.0", - "string-width": "^5.0.1", - "strip-ansi": "^7.0.1" - } - } - } - }, - "@pkgjs/parseargs": { - "version": "0.11.0", - "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz", - "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==", - "dev": true, - "optional": true - }, - "accepts": { - "version": "1.3.8", - "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz", - "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==", - "dev": true, - "requires": { - "mime-types": "~2.1.34", - "negotiator": "0.6.3" - } }, - "ansi-regex": { + "node_modules/wrap-ansi-cjs/node_modules/ansi-regex": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", - "dev": true + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } }, - "ansi-styles": { + "node_modules/wrap-ansi-cjs/node_modules/ansi-styles": { "version": "4.3.0", "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", "dev": true, - "requires": { + "license": "MIT", + "dependencies": { "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" } }, - "array-flatten": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz", - "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==", - "dev": true - }, - "async": { - "version": "3.2.5", - "resolved": "https://registry.npmjs.org/async/-/async-3.2.5.tgz", - "integrity": "sha512-baNZyqaaLhyLVKm/DlvdW051MSgO6b8eVfIezl9E5PqWxFgzLm/wQntEW4zOytVburDEr0JlALEpdOFwvErLsg==", - "dev": true - }, - "balanced-match": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", - "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", - "dev": true - }, - "body-parser": { - "version": "1.20.3", - "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.3.tgz", - "integrity": "sha512-7rAxByjUMqQ3/bHJy7D6OGXvx/MMc4IqBn/X0fcM1QUcAItpZrBEYhWGem+tzXH90c+G01ypMcYJBO9Y30203g==", - "dev": true, - "requires": { - "bytes": "3.1.2", - "content-type": "~1.0.5", - "debug": "2.6.9", - "depd": "2.0.0", - "destroy": "1.2.0", - "http-errors": "2.0.0", - "iconv-lite": "0.4.24", - "on-finished": "2.4.1", - "qs": "6.13.0", - "raw-body": "2.5.2", - "type-is": "~1.6.18", - "unpipe": "1.0.0" - } - }, - "brace-expansion": { - "version": "1.1.11", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", - "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==", - "dev": true, - "requires": { - "balanced-match": "^1.0.0", - "concat-map": "0.0.1" - } - }, - "bytes": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", - "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", - "dev": true - }, - "call-bind": { - "version": "1.0.7", - "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.7.tgz", - "integrity": "sha512-GHTSNSYICQ7scH7sZ+M2rFopRoLh8t2bLSW6BbgrtLsahOIB5iyAVJf9GjWK3cYTDaMj4XdBpM1cA6pIS0Kv2w==", - "dev": true, - "requires": { - "es-define-property": "^1.0.0", - "es-errors": "^1.3.0", - "function-bind": "^1.1.2", - "get-intrinsic": "^1.2.4", - "set-function-length": "^1.2.1" - } - }, - "chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", - "dev": true, - "requires": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" - } - }, - "color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "dev": true, - "requires": { - "color-name": "~1.1.4" - } - }, - "color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "dev": true - }, - "concat-map": { - "version": "0.0.1", - "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=", - "dev": true - }, - "content-disposition": { - "version": "0.5.4", - "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz", - "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==", - "dev": true, - "requires": { - "safe-buffer": "5.2.1" - } - }, - "content-type": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz", - "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==", - "dev": true - }, - "cookie": { - "version": "0.7.1", - "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.1.tgz", - "integrity": "sha512-6DnInpx7SJ2AK3+CTUE/ZM0vWTUboZCegxhC2xiIydHR9jNuTAASBrfEpHhiGOZw/nX51bHt6YQl8jsGo4y/0w==", - "dev": true - }, - "cookie-signature": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz", - "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==", - "dev": true - }, - "core-util-is": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz", - "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==", - "dev": true - }, - "cross-spawn": { - "version": "7.0.3", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz", - "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==", - "dev": true, - "requires": { - "path-key": "^3.1.0", - "shebang-command": "^2.0.0", - "which": "^2.0.1" - } - }, - "debug": { - "version": "2.6.9", - "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", - "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", - "dev": true, - "requires": { - "ms": "2.0.0" - } - }, - "define-data-property": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz", - "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==", - "dev": true, - "requires": { - "es-define-property": "^1.0.0", - "es-errors": "^1.3.0", - "gopd": "^1.0.1" - } - }, - "depd": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz", - "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", - "dev": true - }, - "destroy": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz", - "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==", - "dev": true - }, - "eastasianwidth": { - "version": "0.2.0", - "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz", - "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==", - "dev": true - }, - "ee-first": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", - "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==", - "dev": true - }, - "ejs": { - "version": "3.1.10", - "resolved": "https://registry.npmjs.org/ejs/-/ejs-3.1.10.tgz", - "integrity": "sha512-UeJmFfOrAQS8OJWPZ4qtgHyWExa088/MtK5UEyoJGFH67cDEXkZSviOiKRCZ4Xij0zxI3JECgYs3oKx+AizQBA==", - "dev": true, - "requires": { - "jake": "^10.8.5" - } - }, - "emoji-regex": { + "node_modules/wrap-ansi-cjs/node_modules/emoji-regex": { "version": "8.0.0", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", - "dev": true - }, - "encodeurl": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz", - "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==", - "dev": true - }, - "es-define-property": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.0.tgz", - "integrity": "sha512-jxayLKShrEqqzJ0eumQbVhTYQM27CfT1T35+gCgDFoL82JLsXqTJ76zv6A0YLOgEnLUMvLzsDsGIrl8NFpT2gQ==", - "dev": true, - "requires": { - "get-intrinsic": "^1.2.4" - } - }, - "es-errors": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", - "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", - "dev": true - }, - "escape-html": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", - "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==", - "dev": true - }, - "etag": { - "version": "1.8.1", - "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", - "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", - "dev": true - }, - "express": { - "version": "4.21.1", - "resolved": "https://registry.npmjs.org/express/-/express-4.21.1.tgz", - "integrity": "sha512-YSFlK1Ee0/GC8QaO91tHcDxJiE/X4FbpAyQWkxAvG6AXCuR65YzK8ua6D9hvi/TzUfZMpc+BwuM1IPw8fmQBiQ==", - "dev": true, - "requires": { - "accepts": "~1.3.8", - "array-flatten": "1.1.1", - "body-parser": "1.20.3", - "content-disposition": "0.5.4", - "content-type": "~1.0.4", - "cookie": "0.7.1", - "cookie-signature": "1.0.6", - "debug": "2.6.9", - "depd": "2.0.0", - "encodeurl": "~2.0.0", - "escape-html": "~1.0.3", - "etag": "~1.8.1", - "finalhandler": "1.3.1", - "fresh": "0.5.2", - "http-errors": "2.0.0", - "merge-descriptors": "1.0.3", - "methods": "~1.1.2", - "on-finished": "2.4.1", - "parseurl": "~1.3.3", - "path-to-regexp": "0.1.10", - "proxy-addr": "~2.0.7", - "qs": "6.13.0", - "range-parser": "~1.2.1", - "safe-buffer": "5.2.1", - "send": "0.19.0", - "serve-static": "1.16.2", - "setprototypeof": "1.2.0", - "statuses": "2.0.1", - "type-is": "~1.6.18", - "utils-merge": "1.0.1", - "vary": "~1.1.2" - } - }, - "filelist": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/filelist/-/filelist-1.0.4.tgz", - "integrity": "sha512-w1cEuf3S+DrLCQL7ET6kz+gmlJdbq9J7yXCSjK/OZCPA+qEN1WyF4ZAf0YYJa4/shHJra2t/d/r8SV4Ji+x+8Q==", - "dev": true, - "requires": { - "minimatch": "^5.0.1" - }, - "dependencies": { - "brace-expansion": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", - "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", - "dev": true, - "requires": { - "balanced-match": "^1.0.0" - } - }, - "minimatch": { - "version": "5.1.6", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.6.tgz", - "integrity": "sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g==", - "dev": true, - "requires": { - "brace-expansion": "^2.0.1" - } - } - } - }, - "finalhandler": { - "version": "1.3.1", - "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.1.tgz", - "integrity": "sha512-6BN9trH7bp3qvnrRyzsBz+g3lZxTNZTbVO2EV1CS0WIcDbawYVdYvGflME/9QP0h0pYlCDBCTjYa9nZzMDpyxQ==", - "dev": true, - "requires": { - "debug": "2.6.9", - "encodeurl": "~2.0.0", - "escape-html": "~1.0.3", - "on-finished": "2.4.1", - "parseurl": "~1.3.3", - "statuses": "2.0.1", - "unpipe": "~1.0.0" - } - }, - "foreground-child": { - "version": "3.3.0", - "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.0.tgz", - "integrity": "sha512-Ld2g8rrAyMYFXBhEqMz8ZAHBi4J4uS1i/CxGMDnjyFWddMXLVcDp051DZfu+t7+ab7Wv6SMqpWmyFIj5UbfFvg==", - "dev": true, - "requires": { - "cross-spawn": "^7.0.0", - "signal-exit": "^4.0.1" - } - }, - "forwarded": { - "version": "0.2.0", - "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz", - "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", - "dev": true - }, - "fresh": { - "version": "0.5.2", - "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz", - "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==", - "dev": true - }, - "function-bind": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", - "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", - "dev": true - }, - "get-intrinsic": { - "version": "1.2.4", - "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.2.4.tgz", - "integrity": "sha512-5uYhsJH8VJBTv7oslg4BznJYhDoRI6waYCxMmCdnTrcCrHA/fCFKoTFz2JKKE0HdDFUF7/oQuhzumXJK7paBRQ==", - "dev": true, - "requires": { - "es-errors": "^1.3.0", - "function-bind": "^1.1.2", - "has-proto": "^1.0.1", - "has-symbols": "^1.0.3", - "hasown": "^2.0.0" - } - }, - "gopd": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.0.1.tgz", - "integrity": "sha512-d65bNlIadxvpb/A2abVdlqKqV563juRnZ1Wtk6s1sIR8uNsXR70xqIzVqxVf1eTqDunwT2MkczEeaezCKTZhwA==", - "dev": true, - "requires": { - "get-intrinsic": "^1.1.3" - } - }, - "has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", - "dev": true - }, - "has-property-descriptors": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz", - "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==", - "dev": true, - "requires": { - "es-define-property": "^1.0.0" - } - }, - "has-proto": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.0.3.tgz", - "integrity": "sha512-SJ1amZAJUiZS+PhsVLf5tGydlaVB8EdFpaSO4gmiUKUOxk8qzn5AIy4ZeJUmh22znIdk/uMAUT2pl3FxzVUH+Q==", - "dev": true - }, - "has-symbols": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.0.3.tgz", - "integrity": "sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==", - "dev": true - }, - "hasown": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", - "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", - "dev": true, - "requires": { - "function-bind": "^1.1.2" - } - }, - "http-errors": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz", - "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==", - "dev": true, - "requires": { - "depd": "2.0.0", - "inherits": "2.0.4", - "setprototypeof": "1.2.0", - "statuses": "2.0.1", - "toidentifier": "1.0.1" - } - }, - "iconv-lite": { - "version": "0.4.24", - "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz", - "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==", - "dev": true, - "requires": { - "safer-buffer": ">= 2.1.2 < 3" - } - }, - "immediate": { - "version": "3.0.6", - "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz", - "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==", - "dev": true - }, - "inherits": { - "version": "2.0.4", - "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", - "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", - "dev": true - }, - "ipaddr.js": { - "version": "1.9.1", - "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz", - "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==", - "dev": true - }, - "is-fullwidth-code-point": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", - "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", - "dev": true - }, - "isarray": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", - "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==", - "dev": true - }, - "isexe": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", - "integrity": "sha1-6PvzdNxVb/iUehDcsFctYz8s+hA=", - "dev": true - }, - "jackspeak": { - "version": "3.4.3", - "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz", - "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==", - "dev": true, - "requires": { - "@isaacs/cliui": "^8.0.2", - "@pkgjs/parseargs": "^0.11.0" - } - }, - "jake": { - "version": "10.9.2", - "resolved": "https://registry.npmjs.org/jake/-/jake-10.9.2.tgz", - "integrity": "sha512-2P4SQ0HrLQ+fw6llpLnOaGAvN2Zu6778SJMrCUwns4fOoG9ayrTiZk3VV8sCPkVZF8ab0zksVpS8FDY5pRCNBA==", - "dev": true, - "requires": { - "async": "^3.2.3", - "chalk": "^4.0.2", - "filelist": "^1.0.4", - "minimatch": "^3.1.2" - } - }, - "jasmine-browser-runner": { - "version": "2.5.0", - "resolved": "https://registry.npmjs.org/jasmine-browser-runner/-/jasmine-browser-runner-2.5.0.tgz", - "integrity": "sha512-CzdvpeZunUu6x1u8G6/vPnfcKVpDaBFfk3tIvm1hoA+EfceQ8FRvsy4o8hEcKYyMt556XFRnP5PjYsxFU8z7Xw==", - "dev": true, - "requires": { - "ejs": "^3.1.6", - "express": "^4.19.2", - "glob": "^10.0.0", - "selenium-webdriver": "^4.12.0" - }, - "dependencies": { - "brace-expansion": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", - "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", - "dev": true, - "requires": { - "balanced-match": "^1.0.0" - } - }, - "glob": { - "version": "10.4.5", - "resolved": "https://registry.npmjs.org/glob/-/glob-10.4.5.tgz", - "integrity": "sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg==", - "dev": true, - "requires": { - "foreground-child": "^3.1.0", - "jackspeak": "^3.1.2", - "minimatch": "^9.0.4", - "minipass": "^7.1.2", - "package-json-from-dist": "^1.0.0", - "path-scurry": "^1.11.1" - } - }, - "minimatch": { - "version": "9.0.5", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz", - "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==", - "dev": true, - "requires": { - "brace-expansion": "^2.0.1" - } - } - } - }, - "jasmine-core": { - "version": "5.2.0", - "resolved": "https://registry.npmjs.org/jasmine-core/-/jasmine-core-5.2.0.tgz", - "integrity": "sha512-tSAtdrvWybZkQmmaIoDgnvHG8ORUNw5kEVlO5CvrXj02Jjr9TZrmjFq7FUiOUzJiOP2wLGYT6PgrQgQF4R1xiw==", - "dev": true - }, - "jszip": { - "version": "3.10.1", - "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.1.tgz", - "integrity": "sha512-xXDvecyTpGLrqFrvkrUSoxxfJI5AH7U8zxxtVclpsUtMCq4JQ290LY8AW5c7Ggnr/Y/oK+bQMbqK2qmtk3pN4g==", - "dev": true, - "requires": { - "lie": "~3.3.0", - "pako": "~1.0.2", - "readable-stream": "~2.3.6", - "setimmediate": "^1.0.5" - } - }, - "lie": { - "version": "3.3.0", - "resolved": "https://registry.npmjs.org/lie/-/lie-3.3.0.tgz", - "integrity": "sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==", - "dev": true, - "requires": { - "immediate": "~3.0.5" - } - }, - "lru-cache": { - "version": "10.4.3", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz", - "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==", - "dev": true - }, - "media-typer": { - "version": "0.3.0", - "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz", - "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==", - "dev": true - }, - "merge-descriptors": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz", - "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==", - "dev": true - }, - "methods": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", - "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", - "dev": true - }, - "mime": { - "version": "1.6.0", - "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", - "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", - "dev": true - }, - "mime-db": { - "version": "1.51.0", - "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.51.0.tgz", - "integrity": "sha512-5y8A56jg7XVQx2mbv1lu49NR4dokRnhZYTtL+KGfaa27uq4pSTXkwQkFJl4pkRMyNFz/EtYDSkiiEHx3F7UN6g==", - "dev": true - }, - "mime-types": { - "version": "2.1.34", - "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.34.tgz", - "integrity": "sha512-6cP692WwGIs9XXdOO4++N+7qjqv0rqxxVvJ3VHPh/Sc9mVZcQP+ZGhkKiTvWMQRr2tbHkJP/Yn7Y0npb3ZBs4A==", - "dev": true, - "requires": { - "mime-db": "1.51.0" - } - }, - "minimatch": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", - "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", - "dev": true, - "requires": { - "brace-expansion": "^1.1.7" - } - }, - "minipass": { - "version": "7.1.2", - "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.2.tgz", - "integrity": "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==", - "dev": true - }, - "ms": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", - "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", - "dev": true - }, - "negotiator": { - "version": "0.6.3", - "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz", - "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==", - "dev": true - }, - "object-inspect": { - "version": "1.13.2", - "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.2.tgz", - "integrity": "sha512-IRZSRuzJiynemAXPYtPe5BoI/RESNYR7TYm50MC5Mqbd3Jmw5y790sErYw3V6SryFJD64b74qQQs9wn5Bg/k3g==", - "dev": true - }, - "on-finished": { - "version": "2.4.1", - "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz", - "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", - "dev": true, - "requires": { - "ee-first": "1.1.1" - } - }, - "package-json-from-dist": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.0.tgz", - "integrity": "sha512-dATvCeZN/8wQsGywez1mzHtTlP22H8OEfPrVMLNr4/eGa+ijtLn/6M5f0dY8UKNrC2O9UCU6SSoG3qRKnt7STw==", - "dev": true - }, - "pako": { - "version": "1.0.11", - "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz", - "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==", - "dev": true - }, - "parseurl": { - "version": "1.3.3", - "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", - "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", - "dev": true - }, - "path-key": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", - "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", - "dev": true - }, - "path-scurry": { - "version": "1.11.1", - "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz", - "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==", - "dev": true, - "requires": { - "lru-cache": "^10.2.0", - "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0" - } - }, - "path-to-regexp": { - "version": "0.1.10", - "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.10.tgz", - "integrity": "sha512-7lf7qcQidTku0Gu3YDPc8DJ1q7OOucfa/BSsIwjuh56VU7katFvuM8hULfkwB3Fns/rsVF7PwPKVw1sl5KQS9w==", - "dev": true - }, - "process-nextick-args": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz", - "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==", - "dev": true - }, - "proxy-addr": { - "version": "2.0.7", - "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", - "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==", "dev": true, - "requires": { - "forwarded": "0.2.0", - "ipaddr.js": "1.9.1" - } - }, - "qs": { - "version": "6.13.0", - "resolved": "https://registry.npmjs.org/qs/-/qs-6.13.0.tgz", - "integrity": "sha512-+38qI9SOr8tfZ4QmJNplMUxqjbe7LKvvZgWdExBOmd+egZTtjLB67Gu0HRX3u/XOq7UU2Nx6nsjvS16Z9uwfpg==", - "dev": true, - "requires": { - "side-channel": "^1.0.6" - } - }, - "range-parser": { - "version": "1.2.1", - "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz", - "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==", - "dev": true + "license": "MIT" }, - "raw-body": { - "version": "2.5.2", - "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz", - "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==", - "dev": true, - "requires": { - "bytes": "3.1.2", - "http-errors": "2.0.0", - "iconv-lite": "0.4.24", - "unpipe": "1.0.0" - } - }, - "readable-stream": { - "version": "2.3.8", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", - "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", - "dev": true, - "requires": { - "core-util-is": "~1.0.0", - "inherits": "~2.0.3", - "isarray": "~1.0.0", - "process-nextick-args": "~2.0.0", - "safe-buffer": "~5.1.1", - "string_decoder": "~1.1.1", - "util-deprecate": "~1.0.1" - }, - "dependencies": { - "safe-buffer": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", - "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "dev": true - } - } - }, - "safe-buffer": { - "version": "5.2.1", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", - "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", - "dev": true - }, - "safer-buffer": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", - "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", - "dev": true - }, - "selenium-webdriver": { - "version": "4.23.0", - "resolved": "https://registry.npmjs.org/selenium-webdriver/-/selenium-webdriver-4.23.0.tgz", - "integrity": "sha512-DdvtInpnMt95Td8VApvmAw7oSydBD9twIRXqoMyRoGMvL1dAnMFxdrwnW6L0d/pF/uoNTjbVUarwGZ9wIGNStA==", - "dev": true, - "requires": { - "@bazel/runfiles": "^5.8.1", - "jszip": "^3.10.1", - "tmp": "^0.2.3", - "ws": "^8.17.1" - }, - "dependencies": { - "ws": { - "version": "8.18.0", - "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.0.tgz", - "integrity": "sha512-8VbfWfHLbbwu3+N6OKsOMpBdT4kXPDDB9cJk2bJ6mh9ucxdlnNvH1e+roYkKmN9Nxw2yjz7VzeO9oOz2zJ04Pw==", - "dev": true, - "requires": {} - } - } - }, - "send": { - "version": "0.19.0", - "resolved": "https://registry.npmjs.org/send/-/send-0.19.0.tgz", - "integrity": "sha512-dW41u5VfLXu8SJh5bwRmyYUbAoSB3c9uQh6L8h/KtsFREPWpbX1lrljJo186Jc4nmci/sGUZ9a0a0J2zgfq2hw==", - "dev": true, - "requires": { - "debug": "2.6.9", - "depd": "2.0.0", - "destroy": "1.2.0", - "encodeurl": "~1.0.2", - "escape-html": "~1.0.3", - "etag": "~1.8.1", - "fresh": "0.5.2", - "http-errors": "2.0.0", - "mime": "1.6.0", - "ms": "2.1.3", - "on-finished": "2.4.1", - "range-parser": "~1.2.1", - "statuses": "2.0.1" - }, - "dependencies": { - "encodeurl": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz", - "integrity": "sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w==", - "dev": true - }, - "ms": { - "version": "2.1.3", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", - "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", - "dev": true - } - } - }, - "serve-static": { - "version": "1.16.2", - "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.2.tgz", - "integrity": "sha512-VqpjJZKadQB/PEbEwvFdO43Ax5dFBZ2UECszz8bQ7pi7wt//PWe1P6MN7eCnjsatYtBT6EuiClbjSWP2WrIoTw==", - "dev": true, - "requires": { - "encodeurl": "~2.0.0", - "escape-html": "~1.0.3", - "parseurl": "~1.3.3", - "send": "0.19.0" - } - }, - "set-function-length": { - "version": "1.2.2", - "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz", - "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==", - "dev": true, - "requires": { - "define-data-property": "^1.1.4", - "es-errors": "^1.3.0", - "function-bind": "^1.1.2", - "get-intrinsic": "^1.2.4", - "gopd": "^1.0.1", - "has-property-descriptors": "^1.0.2" - } - }, - "setimmediate": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz", - "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==", - "dev": true - }, - "setprototypeof": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", - "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", - "dev": true - }, - "shebang-command": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", - "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", - "dev": true, - "requires": { - "shebang-regex": "^3.0.0" - } - }, - "shebang-regex": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", - "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", - "dev": true - }, - "side-channel": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.0.6.tgz", - "integrity": "sha512-fDW/EZ6Q9RiO8eFG8Hj+7u/oW+XrPTIChwCOM2+th2A6OblDtYYIpve9m+KvI9Z4C9qSEXlaGR6bTEYHReuglA==", - "dev": true, - "requires": { - "call-bind": "^1.0.7", - "es-errors": "^1.3.0", - "get-intrinsic": "^1.2.4", - "object-inspect": "^1.13.1" - } - }, - "signal-exit": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", - "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", - "dev": true - }, - "statuses": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz", - "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==", - "dev": true - }, - "string_decoder": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", - "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", - "dev": true, - "requires": { - "safe-buffer": "~5.1.0" - }, - "dependencies": { - "safe-buffer": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", - "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "dev": true - } - } - }, - "string-width": { + "node_modules/wrap-ansi-cjs/node_modules/string-width": { "version": "4.2.3", "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", "dev": true, - "requires": { - "emoji-regex": "^8.0.0", - "is-fullwidth-code-point": "^3.0.0", - "strip-ansi": "^6.0.1" - } - }, - "string-width-cjs": { - "version": "npm:string-width@4.2.3", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", - "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", - "dev": true, - "requires": { + "license": "MIT", + "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" } }, - "strip-ansi": { + "node_modules/wrap-ansi-cjs/node_modules/strip-ansi": { "version": "6.0.1", "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", "dev": true, - "requires": { - "ansi-regex": "^5.0.1" - } - }, - "strip-ansi-cjs": { - "version": "npm:strip-ansi@6.0.1", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", - "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "dev": true, - "requires": { + "license": "MIT", + "dependencies": { "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" } }, - "supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", - "dev": true, - "requires": { - "has-flag": "^4.0.0" - } - }, - "tmp": { - "version": "0.2.3", - "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.2.3.tgz", - "integrity": "sha512-nZD7m9iCPC5g0pYmcaxogYKggSfLsdxl8of3Q/oIbqCqLLIO9IAF0GWjX1z9NZRHPiXv8Wex4yDCaZsgEw0Y8w==", - "dev": true - }, - "toidentifier": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", - "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", - "dev": true - }, - "type-is": { - "version": "1.6.18", - "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz", - "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==", - "dev": true, - "requires": { - "media-typer": "0.3.0", - "mime-types": "~2.1.24" - } - }, - "unpipe": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz", - "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==", - "dev": true - }, - "util-deprecate": { + "node_modules/wrappy": { "version": "1.0.2", - "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", - "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", - "dev": true - }, - "utils-merge": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz", - "integrity": "sha1-n5VxD1CiZ5R7LMwSR0HBAoQn5xM=", - "dev": true - }, - "vary": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz", - "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==", - "dev": true - }, - "which": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", - "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", + "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", "dev": true, - "requires": { - "isexe": "^2.0.0" - } + "license": "ISC" }, - "wrap-ansi-cjs": { - "version": "npm:wrap-ansi@7.0.0", - "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", - "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "node_modules/ws": { + "version": "8.18.3", + "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.3.tgz", + "integrity": "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg==", "dev": true, - "requires": { - "ansi-styles": "^4.0.0", - "string-width": "^4.1.0", - "strip-ansi": "^6.0.0" + "license": "MIT", + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "bufferutil": "^4.0.1", + "utf-8-validate": ">=5.0.2" + }, + "peerDependenciesMeta": { + "bufferutil": { + "optional": true + }, + "utf-8-validate": { + "optional": true + } } } } diff --git a/package.json b/package.json index 3a25f9bb3fd..1fc5df72be3 100644 --- a/package.json +++ b/package.json @@ -11,7 +11,7 @@ "url": "https://github.com/sphinx-doc/sphinx/issues" }, "devDependencies": { - "jasmine-browser-runner": "^2.5.0", - "jasmine-core": "^5.2.0" + "jasmine-browser-runner": "^3.0.0", + "jasmine-core": "^5.12.0" } } diff --git a/pyproject.toml b/pyproject.toml index 9645f148dd3..1195b0442dd 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,5 +1,5 @@ [build-system] -requires = ["flit_core>=3.11"] +requires = ["flit_core>=3.12"] build-backend = "flit_core.buildapi" # project metadata @@ -17,7 +17,7 @@ license = "BSD-2-Clause" license-files = [ "LICENSE.rst", ] -requires-python = ">=3.11" +requires-python = ">=3.12" # Classifiers list: https://pypi.org/classifiers/ classifiers = [ @@ -35,10 +35,10 @@ classifiers = [ "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3 :: Only", - "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12", "Programming Language :: Python :: 3.13", "Programming Language :: Python :: 3.14", + "Programming Language :: Python :: 3.15", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Implementation :: PyPy", "Framework :: Sphinx", @@ -75,47 +75,18 @@ dependencies = [ "sphinxcontrib-serializinghtml>=1.1.9", "Jinja2>=3.1", "Pygments>=2.17", - "docutils>=0.20,<0.22", + "docutils>=0.21,<0.23", "snowballstemmer>=2.2", "babel>=2.13", "alabaster>=0.7.14", "imagesize>=1.3", "requests>=2.30.0", - "roman-numerals-py>=1.0.0", + "roman-numerals>=1.0.0", "packaging>=23.0", "colorama>=0.4.6; sys_platform == 'win32'", ] dynamic = ["version"] -[project.optional-dependencies] -docs = [ - "sphinxcontrib-websupport", -] -lint = [ - "ruff==0.9.9", - "mypy==1.15.0", - "sphinx-lint>=0.9", - "types-colorama==0.4.15.20240311", - "types-defusedxml==0.7.0.20240218", - "types-docutils==0.21.0.20241128", - "types-Pillow==10.2.0.20240822", - "types-Pygments==2.19.0.20250219", - "types-requests==2.32.0.20250301", # align with requests - "types-urllib3==1.26.25.14", - "pyright==1.1.396", - "pytest>=8.0", - "pypi-attestations==0.0.21", - "betterproto==2.0.0b6", -] -test = [ - "pytest>=8.0", - "pytest-xdist[psutil]>=3.4", - "defusedxml>=0.7.1", # for secure XML/HTML parsing - "cython>=3.0", - "setuptools>=70.0", # for Cython compilation - "typing_extensions>=4.9", # for typing_extensions.Unpack -] - [[project.authors]] name = "Adam Turner" email = "aa-turner@users.noreply.github.com" @@ -130,6 +101,49 @@ sphinx-quickstart = "sphinx.cmd.quickstart:main" sphinx-apidoc = "sphinx.ext.apidoc:main" sphinx-autogen = "sphinx.ext.autosummary.generate:main" +[dependency-groups] +docs = [ + "sphinxcontrib-websupport", +] +lint = [ + "ruff==0.14.9", + "sphinx-lint>=0.9", +] +package = [ + "build", + "pypi-attestations==0.0.28", + "twine>=6.1", +] +test = [ + "pytest>=9.0", + "pytest-xdist[psutil]>=3.4", + "cython>=3.0", # for Cython compilation + "defusedxml>=0.7.1", # for secure XML/HTML parsing + "setuptools>=70.0", # for Cython compilation + "typing_extensions>=4.9", # for typing_extensions.Unpack +] +translations = [ + "babel>=2.13", + "Jinja2>=3.1", +] +types = [ + "mypy==1.19.1", + "pyrefly", + "pyright==1.1.407", + "ty", + { include-group = "type-stubs" }, +] +type-stubs = [ + # align with versions used elsewhere + "types-colorama==0.4.15.20250801", + "types-defusedxml==0.7.0.20250822", + "types-docutils==0.22.3.20251115", + "types-Pillow==10.2.0.20240822", + "types-Pygments==2.19.0.20251121", + "types-requests==2.32.4.20250913", + "types-urllib3==1.26.25.14", +] + [tool.flit.module] name = "sphinx" @@ -165,7 +179,7 @@ files = [ exclude = [ "tests/roots", ] -python_version = "3.11" +python_version = "3.12" strict = true show_column_numbers = true show_error_context = true @@ -203,75 +217,11 @@ ignore_missing_imports = true [[tool.mypy.overrides]] module = [ # tests/ - "tests.test_addnodes", - "tests.test_application", - "tests.test_events", - "tests.test_highlighting", - "tests.test_project", - "tests.test_versioning", - # tests/test_builders - "tests.test_builders.test_build", - "tests.test_builders.test_build_html", - "tests.test_builders.test_build_html_5_output", - "tests.test_builders.test_build_html_assets", - "tests.test_builders.test_build_html_maths", - "tests.test_builders.test_build_html_numfig", - "tests.test_builders.test_build_html_tocdepth", - "tests.test_builders.test_build_html_toctree", - "tests.test_builders.test_build_linkcheck", - "tests.test_builders.test_build_warnings", - # tests/test_directives - "tests.test_directives.test_directive_code", - "tests.test_directives.test_directives_no_typesetting", - # tests/test_environment - "tests.test_environment.test_environment", - # tests/test_extensions - "tests.test_extensions.test_ext_autodoc_autoclass", - "tests.test_extensions.test_ext_autosummary_imports", - "tests.test_extensions.test_ext_imgconverter", - "tests.test_extensions.test_ext_intersphinx_cache", - "tests.test_extensions.test_ext_math", - "tests.test_extensions.test_ext_napoleon", - "tests.test_extensions.test_ext_todo", - "tests.test_extensions.test_ext_viewcode", - # tests/test_intl - "tests.test_intl.test_catalogs", - "tests.test_intl.test_locale", - # tests/test_markup - "tests.test_markup.test_markup", - "tests.test_markup.test_parser", - # tests/test_theming - "tests.test_theming.test_templating", - "tests.test_theming.test_theming", - # tests/test_transforms - "tests.test_transforms.test_transforms_move_module_targets", - "tests.test_transforms.test_transforms_post_transforms_images", - "tests.test_transforms.test_transforms_reorder_nodes", - # tests/test_util - "tests.test_util.test_util", - "tests.test_util.test_util_display", - "tests.test_util.test_util_docutils", - "tests.test_util.test_util_images", - "tests.test_util.test_util_inventory", - "tests.test_util.test_util_matching", - # tests/test_writers - "tests.test_writers.test_docutilsconf", -] -disallow_untyped_defs = false - -[[tool.mypy.overrides]] -module = [ - # tests/ - "tests.test_quickstart", "tests.test_search", - # tests/test_builders - "tests.test_builders.test_build_latex", # tests/test_config "tests.test_config.test_config", # tests/test_directives - "tests.test_directives.test_directive_only", "tests.test_directives.test_directive_other", - "tests.test_directives.test_directive_patch", # tests/test_domains "tests.test_domains.test_domain_c", "tests.test_domains.test_domain_cpp", @@ -280,32 +230,23 @@ module = [ "tests.test_domains.test_domain_py_fields", "tests.test_domains.test_domain_py_pyfunction", "tests.test_domains.test_domain_py_pyobject", - "tests.test_domains.test_domain_rst", "tests.test_domains.test_domain_std", # tests/test_environment "tests.test_environment.test_environment_toctree", + # tests/test_ext_autodoc + "tests.test_ext_autodoc.test_ext_autodoc", + "tests.test_ext_autodoc.test_ext_autodoc_mock", + # tests/test_ext_autosummary + "tests.test_ext_autosummary.test_ext_autosummary", + # tests/test_ext_intersphinx + "tests.test_ext_intersphinx.test_ext_intersphinx", + # tests/test_ext_napoleon + "tests.test_ext_napoleon.test_ext_napoleon_docstring", # tests/test_extensions "tests.test_extensions.test_ext_apidoc", - "tests.test_extensions.test_ext_autodoc", - "tests.test_extensions.test_ext_autodoc_events", - "tests.test_extensions.test_ext_autodoc_mock", - "tests.test_extensions.test_ext_autosummary", - "tests.test_extensions.test_ext_doctest", "tests.test_extensions.test_ext_inheritance_diagram", - "tests.test_extensions.test_ext_intersphinx", - "tests.test_extensions.test_ext_napoleon_docstring", - # tests/test_intl - "tests.test_intl.test_intl", - # tests/test_pycode - "tests.test_pycode.test_pycode", - "tests.test_pycode.test_pycode_ast", - # tests/test_transforms - "tests.test_transforms.test_transforms_post_transforms", # tests/test_util - "tests.test_util.test_util_fileutil", - "tests.test_util.test_util_i18n", "tests.test_util.test_util_inspect", - "tests.test_util.test_util_logging", "tests.test_util.test_util_nodes", "tests.test_util.test_util_typing", ] @@ -313,7 +254,6 @@ check_untyped_defs = false disable_error_code = [ "annotation-unchecked", ] -disallow_incomplete_defs = false disallow_untyped_calls = false disallow_untyped_defs = false @@ -321,31 +261,6 @@ disallow_untyped_defs = false module = ["tests.test_util.typing_test_data"] ignore_errors = true -[tool.pytest.ini_options] -minversion = "6.0" -addopts = [ - "-ra", - "--import-mode=prepend", -# "--pythonwarnings=error", - "--strict-config", - "--strict-markers", -] -empty_parameter_set_mark = "xfail" -filterwarnings = [ - "all", - "ignore::DeprecationWarning:docutils.io", - "ignore:Distutils was imported before Setuptools:UserWarning:_distutils_hack", - "ignore:Setuptools is replacing distutils:UserWarning:_distutils_hack", - "ignore::DeprecationWarning:pyximport.pyximport", - "ignore::ImportWarning:importlib._bootstrap", -] -log_cli_level = "INFO" -markers = [ - "apidoc", -] -testpaths = ["tests"] -xfail_strict = true - [tool.coverage.run] branch = true parallel = true @@ -372,53 +287,45 @@ include = [ "tests", "utils", ] +exclude = [ + "tests/roots", +] reportArgumentType = "none" reportAssignmentType = "none" reportAttributeAccessIssue = "none" reportCallIssue = "none" reportConstantRedefinition = "none" -reportDeprecated = "none" reportGeneralTypeIssues = "none" reportIncompatibleMethodOverride = "none" reportIncompatibleVariableOverride = "none" -reportInconsistentOverload = "none" reportIndexIssue = "none" -reportInvalidTypeArguments = "none" reportInvalidTypeForm = "none" -reportInvalidTypeVarUse = "none" reportMissingImports = "none" reportMissingModuleSource = "none" reportMissingParameterType = "none" reportMissingTypeArgument = "none" reportMissingTypeStubs = "none" reportOperatorIssue = "none" -reportOptionalIterable = "none" reportOptionalMemberAccess = "none" -reportOptionalOperand = "none" reportOptionalSubscript = "none" reportPossiblyUnboundVariable = "none" reportPrivateUsage = "none" reportRedeclaration = "none" reportReturnType = "none" -reportSelfClsParameterName = "none" -reportTypeCommentUsage = "none" -reportTypedDictNotRequiredAccess = "none" -reportUndefinedVariable = "none" reportUnknownArgumentType = "none" reportUnknownLambdaType = "none" reportUnknownMemberType = "none" reportUnknownParameterType = "none" reportUnknownVariableType = "none" reportUnnecessaryComparison = "none" -reportUnnecessaryContains = "none" reportUnnecessaryIsInstance = "none" -reportUnsupportedDunderAll = "none" reportUntypedBaseClass = "none" -reportUntypedFunctionDecorator = "none" reportUntypedNamedTuple = "none" reportUnusedClass = "none" reportUnusedFunction = "none" reportUnusedImport = "none" reportUnusedVariable = "none" -reportWildcardImportFromLibrary = "none" + +[tool.uv] +default-groups = "all" diff --git a/pyrefly.toml b/pyrefly.toml new file mode 100644 index 00000000000..8e2d8bdc1ef --- /dev/null +++ b/pyrefly.toml @@ -0,0 +1,27 @@ +# Configuration file for Pyrefly_. +# n.b. Pyrefly is early in development. +# Sphinx's current primary/reference type-checker is mypy. +# +# .. _Pyrefly: https://pyrefly.org/en/docs/configuration/ + +project_includes = [ + "doc/conf.py", + "doc/development/tutorials/examples/autodoc_intenum.py", + "doc/development/tutorials/examples/helloworld.py", + "sphinx", + "tests", + "utils", +] +project_excludes = [ + "**/tests/roots*", +] +python_version = "3.12" +replace_imports_with_any = [ + "imagesize", + "pyximport", + "snowballstemmer", +] + +# https://pyrefly.org/en/docs/error-kinds/ +[errors] +implicitly-defined-attribute = false # many false positives diff --git a/sphinx/__init__.py b/sphinx/__init__.py index b70b6db47a6..054399bd354 100644 --- a/sphinx/__init__.py +++ b/sphinx/__init__.py @@ -5,28 +5,15 @@ from __future__ import annotations -import warnings - -# work around flit error in parsing annotated assignments -try: - from sphinx.util._pathlib import _StrPath -except ImportError: - from pathlib import Path as _StrPath # type: ignore[assignment] +from sphinx.util._pathlib import _StrPath TYPE_CHECKING = False if TYPE_CHECKING: from typing import Final -__version__: Final = '8.3.0' +__version__: Final = '9.1.0' __display_version__: Final = __version__ # used for command line version -warnings.filterwarnings( - 'ignore', - 'The frontend.Option class .*', - DeprecationWarning, - module='docutils.frontend', -) - #: Version info for better programmatic use. #: #: A tuple of five elements; for Sphinx version 1.2.1 beta 3 this would be @@ -35,9 +22,10 @@ #: #: .. versionadded:: 1.2 #: Before version 1.2, check the string ``sphinx.__version__``. -version_info: Final = (8, 3, 0, 'beta', 0) +version_info: Final = (9, 1, 0, 'beta', 1) package_dir: Final = _StrPath(__file__).resolve().parent +del _StrPath _in_development = True if _in_development: diff --git a/sphinx/_cli/__init__.py b/sphinx/_cli/__init__.py index 87128b0a5a0..cce4c56e7d9 100644 --- a/sphinx/_cli/__init__.py +++ b/sphinx/_cli/__init__.py @@ -36,12 +36,10 @@ if TYPE_CHECKING: from collections.abc import Callable, Iterable, Iterator, Sequence - from typing import NoReturn, TypeAlias + from typing import NoReturn - _PARSER_SETUP: TypeAlias = Callable[ - [argparse.ArgumentParser], argparse.ArgumentParser - ] - _RUNNER: TypeAlias = Callable[[argparse.Namespace], int] + type _PARSER_SETUP = Callable[[argparse.ArgumentParser], argparse.ArgumentParser] + type _RUNNER = Callable[[argparse.Namespace], int] from typing import Protocol @@ -64,7 +62,7 @@ def _load_subcommand_descriptions() -> Iterator[tuple[str, str]]: # log an error here, but don't fail the full enumeration print(f'Failed to load the description for {command}', file=sys.stderr) else: - yield command, description.split('\n\n', 1)[0] + yield command, description.partition('\n\n')[0] class _RootArgumentParser(argparse.ArgumentParser): diff --git a/sphinx/addnodes.py b/sphinx/addnodes.py index 3cf63b6b053..4ce85dabcf2 100644 --- a/sphinx/addnodes.py +++ b/sphinx/addnodes.py @@ -402,8 +402,8 @@ class desc_sig_literal_char(desc_sig_element, _sig_element=True): class versionmodified(nodes.Admonition, nodes.TextElement): """Node for version change entries. - Currently used for "versionadded", "versionchanged", "deprecated" - and "versionremoved" directives. + Currently used for "version-added", "version-changed", "version-deprecated" + and "version-removed" directives, along with their aliases. """ diff --git a/sphinx/application.py b/sphinx/application.py index fe0e8bdf195..bac6fd41fd5 100644 --- a/sphinx/application.py +++ b/sphinx/application.py @@ -52,7 +52,14 @@ from sphinx.config import ENUM, _ConfigRebuild from sphinx.domains import Domain, Index from sphinx.environment.collectors import EnvironmentCollector - from sphinx.ext.autodoc import Documenter, _AutodocProcessDocstringListener + from sphinx.ext.autodoc._event_listeners import ( + _AutodocBeforeProcessSignatureListener, + _AutodocProcessBasesListener, + _AutodocProcessDocstringListener, + _AutodocProcessSignatureListener, + _AutodocSkipMemberListener, + ) + from sphinx.ext.autodoc._legacy_class_based._documenters import Documenter from sphinx.ext.todo import todo_node from sphinx.extension import Extension from sphinx.registry import ( @@ -196,7 +203,6 @@ def __init__( :param pdb: If true, enable the Python debugger on an exception. :param exception_on_warning: If true, raise an exception on warnings. """ - self.phase = BuildPhase.INITIALIZATION self.verbosity = verbosity self._fresh_env_used: bool | None = None self.extensions: dict[str, Extension] = {} @@ -240,7 +246,7 @@ def __init__( self._fail_on_warnings = bool(warningiserror) self.pdb = pdb self._exception_on_warning = exception_on_warning - logging.setup(self, self._status, self._warning) + logging.setup(self, self._status, self._warning, verbosity=verbosity) self.events = EventManager(self) @@ -255,15 +261,17 @@ def __init__( self.statuscode = 0 # read config + overrides = confoverrides or {} self.tags = Tags(tags) if confdir is None: # set confdir to srcdir if -C given (!= no confdir); a few pieces # of code expect a confdir to be set self.confdir = self.srcdir - self.config = Config({}, confoverrides or {}) + self.config = Config({}, overrides) else: self.confdir = _StrPath(confdir).resolve() - self.config = Config.read(self.confdir, confoverrides or {}, self.tags) + self.config = Config.read(self.confdir, overrides=overrides, tags=self.tags) + self.config._verbosity = -1 if self.quiet else self.verbosity # set up translation infrastructure self._init_i18n() @@ -338,6 +346,12 @@ def fresh_env_used(self) -> bool | None: """ return self._fresh_env_used + @property + def phase(self) -> BuildPhase: + if not hasattr(self, 'builder'): + return BuildPhase.INITIALIZATION + return self.builder.phase + def _init_i18n(self) -> None: """Load translated strings from the configured localedirs if enabled in the configuration. @@ -399,6 +413,8 @@ def _post_init_env(self) -> None: if self._fresh_env_used: self.env.find_files(self.config, self.builder) + self.env._builder_cls = self.builder.__class__ + def preload_builder(self, name: str) -> None: self.registry.preload_builder(self, name) @@ -416,7 +432,7 @@ def _init_builder(self) -> None: # ---- main "build" method ------------------------------------------------- def build(self, force_all: bool = False, filenames: Sequence[Path] = ()) -> None: - self.phase = BuildPhase.READING + self.builder.phase = BuildPhase.READING try: if force_all: self.builder.build_all() @@ -707,7 +723,7 @@ def connect( def connect( self, event: Literal['autodoc-before-process-signature'], - callback: Callable[[Sphinx, Any, bool], None], + callback: _AutodocBeforeProcessSignatureListener, priority: int = 500, ) -> int: ... @@ -715,20 +731,7 @@ def connect( def connect( self, event: Literal['autodoc-process-signature'], - callback: Callable[ - [ - Sphinx, - Literal[ - 'module', 'class', 'exception', 'function', 'method', 'attribute' - ], - str, - Any, - dict[str, bool], - str | None, - str | None, - ], - tuple[str | None, str | None] | None, - ], + callback: _AutodocProcessSignatureListener, priority: int = 500, ) -> int: ... @@ -736,7 +739,7 @@ def connect( def connect( self, event: Literal['autodoc-process-bases'], - callback: Callable[[Sphinx, str, Any, dict[str, bool], list[str]], None], + callback: _AutodocProcessBasesListener, priority: int = 500, ) -> int: ... @@ -744,19 +747,7 @@ def connect( def connect( self, event: Literal['autodoc-skip-member'], - callback: Callable[ - [ - Sphinx, - Literal[ - 'module', 'class', 'exception', 'function', 'method', 'attribute' - ], - str, - Any, - bool, - dict[str, bool], - ], - bool, - ], + callback: _AutodocSkipMemberListener, priority: int = 500, ) -> int: ... @@ -933,6 +924,9 @@ def add_config_value( ``'env'``) to a string. However, booleans are still accepted and converted internally. + .. versionadded:: 1.4 + The *types* parameter. + .. versionadded:: 7.4 The *description* parameter. """ @@ -1108,7 +1102,7 @@ def setup(app): .. versionchanged:: 0.6 Docutils 0.5-style directive classes are now supported. - .. deprecated:: 1.8 + .. versionchanged:: 1.8 Docutils 0.4-style (function based) directives support is deprecated. .. versionchanged:: 1.8 Add *override* keyword. @@ -1637,8 +1631,9 @@ def add_autodocumenter(self, cls: type[Documenter], override: bool = False) -> N logger.debug('[app] adding autodocumenter: %r', cls) from sphinx.ext.autodoc.directive import AutodocDirective - self.registry.add_documenter(cls.objtype, cls) - self.add_directive('auto' + cls.objtype, AutodocDirective, override=override) + objtype = cls.objtype + self.registry.add_documenter(objtype, cls) + self.add_directive('auto' + objtype, AutodocDirective, override=override) def add_autodoc_attrgetter( self, typ: type, getter: Callable[[Any, str, Any], Any] diff --git a/sphinx/builders/__init__.py b/sphinx/builders/__init__.py index 21a1eb8b5c4..ad7523927f3 100644 --- a/sphinx/builders/__init__.py +++ b/sphinx/builders/__init__.py @@ -2,7 +2,6 @@ from __future__ import annotations -import codecs import pickle import re import time @@ -14,6 +13,7 @@ from docutils.utils import DependencyList from sphinx._cli.util.colour import bold +from sphinx.deprecation import _deprecation_warning from sphinx.environment import ( CONFIG_CHANGED_REASON, CONFIG_OK, @@ -22,16 +22,12 @@ from sphinx.environment.adapters.asset import ImageAdapter from sphinx.errors import SphinxError from sphinx.locale import __ -from sphinx.util import ( - get_filetype, - logging, - rst, -) +from sphinx.util import get_filetype, logging from sphinx.util._importer import import_object from sphinx.util._pathlib import _StrPathProperty from sphinx.util.build_phase import BuildPhase from sphinx.util.display import progress_message, status_iterator -from sphinx.util.docutils import sphinx_domains +from sphinx.util.docutils import _parse_str_to_doctree from sphinx.util.i18n import CatalogRepository, docname_to_domain from sphinx.util.osutil import ensuredir, relative_uri, relpath from sphinx.util.parallel import ( @@ -48,7 +44,7 @@ if TYPE_CHECKING: from collections.abc import Iterable, Sequence, Set from gettext import NullTranslations - from typing import Any, Literal + from typing import Any, ClassVar, Literal from docutils.nodes import Node @@ -70,37 +66,39 @@ class Builder: #: The builder's name. #: This is the value used to select builders on the command line. - name: str = '' + name: ClassVar[str] = '' #: The builder's output format, or '' if no document output is produced. #: This is commonly the file extension, e.g. "html", #: though any string value is accepted. #: The builder's format string can be used by various components #: such as :class:`.SphinxPostTransform` or extensions to determine #: their compatibility with the builder. - format: str = '' + format: ClassVar[str] = '' #: The message emitted upon successful build completion. #: This can be a printf-style template string #: with the following keys: ``outdir``, ``project`` - epilog: str = '' + epilog: ClassVar[str] = '' #: default translator class for the builder. This can be overridden by #: :py:meth:`~sphinx.application.Sphinx.set_translator`. - default_translator_class: type[nodes.NodeVisitor] + default_translator_class: ClassVar[type[nodes.NodeVisitor]] # doctree versioning method - versioning_method = 'none' - versioning_compare = False + versioning_method: ClassVar[str] = 'none' + versioning_compare: ClassVar[bool] = False #: Whether it is safe to make parallel :meth:`~.Builder.write_doc` calls. - allow_parallel: bool = False + allow_parallel: ClassVar[bool] = False # support translation - use_message_catalog = True + use_message_catalog: ClassVar[bool] = True #: The list of MIME types of image formats supported by the builder. #: Image files are searched in the order in which they appear here. - supported_image_types: list[str] = [] + supported_image_types: ClassVar[list[str]] = [] #: The builder can produce output documents that may fetch external images when opened. - supported_remote_images: bool = False + supported_remote_images: ClassVar[bool] = False #: The file format produced by the builder allows images to be embedded using data-URIs. - supported_data_uri_images: bool = False + supported_data_uri_images: ClassVar[bool] = False + + phase: BuildPhase = BuildPhase.INITIALIZATION srcdir = _StrPathProperty() confdir = _StrPathProperty() @@ -114,7 +112,7 @@ def __init__(self, app: Sphinx, env: BuildEnvironment) -> None: self.doctreedir = app.doctreedir ensuredir(self.doctreedir) - self.app: Sphinx = app + self._app: Sphinx = app self.env: BuildEnvironment = env self.env.set_versioning_method(self.versioning_method, self.versioning_compare) self.events: EventManager = app.events @@ -124,6 +122,7 @@ def __init__(self, app: Sphinx, env: BuildEnvironment) -> None: self.tags.add(self.name) self.tags.add(f'format_{self.format}') self.tags.add(f'builder_{self.name}') + self._registry = app.registry # images that need to be copied over (source -> dest) self.images: dict[str, str] = {} @@ -136,13 +135,20 @@ def __init__(self, app: Sphinx, env: BuildEnvironment) -> None: self.parallel_ok = False self.finish_tasks: Any = None + @property + def app(self) -> Sphinx: + cls_module = self.__class__.__module__ + cls_name = self.__class__.__qualname__ + _deprecation_warning(cls_module, f'{cls_name}.app', remove=(11, 0)) + return self._app + @property def _translator(self) -> NullTranslations | None: - return self.app.translator + return self._app.translator def get_translator_class(self, *args: Any) -> type[nodes.NodeVisitor]: """Return a class of translator.""" - return self.env._registry.get_translator_class(self) + return self._registry.get_translator_class(self) def create_translator(self, *args: Any) -> nodes.NodeVisitor: """Return an instance of translator. @@ -150,7 +156,7 @@ def create_translator(self, *args: Any) -> nodes.NodeVisitor: This method returns an instance of ``default_translator_class`` by default. Users can replace the translator class with ``app.set_translator()`` API. """ - return self.env._registry.create_translator(self, *args) + return self._registry.create_translator(self, *args) # helper methods def init(self) -> None: @@ -258,7 +264,7 @@ def cat2relpath(cat: CatalogInfo, srcdir: Path = self.srcdir) -> str: __('writing output... '), 'darkgreen', len(catalogs), - self.app.verbosity, + self.config.verbosity, stringify_func=cat2relpath, ): catalog.write_mo( @@ -397,14 +403,14 @@ def build( # while reading, collect all warnings from docutils with ( nullcontext() - if self.app._exception_on_warning + if self._app._exception_on_warning else logging.pending_warnings() ): updated_docnames = set(self.read()) doccount = len(updated_docnames) logger.info(bold(__('looking for now-outdated files... ')), nonl=True) - updated_docnames.update(self.env.check_dependents(self.app, updated_docnames)) + updated_docnames.update(self.env.check_dependents(self._app, updated_docnames)) outdated = len(updated_docnames) - doccount if outdated: logger.info(__('%d found'), outdated) @@ -422,14 +428,14 @@ def build( pickle.dump(self.env, f, pickle.HIGHEST_PROTOCOL) # global actions - self.app.phase = BuildPhase.CONSISTENCY_CHECK + self.phase = BuildPhase.CONSISTENCY_CHECK with progress_message(__('checking consistency')): self.env.check_consistency() else: if method == 'update' and not docnames: logger.info(bold(__('no targets are out of date.'))) - self.app.phase = BuildPhase.RESOLVING + self.phase = BuildPhase.RESOLVING # filter "docnames" (list of outdated files) by the updated # found_docs of the environment; this will remove docs that @@ -438,14 +444,14 @@ def build( docnames = set(docnames) & self.env.found_docs # determine if we can write in parallel - if parallel_available and self.app.parallel > 1 and self.allow_parallel: - self.parallel_ok = self.app.is_parallel_allowed('write') + if parallel_available and self._app.parallel > 1 and self.allow_parallel: + self.parallel_ok = self._app.is_parallel_allowed('write') else: self.parallel_ok = False # create a task executor to use for misc. "finish-up" tasks # if self.parallel_ok: - # self.finish_tasks = ParallelTasks(self.app.parallel) + # self.finish_tasks = ParallelTasks(self._app.parallel) # else: # for now, just execute them serially self.finish_tasks = SerialTasks() @@ -508,13 +514,13 @@ def read(self) -> list[str]: self.events.emit('env-before-read-docs', self.env, docnames) # check if we should do parallel or serial read - if parallel_available and self.app.parallel > 1: - par_ok = self.app.is_parallel_allowed('read') + if parallel_available and self._app.parallel > 1: + par_ok = self._app.is_parallel_allowed('read') else: par_ok = False if par_ok: - self._read_parallel(docnames, nproc=self.app.parallel) + self._read_parallel(docnames, nproc=self._app.parallel) else: self._read_serial(docnames) @@ -576,7 +582,7 @@ def _read_serial(self, docnames: list[str]) -> None: __('reading sources... '), 'purple', len(docnames), - self.app.verbosity, + self.config.verbosity, ): # remove all inventory entries for that file self.events.emit('env-purge-doc', self.env, docname) @@ -589,7 +595,11 @@ def _read_parallel(self, docnames: list[str], nproc: int) -> None: # create a status_iterator to step progressbar after reading a document # (see: ``merge()`` function) progress = status_iterator( - chunks, __('reading sources... '), 'purple', len(chunks), self.app.verbosity + chunks, + __('reading sources... '), + 'purple', + len(chunks), + self.config.verbosity, ) # clear all outdated docs at once @@ -598,7 +608,7 @@ def _read_parallel(self, docnames: list[str], nproc: int) -> None: self.env.clear_doc(docname) def read_process(docs: list[str]) -> bytes: - self.env.app = self.app + self.env._app = self._app for docname in docs: self.read_doc(docname, _cache=False) # allow pickling self to send it back @@ -606,7 +616,7 @@ def read_process(docs: list[str]) -> bytes: def merge(docs: list[str], otherenv: bytes) -> None: env = pickle.loads(otherenv) - self.env.merge_info_from(docs, env, self.app) + self.env.merge_info_from(docs, env, self._app) next(progress) @@ -629,24 +639,27 @@ def read_doc(self, docname: str, *, _cache: bool = True) -> None: if docutils_conf.is_file(): env.note_dependency(docutils_conf) - filename = str(env.doc2path(docname)) - filetype = get_filetype(self.app.config.source_suffix, filename) - publisher = self.env._registry.get_publisher(self.app, filetype) - self.env.current_document._parser = publisher.parser - # record_dependencies is mutable even though it is in settings, - # explicitly re-initialise for each document - publisher.settings.record_dependencies = DependencyList() - with ( - sphinx_domains(env), - rst.default_role(docname, self.config.default_role), - ): - # set up error_handler for the target document - error_handler = _UnicodeDecodeErrorHandler(docname) - codecs.register_error('sphinx', error_handler) # type: ignore[arg-type] + filename = env.doc2path(docname) + + # read the source file + content = filename.read_text(encoding=env.settings['input_encoding']) + + # TODO: move the "source-read" event to here. - publisher.set_source(source_path=filename) - publisher.publish() - doctree = publisher.document + filetype = get_filetype(self.config.source_suffix, filename) + parser = self._registry.create_source_parser( + filetype, config=self.config, env=env + ) + doctree = _parse_str_to_doctree( + content, + filename=filename, + default_role=self.config.default_role, + default_settings=env.settings, + env=env, + events=self.events, + parser=parser, + transforms=self._registry.get_transforms(), + ) # store time of reading, for outdated files detection env.all_docs[docname] = time.time_ns() // 1_000 @@ -675,7 +688,7 @@ def write_doctree( doctree.settings = doctree.settings.copy() doctree.settings.warning_stream = None doctree.settings.env = None - doctree.settings.record_dependencies = None + doctree.settings.record_dependencies = DependencyList() doctree_filename = self.doctreedir / f'{docname}.doctree' doctree_filename.parent.mkdir(parents=True, exist_ok=True) @@ -744,14 +757,14 @@ def write_documents(self, docnames: Set[str]) -> None: if self.parallel_ok: # number of subprocesses is parallel-1 because the main process # is busy loading doctrees and doing write_doc_serialized() - self._write_parallel(sorted_docnames, nproc=self.app.parallel - 1) + self._write_parallel(sorted_docnames, nproc=self._app.parallel - 1) else: self._write_serial(sorted_docnames) def _write_serial(self, docnames: Sequence[str]) -> None: with ( nullcontext() - if self.app._exception_on_warning + if self._app._exception_on_warning else logging.pending_warnings() ): for docname in status_iterator( @@ -759,27 +772,19 @@ def _write_serial(self, docnames: Sequence[str]) -> None: __('writing output... '), 'darkgreen', len(docnames), - self.app.verbosity, + self.config.verbosity, ): - self.app.phase = BuildPhase.RESOLVING - doctree = self.env.get_and_resolve_doctree(docname, self) - self.app.phase = BuildPhase.WRITING - self.write_doc_serialized(docname, doctree) - self.write_doc(docname, doctree) + _write_docname(docname, env=self.env, builder=self, tags=self.tags) def _write_parallel(self, docnames: Sequence[str], nproc: int) -> None: def write_process(docs: list[tuple[str, nodes.document]]) -> None: - self.app.phase = BuildPhase.WRITING + self.phase = BuildPhase.WRITING for docname, doctree in docs: self.write_doc(docname, doctree) # warm up caches/compile templates using the first document firstname, docnames = docnames[0], docnames[1:] - self.app.phase = BuildPhase.RESOLVING - doctree = self.env.get_and_resolve_doctree(firstname, self) - self.app.phase = BuildPhase.WRITING - self.write_doc_serialized(firstname, doctree) - self.write_doc(firstname, doctree) + _write_docname(firstname, env=self.env, builder=self, tags=self.tags) tasks = ParallelTasks(nproc) chunks = make_chunks(docnames, nproc) @@ -791,17 +796,19 @@ def write_process(docs: list[tuple[str, nodes.document]]) -> None: __('writing output... '), 'darkgreen', len(chunks), - self.app.verbosity, + self.config.verbosity, ) def on_chunk_done(args: list[tuple[str, nodes.document]], result: None) -> None: next(progress) - self.app.phase = BuildPhase.RESOLVING + self.phase = BuildPhase.RESOLVING for chunk in chunks: arg = [] for docname in chunk: - doctree = self.env.get_and_resolve_doctree(docname, self) + doctree = self.env.get_and_resolve_doctree( + docname, self, tags=self.tags + ) self.write_doc_serialized(docname, doctree) arg.append((docname, doctree)) tasks.add_task(write_process, arg, on_chunk_done) @@ -867,27 +874,17 @@ def get_builder_config(self, option: str, default: str) -> Any: return getattr(self.config, optname) -class _UnicodeDecodeErrorHandler: - """Custom error handler for open() that warns and replaces.""" - - def __init__(self, docname: str, /) -> None: - self.docname = docname - - def __call__(self, error: UnicodeDecodeError) -> tuple[str, int]: - line_start = error.object.rfind(b'\n', 0, error.start) - line_end = error.object.find(b'\n', error.start) - if line_end == -1: - line_end = len(error.object) - line_num = error.object.count(b'\n', 0, error.start) + 1 - logger.warning( - __('undecodable source characters, replacing with "?": %r'), - ( - error.object[line_start + 1 : error.start] - + b'>>>' - + error.object[error.start : error.end] - + b'<<<' - + error.object[error.end : line_end] - ), - location=(self.docname, line_num), - ) - return '?', error.end +def _write_docname( + docname: str, + /, + *, + env: BuildEnvironment, + builder: Builder, + tags: Tags, +) -> None: + """Write a single document.""" + builder.phase = BuildPhase.RESOLVING + doctree = env.get_and_resolve_doctree(docname, builder=builder, tags=tags) + builder.phase = BuildPhase.WRITING + builder.write_doc_serialized(docname, doctree) + builder.write_doc(docname, doctree) diff --git a/sphinx/builders/_epub_base.py b/sphinx/builders/_epub_base.py index a9527c3c0e3..b7097ebd405 100644 --- a/sphinx/builders/_epub_base.py +++ b/sphinx/builders/_epub_base.py @@ -114,8 +114,8 @@ class NavPoint(NamedTuple): def sphinx_smarty_pants(t: str, language: str = 'en') -> str: t = t.replace('"', '"') - t = smartquotes.educateDashesOldSchool(t) # type: ignore[no-untyped-call] - t = smartquotes.educateQuotes(t, language) # type: ignore[no-untyped-call] + t = smartquotes.educateDashesOldSchool(t) + t = smartquotes.educateQuotes(t, language) t = t.replace('"', '"') return t @@ -233,7 +233,11 @@ def get_toc(self) -> None: and pre and post files not managed by Sphinx. """ doctree = self.env.get_and_resolve_doctree( - self.config.master_doc, self, prune_toctrees=False, includehidden=True + self.config.master_doc, + self, + tags=self.tags, + prune_toctrees=False, + includehidden=True, ) self.refnodes = self.get_refnodes(doctree, []) master_dir = Path(self.config.master_doc).parent @@ -279,16 +283,6 @@ def fix_ids(self, tree: nodes.document) -> None: Some readers crash because they interpret the part as a transport protocol specification. """ - - def update_node_id(node: Element) -> None: - """Update IDs of given *node*.""" - new_ids: list[str] = [] - for node_id in node['ids']: - new_id = self.fix_fragment('', node_id) - if new_id not in new_ids: - new_ids.append(new_id) - node['ids'] = new_ids - for reference in tree.findall(nodes.reference): if 'refuri' in reference: m = self.refuri_re.match(reference['refuri']) @@ -298,66 +292,75 @@ def update_node_id(node: Element) -> None: reference['refid'] = self.fix_fragment('', reference['refid']) for target in tree.findall(nodes.target): - update_node_id(target) + self._update_node_id(target) - next_node: Node = target.next_node(ascend=True) + next_node: Node | None = target.next_node(ascend=True) if isinstance(next_node, nodes.Element): - update_node_id(next_node) + self._update_node_id(next_node) for desc_signature in tree.findall(addnodes.desc_signature): - update_node_id(desc_signature) + self._update_node_id(desc_signature) + + def _update_node_id(self, node: Element, /) -> None: + """Update IDs of given *node*.""" + new_ids: list[str] = [] + for node_id in node['ids']: + new_id = self.fix_fragment('', node_id) + if new_id not in new_ids: + new_ids.append(new_id) + node['ids'] = new_ids + + @staticmethod + def _make_footnote_ref(doc: nodes.document, label: str) -> nodes.footnote_reference: + """Create a footnote_reference node with children""" + footnote_ref = nodes.footnote_reference('[#]_') + footnote_ref.append(nodes.Text(label)) + doc.note_autofootnote_ref(footnote_ref) + return footnote_ref + + @staticmethod + def _make_footnote(doc: nodes.document, label: str, uri: str) -> nodes.footnote: + """Create a footnote node with children""" + footnote = nodes.footnote(uri) + para = nodes.paragraph() + para.append(nodes.Text(uri)) + footnote.append(para) + footnote.insert(0, nodes.label('', label)) + doc.note_autofootnote(footnote) + return footnote + + @staticmethod + def _footnote_spot(tree: nodes.document) -> tuple[Element, int]: + """Find or create a spot to place footnotes. + + The function returns the tuple (parent, index). + """ + # The code uses the following heuristic: + # a) place them after the last existing footnote + # b) place them after an (empty) Footnotes rubric + # c) create an empty Footnotes rubric at the end of the document + fns = list(tree.findall(nodes.footnote)) + if fns: + fn = fns[-1] + return fn.parent, fn.parent.index(fn) + 1 + for node in tree.findall(nodes.rubric): + if len(node) == 1 and node.astext() == FOOTNOTES_RUBRIC_NAME: + return node.parent, node.parent.index(node) + 1 + doc = next(tree.findall(nodes.document)) + rub = nodes.rubric() + rub.append(nodes.Text(FOOTNOTES_RUBRIC_NAME)) + doc.append(rub) + return doc, doc.index(rub) + 1 def add_visible_links( self, tree: nodes.document, show_urls: str = 'inline' ) -> None: """Add visible link targets for external links""" - - def make_footnote_ref( - doc: nodes.document, label: str - ) -> nodes.footnote_reference: - """Create a footnote_reference node with children""" - footnote_ref = nodes.footnote_reference('[#]_') - footnote_ref.append(nodes.Text(label)) - doc.note_autofootnote_ref(footnote_ref) - return footnote_ref - - def make_footnote(doc: nodes.document, label: str, uri: str) -> nodes.footnote: - """Create a footnote node with children""" - footnote = nodes.footnote(uri) - para = nodes.paragraph() - para.append(nodes.Text(uri)) - footnote.append(para) - footnote.insert(0, nodes.label('', label)) - doc.note_autofootnote(footnote) - return footnote - - def footnote_spot(tree: nodes.document) -> tuple[Element, int]: - """Find or create a spot to place footnotes. - - The function returns the tuple (parent, index). - """ - # The code uses the following heuristic: - # a) place them after the last existing footnote - # b) place them after an (empty) Footnotes rubric - # c) create an empty Footnotes rubric at the end of the document - fns = list(tree.findall(nodes.footnote)) - if fns: - fn = fns[-1] - return fn.parent, fn.parent.index(fn) + 1 - for node in tree.findall(nodes.rubric): - if len(node) == 1 and node.astext() == FOOTNOTES_RUBRIC_NAME: - return node.parent, node.parent.index(node) + 1 - doc = next(tree.findall(nodes.document)) - rub = nodes.rubric() - rub.append(nodes.Text(FOOTNOTES_RUBRIC_NAME)) - doc.append(rub) - return doc, doc.index(rub) + 1 - if show_urls == 'no': return if show_urls == 'footnote': doc = next(tree.findall(nodes.document)) - fn_spot, fn_idx = footnote_spot(tree) + fn_spot, fn_idx = self._footnote_spot(tree) nr = 1 for node in list(tree.findall(nodes.reference)): uri = node.get('refuri', '') @@ -371,9 +374,9 @@ def footnote_spot(tree: nodes.document) -> tuple[Element, int]: elif show_urls == 'footnote': label = FOOTNOTE_LABEL_TEMPLATE % nr nr += 1 - footnote_ref = make_footnote_ref(doc, label) + footnote_ref = self._make_footnote_ref(doc, label) node.parent.insert(idx, footnote_ref) - footnote = make_footnote(doc, label, uri) + footnote = self._make_footnote(doc, label, uri) fn_spot.insert(fn_idx, footnote) footnote_ref['refid'] = footnote['ids'][0] footnote.add_backref(footnote_ref['ids'][0]) @@ -422,7 +425,7 @@ def copy_image_files_pil(self) -> None: __('copying images... '), 'brown', len(self.images), - self.app.verbosity, + self.config.verbosity, ): dest = self.images[src] try: @@ -610,9 +613,10 @@ def build_content(self) -> None: continue if refnode['refuri'] in self.ignored_files: continue - spine = Spine(html.escape(self.make_id(refnode['refuri'])), True) + refuri = refnode['refuri'].replace(os.sep, '/') + spine = Spine(html.escape(self.make_id(refuri)), True) metadata['spines'].append(spine) - spinefiles.add(refnode['refuri']) + spinefiles.add(refuri) for info in self.domain_indices: spine = Spine(html.escape(self.make_id(info[0] + self.out_suffix)), True) metadata['spines'].append(spine) @@ -766,7 +770,11 @@ def build_toc(self) -> None: if self.config.epub_tocscope == 'default': doctree = self.env.get_and_resolve_doctree( - self.config.root_doc, self, prune_toctrees=False, includehidden=False + self.config.root_doc, + self, + tags=self.tags, + prune_toctrees=False, + includehidden=False, ) refnodes = self.get_refnodes(doctree, []) self.toc_add_files(refnodes) diff --git a/sphinx/builders/changes.py b/sphinx/builders/changes.py index aa926e0809c..6d38a6acbbc 100644 --- a/sphinx/builders/changes.py +++ b/sphinx/builders/changes.py @@ -23,14 +23,19 @@ class ChangesBuilder(Builder): - """Write a summary with all versionadded/changed/deprecated/removed directives.""" + """Write a summary with all version-related directives.""" name = 'changes' epilog = __('The overview file is in %(outdir)s.') def init(self) -> None: self.create_template_bridge() - theme_factory = HTMLThemeFactory(self.app) + theme_factory = HTMLThemeFactory( + confdir=self.confdir, + app=self._app, + config=self.config, + registry=self._registry, + ) self.theme = theme_factory.create('default') self.templates.init(self, self.theme) @@ -38,9 +43,13 @@ def get_outdated_docs(self) -> str: return str(self.outdir) typemap = { + 'version-added': 'added', 'versionadded': 'added', + 'version-changed': 'changed', 'versionchanged': 'changed', + 'version-deprecated': 'deprecated', 'deprecated': 'deprecated', + 'version-removed': 'removed', 'versionremoved': 'removed', } @@ -107,9 +116,13 @@ def write_documents(self, _docnames: Set[str]) -> None: f.write(self.templates.render('changes/versionchanges.html', ctx)) hltext = [ + f'.. version-added:: {version}', f'.. versionadded:: {version}', + f'.. version-changed:: {version}', f'.. versionchanged:: {version}', + f'.. version-deprecated:: {version}', f'.. deprecated:: {version}', + f'.. version-removed:: {version}', f'.. versionremoved:: {version}', ] diff --git a/sphinx/builders/epub3.py b/sphinx/builders/epub3.py index 2ea66c34b8b..e09b884046a 100644 --- a/sphinx/builders/epub3.py +++ b/sphinx/builders/epub3.py @@ -7,7 +7,6 @@ import html import os -import os.path import re import time from typing import TYPE_CHECKING, NamedTuple @@ -190,7 +189,11 @@ def build_navigation_doc(self) -> None: if self.config.epub_tocscope == 'default': doctree = self.env.get_and_resolve_doctree( - self.config.root_doc, self, prune_toctrees=False, includehidden=False + self.config.root_doc, + self, + tags=self.tags, + prune_toctrees=False, + includehidden=False, ) refnodes = self.get_refnodes(doctree, []) self.toc_add_files(refnodes) diff --git a/sphinx/builders/gettext.py b/sphinx/builders/gettext.py index f5f26ffcc88..fc659d744d5 100644 --- a/sphinx/builders/gettext.py +++ b/sphinx/builders/gettext.py @@ -2,7 +2,6 @@ from __future__ import annotations -import codecs import operator import os import os.path @@ -165,7 +164,7 @@ class I18nBuilder(Builder): def init(self) -> None: super().init() self.env.set_versioning_method(self.versioning_method, self.config.gettext_uuid) - self.tags = self.app.tags = I18nTags() + self.tags = self._app.tags = I18nTags() self.catalogs: defaultdict[str, Catalog] = defaultdict(Catalog) def get_target_uri(self, docname: str, typ: str | None = None) -> str: @@ -212,7 +211,7 @@ def should_write(filepath: Path, new_content: str) -> bool: if not filepath.exists(): return True try: - with codecs.open(str(filepath), encoding='utf-8') as oldpot: + with open(filepath, encoding='utf-8') as oldpot: old_content = oldpot.read() old_header_index = old_content.index('"POT-Creation-Date:') new_header_index = new_content.index('"POT-Creation-Date:') @@ -251,7 +250,7 @@ def init(self) -> None: def _collect_templates(self) -> set[str]: template_files = set() for template_path in self.config.templates_path: - tmpl_abs_path = self.app.srcdir / template_path + tmpl_abs_path = self.srcdir / template_path for dirpath, _dirs, files in walk(tmpl_abs_path): for fn in files: if fn.endswith('.html'): @@ -268,10 +267,14 @@ def _extract_from_template(self) -> None: extract_translations = self.templates.environment.extract_translations for template in status_iterator( - files, __('reading templates... '), 'purple', len(files), self.app.verbosity + files, + __('reading templates... '), + 'purple', + len(files), + self.config.verbosity, ): try: - with codecs.open(template, encoding='utf-8') as f: + with open(template, encoding='utf-8') as f: context = f.read() for line, _meth, msg in extract_translations(context): origin = MsgOrigin(source=template, line=line) @@ -307,7 +310,7 @@ def finish(self) -> None: __('writing message catalogs... '), 'darkgreen', len(self.catalogs), - self.app.verbosity, + self.config.verbosity, operator.itemgetter(0), ): # noop if config.gettext_compact is set @@ -315,14 +318,14 @@ def finish(self) -> None: context['messages'] = list(catalog) template_path = [ - self.app.srcdir / rel_path for rel_path in self.config.templates_path + self.srcdir / rel_path for rel_path in self.config.templates_path ] renderer = GettextRenderer(template_path, outdir=self.outdir) content = renderer.render('message.pot.jinja', context) pofn = self.outdir / f'{textdomain}.pot' if should_write(pofn, content): - with codecs.open(str(pofn), 'w', encoding='utf-8') as pofile: + with open(pofn, 'w', encoding='utf-8') as pofile: pofile.write(content) diff --git a/sphinx/builders/html/__init__.py b/sphinx/builders/html/__init__.py index 5e6acdeaf9d..37becdeb924 100644 --- a/sphinx/builders/html/__init__.py +++ b/sphinx/builders/html/__init__.py @@ -10,17 +10,16 @@ import re import shutil import sys -import warnings from pathlib import Path from types import NoneType from typing import TYPE_CHECKING from urllib.parse import quote +import docutils.parsers.rst import docutils.readers.doctree +import docutils.utils +import jinja2.exceptions from docutils import nodes -from docutils.core import Publisher -from docutils.frontend import OptionParser -from docutils.io import DocTreeInput, StringOutput from sphinx import __display_version__, package_dir from sphinx import version_info as sphinx_version @@ -33,7 +32,6 @@ ) from sphinx.builders.html._build_info import BuildInfo from sphinx.config import ENUM -from sphinx.deprecation import _deprecation_warning from sphinx.domains import Index, IndexEntry from sphinx.environment.adapters.asset import ImageAdapter from sphinx.environment.adapters.indexentries import IndexEntries @@ -48,7 +46,7 @@ from sphinx.util._timestamps import _format_rfc3339_microseconds from sphinx.util._uri import is_url from sphinx.util.display import progress_message, status_iterator -from sphinx.util.docutils import new_document +from sphinx.util.docutils import _get_settings, new_document from sphinx.util.fileutil import copy_asset from sphinx.util.i18n import format_date from sphinx.util.inventory import InventoryFile @@ -66,10 +64,9 @@ if TYPE_CHECKING: from collections.abc import Iterator, Set - from typing import Any, TypeAlias + from typing import Any from docutils.nodes import Node - from docutils.readers import Reader from sphinx.application import Sphinx from sphinx.config import Config @@ -82,7 +79,7 @@ logger = logging.getLogger(__name__) return_codes_re = re.compile('[\r\n]+') -DOMAIN_INDEX_TYPE: TypeAlias = tuple[ +type DOMAIN_INDEX_TYPE = tuple[ # Index name (e.g. py-modindex) str, # Index class @@ -93,6 +90,10 @@ bool, ] +_READER_TRANSFORMS = docutils.readers.doctree.Reader().get_transforms() +_PARSER_TRANSFORMS = docutils.parsers.rst.Parser().get_transforms() +_WRITER_TRANSFORMS = HTMLWriter(None).get_transforms() # type: ignore[arg-type] + def convert_locale_to_language_tag(locale: str | None) -> str | None: """Convert a locale string to a language tag (ex. en_US -> en-US). @@ -150,19 +151,13 @@ def __init__(self, app: Sphinx, env: BuildEnvironment) -> None: # JS files self._js_files: list[_JavaScript] = [] - # Cached Publisher for writing doctrees to HTML - reader: Reader[DocTreeInput] = docutils.readers.doctree.Reader( - parser_name='restructuredtext' - ) - pub = Publisher( - reader=reader, - parser=reader.parser, - writer=HTMLWriter(self), - source_class=DocTreeInput, - destination=StringOutput(encoding='unicode'), + # Cached settings for render_partial() + self._settings = _get_settings( + docutils.readers.doctree.Reader, + docutils.parsers.rst.Parser, + HTMLWriter, + defaults={'output_encoding': 'unicode', 'traceback': True}, ) - pub.get_settings(output_encoding='unicode', traceback=True) - self._publisher = pub def init(self) -> None: self.build_info = self.create_build_info() @@ -227,7 +222,12 @@ def get_theme_config(self) -> tuple[str, dict[str, str | int | bool]]: return self.config.html_theme, self.config.html_theme_options def init_templates(self) -> None: - theme_factory = HTMLThemeFactory(self.app) + theme_factory = HTMLThemeFactory( + confdir=self.confdir, + app=self._app, + config=self.config, + registry=self._registry, + ) theme_name, theme_options = self.get_theme_config() self.theme = theme_factory.create(theme_name) self.theme_options = theme_options @@ -254,29 +254,24 @@ def init_highlighter(self) -> None: self.dark_highlighter: PygmentsBridge | None if dark_style is not None: self.dark_highlighter = PygmentsBridge('html', dark_style) - self.app.add_css_file( - 'pygments_dark.css', - media='(prefers-color-scheme: dark)', - id='pygments_dark_css', - ) else: self.dark_highlighter = None - @property - def css_files(self) -> list[_CascadingStyleSheet]: - _deprecation_warning( - __name__, f'{self.__class__.__name__}.css_files', remove=(9, 0) - ) - return self._css_files - def init_css_files(self) -> None: self._css_files = [] self.add_css_file('pygments.css', priority=200) + if self.dark_highlighter is not None: + self.add_css_file( + 'pygments_dark.css', + priority=200, + media='(prefers-color-scheme: dark)', + id='pygments_dark_css', + ) for filename in self._get_style_filenames(): self.add_css_file(filename, priority=200) - for filename, attrs in self.env._registry.css_files: + for filename, attrs in self._registry.css_files: self.add_css_file(filename, **attrs) for filename, attrs in self.get_builder_config('css_files', 'html'): @@ -291,19 +286,13 @@ def add_css_file(self, filename: str, **kwargs: Any) -> None: if (asset := _CascadingStyleSheet(filename, **kwargs)) not in self._css_files: self._css_files.append(asset) - @property - def script_files(self) -> list[_JavaScript]: - canonical_name = f'{self.__class__.__name__}.script_files' - _deprecation_warning(__name__, canonical_name, remove=(9, 0)) - return self._js_files - def init_js_files(self) -> None: self._js_files = [] self.add_js_file('documentation_options.js', priority=200) self.add_js_file('doctools.js', priority=200) self.add_js_file('sphinx_highlight.js', priority=200) - for filename, attrs in self.env._registry.js_files: + for filename, attrs in self._registry.js_files: self.add_js_file(filename or '', **attrs) for filename, attrs in self.get_builder_config('js_files', 'html'): @@ -328,7 +317,7 @@ def math_renderer_name(self) -> str | None: return name else: # not given: choose a math_renderer from registered ones as possible - renderers = list(self.env._registry.html_inline_math_renderers) + renderers = list(self._registry.html_inline_math_renderers) if len(renderers) == 1: # only default math_renderer (mathjax) is registered return renderers[0] @@ -421,12 +410,19 @@ def render_partial(self, node: Node | None) -> dict[str, str]: """Utility: Render a lone doctree node.""" if node is None: return {'fragment': ''} - - doc = new_document('') + doc = docutils.utils.new_document('', self._settings) doc.append(node) - self._publisher.set_source(doc) - self._publisher.publish() - return self._publisher.writer.parts + doc.transformer.add_transforms(_READER_TRANSFORMS) + doc.transformer.add_transforms(_PARSER_TRANSFORMS) + doc.transformer.add_transforms(_WRITER_TRANSFORMS) + doc.transformer.apply_transforms() + visitor: HTML5Translator = self.create_translator(doc, self) # type: ignore[assignment] + doc.walkabout(visitor) + parts = { + 'fragment': ''.join(visitor.fragment), + 'title': ''.join(visitor.title), + } + return parts def prepare_writing(self, docnames: Set[str]) -> None: # create the search indexer @@ -443,16 +439,9 @@ def prepare_writing(self, docnames: Set[str]) -> None: ) self.load_indexer(docnames) - self.docwriter = HTMLWriter(self) - with warnings.catch_warnings(): - warnings.filterwarnings('ignore', category=DeprecationWarning) - # DeprecationWarning: The frontend.OptionParser class will be replaced - # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later. - self.docsettings: Any = OptionParser( - defaults=self.env.settings, - components=(self.docwriter,), - read_config_files=True, - ).get_default_values() + self.docsettings = _get_settings( + HTMLWriter, defaults=self.env.settings, read_config_files=True + ) self.docsettings.compact_lists = bool(self.config.html_compact_lists) # determine the additional indices to include @@ -516,9 +505,9 @@ def prepare_writing(self, docnames: Set[str]) -> None: )) # add assets registered after ``Builder.init()``. - for css_filename, attrs in self.env._registry.css_files: + for css_filename, attrs in self._registry.css_files: self.add_css_file(css_filename, **attrs) - for js_filename, attrs in self.env._registry.js_files: + for js_filename, attrs in self._registry.js_files: self.add_js_file(js_filename or '', **attrs) # back up _css_files and _js_files to allow adding CSS/JS files to a specific page. @@ -659,7 +648,6 @@ def copy_assets(self) -> None: self.finish_tasks.join() def write_doc(self, docname: str, doctree: nodes.document) -> None: - destination = StringOutput(encoding='utf-8') doctree.settings = self.docsettings self.secnumbers = self.env.toc_secnumbers.get(docname, {}) @@ -667,20 +655,21 @@ def write_doc(self, docname: str, doctree: nodes.document) -> None: self.imgpath = relative_uri(self.get_target_uri(docname), '_images') self.dlpath = relative_uri(self.get_target_uri(docname), '_downloads') self.current_docname = docname - self.docwriter.write(doctree, destination) - self.docwriter.assemble_parts() - body = self.docwriter.parts['fragment'] - metatags = self.docwriter.clean_meta + visitor: HTML5Translator = self.create_translator(doctree, self) # type: ignore[assignment] + doctree.walkabout(visitor) + body = ''.join(visitor.fragment) + clean_meta = ''.join(visitor.meta[2:]) - ctx = self.get_doc_context(docname, body, metatags) - ctx['has_maths_elements'] = self.docwriter._has_maths_elements + ctx = self.get_doc_context(docname, body, clean_meta) + ctx['has_maths_elements'] = getattr(visitor, '_has_maths_elements', False) self.handle_page(docname, ctx, event_arg=doctree) def write_doc_serialized(self, docname: str, doctree: nodes.document) -> None: self.imgpath = relative_uri(self.get_target_uri(docname), self.imagedir) self.post_process_images(doctree) + # get title as plain text title_node = self.env.longtitles.get(docname) - title = self.render_partial(title_node)['title'] if title_node else '' + title = title_node.astext() if title_node else '' self.index_page(docname, doctree, title) def finish(self) -> None: @@ -779,7 +768,7 @@ def copy_image_files(self) -> None: __('copying images... '), 'brown', len(self.images), - self.app.verbosity, + self.config.verbosity, stringify_func=stringify_func, ): dest = self.images[src] @@ -806,7 +795,7 @@ def to_relpath(f: str) -> str: __('copying downloadable files... '), 'brown', len(self.env.dlfiles), - self.app.verbosity, + self.config.verbosity, stringify_func=to_relpath, ): try: @@ -1028,7 +1017,7 @@ def _get_local_toctree( if kwargs.get('maxdepth') == '': # NoQA: PLC1901 kwargs.pop('maxdepth') toctree = global_toctree_for_doc( - self.env, docname, self, collapse=collapse, **kwargs + self.env, docname, self, tags=self.tags, collapse=collapse, **kwargs ) return self.render_partial(toctree)['fragment'] @@ -1038,31 +1027,30 @@ def get_output_path(self, page_name: str, /) -> Path: def get_outfilename(self, pagename: str) -> _StrPath: return _StrPath(self.get_output_path(pagename)) - def add_sidebars(self, pagename: str, ctx: dict[str, Any]) -> None: - def has_wildcard(pattern: str) -> bool: - return any(char in pattern for char in '*?[') - + def _get_sidebars(self, pagename: str, /) -> tuple[str, ...]: matched = None # default sidebars settings for selected theme - sidebars = list(self.theme.sidebar_templates) + sidebars = self.theme.sidebar_templates # user sidebar settings html_sidebars = self.get_builder_config('sidebars', 'html') msg = __('page %s matches two patterns in html_sidebars: %r and %r') for pattern, pat_sidebars in html_sidebars.items(): if patmatch(pagename, pattern): - if matched and has_wildcard(pattern): + if matched and _has_wildcard(pattern): # warn if both patterns contain wildcards - if has_wildcard(matched): + if _has_wildcard(matched): logger.warning(msg, pagename, matched, pattern) # else the already matched pattern is more specific # than the present one, because it contains no wildcard continue matched = pattern - sidebars = pat_sidebars + sidebars = tuple(pat_sidebars) + return sidebars - ctx['sidebars'] = list(sidebars) + def add_sidebars(self, pagename: str, ctx: dict[str, Any]) -> None: + ctx['sidebars'] = list(self._get_sidebars(pagename)) # --------- these are overwritten by the serialization builder @@ -1121,13 +1109,13 @@ def hasdoc(name: str) -> bool: ctx['hasdoc'] = hasdoc ctx['toctree'] = lambda **kwargs: self._get_local_toctree(pagename, **kwargs) - self.add_sidebars(pagename, ctx) + ctx['sidebars'] = list(self._get_sidebars(pagename)) ctx.update(addctx) # 'blah.html' should have content_root = './' not ''. ctx['content_root'] = (f'..{SEP}' * default_baseuri.count(SEP)) or f'.{SEP}' - outdir = self.app.outdir + outdir = self.outdir def css_tag(css: _CascadingStyleSheet) -> str: attrs = [ @@ -1192,21 +1180,20 @@ def js_tag(js: _JavaScript | str) -> str: templatename = new_template # sort JS/CSS before rendering HTML - try: # NoQA: SIM105 + script_files: list[_JavaScript] = ctx['script_files'] + css_files: list[_CascadingStyleSheet] = ctx['css_files'] + + # Skip sorting if users modifies script_files directly (maybe via `html_context`). + # See: https://github.com/sphinx-doc/sphinx/issues/8885 + # + # Note: priority sorting feature will not work in this case. + with contextlib.suppress(AttributeError): # Convert script_files to list to support non-list script_files # See: https://github.com/sphinx-doc/sphinx/issues/8889 - ctx['script_files'] = sorted( - ctx['script_files'], key=lambda js: js.priority - ) - except AttributeError: - # Skip sorting if users modifies script_files directly (maybe via `html_context`). - # See: https://github.com/sphinx-doc/sphinx/issues/8885 - # - # Note: priority sorting feature will not work in this case. - pass + ctx['script_files'] = sorted(script_files, key=lambda js: js.priority) with contextlib.suppress(AttributeError): - ctx['css_files'] = sorted(ctx['css_files'], key=lambda css: css.priority) + ctx['css_files'] = sorted(css_files, key=lambda css: css.priority) try: output = self.templates.render(templatename, ctx) @@ -1221,6 +1208,19 @@ def js_tag(js: _JavaScript | str) -> str: ) return except Exception as exc: + if ( + isinstance(exc, jinja2.exceptions.UndefinedError) + and exc.message == "'style' is undefined" + ): + msg = __( + "The '%s' theme does not support this version of Sphinx, " + "because it uses the 'style' field in HTML templates, " + 'which was was deprecated in Sphinx 5.1 and removed in Sphinx 7.0. ' + "The theme must be updated to use the 'styles' field instead. " + 'See https://www.sphinx-doc.org/en/master/development/html_themes/templating.html#styles' + ) + raise ThemeError(msg % self.config.html_theme) from None + msg = __('An error happened in rendering the page %s.\nReason: %r') % ( pagename, exc, @@ -1241,7 +1241,8 @@ def js_tag(js: _JavaScript | str) -> str: logger.warning(__('error writing file %s: %s'), output_path, err) if self.copysource and ctx.get('sourcename'): # copy the source file for the "show source" link - source_file_path = self._sources_dir / ctx['sourcename'] + sourcename: str = ctx['sourcename'] + source_file_path = self._sources_dir / sourcename source_file_path.parent.mkdir(parents=True, exist_ok=True) copyfile(self.env.doc2path(pagename), source_file_path, force=True) @@ -1277,6 +1278,10 @@ def dump_search_index(self) -> None: Path(search_index_tmp).replace(search_index_path) +def _has_wildcard(pattern: str, /) -> bool: + return any(char in pattern for char in '*?[') + + def convert_html_css_files(app: Sphinx, config: Config) -> None: """Convert string styled html_css_files to tuple styled one.""" html_css_files: list[tuple[str, dict[str, str]]] = [] @@ -1538,26 +1543,3 @@ def setup(app: Sphinx) -> ExtensionMetadata: 'parallel_read_safe': True, 'parallel_write_safe': True, } - - -# deprecated name -> (object to return, canonical path or empty string, removal version) -_DEPRECATED_OBJECTS: dict[str, tuple[Any, str, tuple[int, int]]] = { - 'Stylesheet': ( - _CascadingStyleSheet, - 'sphinx.builders.html._assets._CascadingStyleSheet', - (9, 0), - ), - 'JavaScript': (_JavaScript, 'sphinx.builders.html._assets._JavaScript', (9, 0)), -} - - -def __getattr__(name: str) -> Any: - if name not in _DEPRECATED_OBJECTS: - msg = f'module {__name__!r} has no attribute {name!r}' - raise AttributeError(msg) - - from sphinx.deprecation import _deprecation_warning - - deprecated_object, canonical_name, remove = _DEPRECATED_OBJECTS[name] - _deprecation_warning(__name__, name, canonical_name, remove=remove) - return deprecated_object diff --git a/sphinx/builders/html/_assets.py b/sphinx/builders/html/_assets.py index 309d40d89ed..54f7aa617b5 100644 --- a/sphinx/builders/html/_assets.py +++ b/sphinx/builders/html/_assets.py @@ -1,12 +1,10 @@ from __future__ import annotations import os -import warnings import zlib from functools import cache from typing import TYPE_CHECKING -from sphinx.deprecation import RemovedInSphinx90Warning from sphinx.errors import ThemeError if TYPE_CHECKING: @@ -42,14 +40,6 @@ def __str__(self) -> str: ) def __eq__(self, other: object) -> bool: - if isinstance(other, str): - warnings.warn( - 'The str interface for _CascadingStyleSheet objects is deprecated. ' - 'Use css.filename instead.', - RemovedInSphinx90Warning, - stacklevel=2, - ) - return self.filename == other if not isinstance(other, _CascadingStyleSheet): return NotImplemented return ( @@ -69,24 +59,6 @@ def __delattr__(self, key: str) -> NoReturn: msg = f'{self.__class__.__name__} is immutable' raise AttributeError(msg) - def __getattr__(self, key: str) -> str: - warnings.warn( - 'The str interface for _CascadingStyleSheet objects is deprecated. ' - 'Use css.filename instead.', - RemovedInSphinx90Warning, - stacklevel=2, - ) - return getattr(os.fspath(self.filename), key) - - def __getitem__(self, key: int | slice) -> str: - warnings.warn( - 'The str interface for _CascadingStyleSheet objects is deprecated. ' - 'Use css.filename instead.', - RemovedInSphinx90Warning, - stacklevel=2, - ) - return os.fspath(self.filename)[key] - class _JavaScript: filename: str | os.PathLike[str] @@ -116,14 +88,6 @@ def __str__(self) -> str: ) def __eq__(self, other: object) -> bool: - if isinstance(other, str): - warnings.warn( - 'The str interface for _JavaScript objects is deprecated. ' - 'Use js.filename instead.', - RemovedInSphinx90Warning, - stacklevel=2, - ) - return self.filename == other if not isinstance(other, _JavaScript): return NotImplemented return ( @@ -143,24 +107,6 @@ def __delattr__(self, key: str) -> NoReturn: msg = f'{self.__class__.__name__} is immutable' raise AttributeError(msg) - def __getattr__(self, key: str) -> str: - warnings.warn( - 'The str interface for _JavaScript objects is deprecated. ' - 'Use js.filename instead.', - RemovedInSphinx90Warning, - stacklevel=2, - ) - return getattr(os.fspath(self.filename), key) - - def __getitem__(self, key: int | slice) -> str: - warnings.warn( - 'The str interface for _JavaScript objects is deprecated. ' - 'Use js.filename instead.', - RemovedInSphinx90Warning, - stacklevel=2, - ) - return os.fspath(self.filename)[key] - def _file_checksum(outdir: Path, filename: str | os.PathLike[str]) -> str: filename = os.fspath(filename) diff --git a/sphinx/builders/latex/__init__.py b/sphinx/builders/latex/__init__.py index 5aeafca8bfd..69c11d515b8 100644 --- a/sphinx/builders/latex/__init__.py +++ b/sphinx/builders/latex/__init__.py @@ -4,12 +4,9 @@ import os import os.path -import warnings from pathlib import Path from typing import TYPE_CHECKING -from docutils.frontend import OptionParser - import sphinx.builders.latex.nodes # NoQA: F401 # Workaround: import this before writer to avoid ImportError from sphinx import addnodes, highlighting, package_dir from sphinx._cli.util.colour import darkgreen @@ -27,7 +24,7 @@ from sphinx.locale import _, __ from sphinx.util import logging, texescape from sphinx.util.display import progress_message, status_iterator -from sphinx.util.docutils import SphinxFileOutput, new_document +from sphinx.util.docutils import _get_settings, new_document from sphinx.util.fileutil import copy_asset_file from sphinx.util.i18n import format_date from sphinx.util.nodes import inline_all_toctrees @@ -132,7 +129,7 @@ def init(self) -> None: self.context: dict[str, Any] = {} self.docnames: Iterable[str] = {} self.document_data: list[tuple[str, str, str, str, str, bool]] = [] - self.themes = ThemeFactory(self.app) + self.themes = ThemeFactory(srcdir=self.srcdir, config=self.config) texescape.init() self.init_context() @@ -211,7 +208,7 @@ def init_context(self) -> None: def update_context(self) -> None: """Update template variables for .tex file just before writing.""" # Apply extension settings to context - registry = self.env._registry + registry = self._registry self.context['packages'] = registry.latex_packages self.context['packages_after_hyperref'] = registry.latex_packages_after_hyperref @@ -300,16 +297,9 @@ def copy_assets(self) -> None: self.copy_latex_additional_files() def write_documents(self, _docnames: Set[str]) -> None: - docwriter = LaTeXWriter(self) - with warnings.catch_warnings(): - warnings.filterwarnings('ignore', category=DeprecationWarning) - # DeprecationWarning: The frontend.OptionParser class will be replaced - # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later. - docsettings: Any = OptionParser( - defaults=self.env.settings, - components=(docwriter,), - read_config_files=True, - ).get_default_values() + docsettings = _get_settings( + LaTeXWriter, defaults=self.env.settings, read_config_files=True + ) for entry in self.document_data: docname, targetname, title, author, themename = entry[:5] @@ -317,11 +307,6 @@ def write_documents(self, _docnames: Set[str]) -> None: toctree_only = False if len(entry) > 5: toctree_only = entry[5] - destination = SphinxFileOutput( - destination_path=self.outdir / targetname, - encoding='utf-8', - overwrite_if_changed=True, - ) with progress_message(__('processing %s') % targetname, nonl=False): doctree = self.env.get_doctree(docname) toctree = next(doctree.findall(addnodes.toctree), None) @@ -352,8 +337,16 @@ def write_documents(self, _docnames: Set[str]) -> None: docsettings._docclass = theme.name doctree.settings = docsettings - docwriter.theme = theme - docwriter.write(doctree, destination) + visitor: LaTeXTranslator = self.create_translator(doctree, self, theme) # type: ignore[assignment] + doctree.walkabout(visitor) + output = visitor.astext() + destination_path = self.outdir / targetname + # https://github.com/sphinx-doc/sphinx/issues/4362 + if ( + not destination_path.is_file() + or destination_path.read_bytes() != output.encode() + ): + destination_path.write_text(output, encoding='utf-8') def get_contentsname(self, indexfile: str) -> str: tree = self.env.get_doctree(indexfile) @@ -481,7 +474,7 @@ def copy_image_files(self) -> None: __('copying images... '), 'brown', len(self.images), - self.app.verbosity, + self.config.verbosity, stringify_func=stringify_func, ): dest = self.images[src] @@ -513,9 +506,9 @@ def write_message_catalog(self) -> None: formats = self.config.numfig_format context = { 'addtocaptions': r'\@iden', - 'figurename': formats.get('figure', '').split('%s', 1), - 'tablename': formats.get('table', '').split('%s', 1), - 'literalblockname': formats.get('code-block', '').split('%s', 1), + 'figurename': formats.get('figure', '').split('%s', maxsplit=1), + 'tablename': formats.get('table', '').split('%s', maxsplit=1), + 'literalblockname': formats.get('code-block', '').split('%s', maxsplit=1), } if self.context['babel'] or self.context['polyglossia']: diff --git a/sphinx/builders/latex/theming.py b/sphinx/builders/latex/theming.py index f55c077c9ca..df8eb48ec4f 100644 --- a/sphinx/builders/latex/theming.py +++ b/sphinx/builders/latex/theming.py @@ -12,7 +12,6 @@ if TYPE_CHECKING: from pathlib import Path - from sphinx.application import Sphinx from sphinx.config import Config logger = logging.getLogger(__name__) @@ -102,11 +101,11 @@ def __init__(self, name: str, filename: Path) -> None: class ThemeFactory: """A factory class for LaTeX Themes.""" - def __init__(self, app: Sphinx) -> None: + def __init__(self, *, srcdir: Path, config: Config) -> None: self.themes: dict[str, Theme] = {} - self.theme_paths = [app.srcdir / p for p in app.config.latex_theme_path] - self.config = app.config - self.load_builtin_themes(app.config) + self.theme_paths = [srcdir / p for p in config.latex_theme_path] + self.config = config + self.load_builtin_themes(config) def load_builtin_themes(self, config: Config) -> None: """Load built-in themes.""" diff --git a/sphinx/builders/latex/transforms.py b/sphinx/builders/latex/transforms.py index 9fa180a7dd9..4cbc2930e25 100644 --- a/sphinx/builders/latex/transforms.py +++ b/sphinx/builders/latex/transforms.py @@ -40,7 +40,7 @@ class FootnoteDocnameUpdater(SphinxTransform): def apply(self, **kwargs: Any) -> None: matcher = NodeMatcher(*self.TARGET_NODES) for node in matcher.findall(self.document): - node['docname'] = self.env.docname + node['docname'] = self.env.current_document.docname class SubstitutionDefinitionsRemover(SphinxPostTransform): @@ -420,7 +420,7 @@ def depart_caption(self, node: nodes.caption) -> None: self.unrestrict(node) def visit_title(self, node: nodes.title) -> None: - if isinstance(node.parent, nodes.section | nodes.table): + if isinstance(node.parent, (nodes.section, nodes.table)): self.restrict(node) def depart_title(self, node: nodes.title) -> None: @@ -528,7 +528,7 @@ def run(self, **kwargs: Any) -> None: citations += node if len(citations) > 0: - self.document += citations # type: ignore[attr-defined] + self.document += citations class CitationReferenceTransform(SphinxPostTransform): diff --git a/sphinx/builders/linkcheck.py b/sphinx/builders/linkcheck.py index 93ab2e78b00..5889e75d126 100644 --- a/sphinx/builders/linkcheck.py +++ b/sphinx/builders/linkcheck.py @@ -25,16 +25,17 @@ from sphinx._cli.util.colour import darkgray, darkgreen, purple, red, turquoise from sphinx.builders.dummy import DummyBuilder +from sphinx.errors import ConfigError from sphinx.locale import __ from sphinx.transforms.post_transforms import SphinxPostTransform from sphinx.util import logging, requests from sphinx.util._uri import encode_uri from sphinx.util.http_date import rfc1123_to_epoch -from sphinx.util.nodes import get_node_line +from sphinx.util.nodes import NodeMatcher, get_node_line if TYPE_CHECKING: - from collections.abc import Callable, Iterator - from typing import Any, Literal, TypeAlias + from collections.abc import Callable, Iterator, Sequence + from typing import Any, Literal from requests import Response @@ -43,7 +44,7 @@ from sphinx.util._pathlib import _StrPath from sphinx.util.typing import ExtensionMetadata - _URIProperties: TypeAlias = tuple['_Status', str, int] + type _URIProperties = tuple[_Status, str, int] class _Status(StrEnum): @@ -70,6 +71,15 @@ class _Status(StrEnum): DEFAULT_DELAY = 60.0 +@object.__new__ +class _SENTINEL_LAR: + def __repr__(self) -> str: + return '_SENTINEL_LAR' + + def __reduce__(self) -> str: + return self.__class__.__name__ + + class CheckExternalLinksBuilder(DummyBuilder): """Checks for broken external links.""" @@ -97,7 +107,7 @@ def finish(self) -> None: self.process_result(result) if self.broken_hyperlinks or self.timed_out_hyperlinks: - self.app.statuscode = 1 + self._app.statuscode = 1 def process_result(self, result: CheckResult) -> None: filename = self.env.doc2path(result.docname, False) @@ -129,7 +139,7 @@ def process_result(self, result: CheckResult) -> None: case _Status.WORKING: logger.info(darkgreen('ok ') + f'{res_uri}{result.message}') # NoQA: G003 case _Status.TIMEOUT: - if self.app.quiet: + if self.config.verbosity < 0: msg = 'timeout ' + f'{res_uri}{result.message}' logger.warning(msg, location=(result.docname, result.lineno)) else: @@ -144,7 +154,7 @@ def process_result(self, result: CheckResult) -> None: ) self.timed_out_hyperlinks += 1 case _Status.BROKEN: - if self.app.quiet: + if self.config.verbosity < 0: logger.warning( __('broken link: %s (%s)'), res_uri, @@ -178,7 +188,7 @@ def process_result(self, result: CheckResult) -> None: text = 'with unknown code' linkstat['text'] = text redirection = f'{text} to {result.message}' - if self.config.linkcheck_allowed_redirects: + if self.config.linkcheck_allowed_redirects is not _SENTINEL_LAR: msg = f'redirect {res_uri} - {redirection}' logger.warning(msg, location=(result.docname, result.lineno)) else: @@ -211,7 +221,8 @@ class HyperlinkCollector(SphinxPostTransform): default_priority = 800 def run(self, **kwargs: Any) -> None: - for node in self.document.findall(): + matcher = NodeMatcher(nodes.image, nodes.raw, nodes.reference) + for node in matcher.findall(self.document): if uri := self.find_uri(node): self._add_uri(uri, node) @@ -258,11 +269,11 @@ def _add_uri(self, uri: str, node: nodes.Element) -> None: :param uri: URI to add :param node: A node class where the URI was found """ - builder = cast('CheckExternalLinksBuilder', self.app.builder) + builder = cast('CheckExternalLinksBuilder', self.env._app.builder) hyperlinks = builder.hyperlinks - docname = self.env.docname + docname = self.env.current_document.docname - if newuri := self.app.events.emit_firstresult('linkcheck-process-uri', uri): + if newuri := self.env.events.emit_firstresult('linkcheck-process-uri', uri): uri = newuri try: @@ -375,6 +386,9 @@ def __init__( self.documents_exclude: list[re.Pattern[str]] = list( map(re.compile, config.linkcheck_exclude_documents) ) + self.ignore_case: Sequence[re.Pattern[str]] = tuple( + map(re.compile, config.linkcheck_case_insensitive_urls) + ) self.auth = [ (re.compile(pattern), auth_info) for pattern, auth_info in config.linkcheck_auth @@ -619,8 +633,15 @@ def _check_uri(self, uri: str, hyperlink: Hyperlink) -> _URIProperties: netloc = urlsplit(req_url).netloc self.rate_limits.pop(netloc, None) + # Check if URL should be normalised case-insensitively + ignore_case = any(pat.match(req_url) for pat in self.ignore_case) + normalised_req_url = self._normalise_url(req_url, ignore_case=ignore_case) + normalised_response_url = self._normalise_url( + response_url, ignore_case=ignore_case + ) + if ( - (response_url.rstrip('/') == req_url.rstrip('/')) + normalised_response_url == normalised_req_url or _allowed_redirect(req_url, response_url, self.allowed_redirects) ): # fmt: skip return _Status.WORKING, '', 0 @@ -666,6 +687,17 @@ def limit_rate(self, response_url: str, retry_after: str | None) -> float | None self.rate_limits[netloc] = RateLimit(delay, next_check) return next_check + @staticmethod + def _normalise_url(url: str, *, ignore_case: bool) -> str: + normalised_url = url.rstrip('/') + if not ignore_case: + return normalised_url + # URI fragments are case-sensitive + url_part, sep, fragment = normalised_url.partition('#') + if sep: + return f'{url_part.casefold()}#{fragment}' + return url_part.casefold() + def _get_request_headers( uri: str, @@ -721,6 +753,8 @@ def handle_starttag(self, tag: Any, attrs: Any) -> None: def _allowed_redirect( url: str, new_url: str, allowed_redirects: dict[re.Pattern[str], re.Pattern[str]] ) -> bool: + if allowed_redirects is _SENTINEL_LAR: + return False return any( from_url.match(url) and to_url.match(new_url) for from_url, to_url in allowed_redirects.items() @@ -748,20 +782,26 @@ def rewrite_github_anchor(app: Sphinx, uri: str) -> str | None: def compile_linkcheck_allowed_redirects(app: Sphinx, config: Config) -> None: - """Compile patterns in linkcheck_allowed_redirects to the regexp objects.""" - linkcheck_allowed_redirects = app.config.linkcheck_allowed_redirects - for url, pattern in list(linkcheck_allowed_redirects.items()): + """Compile patterns to the regexp objects.""" + if config.linkcheck_allowed_redirects is _SENTINEL_LAR: + return + if not isinstance(config.linkcheck_allowed_redirects, dict): + msg = __( + f'Invalid value `{config.linkcheck_allowed_redirects!r}` in ' + 'linkcheck_allowed_redirects. Expected a dictionary.' + ) + raise ConfigError(msg) + allowed_redirects = {} + for url, pattern in config.linkcheck_allowed_redirects.items(): try: - linkcheck_allowed_redirects[re.compile(url)] = re.compile(pattern) + allowed_redirects[re.compile(url)] = re.compile(pattern) except re.error as exc: logger.warning( __('Failed to compile regex in linkcheck_allowed_redirects: %r %s'), exc.pattern, exc.msg, ) - finally: - # Remove the original regexp-string - linkcheck_allowed_redirects.pop(url) + config.linkcheck_allowed_redirects = allowed_redirects def setup(app: Sphinx) -> ExtensionMetadata: @@ -772,7 +812,9 @@ def setup(app: Sphinx) -> ExtensionMetadata: app.add_config_value( 'linkcheck_exclude_documents', [], '', types=frozenset({list, tuple}) ) - app.add_config_value('linkcheck_allowed_redirects', {}, '', types=frozenset({dict})) + app.add_config_value( + 'linkcheck_allowed_redirects', _SENTINEL_LAR, '', types=frozenset({dict}) + ) app.add_config_value('linkcheck_auth', [], '', types=frozenset({list, tuple})) app.add_config_value('linkcheck_request_headers', {}, '', types=frozenset({dict})) app.add_config_value('linkcheck_retries', 1, '', types=frozenset({int})) @@ -796,10 +838,17 @@ def setup(app: Sphinx) -> ExtensionMetadata: app.add_config_value( 'linkcheck_report_timeouts_as_broken', False, '', types=frozenset({bool}) ) + app.add_config_value( + 'linkcheck_case_insensitive_urls', + (), + '', + types=frozenset({frozenset, list, set, tuple}), + ) app.add_event('linkcheck-process-uri') - app.connect('config-inited', compile_linkcheck_allowed_redirects, priority=800) + # priority 900 to happen after ``check_confval_types()`` + app.connect('config-inited', compile_linkcheck_allowed_redirects, priority=900) # FIXME: Disable URL rewrite handler for github.com temporarily. # See: https://github.com/sphinx-doc/sphinx/issues/9435 diff --git a/sphinx/builders/manpage.py b/sphinx/builders/manpage.py index 7b62b7dca5a..d30e697d292 100644 --- a/sphinx/builders/manpage.py +++ b/sphinx/builders/manpage.py @@ -2,25 +2,25 @@ from __future__ import annotations -import warnings from typing import TYPE_CHECKING -from docutils.frontend import OptionParser -from docutils.io import FileOutput - from sphinx import addnodes from sphinx._cli.util.colour import darkgreen from sphinx.builders import Builder from sphinx.locale import __ from sphinx.util import logging from sphinx.util.display import progress_message +from sphinx.util.docutils import _get_settings from sphinx.util.nodes import inline_all_toctrees from sphinx.util.osutil import ensuredir, make_filename_from_project -from sphinx.writers.manpage import ManualPageTranslator, ManualPageWriter +from sphinx.writers.manpage import ( + ManualPageTranslator, + ManualPageWriter, + NestedInlineTransform, +) if TYPE_CHECKING: from collections.abc import Set - from typing import Any from sphinx.application import Sphinx from sphinx.config import Config @@ -37,7 +37,7 @@ class ManualPageBuilder(Builder): epilog = __('The manual pages are in %(outdir)s.') default_translator_class = ManualPageTranslator - supported_image_types: list[str] = [] + supported_image_types = [] def init(self) -> None: if not self.config.man_pages: @@ -53,16 +53,9 @@ def get_target_uri(self, docname: str, typ: str | None = None) -> str: @progress_message(__('writing')) def write_documents(self, _docnames: Set[str]) -> None: - docwriter = ManualPageWriter(self) - with warnings.catch_warnings(): - warnings.filterwarnings('ignore', category=DeprecationWarning) - # DeprecationWarning: The frontend.OptionParser class will be replaced - # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later. - docsettings: Any = OptionParser( - defaults=self.env.settings, - components=(docwriter,), - read_config_files=True, - ).get_default_values() + docsettings = _get_settings( + ManualPageWriter, defaults=self.env.settings, read_config_files=True + ) for info in self.config.man_pages: docname, name, description, authors, section = info @@ -91,10 +84,6 @@ def write_documents(self, _docnames: Set[str]) -> None: targetname = f'{name}.{section}' logger.info('%s { ', darkgreen(targetname)) - destination = FileOutput( - destination_path=self.outdir / targetname, - encoding='utf-8', - ) tree = self.env.get_doctree(docname) docnames: set[str] = set() @@ -108,7 +97,11 @@ def write_documents(self, _docnames: Set[str]) -> None: for pendingnode in largetree.findall(addnodes.pending_xref): pendingnode.replace_self(pendingnode.children) - docwriter.write(largetree, destination) + transform = NestedInlineTransform(largetree) + transform.apply() + visitor: ManualPageTranslator = self.create_translator(largetree, self) # type: ignore[assignment] + largetree.walkabout(visitor) + (self.outdir / targetname).write_text(visitor.astext(), encoding='utf-8') def finish(self) -> None: pass diff --git a/sphinx/builders/singlehtml.py b/sphinx/builders/singlehtml.py index c95603927ce..1888f6679d1 100644 --- a/sphinx/builders/singlehtml.py +++ b/sphinx/builders/singlehtml.py @@ -84,7 +84,7 @@ def _get_local_toctree( if kwargs.get('maxdepth') == '': # NoQA: PLC1901 kwargs.pop('maxdepth') toctree = global_toctree_for_doc( - self.env, docname, self, collapse=collapse, **kwargs + self.env, docname, self, tags=self.tags, collapse=collapse, **kwargs ) return self.render_partial(toctree)['fragment'] @@ -141,7 +141,7 @@ def assemble_toc_fignumbers( def get_doc_context(self, docname: str, body: str, metatags: str) -> dict[str, Any]: # no relation links... toctree = global_toctree_for_doc( - self.env, self.config.root_doc, self, collapse=False + self.env, self.config.root_doc, self, tags=self.tags, collapse=False ) # if there is no toctree, toc is None if toctree: diff --git a/sphinx/builders/texinfo.py b/sphinx/builders/texinfo.py index 79afafab84d..ba3cd0c0d10 100644 --- a/sphinx/builders/texinfo.py +++ b/sphinx/builders/texinfo.py @@ -3,12 +3,9 @@ from __future__ import annotations import os.path -import warnings from typing import TYPE_CHECKING from docutils import nodes -from docutils.frontend import OptionParser -from docutils.io import FileOutput from sphinx import addnodes, package_dir from sphinx._cli.util.colour import darkgreen @@ -18,14 +15,13 @@ from sphinx.locale import _, __ from sphinx.util import logging from sphinx.util.display import progress_message, status_iterator -from sphinx.util.docutils import new_document +from sphinx.util.docutils import _get_settings, new_document from sphinx.util.nodes import inline_all_toctrees from sphinx.util.osutil import SEP, copyfile, ensuredir, make_filename_from_project from sphinx.writers.texinfo import TexinfoTranslator, TexinfoWriter if TYPE_CHECKING: from collections.abc import Iterable, Set - from typing import Any from docutils.nodes import Node @@ -106,10 +102,6 @@ def write_documents(self, _docnames: Set[str]) -> None: toctree_only = False if len(entry) > 7: toctree_only = entry[7] - destination = FileOutput( - destination_path=self.outdir / targetname, - encoding='utf-8', - ) with progress_message(__('processing %s') % targetname, nonl=False): appendices = self.config.texinfo_appendices or [] doctree = self.assemble_doctree( @@ -118,16 +110,9 @@ def write_documents(self, _docnames: Set[str]) -> None: with progress_message(__('writing')): self.post_process_images(doctree) - docwriter = TexinfoWriter(self) - with warnings.catch_warnings(): - warnings.filterwarnings('ignore', category=DeprecationWarning) - # DeprecationWarning: The frontend.OptionParser class will be replaced - # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later. - settings: Any = OptionParser( - defaults=self.env.settings, - components=(docwriter,), - read_config_files=True, - ).get_default_values() + settings = _get_settings( + TexinfoWriter, defaults=self.env.settings, read_config_files=True + ) settings.author = author settings.title = title settings.texinfo_filename = targetname[:-5] + '.info' @@ -137,7 +122,10 @@ def write_documents(self, _docnames: Set[str]) -> None: settings.texinfo_dir_description = description or '' settings.docname = docname doctree.settings = settings - docwriter.write(doctree, destination) + visitor: TexinfoTranslator = self.create_translator(doctree, self) # type: ignore[assignment] + doctree.walkabout(visitor) + visitor.finish() + (self.outdir / targetname).write_text(visitor.output, encoding='utf-8') self.copy_image_files(targetname[:-5]) def assemble_doctree( @@ -198,7 +186,7 @@ def copy_image_files(self, targetname: str) -> None: __('copying images... '), 'brown', len(self.images), - self.app.verbosity, + self.config.verbosity, stringify_func=stringify_func, ): dest = self.images[src] diff --git a/sphinx/builders/text.py b/sphinx/builders/text.py index bd7731fdb49..186e71e79da 100644 --- a/sphinx/builders/text.py +++ b/sphinx/builders/text.py @@ -4,16 +4,14 @@ from typing import TYPE_CHECKING -from docutils.io import StringOutput - from sphinx.builders import Builder from sphinx.locale import __ from sphinx.util import logging from sphinx.util.osutil import _last_modified_time -from sphinx.writers.text import TextTranslator, TextWriter +from sphinx.writers.text import TextTranslator if TYPE_CHECKING: - from collections.abc import Iterator, Set + from collections.abc import Iterator from docutils import nodes @@ -59,19 +57,16 @@ def get_outdated_docs(self) -> Iterator[str]: def get_target_uri(self, docname: str, typ: str | None = None) -> str: return '' - def prepare_writing(self, docnames: Set[str]) -> None: - self.writer = TextWriter(self) - def write_doc(self, docname: str, doctree: nodes.document) -> None: self.current_docname = docname self.secnumbers = self.env.toc_secnumbers.get(docname, {}) - destination = StringOutput(encoding='utf-8') - self.writer.write(doctree, destination) + visitor: TextTranslator = self.create_translator(doctree, self) # type: ignore[assignment] + doctree.walkabout(visitor) + output = visitor.body out_file_name = self.outdir / (docname + self.out_suffix) out_file_name.parent.mkdir(parents=True, exist_ok=True) try: - with open(out_file_name, 'w', encoding='utf-8') as f: - f.write(self.writer.output) + out_file_name.write_text(output, encoding='utf-8') except OSError as err: logger.warning(__('error writing file %s: %s'), out_file_name, err) diff --git a/sphinx/builders/xml.py b/sphinx/builders/xml.py index fab0f7cb5c4..e1a50ca45b7 100644 --- a/sphinx/builders/xml.py +++ b/sphinx/builders/xml.py @@ -5,17 +5,15 @@ from typing import TYPE_CHECKING from docutils import nodes -from docutils.io import StringOutput from docutils.writers.docutils_xml import XMLTranslator from sphinx.builders import Builder from sphinx.locale import __ from sphinx.util import logging from sphinx.util.osutil import _last_modified_time -from sphinx.writers.xml import PseudoXMLWriter, XMLWriter if TYPE_CHECKING: - from collections.abc import Iterator, Set + from collections.abc import Iterator from sphinx.application import Sphinx from sphinx.util.typing import ExtensionMetadata @@ -33,8 +31,6 @@ class XMLBuilder(Builder): out_suffix = '.xml' allow_parallel = True - _writer_class: type[XMLWriter | PseudoXMLWriter] = XMLWriter - writer: XMLWriter | PseudoXMLWriter default_translator_class = XMLTranslator def init(self) -> None: @@ -61,9 +57,6 @@ def get_outdated_docs(self) -> Iterator[str]: def get_target_uri(self, docname: str, typ: str | None = None) -> str: return docname - def prepare_writing(self, docnames: Set[str]) -> None: - self.writer = self._writer_class(self) - def write_doc(self, docname: str, doctree: nodes.document) -> None: # work around multiple string % tuple issues in docutils; # replace tuples in attribute values with lists @@ -79,16 +72,25 @@ def write_doc(self, docname: str, doctree: nodes.document) -> None: for i, val in enumerate(value): if isinstance(val, tuple): value[i] = list(val) - destination = StringOutput(encoding='utf-8') - self.writer.write(doctree, destination) + output = self._translate(doctree) out_file_name = self.outdir / (docname + self.out_suffix) out_file_name.parent.mkdir(parents=True, exist_ok=True) try: - with open(out_file_name, 'w', encoding='utf-8') as f: - f.write(self.writer.output) + out_file_name.write_text(output, encoding='utf-8') except OSError as err: logger.warning(__('error writing file %s: %s'), out_file_name, err) + def _translate(self, doctree: nodes.document) -> str: + doctree.settings.newlines = doctree.settings.indents = self.config.xml_pretty + doctree.settings.xml_declaration = True + doctree.settings.doctype_declaration = True + + # copied from docutils.writers.docutils_xml.Writer.translate() + # so that we can override the translator class + visitor: XMLTranslator = self.create_translator(doctree) # type: ignore[assignment] + doctree.walkabout(visitor) + return ''.join(visitor.output) # ty: ignore[unresolved-attribute] + def finish(self) -> None: pass @@ -102,7 +104,8 @@ class PseudoXMLBuilder(XMLBuilder): out_suffix = '.pseudoxml' - _writer_class = PseudoXMLWriter + def _translate(self, doctree: nodes.document) -> str: + return doctree.pformat() def setup(app: Sphinx) -> ExtensionMetadata: diff --git a/sphinx/cmd/build.py b/sphinx/cmd/build.py index 11a70df0c6c..a73717a71d1 100644 --- a/sphinx/cmd/build.py +++ b/sphinx/cmd/build.py @@ -358,7 +358,7 @@ def _parse_logging( warning = TeeStripANSI(warning, warnfp) # type: ignore[assignment] error = warning - return status, warning, error, warnfp + return status, warning, error, warnfp # ty: ignore[invalid-return-type] def _parse_confoverrides( @@ -371,14 +371,14 @@ def _parse_confoverrides( val: Any for val in define: try: - key, val = val.split('=', 1) + key, _, val = val.partition('=') except ValueError: parser.error(__('-D option argument must be in the form name=value')) confoverrides[key] = val for val in htmldefine: try: - key, val = val.split('=') + key, _, val = val.partition('=') except ValueError: parser.error(__('-A option argument must be in the form name=value')) with contextlib.suppress(ValueError): diff --git a/sphinx/cmd/quickstart.py b/sphinx/cmd/quickstart.py index 0275343e847..a376270af7c 100644 --- a/sphinx/cmd/quickstart.py +++ b/sphinx/cmd/quickstart.py @@ -89,7 +89,8 @@ # function to get input from terminal -- overridden by the test suite -def term_input(prompt: str) -> str: +# Arguments are positional-only to match ``input``. +def term_input(prompt: str, /) -> str: if sys.platform == 'win32': # Important: On windows, readline is not enabled by default. In these # environment, escape sequences have been broken. To avoid the @@ -244,8 +245,9 @@ def ask_user(d: dict[str, Any]) -> None: print(__('Enter the root path for documentation.')) d['path'] = do_prompt(__('Root path for the documentation'), '.', is_path) - while os.path.isfile(os.path.join(d['path'], 'conf.py')) or os.path.isfile( - os.path.join(d['path'], 'source', 'conf.py') + d_path: str = d['path'] + while os.path.isfile(os.path.join(d_path, 'conf.py')) or os.path.isfile( + os.path.join(d_path, 'source', 'conf.py') ): print() print( @@ -356,9 +358,12 @@ def ask_user(d: dict[str, Any]) -> None: __('Name of your master document (without suffix)'), 'index' ) + d_path = d['path'] + d_master: str = d['master'] + d_suffix: str = d['suffix'] while ( - os.path.isfile(os.path.join(d['path'], d['master'] + d['suffix'])) - or os.path.isfile(os.path.join(d['path'], 'source', d['master'] + d['suffix'])) + os.path.isfile(os.path.join(d_path, d_master + d_suffix)) + or os.path.isfile(os.path.join(d_path, 'source', d_master + d_suffix)) ): # fmt: skip print() print( @@ -367,7 +372,7 @@ def ask_user(d: dict[str, Any]) -> None: 'Error: the master file %s has already been found in the ' 'selected root path.' ) - % (d['master'] + d['suffix']) + % (d_master + d_suffix) ) ) print(__('sphinx-quickstart will not overwrite the existing file.')) @@ -801,7 +806,7 @@ def main(argv: Sequence[str] = (), /) -> int: print('[Interrupted.]') return 130 # 128 + SIGINT - for variable in d.get('variables', []): + for variable in d.get('variables', []): # type: ignore[union-attr] try: name, value = variable.split('=') d[name] = value diff --git a/sphinx/config.py b/sphinx/config.py index bedc69f2337..9b791702ec0 100644 --- a/sphinx/config.py +++ b/sphinx/config.py @@ -5,13 +5,11 @@ import time import traceback import types -import warnings from contextlib import chdir from os import getenv from pathlib import Path from typing import TYPE_CHECKING, Any, Literal, NamedTuple -from sphinx.deprecation import RemovedInSphinx90Warning from sphinx.errors import ConfigError, ExtensionError from sphinx.locale import _, __ from sphinx.util import logging @@ -19,7 +17,6 @@ if TYPE_CHECKING: import os from collections.abc import Collection, Iterable, Iterator, Sequence, Set - from typing import TypeAlias from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment @@ -28,7 +25,7 @@ logger = logging.getLogger(__name__) -_ConfigRebuild: TypeAlias = Literal[ +type _ConfigRebuild = Literal[ '', 'env', 'epub', @@ -65,7 +62,7 @@ def is_serializable(obj: object, *, _seen: frozenset[int] = frozenset()) -> bool is_serializable(key, _seen=seen) and is_serializable(value, _seen=seen) for key, value in obj.items() ) - elif isinstance(obj, list | tuple | set | frozenset): + elif isinstance(obj, (list, tuple, set, frozenset)): seen = _seen | {id(obj)} return all(is_serializable(item, _seen=seen) for item in obj) @@ -89,12 +86,12 @@ def __repr__(self) -> str: return f'ENUM({", ".join(sorted(map(repr, self._candidates)))})' def match(self, value: str | bool | None | Sequence[str | bool | None]) -> bool: # NoQA: RUF036 - if isinstance(value, str | bool | None): + if isinstance(value, (str, bool, types.NoneType)): return value in self._candidates return all(item in self._candidates for item in value) -_OptValidTypes: TypeAlias = frozenset[type] | ENUM +type _OptValidTypes = frozenset[type] | ENUM class _Opt: @@ -165,7 +162,7 @@ def __lt__(self, other: _Opt) -> bool: other.valid_types, other.description, ) - return self_tpl > other_tpl + return self_tpl > other_tpl # ty: ignore[unsupported-operator] return NotImplemented def __hash__(self) -> int: @@ -195,15 +192,6 @@ def __setstate__( super().__setattr__('valid_types', valid_types) super().__setattr__('description', description) - def __getitem__(self, item: int | slice) -> Any: - warnings.warn( - f'The {self.__class__.__name__!r} object tuple interface is deprecated, ' - "use attribute access instead for 'default', 'rebuild', and 'valid_types'.", - RemovedInSphinx90Warning, - stacklevel=2, - ) - return (self.default, self.rebuild, self.valid_types)[item] - class Config: r"""Configuration file abstraction. @@ -320,7 +308,7 @@ def __init__( for name in list(self._overrides.keys()): if '.' in name: - real_name, key = name.split('.', 1) + real_name, _, key = name.partition('.') raw_config.setdefault(real_name, {})[key] = self._overrides.pop(name) self.setup: _ExtensionSetupFunc | None = raw_config.get('setup') @@ -333,6 +321,8 @@ def __init__( raw_config['extensions'] = extensions self.extensions: list[str] = raw_config.get('extensions', []) + self._verbosity: int = 0 # updated in Sphinx.__init__() + @property def values(self) -> dict[str, _Opt]: return self._options @@ -341,12 +331,17 @@ def values(self) -> dict[str, _Opt]: def overrides(self) -> dict[str, Any]: return self._overrides + @property + def verbosity(self) -> int: + return self._verbosity + @classmethod def read( cls: type[Config], confdir: str | os.PathLike[str], - overrides: dict[str, Any] | None = None, - tags: Tags | None = None, + *, + overrides: dict[str, Any], + tags: Tags, ) -> Config: """Create a Config object from configuration file.""" filename = Path(confdir, CONFIG_FILENAME) @@ -354,23 +349,7 @@ def read( raise ConfigError( __("config directory doesn't contain a conf.py file (%s)") % confdir ) - namespace = eval_config_file(filename, tags) - - # Note: Old sphinx projects have been configured as "language = None" because - # sphinx-quickstart previously generated this by default. - # To keep compatibility, they should be fallback to 'en' for a while - # (This conversion should not be removed before 2025-01-01). - if namespace.get('language', ...) is None: - logger.warning( - __( - "Invalid configuration value found: 'language = None'. " - 'Update your configuration to a valid language code. ' - "Falling back to 'en' (English)." - ) - ) - namespace['language'] = 'en' - - return cls(namespace, overrides) + return _read_conf_py(filename, overrides=overrides, tags=tags) def convert_overrides(self, name: str, value: str) -> Any: opt = self._options[name] @@ -583,12 +562,28 @@ def __setstate__(self, state: dict[str, Any]) -> None: self.__dict__.update(state) -def eval_config_file( - filename: str | os.PathLike[str], tags: Tags | None -) -> dict[str, Any]: - """Evaluate a config file.""" - filename = Path(filename) +def _read_conf_py(conf_path: Path, *, overrides: dict[str, Any], tags: Tags) -> Config: + """Create a Config object from a conf.py file.""" + namespace = eval_config_file(conf_path, tags) + + # Note: Old sphinx projects have been configured as "language = None" because + # sphinx-quickstart previously generated this by default. + # To keep compatibility, they should be fallback to 'en' for a while + # (This conversion should not be removed before 2025-01-01). + if namespace.get('language', ...) is None: + logger.warning( + __( + "Invalid configuration value found: 'language = None'. " + 'Update your configuration to a valid language code. ' + "Falling back to 'en' (English)." + ) + ) + namespace['language'] = 'en' + return Config(namespace, overrides) + +def eval_config_file(filename: Path, tags: Tags) -> dict[str, Any]: + """Evaluate a config file.""" namespace: dict[str, Any] = { '__file__': str(filename), 'tags': tags, @@ -623,12 +618,12 @@ def _validate_valid_types( ) -> frozenset[type] | ENUM: if not valid_types: return frozenset() - if isinstance(valid_types, frozenset | ENUM): - return valid_types + if isinstance(valid_types, (frozenset, ENUM)): + return valid_types # ty: ignore[invalid-return-type] if isinstance(valid_types, type): return frozenset((valid_types,)) if valid_types is Any: - return frozenset({Any}) # type: ignore[arg-type] + return frozenset({Any}) if isinstance(valid_types, set): return frozenset(valid_types) try: @@ -656,7 +651,7 @@ def convert_source_suffix(app: Sphinx, config: Config) -> None: source_suffix, config.source_suffix, ) - elif isinstance(source_suffix, list | tuple): + elif isinstance(source_suffix, (list, tuple)): # if list, considers as all of them are default filetype config.source_suffix = dict.fromkeys(source_suffix, 'restructuredtext') logger.info( @@ -888,7 +883,21 @@ def check_master_doc( return changed +def deprecate_source_encoding(_app: Sphinx, config: Config) -> None: + """Warn on non-UTF 8 source_encoding.""" + # RemovedInSphinx10Warning + if config.source_encoding.lower() not in {'utf-8', 'utf-8-sig', 'utf8'}: + msg = _( + 'Support for source encodings other than UTF-8 ' + 'is deprecated and will be removed in Sphinx 10. ' + 'Please comment at https://github.com/sphinx-doc/sphinx/issues/13665 ' + 'if this causes a problem.' + ) + logger.warning(msg) + + def setup(app: Sphinx) -> ExtensionMetadata: + app.connect('config-inited', deprecate_source_encoding, priority=790) app.connect('config-inited', convert_source_suffix, priority=800) app.connect('config-inited', convert_highlight_options, priority=800) app.connect('config-inited', init_numfig_format, priority=800) diff --git a/sphinx/deprecation.py b/sphinx/deprecation.py index fe7b2b1a455..f8a85bbf230 100644 --- a/sphinx/deprecation.py +++ b/sphinx/deprecation.py @@ -6,15 +6,15 @@ import warnings -class RemovedInSphinx90Warning(DeprecationWarning): +class RemovedInSphinx10Warning(DeprecationWarning): pass -class RemovedInSphinx10Warning(PendingDeprecationWarning): +class RemovedInSphinx11Warning(PendingDeprecationWarning): pass -RemovedInNextVersionWarning = RemovedInSphinx90Warning +RemovedInNextVersionWarning = RemovedInSphinx10Warning # By default, all Sphinx deprecation warnings will be emitted. @@ -50,7 +50,7 @@ def _deprecation_warning( 'deprecated_name': ( object_to_return, 'fully_qualified_replacement_name', - (9, 0), + (10, 0), ), } @@ -66,10 +66,10 @@ def __getattr__(name: str) -> Any: _deprecation_warning(__name__, name, canonical_name, remove=remove) return deprecated_object """ - if remove == (9, 0): - warning_class: type[Warning] = RemovedInSphinx90Warning - elif remove == (10, 0): - warning_class = RemovedInSphinx10Warning + if remove == (10, 0): + warning_class: type[Warning] = RemovedInSphinx10Warning + elif remove == (11, 0): + warning_class = RemovedInSphinx11Warning else: msg = f'removal version {remove!r} is invalid!' raise RuntimeError(msg) diff --git a/sphinx/directives/__init__.py b/sphinx/directives/__init__.py index b4fb7f76006..38344757b37 100644 --- a/sphinx/directives/__init__.py +++ b/sphinx/directives/__init__.py @@ -3,7 +3,7 @@ from __future__ import annotations import re -from typing import TYPE_CHECKING, Generic, TypeVar, cast +from typing import TYPE_CHECKING, cast from docutils import nodes from docutils.parsers.rst import directives, roles @@ -41,10 +41,7 @@ def optional_int(argument: str) -> int | None: return value -ObjDescT = TypeVar('ObjDescT') - - -class ObjectDescription(SphinxDirective, Generic[ObjDescT]): +class ObjectDescription[ObjDescT](SphinxDirective): """Directive to describe a class, function or similar object. Not used directly, but subclassed (in domain-specific directives) @@ -201,7 +198,7 @@ def run(self) -> list[Node]: * parse the content and handle doc fields in it """ if ':' in self.name: - self.domain, self.objtype = self.name.split(':', 1) + self.domain, _, self.objtype = self.name.partition(':') else: self.domain, self.objtype = '', self.name self.indexnode = addnodes.index(entries=[]) @@ -328,8 +325,14 @@ def run(self) -> list[Node]: docutils.unregister_role('') return [] role_name = self.arguments[0] + # TODO: TYPING: Upstream docutils should widen roles.role() to accept + # the RST language module shape (has a `roles` mapping); + # current stub requires _LanguageModule from docutils.languages. role, messages = roles.role( - role_name, self.state_machine.language, self.lineno, self.state.reporter + role_name, + self.state_machine.language, # type: ignore[arg-type] + self.lineno, + self.state.reporter, ) if role: docutils.register_role('', role) # type: ignore[arg-type] diff --git a/sphinx/directives/code.py b/sphinx/directives/code.py index e94b18a18f0..e8f9d6ddf8c 100644 --- a/sphinx/directives/code.py +++ b/sphinx/directives/code.py @@ -119,7 +119,10 @@ class CodeBlock(SphinxDirective): def run(self) -> list[Node]: document = self.state.document code = '\n'.join(self.content) - location = self.state_machine.get_source_and_line(self.lineno) + source, line = self.state_machine.get_source_and_line(self.lineno) + location: tuple[str, int] | None = ( + (source, line) if source is not None and line is not None else None + ) linespec = self.options.get('emphasize-lines') if linespec: @@ -141,7 +144,6 @@ def run(self) -> list[Node]: hl_lines = None if 'dedent' in self.options: - location = self.state_machine.get_source_and_line(self.lineno) lines = code.splitlines(True) lines = dedent_lines(lines, self.options['dedent'], location=location) code = ''.join(lines) @@ -454,7 +456,10 @@ def run(self) -> list[Node]: self.options['diff'] = path try: - location = self.state_machine.get_source_and_line(self.lineno) + source, line = self.state_machine.get_source_and_line(self.lineno) + location: tuple[str, int] | None = ( + (source, line) if source is not None and line is not None else None + ) rel_filename, filename = self.env.relfn2path(self.arguments[0]) self.env.note_dependency(rel_filename) diff --git a/sphinx/directives/other.py b/sphinx/directives/other.py index d9c2b98fd84..80bedce43cb 100644 --- a/sphinx/directives/other.py +++ b/sphinx/directives/other.py @@ -63,7 +63,7 @@ class TocTree(SphinxDirective): def run(self) -> list[Node]: subnode = addnodes.toctree() - subnode['parent'] = self.env.docname + subnode['parent'] = self.env.current_document.docname # (title, ref) pairs, where ref may be a document, or an external link, # and title may be None if the document's title is to be used @@ -90,7 +90,7 @@ def parse_content(self, toctree: addnodes.toctree) -> None: """Populate ``toctree['entries']`` and ``toctree['includefiles']`` from content.""" generated_docnames = frozenset(StandardDomain._virtual_doc_names) suffixes = self.config.source_suffix - current_docname = self.env.docname + current_docname = self.env.current_document.docname glob = toctree['glob'] # glob target documents @@ -267,7 +267,7 @@ def run(self) -> list[Node]: if len(children) != 1 or not isinstance(children[0], nodes.bullet_list): logger.warning( __('.. acks content is not a list'), - location=(self.env.docname, self.lineno), + location=(self.env.current_document.docname, self.lineno), ) return [] return [addnodes.acks('', *children)] @@ -290,7 +290,7 @@ def run(self) -> list[Node]: if len(children) != 1 or not isinstance(children[0], nodes.bullet_list): logger.warning( __('.. hlist content is not a list'), - location=(self.env.docname, self.lineno), + location=(self.env.current_document.docname, self.lineno), ) return [] fulllist = children[0] @@ -388,7 +388,7 @@ def _insert_input(include_lines: list[str], source: str) -> None: text = '\n'.join(include_lines[:-2]) path = Path(relpath(Path(source).resolve(), start=self.env.srcdir)) - docname = self.env.docname + docname = self.env.current_document.docname # Emit the "include-read" event arg = [text] @@ -405,13 +405,12 @@ def _insert_input(include_lines: list[str], source: str) -> None: # Only enable this patch if there are listeners for 'include-read'. if self.env.events.listeners.get('include-read'): - # See https://github.com/python/mypy/issues/2427 for details on the mypy issue - self.state_machine.insert_input = _insert_input + self.state_machine.insert_input = _insert_input # type: ignore[assignment,method-assign] if self.arguments[0].startswith('<') and self.arguments[0].endswith('>'): # docutils "standard" includes, do not do path processing return super().run() - rel_filename, filename = self.env.relfn2path(self.arguments[0]) + _rel_filename, filename = self.env.relfn2path(self.arguments[0]) self.arguments[0] = str(filename) self.env.note_included(filename) return super().run() diff --git a/sphinx/directives/patches.py b/sphinx/directives/patches.py index 94184de502c..578263dcf8e 100644 --- a/sphinx/directives/patches.py +++ b/sphinx/directives/patches.py @@ -9,16 +9,16 @@ from docutils.parsers.rst import directives from docutils.parsers.rst.directives import images, tables from docutils.parsers.rst.directives.misc import Meta -from docutils.parsers.rst.roles import set_classes from sphinx.directives import optional_int from sphinx.locale import __ from sphinx.util import logging -from sphinx.util.docutils import SphinxDirective +from sphinx.util.docutils import SphinxDirective, _normalize_options from sphinx.util.nodes import set_source_info from sphinx.util.osutil import SEP, relpath if TYPE_CHECKING: + from collections.abc import Sequence from typing import ClassVar from docutils.nodes import Node @@ -30,12 +30,12 @@ logger = logging.getLogger(__name__) -class Figure(images.Figure): # type: ignore[misc] +class Figure(images.Figure): """The figure directive which applies `:name:` option to the figure node instead of the image node. """ - def run(self) -> list[Node]: + def run(self) -> Sequence[Node]: name = self.options.pop('name', None) result = super().run() if len(result) == 2 or isinstance(result[0], nodes.system_message): @@ -56,12 +56,12 @@ def run(self) -> list[Node]: return [figure_node] -class CSVTable(tables.CSVTable): # type: ignore[misc] +class CSVTable(tables.CSVTable): """The csv-table directive which searches a CSV file from Sphinx project's source directory when an absolute path is given via :file: option. """ - def run(self) -> list[Node]: + def run(self) -> Sequence[nodes.table | nodes.system_message]: if 'file' in self.options and self.options['file'].startswith((SEP, os.sep)): env = self.state.document.settings.env filename = Path(self.options['file']) @@ -72,11 +72,11 @@ def run(self) -> list[Node]: 'an absolute path as a relative path from source directory. ' 'Please update your document.' ), - location=(env.docname, self.lineno), + location=(env.current_document.docname, self.lineno), ) else: abspath = env.srcdir / self.options['file'][1:] - doc_dir = env.doc2path(env.docname).parent + doc_dir = env.doc2path(env.current_document.docname).parent self.options['file'] = relpath(abspath, doc_dir) return super().run() @@ -100,7 +100,7 @@ class Code(SphinxDirective): def run(self) -> list[Node]: self.assert_has_content() - set_classes(self.options) + self.options = _normalize_options(self.options) code = '\n'.join(self.content) node = nodes.literal_block( code, @@ -162,7 +162,7 @@ def run(self) -> list[Node]: latex, latex, classes=self.options.get('class', []), - docname=self.env.docname, + docname=self.env.current_document.docname, number=None, label=label, ) @@ -180,7 +180,7 @@ def add_target(self, ret: list[Node]) -> None: # assign label automatically if math_number_all enabled if node['label'] == '' or (self.config.math_number_all and not node['label']): # NoQA: PLC1901 seq = self.env.new_serialno('sphinx.ext.math#equations') - node['label'] = f'{self.env.docname}:{seq}' + node['label'] = f'{self.env.current_document.docname}:{seq}' # no targets and numbers are needed if not node['label']: @@ -188,7 +188,9 @@ def add_target(self, ret: list[Node]) -> None: # register label to domain domain = self.env.domains.math_domain - domain.note_equation(self.env.docname, node['label'], location=node) + domain.note_equation( + self.env.current_document.docname, node['label'], location=node + ) node['number'] = domain.get_equation_number_for(node['label']) # add target node @@ -213,7 +215,7 @@ class Rubric(SphinxDirective): } def run(self) -> list[nodes.rubric | nodes.system_message]: - set_classes(self.options) + self.options = _normalize_options(self.options) rubric_text = self.arguments[0] textnodes, messages = self.parse_inline(rubric_text, lineno=self.lineno) if 'heading-level' in self.options: diff --git a/sphinx/domains/__init__.py b/sphinx/domains/__init__.py index 61be6049579..17aa7bdc453 100644 --- a/sphinx/domains/__init__.py +++ b/sphinx/domains/__init__.py @@ -14,7 +14,7 @@ if TYPE_CHECKING: from collections.abc import Iterable, Sequence, Set - from typing import Any + from typing import Any, ClassVar from docutils import nodes from docutils.nodes import Element, Node @@ -82,27 +82,27 @@ class Domain: """ #: domain name: should be short, but unique - name = '' + name: ClassVar[str] = '' #: domain label: longer, more descriptive (used in messages) - label = '' + label: ClassVar[str] = '' #: type (usually directive) name -> ObjType instance - object_types: dict[str, ObjType] = {} + object_types: ClassVar[dict[str, ObjType]] = {} #: directive name -> directive class - directives: dict[str, type[Directive]] = {} + directives: ClassVar[dict[str, type[Directive]]] = {} #: role name -> role callable - roles: dict[str, RoleFunction | XRefRole] = {} + roles: ClassVar[dict[str, RoleFunction | XRefRole]] = {} #: a list of Index subclasses - indices: list[type[Index]] = [] + indices: ClassVar[list[type[Index]]] = [] #: role name -> a warning message if reference is missing - dangling_warnings: dict[str, str] = {} + dangling_warnings: ClassVar[dict[str, str]] = {} #: node_class -> (enum_node_type, title_getter) - enumerable_nodes: dict[type[Node], tuple[str, TitleGetter | None]] = {} + enumerable_nodes: ClassVar[dict[type[Node], tuple[str, TitleGetter | None]]] = {} #: data value for a fresh environment - initial_data: dict[str, Any] = {} + initial_data: ClassVar[dict[str, Any]] = {} #: data value data: dict[str, Any] #: data version, bump this when the format of `self.data` changes - data_version = 0 + data_version: ClassVar[int] = 0 def __init__(self, env: BuildEnvironment) -> None: domain_data: dict[str, dict[str, Any]] = env.domaindata @@ -113,10 +113,10 @@ def __init__(self, env: BuildEnvironment) -> None: self._type2role: dict[str, str] = {} # convert class variables to instance one (to enhance through API) - self.object_types = dict(self.object_types) - self.directives = dict(self.directives) - self.roles = dict(self.roles) - self.indices = list(self.indices) + self.object_types = dict(self.object_types) # type: ignore[misc] + self.directives = dict(self.directives) # type: ignore[misc] + self.roles = dict(self.roles) # type: ignore[misc] + self.indices = list(self.indices) # type: ignore[misc] if self.name not in domain_data: assert isinstance(self.initial_data, dict) diff --git a/sphinx/domains/_index.py b/sphinx/domains/_index.py index afb5be4007b..3845a97ba7b 100644 --- a/sphinx/domains/_index.py +++ b/sphinx/domains/_index.py @@ -9,6 +9,7 @@ if TYPE_CHECKING: from collections.abc import Iterable + from typing import ClassVar from sphinx.domains import Domain @@ -73,9 +74,9 @@ class Index(ABC): :rst:role:`ref` role. """ - name: str - localname: str - shortname: str | None = None + name: ClassVar[str] + localname: ClassVar[str] + shortname: ClassVar[str | None] = None def __init__(self, domain: Domain) -> None: if not self.name or self.localname is None: diff --git a/sphinx/domains/c/__init__.py b/sphinx/domains/c/__init__.py index 6dbbf70ac92..194916122cd 100644 --- a/sphinx/domains/c/__init__.py +++ b/sphinx/domains/c/__init__.py @@ -39,7 +39,7 @@ from docutils.nodes import Element, Node, TextElement, system_message - from sphinx.addnodes import pending_xref + from sphinx.addnodes import desc_signature, pending_xref from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.domains.c._symbol import LookupKey @@ -156,7 +156,7 @@ def _add_enumerator_to_parent(self, ast: ASTDeclaration) -> None: parent=target_symbol, ident=symbol.ident, declaration=decl_clone, - docname=self.env.docname, + docname=self.env.current_document.docname, line=self.get_source_info()[1], ) @@ -259,7 +259,9 @@ def handle_signature(self, sig: str, signode: TextElement) -> ASTDeclaration: try: symbol = parent_symbol.add_declaration( - ast, docname=self.env.docname, line=self.get_source_info()[1] + ast, + docname=self.env.current_document.docname, + line=self.get_source_info()[1], ) # append the new declaration to the sibling list assert symbol.siblingAbove is None @@ -309,6 +311,32 @@ def after_content(self) -> None: self.env.current_document.c_parent_symbol = self.oldParentSymbol self.env.ref_context['c:parent_key'] = self.oldParentKey + def _object_hierarchy_parts(self, sig_node: desc_signature) -> tuple[str, ...]: + last_symbol: Symbol = self.env.current_document.c_last_symbol + return tuple(map(str, last_symbol.get_full_nested_name().names)) + + def _toc_entry_name(self, sig_node: desc_signature) -> str: + if not sig_node.get('_toc_parts'): + return '' + + config = self.config + objtype = sig_node.parent.get('objtype') + if config.add_function_parentheses and ( + objtype in {'function', 'method'} + or (objtype == 'macro' and '(' in sig_node.rawsource) + ): + parens = '()' + else: + parens = '' + *parents, name = sig_node['_toc_parts'] + if config.toc_object_entries_show_parents == 'domain': + return '::'.join((name + parens,)) + if config.toc_object_entries_show_parents == 'hide': + return name + parens + if config.toc_object_entries_show_parents == 'all': + return '::'.join([*parents, name + parens]) + return '' + class CMemberObject(CObject): object_type = 'member' @@ -642,7 +670,7 @@ def run(self) -> list[Node]: The code is therefore based on the ObjectDescription version. """ if ':' in self.name: - self.domain, self.objtype = self.name.split(':', 1) + self.domain, _, self.objtype = self.name.partition(':') else: self.domain, self.objtype = '', self.name @@ -792,7 +820,7 @@ class CDomain(Domain): 'expr': CExprRole(asCode=True), 'texpr': CExprRole(asCode=False), } - initial_data: dict[str, Symbol | dict[str, tuple[str, str, str]]] = { + initial_data: ClassVar[dict[str, Symbol | dict[str, tuple[str, str, str]]]] = { 'root_symbol': Symbol(None, None, None, None, None), 'objects': {}, # fullname -> docname, node_id, objtype } diff --git a/sphinx/domains/c/_ast.py b/sphinx/domains/c/_ast.py index c236276bde8..89e76627b66 100644 --- a/sphinx/domains/c/_ast.py +++ b/sphinx/domains/c/_ast.py @@ -2,7 +2,7 @@ import sys import warnings -from typing import TYPE_CHECKING, Union, cast +from typing import TYPE_CHECKING, cast from docutils import nodes @@ -16,7 +16,7 @@ ) if TYPE_CHECKING: - from typing import Any, TypeAlias + from typing import Any from docutils.nodes import Element, Node, TextElement @@ -27,15 +27,15 @@ StringifyTransform, ) -DeclarationType: TypeAlias = Union[ - 'ASTStruct', - 'ASTUnion', - 'ASTEnum', - 'ASTEnumerator', - 'ASTType', - 'ASTTypeWithInit', - 'ASTMacro', -] +type DeclarationType = ( + 'ASTStruct' + | 'ASTUnion' + | 'ASTEnum' + | 'ASTEnumerator' + | 'ASTType' + | 'ASTTypeWithInit' + | 'ASTMacro' +) class ASTBase(ASTBaseBase): diff --git a/sphinx/domains/c/_parser.py b/sphinx/domains/c/_parser.py index 7eb09f6f7b8..c59352b6ee2 100644 --- a/sphinx/domains/c/_parser.py +++ b/sphinx/domains/c/_parser.py @@ -230,7 +230,7 @@ def _parse_paren_expression_list(self) -> ASTParenExprList | None: # # expression-list # -> initializer-list - exprs, trailing_comma = self._parse_initializer_list( + exprs, _trailing_comma = self._parse_initializer_list( 'parenthesized expression-list', '(', ')' ) if exprs is None: @@ -369,10 +369,7 @@ def _parse_logical_or_expression(self) -> ASTExpression: # pm = cast .*, ->* def _parse_bin_op_expr(self: DefinitionParser, op_id: int) -> ASTExpression: if op_id + 1 == len(_expression_bin_ops): - - def parser() -> ASTExpression: - return self._parse_cast_expression() - + parser = self._parse_cast_expression else: def parser() -> ASTExpression: @@ -760,10 +757,7 @@ def _parse_declarator_name_suffix( if self.skip_string(']'): size = None else: - - def parser() -> ASTExpression: - return self._parse_expression() - + parser = self._parse_expression size = self._parse_expression_fallback([']'], parser) self.skip_ws() if not self.skip_string(']'): @@ -1025,10 +1019,7 @@ def _parse_enumerator(self) -> ASTEnumerator: init = None if self.skip_string('='): self.skip_ws() - - def parser() -> ASTExpression: - return self._parse_constant_expression() - + parser = self._parse_constant_expression init_val = self._parse_expression_fallback([], parser) init = ASTInitializer(init_val) return ASTEnumerator(name, init, attrs) diff --git a/sphinx/domains/c/_symbol.py b/sphinx/domains/c/_symbol.py index cb43910e7ab..0494305dd3d 100644 --- a/sphinx/domains/c/_symbol.py +++ b/sphinx/domains/c/_symbol.py @@ -148,7 +148,8 @@ def _add_child(self, child: Symbol) -> None: # Duplicate so don't add - will be reported in _add_symbols() return self._children_by_name[name] = child - self._children_by_docname.setdefault(child.docname, {})[name] = child + child_docname: str = child.docname + self._children_by_docname.setdefault(child_docname, {})[name] = child if child.ident.is_anonymous: self._anon_children.add(child) @@ -445,43 +446,19 @@ def on_missing_qualified_symbol( # First check if one of those with a declaration matches. # If it's a function, we need to compare IDs, # otherwise there should be only one symbol with a declaration. - def make_cand_symbol() -> Symbol: - if Symbol.debug_lookup: - Symbol.debug_print('begin: creating candidate symbol') - symbol = Symbol( - parent=lookup_result.parent_symbol, - ident=lookup_result.ident, - declaration=declaration, - docname=docname, - line=line, - ) - if Symbol.debug_lookup: - Symbol.debug_print('end: creating candidate symbol') - return symbol if len(with_decl) == 0: cand_symbol = None else: - cand_symbol = make_cand_symbol() - - def handle_duplicate_declaration( - symbol: Symbol, cand_symbol: Symbol - ) -> None: - if Symbol.debug_lookup: - Symbol.debug_indent += 1 - Symbol.debug_print('redeclaration') - Symbol.debug_indent -= 1 - Symbol.debug_indent -= 2 - # Redeclaration of the same symbol. - # Let the new one be there, but raise an error to the client - # so it can use the real symbol as subscope. - # This will probably result in a duplicate id warning. - cand_symbol.isRedeclaration = True - raise _DuplicateSymbolError(symbol, declaration) + cand_symbol = self._make_cand_symbol( + lookup_result, declaration, docname, line + ) if declaration.objectType != 'function': assert len(with_decl) <= 1 - handle_duplicate_declaration(with_decl[0], cand_symbol) + self._handle_duplicate_declaration( + with_decl[0], cand_symbol, declaration + ) # (not reachable) # a function, so compare IDs @@ -493,7 +470,7 @@ def handle_duplicate_declaration( if Symbol.debug_lookup: Symbol.debug_print('old_id: ', old_id) if cand_id == old_id: - handle_duplicate_declaration(symbol, cand_symbol) + self._handle_duplicate_declaration(symbol, cand_symbol, declaration) # (not reachable) # no candidate symbol found with matching ID # if there is an empty symbol, fill that one @@ -507,7 +484,7 @@ def handle_duplicate_declaration( if cand_symbol is not None: return cand_symbol else: - return make_cand_symbol() + return self._make_cand_symbol(lookup_result, declaration, docname, line) else: if Symbol.debug_lookup: Symbol.debug_print( @@ -529,6 +506,42 @@ def handle_duplicate_declaration( symbol._fill_empty(declaration, docname, line) return symbol + @staticmethod + def _make_cand_symbol( + lookup_result: SymbolLookupResult, + declaration: ASTDeclaration | None, + docname: str | None, + line: int | None, + ) -> Symbol: + if Symbol.debug_lookup: + Symbol.debug_print('begin: creating candidate symbol') + symbol = Symbol( + parent=lookup_result.parent_symbol, + ident=lookup_result.ident, + declaration=declaration, + docname=docname, + line=line, + ) + if Symbol.debug_lookup: + Symbol.debug_print('end: creating candidate symbol') + return symbol + + @staticmethod + def _handle_duplicate_declaration( + symbol: Symbol, cand_symbol: Symbol, declaration: ASTDeclaration + ) -> None: + if Symbol.debug_lookup: + Symbol.debug_indent += 1 + Symbol.debug_print('redeclaration') + Symbol.debug_indent -= 1 + Symbol.debug_indent -= 2 + # Redeclaration of the same symbol. + # Let the new one be there, but raise an error to the client + # so it can use the real symbol as subscope. + # This will probably result in a duplicate id warning. + cand_symbol.isRedeclaration = True + raise _DuplicateSymbolError(symbol, declaration) + def merge_with( self, other: Symbol, docnames: list[str], env: BuildEnvironment ) -> None: diff --git a/sphinx/domains/changeset.py b/sphinx/domains/changeset.py index 2d520e6ff64..4349595f9df 100644 --- a/sphinx/domains/changeset.py +++ b/sphinx/domains/changeset.py @@ -21,6 +21,12 @@ from sphinx.environment import BuildEnvironment from sphinx.util.typing import ExtensionMetadata, OptionSpec +name_aliases = { + 'version-added': 'versionadded', + 'version-changed': 'versionchanged', + 'version-deprecated': 'deprecated', + 'version-removed': 'versionremoved', +} versionlabels = { 'versionadded': _('Added in version %s'), @@ -56,12 +62,13 @@ class VersionChange(SphinxDirective): option_spec: ClassVar[OptionSpec] = {} def run(self) -> list[Node]: + name = name_aliases.get(self.name, self.name) node = addnodes.versionmodified() node.document = self.state.document self.set_source_info(node) - node['type'] = self.name + node['type'] = name node['version'] = self.arguments[0] - text = versionlabels[self.name] % self.arguments[0] + text = versionlabels[name] % self.arguments[0] if len(self.arguments) == 2: inodes, messages = self.parse_inline( self.arguments[1], lineno=self.lineno + 1 @@ -73,7 +80,7 @@ def run(self) -> list[Node]: messages = [] if self.content: node += self.parse_content_to_nodes() - classes = ['versionmodified', versionlabel_classes[self.name]] + classes = ['versionmodified', versionlabel_classes[name]] if len(node) > 0 and isinstance(node[0], nodes.paragraph): # the contents start with a paragraph if node[0].rawsource: @@ -121,7 +128,7 @@ class ChangeSetDomain(Domain): name = 'changeset' label = 'changeset' - initial_data: dict[str, dict[str, list[ChangeSet]]] = { + initial_data: ClassVar[dict[str, dict[str, list[ChangeSet]]]] = { 'changes': {}, # version -> list of ChangeSet } @@ -135,7 +142,7 @@ def note_changeset(self, node: addnodes.versionmodified) -> None: objname = self.env.current_document.obj_desc_name changeset = ChangeSet( node['type'], - self.env.docname, + self.env.current_document.docname, node.line, # type: ignore[arg-type] module, objname, @@ -168,9 +175,13 @@ def get_changesets_for(self, version: str) -> list[ChangeSet]: def setup(app: Sphinx) -> ExtensionMetadata: app.add_domain(ChangeSetDomain) + app.add_directive('version-deprecated', VersionChange) app.add_directive('deprecated', VersionChange) + app.add_directive('version-added', VersionChange) app.add_directive('versionadded', VersionChange) + app.add_directive('version-changed', VersionChange) app.add_directive('versionchanged', VersionChange) + app.add_directive('version-removed', VersionChange) app.add_directive('versionremoved', VersionChange) return { diff --git a/sphinx/domains/citation.py b/sphinx/domains/citation.py index 49b74cca269..da7fc6a3fdd 100644 --- a/sphinx/domains/citation.py +++ b/sphinx/domains/citation.py @@ -83,7 +83,7 @@ def note_citation(self, node: nodes.citation) -> None: def note_citation_reference(self, node: pending_xref) -> None: docnames = self.citation_refs.setdefault(node['reftarget'], set()) - docnames.add(self.env.docname) + docnames.add(self.env.current_document.docname) def check_consistency(self) -> None: for name, (docname, _labelid, lineno) in self.citations.items(): @@ -106,7 +106,7 @@ def resolve_xref( node: pending_xref, contnode: Element, ) -> nodes.reference | None: - docname, labelid, lineno = self.citations.get(target, ('', '', 0)) + docname, labelid, _lineno = self.citations.get(target, ('', '', 0)) if not docname: return None @@ -139,7 +139,7 @@ def apply(self, **kwargs: Any) -> None: domain = self.env.domains.citation_domain for node in self.document.findall(nodes.citation): # register citation node to domain - node['docname'] = self.env.docname + node['docname'] = self.env.current_document.docname domain.note_citation(node) # mark citation labels as not smartquoted diff --git a/sphinx/domains/cpp/__init__.py b/sphinx/domains/cpp/__init__.py index 75d7732a405..0ccdc106c44 100644 --- a/sphinx/domains/cpp/__init__.py +++ b/sphinx/domains/cpp/__init__.py @@ -219,7 +219,7 @@ def _add_enumerator_to_parent(self, ast: ASTDeclaration) -> None: templateParams=None, templateArgs=None, declaration=decl_clone, - docname=self.env.docname, + docname=self.env.current_document.docname, line=self.get_source_info()[1], ) @@ -374,7 +374,9 @@ def handle_signature(self, sig: str, signode: desc_signature) -> ASTDeclaration: try: symbol = parent_symbol.add_declaration( - ast, docname=self.env.docname, line=self.get_source_info()[1] + ast, + docname=self.env.current_document.docname, + line=self.get_source_info()[1], ) # append the new declaration to the sibling list assert symbol.siblingAbove is None @@ -744,7 +746,7 @@ def apply(self, **kwargs: Any) -> None: template_decls = ns.templatePrefix.templates else: template_decls = [] - symbols, fail_reason = parent_symbol.find_name( + symbols, _fail_reason = parent_symbol.find_name( nestedName=name, templateDecls=template_decls, typ='any', @@ -812,7 +814,7 @@ def run(self) -> list[Node]: The code is therefore based on the ObjectDescription version. """ if ':' in self.name: - self.domain, self.objtype = self.name.split(':', 1) + self.domain, _, self.objtype = self.name.partition(':') else: self.domain, self.objtype = '', self.name @@ -1056,6 +1058,15 @@ def merge_domaindata(self, docnames: Set[str], otherdata: dict[str, Any]) -> Non logger.debug('\tresult end') logger.debug('merge_domaindata end') + def _check_type(self, typ: str, decl_typ: str) -> bool: + if typ == 'any': + return True + objtypes = self.objtypes_for_role(typ) + if objtypes: + return decl_typ in objtypes + logger.debug(f'Type is {typ}, declaration type is {decl_typ}') # NoQA: G004 + raise AssertionError + def _resolve_xref_inner( self, env: BuildEnvironment, @@ -1150,16 +1161,7 @@ def _resolve_xref_inner( typ = typ.removeprefix('cpp:') decl_typ = s.declaration.objectType - def check_type() -> bool: - if typ == 'any': - return True - objtypes = self.objtypes_for_role(typ) - if objtypes: - return decl_typ in objtypes - logger.debug(f'Type is {typ}, declaration type is {decl_typ}') # NoQA: G004 - raise AssertionError - - if not check_type(): + if not self._check_type(typ, decl_typ): logger.warning( 'cpp:%s targets a %s (%s).', typ, @@ -1299,6 +1301,12 @@ def get_full_qualified_name(self, node: Element) -> str | None: return f'{parent_name}::{target}' +def _init_stuff(app: Sphinx) -> None: + Symbol.debug_lookup = app.config.cpp_debug_lookup + Symbol.debug_show_tree = app.config.cpp_debug_show_tree + app.config.cpp_index_common_prefix.sort(reverse=True) + + def setup(app: Sphinx) -> ExtensionMetadata: app.add_domain(CPPDomain) app.add_config_value('cpp_index_common_prefix', [], 'env', types=frozenset({list})) @@ -1318,12 +1326,7 @@ def setup(app: Sphinx) -> ExtensionMetadata: app.add_config_value('cpp_debug_lookup', False, '', types=frozenset({bool})) app.add_config_value('cpp_debug_show_tree', False, '', types=frozenset({bool})) - def init_stuff(app: Sphinx) -> None: - Symbol.debug_lookup = app.config.cpp_debug_lookup - Symbol.debug_show_tree = app.config.cpp_debug_show_tree - app.config.cpp_index_common_prefix.sort(reverse=True) - - app.connect('builder-inited', init_stuff) + app.connect('builder-inited', _init_stuff) return { 'version': 'builtin', diff --git a/sphinx/domains/cpp/_ast.py b/sphinx/domains/cpp/_ast.py index 6d88c94f17b..90730196a2a 100644 --- a/sphinx/domains/cpp/_ast.py +++ b/sphinx/domains/cpp/_ast.py @@ -4152,7 +4152,7 @@ def get_identifier(self) -> ASTIdentifier: assert isinstance(res, ASTIdentifier) return res else: - return None + return None # ty: ignore[invalid-return-type] def get_id( self, version: int, objectType: str | None = None, symbol: Symbol | None = None @@ -4459,6 +4459,7 @@ def describe_signature( lineSpec: bool, ) -> None: verify_description_mode(mode) + assert self.templates is not None for t in self.templates: t.describe_signature_as_introducer( signode, 'lastIsName', env, symbol, lineSpec @@ -4575,7 +4576,7 @@ def name(self) -> ASTNestedName: @property def function_params(self) -> list[ASTFunctionParameter]: if self.objectType != 'function': - return None + return None # ty: ignore[invalid-return-type] return self.declaration.function_params def get_id(self, version: int, prefixed: bool = True) -> str: diff --git a/sphinx/domains/cpp/_parser.py b/sphinx/domains/cpp/_parser.py index d28c474795d..44e282a17af 100644 --- a/sphinx/domains/cpp/_parser.py +++ b/sphinx/domains/cpp/_parser.py @@ -151,7 +151,7 @@ def paren_attributes(self) -> Sequence[str]: def _parse_string(self) -> str: if self.current_char != '"': - return None + return None # ty: ignore[invalid-return-type] start_pos = self.pos self.pos += 1 escape = False @@ -234,7 +234,7 @@ def _udl(literal: ASTLiteral) -> ASTLiteral: ' resulting in multiple decoded characters.' ) return _udl(char_lit) - return None + return None # ty: ignore[invalid-return-type] def _parse_fold_or_paren_expression(self) -> ASTExpression | None: # "(" expression ")" @@ -323,7 +323,7 @@ def _parse_primary_expression(self) -> ASTExpression: nn = self._parse_nested_name() if nn is not None: return ASTIdExpression(nn) - return None + return None # ty: ignore[invalid-return-type] def _parse_initializer_list( self, name: str, open: str, close: str @@ -333,7 +333,7 @@ def _parse_initializer_list( # | initializer-list ',' initializer-clause '...'[opt] self.skip_ws() if not self.skip_string_and_ws(open): - return None, None + return None, None # ty: ignore[invalid-return-type] if self.skip_string(close): return [], False @@ -365,11 +365,11 @@ def _parse_paren_expression_list(self) -> ASTParenExprList: # # expression-list # -> initializer-list - exprs, trailing_comma = self._parse_initializer_list( + exprs, _trailing_comma = self._parse_initializer_list( 'parenthesized expression-list', '(', ')' ) if exprs is None: - return None + return None # ty: ignore[invalid-return-type] return ASTParenExprList(exprs) def _parse_initializer_clause(self) -> ASTExpression | ASTBracedInitList: @@ -385,7 +385,7 @@ def _parse_braced_init_list(self) -> ASTBracedInitList: 'braced-init-list', '{', '}' ) if exprs is None: - return None + return None # ty: ignore[invalid-return-type] return ASTBracedInitList(exprs, trailing_comma) def _parse_expression_list_or_braced_init_list( @@ -438,9 +438,7 @@ def _parse_postfix_expression(self) -> ASTPostfixExpr: if not self.skip_string('('): self.fail("Expected '(' in '%s'." % cast) - def parser() -> ASTExpression: - return self._parse_expression() - + parser = self._parse_expression expr = self._parse_expression_fallback([')'], parser) self.skip_ws() if not self.skip_string(')'): @@ -459,10 +457,7 @@ def parser() -> ASTExpression: except DefinitionError as e_type: self.pos = pos try: - - def parser() -> ASTExpression: - return self._parse_expression() - + parser = self._parse_expression expr = self._parse_expression_fallback([')'], parser) prefix = ASTTypeId(expr, isType=False) if not self.skip_string(')'): @@ -894,7 +889,7 @@ def _parse_template_argument_list(self) -> ASTTemplateArgs: # id-expression self.skip_ws() if not self.skip_string_and_ws('<'): - return None + return None # ty: ignore[invalid-return-type] if self.skip_string('>'): return ASTTemplateArgs([], False) prev_errors = [] @@ -1043,7 +1038,7 @@ def _parse_simple_type_specifiers(self) -> ASTTrailingTypeSpecFundamental: modifier = t self.skip_ws() if len(names) == 0: - return None + return None # ty: ignore[invalid-return-type] if typ in { 'auto', 'void', 'bool', @@ -1423,9 +1418,7 @@ def _parse_declarator_name_suffix( array_ops.append(ASTArray(None)) continue - def parser() -> ASTExpression: - return self._parse_expression() - + parser = self._parse_expression value = self._parse_expression_fallback([']'], parser) if not self.skip_string(']'): self.fail("Expected ']' in end of array operator.") diff --git a/sphinx/domains/cpp/_symbol.py b/sphinx/domains/cpp/_symbol.py index 36b965e52ae..edc7ab6885b 100644 --- a/sphinx/domains/cpp/_symbol.py +++ b/sphinx/domains/cpp/_symbol.py @@ -38,6 +38,10 @@ def __str__(self) -> str: return 'Internal C++ duplicate symbol error:\n%s' % self.symbol.dump(0) +class _QualifiedSymbolIsTemplateParam(Exception): + pass + + class SymbolLookupResult: __slots__ = ( 'symbols', @@ -419,53 +423,19 @@ def _find_named_symbols( if not _is_specialization(template_params, template_args): template_args = None - def matches(s: Symbol) -> bool: - if s.identOrOp != ident_or_op: - return False - if (s.templateParams is None) != (template_params is None): - if template_params is not None: - # we query with params, they must match params - return False - if not template_shorthand: - # we don't query with params, and we do care about them - return False - if template_params: - # TODO: do better comparison - if str(s.templateParams) != str(template_params): - return False - if (s.templateArgs is None) != (template_args is None): - return False - if s.templateArgs: - # TODO: do better comparison - if str(s.templateArgs) != str(template_args): - return False - return True - - def candidates() -> Iterator[Symbol]: - s = self - if Symbol.debug_lookup: - Symbol.debug_print('searching in self:') - logger.debug(s.to_string(Symbol.debug_indent + 1), end='') - while True: - if match_self: - yield s - if recurse_in_anon: - yield from s.children_recurse_anon - else: - yield from s._children - - if s.siblingAbove is None: - break - s = s.siblingAbove - if Symbol.debug_lookup: - Symbol.debug_print('searching in sibling:') - logger.debug(s.to_string(Symbol.debug_indent + 1), end='') - - for s in candidates(): + for s in self._candidates( + match_self=match_self, recurse_in_anon=recurse_in_anon + ): if Symbol.debug_lookup: Symbol.debug_print('candidate:') logger.debug(s.to_string(Symbol.debug_indent + 1), end='') - if matches(s): + if self._matches( + s, + ident_or_op=ident_or_op, + template_params=template_params, + template_args=template_args, + template_shorthand=template_shorthand, + ): if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print('matches') @@ -476,6 +446,59 @@ def candidates() -> Iterator[Symbol]: if Symbol.debug_lookup: Symbol.debug_indent -= 2 + @staticmethod + def _matches( + s: Symbol, + /, + *, + ident_or_op: ASTIdentifier | ASTOperator, + template_params: ASTTemplateParams | ASTTemplateIntroduction, + template_args: ASTTemplateArgs, + template_shorthand: bool, + ) -> bool: + if s.identOrOp != ident_or_op: + return False + if (s.templateParams is None) != (template_params is None): + if template_params is not None: + # we query with params, they must match params + return False + if not template_shorthand: + # we don't query with params, and we do care about them + return False + if template_params: + # TODO: do better comparison + if str(s.templateParams) != str(template_params): + return False + if (s.templateArgs is None) != (template_args is None): + return False + if s.templateArgs: + # TODO: do better comparison + if str(s.templateArgs) != str(template_args): + return False + return True + + def _candidates( + self, *, match_self: bool, recurse_in_anon: bool + ) -> Iterator[Symbol]: + s = self + if Symbol.debug_lookup: + Symbol.debug_print('searching in self:') + logger.debug(s.to_string(Symbol.debug_indent + 1), end='') + while True: + if match_self: + yield s + if recurse_in_anon: + yield from s.children_recurse_anon + else: + yield from s._children + + if s.siblingAbove is None: + break + s = s.siblingAbove + if Symbol.debug_lookup: + Symbol.debug_print('searching in sibling:') + logger.debug(s.to_string(Symbol.debug_indent + 1), end='') + def _symbol_lookup( self, nested_name: ASTNestedName, @@ -661,34 +684,10 @@ def _add_symbols( Symbol.debug_print('decl: ', declaration) Symbol.debug_print(f'location: {docname}:{line}') - def on_missing_qualified_symbol( - parent_symbol: Symbol, - ident_or_op: ASTIdentifier | ASTOperator, - template_params: Any, - template_args: ASTTemplateArgs, - ) -> Symbol | None: - if Symbol.debug_lookup: - Symbol.debug_indent += 1 - Symbol.debug_print('_add_symbols, on_missing_qualified_symbol:') - Symbol.debug_indent += 1 - Symbol.debug_print('template_params:', template_params) - Symbol.debug_print('ident_or_op: ', ident_or_op) - Symbol.debug_print('template_args: ', template_args) - Symbol.debug_indent -= 2 - return Symbol( - parent=parent_symbol, - identOrOp=ident_or_op, - templateParams=template_params, - templateArgs=template_args, - declaration=None, - docname=None, - line=None, - ) - lookup_result = self._symbol_lookup( nested_name, template_decls, - on_missing_qualified_symbol, + _on_missing_qualified_symbol_fresh, strict_template_param_arg_lists=True, ancestor_lookup_type=None, template_shorthand=False, @@ -759,45 +758,18 @@ def on_missing_qualified_symbol( # First check if one of those with a declaration matches. # If it's a function, we need to compare IDs, # otherwise there should be only one symbol with a declaration. - def make_cand_symbol() -> Symbol: - if Symbol.debug_lookup: - Symbol.debug_print('begin: creating candidate symbol') - symbol = Symbol( - parent=lookup_result.parent_symbol, - identOrOp=lookup_result.ident_or_op, - templateParams=lookup_result.template_params, - templateArgs=lookup_result.template_args, - declaration=declaration, - docname=docname, - line=line, - ) - if Symbol.debug_lookup: - Symbol.debug_print('end: creating candidate symbol') - return symbol - if len(with_decl) == 0: cand_symbol = None else: - cand_symbol = make_cand_symbol() - - def handle_duplicate_declaration( - symbol: Symbol, cand_symbol: Symbol - ) -> None: - if Symbol.debug_lookup: - Symbol.debug_indent += 1 - Symbol.debug_print('redeclaration') - Symbol.debug_indent -= 1 - Symbol.debug_indent -= 2 - # Redeclaration of the same symbol. - # Let the new one be there, but raise an error to the client - # so it can use the real symbol as subscope. - # This will probably result in a duplicate id warning. - cand_symbol.isRedeclaration = True - raise _DuplicateSymbolError(symbol, declaration) + cand_symbol = self._make_cand_symbol( + lookup_result, declaration, docname, line + ) if declaration.objectType != 'function': assert len(with_decl) <= 1 - handle_duplicate_declaration(with_decl[0], cand_symbol) + self._handle_duplicate_declaration( + with_decl[0], cand_symbol, declaration + ) # (not reachable) # a function, so compare IDs @@ -808,13 +780,13 @@ def handle_duplicate_declaration( # but all existing must be functions as well, # otherwise we declare it to be a duplicate if symbol.declaration.objectType != 'function': - handle_duplicate_declaration(symbol, cand_symbol) + self._handle_duplicate_declaration(symbol, cand_symbol, declaration) # (not reachable) old_id = symbol.declaration.get_newest_id() if Symbol.debug_lookup: Symbol.debug_print('old_id: ', old_id) if cand_id == old_id: - handle_duplicate_declaration(symbol, cand_symbol) + self._handle_duplicate_declaration(symbol, cand_symbol, declaration) # (not reachable) # no candidate symbol found with matching ID # if there is an empty symbol, fill that one @@ -824,12 +796,12 @@ def handle_duplicate_declaration( if cand_symbol is not None: Symbol.debug_print('result is already created cand_symbol') else: - Symbol.debug_print('result is make_cand_symbol()') + Symbol.debug_print('result is self._make_cand_symbol()') Symbol.debug_indent -= 2 if cand_symbol is not None: return cand_symbol else: - return make_cand_symbol() + return self._make_cand_symbol(lookup_result, declaration, docname, line) else: if Symbol.debug_lookup: Symbol.debug_print( @@ -851,6 +823,44 @@ def handle_duplicate_declaration( symbol._fill_empty(declaration, docname, line) return symbol + @staticmethod + def _make_cand_symbol( + lookup_result: SymbolLookupResult, + declaration: ASTDeclaration | None, + docname: str | None, + line: int | None, + ) -> Symbol: + if Symbol.debug_lookup: + Symbol.debug_print('begin: creating candidate symbol') + symbol = Symbol( + parent=lookup_result.parent_symbol, + identOrOp=lookup_result.ident_or_op, + templateParams=lookup_result.template_params, + templateArgs=lookup_result.template_args, + declaration=declaration, + docname=docname, + line=line, + ) + if Symbol.debug_lookup: + Symbol.debug_print('end: creating candidate symbol') + return symbol + + @staticmethod + def _handle_duplicate_declaration( + symbol: Symbol, cand_symbol: Symbol, declaration: ASTDeclaration + ) -> None: + if Symbol.debug_lookup: + Symbol.debug_indent += 1 + Symbol.debug_print('redeclaration') + Symbol.debug_indent -= 1 + Symbol.debug_indent -= 2 + # Redeclaration of the same symbol. + # Let the new one be there, but raise an error to the client + # so it can use the real symbol as subscope. + # This will probably result in a duplicate id warning. + cand_symbol.isRedeclaration = True + raise _DuplicateSymbolError(symbol, declaration) + def merge_with( self, other: Symbol, docnames: list[str], env: BuildEnvironment ) -> None: @@ -859,12 +869,6 @@ def merge_with( Symbol.debug_print('merge_with:') assert other is not None - def unconditional_add(self: Symbol, other_child: Symbol) -> None: - # TODO: hmm, should we prune by docnames? - self._children.append(other_child) - other_child.parent = self - other_child._assert_invariants() - if Symbol.debug_lookup: Symbol.debug_indent += 1 for other_child in other._children: @@ -874,7 +878,7 @@ def unconditional_add(self: Symbol, other_child: Symbol) -> None: ) Symbol.debug_indent += 1 if other_child.isRedeclaration: - unconditional_add(self, other_child) + self._unconditional_add(other_child) if Symbol.debug_lookup: Symbol.debug_print('is_redeclaration') Symbol.debug_indent -= 1 @@ -898,7 +902,7 @@ def unconditional_add(self: Symbol, other_child: Symbol) -> None: Symbol.debug_print('non-duplicate candidate symbols:', len(symbols)) if len(symbols) == 0: - unconditional_add(self, other_child) + self._unconditional_add(other_child) if Symbol.debug_lookup: Symbol.debug_indent -= 1 continue @@ -929,7 +933,7 @@ def unconditional_add(self: Symbol, other_child: Symbol) -> None: if Symbol.debug_lookup: Symbol.debug_indent -= 1 if our_child is None: - unconditional_add(self, other_child) + self._unconditional_add(other_child) continue if other_child.declaration and other_child.docname in docnames: if not our_child.declaration: @@ -978,6 +982,12 @@ def unconditional_add(self: Symbol, other_child: Symbol) -> None: if Symbol.debug_lookup: Symbol.debug_indent -= 2 + def _unconditional_add(self, other_child: Symbol) -> None: + # TODO: hmm, should we prune by docnames? + self._children.append(other_child) + other_child.parent = self + other_child._assert_invariants() + def add_name( self, nestedName: ASTNestedName, @@ -1093,7 +1103,7 @@ def direct_lookup(self, key: LookupKey) -> Symbol: if s is None: if Symbol.debug_lookup: Symbol.debug_indent -= 2 - return None + return None # ty: ignore[invalid-return-type] if Symbol.debug_lookup: Symbol.debug_indent -= 2 return s @@ -1125,29 +1135,11 @@ def find_name( Symbol.debug_print('recurseInAnon: ', recurseInAnon) Symbol.debug_print('searchInSiblings: ', searchInSiblings) - class QualifiedSymbolIsTemplateParam(Exception): - pass - - def on_missing_qualified_symbol( - parent_symbol: Symbol, - ident_or_op: ASTIdentifier | ASTOperator, - template_params: Any, - template_args: ASTTemplateArgs, - ) -> Symbol | None: - # TODO: Maybe search without template args? - # Though, the correct_primary_template_args does - # that for primary templates. - # Is there another case where it would be good? - if parent_symbol.declaration is not None: - if parent_symbol.declaration.objectType == 'templateParam': - raise QualifiedSymbolIsTemplateParam - return None - try: lookup_result = self._symbol_lookup( nestedName, templateDecls, - on_missing_qualified_symbol, + _on_missing_qualified_symbol_raise, strict_template_param_arg_lists=False, ancestor_lookup_type=typ, template_shorthand=templateShorthand, @@ -1156,20 +1148,20 @@ def on_missing_qualified_symbol( correct_primary_template_args=False, search_in_siblings=searchInSiblings, ) - except QualifiedSymbolIsTemplateParam: + except _QualifiedSymbolIsTemplateParam: return None, 'templateParamInQualified' if lookup_result is None: # if it was a part of the qualification that could not be found if Symbol.debug_lookup: Symbol.debug_indent -= 2 - return None, None + return None, None # ty: ignore[invalid-return-type] res = list(lookup_result.symbols) if len(res) != 0: if Symbol.debug_lookup: Symbol.debug_indent -= 2 - return res, None + return res, None # ty: ignore[invalid-return-type] if lookup_result.parent_symbol.declaration is not None: if lookup_result.parent_symbol.declaration.objectType == 'templateParam': @@ -1188,9 +1180,9 @@ def on_missing_qualified_symbol( if Symbol.debug_lookup: Symbol.debug_indent -= 2 if symbol is not None: - return [symbol], None + return [symbol], None # ty: ignore[invalid-return-type] else: - return None, None + return None, None # ty: ignore[invalid-return-type] def find_declaration( self, @@ -1210,18 +1202,10 @@ def find_declaration( else: template_decls = [] - def on_missing_qualified_symbol( - parent_symbol: Symbol, - ident_or_op: ASTIdentifier | ASTOperator, - template_params: Any, - template_args: ASTTemplateArgs, - ) -> Symbol | None: - return None - lookup_result = self._symbol_lookup( nested_name, template_decls, - on_missing_qualified_symbol, + _on_missing_qualified_symbol_none, strict_template_param_arg_lists=False, ancestor_lookup_type=typ, template_shorthand=templateShorthand, @@ -1296,3 +1280,53 @@ def dump(self, indent: int) -> str: self.to_string(indent), *(c.dump(indent + 1) for c in self._children), ]) + + +def _on_missing_qualified_symbol_fresh( + parent_symbol: Symbol, + ident_or_op: ASTIdentifier | ASTOperator, + template_params: Any, + template_args: ASTTemplateArgs, +) -> Symbol | None: + if Symbol.debug_lookup: + Symbol.debug_indent += 1 + Symbol.debug_print('_add_symbols, on_missing_qualified_symbol:') + Symbol.debug_indent += 1 + Symbol.debug_print('template_params:', template_params) + Symbol.debug_print('ident_or_op: ', ident_or_op) + Symbol.debug_print('template_args: ', template_args) + Symbol.debug_indent -= 2 + return Symbol( + parent=parent_symbol, + identOrOp=ident_or_op, + templateParams=template_params, + templateArgs=template_args, + declaration=None, + docname=None, + line=None, + ) + + +def _on_missing_qualified_symbol_raise( + parent_symbol: Symbol, + ident_or_op: ASTIdentifier | ASTOperator, + template_params: Any, + template_args: ASTTemplateArgs, +) -> Symbol | None: + # TODO: Maybe search without template args? + # Though, the correct_primary_template_args does + # that for primary templates. + # Is there another case where it would be good? + if parent_symbol.declaration is not None: + if parent_symbol.declaration.objectType == 'templateParam': + raise _QualifiedSymbolIsTemplateParam + return None + + +def _on_missing_qualified_symbol_none( + parent_symbol: Symbol, + ident_or_op: ASTIdentifier | ASTOperator, + template_params: Any, + template_args: ASTTemplateArgs, +) -> Symbol | None: + return None diff --git a/sphinx/domains/index.py b/sphinx/domains/index.py index 09a18d0180e..cefa64a8d5f 100644 --- a/sphinx/domains/index.py +++ b/sphinx/domains/index.py @@ -47,7 +47,7 @@ def merge_domaindata(self, docnames: Set[str], otherdata: dict[str, Any]) -> Non def process_doc(self, env: BuildEnvironment, docname: str, document: Node) -> None: """Process a document after it is read by the environment.""" - entries = self.entries.setdefault(env.docname, []) + entries = self.entries.setdefault(env.current_document.docname, []) for node in list(document.findall(addnodes.index)): node_entries = node['entries'] try: diff --git a/sphinx/domains/javascript.py b/sphinx/domains/javascript.py index 968f73aa3d3..6702d9566a5 100644 --- a/sphinx/domains/javascript.py +++ b/sphinx/domains/javascript.py @@ -70,7 +70,7 @@ def handle_signature(self, sig: str, signode: desc_signature) -> tuple[str, str] """ sig = sig.strip() if '(' in sig and sig[-1:] == ')': - member, arglist = sig.split('(', 1) + member, _, arglist = sig.partition('(') member = member.strip() arglist = arglist[:-1].strip() else: @@ -137,10 +137,11 @@ def handle_signature(self, sig: str, signode: desc_signature) -> tuple[str, str] _pseudo_parse_arglist( signode, arglist, - multi_line_parameter_list, - trailing_comma, + multi_line_parameter_list=multi_line_parameter_list, + trailing_comma=trailing_comma, + env=self.env, ) - return fullname, prefix + return fullname, prefix # type: ignore[return-value] def _object_hierarchy_parts(self, sig_node: desc_signature) -> tuple[str, ...]: if 'fullname' not in sig_node: @@ -272,13 +273,13 @@ class JSCallable(JSObject): 'arguments', label=_('Arguments'), names=('argument', 'arg', 'parameter', 'param'), - typerolename='func', + typerolename='class', typenames=('paramtype', 'type'), ), GroupedField( 'errors', label=_('Throws'), - rolename='func', + rolename='class', names=('throws',), can_collapse=True, ), @@ -362,7 +363,10 @@ def run(self) -> list[Node]: # Make a duplicate entry in 'objects' to facilitate searching for # the module in JavaScriptDomain.find_obj() domain.note_object( - mod_name, 'module', node_id, location=(self.env.docname, self.lineno) + mod_name, + 'module', + node_id, + location=(self.env.current_document.docname, self.lineno), ) # The node order is: index node first, then target node @@ -430,12 +434,12 @@ class JavaScriptDomain(Domain): roles = { 'func': JSXRefRole(fix_parens=True), 'meth': JSXRefRole(fix_parens=True), - 'class': JSXRefRole(fix_parens=True), + 'class': JSXRefRole(), 'data': JSXRefRole(), 'attr': JSXRefRole(), 'mod': JSXRefRole(), } - initial_data: dict[str, dict[str, tuple[str, str]]] = { + initial_data: ClassVar[dict[str, dict[str, tuple[str, str]]]] = { 'objects': {}, # fullname -> docname, node_id, objtype 'modules': {}, # modname -> docname, node_id } @@ -458,14 +462,14 @@ def note_object( docname, location=location, ) - self.objects[fullname] = (self.env.docname, node_id, objtype) + self.objects[fullname] = (self.env.current_document.docname, node_id, objtype) @property def modules(self) -> dict[str, tuple[str, str]]: return self.data.setdefault('modules', {}) # modname -> docname, node_id def note_module(self, modname: str, node_id: str) -> None: - self.modules[modname] = (self.env.docname, node_id) + self.modules[modname] = (self.env.current_document.docname, node_id) def clear_doc(self, docname: str) -> None: for fullname, (pkg_docname, _node_id, _l) in list(self.objects.items()): diff --git a/sphinx/domains/math.py b/sphinx/domains/math.py index 56e543917ad..433e35b7a2f 100644 --- a/sphinx/domains/math.py +++ b/sphinx/domains/math.py @@ -15,7 +15,7 @@ if TYPE_CHECKING: from collections.abc import Iterable, Set - from typing import Any + from typing import Any, ClassVar from docutils.nodes import Element, Node, system_message @@ -47,7 +47,7 @@ class MathDomain(Domain): name = 'math' label = 'mathematics' - initial_data: dict[str, Any] = { + initial_data: ClassVar[dict[str, Any]] = { 'objects': {}, # labelid -> (docname, eqno) # backwards compatibility 'has_equations': {}, # https://github.com/sphinx-doc/sphinx/issues/13346 @@ -74,6 +74,8 @@ def note_equation(self, docname: str, labelid: str, location: Any = None) -> Non labelid, other, location=location, + type='ref', + subtype='equation', ) self.equations[labelid] = (docname, self.env.new_serialno('eqno') + 1) diff --git a/sphinx/domains/python/__init__.py b/sphinx/domains/python/__init__.py index 97519ee028e..a23207ea3c2 100644 --- a/sphinx/domains/python/__init__.py +++ b/sphinx/domains/python/__init__.py @@ -29,7 +29,7 @@ from collections.abc import Iterable, Iterator, Sequence, Set from typing import Any, ClassVar - from docutils.nodes import Element, Node, TextElement + from docutils.nodes import Element, Node from sphinx.addnodes import desc_signature, pending_xref from sphinx.application import Sphinx @@ -52,17 +52,9 @@ py_sig_re, ) -logger = logging.getLogger(__name__) +_TYPING_ALL = frozenset(typing.__all__) -pairindextypes = { - 'module': 'module', - 'keyword': 'keyword', - 'operator': 'operator', - 'object': 'object', - 'exception': 'exception', - 'statement': 'statement', - 'builtin': 'built-in function', -} +logger = logging.getLogger(__name__) class ObjectEntry(NamedTuple): @@ -108,7 +100,7 @@ def add_target_and_index( modname = self.options.get('module', self.env.ref_context.get('py:module')) node_id = signode['ids'][0] - name, cls = name_cls + name, _cls = name_cls if modname: text = _('%s() (in module %s)') % (name, modname) self.indexnode['entries'].append(('single', text, node_id, '', None)) @@ -175,7 +167,7 @@ def handle_signature(self, sig: str, signode: desc_signature) -> tuple[str, str] return fullname, prefix def get_index_text(self, modname: str, name_cls: tuple[str, str]) -> str: - name, cls = name_cls + name, _cls = name_cls if modname: return _('%s (in module %s)') % (name, modname) else: @@ -268,7 +260,7 @@ def get_signature_prefix(self, sig: str) -> Sequence[nodes.Node]: return prefix def get_index_text(self, modname: str, name_cls: tuple[str, str]) -> str: - name, cls = name_cls + name, _cls = name_cls try: clsname, methname = name.rsplit('.', 1) if modname and self.config.add_module_names: @@ -364,7 +356,7 @@ def handle_signature(self, sig: str, signode: desc_signature) -> tuple[str, str] return fullname, prefix def get_index_text(self, modname: str, name_cls: tuple[str, str]) -> str: - name, cls = name_cls + name, _cls = name_cls try: clsname, attrname = name.rsplit('.', 1) if modname and self.config.add_module_names: @@ -424,7 +416,7 @@ def get_signature_prefix(self, sig: str) -> Sequence[nodes.Node]: return prefix def get_index_text(self, modname: str, name_cls: tuple[str, str]) -> str: - name, cls = name_cls + name, _cls = name_cls try: clsname, attrname = name.rsplit('.', 1) if modname and self.config.add_module_names: @@ -464,7 +456,7 @@ def handle_signature(self, sig: str, signode: desc_signature) -> tuple[str, str] return fullname, prefix def get_index_text(self, modname: str, name_cls: tuple[str, str]) -> str: - name, cls = name_cls + name, _cls = name_cls try: clsname, attrname = name.rsplit('.', 1) if modname and self.config.add_module_names: @@ -594,23 +586,17 @@ def process_link( class _PyDecoXRefRole(PyXRefRole): - def __init__( + def process_link( self, - fix_parens: bool = False, - lowercase: bool = False, - nodeclass: type[Element] | None = None, - innernodeclass: type[TextElement] | None = None, - warn_dangling: bool = False, - ) -> None: - super().__init__( - fix_parens=True, - lowercase=lowercase, - nodeclass=nodeclass, - innernodeclass=innernodeclass, - warn_dangling=warn_dangling, + env: BuildEnvironment, + refnode: Element, + has_explicit_title: bool, + title: str, + target: str, + ) -> tuple[str, str]: + title, target = super().process_link( + env, refnode, has_explicit_title, title, target ) - - def update_title_and_target(self, title: str, target: str) -> tuple[str, str]: return f'@{title}', target @@ -675,7 +661,7 @@ def generate( entries = content.setdefault(modname[0].lower(), []) - package = modname.split('.', maxsplit=1)[0] + package = modname.partition('.')[0] if package != modname: # it's a submodule if prev_modname == package: @@ -736,7 +722,7 @@ class PythonDomain(Domain): name = 'py' label = 'Python' - object_types: dict[str, ObjType] = { + object_types = { 'function': ObjType(_('function'), 'func', 'obj'), 'data': ObjType(_('data'), 'data', 'obj'), 'class': ObjType(_('class'), 'class', 'exc', 'obj'), @@ -746,7 +732,7 @@ class PythonDomain(Domain): 'staticmethod': ObjType(_('static method'), 'meth', 'obj'), 'attribute': ObjType(_('attribute'), 'attr', 'obj'), 'property': ObjType(_('property'), 'attr', '_prop', 'obj'), - 'type': ObjType(_('type alias'), 'type', 'obj'), + 'type': ObjType(_('type alias'), 'type', 'class', 'obj'), 'module': ObjType(_('module'), 'mod', 'obj'), } @@ -779,7 +765,7 @@ class PythonDomain(Domain): 'mod': PyXRefRole(), 'obj': PyXRefRole(), } - initial_data: dict[str, dict[str, tuple[Any]]] = { + initial_data: ClassVar[dict[str, dict[str, tuple[Any]]]] = { 'objects': {}, # fullname -> docname, objtype 'modules': {}, # modname -> docname, synopsis, platform, deprecated } @@ -822,7 +808,9 @@ def note_object( other.docname, location=location, ) - self.objects[name] = ObjectEntry(self.env.docname, node_id, objtype, aliased) + self.objects[name] = ObjectEntry( + self.env.current_document.docname, node_id, objtype, aliased + ) @property def modules(self) -> dict[str, ModuleEntry]: @@ -836,7 +824,7 @@ def note_module( .. versionadded:: 2.1 """ self.modules[name] = ModuleEntry( - docname=self.env.docname, + docname=self.env.current_document.docname, node_id=node_id, synopsis=synopsis, platform=platform, @@ -954,6 +942,14 @@ def resolve_xref( searchmode = 1 if node.hasattr('refspecific') else 0 matches = self.find_obj(env, modname, clsname, target, type, searchmode) + if not matches and type == 'class': + # fallback to data/attr (for type aliases) + # type aliases are documented as data/attr but referenced as class + matches = self.find_obj(env, modname, clsname, target, 'data', searchmode) + if not matches: + matches = self.find_obj( + env, modname, clsname, target, 'attr', searchmode + ) if not matches and type == 'attr': # fallback to meth (for property; Sphinx 2.4.x) # this ensures that `:attr:` role continues to refer to the old property entry @@ -1082,13 +1078,6 @@ def builtin_resolver( app: Sphinx, env: BuildEnvironment, node: pending_xref, contnode: Element ) -> Element | None: """Do not emit nitpicky warnings for built-in types.""" - - def istyping(s: str) -> bool: - if s.startswith('typing.'): - s = s.split('.', 1)[1] - - return s in typing.__all__ - if node.get('refdomain') != 'py': return None elif node.get('reftype') in {'class', 'obj'} and node.get('reftarget') == 'None': @@ -1098,13 +1087,17 @@ def istyping(s: str) -> bool: if inspect.isclass(getattr(builtins, reftarget, None)): # built-in class return contnode - if istyping(reftarget): + if _is_typing(reftarget): # typing class return contnode return None +def _is_typing(s: str, /) -> bool: + return s.removeprefix('typing.') in _TYPING_ALL + + def setup(app: Sphinx) -> ExtensionMetadata: app.setup_extension('sphinx.directives') diff --git a/sphinx/domains/python/_annotations.py b/sphinx/domains/python/_annotations.py index 823aac01316..f476ff22fd4 100644 --- a/sphinx/domains/python/_annotations.py +++ b/sphinx/domains/python/_annotations.py @@ -6,6 +6,7 @@ import token from collections import deque from inspect import Parameter +from itertools import chain, islice from typing import TYPE_CHECKING from docutils import nodes @@ -124,6 +125,10 @@ def unparse(node: ast.AST) -> list[Node]: return [nodes.Text(repr(node.value))] if isinstance(node, ast.Expr): return unparse(node.value) + if isinstance(node, ast.Starred): + result = [addnodes.desc_sig_operator('', '*')] + result.extend(unparse(node.value)) + return result if isinstance(node, ast.Invert): return [addnodes.desc_sig_punctuation('', '~')] if isinstance(node, ast.USub): @@ -312,18 +317,6 @@ def parse(self) -> None: self.type_params.append(type_param) def _build_identifier(self, tokens: list[Token]) -> str: - from itertools import chain, islice - - def triplewise(iterable: Iterable[Token]) -> Iterator[tuple[Token, ...]]: - # sliding_window('ABCDEFG', 4) --> ABCD BCDE CDEF DEFG - it = iter(iterable) - window = deque(islice(it, 3), maxlen=3) - if len(window) == 3: - yield tuple(window) - for x in it: - window.append(x) - yield tuple(window) - idents: list[str] = [] tokens: Iterable[Token] = iter(tokens) # type: ignore[no-redef] # do not format opening brackets @@ -338,7 +331,7 @@ def triplewise(iterable: Iterable[Token]) -> Iterator[tuple[Token, ...]]: # check the remaining tokens stop = Token(token.ENDMARKER, '', (-1, -1), (-1, -1), '') is_unpack_operator = False - for tok, op, after in triplewise(chain(tokens, [stop, stop])): + for tok, op, after in _triplewise(chain(tokens, [stop, stop])): ident = self._pformat_token(tok, native=is_unpack_operator) idents.append(ident) # determine if the next token is an unpack operator depending @@ -548,8 +541,10 @@ def _keyword_only_separator() -> addnodes.desc_parameter: def _pseudo_parse_arglist( signode: desc_signature, arglist: str, + *, multi_line_parameter_list: bool = False, trailing_comma: bool = True, + env: BuildEnvironment, ) -> None: """'Parse' a list of arguments separated by commas. @@ -557,6 +552,7 @@ def _pseudo_parse_arglist( brackets. Currently, this will split at any comma, even if it's inside a string literal (e.g. default argument value). """ + # TODO: decompose 'env' parameter into only the required bits paramlist = addnodes.desc_parameterlist() paramlist['multi_line_parameter_list'] = multi_line_parameter_list paramlist['multi_line_trailing_comma'] = trailing_comma @@ -579,9 +575,30 @@ def _pseudo_parse_arglist( ends_open += 1 argument = argument[:-1].strip() if argument: - stack[-1] += addnodes.desc_parameter( - '', '', addnodes.desc_sig_name(argument, argument) - ) + param_with_annotation, _, default_value = argument.partition('=') + param_name, _, annotation = param_with_annotation.partition(':') + del param_with_annotation + + node = addnodes.desc_parameter() + node += addnodes.desc_sig_name('', param_name.strip()) + if annotation: + children = _parse_annotation(annotation.strip(), env=env) + node += addnodes.desc_sig_punctuation('', ':') + node += addnodes.desc_sig_space() + node += addnodes.desc_sig_name('', '', *children) # type: ignore[arg-type] + if default_value: + if annotation: + node += addnodes.desc_sig_space() + node += addnodes.desc_sig_operator('', '=') + if annotation: + node += addnodes.desc_sig_space() + node += nodes.inline( + '', + default_value.strip(), + classes=['default_value'], + support_smartquotes=False, + ) + stack[-1] += node while ends_open: stack.append(addnodes.desc_optional()) stack[-2] += stack[-1] @@ -600,3 +617,14 @@ def _pseudo_parse_arglist( signode += paramlist else: signode += paramlist + + +def _triplewise(iterable: Iterable[Token]) -> Iterator[tuple[Token, ...]]: + # sliding_window('ABCDEFG', 4) --> ABCD BCDE CDEF DEFG + it = iter(iterable) + window = deque(islice(it, 3), maxlen=3) + if len(window) == 3: + yield tuple(window) + for x in it: + window.append(x) + yield tuple(window) diff --git a/sphinx/domains/python/_object.py b/sphinx/domains/python/_object.py index a858afe8a3e..6a0f0ff7334 100644 --- a/sphinx/domains/python/_object.py +++ b/sphinx/domains/python/_object.py @@ -93,7 +93,7 @@ def make_xref( children = result.children result.clear() - shortname = target.split('.')[-1] + shortname = target.rpartition('.')[-1] textnode = innernode('', shortname) # type: ignore[call-arg] contnodes = [ pending_xref_condition('', '', textnode, condition='resolved'), @@ -363,8 +363,9 @@ def handle_signature(self, sig: str, signode: desc_signature) -> tuple[str, str] _pseudo_parse_arglist( signode, arglist, - multi_line_parameter_list, - trailing_comma, + multi_line_parameter_list=multi_line_parameter_list, + trailing_comma=trailing_comma, + env=self.env, ) except (NotImplementedError, ValueError) as exc: # duplicated parameter names raise ValueError and not a SyntaxError @@ -374,8 +375,9 @@ def handle_signature(self, sig: str, signode: desc_signature) -> tuple[str, str] _pseudo_parse_arglist( signode, arglist, - multi_line_parameter_list, - trailing_comma, + multi_line_parameter_list=multi_line_parameter_list, + trailing_comma=trailing_comma, + env=self.env, ) else: if self.needs_arglist(): @@ -422,14 +424,20 @@ def add_target_and_index( domain = self.env.domains.python_domain domain.note_object(fullname, self.objtype, node_id, location=signode) - canonical_name = self.options.get('canonical') - if canonical_name: - domain.note_object( - canonical_name, self.objtype, node_id, aliased=True, location=signode - ) + if self.objtype != 'type': + # py:type directive uses `canonical` option for a different meaning + canonical_name = self.options.get('canonical') + if canonical_name: + domain.note_object( + canonical_name, + self.objtype, + node_id, + aliased=True, + location=signode, + ) if 'no-index-entry' not in self.options: - if index_text := self.get_index_text(mod_name, name_cls): + if index_text := self.get_index_text(mod_name, name_cls): # type: ignore[arg-type] self.indexnode['entries'].append(( 'single', index_text, diff --git a/sphinx/domains/rst.py b/sphinx/domains/rst.py index cd5d8312d4a..64aff25a015 100644 --- a/sphinx/domains/rst.py +++ b/sphinx/domains/rst.py @@ -83,7 +83,7 @@ def _toc_entry_name(self, sig_node: desc_signature) -> str: return '' objtype = sig_node.parent.get('objtype') - *parents, name = sig_node['_toc_parts'] + *_parents, name = sig_node['_toc_parts'] if objtype == 'directive:option': return f':{name}:' if self.config.toc_object_entries_show_parents in {'domain', 'all'}: @@ -244,7 +244,7 @@ class ReSTDomain(Domain): 'dir': XRefRole(), 'role': XRefRole(), } - initial_data: dict[str, dict[tuple[str, str], str]] = { + initial_data: ClassVar[dict[str, dict[tuple[str, str], str]]] = { 'objects': {}, # fullname -> docname, objtype } @@ -266,7 +266,7 @@ def note_object( location=location, ) - self.objects[objtype, name] = (self.env.docname, node_id) + self.objects[objtype, name] = (self.env.current_document.docname, node_id) def clear_doc(self, docname: str) -> None: for (typ, name), (doc, _node_id) in list(self.objects.items()): diff --git a/sphinx/domains/std/__init__.py b/sphinx/domains/std/__init__.py index e123ce85786..f88aa97b40e 100644 --- a/sphinx/domains/std/__init__.py +++ b/sphinx/domains/std/__init__.py @@ -27,7 +27,6 @@ from typing import Any, ClassVar, Final from docutils.nodes import Element, Node, system_message - from docutils.parsers.rst import Directive from sphinx.addnodes import desc_signature from sphinx.application import Sphinx @@ -36,8 +35,6 @@ from sphinx.util.typing import ( ExtensionMetadata, OptionSpec, - RoleFunction, - TitleGetter, ) logger = logging.getLogger(__name__) @@ -218,7 +215,7 @@ def run(self) -> list[Node]: ret.insert(0, inode) name = self.name if ':' in self.name: - _, name = self.name.split(':', 1) + name = self.name.partition(':')[-1] std = self.env.domains.standard_domain std.note_object(name, fullname, node_id, location=node) @@ -311,7 +308,10 @@ def add_target_and_index( domain = self.env.domains.standard_domain for optname in signode.get('allnames', ()): domain.add_program_option( - currprogram, optname, self.env.docname, signode['ids'][0] + currprogram, + optname, + self.env.current_document.docname, + signode['ids'][0], ) # create an index entry @@ -436,6 +436,7 @@ def run(self) -> list[Node]: in_comment = False was_empty = True messages: list[Node] = [] + indent_len = 0 for line, (source, lineno) in zip( self.content, self.content.items, strict=True ): @@ -693,7 +694,7 @@ def make_name_target( @staticmethod def separator_node(*, name: str, max_len: int) -> nodes.Text: - """Return seperator between 'name' and 'tokens'.""" + """Return separator between 'name' and 'tokens'.""" if name: return nodes.Text(' ::= '.rjust(max_len - len(name) + 5)) return nodes.Text(' ' * (max_len + 5)) @@ -725,7 +726,7 @@ class StandardDomain(Domain): name = 'std' label = 'Default' - object_types: dict[str, ObjType] = { + object_types = { 'term': ObjType(_('glossary term'), 'term', searchprio=-1), 'token': ObjType(_('grammar token'), 'token', searchprio=-1), 'label': ObjType(_('reference label'), 'ref', 'keyword', searchprio=-1), @@ -735,7 +736,7 @@ class StandardDomain(Domain): 'doc': ObjType(_('document'), 'doc', searchprio=-1), } - directives: dict[str, type[Directive]] = { + directives = { 'program': Program, 'cmdoption': Cmdoption, # old name for backwards compatibility 'option': Cmdoption, @@ -744,7 +745,7 @@ class StandardDomain(Domain): 'glossary': Glossary, 'productionlist': ProductionList, } - roles: dict[str, RoleFunction | XRefRole] = { + roles = { 'option': OptionXRefRole(warn_dangling=True), 'confval': XRefRole(warn_dangling=True), 'envvar': EnvVarXRefRole(), @@ -780,7 +781,7 @@ class StandardDomain(Domain): } # labelname -> docname, sectionname - _virtual_doc_names: dict[str, tuple[str, str]] = { + _virtual_doc_names: Final = { 'genindex': ('genindex', _('Index')), 'modindex': ('py-modindex', _('Module Index')), 'search': ('search', _('Search Page')), @@ -795,7 +796,7 @@ class StandardDomain(Domain): } # node_class -> (figtype, title_getter) - enumerable_nodes: dict[type[Node], tuple[str, TitleGetter | None]] = { + enumerable_nodes = { nodes.figure: ('figure', None), nodes.table: ('table', None), nodes.container: ('code-block', None), @@ -805,9 +806,9 @@ def __init__(self, env: BuildEnvironment) -> None: super().__init__(env) # set up enumerable nodes - self.enumerable_nodes = copy( - self.enumerable_nodes - ) # create a copy for this instance + + # create a copy for this instance + self.enumerable_nodes = copy(self.enumerable_nodes) # type: ignore[misc] for node, settings in env._registry.enumerable_nodes.items(): self.enumerable_nodes[node] = settings @@ -860,7 +861,7 @@ def note_object( docname, location=location, ) - self.objects[objtype, name] = (self.env.docname, labelid) + self.objects[objtype, name] = (self.env.current_document.docname, labelid) @property def _terms(self) -> dict[str, tuple[str, str]]: @@ -874,7 +875,7 @@ def _note_term(self, term: str, labelid: str, location: Any = None) -> None: """ self.note_object('term', term, labelid, location) - self._terms[term.lower()] = (self.env.docname, labelid) + self._terms[term.lower()] = (self.env.current_document.docname, labelid) @property def progoptions(self) -> dict[tuple[str | None, str], tuple[str, str]]: @@ -945,7 +946,7 @@ def process_doc( node = document.ids[labelid] if isinstance(node, nodes.target) and 'refid' in node: # indirect hyperlink targets - node = document.ids.get(node['refid']) # type: ignore[assignment] + node = document.ids[node['refid']] labelid = node['names'][0] if ( node.tagname == 'footnote' @@ -974,13 +975,13 @@ def process_doc( continue else: if ( - isinstance(node, nodes.definition_list | nodes.field_list) + isinstance(node, (nodes.definition_list, nodes.field_list)) and node.children ): node = cast('nodes.Element', node.children[0]) - if isinstance(node, nodes.field | nodes.definition_list_item): + if isinstance(node, (nodes.field, nodes.definition_list_item)): node = cast('nodes.Element', node.children[0]) - if isinstance(node, nodes.term | nodes.field_name): + if isinstance(node, (nodes.term, nodes.field_name)): sectname = clean_astext(node) else: toctree = next(node.findall(addnodes.toctree), None) @@ -1043,7 +1044,7 @@ def resolve_xref( if typ == 'ref': resolver = self._resolve_ref_xref elif typ == 'numref': - resolver = self._resolve_numref_xref # type: ignore[assignment] + resolver = self._resolve_numref_xref elif typ == 'keyword': resolver = self._resolve_keyword_xref elif typ == 'doc': @@ -1092,7 +1093,7 @@ def _resolve_numref_xref( target: str, node: pending_xref, contnode: Element, - ) -> nodes.reference | Element | None: + ) -> nodes.reference | None: if target in self.labels: docname, labelid, figname = self.labels.get(target, ('', '', '')) else: @@ -1112,12 +1113,12 @@ def _resolve_numref_xref( logger.warning( __('numfig is disabled. :numref: is ignored.'), location=node ) - return contnode + return contnode # type: ignore[return-value] try: fignumber = self.get_fignumber(env, builder, figtype, docname, target_node) if fignumber is None: - return contnode + return contnode # type: ignore[return-value] except ValueError: logger.warning( __( @@ -1126,7 +1127,7 @@ def _resolve_numref_xref( labelid, location=node, ) - return contnode + return contnode # type: ignore[return-value] try: if node['refexplicit']: @@ -1136,7 +1137,7 @@ def _resolve_numref_xref( if figname is None and '{name}' in title: logger.warning(__('the link has no caption: %s'), title, location=node) - return contnode + return contnode # type: ignore[return-value] else: fignum = '.'.join(map(str, fignumber)) if '{name}' in title or 'number' in title: @@ -1152,10 +1153,10 @@ def _resolve_numref_xref( logger.warning( __('invalid numfig_format: %s (%r)'), title, exc, location=node ) - return contnode + return contnode # type: ignore[return-value] except TypeError: logger.warning(__('invalid numfig_format: %s'), title, location=node) - return contnode + return contnode # type: ignore[return-value] return self.build_reference_node( fromdocname, @@ -1235,7 +1236,7 @@ def _resolve_option_xref( if not docname: commands = [] while ws_re.search(target): - subcommand, target = ws_re.split(target, 1) + subcommand, target = ws_re.split(target, maxsplit=1) commands.append(subcommand) progname = '-'.join(commands) @@ -1371,23 +1372,19 @@ def get_numfig_title(self, node: Node) -> str | None: return title_getter(elem) else: for subnode in elem: - if isinstance(subnode, nodes.caption | nodes.title): + if isinstance(subnode, (nodes.caption, nodes.title)): return clean_astext(subnode) return None def get_enumerable_node_type(self, node: Node) -> str | None: """Get type of enumerable nodes.""" - - def has_child(node: Element, cls: type) -> bool: - return any(isinstance(child, cls) for child in node) - if isinstance(node, nodes.section): return 'section' elif ( isinstance(node, nodes.container) and 'literal_block' in node - and has_child(node, nodes.literal_block) + and _has_child(node, nodes.literal_block) ): # given node is a code-block having caption return 'code-block' @@ -1440,6 +1437,10 @@ def get_full_qualified_name(self, node: Element) -> str | None: return None +def _has_child(node: Element, cls: type) -> bool: + return any(isinstance(child, cls) for child in node) + + def warn_missing_reference( app: Sphinx, domain: Domain, diff --git a/sphinx/environment/__init__.py b/sphinx/environment/__init__.py index 79fa6278549..c5cc77139f7 100644 --- a/sphinx/environment/__init__.py +++ b/sphinx/environment/__init__.py @@ -5,12 +5,14 @@ import functools import os import pickle +import warnings from collections import defaultdict from copy import deepcopy from pathlib import Path from typing import TYPE_CHECKING from sphinx import addnodes +from sphinx.deprecation import RemovedInSphinx11Warning, _deprecation_warning from sphinx.domains._domains_container import _DomainsContainer from sphinx.environment.adapters import toctree as toctree_adapters from sphinx.errors import ( @@ -23,7 +25,7 @@ from sphinx.transforms import SphinxTransformer from sphinx.util import logging from sphinx.util._files import DownloadFiles, FilenameUniqDict -from sphinx.util._pathlib import _StrPath, _StrPathProperty +from sphinx.util._pathlib import _StrPathProperty from sphinx.util._serialise import stable_str from sphinx.util._timestamps import _format_rfc3339_microseconds from sphinx.util.docutils import LoggingReporter @@ -32,7 +34,7 @@ from sphinx.util.osutil import _last_modified_time, _relative_path if TYPE_CHECKING: - from collections.abc import Callable, Iterable, Iterator, Mapping + from collections.abc import Callable, Iterable, Iterator, Mapping, Set from typing import Any, Final, Literal from docutils import nodes @@ -49,6 +51,7 @@ from sphinx.extension import Extension from sphinx.project import Project from sphinx.registry import SphinxComponentRegistry + from sphinx.util._pathlib import _StrPath from sphinx.util.tags import Tags logger = logging.getLogger(__name__) @@ -73,7 +76,7 @@ # This is increased every time an environment attribute is added # or changed to properly invalidate pickle files. -ENV_VERSION = 65 +ENV_VERSION = 66 # config status CONFIG_UNSET = -1 @@ -106,8 +109,11 @@ class BuildEnvironment: srcdir = _StrPathProperty() doctreedir = _StrPathProperty() + # builder is created after the environment. + _builder_cls: type[Builder] + def __init__(self, app: Sphinx) -> None: - self.app: Sphinx = app + self._app: Sphinx = app self.doctreedir = app.doctreedir self.srcdir = app.srcdir self.config: Config = None # type: ignore[assignment] @@ -237,11 +243,13 @@ def __getstate__(self) -> dict[str, Any]: """Obtains serializable data for pickling.""" __dict__ = self.__dict__.copy() # clear unpickleable attributes - __dict__.update(app=None, domains=None, events=None) + __dict__.update(_app=None, domains=None, events=None) # clear in-memory doctree caches, to reduce memory consumption and # ensure that, upon restoring the state, the most recent pickled files # on the disk are used instead of those from a possibly outdated state __dict__.update(_pickled_doctree_cache={}, _write_doc_doctree_cache={}) + # clear attributes set in Sphinx._post_init_env() + __dict__.pop('_builder_cls', None) return __dict__ def __setstate__(self, state: dict[str, Any]) -> None: @@ -257,7 +265,7 @@ def setup(self, app: Sphinx) -> None: if self.project: app.project.restore(self.project) - self.app = app + self._app = app self.doctreedir = app.doctreedir self.events = app.events self.srcdir = app.srcdir @@ -277,20 +285,37 @@ def setup(self, app: Sphinx) -> None: # The old config is self.config, restored from the pickled environment. # The new config is app.config, always recreated from ``conf.py`` self.config_status, self.config_status_extra = self._config_status( - old_config=self.config, new_config=app.config, verbosity=app.verbosity + old_config=self.config, + new_config=app.config, + verbosity=app.config.verbosity, ) self.config = app.config # initialize settings self._update_settings(app.config) + @property + def app(self) -> Sphinx: + _deprecation_warning(__name__, 'BuildEnvironment.app', remove=(11, 0)) + return self._app + + @app.setter + def app(self, app: Sphinx) -> None: + _deprecation_warning(__name__, 'BuildEnvironment.app', remove=(11, 0)) + self._app = app + + @app.deleter + def app(self) -> None: + _deprecation_warning(__name__, 'BuildEnvironment.app', remove=(11, 0)) + del self._app + @property def _registry(self) -> SphinxComponentRegistry: - return self.app.registry + return self._app.registry @property def _tags(self) -> Tags: - return self.app.tags + return self._app.tags @staticmethod def _config_status( @@ -498,7 +523,7 @@ def get_outdated_files( ) -> tuple[set[str], set[str], set[str]]: """Return (added, changed, removed) sets.""" # clear all files no longer present - removed = set(self.all_docs) - self.found_docs + removed = self.all_docs.keys() - self.found_docs added: set[str] = set() changed: set[str] = set() @@ -506,65 +531,25 @@ def get_outdated_files( if config_changed: # config values affect e.g. substitutions added = self.found_docs - else: - for docname in self.found_docs: - if docname not in self.all_docs: - logger.debug('[build target] added %r', docname) - added.add(docname) - continue - # if the doctree file is not there, rebuild - filename = self.doctreedir / f'{docname}.doctree' - if not filename.is_file(): - logger.debug('[build target] changed %r', docname) - changed.add(docname) - continue - # check the "reread always" list - if docname in self.reread_always: - logger.debug('[build target] changed %r', docname) - changed.add(docname) - continue - # check the mtime of the document - mtime = self.all_docs[docname] - newmtime = _last_modified_time(self.doc2path(docname)) - if newmtime > mtime: - logger.debug( - '[build target] outdated %r: %s -> %s', - docname, - _format_rfc3339_microseconds(mtime), - _format_rfc3339_microseconds(newmtime), - ) - changed.add(docname) - continue - # finally, check the mtime of dependencies - if docname not in self.dependencies: - continue - for dep in self.dependencies[docname]: - try: - # this will do the right thing when dep is absolute too - dep_path = self.srcdir / dep - if not dep_path.is_file(): - logger.debug( - '[build target] changed %r missing dependency %r', - docname, - dep_path, - ) - changed.add(docname) - break - depmtime = _last_modified_time(dep_path) - if depmtime > mtime: - logger.debug( - '[build target] outdated %r from dependency %r: %s -> %s', - docname, - dep_path, - _format_rfc3339_microseconds(mtime), - _format_rfc3339_microseconds(depmtime), - ) - changed.add(docname) - break - except OSError: - # give it another chance - changed.add(docname) - break + return added, changed, removed + + for docname in self.found_docs: + if docname not in self.all_docs: + logger.debug('[build target] added %r', docname) + added.add(docname) + continue + + # if the document has changed, rebuild + if _has_doc_changed( + docname, + filename=self.doc2path(docname), + reread_always=self.reread_always, + doctreedir=self.doctreedir, + all_docs=self.all_docs, + dependencies=self.dependencies, + ): + changed.add(docname) + continue return added, changed, removed @@ -628,7 +613,9 @@ def note_dependency( """ if docname is None: docname = self.docname - self.dependencies.setdefault(docname, set()).add(_StrPath(filename)) + # this will do the right thing when *filename* is absolute too + filename = self.srcdir / filename + self.dependencies.setdefault(docname, set()).add(filename) def note_included(self, filename: str | os.PathLike[str]) -> None: """Add *filename* as a included from other document. @@ -682,6 +669,8 @@ def get_and_resolve_doctree( self, docname: str, builder: Builder, + *, + tags: Tags = ..., # type: ignore[assignment] doctree: nodes.document | None = None, prune_toctrees: bool = True, includehidden: bool = False, @@ -689,6 +678,15 @@ def get_and_resolve_doctree( """Read the doctree from the pickle, resolve cross-references and toctrees and return it. """ + if tags is ...: + warnings.warn( + "'tags' will become a required keyword argument " + 'for global_toctree_for_doc() in Sphinx 11.0.', + RemovedInSphinx11Warning, + stacklevel=2, + ) + tags = builder.tags + if doctree is None: try: doctree = self._write_doc_doctree_cache.pop(docname) @@ -709,7 +707,7 @@ def get_and_resolve_doctree( toctreenode, prune=prune_toctrees, includehidden=includehidden, - tags=builder.tags, + tags=tags, ) if result is None: toctreenode.parent.replace(toctreenode, []) @@ -750,7 +748,7 @@ def resolve_toctree( titles_only=titles_only, collapse=collapse, includehidden=includehidden, - tags=builder.tags, + tags=self._tags, ) def resolve_references( @@ -764,7 +762,7 @@ def apply_post_transforms(self, doctree: nodes.document, docname: str) -> None: new = deepcopy(backup) new.docname = docname try: - # set env.docname during applying post-transforms + # set env.current_document.docname during applying post-transforms self.current_document = new transformer = SphinxTransformer(doctree) @@ -848,6 +846,71 @@ def _differing_config_keys(old: Config, new: Config) -> frozenset[str]: return frozenset(not_in_both | different_values) +def _has_doc_changed( + docname: str, + *, + filename: Path, + reread_always: Set[str], + doctreedir: Path, + all_docs: Mapping[str, int], + dependencies: Mapping[str, Set[Path]], +) -> bool: + # check the "reread always" list + if docname in reread_always: + logger.debug('[build target] changed %r: re-read forced', docname) + return True + + # if the doctree file is not there, rebuild + doctree_path = doctreedir / f'{docname}.doctree' + if not doctree_path.is_file(): + logger.debug('[build target] changed %r: doctree file does not exist', docname) + return True + + # check the mtime of the document + mtime = all_docs[docname] + new_mtime = _last_modified_time(filename) + if new_mtime > mtime: + logger.debug( + '[build target] changed: %r is outdated (%s -> %s)', + docname, + _format_rfc3339_microseconds(mtime), + _format_rfc3339_microseconds(new_mtime), + ) + return True + + # finally, check the mtime of dependencies + if docname not in dependencies: + return False + for dep_path in dependencies[docname]: + try: + dep_path_is_file = dep_path.is_file() + except OSError: + return True # give it another chance + if not dep_path_is_file: + logger.debug( + '[build target] changed: %r is missing dependency %r', + docname, + dep_path, + ) + return True + + try: + dep_mtime = _last_modified_time(dep_path) + except OSError: + return True # give it another chance + if dep_mtime > mtime: + logger.debug( + '[build target] changed: %r is outdated due to dependency %r (%s -> %s)', + docname, + dep_path, + _format_rfc3339_microseconds(mtime), + _format_rfc3339_microseconds(dep_mtime), + ) + return True + + return False + + def _traverse_toctree( traversed: set[str], parent: str | None, diff --git a/sphinx/environment/adapters/indexentries.py b/sphinx/environment/adapters/indexentries.py index c19628515b6..d81b10addcf 100644 --- a/sphinx/environment/adapters/indexentries.py +++ b/sphinx/environment/adapters/indexentries.py @@ -13,27 +13,27 @@ from sphinx.util.index_entries import _split_into if TYPE_CHECKING: - from typing import Literal, TypeAlias + from typing import Literal from sphinx.builders import Builder from sphinx.environment import BuildEnvironment - _IndexEntryTarget: TypeAlias = tuple[str | None, str | Literal[False]] - _IndexEntryTargets: TypeAlias = list[_IndexEntryTarget] - _IndexEntryCategoryKey: TypeAlias = str | None - _IndexEntrySubItems: TypeAlias = dict[ + type _IndexEntryTarget = tuple[str | None, str | Literal[False]] + type _IndexEntryTargets = list[_IndexEntryTarget] + type _IndexEntryCategoryKey = str | None + type _IndexEntrySubItems = dict[ str, tuple[_IndexEntryTargets, _IndexEntryCategoryKey], ] - _IndexEntry: TypeAlias = tuple[ + type _IndexEntry = tuple[ _IndexEntryTargets, _IndexEntrySubItems, _IndexEntryCategoryKey, ] - _IndexEntryMap: TypeAlias = dict[str, _IndexEntry] + type _IndexEntryMap = dict[str, _IndexEntry] # Used by ``create_index()`` for 'the real index' - _RealIndexEntry: TypeAlias = tuple[ + type _RealIndexEntry = tuple[ str, tuple[ _IndexEntryTargets, @@ -41,8 +41,8 @@ _IndexEntryCategoryKey, ], ] - _RealIndexEntries: TypeAlias = list[_RealIndexEntry] - _Index: TypeAlias = list[tuple[str, _RealIndexEntries]] + type _RealIndexEntries = list[_RealIndexEntry] + type _Index = list[tuple[str, _RealIndexEntries]] logger = logging.getLogger(__name__) @@ -50,7 +50,6 @@ class IndexEntries: def __init__(self, env: BuildEnvironment) -> None: self.env = env - self.builder: Builder def create_index( self, @@ -253,7 +252,7 @@ def _key_func_2(entry: tuple[str, _IndexEntryTargets]) -> str: def _group_by_func(entry: tuple[str, _IndexEntry]) -> str: """Group the entries by letter or category key.""" - key, (targets, sub_items, category_key) = entry + key, (_targets, _sub_items, category_key) = entry if category_key is not None: return category_key diff --git a/sphinx/environment/adapters/toctree.py b/sphinx/environment/adapters/toctree.py index bedeca2f299..da811b480f0 100644 --- a/sphinx/environment/adapters/toctree.py +++ b/sphinx/environment/adapters/toctree.py @@ -2,12 +2,14 @@ from __future__ import annotations -from typing import TYPE_CHECKING, TypeVar +import warnings +from typing import TYPE_CHECKING from docutils import nodes from docutils.nodes import Element from sphinx import addnodes +from sphinx.deprecation import RemovedInSphinx11Warning from sphinx.locale import __ from sphinx.util import logging, url_re from sphinx.util.matching import Matcher @@ -69,6 +71,8 @@ def global_toctree_for_doc( env: BuildEnvironment, docname: str, builder: Builder, + *, + tags: Tags = ..., # type: ignore[assignment] collapse: bool = False, includehidden: bool = True, maxdepth: int = 0, @@ -78,6 +82,15 @@ def global_toctree_for_doc( This gives the global ToC, with all ancestors and their siblings. """ + if tags is ...: + warnings.warn( + "'tags' will become a required keyword argument " + 'for global_toctree_for_doc() in Sphinx 11.0.', + RemovedInSphinx11Warning, + stacklevel=2, + ) + tags = builder.tags + resolved = ( _resolve_toctree( env, @@ -89,7 +102,7 @@ def global_toctree_for_doc( titles_only=titles_only, collapse=collapse, includehidden=includehidden, - tags=builder.tags, + tags=tags, ) for toctree_node in env.master_doctree.findall(addnodes.toctree) ) @@ -191,9 +204,7 @@ def _resolve_toctree( # prune the tree to maxdepth, also set toc depth and current classes _toctree_add_classes(newnode, 1, docname) - newnode = _toctree_copy( - newnode, 1, maxdepth if prune else 0, collapse, builder.tags - ) + newnode = _toctree_copy(newnode, 1, maxdepth if prune else 0, collapse, tags) if ( isinstance(newnode[-1], nodes.Element) and len(newnode[-1]) == 0 @@ -444,7 +455,7 @@ def _toctree_standard_entry( def _toctree_add_classes(node: Element, depth: int, docname: str) -> None: """Add 'toctree-l%d' and 'current' classes to the toctree.""" for subnode in node.children: - if isinstance(subnode, addnodes.compact_paragraph | nodes.list_item): + if isinstance(subnode, (addnodes.compact_paragraph, nodes.list_item)): # for

and

  • , indicate the depth level and recurse subnode['classes'].append(f'toctree-l{depth - 1}') _toctree_add_classes(subnode, depth, docname) @@ -471,56 +482,81 @@ def _toctree_add_classes(node: Element, depth: int, docname: str) -> None: subnode = subnode.parent -ET = TypeVar('ET', bound=Element) - - -def _toctree_copy( +def _toctree_copy[ET: Element]( node: ET, depth: int, maxdepth: int, collapse: bool, tags: Tags ) -> ET: """Utility: Cut and deep-copy a TOC at a specified depth.""" - keep_bullet_list_sub_nodes = depth <= 1 or ( - (depth <= maxdepth or maxdepth <= 0) and (not collapse or 'iscurrent' in node) - ) + assert not isinstance(node, addnodes.only) + depth = max(depth - 1, 1) + copied = _toctree_copy_seq(node, depth, maxdepth, collapse, tags, initial_call=True) + assert len(copied) == 1 + return copied[0] # type: ignore[return-value] - copy = node.copy() - for subnode in node.children: - if isinstance(subnode, addnodes.compact_paragraph | nodes.list_item): - # for

    and

  • , just recurse - copy.append(_toctree_copy(subnode, depth, maxdepth, collapse, tags)) - elif isinstance(subnode, nodes.bullet_list): - # for
      , copy if the entry is top-level - # or, copy if the depth is within bounds and; - # collapsing is disabled or the sub-entry's parent is 'current'. - # The boolean is constant so is calculated outwith the loop. - if keep_bullet_list_sub_nodes: - copy.append(_toctree_copy(subnode, depth + 1, maxdepth, collapse, tags)) - elif isinstance(subnode, addnodes.toctree): - # copy sub toctree nodes for later processing - copy.append(subnode.copy()) - elif isinstance(subnode, addnodes.only): - # only keep children if the only node matches the tags - if _only_node_keep_children(subnode, tags): - for child in subnode.children: - copy.append( - _toctree_copy( - child, - depth, - maxdepth, - collapse, - tags, # type: ignore[type-var] - ) - ) - elif isinstance(subnode, nodes.reference | nodes.title): - # deep copy references and captions - sub_node_copy = subnode.copy() - sub_node_copy.children = [child.deepcopy() for child in subnode.children] - for child in sub_node_copy.children: - child.parent = sub_node_copy - copy.append(sub_node_copy) - else: - msg = f'Unexpected node type {subnode.__class__.__name__!r}!' - raise ValueError(msg) # NoQA: TRY004 - return copy + +def _toctree_copy_seq( + node: Node, + depth: int, + maxdepth: int, + collapse: bool, + tags: Tags, + *, + initial_call: bool = False, + is_current: bool = False, +) -> list[Element]: + copy: Element + if isinstance(node, (addnodes.compact_paragraph, nodes.list_item)): + # for

      and

    • , just recurse + copy = node.copy() + for subnode in node.children: + copy += _toctree_copy_seq( # type: ignore[assignment,operator] + subnode, depth, maxdepth, collapse, tags, is_current='iscurrent' in node + ) + return [copy] + + if isinstance(node, nodes.bullet_list): + # for
        , copy if the entry is top-level + # or, copy if the depth is within bounds and; + # collapsing is disabled or the sub-entry's parent is 'current'. + # The boolean is constant so is calculated outwith the loop. + keep_bullet_list_sub_nodes = depth <= 1 or ( + (depth <= maxdepth or maxdepth <= 0) + and (not collapse or is_current or 'iscurrent' in node) + ) + if not keep_bullet_list_sub_nodes and not initial_call: + return [] + depth += 1 + copy = node.copy() + for subnode in node.children: + copy += _toctree_copy_seq( + subnode, depth, maxdepth, collapse, tags, is_current='iscurrent' in node + ) + return [copy] + + if isinstance(node, addnodes.toctree): + # copy sub toctree nodes for later processing + return [node.copy()] + + if isinstance(node, addnodes.only): + # only keep children if the only node matches the tags + if not _only_node_keep_children(node, tags): + return [] + copied: list[Element] = [] + for subnode in node.children: + copied += _toctree_copy_seq( + subnode, depth, maxdepth, collapse, tags, is_current='iscurrent' in node + ) + return copied + + if isinstance(node, (nodes.reference, nodes.title)): + # deep copy references and captions + sub_node_copy = node.copy() + sub_node_copy.children = [child.deepcopy() for child in node.children] + for child in sub_node_copy.children: + child.parent = sub_node_copy + return [sub_node_copy] + + msg = f'Unexpected node type {node.__class__.__name__!r}!' + raise ValueError(msg) def _get_toctree_ancestors( @@ -584,5 +620,5 @@ def get_toctree_for( **kwargs: Any, ) -> Element | None: return global_toctree_for_doc( - self.env, docname, builder, collapse=collapse, **kwargs + self.env, docname, builder, tags=builder.tags, collapse=collapse, **kwargs ) diff --git a/sphinx/environment/collectors/asset.py b/sphinx/environment/collectors/asset.py index 13105587673..a1af7c33474 100644 --- a/sphinx/environment/collectors/asset.py +++ b/sphinx/environment/collectors/asset.py @@ -47,7 +47,7 @@ def merge_other( def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: """Process and rewrite image URIs.""" - docname = app.env.docname + docname = app.env.current_document.docname for node in doctree.findall(nodes.image): # Map the mimetype to the corresponding image. The writer may @@ -117,7 +117,7 @@ def collect_candidates( try: mimetype = guess_mimetype(filename) if mimetype is None: - basename, suffix = os.path.splitext(filename) + _basename, suffix = os.path.splitext(filename) mimetype = 'image/x-' + suffix[1:] if mimetype not in candidates: globbed.setdefault(mimetype, []).append(new_imgpath.as_posix()) @@ -156,7 +156,9 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: if '://' in targetname: node['refuri'] = targetname else: - rel_filename, filename = app.env.relfn2path(targetname, app.env.docname) + rel_filename, filename = app.env.relfn2path( + targetname, app.env.current_document.docname + ) app.env.note_dependency(rel_filename) if not os.access(filename, os.R_OK): logger.warning( @@ -168,7 +170,7 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: ) continue node['filename'] = app.env.dlfiles.add_file( - app.env.docname, rel_filename + app.env.current_document.docname, rel_filename ).as_posix() diff --git a/sphinx/environment/collectors/metadata.py b/sphinx/environment/collectors/metadata.py index 2cda65beec2..8936341a919 100644 --- a/sphinx/environment/collectors/metadata.py +++ b/sphinx/environment/collectors/metadata.py @@ -41,7 +41,7 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: if index is None: return elif isinstance(doctree[index], nodes.docinfo): - md = app.env.metadata[app.env.docname] + md = app.env.metadata[app.env.current_document.docname] for node in doctree[index]: # type: ignore[attr-defined] # nodes are multiply inherited... if isinstance(node, nodes.authors): diff --git a/sphinx/environment/collectors/title.py b/sphinx/environment/collectors/title.py index 4bd3ed7e146..59a77ef3e7e 100644 --- a/sphinx/environment/collectors/title.py +++ b/sphinx/environment/collectors/title.py @@ -50,13 +50,13 @@ def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: for node in doctree.findall(nodes.section): visitor = SphinxContentsFilter(doctree) node[0].walkabout(visitor) - titlenode += visitor.get_entry_text() # type: ignore[no-untyped-call] + titlenode += visitor.get_entry_text() break else: # document has no title titlenode += nodes.Text(doctree.get('title', '')) - app.env.titles[app.env.docname] = titlenode - app.env.longtitles[app.env.docname] = longtitlenode + app.env.titles[app.env.current_document.docname] = titlenode + app.env.longtitles[app.env.current_document.docname] = longtitlenode def setup(app: Sphinx) -> ExtensionMetadata: diff --git a/sphinx/environment/collectors/toctree.py b/sphinx/environment/collectors/toctree.py index fddd269e1b7..fd270f0fa51 100644 --- a/sphinx/environment/collectors/toctree.py +++ b/sphinx/environment/collectors/toctree.py @@ -2,7 +2,7 @@ from __future__ import annotations -from typing import TYPE_CHECKING, TypeVar, cast +from typing import TYPE_CHECKING, cast from docutils import nodes @@ -23,8 +23,6 @@ from sphinx.environment import BuildEnvironment from sphinx.util.typing import ExtensionMetadata -N = TypeVar('N') - logger = logging.getLogger(__name__) @@ -65,7 +63,7 @@ def merge_other( def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: """Build a TOC from the doctree and store it in the inventory.""" - docname = app.env.docname + docname = app.env.current_document.docname numentries = [0] # nonlocal again... def build_toc( @@ -84,7 +82,7 @@ def build_toc( # and unnecessary stuff visitor = SphinxContentsFilter(doctree) title.walkabout(visitor) - nodetext = visitor.get_entry_text() # type: ignore[no-untyped-call] + nodetext = visitor.get_entry_text() anchorname = _make_anchor_name(sectionnode['ids'], numentries) # make these nodes: # list_item -> compact_paragraph -> reference diff --git a/sphinx/events.py b/sphinx/events.py index 571ad143269..3a075786e7a 100644 --- a/sphinx/events.py +++ b/sphinx/events.py @@ -9,6 +9,7 @@ from operator import attrgetter from typing import TYPE_CHECKING, NamedTuple, overload +from sphinx.deprecation import _deprecation_warning from sphinx.errors import ExtensionError, SphinxError from sphinx.locale import __ from sphinx.util import logging @@ -27,7 +28,13 @@ from sphinx.config import Config from sphinx.domains import Domain from sphinx.environment import BuildEnvironment - from sphinx.ext.autodoc import _AutodocProcessDocstringListener + from sphinx.ext.autodoc._event_listeners import ( + _AutodocBeforeProcessSignatureListener, + _AutodocProcessBasesListener, + _AutodocProcessDocstringListener, + _AutodocProcessSignatureListener, + _AutodocSkipMemberListener, + ) from sphinx.ext.todo import todo_node @@ -66,17 +73,31 @@ class EventManager: """Event manager for Sphinx.""" def __init__(self, app: Sphinx) -> None: - self.app = app + self._app = app self.events = core_events.copy() self.listeners: dict[str, list[EventListener]] = defaultdict(list) self.next_listener_id = 0 + # pass through errors for debugging. + self._reraise_errors: bool = app.pdb + def add(self, name: str) -> None: - """Register a custom Sphinx event.""" + """Register a custom Sphinx event called *name*. + + This is needed to be able to emit the event. + + :param name: The name of the event. + """ if name in self.events: - raise ExtensionError(__('Event %r already present') % name) + msg = __('Event %r already present') + raise ExtensionError(msg % name) self.events[name] = '' + @property + def app(self) -> Sphinx: + _deprecation_warning(__name__, 'EventManager.app', remove=(11, 0)) + return self._app + # ---- Core events ------------------------------------------------------- @overload @@ -274,7 +295,7 @@ def connect( def connect( self, name: Literal['autodoc-before-process-signature'], - callback: Callable[[Sphinx, Any, bool], None], + callback: _AutodocBeforeProcessSignatureListener, priority: int, ) -> int: ... @@ -282,20 +303,7 @@ def connect( def connect( self, name: Literal['autodoc-process-signature'], - callback: Callable[ - [ - Sphinx, - Literal[ - 'module', 'class', 'exception', 'function', 'method', 'attribute' - ], - str, - Any, - dict[str, bool], - str | None, - str | None, - ], - tuple[str | None, str | None] | None, - ], + callback: _AutodocProcessSignatureListener, priority: int, ) -> int: ... @@ -303,7 +311,7 @@ def connect( def connect( self, name: Literal['autodoc-process-bases'], - callback: Callable[[Sphinx, str, Any, dict[str, bool], list[str]], None], + callback: _AutodocProcessBasesListener, priority: int, ) -> int: ... @@ -311,19 +319,7 @@ def connect( def connect( self, name: Literal['autodoc-skip-member'], - callback: Callable[ - [ - Sphinx, - Literal[ - 'module', 'class', 'exception', 'function', 'method', 'attribute' - ], - str, - Any, - bool, - dict[str, bool], - ], - bool, - ], + callback: _AutodocSkipMemberListener, priority: int, ) -> int: ... @@ -365,9 +361,30 @@ def connect( ) -> int: ... def connect(self, name: str, callback: Callable[..., Any], priority: int) -> int: - """Connect a handler to specific event.""" + """Connect a handler to specific event. + + Register *callback* to be called when the *name* event is emitted. + + See :ref:`event callbacks ` for details on available core events + and the arguments of their corresponding callback functions. + + :param name: + The name of the target event. + :param callback: + Callback function for the event. + :param priority: + The priority of the callback. + The callbacks will be invoked in ascending order of *priority*. + :return: + A listener ID, for use with the :meth:`disconnect` method. + + .. versionchanged:: 3.0 + + Support *priority* + """ if name not in self.events: - raise ExtensionError(__('Unknown event name: %s') % name) + msg = __('Unknown event name: %s') + raise ExtensionError(msg % name) listener_id = self.next_listener_id self.next_listener_id += 1 @@ -375,7 +392,11 @@ def connect(self, name: str, callback: Callable[..., Any], priority: int) -> int return listener_id def disconnect(self, listener_id: int) -> None: - """Disconnect a handler.""" + """Disconnect the handler given by *listener_id*. + + :param listener_id: + A listener_id previously returned by :meth:`connect`. + """ for listeners in self.listeners.values(): for listener in listeners.copy(): if listener.id == listener_id: @@ -387,9 +408,25 @@ def emit( *args: Any, allowed_exceptions: tuple[type[Exception], ...] = (), ) -> list[Any]: - """Emit a Sphinx event.""" - # not every object likes to be repr()'d (think - # random stuff coming via autodoc) + """Emit a Sphinx event. + + This emits the *name* event and passes *args* to the handler functions. + Return the return values of all handlers as a list. + Do not emit core Sphinx events in extensions! + + :param name: + The name of the event that will be emitted. + :param args: + The arguments for the event, to be passed to the handler functions. + :param allowed_exceptions: + The list of exceptions that are allowed in the handlers. + + .. versionchanged:: 3.1 + + Added *allowed_exceptions* to specify path-through exceptions + """ + # not every object likes to be repr()'d + # (think random stuff coming via autodoc) try: repr_args = repr(args) except Exception: @@ -401,20 +438,19 @@ def emit( listeners = sorted(self.listeners[name], key=attrgetter('priority')) for listener in listeners: try: - results.append(listener.handler(self.app, *args)) + results.append(listener.handler(self._app, *args)) except allowed_exceptions: # pass through the errors specified as *allowed_exceptions* raise except SphinxError: raise except Exception as exc: - if self.app.pdb: - # Just pass through the error, so that it can be debugged. + if self._reraise_errors: raise modname = safe_getattr(listener.handler, '__module__', None) + msg = __('Handler %r for event %r threw an exception') raise ExtensionError( - __('Handler %r for event %r threw an exception') - % (listener.handler, name), + msg % (listener.handler, name), exc, modname=modname, ) from exc @@ -426,9 +462,22 @@ def emit_firstresult( *args: Any, allowed_exceptions: tuple[type[Exception], ...] = (), ) -> Any: - """Emit a Sphinx event and returns first result. + """Emit a Sphinx event and return the first result. + + This emits the *name* event and passes *args* to the handler functions. + The first non-None result is returned. + + :param name: + The name of the event that will be emitted. + :param args: + The arguments for the event, to be passed to the handler functions. + :param allowed_exceptions: + The list of exceptions that are allowed in the handlers. + + .. versionadded:: 0.5 + .. versionchanged:: 3.1 - This returns the result of the first handler that doesn't return ``None``. + Added *allowed_exceptions* to specify path-through exceptions """ for result in self.emit(name, *args, allowed_exceptions=allowed_exceptions): if result is not None: diff --git a/sphinx/ext/apidoc/_extension.py b/sphinx/ext/apidoc/_extension.py index c5a67528ec0..7199fbba6dd 100644 --- a/sphinx/ext/apidoc/_extension.py +++ b/sphinx/ext/apidoc/_extension.py @@ -243,7 +243,7 @@ def _check_collection_of_strings( """ if key not in options: return default - if not isinstance(options[key], list | tuple | set | frozenset): + if not isinstance(options[key], (list, tuple, set, frozenset)): LOGGER.warning( __("apidoc_modules item %i '%s' must be a sequence"), index, diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py index 8cdb039df3e..aabe59450bd 100644 --- a/sphinx/ext/autodoc/__init__.py +++ b/sphinx/ext/autodoc/__init__.py @@ -7,3159 +7,137 @@ from __future__ import annotations -import functools -import operator -import re -import sys -from inspect import Parameter, Signature -from typing import TYPE_CHECKING, Any, NewType, TypeVar +from typing import TYPE_CHECKING -from docutils.statemachine import StringList - -import sphinx -from sphinx.config import ENUM -from sphinx.errors import PycodeError -from sphinx.ext.autodoc.importer import get_class_members, import_module, import_object -from sphinx.ext.autodoc.mock import ismock, mock, undecorate -from sphinx.locale import _, __ -from sphinx.pycode import ModuleAnalyzer -from sphinx.util import inspect, logging -from sphinx.util.docstrings import prepare_docstring, separate_metadata -from sphinx.util.inspect import ( - evaluate_signature, - getdoc, - object_description, - safe_getattr, - stringify_signature, -) -from sphinx.util.typing import get_type_hints, restify, stringify_annotation - -if TYPE_CHECKING: - from collections.abc import Callable, Iterator, Sequence - from types import ModuleType - from typing import ClassVar, Literal, TypeAlias - - from sphinx.application import Sphinx - from sphinx.config import Config - from sphinx.environment import BuildEnvironment, _CurrentDocument - from sphinx.events import EventManager - from sphinx.ext.autodoc.directive import DocumenterBridge - from sphinx.registry import SphinxComponentRegistry - from sphinx.util.typing import ExtensionMetadata, OptionSpec, _RestifyMode - - _AutodocObjType = Literal[ - 'module', 'class', 'exception', 'function', 'method', 'attribute' - ] - _AutodocProcessDocstringListener: TypeAlias = Callable[ - [Sphinx, _AutodocObjType, str, Any, dict[str, bool], list[str]], None - ] - -logger = logging.getLogger(__name__) - - -# This type isn't exposed directly in any modules, but can be found -# here in most Python versions -MethodDescriptorType = type(type.__subclasses__) - - -#: extended signature RE: with explicit module name separated by :: -py_ext_sig_re = re.compile( - r"""^ ([\w.]+::)? # explicit module name - ([\w.]+\.)? # module and/or class name(s) - (\w+) \s* # thing name - (?: \[\s*(.*?)\s*])? # optional: type parameters list - (?: \((.*)\) # optional: arguments - (?:\s* -> \s* (.*))? # return annotation - )? $ # and nothing more - """, - re.VERBOSE, -) -special_member_re = re.compile(r'^__\S+__$') - - -def _get_render_mode( - typehints_format: Literal['fully-qualified', 'short'], -) -> _RestifyMode: - if typehints_format == 'short': - return 'smart' - return 'fully-qualified-except-typing' - - -def identity(x: Any) -> Any: - return x - - -class _All: - """A special value for :*-members: that matches to any member.""" - - def __contains__(self, item: Any) -> bool: - return True - - def append(self, item: Any) -> None: - pass # nothing - - -class _Empty: - """A special value for :exclude-members: that never matches to any member.""" - - def __contains__(self, item: Any) -> bool: - return False - - -ALL = _All() -EMPTY = _Empty() -UNINITIALIZED_ATTR = object() -INSTANCEATTR = object() -SLOTSATTR = object() - - -def members_option(arg: Any) -> object | list[str]: - """Used to convert the :members: option to auto directives.""" - if arg in {None, True}: - return ALL - elif arg is False: - return None - else: - return [x.strip() for x in arg.split(',') if x.strip()] - - -def exclude_members_option(arg: Any) -> object | set[str]: - """Used to convert the :exclude-members: option.""" - if arg in {None, True}: - return EMPTY - return {x.strip() for x in arg.split(',') if x.strip()} - - -def inherited_members_option(arg: Any) -> set[str]: - """Used to convert the :inherited-members: option to auto directives.""" - if arg in {None, True}: - return {'object'} - elif arg: - return {x.strip() for x in arg.split(',')} - else: - return set() - - -def member_order_option(arg: Any) -> str | None: - """Used to convert the :member-order: option to auto directives.""" - if arg in {None, True}: - return None - elif arg in {'alphabetical', 'bysource', 'groupwise'}: - return arg - else: - raise ValueError(__('invalid value for member-order option: %s') % arg) - - -def class_doc_from_option(arg: Any) -> str | None: - """Used to convert the :class-doc-from: option to autoclass directives.""" - if arg in {'both', 'class', 'init'}: - return arg - else: - raise ValueError(__('invalid value for class-doc-from option: %s') % arg) - - -SUPPRESS = object() - - -def annotation_option(arg: Any) -> Any: - if arg in {None, True}: - # suppress showing the representation of the object - return SUPPRESS - else: - return arg - - -def bool_option(arg: Any) -> bool: - """Used to convert flag options to auto directives. (Instead of - directives.flag(), which returns None). - """ - return True - - -def merge_members_option(options: dict[str, Any]) -> None: - """Merge :private-members: and :special-members: options to the - :members: option. - """ - if options.get('members') is ALL: - # merging is not needed when members: ALL - return - - members = options.setdefault('members', []) - for key in ('private-members', 'special-members'): - other_members = options.get(key) - if other_members is not None and other_members is not ALL: - for member in other_members: - if member not in members: - members.append(member) - - -# Some useful event listener factories for autodoc-process-docstring. - - -def cut_lines( - pre: int, post: int = 0, what: Sequence[str] | None = None -) -> _AutodocProcessDocstringListener: - """Return a listener that removes the first *pre* and last *post* - lines of every docstring. If *what* is a sequence of strings, - only docstrings of a type in *what* will be processed. - - Use like this (e.g. in the ``setup()`` function of :file:`conf.py`):: - - from sphinx.ext.autodoc import cut_lines - - app.connect('autodoc-process-docstring', cut_lines(4, what={'module'})) - - This can (and should) be used in place of :confval:`automodule_skip_lines`. - """ - if not what: - what_unique: frozenset[str] = frozenset() - elif isinstance(what, str): # strongly discouraged - what_unique = frozenset({what}) - else: - what_unique = frozenset(what) - - def process( - app: Sphinx, - what_: _AutodocObjType, - name: str, - obj: Any, - options: dict[str, bool], - lines: list[str], - ) -> None: - if what_unique and what_ not in what_unique: - return - del lines[:pre] - if post: - # remove one trailing blank line. - if lines and not lines[-1]: - lines.pop(-1) - del lines[-post:] - # make sure there is a blank line at the end - if lines and lines[-1]: - lines.append('') - - return process - - -def between( - marker: str, - what: Sequence[str] | None = None, - keepempty: bool = False, - exclude: bool = False, -) -> _AutodocProcessDocstringListener: - """Return a listener that either keeps, or if *exclude* is True excludes, - lines between lines that match the *marker* regular expression. If no line - matches, the resulting docstring would be empty, so no change will be made - unless *keepempty* is true. - - If *what* is a sequence of strings, only docstrings of a type in *what* will - be processed. - """ - marker_re = re.compile(marker) - - def process( - app: Sphinx, - what_: _AutodocObjType, - name: str, - obj: Any, - options: dict[str, bool], - lines: list[str], - ) -> None: - if what and what_ not in what: - return - deleted = 0 - delete = not exclude - orig_lines = lines.copy() - for i, line in enumerate(orig_lines): - if delete: - lines.pop(i - deleted) - deleted += 1 - if marker_re.match(line): - delete = not delete - if delete: - lines.pop(i - deleted) - deleted += 1 - if not lines and not keepempty: - lines[:] = orig_lines - # make sure there is a blank line at the end - if lines and lines[-1]: - lines.append('') - - return process - - -# This class is used only in ``sphinx.ext.autodoc.directive``, -# But we define this class here to keep compatibility -# See: https://github.com/sphinx-doc/sphinx/issues/4538 -class Options(dict[str, Any]): # NoQA: FURB189 - """A dict/attribute hybrid that returns None on nonexisting keys.""" - - def copy(self) -> Options: - return Options(super().copy()) - - def __getattr__(self, name: str) -> Any: - try: - return self[name.replace('_', '-')] - except KeyError: - return None - - -class ObjectMember: - """A member of object. - - This is used for the result of `Documenter.get_module_members()` to - represent each member of the object. - """ - - __slots__ = '__name__', 'object', 'docstring', 'class_', 'skipped' - - __name__: str - object: Any - docstring: str | None - class_: Any - skipped: bool - - def __init__( - self, - name: str, - obj: Any, - *, - docstring: str | None = None, - class_: Any = None, - skipped: bool = False, - ) -> None: - self.__name__ = name - self.object = obj - self.docstring = docstring - self.class_ = class_ - self.skipped = skipped - - def __repr__(self) -> str: - return ( - f'ObjectMember(' - f'name={self.__name__!r}, ' - f'obj={self.object!r}, ' - f'docstring={self.docstring!r}, ' - f'class_={self.class_!r}, ' - f'skipped={self.skipped!r}' - f')' - ) - - -class Documenter: - """A Documenter knows how to autodocument a single object type. When - registered with the AutoDirective, it will be used to document objects - of that type when needed by autodoc. - - Its *objtype* attribute selects what auto directive it is assigned to - (the directive name is 'auto' + objtype), and what directive it generates - by default, though that can be overridden by an attribute called - *directivetype*. - - A Documenter has an *option_spec* that works like a docutils directive's; - in fact, it will be used to parse an auto directive's options that matches - the Documenter. - """ - - #: name by which the directive is called (auto...) and the default - #: generated directive name - objtype = 'object' - #: indentation by which to indent the directive content - content_indent = ' ' - #: priority if multiple documenters return True from can_document_member - priority = 0 - #: order if autodoc_member_order is set to 'groupwise' - member_order = 0 - #: true if the generated content may contain titles - titles_allowed = True - - option_spec: ClassVar[OptionSpec] = { - 'no-index': bool_option, - 'no-index-entry': bool_option, - 'noindex': bool_option, - } - - def get_attr(self, obj: Any, name: str, *defargs: Any) -> Any: - """getattr() override for types such as Zope interfaces.""" - return autodoc_attrgetter(obj, name, *defargs, registry=self.env._registry) - - @classmethod - def can_document_member( - cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any - ) -> bool: - """Called to see if a member can be documented by this Documenter.""" - msg = 'must be implemented in subclasses' - raise NotImplementedError(msg) - - def __init__( - self, directive: DocumenterBridge, name: str, indent: str = '' - ) -> None: - self.directive = directive - self.config: Config = directive.env.config - self.env: BuildEnvironment = directive.env - self._current_document: _CurrentDocument = directive.env.current_document - self._events: EventManager = directive.env.events - self.options = directive.genopt - self.name = name - self.indent = indent - # the module and object path within the module, and the fully - # qualified name (all set after resolve_name succeeds) - self.modname: str = '' - self.module: ModuleType | None = None - self.objpath: list[str] = [] - self.fullname = '' - # extra signature items (arguments and return annotation, - # also set after resolve_name succeeds) - self.args: str | None = None - self.retann: str = '' - # the object to document (set after import_object succeeds) - self.object: Any = None - self.object_name = '' - # the parent/owner of the object to document - self.parent: Any = None - # the module analyzer to get at attribute docs, or None - self.analyzer: ModuleAnalyzer | None = None - - @property - def documenters(self) -> dict[str, type[Documenter]]: - """Returns registered Documenter classes""" - return self.env._registry.documenters - - def add_line(self, line: str, source: str, *lineno: int) -> None: - """Append one line of generated reST to the output.""" - if line.strip(): # not a blank line - self.directive.result.append(self.indent + line, source, *lineno) - else: - self.directive.result.append('', source, *lineno) - - def resolve_name( - self, modname: str | None, parents: Any, path: str, base: str - ) -> tuple[str | None, list[str]]: - """Resolve the module and name of the object to document given by the - arguments and the current module/class. - - Must return a pair of the module name and a chain of attributes; for - example, it would return ``('zipfile', ['ZipFile', 'open'])`` for the - ``zipfile.ZipFile.open`` method. - """ - msg = 'must be implemented in subclasses' - raise NotImplementedError(msg) - - def parse_name(self) -> bool: - """Determine what module to import and what attribute to document. - - Returns True and sets *self.modname*, *self.objpath*, *self.fullname*, - *self.args* and *self.retann* if parsing and resolving was successful. - """ - # first, parse the definition -- auto directives for classes and - # functions can contain a signature which is then used instead of - # an autogenerated one - matched = py_ext_sig_re.match(self.name) - if matched is None: - logger.warning( - __('invalid signature for auto%s (%r)'), - self.objtype, - self.name, - type='autodoc', - ) - return False - explicit_modname, path, base, tp_list, args, retann = matched.groups() - - # support explicit module and class name separation via :: - if explicit_modname is not None: - modname = explicit_modname[:-2] - parents = path.rstrip('.').split('.') if path else [] - else: - modname = None - parents = [] - - with mock(self.config.autodoc_mock_imports): - modname, self.objpath = self.resolve_name(modname, parents, path, base) - - if not modname: - return False - - self.modname = modname - self.args = args - self.retann = retann - self.fullname = '.'.join((self.modname or '', *self.objpath)) - return True - - def import_object(self, raiseerror: bool = False) -> bool: - """Import the object given by *self.modname* and *self.objpath* and set - it as *self.object*. - - Returns True if successful, False if an error occurred. - """ - with mock(self.config.autodoc_mock_imports): - try: - ret = import_object( - self.modname, self.objpath, self.objtype, attrgetter=self.get_attr - ) - self.module, self.parent, self.object_name, self.object = ret - if ismock(self.object): - self.object = undecorate(self.object) - return True - except ImportError as exc: - if raiseerror: - raise - logger.warning(exc.args[0], type='autodoc', subtype='import_object') - self.env.note_reread() - return False - - def get_real_modname(self) -> str: - """Get the real module name of an object to document. - - It can differ from the name of the module through which the object was - imported. - """ - return self.get_attr(self.object, '__module__', None) or self.modname - - def check_module(self) -> bool: - """Check if *self.object* is really defined in the module given by - *self.modname*. - """ - if self.options.imported_members: - return True - - subject = inspect.unpartial(self.object) - modname = self.get_attr(subject, '__module__', None) - return not modname or modname == self.modname - - def format_args(self, **kwargs: Any) -> str: - """Format the argument signature of *self.object*. - - Should return None if the object does not have a signature. - """ - return '' - - def format_name(self) -> str: - """Format the name of *self.object*. - - This normally should be something that can be parsed by the generated - directive, but doesn't need to be (Sphinx will display it unparsed - then). - """ - # normally the name doesn't contain the module (except for module - # directives of course) - return '.'.join(self.objpath) or self.modname - - def _call_format_args(self, **kwargs: Any) -> str: - if kwargs: - try: - return self.format_args(**kwargs) - except TypeError: - # avoid chaining exceptions, by putting nothing here - pass - - # retry without arguments for old documenters - return self.format_args() - - def format_signature(self, **kwargs: Any) -> str: - """Format the signature (arguments and return annotation) of the object. - - Let the user process it via the ``autodoc-process-signature`` event. - """ - if self.args is not None: - # signature given explicitly - args = f'({self.args})' - retann = self.retann - else: - # try to introspect the signature - try: - retann = None - args = self._call_format_args(**kwargs) - if args: - matched = re.match(r'^(\(.*\))\s+->\s+(.*)$', args) - if matched: - args = matched.group(1) - retann = matched.group(2) - except Exception as exc: - logger.warning( - __('error while formatting arguments for %s: %s'), - self.fullname, - exc, - type='autodoc', - ) - args = None - - result = self._events.emit_firstresult( - 'autodoc-process-signature', - self.objtype, - self.fullname, - self.object, - self.options, - args, - retann, - ) - if result: - args, retann = result - - if args is not None: - return args + ((' -> %s' % retann) if retann else '') - else: - return '' - - def add_directive_header(self, sig: str) -> None: - """Add the directive header and options to the generated content.""" - domain = getattr(self, 'domain', 'py') - directive = getattr(self, 'directivetype', self.objtype) - name = self.format_name() - sourcename = self.get_sourcename() - - # one signature per line, indented by column - prefix = f'.. {domain}:{directive}:: ' - for i, sig_line in enumerate(sig.split('\n')): - self.add_line(f'{prefix}{name}{sig_line}', sourcename) - if i == 0: - prefix = ' ' * len(prefix) - - if self.options.no_index or self.options.noindex: - self.add_line(' :no-index:', sourcename) - if self.options.no_index_entry: - self.add_line(' :no-index-entry:', sourcename) - if self.objpath: - # Be explicit about the module, this is necessary since .. class:: - # etc. don't support a prepended module name - self.add_line(' :module: %s' % self.modname, sourcename) - - def get_doc(self) -> list[list[str]] | None: - """Decode and return lines of the docstring(s) for the object. - - When it returns None, autodoc-process-docstring will not be called for this - object. - """ - docstring = getdoc( - self.object, - self.get_attr, - self.config.autodoc_inherit_docstrings, - self.parent, - self.object_name, - ) - if docstring: - tab_width = self.directive.state.document.settings.tab_width - return [prepare_docstring(docstring, tab_width)] - return [] - - def process_doc(self, docstrings: list[list[str]]) -> Iterator[str]: - """Let the user process the docstrings before adding them.""" - for docstringlines in docstrings: - if self._events is not None: - # let extensions preprocess docstrings - self._events.emit( - 'autodoc-process-docstring', - self.objtype, - self.fullname, - self.object, - self.options, - docstringlines, - ) - - if docstringlines and docstringlines[-1]: - # append a blank line to the end of the docstring - docstringlines.append('') - - yield from docstringlines - - def get_sourcename(self) -> str: - obj_module = inspect.safe_getattr(self.object, '__module__', None) - obj_qualname = inspect.safe_getattr(self.object, '__qualname__', None) - if obj_module and obj_qualname: - # Get the correct location of docstring from self.object - # to support inherited methods - fullname = f'{self.object.__module__}.{self.object.__qualname__}' - else: - fullname = self.fullname - - if self.analyzer: - return f'{self.analyzer.srcname}:docstring of {fullname}' - else: - return 'docstring of %s' % fullname - - def add_content(self, more_content: StringList | None) -> None: - """Add content from docstrings, attribute documentation and user.""" - docstring = True - - # set sourcename and add content from attribute documentation - sourcename = self.get_sourcename() - if self.analyzer: - attr_docs = self.analyzer.find_attr_docs() - if self.objpath: - key = ('.'.join(self.objpath[:-1]), self.objpath[-1]) - if key in attr_docs: - docstring = False - # make a copy of docstring for attributes to avoid cache - # the change of autodoc-process-docstring event. - attribute_docstrings = [list(attr_docs[key])] - - for i, line in enumerate(self.process_doc(attribute_docstrings)): - self.add_line(line, sourcename, i) - - # add content from docstrings - if docstring: - docstrings = self.get_doc() - if docstrings is None: - # Do not call autodoc-process-docstring on get_doc() returns None. - pass - else: - if not docstrings: - # append at least a dummy docstring, so that the event - # autodoc-process-docstring is fired and can add some - # content if desired - docstrings.append([]) - for i, line in enumerate(self.process_doc(docstrings)): - self.add_line(line, sourcename, i) - - # add additional content (e.g. from document), if present - if more_content: - for line, src in zip(more_content.data, more_content.items, strict=True): - self.add_line(line, src[0], src[1]) - - def get_object_members(self, want_all: bool) -> tuple[bool, list[ObjectMember]]: - """Return `(members_check_module, members)` where `members` is a - list of `(membername, member)` pairs of the members of *self.object*. - - If *want_all* is True, return all members. Else, only return those - members given by *self.options.members* (which may also be None). - """ - msg = 'must be implemented in subclasses' - raise NotImplementedError(msg) - - def filter_members( - self, members: list[ObjectMember], want_all: bool - ) -> list[tuple[str, Any, bool]]: - """Filter the given member list. - - Members are skipped if - - - they are private (except if given explicitly or the private-members - option is set) - - they are special methods (except if given explicitly or the - special-members option is set) - - they are undocumented (except if the undoc-members option is set) - - The user can override the skipping decision by connecting to the - ``autodoc-skip-member`` event. - """ - - def is_filtered_inherited_member(name: str, obj: Any) -> bool: - inherited_members = self.options.inherited_members or set() - seen = set() - - if inspect.isclass(self.object): - for cls in self.object.__mro__: - if name in cls.__dict__: - seen.add(cls) - if ( - cls.__name__ in inherited_members - and cls != self.object - and any( - issubclass(potential_child, cls) for potential_child in seen - ) - ): - # given member is a member of specified *super class* - return True - if name in cls.__dict__: - return False - if name in self.get_attr(cls, '__annotations__', {}): - return False - if isinstance(obj, ObjectMember) and obj.class_ is cls: - return False - - return False - - ret = [] - - # search for members in source code too - namespace = '.'.join(self.objpath) # will be empty for modules - - if self.analyzer: - attr_docs = self.analyzer.find_attr_docs() - else: - attr_docs = {} - - # process members and determine which to skip - for obj in members: - membername = obj.__name__ - member = obj.object - - # if isattr is True, the member is documented as an attribute - isattr = member is INSTANCEATTR or (namespace, membername) in attr_docs - - try: - doc = getdoc( - member, - self.get_attr, - self.config.autodoc_inherit_docstrings, - self.object, - membername, - ) - if not isinstance(doc, str): - # Ignore non-string __doc__ - doc = None - - # if the member __doc__ is the same as self's __doc__, it's just - # inherited and therefore not the member's doc - cls = self.get_attr(member, '__class__', None) - if cls: - cls_doc = self.get_attr(cls, '__doc__', None) - if cls_doc == doc: - doc = None - - if isinstance(obj, ObjectMember) and obj.docstring: - # hack for ClassDocumenter to inject docstring via ObjectMember - doc = obj.docstring - - doc, metadata = separate_metadata(doc) - has_doc = bool(doc) - - if 'private' in metadata: - # consider a member private if docstring has "private" metadata - isprivate = True - elif 'public' in metadata: - # consider a member public if docstring has "public" metadata - isprivate = False - else: - isprivate = membername.startswith('_') - - keep = False - if ismock(member) and (namespace, membername) not in attr_docs: - # mocked module or object - pass - elif ( - self.options.exclude_members - and membername in self.options.exclude_members - ): - # remove members given by exclude-members - keep = False - elif want_all and special_member_re.match(membername): - # special __methods__ - if ( - self.options.special_members - and membername in self.options.special_members - ): - if membername == '__doc__': # NoQA: SIM114 - keep = False - elif is_filtered_inherited_member(membername, obj): - keep = False - else: - keep = has_doc or self.options.undoc_members - else: - keep = False - elif (namespace, membername) in attr_docs: - if want_all and isprivate: - if self.options.private_members is None: - keep = False - else: - keep = membername in self.options.private_members - else: - # keep documented attributes - keep = True - elif want_all and isprivate: - if has_doc or self.options.undoc_members: - if self.options.private_members is None: # NoQA: SIM114 - keep = False - elif is_filtered_inherited_member(membername, obj): - keep = False - else: - keep = membername in self.options.private_members - else: - keep = False - else: - if self.options.members is ALL and is_filtered_inherited_member( - membername, obj - ): - keep = False - else: - # ignore undocumented members if :undoc-members: is not given - keep = has_doc or self.options.undoc_members - - if isinstance(obj, ObjectMember) and obj.skipped: - # forcedly skipped member (ex. a module attribute not defined in __all__) - keep = False - - # give the user a chance to decide whether this member - # should be skipped - if self._events is not None: - # let extensions preprocess docstrings - skip_user = self._events.emit_firstresult( - 'autodoc-skip-member', - self.objtype, - membername, - member, - not keep, - self.options, - ) - if skip_user is not None: - keep = not skip_user - except Exception as exc: - logger.warning( - __( - 'autodoc: failed to determine %s.%s (%r) to be documented, ' - 'the following exception was raised:\n%s' - ), - self.name, - membername, - member, - exc, - type='autodoc', - ) - keep = False - - if keep: - ret.append((membername, member, isattr)) - - return ret - - def document_members(self, all_members: bool = False) -> None: - """Generate reST for member documentation. - - If *all_members* is True, document all members, else those given by - *self.options.members*. - """ - # set current namespace for finding members - self._current_document.autodoc_module = self.modname - if self.objpath: - self._current_document.autodoc_class = self.objpath[0] - - want_all = ( - all_members or self.options.inherited_members or self.options.members is ALL - ) - # find out which members are documentable - members_check_module, members = self.get_object_members(want_all) - - # document non-skipped members - member_documenters: list[tuple[Documenter, bool]] = [] - for mname, member, isattr in self.filter_members(members, want_all): - classes = [ - cls - for cls in self.documenters.values() - if cls.can_document_member(member, mname, isattr, self) - ] - if not classes: - # don't know how to document this member - continue - # prefer the documenter with the highest priority - classes.sort(key=lambda cls: cls.priority) - # give explicitly separated module name, so that members - # of inner classes can be documented - full_mname = f'{self.modname}::' + '.'.join((*self.objpath, mname)) - documenter = classes[-1](self.directive, full_mname, self.indent) - member_documenters.append((documenter, isattr)) - - member_order = self.options.member_order or self.config.autodoc_member_order - # We now try to import all objects before ordering them. This is to - # avoid possible circular imports if we were to import objects after - # their associated documenters have been sorted. - member_documenters = [ - (documenter, isattr) - for documenter, isattr in member_documenters - if documenter.parse_name() and documenter.import_object() - ] - member_documenters = self.sort_members(member_documenters, member_order) - - for documenter, isattr in member_documenters: - assert documenter.modname - # We can directly call ._generate() since the documenters - # already called parse_name() and import_object() before. - # - # Note that those two methods above do not emit events, so - # whatever objects we deduced should not have changed. - documenter._generate( - all_members=True, - real_modname=self.real_modname, - check_module=members_check_module and not isattr, - ) - - # reset current objects - self._current_document.autodoc_module = '' - self._current_document.autodoc_class = '' - - def sort_members( - self, documenters: list[tuple[Documenter, bool]], order: str - ) -> list[tuple[Documenter, bool]]: - """Sort the given member list.""" - if order == 'groupwise': - # sort by group; alphabetically within groups - documenters.sort(key=lambda e: (e[0].member_order, e[0].name)) - elif order == 'bysource': - # By default, member discovery order matches source order, - # as dicts are insertion-ordered from Python 3.7. - if self.analyzer: - # sort by source order, by virtue of the module analyzer - tagorder = self.analyzer.tagorder - - def keyfunc(entry: tuple[Documenter, bool]) -> int: - fullname = entry[0].name.split('::')[1] - return tagorder.get(fullname, len(tagorder)) - - documenters.sort(key=keyfunc) - else: # alphabetical - documenters.sort(key=lambda e: e[0].name) - - return documenters - - def generate( - self, - more_content: StringList | None = None, - real_modname: str | None = None, - check_module: bool = False, - all_members: bool = False, - ) -> None: - """Generate reST for the object given by *self.name*, and possibly for - its members. - - If *more_content* is given, include that content. If *real_modname* is - given, use that module name to find attribute docs. If *check_module* is - True, only generate if the object is defined in the module name it is - imported from. If *all_members* is True, document all members. - """ - if not self.parse_name(): - # need a module to import - logger.warning( - __( - "don't know which module to import for autodocumenting " - '%r (try placing a "module" or "currentmodule" directive ' - 'in the document, or giving an explicit module name)' - ), - self.name, - type='autodoc', - ) - return - - # now, import the module and get object to document - if not self.import_object(): - return - - self._generate(more_content, real_modname, check_module, all_members) - - def _generate( - self, - more_content: StringList | None = None, - real_modname: str | None = None, - check_module: bool = False, - all_members: bool = False, - ) -> None: - # If there is no real module defined, figure out which to use. - # The real module is used in the module analyzer to look up the module - # where the attribute documentation would actually be found in. - # This is used for situations where you have a module that collects the - # functions and classes of internal submodules. - guess_modname = self.get_real_modname() - self.real_modname: str = real_modname or guess_modname - - # try to also get a source code analyzer for attribute docs - try: - self.analyzer = ModuleAnalyzer.for_module(self.real_modname) - # parse right now, to get PycodeErrors on parsing (results will - # be cached anyway) - self.analyzer.find_attr_docs() - except PycodeError as exc: - logger.debug('[autodoc] module analyzer failed: %s', exc) - # no source file -- e.g. for builtin and C modules - self.analyzer = None - # at least add the module.__file__ as a dependency - if module___file__ := getattr(self.module, '__file__', ''): - self.directive.record_dependencies.add(module___file__) - else: - self.directive.record_dependencies.add(self.analyzer.srcname) - - if self.real_modname != guess_modname: - # Add module to dependency list if target object is defined in other module. - try: - analyzer = ModuleAnalyzer.for_module(guess_modname) - self.directive.record_dependencies.add(analyzer.srcname) - except PycodeError: - pass - - docstrings: list[str] = functools.reduce( - operator.iadd, self.get_doc() or [], [] - ) - if ismock(self.object) and not docstrings: - logger.warning( - __('A mocked object is detected: %r'), - self.name, - type='autodoc', - subtype='mocked_object', - ) - - # check __module__ of object (for members not given explicitly) - if check_module: - if not self.check_module(): - return - - sourcename = self.get_sourcename() - - # make sure that the result starts with an empty line. This is - # necessary for some situations where another directive preprocesses - # reST and no starting newline is present - self.add_line('', sourcename) - - # format the object's signature, if any - try: - sig = self.format_signature() - except Exception as exc: - logger.warning( - __('error while formatting signature for %s: %s'), - self.fullname, - exc, - type='autodoc', - ) - return - - # generate the directive header and options, if applicable - self.add_directive_header(sig) - self.add_line('', sourcename) - - # e.g. the module directive doesn't have content - self.indent += self.content_indent - - # add all content (from docstrings, attribute docs etc.) - self.add_content(more_content) - - # document members, if possible - self.document_members(all_members) - - -class ModuleDocumenter(Documenter): - """Specialized Documenter subclass for modules.""" - - objtype = 'module' - content_indent = '' - _extra_indent = ' ' - - option_spec: ClassVar[OptionSpec] = { - 'members': members_option, - 'undoc-members': bool_option, - 'no-index': bool_option, - 'no-index-entry': bool_option, - 'inherited-members': inherited_members_option, - 'show-inheritance': bool_option, - 'synopsis': identity, - 'platform': identity, - 'deprecated': bool_option, - 'member-order': member_order_option, - 'exclude-members': exclude_members_option, - 'private-members': members_option, - 'special-members': members_option, - 'imported-members': bool_option, - 'ignore-module-all': bool_option, - 'no-value': bool_option, - 'noindex': bool_option, - } - - def __init__(self, *args: Any) -> None: - super().__init__(*args) - merge_members_option(self.options) - self.__all__: Sequence[str] | None = None - - def add_content(self, more_content: StringList | None) -> None: - old_indent = self.indent - self.indent += self._extra_indent - super().add_content(None) - self.indent = old_indent - if more_content: - for line, src in zip(more_content.data, more_content.items, strict=True): - self.add_line(line, src[0], src[1]) - - @classmethod - def can_document_member( - cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any - ) -> bool: - # don't document submodules automatically - return False - - def resolve_name( - self, modname: str | None, parents: Any, path: str, base: str - ) -> tuple[str | None, list[str]]: - if modname is not None: - logger.warning( - __('"::" in automodule name doesn\'t make sense'), type='autodoc' - ) - return (path or '') + base, [] - - def parse_name(self) -> bool: - ret = super().parse_name() - if self.args or self.retann: - logger.warning( - __('signature arguments or return annotation given for automodule %s'), - self.fullname, - type='autodoc', - ) - return ret - - def import_object(self, raiseerror: bool = False) -> bool: - ret = super().import_object(raiseerror) - - try: - if not self.options.ignore_module_all: - self.__all__ = inspect.getall(self.object) - except ValueError as exc: - # invalid __all__ found. - logger.warning( - __( - '__all__ should be a list of strings, not %r ' - '(in module %s) -- ignoring __all__' - ), - exc.args[0], - self.fullname, - type='autodoc', - ) - - return ret - - def add_directive_header(self, sig: str) -> None: - Documenter.add_directive_header(self, sig) - - sourcename = self.get_sourcename() - - # add some module-specific options - if self.options.synopsis: - self.add_line(' :synopsis: ' + self.options.synopsis, sourcename) - if self.options.platform: - self.add_line(' :platform: ' + self.options.platform, sourcename) - if self.options.deprecated: - self.add_line(' :deprecated:', sourcename) - if self.options.no_index_entry: - self.add_line(' :no-index-entry:', sourcename) - - def get_module_members(self) -> dict[str, ObjectMember]: - """Get members of target module.""" - if self.analyzer: - attr_docs = self.analyzer.attr_docs - else: - attr_docs = {} - - members: dict[str, ObjectMember] = {} - for name in dir(self.object): - try: - value = safe_getattr(self.object, name, None) - if ismock(value): - value = undecorate(value) - docstring = attr_docs.get(('', name), []) - members[name] = ObjectMember( - name, value, docstring='\n'.join(docstring) - ) - except AttributeError: - continue - - # annotation only member (ex. attr: int) - for name in inspect.getannotations(self.object): - if name not in members: - docstring = attr_docs.get(('', name), []) - members[name] = ObjectMember( - name, INSTANCEATTR, docstring='\n'.join(docstring) - ) - - return members - - def get_object_members(self, want_all: bool) -> tuple[bool, list[ObjectMember]]: - members = self.get_module_members() - if want_all: - if self.__all__ is None: - # for implicit module members, check __module__ to avoid - # documenting imported objects - return True, list(members.values()) - else: - for member in members.values(): - if member.__name__ not in self.__all__: - member.skipped = True - - return False, list(members.values()) - else: - memberlist = self.options.members or [] - ret = [] - for name in memberlist: - if name in members: - ret.append(members[name]) - else: - logger.warning( - __( - 'missing attribute mentioned in :members: option: ' - 'module %s, attribute %s' - ), - safe_getattr(self.object, '__name__', '???'), - name, - type='autodoc', - ) - return False, ret - - def sort_members( - self, documenters: list[tuple[Documenter, bool]], order: str - ) -> list[tuple[Documenter, bool]]: - if order == 'bysource' and self.__all__: - assert self.__all__ is not None - module_all = self.__all__ - module_all_set = set(module_all) - module_all_len = len(module_all) - - # Sort alphabetically first (for members not listed on the __all__) - documenters.sort(key=lambda e: e[0].name) - - # Sort by __all__ - def keyfunc(entry: tuple[Documenter, bool]) -> int: - name = entry[0].name.split('::')[1] - if name in module_all_set: - return module_all.index(name) - else: - return module_all_len - - documenters.sort(key=keyfunc) - - return documenters - else: - return super().sort_members(documenters, order) - - -class ModuleLevelDocumenter(Documenter): - """Specialized Documenter subclass for objects on module level (functions, - classes, data/constants). - """ - - def resolve_name( - self, modname: str | None, parents: Any, path: str, base: str - ) -> tuple[str | None, list[str]]: - if modname is not None: - return modname, [*parents, base] - if path: - modname = path.rstrip('.') - return modname, [*parents, base] - - # if documenting a toplevel object without explicit module, - # it can be contained in another auto directive ... - modname = self._current_document.autodoc_module - # ... or in the scope of a module directive - if not modname: - modname = self.env.ref_context.get('py:module') - # ... else, it stays None, which means invalid - return modname, [*parents, base] - - -class ClassLevelDocumenter(Documenter): - """Specialized Documenter subclass for objects on class level (methods, - attributes). - """ - - def resolve_name( - self, modname: str | None, parents: Any, path: str, base: str - ) -> tuple[str | None, list[str]]: - if modname is not None: - return modname, [*parents, base] - - if path: - mod_cls = path.rstrip('.') - else: - # if documenting a class-level object without path, - # there must be a current class, either from a parent - # auto directive ... - mod_cls = self._current_document.autodoc_class - # ... or from a class directive - if not mod_cls: - mod_cls = self.env.ref_context.get('py:class', '') - # ... if still falsy, there's no way to know - if not mod_cls: - return None, [] - modname, sep, cls = mod_cls.rpartition('.') - parents = [cls] - # if the module name is still missing, get it like above - if not modname: - modname = self._current_document.autodoc_module - if not modname: - modname = self.env.ref_context.get('py:module') - # ... else, it stays None, which means invalid - return modname, [*parents, base] - - -class DocstringSignatureMixin: - """Mixin for FunctionDocumenter and MethodDocumenter to provide the - feature of reading the signature from the docstring. - """ - - _new_docstrings: list[list[str]] | None = None - _signatures: list[str] = [] - - def _find_signature(self) -> tuple[str | None, str | None] | None: - # candidates of the object name - valid_names = [self.objpath[-1]] # type: ignore[attr-defined] - if isinstance(self, ClassDocumenter): - valid_names.append('__init__') - if hasattr(self.object, '__mro__'): - valid_names.extend(cls.__name__ for cls in self.object.__mro__) - - docstrings = self.get_doc() - if docstrings is None: - return None, None - self._new_docstrings = docstrings[:] - self._signatures = [] - result = None - for i, doclines in enumerate(docstrings): - for j, line in enumerate(doclines): - if not line: - # no lines in docstring, no match - break - - if line.endswith('\\'): - line = line.rstrip('\\').rstrip() - - # match first line of docstring against signature RE - match = py_ext_sig_re.match(line) - if not match: - break - exmod, path, base, tp_list, args, retann = match.groups() - - # the base name must match ours - if base not in valid_names: - break - - # re-prepare docstring to ignore more leading indentation - directive = self.directive # type: ignore[attr-defined] - tab_width = directive.state.document.settings.tab_width - self._new_docstrings[i] = prepare_docstring( - '\n'.join(doclines[j + 1 :]), tab_width - ) - - if result is None: - # first signature - result = args, retann - else: - # subsequent signatures - self._signatures.append(f'({args}) -> {retann}') - - if result is not None: - # finish the loop when signature found - break - - return result - - def get_doc(self) -> list[list[str]] | None: - if self._new_docstrings is not None: - return self._new_docstrings - return super().get_doc() # type: ignore[misc] - - def format_signature(self, **kwargs: Any) -> str: - self.args: str | None - if self.args is None and self.config.autodoc_docstring_signature: # type: ignore[attr-defined] - # only act if a signature is not explicitly given already, and if - # the feature is enabled - result = self._find_signature() - if result is not None: - self.args, self.retann = result - sig = super().format_signature(**kwargs) # type: ignore[misc] - if self._signatures: - return '\n'.join((sig, *self._signatures)) - else: - return sig - - -class DocstringStripSignatureMixin(DocstringSignatureMixin): - """Mixin for AttributeDocumenter to provide the - feature of stripping any function signature from the docstring. - """ - - def format_signature(self, **kwargs: Any) -> str: - if self.args is None and self.config.autodoc_docstring_signature: # type: ignore[attr-defined] - # only act if a signature is not explicitly given already, and if - # the feature is enabled - result = self._find_signature() - if result is not None: - # Discarding _args is a only difference with - # DocstringSignatureMixin.format_signature. - # Documenter.format_signature use self.args value to format. - _args, self.retann = result - return super().format_signature(**kwargs) - - -class FunctionDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter): # type: ignore[misc] - """Specialized Documenter subclass for functions.""" - - objtype = 'function' - member_order = 30 - - @classmethod - def can_document_member( - cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any - ) -> bool: - # supports functions, builtins and bound methods exported at the module level - return ( - inspect.isfunction(member) - or inspect.isbuiltin(member) - or (inspect.isroutine(member) and isinstance(parent, ModuleDocumenter)) - ) - - def format_args(self, **kwargs: Any) -> str: - if self.config.autodoc_typehints in {'none', 'description'}: - kwargs.setdefault('show_annotation', False) - if self.config.autodoc_typehints_format == 'short': - kwargs.setdefault('unqualified_typehints', True) - if self.config.python_display_short_literal_types: - kwargs.setdefault('short_literals', True) - - try: - self._events.emit('autodoc-before-process-signature', self.object, False) - sig = inspect.signature( - self.object, type_aliases=self.config.autodoc_type_aliases - ) - args = stringify_signature(sig, **kwargs) - except TypeError as exc: - logger.warning( - __('Failed to get a function signature for %s: %s'), self.fullname, exc - ) - return '' - except ValueError: - args = '' - - if self.config.strip_signature_backslash: - # escape backslashes for reST - args = args.replace('\\', '\\\\') - return args - - def document_members(self, all_members: bool = False) -> None: - pass - - def add_directive_header(self, sig: str) -> None: - sourcename = self.get_sourcename() - super().add_directive_header(sig) - - is_coro = inspect.iscoroutinefunction(self.object) - is_acoro = inspect.isasyncgenfunction(self.object) - if is_coro or is_acoro: - self.add_line(' :async:', sourcename) - - def format_signature(self, **kwargs: Any) -> str: - if self.config.autodoc_typehints_format == 'short': - kwargs.setdefault('unqualified_typehints', True) - if self.config.python_display_short_literal_types: - kwargs.setdefault('short_literals', True) - - sigs = [] - if ( - self.analyzer - and '.'.join(self.objpath) in self.analyzer.overloads - and self.config.autodoc_typehints != 'none' - ): - # Use signatures for overloaded functions instead of the implementation function. - overloaded = True - else: - overloaded = False - sig = super().format_signature(**kwargs) - sigs.append(sig) - - if inspect.is_singledispatch_function(self.object): - # append signature of singledispatch'ed functions - for typ, func in self.object.registry.items(): - if typ is object: - pass # default implementation. skipped. - else: - dispatchfunc = self.annotate_to_first_argument(func, typ) - if dispatchfunc: - documenter = FunctionDocumenter(self.directive, '') - documenter.object = dispatchfunc - documenter.objpath = [''] - sigs.append(documenter.format_signature()) - if overloaded and self.analyzer is not None: - actual = inspect.signature( - self.object, type_aliases=self.config.autodoc_type_aliases - ) - __globals__ = safe_getattr(self.object, '__globals__', {}) - for overload in self.analyzer.overloads['.'.join(self.objpath)]: - overload = self.merge_default_value(actual, overload) - overload = evaluate_signature( - overload, __globals__, self.config.autodoc_type_aliases - ) - - sig = stringify_signature(overload, **kwargs) - sigs.append(sig) - - return '\n'.join(sigs) - - def merge_default_value(self, actual: Signature, overload: Signature) -> Signature: - """Merge default values of actual implementation to the overload variants.""" - parameters = list(overload.parameters.values()) - for i, param in enumerate(parameters): - actual_param = actual.parameters.get(param.name) - if actual_param and param.default == '...': - parameters[i] = param.replace(default=actual_param.default) - - return overload.replace(parameters=parameters) - - def annotate_to_first_argument( - self, func: Callable[..., Any], typ: type - ) -> Callable[..., Any] | None: - """Annotate type hint to the first argument of function if needed.""" - try: - sig = inspect.signature(func, type_aliases=self.config.autodoc_type_aliases) - except TypeError as exc: - logger.warning( - __('Failed to get a function signature for %s: %s'), self.fullname, exc - ) - return None - except ValueError: - return None - - if len(sig.parameters) == 0: - return None - - def dummy(): # type: ignore[no-untyped-def] # NoQA: ANN202 - pass - - params = list(sig.parameters.values()) - if params[0].annotation is Parameter.empty: - params[0] = params[0].replace(annotation=typ) - try: - dummy.__signature__ = sig.replace(parameters=params) # type: ignore[attr-defined] - return dummy - except (AttributeError, TypeError): - # failed to update signature (ex. built-in or extension types) - return None - - return func - - -class DecoratorDocumenter(FunctionDocumenter): - """Specialized Documenter subclass for decorator functions.""" - - objtype = 'decorator' - - # must be lower than FunctionDocumenter - priority = -1 - - def format_args(self, **kwargs: Any) -> str: - args = super().format_args(**kwargs) - if ',' in args: - return args - else: - return '' - - -# Types which have confusing metaclass signatures it would be best not to show. -# These are listed by name, rather than storing the objects themselves, to avoid -# needing to import the modules. -_METACLASS_CALL_BLACKLIST = frozenset({ - 'enum.EnumType.__call__', -}) - - -# Types whose __new__ signature is a pass-through. -_CLASS_NEW_BLACKLIST = frozenset({ - 'typing.Generic.__new__', -}) - - -class ClassDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter): # type: ignore[misc] - """Specialized Documenter subclass for classes.""" - - objtype = 'class' - member_order = 20 - option_spec: ClassVar[OptionSpec] = { - 'members': members_option, - 'undoc-members': bool_option, - 'no-index': bool_option, - 'no-index-entry': bool_option, - 'inherited-members': inherited_members_option, - 'show-inheritance': bool_option, - 'member-order': member_order_option, - 'exclude-members': exclude_members_option, - 'private-members': members_option, - 'special-members': members_option, - 'class-doc-from': class_doc_from_option, - 'noindex': bool_option, - } - - # Must be higher than FunctionDocumenter, ClassDocumenter, and - # AttributeDocumenter as NewType can be an attribute and is a class - # after Python 3.10. - priority = 15 - - _signature_class: Any = None - _signature_method_name: str = '' - - def __init__(self, *args: Any) -> None: - super().__init__(*args) - - if self.config.autodoc_class_signature == 'separated': - self.options = self.options.copy() - - # show __init__() method - if self.options.special_members is None: - self.options['special-members'] = ['__new__', '__init__'] - else: - self.options.special_members.append('__new__') - self.options.special_members.append('__init__') - - merge_members_option(self.options) - - @classmethod - def can_document_member( - cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any - ) -> bool: - return isinstance(member, type) or ( - isattr and isinstance(member, NewType | TypeVar) - ) - - def import_object(self, raiseerror: bool = False) -> bool: - ret = super().import_object(raiseerror) - # if the class is documented under another name, document it - # as data/attribute - if ret: - if hasattr(self.object, '__name__'): - self.doc_as_attr = self.objpath[-1] != self.object.__name__ - else: - self.doc_as_attr = True - if isinstance(self.object, NewType | TypeVar): - modname = getattr(self.object, '__module__', self.modname) - if modname != self.modname and self.modname.startswith(modname): - bases = self.modname[len(modname) :].strip('.').split('.') - self.objpath = bases + self.objpath - self.modname = modname - return ret - - def _get_signature(self) -> tuple[Any | None, str | None, Signature | None]: - if isinstance(self.object, NewType | TypeVar): - # Suppress signature - return None, None, None - - def get_user_defined_function_or_method(obj: Any, attr: str) -> Any: - """Get the `attr` function or method from `obj`, if it is user-defined.""" - if inspect.is_builtin_class_method(obj, attr): - return None - attr = self.get_attr(obj, attr, None) - if not (inspect.ismethod(attr) or inspect.isfunction(attr)): - return None - return attr - - # This sequence is copied from inspect._signature_from_callable. - # ValueError means that no signature could be found, so we keep going. - - # First, we check if obj has a __signature__ attribute - if hasattr(self.object, '__signature__'): - object_sig = self.object.__signature__ - if isinstance(object_sig, Signature): - return None, None, object_sig - if sys.version_info[:2] in {(3, 12), (3, 13)} and callable(object_sig): - # Support for enum.Enum.__signature__ in Python 3.12 - if isinstance(object_sig_str := object_sig(), str): - return None, None, inspect.signature_from_str(object_sig_str) - - # Next, let's see if it has an overloaded __call__ defined - # in its metaclass - call = get_user_defined_function_or_method(type(self.object), '__call__') - - if call is not None: - if f'{call.__module__}.{call.__qualname__}' in _METACLASS_CALL_BLACKLIST: - call = None - - if call is not None: - self._events.emit('autodoc-before-process-signature', call, True) - try: - sig = inspect.signature( - call, - bound_method=True, - type_aliases=self.config.autodoc_type_aliases, - ) - return type(self.object), '__call__', sig - except ValueError: - pass - - # Now we check if the 'obj' class has a '__new__' method - new = get_user_defined_function_or_method(self.object, '__new__') - - if new is not None: - if f'{new.__module__}.{new.__qualname__}' in _CLASS_NEW_BLACKLIST: - new = None - - if new is not None: - self._events.emit('autodoc-before-process-signature', new, True) - try: - sig = inspect.signature( - new, - bound_method=True, - type_aliases=self.config.autodoc_type_aliases, - ) - return self.object, '__new__', sig - except ValueError: - pass - - # Finally, we should have at least __init__ implemented - init = get_user_defined_function_or_method(self.object, '__init__') - if init is not None: - self._events.emit('autodoc-before-process-signature', init, True) - try: - sig = inspect.signature( - init, - bound_method=True, - type_aliases=self.config.autodoc_type_aliases, - ) - return self.object, '__init__', sig - except ValueError: - pass - - # None of the attributes are user-defined, so fall back to let inspect - # handle it. - # We don't know the exact method that inspect.signature will read - # the signature from, so just pass the object itself to our hook. - self._events.emit('autodoc-before-process-signature', self.object, False) - try: - sig = inspect.signature( - self.object, - bound_method=False, - type_aliases=self.config.autodoc_type_aliases, - ) - return None, None, sig - except ValueError: - pass - - # Still no signature: happens e.g. for old-style classes - # with __init__ in C and no `__text_signature__`. - return None, None, None - - def format_args(self, **kwargs: Any) -> str: - if self.config.autodoc_typehints in {'none', 'description'}: - kwargs.setdefault('show_annotation', False) - if self.config.autodoc_typehints_format == 'short': - kwargs.setdefault('unqualified_typehints', True) - if self.config.python_display_short_literal_types: - kwargs.setdefault('short_literals', True) - - try: - self._signature_class, _signature_method_name, sig = self._get_signature() - except TypeError as exc: - # __signature__ attribute contained junk - logger.warning( - __('Failed to get a constructor signature for %s: %s'), - self.fullname, - exc, - ) - return '' - self._signature_method_name = _signature_method_name or '' - - if sig is None: - return '' - - return stringify_signature(sig, show_return_annotation=False, **kwargs) - - def _find_signature(self) -> tuple[str | None, str | None] | None: - result = super()._find_signature() - if result is not None: - # Strip a return value from signature of constructor in docstring (first entry) - result = (result[0], None) - - for i, sig in enumerate(self._signatures): - if sig.endswith(' -> None'): - # Strip a return value from signatures of constructor in docstring (subsequent - # entries) - self._signatures[i] = sig[:-8] - - return result - - def format_signature(self, **kwargs: Any) -> str: - if self.doc_as_attr: - return '' - if self.config.autodoc_class_signature == 'separated': - # do not show signatures - return '' - - if self.config.autodoc_typehints_format == 'short': - kwargs.setdefault('unqualified_typehints', True) - if self.config.python_display_short_literal_types: - kwargs.setdefault('short_literals', True) - - sig = super().format_signature() - sigs = [] - - overloads = self.get_overloaded_signatures() - if overloads and self.config.autodoc_typehints != 'none': - # Use signatures for overloaded methods instead of the implementation method. - method = safe_getattr( - self._signature_class, self._signature_method_name, None - ) - __globals__ = safe_getattr(method, '__globals__', {}) - for overload in overloads: - overload = evaluate_signature( - overload, __globals__, self.config.autodoc_type_aliases - ) - - parameters = list(overload.parameters.values()) - overload = overload.replace( - parameters=parameters[1:], return_annotation=Parameter.empty - ) - sig = stringify_signature(overload, **kwargs) - sigs.append(sig) - else: - sigs.append(sig) - - return '\n'.join(sigs) - - def get_overloaded_signatures(self) -> list[Signature]: - if self._signature_class and self._signature_method_name: - for cls in self._signature_class.__mro__: - try: - analyzer = ModuleAnalyzer.for_module(cls.__module__) - analyzer.analyze() - qualname = f'{cls.__qualname__}.{self._signature_method_name}' - if qualname in analyzer.overloads: - return analyzer.overloads.get(qualname, []) - elif qualname in analyzer.tagorder: - # the constructor is defined in the class, but not overridden. - return [] - except PycodeError: - pass - - return [] - - def get_canonical_fullname(self) -> str | None: - __modname__ = safe_getattr(self.object, '__module__', self.modname) - __qualname__ = safe_getattr(self.object, '__qualname__', None) - if __qualname__ is None: - __qualname__ = safe_getattr(self.object, '__name__', None) - if __qualname__ and '' in __qualname__: - # No valid qualname found if the object is defined as locals - __qualname__ = None - - if __modname__ and __qualname__: - return f'{__modname__}.{__qualname__}' - else: - return None - - def add_directive_header(self, sig: str) -> None: - sourcename = self.get_sourcename() - - if self.doc_as_attr: - self.directivetype = 'attribute' - super().add_directive_header(sig) - - if isinstance(self.object, NewType | TypeVar): - return - - if self.analyzer and '.'.join(self.objpath) in self.analyzer.finals: - self.add_line(' :final:', sourcename) - - canonical_fullname = self.get_canonical_fullname() - if ( - not self.doc_as_attr - and not isinstance(self.object, NewType) - and canonical_fullname - and self.fullname != canonical_fullname - ): - self.add_line(' :canonical: %s' % canonical_fullname, sourcename) - - # add inheritance info, if wanted - if not self.doc_as_attr and self.options.show_inheritance: - if inspect.getorigbases(self.object): - # A subclass of generic types - # refs: PEP-560 - bases = list(self.object.__orig_bases__) - elif hasattr(self.object, '__bases__') and len(self.object.__bases__): - # A normal class - bases = list(self.object.__bases__) - else: - bases = [] - - self._events.emit( - 'autodoc-process-bases', self.fullname, self.object, self.options, bases - ) - - mode = _get_render_mode(self.config.autodoc_typehints_format) - base_classes = [restify(cls, mode=mode) for cls in bases] - - sourcename = self.get_sourcename() - self.add_line('', sourcename) - self.add_line(' ' + _('Bases: %s') % ', '.join(base_classes), sourcename) - - def get_object_members(self, want_all: bool) -> tuple[bool, list[ObjectMember]]: - members = get_class_members( - self.object, - self.objpath, - self.get_attr, - self.config.autodoc_inherit_docstrings, - ) - if not want_all: - if not self.options.members: - return False, [] - # specific members given - selected = [] - for name in self.options.members: - if name in members: - selected.append(members[name]) - else: - logger.warning( - __('missing attribute %s in object %s'), - name, - self.fullname, - type='autodoc', - ) - return False, selected - elif self.options.inherited_members: - return False, list(members.values()) - else: - return False, [m for m in members.values() if m.class_ == self.object] - - def get_doc(self) -> list[list[str]] | None: - if isinstance(self.object, TypeVar): - if self.object.__doc__ == TypeVar.__doc__: - return [] - if self.doc_as_attr: - # Don't show the docstring of the class when it is an alias. - if self.get_variable_comment(): - return [] - else: - return None - - lines = getattr(self, '_new_docstrings', None) - if lines is not None: - return lines - - classdoc_from = self.options.get( - 'class-doc-from', self.config.autoclass_content - ) - - docstrings = [] - attrdocstring = getdoc(self.object, self.get_attr) - if attrdocstring: - docstrings.append(attrdocstring) - - # for classes, what the "docstring" is can be controlled via a - # config value; the default is only the class docstring - if classdoc_from in {'both', 'init'}: - __init__ = self.get_attr(self.object, '__init__', None) - initdocstring = getdoc( - __init__, - self.get_attr, - self.config.autodoc_inherit_docstrings, - self.object, - '__init__', - ) - # for new-style classes, no __init__ means default __init__ - if initdocstring is not None and ( - initdocstring == object.__init__.__doc__ # for pypy - or initdocstring.strip() == object.__init__.__doc__ # for !pypy - ): - initdocstring = None - if not initdocstring: - # try __new__ - __new__ = self.get_attr(self.object, '__new__', None) - initdocstring = getdoc( - __new__, - self.get_attr, - self.config.autodoc_inherit_docstrings, - self.object, - '__new__', - ) - # for new-style classes, no __new__ means default __new__ - if initdocstring is not None and ( - initdocstring == object.__new__.__doc__ # for pypy - or initdocstring.strip() == object.__new__.__doc__ # for !pypy - ): - initdocstring = None - if initdocstring: - if classdoc_from == 'init': - docstrings = [initdocstring] - else: - docstrings.append(initdocstring) - - tab_width = self.directive.state.document.settings.tab_width - return [prepare_docstring(docstring, tab_width) for docstring in docstrings] - - def get_variable_comment(self) -> list[str] | None: - try: - key = ('', '.'.join(self.objpath)) - if self.doc_as_attr: - analyzer = ModuleAnalyzer.for_module(self.modname) - else: - analyzer = ModuleAnalyzer.for_module(self.get_real_modname()) - analyzer.analyze() - return list(analyzer.attr_docs.get(key, [])) - except PycodeError: - return None - - def add_content(self, more_content: StringList | None) -> None: - mode = _get_render_mode(self.config.autodoc_typehints_format) - short_literals = self.config.python_display_short_literal_types - - if isinstance(self.object, NewType): - supertype = restify(self.object.__supertype__, mode=mode) - - more_content = StringList([_('alias of %s') % supertype, ''], source='') - if isinstance(self.object, TypeVar): - attrs = [repr(self.object.__name__)] - attrs.extend( - stringify_annotation(constraint, mode, short_literals=short_literals) - for constraint in self.object.__constraints__ - ) - if self.object.__bound__: - bound = restify(self.object.__bound__, mode=mode) - attrs.append(r'bound=\ ' + bound) - if self.object.__covariant__: - attrs.append('covariant=True') - if self.object.__contravariant__: - attrs.append('contravariant=True') - - more_content = StringList( - [_('alias of TypeVar(%s)') % ', '.join(attrs), ''], source='' - ) - if self.doc_as_attr and self.modname != self.get_real_modname(): - try: - # override analyzer to obtain doccomment around its definition. - self.analyzer = ModuleAnalyzer.for_module(self.modname) - self.analyzer.analyze() - except PycodeError: - pass - - if self.doc_as_attr and not self.get_variable_comment(): - try: - alias = restify(self.object, mode=mode) - more_content = StringList([_('alias of %s') % alias], source='') - except AttributeError: - pass # Invalid class object is passed. - - super().add_content(more_content) - - def document_members(self, all_members: bool = False) -> None: - if self.doc_as_attr: - return - super().document_members(all_members) - - def generate( - self, - more_content: StringList | None = None, - real_modname: str | None = None, - check_module: bool = False, - all_members: bool = False, - ) -> None: - # Do not pass real_modname and use the name from the __module__ - # attribute of the class. - # If a class gets imported into the module real_modname - # the analyzer won't find the source of the class, if - # it looks in real_modname. - return super().generate( - more_content=more_content, - check_module=check_module, - all_members=all_members, - ) - - -class ExceptionDocumenter(ClassDocumenter): - """Specialized ClassDocumenter subclass for exceptions.""" - - objtype = 'exception' - member_order = 10 - - # needs a higher priority than ClassDocumenter - priority = ClassDocumenter.priority + 5 - - @classmethod - def can_document_member( - cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any - ) -> bool: - try: - return isinstance(member, type) and issubclass(member, BaseException) - except TypeError as exc: - # It's possible for a member to be considered a type, but fail - # issubclass checks due to not being a class. For example: - # https://github.com/sphinx-doc/sphinx/issues/11654#issuecomment-1696790436 - msg = ( - f'{cls.__name__} failed to discern if member {member} with' - f' membername {membername} is a BaseException subclass.' - ) - raise ValueError(msg) from exc - - -class DataDocumenterMixinBase: - # define types of instance variables - config: Config - env: BuildEnvironment - modname: str - parent: Any - object: Any - objpath: list[str] - - def should_suppress_directive_header(self) -> bool: - """Check directive header should be suppressed.""" - return False - - def should_suppress_value_header(self) -> bool: - """Check :value: header should be suppressed.""" - return False - - def update_content(self, more_content: StringList) -> None: - """Update docstring, for example with TypeVar variance.""" - pass - - -class GenericAliasMixin(DataDocumenterMixinBase): - """Mixin for DataDocumenter and AttributeDocumenter to provide the feature for - supporting GenericAliases. - """ - - def should_suppress_directive_header(self) -> bool: - return ( - inspect.isgenericalias(self.object) - or super().should_suppress_directive_header() - ) - - def update_content(self, more_content: StringList) -> None: - if inspect.isgenericalias(self.object): - mode = _get_render_mode(self.config.autodoc_typehints_format) - alias = restify(self.object, mode=mode) - - more_content.append(_('alias of %s') % alias, '') - more_content.append('', '') - - super().update_content(more_content) - - -class UninitializedGlobalVariableMixin(DataDocumenterMixinBase): - """Mixin for DataDocumenter to provide the feature for supporting uninitialized - (type annotation only) global variables. - """ - - def import_object(self, raiseerror: bool = False) -> bool: - try: - return super().import_object(raiseerror=True) # type: ignore[misc] - except ImportError as exc: - # annotation only instance variable (PEP-526) - try: - with mock(self.config.autodoc_mock_imports): - parent = import_module(self.modname) - annotations = get_type_hints( - parent, - None, - self.config.autodoc_type_aliases, - include_extras=True, - ) - if self.objpath[-1] in annotations: - self.object = UNINITIALIZED_ATTR - self.parent = parent - return True - except ImportError: - pass - - if raiseerror: - raise - logger.warning(exc.args[0], type='autodoc', subtype='import_object') - self.env.note_reread() - return False - - def should_suppress_value_header(self) -> bool: - return ( - self.object is UNINITIALIZED_ATTR or super().should_suppress_value_header() - ) - - def get_doc(self) -> list[list[str]] | None: - if self.object is UNINITIALIZED_ATTR: - return [] - else: - return super().get_doc() # type: ignore[misc] - - -class DataDocumenter( - GenericAliasMixin, UninitializedGlobalVariableMixin, ModuleLevelDocumenter -): - """Specialized Documenter subclass for data items.""" - - objtype = 'data' - member_order = 40 - priority = -10 - option_spec: ClassVar[OptionSpec] = dict(ModuleLevelDocumenter.option_spec) - option_spec['annotation'] = annotation_option - option_spec['no-value'] = bool_option - - @classmethod - def can_document_member( - cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any - ) -> bool: - return isinstance(parent, ModuleDocumenter) and isattr - - def update_annotations(self, parent: Any) -> None: - """Update __annotations__ to support type_comment and so on.""" - annotations = dict(inspect.getannotations(parent)) - parent.__annotations__ = annotations - - try: - analyzer = ModuleAnalyzer.for_module(self.modname) - analyzer.analyze() - for (classname, attrname), annotation in analyzer.annotations.items(): - if not classname and attrname not in annotations: - annotations[attrname] = annotation - except PycodeError: - pass - - def import_object(self, raiseerror: bool = False) -> bool: - ret = super().import_object(raiseerror) - if self.parent: - self.update_annotations(self.parent) - - return ret - - def should_suppress_value_header(self) -> bool: - if super().should_suppress_value_header(): - return True - else: - doc = self.get_doc() or [] - docstring, metadata = separate_metadata( - '\n'.join(functools.reduce(operator.iadd, doc, [])) - ) - if 'hide-value' in metadata: - return True - - return False - - def add_directive_header(self, sig: str) -> None: - super().add_directive_header(sig) - sourcename = self.get_sourcename() - if ( - self.options.annotation is SUPPRESS - or self.should_suppress_directive_header() - ): - pass - elif self.options.annotation: - self.add_line(' :annotation: %s' % self.options.annotation, sourcename) - else: - if self.config.autodoc_typehints != 'none': - # obtain annotation for this data - annotations = get_type_hints( - self.parent, - None, - self.config.autodoc_type_aliases, - include_extras=True, - ) - if self.objpath[-1] in annotations: - mode = _get_render_mode(self.config.autodoc_typehints_format) - short_literals = self.config.python_display_short_literal_types - objrepr = stringify_annotation( - annotations.get(self.objpath[-1]), - mode, - short_literals=short_literals, - ) - self.add_line(' :type: ' + objrepr, sourcename) - - try: - if ( - self.options.no_value - or self.should_suppress_value_header() - or ismock(self.object) - ): - pass - else: - objrepr = object_description(self.object) - self.add_line(' :value: ' + objrepr, sourcename) - except ValueError: - pass - - def document_members(self, all_members: bool = False) -> None: - pass - - def get_real_modname(self) -> str: - real_modname = self.get_attr(self.parent or self.object, '__module__', None) - return real_modname or self.modname - - def get_module_comment(self, attrname: str) -> list[str] | None: - try: - analyzer = ModuleAnalyzer.for_module(self.modname) - analyzer.analyze() - key = ('', attrname) - if key in analyzer.attr_docs: - return list(analyzer.attr_docs[key]) - except PycodeError: - pass - - return None - - def get_doc(self) -> list[list[str]] | None: - # Check the variable has a docstring-comment - comment = self.get_module_comment(self.objpath[-1]) - if comment: - return [comment] - else: - return super().get_doc() - - def add_content(self, more_content: StringList | None) -> None: - # Disable analyzing variable comment on Documenter.add_content() to control it on - # DataDocumenter.add_content() - self.analyzer = None - - if not more_content: - more_content = StringList() - - self.update_content(more_content) - super().add_content(more_content) - - -class MethodDocumenter(DocstringSignatureMixin, ClassLevelDocumenter): # type: ignore[misc] - """Specialized Documenter subclass for methods (normal, static and class).""" - - objtype = 'method' - directivetype = 'method' - member_order = 50 - priority = 1 # must be more than FunctionDocumenter - - @classmethod - def can_document_member( - cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any - ) -> bool: - return inspect.isroutine(member) and not isinstance(parent, ModuleDocumenter) - - def import_object(self, raiseerror: bool = False) -> bool: - ret = super().import_object(raiseerror) - if not ret: - return ret - - # to distinguish classmethod/staticmethod - obj = self.parent.__dict__.get(self.object_name, self.object) - if inspect.isstaticmethod(obj, cls=self.parent, name=self.object_name): - # document static members before regular methods - self.member_order -= 1 - elif inspect.isclassmethod(obj): - # document class methods before static methods as - # they usually behave as alternative constructors - self.member_order -= 2 - return ret - - def format_args(self, **kwargs: Any) -> str: - if self.config.autodoc_typehints in {'none', 'description'}: - kwargs.setdefault('show_annotation', False) - if self.config.autodoc_typehints_format == 'short': - kwargs.setdefault('unqualified_typehints', True) - if self.config.python_display_short_literal_types: - kwargs.setdefault('short_literals', True) - - try: - if self.object == object.__init__ and self.parent != object: # NoQA: E721 - # Classes not having own __init__() method are shown as no arguments. - # - # Note: The signature of object.__init__() is (self, /, *args, **kwargs). - # But it makes users confused. - args = '()' - else: - if inspect.isstaticmethod( - self.object, cls=self.parent, name=self.object_name - ): - self._events.emit( - 'autodoc-before-process-signature', self.object, False - ) - sig = inspect.signature( - self.object, - bound_method=False, - type_aliases=self.config.autodoc_type_aliases, - ) - else: - self._events.emit( - 'autodoc-before-process-signature', self.object, True - ) - sig = inspect.signature( - self.object, - bound_method=True, - type_aliases=self.config.autodoc_type_aliases, - ) - args = stringify_signature(sig, **kwargs) - except TypeError as exc: - logger.warning( - __('Failed to get a method signature for %s: %s'), self.fullname, exc - ) - return '' - except ValueError: - args = '' - - if self.config.strip_signature_backslash: - # escape backslashes for reST - args = args.replace('\\', '\\\\') - return args - - def add_directive_header(self, sig: str) -> None: - super().add_directive_header(sig) - - sourcename = self.get_sourcename() - obj = self.parent.__dict__.get(self.object_name, self.object) - if inspect.isabstractmethod(obj): - self.add_line(' :abstractmethod:', sourcename) - if inspect.iscoroutinefunction(obj) or inspect.isasyncgenfunction(obj): - self.add_line(' :async:', sourcename) - if ( - inspect.is_classmethod_like(obj) - or inspect.is_singledispatch_method(obj) - and inspect.is_classmethod_like(obj.func) - ): - self.add_line(' :classmethod:', sourcename) - if inspect.isstaticmethod(obj, cls=self.parent, name=self.object_name): - self.add_line(' :staticmethod:', sourcename) - if self.analyzer and '.'.join(self.objpath) in self.analyzer.finals: - self.add_line(' :final:', sourcename) - - def document_members(self, all_members: bool = False) -> None: - pass - - def format_signature(self, **kwargs: Any) -> str: - if self.config.autodoc_typehints_format == 'short': - kwargs.setdefault('unqualified_typehints', True) - if self.config.python_display_short_literal_types: - kwargs.setdefault('short_literals', True) - - sigs = [] - if ( - self.analyzer - and '.'.join(self.objpath) in self.analyzer.overloads - and self.config.autodoc_typehints != 'none' - ): - # Use signatures for overloaded methods instead of the implementation method. - overloaded = True - else: - overloaded = False - sig = super().format_signature(**kwargs) - sigs.append(sig) - - meth = self.parent.__dict__.get(self.objpath[-1]) - if inspect.is_singledispatch_method(meth): - # append signature of singledispatch'ed functions - for typ, func in meth.dispatcher.registry.items(): - if typ is object: - pass # default implementation. skipped. - else: - if inspect.isclassmethod(func): - func = func.__func__ - dispatchmeth = self.annotate_to_first_argument(func, typ) - if dispatchmeth: - documenter = MethodDocumenter(self.directive, '') - documenter.parent = self.parent - documenter.object = dispatchmeth - documenter.objpath = [''] - sigs.append(documenter.format_signature()) - if overloaded and self.analyzer is not None: - if inspect.isstaticmethod( - self.object, cls=self.parent, name=self.object_name - ): - actual = inspect.signature( - self.object, - bound_method=False, - type_aliases=self.config.autodoc_type_aliases, - ) - else: - actual = inspect.signature( - self.object, - bound_method=True, - type_aliases=self.config.autodoc_type_aliases, - ) - - __globals__ = safe_getattr(self.object, '__globals__', {}) - for overload in self.analyzer.overloads['.'.join(self.objpath)]: - overload = self.merge_default_value(actual, overload) - overload = evaluate_signature( - overload, __globals__, self.config.autodoc_type_aliases - ) - - if not inspect.isstaticmethod( - self.object, cls=self.parent, name=self.object_name - ): - parameters = list(overload.parameters.values()) - overload = overload.replace(parameters=parameters[1:]) - sig = stringify_signature(overload, **kwargs) - sigs.append(sig) - - return '\n'.join(sigs) - - def merge_default_value(self, actual: Signature, overload: Signature) -> Signature: - """Merge default values of actual implementation to the overload variants.""" - parameters = list(overload.parameters.values()) - for i, param in enumerate(parameters): - actual_param = actual.parameters.get(param.name) - if actual_param and param.default == '...': - parameters[i] = param.replace(default=actual_param.default) - - return overload.replace(parameters=parameters) - - def annotate_to_first_argument( - self, func: Callable[..., Any], typ: type - ) -> Callable[..., Any] | None: - """Annotate type hint to the first argument of function if needed.""" - try: - sig = inspect.signature(func, type_aliases=self.config.autodoc_type_aliases) - except TypeError as exc: - logger.warning( - __('Failed to get a method signature for %s: %s'), self.fullname, exc - ) - return None - except ValueError: - return None - - if len(sig.parameters) == 1: - return None - - def dummy(): # type: ignore[no-untyped-def] # NoQA: ANN202 - pass - - params = list(sig.parameters.values()) - if params[1].annotation is Parameter.empty: - params[1] = params[1].replace(annotation=typ) - try: - dummy.__signature__ = sig.replace( # type: ignore[attr-defined] - parameters=params - ) - return dummy - except (AttributeError, TypeError): - # failed to update signature (ex. built-in or extension types) - return None - - return func - - def get_doc(self) -> list[list[str]] | None: - if self._new_docstrings is not None: - # docstring already returned previously, then modified by - # `DocstringSignatureMixin`. Just return the previously-computed - # result, so that we don't lose the processing done by - # `DocstringSignatureMixin`. - return self._new_docstrings - if self.objpath[-1] == '__init__': - docstring = getdoc( - self.object, - self.get_attr, - self.config.autodoc_inherit_docstrings, - self.parent, - self.object_name, - ) - if docstring is not None and ( - docstring == object.__init__.__doc__ # for pypy - or docstring.strip() == object.__init__.__doc__ # for !pypy - ): - docstring = None - if docstring: - tab_width = self.directive.state.document.settings.tab_width - return [prepare_docstring(docstring, tabsize=tab_width)] - else: - return [] - elif self.objpath[-1] == '__new__': - docstring = getdoc( - self.object, - self.get_attr, - self.config.autodoc_inherit_docstrings, - self.parent, - self.object_name, - ) - if docstring is not None and ( - docstring == object.__new__.__doc__ # for pypy - or docstring.strip() == object.__new__.__doc__ # for !pypy - ): - docstring = None - if docstring: - tab_width = self.directive.state.document.settings.tab_width - return [prepare_docstring(docstring, tabsize=tab_width)] - else: - return [] - else: - return super().get_doc() - - -class NonDataDescriptorMixin(DataDocumenterMixinBase): - """Mixin for AttributeDocumenter to provide the feature for supporting non - data-descriptors. - - .. note:: This mix-in must be inherited after other mix-ins. Otherwise, docstring - and :value: header will be suppressed unexpectedly. - """ - - def import_object(self, raiseerror: bool = False) -> bool: - ret = super().import_object(raiseerror) # type: ignore[misc] - if ret and not inspect.isattributedescriptor(self.object): - self.non_data_descriptor = True - else: - self.non_data_descriptor = False - - return ret - - def should_suppress_value_header(self) -> bool: - return ( - not getattr(self, 'non_data_descriptor', False) - or super().should_suppress_directive_header() - ) - - def get_doc(self) -> list[list[str]] | None: - if getattr(self, 'non_data_descriptor', False): - # the docstring of non datadescriptor is very probably the wrong thing - # to display - return None - else: - return super().get_doc() # type: ignore[misc] - - -class SlotsMixin(DataDocumenterMixinBase): - """Mixin for AttributeDocumenter to provide the feature for supporting __slots__.""" - - def isslotsattribute(self) -> bool: - """Check the subject is an attribute in __slots__.""" - try: - if parent___slots__ := inspect.getslots(self.parent): - return self.objpath[-1] in parent___slots__ - else: - return False - except (ValueError, TypeError): - return False - - def import_object(self, raiseerror: bool = False) -> bool: - ret = super().import_object(raiseerror) # type: ignore[misc] - if self.isslotsattribute(): - self.object = SLOTSATTR - - return ret - - def should_suppress_value_header(self) -> bool: - if self.object is SLOTSATTR: - return True - else: - return super().should_suppress_value_header() - - def get_doc(self) -> list[list[str]] | None: - if self.object is SLOTSATTR: - try: - parent___slots__ = inspect.getslots(self.parent) - if parent___slots__ and ( - docstring := parent___slots__.get(self.objpath[-1]) - ): - docstring = prepare_docstring(docstring) - return [docstring] - else: - return [] - except ValueError as exc: - logger.warning( - __('Invalid __slots__ found on %s. Ignored.'), - (self.parent.__qualname__, exc), - type='autodoc', - ) - return [] - else: - return super().get_doc() # type: ignore[misc] - - -class RuntimeInstanceAttributeMixin(DataDocumenterMixinBase): - """Mixin for AttributeDocumenter to provide the feature for supporting runtime - instance attributes (that are defined in __init__() methods with doc-comments). - - Example:: - - class Foo: - def __init__(self): - self.attr = None #: This is a target of this mix-in. - """ - - RUNTIME_INSTANCE_ATTRIBUTE = object() - - def is_runtime_instance_attribute(self, parent: Any) -> bool: - """Check the subject is an attribute defined in __init__().""" - # An instance variable defined in __init__(). - if self.get_attribute_comment(parent, self.objpath[-1]): # type: ignore[attr-defined] - return True - return self.is_runtime_instance_attribute_not_commented(parent) - - def is_runtime_instance_attribute_not_commented(self, parent: Any) -> bool: - """Check the subject is an attribute defined in __init__() without comment.""" - for cls in inspect.getmro(parent): - try: - module = safe_getattr(cls, '__module__') - qualname = safe_getattr(cls, '__qualname__') - - analyzer = ModuleAnalyzer.for_module(module) - analyzer.analyze() - if qualname and self.objpath: - key = f'{qualname}.{self.objpath[-1]}' - if key in analyzer.tagorder: - return True - except (AttributeError, PycodeError): - pass - - return False - - def import_object(self, raiseerror: bool = False) -> bool: - """Check the existence of runtime instance attribute after failing to import the - attribute. - """ - try: - return super().import_object(raiseerror=True) # type: ignore[misc] - except ImportError as exc: - try: - with mock(self.config.autodoc_mock_imports): - ret = import_object( - self.modname, - self.objpath[:-1], - 'class', - attrgetter=self.get_attr, # type: ignore[attr-defined] - ) - parent = ret[3] - if self.is_runtime_instance_attribute(parent): - self.object = self.RUNTIME_INSTANCE_ATTRIBUTE - self.parent = parent - return True - except ImportError: - pass - - if raiseerror: - raise - logger.warning(exc.args[0], type='autodoc', subtype='import_object') - self.env.note_reread() - return False - - def should_suppress_value_header(self) -> bool: - return ( - self.object is self.RUNTIME_INSTANCE_ATTRIBUTE - or super().should_suppress_value_header() - ) - - def get_doc(self) -> list[list[str]] | None: - if ( - self.object is self.RUNTIME_INSTANCE_ATTRIBUTE - and self.is_runtime_instance_attribute_not_commented(self.parent) - ): - return None - else: - return super().get_doc() # type: ignore[misc] - - -class UninitializedInstanceAttributeMixin(DataDocumenterMixinBase): - """Mixin for AttributeDocumenter to provide the feature for supporting uninitialized - instance attributes (PEP-526 styled, annotation only attributes). - - Example:: - - class Foo: - attr: int #: This is a target of this mix-in. - """ - - def is_uninitialized_instance_attribute(self, parent: Any) -> bool: - """Check the subject is an annotation only attribute.""" - annotations = get_type_hints( - parent, None, self.config.autodoc_type_aliases, include_extras=True - ) - return self.objpath[-1] in annotations - - def import_object(self, raiseerror: bool = False) -> bool: - """Check the existence of uninitialized instance attribute when failed to import - the attribute. - """ - try: - return super().import_object(raiseerror=True) # type: ignore[misc] - except ImportError as exc: - try: - ret = import_object( - self.modname, - self.objpath[:-1], - 'class', - attrgetter=self.get_attr, # type: ignore[attr-defined] - ) - parent = ret[3] - if self.is_uninitialized_instance_attribute(parent): - self.object = UNINITIALIZED_ATTR - self.parent = parent - return True - except ImportError: - pass - - if raiseerror: - raise - logger.warning(exc.args[0], type='autodoc', subtype='import_object') - self.env.note_reread() - return False - - def should_suppress_value_header(self) -> bool: - return ( - self.object is UNINITIALIZED_ATTR or super().should_suppress_value_header() - ) - - def get_doc(self) -> list[list[str]] | None: - if self.object is UNINITIALIZED_ATTR: - return None - return super().get_doc() # type: ignore[misc] - - -class AttributeDocumenter( # type: ignore[misc] +import sphinx +from sphinx.config import ENUM +from sphinx.ext.autodoc._directive import AutodocDirective +from sphinx.ext.autodoc._dynamic._importer import ( + _import_module as import_module, +) +from sphinx.ext.autodoc._dynamic._mock import ismock, mock, undecorate +from sphinx.ext.autodoc._event_listeners import between, cut_lines +from sphinx.ext.autodoc._legacy_class_based._directive_options import ( + Options, + annotation_option, + bool_option, + class_doc_from_option, + exclude_members_option, + identity, + inherited_members_option, + member_order_option, + members_option, + merge_members_option, +) +from sphinx.ext.autodoc._legacy_class_based._documenters import ( + AttributeDocumenter, + ClassDocumenter, + ClassLevelDocumenter, + DataDocumenter, + DataDocumenterMixinBase, + DecoratorDocumenter, + DocstringSignatureMixin, + DocstringStripSignatureMixin, + Documenter, + ExceptionDocumenter, + FunctionDocumenter, GenericAliasMixin, - SlotsMixin, + MethodDocumenter, + ModuleDocumenter, + ModuleLevelDocumenter, + NonDataDescriptorMixin, + ObjectMember, + PropertyDocumenter, RuntimeInstanceAttributeMixin, + SlotsMixin, + UninitializedGlobalVariableMixin, UninitializedInstanceAttributeMixin, - NonDataDescriptorMixin, - DocstringStripSignatureMixin, - ClassLevelDocumenter, -): - """Specialized Documenter subclass for attributes.""" - - objtype = 'attribute' - member_order = 60 - option_spec: ClassVar[OptionSpec] = dict(ModuleLevelDocumenter.option_spec) - option_spec['annotation'] = annotation_option - option_spec['no-value'] = bool_option - - # must be higher than the MethodDocumenter, else it will recognize - # some non-data descriptors as methods - priority = 10 - - @staticmethod - def is_function_or_method(obj: Any) -> bool: - return ( - inspect.isfunction(obj) or inspect.isbuiltin(obj) or inspect.ismethod(obj) - ) - - @classmethod - def can_document_member( - cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any - ) -> bool: - if isinstance(parent, ModuleDocumenter): - return False - if inspect.isattributedescriptor(member): - return True - return not inspect.isroutine(member) and not isinstance(member, type) - - def document_members(self, all_members: bool = False) -> None: - pass - - def update_annotations(self, parent: Any) -> None: - """Update __annotations__ to support type_comment and so on.""" - try: - annotations = dict(inspect.getannotations(parent)) - parent.__annotations__ = annotations - - for cls in inspect.getmro(parent): - try: - module = safe_getattr(cls, '__module__') - qualname = safe_getattr(cls, '__qualname__') - - analyzer = ModuleAnalyzer.for_module(module) - analyzer.analyze() - anns = analyzer.annotations - for (classname, attrname), annotation in anns.items(): - if classname == qualname and attrname not in annotations: - annotations[attrname] = annotation - except (AttributeError, PycodeError): - pass - except (AttributeError, TypeError): - # Failed to set __annotations__ (built-in, extensions, etc.) - pass - - def import_object(self, raiseerror: bool = False) -> bool: - ret = super().import_object(raiseerror) - if inspect.isenumattribute(self.object): - self.object = self.object.value - if self.parent: - self.update_annotations(self.parent) - - return ret - - def get_real_modname(self) -> str: - real_modname = self.get_attr(self.parent or self.object, '__module__', None) - return real_modname or self.modname - - def should_suppress_value_header(self) -> bool: - if super().should_suppress_value_header(): - return True - else: - doc = self.get_doc() - if doc: - docstring, metadata = separate_metadata( - '\n'.join(functools.reduce(operator.iadd, doc, [])) - ) - if 'hide-value' in metadata: - return True - - return False - - def add_directive_header(self, sig: str) -> None: - super().add_directive_header(sig) - sourcename = self.get_sourcename() - if ( - self.options.annotation is SUPPRESS - or self.should_suppress_directive_header() - ): - pass - elif self.options.annotation: - self.add_line(' :annotation: %s' % self.options.annotation, sourcename) - else: - if self.config.autodoc_typehints != 'none': - # obtain type annotation for this attribute - annotations = get_type_hints( - self.parent, - None, - self.config.autodoc_type_aliases, - include_extras=True, - ) - if self.objpath[-1] in annotations: - mode = _get_render_mode(self.config.autodoc_typehints_format) - short_literals = self.config.python_display_short_literal_types - objrepr = stringify_annotation( - annotations.get(self.objpath[-1]), - mode, - short_literals=short_literals, - ) - self.add_line(' :type: ' + objrepr, sourcename) - - try: - if ( - self.options.no_value - or self.should_suppress_value_header() - or ismock(self.object) - ): - pass - else: - objrepr = object_description(self.object) - self.add_line(' :value: ' + objrepr, sourcename) - except ValueError: - pass - - def get_attribute_comment(self, parent: Any, attrname: str) -> list[str] | None: - for cls in inspect.getmro(parent): - try: - module = safe_getattr(cls, '__module__') - qualname = safe_getattr(cls, '__qualname__') - - analyzer = ModuleAnalyzer.for_module(module) - analyzer.analyze() - if qualname and self.objpath: - key = (qualname, attrname) - if key in analyzer.attr_docs: - return list(analyzer.attr_docs[key]) - except (AttributeError, PycodeError): - pass - - return None - - def get_doc(self) -> list[list[str]] | None: - # Check the attribute has a docstring-comment - comment = self.get_attribute_comment(self.parent, self.objpath[-1]) - if comment: - return [comment] - - try: - # Disable `autodoc_inherit_docstring` temporarily to avoid to obtain - # a docstring from the value which descriptor returns unexpectedly. - # See: https://github.com/sphinx-doc/sphinx/issues/7805 - orig = self.config.autodoc_inherit_docstrings - self.config.autodoc_inherit_docstrings = False - return super().get_doc() - finally: - self.config.autodoc_inherit_docstrings = orig - - def add_content(self, more_content: StringList | None) -> None: - # Disable analyzing attribute comment on Documenter.add_content() to control it on - # AttributeDocumenter.add_content() - self.analyzer = None - - if more_content is None: - more_content = StringList() - self.update_content(more_content) - super().add_content(more_content) - - -class PropertyDocumenter(DocstringStripSignatureMixin, ClassLevelDocumenter): # type: ignore[misc] - """Specialized Documenter subclass for properties.""" - - objtype = 'property' - member_order = 60 - - # before AttributeDocumenter - priority = AttributeDocumenter.priority + 1 - - @classmethod - def can_document_member( - cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any - ) -> bool: - if isinstance(parent, ClassDocumenter): - if inspect.isproperty(member): - return True - else: - __dict__ = safe_getattr(parent.object, '__dict__', {}) - obj = __dict__.get(membername) - return isinstance(obj, classmethod) and inspect.isproperty(obj.__func__) - else: - return False - - def import_object(self, raiseerror: bool = False) -> bool: - """Check the existence of uninitialized instance attribute when failed to import - the attribute. - """ - ret = super().import_object(raiseerror) - if ret and not inspect.isproperty(self.object): - __dict__ = safe_getattr(self.parent, '__dict__', {}) - obj = __dict__.get(self.objpath[-1]) - if isinstance(obj, classmethod) and inspect.isproperty(obj.__func__): - self.object = obj.__func__ - self.isclassmethod: bool = True - return True - else: - return False - - self.isclassmethod = False - return ret - - def format_args(self, **kwargs: Any) -> str: - func = self._get_property_getter() - if func is None: - return '' - - # update the annotations of the property getter - self._events.emit('autodoc-before-process-signature', func, False) - # correctly format the arguments for a property - return super().format_args(**kwargs) - - def document_members(self, all_members: bool = False) -> None: - pass - - def get_real_modname(self) -> str: - real_modname = self.get_attr(self.parent or self.object, '__module__', None) - return real_modname or self.modname - - def add_directive_header(self, sig: str) -> None: - super().add_directive_header(sig) - sourcename = self.get_sourcename() - if inspect.isabstractmethod(self.object): - self.add_line(' :abstractmethod:', sourcename) - if self.isclassmethod: - self.add_line(' :classmethod:', sourcename) - - func = self._get_property_getter() - if func is None or self.config.autodoc_typehints == 'none': - return - - try: - signature = inspect.signature( - func, type_aliases=self.config.autodoc_type_aliases - ) - if signature.return_annotation is not Parameter.empty: - mode = _get_render_mode(self.config.autodoc_typehints_format) - short_literals = self.config.python_display_short_literal_types - objrepr = stringify_annotation( - signature.return_annotation, mode, short_literals=short_literals - ) - self.add_line(' :type: ' + objrepr, sourcename) - except TypeError as exc: - logger.warning( - __('Failed to get a function signature for %s: %s'), self.fullname, exc - ) - pass - except ValueError: - pass - - def _get_property_getter(self) -> Callable[..., Any] | None: - if safe_getattr(self.object, 'fget', None): # property - return self.object.fget - if safe_getattr(self.object, 'func', None): # cached_property - return self.object.func - return None - - -def autodoc_attrgetter( - obj: Any, name: str, *defargs: Any, registry: SphinxComponentRegistry -) -> Any: - """Alternative getattr() for types""" - for typ, func in registry.autodoc_attrgetters.items(): - if isinstance(obj, typ): - return func(obj, name, *defargs) + autodoc_attrgetter, + py_ext_sig_re, + special_member_re, +) +from sphinx.ext.autodoc._legacy_class_based._sentinels import ( + ALL, + EMPTY, + INSTANCEATTR, + SLOTSATTR, + SUPPRESS, + UNINITIALIZED_ATTR, +) +from sphinx.ext.autodoc.importer import get_class_members, import_object +from sphinx.ext.autodoc.typehints import _merge_typehints - return safe_getattr(obj, name, *defargs) +if TYPE_CHECKING: + from sphinx.application import Sphinx + from sphinx.config import Config + from sphinx.ext.autodoc._property_types import _AutodocObjType + from sphinx.util.typing import ExtensionMetadata + +__all__ = ( + # Useful event listener factories for autodoc-process-docstring + 'cut_lines', + 'between', + # Documenters + 'AttributeDocumenter', + 'ClassDocumenter', + 'DataDocumenter', + 'DecoratorDocumenter', + 'ExceptionDocumenter', + 'FunctionDocumenter', + 'MethodDocumenter', + 'ModuleDocumenter', + 'PropertyDocumenter', + # This class is only used in ``sphinx.ext.autodoc.directive``, + # but we export it here for compatibility. + # See: https://github.com/sphinx-doc/sphinx/issues/4538 + 'Options', + # Option spec functions. + # Exported for compatibility. + 'annotation_option', + 'bool_option', + 'class_doc_from_option', + 'exclude_members_option', + 'identity', + 'inherited_members_option', + 'member_order_option', + 'members_option', + 'merge_members_option', + # Sentinels. + # Exported for compatibility. + 'ALL', + 'EMPTY', + 'INSTANCEATTR', + 'SLOTSATTR', + 'SUPPRESS', + 'UNINITIALIZED_ATTR', + # Miscellaneous other names. + # Exported for compatibility. + 'ObjectMember', + 'py_ext_sig_re', + 'special_member_re', + 'ModuleLevelDocumenter', + 'ClassLevelDocumenter', + 'DocstringSignatureMixin', + 'DocstringStripSignatureMixin', + 'DataDocumenterMixinBase', + 'GenericAliasMixin', + 'UninitializedGlobalVariableMixin', + 'NonDataDescriptorMixin', + 'SlotsMixin', + 'RuntimeInstanceAttributeMixin', + 'UninitializedInstanceAttributeMixin', + 'autodoc_attrgetter', + 'Documenter', + 'get_class_members', + 'import_module', + 'import_object', + 'ismock', + 'mock', + 'undecorate', +) def setup(app: Sphinx) -> ExtensionMetadata: - app.add_autodocumenter(ModuleDocumenter) - app.add_autodocumenter(ClassDocumenter) - app.add_autodocumenter(ExceptionDocumenter) - app.add_autodocumenter(DataDocumenter) - app.add_autodocumenter(FunctionDocumenter) - app.add_autodocumenter(DecoratorDocumenter) - app.add_autodocumenter(MethodDocumenter) - app.add_autodocumenter(AttributeDocumenter) - app.add_autodocumenter(PropertyDocumenter) - app.add_config_value( 'autoclass_content', 'class', @@ -3208,17 +186,68 @@ def setup(app: Sphinx) -> ExtensionMetadata: app.add_config_value( 'autodoc_inherit_docstrings', True, 'env', types=frozenset({bool}) ) + app.add_config_value( + 'autodoc_preserve_defaults', False, 'env', types=frozenset({bool}) + ) + app.add_config_value( + 'autodoc_use_type_comments', True, 'env', types=frozenset({bool}) + ) + app.add_config_value( + 'autodoc_use_legacy_class_based', False, 'env', types=frozenset({bool}) + ) + app.add_event('autodoc-before-process-signature') app.add_event('autodoc-process-docstring') app.add_event('autodoc-process-signature') app.add_event('autodoc-skip-member') app.add_event('autodoc-process-bases') - app.setup_extension('sphinx.ext.autodoc.preserve_defaults') - app.setup_extension('sphinx.ext.autodoc.type_comment') - app.setup_extension('sphinx.ext.autodoc.typehints') + app.connect('object-description-transform', _merge_typehints) + + app.connect('config-inited', _register_directives) return { 'version': sphinx.__display_version__, 'parallel_read_safe': True, } + + +def _register_directives(app: Sphinx, config: Config) -> None: + if not config.autodoc_use_legacy_class_based: + obj_type: _AutodocObjType + for obj_type in ( + 'module', + 'class', + 'exception', + 'function', + 'decorator', + 'method', + 'property', + 'attribute', + 'data', + 'type', + ): + # register the automodule, autoclass, etc. directives + app.add_directive(f'auto{obj_type}', AutodocDirective) + else: + from sphinx.ext.autodoc.preserve_defaults import update_defvalue + from sphinx.ext.autodoc.type_comment import ( + update_annotations_using_type_comments, + ) + from sphinx.ext.autodoc.typehints import record_typehints + + app.add_autodocumenter(ModuleDocumenter) + app.add_autodocumenter(ClassDocumenter) + app.add_autodocumenter(ExceptionDocumenter) + app.add_autodocumenter(DataDocumenter) + app.add_autodocumenter(FunctionDocumenter) + app.add_autodocumenter(DecoratorDocumenter) + app.add_autodocumenter(MethodDocumenter) + app.add_autodocumenter(AttributeDocumenter) + app.add_autodocumenter(PropertyDocumenter) + + app.connect('autodoc-before-process-signature', update_defvalue) + app.connect( + 'autodoc-before-process-signature', update_annotations_using_type_comments + ) + app.connect('autodoc-process-signature', record_typehints) diff --git a/sphinx/ext/autodoc/_directive.py b/sphinx/ext/autodoc/_directive.py new file mode 100644 index 00000000000..7b90c0a3a88 --- /dev/null +++ b/sphinx/ext/autodoc/_directive.py @@ -0,0 +1,118 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING + +from docutils import nodes + +from sphinx.ext.autodoc._directive_options import _process_documenter_options +from sphinx.ext.autodoc._generate import _auto_document_object +from sphinx.ext.autodoc._shared import LOGGER, _AutodocAttrGetter, _AutodocConfig +from sphinx.util.docutils import SphinxDirective, switch_source_input +from sphinx.util.parsing import nested_parse_to_nodes + +if TYPE_CHECKING: + from collections.abc import Callable + + from docutils.nodes import Node + from docutils.parsers.rst.states import RSTState + from docutils.statemachine import StringList + + from sphinx.ext.autodoc._property_types import _AutodocObjType + + +class DummyOptionSpec(dict[str, 'Callable[[str], str]']): # NoQA: FURB189 + """An option_spec allows any options.""" + + def __bool__(self) -> bool: + """Behaves like some options are defined.""" + return True + + def __getitem__(self, _key: str) -> Callable[[str], str]: + return lambda x: x + + +def parse_generated_content( + state: RSTState, content: StringList, titles_allowed: bool +) -> list[Node]: + """Parse an item of content generated by _auto_document_object().""" + with switch_source_input(state, content): + if titles_allowed: + return nested_parse_to_nodes(state, content) + + node = nodes.paragraph() + # necessary so that the child nodes get the right source/line set + node.document = state.document + state.nested_parse(content, 0, node, match_titles=False) + return node.children + + +class AutodocDirective(SphinxDirective): + """A directive class for all autodoc directives. + + It generates the directive lines for the given object, + then parses and returns the generated content. + """ + + option_spec = DummyOptionSpec() + has_content = True + required_arguments = 1 + optional_arguments = 0 + final_argument_whitespace = True + + def run(self) -> list[Node]: + source, lineno = self.get_source_info() + LOGGER.debug('[autodoc] %s:%s: input:\n%s', source, lineno, self.block_text) + + # get target object type / strip prefix (auto-) + assert self.name.startswith('auto') + objtype: _AutodocObjType = self.name[4:] # type: ignore[assignment] + + env = self.env + + #: true if the generated content may contain titles + titles_allowed = True + + # process the options with the selected object type's option_spec + try: + documenter_options = _process_documenter_options( + obj_type=objtype, + default_options=self.config.autodoc_default_options, + options=self.options, + ) + except (KeyError, ValueError, TypeError) as exc: + # an option is either unknown or has a wrong type + LOGGER.error( # NoQA: TRY400 + 'An option to %s is either unknown or has an invalid value: %s', + self.name, + exc, + exc_info=exc, + location=(env.current_document.docname, lineno), + ) + return [] + documenter_options._tab_width = self.state.document.settings.tab_width + + # record all filenames as dependencies -- this will at least + # partially make automatic invalidation possible + record_dependencies = self.state.document.settings.record_dependencies + + # generate the output + content = _auto_document_object( + name=self.arguments[0], + obj_type=objtype, + current_document=env.current_document, + config=_AutodocConfig.from_config(env.config), + events=env.events, + get_attr=_AutodocAttrGetter(env._registry.autodoc_attrgetters), + more_content=self.content, + options=documenter_options, + # TODO: TYPING: Upstream docutils should expose DependencyList as a MutableSet[str] + record_dependencies=record_dependencies, # type: ignore[arg-type] + ref_context=env.ref_context, + reread_always=env.reread_always, + ) + if not content: + return [] + + LOGGER.debug('[autodoc] output:\n%s', '\n'.join(content)) + + return parse_generated_content(self.state, content, titles_allowed) diff --git a/sphinx/ext/autodoc/_directive_options.py b/sphinx/ext/autodoc/_directive_options.py new file mode 100644 index 00000000000..7eeed79287c --- /dev/null +++ b/sphinx/ext/autodoc/_directive_options.py @@ -0,0 +1,348 @@ +from __future__ import annotations + +import warnings +from typing import TYPE_CHECKING + +from docutils.utils import assemble_option_dict + +from sphinx.deprecation import RemovedInSphinx11Warning +from sphinx.ext.autodoc._sentinels import ALL, EMPTY, SUPPRESS +from sphinx.locale import __ + +if TYPE_CHECKING: + from collections.abc import Iterable, Iterator, Mapping, Set + from typing import Any, Final, Literal, Self + + from sphinx.ext.autodoc._property_types import _AutodocObjType + from sphinx.ext.autodoc._sentinels import ALL_T, EMPTY_T, SUPPRESS_T + from sphinx.util.typing import OptionSpec + + +# common option names for autodoc directives +AUTODOC_DEFAULT_OPTIONS = ( + 'members', + 'undoc-members', + 'no-index', + 'no-index-entry', + 'inherited-members', + 'show-inheritance', + 'private-members', + 'special-members', + 'ignore-module-all', + 'exclude-members', + 'member-order', + 'imported-members', + 'class-doc-from', + 'no-value', +) + +AUTODOC_EXTENDABLE_OPTIONS = frozenset({ + 'members', + 'private-members', + 'special-members', + 'exclude-members', +}) + + +class _AutoDocumenterOptions: + # TODO: make immutable. + + no_index: Literal[True] | None = None + no_index_entry: Literal[True] | None = None + _tab_width: int = 8 + + # module-like options + members: ALL_T | list[str] | None = None + undoc_members: Literal[True] | None = None + inherited_members: Set[str] | None = None + show_inheritance: Literal[True] | None = None + synopsis: str | None = None + platform: str | None = None + deprecated: Literal[True] | None = None + member_order: Literal['alphabetical', 'bysource', 'groupwise'] | None = None + exclude_members: EMPTY_T | set[str] | None = None + private_members: ALL_T | list[str] | None = None + special_members: ALL_T | list[str] | None = None + imported_members: Literal[True] | None = None + ignore_module_all: Literal[True] | None = None + no_value: Literal[True] | None = None + + # class-like options (class, exception) + class_doc_from: Literal['both', 'class', 'init'] | None = None + + # assignment-like (data, attribute) + annotation: SUPPRESS_T | str | None = None + + noindex: Literal[True] | None = None + + def __init__(self, **kwargs: Any) -> None: + vars(self).update(kwargs) + + def __repr__(self) -> str: + args = ', '.join(f'{k}={v!r}' for k, v in vars(self).items()) + return f'_AutoDocumenterOptions({args})' + + def __getattr__(self, name: str) -> object: + return None # return None for missing attributes + + def copy(self) -> Self: + return self.__class__(**vars(self)) + + @classmethod + def from_directive_options(cls, opts: Mapping[str, Any], /) -> Self: + return cls(**{k.replace('-', '_'): v for k, v in opts.items() if v is not None}) + + # Mapping interface: + + def __getitem__(self, item: str) -> Any: + warnings.warn( + 'The mapping interface for autodoc options objects is deprecated, ' + 'and will be removed in Sphinx 11. Use attribute access instead.', + RemovedInSphinx11Warning, + stacklevel=2, + ) + try: + return getattr(self, item) + except AttributeError: + raise KeyError(item) from None + + def __setitem__(self, key: str, value: Any) -> None: + msg = f'{self.__class__.__name__!r} object does not support indexed assignment' + raise TypeError(msg) + + def __delitem__(self, key: str) -> None: + msg = f'{self.__class__.__name__!r} object does not support indexed deletion' + raise TypeError(msg) + + def __contains__(self, item: str) -> bool: + warnings.warn( + 'The mapping interface for autodoc options objects is deprecated, ' + 'and will be removed in Sphinx 11. Use attribute access instead.', + RemovedInSphinx11Warning, + stacklevel=2, + ) + return hasattr(self, item) + + def __keys(self) -> list[str]: + return [key for key in dir(self) if not key.startswith('_')] + + def __iter__(self) -> Iterator[str]: + warnings.warn( + 'The mapping interface for autodoc options objects is deprecated, ' + 'and will be removed in Sphinx 11. Use attribute access instead.', + RemovedInSphinx11Warning, + stacklevel=2, + ) + yield from self.__keys() + + def __len__(self) -> int: + warnings.warn( + 'The mapping interface for autodoc options objects is deprecated, ' + 'and will be removed in Sphinx 11. Use attribute access instead.', + RemovedInSphinx11Warning, + stacklevel=2, + ) + return len(self.__keys()) + + def keys(self) -> Iterable[str]: + warnings.warn( + 'The mapping interface for autodoc options objects is deprecated, ' + 'and will be removed in Sphinx 11. Use attribute access instead.', + RemovedInSphinx11Warning, + stacklevel=2, + ) + yield from self.__keys() + + def items(self) -> Iterable[tuple[str, Any]]: + warnings.warn( + 'The mapping interface for autodoc options objects is deprecated, ' + 'and will be removed in Sphinx 11. Use attribute access instead.', + RemovedInSphinx11Warning, + stacklevel=2, + ) + for key in self.__keys(): + yield key, getattr(self, key) + + def values(self) -> Iterable[Any]: + warnings.warn( + 'The mapping interface for autodoc options objects is deprecated, ' + 'and will be removed in Sphinx 11. Use attribute access instead.', + RemovedInSphinx11Warning, + stacklevel=2, + ) + for key in self.__keys(): + yield getattr(self, key) + + def get(self, key: str, default: Any | None = None) -> Any | None: + warnings.warn( + 'The mapping interface for autodoc options objects is deprecated, ' + 'and will be removed in Sphinx 11. Use attribute access instead.', + RemovedInSphinx11Warning, + stacklevel=2, + ) + try: + return getattr(self, key) + except AttributeError: + return default + + +def identity(x: Any) -> Any: + return x + + +def members_option(arg: str | None) -> ALL_T | list[str] | None: + """Used to convert the :members: option to auto directives.""" + if arg is None or arg is True: + return ALL + if arg is False: + return None + return [stripped for x in arg.split(',') if (stripped := x.strip())] + + +def exclude_members_option(arg: str | None) -> EMPTY_T | set[str]: + """Used to convert the :exclude-members: option.""" + if arg is None or arg is True: + return EMPTY + return {stripped for x in arg.split(',') if (stripped := x.strip())} + + +def inherited_members_option(arg: str | None) -> set[str]: + """Used to convert the :inherited-members: option to auto directives.""" + if arg is None or arg is True: + return {'object'} + if arg: + return {x.strip() for x in arg.split(',')} + return set() + + +def member_order_option( + arg: str | None, +) -> Literal['alphabetical', 'bysource', 'groupwise'] | None: + """Used to convert the :member-order: option to auto directives.""" + if arg is None or arg is True: + return None + if arg in {'alphabetical', 'bysource', 'groupwise'}: + return arg # type: ignore[return-value] + raise ValueError(__('invalid value for member-order option: %s') % arg) + + +def class_doc_from_option(arg: str | None) -> Literal['both', 'class', 'init']: + """Used to convert the :class-doc-from: option to autoclass directives.""" + if arg in {'both', 'class', 'init'}: + return arg # type: ignore[return-value] + raise ValueError(__('invalid value for class-doc-from option: %s') % arg) + + +def annotation_option(arg: str | None) -> SUPPRESS_T | str | Literal[False]: + if arg is None or arg is True: + # suppress showing the representation of the object + return SUPPRESS + return arg + + +def bool_option(arg: str | None) -> bool: + """Used to convert flag options to auto directives. (Instead of + directives.flag(), which returns None). + """ + return True + + +def merge_members_option(options: dict[str, Any]) -> None: + """Merge :private-members: and :special-members: options to the + :members: option. + """ + if options.get('members') is ALL: + # merging is not needed when members: ALL + return + + members = options.setdefault('members', []) + for key in ('private-members', 'special-members'): + other_members = options.get(key) + if other_members is not None and other_members is not ALL: + for member in other_members: + if member not in members: + members.append(member) + + +_OPTION_SPEC_COMMON: Final[OptionSpec] = { + 'no-index': bool_option, + 'no-index-entry': bool_option, +} +_OPTION_SPEC_HAS_MEMBERS: Final[OptionSpec] = _OPTION_SPEC_COMMON | { + 'members': members_option, + 'exclude-members': exclude_members_option, + 'undoc-members': bool_option, + 'private-members': members_option, + 'special-members': members_option, + 'member-order': member_order_option, + 'show-inheritance': bool_option, +} +_OPTION_SPEC_MODULE_SPECIFIC: Final[OptionSpec] = { + 'ignore-module-all': bool_option, + 'imported-members': bool_option, + 'deprecated': bool_option, + 'platform': identity, + 'synopsis': identity, +} +_OPTION_SPEC_CLASS_SPECIFIC: Final[OptionSpec] = { + 'class-doc-from': class_doc_from_option, + 'inherited-members': inherited_members_option, +} +_OPTION_SPEC_ASSIGNMENT: Final[OptionSpec] = _OPTION_SPEC_COMMON | { + 'annotation': annotation_option, + 'no-value': bool_option, +} +_OPTION_SPEC_DEPRECATED: Final[OptionSpec] = { + 'noindex': bool_option, +} +_OPTION_SPEC_FUNCTION_DEF: Final = _OPTION_SPEC_COMMON | _OPTION_SPEC_DEPRECATED +_OPTION_SPECS: Final[Mapping[_AutodocObjType, OptionSpec]] = { + 'module': _OPTION_SPEC_HAS_MEMBERS + | _OPTION_SPEC_MODULE_SPECIFIC + | {'inherited-members': inherited_members_option} # special case + | _OPTION_SPEC_DEPRECATED, + 'class': _OPTION_SPEC_HAS_MEMBERS + | _OPTION_SPEC_CLASS_SPECIFIC + | _OPTION_SPEC_DEPRECATED, + 'exception': _OPTION_SPEC_HAS_MEMBERS + | _OPTION_SPEC_CLASS_SPECIFIC + | _OPTION_SPEC_DEPRECATED, + 'function': _OPTION_SPEC_FUNCTION_DEF, + 'decorator': _OPTION_SPEC_FUNCTION_DEF, + 'method': _OPTION_SPEC_FUNCTION_DEF, + 'property': _OPTION_SPEC_FUNCTION_DEF, + 'attribute': _OPTION_SPEC_ASSIGNMENT | _OPTION_SPEC_DEPRECATED, + 'data': _OPTION_SPEC_ASSIGNMENT | _OPTION_SPEC_DEPRECATED, + 'type': _OPTION_SPEC_ASSIGNMENT, +} + + +def _process_documenter_options( + *, + obj_type: _AutodocObjType, + default_options: Mapping[str, str | bool], + options: dict[str, str | None], +) -> _AutoDocumenterOptions: + """Recognize options of object type from user input.""" + option_spec = _OPTION_SPECS[obj_type] + for name in AUTODOC_DEFAULT_OPTIONS: + if name not in option_spec: + continue + + negated = options.pop(f'no-{name}', True) is None + if name in default_options and not negated: + if name in options and isinstance(default_options[name], str): + # take value from options if present or extend it + # with autodoc_default_options if necessary + if name in AUTODOC_EXTENDABLE_OPTIONS: + opt_value = options[name] + if opt_value is not None and opt_value.startswith('+'): + options[name] = f'{default_options[name]},{opt_value[1:]}' + else: + options[name] = default_options[name] # type: ignore[assignment] + elif (opt_value := options.get(name)) is not None: + # remove '+' from option argument if there's nothing to merge it with + options[name] = opt_value.removeprefix('+') + + opts = assemble_option_dict(options.items(), option_spec) # type: ignore[arg-type] + return _AutoDocumenterOptions.from_directive_options(opts) diff --git a/sphinx/ext/autodoc/_dynamic/__init__.py b/sphinx/ext/autodoc/_dynamic/__init__.py new file mode 100644 index 00000000000..6a6433ae842 --- /dev/null +++ b/sphinx/ext/autodoc/_dynamic/__init__.py @@ -0,0 +1 @@ +"""The dynamic (import-based) backend for autodoc.""" diff --git a/sphinx/ext/autodoc/_dynamic/_docstrings.py b/sphinx/ext/autodoc/_dynamic/_docstrings.py new file mode 100644 index 00000000000..0705631f187 --- /dev/null +++ b/sphinx/ext/autodoc/_dynamic/_docstrings.py @@ -0,0 +1,332 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, TypeVar + +from sphinx.errors import PycodeError +from sphinx.ext.autodoc._dynamic._importer import ( + _get_attribute_comment, + _is_runtime_instance_attribute_not_commented, +) +from sphinx.ext.autodoc._property_types import _ClassDefProperties +from sphinx.ext.autodoc._sentinels import ( + RUNTIME_INSTANCE_ATTRIBUTE, + SLOTS_ATTR, + UNINITIALIZED_ATTR, +) +from sphinx.ext.autodoc._shared import LOGGER +from sphinx.locale import __ +from sphinx.pycode import ModuleAnalyzer +from sphinx.util import inspect +from sphinx.util.docstrings import prepare_docstring +from sphinx.util.inspect import getdoc + +if TYPE_CHECKING: + from collections.abc import Iterator, Mapping + from typing import Any, Literal + + from sphinx.events import EventManager + from sphinx.ext.autodoc._directive_options import _AutoDocumenterOptions + from sphinx.ext.autodoc._property_types import _ItemProperties + from sphinx.ext.autodoc._shared import _AttrGetter + + +def _docstring_lines_for_props( + docstrings: list[list[str]] | None, + /, + *, + props: _ItemProperties, + parent_modname: str | None, + events: EventManager, + options: _AutoDocumenterOptions, +) -> tuple[str, ...]: + attr_docs = _attr_docs_for_props(props, parent_modname=parent_modname) + prepared_docstrings = _prepare_docstrings( + docstrings, props=props, attr_docs=attr_docs + ) + docstring_lines = _process_docstrings( + prepared_docstrings, + events=events, + props=props, + options=options, + ) + return tuple(docstring_lines) + + +def _attr_docs_for_props( + props: _ItemProperties, *, parent_modname: str | None +) -> Mapping[tuple[str, str], list[str]]: + if props.obj_type in {'class', 'exception'}: + # If a class gets imported into the module ``parent_modname`` + # the analyzer won't find the source of the class, + # if it looks in ``parent_modname``. + real_modname = props.module_name + elif parent_modname is None: + real_modname = props.canonical_module_name + else: + real_modname = parent_modname + + try: + analyzer = ModuleAnalyzer.for_module(real_modname) + # parse right now, to get PycodeErrors on parsing (results will + # be cached anyway) + analyzer.analyze() + except PycodeError as exc: + LOGGER.debug('[autodoc] module analyzer failed: %s', exc) + # no source file -- e.g. for builtin and C modules + attr_docs = {} + else: + attr_docs = analyzer.attr_docs + return attr_docs + + +def _prepare_docstrings( + docstrings: list[list[str]] | None, + *, + props: _ItemProperties, + attr_docs: Mapping[tuple[str, str], list[str]], +) -> list[list[str]] | None: + """Add content from docstrings, attribute documentation and user.""" + # add content from attribute documentation + if props.obj_type not in {'data', 'attribute', 'type'} and props.parts: + key = ('.'.join(props.parent_names), props.name) + try: + # make a copy of docstring for attributes to avoid cache + # the change of autodoc-process-docstring event. + return [list(attr_docs[key])] + except KeyError: + pass + + if docstrings is None: + return None + if not docstrings: + # append at least a dummy docstring, so that the event + # autodoc-process-docstring is fired and can add some + # content if desired + docstrings.append([]) + return docstrings + + +def _process_docstrings( + docstrings: list[list[str]] | None, + *, + events: EventManager, + props: _ItemProperties, + options: _AutoDocumenterOptions, +) -> Iterator[str]: + """Let the user process the docstrings before adding them.""" + if docstrings is None: + return + for docstring_lines in docstrings: + # let extensions pre-process docstrings + events.emit( + 'autodoc-process-docstring', + props.obj_type, + props.full_name, + props._obj, + options, + docstring_lines, + ) + + yield from docstring_lines + if docstring_lines and docstring_lines[-1]: + # ensure the docstring ends with a blank line + yield '' + + +def _get_docstring_lines( + props: _ItemProperties, + *, + class_doc_from: Literal['both', 'class', 'init'], + get_attr: _AttrGetter, + inherit_docstrings: bool, + parent: Any, + tab_width: int, +) -> list[list[str]] | None: + """Decode and return lines of the docstring(s) for the object. + + When it returns None, autodoc-process-docstring will not be called for this + object. + """ + obj = props._obj + + if props.obj_type in {'class', 'exception'}: + assert isinstance(props, _ClassDefProperties) + + if isinstance(obj, TypeVar): + if obj.__doc__ == TypeVar.__doc__: + return [] + if props.doc_as_attr: + # Don't show the docstring of the class when it is an alias. + if _class_variable_comment(props): + return [] + return None + + docstrings = [] + if attr_docstring := getdoc(obj): + docstrings.append(attr_docstring) + + # for classes, what the "docstring" is can be controlled via a + # config value; the default is only the class docstring + if class_doc_from in {'both', 'init'}: + __init__ = get_attr(obj, '__init__', None) + init_docstring = getdoc( + __init__, + allow_inherited=inherit_docstrings, + cls=obj, # TODO: object or obj? + name='__init__', + ) + # no __init__ means default __init__ + if init_docstring == object.__init__.__doc__: + init_docstring = None + if not init_docstring: + # try __new__ + __new__ = get_attr(obj, '__new__', None) + init_docstring = getdoc( + __new__, + allow_inherited=inherit_docstrings, + cls=object, # TODO: object or obj? + name='__new__', + ) + # no __new__ means default __new__ + if init_docstring == object.__new__.__doc__: + init_docstring = None + if init_docstring: + if class_doc_from == 'init': + docstrings = [init_docstring] + else: + docstrings.append(init_docstring) + + return [prepare_docstring(docstring, tab_width) for docstring in docstrings] + + if props.obj_type == 'method': + docstring = getdoc( + obj, + allow_inherited=inherit_docstrings, + cls=parent, + name=props.object_name, + ) + if ( + not docstring + or (props.name == '__init__' and docstring == object.__init__.__doc__) + or (props.name == '__new__' and docstring == object.__new__.__doc__) + ): + return [] + return [prepare_docstring(docstring, tab_width)] + + if props.obj_type == 'data': + # Check the variable has a docstring-comment + + # get_module_comment() + comment = None + try: + analyzer = ModuleAnalyzer.for_module(props.module_name) + analyzer.analyze() + key = ('', props.name) + if key in analyzer.attr_docs: + comment = list(analyzer.attr_docs[key]) + except PycodeError: + pass + + if comment: + return [comment] + + if obj is UNINITIALIZED_ATTR: + return [] + + docstring = getdoc( + obj, + allow_inherited=inherit_docstrings, + cls=parent, + name=props.object_name, + ) + if not docstring: + return [] + return [prepare_docstring(docstring, tab_width)] + + if props.obj_type == 'attribute': + # Check the attribute has a docstring-comment + comment = _get_attribute_comment( + parent=parent, obj_path=props.parts, attrname=props.parts[-1] + ) + if comment: + return [comment] + + # Disable `autodoc_inherit_docstring` to avoid to obtain + # a docstring from the value which descriptor returns unexpectedly. + # See: https://github.com/sphinx-doc/sphinx/issues/7805 + inherit_docstrings = False + + if obj is SLOTS_ATTR: + # support for __slots__ + try: + parent___slots__ = inspect.getslots(parent) + if parent___slots__ and (docstring := parent___slots__.get(props.name)): + return [prepare_docstring(docstring)] + return [] + except ValueError as exc: + LOGGER.warning( + __('Invalid __slots__ found on %s. Ignored.'), + (parent.__qualname__, exc), + type='autodoc', + ) + return [] + + if ( + obj is RUNTIME_INSTANCE_ATTRIBUTE + and _is_runtime_instance_attribute_not_commented( + parent=parent, obj_path=props.parts + ) + ): + return None + + if obj is UNINITIALIZED_ATTR: + return None + + if not inspect.isattributedescriptor(obj): + # the docstring of non-data descriptor is very probably + # the wrong thing to display + return None + + docstring = getdoc( + obj, + allow_inherited=inherit_docstrings, + cls=parent, + name=props.object_name, + ) + if not docstring: + return [] + return [prepare_docstring(docstring, tab_width)] + + if props.obj_type == 'type': + try: + analyzer = ModuleAnalyzer.for_module(props.module_name) + analyzer.analyze() + except PycodeError: + return None + + key = ('', props.name) + if key in analyzer.attr_docs: + if comment := list(analyzer.attr_docs[key]): + return [comment] + + return None + + docstring = getdoc( + obj, + allow_inherited=inherit_docstrings, + cls=parent, + name=props.object_name, + ) + if not docstring: + return [] + return [prepare_docstring(docstring, tab_width)] + + +def _class_variable_comment(props: _ItemProperties) -> bool: + try: + analyzer = ModuleAnalyzer.for_module(props.module_name) + analyzer.analyze() + key = ('', props.dotted_parts) + return bool(analyzer.attr_docs.get(key, False)) + except PycodeError: + return False diff --git a/sphinx/ext/autodoc/_dynamic/_importer.py b/sphinx/ext/autodoc/_dynamic/_importer.py new file mode 100644 index 00000000000..10d885a0800 --- /dev/null +++ b/sphinx/ext/autodoc/_dynamic/_importer.py @@ -0,0 +1,431 @@ +"""Importer utilities for autodoc""" + +from __future__ import annotations + +import contextlib +import importlib +import os +import sys +import traceback +import typing +from importlib.abc import FileLoader +from importlib.machinery import EXTENSION_SUFFIXES +from importlib.util import decode_source, find_spec, module_from_spec, spec_from_loader +from pathlib import Path +from typing import TYPE_CHECKING + +from sphinx.errors import PycodeError +from sphinx.ext.autodoc._dynamic._mock import ismock, mock, undecorate +from sphinx.ext.autodoc._sentinels import RUNTIME_INSTANCE_ATTRIBUTE, UNINITIALIZED_ATTR +from sphinx.ext.autodoc._shared import LOGGER +from sphinx.pycode import ModuleAnalyzer +from sphinx.util import inspect +from sphinx.util.inspect import isclass, safe_getattr +from sphinx.util.typing import get_type_hints + +if TYPE_CHECKING: + from collections.abc import Mapping, Sequence + from importlib.machinery import ModuleSpec + from types import ModuleType + from typing import Any, Protocol + + from sphinx.ext.autodoc._property_types import _AutodocObjType + + class _AttrGetter(Protocol): + def __call__(self, obj: Any, name: str, default: Any = ..., /) -> Any: ... + + +_NATIVE_SUFFIXES: frozenset[str] = frozenset({'.pyx', *EXTENSION_SUFFIXES}) + + +class _ImportedObject: + #: module containing the object to document + module: ModuleType | None + + #: parent/owner of the object to document + parent: Any + + #: name of the object to document + object_name: str + + #: object to document + obj: Any + + def __init__( + self, + *, + module: ModuleType | None = None, + parent: Any, + object_name: str = '', + obj: Any, + ) -> None: + self.module = module + self.parent = parent + self.object_name = object_name + self.obj = obj + + def __repr__(self) -> str: + return f'<{self.__class__.__name__} {self.__dict__}>' + + +def _import_object( + *, + get_attr: _AttrGetter = safe_getattr, + mock_imports: Sequence[str], + module_name: str, + obj_path: Sequence[str], + obj_type: _AutodocObjType, + type_aliases: Mapping[str, str] | None, +) -> _ImportedObject | None: + """Import the module and get the object to document.""" + try: + with mock(mock_imports): + im = _import_from_module_and_path( + module_name=module_name, obj_path=obj_path, get_attr=get_attr + ) + except ImportError as exc: + if obj_type == 'data': + im_ = _import_data_declaration( + module_name=module_name, + obj_path=obj_path, + mock_imports=mock_imports, + type_aliases=type_aliases, + ) + if im_ is not None: + return im_ + elif obj_type == 'attribute': + im_ = _import_attribute_declaration( + module_name=module_name, + obj_path=obj_path, + mock_imports=mock_imports, + type_aliases=type_aliases, + get_attr=get_attr, + ) + if im_ is not None: + return im_ + LOGGER.warning(exc.args[0], type='autodoc', subtype='import_object') + return None + + if ismock(im.obj): + im.obj = undecorate(im.obj) + return im + + +def _import_from_module_and_path( + *, + module_name: str, + obj_path: Sequence[str], + get_attr: _AttrGetter = safe_getattr, +) -> _ImportedObject: + obj_path = list(obj_path) + if obj_path: + LOGGER.debug('[autodoc] from %s import %s', module_name, '.'.join(obj_path)) + else: + LOGGER.debug('[autodoc] import %s', module_name) + + module = None + exc_on_importing = None + try: + while module is None: + try: + module = _import_module(module_name, try_reload=True) + LOGGER.debug('[autodoc] import %s => %r', module_name, module) + except ImportError as exc: + LOGGER.debug('[autodoc] import %s => failed', module_name) + exc_on_importing = exc + if '.' not in module_name: + raise + + # retry with parent module + module_name, _, name = module_name.rpartition('.') + obj_path.insert(0, name) + + obj = module + parent = None + object_name = '' + for attr_name in obj_path: + parent = obj + LOGGER.debug('[autodoc] getattr(_, %r)', attr_name) + mangled_name = _mangle_name(obj, attr_name) + obj = get_attr(obj, mangled_name) + + try: + LOGGER.debug('[autodoc] => %r', obj) + except TypeError: + # fallback of failure on logging for broken object + # See: https://github.com/sphinx-doc/sphinx/issues/9095 + LOGGER.debug('[autodoc] => %r', (obj,)) + + object_name = attr_name + return _ImportedObject( + module=module, + parent=parent, + object_name=object_name, + obj=obj, + ) + except (AttributeError, ImportError) as exc: + if isinstance(exc, AttributeError) and exc_on_importing: + # restore ImportError + exc = exc_on_importing + + if obj_path: + dotted_objpath = '.'.join(obj_path) + err_parts = [ + f'autodoc: failed to import {dotted_objpath!r} ' + f'from module {module_name!r}' + ] + else: + err_parts = [f'autodoc: failed to import {module_name!r}'] + + if isinstance(exc, ImportError): + # _import_module() raises ImportError having real exception obj and + # traceback + real_exc = exc.args[0] + traceback_msg = ''.join(traceback.format_exception(exc)) + if isinstance(real_exc, SystemExit): + err_parts.append( + 'the module executes module level statement ' + 'and it might call sys.exit().' + ) + elif isinstance(real_exc, ImportError) and real_exc.args: + err_parts.append( + f'the following exception was raised:\n{real_exc.args[0]}' + ) + else: + err_parts.append( + f'the following exception was raised:\n{traceback_msg}' + ) + else: + err_parts.append( + f'the following exception was raised:\n{traceback.format_exc()}' + ) + + errmsg = '; '.join(err_parts) + LOGGER.debug(errmsg) + raise ImportError(errmsg) from exc + + +def _import_module(modname: str, try_reload: bool = False) -> Any: + if modname in sys.modules: + return sys.modules[modname] + + skip_pyi = bool(os.getenv('SPHINX_AUTODOC_IGNORE_NATIVE_MODULE_TYPE_STUBS', '')) + original_module_names = frozenset(sys.modules) + try: + spec = find_spec(modname) + if spec is None: + msg = f'No module named {modname!r}' + raise ModuleNotFoundError(msg, name=modname) # NoQA: TRY301 + spec, pyi_path = _find_type_stub_spec(spec, modname) + if skip_pyi or pyi_path is None: + module = importlib.import_module(modname) + else: + if spec.loader is None: + msg = 'missing loader' + raise ImportError(msg, name=spec.name) # NoQA: TRY301 + sys.modules[modname] = module = module_from_spec(spec) + spec.loader.exec_module(module) + except ImportError: + raise + except BaseException as exc: + # Importing modules may cause any side effects, including + # SystemExit, so we need to catch all errors. + raise ImportError(exc, traceback.format_exc()) from exc + if try_reload and os.environ.get('SPHINX_AUTODOC_RELOAD_MODULES'): + new_modules = [m for m in sys.modules if m not in original_module_names] + # Try reloading modules with ``typing.TYPE_CHECKING == True``. + try: + typing.TYPE_CHECKING = True # type: ignore[misc] + # Ignore failures; we've already successfully loaded these modules + with contextlib.suppress(ImportError, KeyError): + for m in new_modules: + mod_path = getattr(sys.modules[m], '__file__', '') + if mod_path and mod_path.endswith('.pyi'): + continue + _reload_module(sys.modules[m]) + finally: + typing.TYPE_CHECKING = False # type: ignore[misc] + module = sys.modules[modname] + return module + + +def _find_type_stub_spec( + spec: ModuleSpec, modname: str +) -> tuple[ModuleSpec, Path | None]: + """Try finding a spec for a PEP 561 '.pyi' stub file for native modules.""" + if spec.origin is None: + return spec, None + + for suffix in _NATIVE_SUFFIXES: + if not spec.origin.endswith(suffix): + continue + pyi_path = Path(spec.origin.removesuffix(suffix) + '.pyi') + if not pyi_path.is_file(): + continue + pyi_loader = _StubFileLoader(modname, path=str(pyi_path)) + pyi_spec = spec_from_loader(modname, loader=pyi_loader) + if pyi_spec is not None: + return pyi_spec, pyi_path + return spec, None + + +class _StubFileLoader(FileLoader): + """Load modules from ``.pyi`` stub files.""" + + def get_source(self, fullname: str) -> str: + path = self.get_filename(fullname) + for suffix in _NATIVE_SUFFIXES: + if not path.endswith(suffix): + continue + path = path.removesuffix(suffix) + '.pyi' + try: + source_bytes = self.get_data(path) + except OSError as exc: + raise ImportError from exc + return decode_source(source_bytes) + + +def _reload_module(module: ModuleType) -> Any: + """Call importlib.reload(module), convert exceptions to ImportError""" + try: + return importlib.reload(module) + except BaseException as exc: + # Importing modules may cause any side effects, including + # SystemExit, so we need to catch all errors. + raise ImportError(exc, traceback.format_exc()) from exc + + +def _mangle_name(subject: Any, name: str) -> str: + """Mangle the given name.""" + try: + if isclass(subject) and name.startswith('__') and not name.endswith('__'): + return f'_{subject.__name__}{name}' + except AttributeError: + pass + + return name + + +def _import_data_declaration( + *, + module_name: str, + obj_path: Sequence[str], + mock_imports: Sequence[str], + type_aliases: Mapping[str, str] | None, +) -> _ImportedObject | None: + # annotation only instance variable (PEP-526) + try: + with mock(mock_imports): + parent = _import_module(module_name) + annotations = get_type_hints(parent, None, type_aliases, include_extras=True) + if obj_path[-1] in annotations: + im = _ImportedObject( + parent=parent, + obj=UNINITIALIZED_ATTR, + ) + return im + except ImportError: + pass + return None + + +def _import_attribute_declaration( + *, + module_name: str, + obj_path: Sequence[str], + mock_imports: Sequence[str], + type_aliases: Mapping[str, str] | None, + get_attr: _AttrGetter = safe_getattr, +) -> _ImportedObject | None: + # Support runtime & uninitialized instance attributes. + # + # The former are defined in __init__() methods with doc-comments. + # The latter are PEP-526 style annotation only annotations. + # + # class Foo: + # attr: int #: uninitialized attribute + # + # def __init__(self): + # self.attr = None #: runtime attribute + try: + with mock(mock_imports): + ret = _import_from_module_and_path( + module_name=module_name, obj_path=obj_path[:-1], get_attr=get_attr + ) + parent = ret.obj + if _is_runtime_instance_attribute(parent=parent, obj_path=obj_path): + im = _ImportedObject( + parent=parent, + obj=RUNTIME_INSTANCE_ATTRIBUTE, + ) + return im + elif _is_uninitialized_instance_attribute( + parent=parent, obj_path=obj_path, type_aliases=type_aliases + ): + im = _ImportedObject( + parent=parent, + obj=UNINITIALIZED_ATTR, + ) + return im + except ImportError: + pass + return None + + +def _is_runtime_instance_attribute(*, parent: Any, obj_path: Sequence[str]) -> bool: + """Check the subject is an attribute defined in __init__().""" + # An instance variable defined in __init__(). + if _get_attribute_comment(parent=parent, obj_path=obj_path, attrname=obj_path[-1]): + return True + return _is_runtime_instance_attribute_not_commented( + parent=parent, obj_path=obj_path + ) + + +def _is_runtime_instance_attribute_not_commented( + *, parent: Any, obj_path: Sequence[str] +) -> bool: + """Check the subject is an attribute defined in __init__() without comment.""" + for cls in inspect.getmro(parent): + try: + module = safe_getattr(cls, '__module__') + qualname = safe_getattr(cls, '__qualname__') + + analyzer = ModuleAnalyzer.for_module(module) + analyzer.analyze() + if qualname and obj_path: + key = f'{qualname}.{obj_path[-1]}' + if key in analyzer.tagorder: + return True + except (AttributeError, PycodeError): + pass + + return False + + +def _get_attribute_comment( + parent: Any, obj_path: Sequence[str], attrname: str +) -> list[str] | None: + for cls in inspect.getmro(parent): + try: + module = safe_getattr(cls, '__module__') + qualname = safe_getattr(cls, '__qualname__') + + analyzer = ModuleAnalyzer.for_module(module) + analyzer.analyze() + if qualname and obj_path: + key = (qualname, attrname) + if key in analyzer.attr_docs: + return list(analyzer.attr_docs[key]) + except (AttributeError, PycodeError): + pass + + return None + + +def _is_uninitialized_instance_attribute( + *, parent: Any, obj_path: Sequence[str], type_aliases: Mapping[str, str] | None +) -> bool: + """Check the subject is an annotation only attribute.""" + annotations = get_type_hints(parent, None, type_aliases, include_extras=True) + return obj_path[-1] in annotations diff --git a/sphinx/ext/autodoc/_dynamic/_loader.py b/sphinx/ext/autodoc/_dynamic/_loader.py new file mode 100644 index 00000000000..689f92d11a8 --- /dev/null +++ b/sphinx/ext/autodoc/_dynamic/_loader.py @@ -0,0 +1,501 @@ +"""Object loader for autodoc""" + +from __future__ import annotations + +import re +from inspect import Parameter +from pathlib import Path +from types import SimpleNamespace +from typing import TYPE_CHECKING, NewType, TypeVar + +from sphinx.ext.autodoc._dynamic._docstrings import ( + _docstring_lines_for_props, + _get_docstring_lines, +) +from sphinx.ext.autodoc._dynamic._importer import _import_object +from sphinx.ext.autodoc._dynamic._mock import ismock +from sphinx.ext.autodoc._dynamic._signatures import _format_signatures +from sphinx.ext.autodoc._dynamic._type_comments import ( + _ensure_annotations_from_type_comments, + _update_annotations_using_type_comments, +) +from sphinx.ext.autodoc._names import _parse_name +from sphinx.ext.autodoc._property_types import ( + _AssignStatementProperties, + _ClassDefProperties, + _FunctionDefProperties, + _ItemProperties, + _ModuleProperties, + _TypeStatementProperties, +) +from sphinx.ext.autodoc._sentinels import ( + RUNTIME_INSTANCE_ATTRIBUTE, + SLOTS_ATTR, + UNINITIALIZED_ATTR, +) +from sphinx.ext.autodoc._shared import LOGGER, _get_render_mode +from sphinx.locale import __ +from sphinx.util import inspect +from sphinx.util.inspect import safe_getattr +from sphinx.util.typing import get_type_hints, restify, stringify_annotation + +if TYPE_CHECKING: + from collections.abc import Mapping, MutableSet, Sequence + from typing import Any + + from sphinx.environment import _CurrentDocument + from sphinx.events import EventManager + from sphinx.ext.autodoc._directive_options import _AutoDocumenterOptions + from sphinx.ext.autodoc._dynamic._importer import _ImportedObject + from sphinx.ext.autodoc._property_types import _AutodocFuncProperty, _AutodocObjType + from sphinx.ext.autodoc._shared import _AttrGetter, _AutodocConfig + + +_hide_value_re = re.compile(r'^:meta \s*hide-value:( +|$)') + + +def _load_object_by_name( + *, + name: str, + objtype: _AutodocObjType, + current_document: _CurrentDocument, + config: _AutodocConfig, + events: EventManager, + get_attr: _AttrGetter, + options: _AutoDocumenterOptions, + parent_modname: str | None = None, + ref_context: Mapping[str, str | None], + reread_always: MutableSet[str], +) -> _ItemProperties | None: + """Import and load the object given by *name*.""" + parsed = _parse_name( + name=name, + objtype=objtype, + current_document=current_document, + ref_context=ref_context, + ) + if parsed is None: + return None + module_name, parts, args, retann = parsed + + # Import the module and get the object to document + im = _import_object( + module_name=module_name, + obj_path=parts, + mock_imports=config.autodoc_mock_imports, + get_attr=get_attr, + obj_type=objtype, + type_aliases=config.autodoc_type_aliases, + ) + if im is None: + # See BuildEnvironment.note_reread() + reread_always.add(current_document.docname) + return None + + # Assemble object properties from the imported object. + parent = im.parent + props = _make_props_from_imported_object( + im, + config=config, + events=events, + get_attr=get_attr, + module_name=module_name, + objtype=objtype, + parts=parts, + ) + if props is None: + return None + + if options.class_doc_from is not None: + class_doc_from = options.class_doc_from + else: + class_doc_from = config.autoclass_content + + docstrings = _get_docstring_lines( + props, + class_doc_from=class_doc_from, + get_attr=get_attr, + inherit_docstrings=config.autodoc_inherit_docstrings, + parent=parent, + tab_width=options._tab_width, + ) + if docstrings: + for docstring_lines in docstrings: + for line in docstring_lines: + if _hide_value_re.match(line): + props._docstrings_has_hide_value = True + break + + # format the object's signature, if any + try: + signatures = _format_signatures( + args=args, + retann=retann, + autodoc_annotations=current_document.autodoc_annotations, + config=config, + docstrings=docstrings, + events=events, + get_attr=get_attr, + parent=parent, + options=options, + props=props, + ) + except Exception as exc: + msg = __('error while formatting signature for %s: %s') + LOGGER.warning(msg, props.full_name, exc, type='autodoc') + return None + props.signatures = tuple( + f'{args} -> {retann}' if retann else str(args) for args, retann in signatures + ) + + props.docstring_lines = _docstring_lines_for_props( + docstrings, + props=props, + parent_modname=parent_modname, + events=events, + options=options, + ) + + return props + + +def _make_props_from_imported_object( + im: _ImportedObject, + *, + config: _AutodocConfig, + events: EventManager, + get_attr: _AttrGetter, + module_name: str, + objtype: _AutodocObjType, + parts: tuple[str, ...], +) -> _ItemProperties | None: + parent = im.parent + object_name = im.object_name + obj = im.obj + obj_properties: set[_AutodocFuncProperty] = set() + render_mode = _get_render_mode(config.autodoc_typehints_format) + + if objtype == 'module': + try: + mod_origin = im.module.__spec__.origin # type: ignore[union-attr] + except AttributeError: + file_path = None + else: + file_path = Path(mod_origin) if mod_origin is not None else None + + mod_all = safe_getattr(obj, '__all__', None) + if isinstance(mod_all, (list, tuple)) and all( + isinstance(e, str) for e in mod_all + ): + mod_all = tuple(mod_all) + elif mod_all is not None: + # Invalid __all__ found. + msg = __('Ignoring invalid __all__ in module %s: %r') + LOGGER.warning(msg, module_name, mod_all, type='autodoc') + mod_all = None + + return _ModuleProperties( + obj_type=objtype, + module_name=module_name, + docstring_lines=(), + file_path=file_path, + all=mod_all, + _obj=obj, + _obj___module__=obj.__name__, + ) + + if objtype in {'class', 'exception'}: + if isinstance(obj, (NewType, TypeVar)): + obj_module_name = getattr(obj, '__module__', module_name) + if obj_module_name != module_name and module_name.startswith( + obj_module_name + ): + bases = module_name[len(obj_module_name) :].strip('.').split('.') + parts = tuple(bases) + parts + module_name = obj_module_name + + if orig_bases := inspect.getorigbases(obj): + # A subclass of generic types + # refs: PEP-560 + obj_bases = list(orig_bases) + elif hasattr(obj, '__bases__') and obj.__bases__: + # A normal class + obj_bases = list(obj.__bases__) + else: + obj_bases = [] + full_name = '.'.join((module_name, *parts)) + events.emit( + 'autodoc-process-bases', + full_name, + obj, + SimpleNamespace(), + obj_bases, + ) + base_classes = tuple(restify(cls, mode=render_mode) for cls in obj_bases) + + return _ClassDefProperties( + obj_type=objtype, # type: ignore[arg-type] + module_name=module_name, + parts=parts, + docstring_lines=(), + bases=getattr(obj, '__bases__', None), + _obj=obj, + _obj___module__=get_attr(obj, '__module__', None), + _obj___name__=getattr(obj, '__name__', None), + _obj___qualname__=getattr(obj, '__qualname__', None), + _obj_bases=base_classes, + _obj_is_new_type=isinstance(obj, NewType), + _obj_is_typevar=isinstance(obj, TypeVar), + ) + + if objtype in {'function', 'decorator'}: + if inspect.isstaticmethod(obj, cls=parent, name=object_name): + obj_properties.add('staticmethod') + if inspect.isclassmethod(obj): + obj_properties.add('classmethod') + if inspect.iscoroutinefunction(obj) or inspect.isasyncgenfunction(obj): + obj_properties.add('async') + + return _FunctionDefProperties( + obj_type=objtype, # type: ignore[arg-type] + module_name=module_name, + parts=parts, + docstring_lines=(), + properties=frozenset(obj_properties), + _obj=obj, + _obj___module__=get_attr(obj, '__module__', None), + _obj___name__=getattr(obj, '__name__', None), + _obj___qualname__=getattr(obj, '__qualname__', None), + ) + + if objtype == 'method': + # to distinguish classmethod/staticmethod + obj_ = parent.__dict__.get(object_name, obj) + if inspect.isstaticmethod(obj_, cls=parent, name=object_name): + obj_properties.add('staticmethod') + elif ( + inspect.is_classmethod_like(obj_) + or inspect.is_singledispatch_method(obj_) + and inspect.is_classmethod_like(obj_.func) + ): + obj_properties.add('classmethod') + if inspect.isabstractmethod(obj_): + obj_properties.add('abstractmethod') + if inspect.iscoroutinefunction(obj_) or inspect.isasyncgenfunction(obj_): + obj_properties.add('async') + + return _FunctionDefProperties( + obj_type=objtype, + module_name=module_name, + parts=parts, + docstring_lines=(), + properties=frozenset(obj_properties), + _obj=obj, + _obj___module__=get_attr(obj, '__module__', None), + _obj___name__=getattr(obj, '__name__', None), + _obj___qualname__=getattr(obj, '__qualname__', None), + ) + + if objtype == 'property': + if not inspect.isproperty(obj): + # Support for class properties. Note: these only work on Python 3.9. + __dict__ = safe_getattr(parent, '__dict__', {}) + obj = __dict__.get(parts[-1]) + if isinstance(obj, classmethod) and inspect.isproperty(obj.__func__): + obj = obj.__func__ + obj_properties.add('classmethod') + else: + return None + if inspect.isabstractmethod(obj): + obj_properties.add('abstractmethod') + + # get property return type annotation + obj_property_type_annotation = None + if safe_getattr(obj, 'fget', None): # property + func = obj.fget # type: ignore[union-attr] + elif safe_getattr(obj, 'func', None): # cached_property + func = obj.func # type: ignore[union-attr] + else: + func = None + if func is not None: + # update the annotations of the property getter + if config.autodoc_use_type_comments: + _update_annotations_using_type_comments(func, False) + + try: + signature = inspect.signature( + func, type_aliases=config.autodoc_type_aliases + ) + except TypeError as exc: + full_name = '.'.join((module_name, *parts)) + LOGGER.warning( + __('Failed to get a function signature for %s: %s'), + full_name, + exc, + ) + pass + except ValueError: + pass + else: + if signature.return_annotation is not Parameter.empty: + short_literals = config.python_display_short_literal_types + obj_property_type_annotation = stringify_annotation( + signature.return_annotation, + render_mode, + short_literals=short_literals, + ) + + return _FunctionDefProperties( + obj_type=objtype, + module_name=module_name, + parts=parts, + docstring_lines=(), + properties=frozenset(obj_properties), + _obj=obj, + _obj___module__=get_attr(parent or obj, '__module__', None) or module_name, + _obj___name__=getattr(parent or obj, '__name__', None), + _obj___qualname__=getattr(parent or obj, '__qualname__', None), + _obj_property_type_annotation=obj_property_type_annotation, + ) + + if objtype == 'data': + # Update __annotations__ to support type_comment and so on + _ensure_annotations_from_type_comments(parent) + + # obtain annotation + annotations = get_type_hints( + parent, + None, + config.autodoc_type_aliases, + include_extras=True, + ) + if parts[-1] in annotations: + short_literals = config.python_display_short_literal_types + type_annotation = stringify_annotation( + annotations[parts[-1]], render_mode, short_literals=short_literals + ) + else: + type_annotation = None + + if ( + obj is RUNTIME_INSTANCE_ATTRIBUTE + or obj is SLOTS_ATTR + or obj is UNINITIALIZED_ATTR + ): + obj_sentinel = obj + else: + obj_sentinel = None + + return _AssignStatementProperties( + obj_type=objtype, + module_name=module_name, + parts=parts, + docstring_lines=(), + value=..., + annotation='', + class_var=False, + instance_var=False, + _obj=obj, + _obj___module__=get_attr(parent or obj, '__module__', None) or module_name, + _obj_is_generic_alias=inspect.isgenericalias(obj), + _obj_is_attribute_descriptor=inspect.isattributedescriptor(obj), + _obj_is_mock=ismock(obj), + _obj_is_sentinel=obj_sentinel, + _obj_repr_rst=inspect.object_description(obj), + _obj_type_annotation=type_annotation, + ) + + if objtype == 'attribute': + if _is_slots_attribute(parent=parent, obj_path=parts): + obj = SLOTS_ATTR + elif inspect.isenumattribute(obj): + obj = obj.value + if parent: + # Update __annotations__ to support type_comment and so on + _ensure_annotations_from_type_comments(parent) + + # obtain annotation + annotations = get_type_hints( + parent, + None, + config.autodoc_type_aliases, + include_extras=True, + ) + if parts[-1] in annotations: + short_literals = config.python_display_short_literal_types + type_annotation = stringify_annotation( + annotations[parts[-1]], render_mode, short_literals=short_literals + ) + else: + type_annotation = None + + if ( + obj is RUNTIME_INSTANCE_ATTRIBUTE + or obj is SLOTS_ATTR + or obj is UNINITIALIZED_ATTR + ): + obj_sentinel = obj + else: + obj_sentinel = None + + return _AssignStatementProperties( + obj_type=objtype, + module_name=module_name, + parts=parts, + docstring_lines=(), + value=..., + annotation='', + class_var=False, + instance_var=False, + _obj=obj, + _obj___module__=get_attr(obj, '__module__', None), + _obj_is_generic_alias=inspect.isgenericalias(obj), + _obj_is_attribute_descriptor=inspect.isattributedescriptor(obj), + _obj_is_mock=ismock(obj), + _obj_is_sentinel=obj_sentinel, + _obj_repr_rst=inspect.object_description(obj), + _obj_type_annotation=type_annotation, + ) + + if objtype == 'type': + obj_module_name = getattr(obj, '__module__', module_name) + if obj_module_name != module_name and module_name.startswith(obj_module_name): + bases = module_name[len(obj_module_name) :].strip('.').split('.') + parts = tuple(bases) + parts + module_name = obj_module_name + + short_literals = config.python_display_short_literal_types + ann = stringify_annotation( + obj.__value__, render_mode, short_literals=short_literals + ) + return _TypeStatementProperties( + obj_type=objtype, + module_name=module_name, + parts=parts, + docstring_lines=(), + _obj=obj, + _obj___module__=get_attr(obj, '__module__', None), + _obj___name__=getattr(obj, '__name__', None), + _obj___qualname__=getattr(obj, '__qualname__', None), + _obj___value__=ann, + ) + + return _ItemProperties( + obj_type=objtype, + module_name=module_name, + parts=parts, + docstring_lines=(), + _obj=obj, + _obj___module__=get_attr(obj, '__module__', None), + ) + + +def _is_slots_attribute(*, parent: Any, obj_path: Sequence[str]) -> bool: + """Check the subject is an attribute in __slots__.""" + try: + if parent___slots__ := inspect.getslots(parent): + return obj_path[-1] in parent___slots__ + else: + return False + except (ValueError, TypeError): + return False diff --git a/sphinx/ext/autodoc/_dynamic/_member_finder.py b/sphinx/ext/autodoc/_dynamic/_member_finder.py new file mode 100644 index 00000000000..e9afbf9e9cd --- /dev/null +++ b/sphinx/ext/autodoc/_dynamic/_member_finder.py @@ -0,0 +1,871 @@ +from __future__ import annotations + +import operator +import re +from enum import Enum +from typing import TYPE_CHECKING, Literal, NewType, TypeVar + +from sphinx.errors import PycodeError +from sphinx.events import EventManager +from sphinx.ext.autodoc._directive_options import _AutoDocumenterOptions +from sphinx.ext.autodoc._dynamic._loader import _load_object_by_name +from sphinx.ext.autodoc._dynamic._mock import ismock, undecorate +from sphinx.ext.autodoc._property_types import _ClassDefProperties, _ModuleProperties +from sphinx.ext.autodoc._sentinels import ALL, INSTANCE_ATTR, SLOTS_ATTR +from sphinx.ext.autodoc._shared import LOGGER +from sphinx.locale import __ +from sphinx.pycode import ModuleAnalyzer +from sphinx.util import inspect +from sphinx.util.docstrings import separate_metadata +from sphinx.util.inspect import ( + getannotations, + getdoc, + getmro, + getslots, + isclass, + isenumclass, + safe_getattr, + unwrap_all, +) +from sphinx.util.typing import AnyTypeAliasType + +if TYPE_CHECKING: + from collections.abc import Iterable, Iterator, Mapping, MutableSet, Sequence, Set + from typing import Any, Literal + + from sphinx.environment import _CurrentDocument + from sphinx.events import EventManager + from sphinx.ext.autodoc._directive_options import _AutoDocumenterOptions + from sphinx.ext.autodoc._property_types import _AutodocObjType, _ItemProperties + from sphinx.ext.autodoc._sentinels import ( + ALL_T, + EMPTY_T, + INSTANCE_ATTR_T, + SLOTS_ATTR_T, + ) + from sphinx.ext.autodoc._shared import _AttrGetter, _AutodocConfig + +special_member_re = re.compile(r'^__\S+__$') + + +class ObjectMember: + """A member of object. + + This is used for the result of `_get_members_to_document()` to + represent each member of the object. + """ + + __slots__ = '__name__', 'object', 'docstring', 'class_' + + __name__: str + object: Any + docstring: Sequence[str] | None + class_: Any + skipped: bool + + def __init__( + self, + name: str, + obj: INSTANCE_ATTR_T | SLOTS_ATTR_T | Any, + *, + docstring: Sequence[str] | None = None, + class_: Any = None, + ) -> None: + self.__name__ = name + self.object = obj + self.docstring = docstring + self.class_ = class_ + + def __repr__(self) -> str: + return ( + f'ObjectMember(' + f'name={self.__name__!r}, ' + f'obj={self.object!r}, ' + f'docstring={self.docstring!r}, ' + f'class_={self.class_!r}' + f')' + ) + + +def _gather_members( + *, + want_all: bool, + indent: str, + analyzer_order: dict[str, int], + attr_docs: dict[tuple[str, str], list[str]], + config: _AutodocConfig, + current_document: _CurrentDocument, + events: EventManager, + get_attr: _AttrGetter, + options: _AutoDocumenterOptions, + parent_modname: str, + props: _ItemProperties, + ref_context: Mapping[str, str | None], + reread_always: MutableSet[str], +) -> list[tuple[_ItemProperties, bool, str]]: + """Generate reST for member documentation. + + If *want_all* is True, document all members, else those given by + *self.options.members*. + """ + if props.obj_type not in {'module', 'class', 'exception'}: + msg = 'must be implemented in subclasses' + raise NotImplementedError(msg) + assert isinstance(props, (_ModuleProperties, _ClassDefProperties)) + + indent += ' ' * (props.obj_type != 'module') + + # set current namespace for finding members + current_document.autodoc_module = props.module_name + if props.parts: + current_document.autodoc_class = props.parts[0] + + inherited_members = frozenset(options.inherited_members or ()) + found_members = _get_members_to_document( + want_all=want_all, + get_attr=get_attr, + class_signature=config.autodoc_class_signature, + inherit_docstrings=config.autodoc_inherit_docstrings, + props=props, + opt_members=options.members or (), + inherited_members=inherited_members, + opt_private_members=options.private_members, + opt_special_members=options.special_members, + ignore_module_all=bool(options.ignore_module_all), + attr_docs=attr_docs, + ) + filtered_members = _filter_members( + found_members, + want_all=want_all, + events=events, + get_attr=get_attr, + class_signature=config.autodoc_class_signature, + inherit_docstrings=config.autodoc_inherit_docstrings, + options=options, + props=props, + inherited_members=inherited_members, + exclude_members=options.exclude_members, + special_members=options.special_members, + private_members=options.private_members, + undoc_members=options.undoc_members, + attr_docs=attr_docs, + ) + # document non-skipped members + member_documenters: list[tuple[_ItemProperties, bool, str]] = [] + for member_name, member, is_attr in filtered_members: + # prefer the object type with the highest priority + obj_type = _best_object_type_for_member( + member=member, + member_name=member_name, + is_attr=is_attr, + parent_obj_type=props.obj_type, + parent_props=props, + ) + if not obj_type: + # don't know how to document this member + continue + # give explicitly separated module name, so that members + # of inner classes can be documented + dotted_parts = '.'.join((*props.parts, member_name)) + full_name = f'{props.module_name}::{dotted_parts}' + + # We now try to import all objects before ordering them. This is to + # avoid possible circular imports if we were to import objects after + # their associated documenters have been sorted. + member_props = _load_object_by_name( + name=full_name, + objtype=obj_type, + current_document=current_document, + config=config, + events=events, + get_attr=get_attr, + options=options, + parent_modname=parent_modname, + ref_context=ref_context, + reread_always=reread_always, + ) + if member_props is None: + continue + member_documenters.append((member_props, is_attr, indent)) + + member_order = options.member_order or config.autodoc_member_order + member_documenters = _sort_members( + member_documenters, + member_order, + ignore_module_all=bool(options.ignore_module_all), + analyzer_order=analyzer_order, + props=props, + ) + + # reset current objects + current_document.autodoc_module = '' + current_document.autodoc_class = '' + + return member_documenters + + +def _get_members_to_document( + *, + want_all: bool, + get_attr: _AttrGetter, + class_signature: Literal['mixed', 'separated'], + inherit_docstrings: bool, + props: _ModuleProperties | _ClassDefProperties, + opt_members: ALL_T | Sequence[str], + inherited_members: Set[str], + opt_private_members: ALL_T | Sequence[str] | None, + opt_special_members: ALL_T | Sequence[str] | None, + ignore_module_all: bool, + attr_docs: dict[tuple[str, str], list[str]], +) -> list[ObjectMember]: + """Find out which members are documentable + + If *want_all* is True, return all members. Else, only return those + members given by *self.options.members* (which may also be None). + + Filter the given member list. + + Members are skipped if + + - they are private (except if given explicitly or the private-members + option is set) + - they are special methods (except if given explicitly or the + special-members option is set) + - they are undocumented (except if the undoc-members option is set) + + The user can override the skipping decision by connecting to the + ``autodoc-skip-member`` event. + """ + wanted_members: ALL_T | Set[str] + if want_all: + if ( + props.obj_type == 'module' + and not ignore_module_all + and props.all is not None + ): + wanted_members = frozenset(props.all) + else: + wanted_members = ALL + else: + # specific members given + assert opt_members is not ALL + + # Merge :private-members: and :special-members: into :members: + combined_members = set(opt_members) + if opt_private_members is not None and opt_private_members is not ALL: + combined_members.update(opt_private_members) + if opt_special_members is not None and opt_special_members is not ALL: + combined_members.update(opt_special_members) + if class_signature == 'separated' and props.obj_type in {'class', 'exception'}: + combined_members |= {'__new__', '__init__'} # show __init__() method + wanted_members = frozenset(combined_members) + + object_members_map: dict[str, ObjectMember] = {} + if props.obj_type == 'module': + for name in dir(props._obj): + try: + value = safe_getattr(props._obj, name, None) + if ismock(value): + value = undecorate(value) + if name in wanted_members: + object_members_map[name] = ObjectMember( + name, value, docstring=attr_docs.get(('', name), []) + ) + except AttributeError: + continue + + # annotation only member (e.g. attr: int) + for name in inspect.getannotations(props._obj): + if name not in object_members_map and name in wanted_members: + object_members_map[name] = ObjectMember( + name, INSTANCE_ATTR, docstring=attr_docs.get(('', name), []) + ) + + obj_members_seq = list(object_members_map.values()) + elif props.obj_type in {'class', 'exception'}: + # the members directly defined in the class + obj_dict = get_attr(props._obj, '__dict__', {}) + + # enum members + if isenumclass(props._obj): + for name, defining_class, value in _filter_enum_dict( + props._obj, get_attr, obj_dict + ): + # the order of occurrence of *name* matches obj's MRO, + # allowing inherited attributes to be shadowed correctly + if unmangled := unmangle(defining_class, name): + if unmangled in wanted_members: + object_members_map[unmangled] = ObjectMember( + unmangled, value, class_=defining_class + ) + + # members in __slots__ + try: + subject___slots__ = getslots(props._obj) + if subject___slots__: + for name, subject_docstring in subject___slots__.items(): + if name not in wanted_members: + continue + if isinstance(subject_docstring, str): + subject_doclines = subject_docstring.splitlines() + else: + subject_doclines = None + object_members_map[name] = ObjectMember( + name, + SLOTS_ATTR, + class_=props._obj, + docstring=subject_doclines, + ) + except (TypeError, ValueError): + pass + + # other members + for name in dir(props._obj): + try: + value = get_attr(props._obj, name) + if ismock(value): + value = undecorate(value) + + unmangled = unmangle(props._obj, name) + if ( + unmangled + and unmangled not in object_members_map + and unmangled in wanted_members + ): + if name in obj_dict: + object_members_map[unmangled] = ObjectMember( + unmangled, value, class_=props._obj + ) + else: + object_members_map[unmangled] = ObjectMember(unmangled, value) + except AttributeError: + continue + + try: + for cls in getmro(props._obj): + try: + modname = safe_getattr(cls, '__module__') + qualname = safe_getattr(cls, '__qualname__') + except AttributeError: + qualname = None + analyzer = None + else: + try: + analyzer = ModuleAnalyzer.for_module(modname) + analyzer.analyze() + except PycodeError: + analyzer = None + + # annotation only member (ex. attr: int) + for name in getannotations(cls): + unmangled = unmangle(cls, name) + if ( + unmangled + and unmangled not in object_members_map + and unmangled in wanted_members + ): + if analyzer and (qualname, unmangled) in analyzer.attr_docs: + attr_docstring = analyzer.attr_docs[qualname, unmangled] + else: + attr_docstring = None + object_members_map[unmangled] = ObjectMember( + unmangled, + INSTANCE_ATTR, + class_=cls, + docstring=attr_docstring, + ) + + # append or complete instance attributes (cf. self.attr1) if analyzer knows + if analyzer: + for (ns, name), attr_docstring in analyzer.attr_docs.items(): + if ns == qualname and name not in object_members_map: + # otherwise unknown instance attribute + if name in wanted_members: + object_members_map[name] = ObjectMember( + name, + INSTANCE_ATTR, + class_=cls, + docstring=attr_docstring, + ) + elif ( + ns == qualname + and attr_docstring + and not object_members_map[name].docstring + ): + if cls != props._obj and not inherit_docstrings: + # If we are in the MRO of the class and not the class itself, + # and we do not want to inherit docstrings, then skip setting + # the docstring below + continue + # attribute is already known, because dir(props._obj) + # enumerates it. But it has no docstring yet + object_members_map[name].docstring = attr_docstring + except AttributeError: + pass + + if want_all and not inherited_members: + obj_members_seq = [ + m for m in object_members_map.values() if m.class_ == props._obj + ] + else: + obj_members_seq = list(object_members_map.values()) + else: + raise ValueError + + if not want_all and opt_members is not ALL: + for name in opt_members: + if name in object_members_map: + continue + msg = __( + 'attribute %s is listed in :members: but is missing ' + 'as it was not found in object %r' + ) + LOGGER.warning(msg, name, props._obj, type='autodoc') + return obj_members_seq + + +def _filter_members( + obj_members_seq: Iterable[ObjectMember], + *, + want_all: bool, + events: EventManager, + get_attr: _AttrGetter, + options: _AutoDocumenterOptions, + props: _ModuleProperties | _ClassDefProperties, + class_signature: Literal['mixed', 'separated'], + inherit_docstrings: bool, + inherited_members: Set[str], + exclude_members: EMPTY_T | Set[str] | None, + special_members: ALL_T | Sequence[str] | None, + private_members: ALL_T | Sequence[str] | None, + undoc_members: Literal[True] | None, + attr_docs: dict[tuple[str, str], list[str]], +) -> Iterator[tuple[str, Any, bool]]: + # search for members in source code too + namespace = props.dotted_parts # will be empty for modules + + # process members and determine which to skip + for obj in obj_members_seq: + member_name = obj.__name__ + member_obj = obj.object + has_attr_doc = (namespace, member_name) in attr_docs + try: + keep = _should_keep_member( + member_name=member_name, + member_obj=member_obj, + member_docstring=obj.docstring, + member_cls=obj.class_, + get_attr=get_attr, + has_attr_doc=has_attr_doc, + class_signature=class_signature, + inherit_docstrings=inherit_docstrings, + inherited_members=inherited_members, + parent=props._obj, + want_all=want_all, + exclude_members=exclude_members, + special_members=special_members, + private_members=private_members, + undoc_members=undoc_members, + ) + except Exception as exc: + LOGGER.warning( + __( + 'autodoc: failed to determine %s.%s (%r) to be documented, ' + 'the following exception was raised:\n%s' + ), + props.full_name, + member_name, + member_obj, + exc, + type='autodoc', + ) + keep = False + + # give the user a chance to decide whether this member + # should be skipped + if events is not None: + # let extensions preprocess docstrings + skip_member = events.emit_firstresult( + 'autodoc-skip-member', + props.obj_type, + member_name, + member_obj, + not keep, + options, + ) + if skip_member is not None: + keep = not skip_member + + if keep: + # if is_attr is True, the member is documented as an attribute + is_attr = member_obj is INSTANCE_ATTR or has_attr_doc + yield member_name, member_obj, is_attr + + +def _best_object_type_for_member( + member: Any, + member_name: str, + is_attr: bool, + *, + parent_obj_type: str, + parent_props: _ItemProperties | None, +) -> _AutodocObjType | None: + """Return the best object type that supports documenting *member*.""" + filtered = [] + + # Don't document submodules automatically: 'module' is never returned. + + try: + if isinstance(member, type) and issubclass(member, BaseException): + # priority must be higher than 'class' + filtered.append((20, 'exception')) + except TypeError as exc: + # It's possible for a member to be considered a type, but fail + # issubclass checks due to not being a class. For example: + # https://github.com/sphinx-doc/sphinx/issues/11654#issuecomment-1696790436 + msg = f'Failed to discern if member {member} is a BaseException subclass.' + raise ValueError(msg) from exc + + if isinstance(member, type) or (is_attr and isinstance(member, (NewType, TypeVar))): + # priority must be higher than 'function', 'class', and 'attribute' + # as NewType can be an attribute and is a class. + filtered.append((15, 'class')) + + if parent_obj_type in {'class', 'exception'}: + if inspect.isproperty(member): + # priority must be higher than 'attribute' + filtered.append((11, 'property')) + + # See _get_documenter() in autosummary, parent_props might be None. + elif parent_props is not None: + # Support for class properties. Note: these only work on Python 3.9. + __dict__ = safe_getattr(parent_props._obj, '__dict__', {}) + obj = __dict__.get(member_name) + if isinstance(obj, classmethod) and inspect.isproperty(obj.__func__): + # priority must be higher than 'attribute' + filtered.append((11, 'property')) + + if parent_obj_type != 'module': + if inspect.isattributedescriptor(member) or not ( + inspect.isroutine(member) or isinstance(member, type) + ): + # priority must be higher than 'method', else it will recognise + # some non-data descriptors as methods + filtered.append((10, 'attribute')) + + if inspect.isroutine(member) and parent_obj_type != 'module': + # priority must be higher than 'function' + filtered.append((1, 'method')) + + if ( + inspect.isfunction(member) + or inspect.isbuiltin(member) + or (inspect.isroutine(member) and parent_obj_type == 'module') + ): + # supports functions, builtins and bound methods exported + # at the module level + filtered.extend(((0, 'function'), (-1, 'decorator'))) + + if isinstance(member, AnyTypeAliasType): + filtered.append((0, 'type')) + + if parent_obj_type == 'module' and is_attr: + filtered.append((-10, 'data')) + + if filtered: + # return the highest priority object type + return max(filtered, key=operator.itemgetter(0))[1] # type: ignore[return-value] + return None + + +def _sort_members( + documenters: list[tuple[_ItemProperties, bool, str]], + order: Literal['alphabetical', 'bysource', 'groupwise'], + *, + ignore_module_all: bool, + analyzer_order: dict[str, int], + props: _ItemProperties, +) -> list[tuple[_ItemProperties, bool, str]]: + """Sort the given member list.""" + if order == 'groupwise': + # sort by group; alphabetically within groups + def group_order(entry: tuple[_ItemProperties, bool, str]) -> tuple[int, str]: + return entry[0]._groupwise_order_key, entry[0].full_name + + documenters.sort(key=group_order) + elif order == 'bysource': + if ( + isinstance(props, _ModuleProperties) + and not ignore_module_all + and (module_all := props.all) + ): + # Sort by __all__ + module_all_idx = {name: idx for idx, name in enumerate(module_all)} + module_all_len = len(module_all) + + def source_order(entry: tuple[_ItemProperties, bool, str]) -> int: + fullname = entry[0].dotted_parts + return module_all_idx.get(fullname, module_all_len) + + documenters.sort(key=source_order) + + # By default, member discovery order matches source order, + # as dicts are insertion-ordered from Python 3.7. + elif analyzer_order: + # sort by source order, by virtue of the module analyzer + order_len = len(analyzer_order) + + def source_order(entry: tuple[_ItemProperties, bool, str]) -> int: + fullname = entry[0].dotted_parts + return analyzer_order.get(fullname, order_len) + + documenters.sort(key=source_order) + else: # alphabetical + documenters.sort(key=lambda entry: entry[0].full_name) + + return documenters + + +def unmangle(subject: Any, name: str) -> str | None: + """Unmangle the given name.""" + try: + if isclass(subject) and not name.endswith('__'): + prefix = f'_{subject.__name__}__' + if name.startswith(prefix): + return name.replace(prefix, '__', 1) + else: + for cls in subject.__mro__: + prefix = f'_{cls.__name__}__' + if name.startswith(prefix): + # mangled attribute defined in parent class + return None + except AttributeError: + pass + + return name + + +def _filter_enum_dict( + enum_class: type[Enum], + attrgetter: _AttrGetter, + enum_class_dict: Mapping[str, object], +) -> Iterator[tuple[str, type, Any]]: + """Find the attributes to document of an enumeration class. + + The output consists of triplets ``(attribute name, defining class, value)`` + where the attribute name can appear more than once during the iteration + but with different defining class. The order of occurrence is guided by + the MRO of *enum_class*. + """ + # attributes that were found on a mixin type or the data type + candidate_in_mro: set[str] = set() + # sunder names that were picked up (and thereby allowed to be redefined) + # see: https://docs.python.org/3/howto/enum.html#supported-dunder-names + sunder_names = { + '_name_', + '_value_', + '_missing_', + '_order_', + '_generate_next_value_', + } + # attributes that can be picked up on a mixin type or the enum's data type + public_names = {'name', 'value', *object.__dict__, *sunder_names} + # names that are ignored by default + ignore_names = Enum.__dict__.keys() - public_names + + def should_ignore(name: str, value: Any) -> bool: + if name in sunder_names: + return _is_native_enum_api(value, name) + return name in ignore_names + + sentinel = object() + + def query(name: str, defining_class: type) -> tuple[str, type, Any] | None: + value = attrgetter(enum_class, name, sentinel) + if value is not sentinel: + return name, defining_class, value + return None + + # attributes defined on a parent type, possibly shadowed later by + # the attributes defined directly inside the enumeration class + for parent in enum_class.__mro__: + if parent in {enum_class, Enum, object}: + continue + + parent_dict = attrgetter(parent, '__dict__', {}) + for name, value in parent_dict.items(): + if should_ignore(name, value): + continue + + candidate_in_mro.add(name) + if (item := query(name, parent)) is not None: + yield item + + # exclude members coming from the native Enum unless + # they were redefined on a mixin type or the data type + excluded_members = Enum.__dict__.keys() - candidate_in_mro + yield from filter( + None, + ( + query(name, enum_class) + for name in enum_class_dict + if name not in excluded_members + ), + ) + + # check if allowed members from ``Enum`` were redefined at the enum level + special_names = sunder_names | public_names + special_names &= enum_class_dict.keys() + special_names &= Enum.__dict__.keys() + for name in special_names: + if ( + not _is_native_enum_api(enum_class_dict[name], name) + and (item := query(name, enum_class)) is not None + ): + yield item + + +def _is_native_enum_api(obj: object, name: str) -> bool: + """Check whether *obj* is the same as ``Enum.__dict__[name]``.""" + return unwrap_all(obj) is unwrap_all(Enum.__dict__[name]) + + +def _should_keep_member( + *, + member_name: str, + member_obj: Any, + member_docstring: Sequence[str] | None, + member_cls: Any, + get_attr: _AttrGetter, + has_attr_doc: bool, + class_signature: Literal['mixed', 'separated'], + inherit_docstrings: bool, + inherited_members: Set[str], + parent: Any, + want_all: bool, + exclude_members: EMPTY_T | Set[str] | None, + special_members: ALL_T | Sequence[str] | None, + private_members: ALL_T | Sequence[str] | None, + undoc_members: Literal[True] | None, +) -> bool: + if member_docstring: + # hack for ClassDocumenter to inject docstring + doclines: Sequence[str] | None = member_docstring + else: + doc = getdoc( + member_obj, + get_attr, + inherit_docstrings, + parent, + member_name, + ) + # Ignore non-string __doc__ + doclines = doc.splitlines() if isinstance(doc, str) else None + + # if the member __doc__ is the same as self's __doc__, it's just + # inherited and therefore not the member's doc + cls = get_attr(member_obj, '__class__', None) + if cls: + cls_doc = get_attr(cls, '__doc__', None) + if cls_doc == doc: + doclines = None + + if doclines is not None: + doc, metadata = separate_metadata('\n'.join(doclines)) + else: + doc = '' + metadata = {} + has_doc = bool(doc or undoc_members) + + if 'private' in metadata: + # consider a member private if docstring has "private" metadata + is_private = True + elif 'public' in metadata: + # consider a member public if docstring has "public" metadata + is_private = False + else: + is_private = member_name.startswith('_') + + if ismock(member_obj) and not has_attr_doc: + # mocked module or object + return False + + if exclude_members and member_name in exclude_members: + # remove members given by exclude-members + return False + + if not want_all: + # keep documented attributes + return has_doc or has_attr_doc + + is_filtered_inherited_member = _is_filtered_inherited_member( + member_name, + member_cls=member_cls, + parent=parent, + inherited_members=inherited_members, + get_attr=get_attr, + ) + + if special_member_re.match(member_name): + # special __methods__ + if member_name == '__doc__' or is_filtered_inherited_member: + return False + if special_members and member_name in special_members: + return has_doc + if ( + class_signature == 'separated' + and member_name in {'__new__', '__init__'} + and inspect.isclass(parent) + ): + return has_doc # show __init__() method + return False + + if is_private: + if has_attr_doc or has_doc: + if private_members is None: # NoQA: SIM114 + return False + elif has_doc and is_filtered_inherited_member: + return False + return member_name in private_members + return False + + if has_attr_doc: + # keep documented attributes + return True + + if is_filtered_inherited_member: + return False + + # ignore undocumented members if :undoc-members: is not given + return has_doc + + +def _is_filtered_inherited_member( + member_name: str, + *, + member_cls: Any, + parent: Any, + inherited_members: Set[str], + get_attr: _AttrGetter, +) -> bool: + if not inspect.isclass(parent): + return False + + seen = set() + for cls in parent.__mro__: + if member_name in cls.__dict__: + seen.add(cls) + if ( + cls.__name__ in inherited_members + and cls != parent + and any(issubclass(potential_child, cls) for potential_child in seen) + ): + # given member is a member of specified *super class* + return True + if member_cls is cls: + return False + if member_name in cls.__dict__: + return False + if member_name in get_attr(cls, '__annotations__', {}): + return False + return False diff --git a/sphinx/ext/autodoc/_dynamic/_mock.py b/sphinx/ext/autodoc/_dynamic/_mock.py new file mode 100644 index 00000000000..e45d03a877a --- /dev/null +++ b/sphinx/ext/autodoc/_dynamic/_mock.py @@ -0,0 +1,220 @@ +"""mock for autodoc""" + +from __future__ import annotations + +import contextlib +import os +import sys +from importlib.abc import Loader, MetaPathFinder +from importlib.machinery import ModuleSpec +from types import MethodType, ModuleType +from typing import TYPE_CHECKING + +from sphinx.ext.autodoc._shared import LOGGER +from sphinx.util.inspect import isboundmethod, safe_getattr + +if TYPE_CHECKING: + from collections.abc import Iterator, Sequence, Set + from typing import Any + + from typing_extensions import TypeIs + + +class _MockObject: + """Used by autodoc_mock_imports.""" + + __display_name__ = '_MockObject' + __name__ = '' + __sphinx_mock__ = True + __sphinx_decorator_args__: tuple[Any, ...] = () + # Attributes listed here should not be mocked and rather raise an Attribute error: + __sphinx_empty_attrs__: Set[str] = frozenset(('__typing_subst__',)) + + def __new__(cls, *args: Any, **kwargs: Any) -> Any: # NoQA: ARG004 + if len(args) == 3 and isinstance(args[1], tuple): + superclass = args[1][-1].__class__ + if superclass is cls: + # subclassing MockObject + return _make_subclass( + args[0], + superclass.__display_name__, + superclass=superclass, + attributes=args[2], + ) + + return super().__new__(cls) + + def __init__(self, *args: Any, **kwargs: Any) -> None: + self.__qualname__ = self.__name__ + + def __len__(self) -> int: + return 0 + + def __contains__(self, key: str) -> bool: + return False + + def __iter__(self) -> Iterator[Any]: + return iter(()) + + def __mro_entries__(self, bases: tuple[Any, ...]) -> tuple[type, ...]: + return (self.__class__,) + + def __getitem__(self, key: Any) -> _MockObject: + return _make_subclass(str(key), self.__display_name__, self.__class__)() + + def __getattr__(self, key: str) -> _MockObject: + if key in self.__sphinx_empty_attrs__: + raise AttributeError + return _make_subclass(key, self.__display_name__, self.__class__)() + + def __call__(self, *args: Any, **kwargs: Any) -> Any: + call = self.__class__() + call.__sphinx_decorator_args__ = args + return call + + def __repr__(self) -> str: + return self.__display_name__ + + +def _make_subclass( + name: str, + module: str, + superclass: Any = _MockObject, + attributes: Any = None, + decorator_args: tuple[Any, ...] = (), +) -> Any: + attrs = { + '__module__': module, + '__display_name__': module + '.' + name, + '__name__': name, + '__sphinx_decorator_args__': decorator_args, + } + attrs.update(attributes or {}) + + return type(name, (superclass,), attrs) + + +class _MockModule(ModuleType): + """Used by autodoc_mock_imports.""" + + __file__ = os.devnull + __sphinx_mock__ = True + + def __init__(self, name: str) -> None: + super().__init__(name) + self.__all__: list[str] = [] + self.__path__: list[str] = [] + + def __getattr__(self, name: str) -> _MockObject: + return _make_subclass(name, self.__name__)() + + def __repr__(self) -> str: + return self.__name__ + + +class MockLoader(Loader): + """A loader for mocking.""" + + def __init__(self, finder: MockFinder) -> None: + super().__init__() + self.finder = finder + + def create_module(self, spec: ModuleSpec) -> ModuleType: + LOGGER.debug('[autodoc] adding a mock module as %s!', spec.name) + self.finder.mocked_modules.append(spec.name) + return _MockModule(spec.name) + + def exec_module(self, module: ModuleType) -> None: + pass # nothing to do + + +class MockFinder(MetaPathFinder): + """A finder for mocking.""" + + def __init__(self, modnames: Sequence[str]) -> None: + super().__init__() + self.modnames = modnames + self.loader = MockLoader(self) + self.mocked_modules: list[str] = [] + + def find_spec( + self, + fullname: str, + path: Sequence[bytes | str] | None, + target: ModuleType | None = None, + ) -> ModuleSpec | None: + for modname in self.modnames: + # check if fullname is (or is a descendant of) one of our targets + if modname == fullname or fullname.startswith(modname + '.'): + return ModuleSpec(fullname, self.loader) + + return None + + def invalidate_caches(self) -> None: + """Invalidate mocked modules on sys.modules.""" + for modname in self.mocked_modules: + sys.modules.pop(modname, None) + + +@contextlib.contextmanager +def mock(modnames: Sequence[str]) -> Iterator[None]: + """Insert mock modules during context:: + + with mock(['target.module.name']): + # mock modules are enabled here + ... + """ + finder = MockFinder(modnames) + try: + sys.meta_path.insert(0, finder) + yield + finally: + sys.meta_path.remove(finder) + finder.invalidate_caches() + + +def ismockmodule(subject: Any) -> TypeIs[_MockModule]: + """Check if the object is a mocked module.""" + return isinstance(subject, _MockModule) + + +def ismock(subject: Any) -> bool: + """Check if the object is mocked.""" + # check the object has '__sphinx_mock__' attribute + try: + if safe_getattr(subject, '__sphinx_mock__', None) is None: + return False + except AttributeError: + return False + + # check the object is mocked module + if isinstance(subject, _MockModule): + return True + + # check the object is bound method + if isinstance(subject, MethodType) and isboundmethod(subject): + tmp_subject = subject.__func__ + else: + tmp_subject = subject + + try: + # check the object is mocked object + __mro__ = safe_getattr(type(tmp_subject), '__mro__', []) + if len(__mro__) > 2 and __mro__[-2] is _MockObject: + # A mocked object has a MRO that ends with (..., _MockObject, object). + return True + except AttributeError: + pass + + return False + + +def undecorate(subject: _MockObject) -> Any: + """Unwrap mock if *subject* is decorated by mocked object. + + If not decorated, returns given *subject* itself. + """ + if ismock(subject) and subject.__sphinx_decorator_args__: + return subject.__sphinx_decorator_args__[0] + else: + return subject diff --git a/sphinx/ext/autodoc/_dynamic/_preserve_defaults.py b/sphinx/ext/autodoc/_dynamic/_preserve_defaults.py new file mode 100644 index 00000000000..082f3382cc2 --- /dev/null +++ b/sphinx/ext/autodoc/_dynamic/_preserve_defaults.py @@ -0,0 +1,157 @@ +"""Preserve function defaults. + +Preserve the default argument values of function signatures in source code +and keep them not evaluated for readability. +""" + +from __future__ import annotations + +import ast +import inspect +import types +from typing import TYPE_CHECKING + +from sphinx.ext.autodoc._shared import LOGGER +from sphinx.locale import __ +from sphinx.pycode.ast import unparse as ast_unparse + +if TYPE_CHECKING: + from typing import Any + + +_LAMBDA_NAME = (lambda: None).__name__ + + +class DefaultValue: + def __init__(self, name: str) -> None: + self.name = name + + def __repr__(self) -> str: + return self.name + + +def _get_arguments(obj: Any, /) -> ast.arguments | None: + """Parse 'ast.arguments' from an object. + + This tries to parse the original code for an object and returns + an 'ast.arguments' node. + """ + try: + source = inspect.getsource(obj) + if source.startswith((' ', '\t')): + # 'obj' is in some indented block. + module = ast.parse('if True:\n' + source) + subject = module.body[0].body[0] # type: ignore[attr-defined] + else: + module = ast.parse(source) + subject = module.body[0] + except (OSError, TypeError): + # bail; failed to load source for 'obj'. + return None + except SyntaxError: + if _is_lambda(obj): + # Most likely a multi-line arising from detecting a lambda, e.g.: + # + # class Egg: + # x = property( + # lambda self: 1, doc="...") + return None + + # Other syntax errors that are not due to the fact that we are + # documenting a lambda function are propagated + # (in particular if a lambda is renamed by the user). + raise + + return _get_arguments_inner(subject) + + +def _is_lambda(x: Any, /) -> bool: + return isinstance(x, types.LambdaType) and x.__name__ == _LAMBDA_NAME + + +def _get_arguments_inner(x: Any, /) -> ast.arguments | None: + if isinstance(x, (ast.AsyncFunctionDef, ast.FunctionDef, ast.Lambda)): + return x.args + if isinstance(x, (ast.Assign, ast.AnnAssign)): + return _get_arguments_inner(x.value) + return None + + +def get_default_value(lines: list[str], position: ast.expr) -> str | None: + try: + if position.lineno == position.end_lineno: + line = lines[position.lineno - 1] + return line[position.col_offset : position.end_col_offset] + else: + # multiline value is not supported now + return None + except (AttributeError, IndexError): + return None + + +def update_default_value(obj: Any, bound_method: bool) -> None: + """Update default value info of *obj* using type_comments.""" + try: + lines = inspect.getsource(obj).splitlines() + if lines[0].startswith((' ', '\t')): + # insert a dummy line to follow what _get_arguments() does. + lines.insert(0, '') + except (OSError, TypeError): + lines = [] + + try: + args = _get_arguments(obj) + except SyntaxError: + return + if args is None: + # If the object is a built-in, we won't be always able to recover + # the function definition and its arguments. This happens if *obj* + # is the `__init__` method generated automatically for dataclasses. + return + + if not args.defaults and not args.kw_defaults: + return + + try: + if bound_method and inspect.ismethod(obj) and hasattr(obj, '__func__'): + sig = inspect.signature(obj.__func__) + else: + sig = inspect.signature(obj) + defaults = list(args.defaults) + kw_defaults = list(args.kw_defaults) + parameters = list(sig.parameters.values()) + for i, param in enumerate(parameters): + if param.default is param.empty: + if param.kind == param.KEYWORD_ONLY: + # Consume kw_defaults for kwonly args + kw_defaults.pop(0) + else: + if param.kind in {param.POSITIONAL_ONLY, param.POSITIONAL_OR_KEYWORD}: + default = defaults.pop(0) + value = get_default_value(lines, default) + if value is None: + value = ast_unparse(default) + parameters[i] = param.replace(default=DefaultValue(value)) + else: + default = kw_defaults.pop(0) # type: ignore[assignment] + value = get_default_value(lines, default) + if value is None: + value = ast_unparse(default) + parameters[i] = param.replace(default=DefaultValue(value)) + + sig = sig.replace(parameters=parameters) + try: + obj.__signature__ = sig + except AttributeError: + # __signature__ can't be set directly on bound methods. + obj.__dict__['__signature__'] = sig + except (AttributeError, TypeError): + # Failed to update signature (e.g. built-in or extension types). + # For user-defined functions, "obj" may not have __dict__, + # e.g. when decorated with a class that defines __slots__. + # In this case, we can't set __signature__. + return + except NotImplementedError as exc: # failed to ast_unparse() + LOGGER.warning( + __('Failed to parse a default argument value for %r: %s'), obj, exc + ) diff --git a/sphinx/ext/autodoc/_dynamic/_signatures.py b/sphinx/ext/autodoc/_dynamic/_signatures.py new file mode 100644 index 00000000000..de55c44fb9f --- /dev/null +++ b/sphinx/ext/autodoc/_dynamic/_signatures.py @@ -0,0 +1,646 @@ +"""Signature utilities for autodoc""" + +from __future__ import annotations + +import sys +from inspect import Parameter, Signature +from typing import TYPE_CHECKING, NewType, TypeVar + +from sphinx.errors import PycodeError +from sphinx.ext.autodoc._dynamic._preserve_defaults import update_default_value +from sphinx.ext.autodoc._dynamic._type_annotations import _record_typehints +from sphinx.ext.autodoc._dynamic._type_comments import ( + _update_annotations_using_type_comments, +) +from sphinx.ext.autodoc._names import py_ext_sig_re +from sphinx.ext.autodoc._property_types import _AssignStatementProperties +from sphinx.ext.autodoc._shared import LOGGER +from sphinx.locale import __ +from sphinx.pycode import ModuleAnalyzer +from sphinx.util import inspect +from sphinx.util.docstrings import prepare_docstring +from sphinx.util.inspect import ( + _stringify_signature_to_parts, + evaluate_signature, + safe_getattr, +) + +if TYPE_CHECKING: + from collections.abc import Callable, Mapping + from typing import Any + + from sphinx.events import EventManager + from sphinx.ext.autodoc._directive_options import _AutoDocumenterOptions + from sphinx.ext.autodoc._property_types import _ItemProperties + from sphinx.ext.autodoc._shared import _AttrGetter, _AutodocConfig + + type _FormattedSignature = tuple[str, str] + + +def _format_signatures( + *, + autodoc_annotations: dict[str, dict[str, str]], + config: _AutodocConfig, + docstrings: list[list[str]] | None, + events: EventManager, + get_attr: _AttrGetter, + parent: Any, + options: _AutoDocumenterOptions, + props: _ItemProperties, + args: str | None = None, + retann: str | None = '', + **kwargs: Any, +) -> list[_FormattedSignature]: + """Format the signature (arguments and return annotation) of the object. + + Let the user process it via the ``autodoc-process-signature`` event. + """ + if props.obj_type in {'class', 'exception'}: + from sphinx.ext.autodoc._property_types import _ClassDefProperties + + assert isinstance(props, _ClassDefProperties) + if props.doc_as_attr: + return [] + if config.autodoc_class_signature == 'separated': + # do not show signatures + return [] + + if config.autodoc_typehints_format == 'short': + kwargs.setdefault('unqualified_typehints', True) + if config.python_display_short_literal_types: + kwargs.setdefault('short_literals', True) + + if args is None: + signatures: list[_FormattedSignature] = [] + else: + signatures = [(args, retann or '')] + + if ( + not signatures + and config.autodoc_docstring_signature + and props.obj_type not in {'module', 'data', 'type'} + and docstrings is not None + ): + # only act if a signature is not explicitly given already, + # and if the feature is enabled + signatures[:] = _extract_signatures_from_docstrings( + docstrings, props=props, tab_width=options._tab_width + ) + + if not signatures: + # try to introspect the signature + try: + signatures[:] = _extract_signature_from_object( + config=config, + events=events, + get_attr=get_attr, + parent=parent, + props=props, + **kwargs, + ) + except Exception as exc: + msg = __('error while formatting arguments for %s: %s') + LOGGER.warning(msg, props.full_name, exc, type='autodoc') + + if props.obj_type in {'attribute', 'property'}: + # Only keep the return annotation + signatures = [('', retann) for _args, retann in signatures] + + _record_typehints( + autodoc_annotations=autodoc_annotations, + name=props.full_name, + obj=props._obj, + short_literals=kwargs.get('short_literals', False), + type_aliases=config.autodoc_type_aliases, + unqualified_typehints=kwargs.get('unqualified_typehints', False), + ) + if result := events.emit_firstresult( + 'autodoc-process-signature', + props.obj_type, + props.full_name, + props._obj, + options, + signatures[0][0] if signatures else None, # args + signatures[0][1] if signatures else '', # retann + ): + if len(result) == 2 and isinstance(result[0], str): + args, retann = result + signatures[0] = (args, retann if isinstance(retann, str) else '') + + if props.obj_type in {'module', 'data', 'type'}: + signatures[1:] = () # discard all signatures save the first + + analyzer_overloads: dict[str, list[Signature]] = {} + try: + analyzer = ModuleAnalyzer.for_module(props.canonical_module_name) + # parse right now, to get PycodeErrors on parsing (results will + # be cached anyway) + analyzer.analyze() + except PycodeError as exc: + LOGGER.debug('[autodoc] module analyzer failed: %s', exc) + # no source file -- e.g. for builtin and C modules + else: + analyzer_overloads = analyzer.overloads + + if props.obj_type in {'function', 'decorator'}: + overloaded = ( + props.dotted_parts in analyzer_overloads + and config.autodoc_typehints != 'none' + ) + is_singledispatch = inspect.is_singledispatch_function(props._obj) + + if overloaded: + # Use signatures for overloaded functions and methods instead of + # their implementations. + signatures.clear() + elif not is_singledispatch: + return signatures + + if is_singledispatch: + from sphinx.ext.autodoc._property_types import _FunctionDefProperties + + # append signature of singledispatch'ed functions + for typ, func in props._obj.registry.items(): + if typ is object: + continue # default implementation. skipped. + dispatch_func = _annotate_to_first_argument( + func, typ, config=config, props=props + ) + if not dispatch_func: + continue + dispatch_props = _FunctionDefProperties( + obj_type='function', + module_name='', + parts=('',), + docstring_lines=(), + signatures=(), + _obj=dispatch_func, + _obj___module__=None, + _obj___qualname__=None, + _obj___name__=None, + properties=frozenset(), + ) + signatures += _format_signatures( + autodoc_annotations=autodoc_annotations, + config=config, + docstrings=None, + events=events, + get_attr=get_attr, + parent=None, + options=options, + props=dispatch_props, + ) + if overloaded: + actual = inspect.signature( + props._obj, type_aliases=config.autodoc_type_aliases + ) + obj_globals = safe_getattr(props._obj, '__globals__', {}) + overloads = analyzer_overloads[props.dotted_parts] + for overload in overloads: + overload = _merge_default_value(actual, overload) + overload = evaluate_signature( + overload, obj_globals, config.autodoc_type_aliases + ) + signatures.append(_stringify_signature_to_parts(overload, **kwargs)) + + return signatures + + if props.obj_type in {'class', 'exception'}: + from sphinx.ext.autodoc._property_types import _ClassDefProperties + + assert isinstance(props, _ClassDefProperties) + method_name = props._signature_method_name + if method_name == '__call__': + signature_cls = type(props._obj) + else: + signature_cls = props._obj + overloads = [] + overloaded = False + if method_name: + for cls in signature_cls.__mro__: + try: + analyzer = ModuleAnalyzer.for_module(cls.__module__) + analyzer.analyze() + except PycodeError: + pass + else: + qualname = f'{cls.__qualname__}.{method_name}' + if qualname in analyzer.overloads: + overloads = analyzer.overloads[qualname] + overloaded = True + break + if qualname in analyzer.tagorder: + # the constructor is defined in the class, but not overridden. + break + if overloaded and config.autodoc_typehints != 'none': + # Use signatures for overloaded methods instead of the implementation method. + signatures.clear() + method = safe_getattr(signature_cls, method_name, None) + method_globals = safe_getattr(method, '__globals__', {}) + for overload in overloads: + overload = evaluate_signature( + overload, method_globals, config.autodoc_type_aliases + ) + + parameters = list(overload.parameters.values()) + overload = overload.replace( + parameters=parameters[1:], return_annotation=Parameter.empty + ) + signatures.append(_stringify_signature_to_parts(overload, **kwargs)) + return signatures + + return signatures + + if props.obj_type == 'method': + overloaded = ( + props.dotted_parts in analyzer_overloads + and config.autodoc_typehints != 'none' + ) + meth = parent.__dict__.get(props.name) + is_singledispatch = inspect.is_singledispatch_method(meth) + + if overloaded: + # Use signatures for overloaded functions and methods instead of + # their implementations. + signatures.clear() + elif not is_singledispatch: + return signatures + + if is_singledispatch: + from sphinx.ext.autodoc._property_types import _FunctionDefProperties + + # append signature of singledispatch'ed methods + for typ, func in meth.dispatcher.registry.items(): + if typ is object: + continue # default implementation. skipped. + if inspect.isclassmethod(func): + func = func.__func__ + dispatch_meth = _annotate_to_first_argument( + func, typ, config=config, props=props + ) + if not dispatch_meth: + continue + dispatch_props = _FunctionDefProperties( + obj_type='method', + module_name='', + parts=('',), + docstring_lines=(), + signatures=(), + _obj=dispatch_meth, + _obj___module__=None, + _obj___qualname__=None, + _obj___name__=None, + properties=frozenset(), + ) + signatures += _format_signatures( + autodoc_annotations=autodoc_annotations, + config=config, + docstrings=None, + events=events, + get_attr=get_attr, + parent=parent, + options=options, + props=dispatch_props, + ) + if overloaded: + from sphinx.ext.autodoc._property_types import _FunctionDefProperties + + assert isinstance(props, _FunctionDefProperties) + actual = inspect.signature( + props._obj, + bound_method=not props.is_staticmethod, + type_aliases=config.autodoc_type_aliases, + ) + + obj_globals = safe_getattr(props._obj, '__globals__', {}) + overloads = analyzer_overloads[props.dotted_parts] + for overload in overloads: + overload = _merge_default_value(actual, overload) + overload = evaluate_signature( + overload, obj_globals, config.autodoc_type_aliases + ) + + if not props.is_staticmethod: + # hide the first argument (e.g. 'self') + parameters = list(overload.parameters.values()) + overload = overload.replace(parameters=parameters[1:]) + signatures.append(_stringify_signature_to_parts(overload, **kwargs)) + + return signatures + + return signatures + + +def _extract_signatures_from_docstrings( + docstrings: list[list[str]], + /, + props: _ItemProperties, + tab_width: int, +) -> list[_FormattedSignature]: + signatures: list[_FormattedSignature] = [] + + # candidates of the object name + valid_names = {props.name} + if props.obj_type in {'class', 'exception'}: + valid_names.add('__init__') + if hasattr(props._obj, '__mro__'): + valid_names |= {cls.__name__ for cls in props._obj.__mro__} + + stripped_docstrings = [list(l) for l in (docstrings or ())] + for i, doclines in enumerate(docstrings): + j = 0 + for j, line in enumerate(doclines): # NoQA: B007 + if not line: + # no lines in docstring, no match + break + line = line.rstrip('\\').rstrip() + + # match first line of docstring against signature RE + match = py_ext_sig_re.match(line) + if not match: + break + _exmod, _path, base, _tp_list, args, retann = match.groups() + if args is not None: + args = f'({args})' + else: + args = '' # i.e. property or attribute + + # the base name must match ours + if base not in valid_names: + break + + if props.obj_type in {'class', 'exception'} and retann == 'None': + # Strip a return value from signatures of constructor in docstring + signatures.append((args, '')) + else: + signatures.append((args, retann or '')) + + if signatures: + # re-prepare docstring to ignore more leading indentation + stripped_docstrings[i] = prepare_docstring( + '\n'.join(doclines[j:]), tab_width + ) + + # finish the loop after finding at least one signature + break + + if not signatures: + return [] + + # Update docstrings from stripped_docstrings if needed + if props.obj_type in { + 'class', + 'exception', + 'function', + 'method', + 'property', + 'decorator', + } or ( + props.obj_type == 'attribute' + and isinstance(props, _AssignStatementProperties) + and props._obj_is_attribute_descriptor + ): + docstrings[:] = stripped_docstrings + + return signatures + + +def _extract_signature_from_object( + config: _AutodocConfig, + events: EventManager, + get_attr: _AttrGetter, + parent: Any, + props: _ItemProperties, + **kwargs: Any, +) -> list[_FormattedSignature]: + """Format the signature using runtime introspection.""" + sig = _get_signature_object( + events=events, + get_attr=get_attr, + parent=parent, + preserve_defaults=config.autodoc_preserve_defaults, + props=props, + type_aliases=config.autodoc_type_aliases, + use_type_comments=config.autodoc_use_type_comments, + ) + if sig is None: + return [] + + if props.obj_type == 'decorator' and len(sig.parameters) == 1: + # Special case for single-argument decorators + return [('', '')] + + if config.autodoc_typehints in {'none', 'description'}: + kwargs.setdefault('show_annotation', False) + if config.autodoc_typehints_format == 'short': + kwargs.setdefault('unqualified_typehints', True) + if config.python_display_short_literal_types: + kwargs.setdefault('short_literals', True) + if props.obj_type in {'class', 'exception'}: + kwargs['show_return_annotation'] = False + + args, retann = _stringify_signature_to_parts(sig, **kwargs) + if config.strip_signature_backslash: + # escape backslashes for reST + args = args.replace('\\', '\\\\') + retann = retann.replace('\\', '\\\\') + + return [(args, retann)] + + +# Types which have confusing metaclass signatures it would be best not to show. +# These are listed by name, rather than storing the objects themselves, to avoid +# needing to import the modules. +_METACLASS_CALL_BLACKLIST = frozenset({ + 'enum.EnumType.__call__', +}) + + +# Types whose __new__ signature is a pass-through. +_CLASS_NEW_BLACKLIST = frozenset({ + 'typing.Generic.__new__', +}) + + +def _get_signature_object( + events: EventManager, + get_attr: _AttrGetter, + parent: Any, + preserve_defaults: bool, + props: _ItemProperties, + type_aliases: Mapping[str, str] | None, + use_type_comments: bool, +) -> Signature | None: + """Return a Signature for *obj*, or None on failure.""" + obj, is_bound_method = _get_object_for_signature( + props=props, get_attr=get_attr, parent=parent, type_aliases=type_aliases + ) + if obj is None or isinstance(obj, Signature): + return obj + + if preserve_defaults: + update_default_value(obj, bound_method=is_bound_method) + if use_type_comments: + _update_annotations_using_type_comments(obj, bound_method=is_bound_method) + events.emit('autodoc-before-process-signature', obj, is_bound_method) + + if props.obj_type in {'class', 'exception', 'function', 'method', 'decorator'}: + try: + return inspect.signature( + obj, bound_method=is_bound_method, type_aliases=type_aliases + ) + except TypeError as exc: + if props.obj_type in {'class', 'exception'}: + msg = __('Failed to get a constructor signature for %s: %s') + elif props.obj_type in {'function', 'decorator'}: + msg = __('Failed to get a function signature for %s: %s') + elif props.obj_type == 'method': + msg = __('Failed to get a method signature for %s: %s') + else: + msg = __('Failed to get a signature for %s: %s') + LOGGER.warning(msg, props.full_name, exc) + return None + except ValueError: + # Still no signature: happens e.g. for old-style classes + # with __init__ in C and no `__text_signature__`. + return None + + return None + + +def _get_object_for_signature( + props: _ItemProperties, + get_attr: _AttrGetter, + parent: Any, + type_aliases: Mapping[str, str] | None, +) -> tuple[Any, bool]: + """Return the object from which we will obtain the signature.""" + obj = props._obj + if props.obj_type in {'function', 'decorator'}: + return obj, False + + if props.obj_type in {'class', 'exception'}: + if isinstance(obj, (NewType, TypeVar)): + # Suppress signature + return None, False + + try: + object_sig = obj.__signature__ + except AttributeError: + pass + else: + if isinstance(object_sig, Signature): + return object_sig, False + if sys.version_info[:2] <= (3, 14) and callable(object_sig): + # Support for enum.Enum.__signature__ in Python 3.12 & 3.13 + if isinstance(object_sig_str := object_sig(), str): + return inspect.signature_from_str(object_sig_str), False + + def get_user_defined_function_or_method(obj: Any, attr: str) -> Any: + """Get the `attr` function or method from `obj`, if it is user-defined.""" + if inspect.is_builtin_class_method(obj, attr): + return None + attr = get_attr(obj, attr, None) + if not (inspect.ismethod(attr) or inspect.isfunction(attr)): + return None + return attr + + # This sequence is copied from inspect._signature_from_callable. + # ValueError means that no signature could be found, so we keep going. + + # Let's see if it has an overloaded __call__ defined in its metaclass, + # or if the 'obj' class has a '__new__' or '__init__' method + for obj_, meth_name, blacklist in ( + (type(obj), '__call__', _METACLASS_CALL_BLACKLIST), + (obj, '__new__', _CLASS_NEW_BLACKLIST), + (obj, '__init__', frozenset()), + ): + meth = get_user_defined_function_or_method(obj_, meth_name) + if meth is None: + continue + if blacklist: + if f'{meth.__module__}.{meth.__qualname__}' in blacklist: + continue + + try: + inspect.signature(meth, bound_method=True, type_aliases=type_aliases) + except TypeError: + return meth, True # _get_signature_object() needs to log the failure + except ValueError: + continue + else: + from sphinx.ext.autodoc._property_types import _ClassDefProperties + + assert isinstance(props, _ClassDefProperties) + props._signature_method_name = meth_name + return meth, True + + # None of the attributes are user-defined, so fall back to let inspect + # handle it. + # We don't know the exact method that inspect.signature will read + # the signature from, so just return the object itself to be passed + # to the ``autodoc-before-process-signature`` hook. + return obj, False + + if props.obj_type == 'method': + if obj == object.__init__ and parent != object: # NoQA: E721 + # Classes not having own __init__() method are shown as no arguments. + # + # Note: The signature of object.__init__() is (self, /, *args, **kwargs). + # But it makes users confused. + return Signature(), False + + is_bound_method = not inspect.isstaticmethod( + obj, cls=parent, name=props.object_name + ) + return obj, is_bound_method + + return None, False + + +def _annotate_to_first_argument( + func: Callable[..., Any], + typ: type, + *, + config: _AutodocConfig, + props: _ItemProperties, +) -> Callable[..., Any] | None: + """Annotate type hint to the first argument of function if needed.""" + try: + sig = inspect.signature(func, type_aliases=config.autodoc_type_aliases) + except TypeError as exc: + msg = __('Failed to get a function signature for %s: %s') + LOGGER.warning(msg, props.full_name, exc) + return None + except ValueError: + return None + + first_arg_idx = 1 * (props.obj_type == 'method') + if len(sig.parameters) == first_arg_idx: + return None + + def dummy(): # type: ignore[no-untyped-def] # NoQA: ANN202 + pass + + params = list(sig.parameters.values()) + if params[first_arg_idx].annotation is Parameter.empty: + params[first_arg_idx] = params[first_arg_idx].replace(annotation=typ) + try: + dummy.__signature__ = sig.replace(parameters=params) # type: ignore[attr-defined] + return dummy + except (AttributeError, TypeError): + # failed to update signature (ex. built-in or extension types) + return None + + return func + + +def _merge_default_value(actual: Signature, overload: Signature) -> Signature: + """Merge default values of actual implementation to the overload variants.""" + parameters = list(overload.parameters.values()) + for i, param in enumerate(parameters): + actual_param = actual.parameters.get(param.name) + if actual_param and param.default == '...': + parameters[i] = param.replace(default=actual_param.default) + + return overload.replace(parameters=parameters) diff --git a/sphinx/ext/autodoc/_dynamic/_type_annotations.py b/sphinx/ext/autodoc/_dynamic/_type_annotations.py new file mode 100644 index 00000000000..4772a4c2795 --- /dev/null +++ b/sphinx/ext/autodoc/_dynamic/_type_annotations.py @@ -0,0 +1,45 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING + +from sphinx.util import inspect +from sphinx.util.typing import stringify_annotation + +if TYPE_CHECKING: + from collections.abc import Mapping + from typing import Any + + from sphinx.util.typing import _StringifyMode + + +def _record_typehints( + *, + autodoc_annotations: dict[str, dict[str, str]], + name: str, + obj: Any, + short_literals: bool, + type_aliases: Mapping[str, str] | None, + unqualified_typehints: bool, +) -> None: + """Record type hints to env object.""" + mode: _StringifyMode + if unqualified_typehints: + mode = 'smart' + else: + mode = 'fully-qualified' + + try: + if callable(obj): + annotation = autodoc_annotations.setdefault(name, {}) + sig = inspect.signature(obj, type_aliases=type_aliases) + for param in sig.parameters.values(): + if param.annotation is not param.empty: + annotation[param.name] = stringify_annotation( + param.annotation, mode, short_literals=short_literals + ) + if sig.return_annotation is not sig.empty: + annotation['return'] = stringify_annotation( + sig.return_annotation, mode, short_literals=short_literals + ) + except (TypeError, ValueError): + pass diff --git a/sphinx/ext/autodoc/_dynamic/_type_comments.py b/sphinx/ext/autodoc/_dynamic/_type_comments.py new file mode 100644 index 00000000000..060fa5480a7 --- /dev/null +++ b/sphinx/ext/autodoc/_dynamic/_type_comments.py @@ -0,0 +1,229 @@ +"""Update annotations info of living objects using type_comments.""" + +from __future__ import annotations + +import ast +import contextlib +import sys +from inspect import Parameter, Signature, getsource +from types import ModuleType +from typing import TYPE_CHECKING, cast +from weakref import WeakSet + +from sphinx.errors import PycodeError +from sphinx.ext.autodoc._shared import LOGGER +from sphinx.locale import __ +from sphinx.pycode import ModuleAnalyzer +from sphinx.pycode.ast import unparse as ast_unparse +from sphinx.util import inspect +from sphinx.util.inspect import safe_getattr + +if TYPE_CHECKING: + from collections.abc import Sequence + from typing import Any + + +_objects_with_type_comment_annotations: WeakSet[Any] = WeakSet() +"""Cache of objects with annotations updated from type comments.""" + + +def _ensure_annotations_from_type_comments(obj: Any) -> None: + """Ensures `obj.__annotations__` includes type comment information. + + Failures to assign to `__annotations__` are silently ignored. + + If `obj` is a class type, this also ensures that type comment + information is incorporated into the `__annotations__` member of + all parent classes, if possible. + + This mutates the `__annotations__` of existing imported objects, + in order to allow the existing `typing.get_type_hints` method to + take the modified annotations into account. + + Modifying existing imported objects is unfortunate but avoids the + need to reimplement `typing.get_type_hints` in order to take into + account type comment information. + + Note that this does not directly include type comment information + from parent classes, but `typing.get_type_hints` takes that into + account. + """ + if obj in _objects_with_type_comment_annotations: + return + _objects_with_type_comment_annotations.add(obj) + + if isinstance(obj, type): + for cls in inspect.getmro(obj): + modname = safe_getattr(cls, '__module__') + mod = sys.modules.get(modname) + if mod is not None: + _ensure_annotations_from_type_comments(mod) + + elif isinstance(obj, ModuleType): + _update_module_annotations_from_type_comments(obj) + + +def _update_module_annotations_from_type_comments(mod: ModuleType) -> None: + """Adds type comment annotations for a single module. + + Both module-level and class-level annotations are added. + """ + mod_annotations = dict(inspect.getannotations(mod)) + mod.__annotations__ = mod_annotations + + class_annotations: dict[str, dict[str, Any]] = {} + + try: + analyzer = ModuleAnalyzer.for_module(mod.__name__) + analyzer.analyze() + anns = analyzer.annotations + for (classname, attrname), annotation in anns.items(): + if not classname: + annotations = mod_annotations + else: + cls_annotations = class_annotations.get(classname) + if cls_annotations is None: + try: + cls = mod + for part in classname.split('.'): + cls = safe_getattr(cls, part) + annotations = dict(inspect.getannotations(cls)) + # Ignore errors setting __annotations__ + with contextlib.suppress(TypeError, AttributeError): + cls.__annotations__ = annotations + except AttributeError: + annotations = {} + class_annotations[classname] = annotations + else: + annotations = cls_annotations + annotations.setdefault(attrname, annotation) + except PycodeError: + pass + + +def _update_annotations_using_type_comments(obj: Any, bound_method: bool) -> None: + """Update annotations info of *obj* using type_comments.""" + try: + type_sig = get_type_comment(obj, bound_method) + if type_sig: + sig = inspect.signature(obj, bound_method) + for param in sig.parameters.values(): + if param.name not in obj.__annotations__: + annotation = type_sig.parameters[param.name].annotation + if annotation is not Parameter.empty: + obj.__annotations__[param.name] = ast_unparse(annotation) + + if 'return' not in obj.__annotations__: + obj.__annotations__['return'] = type_sig.return_annotation + except KeyError as exc: + LOGGER.warning( + __('Failed to update signature for %r: parameter not found: %s'), obj, exc + ) + except NotImplementedError as exc: # failed to ast.unparse() + LOGGER.warning(__('Failed to parse type_comment for %r: %s'), obj, exc) + + +def get_type_comment(obj: Any, bound_method: bool = False) -> Signature | None: + """Get type_comment'ed FunctionDef object from living object. + + This tries to parse original code for living object and returns + Signature for given *obj*. + """ + try: + source = getsource(obj) + if source.startswith((' ', r'\t')): + # subject is placed inside class or block. To read its docstring, + # this adds if-block before the declaration. + module = ast.parse('if True:\n' + source, type_comments=True) + subject = cast('ast.FunctionDef', module.body[0].body[0]) # type: ignore[attr-defined] + else: + module = ast.parse(source, type_comments=True) + subject = cast('ast.FunctionDef', module.body[0]) + + type_comment = getattr(subject, 'type_comment', None) + if type_comment: + function = ast.parse(type_comment, mode='func_type', type_comments=True) + return signature_from_ast(subject, bound_method, function) + else: + return None + except (OSError, TypeError): # failed to load source code + return None + except SyntaxError: # failed to parse type_comments + return None + + +def signature_from_ast( + node: ast.FunctionDef, bound_method: bool, type_comment: ast.FunctionDef +) -> Signature: + """Return a Signature object for the given *node*. + + :param bound_method: Specify *node* is a bound method or not + """ + params = [] + for arg in node.args.posonlyargs: + param = Parameter( + arg.arg, + Parameter.POSITIONAL_ONLY, + annotation=arg.type_comment, + ) + params.append(param) + + for arg in node.args.args: + param = Parameter( + arg.arg, + Parameter.POSITIONAL_OR_KEYWORD, + annotation=arg.type_comment or Parameter.empty, + ) + params.append(param) + + if node.args.vararg: + param = Parameter( + node.args.vararg.arg, + Parameter.VAR_POSITIONAL, + annotation=node.args.vararg.type_comment or Parameter.empty, + ) + params.append(param) + + for arg in node.args.kwonlyargs: + param = Parameter( + arg.arg, + Parameter.KEYWORD_ONLY, + annotation=arg.type_comment or Parameter.empty, + ) + params.append(param) + + if node.args.kwarg: + param = Parameter( + node.args.kwarg.arg, + Parameter.VAR_KEYWORD, + annotation=node.args.kwarg.type_comment or Parameter.empty, + ) + params.append(param) + + # Remove first parameter when *obj* is bound_method + if bound_method and params: + params.pop(0) + + # merge type_comment into signature + if not_suppressed(type_comment.argtypes): # type: ignore[attr-defined] + for i, param in enumerate(params): + params[i] = param.replace(annotation=type_comment.argtypes[i]) # type: ignore[attr-defined] + + if node.returns: + return Signature(params, return_annotation=node.returns) + elif type_comment.returns: + return Signature(params, return_annotation=ast_unparse(type_comment.returns)) + else: + return Signature(params) + + +def not_suppressed(argtypes: Sequence[ast.expr] = ()) -> bool: + """Check given *argtypes* is suppressed type_comment or not.""" + if len(argtypes) == 0: # no argtypees + return False + if len(argtypes) == 1: + arg = argtypes[0] + if isinstance(arg, ast.Constant) and arg.value is ...: # suppressed + return False + # not suppressed + return True diff --git a/sphinx/ext/autodoc/_event_listeners.py b/sphinx/ext/autodoc/_event_listeners.py new file mode 100644 index 00000000000..ec04fbec2f8 --- /dev/null +++ b/sphinx/ext/autodoc/_event_listeners.py @@ -0,0 +1,169 @@ +"""Some useful event listener factories for autodoc-process-docstring.""" + +from __future__ import annotations + +import re +from typing import TYPE_CHECKING + +if TYPE_CHECKING: + from collections.abc import Sequence + from typing import Any, Protocol + + from sphinx.application import Sphinx + from sphinx.ext.autodoc._property_types import _AutodocObjType + + class _AutodocProcessDocstringListener(Protocol): + # parameter names are non-normative + def __call__( + self, + app: Sphinx, + obj_type: _AutodocObjType, + full_name: str, + obj: Any, + options: Any, + docstring_lines: list[str], + /, + ) -> None: ... + + class _AutodocBeforeProcessSignatureListener(Protocol): # NoQA: PYI046 + # parameter names are non-normative + def __call__( + self, + app: Sphinx, + obj: Any, + is_bound_method: bool, + /, + ) -> None: ... + + class _AutodocProcessSignatureListener(Protocol): # NoQA: PYI046 + # parameter names are non-normative + # returns: (args, retann) | None + def __call__( + self, + app: Sphinx, + obj_type: _AutodocObjType, + full_name: str, + obj: Any, + options: Any, + args: str | None, + retann: str | None, + /, + ) -> tuple[str | None, str | None] | None: ... + + class _AutodocProcessBasesListener(Protocol): # NoQA: PYI046 + # parameter names are non-normative + def __call__( + self, + app: Sphinx, + full_name: str, + obj: Any, + _unused: None, # previously: options + obj_bases: list[type], + /, + ) -> None: ... + + class _AutodocSkipMemberListener(Protocol): # NoQA: PYI046 + # parameter names are non-normative + # returns: skip_member + def __call__( + self, + app: Sphinx, + obj_type: _AutodocObjType, + member_name: str, + member_obj: Any, + skip: bool, + options: Any, + /, + ) -> bool | None: ... + + +def cut_lines( + pre: int, post: int = 0, what: Sequence[str] | None = None +) -> _AutodocProcessDocstringListener: + """Return a listener that removes the first *pre* and last *post* + lines of every docstring. If *what* is a sequence of strings, + only docstrings of a type in *what* will be processed. + + Use like this (e.g. in the ``setup()`` function of :file:`conf.py`):: + + from sphinx.ext.autodoc import cut_lines + + app.connect('autodoc-process-docstring', cut_lines(4, what={'module'})) + + This can (and should) be used in place of :confval:`automodule_skip_lines`. + """ + if not what: + what_unique: frozenset[str] = frozenset() + elif isinstance(what, str): # strongly discouraged + what_unique = frozenset({what}) + else: + what_unique = frozenset(what) + + def process( + app: Sphinx, + what_: _AutodocObjType, + name: str, + obj: Any, + options: Any, + lines: list[str], + ) -> None: + if what_unique and what_ not in what_unique: + return + del lines[:pre] + if post: + # remove one trailing blank line. + if lines and not lines[-1]: + lines.pop(-1) + del lines[-post:] + # make sure there is a blank line at the end + if lines and lines[-1]: + lines.append('') + + return process + + +def between( + marker: str, + what: Sequence[str] | None = None, + keepempty: bool = False, + exclude: bool = False, +) -> _AutodocProcessDocstringListener: + """Return a listener that either keeps, or if *exclude* is True excludes, + lines between lines that match the *marker* regular expression. If no line + matches, the resulting docstring would be empty, so no change will be made + unless *keepempty* is true. + + If *what* is a sequence of strings, only docstrings of a type in *what* will + be processed. + """ + marker_re = re.compile(marker) + + def process( + app: Sphinx, + what_: _AutodocObjType, + name: str, + obj: Any, + options: Any, + lines: list[str], + ) -> None: + if what and what_ not in what: + return + deleted = 0 + delete = not exclude + orig_lines = lines.copy() + for i, line in enumerate(orig_lines): + if delete: + lines.pop(i - deleted) + deleted += 1 + if marker_re.match(line): + delete = not delete + if delete: + lines.pop(i - deleted) + deleted += 1 + if not lines and not keepempty: + lines[:] = orig_lines + # make sure there is a blank line at the end + if lines and lines[-1]: + lines.append('') + + return process diff --git a/sphinx/ext/autodoc/_generate.py b/sphinx/ext/autodoc/_generate.py new file mode 100644 index 00000000000..b5f9714fb14 --- /dev/null +++ b/sphinx/ext/autodoc/_generate.py @@ -0,0 +1,406 @@ +from __future__ import annotations + +import sys +from typing import TYPE_CHECKING + +from docutils.statemachine import StringList + +from sphinx.errors import PycodeError +from sphinx.ext.autodoc._dynamic._loader import _load_object_by_name +from sphinx.ext.autodoc._dynamic._member_finder import _gather_members +from sphinx.ext.autodoc._dynamic._mock import ismock +from sphinx.ext.autodoc._renderer import _add_content, _directive_header_lines +from sphinx.ext.autodoc._sentinels import ALL +from sphinx.ext.autodoc._shared import LOGGER, _get_render_mode +from sphinx.locale import _, __ +from sphinx.pycode import ModuleAnalyzer +from sphinx.util import inspect +from sphinx.util.typing import restify, stringify_annotation + +if TYPE_CHECKING: + from collections.abc import Iterator, Mapping, MutableSet + + from sphinx.environment import _CurrentDocument + from sphinx.events import EventManager + from sphinx.ext.autodoc._directive_options import _AutoDocumenterOptions + from sphinx.ext.autodoc._property_types import _AutodocObjType, _ItemProperties + from sphinx.ext.autodoc._shared import _AttrGetter, _AutodocConfig + from sphinx.util.typing import _RestifyMode + + +def _auto_document_object( + *, + config: _AutodocConfig, + current_document: _CurrentDocument, + events: EventManager, + get_attr: _AttrGetter, + more_content: StringList | None, + name: str, + obj_type: _AutodocObjType, + options: _AutoDocumenterOptions, + record_dependencies: MutableSet[str], + ref_context: Mapping[str, str | None], + reread_always: MutableSet[str], +) -> StringList | None: + props = _load_object_by_name( + name=name, + objtype=obj_type, + current_document=current_document, + config=config, + events=events, + get_attr=get_attr, + options=options, + ref_context=ref_context, + reread_always=reread_always, + ) + if props is None: + return None + + result = StringList() + _generate_directives( + more_content=more_content, + config=config, + current_document=current_document, + events=events, + get_attr=get_attr, + indent='', + options=options, + props=props, + record_dependencies=record_dependencies, + ref_context=ref_context, + reread_always=reread_always, + result=result, + ) + return result + + +def _generate_directives( + more_content: StringList | None = None, + parent_modname: str | None = None, + check_module: bool = False, + all_members: bool = False, + *, + config: _AutodocConfig, + current_document: _CurrentDocument, + events: EventManager, + get_attr: _AttrGetter, + indent: str, + options: _AutoDocumenterOptions, + props: _ItemProperties, + record_dependencies: MutableSet[str], + ref_context: Mapping[str, str | None], + reread_always: MutableSet[str], + result: StringList, +) -> None: + """Generate reST for the object given by *props*, and possibly for its members. + + If *more_content* is given, include that content. If *parent_modname* is + given, use that module name to find attribute docs. If *check_module* is + True, only generate if the object is defined in the module name it is + imported from. If *all_members* is True, document all members. + """ + # If there is no parent module specified, figure out which to use. + # The real module is used in the module analyzer to look up the module + # where the attribute documentation would actually be found in. + # This is used for situations where you have a module that collects the + # functions and classes of internal submodules. + if parent_modname is None or props.obj_type in {'class', 'exception'}: + # If a class gets imported into the module ``parent_modname`` + # the analyzer won't find the source of the class, + # if it looks in ``parent_modname``. + real_modname = props.canonical_module_name + else: + real_modname = parent_modname + + # try to also get a source code analyzer for attribute docs + try: + analyzer = ModuleAnalyzer.for_module(real_modname) + # parse right now, to get PycodeErrors on parsing (results will + # be cached anyway) + analyzer.analyze() + record_dependencies.add(analyzer.srcname) + except PycodeError as exc: + LOGGER.debug('[autodoc] module analyzer failed: %s', exc) + # no source file -- e.g. for builtin and C modules + analyzer = None + # at least add the module source file as a dependency + if props.module_name: + try: + module_spec = sys.modules[props.module_name].__spec__ + except (AttributeError, KeyError): + pass + else: + if ( + module_spec is not None + and module_spec.has_location + and module_spec.origin + ): + record_dependencies.add(module_spec.origin) + + if real_modname != props.canonical_module_name: + # Add module to dependency list if target object is defined in other module. + try: + srcname, _ = ModuleAnalyzer.get_module_source(props.canonical_module_name) + record_dependencies.add(str(srcname)) + except PycodeError: + pass + + has_docstring = bool(props.docstring_lines) + if ismock(props._obj) and not has_docstring: + LOGGER.warning( + __('A mocked object is detected: %r'), + props.full_name, + type='autodoc', + subtype='mocked_object', + ) + + # check __module__ of object (for members not given explicitly) + if check_module and not options.imported_members: + subject = inspect.unpartial(props._obj) + modname = get_attr(subject, '__module__', None) + if modname and modname != props.module_name: + return + + # add all content (from docstrings, attribute docs etc.) + analyzer_source = '' if analyzer is None else analyzer.srcname + _add_directive_lines( + more_content=more_content, + is_final=analyzer is not None and props.dotted_parts in analyzer.finals, + config=config, + indent=indent, + options=options, + props=props, + result=result, + source_name=_docstring_source_name(props=props, source=analyzer_source), + ) + + # document members, if possible + _document_members( + all_members=all_members, + analyzer_order=analyzer.tagorder if analyzer is not None else {}, + attr_docs=analyzer.attr_docs if analyzer is not None else {}, + config=config, + current_document=current_document, + events=events, + get_attr=get_attr, + indent=indent, + options=options, + props=props, + real_modname=real_modname, + record_dependencies=record_dependencies, + ref_context=ref_context, + reread_always=reread_always, + result=result, + ) + + +def _add_directive_lines( + *, + more_content: StringList | None, + is_final: bool, + config: _AutodocConfig, + indent: str, + options: _AutoDocumenterOptions, + props: _ItemProperties, + result: StringList, + source_name: str, +) -> None: + # generate the directive header and options, if applicable + lines = _directive_header_lines( + autodoc_typehints=config.autodoc_typehints, + directive_name=( + 'py:attribute' + if props.obj_type in {'class', 'exception'} and props.doc_as_attr # type: ignore[attr-defined] + else f'py:{props.obj_type}' + ), + is_final=is_final, + options=options, + props=props, + ) + header_lines = StringList(list(lines), source='') + + # add content from docstrings or attribute documentation + docstring_lines = StringList(props.docstring_lines, source=source_name) + + # add alias information, if applicable + lines = _body_alias_lines( + render_mode=_get_render_mode(config.autodoc_typehints_format), + short_literals=config.python_display_short_literal_types, + props=props, + ) + alias_lines = StringList(list(lines), source='') + + # make sure that the result starts with an empty line. This is + # necessary for some situations where another directive preprocesses + # reST and no starting newline is present + result.append('', '') + _add_content(header_lines, result=result, indent=indent) + result.append('', '') + _add_content(docstring_lines, result=result, indent=indent + ' ') + if more_content is not None: + # add additional content from the directive, if present + _add_content(more_content, result=result, indent=indent + ' ') + _add_content(alias_lines, result=result, indent=indent + ' ') + + +def _document_members( + *, + all_members: bool, + analyzer_order: dict[str, int], + attr_docs: dict[tuple[str, str], list[str]], + config: _AutodocConfig, + current_document: _CurrentDocument, + events: EventManager, + get_attr: _AttrGetter, + indent: str, + options: _AutoDocumenterOptions, + props: _ItemProperties, + real_modname: str, + record_dependencies: MutableSet[str], + ref_context: Mapping[str, str | None], + reread_always: MutableSet[str], + result: StringList, +) -> None: + """Generate reST for member documentation. + + If *all_members* is True, document all members, else those given by + *self.options.members*. + """ + has_members = props.obj_type == 'module' or ( + props.obj_type in {'class', 'exception'} and not props.doc_as_attr # type: ignore[attr-defined] + ) + if not has_members: + return + + want_all = bool(all_members or options.inherited_members or options.members is ALL) + member_documenters = _gather_members( + want_all=want_all, + indent=indent, + analyzer_order=analyzer_order, + attr_docs=attr_docs, + config=config, + current_document=current_document, + events=events, + get_attr=get_attr, + options=options, + parent_modname=real_modname, + props=props, + ref_context=ref_context, + reread_always=reread_always, + ) + + # for implicit module members, check __module__ to avoid + # documenting imported objects + members_check_module = bool( + props.obj_type == 'module' + and want_all + and (options.ignore_module_all or props.all is None) # type: ignore[attr-defined] + ) + for member_props, is_attr, member_indent in member_documenters: + assert member_props.module_name + # Note that those two methods above do not emit events, so + # whatever objects we deduced should not have changed. + _generate_directives( + more_content=None, + parent_modname=real_modname, + check_module=members_check_module and not is_attr, + all_members=True, + config=config, + current_document=current_document, + events=events, + get_attr=get_attr, + indent=member_indent, + options=options, + props=member_props, + record_dependencies=record_dependencies, + ref_context=ref_context, + reread_always=reread_always, + result=result, + ) + + +def _body_alias_lines( + *, props: _ItemProperties, render_mode: _RestifyMode, short_literals: bool +) -> Iterator[str]: + """Add content from docstrings, attribute documentation and user.""" + if props.obj_type in {'data', 'attribute'}: + from sphinx.ext.autodoc._property_types import _AssignStatementProperties + + assert isinstance(props, _AssignStatementProperties) + + # Support for documenting GenericAliases + if props._obj_is_generic_alias: + alias = restify(props._obj, mode=render_mode) + yield _('alias of %s') % alias + yield '' + return + return + + if props.obj_type in {'class', 'exception'}: + from sphinx.ext.autodoc._property_types import _ClassDefProperties + + assert isinstance(props, _ClassDefProperties) + + obj = props._obj + + if props._obj_is_new_type: + supertype = restify(obj.__supertype__, mode=render_mode) + yield _('alias of %s') % supertype + yield '' + return + + if props._obj_is_typevar: + attrs = [ + repr(obj.__name__), + *( + stringify_annotation( + constraint, render_mode, short_literals=short_literals + ) + for constraint in obj.__constraints__ + ), + ] + if obj.__bound__: + attrs.append(rf'bound=\ {restify(obj.__bound__, mode=render_mode)}') + if obj.__covariant__: + attrs.append('covariant=True') + if obj.__contravariant__: + attrs.append('contravariant=True') + + alias = f'TypeVar({", ".join(attrs)})' + yield _('alias of %s') % alias + yield '' + return + + if props.doc_as_attr: + try: + analyzer = ModuleAnalyzer.for_module(props.module_name) + analyzer.analyze() + key = ('', props.dotted_parts) + class_var_doc_comment = key in analyzer.attr_docs + except PycodeError: + class_var_doc_comment = False + + if class_var_doc_comment: + return + alias = restify(obj, mode=render_mode) + yield _('alias of %s') % alias + return + + return + + return + + +def _docstring_source_name(*, props: _ItemProperties, source: str) -> str: + obj_module = inspect.safe_getattr(props._obj, '__module__', None) + obj_qualname = inspect.safe_getattr(props._obj, '__qualname__', None) + if obj_module and obj_qualname: + # Get the correct location of docstring from props._obj + # to support inherited methods + fullname = f'{obj_module}.{obj_qualname}' + else: + fullname = props.full_name + + if source: + return f'{source}:docstring of {fullname}' + return f'docstring of {fullname}' diff --git a/sphinx/ext/autodoc/_legacy_class_based/__init__.py b/sphinx/ext/autodoc/_legacy_class_based/__init__.py new file mode 100644 index 00000000000..664f631bdda --- /dev/null +++ b/sphinx/ext/autodoc/_legacy_class_based/__init__.py @@ -0,0 +1 @@ +"""The legacy (class-based) implementation of autodoc.""" diff --git a/sphinx/ext/autodoc/_legacy_class_based/_directive_options.py b/sphinx/ext/autodoc/_legacy_class_based/_directive_options.py new file mode 100644 index 00000000000..bc8a206cc17 --- /dev/null +++ b/sphinx/ext/autodoc/_legacy_class_based/_directive_options.py @@ -0,0 +1,100 @@ +from __future__ import annotations + +from typing import Any + +from sphinx.ext.autodoc._legacy_class_based._sentinels import ALL, EMPTY, SUPPRESS +from sphinx.locale import __ + + +def identity(x: Any) -> Any: + return x + + +def members_option(arg: Any) -> object | list[str]: + """Used to convert the :members: option to auto directives.""" + if arg in {None, True}: + return ALL + elif arg is False: + return None + else: + return [x.strip() for x in arg.split(',') if x.strip()] + + +def exclude_members_option(arg: Any) -> object | set[str]: + """Used to convert the :exclude-members: option.""" + if arg in {None, True}: + return EMPTY + return {x.strip() for x in arg.split(',') if x.strip()} + + +def inherited_members_option(arg: Any) -> set[str]: + """Used to convert the :inherited-members: option to auto directives.""" + if arg in {None, True}: + return {'object'} + elif arg: + return {x.strip() for x in arg.split(',')} + else: + return set() + + +def member_order_option(arg: Any) -> str | None: + """Used to convert the :member-order: option to auto directives.""" + if arg in {None, True}: + return None + elif arg in {'alphabetical', 'bysource', 'groupwise'}: + return arg + else: + raise ValueError(__('invalid value for member-order option: %s') % arg) + + +def class_doc_from_option(arg: Any) -> str | None: + """Used to convert the :class-doc-from: option to autoclass directives.""" + if arg in {'both', 'class', 'init'}: + return arg + else: + raise ValueError(__('invalid value for class-doc-from option: %s') % arg) + + +def annotation_option(arg: Any) -> Any: + if arg in {None, True}: + # suppress showing the representation of the object + return SUPPRESS + else: + return arg + + +def bool_option(arg: Any) -> bool: + """Used to convert flag options to auto directives. (Instead of + directives.flag(), which returns None). + """ + return True + + +def merge_members_option(options: dict[str, Any]) -> None: + """Merge :private-members: and :special-members: options to the + :members: option. + """ + if options.get('members') is ALL: + # merging is not needed when members: ALL + return + + members = options.setdefault('members', []) + for key in ('private-members', 'special-members'): + other_members = options.get(key) + if other_members is not None and other_members is not ALL: + for member in other_members: + if member not in members: + members.append(member) + + +class Options(dict[str, Any]): # NoQA: FURB189 + """A dict/attribute hybrid that returns None on nonexisting keys.""" + + def copy(self) -> Options: + return Options(super().copy()) + + def __getattr__(self, name: str) -> Any: + try: + return self[name.replace('_', '-')] + except KeyError: + return None diff --git a/sphinx/ext/autodoc/_legacy_class_based/_documenters.py b/sphinx/ext/autodoc/_legacy_class_based/_documenters.py new file mode 100644 index 00000000000..456c57abd45 --- /dev/null +++ b/sphinx/ext/autodoc/_legacy_class_based/_documenters.py @@ -0,0 +1,2928 @@ +from __future__ import annotations + +import functools +import operator +import re +import sys +from inspect import Parameter, Signature +from typing import TYPE_CHECKING, NewType, TypeVar + +from docutils.statemachine import StringList + +from sphinx.errors import PycodeError +from sphinx.ext.autodoc._dynamic._mock import ismock, mock, undecorate +from sphinx.ext.autodoc._legacy_class_based._directive_options import ( + annotation_option, + bool_option, + class_doc_from_option, + exclude_members_option, + identity, + inherited_members_option, + member_order_option, + members_option, + merge_members_option, +) +from sphinx.ext.autodoc._legacy_class_based._sentinels import ( + ALL, + INSTANCEATTR, + SLOTSATTR, + SUPPRESS, + UNINITIALIZED_ATTR, +) +from sphinx.ext.autodoc._shared import LOGGER +from sphinx.ext.autodoc.importer import ( # type: ignore[attr-defined] + get_class_members, + import_module, + import_object, +) +from sphinx.locale import _, __ +from sphinx.pycode import ModuleAnalyzer +from sphinx.util import inspect +from sphinx.util.docstrings import prepare_docstring, separate_metadata +from sphinx.util.inspect import ( + evaluate_signature, + getdoc, + object_description, + safe_getattr, + stringify_signature, +) +from sphinx.util.typing import get_type_hints, restify, stringify_annotation + +if TYPE_CHECKING: + from collections.abc import Callable, Iterator, Sequence + from types import ModuleType + from typing import Any, ClassVar, Literal + + from sphinx.config import Config + from sphinx.environment import BuildEnvironment, _CurrentDocument + from sphinx.events import EventManager + from sphinx.ext.autodoc.directive import DocumenterBridge + from sphinx.registry import SphinxComponentRegistry + from sphinx.util.typing import OptionSpec, _RestifyMode + +#: extended signature RE: with explicit module name separated by :: +py_ext_sig_re = re.compile( + r"""^ ([\w.]+::)? # explicit module name + ([\w.]+\.)? # module and/or class name(s) + (\w+) \s* # thing name + (?: \[\s*(.*?)\s*])? # optional: type parameters list + (?: \((.*)\) # optional: arguments + (?:\s* -> \s* (.*))? # return annotation + )? $ # and nothing more + """, + re.VERBOSE, +) +special_member_re = re.compile(r'^__\S+__$') + + +def _get_render_mode( + typehints_format: Literal['fully-qualified', 'short'], +) -> _RestifyMode: + if typehints_format == 'short': + return 'smart' + return 'fully-qualified-except-typing' + + +class ObjectMember: + """A member of object. + + This is used for the result of `Documenter.get_module_members()` to + represent each member of the object. + """ + + __slots__ = '__name__', 'object', 'docstring', 'class_', 'skipped' + + __name__: str + object: Any + docstring: str | None + class_: Any + skipped: bool + + def __init__( + self, + name: str, + obj: Any, + *, + docstring: str | None = None, + class_: Any = None, + skipped: bool = False, + ) -> None: + self.__name__ = name + self.object = obj + self.docstring = docstring + self.class_ = class_ + self.skipped = skipped + + def __repr__(self) -> str: + return ( + f'ObjectMember(' + f'name={self.__name__!r}, ' + f'obj={self.object!r}, ' + f'docstring={self.docstring!r}, ' + f'class_={self.class_!r}, ' + f'skipped={self.skipped!r}' + f')' + ) + + +class Documenter: + """A Documenter knows how to autodocument a single object type. When + registered with the AutoDirective, it will be used to document objects + of that type when needed by autodoc. + + Its *objtype* attribute selects what auto directive it is assigned to + (the directive name is 'auto' + objtype), and what directive it generates + by default, though that can be overridden by an attribute called + *directivetype*. + + A Documenter has an *option_spec* that works like a docutils directive's; + in fact, it will be used to parse an auto directive's options that matches + the Documenter. + """ + + #: name by which the directive is called (auto...) and the default + #: generated directive name + objtype: ClassVar = 'object' + #: indentation by which to indent the directive content + content_indent: ClassVar = ' ' + #: priority if multiple documenters return True from can_document_member + priority: ClassVar = 0 + #: order if autodoc_member_order is set to 'groupwise' + member_order: ClassVar = 0 + #: true if the generated content may contain titles + titles_allowed: ClassVar = True + + option_spec: ClassVar[OptionSpec] = { + 'no-index': bool_option, + 'no-index-entry': bool_option, + 'noindex': bool_option, + } + + def get_attr(self, obj: Any, name: str, *defargs: Any) -> Any: + """getattr() override for types such as Zope interfaces.""" + return autodoc_attrgetter(obj, name, *defargs, registry=self.env._registry) + + @classmethod + def can_document_member( + cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any + ) -> bool: + """Called to see if a member can be documented by this Documenter.""" + msg = 'must be implemented in subclasses' + raise NotImplementedError(msg) + + def __init__( + self, directive: DocumenterBridge, name: str, indent: str = '' + ) -> None: + self.directive = directive + self.config: Config = directive.env.config + self.env: BuildEnvironment = directive.env + self._current_document: _CurrentDocument = directive.env.current_document + self._events: EventManager = directive.env.events + self.options = directive.genopt + self.name = name + self.indent = indent + # the module and object path within the module, and the fully + # qualified name (all set after resolve_name succeeds) + self.modname: str = '' + self.module: ModuleType | None = None + self.objpath: list[str] = [] + self.fullname = '' + # extra signature items (arguments and return annotation, + # also set after resolve_name succeeds) + self.args: str | None = None + self.retann: str = '' + # the object to document (set after import_object succeeds) + self.object: Any = None + self.object_name = '' + # the parent/owner of the object to document + self.parent: Any = None + # the module analyzer to get at attribute docs, or None + self.analyzer: ModuleAnalyzer | None = None + + @property + def documenters(self) -> dict[str, type[Documenter]]: + """Returns registered Documenter classes""" + return self.env._registry.documenters + + def add_line(self, line: str, source: str, *lineno: int) -> None: + """Append one line of generated reST to the output.""" + if line.strip(): # not a blank line + self.directive.result.append(self.indent + line, source, *lineno) + else: + self.directive.result.append('', source, *lineno) + + def resolve_name( + self, modname: str | None, parents: Any, path: str, base: str + ) -> tuple[str | None, list[str]]: + """Resolve the module and name of the object to document given by the + arguments and the current module/class. + + Must return a pair of the module name and a chain of attributes; for + example, it would return ``('zipfile', ['ZipFile', 'open'])`` for the + ``zipfile.ZipFile.open`` method. + """ + msg = 'must be implemented in subclasses' + raise NotImplementedError(msg) + + def parse_name(self) -> bool: + """Determine what module to import and what attribute to document. + + Returns True and sets *self.modname*, *self.objpath*, *self.fullname*, + *self.args* and *self.retann* if parsing and resolving was successful. + """ + # first, parse the definition -- auto directives for classes and + # functions can contain a signature which is then used instead of + # an autogenerated one + matched = py_ext_sig_re.match(self.name) + if matched is None: + LOGGER.warning( + __('invalid signature for auto%s (%r)'), + self.objtype, + self.name, + type='autodoc', + ) + return False + explicit_modname, path, base, _tp_list, args, retann = matched.groups() + + # support explicit module and class name separation via :: + if explicit_modname is not None: + modname = explicit_modname[:-2] + parents = path.rstrip('.').split('.') if path else [] + else: + modname = None + parents = [] + + with mock(self.config.autodoc_mock_imports): + modname, self.objpath = self.resolve_name(modname, parents, path, base) + + if not modname: + return False + + self.modname = modname + self.args = args + self.retann = retann + self.fullname = '.'.join((self.modname or '', *self.objpath)) + return True + + def import_object(self, raiseerror: bool = False) -> bool: + """Import the object given by *self.modname* and *self.objpath* and set + it as *self.object*. + + Returns True if successful, False if an error occurred. + """ + with mock(self.config.autodoc_mock_imports): + try: + ret = import_object( + self.modname, self.objpath, self.objtype, attrgetter=self.get_attr + ) + self.module, self.parent, self.object_name, self.object = ret + if ismock(self.object): + self.object = undecorate(self.object) + return True + except ImportError as exc: + if raiseerror: + raise + LOGGER.warning(exc.args[0], type='autodoc', subtype='import_object') + self.env.note_reread() + return False + + def get_real_modname(self) -> str: + """Get the real module name of an object to document. + + It can differ from the name of the module through which the object was + imported. + """ + return self.get_attr(self.object, '__module__', None) or self.modname + + def check_module(self) -> bool: + """Check if *self.object* is really defined in the module given by + *self.modname*. + """ + if self.options.imported_members: + return True + + subject = inspect.unpartial(self.object) + modname = self.get_attr(subject, '__module__', None) + return not modname or modname == self.modname + + def format_args(self, **kwargs: Any) -> str: + """Format the argument signature of *self.object*. + + Should return None if the object does not have a signature. + """ + return '' + + def format_name(self) -> str: + """Format the name of *self.object*. + + This normally should be something that can be parsed by the generated + directive, but doesn't need to be (Sphinx will display it unparsed + then). + """ + # normally the name doesn't contain the module (except for module + # directives of course) + return '.'.join(self.objpath) or self.modname + + def _call_format_args(self, **kwargs: Any) -> str: + if kwargs: + try: + return self.format_args(**kwargs) + except TypeError: + # avoid chaining exceptions, by putting nothing here + pass + + # retry without arguments for old documenters + return self.format_args() + + def format_signature(self, **kwargs: Any) -> str: + """Format the signature (arguments and return annotation) of the object. + + Let the user process it via the ``autodoc-process-signature`` event. + """ + if self.args is not None: + # signature given explicitly + args = f'({self.args})' + retann = self.retann + else: + # try to introspect the signature + try: + retann = None + args = self._call_format_args(**kwargs) + if args: + matched = re.match(r'^(\(.*\))\s+->\s+(.*)$', args) + if matched: + args = matched.group(1) + retann = matched.group(2) + except Exception as exc: + LOGGER.warning( + __('error while formatting arguments for %s: %s'), + self.fullname, + exc, + type='autodoc', + ) + args = None + + result = self._events.emit_firstresult( + 'autodoc-process-signature', + self.objtype, + self.fullname, + self.object, + self.options, + args, + retann, + ) + if result: + args, retann = result + + if args is not None: + return args + ((' -> %s' % retann) if retann else '') + else: + return '' + + def add_directive_header(self, sig: str) -> None: + """Add the directive header and options to the generated content.""" + domain = getattr(self, 'domain', 'py') + directive = getattr(self, 'directivetype', self.objtype) + name = self.format_name() + sourcename = self.get_sourcename() + + # one signature per line, indented by column + prefix = f'.. {domain}:{directive}:: ' + for i, sig_line in enumerate(sig.split('\n')): + self.add_line(f'{prefix}{name}{sig_line}', sourcename) + if i == 0: + prefix = ' ' * len(prefix) + + if self.options.no_index or self.options.noindex: + self.add_line(' :no-index:', sourcename) + if self.options.no_index_entry: + self.add_line(' :no-index-entry:', sourcename) + if self.objpath: + # Be explicit about the module, this is necessary since .. class:: + # etc. don't support a prepended module name + self.add_line(' :module: %s' % self.modname, sourcename) + + def get_doc(self) -> list[list[str]] | None: + """Decode and return lines of the docstring(s) for the object. + + When it returns None, autodoc-process-docstring will not be called for this + object. + """ + docstring = getdoc( + self.object, + self.get_attr, + self.config.autodoc_inherit_docstrings, + self.parent, + self.object_name, + ) + if docstring: + tab_width = self.directive.state.document.settings.tab_width + return [prepare_docstring(docstring, tab_width)] + return [] + + def process_doc(self, docstrings: list[list[str]]) -> Iterator[str]: + """Let the user process the docstrings before adding them.""" + for docstringlines in docstrings: + if self._events is not None: + # let extensions preprocess docstrings + self._events.emit( + 'autodoc-process-docstring', + self.objtype, + self.fullname, + self.object, + self.options, + docstringlines, + ) + + if docstringlines and docstringlines[-1]: + # append a blank line to the end of the docstring + docstringlines.append('') + + yield from docstringlines + + def get_sourcename(self) -> str: + obj_module = inspect.safe_getattr(self.object, '__module__', None) + obj_qualname = inspect.safe_getattr(self.object, '__qualname__', None) + if obj_module and obj_qualname: + # Get the correct location of docstring from self.object + # to support inherited methods + fullname = f'{self.object.__module__}.{self.object.__qualname__}' + else: + fullname = self.fullname + + if self.analyzer: + return f'{self.analyzer.srcname}:docstring of {fullname}' + else: + return 'docstring of %s' % fullname + + def add_content(self, more_content: StringList | None) -> None: + """Add content from docstrings, attribute documentation and user.""" + docstring = True + + # set sourcename and add content from attribute documentation + sourcename = self.get_sourcename() + if self.analyzer: + attr_docs = self.analyzer.find_attr_docs() + if self.objpath: + key = ('.'.join(self.objpath[:-1]), self.objpath[-1]) + if key in attr_docs: + docstring = False + # make a copy of docstring for attributes to avoid cache + # the change of autodoc-process-docstring event. + attribute_docstrings = [list(attr_docs[key])] + + for i, line in enumerate(self.process_doc(attribute_docstrings)): + self.add_line(line, sourcename, i) + + # add content from docstrings + if docstring: + docstrings = self.get_doc() + if docstrings is None: + # Do not call autodoc-process-docstring on get_doc() returns None. + pass + else: + if not docstrings: + # append at least a dummy docstring, so that the event + # autodoc-process-docstring is fired and can add some + # content if desired + docstrings.append([]) + for i, line in enumerate(self.process_doc(docstrings)): + self.add_line(line, sourcename, i) + + # add additional content (e.g. from document), if present + if more_content: + for line, src in zip(more_content.data, more_content.items, strict=True): + self.add_line(line, src[0], src[1]) + + def get_object_members(self, want_all: bool) -> tuple[bool, list[ObjectMember]]: + """Return `(members_check_module, members)` where `members` is a + list of `(membername, member)` pairs of the members of *self.object*. + + If *want_all* is True, return all members. Else, only return those + members given by *self.options.members* (which may also be None). + """ + msg = 'must be implemented in subclasses' + raise NotImplementedError(msg) + + def filter_members( + self, members: list[ObjectMember], want_all: bool + ) -> list[tuple[str, Any, bool]]: + """Filter the given member list. + + Members are skipped if + + - they are private (except if given explicitly or the private-members + option is set) + - they are special methods (except if given explicitly or the + special-members option is set) + - they are undocumented (except if the undoc-members option is set) + + The user can override the skipping decision by connecting to the + ``autodoc-skip-member`` event. + """ + + def is_filtered_inherited_member(name: str, obj: Any) -> bool: + inherited_members = self.options.inherited_members or set() + seen = set() + + if inspect.isclass(self.object): + for cls in self.object.__mro__: + if name in cls.__dict__: + seen.add(cls) + if ( + cls.__name__ in inherited_members + and cls != self.object + and any( + issubclass(potential_child, cls) for potential_child in seen + ) + ): + # given member is a member of specified *super class* + return True + if name in cls.__dict__: + return False + if name in self.get_attr(cls, '__annotations__', {}): + return False + if isinstance(obj, ObjectMember) and obj.class_ is cls: + return False + + return False + + ret = [] + + # search for members in source code too + namespace = '.'.join(self.objpath) # will be empty for modules + + if self.analyzer: + attr_docs = self.analyzer.find_attr_docs() + else: + attr_docs = {} + + # process members and determine which to skip + for obj in members: + membername = obj.__name__ + member = obj.object + + # if isattr is True, the member is documented as an attribute + isattr = member is INSTANCEATTR or (namespace, membername) in attr_docs + + try: + doc = getdoc( + member, + self.get_attr, + self.config.autodoc_inherit_docstrings, + self.object, + membername, + ) + if not isinstance(doc, str): + # Ignore non-string __doc__ + doc = None + + # if the member __doc__ is the same as self's __doc__, it's just + # inherited and therefore not the member's doc + cls = self.get_attr(member, '__class__', None) + if cls: + cls_doc = self.get_attr(cls, '__doc__', None) + if cls_doc == doc: + doc = None + + if isinstance(obj, ObjectMember) and obj.docstring: + # hack for ClassDocumenter to inject docstring via ObjectMember + doc = obj.docstring + + doc, metadata = separate_metadata(doc) + has_doc = bool(doc) + + if 'private' in metadata: + # consider a member private if docstring has "private" metadata + isprivate = True + elif 'public' in metadata: + # consider a member public if docstring has "public" metadata + isprivate = False + else: + isprivate = membername.startswith('_') + + keep = False + if ismock(member) and (namespace, membername) not in attr_docs: + # mocked module or object + pass + elif ( + self.options.exclude_members + and membername in self.options.exclude_members + ): + # remove members given by exclude-members + keep = False + elif want_all and special_member_re.match(membername): + # special __methods__ + if ( + self.options.special_members + and membername in self.options.special_members + ): + if membername == '__doc__': # NoQA: SIM114 + keep = False + elif is_filtered_inherited_member(membername, obj): + keep = False + else: + keep = has_doc or self.options.undoc_members + else: + keep = False + elif (namespace, membername) in attr_docs: + if want_all and isprivate: + if self.options.private_members is None: + keep = False + else: + keep = membername in self.options.private_members + else: + # keep documented attributes + keep = True + elif want_all and isprivate: + if has_doc or self.options.undoc_members: + if self.options.private_members is None: # NoQA: SIM114 + keep = False + elif is_filtered_inherited_member(membername, obj): + keep = False + else: + keep = membername in self.options.private_members + else: + keep = False + else: + if self.options.members is ALL and is_filtered_inherited_member( + membername, obj + ): + keep = False + else: + # ignore undocumented members if :undoc-members: is not given + keep = has_doc or self.options.undoc_members + + if isinstance(obj, ObjectMember) and obj.skipped: + # forcedly skipped member (ex. a module attribute not defined in __all__) + keep = False + + # give the user a chance to decide whether this member + # should be skipped + if self._events is not None: + # let extensions preprocess docstrings + skip_user = self._events.emit_firstresult( + 'autodoc-skip-member', + self.objtype, + membername, + member, + not keep, + self.options, + ) + if skip_user is not None: + keep = not skip_user + except Exception as exc: + LOGGER.warning( + __( + 'autodoc: failed to determine %s.%s (%r) to be documented, ' + 'the following exception was raised:\n%s' + ), + self.name, + membername, + member, + exc, + type='autodoc', + ) + keep = False + + if keep: + ret.append((membername, member, isattr)) + + return ret + + def document_members(self, all_members: bool = False) -> None: + """Generate reST for member documentation. + + If *all_members* is True, document all members, else those given by + *self.options.members*. + """ + # set current namespace for finding members + self._current_document.autodoc_module = self.modname + if self.objpath: + self._current_document.autodoc_class = self.objpath[0] + + want_all = ( + all_members or self.options.inherited_members or self.options.members is ALL + ) + # find out which members are documentable + members_check_module, members = self.get_object_members(want_all) + + # document non-skipped members + member_documenters: list[tuple[Documenter, bool]] = [] + for mname, member, isattr in self.filter_members(members, want_all): + classes = [ + cls + for cls in self.documenters.values() + if cls.can_document_member(member, mname, isattr, self) + ] + if not classes: + # don't know how to document this member + continue + # prefer the documenter with the highest priority + classes.sort(key=lambda cls: cls.priority) + # give explicitly separated module name, so that members + # of inner classes can be documented + full_mname = f'{self.modname}::' + '.'.join((*self.objpath, mname)) + documenter = classes[-1](self.directive, full_mname, self.indent) + member_documenters.append((documenter, isattr)) + + member_order = self.options.member_order or self.config.autodoc_member_order + # We now try to import all objects before ordering them. This is to + # avoid possible circular imports if we were to import objects after + # their associated documenters have been sorted. + member_documenters = [ + (documenter, isattr) + for documenter, isattr in member_documenters + if documenter.parse_name() and documenter.import_object() + ] + member_documenters = self.sort_members(member_documenters, member_order) + + for documenter, isattr in member_documenters: + assert documenter.modname + # We can directly call ._generate() since the documenters + # already called parse_name() and import_object() before. + # + # Note that those two methods above do not emit events, so + # whatever objects we deduced should not have changed. + documenter._generate( + all_members=True, + real_modname=self.real_modname, + check_module=members_check_module and not isattr, + ) + + # reset current objects + self._current_document.autodoc_module = '' + self._current_document.autodoc_class = '' + + def sort_members( + self, documenters: list[tuple[Documenter, bool]], order: str + ) -> list[tuple[Documenter, bool]]: + """Sort the given member list.""" + if order == 'groupwise': + # sort by group; alphabetically within groups + documenters.sort(key=lambda e: (e[0].member_order, e[0].name)) + elif order == 'bysource': + # By default, member discovery order matches source order, + # as dicts are insertion-ordered from Python 3.7. + if self.analyzer: + # sort by source order, by virtue of the module analyzer + tagorder = self.analyzer.tagorder + + def keyfunc(entry: tuple[Documenter, bool]) -> int: + fullname = entry[0].name.split('::')[1] + return tagorder.get(fullname, len(tagorder)) + + documenters.sort(key=keyfunc) + else: # alphabetical + documenters.sort(key=lambda e: e[0].name) + + return documenters + + def generate( + self, + more_content: StringList | None = None, + real_modname: str | None = None, + check_module: bool = False, + all_members: bool = False, + ) -> None: + """Generate reST for the object given by *self.name*, and possibly for + its members. + + If *more_content* is given, include that content. If *real_modname* is + given, use that module name to find attribute docs. If *check_module* is + True, only generate if the object is defined in the module name it is + imported from. If *all_members* is True, document all members. + """ + if not self.parse_name(): + # need a module to import + LOGGER.warning( + __( + "don't know which module to import for autodocumenting " + '%r (try placing a "module" or "currentmodule" directive ' + 'in the document, or giving an explicit module name)' + ), + self.name, + type='autodoc', + ) + return + + # now, import the module and get object to document + if not self.import_object(): + return + + self._generate(more_content, real_modname, check_module, all_members) + + def _generate( + self, + more_content: StringList | None = None, + real_modname: str | None = None, + check_module: bool = False, + all_members: bool = False, + ) -> None: + # If there is no real module defined, figure out which to use. + # The real module is used in the module analyzer to look up the module + # where the attribute documentation would actually be found in. + # This is used for situations where you have a module that collects the + # functions and classes of internal submodules. + guess_modname = self.get_real_modname() + self.real_modname: str = real_modname or guess_modname + + # try to also get a source code analyzer for attribute docs + try: + self.analyzer = ModuleAnalyzer.for_module(self.real_modname) + # parse right now, to get PycodeErrors on parsing (results will + # be cached anyway) + self.analyzer.find_attr_docs() + except PycodeError as exc: + LOGGER.debug('[autodoc] module analyzer failed: %s', exc) + # no source file -- e.g. for builtin and C modules + self.analyzer = None + # at least add the module.__file__ as a dependency + if module___file__ := getattr(self.module, '__file__', ''): + self.directive.record_dependencies.add(module___file__) + else: + self.directive.record_dependencies.add(self.analyzer.srcname) + + if self.real_modname != guess_modname: + # Add module to dependency list if target object is defined in other module. + try: + analyzer = ModuleAnalyzer.for_module(guess_modname) + self.directive.record_dependencies.add(analyzer.srcname) + except PycodeError: + pass + + docstrings: list[str] = functools.reduce( + operator.iadd, self.get_doc() or [], [] + ) + if ismock(self.object) and not docstrings: + LOGGER.warning( + __('A mocked object is detected: %r'), + self.name, + type='autodoc', + subtype='mocked_object', + ) + + # check __module__ of object (for members not given explicitly) + if check_module: + if not self.check_module(): + return + + sourcename = self.get_sourcename() + + # make sure that the result starts with an empty line. This is + # necessary for some situations where another directive preprocesses + # reST and no starting newline is present + self.add_line('', sourcename) + + # format the object's signature, if any + try: + sig = self.format_signature() + except Exception as exc: + LOGGER.warning( + __('error while formatting signature for %s: %s'), + self.fullname, + exc, + type='autodoc', + ) + return + + # generate the directive header and options, if applicable + self.add_directive_header(sig) + self.add_line('', sourcename) + + # e.g. the module directive doesn't have content + self.indent += self.content_indent + + # add all content (from docstrings, attribute docs etc.) + self.add_content(more_content) + + # document members, if possible + self.document_members(all_members) + + +class ModuleDocumenter(Documenter): + """Specialized Documenter subclass for modules.""" + + objtype = 'module' + content_indent = '' + _extra_indent = ' ' + + option_spec: ClassVar[OptionSpec] = { + 'members': members_option, + 'undoc-members': bool_option, + 'no-index': bool_option, + 'no-index-entry': bool_option, + 'inherited-members': inherited_members_option, + 'show-inheritance': bool_option, + 'synopsis': identity, + 'platform': identity, + 'deprecated': bool_option, + 'member-order': member_order_option, + 'exclude-members': exclude_members_option, + 'private-members': members_option, + 'special-members': members_option, + 'imported-members': bool_option, + 'ignore-module-all': bool_option, + 'no-value': bool_option, + 'noindex': bool_option, + } + + def __init__(self, *args: Any) -> None: + super().__init__(*args) + merge_members_option(self.options) + self.__all__: Sequence[str] | None = None + + def add_content(self, more_content: StringList | None) -> None: + old_indent = self.indent + self.indent += self._extra_indent + super().add_content(None) + self.indent = old_indent + if more_content: + for line, src in zip(more_content.data, more_content.items, strict=True): + self.add_line(line, src[0], src[1]) + + @classmethod + def can_document_member( + cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any + ) -> bool: + # don't document submodules automatically + return False + + def resolve_name( + self, modname: str | None, parents: Any, path: str, base: str + ) -> tuple[str | None, list[str]]: + if modname is not None: + LOGGER.warning( + __('"::" in automodule name doesn\'t make sense'), type='autodoc' + ) + return (path or '') + base, [] + + def parse_name(self) -> bool: + ret = super().parse_name() + if self.args or self.retann: + LOGGER.warning( + __('signature arguments or return annotation given for automodule %s'), + self.fullname, + type='autodoc', + ) + return ret + + def import_object(self, raiseerror: bool = False) -> bool: + ret = super().import_object(raiseerror) + + try: + if not self.options.ignore_module_all: + self.__all__ = inspect.getall(self.object) + except ValueError as exc: + # invalid __all__ found. + LOGGER.warning( + __( + '__all__ should be a list of strings, not %r ' + '(in module %s) -- ignoring __all__' + ), + exc.args[0], + self.fullname, + type='autodoc', + ) + + return ret + + def add_directive_header(self, sig: str) -> None: + Documenter.add_directive_header(self, sig) + + sourcename = self.get_sourcename() + + # add some module-specific options + if self.options.synopsis: + self.add_line(' :synopsis: ' + self.options.synopsis, sourcename) + if self.options.platform: + self.add_line(' :platform: ' + self.options.platform, sourcename) + if self.options.deprecated: + self.add_line(' :deprecated:', sourcename) + if self.options.no_index_entry: + self.add_line(' :no-index-entry:', sourcename) + + def get_module_members(self) -> dict[str, ObjectMember]: + """Get members of target module.""" + if self.analyzer: + attr_docs = self.analyzer.attr_docs + else: + attr_docs = {} + + members: dict[str, ObjectMember] = {} + for name in dir(self.object): + try: + value = safe_getattr(self.object, name, None) + if ismock(value): + value = undecorate(value) + docstring = attr_docs.get(('', name), []) + members[name] = ObjectMember( + name, value, docstring='\n'.join(docstring) + ) + except AttributeError: + continue + + # annotation only member (ex. attr: int) + for name in inspect.getannotations(self.object): + if name not in members: + docstring = attr_docs.get(('', name), []) + members[name] = ObjectMember( + name, INSTANCEATTR, docstring='\n'.join(docstring) + ) + + return members + + def get_object_members(self, want_all: bool) -> tuple[bool, list[ObjectMember]]: + members = self.get_module_members() + if want_all: + if self.__all__ is None: + # for implicit module members, check __module__ to avoid + # documenting imported objects + return True, list(members.values()) + else: + for member in members.values(): + if member.__name__ not in self.__all__: + member.skipped = True + + return False, list(members.values()) + else: + memberlist = self.options.members or [] + ret = [] + for name in memberlist: + if name in members: + ret.append(members[name]) + else: + LOGGER.warning( + __( + 'missing attribute mentioned in :members: option: ' + 'module %s, attribute %s' + ), + safe_getattr(self.object, '__name__', '???'), + name, + type='autodoc', + ) + return False, ret + + def sort_members( + self, documenters: list[tuple[Documenter, bool]], order: str + ) -> list[tuple[Documenter, bool]]: + if order == 'bysource' and self.__all__: + assert self.__all__ is not None + module_all = self.__all__ + module_all_set = set(module_all) + module_all_len = len(module_all) + + # Sort alphabetically first (for members not listed on the __all__) + documenters.sort(key=lambda e: e[0].name) + + # Sort by __all__ + def keyfunc(entry: tuple[Documenter, bool]) -> int: + name = entry[0].name.split('::')[1] + if name in module_all_set: + return module_all.index(name) + else: + return module_all_len + + documenters.sort(key=keyfunc) + + return documenters + else: + return super().sort_members(documenters, order) + + +class ModuleLevelDocumenter(Documenter): + """Specialized Documenter subclass for objects on module level (functions, + classes, data/constants). + """ + + def resolve_name( + self, modname: str | None, parents: Any, path: str, base: str + ) -> tuple[str | None, list[str]]: + if modname is not None: + return modname, [*parents, base] + if path: + modname = path.rstrip('.') + return modname, [*parents, base] + + # if documenting a toplevel object without explicit module, + # it can be contained in another auto directive ... + modname = self._current_document.autodoc_module + # ... or in the scope of a module directive + if not modname: + modname = self.env.ref_context.get('py:module') + # ... else, it stays None, which means invalid + return modname, [*parents, base] + + +class ClassLevelDocumenter(Documenter): + """Specialized Documenter subclass for objects on class level (methods, + attributes). + """ + + def resolve_name( + self, modname: str | None, parents: Any, path: str, base: str + ) -> tuple[str | None, list[str]]: + if modname is not None: + return modname, [*parents, base] + + if path: + mod_cls = path.rstrip('.') + else: + # if documenting a class-level object without path, + # there must be a current class, either from a parent + # auto directive ... + mod_cls = self._current_document.autodoc_class + # ... or from a class directive + if not mod_cls: + mod_cls = self.env.ref_context.get('py:class', '') + # ... if still falsy, there's no way to know + if not mod_cls: + return None, [] + modname, _sep, cls = mod_cls.rpartition('.') + parents = [cls] + # if the module name is still missing, get it like above + if not modname: + modname = self._current_document.autodoc_module + if not modname: + modname = self.env.ref_context.get('py:module') + # ... else, it stays None, which means invalid + return modname, [*parents, base] + + +class DocstringSignatureMixin: + """Mixin for FunctionDocumenter and MethodDocumenter to provide the + feature of reading the signature from the docstring. + """ + + _new_docstrings: list[list[str]] | None = None + _signatures: list[str] = [] + + def _find_signature(self) -> tuple[str | None, str | None] | None: + # candidates of the object name + valid_names = [self.objpath[-1]] # type: ignore[attr-defined] + if isinstance(self, ClassDocumenter): + valid_names.append('__init__') + if hasattr(self.object, '__mro__'): + valid_names.extend(cls.__name__ for cls in self.object.__mro__) + + docstrings = self.get_doc() + if docstrings is None: + return None, None + self._new_docstrings = docstrings[:] + self._signatures = [] + result = None + for i, doclines in enumerate(docstrings): + for j, line in enumerate(doclines): + if not line: + # no lines in docstring, no match + break + + if line.endswith('\\'): + line = line.rstrip('\\').rstrip() + + # match first line of docstring against signature RE + match = py_ext_sig_re.match(line) + if not match: + break + _exmod, _path, base, _tp_list, args, retann = match.groups() + + # the base name must match ours + if base not in valid_names: + break + + # re-prepare docstring to ignore more leading indentation + directive = self.directive # type: ignore[attr-defined] + tab_width = directive.state.document.settings.tab_width + self._new_docstrings[i] = prepare_docstring( + '\n'.join(doclines[j + 1 :]), tab_width + ) + + if result is None: + # first signature + result = args, retann + else: + # subsequent signatures + self._signatures.append(f'({args}) -> {retann}') + + if result is not None: + # finish the loop when signature found + break + + return result + + def get_doc(self) -> list[list[str]] | None: + if self._new_docstrings is not None: + return self._new_docstrings + return super().get_doc() # type: ignore[misc] + + def format_signature(self, **kwargs: Any) -> str: + self.args: str | None + if self.args is None and self.config.autodoc_docstring_signature: # type: ignore[attr-defined] + # only act if a signature is not explicitly given already, and if + # the feature is enabled + result = self._find_signature() + if result is not None: + self.args, self.retann = result + sig = super().format_signature(**kwargs) # type: ignore[misc] + if self._signatures: + return '\n'.join((sig, *self._signatures)) + else: + return sig + + +class DocstringStripSignatureMixin(DocstringSignatureMixin): + """Mixin for AttributeDocumenter to provide the + feature of stripping any function signature from the docstring. + """ + + def format_signature(self, **kwargs: Any) -> str: + if self.args is None and self.config.autodoc_docstring_signature: # type: ignore[attr-defined] + # only act if a signature is not explicitly given already, and if + # the feature is enabled + result = self._find_signature() + if result is not None: + # Discarding _args is a only difference with + # DocstringSignatureMixin.format_signature. + # Documenter.format_signature use self.args value to format. + _args, self.retann = result + return super().format_signature(**kwargs) + + +class FunctionDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter): # type: ignore[misc] + """Specialized Documenter subclass for functions.""" + + objtype = 'function' + member_order = 30 + + @classmethod + def can_document_member( + cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any + ) -> bool: + # supports functions, builtins and bound methods exported at the module level + return ( + inspect.isfunction(member) + or inspect.isbuiltin(member) + or (inspect.isroutine(member) and isinstance(parent, ModuleDocumenter)) + ) + + def format_args(self, **kwargs: Any) -> str: + if self.config.autodoc_typehints in {'none', 'description'}: + kwargs.setdefault('show_annotation', False) + if self.config.autodoc_typehints_format == 'short': + kwargs.setdefault('unqualified_typehints', True) + if self.config.python_display_short_literal_types: + kwargs.setdefault('short_literals', True) + + try: + self._events.emit('autodoc-before-process-signature', self.object, False) + sig = inspect.signature( + self.object, type_aliases=self.config.autodoc_type_aliases + ) + args = stringify_signature(sig, **kwargs) + except TypeError as exc: + LOGGER.warning( + __('Failed to get a function signature for %s: %s'), self.fullname, exc + ) + return '' + except ValueError: + args = '' + + if self.config.strip_signature_backslash: + # escape backslashes for reST + args = args.replace('\\', '\\\\') + return args + + def document_members(self, all_members: bool = False) -> None: + pass + + def add_directive_header(self, sig: str) -> None: + sourcename = self.get_sourcename() + super().add_directive_header(sig) + + is_coro = inspect.iscoroutinefunction(self.object) + is_acoro = inspect.isasyncgenfunction(self.object) + if is_coro or is_acoro: + self.add_line(' :async:', sourcename) + + def format_signature(self, **kwargs: Any) -> str: + if self.config.autodoc_typehints_format == 'short': + kwargs.setdefault('unqualified_typehints', True) + if self.config.python_display_short_literal_types: + kwargs.setdefault('short_literals', True) + + sigs = [] + if ( + self.analyzer + and '.'.join(self.objpath) in self.analyzer.overloads + and self.config.autodoc_typehints != 'none' + ): + # Use signatures for overloaded functions instead of the implementation function. + overloaded = True + else: + overloaded = False + sig = super().format_signature(**kwargs) + sigs.append(sig) + + if inspect.is_singledispatch_function(self.object): + # append signature of singledispatch'ed functions + for typ, func in self.object.registry.items(): + if typ is object: + pass # default implementation. skipped. + else: + dispatchfunc = self.annotate_to_first_argument(func, typ) + if dispatchfunc: + documenter = FunctionDocumenter(self.directive, '') + documenter.object = dispatchfunc + documenter.objpath = [''] + sigs.append(documenter.format_signature()) + if overloaded and self.analyzer is not None: + actual = inspect.signature( + self.object, type_aliases=self.config.autodoc_type_aliases + ) + __globals__ = safe_getattr(self.object, '__globals__', {}) + for overload in self.analyzer.overloads['.'.join(self.objpath)]: + overload = self.merge_default_value(actual, overload) + overload = evaluate_signature( + overload, __globals__, self.config.autodoc_type_aliases + ) + + sig = stringify_signature(overload, **kwargs) + sigs.append(sig) + + return '\n'.join(sigs) + + def merge_default_value(self, actual: Signature, overload: Signature) -> Signature: + """Merge default values of actual implementation to the overload variants.""" + parameters = list(overload.parameters.values()) + for i, param in enumerate(parameters): + actual_param = actual.parameters.get(param.name) + if actual_param and param.default == '...': + parameters[i] = param.replace(default=actual_param.default) + + return overload.replace(parameters=parameters) + + def annotate_to_first_argument( + self, func: Callable[..., Any], typ: type + ) -> Callable[..., Any] | None: + """Annotate type hint to the first argument of function if needed.""" + try: + sig = inspect.signature(func, type_aliases=self.config.autodoc_type_aliases) + except TypeError as exc: + LOGGER.warning( + __('Failed to get a function signature for %s: %s'), self.fullname, exc + ) + return None + except ValueError: + return None + + if len(sig.parameters) == 0: + return None + + def dummy(): # type: ignore[no-untyped-def] # NoQA: ANN202 + pass + + params = list(sig.parameters.values()) + if params[0].annotation is Parameter.empty: + params[0] = params[0].replace(annotation=typ) + try: + dummy.__signature__ = sig.replace(parameters=params) # type: ignore[attr-defined] + return dummy + except (AttributeError, TypeError): + # failed to update signature (ex. built-in or extension types) + return None + + return func + + +class DecoratorDocumenter(FunctionDocumenter): + """Specialized Documenter subclass for decorator functions.""" + + objtype = 'decorator' + + # must be lower than FunctionDocumenter + priority = -1 + + def format_args(self, **kwargs: Any) -> str: + args = super().format_args(**kwargs) + if ',' in args: + return args + else: + return '' + + +# Types which have confusing metaclass signatures it would be best not to show. +# These are listed by name, rather than storing the objects themselves, to avoid +# needing to import the modules. +_METACLASS_CALL_BLACKLIST = frozenset({ + 'enum.EnumType.__call__', +}) + + +# Types whose __new__ signature is a pass-through. +_CLASS_NEW_BLACKLIST = frozenset({ + 'typing.Generic.__new__', +}) + + +class ClassDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter): # type: ignore[misc] + """Specialized Documenter subclass for classes.""" + + objtype = 'class' + member_order = 20 + option_spec: ClassVar[OptionSpec] = { + 'members': members_option, + 'undoc-members': bool_option, + 'no-index': bool_option, + 'no-index-entry': bool_option, + 'inherited-members': inherited_members_option, + 'show-inheritance': bool_option, + 'member-order': member_order_option, + 'exclude-members': exclude_members_option, + 'private-members': members_option, + 'special-members': members_option, + 'class-doc-from': class_doc_from_option, + 'noindex': bool_option, + } + + # Must be higher than FunctionDocumenter, ClassDocumenter, and + # AttributeDocumenter as NewType can be an attribute and is a class + # after Python 3.10. + priority = 15 + + _signature_class: Any = None + _signature_method_name: str = '' + + def __init__(self, *args: Any) -> None: + super().__init__(*args) + + if self.config.autodoc_class_signature == 'separated': + self.options = self.options.copy() + + # show __init__() method + if self.options.special_members is None: + self.options['special-members'] = ['__new__', '__init__'] + else: + self.options.special_members.append('__new__') + self.options.special_members.append('__init__') + + merge_members_option(self.options) + + @classmethod + def can_document_member( + cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any + ) -> bool: + return isinstance(member, type) or ( + isattr and isinstance(member, NewType | TypeVar) + ) + + def import_object(self, raiseerror: bool = False) -> bool: + ret = super().import_object(raiseerror) + # if the class is documented under another name, document it + # as data/attribute + if ret: + if hasattr(self.object, '__name__'): + self.doc_as_attr = self.objpath[-1] != self.object.__name__ + else: + self.doc_as_attr = True + if isinstance(self.object, NewType | TypeVar): + modname = getattr(self.object, '__module__', self.modname) + if modname != self.modname and self.modname.startswith(modname): + bases = self.modname[len(modname) :].strip('.').split('.') + self.objpath = bases + self.objpath + self.modname = modname + return ret + + def _get_signature(self) -> tuple[Any | None, str | None, Signature | None]: + if isinstance(self.object, NewType | TypeVar): + # Suppress signature + return None, None, None + + def get_user_defined_function_or_method(obj: Any, attr: str) -> Any: + """Get the `attr` function or method from `obj`, if it is user-defined.""" + if inspect.is_builtin_class_method(obj, attr): + return None + attr = self.get_attr(obj, attr, None) + if not (inspect.ismethod(attr) or inspect.isfunction(attr)): + return None + return attr + + # This sequence is copied from inspect._signature_from_callable. + # ValueError means that no signature could be found, so we keep going. + + # First, we check if obj has a __signature__ attribute + if hasattr(self.object, '__signature__'): + object_sig = self.object.__signature__ + if isinstance(object_sig, Signature): + return None, None, object_sig + if sys.version_info[:2] <= (3, 14) and callable(object_sig): + # Support for enum.Enum.__signature__ in Python 3.12 & 3.13 + if isinstance(object_sig_str := object_sig(), str): + return None, None, inspect.signature_from_str(object_sig_str) + + # Next, let's see if it has an overloaded __call__ defined + # in its metaclass + call = get_user_defined_function_or_method(type(self.object), '__call__') + + if call is not None: + if f'{call.__module__}.{call.__qualname__}' in _METACLASS_CALL_BLACKLIST: + call = None + + if call is not None: + self._events.emit('autodoc-before-process-signature', call, True) + try: + sig = inspect.signature( + call, + bound_method=True, + type_aliases=self.config.autodoc_type_aliases, + ) + return type(self.object), '__call__', sig + except ValueError: + pass + + # Now we check if the 'obj' class has a '__new__' method + new = get_user_defined_function_or_method(self.object, '__new__') + + if new is not None: + if f'{new.__module__}.{new.__qualname__}' in _CLASS_NEW_BLACKLIST: + new = None + + if new is not None: + self._events.emit('autodoc-before-process-signature', new, True) + try: + sig = inspect.signature( + new, + bound_method=True, + type_aliases=self.config.autodoc_type_aliases, + ) + return self.object, '__new__', sig + except ValueError: + pass + + # Finally, we should have at least __init__ implemented + init = get_user_defined_function_or_method(self.object, '__init__') + if init is not None: + self._events.emit('autodoc-before-process-signature', init, True) + try: + sig = inspect.signature( + init, + bound_method=True, + type_aliases=self.config.autodoc_type_aliases, + ) + return self.object, '__init__', sig + except ValueError: + pass + + # None of the attributes are user-defined, so fall back to let inspect + # handle it. + # We don't know the exact method that inspect.signature will read + # the signature from, so just pass the object itself to our hook. + self._events.emit('autodoc-before-process-signature', self.object, False) + try: + sig = inspect.signature( + self.object, + bound_method=False, + type_aliases=self.config.autodoc_type_aliases, + ) + return None, None, sig + except ValueError: + pass + + # Still no signature: happens e.g. for old-style classes + # with __init__ in C and no `__text_signature__`. + return None, None, None + + def format_args(self, **kwargs: Any) -> str: + if self.config.autodoc_typehints in {'none', 'description'}: + kwargs.setdefault('show_annotation', False) + if self.config.autodoc_typehints_format == 'short': + kwargs.setdefault('unqualified_typehints', True) + if self.config.python_display_short_literal_types: + kwargs.setdefault('short_literals', True) + + try: + self._signature_class, _signature_method_name, sig = self._get_signature() + except TypeError as exc: + # __signature__ attribute contained junk + LOGGER.warning( + __('Failed to get a constructor signature for %s: %s'), + self.fullname, + exc, + ) + return '' + self._signature_method_name = _signature_method_name or '' + + if sig is None: + return '' + + return stringify_signature(sig, show_return_annotation=False, **kwargs) + + def _find_signature(self) -> tuple[str | None, str | None] | None: + result = super()._find_signature() + if result is not None: + # Strip a return value from signature of constructor in docstring (first entry) + result = (result[0], None) + + for i, sig in enumerate(self._signatures): + if sig.endswith(' -> None'): + # Strip a return value from signatures of constructor in docstring (subsequent + # entries) + self._signatures[i] = sig[:-8] + + return result + + def format_signature(self, **kwargs: Any) -> str: + if self.doc_as_attr: + return '' + if self.config.autodoc_class_signature == 'separated': + # do not show signatures + return '' + + if self.config.autodoc_typehints_format == 'short': + kwargs.setdefault('unqualified_typehints', True) + if self.config.python_display_short_literal_types: + kwargs.setdefault('short_literals', True) + + sig = super().format_signature() + sigs = [] + + overloads = self.get_overloaded_signatures() + if overloads and self.config.autodoc_typehints != 'none': + # Use signatures for overloaded methods instead of the implementation method. + method = safe_getattr( + self._signature_class, self._signature_method_name, None + ) + __globals__ = safe_getattr(method, '__globals__', {}) + for overload in overloads: + overload = evaluate_signature( + overload, __globals__, self.config.autodoc_type_aliases + ) + + parameters = list(overload.parameters.values()) + overload = overload.replace( + parameters=parameters[1:], return_annotation=Parameter.empty + ) + sig = stringify_signature(overload, **kwargs) + sigs.append(sig) + else: + sigs.append(sig) + + return '\n'.join(sigs) + + def get_overloaded_signatures(self) -> list[Signature]: + if self._signature_class and self._signature_method_name: + for cls in self._signature_class.__mro__: + try: + analyzer = ModuleAnalyzer.for_module(cls.__module__) + analyzer.analyze() + qualname = f'{cls.__qualname__}.{self._signature_method_name}' + if qualname in analyzer.overloads: + return analyzer.overloads.get(qualname, []) + elif qualname in analyzer.tagorder: + # the constructor is defined in the class, but not overridden. + return [] + except PycodeError: + pass + + return [] + + def get_canonical_fullname(self) -> str | None: + __modname__ = safe_getattr(self.object, '__module__', self.modname) + __qualname__ = safe_getattr(self.object, '__qualname__', None) + if __qualname__ is None: + __qualname__ = safe_getattr(self.object, '__name__', None) + if __qualname__ and '' in __qualname__: + # No valid qualname found if the object is defined as locals + __qualname__ = None + + if __modname__ and __qualname__: + return f'{__modname__}.{__qualname__}' + else: + return None + + def add_directive_header(self, sig: str) -> None: + sourcename = self.get_sourcename() + + if self.doc_as_attr: + self.directivetype = 'attribute' + super().add_directive_header(sig) + + if isinstance(self.object, NewType | TypeVar): + return + + if self.analyzer and '.'.join(self.objpath) in self.analyzer.finals: + self.add_line(' :final:', sourcename) + + canonical_fullname = self.get_canonical_fullname() + if ( + not self.doc_as_attr + and not isinstance(self.object, NewType) + and canonical_fullname + and self.fullname != canonical_fullname + ): + self.add_line(' :canonical: %s' % canonical_fullname, sourcename) + + # add inheritance info, if wanted + if not self.doc_as_attr and self.options.show_inheritance: + if inspect.getorigbases(self.object): + # A subclass of generic types + # refs: PEP-560 + bases = list(self.object.__orig_bases__) + elif hasattr(self.object, '__bases__') and len(self.object.__bases__): + # A normal class + bases = list(self.object.__bases__) + else: + bases = [] + + self._events.emit( + 'autodoc-process-bases', self.fullname, self.object, self.options, bases + ) + + mode = _get_render_mode(self.config.autodoc_typehints_format) + base_classes = [restify(cls, mode=mode) for cls in bases] + + sourcename = self.get_sourcename() + self.add_line('', sourcename) + self.add_line(' ' + _('Bases: %s') % ', '.join(base_classes), sourcename) + + def get_object_members(self, want_all: bool) -> tuple[bool, list[ObjectMember]]: + members = get_class_members( + self.object, + self.objpath, + self.get_attr, + self.config.autodoc_inherit_docstrings, + ) + if not want_all: + if not self.options.members: + return False, [] + # specific members given + selected = [] + for name in self.options.members: + if name in members: + selected.append(members[name]) + else: + LOGGER.warning( + __('missing attribute %s in object %s'), + name, + self.fullname, + type='autodoc', + ) + return False, selected + elif self.options.inherited_members: + return False, list(members.values()) + else: + return False, [m for m in members.values() if m.class_ == self.object] + + def get_doc(self) -> list[list[str]] | None: + if isinstance(self.object, TypeVar): + if self.object.__doc__ == TypeVar.__doc__: + return [] + if self.doc_as_attr: + # Don't show the docstring of the class when it is an alias. + if self.get_variable_comment(): + return [] + else: + return None + + lines = getattr(self, '_new_docstrings', None) + if lines is not None: + return lines + + classdoc_from = self.options.get( + 'class-doc-from', self.config.autoclass_content + ) + + docstrings = [] + attrdocstring = getdoc(self.object, self.get_attr) + if attrdocstring: + docstrings.append(attrdocstring) + + # for classes, what the "docstring" is can be controlled via a + # config value; the default is only the class docstring + if classdoc_from in {'both', 'init'}: + __init__ = self.get_attr(self.object, '__init__', None) + initdocstring = getdoc( + __init__, + self.get_attr, + self.config.autodoc_inherit_docstrings, + self.object, + '__init__', + ) + # for new-style classes, no __init__ means default __init__ + if initdocstring is not None and ( + initdocstring == object.__init__.__doc__ # for pypy + or initdocstring.strip() == object.__init__.__doc__ # for !pypy + ): + initdocstring = None + if not initdocstring: + # try __new__ + __new__ = self.get_attr(self.object, '__new__', None) + initdocstring = getdoc( + __new__, + self.get_attr, + self.config.autodoc_inherit_docstrings, + self.object, + '__new__', + ) + # for new-style classes, no __new__ means default __new__ + if initdocstring is not None and ( + initdocstring == object.__new__.__doc__ # for pypy + or initdocstring.strip() == object.__new__.__doc__ # for !pypy + ): + initdocstring = None + if initdocstring: + if classdoc_from == 'init': + docstrings = [initdocstring] + else: + docstrings.append(initdocstring) + + tab_width = self.directive.state.document.settings.tab_width + return [prepare_docstring(docstring, tab_width) for docstring in docstrings] + + def get_variable_comment(self) -> list[str] | None: + try: + key = ('', '.'.join(self.objpath)) + if self.doc_as_attr: + analyzer = ModuleAnalyzer.for_module(self.modname) + else: + analyzer = ModuleAnalyzer.for_module(self.get_real_modname()) + analyzer.analyze() + return list(analyzer.attr_docs.get(key, [])) + except PycodeError: + return None + + def add_content(self, more_content: StringList | None) -> None: + mode = _get_render_mode(self.config.autodoc_typehints_format) + short_literals = self.config.python_display_short_literal_types + + if isinstance(self.object, NewType): + supertype = restify(self.object.__supertype__, mode=mode) + + more_content = StringList([_('alias of %s') % supertype, ''], source='') + if isinstance(self.object, TypeVar): + attrs = [repr(self.object.__name__)] + attrs.extend( + stringify_annotation(constraint, mode, short_literals=short_literals) + for constraint in self.object.__constraints__ + ) + if self.object.__bound__: + bound = restify(self.object.__bound__, mode=mode) + attrs.append(r'bound=\ ' + bound) + if self.object.__covariant__: + attrs.append('covariant=True') + if self.object.__contravariant__: + attrs.append('contravariant=True') + + more_content = StringList( + [_('alias of TypeVar(%s)') % ', '.join(attrs), ''], source='' + ) + if self.doc_as_attr and self.modname != self.get_real_modname(): + try: + # override analyzer to obtain doccomment around its definition. + self.analyzer = ModuleAnalyzer.for_module(self.modname) + self.analyzer.analyze() + except PycodeError: + pass + + if self.doc_as_attr and not self.get_variable_comment(): + try: + alias = restify(self.object, mode=mode) + more_content = StringList([_('alias of %s') % alias], source='') + except AttributeError: + pass # Invalid class object is passed. + + super().add_content(more_content) + + def document_members(self, all_members: bool = False) -> None: + if self.doc_as_attr: + return + super().document_members(all_members) + + def generate( + self, + more_content: StringList | None = None, + real_modname: str | None = None, + check_module: bool = False, + all_members: bool = False, + ) -> None: + # Do not pass real_modname and use the name from the __module__ + # attribute of the class. + # If a class gets imported into the module real_modname + # the analyzer won't find the source of the class, if + # it looks in real_modname. + return super().generate( + more_content=more_content, + check_module=check_module, + all_members=all_members, + ) + + +class ExceptionDocumenter(ClassDocumenter): + """Specialized ClassDocumenter subclass for exceptions.""" + + objtype = 'exception' + member_order = 10 + + # needs a higher priority than ClassDocumenter + priority = ClassDocumenter.priority + 5 + + @classmethod + def can_document_member( + cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any + ) -> bool: + try: + return isinstance(member, type) and issubclass(member, BaseException) + except TypeError as exc: + # It's possible for a member to be considered a type, but fail + # issubclass checks due to not being a class. For example: + # https://github.com/sphinx-doc/sphinx/issues/11654#issuecomment-1696790436 + msg = ( + f'{cls.__name__} failed to discern if member {member} with' + f' membername {membername} is a BaseException subclass.' + ) + raise ValueError(msg) from exc + + +class DataDocumenterMixinBase: + # define types of instance variables + config: Config + env: BuildEnvironment + modname: str + parent: Any + object: Any + objpath: list[str] + + def should_suppress_directive_header(self) -> bool: + """Check directive header should be suppressed.""" + return False + + def should_suppress_value_header(self) -> bool: + """Check :value: header should be suppressed.""" + return False + + def update_content(self, more_content: StringList) -> None: + """Update docstring, for example with TypeVar variance.""" + pass + + +class GenericAliasMixin(DataDocumenterMixinBase): + """Mixin for DataDocumenter and AttributeDocumenter to provide the feature for + supporting GenericAliases. + """ + + def should_suppress_directive_header(self) -> bool: + return ( + inspect.isgenericalias(self.object) + or super().should_suppress_directive_header() + ) + + def update_content(self, more_content: StringList) -> None: + if inspect.isgenericalias(self.object): + mode = _get_render_mode(self.config.autodoc_typehints_format) + alias = restify(self.object, mode=mode) + + more_content.append(_('alias of %s') % alias, '') + more_content.append('', '') + + super().update_content(more_content) + + +class UninitializedGlobalVariableMixin(DataDocumenterMixinBase): + """Mixin for DataDocumenter to provide the feature for supporting uninitialized + (type annotation only) global variables. + """ + + def import_object(self, raiseerror: bool = False) -> bool: + try: + return super().import_object(raiseerror=True) # type: ignore[misc] + except ImportError as exc: + # annotation only instance variable (PEP-526) + try: + with mock(self.config.autodoc_mock_imports): + parent = import_module(self.modname) + annotations = get_type_hints( + parent, + None, + self.config.autodoc_type_aliases, + include_extras=True, + ) + if self.objpath[-1] in annotations: + self.object = UNINITIALIZED_ATTR + self.parent = parent + return True + except ImportError: + pass + + if raiseerror: + raise + LOGGER.warning(exc.args[0], type='autodoc', subtype='import_object') + self.env.note_reread() + return False + + def should_suppress_value_header(self) -> bool: + return ( + self.object is UNINITIALIZED_ATTR or super().should_suppress_value_header() + ) + + def get_doc(self) -> list[list[str]] | None: + if self.object is UNINITIALIZED_ATTR: + return [] + else: + return super().get_doc() # type: ignore[misc] + + +class DataDocumenter( + GenericAliasMixin, UninitializedGlobalVariableMixin, ModuleLevelDocumenter +): + """Specialized Documenter subclass for data items.""" + + objtype = 'data' + member_order = 40 + priority = -10 + option_spec: ClassVar[OptionSpec] = dict(ModuleLevelDocumenter.option_spec) + option_spec['annotation'] = annotation_option + option_spec['no-value'] = bool_option + + @classmethod + def can_document_member( + cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any + ) -> bool: + return isinstance(parent, ModuleDocumenter) and isattr + + def update_annotations(self, parent: Any) -> None: + """Update __annotations__ to support type_comment and so on.""" + annotations = dict(inspect.getannotations(parent)) + parent.__annotations__ = annotations + + try: + analyzer = ModuleAnalyzer.for_module(self.modname) + analyzer.analyze() + for (classname, attrname), annotation in analyzer.annotations.items(): + if not classname and attrname not in annotations: + annotations[attrname] = annotation + except PycodeError: + pass + + def import_object(self, raiseerror: bool = False) -> bool: + ret = super().import_object(raiseerror) + if self.parent: + self.update_annotations(self.parent) + + return ret + + def should_suppress_value_header(self) -> bool: + if super().should_suppress_value_header(): + return True + else: + doc = self.get_doc() or [] + _docstring, metadata = separate_metadata( + '\n'.join(functools.reduce(operator.iadd, doc, [])) + ) + if 'hide-value' in metadata: + return True + + return False + + def add_directive_header(self, sig: str) -> None: + super().add_directive_header(sig) + sourcename = self.get_sourcename() + if ( + self.options.annotation is SUPPRESS + or self.should_suppress_directive_header() + ): + pass + elif self.options.annotation: + self.add_line(' :annotation: %s' % self.options.annotation, sourcename) + else: + if self.config.autodoc_typehints != 'none': + # obtain annotation for this data + annotations = get_type_hints( + self.parent, + None, + self.config.autodoc_type_aliases, + include_extras=True, + ) + if self.objpath[-1] in annotations: + mode = _get_render_mode(self.config.autodoc_typehints_format) + short_literals = self.config.python_display_short_literal_types + objrepr = stringify_annotation( + annotations.get(self.objpath[-1]), + mode, + short_literals=short_literals, + ) + self.add_line(' :type: ' + objrepr, sourcename) + + try: + if ( + self.options.no_value + or self.should_suppress_value_header() + or ismock(self.object) + ): + pass + else: + objrepr = object_description(self.object) + self.add_line(' :value: ' + objrepr, sourcename) + except ValueError: + pass + + def document_members(self, all_members: bool = False) -> None: + pass + + def get_real_modname(self) -> str: + real_modname = self.get_attr(self.parent or self.object, '__module__', None) + return real_modname or self.modname + + def get_module_comment(self, attrname: str) -> list[str] | None: + try: + analyzer = ModuleAnalyzer.for_module(self.modname) + analyzer.analyze() + key = ('', attrname) + if key in analyzer.attr_docs: + return list(analyzer.attr_docs[key]) + except PycodeError: + pass + + return None + + def get_doc(self) -> list[list[str]] | None: + # Check the variable has a docstring-comment + comment = self.get_module_comment(self.objpath[-1]) + if comment: + return [comment] + else: + return super().get_doc() + + def add_content(self, more_content: StringList | None) -> None: + # Disable analyzing variable comment on Documenter.add_content() to control it on + # DataDocumenter.add_content() + self.analyzer = None + + if not more_content: + more_content = StringList() + + self.update_content(more_content) + super().add_content(more_content) + + +class MethodDocumenter(DocstringSignatureMixin, ClassLevelDocumenter): # type: ignore[misc] + """Specialized Documenter subclass for methods (normal, static and class).""" + + objtype = 'method' + directivetype = 'method' + member_order = 50 + priority = 1 # must be more than FunctionDocumenter + + @classmethod + def can_document_member( + cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any + ) -> bool: + return inspect.isroutine(member) and not isinstance(parent, ModuleDocumenter) + + def import_object(self, raiseerror: bool = False) -> bool: + ret = super().import_object(raiseerror) + if not ret: + return ret + + # to distinguish classmethod/staticmethod + obj = self.parent.__dict__.get(self.object_name, self.object) + if inspect.isstaticmethod(obj, cls=self.parent, name=self.object_name): + # document static members before regular methods + self.member_order -= 1 # type: ignore[misc] + elif inspect.isclassmethod(obj): + # document class methods before static methods as + # they usually behave as alternative constructors + self.member_order -= 2 # type: ignore[misc] + return ret + + def format_args(self, **kwargs: Any) -> str: + if self.config.autodoc_typehints in {'none', 'description'}: + kwargs.setdefault('show_annotation', False) + if self.config.autodoc_typehints_format == 'short': + kwargs.setdefault('unqualified_typehints', True) + if self.config.python_display_short_literal_types: + kwargs.setdefault('short_literals', True) + + try: + if self.object == object.__init__ and self.parent != object: # NoQA: E721 + # Classes not having own __init__() method are shown as no arguments. + # + # Note: The signature of object.__init__() is (self, /, *args, **kwargs). + # But it makes users confused. + args = '()' + else: + if inspect.isstaticmethod( + self.object, cls=self.parent, name=self.object_name + ): + self._events.emit( + 'autodoc-before-process-signature', self.object, False + ) + sig = inspect.signature( + self.object, + bound_method=False, + type_aliases=self.config.autodoc_type_aliases, + ) + else: + self._events.emit( + 'autodoc-before-process-signature', self.object, True + ) + sig = inspect.signature( + self.object, + bound_method=True, + type_aliases=self.config.autodoc_type_aliases, + ) + args = stringify_signature(sig, **kwargs) + except TypeError as exc: + LOGGER.warning( + __('Failed to get a method signature for %s: %s'), self.fullname, exc + ) + return '' + except ValueError: + args = '' + + if self.config.strip_signature_backslash: + # escape backslashes for reST + args = args.replace('\\', '\\\\') + return args + + def add_directive_header(self, sig: str) -> None: + super().add_directive_header(sig) + + sourcename = self.get_sourcename() + obj = self.parent.__dict__.get(self.object_name, self.object) + if inspect.isabstractmethod(obj): + self.add_line(' :abstractmethod:', sourcename) + if inspect.iscoroutinefunction(obj) or inspect.isasyncgenfunction(obj): + self.add_line(' :async:', sourcename) + if ( + inspect.is_classmethod_like(obj) + or inspect.is_singledispatch_method(obj) + and inspect.is_classmethod_like(obj.func) + ): + self.add_line(' :classmethod:', sourcename) + if inspect.isstaticmethod(obj, cls=self.parent, name=self.object_name): + self.add_line(' :staticmethod:', sourcename) + if self.analyzer and '.'.join(self.objpath) in self.analyzer.finals: + self.add_line(' :final:', sourcename) + + def document_members(self, all_members: bool = False) -> None: + pass + + def format_signature(self, **kwargs: Any) -> str: + if self.config.autodoc_typehints_format == 'short': + kwargs.setdefault('unqualified_typehints', True) + if self.config.python_display_short_literal_types: + kwargs.setdefault('short_literals', True) + + sigs = [] + if ( + self.analyzer + and '.'.join(self.objpath) in self.analyzer.overloads + and self.config.autodoc_typehints != 'none' + ): + # Use signatures for overloaded methods instead of the implementation method. + overloaded = True + else: + overloaded = False + sig = super().format_signature(**kwargs) + sigs.append(sig) + + meth = self.parent.__dict__.get(self.objpath[-1]) + if inspect.is_singledispatch_method(meth): + # append signature of singledispatch'ed functions + for typ, func in meth.dispatcher.registry.items(): + if typ is object: + pass # default implementation. skipped. + else: + if inspect.isclassmethod(func): + func = func.__func__ + dispatchmeth = self.annotate_to_first_argument(func, typ) + if dispatchmeth: + documenter = MethodDocumenter(self.directive, '') + documenter.parent = self.parent + documenter.object = dispatchmeth + documenter.objpath = [''] + sigs.append(documenter.format_signature()) + if overloaded and self.analyzer is not None: + if inspect.isstaticmethod( + self.object, cls=self.parent, name=self.object_name + ): + actual = inspect.signature( + self.object, + bound_method=False, + type_aliases=self.config.autodoc_type_aliases, + ) + else: + actual = inspect.signature( + self.object, + bound_method=True, + type_aliases=self.config.autodoc_type_aliases, + ) + + __globals__ = safe_getattr(self.object, '__globals__', {}) + for overload in self.analyzer.overloads['.'.join(self.objpath)]: + overload = self.merge_default_value(actual, overload) + overload = evaluate_signature( + overload, __globals__, self.config.autodoc_type_aliases + ) + + if not inspect.isstaticmethod( + self.object, cls=self.parent, name=self.object_name + ): + parameters = list(overload.parameters.values()) + overload = overload.replace(parameters=parameters[1:]) + sig = stringify_signature(overload, **kwargs) + sigs.append(sig) + + return '\n'.join(sigs) + + def merge_default_value(self, actual: Signature, overload: Signature) -> Signature: + """Merge default values of actual implementation to the overload variants.""" + parameters = list(overload.parameters.values()) + for i, param in enumerate(parameters): + actual_param = actual.parameters.get(param.name) + if actual_param and param.default == '...': + parameters[i] = param.replace(default=actual_param.default) + + return overload.replace(parameters=parameters) + + def annotate_to_first_argument( + self, func: Callable[..., Any], typ: type + ) -> Callable[..., Any] | None: + """Annotate type hint to the first argument of function if needed.""" + try: + sig = inspect.signature(func, type_aliases=self.config.autodoc_type_aliases) + except TypeError as exc: + LOGGER.warning( + __('Failed to get a method signature for %s: %s'), self.fullname, exc + ) + return None + except ValueError: + return None + + if len(sig.parameters) == 1: + return None + + def dummy(): # type: ignore[no-untyped-def] # NoQA: ANN202 + pass + + params = list(sig.parameters.values()) + if params[1].annotation is Parameter.empty: + params[1] = params[1].replace(annotation=typ) + try: + dummy.__signature__ = sig.replace( # type: ignore[attr-defined] + parameters=params + ) + return dummy + except (AttributeError, TypeError): + # failed to update signature (ex. built-in or extension types) + return None + + return func + + def get_doc(self) -> list[list[str]] | None: + if self._new_docstrings is not None: + # docstring already returned previously, then modified by + # `DocstringSignatureMixin`. Just return the previously-computed + # result, so that we don't lose the processing done by + # `DocstringSignatureMixin`. + return self._new_docstrings + if self.objpath[-1] == '__init__': + docstring = getdoc( + self.object, + self.get_attr, + self.config.autodoc_inherit_docstrings, + self.parent, + self.object_name, + ) + if docstring is not None and ( + docstring == object.__init__.__doc__ # for pypy + or docstring.strip() == object.__init__.__doc__ # for !pypy + ): + docstring = None + if docstring: + tab_width = self.directive.state.document.settings.tab_width + return [prepare_docstring(docstring, tabsize=tab_width)] + else: + return [] + elif self.objpath[-1] == '__new__': + docstring = getdoc( + self.object, + self.get_attr, + self.config.autodoc_inherit_docstrings, + self.parent, + self.object_name, + ) + if docstring is not None and ( + docstring == object.__new__.__doc__ # for pypy + or docstring.strip() == object.__new__.__doc__ # for !pypy + ): + docstring = None + if docstring: + tab_width = self.directive.state.document.settings.tab_width + return [prepare_docstring(docstring, tabsize=tab_width)] + else: + return [] + else: + return super().get_doc() + + +class NonDataDescriptorMixin(DataDocumenterMixinBase): + """Mixin for AttributeDocumenter to provide the feature for supporting non + data-descriptors. + + .. note:: This mix-in must be inherited after other mix-ins. Otherwise, docstring + and :value: header will be suppressed unexpectedly. + """ + + def import_object(self, raiseerror: bool = False) -> bool: + ret = super().import_object(raiseerror) # type: ignore[misc] + if ret and not inspect.isattributedescriptor(self.object): + self.non_data_descriptor = True + else: + self.non_data_descriptor = False + + return ret + + def should_suppress_value_header(self) -> bool: + return ( + not getattr(self, 'non_data_descriptor', False) + or super().should_suppress_directive_header() + ) + + def get_doc(self) -> list[list[str]] | None: + if getattr(self, 'non_data_descriptor', False): + # the docstring of non datadescriptor is very probably the wrong thing + # to display + return None + else: + return super().get_doc() # type: ignore[misc] + + +class SlotsMixin(DataDocumenterMixinBase): + """Mixin for AttributeDocumenter to provide the feature for supporting __slots__.""" + + def isslotsattribute(self) -> bool: + """Check the subject is an attribute in __slots__.""" + try: + if parent___slots__ := inspect.getslots(self.parent): + return self.objpath[-1] in parent___slots__ + else: + return False + except (ValueError, TypeError): + return False + + def import_object(self, raiseerror: bool = False) -> bool: + ret = super().import_object(raiseerror) # type: ignore[misc] + if self.isslotsattribute(): + self.object = SLOTSATTR + + return ret + + def should_suppress_value_header(self) -> bool: + if self.object is SLOTSATTR: + return True + else: + return super().should_suppress_value_header() + + def get_doc(self) -> list[list[str]] | None: + if self.object is SLOTSATTR: + try: + parent___slots__ = inspect.getslots(self.parent) + if parent___slots__ and ( + docstring := parent___slots__.get(self.objpath[-1]) + ): + docstring = prepare_docstring(docstring) + return [docstring] + else: + return [] + except ValueError as exc: + LOGGER.warning( + __('Invalid __slots__ found on %s. Ignored.'), + (self.parent.__qualname__, exc), + type='autodoc', + ) + return [] + else: + return super().get_doc() # type: ignore[misc] + + +class RuntimeInstanceAttributeMixin(DataDocumenterMixinBase): + """Mixin for AttributeDocumenter to provide the feature for supporting runtime + instance attributes (that are defined in __init__() methods with doc-comments). + + Example:: + + class Foo: + def __init__(self): + self.attr = None #: This is a target of this mix-in. + """ + + RUNTIME_INSTANCE_ATTRIBUTE = object() + + def is_runtime_instance_attribute(self, parent: Any) -> bool: + """Check the subject is an attribute defined in __init__().""" + # An instance variable defined in __init__(). + if self.get_attribute_comment(parent, self.objpath[-1]): # type: ignore[attr-defined] + return True + return self.is_runtime_instance_attribute_not_commented(parent) + + def is_runtime_instance_attribute_not_commented(self, parent: Any) -> bool: + """Check the subject is an attribute defined in __init__() without comment.""" + for cls in inspect.getmro(parent): + try: + module = safe_getattr(cls, '__module__') + qualname = safe_getattr(cls, '__qualname__') + + analyzer = ModuleAnalyzer.for_module(module) + analyzer.analyze() + if qualname and self.objpath: + key = f'{qualname}.{self.objpath[-1]}' + if key in analyzer.tagorder: + return True + except (AttributeError, PycodeError): + pass + + return False + + def import_object(self, raiseerror: bool = False) -> bool: + """Check the existence of runtime instance attribute after failing to import the + attribute. + """ + try: + return super().import_object(raiseerror=True) # type: ignore[misc] + except ImportError as exc: + try: + with mock(self.config.autodoc_mock_imports): + ret = import_object( + self.modname, + self.objpath[:-1], + 'class', + attrgetter=self.get_attr, # type: ignore[attr-defined] + ) + parent = ret[3] + if self.is_runtime_instance_attribute(parent): + self.object = self.RUNTIME_INSTANCE_ATTRIBUTE + self.parent = parent + return True + except ImportError: + pass + + if raiseerror: + raise + LOGGER.warning(exc.args[0], type='autodoc', subtype='import_object') + self.env.note_reread() + return False + + def should_suppress_value_header(self) -> bool: + return ( + self.object is self.RUNTIME_INSTANCE_ATTRIBUTE + or super().should_suppress_value_header() + ) + + def get_doc(self) -> list[list[str]] | None: + if ( + self.object is self.RUNTIME_INSTANCE_ATTRIBUTE + and self.is_runtime_instance_attribute_not_commented(self.parent) + ): + return None + else: + return super().get_doc() # type: ignore[misc] + + +class UninitializedInstanceAttributeMixin(DataDocumenterMixinBase): + """Mixin for AttributeDocumenter to provide the feature for supporting uninitialized + instance attributes (PEP-526 styled, annotation only attributes). + + Example:: + + class Foo: + attr: int #: This is a target of this mix-in. + """ + + def is_uninitialized_instance_attribute(self, parent: Any) -> bool: + """Check the subject is an annotation only attribute.""" + annotations = get_type_hints( + parent, None, self.config.autodoc_type_aliases, include_extras=True + ) + return self.objpath[-1] in annotations + + def import_object(self, raiseerror: bool = False) -> bool: + """Check the existence of uninitialized instance attribute when failed to import + the attribute. + """ + try: + return super().import_object(raiseerror=True) # type: ignore[misc] + except ImportError as exc: + try: + ret = import_object( + self.modname, + self.objpath[:-1], + 'class', + attrgetter=self.get_attr, # type: ignore[attr-defined] + ) + parent = ret[3] + if self.is_uninitialized_instance_attribute(parent): + self.object = UNINITIALIZED_ATTR + self.parent = parent + return True + except ImportError: + pass + + if raiseerror: + raise + LOGGER.warning(exc.args[0], type='autodoc', subtype='import_object') + self.env.note_reread() + return False + + def should_suppress_value_header(self) -> bool: + return ( + self.object is UNINITIALIZED_ATTR or super().should_suppress_value_header() + ) + + def get_doc(self) -> list[list[str]] | None: + if self.object is UNINITIALIZED_ATTR: + return None + return super().get_doc() # type: ignore[misc] + + +class AttributeDocumenter( # type: ignore[misc] + GenericAliasMixin, + SlotsMixin, + RuntimeInstanceAttributeMixin, + UninitializedInstanceAttributeMixin, + NonDataDescriptorMixin, + DocstringStripSignatureMixin, + ClassLevelDocumenter, +): + """Specialized Documenter subclass for attributes.""" + + objtype = 'attribute' + member_order = 60 + option_spec: ClassVar[OptionSpec] = dict(ModuleLevelDocumenter.option_spec) + option_spec['annotation'] = annotation_option + option_spec['no-value'] = bool_option + + # must be higher than the MethodDocumenter, else it will recognize + # some non-data descriptors as methods + priority = 10 + + @staticmethod + def is_function_or_method(obj: Any) -> bool: + return ( + inspect.isfunction(obj) or inspect.isbuiltin(obj) or inspect.ismethod(obj) + ) + + @classmethod + def can_document_member( + cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any + ) -> bool: + if isinstance(parent, ModuleDocumenter): + return False + if inspect.isattributedescriptor(member): + return True + return not inspect.isroutine(member) and not isinstance(member, type) + + def document_members(self, all_members: bool = False) -> None: + pass + + def update_annotations(self, parent: Any) -> None: + """Update __annotations__ to support type_comment and so on.""" + try: + annotations = dict(inspect.getannotations(parent)) + parent.__annotations__ = annotations + + for cls in inspect.getmro(parent): + try: + module = safe_getattr(cls, '__module__') + qualname = safe_getattr(cls, '__qualname__') + + analyzer = ModuleAnalyzer.for_module(module) + analyzer.analyze() + anns = analyzer.annotations + for (classname, attrname), annotation in anns.items(): + if classname == qualname and attrname not in annotations: + annotations[attrname] = annotation + except (AttributeError, PycodeError): + pass + except (AttributeError, TypeError): + # Failed to set __annotations__ (built-in, extensions, etc.) + pass + + def import_object(self, raiseerror: bool = False) -> bool: + ret = super().import_object(raiseerror) + if inspect.isenumattribute(self.object): + self.object = self.object.value + if self.parent: + self.update_annotations(self.parent) + + return ret + + def get_real_modname(self) -> str: + real_modname = self.get_attr(self.parent or self.object, '__module__', None) + return real_modname or self.modname + + def should_suppress_value_header(self) -> bool: + if super().should_suppress_value_header(): + return True + else: + doc = self.get_doc() + if doc: + _docstring, metadata = separate_metadata( + '\n'.join(functools.reduce(operator.iadd, doc, [])) + ) + if 'hide-value' in metadata: + return True + + return False + + def add_directive_header(self, sig: str) -> None: + super().add_directive_header(sig) + sourcename = self.get_sourcename() + if ( + self.options.annotation is SUPPRESS + or self.should_suppress_directive_header() + ): + pass + elif self.options.annotation: + self.add_line(' :annotation: %s' % self.options.annotation, sourcename) + else: + if self.config.autodoc_typehints != 'none': + # obtain type annotation for this attribute + annotations = get_type_hints( + self.parent, + None, + self.config.autodoc_type_aliases, + include_extras=True, + ) + if self.objpath[-1] in annotations: + mode = _get_render_mode(self.config.autodoc_typehints_format) + short_literals = self.config.python_display_short_literal_types + objrepr = stringify_annotation( + annotations.get(self.objpath[-1]), + mode, + short_literals=short_literals, + ) + self.add_line(' :type: ' + objrepr, sourcename) + + try: + if ( + self.options.no_value + or self.should_suppress_value_header() + or ismock(self.object) + ): + pass + else: + objrepr = object_description(self.object) + self.add_line(' :value: ' + objrepr, sourcename) + except ValueError: + pass + + def get_attribute_comment(self, parent: Any, attrname: str) -> list[str] | None: + for cls in inspect.getmro(parent): + try: + module = safe_getattr(cls, '__module__') + qualname = safe_getattr(cls, '__qualname__') + + analyzer = ModuleAnalyzer.for_module(module) + analyzer.analyze() + if qualname and self.objpath: + key = (qualname, attrname) + if key in analyzer.attr_docs: + return list(analyzer.attr_docs[key]) + except (AttributeError, PycodeError): + pass + + return None + + def get_doc(self) -> list[list[str]] | None: + # Check the attribute has a docstring-comment + comment = self.get_attribute_comment(self.parent, self.objpath[-1]) + if comment: + return [comment] + + try: + # Disable `autodoc_inherit_docstring` temporarily to avoid to obtain + # a docstring from the value which descriptor returns unexpectedly. + # See: https://github.com/sphinx-doc/sphinx/issues/7805 + orig = self.config.autodoc_inherit_docstrings + self.config.autodoc_inherit_docstrings = False + return super().get_doc() + finally: + self.config.autodoc_inherit_docstrings = orig + + def add_content(self, more_content: StringList | None) -> None: + # Disable analyzing attribute comment on Documenter.add_content() to control it on + # AttributeDocumenter.add_content() + self.analyzer = None + + if more_content is None: + more_content = StringList() + self.update_content(more_content) + super().add_content(more_content) + + +class PropertyDocumenter(DocstringStripSignatureMixin, ClassLevelDocumenter): # type: ignore[misc] + """Specialized Documenter subclass for properties.""" + + objtype = 'property' + member_order = 60 + + # before AttributeDocumenter + priority = AttributeDocumenter.priority + 1 + + @classmethod + def can_document_member( + cls: type[Documenter], member: Any, membername: str, isattr: bool, parent: Any + ) -> bool: + if isinstance(parent, ClassDocumenter): + if inspect.isproperty(member): + return True + else: + __dict__ = safe_getattr(parent.object, '__dict__', {}) + obj = __dict__.get(membername) + return isinstance(obj, classmethod) and inspect.isproperty(obj.__func__) + else: + return False + + def import_object(self, raiseerror: bool = False) -> bool: + """Check the existence of uninitialized instance attribute when failed to import + the attribute. + """ + ret = super().import_object(raiseerror) + if ret and not inspect.isproperty(self.object): + __dict__ = safe_getattr(self.parent, '__dict__', {}) + obj = __dict__.get(self.objpath[-1]) + if isinstance(obj, classmethod) and inspect.isproperty(obj.__func__): + self.object = obj.__func__ + self.isclassmethod: bool = True + return True + else: + return False + + self.isclassmethod = False + return ret + + def format_args(self, **kwargs: Any) -> str: + func = self._get_property_getter() + if func is None: + return '' + + # update the annotations of the property getter + self._events.emit('autodoc-before-process-signature', func, False) + # correctly format the arguments for a property + return super().format_args(**kwargs) + + def document_members(self, all_members: bool = False) -> None: + pass + + def get_real_modname(self) -> str: + real_modname = self.get_attr(self.parent or self.object, '__module__', None) + return real_modname or self.modname + + def add_directive_header(self, sig: str) -> None: + super().add_directive_header(sig) + sourcename = self.get_sourcename() + if inspect.isabstractmethod(self.object): + self.add_line(' :abstractmethod:', sourcename) + if self.isclassmethod: + self.add_line(' :classmethod:', sourcename) + + func = self._get_property_getter() + if func is None or self.config.autodoc_typehints == 'none': + return + + try: + signature = inspect.signature( + func, type_aliases=self.config.autodoc_type_aliases + ) + if signature.return_annotation is not Parameter.empty: + mode = _get_render_mode(self.config.autodoc_typehints_format) + short_literals = self.config.python_display_short_literal_types + objrepr = stringify_annotation( + signature.return_annotation, mode, short_literals=short_literals + ) + self.add_line(' :type: ' + objrepr, sourcename) + except TypeError as exc: + LOGGER.warning( + __('Failed to get a function signature for %s: %s'), self.fullname, exc + ) + pass + except ValueError: + pass + + def _get_property_getter(self) -> Callable[..., Any] | None: + if safe_getattr(self.object, 'fget', None): # property + return self.object.fget + if safe_getattr(self.object, 'func', None): # cached_property + return self.object.func + return None + + +def autodoc_attrgetter( + obj: Any, name: str, *defargs: Any, registry: SphinxComponentRegistry +) -> Any: + """Alternative getattr() for types""" + for typ, func in registry.autodoc_attrgetters.items(): + if isinstance(obj, typ): + return func(obj, name, *defargs) + + return safe_getattr(obj, name, *defargs) diff --git a/sphinx/ext/autodoc/_legacy_class_based/_sentinels.py b/sphinx/ext/autodoc/_legacy_class_based/_sentinels.py new file mode 100644 index 00000000000..8809f1a7be7 --- /dev/null +++ b/sphinx/ext/autodoc/_legacy_class_based/_sentinels.py @@ -0,0 +1,31 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING + +if TYPE_CHECKING: + from typing import Any + + +class _All: + """A special value for :*-members: that matches to any member.""" + + def __contains__(self, item: Any) -> bool: + return True + + def append(self, item: Any) -> None: + pass # nothing + + +class _Empty: + """A special value for :exclude-members: that never matches to any member.""" + + def __contains__(self, item: Any) -> bool: + return False + + +ALL = _All() +EMPTY = _Empty() +UNINITIALIZED_ATTR = object() +INSTANCEATTR = object() +SLOTSATTR = object() +SUPPRESS = object() diff --git a/sphinx/ext/autodoc/_names.py b/sphinx/ext/autodoc/_names.py new file mode 100644 index 00000000000..20d6ccbf248 --- /dev/null +++ b/sphinx/ext/autodoc/_names.py @@ -0,0 +1,181 @@ +"""Importer utilities for autodoc""" + +from __future__ import annotations + +import re +from typing import TYPE_CHECKING + +from sphinx.ext.autodoc._shared import LOGGER +from sphinx.locale import __ + +if TYPE_CHECKING: + from collections.abc import Mapping, Sequence + + from sphinx.environment import _CurrentDocument + from sphinx.ext.autodoc._property_types import _AutodocObjType + +#: extended signature RE: with explicit module name separated by :: +py_ext_sig_re = re.compile( + r"""^ ([\w.]+::)? # explicit module name + ([\w.]+\.)? # module and/or class name(s) + (\w+) \s* # thing name + (?: \[\s*(.*?)\s*])? # optional: type parameters list + (?: \((.*)\) # optional: arguments + (?:\s* -> \s* (.*))? # return annotation + )? $ # and nothing more + """, + re.VERBOSE, +) + + +def _parse_name( + *, + name: str, + objtype: _AutodocObjType, + current_document: _CurrentDocument, + ref_context: Mapping[str, str | None], +) -> tuple[str, tuple[str, ...], str | None, str | None] | None: + """Parse *name* into module name, path, arguments, and return annotation.""" + # Parse the definition in *name*. + # autodoc directives for classes and functions can contain a signature, + # which overrides the autogenerated one. + matched = py_ext_sig_re.match(name) + if matched is None: + LOGGER.warning( + __('invalid signature for auto%s (%r)'), + objtype, + name, + type='autodoc', + ) + # need a module to import + LOGGER.warning( + __( + "don't know which module to import for autodocumenting " + '%r (try placing a "module" or "currentmodule" directive ' + 'in the document, or giving an explicit module name)' + ), + name, + type='autodoc', + ) + return None + + explicit_modname, path, base, _tp_list, args, retann = matched.groups() + if args is not None: + args = f'({args})' + + # Support explicit module and class name separation via ``::`` + if explicit_modname is not None: + module_name = explicit_modname.removesuffix('::') + parents = path.rstrip('.').split('.') if path else () + else: + module_name = None + parents = () + + resolved = _resolve_name( + objtype=objtype, + module_name=module_name, + path=path, + base=base, + parents=parents, + current_document=current_document, + ref_context_py_module=ref_context.get('py:module'), + ref_context_py_class=ref_context.get('py:class', ''), # type: ignore[arg-type] + ) + if resolved is None: + return None + module_name, parts = resolved + + if objtype == 'module' and args: + msg = __("signature arguments given for automodule: '%s'") + LOGGER.warning(msg, name, type='autodoc') + return None + if objtype == 'module' and retann: + msg = __("return annotation given for automodule: '%s'") + LOGGER.warning(msg, name, type='autodoc') + return None + + if not module_name: + # Could not resolve a module to import + LOGGER.warning( + __( + "don't know which module to import for autodocumenting " + '%r (try placing a "module" or "currentmodule" directive ' + 'in the document, or giving an explicit module name)' + ), + name, + type='autodoc', + ) + return None + + return module_name, parts, args, retann + + +def _resolve_name( + *, + objtype: _AutodocObjType, + module_name: str | None, + path: str | None, + base: str, + parents: Sequence[str], + current_document: _CurrentDocument, + ref_context_py_module: str | None, + ref_context_py_class: str, +) -> tuple[str | None, tuple[str, ...]] | None: + """Resolve the module and name of the object to document given by the + arguments and the current module/class. + + Must return a pair of the module name and a chain of attributes; for + example, it would return ``('zipfile', ('ZipFile', 'open'))`` for the + ``zipfile.ZipFile.open`` method. + """ + if objtype == 'module': + if module_name is not None: + LOGGER.warning( + __('"::" in automodule name doesn\'t make sense'), type='autodoc' + ) + return (path or '') + base, () + + if objtype in {'class', 'exception', 'function', 'decorator', 'data', 'type'}: + if module_name is not None: + return module_name, (*parents, base) + if path: + module_name = path.rstrip('.') + return module_name, (*parents, base) + + # if documenting a toplevel object without explicit module, + # it can be contained in another auto directive ... + module_name = current_document.autodoc_module + # ... or in the scope of a module directive + if not module_name: + module_name = ref_context_py_module + # ... else, it stays None, which means invalid + return module_name, (*parents, base) + + if objtype in {'method', 'property', 'attribute'}: + if module_name is not None: + return module_name, (*parents, base) + + if path: + mod_cls = path.rstrip('.') + else: + # if documenting a class-level object without path, + # there must be a current class, either from a parent + # auto directive ... + mod_cls = current_document.autodoc_class + # ... or from a class directive + if not mod_cls: + mod_cls = ref_context_py_class + # ... if still falsy, there's no way to know + if not mod_cls: + return None, () + module_name, _sep, cls = mod_cls.rpartition('.') + parents = [cls] + # if the module name is still missing, get it like above + if not module_name: + module_name = current_document.autodoc_module + if not module_name: + module_name = ref_context_py_module + # ... else, it stays None, which means invalid + return module_name, (*parents, base) + + return None diff --git a/sphinx/ext/autodoc/_property_types.py b/sphinx/ext/autodoc/_property_types.py new file mode 100644 index 00000000000..f95e9885ab2 --- /dev/null +++ b/sphinx/ext/autodoc/_property_types.py @@ -0,0 +1,240 @@ +from __future__ import annotations + +import dataclasses + +from sphinx.ext.autodoc._sentinels import RUNTIME_INSTANCE_ATTRIBUTE, UNINITIALIZED_ATTR + +TYPE_CHECKING = False +if TYPE_CHECKING: + from collections.abc import Sequence + from pathlib import Path + from typing import Any, Literal + + from sphinx.ext.autodoc._sentinels import ( + RUNTIME_INSTANCE_ATTRIBUTE_T, + SLOTS_ATTR_T, + UNINITIALIZED_ATTR_T, + ) + + type _AutodocObjType = Literal[ + 'module', + 'class', + 'exception', + 'function', + 'decorator', + 'method', + 'property', + 'attribute', + 'data', + 'type', + ] + type _AutodocFuncProperty = Literal[ + 'abstractmethod', + 'async', + 'classmethod', + 'final', + 'singledispatch', + 'staticmethod', + ] + + +@dataclasses.dataclass(frozen=False, kw_only=True, slots=True) +class _ItemProperties: + #: The kind of object being documented + obj_type: _AutodocObjType + #: The dotted module name + module_name: str + #: The fully-qualified name within the module + parts: tuple[str, ...] + #: This item's docstring, as a sequence of lines + docstring_lines: tuple[str, ...] + #: The item's signature lines, for use in the directive + signatures: tuple[str, ...] = () + + _docstrings_has_hide_value: bool = False + _obj: Any + _obj___module__: str | None + + @property + def name(self) -> str: + """The name of the item""" + return self.parts[-1] + + @property + def object_name(self) -> str: + if self._obj is RUNTIME_INSTANCE_ATTRIBUTE or self._obj is UNINITIALIZED_ATTR: + return '' + return self.name + + @property + def full_name(self) -> str: + return '.'.join((self.module_name, *self.parts)) + + @property + def parent_names(self) -> tuple[str, ...]: + return self.parts[:-1] + + @property + def dotted_parts(self) -> str: + return '.'.join(self.parts) + + @property + def _groupwise_order_key(self) -> int: + return 0 + + @property + def canonical_module_name(self) -> str: + if self._obj___module__ is not None: + return self._obj___module__ + return self.module_name + + +@dataclasses.dataclass(frozen=False, kw_only=True, slots=True) +class _ModuleProperties(_ItemProperties): + obj_type: Literal['module'] = 'module' + parts: tuple[()] = () # modules have no parts + + file_path: Path | None + all: Sequence[str] | None + + @property + def name(self) -> str: + return self.module_name.rpartition('.')[2] + + @property + def object_name(self) -> str: + return '' + + @property + def full_name(self) -> str: + return self.module_name + + @property + def parent_names(self) -> tuple[str, ...]: + return tuple(self.module_name.split('.')[:-1]) + + +@dataclasses.dataclass(frozen=False, kw_only=True, slots=True) +class _ClassDefProperties(_ItemProperties): + obj_type: Literal['class', 'exception'] + + bases: Sequence[tuple[str, ...]] | None + + _obj___name__: str | None + _obj___qualname__: str | None + _obj_bases: tuple[str, ...] + _obj_is_new_type: bool + _obj_is_typevar: bool + _signature_method_name: str = '' + + @property + def doc_as_attr(self) -> bool: + # if the class is documented under another name, document it + # as data/attribute + if self._obj___name__ is None: + return True + return self.parts[-1] != self._obj___name__ + + @property + def canonical_full_name(self) -> str | None: + modname = self._obj___module__ + if modname is None: + modname = self.module_name + qualname = self._obj___qualname__ + if qualname is None: + qualname = self._obj___name__ + if not modname or not qualname or '' in qualname: + # No valid qualname found if the object is defined as locals + return None + return f'{modname}.{qualname}' + + @property + def _groupwise_order_key(self) -> int: + return 10 if self.obj_type == 'exception' else 20 + + +@dataclasses.dataclass(frozen=False, kw_only=True, slots=True) +class _FunctionDefProperties(_ItemProperties): + obj_type: Literal['function', 'method', 'property', 'decorator'] + + properties: frozenset[_AutodocFuncProperty] + + _obj___name__: str | None + _obj___qualname__: str | None + _obj_property_type_annotation: str | None = None + + @property + def is_abstractmethod(self) -> bool: + return 'abstractmethod' in self.properties + + @property + def is_async(self) -> bool: + return 'async' in self.properties + + @property + def is_classmethod(self) -> bool: + return 'classmethod' in self.properties + + @property + def is_final(self) -> bool: + return 'final' in self.properties + + # @property + # def is_singledispatch(self) -> bool: + # return 'singledispatch' in self.properties + + @property + def is_staticmethod(self) -> bool: + return 'staticmethod' in self.properties + + @property + def _groupwise_order_key(self) -> int: + if self.obj_type == 'method': + if self.is_classmethod: + # document class methods before static methods as + # they usually behave as alternative constructors + return 48 + if self.is_staticmethod: + # document static members before regular methods + return 49 + return 50 + if self.obj_type == 'property': + return 60 + return 30 + + +@dataclasses.dataclass(frozen=False, kw_only=True, slots=True) +class _AssignStatementProperties(_ItemProperties): + obj_type: Literal['attribute', 'data'] + + value: object + annotation: str + + class_var: bool + instance_var: bool + + _obj_is_generic_alias: bool + _obj_is_attribute_descriptor: bool + _obj_is_mock: bool + _obj_is_sentinel: ( + RUNTIME_INSTANCE_ATTRIBUTE_T | SLOTS_ATTR_T | UNINITIALIZED_ATTR_T | None + ) + _obj_repr_rst: str + _obj_type_annotation: str | None + + @property + def _groupwise_order_key(self) -> int: + return 40 if self.obj_type == 'data' else 60 + + +@dataclasses.dataclass(frozen=False, kw_only=True, slots=True) +class _TypeStatementProperties(_ItemProperties): + obj_type: Literal['type'] + + _obj___name__: str | None + _obj___qualname__: str | None + _obj___value__: str # The aliased annotation + + @property + def _groupwise_order_key(self) -> int: + return 70 diff --git a/sphinx/ext/autodoc/_renderer.py b/sphinx/ext/autodoc/_renderer.py new file mode 100644 index 00000000000..6284ba4a0a5 --- /dev/null +++ b/sphinx/ext/autodoc/_renderer.py @@ -0,0 +1,176 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING + +from sphinx.ext.autodoc._property_types import ( + _AssignStatementProperties, + _ClassDefProperties, + _FunctionDefProperties, + _TypeStatementProperties, +) +from sphinx.ext.autodoc._sentinels import SUPPRESS +from sphinx.locale import _ + +if TYPE_CHECKING: + from collections.abc import Iterator + from typing import Literal + + from docutils.statemachine import StringList + + from sphinx.ext.autodoc._directive_options import _AutoDocumenterOptions + from sphinx.ext.autodoc._property_types import _ItemProperties + + +def _directive_header_lines( + *, + autodoc_typehints: Literal['signature', 'description', 'none', 'both'], + directive_name: str, + is_final: bool, + options: _AutoDocumenterOptions, + props: _ItemProperties, +) -> Iterator[str]: + """Emit the directive header and option lines.""" + # normally the name doesn't contain the module + # (except for module directives of course) + name = props.dotted_parts or props.module_name + + # emit one signature per line + # the first line contains the directive prefix + sig_line, *sig_lines = props.signatures or ('',) + prefix = f'.. {directive_name}:: ' + yield f'{prefix}{name}{sig_line}' + # emit remaining lines, indented to the same column + prefix = ' ' * len(prefix) + for sig_line in sig_lines: + yield f'{prefix}{name}{sig_line}' + + if options.no_index or options.noindex: + yield ' :no-index:' + if options.no_index_entry: + yield ' :no-index-entry:' + if props.parts: + # Be explicit about the module, this is necessary since .. class:: + # etc. don't support a prepended module name + yield f' :module: {props.module_name}' + + if props.obj_type == 'module': + # add some module-specific options + if options.synopsis: + yield f' :synopsis: {options.synopsis}' + if options.platform: + yield f' :platform: {options.platform}' + if options.deprecated: + yield ' :deprecated:' + + if props.obj_type in {'class', 'exception'}: + assert isinstance(props, _ClassDefProperties) + + if props._obj_is_new_type or props._obj_is_typevar: + return + + if is_final: + yield ' :final:' + + canonical_fullname = props.canonical_full_name + if ( + not props.doc_as_attr + and not props._obj_is_new_type + and canonical_fullname + and props.full_name != canonical_fullname + ): + yield f' :canonical: {canonical_fullname}' + + # add inheritance info, if wanted + if not props.doc_as_attr and options.show_inheritance: + yield '' + yield ' ' + _('Bases: %s') % ', '.join(props._obj_bases) + + if props.obj_type in {'function', 'decorator'}: + assert isinstance(props, _FunctionDefProperties) + + if props.is_async: + yield ' :async:' + + if props.obj_type == 'method': + assert isinstance(props, _FunctionDefProperties) + + if props.is_abstractmethod: + yield ' :abstractmethod:' + if props.is_async: + yield ' :async:' + if props.is_classmethod: + yield ' :classmethod:' + if props.is_staticmethod: + yield ' :staticmethod:' + if props.is_final or is_final: + yield ' :final:' + + if props.obj_type == 'property': + assert isinstance(props, _FunctionDefProperties) + + if props.is_abstractmethod: + yield ' :abstractmethod:' + if props.is_classmethod: + yield ' :classmethod:' + + objrepr = props._obj_property_type_annotation + if autodoc_typehints != 'none' and objrepr is not None: + yield f' :type: {objrepr}' + + if props.obj_type == 'data': + assert isinstance(props, _AssignStatementProperties) + + if options.annotation is SUPPRESS or props._obj_is_generic_alias: + pass + elif options.annotation: + yield f' :annotation: {options.annotation}' + else: + type_annotation = props._obj_type_annotation + if autodoc_typehints != 'none' and type_annotation is not None: + yield f' :type: {type_annotation}' + + if ( + not options.no_value + and props._obj_is_sentinel is None # not any sentinel + and not props._docstrings_has_hide_value + and not props._obj_is_mock + ): + yield f' :value: {props._obj_repr_rst}' + + if props.obj_type == 'attribute': + assert isinstance(props, _AssignStatementProperties) + + if ( + options.annotation + and options.annotation is not SUPPRESS + and not props._obj_is_generic_alias + ): + yield f' :annotation: {options.annotation}' + else: + type_annotation = props._obj_type_annotation + if autodoc_typehints != 'none' and type_annotation is not None: + yield f' :type: {type_annotation}' + + if ( + not options.no_value + and props._obj_is_sentinel is None # not any sentinel + and not props._obj_is_attribute_descriptor + and not props._obj_is_generic_alias + and not props._docstrings_has_hide_value + and not props._obj_is_mock + ): + yield f' :value: {props._obj_repr_rst}' + + if props.obj_type == 'type': + assert isinstance(props, _TypeStatementProperties) + + if not options.no_value and not props._docstrings_has_hide_value: + yield f' :canonical: {props._obj___value__}' + + +def _add_content(content: StringList, *, result: StringList, indent: str) -> None: + for line, src in zip(content.data, content.items, strict=True): + if line.strip(): # not a blank line + result.append(indent + line, src[0], src[1]) + else: + result.append('', src[0], src[1]) diff --git a/sphinx/ext/autodoc/_sentinels.py b/sphinx/ext/autodoc/_sentinels.py new file mode 100644 index 00000000000..b7025163db2 --- /dev/null +++ b/sphinx/ext/autodoc/_sentinels.py @@ -0,0 +1,106 @@ +from __future__ import annotations + +TYPE_CHECKING = False +if TYPE_CHECKING: + from typing import Final, Literal, NoReturn, Self, _SpecialForm + + +class _Sentinel: + """Create a unique sentinel object.""" + + __slots__ = ('_name',) + + _name: str + + def __new__(cls, name: str, /) -> Self: + sentinel = super().__new__(cls) + object.__setattr__(sentinel, '_name', str(name)) + return sentinel + + def __repr__(self) -> str: + return self._name + + def __setattr__(self, key: str, value: object) -> NoReturn: + msg = f'{self._name} is immutable' + raise AttributeError(msg) + + def __or__(self, other: object) -> _SpecialForm: + from typing import Union + + return Union[self, other] # NoQA: UP007 # ty: ignore[invalid-type-form, invalid-return-type] + + def __ror__(self, other: object) -> _SpecialForm: + from typing import Union + + return Union[other, self] # NoQA: UP007 # ty: ignore[invalid-type-form, invalid-return-type] + + def __getstate__(self) -> NoReturn: + msg = f'Cannot pickle {self._name}' + raise TypeError(msg) + + +class _All(_Sentinel): + """A special value for :*-members: that matches to any member.""" + + def __contains__(self, item: object) -> Literal[True]: + return True + + def append(self, item: object) -> None: + pass # nothing + + +class _Empty(_Sentinel): + """A special value for :exclude-members: that never matches to any member.""" + + def __contains__(self, item: object) -> Literal[False]: + return False + + +if TYPE_CHECKING: + # For the sole purpose of satisfying the type checker. + # fmt: off + import enum + class _AllTC(enum.Enum): + ALL = enum.auto() + + def __contains__(self, item: object) -> Literal[True]: return True + def __add__(self, other: object) -> Self: pass + type ALL_T = Literal[_AllTC.ALL] + ALL: Final[ALL_T] = _AllTC.ALL + + class _EmptyTC(enum.Enum): + EMPTY = enum.auto() + + def __contains__(self, item: object) -> Literal[False]: return False + type EMPTY_T = Literal[_EmptyTC.EMPTY] + EMPTY: Final[EMPTY_T] = _EmptyTC.EMPTY + + class _SentinelTC(enum.Enum): + INSTANCE_ATTR = enum.auto() + RUNTIME_INSTANCE_ATTRIBUTE = enum.auto() + SLOTS_ATTR = enum.auto() + SUPPRESS = enum.auto() + UNINITIALIZED_ATTR = enum.auto() + type INSTANCE_ATTR_T = Literal[_SentinelTC.INSTANCE_ATTR] + type RUNTIME_INSTANCE_ATTRIBUTE_T = Literal[ + _SentinelTC.RUNTIME_INSTANCE_ATTRIBUTE + ] + type SLOTS_ATTR_T = Literal[_SentinelTC.SLOTS_ATTR] + type SUPPRESS_T = Literal[_SentinelTC.SUPPRESS] + type UNINITIALIZED_ATTR_T = Literal[_SentinelTC.UNINITIALIZED_ATTR] + INSTANCE_ATTR: Final[INSTANCE_ATTR_T] = _SentinelTC.INSTANCE_ATTR + RUNTIME_INSTANCE_ATTRIBUTE: Final[RUNTIME_INSTANCE_ATTRIBUTE_T] = ( + _SentinelTC.RUNTIME_INSTANCE_ATTRIBUTE + ) + SLOTS_ATTR: Final[SLOTS_ATTR_T] = _SentinelTC.SLOTS_ATTR + SUPPRESS: Final[SUPPRESS_T] = _SentinelTC.SUPPRESS + UNINITIALIZED_ATTR: Final[UNINITIALIZED_ATTR_T] = _SentinelTC.UNINITIALIZED_ATTR + # fmt: on +else: + ALL = _All('ALL') + EMPTY = _Empty('EMPTY') + INSTANCE_ATTR = _Sentinel('INSTANCE_ATTR') + RUNTIME_INSTANCE_ATTRIBUTE = _Sentinel('RUNTIME_INSTANCE_ATTRIBUTE') + SLOTS_ATTR = _Sentinel('SLOTS_ATTR') + SUPPRESS = _Sentinel('SUPPRESS') + UNINITIALIZED_ATTR = _Sentinel('UNINITIALIZED_ATTR') diff --git a/sphinx/ext/autodoc/_shared.py b/sphinx/ext/autodoc/_shared.py new file mode 100644 index 00000000000..203d85a2318 --- /dev/null +++ b/sphinx/ext/autodoc/_shared.py @@ -0,0 +1,162 @@ +"""Shared utilities for autodoc that don't have a better home.""" + +from __future__ import annotations + +from typing import TYPE_CHECKING + +from sphinx.util import logging +from sphinx.util.inspect import safe_getattr + +if TYPE_CHECKING: + from collections.abc import Callable, Mapping, Sequence + from typing import Any, Final, Literal, NoReturn, Protocol + + from sphinx.config import Config + from sphinx.util.typing import _RestifyMode + + class _AttrGetter(Protocol): # NoQA: PYI046 + def __call__(self, obj: Any, name: str, default: Any = ..., /) -> Any: ... + + +LOGGER: Final[logging.SphinxLoggerAdapter] = logging.getLogger('sphinx.ext.autodoc') + + +class _AutodocConfig: + __slots__ = ( + 'autoclass_content', + 'autodoc_class_signature', + 'autodoc_default_options', + 'autodoc_docstring_signature', + 'autodoc_inherit_docstrings', + 'autodoc_member_order', + 'autodoc_mock_imports', + 'autodoc_preserve_defaults', + 'autodoc_type_aliases', + 'autodoc_typehints', + 'autodoc_typehints_description_target', + 'autodoc_typehints_format', + 'autodoc_use_type_comments', + # non-autodoc config + 'python_display_short_literal_types', + 'strip_signature_backslash', + ) + + autoclass_content: Literal['both', 'class', 'init'] + autodoc_class_signature: Literal['mixed', 'separated'] + autodoc_default_options: Mapping[str, str | bool] + autodoc_docstring_signature: bool + autodoc_inherit_docstrings: bool + autodoc_member_order: Literal['alphabetical', 'bysource', 'groupwise'] + autodoc_mock_imports: Sequence[str] + autodoc_preserve_defaults: bool + autodoc_type_aliases: Mapping[str, str] + autodoc_typehints: Literal['signature', 'description', 'none', 'both'] + autodoc_typehints_description_target: Literal[ + 'all', 'documented', 'documented_params' + ] + autodoc_typehints_format: Literal['fully-qualified', 'short'] + autodoc_use_type_comments: bool + # non-autodoc config + python_display_short_literal_types: bool + strip_signature_backslash: bool + + @classmethod + def from_config(cls, config: Config) -> _AutodocConfig: + return cls( + autoclass_content=config.autoclass_content, + autodoc_class_signature=config.autodoc_class_signature, + autodoc_default_options=config.autodoc_default_options, + autodoc_docstring_signature=config.autodoc_docstring_signature, + autodoc_inherit_docstrings=config.autodoc_inherit_docstrings, + autodoc_member_order=config.autodoc_member_order, + autodoc_mock_imports=config.autodoc_mock_imports, + autodoc_preserve_defaults=config.autodoc_preserve_defaults, + autodoc_type_aliases=config.autodoc_type_aliases, + autodoc_typehints=config.autodoc_typehints, + autodoc_typehints_description_target=config.autodoc_typehints_description_target, + autodoc_typehints_format=config.autodoc_typehints_format, + autodoc_use_type_comments=config.autodoc_use_type_comments, + python_display_short_literal_types=config.python_display_short_literal_types, + strip_signature_backslash=config.strip_signature_backslash, + ) + + def __init__( + self, + *, + autoclass_content: Literal['both', 'class', 'init'] = 'class', + autodoc_class_signature: Literal['mixed', 'separated'] = 'mixed', + autodoc_default_options: Mapping[str, str | bool] = {}.keys().mapping, + autodoc_docstring_signature: bool = True, + autodoc_inherit_docstrings: bool = True, + autodoc_member_order: Literal['alphabetical', 'bysource', 'groupwise'] = ( + 'alphabetical' + ), + autodoc_mock_imports: Sequence[str] = (), + autodoc_preserve_defaults: bool = False, + autodoc_type_aliases: Mapping[str, str] = {}.keys().mapping, + autodoc_typehints: Literal[ + 'signature', 'description', 'none', 'both' + ] = 'signature', + autodoc_typehints_description_target: Literal[ + 'all', 'documented', 'documented_params' + ] = 'all', + autodoc_typehints_format: Literal['fully-qualified', 'short'] = 'short', + autodoc_use_type_comments: bool = True, + python_display_short_literal_types: bool = False, + strip_signature_backslash: bool = False, + ) -> None: + for name in self.__slots__: + super().__setattr__(name, locals()[name]) + + def __repr__(self) -> str: + items = ((name, getattr(self, name)) for name in self.__slots__) + args = ', '.join(f'{name}={value!r}' for name, value in items) + return f'_AutodocConfig({args})' + + def __setattr__(self, key: str, value: Any) -> NoReturn: + msg = f'{self.__class__.__name__} is immutable' + raise AttributeError(msg) + + def __delattr__(self, key: str) -> NoReturn: + msg = f'{self.__class__.__name__} is immutable' + raise AttributeError(msg) + + +class _AutodocAttrGetter: + """getattr() override for types such as Zope interfaces.""" + + _attr_getters: Sequence[tuple[type, Callable[[Any, str, Any], Any]]] + + __slots__ = ('_attr_getters',) + + def __init__( + self, attr_getters: dict[type, Callable[[Any, str, Any], Any]], / + ) -> None: + super().__setattr__('_attr_getters', tuple(attr_getters.items())) + + def __call__(self, obj: Any, name: str, *defargs: Any) -> Any: + for typ, func in self._attr_getters: + if isinstance(obj, typ): + return func(obj, name, *defargs) + + return safe_getattr(obj, name, *defargs) + + def __repr__(self) -> str: + return f'_AutodocAttrGetter({dict(self._attr_getters)!r})' + + def __setattr__(self, key: str, value: Any) -> NoReturn: + msg = f'{self.__class__.__name__} is immutable' + raise AttributeError(msg) + + def __delattr__(self, key: str) -> NoReturn: + msg = f'{self.__class__.__name__} is immutable' + raise AttributeError(msg) + + +def _get_render_mode( + typehints_format: Literal['fully-qualified', 'short'], + /, +) -> _RestifyMode: + if typehints_format == 'short': + return 'smart' + return 'fully-qualified-except-typing' diff --git a/sphinx/ext/autodoc/directive.py b/sphinx/ext/autodoc/directive.py index 03d6383e0e1..23764547d99 100644 --- a/sphinx/ext/autodoc/directive.py +++ b/sphinx/ext/autodoc/directive.py @@ -3,14 +3,12 @@ from collections.abc import Callable from typing import TYPE_CHECKING -from docutils import nodes from docutils.statemachine import StringList from docutils.utils import assemble_option_dict -from sphinx.ext.autodoc import Options -from sphinx.util import logging -from sphinx.util.docutils import SphinxDirective, switch_source_input -from sphinx.util.parsing import nested_parse_to_nodes +from sphinx.ext.autodoc._legacy_class_based._directive_options import Options +from sphinx.ext.autodoc._shared import LOGGER +from sphinx.util.docutils import SphinxDirective if TYPE_CHECKING: from typing import Any @@ -21,12 +19,11 @@ from sphinx.config import Config from sphinx.environment import BuildEnvironment - from sphinx.ext.autodoc import Documenter - -logger = logging.getLogger(__name__) + from sphinx.ext.autodoc._legacy_class_based._documenters import Documenter # common option names for autodoc directives +# Retained: legacy class-based AUTODOC_DEFAULT_OPTIONS = [ 'members', 'undoc-members', @@ -44,6 +41,7 @@ 'no-value', ] +# Retained: legacy class-based AUTODOC_EXTENDABLE_OPTIONS = frozenset({ 'members', 'private-members', @@ -52,6 +50,7 @@ }) +# Retained: legacy class-based class DummyOptionSpec(dict[str, Callable[[str], str]]): # NoQA: FURB189 """An option_spec allows any options.""" @@ -63,6 +62,7 @@ def __getitem__(self, _key: str) -> Callable[[str], str]: return lambda x: x +# Retained: legacy class-based class DocumenterBridge: """A parameters container for Documenters.""" @@ -83,6 +83,7 @@ def __init__( self.state = state +# Retained: legacy class-based def process_documenter_options( documenter: type[Documenter], config: Config, options: dict[str, str] ) -> Options: @@ -109,21 +110,17 @@ def process_documenter_options( return Options(assemble_option_dict(options.items(), documenter.option_spec)) +# Retained: legacy class-based def parse_generated_content( state: RSTState, content: StringList, documenter: Documenter ) -> list[Node]: """Parse an item of content generated by Documenter.""" - with switch_source_input(state, content): - if documenter.titles_allowed: - return nested_parse_to_nodes(state, content) + from sphinx.ext.autodoc._directive import parse_generated_content - node = nodes.paragraph() - # necessary so that the child nodes get the right source/line set - node.document = state.document - state.nested_parse(content, 0, node, match_titles=False) - return node.children + return parse_generated_content(state, content, documenter.titles_allowed) +# Retained: legacy class-based class AutodocDirective(SphinxDirective): """A directive class for all autodoc directives. It works as a dispatcher of Documenters. @@ -139,14 +136,8 @@ class AutodocDirective(SphinxDirective): def run(self) -> list[Node]: reporter = self.state.document.reporter - - try: - source, lineno = reporter.get_source_and_line( # type: ignore[attr-defined] - self.lineno - ) - except AttributeError: - source, lineno = (None, None) - logger.debug('[autodoc] %s:%s: input:\n%s', source, lineno, self.block_text) + source, lineno = self.get_source_info() + LOGGER.debug('[autodoc] %s:%s: input:\n%s', source, lineno, self.block_text) # look up target Documenter objtype = self.name[4:] # strip prefix (auto-). @@ -159,11 +150,11 @@ def run(self) -> list[Node]: ) except (KeyError, ValueError, TypeError) as exc: # an option is either unknown or has a wrong type - logger.error( # NoQA: TRY400 + LOGGER.error( # NoQA: TRY400 'An option to %s is either unknown or has an invalid value: %s', self.name, exc, - location=(self.env.docname, lineno), + location=(self.env.current_document.docname, lineno), ) return [] @@ -176,7 +167,7 @@ def run(self) -> list[Node]: if not params.result: return [] - logger.debug('[autodoc] output:\n%s', '\n'.join(params.result)) + LOGGER.debug('[autodoc] output:\n%s', '\n'.join(params.result)) # record all filenames as dependencies -- this will at least # partially make automatic invalidation possible diff --git a/sphinx/ext/autodoc/importer.py b/sphinx/ext/autodoc/importer.py index ea5b47e41e6..02cf4d14f53 100644 --- a/sphinx/ext/autodoc/importer.py +++ b/sphinx/ext/autodoc/importer.py @@ -2,253 +2,49 @@ from __future__ import annotations -import contextlib -import importlib -import os -import sys import traceback -import typing -from enum import Enum -from importlib.abc import FileLoader from importlib.machinery import EXTENSION_SUFFIXES -from importlib.util import decode_source, find_spec, module_from_spec, spec_from_loader -from pathlib import Path from typing import TYPE_CHECKING, NamedTuple from sphinx.errors import PycodeError -from sphinx.ext.autodoc.mock import ismock, undecorate +from sphinx.ext.autodoc._dynamic._importer import ( + _find_type_stub_spec, # NoQA: F401 + _reload_module, # NoQA: F401 + _StubFileLoader, # NoQA: F401 +) +from sphinx.ext.autodoc._dynamic._importer import ( + _import_module as import_module, +) +from sphinx.ext.autodoc._dynamic._importer import _mangle_name as mangle +from sphinx.ext.autodoc._dynamic._member_finder import ( + _filter_enum_dict, + _is_native_enum_api, # NoQA: F401 + unmangle, +) +from sphinx.ext.autodoc._dynamic._mock import ismock, undecorate +from sphinx.ext.autodoc._shared import LOGGER from sphinx.pycode import ModuleAnalyzer -from sphinx.util import logging from sphinx.util.inspect import ( getannotations, getmro, getslots, - isclass, isenumclass, safe_getattr, - unwrap_all, ) if TYPE_CHECKING: - from collections.abc import Iterator, Mapping - from importlib.machinery import ModuleSpec - from types import ModuleType from typing import Any, Protocol - from sphinx.ext.autodoc import ObjectMember + from sphinx.ext.autodoc._legacy_class_based._documenters import ObjectMember class _AttrGetter(Protocol): def __call__(self, obj: Any, name: str, default: Any = ..., /) -> Any: ... _NATIVE_SUFFIXES: frozenset[str] = frozenset({'.pyx', *EXTENSION_SUFFIXES}) -logger = logging.getLogger(__name__) - - -def _filter_enum_dict( - enum_class: type[Enum], - attrgetter: _AttrGetter, - enum_class_dict: Mapping[str, object], -) -> Iterator[tuple[str, type, Any]]: - """Find the attributes to document of an enumeration class. - - The output consists of triplets ``(attribute name, defining class, value)`` - where the attribute name can appear more than once during the iteration - but with different defining class. The order of occurrence is guided by - the MRO of *enum_class*. - """ - # attributes that were found on a mixin type or the data type - candidate_in_mro: set[str] = set() - # sunder names that were picked up (and thereby allowed to be redefined) - # see: https://docs.python.org/3/howto/enum.html#supported-dunder-names - sunder_names = { - '_name_', - '_value_', - '_missing_', - '_order_', - '_generate_next_value_', - } - # attributes that can be picked up on a mixin type or the enum's data type - public_names = {'name', 'value', *object.__dict__, *sunder_names} - # names that are ignored by default - ignore_names = Enum.__dict__.keys() - public_names - - def should_ignore(name: str, value: Any) -> bool: - if name in sunder_names: - return _is_native_enum_api(value, name) - return name in ignore_names - - sentinel = object() - - def query(name: str, defining_class: type) -> tuple[str, type, Any] | None: - value = attrgetter(enum_class, name, sentinel) - if value is not sentinel: - return name, defining_class, value - return None - - # attributes defined on a parent type, possibly shadowed later by - # the attributes defined directly inside the enumeration class - for parent in enum_class.__mro__: - if parent in {enum_class, Enum, object}: - continue - - parent_dict = attrgetter(parent, '__dict__', {}) - for name, value in parent_dict.items(): - if should_ignore(name, value): - continue - - candidate_in_mro.add(name) - if (item := query(name, parent)) is not None: - yield item - - # exclude members coming from the native Enum unless - # they were redefined on a mixin type or the data type - excluded_members = Enum.__dict__.keys() - candidate_in_mro - yield from filter( - None, - ( - query(name, enum_class) - for name in enum_class_dict - if name not in excluded_members - ), - ) - - # check if allowed members from ``Enum`` were redefined at the enum level - special_names = sunder_names | public_names - special_names &= enum_class_dict.keys() - special_names &= Enum.__dict__.keys() - for name in special_names: - if ( - not _is_native_enum_api(enum_class_dict[name], name) - and (item := query(name, enum_class)) is not None - ): - yield item - - -def _is_native_enum_api(obj: object, name: str) -> bool: - """Check whether *obj* is the same as ``Enum.__dict__[name]``.""" - return unwrap_all(obj) is unwrap_all(Enum.__dict__[name]) - - -def mangle(subject: Any, name: str) -> str: - """Mangle the given name.""" - try: - if isclass(subject) and name.startswith('__') and not name.endswith('__'): - return f'_{subject.__name__}{name}' - except AttributeError: - pass - - return name - - -def unmangle(subject: Any, name: str) -> str | None: - """Unmangle the given name.""" - try: - if isclass(subject) and not name.endswith('__'): - prefix = f'_{subject.__name__}__' - if name.startswith(prefix): - return name.replace(prefix, '__', 1) - else: - for cls in subject.__mro__: - prefix = f'_{cls.__name__}__' - if name.startswith(prefix): - # mangled attribute defined in parent class - return None - except AttributeError: - pass - - return name - - -def import_module(modname: str, try_reload: bool = False) -> Any: - if modname in sys.modules: - return sys.modules[modname] - - original_module_names = frozenset(sys.modules) - try: - spec = find_spec(modname) - if spec is None: - msg = f'No module named {modname!r}' - raise ModuleNotFoundError(msg, name=modname) # NoQA: TRY301 - spec, pyi_path = _find_type_stub_spec(spec, modname) - if pyi_path is None: - module = importlib.import_module(modname) - else: - if spec.loader is None: - msg = 'missing loader' - raise ImportError(msg, name=spec.name) # NoQA: TRY301 - sys.modules[modname] = module = module_from_spec(spec) - spec.loader.exec_module(module) - except ImportError: - raise - except BaseException as exc: - # Importing modules may cause any side effects, including - # SystemExit, so we need to catch all errors. - raise ImportError(exc, traceback.format_exc()) from exc - if try_reload and os.environ.get('SPHINX_AUTODOC_RELOAD_MODULES'): - new_modules = [m for m in sys.modules if m not in original_module_names] - # Try reloading modules with ``typing.TYPE_CHECKING == True``. - try: - typing.TYPE_CHECKING = True # type: ignore[misc] - # Ignore failures; we've already successfully loaded these modules - with contextlib.suppress(ImportError, KeyError): - for m in new_modules: - mod_path = getattr(sys.modules[m], '__file__', '') - if mod_path and mod_path.endswith('.pyi'): - continue - _reload_module(sys.modules[m]) - finally: - typing.TYPE_CHECKING = False # type: ignore[misc] - module = sys.modules[modname] - return module - - -def _find_type_stub_spec( - spec: ModuleSpec, modname: str -) -> tuple[ModuleSpec, Path | None]: - """Try finding a spec for a PEP 561 '.pyi' stub file for native modules.""" - if spec.origin is None: - return spec, None - - for suffix in _NATIVE_SUFFIXES: - if not spec.origin.endswith(suffix): - continue - pyi_path = Path(spec.origin.removesuffix(suffix) + '.pyi') - if not pyi_path.is_file(): - continue - pyi_loader = _StubFileLoader(modname, path=str(pyi_path)) - pyi_spec = spec_from_loader(modname, loader=pyi_loader) - if pyi_spec is not None: - return pyi_spec, pyi_path - return spec, None - - -class _StubFileLoader(FileLoader): - """Load modules from ``.pyi`` stub files.""" - - def get_source(self, fullname: str) -> str: - path = self.get_filename(fullname) - for suffix in _NATIVE_SUFFIXES: - if not path.endswith(suffix): - continue - path = path.removesuffix(suffix) + '.pyi' - try: - source_bytes = self.get_data(path) - except OSError as exc: - raise ImportError from exc - return decode_source(source_bytes) - - -def _reload_module(module: ModuleType) -> Any: - """Call importlib.reload(module), convert exceptions to ImportError""" - try: - return importlib.reload(module) - except BaseException as exc: - # Importing modules may cause any side effects, including - # SystemExit, so we need to catch all errors. - raise ImportError(exc, traceback.format_exc()) from exc +# Retained: legacy class-based def import_object( modname: str, objpath: list[str], @@ -256,9 +52,9 @@ def import_object( attrgetter: _AttrGetter = safe_getattr, ) -> Any: if objpath: - logger.debug('[autodoc] from %s import %s', modname, '.'.join(objpath)) + LOGGER.debug('[autodoc] from %s import %s', modname, '.'.join(objpath)) else: - logger.debug('[autodoc] import %s', modname) + LOGGER.debug('[autodoc] import %s', modname) try: module = None @@ -267,9 +63,9 @@ def import_object( while module is None: try: module = import_module(modname, try_reload=True) - logger.debug('[autodoc] import %s => %r', modname, module) + LOGGER.debug('[autodoc] import %s => %r', modname, module) except ImportError as exc: - logger.debug('[autodoc] import %s => failed', modname) + LOGGER.debug('[autodoc] import %s => failed', modname) exc_on_importing = exc if '.' in modname: # retry with parent module @@ -283,16 +79,16 @@ def import_object( object_name = None for attrname in objpath: parent = obj - logger.debug('[autodoc] getattr(_, %r)', attrname) + LOGGER.debug('[autodoc] getattr(_, %r)', attrname) mangled_name = mangle(obj, attrname) obj = attrgetter(obj, mangled_name) try: - logger.debug('[autodoc] => %r', obj) + LOGGER.debug('[autodoc] => %r', obj) except TypeError: # fallback of failure on logging for broken object # See: https://github.com/sphinx-doc/sphinx/issues/9095 - logger.debug('[autodoc] => %r', (obj,)) + LOGGER.debug('[autodoc] => %r', (obj,)) object_name = attrname return [module, parent, object_name, obj] @@ -329,16 +125,18 @@ def import_object( '; the following exception was raised:\n%s' % traceback.format_exc() ) - logger.debug(errmsg) + LOGGER.debug(errmsg) raise ImportError(errmsg) from exc +# Retained: legacy class-based class Attribute(NamedTuple): name: str directly_defined: bool value: Any +# Retained: legacy class-based def get_object_members( subject: Any, objpath: list[str], @@ -346,7 +144,7 @@ def get_object_members( analyzer: ModuleAnalyzer | None = None, ) -> dict[str, Attribute]: """Get members and attributes of target object.""" - from sphinx.ext.autodoc import INSTANCEATTR + from sphinx.ext.autodoc._legacy_class_based._sentinels import INSTANCEATTR # the members directly defined in the class obj_dict = attrgetter(subject, '__dict__', {}) @@ -371,7 +169,7 @@ def get_object_members( try: subject___slots__ = getslots(subject) if subject___slots__: - from sphinx.ext.autodoc import SLOTSATTR + from sphinx.ext.autodoc._legacy_class_based._sentinels import SLOTSATTR for name in subject___slots__: members[name] = Attribute( @@ -414,11 +212,13 @@ def get_object_members( return members +# Retained: legacy class-based def get_class_members( subject: Any, objpath: Any, attrgetter: _AttrGetter, inherit_docstrings: bool = True ) -> dict[str, ObjectMember]: """Get members and attributes of target class.""" - from sphinx.ext.autodoc import INSTANCEATTR, ObjectMember + from sphinx.ext.autodoc._legacy_class_based._documenters import ObjectMember + from sphinx.ext.autodoc._legacy_class_based._sentinels import INSTANCEATTR # the members directly defined in the class obj_dict = attrgetter(subject, '__dict__', {}) @@ -441,7 +241,7 @@ def get_class_members( try: subject___slots__ = getslots(subject) if subject___slots__: - from sphinx.ext.autodoc import SLOTSATTR + from sphinx.ext.autodoc._legacy_class_based._sentinels import SLOTSATTR for name, docstring in subject___slots__.items(): members[name] = ObjectMember( diff --git a/sphinx/ext/autodoc/mock.py b/sphinx/ext/autodoc/mock.py index 236174a62f9..1fb4330bdfd 100644 --- a/sphinx/ext/autodoc/mock.py +++ b/sphinx/ext/autodoc/mock.py @@ -1,218 +1,13 @@ -"""mock for autodoc""" - from __future__ import annotations -import contextlib -import os -import sys -from importlib.abc import Loader, MetaPathFinder -from importlib.machinery import ModuleSpec -from types import MethodType, ModuleType -from typing import TYPE_CHECKING - -from sphinx.util import logging -from sphinx.util.inspect import isboundmethod, safe_getattr - -if TYPE_CHECKING: - from collections.abc import Iterator, Sequence - from typing import Any - - from typing_extensions import TypeIs - -logger = logging.getLogger(__name__) - - -class _MockObject: - """Used by autodoc_mock_imports.""" - - __display_name__ = '_MockObject' - __name__ = '' - __sphinx_mock__ = True - __sphinx_decorator_args__: tuple[Any, ...] = () - - def __new__(cls, *args: Any, **kwargs: Any) -> Any: # NoQA: ARG004 - if len(args) == 3 and isinstance(args[1], tuple): - superclass = args[1][-1].__class__ - if superclass is cls: - # subclassing MockObject - return _make_subclass( - args[0], - superclass.__display_name__, - superclass=superclass, - attributes=args[2], - ) - - return super().__new__(cls) - - def __init__(self, *args: Any, **kwargs: Any) -> None: - self.__qualname__ = self.__name__ - - def __len__(self) -> int: - return 0 - - def __contains__(self, key: str) -> bool: - return False - - def __iter__(self) -> Iterator[Any]: - return iter(()) - - def __mro_entries__(self, bases: tuple[Any, ...]) -> tuple[type, ...]: - return (self.__class__,) - - def __getitem__(self, key: Any) -> _MockObject: - return _make_subclass(str(key), self.__display_name__, self.__class__)() - - def __getattr__(self, key: str) -> _MockObject: - return _make_subclass(key, self.__display_name__, self.__class__)() - - def __call__(self, *args: Any, **kwargs: Any) -> Any: - call = self.__class__() - call.__sphinx_decorator_args__ = args - return call - - def __repr__(self) -> str: - return self.__display_name__ - - -def _make_subclass( - name: str, - module: str, - superclass: Any = _MockObject, - attributes: Any = None, - decorator_args: tuple[Any, ...] = (), -) -> Any: - attrs = { - '__module__': module, - '__display_name__': module + '.' + name, - '__name__': name, - '__sphinx_decorator_args__': decorator_args, - } - attrs.update(attributes or {}) - - return type(name, (superclass,), attrs) - - -class _MockModule(ModuleType): - """Used by autodoc_mock_imports.""" - - __file__ = os.devnull - __sphinx_mock__ = True - - def __init__(self, name: str) -> None: - super().__init__(name) - self.__all__: list[str] = [] - self.__path__: list[str] = [] - - def __getattr__(self, name: str) -> _MockObject: - return _make_subclass(name, self.__name__)() - - def __repr__(self) -> str: - return self.__name__ - - -class MockLoader(Loader): - """A loader for mocking.""" - - def __init__(self, finder: MockFinder) -> None: - super().__init__() - self.finder = finder - - def create_module(self, spec: ModuleSpec) -> ModuleType: - logger.debug('[autodoc] adding a mock module as %s!', spec.name) - self.finder.mocked_modules.append(spec.name) - return _MockModule(spec.name) - - def exec_module(self, module: ModuleType) -> None: - pass # nothing to do - - -class MockFinder(MetaPathFinder): - """A finder for mocking.""" - - def __init__(self, modnames: list[str]) -> None: - super().__init__() - self.modnames = modnames - self.loader = MockLoader(self) - self.mocked_modules: list[str] = [] - - def find_spec( - self, - fullname: str, - path: Sequence[bytes | str] | None, - target: ModuleType | None = None, - ) -> ModuleSpec | None: - for modname in self.modnames: - # check if fullname is (or is a descendant of) one of our targets - if modname == fullname or fullname.startswith(modname + '.'): - return ModuleSpec(fullname, self.loader) - - return None - - def invalidate_caches(self) -> None: - """Invalidate mocked modules on sys.modules.""" - for modname in self.mocked_modules: - sys.modules.pop(modname, None) - - -@contextlib.contextmanager -def mock(modnames: list[str]) -> Iterator[None]: - """Insert mock modules during context:: - - with mock(['target.module.name']): - # mock modules are enabled here - ... - """ - finder = MockFinder(modnames) - try: - sys.meta_path.insert(0, finder) - yield - finally: - sys.meta_path.remove(finder) - finder.invalidate_caches() - - -def ismockmodule(subject: Any) -> TypeIs[_MockModule]: - """Check if the object is a mocked module.""" - return isinstance(subject, _MockModule) - - -def ismock(subject: Any) -> bool: - """Check if the object is mocked.""" - # check the object has '__sphinx_mock__' attribute - try: - if safe_getattr(subject, '__sphinx_mock__', None) is None: - return False - except AttributeError: - return False - - # check the object is mocked module - if isinstance(subject, _MockModule): - return True - - # check the object is bound method - if isinstance(subject, MethodType) and isboundmethod(subject): - tmp_subject = subject.__func__ - else: - tmp_subject = subject - - try: - # check the object is mocked object - __mro__ = safe_getattr(type(tmp_subject), '__mro__', []) - if len(__mro__) > 2 and __mro__[-2] is _MockObject: - # A mocked object has a MRO that ends with (..., _MockObject, object). - return True - except AttributeError: - pass - - return False - - -def undecorate(subject: _MockObject) -> Any: - """Unwrap mock if *subject* is decorated by mocked object. - - If not decorated, returns given *subject* itself. - """ - if ismock(subject) and subject.__sphinx_decorator_args__: - return subject.__sphinx_decorator_args__[0] - else: - return subject +from sphinx.ext.autodoc._dynamic._mock import ( + MockFinder, # NoQA: F401 + MockLoader, # NoQA: F401 + _make_subclass, # NoQA: F401 + _MockModule, # NoQA: F401 + _MockObject, # NoQA: F401 + ismock, # NoQA: F401 + ismockmodule, # NoQA: F401 + mock, # NoQA: F401 + undecorate, # NoQA: F401 +) diff --git a/sphinx/ext/autodoc/preserve_defaults.py b/sphinx/ext/autodoc/preserve_defaults.py index 44fcf215c1c..fed033a7ec1 100644 --- a/sphinx/ext/autodoc/preserve_defaults.py +++ b/sphinx/ext/autodoc/preserve_defaults.py @@ -6,203 +6,27 @@ from __future__ import annotations -import ast -import inspect -import types -import warnings from typing import TYPE_CHECKING -import sphinx -from sphinx.deprecation import RemovedInSphinx90Warning -from sphinx.locale import __ -from sphinx.pycode.ast import unparse as ast_unparse -from sphinx.util import logging +from sphinx.ext.autodoc._dynamic._preserve_defaults import ( + DefaultValue, # NoQA: F401 + _get_arguments, # NoQA: F401 + _get_arguments_inner, # NoQA: F401 + _is_lambda, # NoQA: F401 + get_default_value, # NoQA: F401 + update_default_value, +) if TYPE_CHECKING: from typing import Any from sphinx.application import Sphinx - from sphinx.util.typing import ExtensionMetadata - -logger = logging.getLogger(__name__) -_LAMBDA_NAME = (lambda: None).__name__ - - -class DefaultValue: - def __init__(self, name: str) -> None: - self.name = name - - def __repr__(self) -> str: - return self.name - - -def get_function_def(obj: Any) -> ast.FunctionDef | None: - """Get FunctionDef object from living object. - - This tries to parse original code for living object and returns - AST node for given *obj*. - """ - warnings.warn( - 'sphinx.ext.autodoc.preserve_defaults.get_function_def is' - ' deprecated and scheduled for removal in Sphinx 9.' - ' Use sphinx.ext.autodoc.preserve_defaults._get_arguments() to' - ' extract AST arguments objects from a lambda or regular' - ' function.', - RemovedInSphinx90Warning, - stacklevel=2, - ) - - try: - source = inspect.getsource(obj) - if source.startswith((' ', '\t')): - # subject is placed inside class or block. To read its docstring, - # this adds if-block before the declaration. - module = ast.parse('if True:\n' + source) - return module.body[0].body[0] # type: ignore[attr-defined] - else: - module = ast.parse(source) - return module.body[0] # type: ignore[return-value] - except (OSError, TypeError): # failed to load source code - return None - - -def _get_arguments(obj: Any, /) -> ast.arguments | None: - """Parse 'ast.arguments' from an object. - - This tries to parse the original code for an object and returns - an 'ast.arguments' node. - """ - try: - source = inspect.getsource(obj) - if source.startswith((' ', '\t')): - # 'obj' is in some indented block. - module = ast.parse('if True:\n' + source) - subject = module.body[0].body[0] # type: ignore[attr-defined] - else: - module = ast.parse(source) - subject = module.body[0] - except (OSError, TypeError): - # bail; failed to load source for 'obj'. - return None - except SyntaxError: - if _is_lambda(obj): - # Most likely a multi-line arising from detecting a lambda, e.g.: - # - # class Egg: - # x = property( - # lambda self: 1, doc="...") - return None - - # Other syntax errors that are not due to the fact that we are - # documenting a lambda function are propagated - # (in particular if a lambda is renamed by the user). - raise - - return _get_arguments_inner(subject) - - -def _is_lambda(x: Any, /) -> bool: - return isinstance(x, types.LambdaType) and x.__name__ == _LAMBDA_NAME - - -def _get_arguments_inner(x: Any, /) -> ast.arguments | None: - if isinstance(x, ast.AsyncFunctionDef | ast.FunctionDef | ast.Lambda): - return x.args - if isinstance(x, ast.Assign | ast.AnnAssign): - return _get_arguments_inner(x.value) - return None - - -def get_default_value(lines: list[str], position: ast.expr) -> str | None: - try: - if position.lineno == position.end_lineno: - line = lines[position.lineno - 1] - return line[position.col_offset : position.end_col_offset] - else: - # multiline value is not supported now - return None - except (AttributeError, IndexError): - return None +# Retained: legacy class-based def update_defvalue(app: Sphinx, obj: Any, bound_method: bool) -> None: """Update defvalue info of *obj* using type_comments.""" if not app.config.autodoc_preserve_defaults: return - try: - lines = inspect.getsource(obj).splitlines() - if lines[0].startswith((' ', '\t')): - # insert a dummy line to follow what _get_arguments() does. - lines.insert(0, '') - except (OSError, TypeError): - lines = [] - - try: - args = _get_arguments(obj) - except SyntaxError: - return - if args is None: - # If the object is a built-in, we won't be always able to recover - # the function definition and its arguments. This happens if *obj* - # is the `__init__` method generated automatically for dataclasses. - return - - if not args.defaults and not args.kw_defaults: - return - - try: - if bound_method and inspect.ismethod(obj) and hasattr(obj, '__func__'): - sig = inspect.signature(obj.__func__) - else: - sig = inspect.signature(obj) - defaults = list(args.defaults) - kw_defaults = list(args.kw_defaults) - parameters = list(sig.parameters.values()) - for i, param in enumerate(parameters): - if param.default is param.empty: - if param.kind == param.KEYWORD_ONLY: - # Consume kw_defaults for kwonly args - kw_defaults.pop(0) - else: - if param.kind in {param.POSITIONAL_ONLY, param.POSITIONAL_OR_KEYWORD}: - default = defaults.pop(0) - value = get_default_value(lines, default) - if value is None: - value = ast_unparse(default) - parameters[i] = param.replace(default=DefaultValue(value)) - else: - default = kw_defaults.pop(0) # type: ignore[assignment] - value = get_default_value(lines, default) - if value is None: - value = ast_unparse(default) - parameters[i] = param.replace(default=DefaultValue(value)) - - sig = sig.replace(parameters=parameters) - try: - obj.__signature__ = sig - except AttributeError: - # __signature__ can't be set directly on bound methods. - obj.__dict__['__signature__'] = sig - except (AttributeError, TypeError): - # Failed to update signature (e.g. built-in or extension types). - # For user-defined functions, "obj" may not have __dict__, - # e.g. when decorated with a class that defines __slots__. - # In this case, we can't set __signature__. - return - except NotImplementedError as exc: # failed to ast_unparse() - logger.warning( - __('Failed to parse a default argument value for %r: %s'), obj, exc - ) - - -def setup(app: Sphinx) -> ExtensionMetadata: - app.add_config_value( - 'autodoc_preserve_defaults', False, 'env', types=frozenset({bool}) - ) - app.connect('autodoc-before-process-signature', update_defvalue) - - return { - 'version': sphinx.__display_version__, - 'parallel_read_safe': True, - } + update_default_value(obj, bound_method) diff --git a/sphinx/ext/autodoc/type_comment.py b/sphinx/ext/autodoc/type_comment.py index 69923609f69..e099ca7b492 100644 --- a/sphinx/ext/autodoc/type_comment.py +++ b/sphinx/ext/autodoc/type_comment.py @@ -2,167 +2,25 @@ from __future__ import annotations -import ast -from inspect import Parameter, Signature, getsource -from typing import TYPE_CHECKING, cast +from typing import TYPE_CHECKING -import sphinx -from sphinx.locale import __ -from sphinx.pycode.ast import unparse as ast_unparse -from sphinx.util import inspect, logging +from sphinx.ext.autodoc._dynamic._type_comments import ( + _update_annotations_using_type_comments, + not_suppressed, # NoQA: F401 + signature_from_ast, # NoQA: F401 +) if TYPE_CHECKING: - from collections.abc import Sequence from typing import Any from sphinx.application import Sphinx - from sphinx.util.typing import ExtensionMetadata - -logger = logging.getLogger(__name__) - - -def not_suppressed(argtypes: Sequence[ast.expr] = ()) -> bool: - """Check given *argtypes* is suppressed type_comment or not.""" - if len(argtypes) == 0: # no argtypees - return False - if len(argtypes) == 1: - arg = argtypes[0] - if isinstance(arg, ast.Constant) and arg.value is ...: # suppressed - return False - # not suppressed - return True - - -def signature_from_ast( - node: ast.FunctionDef, bound_method: bool, type_comment: ast.FunctionDef -) -> Signature: - """Return a Signature object for the given *node*. - - :param bound_method: Specify *node* is a bound method or not - """ - params = [] - for arg in node.args.posonlyargs: - param = Parameter( - arg.arg, - Parameter.POSITIONAL_ONLY, - annotation=arg.type_comment, - ) - params.append(param) - - for arg in node.args.args: - param = Parameter( - arg.arg, - Parameter.POSITIONAL_OR_KEYWORD, - annotation=arg.type_comment or Parameter.empty, - ) - params.append(param) - - if node.args.vararg: - param = Parameter( - node.args.vararg.arg, - Parameter.VAR_POSITIONAL, - annotation=node.args.vararg.type_comment or Parameter.empty, - ) - params.append(param) - - for arg in node.args.kwonlyargs: - param = Parameter( - arg.arg, - Parameter.KEYWORD_ONLY, - annotation=arg.type_comment or Parameter.empty, - ) - params.append(param) - - if node.args.kwarg: - param = Parameter( - node.args.kwarg.arg, - Parameter.VAR_KEYWORD, - annotation=node.args.kwarg.type_comment or Parameter.empty, - ) - params.append(param) - - # Remove first parameter when *obj* is bound_method - if bound_method and params: - params.pop(0) - - # merge type_comment into signature - if not_suppressed(type_comment.argtypes): # type: ignore[attr-defined] - for i, param in enumerate(params): - params[i] = param.replace(annotation=type_comment.argtypes[i]) # type: ignore[attr-defined] - - if node.returns: - return Signature(params, return_annotation=node.returns) - elif type_comment.returns: - return Signature(params, return_annotation=ast_unparse(type_comment.returns)) - else: - return Signature(params) - - -def get_type_comment(obj: Any, bound_method: bool = False) -> Signature | None: - """Get type_comment'ed FunctionDef object from living object. - - This tries to parse original code for living object and returns - Signature for given *obj*. - """ - try: - source = getsource(obj) - if source.startswith((' ', r'\t')): - # subject is placed inside class or block. To read its docstring, - # this adds if-block before the declaration. - module = ast.parse('if True:\n' + source, type_comments=True) - subject = cast('ast.FunctionDef', module.body[0].body[0]) # type: ignore[attr-defined] - else: - module = ast.parse(source, type_comments=True) - subject = cast('ast.FunctionDef', module.body[0]) - - type_comment = getattr(subject, 'type_comment', None) - if type_comment: - function = ast.parse(type_comment, mode='func_type', type_comments=True) - return signature_from_ast(subject, bound_method, function) # type: ignore[arg-type] - else: - return None - except (OSError, TypeError): # failed to load source code - return None - except SyntaxError: # failed to parse type_comments - return None +# Retained: legacy class-based def update_annotations_using_type_comments( app: Sphinx, obj: Any, bound_method: bool ) -> None: - """Update annotations info of *obj* using type_comments.""" if not app.config.autodoc_use_type_comments: - return - - try: - type_sig = get_type_comment(obj, bound_method) - if type_sig: - sig = inspect.signature(obj, bound_method) - for param in sig.parameters.values(): - if param.name not in obj.__annotations__: - annotation = type_sig.parameters[param.name].annotation - if annotation is not Parameter.empty: - obj.__annotations__[param.name] = ast_unparse(annotation) - - if 'return' not in obj.__annotations__: - obj.__annotations__['return'] = type_sig.return_annotation - except KeyError as exc: - logger.warning( - __('Failed to update signature for %r: parameter not found: %s'), obj, exc - ) - except NotImplementedError as exc: # failed to ast.unparse() - logger.warning(__('Failed to parse type_comment for %r: %s'), obj, exc) - - -def setup(app: Sphinx) -> ExtensionMetadata: - app.add_config_value( - 'autodoc_use_type_comments', True, 'env', types=frozenset({bool}) - ) - app.connect( - 'autodoc-before-process-signature', update_annotations_using_type_comments - ) + return None - return { - 'version': sphinx.__display_version__, - 'parallel_read_safe': True, - } + return _update_annotations_using_type_comments(obj, bound_method) diff --git a/sphinx/ext/autodoc/typehints.py b/sphinx/ext/autodoc/typehints.py index 63403772137..0ddd906051c 100644 --- a/sphinx/ext/autodoc/typehints.py +++ b/sphinx/ext/autodoc/typehints.py @@ -7,10 +7,8 @@ from docutils import nodes -import sphinx from sphinx import addnodes -from sphinx.util import inspect -from sphinx.util.typing import stringify_annotation +from sphinx.ext.autodoc._dynamic._type_annotations import _record_typehints if TYPE_CHECKING: from collections.abc import Iterable @@ -19,10 +17,11 @@ from docutils.nodes import Element from sphinx.application import Sphinx - from sphinx.ext.autodoc import Options - from sphinx.util.typing import ExtensionMetadata, _StringifyMode + from sphinx.ext.autodoc._legacy_class_based._directive_options import Options + from sphinx.ext.autodoc._property_types import _AutodocObjType +# Retained: legacy class-based def record_typehints( app: Sphinx, objtype: str, @@ -33,34 +32,18 @@ def record_typehints( retann: str, ) -> None: """Record type hints to env object.""" - mode: _StringifyMode - if app.config.autodoc_typehints_format == 'short': - mode = 'smart' - else: - mode = 'fully-qualified' - - short_literals = app.config.python_display_short_literal_types - - try: - if callable(obj): - current_document = app.env.current_document - annotation = current_document.autodoc_annotations.setdefault(name, {}) - sig = inspect.signature(obj, type_aliases=app.config.autodoc_type_aliases) - for param in sig.parameters.values(): - if param.annotation is not param.empty: - annotation[param.name] = stringify_annotation( - param.annotation, mode, short_literals=short_literals - ) - if sig.return_annotation is not sig.empty: - annotation['return'] = stringify_annotation( - sig.return_annotation, mode, short_literals=short_literals - ) - except (TypeError, ValueError): - pass - - -def merge_typehints( - app: Sphinx, domain: str, objtype: str, contentnode: Element + _record_typehints( + autodoc_annotations=app.env.current_document.autodoc_annotations, + name=name, + obj=obj, + short_literals=app.config.python_display_short_literal_types, + type_aliases=app.config.autodoc_type_aliases, + unqualified_typehints=app.config.autodoc_typehints_format == 'short', + ) + + +def _merge_typehints( + app: Sphinx, domain: str, obj_type: _AutodocObjType, contentnode: Element ) -> None: if domain != 'py': return @@ -86,7 +69,7 @@ def merge_typehints( for field_list in field_lists: if app.config.autodoc_typehints_description_target == 'all': - if objtype == 'class': + if obj_type == 'class': modify_field_list( field_list, annotations[fullname], suppress_rtype=True ) @@ -230,14 +213,3 @@ def augment_descriptions_with_types( field += nodes.field_name('', 'rtype') field += nodes.field_body('', nodes.paragraph('', rtype)) node += field - - -def setup(app: Sphinx) -> ExtensionMetadata: - app.connect('autodoc-process-signature', record_typehints) - app.connect('object-description-transform', merge_typehints) - - return { - 'version': sphinx.__display_version__, - 'parallel_read_safe': True, - 'parallel_write_safe': True, - } diff --git a/sphinx/ext/autosectionlabel.py b/sphinx/ext/autosectionlabel.py index b1eaa0ceac9..7c5304ad83d 100644 --- a/sphinx/ext/autosectionlabel.py +++ b/sphinx/ext/autosectionlabel.py @@ -39,7 +39,7 @@ def register_sections_as_label(app: Sphinx, document: Node) -> None: ): continue labelid = node['ids'][0] - docname = app.env.docname + docname = app.env.current_document.docname title = cast('nodes.title', node[0]) ref_name = getattr(title, 'rawsource', title.astext()) if app.config.autosectionlabel_prefix_document: diff --git a/sphinx/ext/autosummary/__init__.py b/sphinx/ext/autosummary/__init__.py index 97c64a37cd1..c3bd7dd4b05 100644 --- a/sphinx/ext/autosummary/__init__.py +++ b/sphinx/ext/autosummary/__init__.py @@ -55,28 +55,26 @@ import re import sys from inspect import Parameter -from pathlib import Path from types import ModuleType from typing import TYPE_CHECKING, cast from docutils import nodes from docutils.parsers.rst import directives -from docutils.parsers.rst.states import RSTStateMachine, Struct, state_classes +from docutils.parsers.rst.states import RSTStateMachine, state_classes from docutils.statemachine import StringList import sphinx from sphinx import addnodes -from sphinx.config import Config -from sphinx.environment import BuildEnvironment from sphinx.errors import PycodeError -from sphinx.ext.autodoc import INSTANCEATTR, Options -from sphinx.ext.autodoc.directive import DocumenterBridge -from sphinx.ext.autodoc.importer import import_module -from sphinx.ext.autodoc.mock import mock +from sphinx.ext.autodoc._directive_options import _AutoDocumenterOptions +from sphinx.ext.autodoc._dynamic._importer import _import_module +from sphinx.ext.autodoc._dynamic._loader import _load_object_by_name +from sphinx.ext.autodoc._dynamic._member_finder import _best_object_type_for_member +from sphinx.ext.autodoc._dynamic._mock import mock +from sphinx.ext.autodoc._sentinels import INSTANCE_ATTR +from sphinx.ext.autodoc._shared import _AutodocAttrGetter, _AutodocConfig from sphinx.locale import __ -from sphinx.project import Project from sphinx.pycode import ModuleAnalyzer -from sphinx.registry import SphinxComponentRegistry from sphinx.util import logging, rst from sphinx.util.docutils import ( NullReporter, @@ -96,8 +94,8 @@ from docutils.nodes import Node, system_message from sphinx.application import Sphinx - from sphinx.ext.autodoc import Documenter - from sphinx.extension import Extension + from sphinx.environment import BuildEnvironment + from sphinx.ext.autodoc._property_types import _AutodocObjType from sphinx.util.typing import ExtensionMetadata, OptionSpec from sphinx.writers.html5 import HTML5Translator @@ -107,7 +105,7 @@ periods_re = re.compile(r'\.(?:\s+)') literal_re = re.compile(r'::\s*$') -WELL_KNOWN_ABBREVIATIONS = ('et al.', 'e.g.', 'i.e.') +WELL_KNOWN_ABBREVIATIONS = ('et al.', 'e.g.', 'i.e.', 'vs.') # -- autosummary_toc node ------------------------------------------------------ @@ -156,79 +154,36 @@ def autosummary_table_visit_html( # -- autodoc integration ------------------------------------------------------- -class FakeApplication: - verbosity = 0 +def _get_documenter(obj: Any, parent: Any) -> _AutodocObjType: + """Get the best object type suitable for documenting the given object. - def __init__(self) -> None: - self.doctreedir = Path() - self.events = None - self.extensions: dict[str, Extension] = {} - self.srcdir = Path() - self.config = Config() - self.project = Project('', {}) - self.registry = SphinxComponentRegistry() - - -class FakeDirective(DocumenterBridge): - def __init__(self) -> None: - settings = Struct(tab_width=8) - document = Struct(settings=settings) - app = FakeApplication() - app.config.add('autodoc_class_signature', 'mixed', 'env', ()) - env = BuildEnvironment(app) # type: ignore[arg-type] - state = Struct(document=document) - super().__init__(env, None, Options(), 0, state) - - -def get_documenter(app: Sphinx, obj: Any, parent: Any) -> type[Documenter]: - """Get an autodoc.Documenter class suitable for documenting the given - object. - - *obj* is the Python object to be documented, and *parent* is an - another Python object (e.g. a module or a class) to which *obj* - belongs to. + *obj* is the Python object to be documented, and *parent* is another + Python object (e.g. a module or a class) to which *obj* belongs. """ - return _get_documenter(obj, parent, registry=app.registry) - - -def _get_documenter( - obj: Any, parent: Any, *, registry: SphinxComponentRegistry -) -> type[Documenter]: - """Get an autodoc.Documenter class suitable for documenting the given - object. - - *obj* is the Python object to be documented, and *parent* is an - another Python object (e.g. a module or a class) to which *obj* - belongs to. - """ - from sphinx.ext.autodoc import DataDocumenter, ModuleDocumenter - if inspect.ismodule(obj): - # ModuleDocumenter.can_document_member always returns False - return ModuleDocumenter + return 'module' - # Construct a fake documenter for *parent* - if parent is not None: - parent_doc_cls = _get_documenter(parent, None, registry=registry) + if parent is None or inspect.ismodule(parent): + parent_obj_type = 'module' else: - parent_doc_cls = ModuleDocumenter + parent_opt = _best_object_type_for_member( + member=parent, + member_name='', + is_attr=False, + parent_obj_type='module', + parent_props=None, + ) + parent_obj_type = parent_opt if parent_opt is not None else 'data' - if hasattr(parent, '__name__'): - parent_doc = parent_doc_cls(FakeDirective(), parent.__name__) - else: - parent_doc = parent_doc_cls(FakeDirective(), '') - - # Get the correct documenter class for *obj* - classes = [ - cls - for cls in registry.documenters.values() - if cls.can_document_member(obj, '', False, parent_doc) - ] - if classes: - classes.sort(key=lambda cls: cls.priority) - return classes[-1] - else: - return DataDocumenter + if obj_type := _best_object_type_for_member( + member=obj, + member_name='', + is_attr=False, + parent_obj_type=parent_obj_type, + parent_props=None, + ): + return obj_type + return 'data' # -- .. autosummary:: ---------------------------------------------------------- @@ -255,10 +210,6 @@ class Autosummary(SphinxDirective): } def run(self) -> list[Node]: - self.bridge = DocumenterBridge( - self.env, self.state.document.reporter, Options(), self.lineno, self.state - ) - names = [ x.strip().split()[0] for x in self.content @@ -268,7 +219,7 @@ def run(self) -> list[Node]: nodes = self.get_table(items) if 'toctree' in self.options: - dirname = posixpath.dirname(self.env.docname) + dirname = posixpath.dirname(self.env.current_document.docname) tree_prefix = self.options['toctree'].strip() docnames = [] @@ -330,22 +281,6 @@ def import_by_name( raise ImportExceptionGroup(exc.args[0], errors) from None - def create_documenter( - self, - obj: Any, - parent: Any, - full_name: str, - *, - registry: SphinxComponentRegistry, - ) -> Documenter: - """Get an autodoc.Documenter class suitable for documenting the given - object. - - Wraps _get_documenter and is meant as a hook for extensions. - """ - doccls = _get_documenter(obj, parent, registry=registry) - return doccls(self.bridge, full_name) - def get_items(self, names: list[str]) -> list[tuple[str, str | None, str, str]]: """Try to import the given names, and return a list of ``[(name, signature, summary_string, real_name), ...]``. @@ -366,6 +301,16 @@ def get_items(self, names: list[str]) -> list[tuple[str, str | None, str, str]]: ) raise ValueError(msg) + document_settings = self.state.document.settings + env = self.env + config = _AutodocConfig.from_config(env.config) + current_document = env.current_document + events = env.events + get_attr = _AutodocAttrGetter(env._registry.autodoc_attrgetters) + opts = _AutoDocumenterOptions() + ref_context = env.ref_context + reread_always = env.reread_always + max_item_chars = 50 for name in names: @@ -388,26 +333,27 @@ def get_items(self, names: list[str]) -> list[tuple[str, str | None, str, str]]: ) continue - self.bridge.result = StringList() # initialize for each documenter - full_name = real_name - if not isinstance(obj, ModuleType): + obj_type = _get_documenter(obj, parent) + if isinstance(obj, ModuleType): + full_name = real_name + else: # give explicitly separated module name, so that members # of inner classes can be documented - full_name = modname + '::' + full_name[len(modname) + 1 :] + full_name = f'{modname}::{real_name[len(modname) + 1 :]}' # NB. using full_name here is important, since Documenters # handle module prefixes slightly differently - documenter = self.create_documenter( - obj, parent, full_name, registry=self.env._registry + props = _load_object_by_name( + name=full_name, + objtype=obj_type, + current_document=current_document, + config=config, + events=events, + get_attr=get_attr, + options=opts, + ref_context=ref_context, + reread_always=reread_always, ) - if not documenter.parse_name(): - logger.warning( - __('failed to parse name %s'), - real_name, - location=self.get_location(), - ) - items.append((display_name, '', '', real_name)) - continue - if not documenter.import_object(): + if props is None: logger.warning( __('failed to import object %s'), real_name, @@ -416,45 +362,22 @@ def get_items(self, names: list[str]) -> list[tuple[str, str | None, str, str]]: items.append((display_name, '', '', real_name)) continue - # try to also get a source code analyzer for attribute docs - try: - documenter.analyzer = ModuleAnalyzer.for_module( - documenter.get_real_modname() - ) - # parse right now, to get PycodeErrors on parsing (results will - # be cached anyway) - documenter.analyzer.find_attr_docs() - except PycodeError as err: - logger.debug('[autodoc] module analyzer failed: %s', err) - # no source file -- e.g. for builtin and C modules - documenter.analyzer = None - # -- Grab the signature if signatures_option == 'none': sig = None - else: - try: - sig = documenter.format_signature(show_annotation=False) - except TypeError: - # the documenter does not support ``show_annotation`` option - sig = documenter.format_signature() - if not sig: - sig = '' - elif signatures_option == 'short': - if sig != '()': - sig = '(…)' - else: # signatures_option == 'long' - max_chars = max(10, max_item_chars - len(display_name)) - sig = mangle_signature(sig, max_chars=max_chars) + elif not props.signatures: + sig = '' + elif signatures_option == 'short': + sig = '()' if props.signatures == ('()',) else '(…)' + else: # signatures_option == 'long' + max_chars = max(10, max_item_chars - len(display_name)) + sig = mangle_signature('\n'.join(props.signatures), max_chars=max_chars) # -- Grab the summary - # bodge for ModuleDocumenter - documenter._extra_indent = '' # type: ignore[attr-defined] - - documenter.add_content(None) - summary = extract_summary(self.bridge.result.data[:], self.state.document) + # get content from docstrings or attribute documentation + summary = extract_summary(props.docstring_lines, document_settings) items.append((display_name, sig, summary, real_name)) @@ -511,7 +434,7 @@ def append_row(*column_texts: str) -> None: def strip_arg_typehint(s: str) -> str: """Strip a type hint from argument definition.""" - return s.split(':')[0].strip() + return s.partition(':')[0].strip() def _cleanup_signature(s: str) -> str: @@ -596,43 +519,39 @@ def mangle_signature(sig: str, max_chars: int = 30) -> str: return '(%s)' % sig -def extract_summary(doc: list[str], document: Any) -> str: +def extract_summary(doc: Sequence[str], settings: Any) -> str: """Extract summary from docstring.""" + # Find the first stanza (heading, sentence, paragraph, etc.). + # If there's a blank line, then we can assume that the stanza has ended, + # so anything after shouldn't be part of the summary. + first_stanza = [] + content_started = False + for line in doc: + is_blank_line = not line or line.isspace() + if not content_started: + # Skip any blank lines at the start + if is_blank_line: + continue + content_started = True + if content_started: + if is_blank_line: + break + first_stanza.append(line) - def parse(doc: list[str], settings: Any) -> nodes.document: - state_machine = RSTStateMachine(state_classes, 'Body') - node = new_document('', settings) - node.reporter = NullReporter() - state_machine.run(doc, node) - - return node - - # Skip a blank lines at the top - while doc and not doc[0].strip(): - doc.pop(0) - - # If there's a blank line, then we can assume the first sentence / - # paragraph has ended, so anything after shouldn't be part of the - # summary - for i, piece in enumerate(doc): - if not piece.strip(): - doc = doc[:i] - break - - if doc == []: + if not first_stanza: return '' # parse the docstring - node = parse(doc, document.settings) + node = _parse_summary(first_stanza, settings) if isinstance(node[0], nodes.section): # document starts with a section heading, so use that. summary = node[0].astext().strip() elif not isinstance(node[0], nodes.paragraph): # document starts with non-paragraph: pick up the first line - summary = doc[0].strip() + summary = first_stanza[0].strip() else: # Try to find the "first sentence", which may span multiple lines - sentences = periods_re.split(' '.join(doc)) + sentences = periods_re.split(' '.join(first_stanza)) if len(sentences) == 1: summary = sentences[0].strip() else: @@ -640,7 +559,7 @@ def parse(doc: list[str], settings: Any) -> nodes.document: for i in range(len(sentences)): summary = '. '.join(sentences[: i + 1]).rstrip('.') + '.' node[:] = [] - node = parse(doc, document.settings) + node = _parse_summary(first_stanza, settings) if summary.endswith(WELL_KNOWN_ABBREVIATIONS): pass elif not any(node.findall(nodes.system_message)): @@ -653,6 +572,15 @@ def parse(doc: list[str], settings: Any) -> nodes.document: return summary +def _parse_summary(doc: Sequence[str], settings: Any) -> nodes.document: + state_machine = RSTStateMachine(state_classes, 'Body') + node = new_document('', settings) + node.reporter = NullReporter() + state_machine.run(doc, node) + + return node + + def limited_join( sep: str, items: list[str], max_chars: int = 30, overflow_marker: str = '...' ) -> str: @@ -682,18 +610,12 @@ def limited_join( # -- Importing items ----------------------------------------------------------- -class ImportExceptionGroup(Exception): +class ImportExceptionGroup(BaseExceptionGroup): """Exceptions raised during importing the target objects. - It contains an error messages and a list of exceptions as its arguments. + It contains an error message and a list of exceptions as its arguments. """ - def __init__( - self, message: str | None, exceptions: Sequence[BaseException] - ) -> None: - super().__init__(message) - self.exceptions = list(exceptions) - def get_import_prefixes_from_env(env: BuildEnvironment) -> list[str | None]: """Obtain current Python import prefixes (for `import_by_name`) @@ -756,7 +678,8 @@ def import_by_name( exceptions: list[BaseException] = functools.reduce( operator.iadd, (e.exceptions for e in errors), [] ) - raise ImportExceptionGroup('no module named %s' % ' or '.join(tried), exceptions) + msg = f'could not import {" or ".join(tried)}' + raise ImportExceptionGroup(msg, exceptions) def _import_by_name(name: str, grouped_exception: bool = True) -> tuple[Any, Any, str]: @@ -770,7 +693,7 @@ def _import_by_name(name: str, grouped_exception: bool = True) -> tuple[Any, Any modname = '.'.join(name_parts[:-1]) if modname: try: - mod = import_module(modname) + mod = _import_module(modname) return getattr(mod, name_parts[-1]), mod, modname except (ImportError, IndexError, AttributeError) as exc: errors.append(exc.__cause__ or exc) @@ -782,7 +705,7 @@ def _import_by_name(name: str, grouped_exception: bool = True) -> tuple[Any, Any last_j = j modname = '.'.join(name_parts[:j]) try: - import_module(modname) + _import_module(modname) except ImportError as exc: errors.append(exc.__cause__ or exc) @@ -814,7 +737,7 @@ def import_ivar_by_name( """ try: name, attr = name.rsplit('.', 1) - real_name, obj, parent, modname = import_by_name(name, prefixes) + real_name, obj, _parent, modname = import_by_name(name, prefixes) # Get ancestors of the object (class.__mro__ includes the class itself as # the first entry) @@ -832,7 +755,7 @@ def import_ivar_by_name( found_attrs |= {attr for (qualname, attr) in analyzer.attr_docs} found_attrs |= {attr for (qualname, attr) in analyzer.annotations} if attr in found_attrs: - return f'{real_name}.{attr}', INSTANCEATTR, obj, modname + return f'{real_name}.{attr}', INSTANCE_ATTR, obj, modname except (ImportError, ValueError, PycodeError) as exc: raise ImportError from exc except ImportExceptionGroup: diff --git a/sphinx/ext/autosummary/generate.py b/sphinx/ext/autosummary/generate.py index d865c0de2af..aec02012ddf 100644 --- a/sphinx/ext/autosummary/generate.py +++ b/sphinx/ext/autosummary/generate.py @@ -33,7 +33,10 @@ from sphinx.builders import Builder from sphinx.config import Config from sphinx.errors import PycodeError -from sphinx.ext.autodoc.importer import import_module +from sphinx.ext.autodoc._dynamic._importer import _import_module +from sphinx.ext.autodoc._dynamic._member_finder import _filter_enum_dict, unmangle +from sphinx.ext.autodoc._dynamic._mock import ismock, undecorate +from sphinx.ext.autodoc._sentinels import INSTANCE_ATTR, SLOTS_ATTR from sphinx.ext.autosummary import ( ImportExceptionGroup, _get_documenter, @@ -45,7 +48,14 @@ from sphinx.registry import SphinxComponentRegistry from sphinx.util import logging, rst from sphinx.util._pathlib import _StrPath -from sphinx.util.inspect import getall, safe_getattr +from sphinx.util.inspect import ( + getall, + getannotations, + getmro, + getslots, + isenumclass, + safe_getattr, +) from sphinx.util.osutil import ensuredir from sphinx.util.template import SphinxTemplateLoader @@ -57,7 +67,7 @@ from sphinx.application import Sphinx from sphinx.events import EventManager - from sphinx.ext.autodoc import Documenter + from sphinx.ext.autodoc._property_types import _AutodocObjType logger = logging.getLogger(__name__) @@ -96,34 +106,6 @@ class AutosummaryEntry(NamedTuple): recursive: bool -def setup_documenters(app: Sphinx) -> None: - from sphinx.ext.autodoc import ( - AttributeDocumenter, - ClassDocumenter, - DataDocumenter, - DecoratorDocumenter, - ExceptionDocumenter, - FunctionDocumenter, - MethodDocumenter, - ModuleDocumenter, - PropertyDocumenter, - ) - - documenters: list[type[Documenter]] = [ - ModuleDocumenter, - ClassDocumenter, - ExceptionDocumenter, - DataDocumenter, - FunctionDocumenter, - MethodDocumenter, - AttributeDocumenter, - DecoratorDocumenter, - PropertyDocumenter, - ] - for documenter in documenters: - app.registry.add_documenter(documenter.objtype, documenter) - - def _underline(title: str, line: str = '=') -> str: if '\n' in title: msg = 'Can only underline single lines' @@ -211,20 +193,18 @@ def __init__( *, config: Config, events: EventManager, - registry: SphinxComponentRegistry, ) -> None: self.config = config self.events = events - self.registry = registry self.object = obj def get_object_type(self, name: str, value: Any) -> str: - return _get_documenter(value, self.object, registry=self.registry).objtype + return _get_documenter(value, self.object) - def is_skipped(self, name: str, value: Any, objtype: str) -> bool: + def is_skipped(self, name: str, value: Any, obj_type: _AutodocObjType) -> bool: try: return self.events.emit_firstresult( - 'autodoc-skip-member', objtype, name, value, False, {} + 'autodoc-skip-member', obj_type, name, value, False, {} ) except Exception as exc: logger.warning( @@ -252,7 +232,7 @@ def scan(self, imported_members: bool) -> list[str]: except AttributeError: value = None - objtype = self.get_object_type(name, value) + objtype = _get_documenter(value, self.object) if self.is_skipped(name, value, objtype): continue @@ -311,15 +291,14 @@ def generate_autosummary_content( *, config: Config, events: EventManager, - registry: SphinxComponentRegistry, ) -> str: - doc = _get_documenter(obj, parent, registry=registry) + obj_type = _get_documenter(obj, parent) ns: dict[str, Any] = {} ns.update(context) - if doc.objtype == 'module': - scanner = ModuleScanner(obj, config=config, events=events, registry=registry) + if obj_type == 'module': + scanner = ModuleScanner(obj, config=config, events=events) ns['members'] = scanner.scan(imported_members) respect_module_all = not config.autosummary_ignore_module_all @@ -328,30 +307,27 @@ def generate_autosummary_content( ) ns['functions'], ns['all_functions'] = _get_members( - doc, + obj_type, obj, {'function'}, config=config, events=events, - registry=registry, imported=imported_members, ) ns['classes'], ns['all_classes'] = _get_members( - doc, + obj_type, obj, {'class'}, config=config, events=events, - registry=registry, imported=imported_members, ) ns['exceptions'], ns['all_exceptions'] = _get_members( - doc, + obj_type, obj, {'exception'}, config=config, events=events, - registry=registry, imported=imported_members, ) ns['attributes'], ns['all_attributes'] = _get_module_attrs(name, ns['members']) @@ -374,12 +350,11 @@ def generate_autosummary_content( # Otherwise, use get_modules method normally if respect_module_all and '__all__' in dir(obj): imported_modules, all_imported_modules = _get_members( - doc, + obj_type, obj, {'module'}, config=config, events=events, - registry=registry, imported=True, ) skip += all_imported_modules @@ -393,34 +368,32 @@ def generate_autosummary_content( ) ns['modules'] = imported_modules + modules ns['all_modules'] = all_imported_modules + all_modules - elif doc.objtype == 'class': + elif obj_type == 'class': ns['members'] = dir(obj) ns['inherited_members'] = set(dir(obj)) - set(obj.__dict__.keys()) ns['methods'], ns['all_methods'] = _get_members( - doc, + obj_type, obj, {'method'}, config=config, events=events, - registry=registry, include_public={'__init__'}, ) ns['attributes'], ns['all_attributes'] = _get_members( - doc, + obj_type, obj, {'attribute', 'property'}, config=config, events=events, - registry=registry, ) if modname is None or qualname is None: modname, qualname = _split_full_qualified_name(name) - if doc.objtype in {'method', 'attribute', 'property'}: + if obj_type in {'method', 'attribute', 'property'}: ns['class'] = qualname.rsplit('.', 1)[0] - if doc.objtype == 'class': + if obj_type == 'class': shortname = qualname else: shortname = qualname.rsplit('.', 1)[-1] @@ -430,19 +403,21 @@ def generate_autosummary_content( ns['objname'] = qualname ns['name'] = shortname - ns['objtype'] = doc.objtype + ns['objtype'] = obj_type ns['underline'] = len(name) * '=' if template_name: return template.render(template_name, ns) else: - return template.render(doc.objtype, ns) + return template.render(obj_type, ns) -def _skip_member(obj: Any, name: str, objtype: str, *, events: EventManager) -> bool: +def _skip_member( + obj: Any, name: str, obj_type: _AutodocObjType, *, events: EventManager +) -> bool: try: return events.emit_firstresult( - 'autodoc-skip-member', objtype, name, obj, False, {} + 'autodoc-skip-member', obj_type, name, obj, False, {} ) except Exception as exc: logger.warning( @@ -458,8 +433,76 @@ def _skip_member(obj: Any, name: str, objtype: str, *, events: EventManager) -> def _get_class_members(obj: Any) -> dict[str, Any]: - members = sphinx.ext.autodoc.importer.get_class_members(obj, None, safe_getattr) - return {name: member.object for name, member in members.items()} + """Get members and attributes of target class.""" + # TODO: Simplify + # the members directly defined in the class + obj_dict = safe_getattr(obj, '__dict__', {}) + + members_simpler: dict[str, Any] = {} + + # enum members + if isenumclass(obj): + for name, defining_class, value in _filter_enum_dict( + obj, safe_getattr, obj_dict + ): + # the order of occurrence of *name* matches obj's MRO, + # allowing inherited attributes to be shadowed correctly + if unmangled := unmangle(defining_class, name): + members_simpler[unmangled] = value + + # members in __slots__ + try: + subject___slots__ = getslots(obj) + if subject___slots__: + for name in subject___slots__: + members_simpler[name] = SLOTS_ATTR + except (TypeError, ValueError): + pass + + # other members + for name in dir(obj): + try: + value = safe_getattr(obj, name) + if ismock(value): + value = undecorate(value) + + unmangled = unmangle(obj, name) + if unmangled and unmangled not in members_simpler: + members_simpler[unmangled] = value + except AttributeError: + continue + + try: + for cls in getmro(obj): + try: + modname = safe_getattr(cls, '__module__') + qualname = safe_getattr(cls, '__qualname__') + except AttributeError: + qualname = None + analyzer = None + else: + try: + analyzer = ModuleAnalyzer.for_module(modname) + analyzer.analyze() + except PycodeError: + analyzer = None + + # annotation only member (ex. attr: int) + for name in getannotations(cls): + unmangled = unmangle(cls, name) + if unmangled and unmangled not in members_simpler: + members_simpler[unmangled] = INSTANCE_ATTR + + # append or complete instance attributes (cf. self.attr1) if analyzer knows + if analyzer: + for ns, name in analyzer.attr_docs: + if ns == qualname and name not in members_simpler: + # otherwise unknown instance attribute + members_simpler[name] = INSTANCE_ATTR + except AttributeError: + pass + + return members_simpler def _get_module_members(obj: Any, *, config: Config) -> dict[str, Any]: @@ -473,36 +516,35 @@ def _get_module_members(obj: Any, *, config: Config) -> dict[str, Any]: def _get_all_members( - doc: type[Documenter], obj: Any, *, config: Config + obj_type: _AutodocObjType, obj: Any, *, config: Config ) -> dict[str, Any]: - if doc.objtype == 'module': + if obj_type == 'module': return _get_module_members(obj, config=config) - elif doc.objtype == 'class': + elif obj_type == 'class': return _get_class_members(obj) return {} def _get_members( - doc: type[Documenter], + obj_type: _AutodocObjType, obj: Any, types: set[str], *, config: Config, events: EventManager, - registry: SphinxComponentRegistry, include_public: Set[str] = frozenset(), imported: bool = True, ) -> tuple[list[str], list[str]]: items: list[str] = [] public: list[str] = [] - all_members = _get_all_members(doc, obj, config=config) + all_members = _get_all_members(obj_type, obj, config=config) for name, value in all_members.items(): - documenter = _get_documenter(value, obj, registry=registry) - if documenter.objtype in types: + obj_type = _get_documenter(value, obj) + if obj_type in types: # skip imported members if expected if imported or getattr(value, '__module__', None) == obj.__name__: - skipped = _skip_member(value, name, documenter.objtype, events=events) + skipped = _skip_member(value, name, obj_type, events=events) if skipped is True: pass elif skipped is False: @@ -548,7 +590,7 @@ def _get_modules( continue fullname = f'{name}.{modname}' try: - module = import_module(fullname) + module = _import_module(fullname) except ImportError: pass else: @@ -583,7 +625,7 @@ def generate_autosummary_docs( showed_sources = sorted(sources) if len(showed_sources) > 20: - showed_sources = showed_sources[:10] + ['...'] + showed_sources[-10:] + showed_sources = [*showed_sources[:10], '...', *showed_sources[-10:]] logger.info( __('[autosummary] generating autosummary for: %s'), ', '.join(showed_sources) ) @@ -655,7 +697,6 @@ def generate_autosummary_docs( qualname, config=app.config, events=app.events, - registry=app.registry, ) file_path = Path(path, filename_map.get(name, name) + suffix) @@ -719,7 +760,7 @@ def find_autosummary_in_docstring( See `find_autosummary_in_lines`. """ try: - real_name, obj, parent, modname = import_by_name(name) + _real_name, obj, _parent, _modname = import_by_name(name) lines = pydoc.getdoc(obj).splitlines() return find_autosummary_in_lines(lines, module=name, filename=filename) except AttributeError: @@ -919,7 +960,6 @@ def main(argv: Sequence[str] = (), /) -> None: app = DummyApplication(sphinx.locale.get_translator()) logging.setup(app, sys.stdout, sys.stderr) # type: ignore[arg-type] - setup_documenters(app) # type: ignore[arg-type] args = get_parser().parse_args(argv or sys.argv[1:]) if args.templates: diff --git a/sphinx/ext/coverage.py b/sphinx/ext/coverage.py index b2d08603f38..cd83bcbaec1 100644 --- a/sphinx/ext/coverage.py +++ b/sphinx/ext/coverage.py @@ -156,7 +156,7 @@ def _determine_py_coverage_modules( logger.warning( __( 'the following modules are specified in coverage_modules ' - 'but were not documented' + 'but were not documented: %s' ), ', '.join(missing_modules), ) @@ -255,7 +255,7 @@ def write_c_coverage(self) -> None: for typ, name in sorted(undoc): op.write(f' * {name:<50} [{typ:>9}]\n') if self.config.coverage_show_missing_items: - if self.app.quiet: + if self.config.verbosity < 0: logger.warning( __('undocumented c api: %s [%s] in file %s'), name, @@ -446,7 +446,7 @@ def write_py_coverage(self) -> None: op.write('Functions:\n') op.writelines(f' * {x}\n' for x in undoc['funcs']) if self.config.coverage_show_missing_items: - if self.app.quiet: + if self.config.verbosity < 0: for func in undoc['funcs']: logger.warning( __('undocumented python function: %s :: %s'), @@ -468,7 +468,7 @@ def write_py_coverage(self) -> None: if not methods: op.write(f' * {class_name}\n') if self.config.coverage_show_missing_items: - if self.app.quiet: + if self.config.verbosity < 0: logger.warning( __('undocumented python class: %s :: %s'), name, @@ -485,7 +485,7 @@ def write_py_coverage(self) -> None: op.write(f' * {class_name} -- missing methods:\n\n') op.writelines(f' - {x}\n' for x in methods) if self.config.coverage_show_missing_items: - if self.app.quiet: + if self.config.verbosity < 0: for meth in methods: logger.warning( __( diff --git a/sphinx/ext/doctest.py b/sphinx/ext/doctest.py index 105c50a6923..9da6c4318d4 100644 --- a/sphinx/ext/doctest.py +++ b/sphinx/ext/doctest.py @@ -336,12 +336,12 @@ def __del__(self) -> None: if hasattr(self, 'outfile'): self.outfile.close() - def _out(self, text: str) -> None: + def _out(self, text: str, /) -> None: logger.info(text, nonl=True) self.outfile.write(text) - def _warn_out(self, text: str) -> None: - if self.app.quiet: + def _warn_out(self, text: str, /) -> None: + if self.config.verbosity < 0: logger.warning(text) else: logger.info(text, nonl=True) @@ -358,10 +358,17 @@ def finish(self) -> None: def s(v: int) -> str: return 's' if v != 1 else '' + header = 'Doctest summary' + if self.total_failures or self.setup_failures or self.cleanup_failures: + self._app.statuscode = 1 + if self.config.doctest_fail_fast: + header = f'{header} (exiting after first failed test)' + underline = '=' * len(header) + self._out( f""" -Doctest summary -=============== +{header} +{underline} {self.total_tries:5} test{s(self.total_tries)} {self.total_failures:5} failure{s(self.total_failures)} in tests {self.setup_failures:5} failure{s(self.setup_failures)} in setup code @@ -370,15 +377,14 @@ def s(v: int) -> str: ) self.outfile.close() - if self.total_failures or self.setup_failures or self.cleanup_failures: - self.app.statuscode = 1 - def write_documents(self, docnames: Set[str]) -> None: logger.info(bold('running tests...')) for docname in sorted(docnames): # no need to resolve the doctree doctree = self.env.get_doctree(docname) - self.test_doc(docname, doctree) + success = self.test_doc(docname, doctree) + if not success and self.config.doctest_fail_fast: + break def get_filename_for_node(self, node: Node, docname: str) -> str: """Try to get the file which actually contains the doctest, not the @@ -386,7 +392,7 @@ def get_filename_for_node(self, node: Node, docname: str) -> str: """ try: filename = relpath(node.source, self.env.srcdir) # type: ignore[arg-type] - return filename.rsplit(':docstring of ', maxsplit=1)[0] + return filename.partition(':docstring of ')[0] except Exception: return str(self.env.doc2path(docname, False)) @@ -419,7 +425,7 @@ def skipped(self, node: Element) -> bool: exec(self.config.doctest_global_cleanup, context) # NoQA: S102 return should_skip - def test_doc(self, docname: str, doctree: Node) -> None: + def test_doc(self, docname: str, doctree: Node) -> bool: groups: dict[str, TestGroup] = {} add_to_all_groups = [] self.setup_runner = SphinxDocTestRunner(verbose=False, optionflags=self.opt) @@ -430,21 +436,9 @@ def test_doc(self, docname: str, doctree: Node) -> None: self.cleanup_runner._fakeout = self.setup_runner._fakeout # type: ignore[attr-defined] if self.config.doctest_test_doctest_blocks: - - def condition(node: Node) -> bool: - return ( - isinstance(node, nodes.literal_block | nodes.comment) - and 'testnodetype' in node - ) or isinstance(node, nodes.doctest_block) - + condition = _condition_with_doctest else: - - def condition(node: Node) -> bool: - return ( - isinstance(node, nodes.literal_block | nodes.comment) - and 'testnodetype' in node - ) - + condition = _condition_default for node in doctree.findall(condition): if self.skipped(node): # type: ignore[arg-type] continue @@ -466,7 +460,7 @@ def condition(node: Node) -> bool: lineno=line_number, # type: ignore[arg-type] options=node.get('options'), # type: ignore[attr-defined] ) - node_groups = node.get('groups', ['default']) # type: ignore[attr-defined] + node_groups = node.get('groups', [self.config.doctest_test_doctest_blocks]) # type: ignore[attr-defined] if '*' in node_groups: add_to_all_groups.append(code) continue @@ -496,13 +490,17 @@ def condition(node: Node) -> bool: for group in groups.values(): group.add_code(code) if not groups: - return + return True show_successes = self.config.doctest_show_successes if show_successes: self._out(f'\nDocument: {docname}\n----------{"-" * len(docname)}\n') + success = True for group in groups.values(): - self.test_group(group) + if not self.test_group(group): + success = False + if self.config.doctest_fail_fast: + break # Separately count results from setup code res_f, res_t = self.setup_runner.summarize(self._out, verbose=False) self.setup_failures += res_f @@ -517,13 +515,14 @@ def condition(node: Node) -> bool: ) self.cleanup_failures += res_f self.cleanup_tries += res_t + return success def compile( self, code: str, name: str, type: str, flags: Any, dont_inherit: bool ) -> Any: return compile(code, name, self.type, flags, dont_inherit) - def test_group(self, group: TestGroup) -> None: + def test_group(self, group: TestGroup) -> bool: ns: dict[str, Any] = {} def run_setup_cleanup( @@ -553,9 +552,10 @@ def run_setup_cleanup( # run the setup code if not run_setup_cleanup(self.setup_runner, group.setup, 'setup'): # if setup failed, don't run the group - return + return False # run the tests + success = True for code in group.tests: if len(code) == 1: # ordinary doctests (code/output interleaved) @@ -608,11 +608,19 @@ def run_setup_cleanup( self.type = 'exec' # multiple statements again # DocTest.__init__ copies the globs namespace, which we don't want test.globs = ns + old_f = self.test_runner.failures # also don't clear the globs namespace after running the doctest self.test_runner.run(test, out=self._warn_out, clear_globs=False) + if self.test_runner.failures > old_f: + success = False + if self.config.doctest_fail_fast: + break # run the cleanup - run_setup_cleanup(self.cleanup_runner, group.cleanup, 'cleanup') + if not run_setup_cleanup(self.cleanup_runner, group.cleanup, 'cleanup'): + return False + + return success def setup(app: Sphinx) -> ExtensionMetadata: @@ -638,7 +646,19 @@ def setup(app: Sphinx) -> ExtensionMetadata: '', types=frozenset({int}), ) + app.add_config_value('doctest_fail_fast', False, '', types=frozenset({bool})) return { 'version': sphinx.__display_version__, 'parallel_read_safe': True, } + + +def _condition_default(node: Node) -> bool: + return ( + isinstance(node, (nodes.literal_block, nodes.comment)) + and 'testnodetype' in node + ) + + +def _condition_with_doctest(node: Node) -> bool: + return _condition_default(node) or isinstance(node, nodes.doctest_block) diff --git a/sphinx/ext/duration.py b/sphinx/ext/duration.py index 1cf3f7b58d4..6207869c218 100644 --- a/sphinx/ext/duration.py +++ b/sphinx/ext/duration.py @@ -2,9 +2,11 @@ from __future__ import annotations +import json import time from itertools import islice from operator import itemgetter +from types import NoneType from typing import TYPE_CHECKING import sphinx @@ -13,7 +15,8 @@ from sphinx.util import logging if TYPE_CHECKING: - from collections.abc import Set + from collections.abc import Collection, Set + from pathlib import Path from typing import TypedDict from docutils import nodes @@ -37,7 +40,16 @@ def reading_durations(self) -> dict[str, float]: return self.data.setdefault('reading_durations', {}) def note_reading_duration(self, duration: float) -> None: - self.reading_durations[self.env.docname] = duration + self.reading_durations[self.env.current_document.docname] = duration + + def warn_reading_duration(self, duration: float, duration_limit: float) -> None: + logger.warning( + __('Reading duration %.3fs exceeded the duration limit %.3fs'), + duration, + duration_limit, + type='duration', + location=self.env.docname, + ) def clear(self) -> None: self.reading_durations.clear() @@ -75,22 +87,65 @@ def on_doctree_read(app: Sphinx, doctree: nodes.document) -> None: domain = app.env.domains['duration'] domain.note_reading_duration(duration) + duration_limit: float | None = app.config.duration_limit + if duration_limit is not None and duration > duration_limit: + domain.warn_reading_duration(duration, duration_limit) + def on_build_finished(app: Sphinx, error: Exception) -> None: """Display duration ranking on the current build.""" domain = app.env.domains['duration'] if not domain.reading_durations: return - durations = sorted( - domain.reading_durations.items(), key=itemgetter(1), reverse=True + + # Get default options and update with user-specified values + if app.config.duration_print_total: + _print_total_duration(domain.reading_durations.values()) + + if app.config.duration_print_slowest: + _print_slowest_durations( + domain.reading_durations, app.config.duration_n_slowest + ) + + if write_json := app.config.duration_write_json: + _write_json_durations(domain.reading_durations, app.outdir / write_json) + + +def _print_total_duration(durations: Collection[float]) -> None: + logger.info('') + logger.info( + __('====================== total reading duration ==========================') + ) + + n_files = len(durations) + s = 's' if n_files != 1 else '' + minutes, seconds = divmod(sum(durations), 60) + logger.info( + __('Total time reading %d file%s: %dm %.3fs'), n_files, s, minutes, seconds ) + +def _print_slowest_durations(durations: dict[str, float], n_slowest: int) -> None: + sorted_durations = sorted(durations.items(), key=itemgetter(1), reverse=True) + n_slowest = n_slowest or len(sorted_durations) + n_slowest = min(n_slowest, len(sorted_durations)) + + logger.info('') logger.info('') logger.info( __('====================== slowest reading durations =======================') ) - for docname, d in islice(durations, 5): - logger.info(f'{d:.3f} {docname}') # NoQA: G004 + for docname, duration in islice(sorted_durations, n_slowest): + logger.info(__('%.3fs %s'), duration, docname) + + logger.info('') + + +def _write_json_durations(durations: dict[str, float], out_file: Path) -> None: + durations = {k: round(v, 3) for k, v in durations.items()} + out_file.parent.mkdir(parents=True, exist_ok=True) + durations_json = json.dumps(durations, ensure_ascii=False, indent=4, sort_keys=True) + out_file.write_text(durations_json, encoding='utf-8') def setup(app: Sphinx) -> dict[str, bool | str]: @@ -100,6 +155,19 @@ def setup(app: Sphinx) -> dict[str, bool | str]: app.connect('doctree-read', on_doctree_read) app.connect('build-finished', on_build_finished) + app.add_config_value('duration_print_total', True, '', types=frozenset({bool})) + app.add_config_value('duration_print_slowest', True, '', types=frozenset({bool})) + app.add_config_value('duration_n_slowest', 5, '', types=frozenset({int})) + app.add_config_value( + 'duration_write_json', + 'sphinx-reading-durations.json', + '', + types=frozenset({str, NoneType}), + ) + app.add_config_value( + 'duration_limit', None, '', types=frozenset({float, int, NoneType}) + ) + return { 'version': sphinx.__display_version__, 'parallel_read_safe': True, diff --git a/sphinx/ext/extlinks.py b/sphinx/ext/extlinks.py index a5e213ac9f9..82a323bd4b8 100644 --- a/sphinx/ext/extlinks.py +++ b/sphinx/ext/extlinks.py @@ -68,7 +68,7 @@ def check_uri(self, refnode: nodes.reference) -> None: uri = refnode['refuri'] title = refnode.astext() - for alias, (base_uri, _caption) in self.app.config.extlinks.items(): + for alias, (base_uri, _caption) in self.config.extlinks.items(): uri_pattern = re.compile(re.escape(base_uri).replace('%s', '(?P.+)')) match = uri_pattern.match(uri) diff --git a/sphinx/ext/graphviz.py b/sphinx/ext/graphviz.py index 9cd4d163e36..8ba99cc24ad 100644 --- a/sphinx/ext/graphviz.py +++ b/sphinx/ext/graphviz.py @@ -167,7 +167,7 @@ def run(self) -> list[Node]: ] node = graphviz() node['code'] = dotcode - node['options'] = {'docname': self.env.docname} + node['options'] = {'docname': self.env.current_document.docname} if 'graphviz_dot' in self.options: node['options']['graphviz_dot'] = self.options['graphviz_dot'] @@ -212,7 +212,7 @@ def run(self) -> list[Node]: node = graphviz() dot_code = '\n'.join(self.content) node['code'] = f'{self.name} {self.arguments[0]} {{\n{dot_code}\n}}\n' - node['options'] = {'docname': self.env.docname} + node['options'] = {'docname': self.env.current_document.docname} if 'graphviz_dot' in self.options: node['options']['graphviz_dot'] = self.options['graphviz_dot'] if 'layout' in self.options: @@ -431,7 +431,7 @@ def render_dot_latex( filename: str | None = None, ) -> None: try: - fname, outfn = render_dot(self, code, options, 'pdf', prefix, filename) + fname, _outfn = render_dot(self, code, options, 'pdf', prefix, filename) except GraphvizError as exc: logger.warning(__('dot code %r: %s'), code, exc) raise nodes.SkipNode from exc @@ -475,7 +475,7 @@ def render_dot_texinfo( prefix: str = 'graphviz', ) -> None: try: - fname, outfn = render_dot(self, code, options, 'png', prefix) + fname, _outfn = render_dot(self, code, options, 'png', prefix) except GraphvizError as exc: logger.warning(__('dot code %r: %s'), code, exc) raise nodes.SkipNode from exc diff --git a/sphinx/ext/imgmath.py b/sphinx/ext/imgmath.py index b7bcf4a7a67..a8f88c62a1c 100644 --- a/sphinx/ext/imgmath.py +++ b/sphinx/ext/imgmath.py @@ -32,7 +32,6 @@ from docutils.nodes import Element from sphinx.application import Sphinx - from sphinx.builders import Builder from sphinx.config import Config from sphinx.util._pathlib import _StrPath from sphinx.util.typing import ExtensionMetadata @@ -116,36 +115,23 @@ def generate_latex_macro( return LaTeXRenderer([templates_path]).render(template_name + '.jinja', variables) -def ensure_tempdir(builder: Builder) -> Path: - """Create temporary directory. - - use only one tempdir per build -- the use of a directory is cleaner - than using temporary files, since we can clean up everything at once - just removing the whole directory (see cleanup_tempdir) - """ - if not hasattr(builder, '_imgmath_tempdir'): - builder._imgmath_tempdir = Path(tempfile.mkdtemp()) # type: ignore[attr-defined] - - return builder._imgmath_tempdir # type: ignore[attr-defined] - - -def compile_math(latex: str, builder: Builder) -> Path: +def compile_math(latex: str, *, config: Config) -> Path: """Compile LaTeX macros for math to DVI.""" - tempdir = ensure_tempdir(builder) + tempdir = Path(tempfile.mkdtemp(suffix='-sphinx-imgmath')) filename = tempdir / 'math.tex' with open(filename, 'w', encoding='utf-8') as f: f.write(latex) - imgmath_latex_name = os.path.basename(builder.config.imgmath_latex) + imgmath_latex_name = os.path.basename(config.imgmath_latex) # build latex command; old versions of latex don't have the # --output-directory option, so we have to manually chdir to the # temp dir to run it. - command = [builder.config.imgmath_latex] + command = [config.imgmath_latex] if imgmath_latex_name != 'tectonic': command.append('--interaction=nonstopmode') # add custom args from the config file - command.extend(builder.config.imgmath_latex_args) + command.extend(config.imgmath_latex_args) command.append('math.tex') try: @@ -162,7 +148,7 @@ def compile_math(latex: str, builder: Builder) -> Path: 'LaTeX command %r cannot be run (needed for math ' 'display), check the imgmath_latex setting' ), - builder.config.imgmath_latex, + config.imgmath_latex, ) raise InvokeError from exc except CalledProcessError as exc: @@ -191,19 +177,19 @@ def convert_dvi_to_image(command: list[str], name: str) -> tuple[str, str]: raise MathExtError(msg, exc.stderr, exc.stdout) from exc -def convert_dvi_to_png(dvipath: Path, builder: Builder, out_path: Path) -> int | None: +def convert_dvi_to_png(dvipath: Path, out_path: Path, *, config: Config) -> int | None: """Convert DVI file to PNG image.""" name = 'dvipng' - command = [builder.config.imgmath_dvipng, '-o', out_path, '-T', 'tight', '-z9'] - command.extend(builder.config.imgmath_dvipng_args) - if builder.config.imgmath_use_preview: + command = [config.imgmath_dvipng, '-o', out_path, '-T', 'tight', '-z9'] + command.extend(config.imgmath_dvipng_args) + if config.imgmath_use_preview: command.append('--depth') command.append(dvipath) - stdout, stderr = convert_dvi_to_image(command, name) + stdout, _stderr = convert_dvi_to_image(command, name) depth = None - if builder.config.imgmath_use_preview: + if config.imgmath_use_preview: for line in stdout.splitlines(): matched = depth_re.match(line) if matched: @@ -214,17 +200,17 @@ def convert_dvi_to_png(dvipath: Path, builder: Builder, out_path: Path) -> int | return depth -def convert_dvi_to_svg(dvipath: Path, builder: Builder, out_path: Path) -> int | None: +def convert_dvi_to_svg(dvipath: Path, out_path: Path, *, config: Config) -> int | None: """Convert DVI file to SVG image.""" name = 'dvisvgm' - command = [builder.config.imgmath_dvisvgm, '-o', out_path] - command.extend(builder.config.imgmath_dvisvgm_args) + command = [config.imgmath_dvisvgm, '-o', out_path] + command.extend(config.imgmath_dvisvgm_args) command.append(dvipath) - stdout, stderr = convert_dvi_to_image(command, name) + _stdout, stderr = convert_dvi_to_image(command, name) depth = None - if builder.config.imgmath_use_preview: + if config.imgmath_use_preview: for line in stderr.splitlines(): # not stdout ! matched = depthsvg_re.match(line) if matched: @@ -236,8 +222,7 @@ def convert_dvi_to_svg(dvipath: Path, builder: Builder, out_path: Path) -> int | def render_math( - self: HTML5Translator, - math: str, + self: HTML5Translator, math: str, *, config: Config ) -> tuple[_StrPath | None, int | None]: """Render the LaTeX math expression *math* using latex and dvipng or dvisvgm. @@ -252,14 +237,12 @@ def render_math( docs successfully). If the programs are there, however, they may not fail since that indicates a problem in the math source. """ - image_format = self.builder.config.imgmath_image_format.lower() + image_format = config.imgmath_image_format.lower() if image_format not in SUPPORT_FORMAT: unsupported_format_msg = 'imgmath_image_format must be either "png" or "svg"' raise MathExtError(unsupported_format_msg) - latex = generate_latex_macro( - image_format, math, self.builder.config, self.builder.confdir - ) + latex = generate_latex_macro(image_format, math, config, self.builder.confdir) filename = ( f'{sha1(latex.encode(), usedforsecurity=False).hexdigest()}.{image_format}' @@ -281,7 +264,7 @@ def render_math( # .tex -> .dvi try: - dvipath = compile_math(latex, self.builder) + dvipath = compile_math(latex, config=config) except InvokeError: self.builder._imgmath_warned_latex = True # type: ignore[attr-defined] return None, None @@ -289,9 +272,9 @@ def render_math( # .dvi -> .png/.svg try: if image_format == 'png': - depth = convert_dvi_to_png(dvipath, self.builder, generated_path) + depth = convert_dvi_to_png(dvipath, generated_path, config=config) elif image_format == 'svg': - depth = convert_dvi_to_svg(dvipath, self.builder, generated_path) + depth = convert_dvi_to_svg(dvipath, generated_path, config=config) except InvokeError: self.builder._imgmath_warned_image_translator = True # type: ignore[attr-defined] return None, None @@ -315,26 +298,25 @@ def clean_up_files(app: Sphinx, exc: Exception) -> None: if exc: return - if hasattr(app.builder, '_imgmath_tempdir'): - with contextlib.suppress(Exception): - shutil.rmtree(app.builder._imgmath_tempdir) - - if app.builder.config.imgmath_embed: + if app.config.imgmath_embed: # in embed mode, the images are still generated in the math output dir # to be shared across workers, but are not useful to the final document with contextlib.suppress(Exception): shutil.rmtree(app.builder.outdir / app.builder.imagedir / 'math') -def get_tooltip(self: HTML5Translator, node: Element) -> str: - if self.builder.config.imgmath_add_tooltips: +def get_tooltip(self: HTML5Translator, node: Element, *, config: Config) -> str: + if config.imgmath_add_tooltips: return f' alt="{self.encode(node.astext()).strip()}"' return '' def html_visit_math(self: HTML5Translator, node: nodes.math) -> None: + config = self.builder.config try: - rendered_path, depth = render_math(self, '$' + node.astext() + '$') + rendered_path, depth = render_math( + self, '$' + node.astext() + '$', config=config + ) except MathExtError as exc: msg = str(exc) sm = nodes.system_message( @@ -350,27 +332,27 @@ def html_visit_math(self: HTML5Translator, node: nodes.math) -> None: f'{self.encode(node.astext()).strip()}' ) else: - if self.builder.config.imgmath_embed: - image_format = self.builder.config.imgmath_image_format.lower() + if config.imgmath_embed: + image_format = config.imgmath_image_format.lower() img_src = render_maths_to_base64(image_format, rendered_path) else: bname = os.path.basename(rendered_path) relative_path = Path(self.builder.imgpath, 'math', bname) img_src = relative_path.as_posix() align = f' style="vertical-align: {-depth:d}px"' if depth is not None else '' - self.body.append( - f'' - ) + tooltip = get_tooltip(self, node, config=config) + self.body.append(f'') raise nodes.SkipNode def html_visit_displaymath(self: HTML5Translator, node: nodes.math_block) -> None: + config = self.builder.config if node.get('no-wrap', node.get('nowrap', False)): latex = node.astext() else: latex = wrap_displaymath(node.astext(), None, False) try: - rendered_path, depth = render_math(self, latex) + rendered_path, _depth = render_math(self, latex, config=config) except MathExtError as exc: msg = str(exc) sm = nodes.system_message( @@ -393,14 +375,15 @@ def html_visit_displaymath(self: HTML5Translator, node: nodes.math_block) -> Non f'{self.encode(node.astext()).strip()}

        \n' ) else: - if self.builder.config.imgmath_embed: - image_format = self.builder.config.imgmath_image_format.lower() + if config.imgmath_embed: + image_format = config.imgmath_image_format.lower() img_src = render_maths_to_base64(image_format, rendered_path) else: bname = os.path.basename(rendered_path) relative_path = Path(self.builder.imgpath, 'math', bname) img_src = relative_path.as_posix() - self.body.append(f'

        \n') + tooltip = get_tooltip(self, node, config=config) + self.body.append(f'

        \n') raise nodes.SkipNode diff --git a/sphinx/ext/inheritance_diagram.py b/sphinx/ext/inheritance_diagram.py index ce05626abe5..f44bbb860ab 100644 --- a/sphinx/ext/inheritance_diagram.py +++ b/sphinx/ext/inheritance_diagram.py @@ -429,6 +429,7 @@ def run(self) -> list[Node]: include_subclasses='include-subclasses' in self.options, ) except InheritanceException as err: + assert node.document is not None return [node.document.reporter.warning(err, line=self.lineno)] # Create xref nodes for each target of the graph's image map and @@ -436,7 +437,7 @@ def run(self) -> list[Node]: # references to real URLs later. These nodes will eventually be # removed from the doctree after we're done with them. for name in graph.get_all_class_names(): - refnodes, x = class_role( # type: ignore[misc] + refnodes, _x = class_role( # type: ignore[misc] 'class', f':class:`{name}`', name, 0, self.state.inliner ) node.extend(refnodes) diff --git a/sphinx/ext/intersphinx/_cli.py b/sphinx/ext/intersphinx/_cli.py index 720f080ebde..bf3a333eb95 100644 --- a/sphinx/ext/intersphinx/_cli.py +++ b/sphinx/ext/intersphinx/_cli.py @@ -5,7 +5,11 @@ import sys from pathlib import Path -from sphinx.ext.intersphinx._load import _fetch_inventory, _InvConfig +from sphinx.ext.intersphinx._load import ( + _fetch_inventory_data, + _InvConfig, + _load_inventory, +) def inspect_main(argv: list[str], /) -> int: @@ -28,12 +32,14 @@ def inspect_main(argv: list[str], /) -> int: ) try: - inv = _fetch_inventory( + raw_data, _ = _fetch_inventory_data( target_uri='', inv_location=filename, config=config, srcdir=Path(), + cache_path=None, ) + inv = _load_inventory(raw_data, target_uri='') for key in sorted(inv.data): print(key) inv_entries = sorted(inv.data[key].items()) diff --git a/sphinx/ext/intersphinx/_load.py b/sphinx/ext/intersphinx/_load.py index 6a07dbbc3f0..ab6a373fea0 100644 --- a/sphinx/ext/intersphinx/_load.py +++ b/sphinx/ext/intersphinx/_load.py @@ -19,6 +19,7 @@ from sphinx.util.inventory import InventoryFile if TYPE_CHECKING: + from collections.abc import Sequence from pathlib import Path from sphinx.application import Sphinx @@ -65,7 +66,7 @@ def validate_intersphinx_mapping(app: Sphinx, config: Config) -> None: continue # ensure values are properly formatted - if not isinstance(value, (tuple | list)): + if not isinstance(value, (tuple, list)): errors += 1 msg = __( 'Invalid value `%r` in intersphinx_mapping[%r]. ' @@ -107,7 +108,7 @@ def validate_intersphinx_mapping(app: Sphinx, config: Config) -> None: continue seen[uri] = name - if not isinstance(inv, tuple | list): + if not isinstance(inv, (tuple, list)): inv = (inv,) # ensure inventory locations are None or non-empty @@ -181,6 +182,9 @@ def load_mappings(app: Sphinx) -> None: now=now, config=inv_config, srcdir=app.srcdir, + # the location of this cache directory must not be relied upon + # externally, it may change without notice or warning. + cache_dir=app.doctreedir / '__intersphinx_cache__', ) for project in projects ] @@ -223,6 +227,17 @@ def from_config(cls, config: Config) -> _InvConfig: ) +def _display_failures(failures: Sequence[tuple[str, ...]]) -> str: + """Format a list of failure tuples into a readable multi-line string.""" + formatted = [] + for failure_args in failures: + try: + formatted.append(failure_args[0] % failure_args[1:]) + except TypeError: + formatted.append(' - '.join(failure_args)) + return '\n'.join(formatted) + + def _fetch_inventory_group( *, project: _IntersphinxProject, @@ -230,6 +245,7 @@ def _fetch_inventory_group( now: int, config: _InvConfig, srcdir: Path, + cache_dir: Path | None, ) -> bool: if config.intersphinx_cache_limit >= 0: # Positive value: cache is expired if its timestamp is below @@ -250,6 +266,26 @@ def _fetch_inventory_group( else: inv_location = location + if cache_dir is not None: + cache_path = cache_dir / f'{project.name}_{INVENTORY_FILENAME}' + else: + cache_path = None + + if ( + cache_path is not None + and '://' in inv_location + and project.target_uri not in cache + and cache_path.is_file() + # the saved 'objects.inv' is not older than the cache expiry time + and cache_path.stat().st_mtime >= cache_time + ): + raw_data = cache_path.read_bytes() + inv = _load_inventory(raw_data, target_uri=project.target_uri) + cache_path_mtime = int(cache_path.stat().st_mtime) + cache[project.target_uri] = project.name, cache_path_mtime, inv.data + updated = True + break + # decide whether the inventory must be read: always read local # files; remote ones only if the cache time is expired if ( @@ -264,17 +300,18 @@ def _fetch_inventory_group( ) try: - inv = _fetch_inventory( + raw_data, target_uri = _fetch_inventory_data( target_uri=project.target_uri, inv_location=inv_location, config=config, srcdir=srcdir, + cache_path=cache_path, ) + inv = _load_inventory(raw_data, target_uri=target_uri) except Exception as err: failures.append(err.args) continue - - if inv: + else: cache[project.target_uri] = project.name, now, inv.data updated = True break @@ -291,29 +328,34 @@ def _fetch_inventory_group( for fail in failures: LOGGER.info(*fail) else: - issues = '\n'.join(f[0] % f[1:] for f in failures) LOGGER.warning( - '%s\n%s', - __('failed to reach any of the inventories with the following issues:'), - issues, + __('failed to reach any of the inventories with the following issues:\n%s'), + _display_failures(failures), ) return updated def fetch_inventory(app: Sphinx, uri: InventoryURI, inv: str) -> Inventory: """Fetch, parse and return an intersphinx inventory file.""" - return _fetch_inventory( + raw_data, uri = _fetch_inventory_data( target_uri=uri, inv_location=inv, config=_InvConfig.from_config(app.config), srcdir=app.srcdir, - ).data + cache_path=None, + ) + return _load_inventory(raw_data, target_uri=uri).data -def _fetch_inventory( - *, target_uri: InventoryURI, inv_location: str, config: _InvConfig, srcdir: Path -) -> _Inventory: - """Fetch, parse and return an intersphinx inventory file.""" +def _fetch_inventory_data( + *, + target_uri: InventoryURI, + inv_location: str, + config: _InvConfig, + srcdir: Path, + cache_path: Path | None, +) -> tuple[bytes, str]: + """Fetch inventory data from a local or remote source.""" # both *target_uri* (base URI of the links to generate) # and *inv_location* (actual location of the inventory file) # can be local or remote URIs @@ -324,9 +366,17 @@ def _fetch_inventory( raw_data, target_uri = _fetch_inventory_url( target_uri=target_uri, inv_location=inv_location, config=config ) + if cache_path is not None: + cache_path.parent.mkdir(parents=True, exist_ok=True) + cache_path.write_bytes(raw_data) else: raw_data = _fetch_inventory_file(inv_location=inv_location, srcdir=srcdir) + return raw_data, target_uri + +def _load_inventory(raw_data: bytes, /, *, target_uri: InventoryURI) -> _Inventory: + """Parse and return an intersphinx inventory file.""" + # *target_uri* (base URI of the links to generate) can be a local or remote URI try: inv = InventoryFile.loads(raw_data, uri=target_uri) except ValueError as exc: diff --git a/sphinx/ext/intersphinx/_resolve.py b/sphinx/ext/intersphinx/_resolve.py index 102c5d3ab07..aa7a365df78 100644 --- a/sphinx/ext/intersphinx/_resolve.py +++ b/sphinx/ext/intersphinx/_resolve.py @@ -9,7 +9,6 @@ from docutils import nodes from sphinx.addnodes import pending_xref -from sphinx.deprecation import _deprecation_warning from sphinx.errors import ExtensionError from sphinx.ext.intersphinx._shared import LOGGER, InventoryAdapter from sphinx.locale import _, __ @@ -46,7 +45,12 @@ def _create_element_from_result( # get correct path in case of subdirectories uri = (_relative_path(Path(), Path(node['refdoc']).parent) / uri).as_posix() if inv_item.project_version: - reftitle = _('(in %s v%s)') % (inv_item.project_name, inv_item.project_version) + if not inv_item.project_version[0].isdigit(): + # Do not append 'v' to non-numeric version + version = inv_item.project_version + else: + version = f'v{inv_item.project_version}' + reftitle = _('(in %s %s)') % (inv_item.project_name, version) else: reftitle = _('(in %s)') % (inv_item.project_name,) @@ -493,7 +497,7 @@ def get_inventory_and_name_suffix(self, name: str) -> tuple[str | None, str]: assert name.startswith('external'), name suffix = name[9:] if name[8] == '+': - inv_name, suffix = suffix.split(':', 1) + inv_name, _, suffix = suffix.partition(':') return inv_name, suffix elif name[8] == ':': return None, suffix @@ -522,74 +526,12 @@ def _emit_warning(self, msg: str, /, *args: Any) -> None: *args, type='intersphinx', subtype='external', - location=(self.env.docname, self.lineno), + location=(self.env.current_document.docname, self.lineno), ) def _concat_strings(self, strings: Iterable[str]) -> str: return ', '.join(f'{s!r}' for s in sorted(strings)) - # deprecated methods - - def get_role_name(self, name: str) -> tuple[str, str] | None: - _deprecation_warning( - __name__, f'{self.__class__.__name__}.get_role_name', '', remove=(9, 0) - ) - names = name.split(':') - if len(names) == 1: - # role - if (domain := self.env.current_document.default_domain) is not None: - domain_name = domain.name - else: - domain_name = None - role = names[0] - elif len(names) == 2: - # domain:role: - domain_name, role = names - else: - return None - - if domain_name and self.is_existent_role(domain_name, role): - return domain_name, role - elif self.is_existent_role('std', role): - return 'std', role - else: - return None - - def is_existent_role(self, domain_name: str, role_name: str) -> bool: - _deprecation_warning( - __name__, f'{self.__class__.__name__}.is_existent_role', '', remove=(9, 0) - ) - try: - domain = self.env.domains[domain_name] - except KeyError: - return False - else: - return role_name in domain.roles - - def invoke_role( - self, role: tuple[str, str] - ) -> tuple[list[Node], list[system_message]]: - """Invoke the role described by a ``(domain, role name)`` pair.""" - _deprecation_warning( - __name__, f'{self.__class__.__name__}.invoke_role', '', remove=(9, 0) - ) - domain = self.env.get_domain(role[0]) - if domain: - role_func = domain.role(role[1]) - assert role_func is not None - - return role_func( - ':'.join(role), - self.rawtext, - self.text, - self.lineno, - self.inliner, - self.options, - self.content, - ) - else: - return [], [] - class IntersphinxRoleResolver(ReferencesResolver): """pending_xref node resolver for intersphinx role. diff --git a/sphinx/ext/intersphinx/_shared.py b/sphinx/ext/intersphinx/_shared.py index 87612b50151..cbedbf1b380 100644 --- a/sphinx/ext/intersphinx/_shared.py +++ b/sphinx/ext/intersphinx/_shared.py @@ -8,7 +8,7 @@ if TYPE_CHECKING: from collections.abc import Sequence - from typing import Any, Final, NoReturn, TypeAlias + from typing import Any, Final, NoReturn from sphinx.environment import BuildEnvironment from sphinx.util.typing import Inventory @@ -30,7 +30,7 @@ InventoryLocation = str | None #: Inventory cache entry. The integer field is the cache expiration time. - InventoryCacheEntry: TypeAlias = tuple[InventoryName, int, Inventory] + type InventoryCacheEntry = tuple[InventoryName, int, Inventory] #: The type of :confval:`intersphinx_mapping` *after* normalisation. IntersphinxMapping = dict[ diff --git a/sphinx/ext/mathjax.py b/sphinx/ext/mathjax.py index 62220cc697f..35766ddcac3 100644 --- a/sphinx/ext/mathjax.py +++ b/sphinx/ext/mathjax.py @@ -28,7 +28,7 @@ # more information for mathjax secure url is here: # https://docs.mathjax.org/en/latest/web/start.html#using-mathjax-from-a-content-delivery-network-cdn -MATHJAX_URL = 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js' +MATHJAX_URL = 'https://cdn.jsdelivr.net/npm/mathjax@4/tex-mml-chtml.js' logger = sphinx.util.logging.getLogger(__name__) @@ -95,30 +95,47 @@ def install_mathjax( builder = cast('StandaloneHTMLBuilder', app.builder) page_has_equations = context.get('has_maths_elements', False) + + # Enable mathjax only if equations exists if app.registry.html_assets_policy == 'always' or page_has_equations: - # Enable mathjax only if equations exists if app.config.mathjax2_config: if app.config.mathjax_path == MATHJAX_URL: logger.warning( 'mathjax_config/mathjax2_config does not work ' - 'for the current MathJax version, use mathjax3_config instead' + 'for the current MathJax version, use mathjax4_config instead' ) - body = 'MathJax.Hub.Config(%s)' % json.dumps(app.config.mathjax2_config) + body = f'MathJax.Hub.Config({json.dumps(app.config.mathjax2_config)})' builder.add_js_file('', type='text/x-mathjax-config', body=body) + if app.config.mathjax3_config: - body = 'window.MathJax = %s' % json.dumps(app.config.mathjax3_config) + body = f'window.MathJax = {json.dumps(app.config.mathjax3_config)}' + builder.add_js_file('', body=body) + + if app.config.mathjax4_config: + body = f'window.MathJax = {json.dumps(app.config.mathjax4_config)}' + builder.add_js_file('', body=body) + + if app.config.mathjax_config_path: + config_path = app.confdir / app.config.mathjax_config_path + if not config_path.exists(): + msg = f'mathjax_config_path file not found: {config_path}' + raise ExtensionError(msg) + if not config_path.is_file() or config_path.suffix != '.js': + msg = f'mathjax_config_path: expected a .js file, but got {config_path}' + raise ExtensionError(msg) + body = config_path.read_text(encoding='utf-8') builder.add_js_file('', body=body) options = {} if app.config.mathjax_options: options.update(app.config.mathjax_options) if 'async' not in options and 'defer' not in options: - if app.config.mathjax3_config: - # Load MathJax v3 via "defer" method - options['defer'] = 'defer' - else: - # Load other MathJax via "async" method + if app.config.mathjax2_config or app.config.mathjax_config: + # Load old MathJax versions via the 'async' method options['async'] = 'async' + else: + # Load MathJax v3+ via the 'defer' method + options['defer'] = 'defer' builder.add_js_file(app.config.mathjax_path, **options) @@ -149,6 +166,10 @@ def setup(app: Sphinx) -> ExtensionMetadata: app.add_config_value( 'mathjax3_config', None, 'html', types=frozenset({dict, NoneType}) ) + app.add_config_value( + 'mathjax4_config', None, 'html', types=frozenset({dict, NoneType}) + ) + app.add_config_value('mathjax_config_path', '', 'html', types=frozenset({str})) app.connect('html-page-context', install_mathjax) return { diff --git a/sphinx/ext/napoleon/__init__.py b/sphinx/ext/napoleon/__init__.py index 6d8f1b22e2d..9509a4f7d5d 100644 --- a/sphinx/ext/napoleon/__init__.py +++ b/sphinx/ext/napoleon/__init__.py @@ -15,6 +15,7 @@ from typing import Any from sphinx.config import _ConfigRebuild + from sphinx.ext.autodoc._property_types import _AutodocObjType from sphinx.util.typing import ExtensionMetadata @@ -362,7 +363,12 @@ def _patch_python_domain() -> None: def _process_docstring( - app: Sphinx, what: str, name: str, obj: Any, options: Any, lines: list[str] + app: Sphinx, + what: _AutodocObjType, + name: str, + obj: Any, + options: Any, + lines: list[str], ) -> None: """Process the docstring for a given python object. @@ -415,7 +421,7 @@ def _process_docstring( def _skip_member( - app: Sphinx, what: str, name: str, obj: Any, skip: bool, options: Any + app: Sphinx, what: _AutodocObjType, name: str, obj: Any, skip: bool, options: Any ) -> bool | None: """Determine if private and special class members are included in docs. diff --git a/sphinx/ext/napoleon/docstring.py b/sphinx/ext/napoleon/docstring.py index d1317e9d841..6c866f3db42 100644 --- a/sphinx/ext/napoleon/docstring.py +++ b/sphinx/ext/napoleon/docstring.py @@ -16,9 +16,11 @@ if TYPE_CHECKING: from collections.abc import Callable, Iterator + from typing import Literal from sphinx.application import Sphinx from sphinx.config import Config as SphinxConfig + from sphinx.ext.autodoc._property_types import _AutodocObjType logger = logging.getLogger(__name__) @@ -328,10 +330,10 @@ def __init__( docstring: str | list[str], config: SphinxConfig | None = None, app: Sphinx | None = None, - what: str = '', + what: _AutodocObjType | Literal['object'] = 'object', name: str = '', - obj: Any = None, - options: Any = None, + obj: Any | None = None, + options: Any | None = None, ) -> None: self._app = app if config: @@ -343,7 +345,7 @@ def __init__( self._config = Config() # type: ignore[assignment] - if not what: + if what == 'object': if inspect.isclass(obj): what = 'class' elif inspect.ismodule(obj): @@ -353,10 +355,16 @@ def __init__( else: what = 'object' - self._what = what + self._what: _AutodocObjType | Literal['object'] = what self._name = name self._obj = obj - self._opt = options + if options: + try: + self._no_index = options.no_index or options.noindex + except (AttributeError, TypeError): + self._no_index = False + else: + self._no_index = False if isinstance(docstring, str): lines = docstring.splitlines() else: @@ -476,7 +484,7 @@ def _consume_field( ) -> tuple[str, str, list[str]]: line = self._lines.next() - before, colon, after = self._partition_field_on_colon(line) + before, _colon, after = self._partition_field_on_colon(line) _name, _type, _desc = before, '', after if parse_type: @@ -535,7 +543,7 @@ def _consume_returns_section( if colon: if after: - _desc = [after] + lines[1:] + _desc = [after, *lines[1:]] else: _desc = lines[1:] @@ -684,7 +692,7 @@ def _format_field(self, _name: str, _type: str, _desc: list[str]) -> list[str]: if has_desc: _desc = self._fix_field_desc(_desc) if _desc[0]: - return [field + _desc[0]] + _desc[1:] + return [field + _desc[0], *_desc[1:]] else: return [field, *_desc] else: @@ -875,9 +883,8 @@ def _parse_attributes_section(self, section: str) -> list[str]: lines.append(f':vartype {_name}: {_type}') else: lines.append('.. attribute:: ' + _name) - if self._opt: - if 'no-index' in self._opt or 'noindex' in self._opt: - lines.append(' :no-index:') + if self._no_index: + lines.append(' :no-index:') lines.append('') fields = self._format_field('', '', _desc) @@ -943,9 +950,8 @@ def _parse_methods_section(self, section: str) -> list[str]: lines: list[str] = [] for _name, _type, _desc in self._consume_fields(parse_type=False): lines.append(f'.. method:: {_name}') - if self._opt: - if 'no-index' in self._opt or 'noindex' in self._opt: - lines.append(' :no-index:') + if self._no_index: + lines.append(' :no-index:') if _desc: lines.extend(['', *self._indent(_desc, 3)]) lines.append('') @@ -1206,10 +1212,10 @@ def __init__( docstring: str | list[str], config: SphinxConfig | None = None, app: Sphinx | None = None, - what: str = '', + what: _AutodocObjType | Literal['object'] = 'object', name: str = '', - obj: Any = None, - options: Any = None, + obj: Any | None = None, + options: Any | None = None, ) -> None: self._directive_sections = ['.. index::'] super().__init__(docstring, config, app, what, name, obj, options) @@ -1387,7 +1393,7 @@ def translate( if m and line[m.end() :].strip().startswith(':'): push_item(current_func, rest) current_func, line = line[: m.end()], line[m.end() :] - rest = [line.split(':', 1)[1].strip()] + rest = [line.partition(':')[-1].strip()] if not rest[0]: rest = [] elif not line.startswith(' '): diff --git a/sphinx/ext/todo.py b/sphinx/ext/todo.py index 53c4d57b4f1..4b2e32bc9c4 100644 --- a/sphinx/ext/todo.py +++ b/sphinx/ext/todo.py @@ -59,7 +59,7 @@ def run(self) -> list[Node]: return [todo] todo.insert(0, nodes.title(text=_('Todo'))) - todo['docname'] = self.env.docname + todo['docname'] = self.env.current_document.docname self.add_name(todo) self.set_source_info(todo) self.state.document.note_explicit_target(todo) diff --git a/sphinx/ext/viewcode.py b/sphinx/ext/viewcode.py index 4b1c62ad0d1..e3e302563c9 100644 --- a/sphinx/ext/viewcode.py +++ b/sphinx/ext/viewcode.py @@ -103,11 +103,11 @@ def _get_full_modname(modname: str, attribute: str) -> str | None: return None -def is_supported_builder(builder: Builder) -> bool: +def is_supported_builder(builder: type[Builder], viewcode_enable_epub: bool) -> bool: return ( builder.format == 'html' and builder.name != 'singlehtml' - and (not builder.name.startswith('epub') or builder.config.viewcode_enable_epub) + and (not builder.name.startswith('epub') or viewcode_enable_epub) ) @@ -166,7 +166,7 @@ def has_tag(modname: str, fullname: str, docname: str, refname: str) -> bool: if not modname: continue fullname = signode.get('fullname') - if not has_tag(modname, fullname, env.docname, refname): + if not has_tag(modname, fullname, env.current_document.docname, refname): continue if fullname in names: # only one link per name, please @@ -174,7 +174,7 @@ def has_tag(modname: str, fullname: str, docname: str, refname: str) -> bool: names.add(fullname) pagename = posixpath.join(OUTPUT_DIRNAME, modname.replace('.', '/')) signode += viewcode_anchor( - reftarget=pagename, refid=fullname, refdoc=env.docname + reftarget=pagename, refid=fullname, refdoc=env.current_document.docname ) @@ -187,7 +187,7 @@ def env_merge_info( if not hasattr(env, '_viewcode_modules'): env._viewcode_modules = {} # type: ignore[attr-defined] # now merge in the information from the subprocess - for modname, entry in other._viewcode_modules.items(): + for modname, entry in other._viewcode_modules.items(): # ty: ignore[unresolved-attribute] if modname not in env._viewcode_modules: # type: ignore[attr-defined] env._viewcode_modules[modname] = entry # type: ignore[attr-defined] else: @@ -205,7 +205,7 @@ def env_purge_doc(app: Sphinx, env: BuildEnvironment, docname: str) -> None: if entry is False: continue - code, tags, used, refname = entry + _code, _tags, used, _refname = entry for fullname in list(used): if used[fullname] == docname: used.pop(fullname) @@ -220,7 +220,9 @@ class ViewcodeAnchorTransform(SphinxPostTransform): default_priority = 100 def run(self, **kwargs: Any) -> None: - if is_supported_builder(self.app.builder): + if is_supported_builder( + self.env._builder_cls, self.config.viewcode_enable_epub + ): self.convert_viewcode_anchors() else: self.remove_viewcode_anchors() @@ -229,7 +231,7 @@ def convert_viewcode_anchors(self) -> None: for node in self.document.findall(viewcode_anchor): anchor = nodes.inline('', _('[source]'), classes=['viewcode-link']) refnode = make_refnode( - self.app.builder, + self.env._app.builder, node['refdoc'], node['reftarget'], node['refid'], @@ -250,7 +252,7 @@ def get_module_filename(app: Sphinx, modname: str) -> _StrPath | None: return None else: try: - filename, source = ModuleAnalyzer.get_module_source(modname) + filename, _source = ModuleAnalyzer.get_module_source(modname) return filename except Exception: return None @@ -281,7 +283,7 @@ def collect_pages(app: Sphinx) -> Iterator[tuple[str, dict[str, Any], str]]: env = app.env if not hasattr(env, '_viewcode_modules'): return - if not is_supported_builder(app.builder): + if not is_supported_builder(env._builder_cls, env.config.viewcode_enable_epub): return highlighter = app.builder.highlighter # type: ignore[attr-defined] urito = app.builder.get_relative_uri @@ -289,11 +291,11 @@ def collect_pages(app: Sphinx) -> Iterator[tuple[str, dict[str, Any], str]]: modnames = set(env._viewcode_modules) for modname, entry in status_iterator( - sorted(env._viewcode_modules.items()), + sorted(env._viewcode_modules.items()), # ty: ignore[unresolved-attribute] __('highlighting module code... '), 'blue', len(env._viewcode_modules), - app.verbosity, + app.config.verbosity, operator.itemgetter(0), ): if not entry: @@ -323,7 +325,7 @@ def collect_pages(app: Sphinx) -> Iterator[tuple[str, dict[str, Any], str]]: max_index = len(lines) - 1 link_text = _('[docs]') for name, docname in used.items(): - type, start, end = tags[name] + _type, start, end = tags[name] backlink = urito(pagename, docname) + '#' + refname + '.' + name lines[start] = ( f'
        \n' diff --git a/sphinx/io.py b/sphinx/io.py index 009cd38bf68..446ec81b8ee 100644 --- a/sphinx/io.py +++ b/sphinx/io.py @@ -2,62 +2,51 @@ from __future__ import annotations +import warnings from typing import TYPE_CHECKING -from docutils.core import Publisher -from docutils.io import FileInput, NullOutput +from docutils.io import FileInput from docutils.readers import standalone from docutils.transforms.references import DanglingReferences from docutils.writers import UnfilteredWriter -from sphinx.transforms import AutoIndexUpgrader, DoctreeReadEvent, SphinxTransformer -from sphinx.transforms.i18n import ( - Locale, - PreserveTranslatableMessages, - RemoveTranslatableInline, -) -from sphinx.transforms.references import SphinxDomains +from sphinx.deprecation import RemovedInSphinx10Warning +from sphinx.transforms import SphinxTransformer from sphinx.util import logging from sphinx.util.docutils import LoggingReporter -from sphinx.versioning import UIDTransform if TYPE_CHECKING: from typing import Any from docutils import nodes - from docutils.frontend import Values from docutils.io import Input from docutils.parsers import Parser from docutils.transforms import Transform - from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment + from sphinx.util.docutils import _DocutilsSettings logger = logging.getLogger(__name__) +warnings.warn('sphinx.io is deprecated', RemovedInSphinx10Warning, stacklevel=2) -class SphinxBaseReader(standalone.Reader): # type: ignore[misc] + +class SphinxBaseReader(standalone.Reader['Any']): """A base class of readers for Sphinx. This replaces reporter by Sphinx's on generating document. """ - transforms: list[type[Transform]] = [] - def __init__(self, *args: Any, **kwargs: Any) -> None: - from sphinx.application import Sphinx - - if len(args) > 0 and isinstance(args[0], Sphinx): - self._app = args[0] - self._env = self._app.env - args = args[1:] - super().__init__(*args, **kwargs) + warnings.warn( + 'sphinx.io.SphinxBaseReader is deprecated', + RemovedInSphinx10Warning, + stacklevel=2, + ) - def setup(self, app: Sphinx) -> None: - self._app = app # hold application object only for compatibility - self._env = app.env + transforms: list[type[Transform]] = [] def get_transforms(self) -> list[type[Transform]]: transforms = super().get_transforms() + self.transforms @@ -90,58 +79,54 @@ def new_document(self) -> nodes.document: class SphinxStandaloneReader(SphinxBaseReader): """A basic document reader for Sphinx.""" - def setup(self, app: Sphinx) -> None: - self.transforms = self.transforms + app.registry.get_transforms() - super().setup(app) - - def read(self, source: Input, parser: Parser, settings: Values) -> nodes.document: # type: ignore[type-arg] + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + warnings.warn( + 'sphinx.io.SphinxStandaloneReader is deprecated', + RemovedInSphinx10Warning, + stacklevel=2, + ) + + def _setup_transforms(self, transforms: list[type[Transform]], /) -> None: + self.transforms = self.transforms + transforms + + def read( + self, + source: Input, # type: ignore[type-arg] + parser: Parser, + settings: _DocutilsSettings, + ) -> nodes.document: self.source = source - if not self.parser: # type: ignore[has-type] + if not self.parser: self.parser = parser self.settings = settings self.input = self.read_source(settings.env) self.parse() + assert self.document is not None return self.document def read_source(self, env: BuildEnvironment) -> str: """Read content from source and do post-process.""" + assert self.source is not None content = self.source.read() # emit "source-read" event arg = [content] - env.events.emit('source-read', env.docname, arg) + env.events.emit('source-read', env.current_document.docname, arg) return arg[0] -class SphinxI18nReader(SphinxBaseReader): - """A document reader for i18n. - - This returns the source line number of original text as current source line number - to let users know where the error happened. - Because the translated texts are partial and they don't have correct line numbers. - """ - - def setup(self, app: Sphinx) -> None: - super().setup(app) - - self.transforms = self.transforms + app.registry.get_transforms() - unused = [ - PreserveTranslatableMessages, - Locale, - RemoveTranslatableInline, - AutoIndexUpgrader, - SphinxDomains, - DoctreeReadEvent, - UIDTransform, - ] - for transform in unused: - if transform in self.transforms: - self.transforms.remove(transform) - - class SphinxDummyWriter(UnfilteredWriter): # type: ignore[type-arg] """Dummy writer module used for generating doctree.""" + def __init__(self) -> None: + super().__init__() + warnings.warn( + 'sphinx.io.SphinxDummyWriter is deprecated', + RemovedInSphinx10Warning, + stacklevel=2, + ) + supported = ('html',) # needed to keep "meta" nodes def translate(self) -> None: @@ -150,6 +135,11 @@ def translate(self) -> None: def SphinxDummySourceClass(source: Any, *args: Any, **kwargs: Any) -> Any: """Bypass source object as is to cheat Publisher.""" + warnings.warn( + 'sphinx.io.SphinxDummySourceClass is deprecated', + RemovedInSphinx10Warning, + stacklevel=2, + ) return source @@ -159,32 +149,8 @@ class SphinxFileInput(FileInput): def __init__(self, *args: Any, **kwargs: Any) -> None: kwargs['error_handler'] = 'sphinx' super().__init__(*args, **kwargs) - - -def create_publisher(app: Sphinx, filetype: str) -> Publisher: - reader = SphinxStandaloneReader() - reader.setup(app) - - parser = app.registry.create_source_parser(app, filetype) - if parser.__class__.__name__ == 'CommonMarkParser' and parser.settings_spec == (): - # a workaround for recommonmark - # If recommonmark.AutoStrictify is enabled, the parser invokes reST parser - # internally. But recommonmark-0.4.0 does not provide settings_spec for reST - # parser. As a workaround, this copies settings_spec for RSTParser to the - # CommonMarkParser. - from docutils.parsers.rst import Parser as RSTParser - - parser.settings_spec = RSTParser.settings_spec # type: ignore[misc] - - pub = Publisher( - reader=reader, - parser=parser, - writer=SphinxDummyWriter(), - source_class=SphinxFileInput, - destination=NullOutput(), - ) - # Propagate exceptions by default when used programmatically: - defaults = {'traceback': True, **app.env.settings} - # Set default settings - pub.get_settings(**defaults) - return pub + warnings.warn( + 'sphinx.io.SphinxFileInput is deprecated', + RemovedInSphinx10Warning, + stacklevel=2, + ) diff --git a/sphinx/jinja2glue.py b/sphinx/jinja2glue.py index 2f33070fa50..fd44a84bcbb 100644 --- a/sphinx/jinja2glue.py +++ b/sphinx/jinja2glue.py @@ -3,7 +3,6 @@ from __future__ import annotations import os -import os.path from pathlib import Path from pprint import pformat from typing import TYPE_CHECKING diff --git a/sphinx/locale/ar/LC_MESSAGES/sphinx.mo b/sphinx/locale/ar/LC_MESSAGES/sphinx.mo index 2e7b5677b1a..db06bc3f2c7 100644 Binary files a/sphinx/locale/ar/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ar/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/ar/LC_MESSAGES/sphinx.po b/sphinx/locale/ar/LC_MESSAGES/sphinx.po index 656ca9fa623..caf8bcf0ecd 100644 --- a/sphinx/locale/ar/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/ar/LC_MESSAGES/sphinx.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Abdullah ahmed , 2020\n" "Language-Team: Arabic (http://app.transifex.com/sphinx-doc/sphinx-1/language/ar/)\n" @@ -20,6 +20,127 @@ msgstr "" "Language: ar\n" "Plural-Forms: nplurals=6; plural=n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -34,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "حدث غير معروف: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "لا يمكن العثور على المجلد المصدر (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "لا يمكن ان يكون المجلد المصدر والمجلد الهدف متطابقين" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "تشغيل Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "يحتاج هذا المشروع على الاقل الى الاصدار %s من Sphinx وبالتالي لا يمكن بناءه باستخدام الاصدار الحالي" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "تحميل الترجمات [ %s ]" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "تم" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "غير متوفرة للرسائل الافتراضية المدمجة" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "فشل: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "لم يتم اختيار نوع البناء، تم استخدام نوع البناء الافتراضي: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +310,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +323,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "مجلد الاعدادات لا يحتوي على ملف conf.py (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "مجلد الاعدادات لا يحتوي على ملف conf.py (%s)" + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,468 +538,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "قسم %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "جدول %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r لتم يتم العثور عليه، لهذا تم تجاهلة" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 +#: locale/__init__.py:229 +msgid "Attention" +msgstr "تنبيه" + +#: locale/__init__.py:230 +msgid "Caution" +msgstr "احتياط" + +#: locale/__init__.py:231 +msgid "Danger" +msgstr "خطر" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "خطأ" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "تلميح" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "مهم" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "ملاحظة" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "شاهد أيضا" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "نصيحة" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "تحذير" + +#: builders/texinfo.py:41 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: events.py:370 +#: builders/texinfo.py:85 #, python-format -msgid "Unknown event name: %s" -msgstr "حدث غير معروف: %s" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "" -#: events.py:416 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "processing %s" +msgstr "معالجة %s" + +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:167 +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "نسخ الصور..." + +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:187 +#: builders/texinfo.py:218 #, python-format -msgid "Builder name %s not registered or available through entry point" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:197 +#: builders/manpage.py:37 #, python-format -msgid "Builder name %s not registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 +#: builders/manpage.py:64 #, python-format -msgid "domain %s not yet registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:235 +#: builders/singlehtml.py:35 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "The HTML page is in %(outdir)s." +msgstr "صفحة الHTML موجودة في %(outdir)s" + +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "كتابة ملفات إضافية" + +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:266 +#: builders/gettext.py:243 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:313 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "The %r object_type is already registered" -msgstr "" +msgid "building [%s]: " +msgstr "بناء [%s]" -#: registry.py:344 +#: builders/gettext.py:265 #, python-format -msgid "The %r crossref_type is already registered" +msgid "targets for %d template files" msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "قراءة القوالب" + +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:363 +#: builders/linkcheck.py:87 #, python-format -msgid "source_parser for %r is already registered" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:372 +#: builders/linkcheck.py:159 #, python-format -msgid "Source parser for %s not registered" +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:390 +#: builders/linkcheck.py:561 #, python-format -msgid "Translator for %r already exists" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: registry.py:496 +#: builders/linkcheck.py:799 #, python-format -msgid "enumerable_node %r already registered" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: registry.py:512 +#: builders/epub3.py:83 #, python-format -msgid "math renderer %s is already registered" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: registry.py:529 -#, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: registry.py:565 -#, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: registry.py:577 -#, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: roles.py:229 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "invalid CVE number %s" +msgid "invalid css_file: %r, ignored" msgstr "" -#: roles.py:251 +#: builders/xml.py:29 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "The XML files are in %(outdir)s." +msgstr "ملفات الXML موجودة في %(outdir)s" + +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: roles.py:274 +#: builders/xml.py:103 #, python-format -msgid "invalid CWE number %s" +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: roles.py:294 +#: builders/_epub_base.py:223 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "duplicated ToC entry found: %s" msgstr "" -#: roles.py:317 +#: builders/_epub_base.py:436 #, python-format -msgid "invalid PEP number %s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: roles.py:355 +#: builders/_epub_base.py:467 #, python-format -msgid "invalid RFC number %s" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[المصدر]" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[المستندات]" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/viewcode.py:353 +#: builders/_epub_base.py:594 #, python-format -msgid "

        Source code for %s

        " +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." msgstr "" -#: ext/extlinks.py:82 +#: builders/_epub_base.py:802 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "writing %s file..." msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/text.py:27 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "The text files are in %(outdir)s." msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/__init__.py:229 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "بناء [mo]:" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " msgstr "" -#: ext/doctest.py:118 +#: builders/__init__.py:280 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "all of %d po files" msgstr "" -#: ext/doctest.py:124 +#: builders/__init__.py:302 #, python-format -msgid "'%s' is not a valid option." +msgid "targets for %d po files that are specified" msgstr "" -#: ext/doctest.py:139 +#: builders/__init__.py:314 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "targets for %d po files that are out of date" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "جميع ملفات المصدر" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/doctest.py:297 +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "التحقق من التوافق" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "تحديث البيئة:" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "تجهيز المستندات" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -740,9 +1176,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -777,6 +1214,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -864,947 +1329,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:47 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "مؤلف القسم:" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[المصدر]" -#: directives/other.py:205 -msgid "Module author: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "كاتب الكود:" - -#: directives/other.py:209 -msgid "Author: " -msgstr "المؤلف" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[المستندات]" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "" - -#: builders/changes.py:29 +#: ext/viewcode.py:359 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:56 -#, python-format -msgid "no changes in version %s." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:133 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "could not read %r for changelog creation" +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:37 +#: domains/javascript.py:183 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "%s() (built-in function)" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:188 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:232 -#, python-format -msgid "a suitable image for %s builder not found: %s" +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "بناء [mo]:" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:297 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are specified" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:309 -#, python-format -msgid "targets for %d po files that are out of date" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "جميع ملفات المصدر" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "كائن" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:361 +#: domains/javascript.py:458 #, python-format -msgid "%d source files given on command line" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:377 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d source files that are out of date" +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "building [%s]: " -msgstr "بناء [%s]" - -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:224 #, python-format -msgid "%d found" +msgid "%s (role)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "التحقق من التوافق" +#: domains/rst.py:236 +msgid "role" +msgstr "متغير بيئة العمل" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "تحديث البيئة:" - -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "تجهيز المستندات" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "ملفات الXML موجودة في %(outdir)s" +#: cmd/build.py:212 +msgid "console output options" +msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "معالجة %s" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "نسخ الصور..." - -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:223 +#: cmd/build.py:357 #, python-format -msgid "duplicated ToC entry found: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "قراءة القوالب" - -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "الرجاء ادخال بعض النصوص" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "صفحة الHTML موجودة في %(outdir)s" - -#: builders/singlehtml.py:171 -msgid "assembling single document" +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "كتابة ملفات إضافية" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "أدخل إما 'نعم' أو'لا'" + +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "أدخل امتداد الملف, مثلا '.rst' أو '.txt'" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:298 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "اسم المشروع" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "اسم المؤلف(ون)" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "نسخة المشروع" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "إصدار المشروع" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "لغة المشروع" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "امتداد ملف المصدر" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:350 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "إنشاء Makefile ؟ (نعم / لا)" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "إنشاء ملف أوامر للويندوز؟ (نعم/لا)" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "اسم المشروع" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "أسماء المؤلفين" + +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: util/nodes.py:706 +#: cmd/quickstart.py:671 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "enable %s extension" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: util/display.py:87 -msgid "failed" -msgstr "فشل" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "إنشاء Makefile" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "إنشاء Batchfile ؟" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "عرف متغير للقالب" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/rst.py:73 +#: cmd/quickstart.py:810 #, python-format -msgid "default role %s not found" +msgid "Invalid template variable: %s" msgstr "" -#: util/inventory.py:147 +#: directives/other.py:119 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/inventory.py:166 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/other.py:169 #, python-format -msgid "[image: %s]" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:203 +msgid "Section author: " +msgstr "مؤلف القسم:" + +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:207 +msgid "Code author: " +msgstr "كاتب الكود:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "المؤلف" + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "" + +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "" + +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1833,6 +2344,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1849,795 +2365,479 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "" - -#: domains/javascript.py:370 +#: writers/latex.py:1950 #, python-format -msgid "%s (module)" +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "كائن" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "متغير بيئة العمل" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "تنبيه" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "احتياط" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "خطر" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "خطأ" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "تلميح" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "مهم" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "ملاحظة" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "شاهد أيضا" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "نصيحة" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "تحذير" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "الرجاء ادخال بعض النصوص" - -#: cmd/quickstart.py:133 +#: util/i18n.py:113 #, python-format -msgid "Please enter one of %s." +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "أدخل إما 'نعم' أو'لا'" - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "أدخل امتداد الملف, مثلا '.rst' أو '.txt'" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" -#: cmd/quickstart.py:229 +#: util/i18n.py:244 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:234 +#: util/i18n.py:253 +#, python-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:241 +#: util/osutil.py:131 #, python-format -msgid "Selected root path: %s" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "" +#: util/display.py:87 +msgid "failed" +msgstr "فشل" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:273 +#: util/fileutil.py:76 +#, python-format msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:286 +#: util/docfields.py:103 +#, python-format msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:297 +#: util/nodes.py:462 +#, python-format msgid "" -"The project name will occur in several places in the built documentation." +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "اسم المشروع" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "اسم المؤلف(ون)" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "نسخة المشروع" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "إصدار المشروع" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "لغة المشروع" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "" - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "امتداد ملف المصدر" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "" - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "" - -#: cmd/quickstart.py:367 +#: util/nodes.py:523 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "استمرار في الصفحة التالية" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "إنشاء Makefile ؟ (نعم / لا)" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "أرقام" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "إنشاء ملف أوامر للويندوز؟ (نعم/لا)" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "صفحة" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: transforms/post_transforms/images.py:79 #, python-format -msgid "File %s already exists, skipping." -msgstr "" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:519 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "" - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:530 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:572 +#: transforms/post_transforms/__init__.py:88 msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "اسم المشروع" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "أسماء المؤلفين" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:670 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "إنشاء Makefile" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "إنشاء Batchfile ؟" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "عرف متغير للقالب" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "Invalid template variable: %s" +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:109 +#: _cli/util/errors.py:207 msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:131 +#: _cli/util/errors.py:240 msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:157 +#: _cli/util/errors.py:246 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "البحث ضمن %(docstitle)s" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "بحث" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "الحقوق" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "الموضوع السابق" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "القسم السابق" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "الموضوع التالي" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "الفصل التالي" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +msgid "Index – %(key)s" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "هذه الصفحة" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "قائمة المحتويات" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "إظهار المصدر" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "بحث" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "البحث السريع" #: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 #: themes/basic/searchfield.html:12 msgid "Go" msgstr "" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "إظهار المصدر" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "المحتوى" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "البحث %(docstitle)s" - #: themes/basic/defindex.html:4 msgid "Overview" msgstr "" @@ -2662,110 +2862,51 @@ msgstr "" msgid "Complete Table of Contents" msgstr "" -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "" - -#: domains/std/__init__.py:773 domains/std/__init__.py:786 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "صفحة البحث" - -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "" - -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "" - -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "الفهرس العام" - -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "هذه الصفحة" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "البحث السريع" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "" - -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "" - -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "الموضوع السابق" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "القسم السابق" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "الموضوع التالي" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "الفصل التالي" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "صفحة البحث" -#: themes/basic/layout.html:18 -msgid "Navigation" +#: themes/basic/defindex.html:19 +msgid "search this documentation" msgstr "" -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "البحث ضمن %(docstitle)s" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "" -#: themes/basic/layout.html:124 -msgid "About these documents" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" msgstr "" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "الحقوق" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "الفهرس العام" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" msgstr "" -#: themes/basic/layout.html:201 +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "قائمة المحتويات" + +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Last updated on %(last_updated)s." +msgid "Search %(docstitle)s" +msgstr "البحث %(docstitle)s" + +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" msgstr "" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +#: themes/basic/genindex-split.html:17 +msgid "can be huge" msgstr "" #: themes/basic/search.html:20 @@ -2784,21 +2925,21 @@ msgstr "" msgid "search" msgstr "بحث" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "المحتوى" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "نتائج البحث" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2810,21 +2951,20 @@ msgstr[3] "" msgstr[4] "" msgstr[5] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2833,6 +2973,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2854,119 +2999,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "متغيرات" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "متغيرات" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2978,92 +3130,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "نوع" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "متغير" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3119,605 +3264,392 @@ msgstr "" msgid "Module Index" msgstr "" -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" - -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:857 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1124 #, python-format -msgid "%r reference target not found: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1138 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:1153 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:1157 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "صفحة الHTML موجودة في %(outdir)s" - -#: builders/html/__init__.py:348 +#: domains/std/__init__.py:1453 #, python-format -msgid "Failed to read build info file: %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:383 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "الفهرس" - -#: builders/html/__init__.py:560 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "Logo of %s" +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "التالي" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "السابق" - -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "إنشاء الفهرس" - -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "كتابة صفحات إضافية " - -#: builders/html/__init__.py:794 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "نسخ الملفات القابلة للتحميل للنسخ..." +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "مثال" -#: builders/html/__init__.py:818 -#, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "غير قادر على نسخ الملفات القابلة للتحميل %r : %s" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "أمثلة" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:882 -#, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "ملاحظات" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:934 -#, python-format -msgid "cannot copy static file %r" -msgstr "غير قادر على نسخ الملف الثابت %r" - -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "نسخ ملفات إضافية" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: builders/html/__init__.py:949 -#, python-format -msgid "cannot copy extra file %r" -msgstr "غير قادر على نسخ المف الإضافي %r" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "مراجع" -#: builders/html/__init__.py:955 -#, python-format -msgid "Failed to write build info file: %r" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1224 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "" - -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1265 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "dumping search index in %s" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1308 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "invalid js_file: %r, ignored" -msgstr "" - -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1346 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "Unknown math_renderer %r is given." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1360 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/autodoc/_names.py:89 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_names.py:93 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "ملف الشعار %r غير موجود" - -#: builders/html/__init__.py:1407 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "favicon file %r does not exist" -msgstr "ملف الايقونة %r غير موجود" +msgid "Failed to remove %s: %s" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "Would create file %s." msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:28 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:91 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "" - -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "استمرار في الصفحة التالية" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "أرقام" - -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "صفحة" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "مثال" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "أمثلة" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" +msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "ملاحظات" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "%s ليس مجلد." -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "مراجع" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3725,7 +3657,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3740,481 +3672,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "%s is not a directory." -msgstr "%s ليس مجلد." - -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_extension.py:247 -#, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "صفحة الHTML موجودة في %(outdir)s" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" +msgid "Failed to read build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" + +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "الفهرس" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:578 +msgid "next" +msgstr "التالي" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "السابق" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "إنشاء الفهرس" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "كتابة صفحات إضافية " + +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "نسخ الملفات القابلة للتحميل للنسخ..." + +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" +msgstr "غير قادر على نسخ الملفات القابلة للتحميل %r : %s" + +#: builders/html/__init__.py:853 +#, python-format +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:871 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "cannot copy static file %r" +msgstr "غير قادر على نسخ الملف الثابت %r" + +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "نسخ ملفات إضافية" + +#: builders/html/__init__.py:938 +#, python-format +msgid "cannot copy extra file %r" +msgstr "غير قادر على نسخ المف الإضافي %r" + +#: builders/html/__init__.py:944 +#, python-format +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "" + +#: builders/html/__init__.py:1038 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "" + +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1266 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "" + +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1370 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1385 +#, python-format +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1390 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 +#, python-format +msgid "logo file %r does not exist" +msgstr "ملف الشعار %r غير موجود" + +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "ملف الايقونة %r غير موجود" + +#: builders/html/__init__.py:1425 +#, python-format msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1438 +msgid "" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%s %s documentation" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/bg/LC_MESSAGES/sphinx.mo b/sphinx/locale/bg/LC_MESSAGES/sphinx.mo index 0ce9ef8dfcc..fc9f176c432 100644 Binary files a/sphinx/locale/bg/LC_MESSAGES/sphinx.mo and b/sphinx/locale/bg/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/bg/LC_MESSAGES/sphinx.po b/sphinx/locale/bg/LC_MESSAGES/sphinx.po index 083d7a9bb34..de995394dda 100644 --- a/sphinx/locale/bg/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/bg/LC_MESSAGES/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Nikolay Stoykov , 2024\n" "Language-Team: Bulgarian (http://app.transifex.com/sphinx-doc/sphinx-1/language/bg/)\n" @@ -19,6 +19,127 @@ msgstr "" "Language: bg\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -33,127 +154,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Не може да се намери изходна директория (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Изходната директория (%s) не е директория" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Изходната директория и целевата директория не могат да бъдат идентични" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "създаване на изходна директория" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +322,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,491 +537,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -776,6 +1213,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -863,947 +1328,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1832,6 +2343,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1848,793 +2364,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2682,7 +2882,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2690,22 +2890,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2716,57 +2908,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2783,21 +2924,21 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2805,21 +2946,20 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2828,6 +2968,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2849,119 +2994,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2973,92 +3125,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3086,581 +3231,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3668,548 +3721,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/bn/LC_MESSAGES/sphinx.mo b/sphinx/locale/bn/LC_MESSAGES/sphinx.mo index a2303eab0d6..d34d9a80253 100644 Binary files a/sphinx/locale/bn/LC_MESSAGES/sphinx.mo and b/sphinx/locale/bn/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/bn/LC_MESSAGES/sphinx.po b/sphinx/locale/bn/LC_MESSAGES/sphinx.po index c7f068ee7eb..399f8edf607 100644 --- a/sphinx/locale/bn/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/bn/LC_MESSAGES/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FIRST AUTHOR , 2009\n" "Language-Team: Bengali (http://app.transifex.com/sphinx-doc/sphinx-1/language/bn/)\n" @@ -19,6 +19,127 @@ msgstr "" "Language: bn\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "পাইথন উন্নয়ন পরামর্শ; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -33,127 +154,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +322,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,468 +537,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "দৃষ্টি আকর্ষণ" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "সতর্কীকরণ" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "বিপজ্জনক" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "ভুল (এরর)" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "আভাস" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "গুরুত্বপূর্ণ" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "নোট" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "আরও দেখুন" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "পরামর্শ" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "সতর্কতা" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "(-" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "পাইথন উন্নয়ন পরামর্শ; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "error writing file %s: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:436 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/doctest.py:297 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/doctest.py:457 -#, python-format -msgid "no code/output in %s block at %s:%s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:594 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:342 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:536 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:545 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:556 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "বিল্টইন সমূহ" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "মডিউল লেভেল" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -739,9 +1175,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -776,6 +1213,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "অসমাপ্ত কাজ" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -863,879 +1328,960 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "অসমাপ্ত কাজ" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:47 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "অনুচ্ছেদ লেখক:" - -#: directives/other.py:205 -msgid "Module author: " -msgstr "মডিউল লেখক:" - -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " -msgstr "লেখক:" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "বিল্টইন সমূহ" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "মডিউল লেভেল" - -#: builders/changes.py:124 -msgid "copying source files..." +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:133 +#: domains/citation.py:75 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/citation.py:92 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:183 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +msgid "%s() (built-in function)" +msgstr "%s() (বিল্ট-ইন ফাংশন)" -#: builders/__init__.py:224 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s() (%s method)" +msgstr "%s() (%s মেথড)" + +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (ক্লাসে)" + +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" +msgstr "%s (%s এ্যট্রিবিউট)" + +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "রিটার্নস" + +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "রিটার্ন টাইপ" + +#: domains/javascript.py:374 +#, python-format +msgid "%s (module)" +msgstr "%s (মডিউল)" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "ফাংশন" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "মেথড" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "ক্লাস" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "ডাটা" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "এ্যট্রিবিউট" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "মডিউল" + +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:275 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "all of %d po files" +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are specified" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:309 +#: domains/rst.py:224 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (role)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:348 +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:361 +#: domains/changeset.py:32 #, python-format -msgid "%d source files given on command line" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:377 +#: domains/changeset.py:33 #, python-format -msgid "targets for %d source files that are out of date" -msgstr "" +msgid "Changed in version %s" +msgstr "%s ভার্সনে পরিবর্তিত" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/changeset.py:34 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "Deprecated since version %s" +msgstr "%s ভার্সন থেকে ডেপ্রিকেটেড" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:410 +#: domains/__init__.py:322 #, python-format -msgid "%d found" +msgid "%s %s" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:531 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:551 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/texinfo.py:45 +#: cmd/build.py:357 #, python-format -msgid "The Texinfo files are in %(outdir)s." +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr "(-" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:134 +#, python-format +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:230 #, python-format -msgid "unknown mimetype for %s, ignoring" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:242 +#, python-format +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "" + +#: cmd/quickstart.py:520 +#, python-format msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" + +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 +#: cmd/quickstart.py:671 #, python-format -msgid "Domain %r is not registered" +msgid "enable %s extension" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/nodes.py:490 +#: cmd/quickstart.py:810 #, python-format -msgid "toctree contains ref to nonexisting file %r" +msgid "Invalid template variable: %s" msgstr "" -#: util/nodes.py:706 +#: directives/other.py:119 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/display.py:87 -msgid "failed" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/osutil.py:131 +#: directives/other.py:169 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: directives/other.py:203 +msgid "Section author: " +msgstr "অনুচ্ছেদ লেখক:" + +#: directives/other.py:205 +msgid "Module author: " +msgstr "মডিউল লেখক:" + +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: directives/other.py:209 +msgid "Author: " +msgstr "লেখক:" + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "" + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: util/docutils.py:789 +#: directives/code.py:87 #, python-format -msgid "unknown node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: util/fileutil.py:76 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: util/fileutil.py:89 +#: directives/code.py:216 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: util/rst.py:73 +#: directives/code.py:231 #, python-format -msgid "default role %s not found" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/inventory.py:147 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: util/inventory.py:166 +#: directives/code.py:276 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "Object named %r not found in include file %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "পাদটীকা" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[ছবি]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1744,11 +2290,15 @@ msgstr "[ছবি]" msgid "Index" msgstr "ইনডেক্স" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "পাদটীকা" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "" @@ -1758,53 +2308,14 @@ msgstr "" msgid "unimplemented node type: %r" msgstr "" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown index entry type %s found" +msgid "[image: %s]" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[ছবি]" #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" @@ -1832,6 +2343,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1848,794 +2364,478 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (বিল্ট-ইন ফাংশন)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s মেথড)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (ক্লাসে)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s এ্যট্রিবিউট)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "রিটার্নস" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "রিটার্ন টাইপ" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (মডিউল)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "ফাংশন" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "মেথড" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "ক্লাস" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "ডাটা" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "এ্যট্রিবিউট" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "মডিউল" - -#: domains/javascript.py:454 +#: writers/latex.py:1615 #, python-format -msgid "duplicate %s description of %s, other %s in %s" +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/changeset.py:26 +#: writers/latex.py:1950 #, python-format -msgid "Added in version %s" +msgid "unknown index entry type %s found" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "%s ভার্সনে পরিবর্তিত" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "%s ভার্সন থেকে ডেপ্রিকেটেড" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/rst.py:236 -msgid "role" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "দৃষ্টি আকর্ষণ" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "সতর্কীকরণ" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "বিপজ্জনক" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "ভুল (এরর)" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "আভাস" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: locale/__init__.py:233 -msgid "Important" -msgstr "গুরুত্বপূর্ণ" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "নোট" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: locale/__init__.py:235 -msgid "See also" -msgstr "আরও দেখুন" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "পরামর্শ" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "সতর্কতা" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:133 +#: util/i18n.py:100 #, python-format -msgid "Please enter one of %s." +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:229 +#: util/i18n.py:244 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:234 +#: util/i18n.py:253 +#, python-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:241 +#: util/osutil.py:131 #, python-format -msgid "Selected root path: %s" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:273 +#: util/fileutil.py:76 +#, python-format msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:339 +#: util/docfields.py:103 +#, python-format msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:349 +#: util/nodes.py:462 +#, python-format msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:367 +#: util/nodes.py:739 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "পূর্ববর্তী পাতা হতে চলমান" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "রিলিজ" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: transforms/post_transforms/images.py:79 #, python-format -msgid "Creating file %s." +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "File %s already exists, skipping." -msgstr "" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:519 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:526 +#: transforms/post_transforms/__init__.py:88 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:530 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:670 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "Invalid template variable: %s" +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:109 +#: _cli/util/errors.py:207 msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:131 +#: _cli/util/errors.py:240 msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:157 +#: _cli/util/errors.py:246 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "নেভিগেশন" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "%(docstitle)s এর মধ্যে খুঁজুন" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "এই ডকুমেন্ট সম্পর্কে" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "অনুসন্ধান" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "কপিরাইট" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "%(last_updated)s সর্বশেষ পরিবর্তন করা হয়েছে।" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "পূর্ববর্তী টপিক" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "পূর্ববর্তী অধ্যায়" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "পরবর্তী টপিক" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "পরবর্তী অধ্যায়" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "অনুসন্ধান" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "এক পাতায় সম্পূর্ণ ইনডেক্স" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "যান" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "এই পাতা" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "সোর্স দেখুন" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "দ্রুত অনুসন্ধান" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "%(docstitle)s-এ খুঁজুন" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "যান" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2682,7 +2882,7 @@ msgstr "গ্লোবাল মডিউল ইনডেক্স" msgid "quick access to all modules" msgstr "সকল মডিউলে দ্রুত প্রবেশ" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "সাধারণ ইনডেক্স" @@ -2690,23 +2890,15 @@ msgstr "সাধারণ ইনডেক্স" msgid "all functions, classes, terms" msgstr "সকল ফাংশন, ক্লাস, টার্ম" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "এই পাতা" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "এক পাতায় সম্পূর্ণ ইনডেক্স" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "দ্রুত অনুসন্ধান" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "%(docstitle)s-এ খুঁজুন" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2716,57 +2908,6 @@ msgstr "বর্ণানুসারে ইনডেক্স পাতা" msgid "can be huge" msgstr "খুব বড় হতে পারে" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "পূর্ববর্তী টপিক" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "পূর্ববর্তী অধ্যায়" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "পরবর্তী টপিক" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "পরবর্তী অধ্যায়" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "নেভিগেশন" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "%(docstitle)s এর মধ্যে খুঁজুন" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "এই ডকুমেন্ট সম্পর্কে" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "কপিরাইট" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "%(last_updated)s সর্বশেষ পরিবর্তন করা হয়েছে।" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2783,21 +2924,21 @@ msgstr "" msgid "search" msgstr "খুঁজুন" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "অনুসন্ধানের ম্যাচগুলো লুকান" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "অনুসন্ধানের ফলাফল" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2805,22 +2946,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "অনুসন্ধানের ম্যাচগুলো লুকান" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2828,6 +2968,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2849,121 +2994,128 @@ msgstr "অন্যান্য পরিবর্তন" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "প্যারামিটার" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "রেইজেস" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s মডিউলে)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (%s মডিউলে)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (বিল্ট-ইন ভ্যারিয়েবল)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (বিল্ট-ইন ক্লাস)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (%s ক্লাসে)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s ক্লাস মেথড)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s স্ট্যাটিক মেথড)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "মডিউল সমূহ" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "ডেপ্রিকেটেড" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "এক্সেপশন" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "ক্লাস মেথড" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "স্ট্যাটিক মেথড" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "প্যারামিটার" - -#: domains/python/_object.py:206 -msgid "Variables" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "রেইজেস" - #: domains/cpp/__init__.py:159 msgid "Template Parameters" msgstr "" @@ -2973,92 +3125,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "এনভায়রনমেন্ট ভ্যারিয়েবল; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3095,572 +3240,480 @@ msgid "grammar token" msgstr "ব্যকরণ টোকেন" #: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "এনভায়রনমেন্ট ভ্যারিয়েবল" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "প্রোগ্রাম অপশন" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "মডিউল ইনডেক্স" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "এনভায়রনমেন্ট ভ্যারিয়েবল" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "প্রোগ্রাম অপশন" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "মডিউল ইনডেক্স" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "ইনডেক্স" - -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "পরবর্তী" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "পূর্ববর্তী" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "রিলিজ" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "পূর্ববর্তী পাতা হতে চলমান" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3668,548 +3721,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "ইনডেক্স" + +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "পরবর্তী" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "পূর্ববর্তী" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/ca/LC_MESSAGES/sphinx.mo b/sphinx/locale/ca/LC_MESSAGES/sphinx.mo index d6fe7d74750..32c9b73d0fc 100644 Binary files a/sphinx/locale/ca/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ca/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/ca/LC_MESSAGES/sphinx.po b/sphinx/locale/ca/LC_MESSAGES/sphinx.po index 8893b4e500b..e1385034533 100644 --- a/sphinx/locale/ca/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/ca/LC_MESSAGES/sphinx.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 18:26+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Antoni Bella Pérez , 2023-2025\n" "Language-Team: Catalan (http://app.transifex.com/sphinx-doc/sphinx-1/language/ca/)\n" @@ -22,6 +22,127 @@ msgstr "" "Language: ca\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "Vulnerabilitats i exposicions comunes (CVE %s)" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "número %s de CVE no vàlid" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "Enumeració de les debilitats comunes (CWE %s)" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "número %s de CWE no vàlid" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Propostes de millora a Python (PEP %s)" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "número de PEP no vàlid %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "número de RFC no vàlid %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "No s'admeten les seccions de configuració del tema que no siguin [theme] i [options] (s'ha intentat obtenir un valor des de %r)." + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "configuració %s. %s no es produeix en cap de les configuracions de temes cercats" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "opció de tema no admesa, s'ha donat %r" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "el fitxer %r en el camí de temes no és un fitxer ZIP vàlid ni conté cap tema" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "no s'ha trobat cap tema anomenat %r (manca theme.toml?)" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "El tema %r té una herència circular" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "El tema %r hereta des de %r, el qual no és un tema que estigui carregat. Els temes carregats són: %s" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "El tema %r té massa avantpassats" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "no s'ha trobat cap fitxer de configuració del tema a %r" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "el tema %r no té la taula «theme»" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "La taula del tema %r «[theme]» no és una taula" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "El tema %r ha de definir la configuració «theme.inherit»" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "La taula del tema %r «[options]» no és una taula" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "La configuració de «theme.pygments_style» ha de ser una taula. Consell: «%s»" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "S'han trobat múltiples fitxers per al document «%s»: %s\nUseu %r per a la compilació." + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "S'ha ignorat el document il·legible %r." + #: extension.py:58 #, python-format msgid "" @@ -36,127 +157,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Aquest projecte necessita l'extensió %s almenys a la versió %s i, per tant, no es pot construir amb la versió carregada (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "No es coneix el nom del lexer de pigments %r" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "L'anàlisi lèxica del literal_block %r com a «%s» ha resultat en un error en el testimoni: %r. S'està tornant a provar en el mode relaxat." + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "L'esdeveniment %r ja està present" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Nom desconegut de l'esdeveniment: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "El gestor %r per a l'esdeveniment %r ha retornat una excepció" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "No es pot trobar el directori d'origen (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "El directori de sortida (%s) no és un directori" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "El directori d'origen i el de destinació no poden ser idèntics" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "S'està executant Sphinx versió %s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Aquest projecte almenys necessita Sphinx versió %s i, per tant, no es pot crear amb aquesta versió." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "es crea el directori de sortida" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "mentre es configura l'extensió %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "«setup» tal com es defineix actualment a conf.py no és una crida de Python. Modifiqueu la seva definició per a convertir-la en una funció que es pugui cridar. Això és necessari perquè conf.py es comporti com a una extensió de Sphinx." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "s'estan carregant les traduccions [%s]..." -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "fet" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "no està disponible per a missatges integrats" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "s'està carregant l'entorn preparat" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "ha fallat: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "No s'ha seleccionat cap constructor, s'usa el predeterminat: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "la compilació ha finalitzat amb problemes." -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "la compilació ha tingut èxit." -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "la compilació ha finalitzat amb problemes, 1 avís (amb els avisos tractats com a errors)." -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "la compilació ha finalitzat amb problemes, 1 avís." -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "la compilació ha tingut èxit, 1 avís." -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "la compilació ha acabat amb problemes, %s avisos (amb avisos tractats com a errors)." -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "la compilació ha acabat amb problemes, %s avisos." -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "la compilació ha tingut èxit, %s avisos." -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "la classe del node %r ja està registrada, els seus visitants seran anul·lats" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "la directiva %r ja està registrada i no serà sobreseguda" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "el rol %r ja està registrat i no serà sobresegut" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -164,12 +312,12 @@ msgid "" "explicit" msgstr "l'extensió %s no declara si és segur per a la lectura en paral·lel, suposant que no ho sigui, demaneu a l'autor de l'extensió que ho comprovi i faci que sigui explícit" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "l'extensió %s no és segura per a la lectura en paral·lel" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -177,82 +325,214 @@ msgid "" "explicit" msgstr "l'extensió %s no declara si és segur per a l'escriptura en paral·lel, suposant que no ho sigui, demaneu a l'autor de l'extensió que ho comprovi i faci que sigui explícit" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "l'extensió %s no és segura per a l'escriptura en paral·lel" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "s'està executant %s en sèrie" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "el directori de configuració no conté un fitxer conf.py (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "La classe del constructor %s no té cap atribut «name»" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "El constructor %r ja existeix (al mòdul %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "El nom del constructor %s no està registrat o disponible a través del punt d'entrada" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "El nom del constructor %s no està registrat" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "el domini %s ja està registrat" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "el domini %s encara no està registrat" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "La directiva %r ja està registrada al domini %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "El rol %r ja està registrat al domini %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "L'índex %r ja està registrat al domini %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "L'object_type %r ja està registrat" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "El crossref_type %r ja està registrat" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r ja està registrat" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser per a %r ja està registrat" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "L'analitzador de fonts per a %s no registrat" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "El traductor per a %r ja existeix" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "kwargs per a add_node() haurà de ser una funció (visita, sortida) tupla: %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r ja està registrat" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "la representació matemàtica %s ja està registrada" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "S'ha trobat un valor de configuració no vàlid: «language = None». Actualitzeu la vostra configuració a un codi d'idioma vàlid. Es torna «en» (anglès)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "l'extensió %r ja es va fusionar amb Sphinx des de la versió %s. Aquesta extensió s'ignorarà." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Excepció original:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "No s'ha pogut importar l'extensió %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "l'extensió %r no té cap funció setup(). És realment un mòdul d'extensions de Sphinx?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "L'extensió %s usada per aquest projecte almenys necessita Sphinx versió %s i, per tant, no es pot crear amb aquesta versió." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "l'extensió %r ha retornat un objecte no admès des de la seva funció setup(). No n'hauria de retornar cap o retornar un diccionari de metadades" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "«Cap» no és un tipus de fitxer vàlid per a %r." + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "el directori de configuració no conté un fitxer conf.py (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "«%s» ha de ser «0» o «1», s'ha obtingut «%s»" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "no s'ha pogut substituir l'ajust de la configuració del diccionari %r, s'ignora (useu %r per a establir elements individuals)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "nombre no vàlid %r del valor de configuració %r, s'ignora" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "no s'ha pogut substituir l'ajust de la configuració %r amb tipus no compatibles, s'ignora" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "valor de configuració desconegut %r en substituir, s'ignora" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "Aquest valor de configuració no existeix: %r" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "El valor de configuració %r ja està present" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "no es pot emmagatzemar a la memòria cau un valor de configuració no recuperable: %r (perquè conté un objecte de funció, classe o mòdul)" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "S'ha trobat un valor de configuració no vàlid: «language = None». Actualitzeu la vostra configuració a un codi d'idioma vàlid. Es torna «en» (anglès)." + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Hi ha un error de sintaxi en el fitxer de configuració: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "El fitxer de configuració (o un dels mòduls que s'importen) ha cridat «sys.exit()»" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -260,540 +540,725 @@ msgid "" "%s" msgstr "Hi ha un error programable en el fitxer de configuració:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" -msgstr "" +msgstr "Ha fallat en convertir %r a un recurs congelat" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "S'està convertint «source_suffix = %r» a «source_suffix = %r»." -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "El valor de configuració «source_suffix» espera un diccionari, una cadena o una llista de cadenes. En lloc d'això, s'ha obtingut «%r» (escriviu %s)." -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Secció %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Fig. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Taula %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Llistat %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "El valor de configuració «{name}» ha de ser un de {candidates}, però s'ha donat «{current}»." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "El valor de configuració «{name}» té el tipus «{current.__name__}», s'espera {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "El valor de configuració «{name}» té el tipus «{current.__name__}», el valor predeterminat és «{default.__name__}»." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "no s'ha trobat primary_domain %r, s'ignora." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." -msgstr "" +msgstr "Sphinx ara utilitza «index» de manera predeterminada com a document mestre. Per a mantenir el comportament anterior a la 2.0, establiu «master_doc = 'contents'»." -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "No es coneix el nom del lexer de pigments %r" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "La compatibilitat amb les codificacions font diferents d'UTF-8 està obsoleta i se suprimirà al Sphinx 10. Si això causa algun problema, feu un comentari a «https://github.com/sphinx-doc/sphinx/issues/13665»." -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "L'anàlisi lèxica del literal_block %r com a «%s» ha resultat en un error en el testimoni: %r. S'està tornant a provar en el mode relaxat." +#: environment/__init__.py:89 +msgid "new config" +msgstr "configuració nova" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "No s'admeten les seccions de configuració del tema que no siguin [theme] i [options] (s'ha intentat obtenir un valor des de %r)." +#: environment/__init__.py:90 +msgid "config changed" +msgstr "configuració modificada" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "configuració %s. %s no es produeix en cap de les configuracions de temes cercats" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "extensions modificades" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "opció de tema no admesa, s'ha donat %r" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "la versió de l'entorn de compilació no és actual" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "el fitxer %r en el camí de temes no és un fitxer ZIP vàlid ni conté cap tema" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "el directori d'origen ha estat modificat" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "no s'ha trobat cap tema anomenat %r (manca theme.toml?)" +msgid "The configuration has changed (1 option: %r)" +msgstr "La configuració ha estat canviada (1 opció: %r)" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" -msgstr "El tema %r té una herència circular" +msgid "The configuration has changed (%d options: %s)" +msgstr "La configuració ha estat canviada (%d opcions: %s)" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "La configuració ha estat canviada (%d opcions: %s, «...»)" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "El tema %r hereta des de %r, el qual no és un tema que estigui carregat. Els temes carregats són: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Aquest entorn és incompatible amb el constructor seleccionat, trieu un altre directori doctree." -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "El tema %r té massa avantpassats" +msgid "Failed to scan documents in %s: %r" +msgstr "Ha fallat en escanejar els documents a %s: %r" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" -msgstr "no s'ha trobat cap fitxer de configuració del tema a %r" +msgid "Domain %r is not registered" +msgstr "El domini %r no està registrat" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "el tema %r no té la taula «theme»" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "el document no està inclòs en cap toctree" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "La taula del tema %r «[theme]» no és una taula" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "S'ha trobat un toctree autoreferenciat. S'ignora." -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "El tema %r ha de definir la configuració «theme.inherit»" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgstr "es fa referència al document en múltiples toctree: %s, se selecciona: %s <- %s" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "La taula del tema %r «[options]» no és una taula" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Atenció" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "La configuració de «theme.pygments_style» ha de ser una taula. Consell: «%s»" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Compte" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "L'esdeveniment %r ja està present" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Perill" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Nom desconegut de l'esdeveniment: %s" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Error" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "El gestor %r per a l'esdeveniment %r ha retornat una excepció" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Suggeriment" -#: project.py:72 +#: locale/__init__.py:234 +msgid "Important" +msgstr "Important" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Nota" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Vegeu també" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Truc" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Avís" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Els fitxers de Texinfo es troben a %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "S'han trobat múltiples fitxers per al document «%s»: %s\nUseu %r per a la compilació." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nExecuteu l'ordre «make» en aquest directori per a executar-les mitjançant\nel makeinfo (useu l'ordre «make info» per a fer-ho automàticament)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "S'ha ignorat el document il·legible %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "no s'ha trobat el valor de configuració «texinfo_documents»: no s'escriurà cap document" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "La classe del constructor %s no té cap atribut «name»" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "El valor de configuració «texinfo_documents» fa referència a un document %s desconegut" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "El constructor %r ja existeix (al mòdul %s)" +msgid "processing %s" +msgstr "s'està processant %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "El nom del constructor %s no està registrat o disponible a través del punt d'entrada" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "s'està escrivint" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "El nom del constructor %s no està registrat" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "s'estan resolent les referències..." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "el domini %s ja està registrat" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (a " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "el domini %s encara no està registrat" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "s'estan copiant les imatges... " -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "La directiva %r ja està registrada al domini %s" +msgid "cannot copy image file %r: %s" +msgstr "no s'ha pogut copiar el fitxer d'imatge %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "El rol %r ja està registrat al domini %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "s'estan copiant els fitxers de suport de Texinfo" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "L'índex %r ja està registrat al domini %s" +msgid "error writing file Makefile: %s" +msgstr "error en escriure el fitxer Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "L'object_type %r ja està registrat" +msgid "The manual pages are in %(outdir)s." +msgstr "Les pàgines del manual es troben a %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "El crossref_type %r ja està registrat" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "no s'ha trobat el valor de configuració «man_pages»: no s'escriuran les pàgines del manual" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r ja està registrat" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "El valor de configuració «man_pages» fa referència a un document %s desconegut" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser per a %r ja està registrat" +msgid "The HTML page is in %(outdir)s." +msgstr "La pàgina HTML es troba a %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "L'analitzador de fonts per a %s no registrat" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "s'està muntant un únic document" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "El traductor per a %r ja existeix" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "s'estan escrivint els fitxers addicionals" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "kwargs per a add_node() haurà de ser una funció (visita, sortida) tupla: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "El constructor fictici no genera cap fitxer." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r ja està registrat" +msgid "The message catalogs are in %(outdir)s." +msgstr "Els catàlegs de missatges es troben a %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "la representació matemàtica %s ja està registrada" +msgid "building [%s]: " +msgstr "s'està construint [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "l'extensió %r ja es va fusionar amb Sphinx des de la versió %s. Aquesta extensió s'ignorarà." +msgid "targets for %d template files" +msgstr "objectius per a %d fitxers de plantilla" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Excepció original:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "s'estan llegint les plantilles... " -#: registry.py:545 +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "s'estan escrivint els catàlegs de missatges... " + +#: builders/linkcheck.py:87 #, python-format -msgid "Could not import extension %s" -msgstr "No s'ha pogut importar l'extensió %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Cerqueu qualsevol error a la sortida anterior o en el fitxer %(outdir)s/output.txt" -#: registry.py:552 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "l'extensió %r no té cap funció setup(). És realment un mòdul d'extensions de Sphinx?" +msgid "broken link: %s (%s)" +msgstr "enllaç trencat: %s (%s)" -#: registry.py:565 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "L'extensió %s usada per aquest projecte almenys necessita Sphinx versió %s i, per tant, no es pot crear amb aquesta versió." +msgid "Anchor '%s' not found" +msgstr "No s'ha trobat l'àncora «%s»" + +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "linkcheck_allowed_redirects. S'esperava un diccionari." -#: registry.py:577 +#: builders/linkcheck.py:799 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "l'extensió %r ha retornat un objecte no admès des de la seva funció setup(). No n'hauria de retornar cap o retornar un diccionari de metadades" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "Ha fallat en compilar expressions regulars a linkcheck_allowed_redirects: %r %s" -#: registry.py:612 +#: builders/epub3.py:83 #, python-format -msgid "`None` is not a valid filetype for %r." -msgstr "«Cap» no és un tipus de fitxer vàlid per a %r." +msgid "The ePub file is in %(outdir)s." +msgstr "El fitxer ePub es troba a %(outdir)s." + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "s'està escrivint el fitxer nav.xhtml..." + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "el valor de configuració «epub_language» (o «language») no pot estar buit per a EPUB3" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "el valor de configuració «epub_uid» haurà de ser un XML NAME per a EPUB3" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "el valor de configuració «epub_title» (o «html_title») no pot estar buit per a EPUB3" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "el valor de configuració «epub_author» no pot estar buit per a EPUB3" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "el valor de configuració «epub_contributor» no pot estar buit per a EPUB3" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "el valor de configuració «epub_description» no pot estar buit per a EPUB3" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "el valor de configuració «epub_publisher» no pot estar buit per a EPUB3" -#: roles.py:206 +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "el valor de configuració «epub_copyright» (o «copyright») no pot estar buit per a EPUB3" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "el valor de configuració «epub_identifier» no pot estar buit per a EPUB3" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "el valor de configuració «version» no pot estar buit per a EPUB3" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "Vulnerabilitats i exposicions comuns (CVE %s)" +msgid "invalid css_file: %r, ignored" +msgstr "css_file no vàlid: %r, s'ignora" -#: roles.py:229 +#: builders/xml.py:29 #, python-format -msgid "invalid CVE number %s" -msgstr "número %s de CVE no vàlid" +msgid "The XML files are in %(outdir)s." +msgstr "Els fitxers en XML es troben a %(outdir)s." -#: roles.py:251 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "Enumeració de les debilitats comuns (CWE %s)" +msgid "error writing file %s: %s" +msgstr "error en escriure al fitxer %s: %s" -#: roles.py:274 +#: builders/xml.py:103 #, python-format -msgid "invalid CWE number %s" -msgstr "número %s de CWE no vàlid" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Els fitxers en pseudo XML es troben a %(outdir)s." -#: roles.py:294 +#: builders/_epub_base.py:223 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Propostes de millora a Python; PEP %s" +msgid "duplicated ToC entry found: %s" +msgstr "s'ha trobat una entrada ToC duplicada: %s" -#: roles.py:317 +#: builders/_epub_base.py:436 #, python-format -msgid "invalid PEP number %s" -msgstr "número de PEP no vàlid %s" +msgid "cannot read image file %r: copying it instead" +msgstr "no s'ha pogut llegir el fitxer d'imatge %r: en el seu lloc, es copia" -#: roles.py:355 +#: builders/_epub_base.py:467 #, python-format -msgid "invalid RFC number %s" -msgstr "número de RFC no vàlid %s" +msgid "cannot write image file %r: %s" +msgstr "no s'ha pogut escriure el fitxer d'imatge %r: %s" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[font]" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "No s'ha trobat el Pillow: es copien els fitxers d'imatge" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "s'està ressaltant el codi del mòdul... " +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "s'està escrivint un fitxer de tipus MIME..." -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[documents]" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "s'està escrivint el fitxer META-INF/container.xml..." -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Codi del mòdul" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "s'està escrivint el fitxer content.opf..." -#: ext/viewcode.py:353 +#: builders/_epub_base.py:594 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        Codi font per a %s

        " +msgid "unknown mimetype for %s, ignoring" +msgstr "tipus MIME desconegut per a %s, s'ignora" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Vista general: codi del mòdul" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "el node té un nivell no vàlid" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Tots els mòduls per als quals hi ha codi

        " +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "s'està escrivint el fitxer toc.ncx..." -#: ext/extlinks.py:82 +#: builders/_epub_base.py:802 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "l'enllaç codificat %r podria substituir-se per un enllaç extern (en el seu lloc intenteu usar %r)" +msgid "writing %s file..." +msgstr "s'està escrivint el fitxer %s..." -#: ext/autosectionlabel.py:52 +#: builders/text.py:27 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "la secció «%s» s'etiqueta com a «%s»" +msgid "The text files are in %(outdir)s." +msgstr "Els fitxers de text es troben a %(outdir)s." -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/__init__.py:229 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "etiqueta duplicada %s, una altra instància a %s" +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "no s'ha trobat una imatge adequada per al constructor %s: %s (%s)" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "Enllaça amb aquesta equació" +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "no s'ha trobat una imatge adequada per al constructor %s: %s" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "==================== durades de lectura més lentes =====================" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "s'estan construint [mo]:" -#: ext/doctest.py:118 -#, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "manca «+» o «-» a l'opció «%s»." +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "s'està escrivint la sortida..." -#: ext/doctest.py:124 +#: builders/__init__.py:280 #, python-format -msgid "'%s' is not a valid option." -msgstr "«%s» no és una opció vàlida." +msgid "all of %d po files" +msgstr "tots els %d fitxers PO" -#: ext/doctest.py:139 +#: builders/__init__.py:302 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "«%s» no és una opció pyversion vàlida" - -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "tipus de TestCode no vàlid" +msgid "targets for %d po files that are specified" +msgstr "objectius per als %d fitxers PO que s'han especificat" -#: ext/doctest.py:297 +#: builders/__init__.py:314 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Proves de doctests en les fonts acabades, mireu el resultat a %(outdir)s/output.txt." +msgid "targets for %d po files that are out of date" +msgstr "objectius per als %d fitxers PO que estan desfasats" -#: ext/doctest.py:457 -#, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "no hi ha codi/sortida en el bloc %s a %s:%s" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "tots els fitxers font" -#: ext/doctest.py:568 +#: builders/__init__.py:335 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "s'ignora el codi doctest no vàlid: %r" +msgid "file %r given on command line does not exist, " +msgstr "el fitxer %r proporcionat a la línia d'ordres no existeix, " -#: ext/imgmath.py:162 +#: builders/__init__.py:342 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "l'ordre de LaTeX %r no s'ha pogut executar (necessària per a la visualització matemàtica), comproveu la configuració d'«imgmath_latex»" +"file %r given on command line is not under the source directory, ignoring" +msgstr "el fitxer %r proporcionat a la línia d'ordres no es troba sota el directori d'origen, s'ignora" -#: ext/imgmath.py:181 +#: builders/__init__.py:353 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%s l'ordre de %r no s'ha pogut executar (necessària per a la visualització matemàtica), comproveu la configuració d'«imgmath_%s»" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "el fitxer %r proporcionat a la línia d'ordres no és un document vàlid, s'ignora" -#: ext/imgmath.py:344 +#: builders/__init__.py:366 #, python-format -msgid "display latex %r: %s" -msgstr "visualització de latex %r: %s" +msgid "%d source files given on command line" +msgstr "%d fitxers font proporcionats a la línia d'ordres" -#: ext/imgmath.py:380 +#: builders/__init__.py:382 #, python-format -msgid "inline latex %r: %s" -msgstr "latex inclòs %r: %s" +msgid "targets for %d source files that are out of date" +msgstr "els objectius per a %d fitxers font que estan desfasats" -#: ext/coverage.py:48 -#, python-format -msgid "invalid regex %r in %s" -msgstr "expressions regulars no vàlides %r a %s" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "s'està cercant per fitxers sense actualitzar... " -#: ext/coverage.py:140 ext/coverage.py:301 +#: builders/__init__.py:415 #, python-format -msgid "module %s could not be imported: %s" -msgstr "el mòdul %s no s'ha pogut importar: %s" +msgid "%d found" +msgstr "s'han trobat %d" -#: ext/coverage.py:148 -#, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "els mòduls següents estan documentats però no s'han especificat a coverage_modules: %s" +#: builders/__init__.py:417 +msgid "none found" +msgstr "no se n'ha trobat cap" -#: ext/coverage.py:158 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" -msgstr "els mòduls següents s'especifiquen a coverage_modules però no estan documentats" +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "s'està preparant l'ambient" -#: ext/coverage.py:172 -#, python-brace-format, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." -msgstr "" +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "s'està comprovant la coherència" -#: ext/coverage.py:187 -#, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "expressions regulars %r no vàlides a coverage_c_regexes" +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "no hi ha cap objectiu desfasat." -#: ext/coverage.py:260 -#, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "API de C sense documentar: %s [ %s] en el fitxer %s" +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "s'està actualitzant l'entorn: " -#: ext/coverage.py:452 +#: builders/__init__.py:499 #, python-format -msgid "undocumented python function: %s :: %s" -msgstr "funció de Python sense documentar: %s :: %s" +msgid "%s added, %s changed, %s removed" +msgstr "%s afegits, %s canviats, %s eliminats" -#: ext/coverage.py:473 +#: builders/__init__.py:536 #, python-format -msgid "undocumented python class: %s :: %s" -msgstr "classe de Python sense documentar: %s :: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "L'Sphinx no pot carregar el document mestre (%s) perquè coincideix amb un patró d'exclusió %r a la construcció. Si us plau, moveu el vostre document mestre cap a una altra ubicació." -#: ext/coverage.py:492 +#: builders/__init__.py:545 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "mètode de Python sense documentar: %s :: %s :: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "L'Sphinx no pot carregar el document mestre (%s) perquè coincideix amb un patró d'exclusió especificat a «conf.py», %r. Si us plau, elimineu aquest patró." -#: ext/imgconverter.py:44 +#: builders/__init__.py:556 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "No es pot executar l'ordre de conversió d'imatges %r. «sphinx.ext.imgconverter» requereix de manera predeterminada ImageMagick. Assegureu-vos que està instal·lat o configureu l'opció «image_converter» a una ordre de conversió personalitzada.\n\nTraça: %s" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "L'Sphinx no pot carregar el document mestre (%s) perquè no s'inclou a l'opció personalitzada include_patterns = %r. Assegureu-vos que un patró a include_patterns coincideixi amb el document mestre." -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: builders/__init__.py:563 #, python-format msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "L'Sphinx no pot carregar el document mestre (%s). El document mestre haurà d'estar dins del directori font o un subdirectori d'aquest." + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "s'estan llegint les fonts... " + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "els docname que s'escriuran: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "no hi ha cap docname per escriure!" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "s'estan preparant els documents" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "s'estan copiant els recursos" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "El fitxer de vista general es troba a %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "no hi ha canvis en la versió %s." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "s'està escrivint el fitxer de vista general..." + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Elements incorporats" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Nivell de mòdul" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "s'estan copiant els fitxers font..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "no s'ha pogut llegir %r per a la creació del registre de canvis" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "expressions regulars no vàlides %r a %s" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "el mòdul %s no s'ha pogut importar: %s" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "els mòduls següents estan documentats, però no s'han especificat a coverage_modules: %s" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "S'han acabat les proves de cobertura a les fonts, mireu el resultat a «%(outdir)s{sep}python.txt»." + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "expressions regulars %r no vàlides a coverage_c_regexes" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "API de C sense documentar: %s [ %s] en el fitxer %s" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "funció de Python sense documentar: %s :: %s" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "classe de Python sense documentar: %s :: %s" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "mètode de Python sense documentar: %s :: %s :: %s" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "l'enllaç codificat %r podria substituir-se per un enllaç extern (en el seu lloc intenteu usar %r)" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Tasca pendent" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "S'ha trobat una entrada TODO: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(L'<> es troba a %s, línia %d)." + +#: ext/todo.py:166 +msgid "original entry" +msgstr "entrada original" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "No es pot executar l'ordre de conversió d'imatges %r. «sphinx.ext.imgconverter» requereix de manera predeterminada ImageMagick. Assegureu-vos que està instal·lat o establiu l'opció «image_converter» a una ordre de conversió personalitzada.\n\nTraça: %s" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" "%r" msgstr "«convert» ha sortit amb un error:\n[stderr]\n%r\n[stdout]\n%r" @@ -850,7 +1315,7 @@ msgstr "«dot» no ha produït un fitxer de sortida:\n[stderr]\n%r\n[stdout]\n%r #: ext/graphviz.py:367 #, python-format msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" -msgstr "" +msgstr "«graphviz_output_format» ha de ser «png» o «svg», però és %r" #: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 #, python-format @@ -866,879 +1331,960 @@ msgstr "[gràfica: %s]" msgid "[graph]" msgstr "[gràfica]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Tasca pendent" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" -msgstr "S'ha trobat una entrada TODO: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "l'ordre de LaTeX %r no s'ha pogut executar (necessària per a la visualització matemàtica), comproveu la configuració d'«imgmath_latex»" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s l'ordre de %r no s'ha pogut executar (necessària per a la visualització matemàtica), comproveu la configuració d'«imgmath_%s»" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(L'<> es troba a %s, línia %d)." +msgid "display latex %r: %s" +msgstr "visualització de latex %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "entrada original" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "latex inclòs %r: %s" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "cap espai en blanc eliminat en disminuir el sagnat" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "Enllaça amb aquesta equació" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" -msgstr "Subtítol no vàlid: %s" +msgid "missing '+' or '-' in '%s' option." +msgstr "manca «+» o «-» a l'opció «%s»." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "l'especificació del número de línia queda fora de l'interval (1-%d): %r" +msgid "'%s' is not a valid option." +msgstr "«%s» no és una opció vàlida." -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "No es poden usar ambdues opcions «%s» i «%s»" +msgid "'%s' is not a valid pyversion option" +msgstr "«%s» no és una opció pyversion vàlida" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "No s'ha trobat el fitxer d'inclusió «%s» o n'ha fallat la lectura" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "tipus de TestCode no vàlid" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "La codificació %r emprada per a llegir el fitxer d'inclusió «%s» sembla ser incorrecta, proveu indicant una opció :encoding:" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Proves de doctests en les fonts acabades, mireu el resultat a %(outdir)s/output.txt." -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "L'objecte anomenat %r no es troba en el fitxer inclòs %r" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "No podeu usar «lineno-match» amb un conjunt desarticulat de «línies»" +msgid "no code/output in %s block at %s:%s" +msgstr "no hi ha codi/sortida en el bloc %s a %s:%s" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Línia específica %r: No hi ha cap línia llançada des del fitxer inclòs %r" +msgid "ignoring invalid doctest code: %r" +msgstr "s'ignora el codi doctest no vàlid: %r" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "«:file:» l'opció per a la directiva «csv-table» ara reconeix un camí absolut com a camí relatiu des del directori d'origen. Actualitzeu el vostre document." +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "la secció «%s» s'etiqueta com a «%s»" -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "El patró global toctree %r no coincideix amb cap document" +msgid "duplicate label %s, other instance in %s" +msgstr "etiqueta duplicada %s, una altra instància a %s" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "el toctree conté una referència cap al document exclòs %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" -#: directives/other.py:156 +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "el toctree conté una referència cap al document %r, el qual no existeix" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "==================== durades de lectura més lentes =====================" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "s'ha trobat una entrada duplicada en el toctree: %s" +msgid "%.3fs %s" +msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autor de la secció:" - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autor del mòdul: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autor del codi: " - -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor: " - -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "... el contingut dels reconeixements no és una llista" - -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "... el contingut de l'historial no és una llista" - -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." -msgstr "El fitxer de vista general es troba a %(outdir)s." - -#: builders/changes.py:56 -#, python-format -msgid "no changes in version %s." -msgstr "no hi ha canvis en la versió %s." - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "s'està escrivint el fitxer de vista general..." - -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Elements incorporats" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[font]" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Nivell de mòdul" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "s'està ressaltant el codi del mòdul... " -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "s'estan copiant els fitxers font..." +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[documents]" -#: builders/changes.py:133 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "no s'ha pogut llegir %r per a la creació del registre de canvis" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Codi del mòdul" -#: builders/manpage.py:37 +#: ext/viewcode.py:359 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Les pàgines del manual es troben a %(outdir)s." +msgid "

        Source code for %s

        " +msgstr "

        Codi font per a %s

        " -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "no s'ha trobat el valor de configuració «man_pages»: no s'escriuran les pàgines del manual" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Vista general: codi del mòdul" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "s'està escrivint" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Tots els mòduls per als quals hi ha codi

        " -#: builders/manpage.py:71 +#: domains/citation.py:75 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "El valor de configuració «man_pages» fa referència a un document %s desconegut" +msgid "duplicate citation %s, other instance in %s" +msgstr "citació duplicada %s, una altra instància a %s" -#: builders/__init__.py:224 +#: domains/citation.py:92 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "no s'ha trobat una imatge adequada per al constructor %s: %s (%s)" +msgid "Citation [%s] is not referenced." +msgstr "No es fa referència a la citació [%s]." -#: builders/__init__.py:232 +#: domains/math.py:73 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "no s'ha trobat una imatge adequada per al constructor %s: %s" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "s'estan construint [mo]:" - -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "s'està escrivint la sortida..." +msgid "duplicate label of equation %s, other instance in %s" +msgstr "etiqueta duplicada de l'equació %s, una altra instància a %s" -#: builders/__init__.py:275 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "all of %d po files" -msgstr "tots els %d fitxers PO" +msgid "Invalid math_eqref_format: %r" +msgstr "math_eqref_format no vàlid: %r" -#: builders/__init__.py:297 +#: domains/javascript.py:183 #, python-format -msgid "targets for %d po files that are specified" -msgstr "objectius per als %d fitxers PO que s'han especificat" +msgid "%s() (built-in function)" +msgstr "%s() (funció interna)" -#: builders/__init__.py:309 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "objectius per als %d fitxers PO que estan desfasats" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "tots els fitxers font" +msgid "%s() (%s method)" +msgstr "%s() (mètode %s)" -#: builders/__init__.py:330 +#: domains/javascript.py:186 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "el fitxer %r proporcionat a la línia d'ordres no existeix, " +msgid "%s() (class)" +msgstr "%s() (classe)" -#: builders/__init__.py:337 +#: domains/javascript.py:188 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "el fitxer %r proporcionat a la línia d'ordres no es troba sota el directori d'origen, s'ignora" +msgid "%s (global variable or constant)" +msgstr "%s (variable global o constant)" -#: builders/__init__.py:348 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "el fitxer %r proporcionat a la línia d'ordres no és un document vàlid, s'ignora" +msgid "%s (%s attribute)" +msgstr "%s (atribut %s)" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "%d fitxers font proporcionats a la línia d'ordres" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Arguments" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "els objectius per a %d fitxers font que estan desfasats" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Llançaments" -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " -msgstr "s'està construint [%s]: " +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Retorna" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "s'està cercant per fitxers sense actualitzar... " +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Tipus de retorn" -#: builders/__init__.py:410 +#: domains/javascript.py:374 #, python-format -msgid "%d found" -msgstr "s'han trobat %d" - -#: builders/__init__.py:412 -msgid "none found" -msgstr "no se n'ha trobat cap" +msgid "%s (module)" +msgstr "%s (mòdul)" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "s'està preparant l'ambient" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funció" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "s'està comprovant la coherència" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "mètode" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "no hi ha cap objectiu desfasat." +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "classe" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "s'està actualitzant l'entorn: " +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "dades" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s afegits, %s canviats, %s eliminats" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribut" -#: builders/__init__.py:531 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "L'Sphinx no pot carregar el document mestre (%s) perquè coincideix amb un patró d'exclusió %r a la construcció. Si us plau, moveu el vostre document mestre cap a una altra ubicació." +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "mòdul" -#: builders/__init__.py:540 +#: domains/javascript.py:458 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "L'Sphinx no pot carregar el document mestre (%s) perquè coincideix amb un patró d'exclusió especificat a «conf.py», %r. Si us plau, elimineu aquest patró." +msgid "duplicate %s description of %s, other %s in %s" +msgstr "descripció %s duplicada de %s, una altra %s a %s" -#: builders/__init__.py:551 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "L'Sphinx no pot carregar el document mestre (%s) perquè no s'inclou a l'opció personalitzada include_patterns = %r. Assegureu-vos que un patró a include_patterns coincideixi amb el document mestre." +msgid "%s (directive)" +msgstr "%s (directiva)" -#: builders/__init__.py:558 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "L'Sphinx no pot carregar el document mestre (%s). El document mestre haurà d'estar dins del directori font o un subdirectori d'aquest." - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "s'estan llegint les fonts... " +msgid ":%s: (directive option)" +msgstr ":%s: (opció de la directiva)" -#: builders/__init__.py:713 +#: domains/rst.py:224 #, python-format -msgid "docnames to write: %s" -msgstr "els docname que s'escriuran: %s" +msgid "%s (role)" +msgstr "%s (rol)" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" +#: domains/rst.py:234 +msgid "directive" +msgstr "directiva" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "s'estan preparant els documents" +#: domains/rst.py:235 +msgid "directive-option" +msgstr "opció_de_la_directiva" -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "s'estan copiant els recursos" +#: domains/rst.py:236 +msgid "role" +msgstr "rol" -#: builders/__init__.py:883 +#: domains/rst.py:262 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "caràcters font no codificables, substituint per «?»: %r" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "descripció duplicada del %s %s, una altra instància a %s" -#: builders/epub3.py:84 +#: domains/changeset.py:32 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "El fitxer ePub es troba a %(outdir)s." +msgid "Added in version %s" +msgstr "Afegit a la versió %s" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "s'està escrivint el fitxer nav.xhtml..." +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "Canviat a la versió %s" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "el valor de configuració «epub_language» (o «language») no pot estar buit per a EPUB3" +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "Obsolet des de la versió %s" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "el valor de configuració «epub_uid» haurà de ser un XML NAME per a EPUB3" +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" +msgstr "S'ha eliminat a la versió %s" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "el valor de configuració «epub_title» (o «html_title») no pot estar buit per a EPUB3" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "el valor de configuració «epub_author» no pot estar buit per a EPUB3" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "el número de treball hauria de ser un nombre positiu" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "el valor de configuració «epub_contributor» no pot estar buit per a EPUB3" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "Per a més informació, visiteu ." -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "el valor de configuració «epub_description» no pot estar buit per a EPUB3" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nGenerar la documentació a partir dels fitxers font.\n\nL'eina «sphinx-build» generarà la documentació a partir dels fitxers\na SOURCEDIR i els situarà a OUTPUTDIR. Cerqueu el «conf.py» en el\nSOURCEDIR per als paràmetres de configuració. L'eina «sphinx-quickstart» es pot usar per a generar fitxers de plantilla, inclòs el «conf.py».\n\nL'eina «sphinx-build» pot crear documentació en formats diferents. A la\nlínia d'ordres se selecciona un format que especifica el nom del constructor.\nDe manera predeterminada és HTML. Els constructors també poden dur a terme\naltres tasques relacionades amb el processament de la documentació.\n\nDe manera predeterminada, es construeix tot el que està desactualitzat. Es pot\ngenerar la sortida només per als fitxers seleccionats especificant noms de fitxer\nindividuals.\n" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "el valor de configuració «epub_publisher» no pot estar buit per a EPUB3" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "camí cap als fitxers font de la documentació" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "el valor de configuració «epub_copyright» (o «copyright») no pot estar buit per a EPUB3" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "camí cap al directori de sortida" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "el valor de configuració «epub_identifier» no pot estar buit per a EPUB3" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "(opcional) una llista de fitxers específics que s'han de reconstruir. S'ignorarà si s'especifica «--write-all»" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "el valor de configuració «version» no pot estar buit per a EPUB3" +#: cmd/build.py:114 +msgid "general options" +msgstr "opcions generals" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "css_file no vàlid: %r, s'ignora" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "constructor que s'usarà (predeterminat: «html»)" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Els fitxers en XML es troben a %(outdir)s." +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "executa en paral·lel amb N processos, quan sigui possible. «auto» uxa el nombre de nuclis de la CPU" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "error en escriure al fitxer %s: %s" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "escriu tots els fitxers (predeterminat: només escriu els fitxers nous i els que han canviat)" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Els fitxers en pseudo XML es troben a %(outdir)s." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "no usar un entorn desat, llegeix sempre tots els fitxers" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Els fitxers de Texinfo es troben a %(outdir)s." +#: cmd/build.py:150 +msgid "path options" +msgstr "opcions de camí" -#: builders/texinfo.py:48 +#: cmd/build.py:157 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nExecuteu l'ordre «make» en aquest directori per a executar-les mitjançant\nel makeinfo (useu l'ordre «make info» per a fer-ho automàticament)." +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "directori per als fitxers doctree i d'entorn (predeterminat: OUTPUT_DIR/.doctrees)" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "no s'ha trobat el valor de configuració «texinfo_documents»: no s'escriurà cap document" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "directori per al fitxer de configuració (conf.py) (predeterminat: SOURCE_DIR)" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "El valor de configuració «texinfo_documents» fa referència a un document %s desconegut" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "no usa cap fitxer de configuració, només usa la configuració de les opcions de «-D»" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "s'està processant %s" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "superposa una configuració en el fitxer de configuració" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "s'estan resolent les referències..." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "passa un valor a dins de les plantilles HTML" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (a " +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "defineix l'etiqueta: inclou blocs «only» amb TAG" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "s'estan copiant les imatges... " +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "mode primmirat: avisa sobre totes les referències que manquen" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "no s'ha pogut copiar el fitxer d'imatge %r: %s" +#: cmd/build.py:212 +msgid "console output options" +msgstr "opcions de sortida de la consola" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "s'estan copiant els fitxers de suport de Texinfo" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "augmenta la loquacitat (es pot repetir)" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "error en escriure el fitxer Makefile: %s" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "sense sortida a la sortida estàndard, només avisos a la sortida d'error estàndard" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "s'ha trobat una entrada ToC duplicada: %s" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "sense sortida, ni tan sols els avisos" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "no s'ha pogut llegir el fitxer d'imatge %r: en el seu lloc, es copia" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "emet una sortida amb colors (predeterminada: detecció automàtica)" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "no s'ha pogut escriure el fitxer d'imatge %r: %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "no emetre una sortida amb colors (predeterminada: detecció automàtica)" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "No s'ha trobat el Pillow: es copien els fitxers d'imatge" +#: cmd/build.py:252 +msgid "warning control options" +msgstr "opcions de control d'avís" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "s'està escrivint un fitxer de tipus MIME..." +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "escriviu els avisos (i errors) al fitxer indicat" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "s'està escrivint el fitxer META-INF/container.xml..." +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "converteix els avisos en errors" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "s'està escrivint el fitxer content.opf..." +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "mostra la traça completa en excepció" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "tipus MIME desconegut per a %s, s'ignora" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "executa Pdb en excepció" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "el node té un nivell no vàlid" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "planteja una excepció sobre els avisos" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "s'està escrivint el fitxer toc.ncx..." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "no es pot combinar l'opció -a i els noms de fitxer" -#: builders/_epub_base.py:794 +#: cmd/build.py:357 #, python-format -msgid "writing %s file..." -msgstr "s'està escrivint el fitxer %s..." +msgid "cannot open warning file '%s': %s" +msgstr "no es pot obrir el fitxer de l'avís «%s»: %s" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "El constructor fictici no genera cap fitxer." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "l'argument de l'opció «-D» haurà d'estar en la forma «nom=valor»" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Els catàlegs de missatges es troben a %(outdir)s." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "l'argument de l'opció -A haurà d'estar en la forma «nom=valor»" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "objectius per a %d fitxers de plantilla" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "insereix automàticament les docstring des dels mòduls" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "s'estan llegint les plantilles... " +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "prova automàticament els fragments de codi en els blocs doctest" -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "s'estan escrivint els catàlegs de missatges... " +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "enllaç entre la documentació de Sphinx de projectes diferents" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "La pàgina HTML es troba a %(outdir)s." +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "escriu les entrades «todo» que es poden mostrar o ocultar durant la construcció" -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "s'està muntant un únic document" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "comprovacions per a la cobertura de la documentació" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "s'estan escrivint els fitxers addicionals" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "inclou expressions matemàtiques, mostrades com a imatges PNG o SVG" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Cerqueu qualsevol error a la sortida anterior o en el fitxer %(outdir)s/output.txt" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "inclou expressions matemàtiques, representades en el navegador per MathJax" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "enllaç trencat: %s (%s)" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "inclusió condicional de contingut basat en els valors de la configuració" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "No s'ha trobat l'àncora «%s»" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "inclou els enllaços cap al codi font dels objectes documentats en Python" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "Ha fallat en compilar expressions regulars a linkcheck_allowed_redirects: %r %s" - -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Els fitxers de text es troben a %(outdir)s." - -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "referències incoherents de nota al peu en el missatge traduït. Original: {0}, traduït: {1}" - -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "referències incoherents en el missatge traduït. Original: {0}, traduït: {1}" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "crea un fitxer .nojekyll per a publicar el document a les pàgines de GitHub" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "referències incoherents de citació en el missatge traduït. Original: {0}, traduït: {1}" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Si us plau, introduïu un nom de camí vàlid." -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "referències incoherents de terme en el missatge traduït. Original: {0}, traduït: {1}" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Si us plau, introduïu algun text." -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 +#: cmd/quickstart.py:134 #, python-format -msgid "%b %d, %Y" -msgstr "%-d %b, %Y" +msgid "Please enter one of %s." +msgstr "Si us plau, introduïu un dels %s." -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "no s'ha pogut calcular el progrés de la traducció!" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Si us plau, introduïu qualsevol de «y» o «n»." -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "No hi ha cap element traduït!" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Si us plau, introduïu un sufix de fitxer, p. ex., «.rst» o «.txt»." -#: transforms/__init__.py:253 +#: cmd/quickstart.py:230 #, python-format +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Us donem la benvinguda a la utilitat d'inici ràpid de Sphinx %s." + +#: cmd/quickstart.py:235 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "S'ha trobat un índex basat en 4 columnes. Pot ser un error de les extensions que utilitzeu: %r" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Introduïu els valors per a les configuracions següents (només premeu «Retorn»\nper a acceptar un valor predeterminat, si se'n dona un entre parèntesis)." -#: transforms/__init__.py:294 +#: cmd/quickstart.py:242 #, python-format -msgid "Footnote [%s] is not referenced." -msgstr "La nota al peu [%s] no té una referència." - -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "No es fa referència a la nota al peu [*]." - -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "La nota al peu [núm.] no té una referència." - -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "Ús:" +msgid "Selected root path: %s" +msgstr "Camí arrel seleccionat: %s" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "{0} [OPCIONS] []" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Introduïu el camí arrel per a la documentació." -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr " El generador de documentació Sphinx." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Camí arrel per a la documentació" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "Ordres:" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Error: ja existeix un fitxer conf.py en el camí arrel seleccionat." -#: _cli/__init__.py:98 -msgid "Options" -msgstr "Opcions" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "«sphinx-quickstart» no sobreescriurà els projectes de Sphinx existents." -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "Per a més informació, visiteu https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Introduïu un camí arrel nou (o premeu «Retorn» per a sortir)" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "{0}: error: {1}\nPer a informació executeu «{0} --help»" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Teniu dues opcions per a col·locar el directori de construcció per a la\nsortida de Sphinx. O useu un directori «_build» dins del camí arrel,\no els directoris separats «source» i «build» dins del camí arrel." -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr " Gestiona la documentació amb Sphinx." +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Separa els directoris «source» i «build» (s/n)" -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "Mostra la versió i surt." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "Dins del directori arrel, es crearan dos directoris més: «_templates» per a\nles plantilles HTML personalitzades i «_static» per als fulls d'estil\npersonalitzats i altres fitxers estàtics. Podeu introduir un altre prefix\n(com «.») per a substituir el guió baix." -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "Mostra aquest missatge i surt." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Prefix de nom per als directoris «templates» i «static»" -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "Registre" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "El nom del projecte apareixerà en diversos llocs de la documentació construïda." -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "Augmenta la verbositat (es pot repetir)" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Nom del projecte" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "Imprimeix només els errors i els avisos." +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Noms de l'autoria" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "Cap sortida en absolut" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx té la noció d'una «versió» i un «llançament» per al programari.\nCada versió pot tenir múltiples versions. Per exemple, per a Python,\nla versió és una cosa semblant a 2.5 o 3.0, mentre que el llançament és\ncom 2.5.1 o 3.0a1. Si no necessiteu aquesta doble estructura, senzillament\nestabliu ambdues amb el mateix valor." -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Versió del projecte" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "Vegeu «sphinx --help».\n" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Llançament del projecte" -#: environment/__init__.py:86 -msgid "new config" -msgstr "configuració nova" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "Si els documents s'han d'escriure en un idioma que no sigui l'anglès,\npodeu seleccionar un idioma aquí per al vostre codi d'idioma.\nA continuació, Sphinx traduirà el text que es genera en aquest idioma.\n\nPer a obtenir una llista dels codis admesos, vegeu\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: environment/__init__.py:87 -msgid "config changed" -msgstr "configuració modificada" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Idioma del projecte" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "extensions modificades" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "El sufix del nom del fitxer per als fitxers d'origen. Normalment, aquest és\n«.txt» o «.rst». Només els fitxers amb aquest sufix es consideraran documents." -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "la versió de l'entorn de compilació no és actual" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Sufix del fitxer font" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "el directori d'origen ha estat modificat" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "Un document és especial perquè es considera el node superior de l'«arbre de\ncontingut», és a dir, és l'arrel de l'estructura jeràrquica dels documents.\nNormalment, es tracta de l'«index», però si el document «index» és una\nplantilla personalitzada, també podreu establir-la a un altre nom de fitxer." -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "La configuració ha estat canviada (1 opció: %r)" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Nom del document mestre (sense sufix)" -#: environment/__init__.py:330 +#: cmd/quickstart.py:368 #, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "La configuració ha estat canviada (%d opcions: %s)" +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Error: el fitxer mestre %s ja es troba en el camí arrel seleccionat." -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "La configuració ha estat canviada (%d opcions: %s, «...»)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "«sphinx-quickstart» no sobreescriurà el fitxer existent." -#: environment/__init__.py:379 +#: cmd/quickstart.py:378 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "Aquest entorn és incompatible amb el constructor seleccionat, trieu un altre directori doctree." +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Introduïu un nom de fitxer nou o canvieu-ne el nom i premeu «Retorn»" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "Ha fallat en escanejar els documents a %s: %r" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Indiqueu quines de les extensions següents de Sphinx haurien d'estar habilitades:" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "El domini %r no està registrat" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Nota: «imgmath» i «mathjax» no es poden habilitar alhora. «imgmath» ha estat desseleccionat." -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "el document no està inclòs en cap toctree" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Es pot generar un fitxer Makefile i un fitxer d'ordres de Windows,\nde manera que només haureu d'executar, p. ex., «make html»\nen lloc d'invocar directament «sphinx-build»." -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "S'ha trobat un toctree autoreferenciat. S'ignora." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Voleu crear el Makefile? (s/n)" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "es fa referència al document en múltiples toctree: %s, se selecciona: %s <- %s" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Voleu crear el fitxer d'ordres de Windows? (s/n)" -#: util/i18n.py:100 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "reading error: %s, %s" -msgstr "error de lectura: %s, %s" +msgid "Creating file %s." +msgstr "S'està creant el fitxer %s." -#: util/i18n.py:113 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "writing error: %s, %s" -msgstr "error d'escriptura: %s, %s" +msgid "File %s already exists, skipping." +msgstr "El fitxer %s ja existeix, se salta." -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "locale_dir %s no existeix" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Finalitzat: s'ha creat una estructura inicial del directori." -#: util/i18n.py:236 +#: cmd/quickstart.py:520 #, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Ara heu de completar el fitxer mestre %s i crear altres fitxers font de documentació. " -#: util/i18n.py:245 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Format de data no vàlid. Citeu la cadena amb cometes senzilles si voleu generar-la directament: %s" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Useu el Makefile per a construir els documents, com segueix:\n make builder" -#: util/docfields.py:103 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "Problema en el domini %s: se suposa que el camp usa el rol «%s», però no es troba en el domini." +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Useu l'ordre «sphinx-build» per a construir els documents, com segueix:\n sphinx-build -b constructor %s %s" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:538 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "%r està en desús per a les entrades d'índex (des de l'entrada %r). En el seu lloc useu «pair: %s»." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "on «constructor» és un dels constructors admesos, p. ex., html, latex o linkcheck." -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "el toctree conté una referència cap al fitxer %r que no existeix" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nGenereu els fitxers necessaris per a un projecte Sphinx.\n\n«sphinx-quickstart» és una eina interactiva que fa algunes preguntes sobre el\nprojecte i després genera un directori complet de documentació i un\nexemple del fitxer Makefile per a ser usat amb l'ordre «sphinx-build».\n" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "excepció mentre només s'avaluava l'expressió directiva: %s" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "mode silenciós" -#: util/display.py:82 -msgid "skipped" -msgstr "s'omet" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "arrel del projecte" -#: util/display.py:87 -msgid "failed" -msgstr "ha fallat" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Opcions de l'estructura" -#: util/osutil.py:131 +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "Si s'especifica, se separarà el codi font i els directoris de compilació" + +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "Si s'especifica, es crearà el directori de construcció a dins del directori d'origen" + +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "substitució per a punts a _templates, etc." + +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Opcions bàsiques del projecte" + +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "nom del projecte" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "noms de l'autoria" + +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "versió del projecte" + +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "llançament del projecte" + +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "idioma del document" + +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "sufix del fitxer font" + +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "nom del document mestre" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "usa epub" + +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Opcions de l'extensió" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "habilita l'extensió %s" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "habilita les extensions arbitràries" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Creació dels fitxers Makefile i de processament per lots" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "es crea el Makefile" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "no es crea el Makefile" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "es crea el fitxer de processament per lots" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "no es crea el fitxer de processament per lots" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "usa el mode make per a Makefile/make.bat" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Plantilles de projecte" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "directori de plantilles per als fitxers de plantilla" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "defineix una variable de plantilla" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "s'especifica «quiet», però no s'especifica cap «project» o «author»." + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "S'ha interromput l'intent de còpia des de %s a %s (hi ha dades existents al camí de destinació)." +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Error: el camí especificat no és un directori o ja hi ha els fitxers de Sphinx." + +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "«sphinx-quickstart» només generarà dins d'un directori buit. Especifiqueu un camí arrel nou." -#: util/docutils.py:309 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown directive name: %s" -msgstr "" +msgid "Invalid template variable: %s" +msgstr "Variable no vàlida de plantilla: %s" -#: util/docutils.py:345 +#: directives/other.py:119 #, python-format -msgid "unknown role name: %s" -msgstr "" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "El patró global toctree %r no coincideix amb cap document" -#: util/docutils.py:789 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "unknown node type: %r" -msgstr "tipus de node desconegut: %r" +msgid "toctree contains reference to excluded document %r" +msgstr "el toctree conté una referència cap al document exclòs %r" -#: util/fileutil.py:76 +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "el toctree conté una referència cap al document %r, el qual no existeix" + +#: directives/other.py:169 #, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "s'ha trobat una entrada duplicada en el toctree: %s" + +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autor de la secció:" + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autor del mòdul: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autor del codi: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "... el contingut dels reconeixements no és una llista" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "... el contingut de l'historial no és una llista" + +#: directives/patches.py:70 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "S'ha interromput l'intent de còpia des de la plantilla representada %s a %s (hi ha dades existents al camí de destinació)." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "«:file:» l'opció per a la directiva «csv-table» ara reconeix un camí absolut com a camí relatiu des del directori d'origen. Actualitzeu el vostre document." -#: util/fileutil.py:89 +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "cap espai en blanc eliminat en disminuir el sagnat" + +#: directives/code.py:87 #, python-format -msgid "Writing evaluated template result to %s" -msgstr "Escriu el resultat de la plantilla avaluada a %s" +msgid "Invalid caption: %s" +msgstr "Subtítol no vàlid: %s" -#: util/rst.py:73 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "default role %s not found" -msgstr "no s'ha trobat el rol predeterminat %s" +msgid "line number spec is out of range(1-%d): %r" +msgstr "l'especificació del número de línia queda fora de l'interval (1-%d): %r" -#: util/inventory.py:147 +#: directives/code.py:216 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "l'inventari <%s> conté definicions duplicades de %s" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "No es poden usar ambdues opcions «%s» i «%s»" -#: util/inventory.py:166 +#: directives/code.py:231 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "l'inventari <%s> conté múltiples definicions per a %s" +msgid "Include file '%s' not found or reading it failed" +msgstr "No s'ha trobat el fitxer d'inclusió «%s» o n'ha fallat la lectura" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Notes al peu" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "La codificació %r emprada per a llegir el fitxer d'inclusió «%s» sembla ser incorrecta, proveu indicant una opció :encoding:" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:276 #, python-format -msgid "[image: %s]" -msgstr "[imatge: %s]" +msgid "Object named %r not found in include file %r" +msgstr "L'objecte anomenat %r no es troba en el fitxer inclòs %r" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[imatge]" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "No podeu usar «lineno-match» amb un conjunt desarticulat de «línies»" + +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Línia específica %r: No hi ha cap línia llançada des del fitxer inclòs %r" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%-d %b, %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1747,11 +2293,15 @@ msgstr "[imatge]" msgid "Index" msgstr "Índex" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "el node del títol no s'ha trobat en la secció, tema, taula, advertiment o nota al marge" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Notes al peu" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "el subtítol no es troba dins d'una figura." @@ -1761,53 +2311,14 @@ msgstr "el subtítol no es troba dins d'una figura." msgid "unimplemented node type: %r" msgstr "tipus de node sense implementar: %r" -#: writers/latex.py:361 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "%r toplevel_sectioning desconegut per a la classe %r" +msgid "[image: %s]" +msgstr "[imatge: %s]" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "no es coneix l'opció de Babel per a l'idioma %r" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr ":maxdepth: massa gran, s'ignora." - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "no s'ha trobat la plantilla %s. En el seu lloc s'està carregant des del llegat %s" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "el títol del document no és només un node de text" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "nivell de capçalera de rúbrica no compatible: %s" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "s'indiquen tant les columnes tabulars com l'opció «:widths:». S'ignora l'opció «:widths:»." - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "la unitat de dimensió %s no és vàlida. S'ignora." - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "s'ha trobat el tipus d'entrada %s amb un índex desconegut" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "math_eqref_format no vàlid: %r" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[imatge]" #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" @@ -1835,6 +2346,11 @@ msgstr "Enllaça amb aquesta capçalera" msgid "Link to this table" msgstr "Enllaça amb aquesta taula" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "nivell de capçalera de rúbrica no compatible: %s" + #: writers/html5.py:636 msgid "Link to this code" msgstr "Enllaça amb aquest codi" @@ -1851,794 +2367,478 @@ msgstr "Enllaça amb aquest toctree" msgid "Could not obtain image size. :scale: option is ignored." msgstr "No s'ha pogut obtenir la mida de la imatge. S'ignora l'opció «:scale:»." -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "%r toplevel_sectioning desconegut per a la classe %r" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "etiqueta duplicada de l'equació %s, una altra instància a %s" +msgid "no Babel option known for language %r" +msgstr "no es coneix l'opció de Babel per a l'idioma %r" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (funció interna)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":maxdepth: massa gran, s'ignora." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (mètode %s)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "no s'ha trobat la plantilla %s. En el seu lloc s'està carregant des del llegat %s" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "el títol del document no és només un node de text" -#: domains/javascript.py:185 +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "s'indiquen tant les columnes tabulars com l'opció «:widths:». S'ignora l'opció «:widths:»." + +#: writers/latex.py:1228 #, python-format -msgid "%s() (class)" -msgstr "%s() (classe)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "S'ha donat colspec %s, el qual sembla usar la sintaxi tabular. Però aquesta taula no es pot representar com a tabular, el colspec donat s'ignorarà." -#: domains/javascript.py:187 +#: writers/latex.py:1615 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s (variable global o constant)" +msgid "dimension unit %s is invalid. Ignored." +msgstr "la unitat de dimensió %s no és vàlida. S'ignora." -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1950 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (atribut %s)" +msgid "unknown index entry type %s found" +msgstr "s'ha trobat el tipus d'entrada %s amb un índex desconegut" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Arguments" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "Ús:" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Llançaments" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "{0} [OPCIONS] []" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Retorna" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr " El generador de documentació Sphinx." -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Tipus de retorn" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "Ordres:" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (mòdul)" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "Opcions" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funció" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "Per a més informació, visiteu https://www.sphinx-doc.org/en/master/man/." -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "mètode" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "{0}: error: {1}\nPer a informació executeu «{0} --help»" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "classe" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr " Gestiona la documentació amb Sphinx." -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "dades" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "Mostra la versió i surt." -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atribut" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "Mostra aquest missatge i surt." -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "mòdul" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "Registre" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "descripció %s duplicada de %s, una altra %s a %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "Augmenta la verbositat (es pot repetir)" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "Afegit a la versió %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "Imprimeix només els errors i els avisos." -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Canviat a la versió %s" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "Cap sortida en absolut" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Obsolet des de la versió %s" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "S'ha eliminat a la versió %s" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "Vegeu «sphinx --help».\n" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (directiva)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "referències incoherents de nota al peu en el missatge traduït. Original: {0}, traduït: {1}" -#: domains/rst.py:191 domains/rst.py:202 +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "referències incoherents en el missatge traduït. Original: {0}, traduït: {1}" + +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "referències incoherents de citació en el missatge traduït. Original: {0}, traduït: {1}" + +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "referències incoherents de terme en el missatge traduït. Original: {0}, traduït: {1}" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "no s'ha pogut calcular el progrés de la traducció!" + +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "No hi ha cap element traduït!" + +#: transforms/__init__.py:258 #, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (opció de la directiva)" +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "S'ha trobat un índex basat en 4 columnes. Pot ser un error de les extensions que utilitzeu: %r" -#: domains/rst.py:224 +#: transforms/__init__.py:299 #, python-format -msgid "%s (role)" -msgstr "%s (rol)" +msgid "Footnote [%s] is not referenced." +msgstr "La nota al peu [%s] no té una referència." -#: domains/rst.py:234 -msgid "directive" -msgstr "directiva" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "No es fa referència a la nota al peu [*]." -#: domains/rst.py:235 -msgid "directive-option" -msgstr "opció_de_la_directiva" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "La nota al peu [núm.] no té una referència." -#: domains/rst.py:236 -msgid "role" -msgstr "rol" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "l'inventari <%s> conté definicions duplicades de %s" -#: domains/rst.py:262 +#: util/inventory.py:166 #, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "descripció duplicada del %s %s, una altra instància a %s" +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "l'inventari <%s> conté múltiples definicions per a %s" -#: domains/citation.py:75 +#: util/i18n.py:100 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "citació duplicada %s, una altra instància a %s" +msgid "reading error: %s, %s" +msgstr "error de lectura: %s, %s" -#: domains/citation.py:92 +#: util/i18n.py:113 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "No es fa referència a la citació [%s]." +msgid "writing error: %s, %s" +msgstr "error d'escriptura: %s, %s" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Atenció" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "locale_dir %s no existeix" -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Compte" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "La configuració regional «Babel» no és vàlida: %r." -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Perill" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Error" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Suggeriment" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Important" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Nota" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Vegeu també" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Truc" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Avís" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "insereix automàticament les docstring des dels mòduls" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "prova automàticament els fragments de codi en els blocs doctest" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "enllaç entre la documentació de Sphinx de projectes diferents" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "escriu les entrades «todo» que es poden mostrar o ocultar durant la construcció" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "comprovacions per a la cobertura de la documentació" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "inclou expressions matemàtiques, mostrades com a imatges PNG o SVG" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "inclou expressions matemàtiques, representades en el navegador per MathJax" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "inclusió condicional de contingut basat en els valors de la configuració" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "inclou els enllaços cap al codi font dels objectes documentats en Python" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "crea un fitxer .nojekyll per a publicar el document a les pàgines de GitHub" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Si us plau, introduïu un nom de camí vàlid." - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Si us plau, introduïu algun text." - -#: cmd/quickstart.py:133 +#: util/i18n.py:253 #, python-format -msgid "Please enter one of %s." -msgstr "Si us plau, introduïu un dels %s." - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Si us plau, introduïu qualsevol de «y» o «n»." - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Si us plau, introduïu un sufix de fitxer, p. ex., «.rst» o «.txt»." - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Us donem la benvinguda a la utilitat d'inici ràpid de Sphinx %s." - -#: cmd/quickstart.py:234 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Introduïu els valors per a les configuracions següents (només premeu «Retorn»\nper a acceptar un valor predeterminat, si se'n dona un entre parèntesis)." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Format de data no vàlid. Citeu la cadena amb cometes senzilles si voleu generar-la directament: %s" -#: cmd/quickstart.py:241 +#: util/osutil.py:131 #, python-format -msgid "Selected root path: %s" -msgstr "Camí arrel seleccionat: %s" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "Introduïu el camí arrel per a la documentació." - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Camí arrel per a la documentació" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Error: ja existeix un fitxer conf.py en el camí arrel seleccionat." - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "«sphinx-quickstart» no sobreescriurà els projectes de Sphinx existents." - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Introduïu un camí arrel nou (o premeu «Retorn» per a sortir)" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Teniu dues opcions per a col·locar el directori de construcció per a la\nsortida de Sphinx. O useu un directori «_build» dins del camí arrel,\no els directoris separats «source» i «build» dins del camí arrel." - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Separa els directoris «source» i «build» (s/n)" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "Dins del directori arrel, es crearan dos directoris més: «_templates» per a\nles plantilles HTML personalitzades i «_static» per als fulls d'estil\npersonalitzats i altres fitxers estàtics. Podeu introduir un altre prefix\n(com «.») per a substituir el guió baix." - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Prefix de nom per als directoris «templates» i «static»" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "El nom del projecte apareixerà en diversos llocs de la documentació construïda." - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Nom del projecte" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Noms de l'autoria" - -#: cmd/quickstart.py:308 msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "Sphinx té la noció d'una «versió» i un «llançament» per al programari.\nCada versió pot tenir múltiples versions. Per exemple, per a Python,\nla versió és una cosa semblant a 2.5 o 3.0, mentre que el llançament és\ncom 2.5.1 o 3.0a1. Si no necessiteu aquesta doble estructura, senzillament\nestabliu ambdues amb el mateix valor." - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Versió del projecte" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Llançament del projecte" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "Si els documents s'han d'escriure en un idioma que no sigui l'anglès,\npodeu seleccionar un idioma aquí per al vostre codi d'idioma.\nA continuació, Sphinx traduirà el text que es genera en aquest idioma.\n\nPer a obtenir una llista dels codis admesos, vegeu\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Idioma del projecte" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "El sufix del nom del fitxer per als fitxers d'origen. Normalment, aquest és\n«.txt» o «.rst». Només els fitxers amb aquest sufix es consideraran documents." - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Sufix del fitxer font" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "S'ha interromput l'intent de còpia des de %s a %s (hi ha dades existents al camí de destinació)." -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "Un document és especial perquè es considera el node superior de l'«arbre de\ncontingut», és a dir, és l'arrel de l'estructura jeràrquica dels documents.\nNormalment, es tracta de l'«index», però si el document «index» és una\nplantilla personalitzada, també podreu establir-la a un altre nom de fitxer." +#: util/display.py:82 +msgid "skipped" +msgstr "s'omet" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Nom del document mestre (sense sufix)" +#: util/display.py:87 +msgid "failed" +msgstr "ha fallat" -#: cmd/quickstart.py:367 +#: util/docutils.py:325 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Error: el fitxer mestre %s ja es troba en el camí arrel seleccionat." - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "«sphinx-quickstart» no sobreescriurà el fitxer existent." - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Introduïu un nom de fitxer nou o canvieu-ne el nom i premeu «Retorn»" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Indiqueu quines de les extensions següents de Sphinx haurien d'estar habilitades:" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Nota: «imgmath» i «mathjax» no es poden habilitar alhora. «imgmath» ha estat desseleccionat." - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Es pot generar un fitxer Makefile i un fitxer d'ordres de Windows,\nde manera que només haureu d'executar, p. ex., «make html»\nen lloc d'invocar directament «sphinx-build»." - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Voleu crear el Makefile? (s/n)" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Voleu crear el fitxer d'ordres de Windows? (s/n)" +msgid "unknown directive name: %s" +msgstr "nom desconegut de la directiva: %s" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: util/docutils.py:361 #, python-format -msgid "Creating file %s." -msgstr "S'està creant el fitxer %s." +msgid "unknown role name: %s" +msgstr "nom desconegut del rol: %s" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: util/docutils.py:805 #, python-format -msgid "File %s already exists, skipping." -msgstr "El fitxer %s ja existeix, se salta." - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Finalitzat: s'ha creat una estructura inicial del directori." +msgid "unknown node type: %r" +msgstr "tipus de node desconegut: %r" -#: cmd/quickstart.py:519 +#: util/fileutil.py:76 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "Ara heu de completar el fitxer mestre %s i crear altres fitxers font de documentació. " - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Useu el Makefile per a construir els documents, com segueix:\n make builder" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "S'ha interromput l'intent de còpia des de la plantilla representada %s a %s (hi ha dades existents al camí de destinació)." -#: cmd/quickstart.py:530 +#: util/fileutil.py:89 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Useu l'ordre «sphinx-build» per a construir els documents, com segueix:\n sphinx-build -b constructor %s %s" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "on «constructor» és un dels constructors admesos, p. ex., html, latex o linkcheck." - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nGenereu els fitxers necessaris per a un projecte Sphinx.\n\n«sphinx-quickstart» és una eina interactiva que fa algunes preguntes sobre el\nprojecte i després genera un directori complet de documentació i un\nexemple del fitxer Makefile per a ser usat amb l'ordre «sphinx-build».\n" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "Per a més informació, visiteu ." - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "mode silenciós" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "arrel del projecte" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Opcions de l'estructura" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "Si s'especifica, se separarà el codi font i els directoris de compilació" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "Si s'especifica, es crearà el directori de construcció a dins del directori d'origen" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "substitució per a punts a _templates, etc." - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Opcions bàsiques del projecte" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "nom del projecte" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "noms de l'autoria" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "versió del projecte" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "llançament del projecte" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "idioma del document" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "sufix del fitxer font" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "nom del document mestre" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "usa epub" - -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Opcions de l'extensió" +msgid "Writing evaluated template result to %s" +msgstr "Escriu el resultat de la plantilla avaluada a %s" -#: cmd/quickstart.py:670 +#: util/docfields.py:103 #, python-format -msgid "enable %s extension" -msgstr "habilita l'extensió %s" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "habilita les extensions arbitràries" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Creació dels fitxers Makefile i de processament per lots" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "es crea el Makefile" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "no es crea el Makefile" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "es crea el fitxer de processament per lots" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "no es crea el fitxer de processament per lots" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "usa el mode make per a Makefile/make.bat" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Plantilles de projecte" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "directori de plantilles per als fitxers de plantilla" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "defineix una variable de plantilla" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "s'especifica «quiet», però no s'especifica cap «project» o «author»." - -#: cmd/quickstart.py:785 msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Error: el camí especificat no és un directori o ja hi ha els fitxers de Sphinx." - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "«sphinx-quickstart» només generarà dins d'un directori buit. Especifiqueu un camí arrel nou." +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "Problema en el domini %s: se suposa que el camp usa el rol «%s», però no es troba en el domini." -#: cmd/quickstart.py:809 +#: util/rst.py:73 #, python-format -msgid "Invalid template variable: %s" -msgstr "Variable no vàlida de plantilla: %s" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "el número de treball hauria de ser un nombre positiu" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\nGenerar la documentació a partir dels fitxers font.\n\nL'eina «sphinx-build» generarà la documentació a partir dels fitxers\na SOURCEDIR i els situarà a OUTPUTDIR. Cerqueu el «conf.py» en el\nSOURCEDIR per als paràmetres de configuració. L'eina «sphinx-quickstart» es pot usar per a generar fitxers de plantilla, inclòs el «conf.py».\n\nL'eina «sphinx-build» pot crear documentació en formats diferents. A la\nlínia d'ordres se selecciona un format que especifica el nom del constructor.\nDe manera predeterminada és HTML. Els constructors també poden dur a terme\naltres tasques relacionades amb el processament de la documentació.\n\nDe manera predeterminada, es construeix tot el que està desactualitzat. Es pot\ngenerar la sortida només per als fitxers seleccionats especificant noms de fitxer\nindividuals.\n" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "camí cap als fitxers font de la documentació" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "camí cap al directori de sortida" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "(opcional) una llista de fitxers específics que s'han de reconstruir. S'ignorarà si s'especifica «--write-all»" - -#: cmd/build.py:114 -msgid "general options" -msgstr "opcions generals" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "constructor que s'usarà (predeterminat: «html»)" +msgid "default role %s not found" +msgstr "no s'ha trobat el rol predeterminat %s" -#: cmd/build.py:131 +#: util/nodes.py:462 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "executa en paral·lel amb N processos, quan sigui possible. «auto» uxa el nombre de nuclis de la CPU" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "escriu tots els fitxers (predeterminat: només escriu els fitxers nous i els que han canviat)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "no usar un entorn desat, llegeix sempre tots els fitxers" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "el toctree conté una referència cap al fitxer %r que no existeix" -#: cmd/build.py:150 -msgid "path options" -msgstr "opcions de camí" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "excepció mentre només s'avaluava l'expressió directiva: %s" -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "directori per als fitxers doctree i d'entorn (predeterminat: OUTPUT_DIR/.doctrees)" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "ve de la pàgina anterior" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "directori per al fitxer de configuració (conf.py) (predeterminat: SOURCE_DIR)" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "continua a la pàgina següent" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "no usa cap fitxer de configuració, només usa la configuració de les opcions de «-D»" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "No alfabètic" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "superposa una configuració en el fitxer de configuració" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Símbols" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "passa un valor a dins de les plantilles HTML" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Números" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "defineix l'etiqueta: inclou blocs «only» amb TAG" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "pàgina" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "mode primmirat: avisa sobre totes les referències que manquen" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Versió" -#: cmd/build.py:212 -msgid "console output options" -msgstr "opcions de sortida de la consola" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "No s'ha pogut recuperar la imatge remota: %s [%s]" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "augmenta la loquacitat (es pot repetir)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "No s'ha pogut recuperar la imatge remota: %s [%d]" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "sense sortida a la sortida estàndard, només avisos a la sortida d'error estàndard" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Format d'imatge desconegut: %s..." -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "sense sortida, ni tan sols els avisos" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "No s'ha pogut determinar el text alternatiu per a la referència creuada. Podria ser un error." -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "emet una sortida amb colors (predeterminada: detecció automàtica)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "s'ha trobat més d'una destinació per a «any» en la referència creuada %r: podria ser %s" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "no emetre una sortida amb colors (predeterminada: detecció automàtica)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s no es troba la destinació de la referència: %s" -#: cmd/build.py:252 -msgid "warning control options" -msgstr "opcions de control d'avís" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r no es troba la destinació de la referència: %s" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "escriviu els avisos (i errors) al fitxer indicat" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "S'ha interromput!" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "converteix els avisos en errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "Error de marcatge en el reStructuredText!" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "mostra la traça completa en excepció" +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "Error de codificació!" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "executa Pdb en excepció" +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "Error de recursivitat!" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "planteja una excepció sobre els avisos" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "Això pot passar amb fitxers font molt grans o molt imbricats. Podeu fer augmentar amb cura el límit predeterminat de la recursivitat de Python de 1.000 al «conf.py» amb, per exemple:" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "no es pot combinar l'opció -a i els noms de fitxer" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "S'està iniciant el depurador:" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" -msgstr "no es pot obrir el fitxer de l'avís «%s»: %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "S'ha desat la traça completa a:" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "l'argument de l'opció «-D» haurà d'estar en la forma «nom=valor»" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "Per a informar d'aquest error als desenvolupadors, obriu un problema a . Gràcies!" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "l'argument de l'opció -A haurà d'estar en la forma «nom=valor»" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Informeu-ho també si es tractava d'un error d'usuari, de manera que la pròxima vegada es pugui proporcionar un missatge d'error millor." #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Redueix la barra lateral" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Taula de continguts" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navegació" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Cerca dins de %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Quant a aquests documents" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Cerca" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Ves a" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Darrera actualització el %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Creada mitjançant Sphinx %(sphinx_version)s." + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Tema anterior" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "capítol anterior" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Tema següent" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "capítol següent" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "Índex – %(key)s" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Índex complet en una pàgina" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Aquesta pàgina" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Mostra el codi font" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Contingut" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Cerca ràpida" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Cercar a %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Ves a" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2685,7 +2885,7 @@ msgstr "Índex global de mòduls" msgid "quick access to all modules" msgstr "accés ràpid a tots els mòduls" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Índex general" @@ -2693,23 +2893,15 @@ msgstr "Índex general" msgid "all functions, classes, terms" msgstr "totes les funcions, classes, termes" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Aquesta pàgina" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Taula de continguts" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "Índex – %(key)s" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Índex complet en una pàgina" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Cerca ràpida" +msgid "Search %(docstitle)s" +msgstr "Cercar a %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2719,57 +2911,6 @@ msgstr "Pàgines d'índex per lletra" msgid "can be huge" msgstr "pot ser gegant" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Tema anterior" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "capítol anterior" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Tema següent" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "capítol següent" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navegació" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Cerca dins de %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Quant a aquests documents" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "© %(copyright_prefix)s %(copyright)s." - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Darrera actualització el %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Creada mitjançant Sphinx %(sphinx_version)s." - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2786,21 +2927,21 @@ msgstr "Cercar múltiples paraules només mostrarà les coincidències\n que msgid "search" msgstr "cerca" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Oculta els resultats de cerca" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Contingut" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Resultats de la cerca" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "La vostra cerca no ha coincidit amb cap document. Assegureu-vos que s'escriuen correctament totes les paraules i que heu seleccionat prou categories." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2808,22 +2949,21 @@ msgid_plural "" msgstr[0] "La cerca ha acabat, s'ha trobat una pàgina que coincideix amb la consulta de cerca." msgstr[1] "La cerca ha acabat, s'han trobat ${resultCount} pàgines que coincideixen amb la consulta de cerca." -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "S'està cercant" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "S'està preparant la cerca..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", a " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Oculta els resultats de cerca" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2831,6 +2971,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Canvis en la versió %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2852,120 +2997,127 @@ msgstr "Altres canvis" msgid "Expand sidebar" msgstr "Expandeix la barra lateral" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" -msgstr "" +msgstr "Separador de paràmetres només posicional (PEP 570)" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" -msgstr "" +msgstr "Separador de paràmetres només posicional (PEP 3102)" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Paràmetres" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variables" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Llença" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (al mòdul %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (al mòdul %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (variable interna)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (classe interna)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (classe a %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (mètode de classe %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (mètode estàtic %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (propietat %s)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "%s (escriviu l'àlies a %s)" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Índex de mòduls en Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "mòduls" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Obsolet" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "excepció" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "mètode de classe" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "mètode estàtic" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "propietat" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "escriviu l'àlies" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "descripció de l'objecte duplicat de %s, una altra instància a %s, ús «:no-index:» per a un d'ells" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "s'ha trobat més d'un objectiu per a la referència creuada %r: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (obsolet)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Paràmetres" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variables" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Llença" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "Declaració de C** duplicada, també definida a %s:%s.\nLa declaració és «.. cpp:%s:: %s»." #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2976,92 +3128,85 @@ msgstr "Paràmetres de la plantilla" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "Declaració de C** duplicada, també definida a %s:%s.\nLa declaració és «.. cpp:%s:: %s»." - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "Valors retornats" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "unió" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "membre" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tipus" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "concepte" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enumera" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "numerador" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "paràmetre de la funció" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "paràmetre de la plantilla" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Declaració de C duplicada, també definida a %s:%s.\nLa declaració és «.. c:%s:: %s»." -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "variable" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "macro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "estructura" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "variable d'entorn; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "%s; valor de configuració" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "Tipus" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "Predeterminat" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3148,522 +3293,430 @@ msgstr "numfig_format no vàlid: %s" #: domains/std/__init__.py:1453 #, python-format -msgid "undefined label: %r" -msgstr "etiqueta sense definir: %r" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "Ha fallat en crear una referència creuada. No es troba un títol o subtítol: %r" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "s'han detectat referències circulars del toctree, s'ignora: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "el toctree conté una referència cap al document %r, el qual no conté un títol: no es generarà cap enllaç" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "el toctree conté una referència cap a un document no inclòs %r" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "vegeu %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "vegeu també %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "tipus d'entrada %r amb un índex desconegut" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Símbols" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "el fitxer d'imatge no es pot llegir: %s" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "el fitxer d'imatge %s no es pot llegir: %s" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "el fitxer de baixada no es pot llegir: %s" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s ja té assignats números de secció (toctree amb numeració imbricada?)" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "S'ha interromput!" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "S'ha desat la traça completa a:" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "Per a informar d'aquest error als desenvolupadors, obriu un problema a . Gràcies!" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Informeu-ho també si es tractava d'un error d'usuari, de manera que la pròxima vegada es pugui proporcionar un missatge d'error millor." - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "No s'ha pogut determinar el text alternatiu per a la referència creuada. Podria ser un error." - -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "s'ha trobat més d'una destinació per a «any» en la referència creuada %r: podria ser %s" - -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s no es troba la destinació de la referència: %s" - -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "%r no es troba la destinació de la referència: %s" +msgid "undefined label: %r" +msgstr "etiqueta sense definir: %r" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "No s'ha pogut recuperar la imatge remota: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "Ha fallat en crear una referència creuada. No es troba un títol o subtítol: %r" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "No s'ha pogut recuperar la imatge remota: %s [%d]" +msgid "invalid value set (missing closing brace): %s" +msgstr "conjunt de valors no vàlid (manca el claudàtor de tancament): %s" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." -msgstr "Format d'imatge desconegut: %s..." +msgid "invalid value set (missing opening brace): %s" +msgstr "conjunt de valors no vàlid (manca el claudàtor d'obertura): %s" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "Les pàgines en HTML es troben a %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" +msgstr "Cadena incorrecta literal (manquen les cometes de tancament): %s" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" -msgstr "Ha fallat en llegir el fitxer d'informació de la construcció: %r" +msgid "malformed string literal (missing opening quote): %s" +msgstr "Cadena incorrecta literal (manquen les cometes d'obertura): %s" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "build_info no coincideix, s'està copiant .buildinfo a .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Exemple" -#: builders/html/__init__.py:366 -msgid "building [html]: " -msgstr "es construeix [html]:" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Exemples" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "s'ha canviat la plantilla %s des de la compilació anterior, es reconstruiran tots els documents" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Arguments de paraules clau" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "índex" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Notes" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "Logotip de %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Altres paràmetres" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "següent" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "Rebudes" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "anterior" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Referències" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "s'estan generant els índexs" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Avisos" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "s'estan escrivint les pàgines addicionals" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "Rendiments" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "no es pot copiar el fitxer d'imatge «%s»: %s" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "s'estan copiant els fitxers que es poden baixar... " +msgid "A mocked object is detected: %r" +msgstr "S'ha detectat un objecte simulat: %r" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "no s'ha pogut copiar el fitxer que es podia baixar %r: %s" +msgid "alias of %s" +msgstr "àlies de %s" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "Ha fallat en copiar un fitxer al directori «static» del tema: %s: %r" +msgid "Bases: %s" +msgstr "Bases: %s" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "Ha fallat en copiar un fitxer a html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" +msgstr "valor no vàlid per a l'opció de l'ordre de membre: %s" -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "s'estan copiant els fitxers estàtics" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "valor no vàlid per a l'opció des de la documentació de classes: %s" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" -msgstr "no s'ha pogut copiar el fitxer estàtic %r" +msgid "invalid signature for auto%s (%r)" +msgstr "signatura no vàlida per a auto%s (%r)" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "s'estan copiant els fitxers addicionals" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "es desconeix quin és el mòdul que s'importarà per al document automàtic %r (proveu de col·locar una directiva «module» o «currentmodule» en el document o doneu-li un nom explícit al mòdul)" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" -msgstr "no s'ha pogut copiar el fitxer addicional %r" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" -msgstr "Ha fallat en escriure el fitxer d'informació de la construcció: %r" +msgid "return annotation given for automodule: '%s'" +msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "no s'ha pogut carregar l'índex de cerca, i no es construiran tots els documents: l'índex estarà incomplet." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "«::» en el nom de l'«automodule» no té sentit" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "la pàgina %s coincideix amb dos patrons a html_sidebars: %r i %r" +msgid "Failed to remove %s: %s" +msgstr "S'ha fallat en eliminar %s: %s" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "S'hauria de crear el fitxer %s." + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "s'ha produït un error d'Unicode en representar la pàgina %s. Assegureu-vos que tots els valors de configuració que contenen contingut que no és ASCII són cadenes Unicode." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nMireu recursivament a per als mòduls i paquets de Python\ni creeu un fitxer reST amb les directives «automodule» per paquet en el .\n\nEls poden ser fitxers i/o patrons de directori que seran\nexclosos de la generació.\n\nNota: De manera predeterminada, aquest script no sobreescriurà els fitxers que ja s'han creat." -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "camí cap al mòdul que es documenta" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "S'ha produït un error en representar la pàgina %s.\nMotiu: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "fitxer d'estil fnmatch i/o patrons de directori que s'exclouran de la generació" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "s'està bolcant l'inventari d'objectes" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "directori per a col·locar tota la sortida" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "s'està bolcant l'índex de cerca a %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "profunditat màxima dels submòduls que es mostraran a la TOC (predeterminada: 4)" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "js_file no vàlid: %r, s'ignora" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "sobreescriu els fitxers existents" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "S'han enregistrat molts math_renderer. Però no s'ha seleccionat math_renderer." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "seguir els enllaços simbòlics. Potent quan es combina amb el paquet collective.recipe.omelette." -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "S'ha donat un math_renderer %r desconegut." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "executa l'script sense crear els fitxers" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "l'entrada html_extra_path %r es col·loca dins del directori de sortida" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "posa la documentació per a cada mòdul a la seva pròpia pàgina" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "l'entrada html_extra_path %r no existeix" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "inclou «_private» en els mòduls" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "l'entrada html_static_path %r es col·loca dins del directori de sortida" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "nom de fitxer de la taula de contingut (predeterminat: mòduls)" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" -msgstr "l'entrada html_static_path %r no existeix" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "no crea un fitxer de taula de contingut" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "el fitxer de logotip %r no existeix" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "no crea capçaleres per als paquets del mòdul/paquet (p. ex., quan les cadenes de documentació ja les contenen)" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" -msgstr "el fitxer icona de web %r no existeix" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "posa la documentació del mòdul abans de la documentació del submòdul" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." -msgstr "Els valors a «html_sidebars» han de ser una llista de cadenes. Almenys un patró té un valor de cadena: %s. Canvia a «html_sidebars = %r»." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "interpreta els camins dels mòduls segons l'especificació d'espais de noms implícits al PEP-0420" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "HTML 4 ja no és compatible amb Sphinx. (s'ha detectat «html4_writer=true» a les opcions de configuració)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "Llista d'opcions separades per comes que es passarà a la directiva «automodule» (o useu SPHINX_APIDOC_OPTIONS)." -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" -msgstr "%s %s documentació" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "sufix del fitxer (predeterminat: rst)" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" -msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (versió desconeguda)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "Elimina els fitxers existents al directori de sortida que no s'hagin generat" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" -msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (manca l'entrada «config»)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "genera un projecte complet amb «sphinx-quickstart»" + +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "afegeix module_path a sys.path, s'usa quan s'indica el paràmetre «--full»" + +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "nom del projecte (predeterminat: nom del mòdul arrel)" + +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "autoria del projecte, s'usa quan s'indica el paràmetre «--full»" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" -msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (manca l'entrada «tags»)" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "versió del projecte, s'usa quan s'indica el paràmetre «--full»" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Els fitxers en LaTeX es troben a %(outdir)s." +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "llançament del projecte, s'usa quan s'indica el paràmetre «--full», predeterminat a «--doc-version»" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nExecuteu l'ordre «make» en aquest directori per a executar-les\nmitjançant el (pdf)latex (useu l'ordre «make latexpdf» per a fer-ho\nautomàticament)." +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "opcions de l'extensió" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "no s'ha trobat el valor de configuració «latex_documents»: no s'escriurà cap document" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "habilita les extensions arbitràries, que s'usen quan s'indica «--full»" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "El valor de configuració «latex_documents» fa referència a un document %s desconegut" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Versió" +msgid "enable %s extension, used when --full is given" +msgstr "habilita l'extensió %s, que s'usa quan s'indica «--full»" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "s'estan copiant els fitxers de suport de TeX" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "%s no és cap directori." -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "s'estan copiant els fitxers addicionals" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "S'està executant apidoc" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "Clau de configuració desconeguda: latex_elements[%r], s'ignora." +msgid "apidoc_modules item %i must be a dict" +msgstr "«apidoc_modules» l'element %i ha de ser un diccionari" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "Opció desconeguda de tema: latex_theme_options[%r], s'ignora." - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" -msgstr "Ha fallat en obtenir el docname!" +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "«apidoc_modules» l'element %i ha de tenir una clau «path»." -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" -msgstr "S'ha fallat en obtenir un nom de document per a la font %r!" +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "«apidoc_modules» l'element «path» %i ha de ser una cadena" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" -msgstr "No s'ha trobat cap nota a peu de pàgina per al node de referència %r donat" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "«apidoc_modules» l'element «path» %i no és una carpeta existent: %s" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r no té la configuració «theme»" +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "«apidoc_modules» l'element %i ha de tenir una clau «destination»" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r no té la configuració «%s»" +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "«apidoc_modules» l'element «destination» %i ha de ser una cadena" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "ve de la pàgina anterior" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "«apidoc_modules» l'element «destination» %i hauria de ser un camí relatiu" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "continua a la pàgina següent" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "«apidoc_modules» l'element %i no pot crear el directori de destinació: %s" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "No alfabètic" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "«apidoc_modules» l'element %i «%s» ha de ser un nombre enter" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Números" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "«apidoc_modules» l'element %i «%s» ha de ser un booleà" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "pàgina" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "«apidoc_modules» l'element %i té claus inesperades: %s" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Arguments de paraules clau" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "«apidoc_modules» l'element %i «%s» ha de ser una seqüència" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "conjunt de valors no vàlid (manca el claudàtor de tancament): %s" +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "«apidoc_modules» l'element %i «%s» ha de contenir cadenes" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "conjunt de valors no vàlid (manca el claudàtor d'obertura): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "autosummary: ha fallat en determinar %r que s'ha de documentar, s'ha plantejat l'excepció següent:\n%s" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "Cadena incorrecta literal (manquen les cometes de tancament): %s" +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] s'està generant autosummary per a: %s" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "Cadena incorrecta literal (manquen les cometes d'obertura): %s" +msgid "[autosummary] writing to %s" +msgstr "[autosummary] s'està escrivint a %s" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Exemple" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "[autosummary]: ha fallat en importar %s.\nPossibles pistes:\n%s" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Exemples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nGenera ReStructuredText mitjançant directrius de resum automàtic «autosummary».\n\n«sphinx-autogen» és un frontal per a sphinx.ext.autosummary.generate.\nGenera els fitxers en reStructuredText des de les directrius d'autosummary\ncontingudes en els fitxers d'entrada indicats.\n\nEl format de les directrius d'autosummary està documentat en el mòdul\n``sphinx.ext.autosummary`` de Python i es pot llegir mitjançant l'ordre següent::\n\npydoc sphinx.ext.autosummary\n" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "fitxers font per a generar els fitxers rST per a" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Altres paràmetres" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "directori per a col·locar tota la sortida a" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "Rebudes" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "sufix predeterminat per als fitxers (predeterminat: %(default)s)" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Referències" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "directori de plantilles personalitzades (predeterminat: %(default)s)" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Avisos" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "document de membres importats (predeterminat: %(default)s)" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "Rendiments" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "documenta exactament els membres en l'atribut __all__ del mòdul (predeterminat: %(default)s)." -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "referències autosummary excloses del document %r. S'ignora." -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: no s'ha trobat el fitxer stub %r. Verifiqueu la vostra configuració autosummary_generate." -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "Un resum automàtic amb subtítols requereix l'opció «:toctree:». S'ignora." -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3671,548 +3724,585 @@ msgid "" "%s" msgstr "autosummary: ha fallat en importar %s.\nPossibles pistes:\n%s" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "ha fallat en analitzar el nom %s" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "ha fallat en importar l'objecte %s" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "Els elements resumits no han d'incloure el mòdul actual. Substituïu %r per %r." -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: no s'ha trobat el fitxer: %s" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "«autosummary» genera internament els fitxers «.rst». Però el vostre source_suffix no conté cap «.rst». S'omet." -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "autosummary: ha fallat en determinar %r que s'ha de documentar, s'ha plantejat l'excepció següent:\n%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "L'identificador «%r» del projecte intersphinx no és vàlid a intersphinx_mapping. Els identificadors de projecte han de ser cadenes no buides." -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[autosummary] s'està generant autosummary per a: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "El valor «%r» no és vàlid a intersphinx_mapping[%r]. S'esperava una tupla o llista de dos elements." -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[autosummary] s'està escrivint a %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "El valor «%r» no és vàlid a intersphinx_mapping[%r]. Els valors han de ser un parell (URI de destinació, ubicacions de l'inventari)." -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "[autosummary]: ha fallat en importar %s.\nPossibles pistes:\n%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "El valor «%r» de l'URI de destinació no és vàlid a intersphinx_mapping[%r][0]. Els URI de destinació han de ser cadenes úniques no buides." -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nGenera ReStructuredText mitjançant directrius de resum automàtic «autosummary».\n\n«sphinx-autogen» és un frontal per a sphinx.ext.autosummary.generate.\nGenera els fitxers en reStructuredText des de les directrius d'autosummary\ncontingudes en els fitxers d'entrada indicats.\n\nEl format de les directrius d'autosummary està documentat en el mòdul\n``sphinx.ext.autosummary`` de Python i es pot llegir mitjançant l'ordre següent::\n\npydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "El valor «%r» de l'URI de destinació no és vàlid a intersphinx_mapping[%r][0]. Els URI de destinació han de ser únics (una altra instància a intersphinx_mapping[%r])." -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "fitxers font per a generar els fitxers rST per a" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "El valor «%r» d'ubicació de l'inventari no és vàlid a intersphinx_mapping[%r][1]. Les ubicacions de l'inventari han de ser cadenes no buides o «None»." -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "directori per a col·locar tota la sortida a" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "Configuració d'«intersphinx_mapping» no vàlida (1 error)." -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "sufix predeterminat per als fitxers (predeterminat: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "Configuració d'«intersphinx_mapping» no vàlida (%s errors)." + +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "S'ha afegit una entrada intersphinx_mapping no vàlida després de la normalització." + +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "s'està carregant l'inventari intersphinx «%s» de %s ..." + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "s'han trobat alguns problemes amb alguns dels inventaris, però tenien alternatives funcionals:" + +#: ext/intersphinx/_load.py:332 +#, python-format +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "directori de plantilles personalitzades (predeterminat: %(default)s)" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "s'ha mogut l'inventari intersphinx: %s -> %s" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "document de membres importats (predeterminat: %(default)s)" +msgid "(in %s %s)" +msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "documenta exactament els membres en l'atribut __all__ del mòdul. (predeterminat: %(default)s)" +msgid "(in %s)" +msgstr "(a %s)" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" -msgstr "Elimina els fitxers existents al directori de sortida que no s'hagin generat" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "inventari «%s»: s'han trobat coincidències duplicades per a %s:%s" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Failed to remove %s: %s" -msgstr "S'ha fallat en eliminar %s: %s" +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "inventari «%s»: s'han trobat múltiples coincidències per a %s:%s" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nMireu recursivament a per als mòduls i paquets de Python\ni creeu un fitxer reST amb les directives «automodule» per paquet en el .\n\nEls poden ser fitxers i/o patrons de directori que seran\nexclosos de la generació.\n\nNota: De manera predeterminada, aquest script no sobreescriurà els fitxers que ja s'han creat." +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "no es troba l'inventari per a la referència creuada externa: %r" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "camí cap al mòdul que es documenta" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "no es troba l'inventari per a la referència creuada externa: %r" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "fitxer d'estil fnmatch i/o patrons de directori que s'exclouran de la generació" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "no es troba el domini per a la referència creuada externa: %r" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "directori per a col·locar tota la sortida" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "%s externa: no es troba la destinació de la referència %s: %s" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "profunditat màxima dels submòduls que es mostraran a la TOC (predeterminada: 4)" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "error mentre es donava format a la signatura per a %s: %s" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "sobreescriu els fitxers existents" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "seguir els enllaços simbòlics. Potent quan es combina amb el paquet collective.recipe.omelette." +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "Ha fallat en obtenir una signatura de funció per a %s: %s" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "executa l'script sense crear els fitxers" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "Ha fallat en actualitzar la signatura per a %r: no es troba el paràmetre: %s" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "posa la documentació per a cada mòdul a la seva pròpia pàgina" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "Ha fallat en analitzar type_comment per a %r: %s" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "inclou «_private» en els mòduls" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "S'han trobat __slots__ no vàlids a %s. S'ignora." -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "nom de fitxer de la taula de contingut (predeterminat: mòduls)" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "error mentre es donava format als arguments per a %s: %s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "no crea un fitxer de taula de contingut" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "Ha fallat en obtenir un constructor de funció per a %s: %s" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "no crea capçaleres per als paquets del mòdul/paquet (p. ex., quan les cadenes de documentació ja les contenen)" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "Ha fallat en obtenir una signatura de mètode per a %s: %s" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "posa la documentació del mòdul abans de la documentació del submòdul" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "interpreta els camins dels mòduls segons l'especificació d'espais de noms implícits al PEP-0420" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "Ha fallat en analitzar un valor d'argument predeterminat per a %r: %s" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "sufix del fitxer (predeterminat: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "autodoc: ha fallat en determinar %s. %s (%r) que s'ha de documentar, s'ha plantejat l'excepció següent:\n%s" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "genera un projecte complet amb «sphinx-quickstart»" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "arguments de signatura o anotació de retorn indicats per a «automodule» %s" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "afegeix module_path a sys.path, s'usa quan s'indica el paràmetre «--full»" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ ha de ser una llista de cadenes, no %r (en el mòdul %s) -s'ignora __all__-" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "nom del projecte (predeterminat: nom del mòdul arrel)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "manca l'atribut esmentat a l'opció «:members:»: mòdul %s, atribut %s" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "autoria del projecte, s'usa quan s'indica el paràmetre «--full»" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "manca l'atribut %s a l'objecte %s" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "versió del projecte, s'usa quan s'indica el paràmetre «--full»" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "àlies de TypeVar(%s)" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "llançament del projecte, s'usa quan s'indica el paràmetre «--full», predeterminat a «--doc-version»" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (versió desconeguda)" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "opcions de l'extensió" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (manca l'entrada «config»)" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" -msgstr "" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (manca l'entrada «tags»)" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "Les pàgines en HTML es troben a %(outdir)s." -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." -msgstr "%s no és cap directori." - -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" -msgstr "" +msgid "Failed to read build info file: %r" +msgstr "Ha fallat en llegir el fitxer d'informació de la construcció: %r" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" -msgstr "" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "build_info no coincideix, s'està copiant .buildinfo a .buildinfo.bak" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" -msgstr "" +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "es construeix [html]:" -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" -msgstr "" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "s'ha canviat la plantilla %s des de la compilació anterior, es reconstruiran tots els documents" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" -msgstr "" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "índex" -#: ext/apidoc/_extension.py:133 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +msgid "Logo of %s" +msgstr "Logotip de %s" -#: ext/apidoc/_extension.py:140 -#, python-format -msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "següent" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "anterior" -#: ext/apidoc/_extension.py:157 -#, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" -msgstr "" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "s'estan generant els índexs" -#: ext/apidoc/_extension.py:178 -#, python-format -msgid "apidoc_modules item %i '%s' must be an int" -msgstr "" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "s'estan escrivint les pàgines addicionals" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +msgid "cannot copy image file '%s': %s" +msgstr "no es pot copiar el fitxer d'imatge «%s»: %s" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" -msgstr "" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "s'estan copiant els fitxers que es poden baixar... " -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "no s'ha pogut copiar el fitxer que es podia baixar %r: %s" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgstr "Ha fallat en copiar un fitxer al directori «static» del tema: %s: %r" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:871 #, python-format -msgid "Would create file %s." -msgstr "S'hauria de crear el fitxer %s." +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "Ha fallat en copiar un fitxer a html_static_file: %s: %r" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s v%s)" -msgstr "(a %s versió %s)" +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "s'estan copiant els fitxers estàtics" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:923 #, python-format -msgid "(in %s)" -msgstr "(a %s)" +msgid "cannot copy static file %r" +msgstr "no s'ha pogut copiar el fitxer estàtic %r" -#: ext/intersphinx/_resolve.py:108 -#, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "inventari «%s»: s'han trobat coincidències duplicades per a %s:%s" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "s'estan copiant els fitxers addicionals" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:938 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "inventari «%s»: s'han trobat múltiples coincidències per a %s:%s" +msgid "cannot copy extra file %r" +msgstr "no s'ha pogut copiar el fitxer addicional %r" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:944 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "no es troba l'inventari per a la referència creuada externa: %r" +msgid "Failed to write build info file: %r" +msgstr "Ha fallat en escriure el fitxer d'informació de la construcció: %r" -#: ext/intersphinx/_resolve.py:392 -#, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "no es troba l'inventari per a la referència creuada externa: %r" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "no s'ha pogut carregar l'índex de cerca, i no es construiran tots els documents: l'índex estarà incomplet." -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:1038 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "no es troba el domini per a la referència creuada externa: %r" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "la pàgina %s coincideix amb dos patrons a html_sidebars: %r i %r" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1204 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "%s externa: no es troba la destinació de la referència %s: %s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "s'ha produït un error d'Unicode en representar la pàgina %s. Assegureu-vos que tots els valors de configuració que contenen contingut que no és ASCII són cadenes Unicode." -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "L'identificador «%r» del projecte intersphinx no és vàlid a intersphinx_mapping. Els identificadors de projecte han de ser cadenes no buides." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" +msgstr "El tema «%s» no admet aquesta versió de Sphinx, perquè usa el camp «style» a les plantilles HTML, el qual és obsolet a Sphinx 5.1 i s'ha eliminat a Sphinx 7.0. El tema s'ha d'actualitzar per a usar en el seu lloc el camp «styles». Vegeu https://www.sphinx-doc.org/en/master/development/html_themes/templating.html#styles" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "El valor «%r» no és vàlid a intersphinx_mapping[%r]. S'esperava una tupla o llista de dos elements." +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "S'ha produït un error en representar la pàgina %s.\nMotiu: %r" + +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "s'està bolcant l'inventari d'objectes" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1266 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "El valor «%r» no és vàlid a intersphinx_mapping[%r]. Els valors han de ser un parell (URI de destinació, ubicacions de l'inventari)." +msgid "dumping search index in %s" +msgstr "s'està bolcant l'índex de cerca a %s" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "El valor «%r» de l'URI de destinació no és vàlid a intersphinx_mapping[%r][0]. Els URI de destinació han de ser cadenes úniques no buides." +msgid "invalid js_file: %r, ignored" +msgstr "js_file no vàlid: %r, s'ignora" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "S'han enregistrat molts math_renderer. Però no s'ha seleccionat math_renderer." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "El valor «%r» de l'URI de destinació no és vàlid a intersphinx_mapping[%r][0]. Els URI de destinació han de ser únics (una altra instància a intersphinx_mapping[%r])." +msgid "Unknown math_renderer %r is given." +msgstr "S'ha donat un math_renderer %r desconegut." + +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "l'entrada html_extra_path %r es col·loca dins del directori de sortida" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "El valor «%r» d'ubicació de l'inventari no és vàlid a intersphinx_mapping[%r][1]. Les ubicacions de l'inventari han de ser cadenes no buides o «None»." +msgid "html_extra_path entry %r does not exist" +msgstr "l'entrada html_extra_path %r no existeix" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "Configuració d'«intersphinx_mapping» no vàlida (1 error)." +#: builders/html/__init__.py:1385 +#, python-format +msgid "html_static_path entry %r is placed inside outdir" +msgstr "l'entrada html_static_path %r es col·loca dins del directori de sortida" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1390 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "Configuració d'«intersphinx_mapping» no vàlida (%s errors)." +msgid "html_static_path entry %r does not exist" +msgstr "l'entrada html_static_path %r no existeix" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "S'ha afegit una entrada intersphinx_mapping no vàlida després de la normalització." +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 +#, python-format +msgid "logo file %r does not exist" +msgstr "el fitxer de logotip %r no existeix" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1412 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "s'està carregant l'inventari intersphinx «%s» de %s ..." +msgid "favicon file %r does not exist" +msgstr "el fitxer icona de web %r no existeix" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1425 +#, python-format msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "s'han trobat alguns problemes amb alguns dels inventaris, però tenien alternatives funcionals:" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." +msgstr "Els valors a «html_sidebars» han de ser una llista de cadenes. Almenys un patró té un valor de cadena: %s. Canvia a «html_sidebars = %r»." -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "s'ha fallat en arribar a cap dels inventaris amb els problemes següents:" +#: builders/html/__init__.py:1438 +msgid "" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "HTML 4 ja no és compatible amb Sphinx. (s'ha detectat «html4_writer=true» a les opcions de configuració)" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "s'ha mogut l'inventari intersphinx: %s -> %s" +msgid "%s %s documentation" +msgstr "%s %s documentació" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "valor no vàlid per a l'opció de l'ordre de membre: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r no té la configuració «theme»" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "valor no vàlid per a l'opció des de la documentació de classes: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r no té la configuració «%s»" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "signatura no vàlida per a auto%s (%r)" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "Ha fallat en obtenir el docname!" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "error mentre es donava format als arguments per a %s: %s" +msgid "Failed to get a docname for source %r!" +msgstr "S'ha fallat en obtenir un nom de document per a la font %r!" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "autodoc: ha fallat en determinar %s. %s (%r) que s'ha de documentar, s'ha plantejat l'excepció següent:\n%s" +msgid "No footnote was found for given reference node %r" +msgstr "No s'ha trobat cap nota a peu de pàgina per al node de referència %r donat" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Els fitxers en LaTeX es troben a %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "es desconeix quin és el mòdul que s'importarà per al document automàtic %r (proveu de col·locar una directiva «module» o «currentmodule» en el document o doneu-li un nom explícit al mòdul)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nExecuteu l'ordre «make» en aquest directori per a executar-les\nmitjançant el (pdf)latex (useu l'ordre «make latexpdf» per a fer-ho\nautomàticament)." -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" -msgstr "S'ha detectat un objecte simulat: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "no s'ha trobat el valor de configuració «latex_documents»: no s'escriurà cap document" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "error mentre es donava format a la signatura per a %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "El valor de configuració «latex_documents» fa referència a un document %s desconegut" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "«::» en el nom de l'«automodule» no té sentit" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "s'estan copiant els fitxers de suport de TeX" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "arguments de signatura o anotació de retorn indicats per a «automodule» %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "s'estan copiant els fitxers addicionals" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ ha de ser una llista de cadenes, no %r (en el mòdul %s) -s'ignora __all__-" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Clau de configuració desconeguda: latex_elements[%r], s'ignora." -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "manca l'atribut esmentat a l'opció «:members:»: mòdul %s, atribut %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "Opció desconeguda de tema: latex_theme_options[%r], s'ignora." -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "Ha fallat en obtenir una signatura de funció per a %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s ja té assignats números de secció (toctree amb numeració imbricada?)" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "Ha fallat en obtenir un constructor de funció per a %s: %s" +msgid "image file not readable: %s" +msgstr "el fitxer d'imatge no es pot llegir: %s" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" -msgstr "Bases: %s" +msgid "image file %s not readable: %s" +msgstr "el fitxer d'imatge %s no es pot llegir: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" -msgstr "manca l'atribut %s a l'objecte %s" +msgid "download file not readable: %s" +msgstr "el fitxer de baixada no es pot llegir: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" -msgstr "àlies de %s" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "s'han detectat referències circulars del toctree, s'ignora: %s <- %s" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "àlies de TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "el toctree conté una referència cap al document %r, el qual no conté un títol: no es generarà cap enllaç" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "Ha fallat en obtenir una signatura de mètode per a %s: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "el toctree conté una referència cap a un document no inclòs %r" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "S'han trobat __slots__ no vàlids a %s. S'ignora." +msgid "toctree contains reference to non-existing document %r" +msgstr "el toctree conté una referència cap al document inexistent %r" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "Ha fallat en analitzar un valor d'argument predeterminat per a %r: %s" +msgid "see %s" +msgstr "vegeu %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "Ha fallat en actualitzar la signatura per a %r: no es troba el paràmetre: %s" +msgid "see also %s" +msgstr "vegeu també %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "Ha fallat en analitzar type_comment per a %r: %s" +msgid "unknown index entry type %r" +msgstr "tipus d'entrada %r amb un índex desconegut" diff --git a/sphinx/locale/ca@valencia/LC_MESSAGES/sphinx.mo b/sphinx/locale/ca@valencia/LC_MESSAGES/sphinx.mo index d7be7306ce7..8e90d9aa4c4 100644 Binary files a/sphinx/locale/ca@valencia/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ca@valencia/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/ca@valencia/LC_MESSAGES/sphinx.po b/sphinx/locale/ca@valencia/LC_MESSAGES/sphinx.po index 2909dbbe74a..d92dfebf112 100644 --- a/sphinx/locale/ca@valencia/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/ca@valencia/LC_MESSAGES/sphinx.po @@ -4,14 +4,16 @@ # # Translators: # Adam Turner, 2023 +# Antoni Bella Pérez , 2025 +# FIRST AUTHOR , 2009 # Pau Fernández , 2009 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" -"Last-Translator: Pau Fernández , 2009\n" +"Last-Translator: Antoni Bella Pérez , 2025\n" "Language-Team: Catalan (Valencian) (http://app.transifex.com/sphinx-doc/sphinx-1/language/ca@valencia/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -20,6 +22,127 @@ msgstr "" "Language: ca@valencia\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "Vulnerabilitats i exposicions comunes (CVE %s)" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "número %s de CVE no vàlid" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "Enumeració de les debilitats comunes (CWE %s)" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "número %s de CWE no vàlid" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Propostes de millora a Python (PEP %s)" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "número de PEP no vàlid %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "número de RFC no vàlid %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "No s'admeten les seccions de configuració del tema que no siguen [theme] i [options] (s'ha intentat obtindre un valor des de %r)." + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "configuració %s. %s no es produïx en cap de les configuracions de temes buscats" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "opció de tema no admesa, s'ha donat %r" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "el fitxer %r en el camí de temes no és un fitxer ZIP vàlid ni conté cap tema" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "no s'ha trobat cap tema anomenat %r (falta theme.toml?)" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "El tema %r té una herència circular" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "El tema %r hereta des de %r, el qual no és un tema que estiga carregat. Els temes carregats són: %s" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "El tema %r té massa avantpassats" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "no s'ha trobat cap fitxer de configuració del tema a %r" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "el tema %r no té la taula «theme»" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "La taula del tema %r «[theme]» no és una taula" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "El tema %r ha de definir la configuració «theme.inherit»" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "La taula del tema %r «[options]» no és una taula" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "La configuració de «theme.pygments_style» ha de ser una taula. Consell: «%s»" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "S'han trobat múltiples fitxers per al document «%s»: %s\nUtilitzeu %r per a la compilació." + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "S'ha ignorat el document il·legible %r." + #: extension.py:58 #, python-format msgid "" @@ -34,127 +157,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Este projecte necessita l'extensió %s almenys en la versió %s i, per tant, no es pot construir amb la versió carregada (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "No es coneix el nom del lexer de pigments %r" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "L'anàlisi lèxica del literal_block %r com a «%s» ha resultat en un error en el testimoni: %r. S'està tornant a provar en el mode relaxat." + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "L'esdeveniment %r ja està present" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Nom desconegut de l'esdeveniment: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "El gestor %r per a l'esdeveniment %r ha retornat una excepció" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "No es pot trobar el directori d'origen (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "El directori d'eixida (%s) no és un directori" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "El directori d'origen i el de destinació no poden ser idèntics" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "S'està executant Sphinx versió %s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Este projecte almenys necessita Sphinx versió %s i, per tant, no es pot crear amb esta versió." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "es crea el directori d'eixida" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "mentre es configura l'extensió %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "«setup» tal com es definix actualment a conf.py no és una crida de Python. Modifiqueu la seua definició per a convertir-la en una funció que es puga cridar. Açò és necessari perquè conf.py es comporte com a una extensió de Sphinx." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "s'estan carregant les traduccions [%s]…" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "fet" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "no està disponible per a missatges integrats" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "s'està carregant l'entorn preparat" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "ha fallat: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "No s'ha seleccionat cap constructor, s'utilitza el predeterminat: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "la compilació ha finalitzat amb problemes." -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "la compilació ha tingut èxit." -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "la compilació ha finalitzat amb problemes, 1 avís (amb els avisos tractats com a errors)." -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "la compilació ha finalitzat amb problemes, 1 avís." -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "la compilació ha tingut èxit, 1 avís." -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "la compilació ha acabat amb problemes, %s avisos (amb avisos tractats com a errors)." -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "la compilació ha acabat amb problemes, %s avisos." -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "la compilació ha tingut èxit, %s avisos." -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "la classe del node %r ja està registrada, els seus visitants seran anul·lats" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" -msgstr "" +msgstr "la directiva %r ja està registrada i no serà sobreseguda" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" -msgstr "" +msgstr "el rol %r ja està registrat i no serà sobresegut" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +312,12 @@ msgid "" "explicit" msgstr "l'extensió %s no declara si és segur per a la lectura en paral·lel, suposant que no ho siga, demaneu a l'autor de l'extensió que ho comprove i faça que siga explícit" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "l'extensió %s no és segura per a la lectura en paral·lel" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +325,214 @@ msgid "" "explicit" msgstr "l'extensió %s no declara si és segur per a l'escriptura en paral·lel, suposant que no ho siga, demaneu a l'autor de l'extensió que ho comprove i faça que siga explícit" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "l'extensió %s no és segura per a l'escriptura en paral·lel" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "s'està executant %s en sèrie" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "el directori de configuració no conté un fitxer conf.py (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "La classe del constructor %s no té cap atribut «name»" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "El constructor %r ja existix (en el mòdul %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "El nom del constructor %s no està registrat o disponible a través del punt d'entrada" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "El nom del constructor %s no està registrat" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "el domini %s ja està registrat" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "el domini %s encara no està registrat" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "La directiva %r ja està registrada al domini %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "El rol %r ja està registrat al domini %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "L'índex %r ja està registrat al domini %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "L'object_type %r ja està registrat" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "El crossref_type %r ja està registrat" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r ja està registrat" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser per a %r ja està registrat" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "L'analitzador de fonts per a %s no registrat" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "El traductor per a %r ja existix" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "kwargs per a add_node() haurà de ser una funció (visita, eixida) tupla: %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r ja està registrat" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "la representació matemàtica %s ja està registrada" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "S'ha trobat un valor de configuració no vàlid: «language = None». Actualitzeu la vostra configuració a un codi d'idioma vàlid. Es torna «en» (anglés)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "l'extensió %r ja es va fusionar amb Sphinx des de la versió %s. Esta extensió s'ignorarà." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Excepció original:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "No s'ha pogut importar l'extensió %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "l'extensió %r no té cap funció setup(). És realment un mòdul d'extensions de Sphinx?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "L'extensió %s utilitzada per este projecte almenys necessita Sphinx versió %s i, per tant, no es pot crear amb esta versió." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "l'extensió %r ha retornat un objecte no admés des de la seua funció setup(). No n'hauria de retornar cap o retornar un diccionari de metadades" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "«Cap» no és un tipus de fitxer vàlid per a %r." + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "el directori de configuració no conté un fitxer conf.py (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" -msgstr "" +msgstr "«%s» ha de ser «0» o «1», s'ha obtingut «%s»" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "no s'ha pogut substituir l'ajust de la configuració del diccionari %r, s'ignora (utilitzeu %r per a establir elements individuals)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "nombre no vàlid %r del valor de configuració %r, s'ignora" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "no s'ha pogut substituir l'ajust de la configuració %r amb tipus no compatibles, s'ignora" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "valor de configuració desconegut %r en substituir, s'ignora" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "Este valor de configuració no existix: %r" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "El valor de configuració %r ja està present" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" -msgstr "" +msgstr "no es pot emmagatzemar en la memòria cau un valor de configuració no recuperable: %r (perquè conté un objecte de funció, classe o mòdul)" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "S'ha trobat un valor de configuració no vàlid: «language = None». Actualitzeu la vostra configuració a un codi d'idioma vàlid. Es torna «en» (anglés)." + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "S'ha produït un error de sintaxi en el fitxer de configuració: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "El fitxer de configuració (o un dels mòduls que s'importen) ha cridat «sys.exit()»" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,534 +540,719 @@ msgid "" "%s" msgstr "S'ha produït un error programable en el fitxer de configuració:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" -msgstr "" +msgstr "No s'ha pogut convertir %r a un recurs congelat" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "S'està convertint «source_suffix = %r» a «source_suffix = %r»." -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "El valor de configuració «source_suffix» espera un diccionari, una cadena o una llista de cadenes. En lloc d'açò, s'ha obtingut «%r» (escriviu %s)." -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Secció %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Fig. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Taula %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Llistat %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "El valor de configuració «{name}» ha de ser un de {candidates}, però s'ha donat «{current}»." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "El valor de configuració «{name}» té el tipus «{current.__name__}», s'espera {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "El valor de configuració «{name}» té el tipus «{current.__name__}», el valor predeterminat és «{default.__name__}»." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "no s'ha trobat primary_domain %r, s'ignora." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." -msgstr "" +msgstr "Sphinx ara utilitza «index» de manera predeterminada com a document mestre. Per a mantindre el comportament anterior a la 2.0, establiu «master_doc = 'contents'»." -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "No es coneix el nom del lexer de pigments %r" - -#: highlighting.py:209 -#, python-format +#: config.py:892 msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "L'anàlisi lèxica del literal_block %r com a «%s» ha resultat en un error en el testimoni: %r. S'està tornant a provar en el mode relaxat." +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "La compatibilitat amb les codificacions font diferents d'UTF-8 està obsoleta i se suprimirà en el Sphinx 10. Si això causa algun problema, feu un comentari a «https://github.com/sphinx-doc/sphinx/issues/13665»." -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "No s'admeten les seccions de configuració del tema que no siguen [theme] i [options] (s'ha intentat obtindre un valor des de %r)." +#: environment/__init__.py:89 +msgid "new config" +msgstr "configuració nova" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "configuració %s. %s no es produïx en cap de les configuracions de temes buscats" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "configuració modificada" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "opció de tema no admesa, s'ha donat %r" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "extensions modificades" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "el fitxer %r en el camí de temes no és un fitxer ZIP vàlid ni conté cap tema" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "la versió de l'entorn de compilació no és actual" + +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "el directori d'origen ha sigut modificat" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "no s'ha trobat cap tema anomenat %r (falta theme.toml?)" +msgid "The configuration has changed (1 option: %r)" +msgstr "La configuració ha sigut canviada (1 opció: %r)" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" -msgstr "El tema %r té una herència circular" +msgid "The configuration has changed (%d options: %s)" +msgstr "La configuració ha sigut canviada (%d opcions: %s)" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "La configuració ha sigut canviada (%d opcions: %s, «…»)" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "El tema %r hereta des de %r, el qual no és un tema que estiga carregat. Els temes carregats són: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Este entorn és incompatible amb el constructor seleccionat, trieu un altre directori doctree." -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "El tema %r té massa avantpassats" +msgid "Failed to scan documents in %s: %r" +msgstr "No s'ha pogut escanejar els documents a %s: %r" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" -msgstr "no s'ha trobat cap fitxer de configuració del tema a %r" +msgid "Domain %r is not registered" +msgstr "El domini %r no està registrat" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "el tema %r no té la taula «theme»" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "el document no està inclòs en cap toctree" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "La taula del tema %r «[theme]» no és una taula" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "S'ha trobat un toctree autoreferenciat. S'ignora." -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "El tema %r ha de definir la configuració «theme.inherit»" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgstr "es fa referència al document en múltiples toctree: %s, se selecciona: %s <- %s" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "La taula del tema %r «[options]» no és una taula" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Atenció" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "La configuració de «theme.pygments_style» ha de ser una taula. Consell: «%s»" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Compte" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "L'esdeveniment %r ja està present" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Perill" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Nom desconegut de l'esdeveniment: %s" +#: locale/__init__.py:232 +msgid "Error" +msgstr "S'ha produït un error" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "El gestor %r per a l'esdeveniment %r ha retornat una excepció" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Suggeriment" -#: project.py:72 +#: locale/__init__.py:234 +msgid "Important" +msgstr "Important" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Nota" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Vegeu també" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Truc" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Avís" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Els fitxers de Texinfo es troben a %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "S'han trobat múltiples fitxers per al document «%s»: %s\nUtilitzeu %r per a la compilació." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nExecuteu l'ordre «make» en este directori per a executar-les mitjançant\nel makeinfo (utilitzeu l'ordre «make info» per a fer-ho automàticament)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "S'ha ignorat el document il·legible %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "no s'ha trobat el valor de configuració «texinfo_documents»: no s'escriurà cap document" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "La classe del constructor %s no té cap atribut «name»" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "El valor de configuració «texinfo_documents» fa referència a un document %s desconegut" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "El constructor %r ja existix (en el mòdul %s)" +msgid "processing %s" +msgstr "s'està processant %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "El nom del constructor %s no està registrat o disponible a través del punt d'entrada" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "s'està escrivint" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "El nom del constructor %s no està registrat" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "s'estan resolent les referències…" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "el domini %s ja està registrat" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (a " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "el domini %s encara no està registrat" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "s'estan copiant les imatges… " -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "La directiva %r ja està registrada al domini %s" +msgid "cannot copy image file %r: %s" +msgstr "no s'ha pogut copiar el fitxer d'imatge %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "El rol %r ja està registrat al domini %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "s'estan copiant els fitxers de suport de Texinfo" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "L'índex %r ja està registrat al domini %s" +msgid "error writing file Makefile: %s" +msgstr "s'ha produït un error mentre s'escrivia el fitxer Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "L'object_type %r ja està registrat" +msgid "The manual pages are in %(outdir)s." +msgstr "Les pàgines del manual es troben a %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "El crossref_type %r ja està registrat" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "no s'ha trobat el valor de configuració «man_pages»: no s'escriuran les pàgines del manual" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r ja està registrat" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "El valor de configuració «man_pages» fa referència a un document %s desconegut" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser per a %r ja està registrat" +msgid "The HTML page is in %(outdir)s." +msgstr "La pàgina HTML es troba a %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "L'analitzador de fonts per a %s no registrat" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "s'està muntant un únic document" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "El traductor per a %r ja existix" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "s'estan escrivint els fitxers addicionals" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "kwargs per a add_node() haurà de ser una funció (visita, eixida) tupla: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "El constructor fictici no genera cap fitxer." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r ja està registrat" +msgid "The message catalogs are in %(outdir)s." +msgstr "Els catàlegs de missatges es troben a %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "la representació matemàtica %s ja està registrada" +msgid "building [%s]: " +msgstr "s'està construint [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "l'extensió %r ja es va fusionar amb Sphinx des de la versió %s. Esta extensió s'ignorarà." +msgid "targets for %d template files" +msgstr "objectius per a %d fitxers de plantilla" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Excepció original:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "s'estan llegint les plantilles… " -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "No s'ha pogut importar l'extensió %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "s'estan escrivint els catàlegs de missatges… " -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "l'extensió %r no té cap funció setup(). És realment un mòdul d'extensions de Sphinx?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Busqueu qualsevol error en l'eixida anterior o en el fitxer %(outdir)s/output.txt" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "L'extensió %s utilitzada per este projecte almenys necessita Sphinx versió %s i, per tant, no es pot crear amb esta versió." +msgid "broken link: %s (%s)" +msgstr "enllaç trencat: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "l'extensió %r ha retornat un objecte no admés des de la seua funció setup(). No n'hauria de retornar cap o retornar un diccionari de metadades" +msgid "Anchor '%s' not found" +msgstr "No s'ha trobat l'àncora «%s»" -#: registry.py:612 +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "linkcheck_allowed_redirects. S'esperava un diccionari." + +#: builders/linkcheck.py:799 #, python-format -msgid "`None` is not a valid filetype for %r." -msgstr "«Cap» no és un tipus de fitxer vàlid per a %r." +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "No s'ha pogut compilar expressions regulars en linkcheck_allowed_redirects: %r %s" -#: roles.py:206 +#: builders/epub3.py:83 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "Vulnerabilitats i exposicions comuns (CVE %s)" +msgid "The ePub file is in %(outdir)s." +msgstr "El fitxer ePub es troba a %(outdir)s." + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "s'està escrivint el fitxer nav.xhtml…" + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "el valor de configuració «epub_language» (o «language») no pot estar buit per a EPUB3" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "el valor de configuració «epub_uid» haurà de ser un XML NAME per a EPUB3" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "el valor de configuració «epub_title» (o «html_title») no pot estar buit per a EPUB3" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "el valor de configuració «epub_author» no pot estar buit per a EPUB3" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "el valor de configuració «epub_contributor» no pot estar buit per a EPUB3" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "el valor de configuració «epub_description» no pot estar buit per a EPUB3" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "el valor de configuració «epub_publisher» no pot estar buit per a EPUB3" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "el valor de configuració «epub_copyright» (o «copyright») no pot estar buit per a EPUB3" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "el valor de configuració «epub_identifier» no pot estar buit per a EPUB3" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "el valor de configuració «version» no pot estar buit per a EPUB3" -#: roles.py:229 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "invalid CVE number %s" -msgstr "número %s de CVE no vàlid" +msgid "invalid css_file: %r, ignored" +msgstr "css_file no vàlid: %r, s'ignora" -#: roles.py:251 +#: builders/xml.py:29 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "Enumeració de les debilitats comuns (CWE %s)" +msgid "The XML files are in %(outdir)s." +msgstr "Els fitxers en XML es troben a %(outdir)s." -#: roles.py:274 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "invalid CWE number %s" -msgstr "número %s de CWE no vàlid" +msgid "error writing file %s: %s" +msgstr "s'ha produït un error mentre s'escrivia al fitxer %s: %s" -#: roles.py:294 +#: builders/xml.py:103 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Propostes de millora a Python; PEP %s" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Els fitxers en pseudo XML es troben a %(outdir)s." -#: roles.py:317 +#: builders/_epub_base.py:223 #, python-format -msgid "invalid PEP number %s" -msgstr "número de PEP no vàlid %s" +msgid "duplicated ToC entry found: %s" +msgstr "s'ha trobat una entrada ToC duplicada: %s" -#: roles.py:355 +#: builders/_epub_base.py:436 #, python-format -msgid "invalid RFC number %s" -msgstr "número de RFC no vàlid %s" +msgid "cannot read image file %r: copying it instead" +msgstr "no s'ha pogut llegir el fitxer d'imatge %r: en el seu lloc, es copia" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[font]" +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" +msgstr "no s'ha pogut escriure el fitxer d'imatge %r: %s" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "s'està ressaltant el codi del mòdul… " +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "No s'ha trobat el Pillow: es copien els fitxers d'imatge" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[documents]" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "s'està escrivint un fitxer de tipus MIME…" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Codi del mòdul" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "s'està escrivint el fitxer META-INF/container.xml…" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "s'està escrivint el fitxer content.opf…" -#: ext/viewcode.py:353 +#: builders/_epub_base.py:594 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        Codi font per a %s

        " +msgid "unknown mimetype for %s, ignoring" +msgstr "tipus MIME desconegut per a %s, s'ignora" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Vista general: codi del mòdul" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "el node té un nivell no vàlid" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Tots els mòduls per als quals hi ha codi

        " +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "s'està escrivint el fitxer toc.ncx…" -#: ext/extlinks.py:82 +#: builders/_epub_base.py:802 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "l'enllaç codificat %r podria substituir-se per un enllaç extern (en el seu lloc intenteu utilitzar %r)" +msgid "writing %s file..." +msgstr "s'està escrivint el fitxer %s…" -#: ext/autosectionlabel.py:52 +#: builders/text.py:27 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "la secció «%s» s'etiqueta com a «%s»" +msgid "The text files are in %(outdir)s." +msgstr "Els fitxers de text es troben a %(outdir)s." -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/__init__.py:229 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "etiqueta duplicada %s, una altra instància a %s" +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "no s'ha trobat una imatge adequada per al constructor %s: %s (%s)" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "Enllaça amb esta equació" +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "no s'ha trobat una imatge adequada per al constructor %s: %s" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "==================== durades de lectura més lentes =====================" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "s'estan construint [mo]:" -#: ext/doctest.py:118 -#, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "falta «+» o «-» en l'opció «%s»." +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "s'està escrivint l'eixida…" -#: ext/doctest.py:124 +#: builders/__init__.py:280 #, python-format -msgid "'%s' is not a valid option." -msgstr "«%s» no és una opció vàlida." +msgid "all of %d po files" +msgstr "tots els %d fitxers PO" -#: ext/doctest.py:139 +#: builders/__init__.py:302 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "«%s» no és una opció pyversion vàlida" - -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "tipus de TestCode no vàlid" +msgid "targets for %d po files that are specified" +msgstr "objectius per als %d fitxers PO que s'han especificat" -#: ext/doctest.py:297 +#: builders/__init__.py:314 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Proves de doctests en les fonts acabades, mireu el resultat a %(outdir)s/output.txt." +msgid "targets for %d po files that are out of date" +msgstr "objectius per als %d fitxers PO que estan desfasats" -#: ext/doctest.py:457 -#, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "no hi ha codi/eixida en el bloc %s a %s:%s" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "tots els fitxers font" -#: ext/doctest.py:568 +#: builders/__init__.py:335 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "s'ignora el codi doctest no vàlid: %r" +msgid "file %r given on command line does not exist, " +msgstr "el fitxer %r proporcionat a la línia d'ordres no existix, " -#: ext/imgmath.py:162 +#: builders/__init__.py:342 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "l'ordre de LaTeX %r no s'ha pogut executar (necessària per a la visualització matemàtica), comproveu la configuració d'«imgmath_latex»" +"file %r given on command line is not under the source directory, ignoring" +msgstr "el fitxer %r proporcionat a la línia d'ordres no es troba davall el directori d'origen, s'ignora" -#: ext/imgmath.py:181 +#: builders/__init__.py:353 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%s l'ordre de %r no s'ha pogut executar (necessària per a la visualització matemàtica), comproveu la configuració d'«imgmath_%s»" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "el fitxer %r proporcionat a la línia d'ordres no és un document vàlid, s'ignora" -#: ext/imgmath.py:344 +#: builders/__init__.py:366 #, python-format -msgid "display latex %r: %s" -msgstr "visualització de latex %r: %s" +msgid "%d source files given on command line" +msgstr "%d fitxers font proporcionats en la línia d'ordres" -#: ext/imgmath.py:380 +#: builders/__init__.py:382 #, python-format -msgid "inline latex %r: %s" -msgstr "latex inclòs %r: %s" +msgid "targets for %d source files that are out of date" +msgstr "els objectius per a %d fitxers font que estan desfasats" -#: ext/coverage.py:48 -#, python-format -msgid "invalid regex %r in %s" -msgstr "expressions regulars no vàlides %r a %s" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "s'està buscant per fitxers sense actualitzar… " -#: ext/coverage.py:140 ext/coverage.py:301 +#: builders/__init__.py:415 #, python-format -msgid "module %s could not be imported: %s" -msgstr "el mòdul %s no s'ha pogut importar: %s" +msgid "%d found" +msgstr "s'han trobat %d" -#: ext/coverage.py:148 -#, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "els mòduls següents estan documentats però no s'han especificat en coverage_modules: %s" +#: builders/__init__.py:417 +msgid "none found" +msgstr "no se n'ha trobat cap" -#: ext/coverage.py:158 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" -msgstr "els mòduls següents s'especifiquen en coverage_modules però no estan documentats" +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "s'està preparant l'ambient" -#: ext/coverage.py:172 -#, python-brace-format, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." -msgstr "" +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "s'està comprovant la coherència" -#: ext/coverage.py:187 -#, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "expressions regulars %r no vàlides en coverage_c_regexes" +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "no hi ha cap objectiu desfasat." -#: ext/coverage.py:260 -#, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "API de C sense documentar: %s [ %s] en el fitxer %s" +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "s'està actualitzant l'entorn: " -#: ext/coverage.py:452 +#: builders/__init__.py:499 #, python-format -msgid "undocumented python function: %s :: %s" -msgstr "funció de Python sense documentar: %s :: %s" +msgid "%s added, %s changed, %s removed" +msgstr "%s afegits, %s canviats, %s eliminats" -#: ext/coverage.py:473 +#: builders/__init__.py:536 #, python-format -msgid "undocumented python class: %s :: %s" -msgstr "classe de Python sense documentar: %s :: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "Sphinx no pot carregar el document mestre (%s) perquè coincidix amb un patró d'exclusió %r en la construcció. Moveu el vostre document mestre cap a una altra ubicació." -#: ext/coverage.py:492 +#: builders/__init__.py:545 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "mètode de Python sense documentar: %s :: %s :: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "Sphinx no pot carregar el document mestre (%s) perquè coincidix amb un patró d'exclusió especificat en «conf.py», %r. Per favor, elimineu este patró." -#: ext/imgconverter.py:44 +#: builders/__init__.py:556 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "No es pot executar l'ordre de conversió d'imatges %r. «sphinx.ext.imgconverter» requerix de manera predeterminada ImageMagick. Assegureu-vos que està instal·lat o configureu l'opció «image_converter» a una ordre de conversió personalitzada.\n\nTraça: %s" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "Sphinx no pot carregar el document mestre (%s) perquè no s'inclou en l'opció personalitzada include_patterns = %r. Assegureu-vos que un patró en include_patterns coincidisca amb el document mestre." -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "Sphinx no pot carregar el document mestre (%s). El document mestre haurà d'estar dins del directori font o un subdirectori d'este." + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "s'estan llegint les fonts… " + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "els docname que s'escriuran: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "no hi ha cap docname per a escriure!" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "s'estan preparant els documents" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "s'estan copiant els recursos" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "El fitxer de vista general es troba a %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "no hi ha canvis en la versió %s." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "s'està escrivint el fitxer de vista general…" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Elements incorporats" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Nivell de mòdul" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "s'estan copiant els fitxers font…" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "no s'ha pogut llegir %r per a la creació del registre de canvis" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "expressions regulars no vàlides %r a %s" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "el mòdul %s no s'ha pogut importar: %s" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "els mòduls següents estan documentats, però no s'han especificat en coverage_modules: %s" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "S'han acabat les proves de cobertura a les fonts, mireu el resultat a «%(outdir)s{sep}python.txt»." + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "expressions regulars %r no vàlides en coverage_c_regexes" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "API de C sense documentar: %s [ %s] en el fitxer %s" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "funció de Python sense documentar: %s :: %s" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "classe de Python sense documentar: %s :: %s" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "mètode de Python sense documentar: %s :: %s :: %s" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "l'enllaç codificat %r podria substituir-se per un enllaç extern (en el seu lloc intenteu utilitzar %r)" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Tasca pendent" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "S'ha trobat una entrada TODO: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(L'<> es troba a %s, línia %d)." + +#: ext/todo.py:166 +msgid "original entry" +msgstr "entrada original" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "No es pot executar l'ordre de conversió d'imatges %r. «sphinx.ext.imgconverter» requerix de manera predeterminada ImageMagick. Assegureu-vos que està instal·lat o establiu l'opció «image_converter» a una ordre de conversió personalitzada.\n\nTraça: %s" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 #, python-format msgid "" "convert exited with error:\n" @@ -848,7 +1315,7 @@ msgstr "«dot» no ha produït un fitxer d'eixida:\n[stderr]\n%r\n[stdout]\n%r" #: ext/graphviz.py:367 #, python-format msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" -msgstr "" +msgstr "«graphviz_output_format» ha de ser «png» o «svg», però és %r" #: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 #, python-format @@ -864,879 +1331,960 @@ msgstr "[gràfica: %s]" msgid "[graph]" msgstr "[gràfica]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Tasca pendent" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "l'ordre de LaTeX %r no s'ha pogut executar (necessària per a la visualització matemàtica), comproveu la configuració d'«imgmath_latex»" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" -msgstr "S'ha trobat una entrada TODO: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s l'ordre de %r no s'ha pogut executar (necessària per a la visualització matemàtica), comproveu la configuració d'«imgmath_%s»" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "visualització de latex %r: %s" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(L'<> es troba a %s, línia %d)." +msgid "inline latex %r: %s" +msgstr "latex inclòs %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "entrada original" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "Enllaça amb esta equació" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "cap espai en blanc eliminat en disminuir el sagnat" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "falta «+» o «-» en l'opció «%s»." -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" -msgstr "Subtítol no vàlid: %s" +msgid "'%s' is not a valid option." +msgstr "«%s» no és una opció vàlida." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "l'especificació del número de línia queda fora de l'interval (1-%d): %r" +msgid "'%s' is not a valid pyversion option" +msgstr "«%s» no és una opció pyversion vàlida" -#: directives/code.py:216 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "tipus de TestCode no vàlid" + +#: ext/doctest.py:297 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "No es poden utilitzar ambdues opcions «%s» i «%s»" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Proves de doctests en les fonts acabades, mireu el resultat a %(outdir)s/output.txt." -#: directives/code.py:231 +#: ext/doctest.py:451 #, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "No s'ha trobat el fitxer d'inclusió «%s» o n'ha fallat la lectura" +msgid "no code/output in %s block at %s:%s" +msgstr "no hi ha codi/eixida en el bloc %s a %s:%s" -#: directives/code.py:235 +#: ext/doctest.py:568 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "La codificació %r emprada per a llegir el fitxer d'inclusió «%s» pareix ser incorrecta, proveu indicant una opció :encoding:" +msgid "ignoring invalid doctest code: %r" +msgstr "s'ignora el codi doctest no vàlid: %r" -#: directives/code.py:276 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "L'objecte anomenat %r no es troba en el fitxer inclòs %r" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "la secció «%s» s'etiqueta com a «%s»" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "No podeu utilitzar «lineno-match» amb un conjunt desarticulat de «línies»" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "etiqueta duplicada %s, una altra instància a %s" -#: directives/code.py:314 +#: ext/duration.py:47 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Línia específica %r: No hi ha cap línia llançada des del fitxer inclòs %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" -#: directives/patches.py:71 +#: ext/duration.py:117 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "«:file:» l'opció per a la directiva «csv-table» ara reconeix un camí absolut com a camí relatiu des del directori d'origen. Actualitzeu el vostre document." +"====================== total reading duration ==========================" +msgstr "" -#: directives/other.py:119 +#: ext/duration.py:124 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "El patró global toctree %r no coincidix amb cap document" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "el toctree conté una referència cap al document exclòs %r" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "==================== durades de lectura més lentes =====================" -#: directives/other.py:156 +#: ext/duration.py:139 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "el toctree conté una referència cap al document %r, el qual no existix" +msgid "%.3fs %s" +msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "s'ha trobat una entrada duplicada en el toctree: %s" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[font]" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autoria de la secció:" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "s'està ressaltant el codi del mòdul… " -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autoria del mòdul: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[documents]" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autoria del codi: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Codi del mòdul" -#: directives/other.py:209 -msgid "Author: " -msgstr "Autoria: " +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Codi font per a %s

        " -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "… el contingut dels reconeixements no és una llista" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Vista general: codi del mòdul" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "… el contingut de l'historial no és una llista" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Tots els mòduls per als quals hi ha codi

        " -#: builders/changes.py:29 +#: domains/citation.py:75 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "El fitxer de vista general es troba a %(outdir)s." +msgid "duplicate citation %s, other instance in %s" +msgstr "citació duplicada %s, una altra instància a %s" -#: builders/changes.py:56 +#: domains/citation.py:92 #, python-format -msgid "no changes in version %s." -msgstr "no hi ha canvis en la versió %s." - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "s'està escrivint el fitxer de vista general…" - -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Elements incorporats" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "Nivell de mòdul" - -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "s'estan copiant els fitxers font…" +msgid "Citation [%s] is not referenced." +msgstr "No es fa referència en la citació [%s]." -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" -msgstr "no s'ha pogut llegir %r per a la creació del registre de canvis" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "etiqueta duplicada de l'equació %s, una altra instància a %s" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Les pàgines del manual es troben a %(outdir)s." +msgid "Invalid math_eqref_format: %r" +msgstr "math_eqref_format no vàlid: %r" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "no s'ha trobat el valor de configuració «man_pages»: no s'escriuran les pàgines del manual" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (funció interna)" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "s'està escrivint" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (mètode %s)" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "El valor de configuració «man_pages» fa referència a un document %s desconegut" +msgid "%s() (class)" +msgstr "%s() (classe)" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "no s'ha trobat una imatge adequada per al constructor %s: %s (%s)" +msgid "%s (global variable or constant)" +msgstr "%s (variable global o constant)" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "no s'ha trobat una imatge adequada per al constructor %s: %s" +msgid "%s (%s attribute)" +msgstr "%s (atribut %s)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "s'estan construint [mo]:" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Arguments" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "s'està escrivint l'eixida…" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Llançaments" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" -msgstr "tots els %d fitxers PO" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Retorna" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" -msgstr "objectius per als %d fitxers PO que s'han especificat" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Tipus de retorn" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "objectius per als %d fitxers PO que estan desfasats" +msgid "%s (module)" +msgstr "%s (mòdul)" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "tots els fitxers font" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funció" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " -msgstr "el fitxer %r proporcionat a la línia d'ordres no existix, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "mètode" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "el fitxer %r proporcionat a la línia d'ordres no es troba davall el directori d'origen, s'ignora" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "classe" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "el fitxer %r proporcionat a la línia d'ordres no és un document vàlid, s'ignora" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "dades" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "%d fitxers font proporcionats en la línia d'ordres" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribut" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "els objectius per a %d fitxers font que estan desfasats" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "mòdul" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " -msgstr "s'està construint [%s]: " - -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "s'està buscant per fitxers sense actualitzar… " +msgid "duplicate %s description of %s, other %s in %s" +msgstr "descripció %s duplicada de %s, una altra %s a %s" -#: builders/__init__.py:410 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "%d found" -msgstr "s'han trobat %d" +msgid "%s (directive)" +msgstr "%s (directiva)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "no se n'ha trobat cap" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr ":%s: (opció de la directiva)" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "s'està preparant l'ambient" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (rol)" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "s'està comprovant la coherència" +#: domains/rst.py:234 +msgid "directive" +msgstr "directiva" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "no hi ha cap objectiu desfasat." +#: domains/rst.py:235 +msgid "directive-option" +msgstr "opció_de_la_directiva" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "s'està actualitzant l'entorn: " +#: domains/rst.py:236 +msgid "role" +msgstr "rol" -#: builders/__init__.py:494 +#: domains/rst.py:262 #, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s afegits, %s canviats, %s eliminats" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "descripció duplicada del %s %s, una altra instància a %s" -#: builders/__init__.py:531 +#: domains/changeset.py:32 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "Sphinx no pot carregar el document mestre (%s) perquè coincidix amb un patró d'exclusió %r en la construcció. Moveu el vostre document mestre cap a una altra ubicació." +msgid "Added in version %s" +msgstr "Afegit a la versió %s" -#: builders/__init__.py:540 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "Sphinx no pot carregar el document mestre (%s) perquè coincidix amb un patró d'exclusió especificat en «conf.py», %r. Per favor, elimineu este patró." +msgid "Changed in version %s" +msgstr "Canviat a la versió %s" -#: builders/__init__.py:551 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "Sphinx no pot carregar el document mestre (%s) perquè no s'inclou en l'opció personalitzada include_patterns = %r. Assegureu-vos que un patró en include_patterns coincidisca amb el document mestre." +msgid "Deprecated since version %s" +msgstr "Obsolet des de la versió %s" -#: builders/__init__.py:558 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "Sphinx no pot carregar el document mestre (%s). El document mestre haurà d'estar dins del directori font o un subdirectori d'este." - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "s'estan llegint les fonts… " +msgid "Removed in version %s" +msgstr "S'ha eliminat en la versió %s" -#: builders/__init__.py:713 +#: domains/__init__.py:322 #, python-format -msgid "docnames to write: %s" -msgstr "els docname que s'escriuran: %s" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "el número de treball hauria de ser un nombre positiu" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "s'estan preparant els documents" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "Per a més informació, visiteu ." -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "s'estan copiant els recursos" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nGenerar la documentació a partir dels fitxers font.\n\nL'eina «sphinx-build» generarà la documentació a partir dels fitxers\na SOURCEDIR i els situarà a OUTPUTDIR. Busqueu el «conf.py» en el\nSOURCEDIR per als paràmetres de configuració. L'eina «sphinx-quickstart» es pot utilitzar per a generar fitxers de plantilla, inclòs el «conf.py».\n\nL'eina «sphinx-build» pot crear documentació en formats diferents. A la\nlínia d'ordres se selecciona un format que especifica el nom del constructor.\nDe manera predeterminada és HTML. Els constructors també poden dur a terme\naltres tasques relacionades amb el processament de la documentació.\n\nDe manera predeterminada, es construïx tot el que està desactualitzat. Es pot\ngenerar l'eixida només per als fitxers seleccionats especificant noms de fitxer\nindividuals.\n" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "caràcters font no codificables, substituint per «?»: %r" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "camí cap als fitxers font de la documentació" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "El fitxer ePub es troba a %(outdir)s." +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "camí cap al directori d'eixida" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "s'està escrivint el fitxer nav.xhtml…" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "(opcional) una llista de fitxers específics que s'han de reconstruir. S'ignorarà si s'especifica «--write-all»" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "el valor de configuració «epub_language» (o «language») no pot estar buit per a EPUB3" +#: cmd/build.py:114 +msgid "general options" +msgstr "opcions generals" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "el valor de configuració «epub_uid» haurà de ser un XML NAME per a EPUB3" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "constructor que s'utilitzarà (predeterminat: «html»)" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "el valor de configuració «epub_title» (o «html_title») no pot estar buit per a EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "executa en paral·lel amb N processos, quan siga possible. «auto» uxa el nombre de nuclis de la CPU" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "el valor de configuració «epub_author» no pot estar buit per a EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "escriu tots els fitxers (predeterminat: només escriu els fitxers nous i els que han canviat)" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "el valor de configuració «epub_contributor» no pot estar buit per a EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "no utilitzar un entorn guardat, llig sempre tots els fitxers" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "el valor de configuració «epub_description» no pot estar buit per a EPUB3" +#: cmd/build.py:150 +msgid "path options" +msgstr "opcions de camí" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "el valor de configuració «epub_publisher» no pot estar buit per a EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "directori per als fitxers doctree i d'entorn (predeterminat: OUTPUT_DIR/.doctrees)" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "el valor de configuració «epub_copyright» (o «copyright») no pot estar buit per a EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "directori per al fitxer de configuració (conf.py) (predeterminat: SOURCE_DIR)" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "el valor de configuració «epub_identifier» no pot estar buit per a EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "no utilitza cap fitxer de configuració, només utilitza la configuració de les opcions de «-D»" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "el valor de configuració «version» no pot estar buit per a EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "superposa una configuració en el fitxer de configuració" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "css_file no vàlid: %r, s'ignora" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "passa un valor a dins de les plantilles HTML" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Els fitxers en XML es troben a %(outdir)s." +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "definix l'etiqueta: inclou blocs «only» amb TAG" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "s'ha produït un s'ha produït un error mentre s'escrivia al fitxer %s: %s" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "mode primmirat: avisa sobre totes les referències que falten" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Els fitxers en pseudo XML es troben a %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" +msgstr "opcions d'eixida de la consola" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Els fitxers de Texinfo es troben a %(outdir)s." +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "augmenta la loquacitat (es pot repetir)" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nExecuteu l'ordre «make» en este directori per a executar-les mitjançant\nel makeinfo (utilitzeu l'ordre «make info» per a fer-ho automàticament)." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "sense eixida cap a l'eixida estàndard, només avisos a l'eixida d'error estàndard" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "no s'ha trobat el valor de configuració «texinfo_documents»: no s'escriurà cap document" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "sense eixida, ni tan sols els avisos" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "El valor de configuració «texinfo_documents» fa referència a un document %s desconegut" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "emet una eixida amb colors (predeterminada: detecció automàtica)" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "s'està processant %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "no emetre una eixida amb colors (predeterminada: detecció automàtica)" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "s'estan resolent les referències…" +#: cmd/build.py:252 +msgid "warning control options" +msgstr "opcions de control d'avís" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (a " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "escriviu els avisos (i errors) al fitxer indicat" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "s'estan copiant les imatges… " +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "convertix els avisos en errors" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "no s'ha pogut copiar el fitxer d'imatge %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "mostra la traça completa en excepció" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "s'estan copiant els fitxers de suport de Texinfo" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "executa Pdb en excepció" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "s'ha produït un s'ha produït un error mentre s'escrivia el fitxer Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "planteja una excepció sobre els avisos" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "s'ha trobat una entrada ToC duplicada: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "no es pot combinar l'opció -a i els noms de fitxer" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "no s'ha pogut llegir el fitxer d'imatge %r: en el seu lloc, es copia" +msgid "cannot open warning file '%s': %s" +msgstr "no es pot obrir el fitxer de l'avís «%s»: %s" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "no s'ha pogut escriure el fitxer d'imatge %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "l'argument de l'opció «-D» haurà d'estar en la forma «nom=valor»" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "No s'ha trobat el Pillow: es copien els fitxers d'imatge" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "l'argument de l'opció -A haurà d'estar en la forma «nom=valor»" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "s'està escrivint un fitxer de tipus MIME…" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "inserix automàticament les docstring des dels mòduls" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "s'està escrivint el fitxer META-INF/container.xml…" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "prova automàticament els fragments de codi en els blocs doctest" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "s'està escrivint el fitxer content.opf…" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "enllaç entre la documentació de Sphinx de projectes diferents" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "tipus MIME desconegut per a %s, s'ignora" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "escriu les entrades «todo» que es poden mostrar o ocultar durant la construcció" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "el node té un nivell no vàlid" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "comprovacions per a la cobertura de la documentació" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "s'està escrivint el fitxer toc.ncx…" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "inclou expressions matemàtiques, mostrades com a imatges PNG o SVG" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "s'està escrivint el fitxer %s…" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "inclou expressions matemàtiques, representades en el navegador per MathJax" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "El constructor fictici no genera cap fitxer." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "inclusió condicional de contingut basat en els valors de la configuració" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Els catàlegs de missatges es troben a %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "inclou els enllaços cap al codi font dels objectes documentats en Python" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "objectius per a %d fitxers de plantilla" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "crea un fitxer .nojekyll per a publicar el document en les pàgines de GitHub" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "s'estan llegint les plantilles… " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Introduïu un nom de camí vàlid." -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "s'estan escrivint els catàlegs de missatges… " +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Introduïu algun text." -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "La pàgina HTML es troba a %(outdir)s." +msgid "Please enter one of %s." +msgstr "Introduïu un dels %s." -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "s'està muntant un únic document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Introduïu qualsevol de «y» o «n»." -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "s'estan escrivint els fitxers addicionals" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Introduïu un sufix de fitxer, p. ex., «.rst» o «.txt»." -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Busqueu qualsevol error en l'eixida anterior o en el fitxer %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Us donem la benvinguda a la utilitat d'inici ràpid de Sphinx %s." + +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Introduïu els valors per a les configuracions següents (només premeu «Retorn»\nper a acceptar un valor predeterminat, si se'n dona un entre parèntesis)." -#: builders/linkcheck.py:149 +#: cmd/quickstart.py:242 #, python-format -msgid "broken link: %s (%s)" -msgstr "enllaç trencat: %s (%s)" - -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "No s'ha trobat l'àncora «%s»" +msgid "Selected root path: %s" +msgstr "Camí arrel seleccionat: %s" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "No s'ha pogut compilar expressions regulars en linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Introduïu el camí arrel per a la documentació." -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Els fitxers de text es troben a %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Camí arrel per a la documentació" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "referències incoherents de nota al peu en el missatge traduït. Original: {0}, traduït: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "S'ha produït un error: ja existix un fitxer conf.py en el camí arrel seleccionat." -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "referències incoherents en el missatge traduït. Original: {0}, traduït: {1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "«sphinx-quickstart» no sobreescriurà els projectes de Sphinx existents." -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "referències incoherents de citació en el missatge traduït. Original: {0}, traduït: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Introduïu un camí arrel nou (o premeu «Retorn» per a eixir)" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "referències incoherents de terme en el missatge traduït. Original: {0}, traduït: {1}" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%-d %b, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "no s'ha pogut calcular el progrés de la traducció!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Teniu dues opcions per a col·locar el directori de construcció per a la\neixida de Sphinx. O utilitzeu un directori «_build» dins del camí arrel,\no els directoris separats «source» i «build» dins del camí arrel." -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "No hi ha cap element traduït!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Separa els directoris «source» i «build» (s/n)" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "S'ha trobat un índex basat en 4 columnes. Pot ser un error de les extensions que utilitzeu: %r" - -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "La nota al peu [%s] no té una referència." - -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "No es fa referència en la nota al peu [*]." +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "Dins del directori arrel, es crearan dos directoris més: «_templates» per a\nles plantilles HTML personalitzades i «_static» per als fulls d'estil\npersonalitzats i altres fitxers estàtics. Podeu introduir un altre prefix\n(com «.») per a substituir el guió baix." -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "La nota al peu [núm.] no té una referència." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Prefix de nom per als directoris «templates» i «static»" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "Ús:" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "El nom del projecte apareixerà en diversos llocs de la documentació construïda." -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "{0} [OPCIONS] []" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Nom del projecte" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr " El generador de documentació Sphinx." +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Noms de l'autoria" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "Ordres:" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx té la noció d'una «versió» i un «llançament» per al programari.\nCada versió pot tindre múltiples versions. Per exemple, per a Python,\nla versió és una cosa pareixent a 2.5 o 3.0, mentre que el llançament és\ncom 2.5.1 o 3.0a1. Si no necessiteu esta doble estructura, senzillament\nestabliu ambdues amb el mateix valor." -#: _cli/__init__.py:98 -msgid "Options" -msgstr "Opcions" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Versió del projecte" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "Per a més informació, visiteu https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Llançament del projecte" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "{0}: error: {1}\nPer a informació executeu «{0} --help»" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr " Gestiona la documentació amb Sphinx." +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "Si els documents s'han d'escriure en un idioma que no siga l'anglés,\npodeu seleccionar un idioma ací per al vostre codi d'idioma.\nA continuació, Sphinx traduirà el text que es genera en este idioma.\n\nPer a obtindre una llista dels codis admesos, vegeu\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "Mostra la versió i ix." +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Idioma del projecte" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "Mostra este missatge i ix." +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "El sufix del nom del fitxer per als fitxers d'origen. Normalment, este és\n«.txt» o «.rst». Només els fitxers amb este sufix es consideraran documents." -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "Registre" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Sufix del fitxer font" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "Augmenta la verbositat (es pot repetir)" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "Un document és especial perquè es considera el node superior de l'«arbre de\ncontingut», és a dir, és l'arrel de l'estructura jeràrquica dels documents.\nNormalment, es tracta de l'«index», però si el document «index» és una\nplantilla personalitzada, també podreu establir-la a un altre nom de fitxer." -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "Imprimix només els errors i els avisos." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Nom del document mestre (sense sufix)" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "Cap eixida en absolut" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "S'ha produït un error: el fitxer mestre %s ja es troba en el camí arrel seleccionat." -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "«sphinx-quickstart» no sobreescriurà el fitxer existent." -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "Vegeu «sphinx --help».\n" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Introduïu un nom de fitxer nou o canvieu-ne el nom i premeu «Retorn»" -#: environment/__init__.py:86 -msgid "new config" -msgstr "configuració nova" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Indiqueu quines de les extensions següents de Sphinx haurien d'estar habilitades:" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "configuració modificada" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Nota: «imgmath» i «mathjax» no es poden habilitar alhora. «imgmath» ha sigut desseleccionat." -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "extensions modificades" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Es pot generar un fitxer Makefile i un fitxer d'ordres de Windows,\nde manera que només haureu d'executar, p. ex., «make html»\nen lloc d'invocar directament «sphinx-build»." -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "la versió de l'entorn de compilació no és actual" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Voleu crear el Makefile? (s/n)" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "el directori d'origen ha sigut modificat" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Voleu crear el fitxer d'ordres de Windows? (s/n)" -#: environment/__init__.py:325 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "La configuració ha sigut canviada (1 opció: %r)" +msgid "Creating file %s." +msgstr "S'està creant el fitxer %s." -#: environment/__init__.py:330 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "La configuració ha sigut canviada (%d opcions: %s)" +msgid "File %s already exists, skipping." +msgstr "El fitxer %s ja existix, se salta." + +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Finalitzat: s'ha creat una estructura inicial del directori." -#: environment/__init__.py:336 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "La configuració ha sigut canviada (%d opcions: %s, «…»)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Ara heu de completar el fitxer mestre %s i crear altres fitxers font de documentació. " -#: environment/__init__.py:379 +#: cmd/quickstart.py:527 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "Este entorn és incompatible amb el constructor seleccionat, trieu un altre directori doctree." +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Utilitzeu el Makefile per a construir els documents, com seguix:\n make builder" -#: environment/__init__.py:493 +#: cmd/quickstart.py:531 #, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "No s'ha pogut escanejar els documents a %s: %r" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Utilitzeu l'ordre «sphinx-build» per a construir els documents, com seguix:\n sphinx-build -b constructor %s %s" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "El domini %r no està registrat" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "on «constructor» és un dels constructors admesos, p. ex., html, latex o linkcheck." -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "el document no està inclòs en cap toctree" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nGenereu els fitxers necessaris per a un projecte Sphinx.\n\n«sphinx-quickstart» és una eina interactiva que fa algunes preguntes sobre el\nprojecte i després genera un directori complet de documentació i un\nexemple del fitxer Makefile per a utilitzar-se amb l'ordre «sphinx-build».\n" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "S'ha trobat un toctree autoreferenciat. S'ignora." +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "mode silenciós" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "es fa referència al document en múltiples toctree: %s, se selecciona: %s <- %s" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "arrel del projecte" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "s'ha produït un s'ha produït un error mentre es llegia: %s, %s" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Opcions de l'estructura" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "s'ha produït un s'ha produït un error mentre s'escrivia: %s, %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "Si s'especifica, se separarà el codi font i els directoris de compilació" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "locale_dir %s no existix" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "Si s'especifica, es crearà el directori de construcció a dins del directori d'origen" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "substitució per a punts a _templates, etc." -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Format de data no vàlid. Citeu la cadena amb cometes senzilles si voleu generar-la directament: %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Opcions bàsiques del projecte" -#: util/docfields.py:103 +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "nom del projecte" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "noms de l'autoria" + +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "versió del projecte" + +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "llançament del projecte" + +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "idioma del document" + +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "sufix del fitxer font" + +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "nom del document mestre" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "utilitza epub" + +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Opcions de l'extensió" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "habilita l'extensió %s" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "habilita les extensions arbitràries" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Creeu els fitxers Makefile i de processament per lots" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "es crea el Makefile" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "no es crea el Makefile" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "es crea el fitxer de processament per lots" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "no es crea el fitxer de processament per lots" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "utilitza el mode make per a Makefile/make.bat" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Plantilles de projecte" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "directori de plantilles per als fitxers de plantilla" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "definix una variable de plantilla" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "s'especifica «quiet», però no s'especifica cap «project» o «author»." + +#: cmd/quickstart.py:786 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "Problema en el domini %s: se suposa que el camp utilitza el rol «%s», però no es troba en el domini." +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "S'ha produït un error: el camí especificat no és un directori o ja hi ha els fitxers de Sphinx." -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "%r està en desús per a les entrades d'índex (des de l'entrada %r). En el seu lloc utilitzeu «pair: %s»." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "«sphinx-quickstart» només generarà dins d'un directori buit. Especifiqueu un camí arrel nou." -#: util/nodes.py:490 +#: cmd/quickstart.py:810 #, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "el toctree conté una referència cap al fitxer %r que no existix" +msgid "Invalid template variable: %s" +msgstr "Variable no vàlida de plantilla: %s" -#: util/nodes.py:706 +#: directives/other.py:119 #, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "excepció mentre només s'avaluava l'expressió directiva: %s" - -#: util/display.py:82 -msgid "skipped" -msgstr "s'omet" - -#: util/display.py:87 -msgid "failed" -msgstr "ha fallat" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "El patró global toctree %r no coincidix amb cap document" -#: util/osutil.py:131 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "S'ha interromput l'intent de còpia des de %s a %s (hi ha dades existents en el camí de destinació)." +msgid "toctree contains reference to excluded document %r" +msgstr "el toctree conté una referència cap al document exclòs %r" -#: util/docutils.py:309 +#: directives/other.py:156 #, python-format -msgid "unknown directive name: %s" -msgstr "" +msgid "toctree contains reference to nonexisting document %r" +msgstr "el toctree conté una referència cap al document %r, el qual no existix" -#: util/docutils.py:345 +#: directives/other.py:169 #, python-format -msgid "unknown role name: %s" -msgstr "" +msgid "duplicated entry found in toctree: %s" +msgstr "s'ha trobat una entrada duplicada en el toctree: %s" + +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autoria de la secció:" + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autoria del mòdul: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autoria del codi: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autoria: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "… el contingut dels reconeixements no és una llista" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "… el contingut de l'historial no és una llista" + +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "«:file:» l'opció per a la directiva «csv-table» ara reconeix un camí absolut com a camí relatiu des del directori d'origen. Actualitzeu el vostre document." -#: util/docutils.py:789 +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "cap espai en blanc eliminat en disminuir el sagnat" + +#: directives/code.py:87 #, python-format -msgid "unknown node type: %r" -msgstr "tipus de node desconegut: %r" +msgid "Invalid caption: %s" +msgstr "Subtítol no vàlid: %s" -#: util/fileutil.py:76 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "S'ha interromput l'intent de còpia des de la plantilla representada %s a %s (hi ha dades existents en el camí de destinació)." +msgid "line number spec is out of range(1-%d): %r" +msgstr "l'especificació del número de línia queda fora de l'interval (1-%d): %r" -#: util/fileutil.py:89 +#: directives/code.py:216 #, python-format -msgid "Writing evaluated template result to %s" -msgstr "Escriu el resultat de la plantilla avaluada a %s" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "No es poden utilitzar ambdues opcions «%s» i «%s»" -#: util/rst.py:73 +#: directives/code.py:231 #, python-format -msgid "default role %s not found" -msgstr "no s'ha trobat el rol predeterminat %s" +msgid "Include file '%s' not found or reading it failed" +msgstr "No s'ha trobat el fitxer d'inclusió «%s» o n'ha fallat la lectura" -#: util/inventory.py:147 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "l'inventari <%s> conté definicions duplicades de %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "La codificació %r emprada per a llegir el fitxer d'inclusió «%s» pareix ser incorrecta, proveu indicant una opció :encoding:" -#: util/inventory.py:166 +#: directives/code.py:276 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "l'inventari <%s> conté múltiples definicions per a %s" +msgid "Object named %r not found in include file %r" +msgstr "L'objecte anomenat %r no es troba en el fitxer inclòs %r" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Notes al peu" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "No podeu utilitzar «lineno-match» amb un conjunt desarticulat de «línies»" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" -msgstr "[imatge: %s]" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Línia específica %r: No hi ha cap línia llançada des del fitxer inclòs %r" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[imatge]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%-d %b, %Y" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1745,11 +2293,15 @@ msgstr "[imatge]" msgid "Index" msgstr "Índex" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "el node del títol no s'ha trobat en la secció, tema, taula, advertiment o nota al marge" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Notes al peu" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "el subtítol no es troba dins d'una figura." @@ -1759,67 +2311,28 @@ msgstr "el subtítol no es troba dins d'una figura." msgid "unimplemented node type: %r" msgstr "tipus de node sense implementar: %r" -#: writers/latex.py:361 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "%r toplevel_sectioning desconegut per a la classe %r" +msgid "[image: %s]" +msgstr "[imatge: %s]" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "no es coneix l'opció de Babel per a l'idioma %r" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[imatge]" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr ":maxdepth: massa gran, s'ignora." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "Enllaça amb esta definició" -#: writers/latex.py:591 +#: writers/html5.py:431 #, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "no s'ha trobat la plantilla %s. En el seu lloc s'està carregant des del llegat %s" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "el títol del document no és només un node de text" +msgid "numfig_format is not defined for %s" +msgstr "numfig_format no s'ha definit per a %s" -#: writers/html5.py:572 writers/latex.py:1106 +#: writers/html5.py:441 #, python-format -msgid "unsupported rubric heading level: %s" -msgstr "nivell de capçalera de rúbrica no compatible: %s" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "s'indiquen tant les columnes tabulars com l'opció «:widths:». S'ignora l'opció «:widths:»." - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "la unitat de dimensió %s no és vàlida. S'ignora." - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "s'ha trobat el tipus d'entrada %s amb un índex desconegut" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "math_eqref_format no vàlid: %r" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "Enllaça amb esta definició" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "numfig_format no s'ha definit per a %s" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "Qualsevol ID no assignat per al node %s" +msgid "Any IDs not assigned for %s node" +msgstr "Qualsevol ID no assignat per al node %s" #: writers/html5.py:496 msgid "Link to this term" @@ -1833,6 +2346,11 @@ msgstr "Enllaça amb esta capçalera" msgid "Link to this table" msgstr "Enllaça amb esta taula" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "nivell de capçalera de rúbrica no compatible: %s" + #: writers/html5.py:636 msgid "Link to this code" msgstr "Enllaça amb este codi" @@ -1849,794 +2367,478 @@ msgstr "Enllaça amb este toctree" msgid "Could not obtain image size. :scale: option is ignored." msgstr "No s'ha pogut obtindre la mida de la imatge. S'ignora l'opció «:scale:»." -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "%r toplevel_sectioning desconegut per a la classe %r" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "etiqueta duplicada de l'equació %s, una altra instància a %s" +msgid "no Babel option known for language %r" +msgstr "no es coneix l'opció de Babel per a l'idioma %r" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (funció interna)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":maxdepth: massa gran, s'ignora." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (mètode %s)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "no s'ha trobat la plantilla %s. En el seu lloc s'està carregant des del llegat %s" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "el títol del document no és només un node de text" -#: domains/javascript.py:185 +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "s'indiquen tant les columnes tabulars com l'opció «:widths:». S'ignora l'opció «:widths:»." + +#: writers/latex.py:1228 #, python-format -msgid "%s() (class)" -msgstr "%s() (classe)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "S'ha donat colspec %s, el qual sembla utilitzar la sintaxi tabular. Però esta taula no es pot representar com a tabular, el colspec donat s'ignorarà." -#: domains/javascript.py:187 +#: writers/latex.py:1615 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s (variable global o constant)" +msgid "dimension unit %s is invalid. Ignored." +msgstr "la unitat de dimensió %s no és vàlida. S'ignora." -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1950 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (atribut %s)" +msgid "unknown index entry type %s found" +msgstr "s'ha trobat el tipus d'entrada %s amb un índex desconegut" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Arguments" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "Ús:" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Llançaments" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "{0} [OPCIONS] []" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Retorna" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr " El generador de documentació Sphinx." -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Tipus de retorn" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "Ordres:" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (mòdul)" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "Opcions" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funció" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "Per a més informació, visiteu https://www.sphinx-doc.org/en/master/man/." -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "mètode" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "{0}: error: {1}\nPer a informació executeu «{0} --help»" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "classe" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr " Gestiona la documentació amb Sphinx." -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "dades" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "Mostra la versió i ix." -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atribut" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "Mostra este missatge i ix." -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "mòdul" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "Registre" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "descripció %s duplicada de %s, una altra %s a %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "Augmenta la verbositat (es pot repetir)" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "Afegit a la versió %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "Imprimix només els errors i els avisos." -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Canviat a la versió %s" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "Cap eixida en absolut" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Obsolet des de la versió %s" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "S'ha eliminat en la versió %s" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "Vegeu «sphinx --help».\n" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (directiva)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "referències incoherents de nota al peu en el missatge traduït. Original: {0}, traduït: {1}" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (opció de la directiva)" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "referències incoherents en el missatge traduït. Original: {0}, traduït: {1}" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (rol)" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "referències incoherents de citació en el missatge traduït. Original: {0}, traduït: {1}" -#: domains/rst.py:234 -msgid "directive" -msgstr "directiva" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "referències incoherents de terme en el missatge traduït. Original: {0}, traduït: {1}" -#: domains/rst.py:235 -msgid "directive-option" -msgstr "opció_de_la_directiva" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "no s'ha pogut calcular el progrés de la traducció!" -#: domains/rst.py:236 -msgid "role" -msgstr "rol" +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "No hi ha cap element traduït!" -#: domains/rst.py:262 +#: transforms/__init__.py:258 #, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "descripció duplicada del %s %s, una altra instància a %s" +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "S'ha trobat un índex basat en 4 columnes. Pot ser un error de les extensions que utilitzeu: %r" -#: domains/citation.py:75 +#: transforms/__init__.py:299 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "citació duplicada %s, una altra instància a %s" +msgid "Footnote [%s] is not referenced." +msgstr "La nota al peu [%s] no té una referència." -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "No es fa referència en la citació [%s]." +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "No es fa referència en la nota al peu [*]." -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Atenció" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "La nota al peu [núm.] no té una referència." -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Compte" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "l'inventari <%s> conté definicions duplicades de %s" -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Perill" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "l'inventari <%s> conté múltiples definicions per a %s" -#: locale/__init__.py:231 -msgid "Error" -msgstr "S'ha produït un error" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "s'ha produït un error mentre es llegia: %s, %s" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Suggeriment" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "s'ha produït un error mentre s'escrivia: %s, %s" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Important" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Nota" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Vegeu també" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Truc" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Avís" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "inserix automàticament les docstring des dels mòduls" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "prova automàticament els fragments de codi en els blocs doctest" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "enllaç entre la documentació de Sphinx de projectes diferents" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "escriu les entrades «todo» que es poden mostrar o ocultar durant la construcció" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "comprovacions per a la cobertura de la documentació" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "inclou expressions matemàtiques, mostrades com a imatges PNG o SVG" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "inclou expressions matemàtiques, representades en el navegador per MathJax" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "inclusió condicional de contingut basat en els valors de la configuració" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "inclou els enllaços cap al codi font dels objectes documentats en Python" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "crea un fitxer .nojekyll per a publicar el document en les pàgines de GitHub" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Introduïu un nom de camí vàlid." - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Introduïu algun text." - -#: cmd/quickstart.py:133 +#: util/i18n.py:146 #, python-format -msgid "Please enter one of %s." -msgstr "Introduïu un dels %s." - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Introduïu qualsevol de «y» o «n»." - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Introduïu un sufix de fitxer, p. ex., «.rst» o «.txt»." +msgid "locale_dir %s does not exist" +msgstr "locale_dir %s no existix" -#: cmd/quickstart.py:229 +#: util/i18n.py:244 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Us donem la benvinguda a la utilitat d'inici ràpid de Sphinx %s." - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Introduïu els valors per a les configuracions següents (només premeu «Retorn»\nper a acceptar un valor predeterminat, si se'n dona un entre parèntesis)." +msgid "Invalid Babel locale: %r." +msgstr "La configuració regional «Babel» no és vàlida: %r." -#: cmd/quickstart.py:241 +#: util/i18n.py:253 #, python-format -msgid "Selected root path: %s" -msgstr "Camí arrel seleccionat: %s" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "Introduïu el camí arrel per a la documentació." - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Camí arrel per a la documentació" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "S'ha produït un error: ja existix un fitxer conf.py en el camí arrel seleccionat." - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "«sphinx-quickstart» no sobreescriurà els projectes de Sphinx existents." - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Introduïu un camí arrel nou (o premeu «Retorn» per a eixir)" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Teniu dues opcions per a col·locar el directori de construcció per a la\neixida de Sphinx. O utilitzeu un directori «_build» dins del camí arrel,\no els directoris separats «source» i «build» dins del camí arrel." - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Separa els directoris «source» i «build» (s/n)" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "Dins del directori arrel, es crearan dos directoris més: «_templates» per a\nles plantilles HTML personalitzades i «_static» per als fulls d'estil\npersonalitzats i altres fitxers estàtics. Podeu introduir un altre prefix\n(com «.») per a substituir el guió baix." - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Prefix de nom per als directoris «templates» i «static»" - -#: cmd/quickstart.py:297 msgid "" -"The project name will occur in several places in the built documentation." -msgstr "El nom del projecte apareixerà en diversos llocs de la documentació construïda." - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Nom del projecte" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Noms de l'autoria" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "Sphinx té la noció d'una «versió» i un «llançament» per al programari.\nCada versió pot tindre múltiples versions. Per exemple, per a Python,\nla versió és una cosa pareixent a 2.5 o 3.0, mentre que el llançament és\ncom 2.5.1 o 3.0a1. Si no necessiteu esta doble estructura, senzillament\nestabliu ambdues amb el mateix valor." - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Versió del projecte" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Llançament del projecte" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "Si els documents s'han d'escriure en un idioma que no siga l'anglés,\npodeu seleccionar un idioma ací per al vostre codi d'idioma.\nA continuació, Sphinx traduirà el text que es genera en este idioma.\n\nPer a obtindre una llista dels codis admesos, vegeu\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Idioma del projecte" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "El sufix del nom del fitxer per als fitxers d'origen. Normalment, este és\n«.txt» o «.rst». Només els fitxers amb este sufix es consideraran documents." - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Sufix del fitxer font" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "Un document és especial perquè es considera el node superior de l'«arbre de\ncontingut», és a dir, és l'arrel de l'estructura jeràrquica dels documents.\nNormalment, es tracta de l'«index», però si el document «index» és una\nplantilla personalitzada, també podreu establir-la a un altre nom de fitxer." - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Nom del document mestre (sense sufix)" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Format de data no vàlid. Citeu la cadena amb cometes senzilles si voleu generar-la directament: %s" -#: cmd/quickstart.py:367 +#: util/osutil.py:131 #, python-format msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "S'ha produït un error: el fitxer mestre %s ja es troba en el camí arrel seleccionat." - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "«sphinx-quickstart» no sobreescriurà el fitxer existent." - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Introduïu un nom de fitxer nou o canvieu-ne el nom i premeu «Retorn»" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Indiqueu quines de les extensions següents de Sphinx haurien d'estar habilitades:" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Nota: «imgmath» i «mathjax» no es poden habilitar alhora. «imgmath» ha sigut desseleccionat." - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Es pot generar un fitxer Makefile i un fitxer d'ordres de Windows,\nde manera que només haureu d'executar, p. ex., «make html»\nen lloc d'invocar directament «sphinx-build»." +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "S'ha interromput l'intent de còpia des de %s a %s (hi ha dades existents en el camí de destinació)." -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Voleu crear el Makefile? (s/n)" +#: util/display.py:82 +msgid "skipped" +msgstr "s'omet" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Voleu crear el fitxer d'ordres de Windows? (s/n)" +#: util/display.py:87 +msgid "failed" +msgstr "ha fallat" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: util/docutils.py:325 #, python-format -msgid "Creating file %s." -msgstr "S'està creant el fitxer %s." +msgid "unknown directive name: %s" +msgstr "nom desconegut de la directiva: %s" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: util/docutils.py:361 #, python-format -msgid "File %s already exists, skipping." -msgstr "El fitxer %s ja existix, se salta." - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Finalitzat: s'ha creat una estructura inicial del directori." +msgid "unknown role name: %s" +msgstr "nom desconegut del rol: %s" -#: cmd/quickstart.py:519 +#: util/docutils.py:805 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "Ara heu de completar el fitxer mestre %s i crear altres fitxers font de documentació. " - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Utilitzeu el Makefile per a construir els documents, com seguix:\n make builder" +msgid "unknown node type: %r" +msgstr "tipus de node desconegut: %r" -#: cmd/quickstart.py:530 +#: util/fileutil.py:76 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Utilitzeu l'ordre «sphinx-build» per a construir els documents, com seguix:\n sphinx-build -b constructor %s %s" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "on «constructor» és un dels constructors admesos, p. ex., html, latex o linkcheck." - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nGenereu els fitxers necessaris per a un projecte Sphinx.\n\n«sphinx-quickstart» és una eina interactiva que fa algunes preguntes sobre el\nprojecte i després genera un directori complet de documentació i un\nexemple del fitxer Makefile per a utilitzar-se amb l'ordre «sphinx-build».\n" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "Per a més informació, visiteu ." - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "mode silenciós" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "arrel del projecte" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Opcions de l'estructura" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "Si s'especifica, se separarà el codi font i els directoris de compilació" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "Si s'especifica, es crearà el directori de construcció a dins del directori d'origen" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "substitució per a punts a _templates, etc." - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Opcions bàsiques del projecte" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "nom del projecte" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "noms de l'autoria" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "versió del projecte" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "llançament del projecte" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "idioma del document" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "sufix del fitxer font" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "nom del document mestre" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "utilitza epub" - -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Opcions de l'extensió" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "S'ha interromput l'intent de còpia des de la plantilla representada %s a %s (hi ha dades existents en el camí de destinació)." -#: cmd/quickstart.py:670 +#: util/fileutil.py:89 #, python-format -msgid "enable %s extension" -msgstr "habilita l'extensió %s" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "habilita les extensions arbitràries" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Creeu els fitxers Makefile i de processament per lots" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "es crea el Makefile" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "no es crea el Makefile" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "es crea el fitxer de processament per lots" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "no es crea el fitxer de processament per lots" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "utilitza el mode make per a Makefile/make.bat" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Plantilles de projecte" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "directori de plantilles per als fitxers de plantilla" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "definix una variable de plantilla" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "s'especifica «quiet», però no s'especifica cap «project» o «author»." - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "S'ha produït un error: el camí especificat no és un directori o ja hi ha els fitxers de Sphinx." - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "«sphinx-quickstart» només generarà dins d'un directori buit. Especifiqueu un camí arrel nou." +msgid "Writing evaluated template result to %s" +msgstr "Escriu el resultat de la plantilla avaluada a %s" -#: cmd/quickstart.py:809 +#: util/docfields.py:103 #, python-format -msgid "Invalid template variable: %s" -msgstr "Variable no vàlida de plantilla: %s" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "el número de treball hauria de ser un nombre positiu" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\nGenerar la documentació a partir dels fitxers font.\n\nL'eina «sphinx-build» generarà la documentació a partir dels fitxers\na SOURCEDIR i els situarà a OUTPUTDIR. Busqueu el «conf.py» en el\nSOURCEDIR per als paràmetres de configuració. L'eina «sphinx-quickstart» es pot utilitzar per a generar fitxers de plantilla, inclòs el «conf.py».\n\nL'eina «sphinx-build» pot crear documentació en formats diferents. A la\nlínia d'ordres se selecciona un format que especifica el nom del constructor.\nDe manera predeterminada és HTML. Els constructors també poden dur a terme\naltres tasques relacionades amb el processament de la documentació.\n\nDe manera predeterminada, es construïx tot el que està desactualitzat. Es pot\ngenerar l'eixida només per als fitxers seleccionats especificant noms de fitxer\nindividuals.\n" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "camí cap als fitxers font de la documentació" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "camí cap al directori d'eixida" - -#: cmd/build.py:109 msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "(opcional) una llista de fitxers específics que s'han de reconstruir. S'ignorarà si s'especifica «--write-all»" - -#: cmd/build.py:114 -msgid "general options" -msgstr "opcions generals" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "Problema en el domini %s: se suposa que el camp utilitza el rol «%s», però no es troba en el domini." -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "constructor que s'utilitzarà (predeterminat: «html»)" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "no s'ha trobat el rol predeterminat %s" -#: cmd/build.py:131 +#: util/nodes.py:462 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "executa en paral·lel amb N processos, quan siga possible. «auto» uxa el nombre de nuclis de la CPU" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "escriu tots els fitxers (predeterminat: només escriu els fitxers nous i els que han canviat)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "no utilitzar un entorn guardat, llig sempre tots els fitxers" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "el toctree conté una referència cap al fitxer %r que no existix" -#: cmd/build.py:150 -msgid "path options" -msgstr "opcions de camí" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "excepció mentre només s'avaluava l'expressió directiva: %s" -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "directori per als fitxers doctree i d'entorn (predeterminat: OUTPUT_DIR/.doctrees)" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "ve de la pàgina anterior" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "directori per al fitxer de configuració (conf.py) (predeterminat: SOURCE_DIR)" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "continua en la pàgina següent" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "no utilitza cap fitxer de configuració, només utilitza la configuració de les opcions de «-D»" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "No alfabètic" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "superposa una configuració en el fitxer de configuració" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Símbols" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "passa un valor a dins de les plantilles HTML" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Números" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "definix l'etiqueta: inclou blocs «only» amb TAG" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "pàgina" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "mode primmirat: avisa sobre totes les referències que falten" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Versió" -#: cmd/build.py:212 -msgid "console output options" -msgstr "opcions d'eixida de la consola" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "No s'ha pogut recuperar la imatge remota: %s [%s]" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "augmenta la loquacitat (es pot repetir)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "No s'ha pogut recuperar la imatge remota: %s [%d]" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "sense eixida cap a l'eixida estàndard, només avisos a l'eixida d'error estàndard" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Format d'imatge desconegut: %s…" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "sense eixida, ni tan sols els avisos" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "No s'ha pogut determinar el text alternatiu per a la referència creuada. Podria ser un error." -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "emet una eixida amb colors (predeterminada: detecció automàtica)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "s'ha trobat més d'una destinació per a «any» en la referència creuada %r: podria ser %s" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "no emetre una eixida amb colors (predeterminada: detecció automàtica)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s no es troba la destinació de la referència: %s" -#: cmd/build.py:252 -msgid "warning control options" -msgstr "opcions de control d'avís" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r no es troba la destinació de la referència: %s" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "escriviu els avisos (i errors) al fitxer indicat" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "S'ha interromput!" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "convertix els avisos en errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "S'ha produït un error de marcatge en el reStructuredText!" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "mostra la traça completa en excepció" +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "S'ha produït un error de codificació!" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "executa Pdb en excepció" +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "S'ha produït un error de recursivitat!" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "planteja una excepció sobre els avisos" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "Açò pot passar amb fitxers font molt grans o molt imbricats. Podeu fer augmentar amb cura el límit predeterminat de la recursivitat de Python de 1.000 al «conf.py» amb, per exemple:" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "no es pot combinar l'opció -a i els noms de fitxer" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "S'està iniciant el depurador:" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" -msgstr "no es pot obrir el fitxer de l'avís «%s»: %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "S'ha guardat la traça completa a:" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "l'argument de l'opció «-D» haurà d'estar en la forma «nom=valor»" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "Per a informar d'este error als desenvolupadors, obriu un problema a . Gràcies!" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "l'argument de l'opció -A haurà d'estar en la forma «nom=valor»" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Informeu-ho també si es tractava d'un error d'usuari, de manera que la pròxima vegada es puga proporcionar un missatge d'error millor." #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Reduïx la barra lateral" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Taula de continguts" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navegueu" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Busca dins de %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Quant a estos documents" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Busca" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Ves fins a" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Última actualització el %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Creada mitjançant Sphinx %(sphinx_version)s." + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Tema anterior" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "capítol anterior" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Tema següent" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "capítol següent" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "Índex – %(key)s" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Índex complet en una pàgina" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Esta pàgina" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Mostra el codi font" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Contingut" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Busca ràpida" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Buscar a %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Ves fins a" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2683,7 +2885,7 @@ msgstr "Índex global de mòduls" msgid "quick access to all modules" msgstr "accés ràpid a tots els mòduls" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Índex general" @@ -2691,23 +2893,15 @@ msgstr "Índex general" msgid "all functions, classes, terms" msgstr "totes les funcions, classes, termes" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Esta pàgina" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Taula de continguts" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "Índex – %(key)s" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Índex complet en una pàgina" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Busca ràpida" +msgid "Search %(docstitle)s" +msgstr "Buscar a %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2717,57 +2911,6 @@ msgstr "Pàgines d'índex per lletra" msgid "can be huge" msgstr "pot ser gegant" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Tema anterior" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "capítol anterior" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Tema següent" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "capítol següent" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navegueu" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Busca dins de %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Quant a estos documents" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "© %(copyright_prefix)s %(copyright)s." - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Última actualització el %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Creada mitjançant Sphinx %(sphinx_version)s." - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2784,21 +2927,21 @@ msgstr "Buscar múltiples paraules només mostrarà les coincidències\n que msgid "search" msgstr "busca" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Oculta els resultats de busca" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Contingut" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Resultats de la busca" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "La vostra busca no ha coincidit amb cap document. Assegureu-vos que s'escriuen correctament totes les paraules i que heu seleccionat prou categories." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2806,22 +2949,21 @@ msgid_plural "" msgstr[0] "La busca ha acabat, s'ha trobat una pàgina que coincidix amb la consulta de busca." msgstr[1] "La busca ha acabat, s'han trobat ${resultCount} pàgines que coincidixen amb la consulta de busca." -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "S'està buscant" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "S'està preparant la busca…" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", a " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Oculta els resultats de busca" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2829,6 +2971,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Canvis en la versió %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2850,120 +2997,127 @@ msgstr "Altres canvis" msgid "Expand sidebar" msgstr "Expandix la barra lateral" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" -msgstr "" +msgstr "Separador de paràmetres només posicional (PEP 570)" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" -msgstr "" +msgstr "Separador de paràmetres només posicional (PEP 3102)" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Paràmetres" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variables" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Llença" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (en el mòdul %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (en el mòdul %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (variable interna)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (classe interna)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (classe a %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (mètode de classe %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (mètode estàtic %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (propietat %s)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "%s (escriviu l'àlies a %s)" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Índex de mòduls en Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "mòduls" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Obsolet" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "excepció" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "mètode de classe" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "mètode estàtic" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "propietat" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "escriviu l'àlies" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "descripció de l'objecte duplicat de %s, una altra instància a %s, ús «:no-index:» per a un d'ells" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "s'ha trobat més d'un objectiu per a la referència creuada %r: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (obsolet)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Paràmetres" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variables" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Llença" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "Declaració de C** duplicada, també definida a %s:%s.\nLa declaració és «.. cpp:%s:: %s»." #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2974,92 +3128,85 @@ msgstr "Paràmetres de la plantilla" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "Declaració de C** duplicada, també definida a %s:%s.\nLa declaració és «.. cpp:%s:: %s»." - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "Valors retornats" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "unió" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "membre" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tipus" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "concepte" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enumera" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "numerador" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "paràmetre de la funció" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "paràmetre de la plantilla" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Declaració de C duplicada, també definida a %s:%s.\nLa declaració és «.. c:%s:: %s»." -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "variable" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "macro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "estructura" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "variable d'entorn; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "%s; valor de configuració" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "Tipus" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "Predeterminat" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3146,522 +3293,430 @@ msgstr "numfig_format no vàlid: %s" #: domains/std/__init__.py:1453 #, python-format -msgid "undefined label: %r" -msgstr "etiqueta sense definir: %r" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "No s'ha pogut crear una referència creuada. No es troba un títol o subtítol: %r" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "s'han detectat referències circulars del toctree, s'ignora: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "el toctree conté una referència cap al document %r, el qual no conté un títol: no es generarà cap enllaç" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "el toctree conté una referència cap a un document no inclòs %r" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "vegeu %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "vegeu també %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "tipus d'entrada %r amb un índex desconegut" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Símbols" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "el fitxer d'imatge no es pot llegir: %s" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "el fitxer d'imatge %s no es pot llegir: %s" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "el fitxer de baixada no es pot llegir: %s" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s ja té assignats números de secció (toctree amb numeració imbricada?)" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "S'ha interromput!" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "S'ha guardat la traça completa a:" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "Per a informar d'este error als desenvolupadors, obriu un problema a . Gràcies!" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Informeu-ho també si es tractava d'un error d'usuari, de manera que la pròxima vegada es puga proporcionar un missatge d'error millor." - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "No s'ha pogut determinar el text alternatiu per a la referència creuada. Podria ser un error." - -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "s'ha trobat més d'una destinació per a «any» en la referència creuada %r: podria ser %s" - -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s no es troba la destinació de la referència: %s" - -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "%r no es troba la destinació de la referència: %s" +msgid "undefined label: %r" +msgstr "etiqueta sense definir: %r" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "No s'ha pogut recuperar la imatge remota: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "No s'ha pogut crear una referència creuada. No es troba un títol o subtítol: %r" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "No s'ha pogut recuperar la imatge remota: %s [%d]" +msgid "invalid value set (missing closing brace): %s" +msgstr "conjunt de valors no vàlid (falta el claudàtor de tancament): %s" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." -msgstr "Format d'imatge desconegut: %s…" +msgid "invalid value set (missing opening brace): %s" +msgstr "conjunt de valors no vàlid (falta el claudàtor d'obertura): %s" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "Les pàgines en HTML es troben a %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" +msgstr "Cadena incorrecta literal (falten les cometes de tancament): %s" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" -msgstr "No s'ha pogut llegir el fitxer d'informació de la construcció: %r" +msgid "malformed string literal (missing opening quote): %s" +msgstr "Cadena incorrecta literal (falten les cometes d'obertura): %s" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "build_info no coincidix, s'està copiant .buildinfo a .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Exemple" -#: builders/html/__init__.py:366 -msgid "building [html]: " -msgstr "es construïx [html]:" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Exemples" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "s'ha canviat la plantilla %s des de la compilació anterior, es reconstruiran tots els documents" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Arguments de paraules clau" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "índex" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Notes" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "Logotip de %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Altres paràmetres" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "següent" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "Rebudes" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "anterior" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Referències" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "s'estan generant els índexs" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Avisos" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "s'estan escrivint les pàgines addicionals" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "Rendiments" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "no es pot copiar el fitxer d'imatge «%s»: %s" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "s'estan copiant els fitxers que es poden baixar… " +msgid "A mocked object is detected: %r" +msgstr "S'ha detectat un objecte simulat: %r" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "no s'ha pogut copiar el fitxer que es podia baixar %r: %s" +msgid "alias of %s" +msgstr "àlies de %s" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "No s'ha pogut copiar un fitxer en el directori «static» del tema: %s: %r" +msgid "Bases: %s" +msgstr "Bases: %s" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "No s'ha pogut copiar un fitxer en html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" +msgstr "valor no vàlid per a l'opció de l'ordre de membre: %s" -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "s'estan copiant els fitxers estàtics" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "valor no vàlid per a l'opció des de la documentació de classes: %s" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" -msgstr "no s'ha pogut copiar el fitxer estàtic %r" +msgid "invalid signature for auto%s (%r)" +msgstr "signatura no vàlida per a auto%s (%r)" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "s'estan copiant els fitxers addicionals" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "es desconeix quin és el mòdul que s'importarà per al document automàtic %r (proveu de col·locar una directiva «module» o «currentmodule» en el document o doneu-li un nom explícit al mòdul)" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" -msgstr "no s'ha pogut copiar el fitxer addicional %r" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" -msgstr "No s'ha pogut escriure el fitxer d'informació de la construcció: %r" +msgid "return annotation given for automodule: '%s'" +msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "no s'ha pogut carregar l'índex de busca, i no es construiran tots els documents: l'índex estarà incomplet." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "«::» en el nom de l'«automodule» no té sentit" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "la pàgina %s coincidix amb dos patrons en html_sidebars: %r i %r" +msgid "Failed to remove %s: %s" +msgstr "S'ha fallat en eliminar %s: %s" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "S'hauria de crear el fitxer %s." + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "s'ha produït un error d'Unicode en representar la pàgina %s. Assegureu-vos que tots els valors de configuració que contenen contingut que no és ASCII són cadenes Unicode." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nMireu recursivament a per als mòduls i paquets de Python\ni creeu un fitxer reST amb les directives «automodule» per paquet en el .\n\nEls poden ser fitxers i/o patrons de directori que seran\nexclosos de la generació.\n\nNota: De manera predeterminada, este script no sobreescriurà els fitxers que ja s'han creat." -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "camí cap al mòdul que es documenta" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "S'ha produït un error en representar la pàgina %s.\nMotiu: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "fitxer d'estil fnmatch i/o patrons de directori que s'exclouran de la generació" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "s'està bolcant l'inventari d'objectes" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "directori per a col·locar tota l'eixida" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "s'està bolcant l'índex de busca a %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "profunditat màxima dels submòduls que es mostraran en la TOC (predeterminada: 4)" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "js_file no vàlid: %r, s'ignora" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "sobreescriu els fitxers existents" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "S'han enregistrat molts math_renderer. Però no s'ha seleccionat math_renderer." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "seguir els enllaços simbòlics. Potent quan es combina amb el paquet collective.recipe.omelette." -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "S'ha donat un math_renderer %r desconegut." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "executa l'script sense crear els fitxers" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "l'entrada html_extra_path %r es col·loca dins del directori d'eixida" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "posa la documentació per a cada mòdul en la seua pròpia pàgina" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "l'entrada html_extra_path %r no existix" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "inclou «_private» en els mòduls" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "l'entrada html_static_path %r es col·loca dins del directori d'eixida" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "nom de fitxer de la taula de contingut (predeterminat: mòduls)" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" -msgstr "l'entrada html_static_path %r no existix" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "no crea un fitxer de taula de contingut" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "el fitxer de logotip %r no existix" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "no crea capçaleres per als paquets del mòdul/paquet (p. ex., quan les cadenes de documentació ja les contenen)" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" -msgstr "el fitxer icona de web %r no existix" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "posa la documentació del mòdul abans de la documentació del submòdul" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." -msgstr "Els valors a «html_sidebars» han de ser una llista de cadenes. Almenys un patró té un valor de cadena: %s. Canvia a «html_sidebars = %r»." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "interpreta els camins dels mòduls segons l'especificació d'espais de nom implícits al PEP-0420" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "HTML 4 ja no és compatible amb Sphinx. (s'ha detectat «html4_writer=true» en les opcions de configuració)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "Llista d'opcions separades per comes que es passarà a la directiva «automodule» (o utilitzeu SPHINX_APIDOC_OPTIONS)." -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" -msgstr "%s %s documentació" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "sufix del fitxer (predeterminat: rst)" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" -msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (versió desconeguda)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "Elimina els fitxers existents en el directori d'eixida que no s'hagen generat" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" -msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (falta l'entrada «config»)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "genera un projecte complet amb «sphinx-quickstart»" + +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "afig module_path a sys.path, s'utilitza quan s'indica el paràmetre «--full»" + +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "nom del projecte (predeterminat: nom del mòdul arrel)" + +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "autoria del projecte, s'utilitza quan s'indica el paràmetre «--full»" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" -msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (falta l'entrada «tags»)" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "versió del projecte, s'utilitza quan s'indica el paràmetre «--full»" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Els fitxers en LaTeX es troben a %(outdir)s." +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "llançament del projecte, s'utilitza quan s'indica el paràmetre «--full», predeterminat a «--doc-version»" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nExecuteu l'ordre «make» en este directori per a executar-les\nmitjançant (pdf)latex (utilitzeu l'ordre «make latexpdf» per a fer-ho\nautomàticament)." +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "opcions de l'extensió" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "no s'ha trobat el valor de configuració «latex_documents»: no s'escriurà cap document" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "habilita les extensions arbitràries, que s'utilitzen quan s'indica «--full»" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "El valor de configuració «latex_documents» fa referència a un document %s desconegut" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Versió" +msgid "enable %s extension, used when --full is given" +msgstr "habilita l'extensió %s, que s'utilitza quan s'indica «--full»" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "s'estan copiant els fitxers de suport de TeX" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "%s no és cap directori." -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "s'estan copiant els fitxers addicionals" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "S'està executant apidoc" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "Clau de configuració desconeguda: latex_elements[%r], s'ignora." +msgid "apidoc_modules item %i must be a dict" +msgstr "«apidoc_modules» l'element %i ha de ser un diccionari" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "Opció desconeguda de tema: latex_theme_options[%r], s'ignora." - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" -msgstr "No s'ha pogut obtindre el docname!" +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "«apidoc_modules» l'element %i ha de tindre una clau «path»." -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" -msgstr "S'ha fallat en obtindre un nom de document per a la font %r!" +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "«apidoc_modules» l'element «path» %i ha de ser una cadena" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" -msgstr "No s'ha trobat cap nota a peu de pàgina per al node de referència %r donat" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "«apidoc_modules» l'element «path» %i no és una carpeta existent: %s" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r no té la configuració «theme»" +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "«apidoc_modules» l'element %i ha de tindre una clau «destination»" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r no té la configuració «%s»" +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "«apidoc_modules» l'element «destination» %i ha de ser una cadena" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "ve de la pàgina anterior" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "«apidoc_modules» l'element «destination» %i hauria de ser un camí relatiu" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "continua en la pàgina següent" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "«apidoc_modules» l'element %i no pot crear el directori de destinació: %s" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "No alfabètic" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "«apidoc_modules» l'element %i «%s» ha de ser un nombre enter" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Números" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "«apidoc_modules» l'element %i «%s» ha de ser un booleà" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "pàgina" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "«apidoc_modules» l'element %i té claus inesperades: %s" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Arguments de paraules clau" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "«apidoc_modules» l'element %i «%s» ha de ser una seqüència" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "conjunt de valors no vàlid (falta el claudàtor de tancament): %s" +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "«apidoc_modules» l'element %i «%s» ha de contindre cadenes" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "conjunt de valors no vàlid (falta el claudàtor d'obertura): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "autosummary: ha fallat en determinar %r que s'ha de documentar, s'ha plantejat l'excepció següent:\n%s" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "Cadena incorrecta literal (falten les cometes de tancament): %s" +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] s'està generant autosummary per a: %s" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "Cadena incorrecta literal (falten les cometes d'obertura): %s" +msgid "[autosummary] writing to %s" +msgstr "[autosummary] s'està escrivint a %s" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Exemple" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "[autosummary]: ha fallat en importar %s.\nPossibles pistes:\n%s" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Exemples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nGenera ReStructuredText mitjançant directrius de resum automàtic «autosummary».\n\n«sphinx-autogen» és un frontal per a sphinx.ext.autosummary.generate.\nGenera els fitxers en reStructuredText des de les directrius d'autosummary\ncontingudes en els fitxers d'entrada indicats.\n\nEl format de les directrius d'autosummary està documentat en el mòdul\n``sphinx.ext.autosummary`` de Python i es pot llegir mitjançant l'ordre següent::\n\npydoc sphinx.ext.autosummary\n" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "fitxers font per a generar els fitxers rST per a" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Altres paràmetres" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "directori per a col·locar tota l'eixida cap a" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "Rebudes" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "sufix predeterminat per als fitxers (predeterminat: %(default)s)" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Referències" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "directori de plantilles personalitzades (predeterminat: %(default)s)" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Avisos" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "document de membres importats (predeterminat: %(default)s)" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "Rendiments" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "documenta exactament els membres en l'atribut __all__ del mòdul (predeterminat: %(default)s)." -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "referències autosummary excloses del document %r. S'ignora." -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: no s'ha trobat el fitxer stub %r. Verifiqueu la vostra configuració autosummary_generate." -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "Un resum automàtic amb subtítols requerix l'opció «:toctree:». S'ignora." -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3669,548 +3724,585 @@ msgid "" "%s" msgstr "autosummary: ha fallat en importar %s.\nPossibles pistes:\n%s" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "ha fallat en l'anàlisi sintàctica del nom %s" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "ha fallat en importar l'objecte %s" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "Els elements resumits no han d'incloure el mòdul actual. Substituïu %r per %r." -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: no s'ha trobat el fitxer: %s" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "«autosummary» genera internament els fitxers «.rst». Però el vostre source_suffix no conté cap «.rst». S'omet." -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "autosummary: ha fallat en determinar %r que s'ha de documentar, s'ha plantejat l'excepció següent:\n%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "L'identificador «%r» del projecte intersphinx no és vàlid en intersphinx_mapping. Els identificadors de projecte han de ser cadenes no buides." -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[autosummary] s'està generant autosummary per a: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "El valor «%r» no és vàlid en intersphinx_mapping[%r]. S'esperava una tupla o llista de dos elements." -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[autosummary] s'està escrivint a %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "El valor «%r» no és vàlid en intersphinx_mapping[%r]. Els valors han de ser un parell (URI de destinació, ubicacions de l'inventari)." -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "[autosummary]: ha fallat en importar %s.\nPossibles pistes:\n%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "El valor «%r» de l'URI de destinació no és vàlid en intersphinx_mapping[%r][0]. Els URI de destinació han de ser cadenes úniques no buides." -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nGenera ReStructuredText mitjançant directrius de resum automàtic «autosummary».\n\n«sphinx-autogen» és un frontal per a sphinx.ext.autosummary.generate.\nGenera els fitxers en reStructuredText des de les directrius d'autosummary\ncontingudes en els fitxers d'entrada indicats.\n\nEl format de les directrius d'autosummary està documentat en el mòdul\n``sphinx.ext.autosummary`` de Python i es pot llegir mitjançant l'ordre següent::\n\npydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "El valor «%r» de l'URI de destinació no és vàlid en intersphinx_mapping[%r][0]. Els URI de destinació han de ser únics (una altra instància en intersphinx_mapping[%r])." -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "fitxers font per a generar els fitxers rST per a" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "El valor «%r» d'ubicació de l'inventari no és vàlid en intersphinx_mapping[%r][1]. Les ubicacions de l'inventari han de ser cadenes no buides o «None»." -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "directori per a col·locar tota l'eixida cap a" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "Configureu «intersphinx_mapping» no vàlida (1 error)." + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "Configureu «intersphinx_mapping» no vàlida (%s errors)." + +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "S'ha afegit una entrada intersphinx_mapping no vàlida després de la normalització." + +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "s'està carregant l'inventari intersphinx «%s» de %s …" + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "s'han trobat alguns problemes amb alguns dels inventaris, però tenien alternatives funcionals:" + +#: ext/intersphinx/_load.py:332 +#, python-format +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "sufix predeterminat per als fitxers (predeterminat: %(default)s)" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "s'ha mogut l'inventari intersphinx: %s -> %s" -#: ext/autosummary/generate.py:882 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "directori de plantilles personalitzades (predeterminat: %(default)s)" +msgid "(in %s %s)" +msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "document de membres importats (predeterminat: %(default)s)" +msgid "(in %s)" +msgstr "(a %s)" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "documenta exactament els membres en l'atribut __all__ del mòdul. (predeterminat: %(default)s)" - -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" -msgstr "Elimina els fitxers existents en el directori d'eixida que no s'hagen generat" +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "inventari «%s»: s'han trobat coincidències duplicades per a %s:%s" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Failed to remove %s: %s" -msgstr "S'ha fallat en eliminar %s: %s" +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "inventari «%s»: s'han trobat múltiples coincidències per a %s:%s" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nMireu recursivament a per als mòduls i paquets de Python\ni creeu un fitxer reST amb les directives «automodule» per paquet en el .\n\nEls poden ser fitxers i/o patrons de directori que seran\nexclosos de la generació.\n\nNota: De manera predeterminada, este script no sobreescriurà els fitxers que ja s'han creat." +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "no es troba l'inventari per a la referència creuada externa: %r" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "camí cap al mòdul que es documenta" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "no es troba l'inventari per a la referència creuada externa: %r" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "fitxer d'estil fnmatch i/o patrons de directori que s'exclouran de la generació" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "no es troba el domini per a la referència creuada externa: %r" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "directori per a col·locar tota l'eixida" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "%s externa: no es troba la destinació de la referència %s: %s" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "profunditat màxima dels submòduls que es mostraran en la TOC (predeterminada: 4)" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "s'ha produït un error mentre es donava format a la signatura per a %s: %s" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "sobreescriu els fitxers existents" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "seguir els enllaços simbòlics. Potent quan es combina amb el paquet collective.recipe.omelette." +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "No s'ha pogut obtindre una signatura de funció per a %s: %s" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "executa l'script sense crear els fitxers" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "No s'ha pogut actualitzar la signatura per a %r: no es troba el paràmetre: %s" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "posa la documentació per a cada mòdul en la seua pròpia pàgina" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "No s'ha pogut analitzar type_comment per a %r: %s" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "inclou «_private» en els mòduls" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "S'han trobat __slots__ no vàlids a %s. S'ignora." -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "nom de fitxer de la taula de contingut (predeterminat: mòduls)" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "s'ha produït un error mentre es donava format als arguments per a %s: %s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "no crea un fitxer de taula de contingut" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "No s'ha pogut obtindre un constructor de funció per a %s: %s" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "no crea capçaleres per als paquets del mòdul/paquet (p. ex., quan les cadenes de documentació ja les contenen)" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "No s'ha pogut obtindre una signatura de mètode per a %s: %s" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "posa la documentació del mòdul abans de la documentació del submòdul" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "interpreta els camins dels mòduls segons l'especificació d'espais de nom implícits al PEP-0420" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "No s'ha pogut analitzar un valor d'argument predeterminat per a %r: %s" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "sufix del fitxer (predeterminat: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "autodoc: ha fallat en determinar %s. %s (%r) que s'ha de documentar, s'ha plantejat l'excepció següent:\n%s" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "genera un projecte complet amb «sphinx-quickstart»" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "arguments de signatura o anotació de retorn indicats per a «automodule» %s" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "afig module_path a sys.path, s'utilitza quan s'indica el paràmetre «--full»" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ ha de ser una llista de cadenes, no %r (en el mòdul %s) -s'ignora __all__-" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "nom del projecte (predeterminat: nom del mòdul arrel)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "falta l'atribut esmentat en l'opció «:members:»: mòdul %s, atribut %s" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "autoria del projecte, s'utilitza quan s'indica el paràmetre «--full»" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "falta l'atribut %s en l'objecte %s" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "versió del projecte, s'utilitza quan s'indica el paràmetre «--full»" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "àlies de TypeVar(%s)" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "llançament del projecte, s'utilitza quan s'indica el paràmetre «--full», predeterminat a «--doc-version»" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (versió desconeguda)" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "opcions de l'extensió" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (falta l'entrada «config»)" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" -msgstr "" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "s'ha fallat en llegir el fitxer d'informació de la compilació trencada (falta l'entrada «tags»)" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "Les pàgines en HTML es troben a %(outdir)s." -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." -msgstr "%s no és cap directori." - -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" -msgstr "" +msgid "Failed to read build info file: %r" +msgstr "No s'ha pogut llegir el fitxer d'informació de la construcció: %r" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" -msgstr "" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "build_info no coincidix, s'està copiant .buildinfo a .buildinfo.bak" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" -msgstr "" +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "es construïx [html]:" -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" -msgstr "" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "s'ha canviat la plantilla %s des de la compilació anterior, es reconstruiran tots els documents" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" -msgstr "" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "índex" -#: ext/apidoc/_extension.py:133 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +msgid "Logo of %s" +msgstr "Logotip de %s" -#: ext/apidoc/_extension.py:140 -#, python-format -msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "següent" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "anterior" -#: ext/apidoc/_extension.py:157 -#, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" -msgstr "" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "s'estan generant els índexs" -#: ext/apidoc/_extension.py:178 -#, python-format -msgid "apidoc_modules item %i '%s' must be an int" -msgstr "" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "s'estan escrivint les pàgines addicionals" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +msgid "cannot copy image file '%s': %s" +msgstr "no es pot copiar el fitxer d'imatge «%s»: %s" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" -msgstr "" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "s'estan copiant els fitxers que es poden baixar… " -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "no s'ha pogut copiar el fitxer que es podia baixar %r: %s" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgstr "No s'ha pogut copiar un fitxer en el directori «static» del tema: %s: %r" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:871 #, python-format -msgid "Would create file %s." -msgstr "S'hauria de crear el fitxer %s." +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "No s'ha pogut copiar un fitxer en html_static_file: %s: %r" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s v%s)" -msgstr "(a %s versió %s)" +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "s'estan copiant els fitxers estàtics" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:923 #, python-format -msgid "(in %s)" -msgstr "(a %s)" +msgid "cannot copy static file %r" +msgstr "no s'ha pogut copiar el fitxer estàtic %r" -#: ext/intersphinx/_resolve.py:108 -#, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "inventari «%s»: s'han trobat coincidències duplicades per a %s:%s" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "s'estan copiant els fitxers addicionals" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:938 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "inventari «%s»: s'han trobat múltiples coincidències per a %s:%s" +msgid "cannot copy extra file %r" +msgstr "no s'ha pogut copiar el fitxer addicional %r" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:944 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "no es troba l'inventari per a la referència creuada externa: %r" +msgid "Failed to write build info file: %r" +msgstr "No s'ha pogut escriure el fitxer d'informació de la construcció: %r" -#: ext/intersphinx/_resolve.py:392 -#, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "no es troba l'inventari per a la referència creuada externa: %r" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "no s'ha pogut carregar l'índex de busca, i no es construiran tots els documents: l'índex estarà incomplet." -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:1038 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "no es troba el domini per a la referència creuada externa: %r" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "la pàgina %s coincidix amb dos patrons en html_sidebars: %r i %r" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1204 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "%s externa: no es troba la destinació de la referència %s: %s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "s'ha produït un error d'Unicode en representar la pàgina %s. Assegureu-vos que tots els valors de configuració que contenen contingut que no és ASCII són cadenes Unicode." -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "L'identificador «%r» del projecte intersphinx no és vàlid en intersphinx_mapping. Els identificadors de projecte han de ser cadenes no buides." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" +msgstr "El tema «%s» no admet aquesta versió de Sphinx, perquè utilitza el camp «style» en les plantilles HTML, el qual és obsolet en Sphinx 5.1 i s'ha eliminat en Sphinx 7.0. El tema s'ha d'actualitzar per a utilitzar en el seu lloc el camp «styles». Vegeu https://www.sphinx-doc.org/en/master/development/html_themes/templating.html#styles" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "El valor «%r» no és vàlid en intersphinx_mapping[%r]. S'esperava una tupla o llista de dos elements." +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "S'ha produït un error en representar la pàgina %s.\nMotiu: %r" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "s'està bolcant l'inventari d'objectes" + +#: builders/html/__init__.py:1266 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "El valor «%r» no és vàlid en intersphinx_mapping[%r]. Els valors han de ser un parell (URI de destinació, ubicacions de l'inventari)." +msgid "dumping search index in %s" +msgstr "s'està bolcant l'índex de busca a %s" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "El valor «%r» de l'URI de destinació no és vàlid en intersphinx_mapping[%r][0]. Els URI de destinació han de ser cadenes úniques no buides." +msgid "invalid js_file: %r, ignored" +msgstr "js_file no vàlid: %r, s'ignora" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "S'han enregistrat molts math_renderer. Però no s'ha seleccionat math_renderer." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "El valor «%r» de l'URI de destinació no és vàlid en intersphinx_mapping[%r][0]. Els URI de destinació han de ser únics (una altra instància en intersphinx_mapping[%r])." +msgid "Unknown math_renderer %r is given." +msgstr "S'ha donat un math_renderer %r desconegut." -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "El valor «%r» d'ubicació de l'inventari no és vàlid en intersphinx_mapping[%r][1]. Les ubicacions de l'inventari han de ser cadenes no buides o «None»." +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "l'entrada html_extra_path %r es col·loca dins del directori d'eixida" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "Configureu «intersphinx_mapping» no vàlida (1 error)." +#: builders/html/__init__.py:1370 +#, python-format +msgid "html_extra_path entry %r does not exist" +msgstr "l'entrada html_extra_path %r no existix" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1385 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "Configureu «intersphinx_mapping» no vàlida (%s errors)." +msgid "html_static_path entry %r is placed inside outdir" +msgstr "l'entrada html_static_path %r es col·loca dins del directori d'eixida" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "S'ha afegit una entrada intersphinx_mapping no vàlida després de la normalització." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" +msgstr "l'entrada html_static_path %r no existix" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "s'està carregant l'inventari intersphinx «%s» de %s …" +msgid "logo file %r does not exist" +msgstr "el fitxer de logotip %r no existix" + +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "el fitxer icona de web %r no existix" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1425 +#, python-format msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "s'han trobat alguns problemes amb alguns dels inventaris, però tenien alternatives funcionals:" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." +msgstr "Els valors a «html_sidebars» han de ser una llista de cadenes. Almenys un patró té un valor de cadena: %s. Canvia a «html_sidebars = %r»." -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "s'ha fallat en arribar fins a cap dels inventaris amb els problemes següents:" +#: builders/html/__init__.py:1438 +msgid "" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "HTML 4 ja no és compatible amb Sphinx. (s'ha detectat «html4_writer=true» en les opcions de configuració)" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "s'ha mogut l'inventari intersphinx: %s -> %s" +msgid "%s %s documentation" +msgstr "%s %s documentació" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "valor no vàlid per a l'opció de l'ordre de membre: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r no té la configuració «theme»" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "valor no vàlid per a l'opció des de la documentació de classes: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r no té la configuració «%s»" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "signatura no vàlida per a auto%s (%r)" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "No s'ha pogut obtindre el docname!" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "s'ha produït un error mentre es donava format als arguments per a %s: %s" +msgid "Failed to get a docname for source %r!" +msgstr "S'ha fallat en obtindre un nom de document per a la font %r!" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "autodoc: ha fallat en determinar %s. %s (%r) que s'ha de documentar, s'ha plantejat l'excepció següent:\n%s" +msgid "No footnote was found for given reference node %r" +msgstr "No s'ha trobat cap nota a peu de pàgina per al node de referència %r donat" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Els fitxers en LaTeX es troben a %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "es desconeix quin és el mòdul que s'importarà per al document automàtic %r (proveu de col·locar una directiva «module» o «currentmodule» en el document o doneu-li un nom explícit al mòdul)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nExecuteu l'ordre «make» en este directori per a executar-les\nmitjançant el (pdf)latex (utilitzeu l'ordre «make latexpdf» per a fer-ho\nautomàticament)." -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" -msgstr "S'ha detectat un objecte simulat: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "no s'ha trobat el valor de configuració «latex_documents»: no s'escriurà cap document" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "s'ha produït un error mentre es donava format a la signatura per a %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "El valor de configuració «latex_documents» fa referència a un document %s desconegut" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "«::» en el nom de l'«automodule» no té sentit" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "s'estan copiant els fitxers de suport de TeX" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "arguments de signatura o anotació de retorn indicats per a «automodule» %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "s'estan copiant els fitxers addicionals" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ ha de ser una llista de cadenes, no %r (en el mòdul %s) -s'ignora __all__-" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Clau de configuració desconeguda: latex_elements[%r], s'ignora." -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "falta l'atribut esmentat en l'opció «:members:»: mòdul %s, atribut %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "Opció desconeguda de tema: latex_theme_options[%r], s'ignora." -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "No s'ha pogut obtindre una signatura de funció per a %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s ja té assignats números de secció (toctree amb numeració imbricada?)" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "No s'ha pogut obtindre un constructor de funció per a %s: %s" +msgid "image file not readable: %s" +msgstr "el fitxer d'imatge no es pot llegir: %s" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" -msgstr "Bases: %s" +msgid "image file %s not readable: %s" +msgstr "el fitxer d'imatge %s no es pot llegir: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" -msgstr "falta l'atribut %s en l'objecte %s" +msgid "download file not readable: %s" +msgstr "el fitxer de baixada no es pot llegir: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" -msgstr "àlies de %s" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "s'han detectat referències circulars del toctree, s'ignora: %s <- %s" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "àlies de TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "el toctree conté una referència cap al document %r, el qual no conté un títol: no es generarà cap enllaç" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "No s'ha pogut obtindre una signatura de mètode per a %s: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "el toctree conté una referència cap a un document no inclòs %r" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "S'han trobat __slots__ no vàlids a %s. S'ignora." +msgid "toctree contains reference to non-existing document %r" +msgstr "el toctree conté una referència cap al document inexistent %r" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "No s'ha pogut analitzar un valor d'argument predeterminat per a %r: %s" +msgid "see %s" +msgstr "vegeu %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "No s'ha pogut actualitzar la signatura per a %r: no es troba el paràmetre: %s" +msgid "see also %s" +msgstr "vegeu també %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "No s'ha pogut analitzar type_comment per a %r: %s" +msgid "unknown index entry type %r" +msgstr "tipus d'entrada %r amb un índex desconegut" diff --git a/sphinx/locale/cak/LC_MESSAGES/sphinx.mo b/sphinx/locale/cak/LC_MESSAGES/sphinx.mo index 7b1521c4231..55516460e5d 100644 Binary files a/sphinx/locale/cak/LC_MESSAGES/sphinx.mo and b/sphinx/locale/cak/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/cak/LC_MESSAGES/sphinx.po b/sphinx/locale/cak/LC_MESSAGES/sphinx.po index f09a9bb52b5..dcf3155e824 100644 --- a/sphinx/locale/cak/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/cak/LC_MESSAGES/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Julien Malard , 2019\n" "Language-Team: Kaqchikel (http://app.transifex.com/sphinx-doc/sphinx-1/language/cak/)\n" @@ -19,6 +19,127 @@ msgstr "" "Language: cak\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -33,127 +154,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "xk'isïk" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "sachoj: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +322,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,471 +537,627 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Ruwachib'äl %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Kik'ajtz'ïk %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Sachoj" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "" +#: locale/__init__.py:236 +msgid "See also" +msgstr "Tatz'u chuqa'" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:204 +#: builders/texinfo.py:41 #, python-format -msgid "domain %s already registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:235 -#, python-format -msgid "The %r directive is already registered to domain %s" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:253 +#: builders/texinfo.py:85 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:266 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "tajin nutz'ib'aj" + +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "(chupam" + +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:353 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_suffix %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:363 -#, python-format -msgid "source_parser for %r is already registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:372 +#: builders/texinfo.py:218 #, python-format -msgid "Source parser for %s not registered" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:390 +#: builders/manpage.py:37 #, python-format -msgid "Translator for %r already exists" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:496 +#: builders/manpage.py:64 #, python-format -msgid "enumerable_node %r already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:512 +#: builders/singlehtml.py:35 #, python-format -msgid "math renderer %s is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:529 -#, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:552 +#: builders/gettext.py:243 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:565 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "building [%s]: " msgstr "" -#: registry.py:577 +#: builders/gettext.py:265 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "targets for %d template files" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:229 +#: builders/linkcheck.py:87 #, python-format -msgid "invalid CVE number %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:159 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:561 #, python-format -msgid "invalid CWE number %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:317 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid PEP number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:355 +#: builders/epub3.py:83 #, python-format -msgid "invalid RFC number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:118 +#: builders/xml.py:29 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:124 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid option." +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:139 +#: builders/xml.py:103 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:436 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:467 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:568 -#, python-format -msgid "ignoring invalid doctest code: %r" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/imgmath.py:380 +#: builders/_epub_base.py:594 #, python-format -msgid "inline latex %r: %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 #, python-format msgid "invalid regex %r in %s" msgstr "" @@ -739,9 +1175,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -776,6 +1213,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Chi tiqib'ana'" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(Ri <> k'o chupam %s, pa juch' %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -863,949 +1328,995 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Chi tiqib'ana'" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" - -#: ext/todo.py:154 +#: ext/imgmath.py:167 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(Ri <> k'o chupam %s, pa juch' %d.)" - -#: ext/todo.py:166 -msgid "original entry" -msgstr "" - -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: directives/code.py:87 +#: ext/imgmath.py:326 #, python-format -msgid "Invalid caption: %s" +msgid "display latex %r: %s" msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/imgmath.py:362 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:231 +#: ext/doctest.py:118 #, python-format -msgid "Include file '%s' not found or reading it failed" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:124 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:139 #, python-format -msgid "Object named %r not found in include file %r" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:314 +#: ext/doctest.py:297 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "" - -#: directives/patches.py:71 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/other.py:119 +#: ext/doctest.py:451 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/doctest.py:568 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/other.py:156 +#: ext/autosectionlabel.py:52 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:169 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: builders/changes.py:56 -#, python-format -msgid "no changes in version %s." +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:133 +#: domains/citation.py:75 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/citation.py:92 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "tajin nutz'ib'aj" - -#: builders/manpage.py:71 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:183 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s() (built-in function)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s() (%s method)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:275 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "all of %d po files" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:309 -#, python-format -msgid "targets for %d po files that are out of date" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:337 +#: domains/javascript.py:374 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "Ruwäch" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:410 +#: domains/javascript.py:458 #, python-format -msgid "%d found" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:531 +#: domains/rst.py:262 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:32 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:713 +#: domains/__init__.py:322 #, python-format -msgid "docnames to write: %s" +msgid "%s %s" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr "(chupam" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Ütz apetïk pa rokisanem runuk'ik Sphinx %s." -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:298 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Rub'i' samäj" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Kib'i' ajtz'ib'anel(a')" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Rujalwäch samäj" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Ruch'ab'äl samaj" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:350 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "rusachoj rusik'inïk: %s, %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "rusachoj rutz'ib'axïk: %s, %s" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" + +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: util/nodes.py:706 +#: cmd/quickstart.py:671 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "enable %s extension" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[wachib'äl: %s]" +#: directives/other.py:209 +msgid "Author: " +msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[wachib'äl]" +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Cholwuj" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" +msgstr "" + +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:276 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "Object named %r not found in include file %r" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" msgstr "" -#: writers/latex.py:1183 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Cholwuj" + +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" msgstr "" -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/texinfo.py:1303 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "unimplemented node type: %r" msgstr "" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[wachib'äl: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[wachib'äl]" + #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" msgstr "" @@ -1832,6 +2343,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1848,775 +2364,472 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "Ruwäch" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" -msgstr "Sachoj" - -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "rusachoj rusik'inïk: %s, %s" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Tatz'u chuqa'" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "rusachoj rutz'ib'axïk: %s, %s" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:523 #, python-format -msgid "Please enter one of %s." +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Ütz apetïk pa rokisanem runuk'ik Sphinx %s." - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Ajilanïk" + +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "" - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Rub'i' samäj" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Kib'i' ajtz'ib'anel(a')" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Rujalwäch samäj" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Ruch'ab'äl samaj" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "" - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "" - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "" - -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "" - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "" - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "" - -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: transforms/post_transforms/images.py:79 #, python-format -msgid "Creating file %s." +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "File %s already exists, skipping." -msgstr "" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:519 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:526 +#: transforms/post_transforms/__init__.py:88 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:530 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:670 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "Invalid template variable: %s" +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:109 +#: _cli/util/errors.py:207 msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:131 +#: _cli/util/errors.py:240 msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:157 +#: _cli/util/errors.py:246 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +msgid "Index – %(key)s" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Ruxaq wuj re'" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" #: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 @@ -2624,19 +2837,6 @@ msgstr "" msgid "Go" msgstr "" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "" - #: themes/basic/defindex.html:4 msgid "Overview" msgstr "" @@ -2649,122 +2849,63 @@ msgstr "Ütz apetïk! Wawe' k'o" msgid "the documentation for" msgstr "ri wuj richin" -#: themes/basic/defindex.html:10 -msgid "last updated" -msgstr "" - -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" -msgstr "" - -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" -msgstr "" - -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "" - -#: domains/std/__init__.py:773 domains/std/__init__.py:786 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "" - -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "" - -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "" - -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Konojel cholwuj" - -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Ruxaq wuj re'" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" +#: themes/basic/defindex.html:10 +msgid "last updated" msgstr "" -#: themes/basic/genindex-split.html:17 -msgid "can be huge" +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" msgstr "" -#: themes/basic/relations.html:6 -msgid "previous chapter" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" msgstr "" -#: themes/basic/relations.html:11 -msgid "Next topic" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" msgstr "" -#: themes/basic/relations.html:13 -msgid "next chapter" +#: themes/basic/defindex.html:19 +msgid "search this documentation" msgstr "" -#: themes/basic/layout.html:18 -msgid "Navigation" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" msgstr "" -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" msgstr "" -#: themes/basic/layout.html:124 -msgid "About these documents" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Konojel cholwuj" + +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" msgstr "" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +msgid "Search %(docstitle)s" msgstr "" -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" msgstr "" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +#: themes/basic/genindex-split.html:17 +msgid "can be huge" msgstr "" #: themes/basic/search.html:20 @@ -2783,21 +2924,21 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2805,21 +2946,20 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", pa" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2828,6 +2968,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2849,119 +2994,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Jalajöj" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Retal jalöj" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Jalajöj" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Retal jalöj" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2973,92 +3125,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "retal jalöj" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3094,573 +3239,481 @@ msgstr "" msgid "grammar token" msgstr "" -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "wuj" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "tatz'u %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "tatz'u chuqa' %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:735 +msgid "document" +msgstr "wuj" + +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:857 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "duplicate %s description of %s, other instance in %s" +msgstr "" + +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1124 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1138 #, python-format -msgid "%r reference target not found: %s" +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1153 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:1157 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:1453 #, python-format -msgid "Unknown image format: %s..." +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:1456 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Failed to read build info file: %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:383 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "cholwuj" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Tz'etb'äl" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Tz'etb'äl" + +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "jun chïk" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "chi rij kan" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Jalajöj chïk" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "cannot copy static file %r" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "cannot copy extra file %r" +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:89 #, python-format -msgid "Failed to write build info file: %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Ajilanïk" - -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:630 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:679 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Tz'etb'äl" - -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Tz'etb'äl" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Jalajöj chïk" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3668,548 +3721,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "(chupam %s)" + +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "cholwuj" + +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "jun chïk" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "chi rij kan" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" -msgstr "(chupam %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "" +msgid "see %s" +msgstr "tatz'u %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "" +msgid "see also %s" +msgstr "tatz'u chuqa' %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/cs/LC_MESSAGES/sphinx.mo b/sphinx/locale/cs/LC_MESSAGES/sphinx.mo index b91950c4d80..139be3a0534 100644 Binary files a/sphinx/locale/cs/LC_MESSAGES/sphinx.mo and b/sphinx/locale/cs/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/cs/LC_MESSAGES/sphinx.po b/sphinx/locale/cs/LC_MESSAGES/sphinx.po index cce6e31673c..96e98543663 100644 --- a/sphinx/locale/cs/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/cs/LC_MESSAGES/sphinx.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Vilibald W. , 2014-2015\n" "Language-Team: Czech (http://app.transifex.com/sphinx-doc/sphinx-1/language/cs/)\n" @@ -20,6 +20,127 @@ msgstr "" "Language: cs\n" "Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n >= 2 && n <= 4 && n % 1 == 0) ? 1: (n % 1 != 0 ) ? 2 : 3;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -34,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +310,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +323,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,468 +538,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Obr. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabulka %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Výpis %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Výstraha" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Upozornění" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Nebezpečí" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Chyba" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Rada" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Důležité" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Poznámka" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Viz také" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tip" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Varování" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (v " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[zdroj]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[dokumentace]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Kód modulu" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Zdrojový kód pro %s

        " +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Přehled: kód modulu" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Všechny moduly s dostupným kódem

        " +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "invalid css_file: %r, ignored" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/xml.py:29 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Vestavěné funkce" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Úroveň modulu" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -740,9 +1176,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -777,6 +1214,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "původní záznam" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -864,1779 +1329,1514 @@ msgstr "[graf: %s]" msgid "[graph]" msgstr "[graf]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Todo" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "původní záznam" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autor sekce: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[zdroj]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autor modulu: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autor kódu:" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[dokumentace]" -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Kód modulu" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Zdrojový kód pro %s

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Přehled: kód modulu" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Všechny moduly s dostupným kódem

        " + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:92 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:56 +#: domains/math.py:73 #, python-format -msgid "no changes in version %s." +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Vestavěné funkce" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (vestavěná funkce)" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Úroveň modulu" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (metoda %s)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (třída)" -#: builders/changes.py:133 +#: domains/javascript.py:188 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (globální proměnná nebo konstanta)" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (atribut %s)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumenty" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Vyvolá" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Vrací" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Typ návratové hodnoty" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (modul)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funkce" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metoda" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "třída" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "data" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribut" -#: builders/__init__.py:275 +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" + +#: domains/javascript.py:458 #, python-format -msgid "all of %d po files" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s (directive)" +msgstr "%s (direktiva)" -#: builders/__init__.py:309 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are out of date" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (role)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "direktiva" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:330 +#: domains/rst.py:236 +msgid "role" +msgstr "role" + +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/changeset.py:32 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:348 +#: domains/changeset.py:33 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "Changed in version %s" +msgstr "Změněno ve verzi %s" -#: builders/__init__.py:361 +#: domains/changeset.py:34 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Zastaralé od verze %s" -#: builders/__init__.py:377 +#: domains/changeset.py:35 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/__init__.py:322 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:410 -#, python-format -msgid "%d found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: cmd/build.py:357 #, python-format -msgid "error writing file %s: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (v " +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:464 +#: cmd/quickstart.py:134 #, python-format -msgid "cannot write image file %r: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:242 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d.%m.%Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" - -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" - -#: _cli/__init__.py:171 -#, python-brace-format -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" - -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" - -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" - -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" - -#: _cli/__init__.py:231 -msgid "" -msgstr "" - -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" - -#: environment/__init__.py:86 -msgid "new config" -msgstr "" - -#: environment/__init__.py:87 -msgid "config changed" -msgstr "" - -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "" - -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" - -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "" - -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" - -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" - -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" - -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "" - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "" - -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "" - -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "" - -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" - -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "" - -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "" - -#: util/i18n.py:146 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "locale_dir %s does not exist" -msgstr "" - -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +msgid "Creating file %s." msgstr "" -#: util/i18n.py:245 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +msgid "File %s already exists, skipping." msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: util/nodes.py:423 +#: cmd/quickstart.py:520 #, python-format msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" - -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" - -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" - -#: util/display.py:82 -msgid "skipped" -msgstr "" - -#: util/display.py:87 -msgid "failed" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" - -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" - -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" - -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: util/fileutil.py:76 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" - -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" - -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "" - -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" - -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Poznámky pod čarou" - -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[obrázek: %s]" - -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[obrázek]" - -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Rejstřík" - -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:538 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" - -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "" - -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "" - -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: writers/latex.py:1183 +#: cmd/quickstart.py:573 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" - -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" - -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "" - -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (vestavěná funkce)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (metoda %s)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (třída)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (globální proměnná nebo konstanta)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (atribut %s)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumenty" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Vyvolá" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Vrací" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Typ návratové hodnoty" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funkce" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metoda" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "třída" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "data" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atribut" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modul" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Změněno ve verzi %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Zastaralé od verze %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktiva)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (role)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "direktiva" - -#: domains/rst.py:235 -msgid "directive-option" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "role" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Výstraha" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Upozornění" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Nebezpečí" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Chyba" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Rada" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Důležité" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Poznámka" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Viz také" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tip" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Varování" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: cmd/quickstart.py:234 +#: cmd/quickstart.py:793 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: cmd/quickstart.py:241 +#: cmd/quickstart.py:810 #, python-format -msgid "Selected root path: %s" +msgid "Invalid template variable: %s" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autor sekce: " -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autor modulu: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autor kódu:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: cmd/quickstart.py:286 +#: directives/patches.py:70 msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" msgstr "" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: cmd/quickstart.py:339 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d.%m.%Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Rejstřík" + +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Poznámky pod čarou" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[obrázek: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[obrázek]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: cmd/quickstart.py:367 +#: writers/html5.py:431 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "numfig_format is not defined for %s" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" + +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" + +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:386 #, python-format -msgid "Creating file %s." +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "File %s already exists, skipping." +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:519 +#: writers/latex.py:616 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:526 +#: writers/latex.py:1198 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:530 +#: writers/latex.py:1228 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:809 +#: util/i18n.py:244 #, python-format -msgid "Invalid template variable: %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/build.py:74 +#: util/osutil.py:131 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:131 +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "pokračujte na předchozí stránce" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "" + +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Symboly" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Vydání" -#: cmd/build.py:212 -msgid "console output options" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Sbalit boční lištu" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigace" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Prohledat %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "O těchto dokumentech" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Vyhledávání" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "OK" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Veškerá práva vyhrazena" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Aktualizováno dne %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Přechozí téma" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "předchozí kapitola" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Další téma" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "další kapitola" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Celý rejstřík na jedné stránce" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Tato stránka" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Ukázat zdroj" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Obsah" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Rychlé vyhledávání" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Prohledat %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "OK" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2683,7 +2883,7 @@ msgstr "Celkový rejstřík modulů" msgid "quick access to all modules" msgstr "rychlý přístup ke všem modulům" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Obecný rejstřík" @@ -2691,23 +2891,15 @@ msgstr "Obecný rejstřík" msgid "all functions, classes, terms" msgstr "všechny funkce, třídy, termíny" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Tato stránka" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Celý rejstřík na jedné stránce" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Rychlé vyhledávání" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "Prohledat %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2717,57 +2909,6 @@ msgstr "Rejstřík podle písmene" msgid "can be huge" msgstr "může být obrovský" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Přechozí téma" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "předchozí kapitola" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Další téma" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "další kapitola" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigace" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Prohledat %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "O těchto dokumentech" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Veškerá práva vyhrazena" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Aktualizováno dne %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2784,21 +2925,21 @@ msgstr "" msgid "search" msgstr "hledat" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Skrýt výsledky vyhledávání" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Obsah" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Výsledky vyhledávání" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Vyhledávání nenalezlo žádný odpovídající dokument. Ujistěte se, že jste všechna slova zapsal/a správně a že jste vybral/a dostatek kategorií." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2808,22 +2949,21 @@ msgstr[1] "" msgstr[2] "" msgstr[3] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Probíhá vyhledání" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Vyhledávání se připravuje..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", v " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Skrýt výsledky vyhledávání" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2831,6 +2971,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2852,120 +2997,127 @@ msgstr "Ostatní změny" msgid "Expand sidebar" msgstr "Rozbalit boční lištu" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametry" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Proměnné" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Vyvolá" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (v modulu %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (v modulu %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (vestavěná proměnná)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (vestavěná třída)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (třída v %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (třídní metoda %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (statická metoda %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Rejstřík modulů Pythonu" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moduly" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Zastaralé" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "výjimka" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "třídní metoda" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statická metoda" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (zastaralé)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametry" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Proměnné" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Vyvolá" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2976,746 +3128,526 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "člen" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "typ" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "proměnná" - -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "makro" - -#: domains/c/__init__.py:753 -msgid "struct" -msgstr "" - -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "proměnná prostředí; %s" - -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "termín v glosáři" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "token gramatiky" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "referenční návěstí" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "proměnná prostředí" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "volba programu" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Rejstřík modulů" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "viz %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "viz také %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Symboly" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 +#: domains/c/__init__.py:211 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +msgid "%s (C %s)" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "proměnná" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "makro" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "" +msgid "environment variable; %s" +msgstr "proměnná prostředí; %s" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:116 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "%s; configuration value" msgstr "" -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:239 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:319 #, python-format -msgid "Unknown image format: %s..." +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "termín v glosáři" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "rejstřík" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "token gramatiky" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "referenční návěstí" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "další" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "proměnná prostředí" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "předchozí" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "volba programu" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Rejstřík modulů" -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1153 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy static file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Failed to write build info file: %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "Dokumentace pro %s %s" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Vydání" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "pokračujte na předchozí stránce" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3723,7 +3655,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3738,481 +3670,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:123 #, python-format -msgid "%s is not a directory." +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" -msgstr "(v %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "rejstřík" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "další" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "předchozí" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "Dokumentace pro %s %s" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "viz %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "viz také %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/cy/LC_MESSAGES/sphinx.mo b/sphinx/locale/cy/LC_MESSAGES/sphinx.mo index 31232b73332..44fddec6d8c 100644 Binary files a/sphinx/locale/cy/LC_MESSAGES/sphinx.mo and b/sphinx/locale/cy/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/cy/LC_MESSAGES/sphinx.po b/sphinx/locale/cy/LC_MESSAGES/sphinx.po index b613158d446..3f0ac1d9f41 100644 --- a/sphinx/locale/cy/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/cy/LC_MESSAGES/sphinx.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Geraint Palmer , 2016\n" "Language-Team: Welsh (http://app.transifex.com/sphinx-doc/sphinx-1/language/cy/)\n" @@ -20,6 +20,127 @@ msgstr "" "Language: cy\n" "Plural-Forms: nplurals=4; plural=(n==1) ? 0 : (n==2) ? 1 : (n != 8 && n != 11) ? 2 : 3;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -34,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +310,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +323,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,468 +538,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Ffig. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabl %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Listing %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Sylw" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Gofal" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Perygl" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Gwall" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Awgrym" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Pwysig" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Nodyn" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Gweler hefyd" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Awgrym" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Rhybudd" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (yn " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[ffynhonnell]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[docs]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Cod y modiwl" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Cod ffynhonnell ar gyfer %s

        " +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Trosolwg: cod y modiwl" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Holl fodiwlau lle mae'r cod ar gael

        " +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "invalid css_file: %r, ignored" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/xml.py:29 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Lefel modiwl" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -740,9 +1176,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -777,6 +1214,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "eitem wreiddiol" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -864,948 +1329,994 @@ msgstr "[graff: %s]" msgid "[graph]" msgstr "[graff]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Todo" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "eitem wreiddiol" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Awdur yr adran:" - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Awdur y fodiwl:" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Awdur y cod:" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" +msgstr "" -#: directives/other.py:209 -msgid "Author: " -msgstr "Awdur:" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[ffynhonnell]" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[docs]" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." -msgstr "" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Cod y modiwl" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." -msgstr "" - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "" +msgid "

        Source code for %s

        " +msgstr "

        Cod ffynhonnell ar gyfer %s

        " -#: builders/changes.py:70 -msgid "Builtins" -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Trosolwg: cod y modiwl" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Lefel modiwl" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Holl fodiwlau lle mae'r cod ar gael

        " -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:133 +#: domains/citation.py:92 #, python-format -msgid "could not read %r for changelog creation" +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:73 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (%s method)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:186 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (global variable or constant)" +msgstr "%s (newidyn byd-eang neu cysonyn)" + +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "ffwythiant" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modiwl" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "" +msgid "Changed in version %s" +msgstr "Wedi newid yn fersiwn %s" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "Deprecated since version %s" +msgstr "Dibrisiwyd ers fersiwn %s" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "" - -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (yn " - -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:298 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:350 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "" + +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/nodes.py:706 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "enable %s extension" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/rst.py:73 +#: cmd/quickstart.py:810 #, python-format -msgid "default role %s not found" +msgid "Invalid template variable: %s" msgstr "" -#: util/inventory.py:147 +#: directives/other.py:119 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/inventory.py:166 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Troednodiadau" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/other.py:169 #, python-format -msgid "[image: %s]" -msgstr "[delwedd: %s]" +msgid "duplicated entry found in toctree: %s" +msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[delwedd]" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Awdur yr adran:" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Indecs" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Awdur y fodiwl:" + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Awdur y cod:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "Awdur:" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" msgstr "" -#: writers/latex.py:1183 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Indecs" + +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Troednodiadau" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" +msgid "[image: %s]" +msgstr "[delwedd: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[delwedd]" #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" @@ -1833,6 +2344,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1849,794 +2365,478 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (newidyn byd-eang neu cysonyn)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "ffwythiant" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modiwl" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Wedi newid yn fersiwn %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Dibrisiwyd ers fersiwn %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "" - -#: domains/rst.py:234 -msgid "directive" -msgstr "" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:236 -msgid "role" -msgstr "" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "" - -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Sylw" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Gofal" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Perygl" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Gwall" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Awgrym" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Pwysig" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Nodyn" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Gweler hefyd" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Awgrym" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Rhybudd" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "" - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "" - -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "" - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "" - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "" - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "" - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "" - -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" -msgstr "" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "" - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "" - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "" - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "" - -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "" - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "" - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:616 #, python-format -msgid "Creating file %s." +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:519 +#: writers/latex.py:1228 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:530 +#: writers/latex.py:1950 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:792 +#: util/i18n.py:253 +#, python-format msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:809 +#: util/osutil.py:131 #, python-format -msgid "Invalid template variable: %s" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:131 +#: util/docfields.py:103 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "wedi'i barhau o'r tudalen blaenorol" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Symbolau" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Rhyddhad" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Cyfangu'r bar ochr" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Llywio" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Chwilio o fewn %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Ynglŷn â'r dogfennau hyn" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Chwilio" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Ewch" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Hawlfraint" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Diweddarwyd yn ddiwethaf ar %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Pwnc blaenorol" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "pennod blaenorol" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Pwnc nesaf" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "pennod nesaf" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Indecs llawn ar un tudalen" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Y Dudalen Hon" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Dangos Ffynhonell" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Cynnwys" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Chwilio cyflym" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Chwilio %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Ewch" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2683,7 +2883,7 @@ msgstr "Indecs Modiwl Byd-Eang" msgid "quick access to all modules" msgstr "mynediad cloi i bob modiwl" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Indecs cyffredinol" @@ -2691,23 +2891,15 @@ msgstr "Indecs cyffredinol" msgid "all functions, classes, terms" msgstr "holl ffwythiannau, dosbarthau a thermau" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Y Dudalen Hon" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Indecs llawn ar un tudalen" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Chwilio cyflym" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "Chwilio %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2717,57 +2909,6 @@ msgstr "Indecs tudalennau gan lythyren" msgid "can be huge" msgstr "gall fod yn enfawr" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Pwnc blaenorol" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "pennod blaenorol" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Pwnc nesaf" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "pennod nesaf" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Llywio" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Chwilio o fewn %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Ynglŷn â'r dogfennau hyn" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Hawlfraint" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Diweddarwyd yn ddiwethaf ar %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2784,21 +2925,21 @@ msgstr "" msgid "search" msgstr "chwilio" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Cuddio Canlyniadau Chwilio" - -#: themes/basic/static/searchtools.js:117 +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Cynnwys" + +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Canlyniadau chwilio" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Nid yw eich chwiliad yn cyfateb unrhyw ddogfennau. Gwnewch yn siŵr fod pob gair wedi'i sillafu'n gywir, ac eich bod wedi dewis digon o gategorïau." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2808,22 +2949,21 @@ msgstr[1] "" msgstr[2] "" msgstr[3] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Yn chwilio" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Paratoi chwilio..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", yn " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Cuddio Canlyniadau Chwilio" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2831,6 +2971,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2852,119 +2997,126 @@ msgstr "Newidiadau arall" msgid "Expand sidebar" msgstr "Ehangu'r bar ochr" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Paramedrau" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Paramedrau" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2976,746 +3128,526 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "aelod" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "" - -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "" - -#: domains/c/__init__.py:753 -msgid "struct" -msgstr "" - -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "" - -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Indecs Modiwlau" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "gweler %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "gweler hefyd %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Symbolau" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 +#: domains/c/__init__.py:211 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +msgid "%s (C %s)" msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/c/__init__.py:778 +msgid "variable" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/c/__init__.py:780 +msgid "macro" msgstr "" -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "environment variable; %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:116 #, python-format -msgid "%r reference target not found: %s" +msgid "%s; configuration value" msgstr "" -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:239 #, python-format -msgid "Unknown image format: %s..." +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:319 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "indecs" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "nesaf" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "blaenorol" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Indecs Modiwlau" + +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1153 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy static file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Failed to write build info file: %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "Dogfennaeth %s %s " +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Rhyddhad" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "wedi'i barhau o'r tudalen blaenorol" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3723,7 +3655,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3738,481 +3670,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:123 #, python-format -msgid "%s is not a directory." +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" -msgstr "(yn %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "indecs" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "nesaf" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "blaenorol" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "Dogfennaeth %s %s " + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "gweler %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "gweler hefyd %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/da/LC_MESSAGES/sphinx.mo b/sphinx/locale/da/LC_MESSAGES/sphinx.mo index 54521ffb375..c001d903c43 100644 Binary files a/sphinx/locale/da/LC_MESSAGES/sphinx.mo and b/sphinx/locale/da/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/da/LC_MESSAGES/sphinx.po b/sphinx/locale/da/LC_MESSAGES/sphinx.po index da61a5e20f6..1a36bb736d4 100644 --- a/sphinx/locale/da/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/da/LC_MESSAGES/sphinx.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Komiya Takeshi , 2021\n" "Language-Team: Danish (http://app.transifex.com/sphinx-doc/sphinx-1/language/da/)\n" @@ -22,6 +22,127 @@ msgstr "" "Language: da\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -36,127 +157,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Ukendt hændelsesnavn: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Kan ikke finde kildemappen (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Kildemappe og destinationsmappe kan ikke være identiske" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Kører Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Dette projekt kræver mindst Sphinx v%s og kan derfor ikke bygges med denne version." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "indlæser oversættelser [%s] ..." -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "færdig" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "ikke tilgængelig for indbyggede beskeder" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "fejlede: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -164,12 +312,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -177,82 +325,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "konfigurationsmappe indeholder ikke en conf.py-fil (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "domænet %s er allerede registreret" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "Rollen %r er allerede registreret til domæne %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser for %r er allerede registreret" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Kunne ikke importere udvidelse %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "Udvidelsen %s brugt af dette projekt kræver mindst Sphinx v%s; den kan derfor ikke bygges med denne version." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "konfigurationsmappe indeholder ikke en conf.py-fil (%s)" + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Konfigurationsværdien %r er allerede til stede" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -260,468 +540,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "figur %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "tabel %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Kildekode %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r blev ikke fundet, ignorerer." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "ny konfiguration" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "udvidelser ændret" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "kildemappe er ændret" + +#: environment/__init__.py:350 #, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:228 +#: environment/__init__.py:355 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:361 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:276 -#, python-format +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Vær opmærksom" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Forsigtig" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Fare" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Ukendt hændelsesnavn: %s" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Fejl" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Fif" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Vigtigt" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Bemærk" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Se også" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tip" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Advarsel" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "domænet %s er allerede registreret" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (i " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "Rollen %r er allerede registreret til domæne %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser for %r er allerede registreret" +msgid "The HTML page is in %(outdir)s." +msgstr "HTML-siden er i %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "" +msgid "The message catalogs are in %(outdir)s." +msgstr "Beskedkatalogerne er i %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "læser skabeloner ..." -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "Kunne ikke importere udvidelse %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "skriver beskedkataloger ..." -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "Udvidelsen %s brugt af dette projekt kræver mindst Sphinx v%s; den kan derfor ikke bygges med denne version." +msgid "broken link: %s (%s)" +msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[kilde]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "konfigurationsværdien »epub_contributor« bør ikke være tom for EPUB3" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[dok]" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Modulkode" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Kildekode for %s

        " +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Oversigt: modulkode" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Alle moduler, der er kode tilgængelig for

        " +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" +msgstr "ugyldig css_file: %r, ignoreret" -#: ext/extlinks.py:82 +#: builders/xml.py:29 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "error writing file %s: %s" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/xml.py:103 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:467 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 #, python-format -msgid "'%s' is not a valid option." +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "writing %s file..." msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "læser kilder ..." + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "forbereder dokumenter" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Indbyggede" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Modulniveau" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -742,9 +1178,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -779,6 +1216,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(Det <> befinder sig i %s, linje %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "oprindeligt punkt" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -866,1779 +1331,1514 @@ msgstr "[graf: %s]" msgid "[graph]" msgstr "[graf]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Todo" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" - -#: ext/todo.py:154 +#: ext/imgmath.py:167 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(Det <> befinder sig i %s, linje %d.)" - -#: ext/todo.py:166 -msgid "original entry" -msgstr "oprindeligt punkt" - -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: directives/code.py:87 +#: ext/imgmath.py:326 #, python-format -msgid "Invalid caption: %s" +msgid "display latex %r: %s" msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/imgmath.py:362 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:231 +#: ext/doctest.py:118 #, python-format -msgid "Include file '%s' not found or reading it failed" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:124 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:139 #, python-format -msgid "Object named %r not found in include file %r" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:314 +#: ext/doctest.py:297 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "" - -#: directives/patches.py:71 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/other.py:119 +#: ext/doctest.py:451 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/doctest.py:568 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/other.py:156 +#: ext/autosectionlabel.py:52 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:169 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Afsnitsforfatter: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Modulforfatter: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Kodeforfatter: " - -#: directives/other.py:209 -msgid "Author: " -msgstr "Forfatter: " - -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: builders/changes.py:29 +#: ext/duration.py:124 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: builders/changes.py:56 -#, python-format -msgid "no changes in version %s." +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Indbyggede" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "Modulniveau" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[kilde]" -#: builders/changes.py:124 -msgid "copying source files..." +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: builders/changes.py:133 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[dok]" -#: builders/manpage.py:37 +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Modulkode" + +#: ext/viewcode.py:359 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "

        Source code for %s

        " +msgstr "

        Kildekode for %s

        " -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Oversigt: modulkode" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Alle moduler, der er kode tilgængelig for

        " -#: builders/manpage.py:71 +#: domains/citation.py:75 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/__init__.py:224 +#: domains/citation.py:92 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/__init__.py:232 +#: domains/math.py:73 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" - -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/__init__.py:275 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "all of %d po files" +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/__init__.py:297 +#: domains/javascript.py:183 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s() (built-in function)" +msgstr "%s() (indbygget funktion)" -#: builders/__init__.py:309 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "" +msgid "%s() (%s method)" +msgstr "%s() (metode i %s)" -#: builders/__init__.py:330 +#: domains/javascript.py:186 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +msgid "%s() (class)" +msgstr "%s() (klasse)" -#: builders/__init__.py:337 +#: domains/javascript.py:188 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (global variabel eller konstant)" -#: builders/__init__.py:348 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (attribut i %s)" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Parametre" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Kaster" -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Returnerer" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Returtype" -#: builders/__init__.py:410 +#: domains/javascript.py:374 #, python-format -msgid "%d found" -msgstr "" +msgid "%s (module)" +msgstr "%s (modul)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funktion" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metode" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klasse" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "data" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "attribut" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" -#: builders/__init__.py:531 +#: domains/javascript.py:458 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:540 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "%s (directive)" +msgstr "%s (direktiv)" -#: builders/__init__.py:551 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:558 +#: domains/rst.py:224 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s (role)" +msgstr "%s (rolle)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "direktiv" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "læser kilder ..." +#: domains/rst.py:236 +msgid "role" +msgstr "rolle" -#: builders/__init__.py:713 +#: domains/rst.py:262 #, python-format -msgid "docnames to write: %s" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "forbereder dokumenter" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "Ændret i version %s" -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "" +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "Forældet siden version %s" -#: builders/__init__.py:883 +#: domains/changeset.py:35 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +msgid "Removed in version %s" msgstr "" -#: builders/epub3.py:84 +#: domains/__init__.py:322 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "konfigurationsværdien »epub_contributor« bør ikke være tom for EPUB3" - -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "ugyldig css_file: %r, ignoreret" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (i " +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:591 +#: cmd/build.py:357 #, python-format -msgid "unknown mimetype for %s, ignoring" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Beskedkatalogerne er i %(outdir)s." - -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "læser skabeloner ..." - -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "skriver beskedkataloger ..." +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "HTML-siden er i %(outdir)s." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/text.py:29 +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Indtast venligst noget tekst." + +#: cmd/quickstart.py:134 #, python-format -msgid "The text files are in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Indtast venligst enten »y« eller »n«." -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Indtast venligt et filsuffiks, f.eks. ».rst« eller ».txt«" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:235 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 +#: cmd/quickstart.py:242 #, python-format -msgid "%b %d, %Y" -msgstr "%d. %b, %Y" +msgid "Selected root path: %s" +msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/__init__.py:253 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:309 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" - -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" - -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:203 -msgid "Logging" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: environment/__init__.py:86 -msgid "new config" -msgstr "ny konfiguration" - -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "udvidelser ændret" - -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "kildemappe er ændret" - -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: environment/__init__.py:330 +#: cmd/quickstart.py:368 #, python-format -msgid "The configuration has changed (%d options: %s)" +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:378 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: util/i18n.py:100 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "reading error: %s, %s" +msgid "Creating file %s." msgstr "" -#: util/i18n.py:113 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "writing error: %s, %s" +msgid "File %s already exists, skipping." +msgstr "Filen %s findes allerede, udelader." + +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: util/i18n.py:146 +#: cmd/quickstart.py:520 #, python-format -msgid "locale_dir %s does not exist" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: util/i18n.py:245 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:538 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:573 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/fileutil.py:76 -#, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Fodnoter" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[billede: %s]" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[billede]" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Indeks" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" +msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "opret ikke makefile" + +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "skabelonmappe for skabelonfiler" + +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: writers/latex.py:1183 +#: cmd/quickstart.py:786 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: writers/latex.py:1939 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown index entry type %s found" +msgid "Invalid template variable: %s" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: directives/other.py:119 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: writers/html5.py:431 +#: directives/other.py:156 #, python-format -msgid "numfig_format is not defined for %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: writers/html5.py:441 +#: directives/other.py:169 #, python-format -msgid "Any IDs not assigned for %s node" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Afsnitsforfatter: " -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Modulforfatter: " -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" +#: directives/other.py:207 +msgid "Code author: " +msgstr "Kodeforfatter: " -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" +#: directives/other.py:209 +msgid "Author: " +msgstr "Forfatter: " -#: writers/html5.py:638 -msgid "Link to this image" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: writers/html5.py:640 -msgid "Link to this toctree" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (indbygget funktion)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (metode i %s)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (klasse)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (global variabel eller konstant)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (attribut i %s)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Parametre" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Kaster" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Returnerer" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Returtype" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funktion" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metode" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klasse" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "data" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "attribut" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modul" - -#: domains/javascript.py:454 +#: directives/code.py:87 #, python-format -msgid "duplicate %s description of %s, other %s in %s" +msgid "Invalid caption: %s" msgstr "" -#: domains/changeset.py:26 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "Added in version %s" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Ændret i version %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Forældet siden version %s" - -#: domains/changeset.py:29 +#: directives/code.py:216 #, python-format -msgid "Removed in version %s" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktiv)" - -#: domains/rst.py:191 domains/rst.py:202 +#: directives/code.py:231 #, python-format -msgid ":%s: (directive option)" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: domains/rst.py:224 +#: directives/code.py:235 #, python-format -msgid "%s (role)" -msgstr "%s (rolle)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "direktiv" - -#: domains/rst.py:235 -msgid "directive-option" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "rolle" - -#: domains/rst.py:262 +#: directives/code.py:276 #, python-format -msgid "duplicate description of %s %s, other instance in %s" +msgid "Object named %r not found in include file %r" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: domains/citation.py:92 +#: directives/code.py:314 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Vær opmærksom" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Forsigtig" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Fare" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Fejl" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Fif" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Vigtigt" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Bemærk" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Se også" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tip" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Advarsel" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Indtast venligst noget tekst." - -#: cmd/quickstart.py:133 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format -msgid "Please enter one of %s." -msgstr "" - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Indtast venligst enten »y« eller »n«." - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Indtast venligt et filsuffiks, f.eks. ».rst« eller ».txt«" +msgid "%b %d, %Y" +msgstr "%d. %b, %Y" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Indeks" -#: cmd/quickstart.py:234 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "" - -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" -msgstr "" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Fodnoter" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" msgstr "" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[billede: %s]" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[billede]" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" msgstr "" -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:367 +#: writers/latex.py:616 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:377 +#: writers/latex.py:1198 msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/latex.py:1228 +#, python-format +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "Filen %s findes allerede, udelader." +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:526 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:670 +#: util/inventory.py:166 #, python-format -msgid "enable %s extension" +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "opret ikke makefile" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "skabelonmappe for skabelonfiler" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:785 +#: util/fileutil.py:76 +#, python-format msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:809 +#: util/docfields.py:103 #, python-format -msgid "Invalid template variable: %s" +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:74 +#: util/nodes.py:462 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "fortsat fra forrige side" -#: cmd/build.py:114 -msgid "general options" -msgstr "" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "fortsætter på næste side" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Symboler" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "side" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Udgave" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:157 +#: transforms/post_transforms/__init__.py:88 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Sammenfold sidebjælke" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigation" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Søg i %(docstitle)s" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Om disse dokumenter" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Søg" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Ophavsret" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:357 +#: themes/basic/layout.html:201 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" +msgid "Last updated on %(last_updated)s." +msgstr "Sidst opdateret %(last_updated)s." -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Forrige emne" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Sammenfold sidebjælke" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "forrige kapitel" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Næste emne" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "næste kapitel" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Søg" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Fuldt indeks på én side" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Søg" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Denne side" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Vis kilde" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Indhold" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Hurtig søgning" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Søg i %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Søg" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2668,107 +2868,48 @@ msgstr "Fuldstændig indholdsfortegnelse" msgid "lists all sections and subsections" msgstr "viser alle afsnit og underafsnit" -#: domains/std/__init__.py:773 domains/std/__init__.py:786 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "Søgeside" - -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "søg i denne dokumentation" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "Globalt modulindeks" - -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "hurtig adgang til alle moduler" - -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Generelt indeks" - -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "alle funktioner, klasser, begreber" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Denne side" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Fuldt indeks på én side" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Hurtig søgning" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Indeksér sider efter bogstav" - -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "kan være enormt" - -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Forrige emne" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "forrige kapitel" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Næste emne" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "Søgeside" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "næste kapitel" +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "søg i denne dokumentation" -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigation" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "Globalt modulindeks" -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Søg i %(docstitle)s" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "hurtig adgang til alle moduler" -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Om disse dokumenter" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Generelt indeks" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Ophavsret" +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "alle funktioner, klasser, begreber" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/layout.html:201 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Sidst opdateret %(last_updated)s." +msgid "Search %(docstitle)s" +msgstr "Søg i %(docstitle)s" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Indeksér sider efter bogstav" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "kan være enormt" #: themes/basic/search.html:20 msgid "" @@ -2786,21 +2927,21 @@ msgstr "Bemærk: Hvis du søger efter flere ord, vises kun resultater der indeho msgid "search" msgstr "søg" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Skjul søgeresultater" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Indhold" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Søgeresultater" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Din søgning matchede ikke nogen dokumenter. Sikr dig at alle ord er stavet korrekt og at du har valgt nok kategorier." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2808,22 +2949,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Søger" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Forbereder søgning..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", i" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Skjul søgeresultater" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2831,6 +2971,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Ændringer i version %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2852,120 +2997,127 @@ msgstr "Andre ændringer" msgid "Expand sidebar" msgstr "Udfold sidebjælke" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametre" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variable" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Rejser" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (i modulet %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (i modulet %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (indbygget variabel)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (indbygget klasse)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (klasse i %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (klassemetode i %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (statisk metode i %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python-modulindeks" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moduler" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Forældet" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "undtagelse" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "klassemetode" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statisk metode" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (forældet)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametre" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variable" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Rejser" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2976,92 +3128,85 @@ msgstr "Template-parametre" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "medlem" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "type" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "koncept" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "optæl" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "optælling" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "variabel" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "makro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "miljøvariabel; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3115,607 +3260,394 @@ msgstr "dokument" #: domains/std/__init__.py:772 domains/std/__init__.py:785 msgid "Module Index" -msgstr "Modulindeks" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "se %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "se også %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Symboler" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" +msgstr "Modulindeks" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1124 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1138 #, python-format -msgid "%r reference target not found: %s" +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1153 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:1157 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:1453 #, python-format -msgid "Unknown image format: %s..." +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:1456 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "HTML-siderne er i %(outdir)s." +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Failed to read build info file: %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:383 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "indeks" - -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "næste" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Eksempler" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "forrige" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Nøgleordsargumenter" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Andre parametre" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Referencer" -#: builders/html/__init__.py:818 -#, python-format -msgid "cannot copy downloadable file %r: %s" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "" - -#: builders/html/__init__.py:917 -msgid "copying static files" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy static file %r" -msgstr "kan ikke kopiere statisk fil %r" - -#: builders/html/__init__.py:939 -msgid "copying extra files" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "cannot copy extra file %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to write build info file: %r" -msgstr "" - -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1224 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "" - -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "" - -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1308 +#: ext/autodoc/_names.py:89 #, python-format -msgid "invalid js_file: %r, ignored" -msgstr "udgyldig js_file: %r, ignoreret" - -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1346 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Unknown math_renderer %r is given." +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "Would create file %s." msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" -msgstr "favicon-filen %r findes ikke" - -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:50 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" -msgstr "%s %s dokumentation" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" -msgstr "" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "overskriv eksisterende filer" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Udgave" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "fortsat fra forrige side" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "fortsætter på næste side" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "side" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Nøgleordsargumenter" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "" +msgid "%s is not a directory." +msgstr "%s er ikke en mappe" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Eksempler" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Andre parametre" - -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Referencer" - -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3723,7 +3655,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3738,481 +3670,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "overskriv eksisterende filer" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "%s is not a directory." -msgstr "%s er ikke en mappe" - -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:247 -#, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_generate.py:69 -#, python-format -msgid "Would create file %s." +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:114 #, python-format -msgid "(in %s v%s)" -msgstr "(i %s v%s)" +msgid "The HTML pages are in %(outdir)s." +msgstr "HTML-siderne er i %(outdir)s." -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s)" +msgid "Failed to read build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:108 -#, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:372 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "indeks" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "næste" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "forrige" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "" + +#: builders/html/__init__.py:783 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:807 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:853 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:871 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +msgid "cannot copy static file %r" +msgstr "kan ikke kopiere statisk fil %r" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1217 +#, python-format +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1225 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1266 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" +msgstr "udgyldig js_file: %r, ignoreret" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1365 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1370 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "favicon-filen %r findes ikke" + +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s dokumentation" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "se %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "se også %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/de/LC_MESSAGES/sphinx.mo b/sphinx/locale/de/LC_MESSAGES/sphinx.mo index 71a0d4ab23b..667f0290e08 100644 Binary files a/sphinx/locale/de/LC_MESSAGES/sphinx.mo and b/sphinx/locale/de/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/de/LC_MESSAGES/sphinx.po b/sphinx/locale/de/LC_MESSAGES/sphinx.po index 65baa1a991f..9a63ceadffd 100644 --- a/sphinx/locale/de/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/de/LC_MESSAGES/sphinx.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Jean-François B. , 2018\n" "Language-Team: German (http://app.transifex.com/sphinx-doc/sphinx-1/language/de/)\n" @@ -22,6 +22,127 @@ msgstr "" "Language: de\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -36,127 +157,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Pygments Lexer Name %r ist unbekannt" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Event %r bereits verfügbar" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Unbekannter Event name: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Kann Quellverzeichnis nicht finden (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Quellverzeichnis und Zielverzeichnis können nicht identisch sein" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx v%s in Verwendung" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Dieses Projekt benötigt Version %s oder später und kann daher nicht gebaut werden." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "Lade Übersetzungen [%s]…" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "erledigt" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "nicht verfügbar für vordefinierte Nachrichten" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "Fehlgeschlagen: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Kein builder ausgewählt, verwende 'html' per default" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -164,12 +312,12 @@ msgid "" "explicit" msgstr "Die Erweiterung %s gibt nicht an ob paralleles Datenlesen fehlerfrei möglich ist, es wird daher nicht davon ausgegangen - bitte kontaktiere den Erweiterungsautor zur Überprüfung und Angabe" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -177,82 +325,214 @@ msgid "" "explicit" msgstr "Die Erweiterung %s gibt nicht an ob paralleles Datenschreiben fehlerfrei möglich ist, es wird daher nicht davon ausgegangen - bitte kontaktiere den Erweiterungsautor zur Überprüfung und Angabe" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "Konfigurationsverzeichnis enthält keine conf.py Datei (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Ursprüngliche Ausnahme:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "Konfigurationsverzeichnis enthält keine conf.py Datei (%s)" + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "Ungültige Nummer %r for Konfiguration %r, wird ignoriert" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Konfigurationswert %r bereits gesetzt" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -260,468 +540,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Abschnitt %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Abb. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tab. %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Quellcode %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r nicht gefunden, daher ignoriert." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Pygments Lexer Name %r ist unbekannt" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Achtung" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Event %r bereits verfügbar" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Vorsicht" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Unbekannter Event name: %s" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Gefahr" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Fehler" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Hinweis" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Wichtig" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Bemerkung" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Siehe auch" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tipp" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Warnung" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (in " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Ursprüngliche Ausnahme:\n" - -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:612 +#: builders/linkcheck.py:561 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:229 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid CVE number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:251 +#: builders/epub3.py:83 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[Quellcode]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[Doku]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Modul-Quellcode" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Quellcode für %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Überblick: Modul-Quellcode" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Alle Module, für die Quellcode verfügbar ist

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "error writing file %s: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:436 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Builtins" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Modulebene" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -742,9 +1178,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -779,6 +1216,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Zu tun" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(Der <> steht in %s, Zeile %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "ursprüngliche Eintrag" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -866,1779 +1331,1514 @@ msgstr "[Diagramm: %s]" msgid "[graph]" msgstr "[Diagramm]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Zu tun" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" - -#: ext/todo.py:154 +#: ext/imgmath.py:167 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(Der <> steht in %s, Zeile %d.)" - -#: ext/todo.py:166 -msgid "original entry" -msgstr "ursprüngliche Eintrag" - -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: directives/code.py:87 +#: ext/imgmath.py:326 #, python-format -msgid "Invalid caption: %s" +msgid "display latex %r: %s" msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/imgmath.py:362 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:231 +#: ext/doctest.py:118 #, python-format -msgid "Include file '%s' not found or reading it failed" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:124 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:139 #, python-format -msgid "Object named %r not found in include file %r" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:314 +#: ext/doctest.py:297 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "" - -#: directives/patches.py:71 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/other.py:119 +#: ext/doctest.py:451 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/doctest.py:568 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/other.py:156 +#: ext/autosectionlabel.py:52 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:169 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autor des Abschnitts: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autor des Moduls: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autor des Quellcode: " - -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor: " - -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: builders/changes.py:29 +#: ext/duration.py:124 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: builders/changes.py:56 -#, python-format -msgid "no changes in version %s." +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Builtins" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "Modulebene" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[Quellcode]" -#: builders/changes.py:124 -msgid "copying source files..." +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: builders/changes.py:133 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[Doku]" -#: builders/manpage.py:37 +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Modul-Quellcode" + +#: ext/viewcode.py:359 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "

        Source code for %s

        " +msgstr "

        Quellcode für %s

        " -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Überblick: Modul-Quellcode" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Alle Module, für die Quellcode verfügbar ist

        " -#: builders/manpage.py:71 +#: domains/citation.py:75 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/__init__.py:224 +#: domains/citation.py:92 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/__init__.py:232 +#: domains/math.py:73 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" - -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/__init__.py:275 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "all of %d po files" +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/__init__.py:297 +#: domains/javascript.py:183 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s() (built-in function)" +msgstr "%s() (Standard-Funktion)" -#: builders/__init__.py:309 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "" +msgid "%s() (%s method)" +msgstr "%s() (Methode von %s)" -#: builders/__init__.py:330 +#: domains/javascript.py:186 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +msgid "%s() (class)" +msgstr "%s() (Klasse)" -#: builders/__init__.py:337 +#: domains/javascript.py:188 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (globale Variable oder Konstante)" -#: builders/__init__.py:348 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (Attribut von %s)" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Parameter" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Wirft" -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Rückgabe" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Rückgabetyp" -#: builders/__init__.py:410 +#: domains/javascript.py:374 #, python-format -msgid "%d found" -msgstr "" +msgid "%s (module)" +msgstr "%s (Modul)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "Funktion" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "Methode" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "Klasse" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "Wert" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "Attribut" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "Modul" -#: builders/__init__.py:531 +#: domains/javascript.py:458 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:540 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "%s (directive)" +msgstr "%s (Direktive)" -#: builders/__init__.py:551 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:558 +#: domains/rst.py:224 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" +msgid "%s (role)" +msgstr "%s (Rolle)" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: domains/rst.py:234 +msgid "directive" +msgstr "Direktive" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:713 +#: domains/rst.py:236 +msgid "role" +msgstr "Rolle" + +#: domains/rst.py:262 #, python-format -msgid "docnames to write: %s" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "Geändert in Version %s" -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "" +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "Veraltet ab Version %s" -#: builders/__init__.py:883 +#: domains/changeset.py:35 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +msgid "Removed in version %s" msgstr "" -#: builders/epub3.py:84 +#: domains/__init__.py:322 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "" +msgid "%s %s" +msgstr "%s-%s" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (in " - -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:591 +#: cmd/build.py:357 #, python-format -msgid "unknown mimetype for %s, ignoring" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/linkcheck.py:758 +#: cmd/quickstart.py:134 #, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgid "Please enter one of %s." +msgstr "" + +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "" + +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/text.py:29 +#: cmd/quickstart.py:230 #, python-format -msgid "The text files are in %(outdir)s." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:235 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:242 +#, python-format +msgid "Selected root path: %s" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d.%m.%Y" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:274 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" - -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" - -#: _cli/__init__.py:231 -msgid "" -msgstr "" - -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" - -#: environment/__init__.py:86 -msgid "new config" -msgstr "" - -#: environment/__init__.py:87 -msgid "config changed" -msgstr "" - -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "" - -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" - -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "" - -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" - -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" - -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" - -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "" - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "" - -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "" - -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "" - -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" - -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "" - -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "" - -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" - -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: util/i18n.py:245 -#, python-format +#: cmd/quickstart.py:350 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: util/nodes.py:423 +#: cmd/quickstart.py:368 #, python-format msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" - -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" - -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" - -#: util/display.py:82 -msgid "skipped" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:378 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" - -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" - -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:397 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" - -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" - -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "" - -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" - -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Fußnoten" - -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[Bild: %s]" - -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[Bild]" - -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Stichwortverzeichnis" - -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:407 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" - -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +msgid "Creating file %s." msgstr "" -#: writers/latex.py:591 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "File %s already exists, skipping." msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: cmd/quickstart.py:520 #, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" - -#: writers/latex.py:1183 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" - -#: writers/html5.py:640 -msgid "Link to this toctree" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s-%s" - -#: domains/math.py:73 +#: cmd/quickstart.py:531 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (Standard-Funktion)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (Methode von %s)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (Klasse)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (globale Variable oder Konstante)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (Attribut von %s)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Parameter" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Wirft" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Rückgabe" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Rückgabetyp" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (Modul)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "Funktion" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "Methode" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "Klasse" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "Wert" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "Attribut" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "Modul" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Geändert in Version %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Veraltet ab Version %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (Direktive)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (Rolle)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "Direktive" - -#: domains/rst.py:235 -msgid "directive-option" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "Rolle" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Achtung" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Vorsicht" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Gefahr" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Fehler" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Hinweis" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Wichtig" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Bemerkung" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Siehe auch" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tipp" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Warnung" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: cmd/quickstart.py:234 +#: cmd/quickstart.py:786 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: cmd/quickstart.py:810 +#, python-format +msgid "Invalid template variable: %s" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" msgstr "" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autor des Abschnitts: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autor des Moduls: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autor des Quellcode: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: cmd/quickstart.py:286 +#: directives/patches.py:70 msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" msgstr "" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: cmd/quickstart.py:339 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d.%m.%Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Stichwortverzeichnis" + +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Fußnoten" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[Bild: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[Bild]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: cmd/quickstart.py:367 +#: writers/html5.py:431 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "numfig_format is not defined for %s" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" + +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" + +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:386 #, python-format -msgid "Creating file %s." +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "File %s already exists, skipping." +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:519 +#: writers/latex.py:616 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:526 +#: writers/latex.py:1198 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:530 +#: writers/latex.py:1228 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:809 +#: util/i18n.py:244 #, python-format -msgid "Invalid template variable: %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/build.py:74 +#: util/osutil.py:131 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:131 +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "Fortsetzung der vorherigen Seite" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "Fortsetzung auf der nächsten Seite" + +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Sonderzeichen" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "Seite" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Release" -#: cmd/build.py:212 -msgid "console output options" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Seitenleiste einklappen" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Inhaltsverzeichnis" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigation" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Suche in %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Über dieses Dokument" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Suche" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Los" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Zuletzt aktualisiert am %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Vorheriges Thema" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "vorheriges Kapitel" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Nächstes Thema" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "nächstes Kapitel" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Gesamtes Stichwortverzeichnis auf einer Seite" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Diese Seite" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Quellcode anzeigen" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Inhalt" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Schnellsuche" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Suche in %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Los" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2685,7 +2885,7 @@ msgstr "Globaler Modulindex" msgid "quick access to all modules" msgstr "schneller Zugriff auf alle Module" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Stichwortverzeichnis" @@ -2693,23 +2893,15 @@ msgstr "Stichwortverzeichnis" msgid "all functions, classes, terms" msgstr "alle Funktionen, Klassen, Begriffe" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Diese Seite" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Inhaltsverzeichnis" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Gesamtes Stichwortverzeichnis auf einer Seite" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Schnellsuche" +msgid "Search %(docstitle)s" +msgstr "Suche in %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2719,57 +2911,6 @@ msgstr "Stichwortverzeichnis nach Anfangsbuchstabe" msgid "can be huge" msgstr "kann groß sein" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Vorheriges Thema" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "vorheriges Kapitel" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Nächstes Thema" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "nächstes Kapitel" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigation" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Suche in %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Über dieses Dokument" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Zuletzt aktualisiert am %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2786,21 +2927,21 @@ msgstr "" msgid "search" msgstr "suchen" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Suchergebnisse ausblenden" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Inhalt" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Suchergebnisse" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Ihre Suche ergab keine Treffer. Bitte stellen Sie sicher, dass alle Wörter richtig geschrieben sind und genügend Kategorien ausgewählt sind." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2808,27 +2949,31 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Suchen" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Suche wird vorbereitet..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", in " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Suchergebnisse ausblenden" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" +msgid "Changes in Version %(version)s — %(docstitle)s" +msgstr "" + +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" msgstr "" #: themes/basic/changes/versionchanges.html:17 @@ -2852,120 +2997,127 @@ msgstr "Andere Änderungen" msgid "Expand sidebar" msgstr "Seitenleiste ausklappen" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parameter" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variablen" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Verursacht" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (im Modul %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (in Modul %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (Standard-Variable)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (Builtin-Klasse)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (Klasse in %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (Klassenmethode von %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (statische Methode von %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python-Modulindex" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "Module" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Veraltet" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "Exception" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "Klassenmethode" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statische Methode" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (veraltet)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parameter" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variablen" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Verursacht" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2976,746 +3128,526 @@ msgstr "Template Parameter" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "Member" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "Typ" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "Aufzählung" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "Enumerator" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "Variable" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "Makro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "Umgebungsvariable; %s" - -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "Glossareintrag" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "Grammatik-Token" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "Referenz-Label" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "Umgebungsvariable" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "Programmoption" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Modulindex" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "siehe %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "siehe auch %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Sonderzeichen" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" - -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "" +msgid "environment variable; %s" +msgstr "Umgebungsvariable; %s" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:116 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "%s; configuration value" msgstr "" -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:239 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:319 #, python-format -msgid "Unknown image format: %s..." +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "Glossareintrag" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "Index" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "Grammatik-Token" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "Referenz-Label" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "weiter" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "Umgebungsvariable" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "zurück" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "Programmoption" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Modulindex" -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1153 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy static file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Failed to write build info file: %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "%s %s Dokumentation" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Release" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" + +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "Fortsetzung der vorherigen Seite" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "Fortsetzung auf der nächsten Seite" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "Seite" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3723,7 +3655,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3738,481 +3670,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:123 #, python-format -msgid "%s is not a directory." +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" -msgstr "(in %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "Index" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "weiter" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "zurück" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s Dokumentation" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "siehe %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "siehe auch %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/de_DE/LC_MESSAGES/sphinx.mo b/sphinx/locale/de_DE/LC_MESSAGES/sphinx.mo index a8e26342d4b..91619ffc82b 100644 Binary files a/sphinx/locale/de_DE/LC_MESSAGES/sphinx.mo and b/sphinx/locale/de_DE/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/de_DE/LC_MESSAGES/sphinx.po b/sphinx/locale/de_DE/LC_MESSAGES/sphinx.po index 7c1421aa99f..43b75f34443 100644 --- a/sphinx/locale/de_DE/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/de_DE/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: German (Germany) (http://app.transifex.com/sphinx-doc/sphinx-1/language/de_DE/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: de_DE\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2804,21 +2945,20 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2827,6 +2967,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2848,119 +2993,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2972,92 +3124,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3085,581 +3230,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3667,548 +3720,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/el/LC_MESSAGES/sphinx.mo b/sphinx/locale/el/LC_MESSAGES/sphinx.mo index 5784c90a594..c5843c13d75 100644 Binary files a/sphinx/locale/el/LC_MESSAGES/sphinx.mo and b/sphinx/locale/el/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/el/LC_MESSAGES/sphinx.po b/sphinx/locale/el/LC_MESSAGES/sphinx.po index fc081cce481..3dcc383b65f 100644 --- a/sphinx/locale/el/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/el/LC_MESSAGES/sphinx.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Komiya Takeshi , 2021\n" "Language-Team: Greek (http://app.transifex.com/sphinx-doc/sphinx-1/language/el/)\n" @@ -21,6 +21,127 @@ msgstr "" "Language: el\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "η ρύθμιση %s.%s δεν εμφανίζεται από τις παραμετροποιήσεις θέματος που αναζητήθηκαν" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "δόθηκε μη υποστηριζόμενη επιλογή θέματος %r" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "το αρχείο %r στο μονοπάτι θέματος δεν αποτελεί ένα έγκυρο zipfile ή δεν περιλαμβάνει ένα θέμα" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -35,127 +156,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Το έργο χρειάζεται την επέκταση %s τουλάχιστον στην έκδοση %s και επομένως δεν είναι δυνατή η μεταγλώττιση με τη φορτωμένη έκδοση (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Το όνομα %r δεν είναι γνωστό" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Το συμβάν %r υπάρχει ήδη" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Άγνωστο όνομα συμβάντος: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Δεν είναι δυνατή η εύρεση του καταλόγου πηγής (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Ο κατάλογος πηγής και ο κατάλογος προορισμού δεν είναι δυνατό να είναι ίδιοι" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Εκτέλεση Sphinx έκδοση %s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s και επομένως δεν είναι δυνατή η μεταγλωτισση με αυτή την έκδοση." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "δημιουργία καταλόγου εξόδου" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "κατά τον καθορισμό της επέκτασης %s" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "η 'παραμετροποίηση' σύμφωνα με τον τρέχοντα ορισμό στο conf.py δεν αποτελεί καλέσιμο. Παρακαλείσθε να τροποποιήσετε τον ορισμό ώστε να το κάνετε μία καλέσιμη συνάρτηση. Αυτό απαιτείται προκειμένου το conf.py να συμπεριφέρεται ως μία επέκταση Sphinx." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "φόρτωση μεταφράσεων [%s]..." -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "ολοκλήρωση" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "δεν είναι διαθέσιμο για εσωτερικά μηνύματα" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "φόρτωση πακτωμένου περιβάλλοντος" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "αποτυχία: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Δεν επιλέχθηκε μεταγλωττιστής, θα χρησιμοποιηθεί ο προεπιλεγμένος: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "η κλάση κόμβου %r έχει ήδη καταχωρηθεί, οι επισκέπτες της θα υπερσκελιστούν" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -163,12 +311,12 @@ msgid "" "explicit" msgstr "η επέκταση %s δεν καθορίζει αν είναι ασφαλής η παράλληλη ανάγνωση, υποθέτοντας ότι δεν είναι - παρακαλείσθε να ζητήσετε από το δημιουργό της επέκτασης να το ελέγχει και να το κάνει σαφές" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -176,82 +324,214 @@ msgid "" "explicit" msgstr "η επέκταση %s δεν καθορίζει αν είναι ασφαλής η παράλληλη ανάγνωση, υποθέτοντας ότι δεν είναι - παρακαλείσθε να ζητήσετε το δημιουργό της επέκτασης να το ελέγξει και να το κάνει σαφές" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "εκτέλεση σειριακής %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "ο κατάλογος παραμετροποίησης δεν περιλαμβάνει κανένα αρχείο conf.py (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Η κλάση μεταγλώττισης %s δεν έχει χαρακτηριστικό \"name\" " + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Ο μεταγλωττιστής %r υφίσταται ήδη (στο δομοστοιχείο %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Το όνομα μεταγλωττιστή %s δεν είναι καταχωρημένο ή διαθέσιμο δια μέσου του σημείου εισαγωγής" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Το όνομα μεταγλωττιστή %sδεν είναι καταχορημένο" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "ο τομέας %s είναι ήδη καταχωρημένος" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "ο τομέας %s δεν έχει καταχωρηθεί ακόμη" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "Η οδηγία %r είναι ήδη καταχωρημένη στον τομέα %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "Ο ρόλος %r είναι ήδη καταχωρημένος στον τομέα %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "Ο δείκτης %r είναι ήδη καταχωρημένος στον τομέα %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "Το object_type %r είναι ήδη καταχωρημένο" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "Το crossref_type %r είναι ήδη καταχωρημένο" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "το source_suffix %r είναι ήδη καταχωρημένο" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "το source_parser για το %r είναι ήδη καταχωρημένο" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Ο αναλυτής πηγής για το %s δεν είναι καταχωρημένος" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "Ο μεταφραστής για το %r υφίσταται ήδη" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "το kwargs για το add_node() πρέπει να είναι μία (visit, depart) συνάρτηση πλειάδας: %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "το enumerable_node %r είναι ήδη καταχωρημένο" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "η επέκταση %r συγχωνεύθηκε ήδη με το Sphinx από την έκδοση %s; η επέκταση αυτή θα αγνοηθεί." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Αρχική εξαίρεση:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Δεν ήταν δυνατή η εισαγωγή της επέκτασης %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "η επέκταση %r δεν έχει συνάρτηση setup(); αποτελεί δομοστοιχείο επέκτασης του Sphinx;" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "Η επέκταση %s η οποία χρησιμοποιείται από αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s: επομένως δεν είναι δυνατή η μεταγλώττιση με αυτή την έκδοση." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "η επέκταση %r επιστρέφει ένα μη υποστηριζόμενο αντικείμενο από τη συνάρτησή της setup(): θα έπρεπε να επιστρέφει None ή έναν κατάλογο μεταδεδομένων" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "ο κατάλογος παραμετροποίησης δεν περιλαμβάνει κανένα αρχείο conf.py (%s)" + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "δεν είναι δυνατή η υπερσκέλιση της ρύθμισης παραμετροποίησης καταλόγου %r, θα αγνοηθεί (χρησιμοποιήστε το %r για να καθορίσετε τα επιμέρους στοιχεία)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "ανέγκυρος αριθμός %r για τιμή παραμετροποίησης %r, θα αγνοηθεί" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "δεν είναι δυνατή η υπερσκέλιση της ρύθμισης παραμετροποίησης %r με τύπο ο οποίος δεν υποστηρίζεται, θα αγνοηθεί" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "άγνωστη τιμή παραμετροποίσης %r στην υπερσκέλιση, θα αγνοηθεί" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Η τιμή παραμετροποίησης %r υφίσταται ήδη." -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Υπάρχει ένα συντακτικό λάθος στο αρχείο παραμετροποίησής σας: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Το αρχείο παραμετροποίησης (ή ένα από τα στοιχεία που εισάγει) κάλεσε την sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -259,469 +539,625 @@ msgid "" "%s" msgstr "Υπάρχει ένα προγραμματιστικό λάθος στο αρχείο παραμετροποίησής σας:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Τομέας %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Εικ. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Πίνακας %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Λίστα %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Η τιμή παραμετροποίησης '{name}' πρέπει να λαμβάνει μία από τις {candidates} αλλά εκχωρήθηκε η '{current}'." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Η τιμή παραμετροποίησης '{name]' έχει τύπο '[current__name__}'; αναμενόμενη {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Η τιμή παραμετροποίησης '{name}' έχει τύπο '{current__name__}', αρχικοποίηση σε '{default__name__}'." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "το primary_domain %r δεν βρέθηκε, θα αγνοηθεί." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Το όνομα %r δεν είναι γνωστό" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "νέα παραμετροποίηση" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "η παραμετροποίηση άλλαξε" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "η ρύθμιση %s.%s δεν εμφανίζεται από τις παραμετροποιήσεις θέματος που αναζητήθηκαν" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "αλλαγμένες επεκτάσεις" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "δόθηκε μη υποστηριζόμενη επιλογή θέματος %r" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "η έκδοση του περιβάλλοντος μεταλώττισης δεν είναι η τρέχουσα" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "το αρχείο %r στο μονοπάτι θέματος δεν αποτελεί ένα έγκυρο zipfile ή δεν περιλαμβάνει ένα θέμα" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "ο πηγαίος κατάλογος έχει αλλάξει" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" -msgstr "" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Το περιβάλλον δεν είναι συμβατό με τον επιλεγμένο μεταγλωττιστή, παρακαλείστε να επιλέξετε ένα διαφορετικό κατάλογο toctree." -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" -msgstr "" +msgid "Failed to scan documents in %s: %r" +msgstr "Αδυναμία σάρωσης εγγράφων σε %s: %r" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +msgid "Domain %r is not registered" +msgstr "Ο τομέας %r δεν είναι καταχωρημένος" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "το έγγραφο δεν συμπεριλαμβάνεται σε κανένα toctree" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "Βρέθηκε αυτοαναφερόμενο toctree. Θα αγνοηθεί." -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Προσοχή" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Το συμβάν %r υπάρχει ήδη" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Προσοχή" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Άγνωστο όνομα συμβάντος: %s" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Κίνδυνος" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Σφάλμα" -#: project.py:72 +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Συμβουλή" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Σημαντικό" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Σημείωση" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Δείτε επίσης" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Πρακτική συμβουλή" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Προειδοποίηση" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Τα αρχεία Texinfo βρίσκονται σε %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nΕκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του makeinfo\n(χρησιμοποιήστε το 'make info' εδώ για να το κάνετε αυτόματα)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "δεν βρέθηκε τιμή \"texinfo_documents\": δεν θα γίνει εγγραφή κανενός κειμένου" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Η κλάση μεταγλώττισης %s δεν έχει χαρακτηριστικό \"name\" " +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "η τιμή παραμετροποίησης \"texninfo_documents\" αναφέρεται σε άγνωστο κείμενο %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Ο μεταγλωττιστής %r υφίσταται ήδη (στο δομοστοιχείο %s)" +msgid "processing %s" +msgstr "επεξεργασία %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Το όνομα μεταγλωττιστή %s δεν είναι καταχωρημένο ή διαθέσιμο δια μέσου του σημείου εισαγωγής" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "εγγραφή" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Το όνομα μεταγλωττιστή %sδεν είναι καταχορημένο" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "επίλυση αναφορών..." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "ο τομέας %s είναι ήδη καταχωρημένος" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (σε " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "ο τομέας %s δεν έχει καταχωρηθεί ακόμη" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "αντιγραφή εικόνων..." -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "Η οδηγία %r είναι ήδη καταχωρημένη στον τομέα %s" +msgid "cannot copy image file %r: %s" +msgstr "δεν είναι δυνατή η αντιγραφή αρχείου εικόνας %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "Ο ρόλος %r είναι ήδη καταχωρημένος στον τομέα %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "αντιγραφή αρχείων υποστήριξης Texinfo" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "Ο δείκτης %r είναι ήδη καταχωρημένος στον τομέα %s" +msgid "error writing file Makefile: %s" +msgstr "σφάλμα κατά την εγγραφή του αρχείου Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "Το object_type %r είναι ήδη καταχωρημένο" +msgid "The manual pages are in %(outdir)s." +msgstr "Οι σελίδες manual βρίσκονται σε %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "Το crossref_type %r είναι ήδη καταχωρημένο" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "δεν βρέθηκε τιμή παραμετροποίησης \"man_pages\"; δεν θα καταγραφούν manual pages" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "το source_suffix %r είναι ήδη καταχωρημένο" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "η τιμή παραμετροποίησης \"man_pages\" κάνει αναφορά το άγνωστο κείμενο %s" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "το source_parser για το %r είναι ήδη καταχωρημένο" +msgid "The HTML page is in %(outdir)s." +msgstr "Η σελίδα HTML είναι στο %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "Ο αναλυτής πηγής για το %s δεν είναι καταχωρημένος" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "συναρμολόγηση απλού κειμένου" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "Ο μεταφραστής για το %r υφίσταται ήδη" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "εγγραφή επιπρόσθετων αρχείων" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "το kwargs για το add_node() πρέπει να είναι μία (visit, depart) συνάρτηση πλειάδας: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "Ο προσωρινός μεταγλωττιστής δεν δημιουργεί αρχεία." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "το enumerable_node %r είναι ήδη καταχωρημένο" +msgid "The message catalogs are in %(outdir)s." +msgstr "Οι κατάλογοι των μηνυμάτων είναι στο %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "" +msgid "building [%s]: " +msgstr "μεταγλώττιση [%s]:" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "η επέκταση %r συγχωνεύθηκε ήδη με το Sphinx από την έκδοση %s; η επέκταση αυτή θα αγνοηθεί." +msgid "targets for %d template files" +msgstr "στόχοι για %d πρότυπα αρχεία" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Αρχική εξαίρεση:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "ανάγνωση προτύπων..." -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "Δεν ήταν δυνατή η εισαγωγή της επέκτασης %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "εγγραφή καταλόγων μηνύματος..." -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "η επέκταση %r δεν έχει συνάρτηση setup(); αποτελεί δομοστοιχείο επέκτασης του Sphinx;" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Αναζητήστε οποιαδήποτε λάθη στο παραπάνω αποτέλεσμα ή σε %(outdir)s/output.txt" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "Η επέκταση %s η οποία χρησιμοποιείται από αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s: επομένως δεν είναι δυνατή η μεταγλώττιση με αυτή την έκδοση." +msgid "broken link: %s (%s)" +msgstr "λανθασμένος σύνδεσμος: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "η επέκταση %r επιστρέφει ένα μη υποστηριζόμενο αντικείμενο από τη συνάρτησή της setup(): θα έπρεπε να επιστρέφει None ή έναν κατάλογο μεταδεδομένων" +msgid "Anchor '%s' not found" +msgstr "Δεν βρέθηκε το anchor '%s'" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." +msgstr "Το αρχείο ePub βρίσκεται σε %(outdir)s." + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:251 +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "η τιμή παραμετροποίησης \"epub_language\" (ή \"language\") δεν πρέπει να είναι κενή για EPUB3" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "η τιμή παραμετροποίησης \"epub_uid\" πρέπει να είναι XML NAME για EPUB3" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "η τιμή παραμετροποίησης \"epub_title\" (ή \"html_title\") δεν πρέπει να είναι κενή για EPUB3" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "η τιμή παραμετροποίησης \"epub_author\" δεν πρέπει να είναι κενή για EPUB3" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "η τιμή παραμετροποίησης \"epub_contributor\" δεν πρέπει να είναι κενή για EPUB3" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "η τιμή παραμετροποίησης \"epub_description\" δεν πρέπει να είναι κενή για EPUB3" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "η τιμή παραμετροποίησης \"epub_publisher\" δεν πρέπει να είναι κενή για EPUB3" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "η τιμή παραμετροποίησης \"epub_copyright\" (ή \"copyright\") δεν πρέπει να είναι κενή για EPUB3" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "η τιμή παραμετροποίησης \"epub_identifier\" δεν πρέπει να είναι κενή για EPUB3" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "η τιμή παραμετροποίησης \"version\" δεν πρέπει να είναι κενή για EPUB3" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +msgid "invalid css_file: %r, ignored" +msgstr "ανέγκυρο css_file: %r, θα αγνοηθεί" -#: roles.py:274 +#: builders/xml.py:29 #, python-format -msgid "invalid CWE number %s" -msgstr "" +msgid "The XML files are in %(outdir)s." +msgstr "Τα αρχεία XML βρίσκονται σε %(outdir)s." -#: roles.py:294 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +msgid "error writing file %s: %s" +msgstr "σφάλμα καταγραφής αρχείου %s: %s" -#: roles.py:317 +#: builders/xml.py:103 #, python-format -msgid "invalid PEP number %s" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Τα αρχεία XML βρίσκονται σε %(outdir)s." + +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" +msgstr "βρέθηκε διπλότυπη εγγραφή ToC: %s" + +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" +msgstr "δεν είναι δυνατή η ανάγωνση αρχείου εικόνας %r: αντί αυτού θα αντιγραφεί" + +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" +msgstr "δεν είναι δυνατή η εγγραφή αρχείου %r: %s" + +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Το pillow δεν βρέθηκε - αντιγραφή αρχείων εικόνας" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: roles.py:355 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid RFC number %s" +msgid "unknown mimetype for %s, ignoring" +msgstr "άγνωστο mimetype για %s, θα ανγοηθεί" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[πηγή]" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "επισήμανση κώδικα δομοστοιχείου..." +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "εγγραφή %s αρχείου..." -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[τεκμηρίωση]" +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "Τα αρχεία κειένου βρίσκονται σε %(outdir)s." -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Κώδικας μονάδας" +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s (%s)" -#: ext/viewcode.py:353 +#: builders/__init__.py:237 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        Πηγαίος κώδικας για το %s

        " +msgid "a suitable image for %s builder not found: %s" +msgstr "δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Επισκόπηση: κώδικας της μονάδας" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "μεταγλώττιση [mo]:" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Όλες οι μονάδες για τις οποίες υπάρχει διαθέσιμος κώδικας

        " +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "εγγραφή εξόδου..." -#: ext/extlinks.py:82 +#: builders/__init__.py:280 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "" +msgid "all of %d po files" +msgstr "όλα τα αρχεία po του %d" -#: ext/autosectionlabel.py:52 +#: builders/__init__.py:302 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "" +msgid "targets for %d po files that are specified" +msgstr "στόχοι για τα αρχεία po του %d οι οποίοι έχουν καθοριστεί" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/__init__.py:314 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s" +msgid "targets for %d po files that are out of date" +msgstr "στόχοι για τα αρχεία po του %d τα οποία είναι ξεπερασμένα" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "όλα τα αρχεία πηγής" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/duration.py:90 +#: builders/__init__.py:342 +#, python-format msgid "" -"====================== slowest reading durations =======================" +"file %r given on command line is not under the source directory, ignoring" +msgstr "το αρχείο %r που δόθηκε στη γραμμή εντολής δεν βρίσκεται κάτω από τον κατάλογο πηγής, θα αγνοηθεί" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:118 +#: builders/__init__.py:366 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "λείπει '+' ή '-' στην επιλογή '%s'." +msgid "%d source files given on command line" +msgstr "τα αρχεία πηγής %d που δόθηκαν στη γραμμή εντολής" -#: ext/doctest.py:124 +#: builders/__init__.py:382 #, python-format -msgid "'%s' is not a valid option." -msgstr "Η '%s δεν είναι μία έγκυρη επιλογή." +msgid "targets for %d source files that are out of date" +msgstr "στόχοι για τα αρχεία πηγής %d τα οποία είναι ξεπερασμένα" -#: ext/doctest.py:139 +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "αναζήτηση για νεοξεπερασμένα αρχεία..." + +#: builders/__init__.py:415 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' δεν αποτελεί μία έγκυρη επιλογή για pyversion" +msgid "%d found" +msgstr "βρέθηκε %d" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "ανέγκυρος τύπος TestCode" +#: builders/__init__.py:417 +msgid "none found" +msgstr "δεν βρέθηκε κανένα" -#: ext/doctest.py:297 +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "Περιβάλλον μετατροπής αντικειμένων Python σε ροή bytes" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "έλεγχος συνοχής" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "κανένας στόχος δεν είναι ξεπερασμένος." + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "αναβάθμιση περιβάλλοντος:" + +#: builders/__init__.py:499 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Ολοκληρώθηκε η δοκιμή των doctests στις πηγές, δείτε τα αποτελέσματα σε %(outdir)s/output.txt." +msgid "%s added, %s changed, %s removed" +msgstr "%s προστέθηκε, %s άλλαξε, %s απομακρύνθηκε" -#: ext/doctest.py:457 +#: builders/__init__.py:536 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "δεν υπάρχει κώδικας/αποτέλεσμα στο τμήμα %s στο %s:%s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:545 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "Ο ανέγκυρος κώδικας doctest θα αγνοηθεί: %r" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:556 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "Η εντολή LaTex %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για απεικόνιση μαθηματικών), ελέγξτε τη ρύθμιση imgmath_latex" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:563 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%s η εντολή %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για μαθηματική απεικόνιση), ελέγξτε τη ρύθμιση imgmath_%s" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "ανάγνωση πηγών..." -#: ext/imgmath.py:344 +#: builders/__init__.py:725 #, python-format -msgid "display latex %r: %s" -msgstr "απεικόνιση latex %r: %s" +msgid "docnames to write: %s" +msgstr "docname προς εγγραφή: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "προετοιμασία κειμένων" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" -#: ext/imgmath.py:380 +#: builders/changes.py:29 #, python-format -msgid "inline latex %r: %s" -msgstr "σε σειρά latex %r: %s" +msgid "The overview file is in %(outdir)s." +msgstr "Το αρχείο επισκόπησης είναι σε %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "καμία αλλαγή στην έκδοση %s." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "εγγραφή αρχείου σύνοψης" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Ενσωματωμένες λειτουργίες" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Επίπεδο μονάδας λειτουργίας" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "αντιγραφή αρχείων πηγής..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "δεν ήταν δυνατή η ανάγνωση %r για τη δημιουργία changelog" #: ext/coverage.py:48 #, python-format @@ -741,9 +1177,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -778,11 +1215,39 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" -#: ext/imgconverter.py:44 +#: ext/extlinks.py:82 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Εκκρεμότητα" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "βρέθηκε εγγραφή TODO:%s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(Το <> βρίσκεται στο %s, γραμή %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "αρχική εγγραφή" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" "Traceback: %s" msgstr "" @@ -865,948 +1330,994 @@ msgstr "[γράφημα: %s]" msgid "[graph]" msgstr "[γράφημα]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Εκκρεμότητα" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" -msgstr "βρέθηκε εγγραφή TODO:%s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "Η εντολή LaTex %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για απεικόνιση μαθηματικών), ελέγξτε τη ρύθμιση imgmath_latex" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s η εντολή %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για μαθηματική απεικόνιση), ελέγξτε τη ρύθμιση imgmath_%s" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(Το <> βρίσκεται στο %s, γραμή %d.)" +msgid "display latex %r: %s" +msgstr "απεικόνιση latex %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "αρχική εγγραφή" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "σε σειρά latex %r: %s" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" -msgstr "Ανέγκυρη λεζάντα: %s" +msgid "missing '+' or '-' in '%s' option." +msgstr "λείπει '+' ή '-' στην επιλογή '%s'." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "η προδιαγραφή αριθμού σειράς είναι εκτός e;yroyw (1-%d): %r" +msgid "'%s' is not a valid option." +msgstr "Η '%s δεν είναι μία έγκυρη επιλογή." -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Δεν είναι δυνατή η ταυτόχρονη χρήση των επιλογών \"%s\" και \"%s\"" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' δεν αποτελεί μία έγκυρη επιλογή για pyversion" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "ανέγκυρος τύπος TestCode" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Ολοκληρώθηκε η δοκιμή των doctests στις πηγές, δείτε τα αποτελέσματα σε %(outdir)s/output.txt." -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "Το αντικείμενο με όνομα %r δεν βρέθηκε στο συμπεριληφθέν αρχείο %r" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "Δεν είναι δυνατή η χρήση \"leneno-match\" με ένα κομματιασμένο σετ απο \"lines\"" +msgid "no code/output in %s block at %s:%s" +msgstr "δεν υπάρχει κώδικας/αποτέλεσμα στο τμήμα %s στο %s:%s" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Προσδιορισμός γραμμής %r: δεν ελήφθησαν γραμμές από το συμπεριληφθέν αρχείο %r" - -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" +msgid "ignoring invalid doctest code: %r" +msgstr "Ο ανέγκυρος κώδικας doctest θα αγνοηθεί: %r" -#: directives/other.py:119 +#: ext/autosectionlabel.py:52 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "Το toctree περιλαμβάνει αναφορά στο αποκλεισμένο κείμενο %r" - -#: directives/other.py:156 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "το toctree περιλαμβάνει αναφορά στο μη υπαρκτό έγγραφο %r" +msgid "duplicate label %s, other instance in %s" +msgstr "διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s" -#: directives/other.py:169 +#: ext/duration.py:47 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Συντάκτης τμήματος: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Συντάκτης μονάδας: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Συντάκτης κώδικα: " - -#: directives/other.py:209 -msgid "Author: " -msgstr "Συντάκτης: " - -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." -msgstr "Το αρχείο επισκόπησης είναι σε %(outdir)s." +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" -#: builders/changes.py:56 +#: ext/duration.py:139 #, python-format -msgid "no changes in version %s." -msgstr "καμία αλλαγή στην έκδοση %s." - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "εγγραφή αρχείου σύνοψης" +msgid "%.3fs %s" +msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Ενσωματωμένες λειτουργίες" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[πηγή]" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Επίπεδο μονάδας λειτουργίας" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "επισήμανση κώδικα δομοστοιχείου..." -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "αντιγραφή αρχείων πηγής..." +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[τεκμηρίωση]" -#: builders/changes.py:133 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "δεν ήταν δυνατή η ανάγνωση %r για τη δημιουργία changelog" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Κώδικας μονάδας" -#: builders/manpage.py:37 +#: ext/viewcode.py:359 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Οι σελίδες manual βρίσκονται σε %(outdir)s." +msgid "

        Source code for %s

        " +msgstr "

        Πηγαίος κώδικας για το %s

        " -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "δεν βρέθηκε τιμή παραμετροποίησης \"man_pages\"; δεν θα καταγραφούν manual pages" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Επισκόπηση: κώδικας της μονάδας" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "εγγραφή" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Όλες οι μονάδες για τις οποίες υπάρχει διαθέσιμος κώδικας

        " -#: builders/manpage.py:71 +#: domains/citation.py:75 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "η τιμή παραμετροποίησης \"man_pages\" κάνει αναφορά το άγνωστο κείμενο %s" +msgid "duplicate citation %s, other instance in %s" +msgstr "διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s" -#: builders/__init__.py:224 +#: domains/citation.py:92 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s (%s)" +msgid "Citation [%s] is not referenced." +msgstr "Η παραπομπή [%s] δεν αναφέρεται." -#: builders/__init__.py:232 +#: domains/math.py:73 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "μεταγλώττιση [mo]:" - -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "εγγραφή εξόδου..." +msgid "duplicate label of equation %s, other instance in %s" +msgstr "διπλότυπη ετικέτα της εξίσωσης %s, άλλη εμφάνιση στο %s" -#: builders/__init__.py:275 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "all of %d po files" -msgstr "όλα τα αρχεία po του %d" +msgid "Invalid math_eqref_format: %r" +msgstr "Ανέγκυρο math_eqref_format: %r" -#: builders/__init__.py:297 +#: domains/javascript.py:183 #, python-format -msgid "targets for %d po files that are specified" -msgstr "στόχοι για τα αρχεία po του %d οι οποίοι έχουν καθοριστεί" +msgid "%s() (built-in function)" +msgstr "%s() (ενσωματωμένη συνάρτηση)" -#: builders/__init__.py:309 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "στόχοι για τα αρχεία po του %d τα οποία είναι ξεπερασμένα" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "όλα τα αρχεία πηγής" +msgid "%s() (%s method)" +msgstr "%s() (μέθοδος της %s)" -#: builders/__init__.py:330 +#: domains/javascript.py:186 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +msgid "%s() (class)" +msgstr "%s() (κλάση)" -#: builders/__init__.py:337 +#: domains/javascript.py:188 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "το αρχείο %r που δόθηκε στη γραμμή εντολής δεν βρίσκεται κάτω από τον κατάλογο πηγής, θα αγνοηθεί" +msgid "%s (global variable or constant)" +msgstr "%s (καθολική μεταβλητή ή σταθερά)" -#: builders/__init__.py:348 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (ιδιότητα της %s)" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "τα αρχεία πηγής %d που δόθηκαν στη γραμμή εντολής" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Παράμετροι" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "στόχοι για τα αρχεία πηγής %d τα οποία είναι ξεπερασμένα" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Προκαλεί" -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " -msgstr "μεταγλώττιση [%s]:" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Επιστρέφει" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "αναζήτηση για νεοξεπερασμένα αρχεία..." +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Επιστρεφόμενος τύπος" -#: builders/__init__.py:410 +#: domains/javascript.py:374 #, python-format -msgid "%d found" -msgstr "βρέθηκε %d" +msgid "%s (module)" +msgstr "%s (μονάδα)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "δεν βρέθηκε κανένα" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "συνάρτηση" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "Περιβάλλον μετατροπής αντικειμένων Python σε ροή bytes" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "μέθοδος" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "έλεγχος συνοχής" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "κλάση" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "κανένας στόχος δεν είναι ξεπερασμένος." +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "δεδομένα" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "αναβάθμιση περιβάλλοντος:" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "ιδιότητα" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s προστέθηκε, %s άλλαξε, %s απομακρύνθηκε" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "μονάδα" -#: builders/__init__.py:531 +#: domains/javascript.py:458 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:540 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "%s (directive)" +msgstr "%s (οδηγία)" -#: builders/__init__.py:551 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:558 +#: domains/rst.py:224 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "ανάγνωση πηγών..." +msgid "%s (role)" +msgstr "%s (ρόλος)" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" -msgstr "docname προς εγγραφή: %s" +#: domains/rst.py:234 +msgid "directive" +msgstr "οδηγία" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "προετοιμασία κειμένων" - -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "" +#: domains/rst.py:236 +msgid "role" +msgstr "ρόλος" -#: builders/__init__.py:883 +#: domains/rst.py:262 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "μη κωδικοποιήσιμοι χαρακτήρες πηγής, θα αντικατασταθούν με \"?\": %r" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "" -#: builders/epub3.py:84 +#: domains/changeset.py:32 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "Το αρχείο ePub βρίσκεται σε %(outdir)s." - -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +msgid "Added in version %s" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "η τιμή παραμετροποίησης \"epub_language\" (ή \"language\") δεν πρέπει να είναι κενή για EPUB3" - -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "η τιμή παραμετροποίησης \"epub_uid\" πρέπει να είναι XML NAME για EPUB3" - -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "η τιμή παραμετροποίησης \"epub_title\" (ή \"html_title\") δεν πρέπει να είναι κενή για EPUB3" - -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "η τιμή παραμετροποίησης \"epub_author\" δεν πρέπει να είναι κενή για EPUB3" - -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "η τιμή παραμετροποίησης \"epub_contributor\" δεν πρέπει να είναι κενή για EPUB3" - -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "η τιμή παραμετροποίησης \"epub_description\" δεν πρέπει να είναι κενή για EPUB3" - -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "η τιμή παραμετροποίησης \"epub_publisher\" δεν πρέπει να είναι κενή για EPUB3" - -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "η τιμή παραμετροποίησης \"epub_copyright\" (ή \"copyright\") δεν πρέπει να είναι κενή για EPUB3" - -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "η τιμή παραμετροποίησης \"epub_identifier\" δεν πρέπει να είναι κενή για EPUB3" - -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "η τιμή παραμετροποίησης \"version\" δεν πρέπει να είναι κενή για EPUB3" - -#: builders/epub3.py:279 builders/html/__init__.py:1291 +#: domains/changeset.py:33 #, python-format -msgid "invalid css_file: %r, ignored" -msgstr "ανέγκυρο css_file: %r, θα αγνοηθεί" +msgid "Changed in version %s" +msgstr "Άλλαξε στην έκδοση %s" -#: builders/xml.py:31 +#: domains/changeset.py:34 #, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Τα αρχεία XML βρίσκονται σε %(outdir)s." +msgid "Deprecated since version %s" +msgstr "Αποσύρθηκε στην έκδοση %s" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: domains/changeset.py:35 #, python-format -msgid "error writing file %s: %s" -msgstr "σφάλμα καταγραφής αρχείου %s: %s" +msgid "Removed in version %s" +msgstr "" -#: builders/xml.py:101 +#: domains/__init__.py:322 #, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Τα αρχεία XML βρίσκονται σε %(outdir)s." +msgid "%s %s" +msgstr "%s %s" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Τα αρχεία Texinfo βρίσκονται σε %(outdir)s." +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "ο αριθμός εργασίας θα πρέπει να είναι θετικός αριθμός" + +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" -#: builders/texinfo.py:48 +#: cmd/build.py:74 msgid "" "\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nΕκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του makeinfo\n(χρησιμοποιήστε το 'make info' εδώ για να το κάνετε αυτόματα)." - -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "δεν βρέθηκε τιμή \"texinfo_documents\": δεν θα γίνει εγγραφή κανενός κειμένου" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "η τιμή παραμετροποίησης \"texninfo_documents\" αναφέρεται σε άγνωστο κείμενο %s" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "επεξεργασία %s" - -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "επίλυση αναφορών..." - -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (σε " +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "αντιγραφή εικόνων..." +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "μονοπάτι για τα αρχεία πηγής τεκμηρίωσης" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "δεν είναι δυνατή η αντιγραφή αρχείου εικόνας %r: %s" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "μονοπάτι στον κατάλογο εξόδου" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "αντιγραφή αρχείων υποστήριξης Texinfo" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "σφάλμα κατά την εγγραφή του αρχείου Makefile: %s" +#: cmd/build.py:114 +msgid "general options" +msgstr "γενικές επιλογές" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "βρέθηκε διπλότυπη εγγραφή ToC: %s" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "δεν είναι δυνατή η ανάγωνση αρχείου εικόνας %r: αντί αυτού θα αντιγραφεί" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "δεν είναι δυνατή η εγγραφή αρχείου %r: %s" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "εγγραφή όλων των αρχείων (προεπιλογή: εγγραφή μόνο νέων και αλλαγμένων αρχείων)" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Το pillow δεν βρέθηκε - αντιγραφή αρχείων εικόνας" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "μην χρησιμοποιείτε ένα αποθηκευμένο περιβάλλον, πάντα να διαβάζετε όλα τα αρχεία" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "άγνωστο mimetype για %s, θα ανγοηθεί" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "παράκαμψη ρύθμισης στο αρχείο παραμετροποίησης" + +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "μεταφορά τιμής στα πρότυπα HTML" + +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "ορίστε ετικέτα: συμπεριλάβατε \"only\" τμήματα με TAG" + +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "εγγραφή %s αρχείου..." +#: cmd/build.py:212 +msgid "console output options" +msgstr "επιλογές εξόδου κονσόλας" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "Ο προσωρινός μεταγλωττιστής δεν δημιουργεί αρχεία." +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "αυξήστε τον βερμπαλισμό (μπορεί να επαναληφθεί)" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Οι κατάλογοι των μηνυμάτων είναι στο %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "καμία έξοδος στο stdout, μόνο προειδοποιήσεις στο stderr" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "στόχοι για %d πρότυπα αρχεία" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "κανένα αποτέλεσμα ούτε προειδοποιήσεις" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "ανάγνωση προτύπων..." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "να γίνεται εκπομπή χρωματιστής εξόδου (προεπιλογή: auto-detect)" -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "εγγραφή καταλόγων μηνύματος..." +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "να μην παρουσιάζεται έγχρωμο αποτέλεσμα (προεπιλογή: αυτόματη αναγνώριση)" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "Η σελίδα HTML είναι στο %(outdir)s." +#: cmd/build.py:252 +msgid "warning control options" +msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "συναρμολόγηση απλού κειμένου" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "προειδοποιήσεις εγγραφής (και σφάλματα) στο δοθέν αρχείο" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "εγγραφή επιπρόσθετων αρχείων" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "μετατροπή προειδοποιήσεων σε σφάλματα" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Αναζητήστε οποιαδήποτε λάθη στο παραπάνω αποτέλεσμα ή σε %(outdir)s/output.txt" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "απεικόνιση πλήρους ιστορικού σε περίπτωση εξαίρεσης" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "λανθασμένος σύνδεσμος: %s (%s)" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "εκτέλεση Pdb σε περίπτωση εξαίρεσης" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "Δεν βρέθηκε το anchor '%s'" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" + +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "δεν γίνεται συνδιασμός της επιλογής -a και των ονομάτων αρχείων" -#: builders/linkcheck.py:758 +#: cmd/build.py:357 #, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Τα αρχεία κειένου βρίσκονται σε %(outdir)s." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "Το όρισμα -D πρέπει να είναι της μορφής όνομα=τιμέ" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "ασυνεπείς αναφορές υποσημείωσης στα μεταφρασμένα μηνύματα. original: {0}, translated: {1}" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "Το όρισμα -Α πρέπει να είναι της μορφής όνομα=τιμή" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "ασυνεπείς αναφορές στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "αυτόματη εισαγωγή docstrings από τα δομοστοιχεία" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "ασυνεπείς αναφορές παραπομπής στο μεταφρασμένο μήνυμα. αρχικό: {0}, μεταφρασμένο: {1}" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "αυτόματα κομμάτια δοκιμαστικού κώδικα σε τμήματα doctest" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "ασυνεπείς αναφορές όρων στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "σύνδεσμος μεταξύ τεκμηρίωσης Sphinx διαφόρων έργων" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %B %Y" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "γράψτε εγγραφές \"todo\" οι οποίες μπορούν αν εμφανίζονται ή να αποκρύπτονται κατά τη μεταγλώττιση" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "αναζήτηση για κάλυψη βιβλιογραφίας" -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "να συμπεριληφθεί το math, απεικονισμένο ως εικόνες PNG η SVG" -#: transforms/__init__.py:253 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "βρέθηκε ευρετήριο βασιζόμενο σε 4 στήλες. Μπορεί να αποτελεί σφάλμα της επέκτασης που χρησιμοποιείτε: %r" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "να συμπεριληφθεί το math, απεικονισμένο στο φυλλομετρηρή απο το MathJax" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "Δεν υπάρχει αναφορά για την υποσημείωση [%s]." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "υποθετική εισαγωγή περιεχομένου βασισμένη στις τιμές παραμετροποίησης" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "να συμπεριληφθούν σύνδεσμοι στον πηγαίο κώδικα των τεκμηριωμένων αντικειμένων Python" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "Η υποσημείωση [#] δεν αναφέρεται." +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "δημιουργία αρχείου .nojekyll για έκδοση του εγγράφου στις σελίδες GitHub " -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Παρακαλείστε να εισάγετε ένα έγκυρο όνομα μονοπατιού." -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Παρακαλείστε να εισάγετε κάποιο κείμενο." -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" +#: cmd/quickstart.py:134 +#, python-format +msgid "Please enter one of %s." +msgstr "Παρακαλείστε να εισάγετε ένα από τα %s." -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Παρακαλείστε να εισάγετε είτε 'y' είτε 'n'." -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Παρακαλείστε να εισάγετε μία επέκταση αρχείου, π.χ. '.rst' ή '.txt'." -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Καλώς ήρθατε στο εργαλείο γρήγορης εκκίνησης Sphinx %s." -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:235 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:242 +#, python-format +msgid "Selected root path: %s" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Ριζικό μονοπάτι για την τεκμηρίωση" -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Σφάλμα: ένα υπάρχον conf.py έχει βρεθεί στοn επιλεγμένο ριζικό κατάλογο." -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα έργα Sphinx." -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Παρακαλείστε να εισάγετε ένα νέο ριζικό μονοπάτι (ή απλά πιέστε το Enter για έξοδο)" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Ξεχωριστοί κατάλογοι για πηγή και μεταγλώττιση (y/n)" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: environment/__init__.py:86 -msgid "new config" -msgstr "νέα παραμετροποίηση" - -#: environment/__init__.py:87 -msgid "config changed" -msgstr "η παραμετροποίηση άλλαξε" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Πρόθεμα ονόματος για πρότυπα και στατικούς καταλόγους" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "αλλαγμένες επεκτάσεις" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "η έκδοση του περιβάλλοντος μεταλώττισης δεν είναι η τρέχουσα" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Όνομα έργου" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "ο πηγαίος κατάλογος έχει αλλάξει" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Όνομα(τα) συγγραφέα" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Έκδοση έργου" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Κυκλοφορία έργου" -#: environment/__init__.py:379 +#: cmd/quickstart.py:324 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "Το περιβάλλον δεν είναι συμβατό με τον επιλεγμένο μεταγλωττιστή, παρακαλείστε να επιλέξετε ένα διαφορετικό κατάλογο toctree." - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "Αδυναμία σάρωσης εγγράφων σε %s: %r" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "Ο τομέας %r δεν είναι καταχωρημένος" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Γλώσσα έργου" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "το έγγραφο δεν συμπεριλαμβάνεται σε κανένα toctree" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "Βρέθηκε αυτοαναφερόμενο toctree. Θα αγνοηθεί." +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Επέκταση αρχείου πηγής" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "σφάλμα ανάγνωσης: %s, %s" - -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "καταγραφή λάθους: %s, %s" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Όνομα του κυρίους σας εγγράφου (χωρίς επέκταση)" -#: util/i18n.py:146 +#: cmd/quickstart.py:368 #, python-format -msgid "locale_dir %s does not exist" -msgstr "" +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Σφάλμα: το κύριο αρχείο %s έχει ήδη βρεθεί στο επιλεγμένο ριζικό κατάλογο." -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα αρχεία." -#: util/i18n.py:245 -#, python-format +#: cmd/quickstart.py:378 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Ανέγκυρος τύπος ημερομηνίας. Τοποθετείστε στη στοιχειοσειρά μονά εισαγωγικά εάν θέλετε να το εξάγετε απευθείας: %s" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Παρακαλείσθε να εισάγετε ένα νέο όνομα αρχείου, ή να μεταονομάσετε το υπάρχον αρχείο και να πιέσετε το Enter" -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Υποδείξτε ποιά απο τις ακόλουθες επεκτάσεις Sphinx πρέπει να ενεργοποιηθούν:" + +#: cmd/quickstart.py:397 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Σημείωση: τα imgmath και mathjax δεν είναι δυνατό να ενεργοποιηθούν ταυτόχρονα. Το imgmath έχει αποεπιλεγθεί. " -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:407 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "το toctree περιλαμβάνει αναφορά σε άγνωστο αρχείο %r" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Δημιουργία Makefile; (y/n)" + +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Δημιουργία αρχείου εντολών Windows; (y/n)" -#: util/nodes.py:706 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "εξαίρεση κατά την αξιολόγηση μόνο της έκφρασης οδηγίας: %s" +msgid "Creating file %s." +msgstr "Δημιουργία αρχείου %s." -#: util/display.py:82 -msgid "skipped" -msgstr "παράβλεψη" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." +msgstr "Το αρχείο %s υπάρχει ήδη, παραλείπεται." -#: util/display.py:87 -msgid "failed" -msgstr "αποτυχία" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Ολοκλήρωση: μία αρχική δομή καταλόγου δημιουργήθηκε." -#: util/osutil.py:131 +#: cmd/quickstart.py:520 #, python-format msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:531 #, python-format -msgid "unknown role name: %s" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" -msgstr "άγνωστος τύπος κόμβου: %r" - -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:538 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nΔημιουργία απαιτούμενων αρχείων για ένα έργο Sphinx.\n\nΤο sphinx-quickstart είναι ένα διαδραστικό εργαλείο το οποίο κάνει κάποιες ερωτήσεις για το δικό σας \nέργο και μετά δημιουργεί έναν πλήρη κατάλογο τεκμηρίωσης και δείγμα \nMakefile για να χρησιμοποιηθεί με το sphinx-build.\n" -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "ο προεπιλεγμένος ρόλος %s δεν βρέθηκε" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "ήσυχος τρόπος" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Επιλογές δομής" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Σημειώσεις υποσέλιδου" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "αν ορίζεται, θα ξεχωρίσουν οι κατάλογοι πηγής και μεταγλώττισης" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[εικόνα: %s]" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[εικόνα]" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "αντικατάσταση για τελεία σε _templates κλπ." -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Ευρετήριο" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Βασικές επιλογές έργου" -#: writers/latex.py:743 writers/texinfo.py:646 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "ο ανακαλυφθέν τίτλος κόμβος δεν βρίσκεται σε τομέα, θέμα, πίνακα, προειδοποίηση ή πλαϊνή μπάρα" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "όνομα έργου" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "η λεζάντα δεν βρίσκεται εντός μίας εικόνας." +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "ονόματα συγγραφέων" -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "μη υλοποιημένος τύπος κόμβου: %r" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "έκδοση του έργου" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "άγνωστο toplevel_sectioning %r για την κλάσση %r" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "δημοσίευση του έργου" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "καμία γνωστή επιλογή Babel για τη γλώσσα %r" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "γλώσσα εγγράφου" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "πολύ μεγάλο :maxdepth:, θα αγνοηθεί." +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "επέκταση αρχείου πηγής" -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "κύριο όνομα εγγράφου" -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "ο τίτλος του εγγράφου δεν είναι μονός κόμβος κειμένου" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "χρηση epub" -#: writers/html5.py:572 writers/latex.py:1106 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Επιλογές επέκτασης" + +#: cmd/quickstart.py:671 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "enable %s extension" +msgstr "ενεργοποίηση της επέκτασης %s" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "ενεργοποίηση αυθαίρετων επεκτάσεων" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Δημιουργία Makefile και Batchfile" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "δημιουργία makefile" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "να μη δημιουργηθεί makefile" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "δημιουργία batchfile" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "να μη δημιουργηθεί batchfile" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "χρησιμοποιήστε το make-mode για το Makefile/make.bat" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Προτυποποίηση έργου" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "πρότυπος κατάλογος για πρότυπα αρχεία" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "ορίστε μία τιμή προτύπου" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "καθορίστηκε το \"quiet\", αλλά δεν καθορίστηκε είτε το \"project\" είτε το \"author\"." + +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Σφάλμα: το καθορισθέν μονοπάτι δεν είναι κατάλογος, ή τα αρχεία sphinx υπάρχουν ήδη." + +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "Το sphinx-quickstart δημιουργεί μόνο εντός ενός κενού καταλόγου. Παρακαλείσθε να καθορίσετε ένα νέο ριζικό μονοπάτι." + +#: cmd/quickstart.py:810 +#, python-format +msgid "Invalid template variable: %s" +msgstr "Ανέγκυρη μεταβλητή προτύπου: %s" + +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" +msgstr "" + +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" +msgstr "Το toctree περιλαμβάνει αναφορά στο αποκλεισμένο κείμενο %r" + +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "το toctree περιλαμβάνει αναφορά στο μη υπαρκτό έγγραφο %r" + +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "" + +#: directives/other.py:203 +msgid "Section author: " +msgstr "Συντάκτης τμήματος: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Συντάκτης μονάδας: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Συντάκτης κώδικα: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Συντάκτης: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:1183 +#: directives/patches.py:70 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "τόσο η επιλογή για tabularcolumns όσο και για :widths: δίνονται. Η επιλογή :widths: θα αγνοηθεί." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "" + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "" -#: writers/latex.py:1580 +#: directives/code.py:87 #, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "η μονάδα διάστασης %s δεν είναι έγκυρη. Θα αγνοηθεί." +msgid "Invalid caption: %s" +msgstr "Ανέγκυρη λεζάντα: %s" -#: writers/latex.py:1939 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown index entry type %s found" -msgstr "βρέθηκε άγνωστος τύπος εγγραφής ευρετηρίου %s" +msgid "line number spec is out of range(1-%d): %r" +msgstr "η προδιαγραφή αριθμού σειράς είναι εκτός e;yroyw (1-%d): %r" -#: domains/math.py:128 writers/latex.py:2495 +#: directives/code.py:216 #, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "Ανέγκυρο math_eqref_format: %r" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Δεν είναι δυνατή η ταυτόχρονη χρήση των επιλογών \"%s\" και \"%s\"" + +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" +msgstr "" + +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" + +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "Το αντικείμενο με όνομα %r δεν βρέθηκε στο συμπεριληφθέν αρχείο %r" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "Δεν είναι δυνατή η χρήση \"leneno-match\" με ένα κομματιασμένο σετ απο \"lines\"" + +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Προσδιορισμός γραμμής %r: δεν ελήφθησαν γραμμές από το συμπεριληφθέν αρχείο %r" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d %B %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Ευρετήριο" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "ο ανακαλυφθέν τίτλος κόμβος δεν βρίσκεται σε τομέα, θέμα, πίνακα, προειδοποίηση ή πλαϊνή μπάρα" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Σημειώσεις υποσέλιδου" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "η λεζάντα δεν βρίσκεται εντός μίας εικόνας." + +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "μη υλοποιημένος τύπος κόμβου: %r" + +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[εικόνα: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[εικόνα]" #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" @@ -1834,6 +2345,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1850,795 +2366,479 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "Δεν ήταν δυνατή η λήψη του μεγέθους της εικόνας. Η επιλογή :scale: θα αγνοηθεί." -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "άγνωστο toplevel_sectioning %r για την κλάσση %r" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "διπλότυπη ετικέτα της εξίσωσης %s, άλλη εμφάνιση στο %s" +msgid "no Babel option known for language %r" +msgstr "καμία γνωστή επιλογή Babel για τη γλώσσα %r" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (ενσωματωμένη συνάρτηση)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "πολύ μεγάλο :maxdepth:, θα αγνοηθεί." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (μέθοδος της %s)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (κλάση)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "ο τίτλος του εγγράφου δεν είναι μονός κόμβος κειμένου" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (καθολική μεταβλητή ή σταθερά)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "τόσο η επιλογή για tabularcolumns όσο και για :widths: δίνονται. Η επιλογή :widths: θα αγνοηθεί." -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (ιδιότητα της %s)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Παράμετροι" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "η μονάδα διάστασης %s δεν είναι έγκυρη. Θα αγνοηθεί." -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Προκαλεί" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "βρέθηκε άγνωστος τύπος εγγραφής ευρετηρίου %s" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Επιστρέφει" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Επιστρεφόμενος τύπος" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (μονάδα)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "συνάρτηση" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "μέθοδος" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "κλάση" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "δεδομένα" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "ιδιότητα" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "μονάδα" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Άλλαξε στην έκδοση %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Αποσύρθηκε στην έκδοση %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (οδηγία)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (ρόλος)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "οδηγία" - -#: domains/rst.py:235 -msgid "directive-option" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "ρόλος" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s" - -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "Η παραπομπή [%s] δεν αναφέρεται." - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Προσοχή" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Προσοχή" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Κίνδυνος" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Σφάλμα" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Συμβουλή" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Σημαντικό" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Σημείωση" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Δείτε επίσης" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Πρακτική συμβουλή" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Προειδοποίηση" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "αυτόματη εισαγωγή docstrings από τα δομοστοιχεία" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "αυτόματα κομμάτια δοκιμαστικού κώδικα σε τμήματα doctest" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "σύνδεσμος μεταξύ τεκμηρίωσης Sphinx διαφόρων έργων" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "γράψτε εγγραφές \"todo\" οι οποίες μπορούν αν εμφανίζονται ή να αποκρύπτονται κατά τη μεταγλώττιση" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "αναζήτηση για κάλυψη βιβλιογραφίας" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "να συμπεριληφθεί το math, απεικονισμένο ως εικόνες PNG η SVG" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "να συμπεριληφθεί το math, απεικονισμένο στο φυλλομετρηρή απο το MathJax" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "υποθετική εισαγωγή περιεχομένου βασισμένη στις τιμές παραμετροποίησης" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "να συμπεριληφθούν σύνδεσμοι στον πηγαίο κώδικα των τεκμηριωμένων αντικειμένων Python" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "δημιουργία αρχείου .nojekyll για έκδοση του εγγράφου στις σελίδες GitHub " - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Παρακαλείστε να εισάγετε ένα έγκυρο όνομα μονοπατιού." - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Παρακαλείστε να εισάγετε κάποιο κείμενο." - -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "Παρακαλείστε να εισάγετε ένα από τα %s." - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Παρακαλείστε να εισάγετε είτε 'y' είτε 'n'." - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Παρακαλείστε να εισάγετε μία επέκταση αρχείου, π.χ. '.rst' ή '.txt'." - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Καλώς ήρθατε στο εργαλείο γρήγορης εκκίνησης Sphinx %s." - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Ριζικό μονοπάτι για την τεκμηρίωση" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Σφάλμα: ένα υπάρχον conf.py έχει βρεθεί στοn επιλεγμένο ριζικό κατάλογο." - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα έργα Sphinx." - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Παρακαλείστε να εισάγετε ένα νέο ριζικό μονοπάτι (ή απλά πιέστε το Enter για έξοδο)" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Ξεχωριστοί κατάλογοι για πηγή και μεταγλώττιση (y/n)" - -#: cmd/quickstart.py:286 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Πρόθεμα ονόματος για πρότυπα και στατικούς καταλόγους" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "ασυνεπείς αναφορές υποσημείωσης στα μεταφρασμένα μηνύματα. original: {0}, translated: {1}" -#: cmd/quickstart.py:297 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Όνομα έργου" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Όνομα(τα) συγγραφέα" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "ασυνεπείς αναφορές στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}" -#: cmd/quickstart.py:308 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Έκδοση έργου" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Κυκλοφορία έργου" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "ασυνεπείς αναφορές παραπομπής στο μεταφρασμένο μήνυμα. αρχικό: {0}, μεταφρασμένο: {1}" -#: cmd/quickstart.py:323 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Γλώσσα έργου" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "ασυνεπείς αναφορές όρων στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Επέκταση αρχείου πηγής" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Όνομα του κυρίους σας εγγράφου (χωρίς επέκταση)" - -#: cmd/quickstart.py:367 +#: transforms/__init__.py:258 #, python-format msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Σφάλμα: το κύριο αρχείο %s έχει ήδη βρεθεί στο επιλεγμένο ριζικό κατάλογο." - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα αρχεία." - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Παρακαλείσθε να εισάγετε ένα νέο όνομα αρχείου, ή να μεταονομάσετε το υπάρχον αρχείο και να πιέσετε το Enter" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Υποδείξτε ποιά απο τις ακόλουθες επεκτάσεις Sphinx πρέπει να ενεργοποιηθούν:" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "βρέθηκε ευρετήριο βασιζόμενο σε 4 στήλες. Μπορεί να αποτελεί σφάλμα της επέκτασης που χρησιμοποιείτε: %r" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Σημείωση: τα imgmath και mathjax δεν είναι δυνατό να ενεργοποιηθούν ταυτόχρονα. Το imgmath έχει αποεπιλεγθεί. " +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "Δεν υπάρχει αναφορά για την υποσημείωση [%s]." -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Δημιουργία Makefile; (y/n)" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "Η υποσημείωση [#] δεν αναφέρεται." -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Δημιουργία αρχείου εντολών Windows; (y/n)" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: util/inventory.py:166 #, python-format -msgid "Creating file %s." -msgstr "Δημιουργία αρχείου %s." +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: util/i18n.py:100 #, python-format -msgid "File %s already exists, skipping." -msgstr "Το αρχείο %s υπάρχει ήδη, παραλείπεται." +msgid "reading error: %s, %s" +msgstr "σφάλμα ανάγνωσης: %s, %s" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Ολοκλήρωση: μία αρχική δομή καταλόγου δημιουργήθηκε." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "καταγραφή λάθους: %s, %s" -#: cmd/quickstart.py:519 +#: util/i18n.py:146 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:530 +#: util/i18n.py:253 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Ανέγκυρος τύπος ημερομηνίας. Τοποθετείστε στη στοιχειοσειρά μονά εισαγωγικά εάν θέλετε να το εξάγετε απευθείας: %s" -#: cmd/quickstart.py:537 +#: util/osutil.py:131 +#, python-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nΔημιουργία απαιτούμενων αρχείων για ένα έργο Sphinx.\n\nΤο sphinx-quickstart είναι ένα διαδραστικό εργαλείο το οποίο κάνει κάποιες ερωτήσεις για το δικό σας \nέργο και μετά δημιουργεί έναν πλήρη κατάλογο τεκμηρίωσης και δείγμα \nMakefile για να χρησιμοποιηθεί με το sphinx-build.\n" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" +#: util/display.py:82 +msgid "skipped" +msgstr "παράβλεψη" -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "ήσυχος τρόπος" +#: util/display.py:87 +msgid "failed" +msgstr "αποτυχία" -#: cmd/quickstart.py:601 -msgid "project root" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Επιλογές δομής" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "αν ορίζεται, θα ξεχωρίσουν οι κατάλογοι πηγής και μεταγλώττισης" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "αντικατάσταση για τελεία σε _templates κλπ." - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Βασικές επιλογές έργου" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "όνομα έργου" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "ονόματα συγγραφέων" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "έκδοση του έργου" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "δημοσίευση του έργου" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "γλώσσα εγγράφου" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "επέκταση αρχείου πηγής" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "κύριο όνομα εγγράφου" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "χρηση epub" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "άγνωστος τύπος κόμβου: %r" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Επιλογές επέκτασης" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" -#: cmd/quickstart.py:670 +#: util/fileutil.py:89 #, python-format -msgid "enable %s extension" -msgstr "ενεργοποίηση της επέκτασης %s" +msgid "Writing evaluated template result to %s" +msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "ενεργοποίηση αυθαίρετων επεκτάσεων" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Δημιουργία Makefile και Batchfile" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "ο προεπιλεγμένος ρόλος %s δεν βρέθηκε" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "δημιουργία makefile" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "να μη δημιουργηθεί makefile" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "το toctree περιλαμβάνει αναφορά σε άγνωστο αρχείο %r" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "δημιουργία batchfile" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "εξαίρεση κατά την αξιολόγηση μόνο της έκφρασης οδηγίας: %s" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "να μη δημιουργηθεί batchfile" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "συνεχίζεται από την προηγούμενη σελίδα" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "χρησιμοποιήστε το make-mode για το Makefile/make.bat" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "συνέχεια στην επόμενη σελίδα" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Προτυποποίηση έργου" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "μη-αλφαβιτικά" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "πρότυπος κατάλογος για πρότυπα αρχεία" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Σύμβολα" -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "ορίστε μία τιμή προτύπου" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Αριιθμοί" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "καθορίστηκε το \"quiet\", αλλά δεν καθορίστηκε είτε το \"project\" είτε το \"author\"." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "σελίδα" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Σφάλμα: το καθορισθέν μονοπάτι δεν είναι κατάλογος, ή τα αρχεία sphinx υπάρχουν ήδη." +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Δημοσίευση" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "Το sphinx-quickstart δημιουργεί μόνο εντός ενός κενού καταλόγου. Παρακαλείσθε να καθορίσετε ένα νέο ριζικό μονοπάτι." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s [%s]" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "Invalid template variable: %s" -msgstr "Ανέγκυρη μεταβλητή προτύπου: %s" +msgid "Could not fetch remote image: %s [%d]" +msgstr "Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s [%d]" -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "ο αριθμός εργασίας θα πρέπει να είναι θετικός αριθμός" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Άγνωστος τύπος αρχείου: %s..." -#: cmd/build.py:74 +#: transforms/post_transforms/__init__.py:88 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "μονοπάτι για τα αρχεία πηγής τεκμηρίωσης" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "μονοπάτι στον κατάλογο εξόδου" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "περισσότεροι από ένας στόχοι βρέθηκαν για 'οποιαδήποτε' παραπομπή %r: θα μπορούσε να είναι %s" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:114 -msgid "general options" -msgstr "γενικές επιλογές" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "εγγραφή όλων των αρχείων (προεπιλογή: εγγραφή μόνο νέων και αλλαγμένων αρχείων)" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "μην χρησιμοποιείτε ένα αποθηκευμένο περιβάλλον, πάντα να διαβάζετε όλα τα αρχεία" +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:157 +#: _cli/util/errors.py:207 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "παράκαμψη ρύθμισης στο αρχείο παραμετροποίησης" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "μεταφορά τιμής στα πρότυπα HTML" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "ορίστε ετικέτα: συμπεριλάβατε \"only\" τμήματα με TAG" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" -msgstr "επιλογές εξόδου κονσόλας" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Παρακαλείστε να το αναφέρετε αν ήταν ένα σφάλμα χρήσης, ώστε ένα καλύτερο μήνυμα σφάλματος να δοθεί την επόμενη φορά." -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "αυξήστε τον βερμπαλισμό (μπορεί να επαναληφθεί)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Κλείσιμο πλαϊνής μπάρας" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "καμία έξοδος στο stdout, μόνο προειδοποιήσεις στο stderr" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Πλοήγηση" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "κανένα αποτέλεσμα ούτε προειδοποιήσεις" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Αναζήτηση στο %(docstitle)s" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "να γίνεται εκπομπή χρωματιστής εξόδου (προεπιλογή: auto-detect)" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Σχετικά με αυτά τα κείμενα" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "να μην παρουσιάζεται έγχρωμο αποτέλεσμα (προεπιλογή: αυτόματη αναγνώριση)" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Αναζήτηση" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "προειδοποιήσεις εγγραφής (και σφάλματα) στο δοθέν αρχείο" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Τελευταία ενημέρωση στις %(last_updated)s." -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "μετατροπή προειδοποιήσεων σε σφάλματα" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "απεικόνιση πλήρους ιστορικού σε περίπτωση εξαίρεσης" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Προηγούμενο θέμα" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "εκτέλεση Pdb σε περίπτωση εξαίρεσης" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "προηγούμενο κεφάλαιο" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Επόμενο θέμα" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "δεν γίνεται συνδιασμός της επιλογής -a και των ονομάτων αρχείων" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "επόμενο κεφάλαιο" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "Index – %(key)s" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "Το όρισμα -D πρέπει να είναι της μορφής όνομα=τιμέ" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "Το όρισμα -Α πρέπει να είναι της μορφής όνομα=τιμή" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Πλήρες ευρετήριο σε μία σελίδα" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Κλείσιμο πλαϊνής μπάρας" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Αυτή η σελίδα" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Πίνακας περιεχομένων" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "Προβολή κώδικα" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Αναζήτηση" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Σύντομη αναζήτηση" #: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 #: themes/basic/searchfield.html:12 msgid "Go" msgstr "Πάμε" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "Προβολή κώδικα" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Περιεχόμενα" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Αναζήτηση %(docstitle)s" - #: themes/basic/defindex.html:4 msgid "Overview" msgstr "Επισκόπηση" @@ -2684,7 +2884,7 @@ msgstr "Καθολικό Ευρετήριο Μονάδων" msgid "quick access to all modules" msgstr "γρήγορη πρόσβαση σε όλες τις μονάδες" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Κεντρικό Ευρετήριοο" @@ -2692,23 +2892,15 @@ msgstr "Κεντρικό Ευρετήριοο" msgid "all functions, classes, terms" msgstr "όλες οι συναρτήσεις, κλάσεις, όροι" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Αυτή η σελίδα" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Πίνακας περιεχομένων" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Πλήρες ευρετήριο σε μία σελίδα" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Σύντομη αναζήτηση" +msgid "Search %(docstitle)s" +msgstr "Αναζήτηση %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2718,57 +2910,6 @@ msgstr "Σελίδες ευρετηρίου ανά γράμμα" msgid "can be huge" msgstr "μπορεί να είναι τεράστιο" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Προηγούμενο θέμα" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "προηγούμενο κεφάλαιο" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Επόμενο θέμα" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "επόμενο κεφάλαιο" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Πλοήγηση" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Αναζήτηση στο %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Σχετικά με αυτά τα κείμενα" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Τελευταία ενημέρωση στις %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2785,21 +2926,21 @@ msgstr "" msgid "search" msgstr "αναζήτηση" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Απόκρυψη Ευρεθέντων Αναζητήσεων" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Περιεχόμενα" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Αποτελέσματα Αναζήτησης" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Η αναζήτησή σας δεν ταυτοποιήθηκε με κανένα κείμενο. Παρακαλώ, επιβεβαιώστε ότι όλες οι λέξεις έχουν τη σωστή ορθογραφία και ότι έχετε επιλέξεις αρκετές κατηγορίες." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2807,22 +2948,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Εκτελείται η αναζήτηση" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Προετοιμασία αναζήτησης..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", στο " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Απόκρυψη Ευρεθέντων Αναζητήσεων" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2830,6 +2970,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Αλλαγές στην Έκδοση %(version)s —'\n%(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2851,120 +2996,127 @@ msgstr "Άλλες αλλαγές" msgid "Expand sidebar" msgstr "Άνοιγμα πλαϊνής μπάρας" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Παράμετροι" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Μεταβλητές" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Προκαλεί" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (στη μονάδα %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (στη μονάδα %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (ενσωματωμένη μεταβλητή)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (ενσωματωμένη κλάση)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (κλάση σε %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (μέθοδος κλάσης της %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (στατική μέθοδος της %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Ευρετήριο Μονάδων της Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "μονάδες" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Αποσύρθηκε" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "εξαίρεση" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "μέθοδος της κλάσης" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "στατική μέθοδος" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "περισσότεροι από έναν στόχοι βρέθηκα για την παραπομπή %r: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (αποσύρθηκε)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Παράμετροι" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Μεταβλητές" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Προκαλεί" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2975,92 +3127,85 @@ msgstr "Παράμετροι Προτύπου" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "ένωση" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "μέλος" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "τύπος" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "έννοια" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerator" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "μεταβλητή" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "μακροεντολή" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "μεταβλητή περιβάλλοντος; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3130,1088 +3275,1033 @@ msgstr "το numfig έχει απενεργοποιηθεί. Το :numref: θα msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: domains/std/__init__.py:1138 +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" +msgstr "ο σύνδεσμος δεν έχει λεζάντα: %s" + +#: domains/std/__init__.py:1153 +#, python-format +msgid "invalid numfig_format: %s (%r)" +msgstr "ανέγκυρο numfig_format: %s (%r)" + +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" +msgstr "ανέγκυρο numfig_format: %s" + +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" +msgstr "" + +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "" + +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" +msgstr "" + +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" +msgstr "" + +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" +msgstr "" + +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" +msgstr "" + +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Παράδειγμα" + +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Παραδείγματα" + +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Ορίσματα λέξης-κλειδί" + +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Σημειώσεις" + +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Άλλες παράμετροι" + +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" + +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Αναφορές" + +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Προειδοποιήσεις" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "Αποδόσεις" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "the link has no caption: %s" -msgstr "ο σύνδεσμος δεν έχει λεζάντα: %s" +msgid "A mocked object is detected: %r" +msgstr "" -#: domains/std/__init__.py:1153 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "ανέγκυρο numfig_format: %s (%r)" +msgid "alias of %s" +msgstr "" -#: domains/std/__init__.py:1157 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "invalid numfig_format: %s" -msgstr "ανέγκυρο numfig_format: %s" +msgid "Bases: %s" +msgstr "Βάσεις: %s" -#: domains/std/__init__.py:1453 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "undefined label: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: domains/std/__init__.py:1456 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: environment/adapters/toctree.py:324 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "αναγνωρίστηκαν κυκλικές αναφορές toctree, θα αγνοηθούν: %s <- %s" +msgid "invalid signature for auto%s (%r)" +msgstr "ανέγκυρη υπογραφή για αυτόματο %s (%r)" -#: environment/adapters/toctree.py:349 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "το toctree περιλαμβάνει αναφορά στο έγγραφο %r η οποία δεν έχει τίτλο: δεν θα δημιουργηθεί σύνδεσμος" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "δεν γνωρίζω ποιο δομοστοιχείο να εισάγω για αυτόματη τεκμηρίωση %r (προσπαθήστε να τοποθετήσετε μία οδηγία \"module\" ή \"currentmodule\" στο έγγραφο, ή να δώσετε ένα σαφές όνομα δομοστοιχείου)" -#: environment/adapters/toctree.py:364 +#: ext/autodoc/_names.py:89 #, python-format -msgid "toctree contains reference to non-included document %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: environment/adapters/toctree.py:367 +#: ext/autodoc/_names.py:93 #, python-format -msgid "toctree contains reference to non-existing document %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "δείτε %s" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "\"::\" στο όνομα automodule δεν βγάζει νόημα" -#: environment/adapters/indexentries.py:133 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "see also %s" -msgstr "δείτε επίσης %s" +msgid "Failed to remove %s: %s" +msgstr "" -#: environment/adapters/indexentries.py:141 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "unknown index entry type %r" -msgstr "άγνωστος τύπος εγγραφής ευρετηρίου %r" +msgid "Would create file %s." +msgstr "Θα δημιουργούσε το αρχείο %s." -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Σύμβολα" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nΑναζητήστε αναδρομικα σε για δομοστοιχεία Python και πακέτα και δημιουργήστε \nένα αρχείο reST με οδηγίες automodule για κάθε πακέτο στο .\n\nΤα μπορεί να αποτελούν αρχεία ή/και σχέδια καταλόγων τα οποία θα \nεκτελεστούν κατά τη δημιουργία.\n\nΣημείωση: από προεπιλογή αυτό το σενάριο δεν θα αντικαταστήσει τα ήδη δημιουργημένα αρχεία." -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "το αρχείο εικόνας δεν είναι αναγνώσιμο: %s" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "μονοπάτι για το δομοστοιχείο για το έγγραφο" -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "το αρχείο εικόνας %s δεν είναι αναγνώσιμο: %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "αρχεία fnmatch-style και/ή υποδείγματα καταλόγου που θα εξαιρεθούν από τη δημιουργία" -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "το μεταφορτωμένο αρχείο δεν είναι αναγνώσιμο: %s" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "κατάλογο για τοποθέτηση όλων των προϊόντων" -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "στο %s έχουν ήδη ανατεθεί αριθμοί τομέα (εμφωλιασμένο αριθμημένο toctree;)" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "μέγιστο βάθος από υποδομοστοιχεία για απεικόνιση στο TOC (προεπιλογή: 4)" -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "αντικατάσταση υπάρχοντων αρχείων" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "ακολουθία συμβολικών συνδέσμων. Ισχυρό όταν συνδυάζεται με το collective.recipe.omelette." -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "εκτελέστε το σενάριο χωρίς τη δημιουργία αρχείων" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "τοποθετήστε βιβλιογραφία για κάθε δομοστοιχείο στη δικής της σελίδα" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "να συμπεριληφθούν τα δομοστοιχεία \"_private\"" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "όνομα αρχείου του πίνακα περιεχομένων (προεπιλογή: δομοστοιχεία)" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "να μη δημιουργηθεί αρχείο με πίνακα περιεχομένων" -#: _cli/util/errors.py:240 +#: ext/apidoc/_cli.py:135 msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "μη δημιουργείτε κεφαλίδες για πακέτα δομοστοιχείων/πακέτων (π.χ. όταν τα docstrings τα περιλαμβάνουν ήδη)" -#: _cli/util/errors.py:246 +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "τοποθέτηση βιβλιογραφίας δομοστοιχείου πριν από την βιβλιογραφία υπόδομοστοιχείου" + +#: ext/apidoc/_cli.py:152 msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Παρακαλείστε να το αναφέρετε αν ήταν ένα σφάλμα χρήσης, ώστε ένα καλύτερο μήνυμα σφάλματος να δοθεί την επόμενη φορά." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "ερμηνεία μονοπατιών δομοστοιχείων σύμφωνα με την προδιαγραφή POP-0420 αυτονόητων namespaces" -#: transforms/post_transforms/__init__.py:88 +#: ext/apidoc/_cli.py:160 msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "περισσότεροι από ένας στόχοι βρέθηκαν για 'οποιαδήποτε' παραπομπή %r: θα μπορούσε να είναι %s" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "επέκταση αρχείου (προεπιλογή: rst)" -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "δημιουργία ενός πλήρους έργου με το sphinx-quickstart" -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s [%s]" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "η προσθήκη του module_path στο sys.path, χρησιμοποιείται όταν δίδεται το --full" -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s [%d]" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "όνομα έργου (προεπιλογή: όνομα ριζικού δομοστοιχείου)" -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." -msgstr "Άγνωστος τύπος αρχείου: %s..." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "συγγραφέας(εις) έργου, χρησιμοποιείται όταν δίδεται το --full" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "Οι σελίδες HTML βρίσκονται σε %(outdir)s." +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "έκδοση έργου, χρησιμοποιείται όταν δίνεται το --full" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" -msgstr "Αδυναμία ανάγνωσης αρχείου πληροφοριών μεταγλώττισης: %r" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "έκδοση έργου, χρησιμοποιείται όταν δίδεται το --full, προεπιλογή σε --doc-version" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "επιλογές επέκτασης" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/html/__init__.py:383 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "ευρετήριο" - -#: builders/html/__init__.py:560 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "Logo of %s" -msgstr "" - -#: builders/html/__init__.py:589 -msgid "next" -msgstr "επόμενο" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "προηγούμενο" +msgid "%s is not a directory." +msgstr "το %s δεν είναι κατάλογος." -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/__init__.py:794 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "αντιγραφή αρχείων μεταφόρτωσης..." - -#: builders/html/__init__.py:818 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "δεν είναι δυνατή η αντιγραφή του μεταφορτωμένου αρχείου %r: %s" +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "" -#: builders/html/__init__.py:864 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:934 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "cannot copy static file %r" -msgstr "δεν είναι δυνατή η αντιγραφή στατικού αρχείου %r" - -#: builders/html/__init__.py:939 -msgid "copying extra files" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/__init__.py:949 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "cannot copy extra file %r" -msgstr "δεν είναι δυνατή η αντιγραφή του επιπλέον αρχείου %r" +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "" -#: builders/html/__init__.py:955 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "Failed to write build info file: %r" -msgstr "Αδυναμία εγγραφής του αρχείου πληροφοριών μεταγλώττισης: %r" - -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "ο κατάλογος εύρεσης δεν ήταν δυνατό να φορτωθεί, αλλά δε θα μεταγλωττιστούν όλα τα έγγραφα: ο κατάλογος δε θα είναι πλήρης." +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "η σελιδα %s ταιριάζει δύο σχέδια στo html_sidebars: %r and %r" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "ένα σφάλμα Unicode παρουσιάστηκε κατά τη δημιουργία της σελίδας %s. Παρακαλείστε να επιβεβαιώσετε ότι όλες οι τιμές παραμετροποίησης οι οποίες περιλαμβάνουν μη-ASCII περιεχόμενο είναι στοιχειοσειρές Unicode." +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "" -#: builders/html/__init__.py:1224 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "Ένα σφάλμα συνέβη κατά τη σύνθεση της σελίδας %s.\n\nΑιτία %r " - -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: builders/html/__init__.py:1265 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "dumping search index in %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: builders/html/__init__.py:1308 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid js_file: %r, ignored" -msgstr "ανέγκυρο js_file: %r, θα αγνοηθεί" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "Πολλά math_renderers έχουν καταγραφεί. Αλλά δεν έχει επιλεγεί κανένα math_renderer." +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] δημιουργία autosummary για: %s" -#: builders/html/__init__.py:1346 +#: ext/autosummary/generate.py:634 #, python-format -msgid "Unknown math_renderer %r is given." -msgstr "Δόθηκε άγνωστο math_renderer %r." +msgid "[autosummary] writing to %s" +msgstr "[αυτόματη περίληψη] εγγραφή στο %s" -#: builders/html/__init__.py:1360 +#: ext/autosummary/generate.py:679 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "Η εγγραφή html_extra_path %r δεν υπάρχει" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nΔημιουργία ReStrucuredText χρησιμοποιώντας τις οδηγίες autosummary.\n\nΤο sphinx-autogen αποτελεί ένα πρόσθιο εργαλείο για το sphinx.ext.autosummary.generate. Δημιουργεί \nτα αρχεία reStructuredText από τις οδηγίες autosummary οι οποίες περιλαμβάνονται στα \nπαραδοθέντα αρχεία εισόδου.\n\nΗ μορφή της οδηγίας autosummary τεκμηρειώνεται στο \nδομοστοιχείο ``sphinx.ext.autosummary`` της Python και μπορεί να αναγνωστεί χρησιμοποιώντας το :: \n\npydoc sphinx.ext.autosummary\n" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "αρχεία πηγής για να δημιουργηθούν τα αρχεία reST" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" -msgstr "η εγγραφή html_static_path %r δεν υπάρχει" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "ο κατάλογος που θα τοποθετεί όλο το αποτέλεσμα εξόδου" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autosummary/generate.py:915 #, python-format -msgid "logo file %r does not exist" -msgstr "το αρχείο logo %r δεν υπάρχει" +msgid "default suffix for files (default: %(default)s)" +msgstr "προεπιλεγμένη επέκταση για αρχεία (προεπιλογή: %(default)s)" -#: builders/html/__init__.py:1407 +#: ext/autosummary/generate.py:923 #, python-format -msgid "favicon file %r does not exist" -msgstr "το αρχείο favicon %r δεν υπάρχει" +msgid "custom template directory (default: %(default)s)" +msgstr "προσαρμοσμένος κατάλογος προτύπου (προεπιλογή: %(default)s)" -#: builders/html/__init__.py:1420 +#: ext/autosummary/generate.py:931 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." -msgstr "" +msgid "document imported members (default: %(default)s)" +msgstr "μέλη εισαγμένα στο έγγραφο (προεπιλογή: %(default)s)" -#: builders/html/__init__.py:1433 +#: ext/autosummary/generate.py:940 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autosummary/__init__.py:235 #, python-format -msgid "%s %s documentation" -msgstr "Τεκμηρίωση του %s - %s" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autosummary/__init__.py:239 +#, python-format +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: builders/latex/__init__.py:118 +#: ext/autosummary/__init__.py:329 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Τα αρχεία LaTeX βρίσκονται σε %(outdir)s." - -#: builders/latex/__init__.py:121 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nΕκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του (pdf)latex\n(χρησιμοποιήστε το 'make latexpdf' εδώ για να το κάνετε αυτόματα)." - -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "δεν βρέθηκε τιμή παραμετροποίησης \"latex_documents\": δεν θα πραγματοποιηθεί εγγραφή για κανένα κείμενο" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" -#: builders/latex/__init__.py:170 +#: ext/autosummary/__init__.py:358 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "η τιμή παραμετροποίησης \"latex_documents\" κάνει αναφορά το άγνωστο κείμενο %s" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Δημοσίευση" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "αντιγραφή αρχείων υποστήριξης TeX" - -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "αντιγραφή επιπρόσθετων αρχείων" +msgid "failed to import object %s" +msgstr "αδυναμία εισαγωγής αντικειμένου %s" -#: builders/latex/__init__.py:536 +#: ext/autosummary/__init__.py:652 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: builders/latex/__init__.py:544 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "autosummary_generate: file not found: %s" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: builders/latex/transforms.py:121 +#: ext/intersphinx/_load.py:61 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: builders/latex/transforms.py:487 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: builders/latex/theming.py:88 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: builders/latex/theming.py:91 +#: ext/intersphinx/_load.py:94 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "συνεχίζεται από την προηγούμενη σελίδα" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "συνέχεια στην επόμενη σελίδα" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "μη-αλφαβιτικά" - -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Αριιθμοί" - -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "σελίδα" - -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Ορίσματα λέξης-κλειδί" - -#: ext/napoleon/docstring.py:176 +#: ext/intersphinx/_load.py:103 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "" - -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Παράδειγμα" - -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Παραδείγματα" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Σημειώσεις" - -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Άλλες παράμετροι" - -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Αναφορές" - -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Προειδοποιήσεις" - -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "Αποδόσεις" - -#: ext/autosummary/__init__.py:284 -#, python-format -msgid "autosummary references excluded document %r. Ignored." +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." -msgstr "" +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "παρουσιάστηκαν κάποια ζητήματα με μερικά απο τα αποθέματα, αλλά υπήρξαν λειτουργικές εναλλακτικές:" -#: ext/autosummary/__init__.py:384 +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" +"failed to reach any of the inventories with the following issues:\n" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "failed to parse name %s" -msgstr "αδυναμία ανάλυσης ονόματος %s" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "το απόθεμα intersphinx έχει μεταφερθεί: %s->%s" -#: ext/autosummary/__init__.py:412 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "failed to import object %s" -msgstr "αδυναμία εισαγωγής αντικειμένου %s" +msgid "(in %s %s)" +msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." -msgstr "" +msgid "(in %s)" +msgstr "(στο %s)" -#: ext/autosummary/__init__.py:927 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_resolve.py:387 #, python-format -msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_resolve.py:396 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[autosummary] δημιουργία autosummary για: %s" +msgid "invalid external cross-reference suffix: %r" +msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_resolve.py:407 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[αυτόματη περίληψη] εγγραφή στο %s" +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_resolve.py:561 #, python-format -msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/autosummary/generate.py:836 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nΔημιουργία ReStrucuredText χρησιμοποιώντας τις οδηγίες autosummary.\n\nΤο sphinx-autogen αποτελεί ένα πρόσθιο εργαλείο για το sphinx.ext.autosummary.generate. Δημιουργεί \nτα αρχεία reStructuredText από τις οδηγίες autosummary οι οποίες περιλαμβάνονται στα \nπαραδοθέντα αρχεία εισόδου.\n\nΗ μορφή της οδηγίας autosummary τεκμηρειώνεται στο \nδομοστοιχείο ``sphinx.ext.autosummary`` της Python και μπορεί να αναγνωστεί χρησιμοποιώντας το :: \n\npydoc sphinx.ext.autosummary\n" - -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "αρχεία πηγής για να δημιουργηθούν τα αρχεία reST" - -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "ο κατάλογος που θα τοποθετεί όλο το αποτέλεσμα εξόδου" - -#: ext/autosummary/generate.py:874 +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "προεπιλεγμένη επέκταση για αρχεία (προεπιλογή: %(default)s)" +msgid "error while formatting signature for %s: %s" +msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autodoc/_dynamic/_loader.py:193 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "προσαρμοσμένος κατάλογος προτύπου (προεπιλογή: %(default)s)" +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "μέλη εισαγμένα στο έγγραφο (προεπιλογή: %(default)s)" +msgid "Failed to get a function signature for %s: %s" +msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "Failed to remove %s: %s" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nΑναζητήστε αναδρομικα σε για δομοστοιχεία Python και πακέτα και δημιουργήστε \nένα αρχείο reST με οδηγίες automodule για κάθε πακέτο στο .\n\nΤα μπορεί να αποτελούν αρχεία ή/και σχέδια καταλόγων τα οποία θα \nεκτελεστούν κατά τη δημιουργία.\n\nΣημείωση: από προεπιλογή αυτό το σενάριο δεν θα αντικαταστήσει τα ήδη δημιουργημένα αρχεία." - -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "μονοπάτι για το δομοστοιχείο για το έγγραφο" - -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "αρχεία fnmatch-style και/ή υποδείγματα καταλόγου που θα εξαιρεθούν από τη δημιουργία" - -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "κατάλογο για τοποθέτηση όλων των προϊόντων" - -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "μέγιστο βάθος από υποδομοστοιχεία για απεικόνιση στο TOC (προεπιλογή: 4)" - -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "αντικατάσταση υπάρχοντων αρχείων" - -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "ακολουθία συμβολικών συνδέσμων. Ισχυρό όταν συνδυάζεται με το collective.recipe.omelette." - -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "εκτελέστε το σενάριο χωρίς τη δημιουργία αρχείων" - -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "τοποθετήστε βιβλιογραφία για κάθε δομοστοιχείο στη δικής της σελίδα" - -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "να συμπεριληφθούν τα δομοστοιχεία \"_private\"" - -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "όνομα αρχείου του πίνακα περιεχομένων (προεπιλογή: δομοστοιχεία)" - -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "να μη δημιουργηθεί αρχείο με πίνακα περιεχομένων" - -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "μη δημιουργείτε κεφαλίδες για πακέτα δομοστοιχείων/πακέτων (π.χ. όταν τα docstrings τα περιλαμβάνουν ήδη)" - -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "τοποθέτηση βιβλιογραφίας δομοστοιχείου πριν από την βιβλιογραφία υπόδομοστοιχείου" - -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "ερμηνεία μονοπατιών δομοστοιχείων σύμφωνα με την προδιαγραφή POP-0420 αυτονόητων namespaces" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "σφάλμα κατά τη μορφοποίηση των ορισμάτων για %s:%s" -#: ext/apidoc/_cli.py:160 -msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "επέκταση αρχείου (προεπιλογή: rst)" - -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "δημιουργία ενός πλήρους έργου με το sphinx-quickstart" - -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "η προσθήκη του module_path στο sys.path, χρησιμοποιείται όταν δίδεται το --full" - -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "όνομα έργου (προεπιλογή: όνομα ριζικού δομοστοιχείου)" - -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "συγγραφέας(εις) έργου, χρησιμοποιείται όταν δίδεται το --full" - -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "έκδοση έργου, χρησιμοποιείται όταν δίνεται το --full" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "έκδοση έργου, χρησιμοποιείται όταν δίδεται το --full, προεπιλογή σε --doc-version" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "επιλογές επέκτασης" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "%s is not a directory." -msgstr "το %s δεν είναι κατάλογος." +msgid "signature arguments or return annotation given for automodule %s" +msgstr "ορίσματα υπογραφής ή επιστροφή σημείωσης η οποία δόθηκε για το automodule %s" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" -msgstr "" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ πρέπει να είναι λίστα στοιχειοσειράς, όχι %r (στο δομοστοιχείο %s) -- θα αγνοηθεί το __all__" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" -msgstr "" +msgid "missing attribute %s in object %s" +msgstr "απουσιάζει το χαρακτηριστικό %s στο αντικείμενο %s" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_extension.py:140 -#, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_extension.py:147 +#: builders/html/__init__.py:114 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "Οι σελίδες HTML βρίσκονται σε %(outdir)s." -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:337 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "Failed to read build info file: %r" +msgstr "Αδυναμία ανάγνωσης αρχείου πληροφοριών μεταγλώττισης: %r" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:178 -#, python-format -msgid "apidoc_modules item %i '%s' must be an int" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:210 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "ευρετήριο" + +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:247 -#, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "επόμενο" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "προηγούμενο" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:783 #, python-format -msgid "Would create file %s." -msgstr "Θα δημιουργούσε το αρχείο %s." +msgid "cannot copy image file '%s': %s" +msgstr "" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s v%s)" -msgstr "(στη %s έκδοση %s)" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "αντιγραφή αρχείων μεταφόρτωσης..." -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:807 #, python-format -msgid "(in %s)" -msgstr "(στο %s)" +msgid "cannot copy downloadable file %r: %s" +msgstr "δεν είναι δυνατή η αντιγραφή του μεταφορτωμένου αρχείου %r: %s" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:871 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:383 -#, python-format -msgid "inventory for external cross-reference not found: %r" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:923 #, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "" +msgid "cannot copy static file %r" +msgstr "δεν είναι δυνατή η αντιγραφή στατικού αρχείου %r" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:938 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "" +msgid "cannot copy extra file %r" +msgstr "δεν είναι δυνατή η αντιγραφή του επιπλέον αρχείου %r" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:944 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "Failed to write build info file: %r" +msgstr "Αδυναμία εγγραφής του αρχείου πληροφοριών μεταγλώττισης: %r" -#: ext/intersphinx/_load.py:71 -#, python-format +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "ο κατάλογος εύρεσης δεν ήταν δυνατό να φορτωθεί, αλλά δε θα μεταγλωττιστούν όλα τα έγγραφα: ο κατάλογος δε θα είναι πλήρης." -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "η σελιδα %s ταιριάζει δύο σχέδια στo html_sidebars: %r and %r" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "ένα σφάλμα Unicode παρουσιάστηκε κατά τη δημιουργία της σελίδας %s. Παρακαλείστε να επιβεβαιώσετε ότι όλες οι τιμές παραμετροποίησης οι οποίες περιλαμβάνουν μη-ASCII περιεχόμενο είναι στοιχειοσειρές Unicode." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "Ένα σφάλμα συνέβη κατά τη σύνθεση της σελίδας %s.\n\nΑιτία %r " -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "" - -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "παρουσιάστηκαν κάποια ζητήματα με μερικά απο τα αποθέματα, αλλά υπήρξαν λειτουργικές εναλλακτικές:" +msgid "invalid js_file: %r, ignored" +msgstr "ανέγκυρο js_file: %r, θα αγνοηθεί" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "αδυναμία προσέγγισης οποιασδήποτε αποθήκης με τα ακόλουθα ζητήματα:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Πολλά math_renderers έχουν καταγραφεί. Αλλά δεν έχει επιλεγεί κανένα math_renderer." -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1351 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "το απόθεμα intersphinx έχει μεταφερθεί: %s->%s" +msgid "Unknown math_renderer %r is given." +msgstr "Δόθηκε άγνωστο math_renderer %r." -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1365 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1370 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_extra_path entry %r does not exist" +msgstr "Η εγγραφή html_extra_path %r δεν υπάρχει" + +#: builders/html/__init__.py:1385 +#, python-format +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "ανέγκυρη υπογραφή για αυτόματο %s (%r)" +msgid "html_static_path entry %r does not exist" +msgstr "η εγγραφή html_static_path %r δεν υπάρχει" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "σφάλμα κατά τη μορφοποίηση των ορισμάτων για %s:%s" +msgid "logo file %r does not exist" +msgstr "το αρχείο logo %r δεν υπάρχει" + +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "το αρχείο favicon %r δεν υπάρχει" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "δεν γνωρίζω ποιο δομοστοιχείο να εισάγω για αυτόματη τεκμηρίωση %r (προσπαθήστε να τοποθετήσετε μία οδηγία \"module\" ή \"currentmodule\" στο έγγραφο, ή να δώσετε ένα σαφές όνομα δομοστοιχείου)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "Τεκμηρίωση του %s - %s" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "\"::\" στο όνομα automodule δεν βγάζει νόημα" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "ορίσματα υπογραφής ή επιστροφή σημείωσης η οποία δόθηκε για το automodule %s" +msgid "Failed to get a docname for source %r!" +msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ πρέπει να είναι λίστα στοιχειοσειράς, όχι %r (στο δομοστοιχείο %s) -- θα αγνοηθεί το __all__" +msgid "No footnote was found for given reference node %r" +msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Τα αρχεία LaTeX βρίσκονται σε %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nΕκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του (pdf)latex\n(χρησιμοποιήστε το 'make latexpdf' εδώ για να το κάνετε αυτόματα)." + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "δεν βρέθηκε τιμή παραμετροποίησης \"latex_documents\": δεν θα πραγματοποιηθεί εγγραφή για κανένα κείμενο" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "η τιμή παραμετροποίησης \"latex_documents\" κάνει αναφορά το άγνωστο κείμενο %s" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "αντιγραφή αρχείων υποστήριξης TeX" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "αντιγραφή επιπρόσθετων αρχείων" + +#: builders/latex/__init__.py:529 +#, python-format +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:537 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Bases: %s" -msgstr "Βάσεις: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "στο %s έχουν ήδη ανατεθεί αριθμοί τομέα (εμφωλιασμένο αριθμημένο toctree;)" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" -msgstr "απουσιάζει το χαρακτηριστικό %s στο αντικείμενο %s" +msgid "image file not readable: %s" +msgstr "το αρχείο εικόνας δεν είναι αναγνώσιμο: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" -msgstr "" +msgid "image file %s not readable: %s" +msgstr "το αρχείο εικόνας %s δεν είναι αναγνώσιμο: %s" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "" +msgid "download file not readable: %s" +msgstr "το μεταφορτωμένο αρχείο δεν είναι αναγνώσιμο: %s" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "αναγνωρίστηκαν κυκλικές αναφορές toctree, θα αγνοηθούν: %s <- %s" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "το toctree περιλαμβάνει αναφορά στο έγγραφο %r η οποία δεν έχει τίτλο: δεν θα δημιουργηθεί σύνδεσμος" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "" +msgid "see %s" +msgstr "δείτε %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "δείτε επίσης %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "άγνωστος τύπος εγγραφής ευρετηρίου %r" diff --git a/sphinx/locale/en_DE/LC_MESSAGES/sphinx.mo b/sphinx/locale/en_DE/LC_MESSAGES/sphinx.mo index fcd63520b4a..d48f69d7c9f 100644 Binary files a/sphinx/locale/en_DE/LC_MESSAGES/sphinx.mo and b/sphinx/locale/en_DE/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/en_DE/LC_MESSAGES/sphinx.po b/sphinx/locale/en_DE/LC_MESSAGES/sphinx.po index f5ee08a31ca..b7bec330794 100644 --- a/sphinx/locale/en_DE/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/en_DE/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: English (Germany) (http://app.transifex.com/sphinx-doc/sphinx-1/language/en_DE/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: en_DE\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2804,21 +2945,20 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2827,6 +2967,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2848,119 +2993,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2972,92 +3124,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3085,581 +3230,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3667,548 +3720,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo b/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo index 499783922a4..cdf93390a8b 100644 Binary files a/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo and b/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po b/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po index 4b3157ca9e8..a1a2a701482 100644 --- a/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: English (France) (http://app.transifex.com/sphinx-doc/sphinx-1/language/en_FR/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: en_FR\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2804,21 +2945,20 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2827,6 +2967,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2848,119 +2993,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2972,92 +3124,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3085,581 +3230,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3667,548 +3720,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo index a75df5fcd53..28c63c2608a 100644 Binary files a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo and b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po index 2e1e3dfbe96..d8228ab9d3d 100644 --- a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Adam Turner, 2022-2023\n" "Language-Team: English (United Kingdom) (http://app.transifex.com/sphinx-doc/sphinx-1/language/en_GB/)\n" @@ -19,6 +19,127 @@ msgstr "" "Language: en_GB\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "invalid PEP number %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "invalid RFC number %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "setting %s.%s occurs in none of the searched theme configs" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "unsupported theme option %r given" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "file %r on theme path is not a valid zipfile or contains no theme" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -33,127 +154,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Pygments lexer name %r is not known" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Event %r already present" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Unknown event name: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "Handler %r for event %r threw an exception" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Cannot find source directory (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Output directory (%s) is not a directory" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Source directory and destination directory cannot be identical" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Running Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "This project needs at least Sphinx v%s and therefore cannot be built with this version." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "making output directory" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "while setting up extension %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "loading translations [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "done" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "not available for built-in messages" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "loading pickled environment" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "failed: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "No builder selected, using default: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "node class %r is already registered, its visitors will be overridden" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +309,12 @@ msgid "" "explicit" msgstr "the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "the %s extension is not safe for parallel reading" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +322,214 @@ msgid "" "explicit" msgstr "the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "the %s extension is not safe for parallel writing" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "doing serial %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Builder class %s has no \"name\" attribute" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Builder %r already exists (in module %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Builder name %s not registered or available through entry point" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Builder name %s not registered" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "domain %s already registered" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "domain %s not yet registered" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "The %r directive is already registered to domain %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "The %r role is already registered to domain %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "The %r index is already registered to domain %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "The %r object_type is already registered" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "The %r crossref_type is already registered" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r is already registered" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser for %r is already registered" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Source parser for %s not registered" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "Translator for %r already exists" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r already registered" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "maths renderer %s is already registered" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "Invalid configuration value found: 'language = None'. Update your configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "the extension %r was already merged with Sphinx since version %s; this extension is ignored." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Original exception:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Could not import extension %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "extension %r has no setup() function; is it really a Sphinx extension module?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "config directory doesn't contain a conf.py file (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "cannot override dictionary config setting %r, ignoring (use %r to set individual elements)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "invalid number %r for config value %r, ignoring" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "cannot override config setting %r with unsupported type, ignoring" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "unknown config value %r in override, ignoring" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Config value %r already present" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "Invalid configuration value found: 'language = None'. Update your configuration to a valid language code. Falling back to 'en' (English)." + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "There is a syntax error in your configuration file: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "The configuration file (or one of the modules it imports) called sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,2385 +537,2305 @@ msgid "" "%s" msgstr "There is a programmable error in your configuration file:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Section %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Fig. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Table %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Listing %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "The config value `{name}` has to be a one of {candidates}, but `{current}` is given." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "The config value `{name}' has type `{current.__name__}'; expected {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r not found, ignored." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Pygments lexer name %r is not known" - -#: highlighting.py:209 -#, python-format +#: config.py:892 msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "new config" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "config changed" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "unsupported theme option %r given" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "extensions changed" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "build environment version not current" -#: theming.py:228 -#, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "source directory has changed" -#: theming.py:268 +#: environment/__init__.py:350 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:355 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:282 +#: environment/__init__.py:361 #, python-format -msgid "The %r theme has too many ancestors" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:310 -#, python-format -msgid "no theme configuration file found in %r" -msgstr "" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "This environment is incompatible with the selected builder, please choose another doctree directory." -#: theming.py:335 theming.py:388 +#: environment/__init__.py:518 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +msgid "Failed to scan documents in %s: %r" +msgstr "Failed to scan documents in %s: %r" -#: theming.py:339 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +msgid "Domain %r is not registered" +msgstr "Domain %r is not registered" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "document isn't included in any toctree" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "self referenced toctree found. Ignored." -#: theming.py:366 +#: environment/__init__.py:952 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Event %r already present" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Attention" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Unknown event name: %s" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Caution" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "Handler %r for event %r threw an exception" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Danger" -#: project.py:72 +#: locale/__init__.py:232 +msgid "Error" +msgstr "Error" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Hint" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Important" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Note" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "See also" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tip" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Warning" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "The Texinfo files are in %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nRun 'make' in that directory to run these through makeinfo\n(use 'make info' here to do that automatically)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "no \"texinfo_documents\" config value found; no documents will be written" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "\"texinfo_documents\" config value references unknown document %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Builder %r already exists (in module %s)" +msgid "processing %s" +msgstr "processing %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "writing" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "resolving references..." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "domain %s already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (in " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "copying images... " -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" +msgstr "cannot copy image file %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "copying Texinfo support files" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" +msgstr "error writing file Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." +msgstr "The manual pages are in %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "no \"man_pages\" config value found; no manual pages will be written" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "\"man_pages\" config value references unknown document %s" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." +msgstr "The HTML page is in %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "assembling single document" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "writing additional files" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "The dummy builder generates no files." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." +msgstr "The message catalogues are in %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "maths renderer %s is already registered" +msgid "building [%s]: " +msgstr "building [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "the extension %r was already merged with Sphinx since version %s; this extension is ignored." +msgid "targets for %d template files" +msgstr "targets for %d template files" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "reading templates... " -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "writing message catalogues... " -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "extension %r has no setup() function; is it really a Sphinx extension module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Look for any errors in the above output or in %(outdir)s/output.txt" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version." +msgid "broken link: %s (%s)" +msgstr "broken link: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary" +msgid "Anchor '%s' not found" +msgstr "Anchor '%s' not found" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" -msgstr "" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -#: roles.py:251 +#: builders/epub3.py:83 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +msgid "The ePub file is in %(outdir)s." +msgstr "The ePub file is in %(outdir)s." -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" -msgstr "" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "writing nav.xhtml file..." -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" -msgstr "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "conf value \"epub_uid\" should be XML NAME for EPUB3" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" -msgstr "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[source]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "conf value \"epub_author\" should not be empty for EPUB3" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "highlighting module code... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "conf value \"epub_contributor\" should not be empty for EPUB3" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[docs]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "conf value \"epub_description\" should not be empty for EPUB3" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Module code" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "conf value \"epub_publisher\" should not be empty for EPUB3" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Source code for %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Overview: module code" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "conf value \"epub_identifier\" should not be empty for EPUB3" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        All modules for which code is available

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "conf value \"version\" should not be empty for EPUB3" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "invalid css_file: %r, ignored" +msgstr "invalid css_file: %r, ignored" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "section \"%s\" gets labeled as \"%s\"" +msgid "The XML files are in %(outdir)s." +msgstr "The XML files are in %(outdir)s." -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "duplicate label %s, other instance in %s" - -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "" +msgid "error writing file %s: %s" +msgstr "error writing file %s: %s" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "====================== slowest reading durations =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "The pseudo-XML files are in %(outdir)s." -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "missing '+' or '-' in '%s' option." +msgid "duplicated ToC entry found: %s" +msgstr "duplicated ToC entry found: %s" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' is not a valid option." +msgid "cannot read image file %r: copying it instead" +msgstr "cannot read image file %r: copying it instead" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' is not a valid pyversion option" +msgid "cannot write image file %r: %s" +msgstr "cannot write image file %r: %s" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "invalid TestCode type" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow not found - copying image files" -#: ext/doctest.py:297 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt." +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "writing mimetype file..." -#: ext/doctest.py:457 -#, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "no code/output in %s block at %s:%s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "writing META-INF/container.xml file..." -#: ext/doctest.py:568 -#, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "ignoring invalid doctest code: %r" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "writing content.opf file..." -#: ext/imgmath.py:162 +#: builders/_epub_base.py:594 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "LaTeX command %r cannot be run (needed for maths display), check the imgmath_latex setting" +msgid "unknown mimetype for %s, ignoring" +msgstr "unknown mimetype for %s, ignoring" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%s command %r cannot be run (needed for maths display), check the imgmath_%s setting" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" -msgstr "display latex %r: %s" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "writing toc.ncx file..." -#: ext/imgmath.py:380 +#: builders/_epub_base.py:802 #, python-format -msgid "inline latex %r: %s" -msgstr "inline latex %r: %s" +msgid "writing %s file..." +msgstr "writing %s file..." -#: ext/coverage.py:48 +#: builders/text.py:27 #, python-format -msgid "invalid regex %r in %s" -msgstr "invalid regex %r in %s" +msgid "The text files are in %(outdir)s." +msgstr "The text files are in %(outdir)s." -#: ext/coverage.py:140 ext/coverage.py:301 +#: builders/__init__.py:229 #, python-format -msgid "module %s could not be imported: %s" -msgstr "module %s could not be imported: %s" +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "a suitable image for %s builder not found: %s (%s)" -#: ext/coverage.py:148 +#: builders/__init__.py:237 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "" +msgid "a suitable image for %s builder not found: %s" +msgstr "a suitable image for %s builder not found: %s" -#: ext/coverage.py:158 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" -msgstr "" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "building [mo]: " -#: ext/coverage.py:172 -#, python-brace-format, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." -msgstr "" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "writing output... " -#: ext/coverage.py:187 +#: builders/__init__.py:280 #, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "invalid regex %r in coverage_c_regexes" +msgid "all of %d po files" +msgstr "all of %d po files" -#: ext/coverage.py:260 +#: builders/__init__.py:302 #, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "undocumented c api: %s [%s] in file %s" +msgid "targets for %d po files that are specified" +msgstr "targets for %d po files that are specified" -#: ext/coverage.py:452 +#: builders/__init__.py:314 #, python-format -msgid "undocumented python function: %s :: %s" -msgstr "undocumented python function: %s :: %s" +msgid "targets for %d po files that are out of date" +msgstr "targets for %d po files that are out of date" -#: ext/coverage.py:473 -#, python-format -msgid "undocumented python class: %s :: %s" -msgstr "undocumented python class: %s :: %s" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "all source files" -#: ext/coverage.py:492 +#: builders/__init__.py:335 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "undocumented python method: %s :: %s :: %s" +msgid "file %r given on command line does not exist, " +msgstr "file %r given on command line does not exist, " -#: ext/imgconverter.py:44 +#: builders/__init__.py:342 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n\nTraceback: %s" +"file %r given on command line is not under the source directory, ignoring" +msgstr "file %r given on command line is not under the source directory, ignoring" -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: builders/__init__.py:353 #, python-format -msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "convert exited with error:\n[stderr]\n%r\n[stdout]\n%r" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "file %r given on command line is not a valid document, ignoring" -#: ext/imgconverter.py:83 +#: builders/__init__.py:366 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "convert command %r cannot be run, check the image_converter setting" - -#: ext/graphviz.py:138 -msgid "Graphviz directive cannot have both content and a filename argument" -msgstr "Graphviz directive cannot have both content and a filename argument" +msgid "%d source files given on command line" +msgstr "%d source files given on command line" -#: ext/graphviz.py:153 +#: builders/__init__.py:382 #, python-format -msgid "External Graphviz file %r not found or reading it failed" -msgstr "External Graphviz file %r not found or reading it failed" +msgid "targets for %d source files that are out of date" +msgstr "targets for %d source files that are out of date" -#: ext/graphviz.py:164 -msgid "Ignoring \"graphviz\" directive without content." -msgstr "Ignoring \"graphviz\" directive without content." +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "looking for now-outdated files... " -#: ext/graphviz.py:287 +#: builders/__init__.py:415 #, python-format -msgid "graphviz_dot executable path must be set! %r" -msgstr "" +msgid "%d found" +msgstr "%d found" -#: ext/graphviz.py:328 -#, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" -msgstr "dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting" +#: builders/__init__.py:417 +msgid "none found" +msgstr "none found" -#: ext/graphviz.py:339 -#, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "dot exited with error:\n[stderr]\n%r\n[stdout]\n%r" - -#: ext/graphviz.py:344 -#, python-format -msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "dot did not produce an output file:\n[stderr]\n%r\n[stdout]\n%r" - -#: ext/graphviz.py:367 -#, python-format -msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" -msgstr "" - -#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 -#, python-format -msgid "dot code %r: %s" -msgstr "dot code %r: %s" - -#: ext/graphviz.py:493 ext/graphviz.py:501 -#, python-format -msgid "[graph: %s]" -msgstr "[graph: %s]" - -#: ext/graphviz.py:495 ext/graphviz.py:503 -msgid "[graph]" -msgstr "[graph]" - -#: ext/todo.py:61 -msgid "Todo" -msgstr "Todo" - -#: ext/todo.py:94 -#, python-format -msgid "TODO entry found: %s" -msgstr "TODO entry found: %s" - -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" - -#: ext/todo.py:154 -#, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(The <> is located in %s, line %d.)" - -#: ext/todo.py:166 -msgid "original entry" -msgstr "original entry" +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "pickling environment" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "non-whitespace stripped by dedent" +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "checking consistency" -#: directives/code.py:87 -#, python-format -msgid "Invalid caption: %s" -msgstr "Invalid caption: %s" +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "no targets are out of date." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 -#, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "line number spec is out of range(1-%d): %r" +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "updating environment: " -#: directives/code.py:216 +#: builders/__init__.py:499 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Cannot use both \"%s\" and \"%s\" options" +msgid "%s added, %s changed, %s removed" +msgstr "%s added, %s changed, %s removed" -#: directives/code.py:231 +#: builders/__init__.py:536 #, python-format -msgid "Include file '%s' not found or reading it failed" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: directives/code.py:235 +#: builders/__init__.py:545 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: directives/code.py:276 -#, python-format -msgid "Object named %r not found in include file %r" -msgstr "Object named %r not found in include file %r" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" - -#: directives/code.py:314 +#: builders/__init__.py:556 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Line spec %r: no lines pulled from include file %r" - -#: directives/patches.py:71 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "\":file:\" option for csv-table directive now recognises an absolute path as a relative path from source directory. Please update your document." - -#: directives/other.py:119 -#, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "toctree glob pattern %r didn't match any documents" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: builders/__init__.py:563 #, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "toctree contains reference to excluded document %r" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "toctree contains reference to nonexisting document %r" +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "reading sources... " -#: directives/other.py:169 +#: builders/__init__.py:725 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "duplicated entry found in toctree: %s" - -#: directives/other.py:203 -msgid "Section author: " -msgstr "Section author: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Module author: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Code author: " +msgid "docnames to write: %s" +msgstr "docnames to write: %s" -#: directives/other.py:209 -msgid "Author: " -msgstr "Author: " +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr ".. acks content is not a list" +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "preparing documents" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr ".. hlist content is not a list" +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "copying assets" #: builders/changes.py:29 #, python-format msgid "The overview file is in %(outdir)s." msgstr "The overview file is in %(outdir)s." -#: builders/changes.py:56 +#: builders/changes.py:65 #, python-format msgid "no changes in version %s." msgstr "no changes in version %s." -#: builders/changes.py:58 +#: builders/changes.py:67 msgid "writing summary file..." msgstr "writing summary file..." -#: builders/changes.py:70 +#: builders/changes.py:79 msgid "Builtins" msgstr "Builtins" -#: builders/changes.py:72 +#: builders/changes.py:81 msgid "Module level" msgstr "Module level" -#: builders/changes.py:124 +#: builders/changes.py:137 msgid "copying source files..." msgstr "copying source files..." -#: builders/changes.py:133 +#: builders/changes.py:146 #, python-format msgid "could not read %r for changelog creation" msgstr "could not read %r for changelog creation" -#: builders/manpage.py:37 +#: ext/coverage.py:48 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "The manual pages are in %(outdir)s." - -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "no \"man_pages\" config value found; no manual pages will be written" - -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "writing" +msgid "invalid regex %r in %s" +msgstr "invalid regex %r in %s" -#: builders/manpage.py:71 +#: ext/coverage.py:140 ext/coverage.py:301 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "\"man_pages\" config value references unknown document %s" +msgid "module %s could not be imported: %s" +msgstr "module %s could not be imported: %s" -#: builders/__init__.py:224 +#: ext/coverage.py:148 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "a suitable image for %s builder not found: %s (%s)" +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "" -#: builders/__init__.py:232 +#: ext/coverage.py:158 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "a suitable image for %s builder not found: %s" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "building [mo]: " +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "writing output... " +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "" -#: builders/__init__.py:275 +#: ext/coverage.py:187 #, python-format -msgid "all of %d po files" -msgstr "all of %d po files" +msgid "invalid regex %r in coverage_c_regexes" +msgstr "invalid regex %r in coverage_c_regexes" -#: builders/__init__.py:297 +#: ext/coverage.py:260 #, python-format -msgid "targets for %d po files that are specified" -msgstr "targets for %d po files that are specified" +msgid "undocumented c api: %s [%s] in file %s" +msgstr "undocumented c api: %s [%s] in file %s" -#: builders/__init__.py:309 +#: ext/coverage.py:452 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "targets for %d po files that are out of date" +msgid "undocumented python function: %s :: %s" +msgstr "undocumented python function: %s :: %s" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "all source files" +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "undocumented python class: %s :: %s" -#: builders/__init__.py:330 +#: ext/coverage.py:492 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "file %r given on command line does not exist, " +msgid "undocumented python method: %s :: %s :: %s" +msgstr "undocumented python method: %s :: %s :: %s" -#: builders/__init__.py:337 +#: ext/extlinks.py:82 #, python-format msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "file %r given on command line is not under the source directory, ignoring" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "hardcoded link %r could be replaced by an extlink (try using %r instead)" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "file %r given on command line is not a valid document, ignoring" +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" -#: builders/__init__.py:361 +#: ext/todo.py:94 #, python-format -msgid "%d source files given on command line" -msgstr "%d source files given on command line" +msgid "TODO entry found: %s" +msgstr "TODO entry found: %s" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "targets for %d source files that are out of date" +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" -#: builders/__init__.py:395 builders/gettext.py:265 +#: ext/todo.py:154 #, python-format -msgid "building [%s]: " -msgstr "building [%s]: " - -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "looking for now-outdated files... " - -#: builders/__init__.py:410 -#, python-format -msgid "%d found" -msgstr "%d found" +msgid "(The <> is located in %s, line %d.)" +msgstr "(The <> is located in %s, line %d.)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "none found" +#: ext/todo.py:166 +msgid "original entry" +msgstr "original entry" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "pickling environment" +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n\nTraceback: %s" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "checking consistency" +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "convert exited with error:\n[stderr]\n%r\n[stdout]\n%r" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "no targets are out of date." +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" +msgstr "convert command %r cannot be run, check the image_converter setting" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "updating environment: " +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" +msgstr "Graphviz directive cannot have both content and a filename argument" -#: builders/__init__.py:494 +#: ext/graphviz.py:153 #, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s added, %s changed, %s removed" +msgid "External Graphviz file %r not found or reading it failed" +msgstr "External Graphviz file %r not found or reading it failed" + +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "Ignoring \"graphviz\" directive without content." -#: builders/__init__.py:531 +#: ext/graphviz.py:287 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "graphviz_dot executable path must be set! %r" msgstr "" -#: builders/__init__.py:540 +#: ext/graphviz.py:328 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" +msgstr "dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting" -#: builders/__init__.py:551 +#: ext/graphviz.py:339 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "dot exited with error:\n[stderr]\n%r\n[stdout]\n%r" -#: builders/__init__.py:558 +#: ext/graphviz.py:344 #, python-format msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "reading sources... " +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "dot did not produce an output file:\n[stderr]\n%r\n[stdout]\n%r" -#: builders/__init__.py:713 +#: ext/graphviz.py:367 #, python-format -msgid "docnames to write: %s" -msgstr "docnames to write: %s" - -#: builders/__init__.py:715 -msgid "no docnames to write!" +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "preparing documents" - -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "copying assets" - -#: builders/__init__.py:883 +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "undecodable source characters, replacing with \"?\": %r" +msgid "dot code %r: %s" +msgstr "dot code %r: %s" -#: builders/epub3.py:84 +#: ext/graphviz.py:493 ext/graphviz.py:501 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "The ePub file is in %(outdir)s." +msgid "[graph: %s]" +msgstr "[graph: %s]" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "writing nav.xhtml file..." +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" +msgstr "[graph]" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "LaTeX command %r cannot be run (needed for maths display), check the imgmath_latex setting" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s command %r cannot be run (needed for maths display), check the imgmath_%s setting" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "display latex %r: %s" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "conf value \"epub_author\" should not be empty for EPUB3" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "inline latex %r: %s" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "conf value \"epub_contributor\" should not be empty for EPUB3" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "conf value \"epub_description\" should not be empty for EPUB3" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "missing '+' or '-' in '%s' option." -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "conf value \"epub_publisher\" should not be empty for EPUB3" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "'%s' is not a valid option." -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' is not a valid pyversion option" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "conf value \"epub_identifier\" should not be empty for EPUB3" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "invalid TestCode type" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "conf value \"version\" should not be empty for EPUB3" +#: ext/doctest.py:297 +#, python-format +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt." -#: builders/epub3.py:279 builders/html/__init__.py:1291 +#: ext/doctest.py:451 #, python-format -msgid "invalid css_file: %r, ignored" -msgstr "invalid css_file: %r, ignored" +msgid "no code/output in %s block at %s:%s" +msgstr "no code/output in %s block at %s:%s" -#: builders/xml.py:31 +#: ext/doctest.py:568 #, python-format -msgid "The XML files are in %(outdir)s." -msgstr "The XML files are in %(outdir)s." +msgid "ignoring invalid doctest code: %r" +msgstr "ignoring invalid doctest code: %r" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: ext/autosectionlabel.py:52 #, python-format -msgid "error writing file %s: %s" -msgstr "error writing file %s: %s" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "section \"%s\" gets labeled as \"%s\"" -#: builders/xml.py:101 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "The pseudo-XML files are in %(outdir)s." +msgid "duplicate label %s, other instance in %s" +msgstr "duplicate label %s, other instance in %s" -#: builders/texinfo.py:45 +#: ext/duration.py:47 #, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "The Texinfo files are in %(outdir)s." +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" -#: builders/texinfo.py:48 +#: ext/duration.py:117 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nRun 'make' in that directory to run these through makeinfo\n(use 'make info' here to do that automatically)." - -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "no \"texinfo_documents\" config value found; no documents will be written" +"====================== total reading duration ==========================" +msgstr "" -#: builders/texinfo.py:89 +#: ext/duration.py:124 #, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "\"texinfo_documents\" config value references unknown document %s" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" + +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "====================== slowest reading durations =======================" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 +#: ext/duration.py:139 #, python-format -msgid "processing %s" -msgstr "processing %s" +msgid "%.3fs %s" +msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "resolving references..." +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[source]" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (in " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "highlighting module code... " -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "copying images... " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[docs]" + +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Module code" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 +#: ext/viewcode.py:359 #, python-format -msgid "cannot copy image file %r: %s" -msgstr "cannot copy image file %r: %s" +msgid "

        Source code for %s

        " +msgstr "

        Source code for %s

        " -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "copying Texinfo support files" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Overview: module code" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "error writing file Makefile: %s" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        All modules for which code is available

        " -#: builders/_epub_base.py:223 +#: domains/citation.py:75 #, python-format -msgid "duplicated ToC entry found: %s" -msgstr "duplicated ToC entry found: %s" +msgid "duplicate citation %s, other instance in %s" +msgstr "duplicate citation %s, other instance in %s" -#: builders/_epub_base.py:433 +#: domains/citation.py:92 #, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "cannot read image file %r: copying it instead" +msgid "Citation [%s] is not referenced." +msgstr "Citation [%s] is not referenced." -#: builders/_epub_base.py:464 +#: domains/math.py:73 #, python-format -msgid "cannot write image file %r: %s" -msgstr "cannot write image file %r: %s" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "duplicate label of equation %s, other instance in %s" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Pillow not found - copying image files" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "Invalid math_eqref_format: %r" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "writing mimetype file..." +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (built-in function)" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "writing META-INF/container.xml file..." +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s method)" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "writing content.opf file..." +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (class)" -#: builders/_epub_base.py:591 +#: domains/javascript.py:188 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "unknown mimetype for %s, ignoring" +msgid "%s (global variable or constant)" +msgstr "%s (global variable or constant)" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "" +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" +msgstr "%s (%s attribute)" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "writing toc.ncx file..." +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Arguments" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "writing %s file..." +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Throws" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "The dummy builder generates no files." +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Returns" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "The message catalogues are in %(outdir)s." +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Return type" -#: builders/gettext.py:266 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d template files" -msgstr "targets for %d template files" +msgid "%s (module)" +msgstr "%s (module)" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "reading templates... " +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "function" -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "writing message catalogues... " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "method" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "The HTML page is in %(outdir)s." +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "class" -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "assembling single document" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "data" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "writing additional files" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "attribute" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Look for any errors in the above output or in %(outdir)s/output.txt" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "module" -#: builders/linkcheck.py:149 +#: domains/javascript.py:458 #, python-format -msgid "broken link: %s (%s)" -msgstr "broken link: %s (%s)" +msgid "duplicate %s description of %s, other %s in %s" +msgstr "duplicate %s description of %s, other %s in %s" -#: builders/linkcheck.py:548 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "Anchor '%s' not found" -msgstr "Anchor '%s' not found" +msgid "%s (directive)" +msgstr "%s (directive)" -#: builders/linkcheck.py:758 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgid ":%s: (directive option)" +msgstr ":%s: (directive option)" -#: builders/text.py:29 +#: domains/rst.py:224 #, python-format -msgid "The text files are in %(outdir)s." -msgstr "The text files are in %(outdir)s." - -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "inconsistent footnote references in translated message. original: {0}, translated: {1}" +msgid "%s (role)" +msgstr "%s (role)" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "inconsistent references in translated message. original: {0}, translated: {1}" +#: domains/rst.py:234 +msgid "directive" +msgstr "directive" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "inconsistent citation references in translated message. original: {0}, translated: {1}" +#: domains/rst.py:235 +msgid "directive-option" +msgstr "directive-option" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "inconsistent term references in translated message. original: {0}, translated: {1}" +#: domains/rst.py:236 +msgid "role" +msgstr "role" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 +#: domains/rst.py:262 #, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "duplicate description of %s %s, other instance in %s" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" msgstr "" -#: transforms/__init__.py:253 +#: domains/changeset.py:33 #, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "4 column based index found. It might be a bug of extensions you use: %r" +msgid "Changed in version %s" +msgstr "Changed in version %s" -#: transforms/__init__.py:294 +#: domains/changeset.py:34 #, python-format -msgid "Footnote [%s] is not referenced." -msgstr "Footnote [%s] is not referenced." +msgid "Deprecated since version %s" +msgstr "Deprecated since version %s" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "Footnote [#] is not referenced." +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "job number should be a positive number" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "For more information, visit ." -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nGenerate documentation from source files.\n\nsphinx-build generates documentation from the files in SOURCEDIR and places it\nin OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\nsettings. The 'sphinx-quickstart' tool may be used to generate template files,\nincluding 'conf.py'\n\nsphinx-build can create documentation in different formats. A format is\nselected by specifying the builder name on the command line; it defaults to\nHTML. Builders can also perform other tasks related to documentation\nprocessing.\n\nBy default, everything that is outdated is built. Output only for selected\nfiles can be built by specifying individual filenames.\n" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "path to documentation source files" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "path to output directory" + +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/build.py:114 +msgid "general options" +msgstr "general options" + +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/build.py:131 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "write all files (default: only write new and changed files)" -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "don't use a saved environment, always read all files" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "override a setting in configuration file" -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "pass a value into HTML templates" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "define tag: include \"only\" blocks with TAG" + +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: environment/__init__.py:86 -msgid "new config" -msgstr "new config" +#: cmd/build.py:212 +msgid "console output options" +msgstr "console output options" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "config changed" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "increase verbosity (can be repeated)" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "extensions changed" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "no output on stdout, just warnings on stderr" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "build environment version not current" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "no output at all, not even warnings" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "source directory has changed" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "do emit colored output (default: auto-detect)" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "do not emit coloured output (default: auto-detect)" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "write warnings (and errors) to given file" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "This environment is incompatible with the selected builder, please choose another doctree directory." +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "turn warnings into errors" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "Failed to scan documents in %s: %r" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "show full traceback on exception" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "Domain %r is not registered" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "run Pdb on exception" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "document isn't included in any toctree" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "self referenced toctree found. Ignored." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "cannot combine -a option and filenames" -#: environment/__init__.py:889 +#: cmd/build.py:357 #, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "reading error: %s, %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "-D option argument must be in the form name=value" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "writing error: %s, %s" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "-A option argument must be in the form name=value" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "automatically insert docstrings from modules" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "automatically test code snippets in doctest blocks" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Invalid date format. Quote the string by single quote if you want to output it directly: %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "link between Sphinx documentation of different projects" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "Problem in %s domain: field is supposed to use role '%s', but that role is not in the domain." +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "write \"todo\" entries that can be shown or hidden on build" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "checks for documentation coverage" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "include maths, rendered as PNG or SVG images" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "include maths, rendered in the browser by MathJax" -#: util/display.py:82 -msgid "skipped" -msgstr "skipped" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "conditional inclusion of content based on config values" -#: util/display.py:87 -msgid "failed" -msgstr "failed" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "include links to the source code of documented Python objects" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "create .nojekyll file to publish the document on GitHub pages" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Please enter a valid path name." -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Please enter some text." -#: util/docutils.py:789 +#: cmd/quickstart.py:134 #, python-format -msgid "unknown node type: %r" -msgstr "unknown node type: %r" +msgid "Please enter one of %s." +msgstr "Please enter one of %s." -#: util/fileutil.py:76 -#, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Please enter either 'y' or 'n'." -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Please enter a file suffix, e.g. '.rst' or '.txt'." -#: util/rst.py:73 +#: cmd/quickstart.py:230 #, python-format -msgid "default role %s not found" -msgstr "default role %s not found" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Welcome to the Sphinx %s quickstart utility." -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Please enter values for the following settings (just press Enter to\naccept a default value, if one is given in brackets)." -#: util/inventory.py:166 +#: cmd/quickstart.py:242 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" +msgid "Selected root path: %s" +msgstr "Selected root path: %s" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Footnotes" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Enter the root path for documentation." -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[image: %s]" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Root path for the documentation" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[image]" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Error: an existing conf.py has been found in the selected root path." -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Index" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart will not overwrite existing Sphinx projects." -#: writers/latex.py:743 writers/texinfo.py:646 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "encountered title node not in section, topic, table, admonition or sidebar" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Please enter a new root path (or just Enter to exit)" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "caption not inside a figure." +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "You have two options for placing the build directory for Sphinx output.\nEither, you use a directory \"_build\" within the root path, or you separate\n\"source\" and \"build\" directories within the root path." -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "unimplemented node type: %r" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Separate source and build directories (y/n)" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "unknown %r toplevel_sectioning for class %r" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "Inside the root directory, two more directories will be created; \"_templates\"\nfor custom HTML templates and \"_static\" for custom stylesheets and other static\nfiles. You can enter another prefix (such as \".\") to replace the underscore." -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "no Babel option known for language %r" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Name prefix for templates and static dir" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "too large :maxdepth:, ignored." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "The project name will occur in several places in the built documentation." -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Project name" -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "document title is not a single Text node" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Author name(s)" -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx has the notion of a \"version\" and a \"release\" for the\nsoftware. Each version can have multiple releases. For example, for\nPython the version is something like 2.5 or 3.0, while the release is\nsomething like 2.5.1 or 3.0a1. If you don't need this dual structure,\njust set both to the same value." -#: writers/latex.py:1183 +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Project version" + +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Project release" + +#: cmd/quickstart.py:324 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "both tabularcolumns and :widths: option are given. :widths: is ignored." +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "If the documents are to be written in a language other than English,\nyou can select a language here by its language code. Sphinx will then\ntranslate text that it generates into that language.\n\nFor a list of supported codes, see\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "dimension unit %s is invalid. Ignored." +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Project language" -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "unknown index entry type %s found" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "The file name suffix for source files. Commonly, this is either \".txt\"\nor \".rst\". Only files with this suffix are considered documents." -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "Invalid math_eqref_format: %r" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Source file suffix" -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "One document is special in that it is considered the top node of the\n\"contents tree\", that is, it is the root of the hierarchical structure\nof the documents. Normally, this is \"index\", but if your \"index\"\ndocument is a custom template, you can also set this to another filename." -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "numfig_format is not defined for %s" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Name of your master document (without suffix)" -#: writers/html5.py:441 +#: cmd/quickstart.py:368 #, python-format -msgid "Any IDs not assigned for %s node" -msgstr "Any IDs not assigned for %s node" +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Error: the master file %s has already been found in the selected root path." -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart will not overwrite the existing file." -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Please enter a new file name, or rename the existing file and press Enter" -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Indicate which of the following Sphinx extensions should be enabled:" -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected." -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "A Makefile and a Windows command file can be generated for you so that you\nonly have to run e.g. `make html' instead of invoking sphinx-build\ndirectly." -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Create Makefile? (y/n)" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "Could not obtain image size. :scale: option is ignored." +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Create Windows command file? (y/n)" -#: domains/__init__.py:322 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "Creating file %s." +msgstr "Creating file %s." -#: domains/math.py:73 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "duplicate label of equation %s, other instance in %s" +msgid "File %s already exists, skipping." +msgstr "File %s already exists, skipping." -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (built-in function)" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Finished: An initial directory structure has been created." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: cmd/quickstart.py:520 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s method)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "You should now populate your master file %s and create other documentation\nsource files. " -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (class)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Use the Makefile to build the docs, like so:\n make builder" -#: domains/javascript.py:187 +#: cmd/quickstart.py:531 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s (global variable or constant)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Use the sphinx-build command to build the docs, like so:\n sphinx-build -b builder %s %s" -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s attribute)" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "where \"builder\" is one of the supported builders, e.g. html, latex or linkcheck." -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Arguments" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nGenerate required files for a Sphinx project.\n\nsphinx-quickstart is an interactive tool that asks some questions about your\nproject and then generates a complete documentation directory and sample\nMakefile to be used with sphinx-build.\n" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Throws" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "quiet mode" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Returns" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "project root" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Return type" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Structure options" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (module)" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "if specified, separate source and build dirs" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "function" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "if specified, create build dir under source dir" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "method" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "replacement for dot in _templates etc." -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "class" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Project basic options" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "data" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "project name" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "attribute" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "author names" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "module" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "version of project" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "duplicate %s description of %s, other %s in %s" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "release of project" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "document language" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Changed in version %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "source file suffix" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Deprecated since version %s" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "master document name" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (directive)" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "use epub" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (directive option)" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Extension options" -#: domains/rst.py:224 +#: cmd/quickstart.py:671 #, python-format -msgid "%s (role)" -msgstr "%s (role)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "directive" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "directive-option" +msgid "enable %s extension" +msgstr "enable %s extension" -#: domains/rst.py:236 -msgid "role" -msgstr "role" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "enable arbitrary extensions" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "duplicate description of %s %s, other instance in %s" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Makefile and Batchfile creation" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "duplicate citation %s, other instance in %s" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "create makefile" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "Citation [%s] is not referenced." +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "do not create makefile" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Attention" +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "create batchfile" -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Caution" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "do not create batchfile" -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Danger" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "use make-mode for Makefile/make.bat" -#: locale/__init__.py:231 -msgid "Error" -msgstr "Error" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Project templating" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Hint" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "template directory for template files" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Important" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "define a template variable" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Note" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -#: locale/__init__.py:235 -msgid "See also" -msgstr "See also" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Error: specified path is not a directory, or sphinx files already exist." -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tip" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart only generate into a empty directory. Please specify a new root path." -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Warning" +#: cmd/quickstart.py:810 +#, python-format +msgid "Invalid template variable: %s" +msgstr "Invalid template variable: %s" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "automatically insert docstrings from modules" +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" +msgstr "toctree glob pattern %r didn't match any documents" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "automatically test code snippets in doctest blocks" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" +msgstr "toctree contains reference to excluded document %r" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "link between Sphinx documentation of different projects" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "toctree contains reference to nonexisting document %r" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "write \"todo\" entries that can be shown or hidden on build" +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "duplicated entry found in toctree: %s" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "checks for documentation coverage" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Section author: " -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "include maths, rendered as PNG or SVG images" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Module author: " -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "include maths, rendered in the browser by MathJax" +#: directives/other.py:207 +msgid "Code author: " +msgstr "Code author: " -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "conditional inclusion of content based on config values" +#: directives/other.py:209 +msgid "Author: " +msgstr "Author: " -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "include links to the source code of documented Python objects" +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr ".. acks content is not a list" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "create .nojekyll file to publish the document on GitHub pages" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr ".. hlist content is not a list" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Please enter a valid path name." +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "\":file:\" option for csv-table directive now recognises an absolute path as a relative path from source directory. Please update your document." -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Please enter some text." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "non-whitespace stripped by dedent" -#: cmd/quickstart.py:133 +#: directives/code.py:87 #, python-format -msgid "Please enter one of %s." -msgstr "Please enter one of %s." +msgid "Invalid caption: %s" +msgstr "Invalid caption: %s" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Please enter either 'y' or 'n'." +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" +msgstr "line number spec is out of range(1-%d): %r" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Cannot use both \"%s\" and \"%s\" options" -#: cmd/quickstart.py:229 +#: directives/code.py:231 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Welcome to the Sphinx %s quickstart utility." +msgid "Include file '%s' not found or reading it failed" +msgstr "" -#: cmd/quickstart.py:234 +#: directives/code.py:235 +#, python-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Please enter values for the following settings (just press Enter to\naccept a default value, if one is given in brackets)." +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" -#: cmd/quickstart.py:241 +#: directives/code.py:276 #, python-format -msgid "Selected root path: %s" -msgstr "Selected root path: %s" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "Enter the root path for documentation." +msgid "Object named %r not found in include file %r" +msgstr "Object named %r not found in include file %r" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Root path for the documentation" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Error: an existing conf.py has been found in the selected root path." +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Line spec %r: no lines pulled from include file %r" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart will not overwrite existing Sphinx projects." +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Please enter a new root path (or just Enter to exit)" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Index" -#: cmd/quickstart.py:273 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "You have two options for placing the build directory for Sphinx output.\nEither, you use a directory \"_build\" within the root path, or you separate\n\"source\" and \"build\" directories within the root path." +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "encountered title node not in section, topic, table, admonition or sidebar" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Separate source and build directories (y/n)" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Footnotes" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "Inside the root directory, two more directories will be created; \"_templates\"\nfor custom HTML templates and \"_static\" for custom stylesheets and other static\nfiles. You can enter another prefix (such as \".\") to replace the underscore." - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Name prefix for templates and static dir" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "The project name will occur in several places in the built documentation." - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Project name" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Author name(s)" +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "caption not inside a figure." -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "Sphinx has the notion of a \"version\" and a \"release\" for the\nsoftware. Each version can have multiple releases. For example, for\nPython the version is something like 2.5 or 3.0, while the release is\nsomething like 2.5.1 or 3.0a1. If you don't need this dual structure,\njust set both to the same value." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "unimplemented node type: %r" -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Project version" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[image: %s]" -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Project release" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[image]" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "If the documents are to be written in a language other than English,\nyou can select a language here by its language code. Sphinx will then\ntranslate text that it generates into that language.\n\nFor a list of supported codes, see\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Project language" +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" +msgstr "numfig_format is not defined for %s" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "The file name suffix for source files. Commonly, this is either \".txt\"\nor \".rst\". Only files with this suffix are considered documents." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "Any IDs not assigned for %s node" -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Source file suffix" +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "One document is special in that it is considered the top node of the\n\"contents tree\", that is, it is the root of the hierarchical structure\nof the documents. Normally, this is \"index\", but if your \"index\"\ndocument is a custom template, you can also set this to another filename." +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Name of your master document (without suffix)" +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" -#: cmd/quickstart.py:367 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Error: the master file %s has already been found in the selected root path." - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart will not overwrite the existing file." - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Please enter a new file name, or rename the existing file and press Enter" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Indicate which of the following Sphinx extensions should be enabled:" +msgid "unsupported rubric heading level: %s" +msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected." +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "A Makefile and a Windows command file can be generated for you so that you\nonly have to run e.g. `make html' instead of invoking sphinx-build\ndirectly." +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Create Makefile? (y/n)" +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Create Windows command file? (y/n)" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "Could not obtain image size. :scale: option is ignored." -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:386 #, python-format -msgid "Creating file %s." -msgstr "Creating file %s." +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "unknown %r toplevel_sectioning for class %r" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "File %s already exists, skipping." -msgstr "File %s already exists, skipping." +msgid "no Babel option known for language %r" +msgstr "no Babel option known for language %r" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Finished: An initial directory structure has been created." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "too large :maxdepth:, ignored." -#: cmd/quickstart.py:519 +#: writers/latex.py:616 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "You should now populate your master file %s and create other documentation\nsource files. " +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Use the Makefile to build the docs, like so:\n make builder" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "document title is not a single Text node" -#: cmd/quickstart.py:530 -#, python-format +#: writers/latex.py:1198 msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Use the sphinx-build command to build the docs, like so:\n sphinx-build -b builder %s %s" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "both tabularcolumns and :widths: option are given. :widths: is ignored." -#: cmd/quickstart.py:537 +#: writers/latex.py:1228 +#, python-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "where \"builder\" is one of the supported builders, e.g. html, latex or linkcheck." +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nGenerate required files for a Sphinx project.\n\nsphinx-quickstart is an interactive tool that asks some questions about your\nproject and then generates a complete documentation directory and sample\nMakefile to be used with sphinx-build.\n" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "dimension unit %s is invalid. Ignored." -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "For more information, visit ." +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "unknown index entry type %s found" -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "quiet mode" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "project root" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Structure options" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "if specified, separate source and build dirs" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "if specified, create build dir under source dir" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "replacement for dot in _templates etc." +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Project basic options" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "project name" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "author names" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "version of project" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "release of project" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "document language" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "source file suffix" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "master document name" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "use epub" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Extension options" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" -msgstr "enable %s extension" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "inconsistent footnote references in translated message. original: {0}, translated: {1}" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "enable arbitrary extensions" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "inconsistent references in translated message. original: {0}, translated: {1}" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Makefile and Batchfile creation" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "inconsistent citation references in translated message. original: {0}, translated: {1}" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "create makefile" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "inconsistent term references in translated message. original: {0}, translated: {1}" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "do not create makefile" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "create batchfile" +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "do not create batchfile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "4 column based index found. It might be a bug of extensions you use: %r" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "use make-mode for Makefile/make.bat" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "Footnote [%s] is not referenced." -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Project templating" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "template directory for template files" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "Footnote [#] is not referenced." -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "define a template variable" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "reading error: %s, %s" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart only generate into a empty directory. Please specify a new root path." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "writing error: %s, %s" -#: cmd/quickstart.py:809 +#: util/i18n.py:146 #, python-format -msgid "Invalid template variable: %s" -msgstr "Invalid template variable: %s" +msgid "locale_dir %s does not exist" +msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "job number should be a positive number" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" -#: cmd/build.py:74 +#: util/i18n.py:253 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\nGenerate documentation from source files.\n\nsphinx-build generates documentation from the files in SOURCEDIR and places it\nin OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\nsettings. The 'sphinx-quickstart' tool may be used to generate template files,\nincluding 'conf.py'\n\nsphinx-build can create documentation in different formats. A format is\nselected by specifying the builder name on the command line; it defaults to\nHTML. Builders can also perform other tasks related to documentation\nprocessing.\n\nBy default, everything that is outdated is built. Output only for selected\nfiles can be built by specifying individual filenames.\n" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "path to documentation source files" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "path to output directory" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Invalid date format. Quote the string by single quote if you want to output it directly: %s" -#: cmd/build.py:109 +#: util/osutil.py:131 +#, python-format msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:114 -msgid "general options" -msgstr "general options" +#: util/display.py:82 +msgid "skipped" +msgstr "skipped" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/display.py:87 +msgid "failed" +msgstr "failed" + +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "write all files (default: only write new and changed files)" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "unknown node type: %r" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "don't use a saved environment, always read all files" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:157 +#: util/docfields.py:103 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "Problem in %s domain: field is supposed to use role '%s', but that role is not in the domain." -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "default role %s not found" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "override a setting in configuration file" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "toctree contains ref to nonexisting file %r" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "pass a value into HTML templates" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "exception while evaluating only directive expression: %s" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "define tag: include \"only\" blocks with TAG" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "continued from previous page" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "continues on next page" -#: cmd/build.py:212 -msgid "console output options" -msgstr "console output options" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "Non-alphabetical" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "increase verbosity (can be repeated)" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Symbols" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "no output on stdout, just warnings on stderr" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Numbers" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "no output at all, not even warnings" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "page" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "do emit colored output (default: auto-detect)" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Release" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "do not emit coloured output (default: auto-detect)" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "Could not fetch remote image: %s [%s]" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "Could not fetch remote image: %s [%d]" + +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Unknown image format: %s..." + +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "Could not determine the fallback text for the cross-reference. Might be a bug." + +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "more than one target found for 'any' cross-reference %r: could be %s" + +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s reference target not found: %s" + +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r reference target not found: %s" + +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "Interrupted!" + +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "write warnings (and errors) to given file" +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "turn warnings into errors" +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "show full traceback on exception" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "run Pdb on exception" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "cannot combine -a option and filenames" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "" -#: cmd/build.py:357 +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Please also report this if it was a user error, so that a better error message can be provided next time." + +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Collapse sidebar" + +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigation" + +#: themes/basic/layout.html:115 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" +msgid "Search within %(docstitle)s" +msgstr "Search within %(docstitle)s" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "-D option argument must be in the form name=value" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "About these documents" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "-A option argument must be in the form name=value" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Search" + +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Last updated on %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Created using Sphinx %(sphinx_version)s." + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Previous topic" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "previous chapter" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Next topic" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Collapse sidebar" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "next chapter" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Table of Contents" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Full index on one page" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "This Page" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Show Source" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Quick search" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Go" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2682,7 +2882,7 @@ msgstr "Global Module Index" msgid "quick access to all modules" msgstr "quick access to all modules" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "General Index" @@ -2690,23 +2890,15 @@ msgstr "General Index" msgid "all functions, classes, terms" msgstr "all functions, classes, terms" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Table of Contents" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Full index on one page" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Quick search" +msgid "Search %(docstitle)s" +msgstr "Search %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2716,57 +2908,6 @@ msgstr "Index pages by letter" msgid "can be huge" msgstr "can be huge" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Previous topic" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "previous chapter" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Next topic" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "next chapter" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigation" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Search within %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "About these documents" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "© %(copyright_prefix)s %(copyright)s." - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Last updated on %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Created using Sphinx %(sphinx_version)s." - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2783,21 +2924,21 @@ msgstr "Searching for multiple words only shows matches that contain\n all wo msgid "search" msgstr "search" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Contents" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Search Results" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2805,22 +2946,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Searching" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Preparing search..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", in " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Hide Search Matches" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2828,6 +2968,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Changes in Version %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2849,120 +2994,127 @@ msgstr "Other changes" msgid "Expand sidebar" msgstr "Expand sidebar" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parameters" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variables" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Raises" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (in module %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (in module %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (built-in variable)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (built-in class)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (class in %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s class method)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s static method)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (%s property)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python Module Index" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "modules" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Deprecated" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "exception" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "class method" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "static method" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "property" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "more than one target found for cross-reference %r: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (deprecated)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parameters" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variables" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "Duplicate C++ declaration, also defined at %s:%s.\nDeclaration is '.. cpp:%s:: %s'." #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2973,92 +3125,85 @@ msgstr "Template Parameters" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "Duplicate C++ declaration, also defined at %s:%s.\nDeclaration is '.. cpp:%s:: %s'." - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "Return values" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "union" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "member" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "type" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "concept" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerator" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "function parameter" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "template parameter" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Duplicate C declaration, also defined at %s:%s.\nDeclaration is '.. c:%s:: %s'." -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "variable" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "macro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "struct" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "environment variable; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3153,514 +3298,422 @@ msgstr "undefined label: %r" msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "Failed to create a cross reference. A title or caption not found: %r" -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "circular toctree references detected, ignoring: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "toctree contains reference to document %r that doesn't have a title: no link will be generated" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "toctree contains reference to non-included document %r" - -#: environment/adapters/toctree.py:367 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "see %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "see also %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "unknown index entry type %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Symbols" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "image file not readable: %s" +msgid "invalid value set (missing closing brace): %s" +msgstr "invalid value set (missing closing brace): %s" -#: environment/collectors/asset.py:126 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "image file %s not readable: %s" -msgstr "image file %s not readable: %s" +msgid "invalid value set (missing opening brace): %s" +msgstr "invalid value set (missing opening brace): %s" -#: environment/collectors/asset.py:163 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "download file not readable: %s" -msgstr "download file not readable: %s" +msgid "malformed string literal (missing closing quote): %s" +msgstr "malformed string literal (missing closing quote): %s" -#: environment/collectors/toctree.py:259 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s is already assigned section numbers (nested numbered toctree?)" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "Interrupted!" +msgid "malformed string literal (missing opening quote): %s" +msgstr "malformed string literal (missing opening quote): %s" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Example" -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Examples" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Keyword Arguments" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Notes" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Other Parameters" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "Receives" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "References" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Please also report this if it was a user error, so that a better error message can be provided next time." +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Warns" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "Could not determine the fallback text for the cross-reference. Might be a bug." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "Yields" -#: transforms/post_transforms/__init__.py:237 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "more than one target found for 'any' cross-reference %r: could be %s" +msgid "A mocked object is detected: %r" +msgstr "A mocked object is detected: %r" -#: transforms/post_transforms/__init__.py:299 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s reference target not found: %s" +msgid "alias of %s" +msgstr "alias of %s" -#: transforms/post_transforms/__init__.py:305 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "%r reference target not found: %s" -msgstr "%r reference target not found: %s" +msgid "Bases: %s" +msgstr "Bases: %s" -#: transforms/post_transforms/images.py:79 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "Could not fetch remote image: %s [%s]" +msgid "invalid value for member-order option: %s" +msgstr "invalid value for member-order option: %s" -#: transforms/post_transforms/images.py:96 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "Could not fetch remote image: %s [%d]" +msgid "invalid value for class-doc-from option: %s" +msgstr "invalid value for class-doc-from option: %s" -#: transforms/post_transforms/images.py:143 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "Unknown image format: %s..." -msgstr "Unknown image format: %s..." +msgid "invalid signature for auto%s (%r)" +msgstr "invalid signature for auto%s (%r)" -#: builders/html/__init__.py:113 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "The HTML pages are in %(outdir)s." +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "don't know which module to import for autodocumenting %r (try placing a \"module\" or \"currentmodule\" directive in the document, or giving an explicit module name)" -#: builders/html/__init__.py:348 +#: ext/autodoc/_names.py:89 #, python-format -msgid "Failed to read build info file: %r" -msgstr "Failed to read build info file: %r" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "" - -#: builders/html/__init__.py:366 -msgid "building [html]: " +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:383 +#: ext/autodoc/_names.py:93 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "index" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "\"::\" in automodule name doesn't make sense" -#: builders/html/__init__.py:560 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "Logo of %s" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "next" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "previous" +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "Would create file %s." -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "generating indices" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nLook recursively in for Python modules and packages and create\none reST file with automodule directives per package in the .\n\nThe s can be file and/or directory patterns that will be\nexcluded from generation.\n\nNote: By default this script will not overwrite already created files." -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "writing additional pages" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "path to module to document" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "fnmatch-style file and/or directory patterns to exclude from generation" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "copying downloadable files... " +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "directory to place all output" -#: builders/html/__init__.py:818 -#, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "cannot copy downloadable file %r: %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "maximum depth of submodules to show in the TOC (default: 4)" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "overwrite existing files" -#: builders/html/__init__.py:882 -#, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "Failed to copy a file in html_static_file: %s: %r" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "follow symbolic links. Powerful when combined with collective.recipe.omelette." -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "copying static files" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "run the script without creating files" -#: builders/html/__init__.py:934 -#, python-format -msgid "cannot copy static file %r" -msgstr "cannot copy static file %r" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "put documentation for each module on its own page" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "copying extra files" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "include \"_private\" modules" -#: builders/html/__init__.py:949 -#, python-format -msgid "cannot copy extra file %r" -msgstr "cannot copy extra file %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "filename of table of contents (default: modules)" -#: builders/html/__init__.py:955 -#, python-format -msgid "Failed to write build info file: %r" -msgstr "Failed to write build info file: %r" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "don't create a table of contents file" -#: builders/html/__init__.py:1005 +#: ext/apidoc/_cli.py:135 msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "search index couldn't be loaded, but not all documents will be built: the index will be incomplete." +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "don't create headings for the module/package packages (e.g. when the docstrings already contain them)" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "page %s matches two patterns in html_sidebars: %r and %r" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "put module documentation before submodule documentation" -#: builders/html/__init__.py:1216 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "interpret module paths according to PEP-0420 implicit namespaces specification" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "An error happened in rendering the page %s.\nReason: %r" - -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "dumping object inventory" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "dumping search index in %s" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "file suffix (default: rst)" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "generate a full project with sphinx-quickstart" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "append module_path to sys.path, used when --full is given" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "project name (default: root module name)" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "project author(s), used when --full is given" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "project version, used when --full is given" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" -msgstr "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "project release, used when --full is given, defaults to --doc-version" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "logo file %r does not exist" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "extension options" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" -msgstr "favicon file %r does not exist" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in configuration options)" - -#: builders/html/__init__.py:1449 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "%s %s documentation" -msgstr "%s %s documentation" +msgid "%s is not a directory." +msgstr "%s is not a directory." -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "The LaTeX files are in %(outdir)s." - -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nRun 'make' in that directory to run these through (pdf)latex\n(use `make latexpdf' here to do that automatically)." - -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "no \"latex_documents\" config value found; no documents will be written" +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "\"latex_documents\" config value references unknown document %s" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Release" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "copying TeX support files" - -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "copying additional files" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "Unknown theme option: latex_theme_options[%r], ignored." - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" -msgstr "Failed to get a docname!" +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "No footnote was found for given reference node %r" -msgstr "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r doesn't have \"%s\" setting" - -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "continued from previous page" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "continues on next page" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "Non-alphabetical" - -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Numbers" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "autosummary: failed to determine %r to be documented, the following exception was raised:\n%s" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] generating autosummary for: %s" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" +msgstr "[autosummary] writing to %s" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "[autosummary] failed to import %s.\nPossible hints:\n%s" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nGenerate ReStructuredText using autosummary directives.\n\nsphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\nthe reStructuredText files from the autosummary directives contained in the\ngiven input files.\n\nThe format of the autosummary directive is documented in the\n``sphinx.ext.autosummary`` Python module and can be read using::\n\n pydoc sphinx.ext.autosummary\n" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "source files to generate rST files for" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "directory to place all output in" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "default suffix for files (default: %(default)s)" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "custom template directory (default: %(default)s)" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "document imported members (default: %(default)s)" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "document exactly the members in module __all__ attribute. (default: %(default)s)" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "autosummary references excluded document %r. Ignored." -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: stub file not found %r. Check your autosummary_generate setting." -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "A captioned autosummary requires :toctree: option. ignored." -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3668,548 +3721,585 @@ msgid "" "%s" msgstr "autosummary: failed to import %s.\nPossible hints:\n%s" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "failed to parse name %s" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "failed to import object %s" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: file not found: %s" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "autosummary: failed to determine %r to be documented, the following exception was raised:\n%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "[autosummary] failed to import %s.\nPossible hints:\n%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nGenerate ReStructuredText using autosummary directives.\n\nsphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\nthe reStructuredText files from the autosummary directives contained in the\ngiven input files.\n\nThe format of the autosummary directive is documented in the\n``sphinx.ext.autosummary`` Python module and can be read using::\n\n pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "" + +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" + +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "" + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "source files to generate rST files for" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "directory to place all output in" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "encountered some issues with some of the inventories, but they had working alternatives:" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:332 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "default suffix for files (default: %(default)s)" +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "custom template directory (default: %(default)s)" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "intersphinx inventory has moved: %s -> %s" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "document imported members (default: %(default)s)" +msgid "(in %s %s)" +msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "document exactly the members in module __all__ attribute. (default: %(default)s)" +msgid "(in %s)" +msgstr "(in %s)" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Failed to remove %s: %s" +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nLook recursively in for Python modules and packages and create\none reST file with automodule directives per package in the .\n\nThe s can be file and/or directory patterns that will be\nexcluded from generation.\n\nNote: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "path to module to document" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "directory to place all output" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "external %s:%s reference target not found: %s" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "error while formatting signature for %s: %s" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "overwrite existing files" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "follow symbolic links. Powerful when combined with collective.recipe.omelette." +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "Failed to get a function signature for %s: %s" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "run the script without creating files" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "Failed to update signature for %r: parameter not found: %s" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "Failed to parse type_comment for %r: %s" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "include \"_private\" modules" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "Invalid __slots__ found on %s. Ignored." -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "error while formatting arguments for %s: %s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "don't create a table of contents file" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "Failed to get a constructor signature for %s: %s" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "don't create headings for the module/package packages (e.g. when the docstrings already contain them)" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "Failed to get a method signature for %s: %s" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "interpret module paths according to PEP-0420 implicit namespaces specification" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "Failed to parse a default argument value for %r: %s" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "file suffix (default: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n%s" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "signature arguments or return annotation given for automodule %s" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "project name (default: root module name)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "missing attribute mentioned in :members: option: module %s, attribute %s" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "project author(s), used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "missing attribute %s in object %s" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "project version, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "alias of TypeVar(%s)" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "project release, used when --full is given, defaults to --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "extension options" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "The HTML pages are in %(outdir)s." -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." -msgstr "%s is not a directory." +msgid "Failed to read build info file: %r" +msgstr "Failed to read build info file: %r" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" -msgstr "" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "index" -#: ext/apidoc/_extension.py:121 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "next" -#: ext/apidoc/_extension.py:140 -#, python-format -msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "previous" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "generating indices" -#: ext/apidoc/_extension.py:157 -#, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" -msgstr "" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "writing additional pages" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:192 -#, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "copying downloadable files... " -#: ext/apidoc/_extension.py:210 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "cannot copy downloadable file %r: %s" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "Failed to copy a file in html_static_file: %s: %r" -#: ext/apidoc/_generate.py:69 -#, python-format -msgid "Would create file %s." -msgstr "Would create file %s." +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "copying static files" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:923 #, python-format -msgid "(in %s v%s)" -msgstr "(in %s v%s)" +msgid "cannot copy static file %r" +msgstr "cannot copy static file %r" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" -msgstr "(in %s)" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "copying extra files" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:938 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "" +msgid "cannot copy extra file %r" +msgstr "cannot copy extra file %r" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:944 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "" +msgid "Failed to write build info file: %r" +msgstr "Failed to write build info file: %r" + +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "search index couldn't be loaded, but not all documents will be built: the index will be incomplete." -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "page %s matches two patterns in html_sidebars: %r and %r" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1204 #, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings." -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:1217 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1225 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "external %s:%s reference target not found: %s" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "An error happened in rendering the page %s.\nReason: %r" + +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "dumping object inventory" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1266 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "dumping search index in %s" +msgstr "dumping search index in %s" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +msgid "invalid js_file: %r, ignored" +msgstr "invalid js_file: %r, ignored" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Many math_renderers are registered. But no math_renderer is selected." -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "Unknown math_renderer %r is given." +msgstr "Unknown math_renderer %r is given." -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "html_extra_path entry %r is placed inside outdir" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "html_extra_path entry %r does not exist" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "html_static_path entry %r is placed inside outdir" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" +msgstr "html_static_path entry %r does not exist" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" +msgid "logo file %r does not exist" +msgstr "logo file %r does not exist" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "favicon file %r does not exist" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "encountered some issues with some of the inventories, but they had working alternatives:" - -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "failed to reach any of the inventories with the following issues:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in configuration options)" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "intersphinx inventory has moved: %s -> %s" +msgid "%s %s documentation" +msgstr "%s %s documentation" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "invalid value for member-order option: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r doesn't have \"theme\" setting" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "invalid value for class-doc-from option: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r doesn't have \"%s\" setting" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "invalid signature for auto%s (%r)" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "Failed to get a docname!" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "error while formatting arguments for %s: %s" +msgid "Failed to get a docname for source %r!" +msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n%s" +msgid "No footnote was found for given reference node %r" +msgstr "No footnote was found for given reference node %r" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "The LaTeX files are in %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "don't know which module to import for autodocumenting %r (try placing a \"module\" or \"currentmodule\" directive in the document, or giving an explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nRun 'make' in that directory to run these through (pdf)latex\n(use `make latexpdf' here to do that automatically)." -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" -msgstr "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "no \"latex_documents\" config value found; no documents will be written" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "\"latex_documents\" config value references unknown document %s" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "copying TeX support files" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "copying additional files" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Unknown configure key: latex_elements[%r], ignored." -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "Unknown theme option: latex_theme_options[%r], ignored." -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s is already assigned section numbers (nested numbered toctree?)" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" +msgstr "image file not readable: %s" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" -msgstr "Bases: %s" +msgid "image file %s not readable: %s" +msgstr "image file %s not readable: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" -msgstr "missing attribute %s in object %s" +msgid "download file not readable: %s" +msgstr "download file not readable: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" -msgstr "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "circular toctree references detected, ignoring: %s <- %s" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "toctree contains reference to document %r that doesn't have a title: no link will be generated" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "toctree contains reference to non-included document %r" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" +msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "Failed to parse a default argument value for %r: %s" +msgid "see %s" +msgstr "see %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" +msgstr "see also %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" +msgstr "unknown index entry type %r" diff --git a/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo b/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo index 8898472d6f4..837c1f26c9b 100644 Binary files a/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo and b/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po b/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po index 0b6990defe6..29d3ce5b55a 100644 --- a/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: English (Hong Kong) (http://app.transifex.com/sphinx-doc/sphinx-1/language/en_HK/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: en_HK\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2804,21 +2945,20 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2827,6 +2967,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2848,119 +2993,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2972,92 +3124,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3085,581 +3230,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3667,548 +3720,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/eo/LC_MESSAGES/sphinx.mo b/sphinx/locale/eo/LC_MESSAGES/sphinx.mo index 44999ce8fa4..fe3b1d04f9d 100644 Binary files a/sphinx/locale/eo/LC_MESSAGES/sphinx.mo and b/sphinx/locale/eo/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/eo/LC_MESSAGES/sphinx.po b/sphinx/locale/eo/LC_MESSAGES/sphinx.po index 7babeec23ea..e9ed584be18 100644 --- a/sphinx/locale/eo/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/eo/LC_MESSAGES/sphinx.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Tatsuro YOKOTA , 2021\n" "Language-Team: Esperanto (http://app.transifex.com/sphinx-doc/sphinx-1/language/eo/)\n" @@ -20,6 +20,127 @@ msgstr "" "Language: eo\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -34,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Ne povas trovi fontan dosierujon (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +310,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +323,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,473 +538,629 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Eraro" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:197 +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Averto" + +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" +msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" msgstr "" #: ext/coverage.py:140 ext/coverage.py:301 @@ -740,9 +1176,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -777,6 +1214,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -864,947 +1329,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "inline latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:231 +#: ext/doctest.py:297 #, python-format -msgid "Include file '%s' not found or reading it failed" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:451 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:568 #, python-format -msgid "Object named %r not found in include file %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/code.py:314 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/patches.py:71 +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" + +#: ext/duration.py:117 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:124 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:139 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:203 -msgid "Section author: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: directives/other.py:209 -msgid "Author: " -msgstr "Aŭtoro:" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:75 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:56 +#: domains/citation.py:92 #, python-format -msgid "no changes in version %s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/changes.py:133 +#: domains/javascript.py:186 #, python-format -msgid "could not read %r for changelog creation" +msgid "%s() (class)" +msgstr "%s() (klaso)" + +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" msgstr "" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "%s (%s attribute)" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funkcio" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klaso" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "datenoj" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atributo" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:275 +#: domains/javascript.py:458 #, python-format -msgid "all of %d po files" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are specified" +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:309 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are out of date" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:361 +#: domains/rst.py:262 #, python-format -msgid "%d source files given on command line" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:377 +#: domains/changeset.py:32 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/changeset.py:33 #, python-format -msgid "building [%s]: " +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:410 +#: domains/changeset.py:35 #, python-format -msgid "%d found" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:412 -msgid "none found" -msgstr "" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:109 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:558 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "" - -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "" - -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/texinfo.py:89 +#: cmd/build.py:357 #, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:134 #, python-format -msgid "unknown mimetype for %s, ignoring" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:794 +#: cmd/quickstart.py:230 #, python-format -msgid "writing %s file..." -msgstr "" - -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/gettext.py:266 +#: cmd/quickstart.py:242 #, python-format -msgid "targets for %d template files" -msgstr "" - -#: builders/gettext.py:271 -msgid "reading templates... " +msgid "Selected root path: %s" msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:298 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:309 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:324 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:397 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: util/i18n.py:245 +#: cmd/quickstart.py:671 #, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +msgid "enable %s extension" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/rst.py:73 +#: cmd/quickstart.py:810 #, python-format -msgid "default role %s not found" +msgid "Invalid template variable: %s" msgstr "" -#: util/inventory.py:147 +#: directives/other.py:119 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/inventory.py:166 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/other.py:169 #, python-format -msgid "[image: %s]" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:205 +msgid "Module author: " +msgstr "" + +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/other.py:209 +msgid "Author: " +msgstr "Aŭtoro:" + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1833,6 +2344,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1849,793 +2365,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (klaso)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funkcio" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klaso" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "datenoj" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atributo" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "" - -#: domains/rst.py:234 -msgid "directive" -msgstr "" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:236 -msgid "role" -msgstr "" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "" - -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Eraro" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Averto" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:273 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:286 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:297 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:308 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:323 +#: transforms/__init__.py:258 +#, python-format msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:367 +#: util/i18n.py:100 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:396 +#: util/i18n.py:253 +#, python-format msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:406 +#: util/osutil.py:131 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: util/docutils.py:325 #, python-format -msgid "Creating file %s." +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: util/docutils.py:361 #, python-format -msgid "File %s already exists, skipping." -msgstr "" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:519 +#: util/docutils.py:805 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "" - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:530 +#: util/fileutil.py:76 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:572 +#: util/docfields.py:103 +#, python-format msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:670 +#: util/rst.py:73 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:792 +#: util/nodes.py:462 +#, python-format msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:809 +#: util/nodes.py:523 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Simboloj" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:157 +#: transforms/post_transforms/__init__.py:88 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Aŭtora rajto" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:357 +#: themes/basic/layout.html:201 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Antaŭa temo" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "antaŭa ĉapitro" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Sekva temo" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "sekvo ĉapitro" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2683,7 +2883,7 @@ msgstr "Universala modjulindico" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Indico universala" @@ -2691,22 +2891,14 @@ msgstr "Indico universala" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2714,58 +2906,7 @@ msgid "Index pages by letter" msgstr "" #: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "" - -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Antaŭa temo" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "antaŭa ĉapitro" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Sekva temo" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "sekvo ĉapitro" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Aŭtora rajto" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +msgid "can be huge" msgstr "" #: themes/basic/search.html:20 @@ -2784,21 +2925,21 @@ msgstr "" msgid "search" msgstr "serĉu" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2806,21 +2947,20 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2829,6 +2969,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2850,119 +2995,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametroj" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "escepto" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametroj" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2974,746 +3126,526 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "membro" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tipo" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "" - -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "nomaĵo" - -#: domains/c/__init__.py:753 -msgid "struct" -msgstr "" - -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "" - -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "vidu %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "vidu ankaŭ %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Simboloj" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/c/__init__.py:778 +msgid "variable" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "nomaĵo" + +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "environment variable; %s" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:116 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "%s; configuration value" msgstr "" -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:239 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:319 #, python-format -msgid "Unknown image format: %s..." +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "indico" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "sekva" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "antaŭa" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1153 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy static file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Failed to write build info file: %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Avertoj" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "%s %s dokumentaro" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "" + +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "" + +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "" - -#: ext/napoleon/docstring.py:895 -msgid "Example" +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Avertoj" - -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3721,7 +3653,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3736,481 +3668,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "%s is not a directory." +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:256 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "indico" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "sekva" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "antaŭa" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s dokumentaro" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "vidu %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "vidu ankaŭ %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/es/LC_MESSAGES/sphinx.mo b/sphinx/locale/es/LC_MESSAGES/sphinx.mo index b757652751f..8bc422bcdd2 100644 Binary files a/sphinx/locale/es/LC_MESSAGES/sphinx.mo and b/sphinx/locale/es/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/es/LC_MESSAGES/sphinx.po b/sphinx/locale/es/LC_MESSAGES/sphinx.po index 24ea0cd0247..13e88cea007 100644 --- a/sphinx/locale/es/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/es/LC_MESSAGES/sphinx.po @@ -16,7 +16,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Adam Turner, 2023\n" "Language-Team: Spanish (http://app.transifex.com/sphinx-doc/sphinx-1/language/es/)\n" @@ -27,6 +27,127 @@ msgstr "" "Language: es\n" "Plural-Forms: nplurals=3; plural=n == 1 ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "número de PEP inválido %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "número RFC inválido %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "configuración de %s.%s se produce en ninguna de las configuraciones de tema buscado" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "opción de tema no soportada %r fue dada" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "archivo %r o ruta del tema no es un archivo zip válido o no contiene ningún tema" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -41,127 +162,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Este proyecto necesita la extensión %s por lo menos en la versión %s y por lo tanto no puede ser construido con la versión cargada (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "El nombre del lexer de pigmentos %r se desconoce" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Evento %r ya presente" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Nombre de evento desconocido: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "Manipulador %r para el evento %r lanzó una excepción" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "No se encuentra directorio fuente (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Directorio de salida (%s) no es un directorio" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Directorio fuente y directorio destino no pueden ser idénticos" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Ejecutando Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Este proyecto necesita al menos Sphinx v%s y por lo tanto no se puede construir con esta versión." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "creando directorio de salida" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "mientras configura la extensión %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' como se define actualmente en el archivo conf.py no es un Python invocable. Por favor, modifique su definición para que sea una función invocable. Esto es necesario para que el archivo conf.py se comporte como una extensión de Sphinx." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "cargando traducciones [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "hecho" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "no disponible para mensajes incorporados" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "cargando el ambiente pickled" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "fallo: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Ningún constructor seleccionado, utilizando el valor predeterminado: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "la clase de nodo %r ya está registrada, sus visitantes serán reemplazados" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -169,12 +317,12 @@ msgid "" "explicit" msgstr "la extensión de %s no declara si es seguro para la lectura en paralelo, asumiendo que no es - consulte con el autor de la extensión para comprobar y hacer explícito" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "la extensión %s no es segura para lectura paralela" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -182,82 +330,214 @@ msgid "" "explicit" msgstr "la extensión %s no declara si es seguro para la escritura paralela, suponiendo que no lo sea - solicite al autor de la extensión que lo verifique y haga explicito" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "la extensión %s no es segura para escritura paralela" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "realizando serialmente %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "directorio de configuración no contiene un archivo conf.py (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Constructor clase %s no tiene ningún atributo \"name\"" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Constructor %r ya existe (en el módulo %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Nombre de constructor %s no registrados o disponibles a través del punto de entrada" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Nombre de constructor %s no registrado" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "dominio %s ya esta registrado" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "dominio %s no esta registrado" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "La directiva %r ya fue registrada en el dominio %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "El rol %r ya fue registrado en el dominio %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "El índice %r ya fue registrado en el dominio %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "El %r object_type ya está registrado" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "El %r crossref_type ya está registrado" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r ya está registrado" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser para %r ya está registrado" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Analizador de fuentes para %s no registrado" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "Traductor para %r ya existe" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "kwargs para la función add_node() debe ser una tupla de función (visitar, salir): %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r ya esta registrado" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "el renderizador matemático %s ya está registrado" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "Se encontró un valor de configuración no válido: 'language = None'. Actualice su configuración a un código de idioma válido. Volviendo a definir 'en' (Inglés)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "la extensión %r ya se fusionó con Sphinx desde la versión %s; esta extensión se omite." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Excepción original:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "No puede importar la extensión %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "extensión %r no tiene ninguna función setup(); ¿es realmente un módulo de extensión de Sphinx?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "La extensión %s utilizada por este proyecto necesita al menos la versión de Sphinx v%s; por lo tanto no puede ser construido con esta versión." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "extensión %r devuelve un objeto no soportado de su función setup(); debe devolver un diccionario de metadatos o ninguno" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "directorio de configuración no contiene un archivo conf.py (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "no se puede reemplazar el ajuste de la configuración del diccionario %r, haciendo caso omiso (utilice %r para definir elementos individuales)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "número no válido %r de valor de configuración %r, haciendo caso omiso" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "no se puede reemplazar los ajustes de configuración %r con tipo no compatible, haciendo caso omiso" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "valor de configuración desconocido %r en anulación, ignorando" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Valor de configuración %r ya presente" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "Se encontró un valor de configuración no válido: 'language = None'. Actualice su configuración a un código de idioma válido. Volviendo a definir 'en' (Inglés)." + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Hay un error de sintaxis en su archivo de configuración: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "El archivo de configuración (o uno de los módulos que importa) invocó sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -265,547 +545,732 @@ msgid "" "%s" msgstr "Hay un error programable en su archivo de configuración:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Sección %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Figura %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabla %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Lista %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "El valor de configuración `{name}` tiene que ser uno de {candidates}, pero fue dado `{current}`." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "El valor de configuración `{name}' tiene tipo `{current.__name__}'; esperado {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "El valor de configuración `{name}' tiene el tipo `{current.__name__}', el valor predeterminado es `{default.__name__}'." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r no fue encontrado, se ignora." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "El nombre del lexer de pigmentos %r se desconoce" - -#: highlighting.py:209 -#, python-format +#: config.py:892 msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "nueva configuración" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "configuración de %s.%s se produce en ninguna de las configuraciones de tema buscado" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "configuración modificada" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "opción de tema no soportada %r fue dada" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "extensiones modificadas" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "archivo %r o ruta del tema no es un archivo zip válido o no contiene ningún tema" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "la versión del entorno de compilación no es actual" -#: theming.py:228 -#, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "directorio fuente ha cambiado" -#: theming.py:268 +#: environment/__init__.py:350 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:355 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:282 +#: environment/__init__.py:361 #, python-format -msgid "The %r theme has too many ancestors" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:310 -#, python-format -msgid "no theme configuration file found in %r" -msgstr "" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Este entorno es incompatible con el generador seleccionado, elija otro directorio doctree." -#: theming.py:335 theming.py:388 +#: environment/__init__.py:518 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +msgid "Failed to scan documents in %s: %r" +msgstr "Error al escanear los documentos en %s: %r" -#: theming.py:339 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +msgid "Domain %r is not registered" +msgstr "Dominio %r no está registrado" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "documento no está incluido en ningún toctree" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "toctree auto referenciado encontrado. Ignorado." -#: theming.py:366 +#: environment/__init__.py:952 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Evento %r ya presente" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Atención" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Nombre de evento desconocido: %s" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Prudencia" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "Manipulador %r para el evento %r lanzó una excepción" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Peligro" -#: project.py:72 +#: locale/__init__.py:232 +msgid "Error" +msgstr "Error" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Consejo" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Importante" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Nota" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Ver también" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Truco" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Advertencia" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Los archivos Texinfo están en %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nEjecute el comando 'make' en ese directorio para ejecutarlos a través de makeinfo\n(usa el comando 'make info' aquí para hacer esto automáticamente)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "no se encontró el valor de configuración \"texinfo_documents\"; no se escribirán documentos" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Constructor clase %s no tiene ningún atributo \"name\"" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "El valor de configuración \"texinfo_documents\" hace referencia a un documento desconocido %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Constructor %r ya existe (en el módulo %s)" +msgid "processing %s" +msgstr "procesando %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Nombre de constructor %s no registrados o disponibles a través del punto de entrada" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "escribiendo" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Nombre de constructor %s no registrado" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "resolviendo referencias..." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "dominio %s ya esta registrado" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (en " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "dominio %s no esta registrado" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "copiando imágenes... " -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "La directiva %r ya fue registrada en el dominio %s" +msgid "cannot copy image file %r: %s" +msgstr "no se puede copiar archivo de imagen %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "El rol %r ya fue registrado en el dominio %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "copiando archivos de soporte Texinfo" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "El índice %r ya fue registrado en el dominio %s" +msgid "error writing file Makefile: %s" +msgstr "error escribiendo archivo Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "El %r object_type ya está registrado" +msgid "The manual pages are in %(outdir)s." +msgstr "Las páginas del manual están en %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "El %r crossref_type ya está registrado" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "no se encontró el valor de configuración \"man_pages\"; no se escribirán las páginas del manual" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r ya está registrado" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "El valor de configuración \"man_pages\" hace referencia a un documento desconocido %s" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser para %r ya está registrado" +msgid "The HTML page is in %(outdir)s." +msgstr "Página HTML está en %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "Analizador de fuentes para %s no registrado" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "ensamblando documento sencillo" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "Traductor para %r ya existe" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "escribiendo archivos adicionales" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "kwargs para la función add_node() debe ser una tupla de función (visitar, salir): %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "El constructor ficticio no genera archivos." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r ya esta registrado" +msgid "The message catalogs are in %(outdir)s." +msgstr "Los catálogos de mensajes están en %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "el renderizador matemático %s ya está registrado" +msgid "building [%s]: " +msgstr "compilando [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "la extensión %r ya se fusionó con Sphinx desde la versión %s; esta extensión se omite." +msgid "targets for %d template files" +msgstr "objetivos para los archivos de plantillas %d" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Excepción original:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "leyendo plantillas... " -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "No puede importar la extensión %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "escribiendo catálogos de mensajes... " -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "extensión %r no tiene ninguna función setup(); ¿es realmente un módulo de extensión de Sphinx?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Busque cualquier error en la salida anterior o en el archivo %(outdir)s/output.txt" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "La extensión %s utilizada por este proyecto necesita al menos la versión de Sphinx v%s; por lo tanto no puede ser construido con esta versión." +msgid "broken link: %s (%s)" +msgstr "enlace roto: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "extensión %r devuelve un objeto no soportado de su función setup(); debe devolver un diccionario de metadatos o ninguno" +msgid "Anchor '%s' not found" +msgstr "Ancla '%s' no encontrado" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" -msgstr "" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "Error al compilar expresiones regulares en linkcheck_allowed_redirects: %r %s" -#: roles.py:251 +#: builders/epub3.py:83 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +msgid "The ePub file is in %(outdir)s." +msgstr "El archivo ePub está en %(outdir)s." -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" -msgstr "" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "escribiendo el archivo nav.xhtml..." -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "el valor de configuración \"epub_language\" (o \"language\") no debe estar vacío para EPUB3" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" -msgstr "número de PEP inválido %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "el valor de configuración \"epub_uid\" debe ser XML NAME para EPUB3" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" -msgstr "número RFC inválido %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "el valor de configuración \"epub_title\" (or \"html_title\") no debe estar vacío para EPUB3" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[fuente]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "el valor de configuración \"epub_author\" no debe estar vacío para EPUB3" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "resaltando el código del módulo... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "el valor de configuración \"epub_contributor\" no debe estar vacío para EPUB3" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[documentos]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "el valor de configuración \"epub_description\" no debe estar vacío para EPUB3" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Código de módulo" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "el valor de configuración \"epub_publisher\" no debe estar vacío para EPUB3" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Código fuente para %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "el valor de configuración \"epub_copyright\" (or \"copyright\") no debe estar vacío para EPUB3" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Resumen: código de modulo" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "el valor de configuración \"epub_identifier\" no debe estar vacío para EPUB3" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Todos los módulos para los cuales disponen código

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "el valor de configuración \"version\" no debe estar vacío para EPUB3" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "enlace codificado %r podría reemplazarse por un enlace externo (intente usar %r en su lugar)" +msgid "invalid css_file: %r, ignored" +msgstr "css_file inválido: %r, ignorado" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "" +msgid "The XML files are in %(outdir)s." +msgstr "Los archivos XML están en %(outdir)s." -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "etiqueta duplicada %s, otra instancia en %s" - -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "" +msgid "error writing file %s: %s" +msgstr "error escribiendo archivo %s: %s" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "====================== duraciones de lectura más lentas =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Los archivos pseudo-XML están en %(outdir)s." -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "falta '+' o '-' en la opción '%s'." +msgid "duplicated ToC entry found: %s" +msgstr "entrada de tabla de contenido duplicada encontrada: %s" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' no es una opción válida." +msgid "cannot read image file %r: copying it instead" +msgstr "no puede leer el archivo de imagen %r: en su lugar, lo copia" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' no es una opción pyversion válida" +msgid "cannot write image file %r: %s" +msgstr "no se puede escribir archivo de imagen %r: %s" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "tipo de TestCode inválido" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow no encontrada - copiando archivos de imágenes" -#: ext/doctest.py:297 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Prueba de doctests en las fuentes terminadas, mira los resultados en %(outdir)s/output.txt." +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "escribiendo el archivo mimetype..." + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "escribiendo el archivo META-INF/container.xml..." + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "escribiendo el archivo content.opf..." -#: ext/doctest.py:457 +#: builders/_epub_base.py:594 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "sin código/salida en el bloque %s en %s:%s" +msgid "unknown mimetype for %s, ignoring" +msgstr "mimetype desconocido para %s, ignorando" -#: ext/doctest.py:568 +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "escribiendo el archivo toc.ncx..." + +#: builders/_epub_base.py:802 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "ignorando el código doctest no válido: %r" +msgid "writing %s file..." +msgstr "escribiendo archivo %s..." -#: ext/imgmath.py:162 +#: builders/text.py:27 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "comando LaTeX %r no se puede ejecutar (necesario para la visualización matemática), compruebe la configuración de imgmath_latex" +msgid "The text files are in %(outdir)s." +msgstr "Los archivos de texto están en %(outdir)s." -#: ext/imgmath.py:181 +#: builders/__init__.py:229 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "comando %s %r no se puede ejecutar (necesario para la visualización matemática), verifique la configuración imgmath_%s" +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "una imagen adecuada para %s constructor no encontrado: %s (%s)" -#: ext/imgmath.py:344 +#: builders/__init__.py:237 #, python-format -msgid "display latex %r: %s" -msgstr "visualizar latex %r: %s" +msgid "a suitable image for %s builder not found: %s" +msgstr "una imagen adecuada para %s constructor no encontrado: %s" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "compilando [mo]: " + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "escribiendo salida... " -#: ext/imgmath.py:380 +#: builders/__init__.py:280 #, python-format -msgid "inline latex %r: %s" -msgstr "en línea latex %r: %s" +msgid "all of %d po files" +msgstr "todos los %d archivos po" -#: ext/coverage.py:48 +#: builders/__init__.py:302 #, python-format -msgid "invalid regex %r in %s" -msgstr "expresiones regulares inválidas %r en %s" +msgid "targets for %d po files that are specified" +msgstr "los objetivos para %d los archivos po que se especifican" -#: ext/coverage.py:140 ext/coverage.py:301 +#: builders/__init__.py:314 #, python-format -msgid "module %s could not be imported: %s" -msgstr "el módulo %s no podía ser importado: %s" +msgid "targets for %d po files that are out of date" +msgstr "los objetivos para %d los archivos po que estan desactualizados" -#: ext/coverage.py:148 +#: builders/__init__.py:324 +msgid "all source files" +msgstr "todos los archivos fuente" + +#: builders/__init__.py:335 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/coverage.py:158 +#: builders/__init__.py:342 +#, python-format msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" -msgstr "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "archivo %r dado en la línea de comandos no está en el directorio fuente, ignorado" -#: ext/coverage.py:172 -#, python-brace-format, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/coverage.py:187 +#: builders/__init__.py:366 #, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "expresiones regulares inválidas %r en coverage_c_regexes" +msgid "%d source files given on command line" +msgstr "%d archivos fuente dados en la línea de comandos" -#: ext/coverage.py:260 +#: builders/__init__.py:382 #, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "api c indocumentado: %s [%s] en archivo %s" +msgid "targets for %d source files that are out of date" +msgstr "los objetivos para %d los archivos fuentes que estan desactualizados" -#: ext/coverage.py:452 -#, python-format -msgid "undocumented python function: %s :: %s" -msgstr "función python indocumentada: %s :: %s" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "buscando por archivos no actualizados... " -#: ext/coverage.py:473 +#: builders/__init__.py:415 #, python-format -msgid "undocumented python class: %s :: %s" -msgstr "clase python indocumentada: %s :: %s" +msgid "%d found" +msgstr "%d encontrado" -#: ext/coverage.py:492 +#: builders/__init__.py:417 +msgid "none found" +msgstr "no encontrado" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "preparando ambiente" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "verificando consistencia" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "no hay archivos objetivo desactualizados." + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "actualizando ambiente: " + +#: builders/__init__.py:499 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "método python indocumentado: %s :: %s :: %s" +msgid "%s added, %s changed, %s removed" +msgstr "%sañadido, %s cambiado, %s removido" -#: ext/imgconverter.py:44 +#: builders/__init__.py:536 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "No se puede ejecutar el comando de conversión de imagen %r. 'sphinx.ext.imgconverter' requiere ImageMagick por defecto. Asegúrese de que esté instalado o configure la opción 'image_converter' a un comando de conversión personalizado.\n\nRastrear: %s" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: builders/__init__.py:545 #, python-format msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "convert salió con error:\n[stderr]\n%r\n[stdout]\n%r" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" -#: ext/imgconverter.py:83 +#: builders/__init__.py:556 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "el comando convert %r no puede ejecutar, compruebe el valor de configuración image_converter" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "leyendo fuentes... " + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "docnames para escribir: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "preparando documentos" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "El archivo de resumen está en %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "no hay cambios en versión %s." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "escribiendo archivo de resumen..." + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Funciones incorporadas" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Nivel de módulo" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "copiando archivos fuente..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "no se pudo leer %r for para la creación del registro de cambios" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "expresiones regulares inválidas %r en %s" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "el módulo %s no podía ser importado: %s" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "" + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "expresiones regulares inválidas %r en coverage_c_regexes" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "api c indocumentado: %s [%s] en archivo %s" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "función python indocumentada: %s :: %s" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "clase python indocumentada: %s :: %s" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "método python indocumentado: %s :: %s :: %s" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "enlace codificado %r podría reemplazarse por un enlace externo (intente usar %r en su lugar)" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Por hacer" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "Marca TODO encontrada: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(La <> se encuentra en %s, línea %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "entrada original" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "No se puede ejecutar el comando de conversión de imagen %r. 'sphinx.ext.imgconverter' requiere ImageMagick por defecto. Asegúrese de que esté instalado o configure la opción 'image_converter' a un comando de conversión personalizado.\n\nRastrear: %s" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "convert salió con error:\n[stderr]\n%r\n[stdout]\n%r" + +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" +msgstr "el comando convert %r no puede ejecutar, compruebe el valor de configuración image_converter" #: ext/graphviz.py:138 msgid "Graphviz directive cannot have both content and a filename argument" @@ -871,1780 +1336,1515 @@ msgstr "[gráfica: %s]" msgid "[graph]" msgstr "[gráfica]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Por hacer" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "comando LaTeX %r no se puede ejecutar (necesario para la visualización matemática), compruebe la configuración de imgmath_latex" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" -msgstr "Marca TODO encontrada: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "comando %s %r no se puede ejecutar (necesario para la visualización matemática), verifique la configuración imgmath_%s" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "visualizar latex %r: %s" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(La <> se encuentra en %s, línea %d.)" +msgid "inline latex %r: %s" +msgstr "en línea latex %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "entrada original" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "no espacios en blanco eliminados por identado" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "falta '+' o '-' en la opción '%s'." -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" -msgstr "Subtítulo inválido: %s" +msgid "'%s' is not a valid option." +msgstr "'%s' no es una opción válida." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "la especificación del número de línea está fuera de range(1-%d): %r" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' no es una opción pyversion válida" -#: directives/code.py:216 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "tipo de TestCode inválido" + +#: ext/doctest.py:297 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "No puede utilizar ambas opciones \"%s\" y \"%s\"" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Prueba de doctests en las fuentes terminadas, mira los resultados en %(outdir)s/output.txt." -#: directives/code.py:231 +#: ext/doctest.py:451 #, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "" +msgid "no code/output in %s block at %s:%s" +msgstr "sin código/salida en el bloque %s en %s:%s" -#: directives/code.py:235 +#: ext/doctest.py:568 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +msgid "ignoring invalid doctest code: %r" +msgstr "ignorando el código doctest no válido: %r" -#: directives/code.py:276 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "Objeto nombrado %r no encontrado en el archivo incluido %r" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "No puede utilizar a \"lineno-match\" con un conjunto desunido de \"líneas\"" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "etiqueta duplicada %s, otra instancia en %s" -#: directives/code.py:314 +#: ext/duration.py:47 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Línea especifico %r: sin líneas tiradas desde el archivo incluido %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" -#: directives/patches.py:71 +#: ext/duration.py:117 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "\":file:\" La opción para la directiva csv-table ahora reconoce una ruta absoluta como una ruta relativa desde el directorio de origen. Actualice su documento." +"====================== total reading duration ==========================" +msgstr "" -#: directives/other.py:119 +#: ext/duration.py:124 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "patrón global toctree %r no coincide con ningún documento" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "toctree contiene referencia al documento excluido %r" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "====================== duraciones de lectura más lentas =======================" -#: directives/other.py:156 +#: ext/duration.py:139 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "toctree contiene referencias a documentos inexistentes %r" +msgid "%.3fs %s" +msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "entrada duplicada encontrada en toctree: %s" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[fuente]" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autor de la sección: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "resaltando el código del módulo... " -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autor del módulo: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[documentos]" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Código del autor: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Código de módulo" -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor: " +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Código fuente para %s

        " -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr ".. contenido de los reconocimientos no es una lista" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Resumen: código de modulo" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr ".. hlist contenido no es una lista" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Todos los módulos para los cuales disponen código

        " -#: builders/changes.py:29 +#: domains/citation.py:75 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "El archivo de resumen está en %(outdir)s." +msgid "duplicate citation %s, other instance in %s" +msgstr "citación duplicada %s, otra instancia en %s" -#: builders/changes.py:56 +#: domains/citation.py:92 #, python-format -msgid "no changes in version %s." -msgstr "no hay cambios en versión %s." - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "escribiendo archivo de resumen..." - -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Funciones incorporadas" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "Nivel de módulo" - -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "copiando archivos fuente..." +msgid "Citation [%s] is not referenced." +msgstr "Citación [%s] no está referenciada." -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" -msgstr "no se pudo leer %r for para la creación del registro de cambios" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "etiqueta duplicada de la ecuación %s, otra instancia en %s" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Las páginas del manual están en %(outdir)s." +msgid "Invalid math_eqref_format: %r" +msgstr "No válido math_eqref_format: %r" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "no se encontró el valor de configuración \"man_pages\"; no se escribirán las páginas del manual" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (función incorporada)" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "escribiendo" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (método de %s)" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "El valor de configuración \"man_pages\" hace referencia a un documento desconocido %s" +msgid "%s() (class)" +msgstr "%s() (clase)" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "una imagen adecuada para %s constructor no encontrado: %s (%s)" +msgid "%s (global variable or constant)" +msgstr "%s (variable global o constante)" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "una imagen adecuada para %s constructor no encontrado: %s" +msgid "%s (%s attribute)" +msgstr "%s (atributo de %s)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "compilando [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumentos" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "escribiendo salida... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Lanzamientos" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" -msgstr "todos los %d archivos po" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Devuelve" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" -msgstr "los objetivos para %d los archivos po que se especifican" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Tipo del valor devuelto" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "los objetivos para %d los archivos po que estan desactualizados" +msgid "%s (module)" +msgstr "%s (módulo)" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "todos los archivos fuente" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "función" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "método" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "archivo %r dado en la línea de comandos no está en el directorio fuente, ignorado" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "clase" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "dato" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "%d archivos fuente dados en la línea de comandos" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atributo" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "los objetivos para %d los archivos fuentes que estan desactualizados" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "módulo" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " -msgstr "compilando [%s]: " - -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "buscando por archivos no actualizados... " +msgid "duplicate %s description of %s, other %s in %s" +msgstr "duplicada %s descripción de %s, otra %s en %s" -#: builders/__init__.py:410 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "%d found" -msgstr "%d encontrado" - -#: builders/__init__.py:412 -msgid "none found" -msgstr "no encontrado" +msgid "%s (directive)" +msgstr "%s (directiva)" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "preparando ambiente" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr ":%s: (opción directiva)" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "verificando consistencia" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (rol)" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "no hay archivos objetivo desactualizados." +#: domains/rst.py:234 +msgid "directive" +msgstr "directiva" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "actualizando ambiente: " +#: domains/rst.py:235 +msgid "directive-option" +msgstr "directive-option" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%sañadido, %s cambiado, %s removido" +#: domains/rst.py:236 +msgid "role" +msgstr "rol" -#: builders/__init__.py:531 +#: domains/rst.py:262 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "descripción duplicada de %s %s, otra instancia en %s" -#: builders/__init__.py:540 +#: domains/changeset.py:32 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "" +msgid "Changed in version %s" +msgstr "Distinto en la versión %s" -#: builders/__init__.py:558 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "leyendo fuentes... " +msgid "Deprecated since version %s" +msgstr "Obsoleto desde la versión %s" -#: builders/__init__.py:713 +#: domains/changeset.py:35 #, python-format -msgid "docnames to write: %s" -msgstr "docnames para escribir: %s" - -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" - -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "preparando documentos" - -#: builders/__init__.py:731 -msgid "copying assets" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:883 +#: domains/__init__.py:322 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "caracteres fuente no codificables, reemplazando con \"?\": %r" +msgid "%s %s" +msgstr "%s %s" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "El archivo ePub está en %(outdir)s." +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "número de trabajo debe ser un número positivo" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "escribiendo el archivo nav.xhtml..." +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "Para más información visite ." -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "el valor de configuración \"epub_language\" (o \"language\") no debe estar vacío para EPUB3" - -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "el valor de configuración \"epub_uid\" debe ser XML NAME para EPUB3" - -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "el valor de configuración \"epub_title\" (or \"html_title\") no debe estar vacío para EPUB3" - -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "el valor de configuración \"epub_author\" no debe estar vacío para EPUB3" - -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "el valor de configuración \"epub_contributor\" no debe estar vacío para EPUB3" - -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "el valor de configuración \"epub_description\" no debe estar vacío para EPUB3" - -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "el valor de configuración \"epub_publisher\" no debe estar vacío para EPUB3" - -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "el valor de configuración \"epub_copyright\" (or \"copyright\") no debe estar vacío para EPUB3" - -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "el valor de configuración \"epub_identifier\" no debe estar vacío para EPUB3" - -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "el valor de configuración \"version\" no debe estar vacío para EPUB3" - -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "css_file inválido: %r, ignorado" - -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Los archivos XML están en %(outdir)s." - -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "error escribiendo archivo %s: %s" - -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Los archivos pseudo-XML están en %(outdir)s." - -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Los archivos Texinfo están en %(outdir)s." - -#: builders/texinfo.py:48 +#: cmd/build.py:74 msgid "" "\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nEjecute el comando 'make' en ese directorio para ejecutarlos a través de makeinfo\n(usa el comando 'make info' aquí para hacer esto automáticamente)." - -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "no se encontró el valor de configuración \"texinfo_documents\"; no se escribirán documentos" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "El valor de configuración \"texinfo_documents\" hace referencia a un documento desconocido %s" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "procesando %s" - -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "resolviendo referencias..." - -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (en " - -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "copiando imágenes... " - -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "no se puede copiar archivo de imagen %r: %s" - -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "copiando archivos de soporte Texinfo" - -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "error escribiendo archivo Makefile: %s" - -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "entrada de tabla de contenido duplicada encontrada: %s" - -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "no puede leer el archivo de imagen %r: en su lugar, lo copia" - -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "no se puede escribir archivo de imagen %r: %s" - -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Pillow no encontrada - copiando archivos de imágenes" - -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "escribiendo el archivo mimetype..." - -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "escribiendo el archivo META-INF/container.xml..." - -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "escribiendo el archivo content.opf..." - -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "mimetype desconocido para %s, ignorando" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "" - -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "escribiendo el archivo toc.ncx..." - -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "escribiendo archivo %s..." - -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "El constructor ficticio no genera archivos." - -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Los catálogos de mensajes están en %(outdir)s." - -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "objetivos para los archivos de plantillas %d" - -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "leyendo plantillas... " - -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "escribiendo catálogos de mensajes... " - -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "Página HTML está en %(outdir)s." - -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "ensamblando documento sencillo" - -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "escribiendo archivos adicionales" - -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Busque cualquier error en la salida anterior o en el archivo %(outdir)s/output.txt" - -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "enlace roto: %s (%s)" - -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "Ancla '%s' no encontrado" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nGenerar documentación a partir de archivos fuente.\n\nsphinx-build genera documentación a partir de los archivos en SOURCEDIR y la\ncoloca en OUTPUTDIR. Busca 'conf.py' en SOURCEDIR para los ajustes de configuración.\nLa herramienta 'sphinx-quickstart' se puede usar para generar archivos de plantilla,\nincluido 'conf.py'\n\nsphinx-build puede crear documentación en diferentes formatos. Se selecciona un\nformato especificando el nombre del constructor en la línea de comando; por defecto\nes HTML. Los constructores también pueden realizar otras tareas relacionadas con\nel procesamiento de la documentación.\n\nDe forma predeterminada, se construye todo lo que está desactualizado. La salida solo\npara archivos seleccionados se puede generar especificando nombres de archivo individuales.\n" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "Error al compilar expresiones regulares en linkcheck_allowed_redirects: %r %s" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "ruta a los archivos fuente de la documentación" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Los archivos de texto están en %(outdir)s." +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "ruta al directorio de salida" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/build.py:109 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "referencias de pie de página inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "referencias inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" +#: cmd/build.py:114 +msgid "general options" +msgstr "opciones generales" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "referencias de citas inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/build.py:131 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "referencias de término inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d de %B de %Y" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "escribir todos los archivos (por defecto: solo escribir archivos nuevos y modificados)" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "no usar un entorno guardado, siempre leer todos los archivos" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/build.py:157 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "Índice basado en 4 columnas encontrado. Puede ser un error de extensiones que usted usa: %r" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "Pie de página [%s] no está referenciado." +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "Pie de página [#] no está referenciado." +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "sobreescribir un ajuste en el fichero de configuración" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "pasar un valor a la plantilla HTML" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "define la etiqueta: incluye bloques \"only\" con TAG" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/build.py:212 +msgid "console output options" +msgstr "opciones de salida de consola" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "Opciones" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "aumentar la verbosidad (puede repetirse)" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "sin salida en salida estándar, solo advertencias en los mensajes de error estándar" -#: _cli/__init__.py:171 -#, python-brace-format -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "sin salida, ni siquiera advertencias" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "emitir salida de color (predeterminado: detección automática)" -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "no emite salida de color (predeterminado: detección automática)" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "escribir avisos (y errores) al fichero indicado" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "convertir advertencias en errores" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "mostrar rastreo completo en excepción" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "ejecutar Pdb en excepción" -#: _cli/__init__.py:231 -msgid "" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "no se puede combinar la opción -a y nombres de archivo" -#: environment/__init__.py:86 -msgid "new config" -msgstr "nueva configuración" +#: cmd/build.py:357 +#, python-format +msgid "cannot open warning file '%s': %s" +msgstr "" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "configuración modificada" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "argumento de la opción -D debe estar en la forma nombre=valor" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "extensiones modificadas" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "argumento de la opción -A debe estar en la forma nombre=valor" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "la versión del entorno de compilación no es actual" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "insertar automáticamente docstrings de los módulos" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "directorio fuente ha cambiado" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "probar automáticamente fragmentos de código en bloques doctest" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "enlace entre la documentación de Sphinx de diferentes proyectos" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "escribir entradas de \"todo\" que se pueden mostrar u ocultar en la compilación" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "verificación para el cubrimiento de la documentación" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "Este entorno es incompatible con el generador seleccionado, elija otro directorio doctree." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "incluir expresiones matemáticas, mostradas como imágenes PNG o SVG" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "Error al escanear los documentos en %s: %r" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "incluir matemática, mostrada en el navegador por MathJax" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "Dominio %r no está registrado" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "inclusión condicional de contenido basado en valores de configuración" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "documento no está incluido en ningún toctree" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "incluir enlaces al código fuente de objetos documentados de Python" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "toctree auto referenciado encontrado. Ignorado." +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "crear archivo .nojekyll para publicar el documento en páginas GitHub" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Por favor, ingrese un nombre de ruta válido." -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "leyendo error: %s, %s" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Por favor, ingrese algún texto." -#: util/i18n.py:113 +#: cmd/quickstart.py:134 #, python-format -msgid "writing error: %s, %s" -msgstr "escribiendo error: %s, %s" +msgid "Please enter one of %s." +msgstr "Por favor, ingrese uno de %s." -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Por favor, ingrese cualquiera de 'y' o 'n'." -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Por favor, ingrese un archivo de sufijo, por ejemplo, '.rst' o '.txt'." -#: util/i18n.py:245 +#: cmd/quickstart.py:230 #, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Formato de fecha inválido. Cite la cadena con comillas simples si desea generarla directamente: %s" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Bienvenido a la utilidad de inicio rápido de Sphinx %s." -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:235 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "Problema en el dominio %s: se supone que el campo debe usar el rol '%s', pero ese rol no está en el dominio." +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Ingrese los valores para las siguientes configuraciones (solo presione Entrar para\naceptar un valor predeterminado, si se da uno entre paréntesis)." -#: util/nodes.py:423 +#: cmd/quickstart.py:242 #, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" +msgid "Selected root path: %s" +msgstr "Ruta raíz seleccionada: %s" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "toctree contiene referencia al archivo inexistente %r" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Ingrese la ruta raíz para la documentación." -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "excepción al evaluar solamente la expresión directiva: %s" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Ruta raíz para la documentación" -#: util/display.py:82 -msgid "skipped" -msgstr "omitido" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Error: un archivo conf.py ya existe en la ruta raíz seleccionada." -#: util/display.py:87 -msgid "failed" -msgstr "fallado" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart no sobreescribirá proyectos existentes de Sphinx." -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Por favor, ingrese una nueva ruta raíz (o ingrese Enter para salir)" + +#: cmd/quickstart.py:274 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Tiene dos opciones para colocar el directorio de compilación para la salida de Sphinx.\nO usas un directorio \"_build\" dentro de la ruta raíz, o separas\ndirectorios \"fuente\" y \"compilación\" dentro de la ruta raíz." -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Separar directorios fuente y compilado (y/n)" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "Dentro del directorio raíz, se crearán dos directorios más; \"_templates\"\npara plantillas HTML personalizadas y \"_static\" para hojas de estilo personalizadas y otras archivos\nestáticos. Puede ingresar otro prefijo (como \".\") Para reemplazar el guión bajo." -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" -msgstr "tipo de nodo desconocido: %r" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Prefijo de nombre para directorios de plantillas y estático" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:298 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" - -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +"The project name will occur in several places in the built documentation." +msgstr "El nombre del proyecto aparecerá en varios lugares en la documentación construida." -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "rol por defecto %s no encontrado" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Nombre de proyecto" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Autor(es)" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx tiene la noción de una \"versión\" y un \"lanzamiento\" para el\nsoftware. Cada versión puede tener varios lanzamientos. Por ejemplo, para\nPython, la versión es algo así como 2.5 o 3.0, mientras que el lanzamiento es\nalgo así como 2.5.1 o 3.0a1. Si no necesita esta estructura dual, simplemente\nconfigure ambas con el mismo valor." -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Notas a pie de página" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Versión del proyecto" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[imagen: %s]" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Liberación del proyecto" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[imagen]" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "Si los documentos deben escribirse en un idioma que no sea inglés,\npuede seleccionar un idioma aquí por su código de idioma. Sphinx entonces\ntraducir el texto que genera a ese idioma.\n\nPara obtener una lista de códigos compatibles, vea\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Índice" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Lenguaje del proyecto" -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:340 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "no se encontró el nodo de título en la sección, tema, tabla, advertencia o barra lateral" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "El sufijo del nombre de archivo para los archivos de fuente. Comúnmente, esto es \".txt\"\no \".rst\". Solo los archivos con este sufijo se consideran documentos." -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "subtítulo no dentro de una figura." +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Sufijo del archivo fuente" -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "tipo de nodo no implementado: %r" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "Un documento es especial porque se considera el nodo superior del\n\"contents tree\", es decir, es la raíz de la estructura jerárquica\nde los documentos. Normalmente, esto es \"index\", pero si su documento \"index\"\nes una plantilla personalizada, también puede establecerlo en otro nombre de archivo." -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "desconocida %r toplevel_sectioning para la clase %r" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Nombre del documento maestro (sin sufijo)" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: cmd/quickstart.py:368 #, python-format -msgid "no Babel option known for language %r" -msgstr "No se conoce la opción de Babel para el idioma %r" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "demasiado grande :maxdepth:, ignorado." +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Error: el archivo maestro %s ya se ha encontrado en la ruta raíz seleccionada." -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart no sobreescribirá el archivo existente." -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "título del documento no es un nodo de Texto único" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Ingrese un nuevo nombre de archivo o cambie el nombre del archivo existente y presione Enter" -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Indique cuál de las siguientes extensiones de Sphinx deben habilitarse:" -#: writers/latex.py:1183 +#: cmd/quickstart.py:397 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "ambas columnas tabulares y la opción :widths: se dan. La opción :widths: se ignora." - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "la unidad de dimensión %s no es válida. Ignorado." +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Nota: imgmath y mathjax no se pueden habilitar al mismo tiempo. imgmath ha sido deseleccionado." -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "tipo de entrada de índice desconocido %s encontrado" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Se puede generar un archivo Makefile y un archivo de comandos de Windows para que usted\nsolo tiene que ejecutar, por ejemplo, `make html' en lugar de invocar sphinx-build\ndirectamente." -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "No válido math_eqref_format: %r" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "¿Crear Makefile? (y/n)" -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "¿Crear archivo de comandos para Windows? (y/n)" -#: writers/html5.py:431 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "numfig_format is not defined for %s" -msgstr "numfig_format no está definido para %s" +msgid "Creating file %s." +msgstr "Creando archivo %s." -#: writers/html5.py:441 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "Any IDs not assigned for %s node" -msgstr "Cualquier ID no asignado para el nodo %s" +msgid "File %s already exists, skipping." +msgstr "El archivo %s ya existe, omitiendo." -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Terminado: se ha creado una estructura de directorio inicial." -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Ahora debe completar su archivo maestro %s y crear otros archivos fuente\nde documentación. " -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Use el archivo Makefile para compilar los documentos, así ejecute el comando:\n make builder" -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Use el comando sphinx-build para compilar los documentos, así ejecute el comando:\n sphinx-build -b builder %s %s" -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "donde \"builder\" es uno de los constructores compatibles, por ejemplo, html, latex o linkcheck." -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nGenere los archivos necesarios para un proyecto Sphinx.\n\nsphinx-quickstart es una herramienta interactiva que hace algunas preguntas sobre su\nproyecto y luego genera un directorio completo de documentación y un ejemplo del archivo\nMakefilepara ser utilizado con el comando sphinx-build.\n" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "No se pudo obtener el tamaño de la imagen. La opción :scale: se ignora." +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "modo silencioso" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "raíz del proyecto" -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "etiqueta duplicada de la ecuación %s, otra instancia en %s" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Opciones de estructura" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (función incorporada)" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "si se especifica, separe los directorios de fuentes y de compilación" -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (método de %s)" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "si se especifica, cree un directorio de compilación en el directorio de origen" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (clase)" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "reemplazo para punto en _templates, etc." -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (variable global o constante)" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Opciones básicas del proyecto" -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (atributo de %s)" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "nombre del proyecto" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumentos" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "autores" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Lanzamientos" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "versión del proyecto" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Devuelve" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "liberación del proyecto" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Tipo del valor devuelto" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "lenguaje del documento" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (módulo)" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "sufijo de archivo fuente" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "función" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "nombre de documento maestro" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "método" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "usar epub" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "clase" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Opciones de extensión" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "dato" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" +msgstr "habilitada extensión %s" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atributo" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "habilitar extensiones arbitrarias" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "módulo" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "creación del Makefile y Batchfile" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "duplicada %s descripción de %s, otra %s en %s" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "crear makefile" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "no crear makefile" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Distinto en la versión %s" +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "crear batchfile" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Obsoleto desde la versión %s" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "no crear batchfile" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "use el modo make para Makefile/make.bat" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (directiva)" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Plantillas de proyecto" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (opción directiva)" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "directorio de plantillas para archivos de plantillas" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (rol)" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "definir una variable de proyceto" -#: domains/rst.py:234 -msgid "directive" -msgstr "directiva" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "se especifica \"quiet\", pero no se especifica ninguno de \"project\" o \"author\"." -#: domains/rst.py:235 -msgid "directive-option" -msgstr "directive-option" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Error: la ruta especificada no es un directorio, o ya existen archivos sphinx." -#: domains/rst.py:236 -msgid "role" -msgstr "rol" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart solo se genera en un directorio vacío. Por favor, especifique una nueva ruta raíz." -#: domains/rst.py:262 +#: cmd/quickstart.py:810 #, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "descripción duplicada de %s %s, otra instancia en %s" +msgid "Invalid template variable: %s" +msgstr "Variable de plantilla inválida: %s" -#: domains/citation.py:75 +#: directives/other.py:119 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "citación duplicada %s, otra instancia en %s" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "patrón global toctree %r no coincide con ningún documento" -#: domains/citation.py:92 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "Citación [%s] no está referenciada." - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Atención" +msgid "toctree contains reference to excluded document %r" +msgstr "toctree contiene referencia al documento excluido %r" -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Prudencia" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "toctree contiene referencias a documentos inexistentes %r" -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Peligro" +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "entrada duplicada encontrada en toctree: %s" -#: locale/__init__.py:231 -msgid "Error" -msgstr "Error" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autor de la sección: " -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Consejo" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autor del módulo: " -#: locale/__init__.py:233 -msgid "Important" -msgstr "Importante" +#: directives/other.py:207 +msgid "Code author: " +msgstr "Código del autor: " -#: locale/__init__.py:234 -msgid "Note" -msgstr "Nota" +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor: " -#: locale/__init__.py:235 -msgid "See also" -msgstr "Ver también" +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr ".. contenido de los reconocimientos no es una lista" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Truco" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr ".. hlist contenido no es una lista" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Advertencia" +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "\":file:\" La opción para la directiva csv-table ahora reconoce una ruta absoluta como una ruta relativa desde el directorio de origen. Actualice su documento." -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "insertar automáticamente docstrings de los módulos" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "no espacios en blanco eliminados por identado" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "probar automáticamente fragmentos de código en bloques doctest" +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" +msgstr "Subtítulo inválido: %s" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "enlace entre la documentación de Sphinx de diferentes proyectos" +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" +msgstr "la especificación del número de línea está fuera de range(1-%d): %r" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "escribir entradas de \"todo\" que se pueden mostrar u ocultar en la compilación" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "No puede utilizar ambas opciones \"%s\" y \"%s\"" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "verificación para el cubrimiento de la documentación" +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" +msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "incluir expresiones matemáticas, mostradas como imágenes PNG o SVG" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "incluir matemática, mostrada en el navegador por MathJax" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "Objeto nombrado %r no encontrado en el archivo incluido %r" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "inclusión condicional de contenido basado en valores de configuración" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "No puede utilizar a \"lineno-match\" con un conjunto desunido de \"líneas\"" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "incluir enlaces al código fuente de objetos documentados de Python" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Línea especifico %r: sin líneas tiradas desde el archivo incluido %r" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "crear archivo .nojekyll para publicar el documento en páginas GitHub" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d de %B de %Y" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Por favor, ingrese un nombre de ruta válido." +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Índice" -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Por favor, ingrese algún texto." +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "no se encontró el nodo de título en la sección, tema, tabla, advertencia o barra lateral" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "Por favor, ingrese uno de %s." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Notas a pie de página" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Por favor, ingrese cualquiera de 'y' o 'n'." +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "subtítulo no dentro de una figura." -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Por favor, ingrese un archivo de sufijo, por ejemplo, '.rst' o '.txt'." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "tipo de nodo no implementado: %r" -#: cmd/quickstart.py:229 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Bienvenido a la utilidad de inicio rápido de Sphinx %s." +msgid "[image: %s]" +msgstr "[imagen: %s]" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Ingrese los valores para las siguientes configuraciones (solo presione Entrar para\naceptar un valor predeterminado, si se da uno entre paréntesis)." +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[imagen]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "" -#: cmd/quickstart.py:241 +#: writers/html5.py:431 #, python-format -msgid "Selected root path: %s" -msgstr "Ruta raíz seleccionada: %s" +msgid "numfig_format is not defined for %s" +msgstr "numfig_format no está definido para %s" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "Ingrese la ruta raíz para la documentación." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "Cualquier ID no asignado para el nodo %s" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Ruta raíz para la documentación" +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Error: un archivo conf.py ya existe en la ruta raíz seleccionada." +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart no sobreescribirá proyectos existentes de Sphinx." +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Por favor, ingrese una nueva ruta raíz (o ingrese Enter para salir)" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Tiene dos opciones para colocar el directorio de compilación para la salida de Sphinx.\nO usas un directorio \"_build\" dentro de la ruta raíz, o separas\ndirectorios \"fuente\" y \"compilación\" dentro de la ruta raíz." +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Separar directorios fuente y compilado (y/n)" +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "Dentro del directorio raíz, se crearán dos directorios más; \"_templates\"\npara plantillas HTML personalizadas y \"_static\" para hojas de estilo personalizadas y otras archivos\nestáticos. Puede ingresar otro prefijo (como \".\") Para reemplazar el guión bajo." +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Prefijo de nombre para directorios de plantillas y estático" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "No se pudo obtener el tamaño de la imagen. La opción :scale: se ignora." -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "El nombre del proyecto aparecerá en varios lugares en la documentación construida." +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "desconocida %r toplevel_sectioning para la clase %r" -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Nombre de proyecto" +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" +msgstr "No se conoce la opción de Babel para el idioma %r" -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Autor(es)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "demasiado grande :maxdepth:, ignorado." -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "Sphinx tiene la noción de una \"versión\" y un \"lanzamiento\" para el\nsoftware. Cada versión puede tener varios lanzamientos. Por ejemplo, para\nPython, la versión es algo así como 2.5 o 3.0, mientras que el lanzamiento es\nalgo así como 2.5.1 o 3.0a1. Si no necesita esta estructura dual, simplemente\nconfigure ambas con el mismo valor." +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Versión del proyecto" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "título del documento no es un nodo de Texto único" -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Liberación del proyecto" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "ambas columnas tabulares y la opción :widths: se dan. La opción :widths: se ignora." -#: cmd/quickstart.py:323 +#: writers/latex.py:1228 +#, python-format msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "Si los documentos deben escribirse en un idioma que no sea inglés,\npuede seleccionar un idioma aquí por su código de idioma. Sphinx entonces\ntraducir el texto que genera a ese idioma.\n\nPara obtener una lista de códigos compatibles, vea\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Lenguaje del proyecto" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "la unidad de dimensión %s no es válida. Ignorado." -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "El sufijo del nombre de archivo para los archivos de fuente. Comúnmente, esto es \".txt\"\no \".rst\". Solo los archivos con este sufijo se consideran documentos." +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "tipo de entrada de índice desconocido %s encontrado" + +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Sufijo del archivo fuente" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "Un documento es especial porque se considera el nodo superior del\n\"contents tree\", es decir, es la raíz de la estructura jerárquica\nde los documentos. Normalmente, esto es \"index\", pero si su documento \"index\"\nes una plantilla personalizada, también puede establecerlo en otro nombre de archivo." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Nombre del documento maestro (sin sufijo)" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Error: el archivo maestro %s ya se ha encontrado en la ruta raíz seleccionada." +#: _cli/__init__.py:98 +msgid "Options" +msgstr "Opciones" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart no sobreescribirá el archivo existente." +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: cmd/quickstart.py:377 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Ingrese un nuevo nombre de archivo o cambie el nombre del archivo existente y presione Enter" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Indique cuál de las siguientes extensiones de Sphinx deben habilitarse:" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Nota: imgmath y mathjax no se pueden habilitar al mismo tiempo. imgmath ha sido deseleccionado." +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Se puede generar un archivo Makefile y un archivo de comandos de Windows para que usted\nsolo tiene que ejecutar, por ejemplo, `make html' en lugar de invocar sphinx-build\ndirectamente." +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "¿Crear Makefile? (y/n)" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "¿Crear archivo de comandos para Windows? (y/n)" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." -msgstr "Creando archivo %s." +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "El archivo %s ya existe, omitiendo." +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Terminado: se ha creado una estructura de directorio inicial." +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: cmd/quickstart.py:519 -#, python-format +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" + +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "Ahora debe completar su archivo maestro %s y crear otros archivos fuente\nde documentación. " +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "referencias de pie de página inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" -#: cmd/quickstart.py:526 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Use el archivo Makefile para compilar los documentos, así ejecute el comando:\n make builder" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "referencias inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" -#: cmd/quickstart.py:530 -#, python-format +#: transforms/i18n.py:325 +#, python-brace-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Use el comando sphinx-build para compilar los documentos, así ejecute el comando:\n sphinx-build -b builder %s %s" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "referencias de citas inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" -#: cmd/quickstart.py:537 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "donde \"builder\" es uno de los constructores compatibles, por ejemplo, html, latex o linkcheck." +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "referencias de término inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" -#: cmd/quickstart.py:572 +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" + +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" + +#: transforms/__init__.py:258 +#, python-format msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nGenere los archivos necesarios para un proyecto Sphinx.\n\nsphinx-quickstart es una herramienta interactiva que hace algunas preguntas sobre su\nproyecto y luego genera un directorio completo de documentación y un ejemplo del archivo\nMakefilepara ser utilizado con el comando sphinx-build.\n" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "Índice basado en 4 columnas encontrado. Puede ser un error de extensiones que usted usa: %r" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "Para más información visite ." +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "Pie de página [%s] no está referenciado." -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "modo silencioso" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "raíz del proyecto" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "Pie de página [#] no está referenciado." -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Opciones de estructura" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "si se especifica, separe los directorios de fuentes y de compilación" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "si se especifica, cree un directorio de compilación en el directorio de origen" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "leyendo error: %s, %s" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "reemplazo para punto en _templates, etc." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "escribiendo error: %s, %s" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Opciones básicas del proyecto" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "nombre del proyecto" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "autores" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Formato de fecha inválido. Cite la cadena con comillas simples si desea generarla directamente: %s" -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "versión del proyecto" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "liberación del proyecto" +#: util/display.py:82 +msgid "skipped" +msgstr "omitido" -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "lenguaje del documento" +#: util/display.py:87 +msgid "failed" +msgstr "fallado" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "sufijo de archivo fuente" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "nombre de documento maestro" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "usar epub" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "tipo de nodo desconocido: %r" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Opciones de extensión" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" -#: cmd/quickstart.py:670 +#: util/fileutil.py:89 #, python-format -msgid "enable %s extension" -msgstr "habilitada extensión %s" +msgid "Writing evaluated template result to %s" +msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "habilitar extensiones arbitrarias" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "Problema en el dominio %s: se supone que el campo debe usar el rol '%s', pero ese rol no está en el dominio." -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "creación del Makefile y Batchfile" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "rol por defecto %s no encontrado" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "crear makefile" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "no crear makefile" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "toctree contiene referencia al archivo inexistente %r" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "crear batchfile" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "excepción al evaluar solamente la expresión directiva: %s" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "no crear batchfile" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "proviene de la página anterior" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "use el modo make para Makefile/make.bat" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "continúe en la próxima página" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Plantillas de proyecto" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "No alfabético" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "directorio de plantillas para archivos de plantillas" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Símbolos" -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "definir una variable de proyceto" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Números" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "se especifica \"quiet\", pero no se especifica ninguno de \"project\" o \"author\"." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "página" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Error: la ruta especificada no es un directorio, o ya existen archivos sphinx." +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Versión" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart solo se genera en un directorio vacío. Por favor, especifique una nueva ruta raíz." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "No se pudo recuperar la imagen remota: %s [%s]" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "Invalid template variable: %s" -msgstr "Variable de plantilla inválida: %s" +msgid "Could not fetch remote image: %s [%d]" +msgstr "No se pudo recuperar la imagen remota: %s [%d]" -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "número de trabajo debe ser un número positivo" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Formato de imagen desconocido: %s..." -#: cmd/build.py:74 +#: transforms/post_transforms/__init__.py:88 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\nGenerar documentación a partir de archivos fuente.\n\nsphinx-build genera documentación a partir de los archivos en SOURCEDIR y la\ncoloca en OUTPUTDIR. Busca 'conf.py' en SOURCEDIR para los ajustes de configuración.\nLa herramienta 'sphinx-quickstart' se puede usar para generar archivos de plantilla,\nincluido 'conf.py'\n\nsphinx-build puede crear documentación en diferentes formatos. Se selecciona un\nformato especificando el nombre del constructor en la línea de comando; por defecto\nes HTML. Los constructores también pueden realizar otras tareas relacionadas con\nel procesamiento de la documentación.\n\nDe forma predeterminada, se construye todo lo que está desactualizado. La salida solo\npara archivos seleccionados se puede generar especificando nombres de archivo individuales.\n" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "No se pudo determinar el texto alternativo para la referencia cruzada. Podría ser un error." -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "ruta a los archivos fuente de la documentación" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "más de un objetivo destino encontrado para 'cualquier' referencia cruzada %r: podría ser %s" -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "ruta al directorio de salida" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s objetivo de referencia no encontrado: %s" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r objetivo de referencia no encontrado: %s" -#: cmd/build.py:114 -msgid "general options" -msgstr "opciones generales" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "¡Interrumpido!" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "escribir todos los archivos (por defecto: solo escribir archivos nuevos y modificados)" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "no usar un entorno guardado, siempre leer todos los archivos" - -#: cmd/build.py:150 -msgid "path options" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:157 +#: _cli/util/errors.py:207 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "sobreescribir un ajuste en el fichero de configuración" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "pasar un valor a la plantilla HTML" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "define la etiqueta: incluye bloques \"only\" con TAG" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" -msgstr "opciones de salida de consola" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Por favor, informe también esto si fue un error del usuario, de modo que la próxima vez se pueda proporcionar un mejor mensaje de error." -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "aumentar la verbosidad (puede repetirse)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Contraer barra lateral" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "sin salida en salida estándar, solo advertencias en los mensajes de error estándar" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navegación" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "sin salida, ni siquiera advertencias" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Buscar en %(docstitle)s" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "emitir salida de color (predeterminado: detección automática)" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Sobre este documento" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "no emite salida de color (predeterminado: detección automática)" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Búsqueda" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "escribir avisos (y errores) al fichero indicado" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Actualizado por última vez en %(last_updated)s." -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "convertir advertencias en errores" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Creado usando Sphinx %(sphinx_version)s." -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "mostrar rastreo completo en excepción" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Tema anterior" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "ejecutar Pdb en excepción" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "capítulo anterior" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Próximo tema" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "no se puede combinar la opción -a y nombres de archivo" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "próximo capítulo" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "Index – %(key)s" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "argumento de la opción -D debe estar en la forma nombre=valor" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "argumento de la opción -A debe estar en la forma nombre=valor" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Índice completo en una página" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Contraer barra lateral" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Esta página" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Tabla de contenido" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "Mostrar el código" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Búsqueda" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Búsqueda rápida" #: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 #: themes/basic/searchfield.html:12 msgid "Go" msgstr "Ir a" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "Mostrar el código" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Contenidos" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Buscar en %(docstitle)s" - #: themes/basic/defindex.html:4 msgid "Overview" msgstr "Resumen" @@ -2690,7 +2890,7 @@ msgstr "Índice Global de Módulos" msgid "quick access to all modules" msgstr "acceso rápido a todos los módulos" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Índice General" @@ -2698,23 +2898,15 @@ msgstr "Índice General" msgid "all functions, classes, terms" msgstr "todas las funciones, clases, términos" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Esta página" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Tabla de contenido" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Índice completo en una página" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Búsqueda rápida" +msgid "Search %(docstitle)s" +msgstr "Buscar en %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2724,57 +2916,6 @@ msgstr "Índice alfabético de páginas" msgid "can be huge" msgstr "puede ser muy grande" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Tema anterior" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "capítulo anterior" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Próximo tema" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "próximo capítulo" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navegación" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Buscar en %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Sobre este documento" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Actualizado por última vez en %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Creado usando Sphinx %(sphinx_version)s." - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2791,21 +2932,21 @@ msgstr "La búsqueda de varias palabras solo muestra coincidencias que contienen msgid "search" msgstr "buscar" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Ocultar coincidencias de la búsqueda" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Contenidos" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Resultados de la búsqueda" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Su búsqueda no coincide con ningún documentos. Por favor, asegúrese de que todas las palabras estén correctamente escritas y que usted allá seleccionado las suficientes categorías." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2814,22 +2955,21 @@ msgstr[0] "" msgstr[1] "" msgstr[2] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Buscando" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Preparando búsqueda..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", en " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Ocultar coincidencias de la búsqueda" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2837,6 +2977,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Cambios en la versión %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2858,120 +3003,127 @@ msgstr "Otros cambios" msgid "Expand sidebar" msgstr "Expandir barra lateral" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parámetros" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variables" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Muestra" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (en el módulo %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (en el módulo %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (variable incorporada)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (clase incorporada)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (clase en %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (método de clase de %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (método estático de %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (%s propiedad)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Índice de Módulos Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "módulos" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Obsoleto" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "excepción" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "método de la clase" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "método estático" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "propiedad" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "se encontró más de un objetivo para la referencia cruzada %r: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (obsoleto)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parámetros" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variables" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Muestra" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "Declaración de C++ duplicada, también definida en %s:%s.\nLa declaración es '.. cpp:%s:: %s'." #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2982,92 +3134,85 @@ msgstr "Parametros de Plantilla" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "Declaración de C++ duplicada, también definida en %s:%s.\nLa declaración es '.. cpp:%s:: %s'." - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "Valores devueltos" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "unión" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "miembro" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tipo" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "concepto" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumeración" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "parámetro de función" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "parámetro de plantilla" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Declaración de C duplicada, también definida en %s:%s.\nLa declaración es '.. c:%s:: %s'." -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "variable" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "macro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "estructura" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "variables de entorno; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3162,514 +3307,422 @@ msgstr "etiqueta indefinida: %r" msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "No se pudo crear una referencia cruzada. Un título o subtítulo no encontrado: %r" -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "referencias circulares de toctree detectadas, ignorando: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "toctree contiene una referencia al documento %r que no tiene título: no se generará ningún enlace" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "el árbol de la tabla de contenido contiene una referencia a un documento no incluido %r" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "ver %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "ver también %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "tipo de entrada de índice desconocido %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Símbolos" - -#: environment/collectors/asset.py:98 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "image file not readable: %s" -msgstr "archivo de imagen no legible: %s" +msgid "invalid value set (missing closing brace): %s" +msgstr "conjunto de valores no válidos (falta la llave de cierre): %s" -#: environment/collectors/asset.py:126 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "image file %s not readable: %s" -msgstr "archivo de imagen %s no legible: %s" +msgid "invalid value set (missing opening brace): %s" +msgstr "conjunto de valor no válido (falta llave de apertura): %s" -#: environment/collectors/asset.py:163 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "download file not readable: %s" -msgstr "el archivo de descarga no es legible: %s" +msgid "malformed string literal (missing closing quote): %s" +msgstr "literal de cadena con formato incorrecto (falta la comilla de cierre): %s" -#: environment/collectors/toctree.py:259 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s ya tiene asignados números de sección (¿número de árbol anidado?)" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "¡Interrumpido!" +msgid "malformed string literal (missing opening quote): %s" +msgstr "literal de cadena con formato incorrecto (falta la comilla de apertura): %s" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Ejemplo" -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Ejemplos" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Argumentos de palabras clave" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Notas" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Otros parámetros" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "Recibe" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Referencias" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Por favor, informe también esto si fue un error del usuario, de modo que la próxima vez se pueda proporcionar un mejor mensaje de error." +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Avisos" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "No se pudo determinar el texto alternativo para la referencia cruzada. Podría ser un error." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "Campos" -#: transforms/post_transforms/__init__.py:237 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "más de un objetivo destino encontrado para 'cualquier' referencia cruzada %r: podría ser %s" +msgid "A mocked object is detected: %r" +msgstr "Se detecta un objeto simulado: %r" -#: transforms/post_transforms/__init__.py:299 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s objetivo de referencia no encontrado: %s" +msgid "alias of %s" +msgstr "alias de %s" -#: transforms/post_transforms/__init__.py:305 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "%r reference target not found: %s" -msgstr "%r objetivo de referencia no encontrado: %s" +msgid "Bases: %s" +msgstr "Bases: %s" -#: transforms/post_transforms/images.py:79 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "No se pudo recuperar la imagen remota: %s [%s]" +msgid "invalid value for member-order option: %s" +msgstr "valor no válido para la opción de pedido de miembro: %s" -#: transforms/post_transforms/images.py:96 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "No se pudo recuperar la imagen remota: %s [%d]" +msgid "invalid value for class-doc-from option: %s" +msgstr "valor no válido para la opción class-doc-from: %s" -#: transforms/post_transforms/images.py:143 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "Unknown image format: %s..." -msgstr "Formato de imagen desconocido: %s..." +msgid "invalid signature for auto%s (%r)" +msgstr "firma inválida para auto%s (%r)" -#: builders/html/__init__.py:113 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "Las páginas HTML están en %(outdir)s." +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "no sabe qué módulo importar para el autodocumento %r (intente colocar una directiva \"module\" o \"currentmodule\" en el documento o dar un nombre explícito al módulo)" -#: builders/html/__init__.py:348 +#: ext/autodoc/_names.py:89 #, python-format -msgid "Failed to read build info file: %r" -msgstr "Error al leer la información de compilación del fichero: %r" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "" - -#: builders/html/__init__.py:366 -msgid "building [html]: " +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:383 +#: ext/autodoc/_names.py:93 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "índice" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "\"::\" en el nombre del automodule no tiene sentido" -#: builders/html/__init__.py:560 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "Logo of %s" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "siguiente" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "anterior" +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "Debería crear archivo %s." -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "generando índices" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nMire recursivamente en para módulos y paquetes de Python y cree\nun archivo reST con directivas automodule por paquete en el .\n\nLos s pueden ser patrones de archivo y/o directorio que serán\nexcluidos de la generación.\n\nNota: Por defecto, este script no sobrescribirá los archivos ya creados." -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "escribiendo páginas adicionales" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "ruta al módulo al documento" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "archivo de estilo fnmatch y/o patrones de directorio para excluir de la generación" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "copiando archivos descargables... " +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "directorio para colocar toda la salida" -#: builders/html/__init__.py:818 -#, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "no se puede copiar archivo descargable %r: %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "rofundidad máxima de submódulos para mostrar en la tabla de contenido (predeterminado: 4)" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "sobreescribir archivos existentes" -#: builders/html/__init__.py:882 -#, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "Error al copiar un archivo en html_static_file: %s: %r" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "seguir enlaces simbólicos. Potente cuando se combina con el paquete collective.recipe.omelette." -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "copiar archivos estáticos" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "ejecutar la rutina sin crear archivos" -#: builders/html/__init__.py:934 -#, python-format -msgid "cannot copy static file %r" -msgstr "no se puede copiar archivo estático %r" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "poner documentación para cada módulo en su propia página" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "copiando archivos extras" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "incluir \"_private\" en módulos" -#: builders/html/__init__.py:949 -#, python-format -msgid "cannot copy extra file %r" -msgstr "no se puede copiar archivo extra %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "nombre de archivo de la tabla de contenido (predeterminado: módulos)" -#: builders/html/__init__.py:955 -#, python-format -msgid "Failed to write build info file: %r" -msgstr "Error al escribir el archivo de información de compilación: %r" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "no crear un archivo de tabla de contenido" -#: builders/html/__init__.py:1005 +#: ext/apidoc/_cli.py:135 msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "no se pudo cargar el índice de búsqueda, pero no se crearán todos los documentos: el índice estará incompleto." +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "no cree encabezados para los paquetes de módulos/paquetes (por ejemplo, cuando las cadenas de documentación docstrings ya los contienen)" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "página %s coincide con dos patrones en html_sidebars: %r y %r" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "poner la documentación del módulo antes de la documentación del submódulo" -#: builders/html/__init__.py:1216 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "Se produjo un error Unicode al representar la página %s. Asegúrese de que todos los valores de configuración que contengan contenido que no sea ASCII sean cadenas Unicode." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "interpretar las rutas del módulo de acuerdo con la especificación de espacios de nombres implícitos en la PEP-0420" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "Ha ocurrido un error al renderizar la pagina %s.\nRazón: %r" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "volcar inventario de objetos" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "sufijo de archivo (por defecto: rst)" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "volcar el índice de búsqueda en %s" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "js_file inválido: %r, ignorado" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "generar un proyecto completo con sphinx-quickstart" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "Muchos math_renderers están registrados. Pero no se ha seleccionado math_renderer." +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "agregue module_path al sys.path, que se usa cuando se da el parámetro --full" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "Desconocido math_renderer %r es dado." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "nombre del proyecto (predeterminado: nombre del módulo raíz)" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "entrada html_extra_path %r se coloca dentro de outdir" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "autor(es) del proyecto, utilizado cuando se da el parámetro --full" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "entrada html_extra_path %r no existe" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "versión del proyecto, utilizado cuando se da el parámetro --full" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "lanzamiento del proyecto, utilizado cuando se da el parámetro --full, por defecto es --doc-version" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "opciones de extensión" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1380 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "entrada html_static_path %r se coloca dentro de outdir" +msgid "enable %s extension, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1385 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "html_static_path entry %r does not exist" -msgstr "entrada html_static_path %r no existe" +msgid "%s is not a directory." +msgstr "%s no es un directorio." -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "archivo de logo %r no existe" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "" -#: builders/html/__init__.py:1407 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "favicon file %r does not exist" -msgstr "el archivo %r usado para el favicon no existe" +msgid "apidoc_modules item %i must be a dict" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "%s %s documentation" -msgstr "documentación de %s - %s" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_extension.py:133 +#, python-format +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Los archivos LaTeX están en %(outdir)s." - -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nEjecuta el comando 'make' en este directorio para compilarlos usando (pdf)latex\n(usa el comando 'make latexpdf' aquí para hacer esto automáticamente)." - -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "no se encontró el valor de configuración \"latex_documents\"; no se escribirán documentos" +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "valor de configuración \"latex_documents\" hace referencia a un documento desconocido %s" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Versión" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "copiando archivos de soporte TeX" - -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "copiando archivos adicionales" +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "Clave de configuración desconocida: latex_elements[%r], ignorada." +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "Opción de tema desconocida: latex_theme_options[%r], ignorado." - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r no tiene configuración de \"tema\"" +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "" -#: builders/latex/theming.py:91 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r no tiene configuración de \"%s\"" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "autosummary: no se pudo determinar %r que se documentará, se produjo la siguiente excepción:\n%s" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "proviene de la página anterior" +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] generar autosummary para: %s" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "continúe en la próxima página" +#: ext/autosummary/generate.py:634 +#, python-format +msgid "[autosummary] writing to %s" +msgstr "[autosummary] escribiendo a %s" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "No alfabético" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "[autosummary] no se pudo importar %s.\nPosibles pistas:\n%s" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Números" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nGenere ReStructuredText usando directivas de resumen automático \"autosummary\".\n\nsphinx-autogen es una interfaz para sphinx.ext.autosummary.generate. Genera\nlos archivos reStructuredText de las directivas autosummary contenidas en el\nlos archivos de entrada dados.\n\nEl formato de la directiva autosummary está documentado en el módulo Python\n``sphinx.ext.autosummary`` y se puede leer usando el siguiente comando::\n\n pydoc sphinx.ext.autosummary\n" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "página" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "archivos fuente para generar archivos rST para" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Argumentos de palabras clave" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "directorio para colocar toda la salida en" -#: ext/napoleon/docstring.py:176 +#: ext/autosummary/generate.py:915 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "conjunto de valores no válidos (falta la llave de cierre): %s" +msgid "default suffix for files (default: %(default)s)" +msgstr "sufijo predeterminado para archivos (predeterminado: %(default)s)" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:923 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "conjunto de valor no válido (falta llave de apertura): %s" +msgid "custom template directory (default: %(default)s)" +msgstr "directorio de plantillas personalizadas (predeterminado: %(default)s)" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:931 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "literal de cadena con formato incorrecto (falta la comilla de cierre): %s" +msgid "document imported members (default: %(default)s)" +msgstr "documento importados miembros (predeterminado: %(default)s)" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:940 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "literal de cadena con formato incorrecto (falta la comilla de apertura): %s" - -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Ejemplo" - -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Ejemplos" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Notas" - -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Otros parámetros" - -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "Recibe" - -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Referencias" - -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Avisos" - -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "Campos" +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "documentar exactamente los miembros en module __all__ attribute. (por defecto: %(default)s)" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "referencias autosummary excluidas documento %r. Ignorado." -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: no se encontró el archivo stub %r. Verifique su configuración de autosummary_generate." -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "Un resumen automático con subtítulos requiere la opción :toctree: ignorado." -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3677,548 +3730,585 @@ msgid "" "%s" msgstr "autosummary: no se pudo importar %s.\nPosibles pistas:\n%s" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "fallo al analizar el nombre %s" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "fallo al importar el objeto %s" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: archivo no encontrado: %s" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "autosummary: no se pudo determinar %r que se documentará, se produjo la siguiente excepción:\n%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[autosummary] generar autosummary para: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[autosummary] escribiendo a %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "[autosummary] no se pudo importar %s.\nPosibles pistas:\n%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nGenere ReStructuredText usando directivas de resumen automático \"autosummary\".\n\nsphinx-autogen es una interfaz para sphinx.ext.autosummary.generate. Genera\nlos archivos reStructuredText de las directivas autosummary contenidas en el\nlos archivos de entrada dados.\n\nEl formato de la directiva autosummary está documentado en el módulo Python\n``sphinx.ext.autosummary`` y se puede leer usando el siguiente comando::\n\n pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "" + +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" + +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "" + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "archivos fuente para generar archivos rST para" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "directorio para colocar toda la salida en" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "encontró algunos problemas con algunos de los inventarios, pero tenían alternativas de trabajo:" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:332 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "sufijo predeterminado para archivos (predeterminado: %(default)s)" +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "directorio de plantillas personalizadas (predeterminado: %(default)s)" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "el inventario intersphinx se ha movido: %s -> %s" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "documento importados miembros (predeterminado: %(default)s)" +msgid "(in %s %s)" +msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "documentar exactamente los miembros en module __all__ attribute. (por defecto: %(default)s)" +msgid "(in %s)" +msgstr "(en %s)" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Failed to remove %s: %s" +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nMire recursivamente en para módulos y paquetes de Python y cree\nun archivo reST con directivas automodule por paquete en el .\n\nLos s pueden ser patrones de archivo y/o directorio que serán\nexcluidos de la generación.\n\nNota: Por defecto, este script no sobrescribirá los archivos ya creados." +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "ruta al módulo al documento" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "archivo de estilo fnmatch y/o patrones de directorio para excluir de la generación" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "directorio para colocar toda la salida" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "%s externo: destino de referencia %s no encontrado: %s" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "rofundidad máxima de submódulos para mostrar en la tabla de contenido (predeterminado: 4)" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "error al formatear la firma para %s: %s" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "sobreescribir archivos existentes" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "seguir enlaces simbólicos. Potente cuando se combina con el paquete collective.recipe.omelette." +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "Error al obtener una firma de función para %s: %s" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "ejecutar la rutina sin crear archivos" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "Error al actualizar la firma para %r: parámetro no encontrado: %s" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "poner documentación para cada módulo en su propia página" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "Error al analizar type_comment para %r: %s" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "incluir \"_private\" en módulos" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "Se encontraron __slots__ no válidas en %s. Ignorado." -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "nombre de archivo de la tabla de contenido (predeterminado: módulos)" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "error al formatear argumentos para %s: %s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "no crear un archivo de tabla de contenido" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "Error al obtener una firma de constructor para %s: %s" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "no cree encabezados para los paquetes de módulos/paquetes (por ejemplo, cuando las cadenas de documentación docstrings ya los contienen)" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "Error al obtener una firma de método para %s: %s" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "poner la documentación del módulo antes de la documentación del submódulo" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "interpretar las rutas del módulo de acuerdo con la especificación de espacios de nombres implícitos en la PEP-0420" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "Error al analizar un valor de argumento predeterminado para %r: %s" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "sufijo de archivo (por defecto: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "autodoc: no pudo determinar %s.%s (%r) para ser documentado, se planteó la siguiente excepción:\n%s" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "generar un proyecto completo con sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "argumentos de firma o anotación de retorno dada para automodule %s" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "agregue module_path al sys.path, que se usa cuando se da el parámetro --full" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ debe ser una lista de cadenas, no %r (en el módulo %s) -- ignorando __all__" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "nombre del proyecto (predeterminado: nombre del módulo raíz)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "atributo faltante mencionado en la :members: módulo %s, atributo %s" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "autor(es) del proyecto, utilizado cuando se da el parámetro --full" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "falta el atributo %s en el objeto %s" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "versión del proyecto, utilizado cuando se da el parámetro --full" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "alias de TypeVar(%s)" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "lanzamiento del proyecto, utilizado cuando se da el parámetro --full, por defecto es --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "opciones de extensión" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "Las páginas HTML están en %(outdir)s." -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." -msgstr "%s no es un directorio." +msgid "Failed to read build info file: %r" +msgstr "Error al leer la información de compilación del fichero: %r" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" -msgstr "" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "índice" -#: ext/apidoc/_extension.py:121 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "siguiente" -#: ext/apidoc/_extension.py:140 -#, python-format -msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "anterior" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "generando índices" -#: ext/apidoc/_extension.py:157 -#, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" -msgstr "" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "escribiendo páginas adicionales" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:192 -#, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "copiando archivos descargables... " -#: ext/apidoc/_extension.py:210 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "no se puede copiar archivo descargable %r: %s" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "Error al copiar un archivo en html_static_file: %s: %r" -#: ext/apidoc/_generate.py:69 -#, python-format -msgid "Would create file %s." -msgstr "Debería crear archivo %s." +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "copiar archivos estáticos" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:923 #, python-format -msgid "(in %s v%s)" -msgstr "(en %s versión %s)" +msgid "cannot copy static file %r" +msgstr "no se puede copiar archivo estático %r" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" -msgstr "(en %s)" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "copiando archivos extras" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:938 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "" +msgid "cannot copy extra file %r" +msgstr "no se puede copiar archivo extra %r" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:944 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "" +msgid "Failed to write build info file: %r" +msgstr "Error al escribir el archivo de información de compilación: %r" + +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "no se pudo cargar el índice de búsqueda, pero no se crearán todos los documentos: el índice estará incompleto." -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "página %s coincide con dos patrones en html_sidebars: %r y %r" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1204 #, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "Se produjo un error Unicode al representar la página %s. Asegúrese de que todos los valores de configuración que contengan contenido que no sea ASCII sean cadenas Unicode." -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:1217 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1225 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "%s externo: destino de referencia %s no encontrado: %s" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "Ha ocurrido un error al renderizar la pagina %s.\nRazón: %r" + +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "volcar inventario de objetos" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1266 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "dumping search index in %s" +msgstr "volcar el índice de búsqueda en %s" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +msgid "invalid js_file: %r, ignored" +msgstr "js_file inválido: %r, ignorado" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Muchos math_renderers están registrados. Pero no se ha seleccionado math_renderer." -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "Unknown math_renderer %r is given." +msgstr "Desconocido math_renderer %r es dado." -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "entrada html_extra_path %r se coloca dentro de outdir" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "entrada html_extra_path %r no existe" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "entrada html_static_path %r se coloca dentro de outdir" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" +msgstr "entrada html_static_path %r no existe" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" +msgid "logo file %r does not exist" +msgstr "archivo de logo %r no existe" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "el archivo %r usado para el favicon no existe" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "encontró algunos problemas con algunos de los inventarios, pero tenían alternativas de trabajo:" - -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "no se pudo llegar a ninguno de los inventarios con los siguientes problemas:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "el inventario intersphinx se ha movido: %s -> %s" +msgid "%s %s documentation" +msgstr "documentación de %s - %s" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "valor no válido para la opción de pedido de miembro: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r no tiene configuración de \"tema\"" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "valor no válido para la opción class-doc-from: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r no tiene configuración de \"%s\"" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "firma inválida para auto%s (%r)" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "error al formatear argumentos para %s: %s" +msgid "Failed to get a docname for source %r!" +msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "autodoc: no pudo determinar %s.%s (%r) para ser documentado, se planteó la siguiente excepción:\n%s" +msgid "No footnote was found for given reference node %r" +msgstr "" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Los archivos LaTeX están en %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "no sabe qué módulo importar para el autodocumento %r (intente colocar una directiva \"module\" o \"currentmodule\" en el documento o dar un nombre explícito al módulo)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nEjecuta el comando 'make' en este directorio para compilarlos usando (pdf)latex\n(usa el comando 'make latexpdf' aquí para hacer esto automáticamente)." -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" -msgstr "Se detecta un objeto simulado: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "no se encontró el valor de configuración \"latex_documents\"; no se escribirán documentos" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "error al formatear la firma para %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "valor de configuración \"latex_documents\" hace referencia a un documento desconocido %s" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "\"::\" en el nombre del automodule no tiene sentido" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "copiando archivos de soporte TeX" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "argumentos de firma o anotación de retorno dada para automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "copiando archivos adicionales" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ debe ser una lista de cadenas, no %r (en el módulo %s) -- ignorando __all__" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Clave de configuración desconocida: latex_elements[%r], ignorada." -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "atributo faltante mencionado en la :members: módulo %s, atributo %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "Opción de tema desconocida: latex_theme_options[%r], ignorado." -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "Error al obtener una firma de función para %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s ya tiene asignados números de sección (¿número de árbol anidado?)" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "Error al obtener una firma de constructor para %s: %s" +msgid "image file not readable: %s" +msgstr "archivo de imagen no legible: %s" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" -msgstr "Bases: %s" +msgid "image file %s not readable: %s" +msgstr "archivo de imagen %s no legible: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" -msgstr "falta el atributo %s en el objeto %s" +msgid "download file not readable: %s" +msgstr "el archivo de descarga no es legible: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" -msgstr "alias de %s" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "referencias circulares de toctree detectadas, ignorando: %s <- %s" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "alias de TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "toctree contiene una referencia al documento %r que no tiene título: no se generará ningún enlace" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "Error al obtener una firma de método para %s: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "el árbol de la tabla de contenido contiene una referencia a un documento no incluido %r" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "Se encontraron __slots__ no válidas en %s. Ignorado." +msgid "toctree contains reference to non-existing document %r" +msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "Error al analizar un valor de argumento predeterminado para %r: %s" +msgid "see %s" +msgstr "ver %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "Error al actualizar la firma para %r: parámetro no encontrado: %s" +msgid "see also %s" +msgstr "ver también %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "Error al analizar type_comment para %r: %s" +msgid "unknown index entry type %r" +msgstr "tipo de entrada de índice desconocido %r" diff --git a/sphinx/locale/es_CO/LC_MESSAGES/sphinx.mo b/sphinx/locale/es_CO/LC_MESSAGES/sphinx.mo index ebade7dade8..231c1f66695 100644 Binary files a/sphinx/locale/es_CO/LC_MESSAGES/sphinx.mo and b/sphinx/locale/es_CO/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/es_CO/LC_MESSAGES/sphinx.po b/sphinx/locale/es_CO/LC_MESSAGES/sphinx.po index c160295590a..7467b0ae369 100644 --- a/sphinx/locale/es_CO/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/es_CO/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Spanish (Colombia) (http://app.transifex.com/sphinx-doc/sphinx-1/language/es_CO/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: es_CO\n" "Plural-Forms: nplurals=3; plural=n == 1 ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2805,21 +2946,20 @@ msgstr[0] "" msgstr[1] "" msgstr[2] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2828,6 +2968,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2849,119 +2994,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2973,92 +3125,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3086,581 +3231,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3668,548 +3721,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/et/LC_MESSAGES/sphinx.mo b/sphinx/locale/et/LC_MESSAGES/sphinx.mo index d3a3c54a438..9230844e6d1 100644 Binary files a/sphinx/locale/et/LC_MESSAGES/sphinx.mo and b/sphinx/locale/et/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/et/LC_MESSAGES/sphinx.po b/sphinx/locale/et/LC_MESSAGES/sphinx.po index d3fbc7b3d9c..3258f1b49cd 100644 --- a/sphinx/locale/et/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/et/LC_MESSAGES/sphinx.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Ivar Smolin , 2013-2022\n" "Language-Team: Estonian (http://app.transifex.com/sphinx-doc/sphinx-1/language/et/)\n" @@ -22,6 +22,127 @@ msgstr "" "Language: et\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Pythoni täiustusettepanekud; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "fail %r teemarajal pole korrektni zip-fail või ei sisalda see teemat" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -36,127 +157,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "See projekt vajab laiendust %s vähemalt versiooniga %s ja seetõttu pole projekti võimalik laaditud versiooniga (%s) ehitada." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Sündmus %r on juba olemas" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Tundmatu sündmuse nimi: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Lähtekataloogi (%s) pole võimalik leida" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Väljundkataloog (%s) ei ole kataloog" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Lähtekataloog ja sihtkataloog ei tohi olla identsed" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx v%s käitamine" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "See projekt vajab vähemalt Sphinxi v%s ja seetõttu pole projekti võimalik käesoleva versiooniga ehitada." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "väljundkataloogi loomine" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "tõlgete laadimine [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "valmis" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "serialiseeritud keskkonna laadimine" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "tõrge: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Ehitajat pole valitud, kasutatakse vaikimisi ehitajat: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -164,12 +312,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "laiendus %s pole rööbiti lugemiseks turvaline" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -177,82 +325,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "laiendus %s pole rööbiti kirjutamiseks turvaline" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "seadistuste kataloog (%s) ei sisalda faili conf.py" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Ehitaja klassil %s puudub atribuut \"name\"" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Ehitaja %r on juba olemas (moodulis %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Ehitajat nimega %s pole registreeritud" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "domeen %s on juba registreeritud" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "domeen %s pole veel registreeritud" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser on %r jaoks juba registreeritud" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Lähtekoodi analüsaatorit pole %s jaoks registreeritud" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Algne erind:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Laiendust %s pole võimalik importida" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "erindil %r puudub funktsioon setup(); kas see on päriselt Sphinxi laiendusmoodul?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "seadistuste kataloog (%s) ei sisalda faili conf.py" + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "vigane arv %r seadistuse väärtusele %r, eiratakse" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Seadistuste väärtus %r on juba olemas" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Sinu seadistusfailis on süntaksi viga: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Seadistusfail (või mõni selle poolt imporditud moodulitest) kutsus välja sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -260,468 +540,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Sektsioon %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Joonis %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabel %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Nimekiri %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r ei leitud, eiratakse." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "fail %r teemarajal pole korrektni zip-fail või ei sisalda see teemat" - -#: theming.py:228 -#, python-format -msgid "no theme named %r found (missing theme.toml?)" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:268 +#: environment/__init__.py:350 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:355 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:282 +#: environment/__init__.py:361 #, python-format -msgid "The %r theme has too many ancestors" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:310 -#, python-format -msgid "no theme configuration file found in %r" -msgstr "" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "See keskkond pole valitud ehitajaga ühilduv, palun vali mõni teine dokumendipuu kataloog." -#: theming.py:335 theming.py:388 +#: environment/__init__.py:518 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:339 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "dokument pole ühegi sisukorrapuu osa" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:366 +#: environment/__init__.py:952 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Sündmus %r on juba olemas" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Tähelepanu" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Tundmatu sündmuse nimi: %s" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Ettevaatust" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Oht" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Viga" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Vihje" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Ehitaja klassil %s puudub atribuut \"name\"" +#: locale/__init__.py:234 +msgid "Important" +msgstr "Tähtis" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Ehitaja %r on juba olemas (moodulis %s)" +#: locale/__init__.py:235 +msgid "Note" +msgstr "Märkus" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "" +#: locale/__init__.py:236 +msgid "See also" +msgstr "Vaata ka" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Ehitajat nimega %s pole registreeritud" +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Nõuanne" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "domeen %s on juba registreeritud" +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Hoiatus" -#: registry.py:228 registry.py:249 registry.py:262 +#: builders/texinfo.py:41 #, python-format -msgid "domain %s not yet registered" -msgstr "domeen %s pole veel registreeritud" +msgid "The Texinfo files are in %(outdir)s." +msgstr "Texinfo failid asuvad kataloogis %(outdir)s." -#: registry.py:235 -#, python-format -msgid "The %r directive is already registered to domain %s" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:253 +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "seadistusparameetrit \"texinfo_documents\" ei leitud, dokumente ei kirjutata" + +#: builders/texinfo.py:85 #, python-format -msgid "The %r role is already registered to domain %s" -msgstr "" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "seadistusparameeter \"texinfo_documents\" viitab tundmatule dokumendile %s" -#: registry.py:266 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:344 +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "viidete lahendamine..." + +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (pealkirjas " + +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "kujutiste kopeerimine... " + +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r crossref_type is already registered" -msgstr "" +msgid "cannot copy image file %r: %s" +msgstr "kujutise faili %r pole võimalik kopeerida: %s" + +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "Texinfo tugifailide kopeerimine" -#: registry.py:353 +#: builders/texinfo.py:218 #, python-format -msgid "source_suffix %r is already registered" -msgstr "" +msgid "error writing file Makefile: %s" +msgstr "viga faili Makefile kirjutamisel: %s" -#: registry.py:363 +#: builders/manpage.py:37 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser on %r jaoks juba registreeritud" +msgid "The manual pages are in %(outdir)s." +msgstr "Juhendi lehed asuvad kataloogis %(outdir)s." + +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "seadistusparameetrit \"man_pages\" ei leitud, juhendi lehti ei kirjutata" -#: registry.py:372 +#: builders/manpage.py:64 #, python-format -msgid "Source parser for %s not registered" -msgstr "Lähtekoodi analüsaatorit pole %s jaoks registreeritud" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "seadistusparameeter \"man_pages\" viitab tundmatule dokumendile %s" -#: registry.py:390 +#: builders/singlehtml.py:35 #, python-format -msgid "Translator for %r already exists" +msgid "The HTML page is in %(outdir)s." +msgstr "HTML-leht asub kataloogis %(outdir)s." + +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "täiendavate failide kirjutamine" + +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "" +msgid "The message catalogs are in %(outdir)s." +msgstr "Sõnumikataloogid asuvad kataloogis %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "" +msgid "building [%s]: " +msgstr "ehitamine [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "" +msgid "targets for %d template files" +msgstr "%d mallifaili sihtfailid" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Algne erind:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "mallide lugemine... " -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "Laiendust %s pole võimalik importida" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "sõnumikataloogide kirjutamine... " -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "erindil %r puudub funktsioon setup(); kas see on päriselt Sphinxi laiendusmoodul?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Otsi vigu ülalolevast väljundist või failist %(outdir)s/output.txt" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Pythoni täiustusettepanekud; PEP %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[lähtekood]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[dokumentatsioon]" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Mooduli kood" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        %s lähtekood

        " +msgid "invalid css_file: %r, ignored" +msgstr "vigane css_file: %r, eiratakse" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Ülevaade: mooduli kood" +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." +msgstr "XML-failid asuvad kataloogis %(outdir)s." -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Kõik lähtekoodiga moodulid

        " +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" +msgstr "viga faili %s kirjutamisel: %s" -#: ext/extlinks.py:82 +#: builders/xml.py:103 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "PseudoXML-failid asuvad kataloogis %(outdir)s." + +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/_epub_base.py:436 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/_epub_base.py:467 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "cannot write image file %r: %s" +msgstr "kujutise faili %r pole võimalik kirjutada: %s" + +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 #, python-format -msgid "'%s' is not a valid option." +msgid "writing %s file..." +msgstr "faili %s kirjutamine..." + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "Tekstifailid asuvad kataloogis %(outdir)s." + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: ext/doctest.py:139 +#: builders/__init__.py:237 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "a suitable image for %s builder not found: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "vigane TestCode tüüp" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "ehitamine [mo]: " -#: ext/doctest.py:297 +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "väljundi kirjutamine... " + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "%d määratud po-faili sihtfailid" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "%d po-faili sihtfailid on aegunud" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "kõik lähtefailid" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Lähtefailide doctest-testimine on lõppenud, vaata tulemusi failist %(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" +msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "vigase doctest koodi eiramine: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "%d lähtefaili sihtfailid on aegunud" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "praeguseks aegunud failide otsimine... " + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "leitud %d" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "ei leitud" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "kooskõla kontrollimine" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "aegunud sihtfaile pole" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "keskkonna uuendamine:" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "lisatud %s, muudetud %s, eemaldatud %s" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "lähtefailide lugemine..." + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "dokumentide ettevalmistamine" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "Ülevaatefail asub kataloogis %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "versioonis %s pole muutusi." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "kokkuvõttefaili kirjutamine..." + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Sisseehitatud" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Mooduli tase" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "lähtefailide kopeerimine..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -742,9 +1178,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -779,6 +1216,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Teha" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "Leitud TEHA kirje: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<> asub failis %s, real %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "algne kirje" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -866,879 +1331,960 @@ msgstr "[joonis: %s]" msgid "[graph]" msgstr "[joonis]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Teha" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" -msgstr "Leitud TEHA kirje: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<> asub failis %s, real %d.)" +msgid "inline latex %r: %s" +msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "algne kirje" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" -msgstr "Vigane selgitustekst: %s" +msgid "'%s' is not a valid option." +msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "vigane TestCode tüüp" + +#: ext/doctest.py:297 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Suvandeid \"%s\" ja \"%s\" pole võimalik korraga kasutada" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Lähtefailide doctest-testimine on lõppenud, vaata tulemusi failist %(outdir)s/output.txt." -#: directives/code.py:231 +#: ext/doctest.py:451 #, python-format -msgid "Include file '%s' not found or reading it failed" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:568 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +msgid "ignoring invalid doctest code: %r" +msgstr "vigase doctest koodi eiramine: %r" -#: directives/code.py:276 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Object named %r not found in include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/code.py:314 +#: ext/duration.py:47 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/patches.py:71 +#: ext/duration.py:117 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:124 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:139 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[lähtekood]" + +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Sektsiooni autor: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[dokumentatsioon]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Mooduli autor: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Mooduli kood" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Koodi autor: " +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        %s lähtekood

        " -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor: " +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Ülevaade: mooduli kood" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Kõik lähtekoodiga moodulid

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:92 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "Ülevaatefail asub kataloogis %(outdir)s." +msgid "Citation [%s] is not referenced." +msgstr "" -#: builders/changes.py:56 +#: domains/math.py:73 #, python-format -msgid "no changes in version %s." -msgstr "versioonis %s pole muutusi." +msgid "duplicate label of equation %s, other instance in %s" +msgstr "võrrandil %s on topeltsilt, teine instants on %s" -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "kokkuvõttefaili kirjutamine..." +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "Vigane math_eqref_format: %r" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Sisseehitatud" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (sisseehitatud funktsioon)" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Mooduli tase" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s meetod)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "lähtefailide kopeerimine..." +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (klass)" -#: builders/changes.py:133 +#: domains/javascript.py:188 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (globaalmuutuja või konstant)" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Juhendi lehed asuvad kataloogis %(outdir)s." +msgid "%s (%s attribute)" +msgstr "%s (%s atribuut)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "seadistusparameetrit \"man_pages\" ei leitud, juhendi lehti ei kirjutata" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumendid" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "seadistusparameeter \"man_pages\" viitab tundmatule dokumendile %s" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Tagastab" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Tagastustüüp" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (moodul)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "ehitamine [mo]: " +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funktsioon" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "väljundi kirjutamine... " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "meetod" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" -msgstr "" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klass" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" -msgstr "%d määratud po-faili sihtfailid" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "andmed" -#: builders/__init__.py:309 -#, python-format -msgid "targets for %d po files that are out of date" -msgstr "%d po-faili sihtfailid on aegunud" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribuut" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "kõik lähtefailid" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "moodul" -#: builders/__init__.py:330 +#: domains/javascript.py:458 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "%s (directive)" +msgstr "%s (direktiiv)" + +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:348 +#: domains/rst.py:224 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" +msgid "%s (role)" +msgstr "%s (roll)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "direktiiv" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:361 +#: domains/rst.py:236 +msgid "role" +msgstr "roll" + +#: domains/rst.py:262 #, python-format -msgid "%d source files given on command line" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:377 +#: domains/changeset.py:32 #, python-format -msgid "targets for %d source files that are out of date" -msgstr "%d lähtefaili sihtfailid on aegunud" +msgid "Added in version %s" +msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/changeset.py:33 #, python-format -msgid "building [%s]: " -msgstr "ehitamine [%s]: " +msgid "Changed in version %s" +msgstr "Muudetud versioonis %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "praeguseks aegunud failide otsimine... " +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "Iganenud alates versioonist %s" -#: builders/__init__.py:410 +#: domains/changeset.py:35 #, python-format -msgid "%d found" -msgstr "leitud %d" +msgid "Removed in version %s" +msgstr "" -#: builders/__init__.py:412 -msgid "none found" -msgstr "ei leitud" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "kooskõla kontrollimine" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "aegunud sihtfaile pole" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "keskkonna uuendamine:" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "dokumentatsiooni lähtefailide rada" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "lisatud %s, muudetud %s, eemaldatud %s" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "väljundkataloogi rada" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:109 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +#: cmd/build.py:114 +msgid "general options" +msgstr "üldsuvandid" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:558 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "lähtefailide lugemine..." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "kõikide failide kirjutamine (vaikimisi kirjutatakse ainult uued ja muutunud failid)" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" -msgstr "" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "salvestatud keskkonda ei kasutata, alati loetakse kõik failid" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "dokumentide ettevalmistamine" - -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "seadistusfailis määratud väärtuse asendamine" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "väärtuse edastamine HTML-mallidesse" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:212 +msgid "console output options" +msgstr "konsooliväljundi suvandid" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "vigane css_file: %r, eiratakse" - -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "XML-failid asuvad kataloogis %(outdir)s." +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "hoiatuste (ja vigade) kirjutamine määratud faili" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "viga faili %s kirjutamisel: %s" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "hoiatuste muutmine vigadeks" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "PseudoXML-failid asuvad kataloogis %(outdir)s." +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "erindi korral täieliku tagasijälituse näitamine" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Texinfo failid asuvad kataloogis %(outdir)s." +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "erindi korral Pdb käivitamine" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "seadistusparameetrit \"texinfo_documents\" ei leitud, dokumente ei kirjutata" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "seadistusparameeter \"texinfo_documents\" viitab tundmatule dokumendile %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "suvandit -a ja failinimesid pole võimalik kombineerida" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 +#: cmd/build.py:357 #, python-format -msgid "processing %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "viidete lahendamine..." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "-D suvandi argument peab olema vormingus nimi=väärtus" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (pealkirjas " +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "-A suvandi argument peab olema vormingus nimi=väärtus" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "kujutiste kopeerimine... " +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "moodulite dokumentatsioonistringide automaatne lisamine" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "kujutise faili %r pole võimalik kopeerida: %s" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "dokumentatsioonistringides olevate koodijuppide automaattestimine" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "Texinfo tugifailide kopeerimine" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "eri projektide Sphinx-dokumentatsiooni omavaheline viitamine" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "viga faili Makefile kirjutamisel: %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "\"teha\" sissekannete kirjutamine, mida võib ehitamisega peita või näidata" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "dokumentatsiooni katvuse kontrollid" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "matemaatika kaasamine, mis renderdatakse PNG- või SVG-kujutisteks" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "kujutise faili %r pole võimalik kirjutada: %s" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "matemaatika kaasamine, mis renderdatakse veebisirvikus MathJax-i abil" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "sisu tingimuslik kaasamine seadistusparameetrite alusel" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "dokumenteeritud Python-objektide lähtekoodile viitamise kaasamine" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr ".nojekyll faili loomine dokumentide avaldamiseks GitHub-i lehtedel" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Palun sisesta mingi tekst." + +#: cmd/quickstart.py:134 #, python-format -msgid "unknown mimetype for %s, ignoring" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Palun sisesta kas 'y' või 'n'." -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:794 +#: cmd/quickstart.py:230 #, python-format -msgid "writing %s file..." -msgstr "faili %s kirjutamine..." +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Tere tulemast kasutama Sphinx %s lendstardi utiliiti." -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Palun sisesta väärtused järgnevate sätete jaoks (kandiliste sulgude vahel\nvõib olla vaikeväärtus, millega nõustumiseks vajuta lihtsalt Enter)." -#: builders/gettext.py:244 +#: cmd/quickstart.py:242 #, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Sõnumikataloogid asuvad kataloogis %(outdir)s." +msgid "Selected root path: %s" +msgstr "Valitud juurkataloog: %s" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "%d mallifaili sihtfailid" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "mallide lugemine... " +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "sõnumikataloogide kirjutamine... " +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Viga: valitud juurkataloogist leiti olemasolev conf.py." -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "HTML-leht asub kataloogis %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart ei kirjuta olemasolevaid Sphinx-projekte üle." -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Palun sisesta uus juurkataloog (või vajuta Enter lõpetamiseks)" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "täiendavate failide kirjutamine" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Sphinx'i väljundi ehitamise kataloogi asetamiseks on kaks valikut.\nVõid kasutada kataloogi \"_build\" juurkataloogis või eraldiseisvaid \n\"source\" ja \"build\" katalooge juurkataloogis." -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Otsi vigu ülalolevast väljundist või failist %(outdir)s/output.txt" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Lähtekoodi ja ehitamise kataloogide eraldamine (y/n)" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Mallide ja staatilise kataloogi nime eesliide" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Tekstifailid asuvad kataloogis %(outdir)s." +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Projekti nimi" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Autorite nimed" -#: transforms/i18n.py:272 -#, python-brace-format +#: cmd/quickstart.py:309 msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Projekti versioon" + +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Projekti väljalase" + +#: cmd/quickstart.py:324 msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Projekti keel" + +#: cmd/quickstart.py:340 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d. %b %Y" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Lähtefaili järelliide" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Sinu põhidokumendi nimi (ilma järelliiteta)" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Viga: valitud juurkataloogist leiti peafail %s." -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart ei kirjuta olemasolevat faili üle." -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Palun sisesta uus failinimi või nimeta olemasolev fail ümber ja vajuta Enter" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Märkus: imgmath ja mathjax ei saa korraga lubatud olla. imgmath eemaldati valikust." -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Kas luua Makefile? (y/n)" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Kas luua Windowsi käsufail? (y/n)" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." +msgstr "Faili %s loomine." -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." +msgstr "Fail %s on juba olemas ja jäetakse vahele." -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Lõpetamine: Algne kataloogistruktuur on loodud." + +#: cmd/quickstart.py:520 +#, python-format msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Sa peaks nüüd asustama oma peafaili %s ja looma ülejäänud dokumentatsiooni\nlähtefailid. " -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Dokumentide ehitamiseks kasuta Makefile, näiteks:\n make ehitaja" -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Dokumentide ehitamiseks kasuta käsku sphinx-build, näiteks:\n sphinx-build -b builder %s %s" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "kus \"ehitaja\" on üks toetatud ehitajatest, nt. html, latex või linkcheck." -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nSphinx-projekti jaoks vajalike failide genereerimine.\n\nsphinx-quickstart on interaktiivne tööriist, mis küsib mõned küsimused Sinu\nprojekti kohta ja seepeale genereerib täieliku dokumentatsioonikataloogi ning\nnäidis-Makefile kasutamiseks koos sphinx-buildiga.\n" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "vaikne režiim" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Struktuuri suvandid" -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "kasutamise korral eraldatakse lähtefailide ja ehitamise kataloogid" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Projekti põhisuvandid" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "projekti nimi" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "autorite nimed" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "projekti versioon" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "projekti väljalase" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "dokumendi keel" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "lähtefaili järelliide" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "See keskkond pole valitud ehitajaga ühilduv, palun vali mõni teine dokumendipuu kataloog." +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "põhidokumendi nimi" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Laienduste suvandid" + +#: cmd/quickstart.py:671 #, python-format -msgid "Domain %r is not registered" -msgstr "" +msgid "enable %s extension" +msgstr "laienduse %s lubamine" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "dokument pole ühegi sisukorrapuu osa" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "suvaliste laienduste määramine" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Makefile ja Batchfile loomine" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "makefile loomine" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "makefile loomata jätmine" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "batchfile loomine" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "batchfile loomata jätmine" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "viga lugemisel: %s, %s" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Projekti loomine mallist" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "viga kirjutamisel: %s, %s" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "mallifailide kataloog" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "malli muutuja kirjeldamine" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/i18n.py:245 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docfields.py:103 +#: cmd/quickstart.py:810 #, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +msgid "Invalid template variable: %s" +msgstr "Vigane mallimuutuja: %s" + +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/nodes.py:423 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/nodes.py:490 +#: directives/other.py:156 #, python-format -msgid "toctree contains ref to nonexisting file %r" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/nodes.py:706 +#: directives/other.py:169 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Sektsiooni autor: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Mooduli autor: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Koodi autor: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/display.py:87 -msgid "failed" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: util/osutil.py:131 -#, python-format +#: directives/patches.py:70 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: util/docutils.py:345 +#: directives/code.py:87 #, python-format -msgid "unknown role name: %s" -msgstr "" +msgid "Invalid caption: %s" +msgstr "Vigane selgitustekst: %s" -#: util/docutils.py:789 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown node type: %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: util/fileutil.py:76 +#: directives/code.py:216 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Suvandeid \"%s\" ja \"%s\" pole võimalik korraga kasutada" -#: util/fileutil.py:89 +#: directives/code.py:231 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/rst.py:73 +#: directives/code.py:235 #, python-format -msgid "default role %s not found" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: util/inventory.py:147 +#: directives/code.py:276 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "Object named %r not found in include file %r" msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Joonealused märkused" - -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" -msgstr "[pilt: %s]" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[pilt]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d. %b %Y" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1747,11 +2293,15 @@ msgstr "[pilt]" msgid "Index" msgstr "Indeks" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Joonealused märkused" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "" @@ -1761,53 +2311,14 @@ msgstr "" msgid "unimplemented node type: %r" msgstr "" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr ":maxdepth: on liiga suur ja seda eiratakse." - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown index entry type %s found" -msgstr "" +msgid "[image: %s]" +msgstr "[pilt: %s]" -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "Vigane math_eqref_format: %r" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[pilt]" #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" @@ -1835,6 +2346,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1851,794 +2367,478 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "võrrandil %s on topeltsilt, teine instants on %s" +msgid "no Babel option known for language %r" +msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (sisseehitatud funktsioon)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":maxdepth: on liiga suur ja seda eiratakse." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s meetod)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (klass)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (globaalmuutuja või konstant)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s atribuut)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumendid" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Tagastab" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Tagastustüüp" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (moodul)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funktsioon" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "meetod" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klass" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "andmed" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atribuut" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "moodul" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Muudetud versioonis %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Iganenud alates versioonist %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktiiv)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (roll)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "direktiiv" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:236 -msgid "role" -msgstr "roll" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/citation.py:92 +#: writers/latex.py:1228 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Tähelepanu" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Ettevaatust" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Oht" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Viga" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Vihje" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Tähtis" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Märkus" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Vaata ka" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Nõuanne" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Hoiatus" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "moodulite dokumentatsioonistringide automaatne lisamine" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "dokumentatsioonistringides olevate koodijuppide automaattestimine" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "eri projektide Sphinx-dokumentatsiooni omavaheline viitamine" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "\"teha\" sissekannete kirjutamine, mida võib ehitamisega peita või näidata" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "dokumentatsiooni katvuse kontrollid" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "matemaatika kaasamine, mis renderdatakse PNG- või SVG-kujutisteks" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "matemaatika kaasamine, mis renderdatakse veebisirvikus MathJax-i abil" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "sisu tingimuslik kaasamine seadistusparameetrite alusel" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "dokumenteeritud Python-objektide lähtekoodile viitamise kaasamine" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr ".nojekyll faili loomine dokumentide avaldamiseks GitHub-i lehtedel" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Palun sisesta mingi tekst." - -#: cmd/quickstart.py:133 +#: writers/latex.py:1615 #, python-format -msgid "Please enter one of %s." -msgstr "" - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Palun sisesta kas 'y' või 'n'." - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Tere tulemast kasutama Sphinx %s lendstardi utiliiti." - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Palun sisesta väärtused järgnevate sätete jaoks (kandiliste sulgude vahel\nvõib olla vaikeväärtus, millega nõustumiseks vajuta lihtsalt Enter)." - -#: cmd/quickstart.py:241 +#: writers/latex.py:1950 #, python-format -msgid "Selected root path: %s" -msgstr "Valitud juurkataloog: %s" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Viga: valitud juurkataloogist leiti olemasolev conf.py." - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart ei kirjuta olemasolevaid Sphinx-projekte üle." - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Palun sisesta uus juurkataloog (või vajuta Enter lõpetamiseks)" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Sphinx'i väljundi ehitamise kataloogi asetamiseks on kaks valikut.\nVõid kasutada kataloogi \"_build\" juurkataloogis või eraldiseisvaid \n\"source\" ja \"build\" katalooge juurkataloogis." - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Lähtekoodi ja ehitamise kataloogide eraldamine (y/n)" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Mallide ja staatilise kataloogi nime eesliide" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Projekti nimi" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Autorite nimed" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Projekti versioon" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Projekti väljalase" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Projekti keel" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Lähtefaili järelliide" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Sinu põhidokumendi nimi (ilma järelliiteta)" - -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Viga: valitud juurkataloogist leiti peafail %s." - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart ei kirjuta olemasolevat faili üle." - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Palun sisesta uus failinimi või nimeta olemasolev fail ümber ja vajuta Enter" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Märkus: imgmath ja mathjax ei saa korraga lubatud olla. imgmath eemaldati valikust." - -#: cmd/quickstart.py:406 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Kas luua Makefile? (y/n)" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Kas luua Windowsi käsufail? (y/n)" - -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." -msgstr "Faili %s loomine." - -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "Fail %s on juba olemas ja jäetakse vahele." - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Lõpetamine: Algne kataloogistruktuur on loodud." - -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "Sa peaks nüüd asustama oma peafaili %s ja looma ülejäänud dokumentatsiooni\nlähtefailid. " - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Dokumentide ehitamiseks kasuta Makefile, näiteks:\n make ehitaja" - -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Dokumentide ehitamiseks kasuta käsku sphinx-build, näiteks:\n sphinx-build -b builder %s %s" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "kus \"ehitaja\" on üks toetatud ehitajatest, nt. html, latex või linkcheck." - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nSphinx-projekti jaoks vajalike failide genereerimine.\n\nsphinx-quickstart on interaktiivne tööriist, mis küsib mõned küsimused Sinu\nprojekti kohta ja seepeale genereerib täieliku dokumentatsioonikataloogi ning\nnäidis-Makefile kasutamiseks koos sphinx-buildiga.\n" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "vaikne režiim" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Struktuuri suvandid" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "kasutamise korral eraldatakse lähtefailide ja ehitamise kataloogid" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Projekti põhisuvandid" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "projekti nimi" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "autorite nimed" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "projekti versioon" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "projekti väljalase" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "dokumendi keel" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "lähtefaili järelliide" +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "põhidokumendi nimi" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Laienduste suvandid" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" + +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "" -#: cmd/quickstart.py:670 +#: util/inventory.py:147 #, python-format -msgid "enable %s extension" -msgstr "laienduse %s lubamine" +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "suvaliste laienduste määramine" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Makefile ja Batchfile loomine" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "viga lugemisel: %s, %s" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "makefile loomine" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "viga kirjutamisel: %s, %s" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "makefile loomata jätmine" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "batchfile loomine" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "batchfile loomata jätmine" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Projekti loomine mallist" +#: util/display.py:82 +msgid "skipped" +msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "mallifailide kataloog" +#: util/display.py:87 +msgid "failed" +msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "malli muutuja kirjeldamine" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:792 +#: util/fileutil.py:76 +#, python-format msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:809 +#: util/fileutil.py:89 #, python-format -msgid "Invalid template variable: %s" -msgstr "Vigane mallimuutuja: %s" - -#: cmd/build.py:64 -msgid "job number should be a positive number" +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:74 +#: util/docfields.py:103 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "dokumentatsiooni lähtefailide rada" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "väljundkataloogi rada" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "" -#: cmd/build.py:109 +#: util/nodes.py:462 +#, python-format msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:114 -msgid "general options" -msgstr "üldsuvandid" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "jätk eelmisele leheküljele" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "jätkub järgmisel leheküljel" + +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "kõikide failide kirjutamine (vaikimisi kirjutatakse ainult uued ja muutunud failid)" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Sümbolid" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "salvestatud keskkonda ei kasutata, alati loetakse kõik failid" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "lehekülg" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Redaktsioon" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "" + +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:157 +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Tundmatu pildivorming: %s..." + +#: transforms/post_transforms/__init__.py:88 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "seadistusfailis määratud väärtuse asendamine" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "väärtuse edastamine HTML-mallidesse" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "Katkestatud!" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" -msgstr "konsooliväljundi suvandid" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Kui see oli kasutaja viga, siis anna palun sellest teada, et tulevikus oleks võimalik parem veateade väljastada." -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "hoiatuste (ja vigade) kirjutamine määratud faili" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Varja külgriba" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "hoiatuste muutmine vigadeks" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigatsioon" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "erindi korral täieliku tagasijälituse näitamine" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Otsi %(docstitle)s piires" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "erindi korral Pdb käivitamine" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Info selle dokumentatsiooni kohta" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Otsing" + +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Autoriõigus" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "suvandit -a ja failinimesid pole võimalik kombineerida" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Viimati uuendatud %(last_updated)s." -#: cmd/build.py:357 +#: themes/basic/layout.html:204 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "-D suvandi argument peab olema vormingus nimi=väärtus" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Eelmine teema" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "-A suvandi argument peab olema vormingus nimi=väärtus" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "eelmine jaotis" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Varja külgriba" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Järgmine teema" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Sisukorratabel" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "järgmine jaotis" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Otsing" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Otsi" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Täisindeks ühel lehel" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Käesolev leht" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Näita lähtekoodi" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Sisukord" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Kiirotsing" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Otsi %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Otsi" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2685,7 +2885,7 @@ msgstr "Globaalne moodulite indeks" msgid "quick access to all modules" msgstr "kiire ligipääs kõigile moodulitele" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Üldindeks" @@ -2693,82 +2893,23 @@ msgstr "Üldindeks" msgid "all functions, classes, terms" msgstr "kõik funktsioonid, klassid ja terminid" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Käesolev leht" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Täisindeks ühel lehel" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Kiirotsing" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Indeksi leheküljed algustähe kaupa" - -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "võib olla väga suur" - -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Eelmine teema" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "eelmine jaotis" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Järgmine teema" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "järgmine jaotis" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigatsioon" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Otsi %(docstitle)s piires" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Info selle dokumentatsiooni kohta" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Autoriõigus" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Sisukorratabel" -#: themes/basic/layout.html:201 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Viimati uuendatud %(last_updated)s." +msgid "Search %(docstitle)s" +msgstr "Otsi %(docstitle)s" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Indeksi leheküljed algustähe kaupa" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "võib olla väga suur" #: themes/basic/search.html:20 msgid "" @@ -2786,21 +2927,21 @@ msgstr "" msgid "search" msgstr "otsi" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Varja otsingu tulemused" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Sisukord" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Otsingu tulemused" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Sinu otsingule ei vastanud ükski dokument. Palun veendu, et kõik sisestatud sõnad on õigesti kirjutatud ja sa oled valinud piisavalt kategooriaid." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2808,22 +2949,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Otsimine" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Otsingu ettevalmistamine..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s &8212; %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Varja otsingu tulemused" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2831,6 +2971,11 @@ msgstr "%(filename)s &8212; %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Muutused versioonis %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s &8212; %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2852,119 +2997,126 @@ msgstr "Ülejäänud muutused" msgid "Expand sidebar" msgstr "Näita külgriba" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parameetrid" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Muutujad" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (moodulis %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (moodulis %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (sisseehitatud muutuja)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (sisseehitatud klass)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (klass moodulis %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (klassi %s meetod)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s staatiline meetod)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Pythoni moodulite indeks" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moodulid" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Iganenud" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "erind" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "klassi meetod" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "staatiline meetod" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (iganenud)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parameetrid" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Muutujad" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2976,92 +3128,85 @@ msgstr "Malli parameetrid" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "liige" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tüüp" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "loend" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "funktsiooni parameeter" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "muutuja" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "makro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "keskkonnamuutuja; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3146,576 +3291,363 @@ msgstr "vigane numfig_format: %s (%r)" msgid "invalid numfig_format: %s" msgstr "vigane numfig_format: %s" -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "vaata %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "vaata ka %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Sümbolid" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "kujutise fail pole loetav: %s" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "kujutise fail %s pole loetav: %s" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "Katkestatud!" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Kui see oli kasutaja viga, siis anna palun sellest teada, et tulevikus oleks võimalik parem veateade väljastada." - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" - -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "" - -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "" - -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "" - -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "" - -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "" - -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." -msgstr "Tundmatu pildivorming: %s..." - -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "HTML-lehed asuvad kataloogis %(outdir)s." - -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" -msgstr "Viga ehitamise infofaili lugemisel: %r" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "" - -#: builders/html/__init__.py:366 -msgid "building [html]: " -msgstr "" - -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "" - -#: builders/html/__init__.py:507 -msgid "index" -msgstr "indeks" - -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "" - -#: builders/html/__init__.py:589 -msgid "next" -msgstr "järgmine" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "eelmine" - -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "indeksite genereerimine" - -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "täiendavate lehtede kirjutamine" - -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "allalaaditavate failide kopeerimine..." - -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1456 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:864 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "cannot copy static file %r" -msgstr "staatilist faili %r pole võimalik kopeerida" +msgid "malformed string literal (missing opening quote): %s" +msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "lisafailide kopeerimine" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Näide" -#: builders/html/__init__.py:949 -#, python-format -msgid "cannot copy extra file %r" -msgstr "lisafaili %r pole võimalik kopeerida" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Näited" -#: builders/html/__init__.py:955 -#, python-format -msgid "Failed to write build info file: %r" -msgstr "Viga ehitamise infofaili kirjutamisel: %r" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Võtmesõnadega argumendid" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Märkused" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "lehe %s renderdamisel tekkis Unicode viga. Palun veendu, et kõik mitte-ASCII sisuga seadistusparameetrid on kirjeldatud Unicode stringidena." - -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "otsinguindeksi tõmmise kirjutamine keelele %s" - -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "vigane js_file: %r, eiratakse" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:1346 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "Unknown math_renderer %r is given." +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1360 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "html_extra_path kirje %r asub väljaspool väljundkataloogi" +msgid "alias of %s" +msgstr "" -#: builders/html/__init__.py:1365 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "html_extra_path kirjet %r pole olemas" +msgid "Bases: %s" +msgstr "Põlvnemine: %s" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "logofaili %r pole olemas" - -#: builders/html/__init__.py:1407 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "favicon file %r does not exist" -msgstr "favicon faili %r pole olemas" +msgid "invalid signature for auto%s (%r)" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:93 #, python-format -msgid "%s %s documentation" -msgstr "%s %s dokumentatsioon" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "LaTeX-failid asuvad kataloogis %(outdir)s." +msgid "Would create file %s." +msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nNende jooksutamiseks läbi (pdf)latex programmi käivita selles kataloogis\n'make' (selle automaatseks tegemiseks kasuta `make latexpdf')." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "seadistusparameetrit \"latex_documents\" ei leitud, dokumente ei kirjutata" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "seadistusparameeter \"latex_documents\" viitab tundmatule dokumendile %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Redaktsioon" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "TeX-i tugifailide kopeerimine" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "lisafailide kopeerimine" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "jätk eelmisele leheküljele" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "jätkub järgmisel leheküljel" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "lehekülg" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Võtmesõnadega argumendid" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Näide" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "laienduse suvandid" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Näited" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" +msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Märkused" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "%s pole kataloog." -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" -msgstr "tõrge objekti %s importimisel" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] automaatkokkuvõtte genereerimine failile: %s" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] kirjutamine kataloogi %s" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3723,7 +3655,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3738,481 +3670,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "lähtefailid, mille kohta rST-faile genereerida" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "väljundfailide kataloog" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "failide vaikimisi järelliide (vaikimisi: %(default)s)" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "kohandatud mallide kataloog (vaikimisi: %(default)s)" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "imporditud liikmete dokumenteerimine (vaikimisi: %(default)s)" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:329 +#, python-format +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" +msgstr "tõrge objekti %s importimisel" + +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "laienduse suvandid" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_loader.py:193 #, python-format -msgid "%s is not a directory." -msgstr "%s pole kataloog." +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:157 -#, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_extension.py:178 -#, python-format -msgid "apidoc_modules item %i '%s' must be an int" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_extension.py:192 -#, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_extension.py:210 +#: builders/html/__init__.py:114 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "HTML-lehed asuvad kataloogis %(outdir)s." -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:337 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "Failed to read build info file: %r" +msgstr "Viga ehitamise infofaili lugemisel: %r" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:372 #, python-format -msgid "Would create file %s." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s v%s)" -msgstr "(projektis %s v%s)" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "indeks" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:549 #, python-format -msgid "(in %s)" +msgid "Logo of %s" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:578 +msgid "next" +msgstr "järgmine" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "eelmine" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "indeksite genereerimine" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "täiendavate lehtede kirjutamine" + +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "allalaaditavate failide kopeerimine..." + +#: builders/html/__init__.py:807 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:871 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "" +msgid "cannot copy static file %r" +msgstr "staatilist faili %r pole võimalik kopeerida" + +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "lisafailide kopeerimine" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "cannot copy extra file %r" +msgstr "lisafaili %r pole võimalik kopeerida" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "Viga ehitamise infofaili kirjutamisel: %r" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "lehe %s renderdamisel tekkis Unicode viga. Palun veendu, et kõik mitte-ASCII sisuga seadistusparameetrid on kirjeldatud Unicode stringidena." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +msgid "dumping search index in %s" +msgstr "otsinguindeksi tõmmise kirjutamine keelele %s" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "" +msgid "invalid js_file: %r, ignored" +msgstr "vigane js_file: %r, eiratakse" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1365 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "html_extra_path kirje %r asub väljaspool väljundkataloogi" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1370 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "html_extra_path kirjet %r pole olemas" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "" +msgid "logo file %r does not exist" +msgstr "logofaili %r pole olemas" + +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "favicon faili %r pole olemas" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s dokumentatsioon" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "LaTeX-failid asuvad kataloogis %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nNende jooksutamiseks läbi (pdf)latex programmi käivita selles kataloogis\n'make' (selle automaatseks tegemiseks kasuta `make latexpdf')." + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "seadistusparameetrit \"latex_documents\" ei leitud, dokumente ei kirjutata" + +#: builders/latex/__init__.py:167 +#, python-format +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "seadistusparameeter \"latex_documents\" viitab tundmatule dokumendile %s" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "TeX-i tugifailide kopeerimine" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "lisafailide kopeerimine" + +#: builders/latex/__init__.py:529 +#, python-format +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:537 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:98 #, python-format -msgid "Bases: %s" -msgstr "Põlvnemine: %s" +msgid "image file not readable: %s" +msgstr "kujutise fail pole loetav: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:126 #, python-format -msgid "missing attribute %s in object %s" -msgstr "" +msgid "image file %s not readable: %s" +msgstr "kujutise fail %s pole loetav: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of TypeVar(%s)" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "" +msgid "see %s" +msgstr "vaata %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see also %s" +msgstr "vaata ka %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/eu/LC_MESSAGES/sphinx.mo b/sphinx/locale/eu/LC_MESSAGES/sphinx.mo index b2fdc51d863..9dff32fa852 100644 Binary files a/sphinx/locale/eu/LC_MESSAGES/sphinx.mo and b/sphinx/locale/eu/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/eu/LC_MESSAGES/sphinx.po b/sphinx/locale/eu/LC_MESSAGES/sphinx.po index 5aced68d7ab..db4b739728d 100644 --- a/sphinx/locale/eu/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/eu/LC_MESSAGES/sphinx.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:38+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Asier Iturralde Sarasola , 2018\n" "Language-Team: Basque (http://app.transifex.com/sphinx-doc/sphinx-1/language/eu/)\n" @@ -20,6 +20,127 @@ msgstr "" "Language: eu\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Hobekuntza Proposamena; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -34,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +310,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +323,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,468 +538,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Adi" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Kontuz" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Arriskua" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Errorea" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Argibidea" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Garrantzitsua" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Oharra" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Ikusi baita ere" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Iradokizuna" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Kontuz" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (hemen: " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Hobekuntza Proposamena; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[iturburua]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[dokumentazioa]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Moduluko kodea" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        %s(r)en iturburu kodea

        " +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Gainbegirada: moduluko kodea" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Kodea eskuragarri duten modulu guztiak

        " +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "invalid css_file: %r, ignored" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/xml.py:29 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Modulu maila" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -740,9 +1176,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -777,6 +1214,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Egitekoa" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "jatorrizko sarrera" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -864,1779 +1329,1514 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Egitekoa" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "jatorrizko sarrera" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Atalaren egilea: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[iturburua]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Moduluaren egilea: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Kodearen egilea: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[dokumentazioa]" -#: directives/other.py:209 -msgid "Author: " -msgstr "Egilea:" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Moduluko kodea" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        %s(r)en iturburu kodea

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Gainbegirada: moduluko kodea" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Kodea eskuragarri duten modulu guztiak

        " + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:92 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:56 +#: domains/math.py:73 #, python-format -msgid "no changes in version %s." +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Modulu maila" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s metodoa)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (klasea)" -#: builders/changes.py:133 +#: domains/javascript.py:188 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (aldagai globala edo konstantea)" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s atributua)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumentuak" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Jaurtitzen du" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Itzultzen du" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Itzulketa mota" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (modulua)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funtzioa" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metodoa" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klasea" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "datuak" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atributua" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modulua" + +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:275 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "all of %d po files" +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are specified" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:309 +#: domains/rst.py:224 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (role)" +msgstr "%s (rola)" + +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:330 +#: domains/rst.py:236 +msgid "role" +msgstr "rola" + +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/changeset.py:32 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:348 +#: domains/changeset.py:33 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "Changed in version %s" +msgstr "%s bertsioan aldatuta" -#: builders/__init__.py:361 +#: domains/changeset.py:34 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Deprecated since version %s" +msgstr "%s bertsiotik aurrera zaharkituta" -#: builders/__init__.py:377 +#: domains/changeset.py:35 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/__init__.py:322 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:410 -#, python-format -msgid "%d found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: cmd/build.py:357 #, python-format -msgid "error writing file %s: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (hemen: " +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:464 +#: cmd/quickstart.py:134 #, python-format -msgid "cannot write image file %r: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:242 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%Y %b %d" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" - -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" - -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" - -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" - -#: _cli/__init__.py:231 -msgid "" -msgstr "" - -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" - -#: environment/__init__.py:86 -msgid "new config" -msgstr "" - -#: environment/__init__.py:87 -msgid "config changed" -msgstr "" - -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "" - -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" - -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "" - -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" - -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" - -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" - -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "" - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "" - -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "" - -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "" - -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" - -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "" - -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "" - -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" - -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" - -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "" - -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: util/nodes.py:423 +#: cmd/quickstart.py:520 #, python-format msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" - -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" - -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" - -#: util/display.py:82 -msgid "skipped" -msgstr "" - -#: util/display.py:87 -msgid "failed" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" - -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" - -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" - -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: util/fileutil.py:76 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" - -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" - -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "" - -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" - -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" - -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Oin-oharrak" - -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[irudia]" - -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Indizea" - -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:538 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" - -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "" - -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "" - -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: writers/latex.py:1183 +#: cmd/quickstart.py:573 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" - -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" - -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "" - -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metodoa)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (klasea)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (aldagai globala edo konstantea)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s atributua)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumentuak" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Jaurtitzen du" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Itzultzen du" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Itzulketa mota" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modulua)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funtzioa" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metodoa" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klasea" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "datuak" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atributua" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modulua" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "%s bertsioan aldatuta" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "%s bertsiotik aurrera zaharkituta" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (rola)" - -#: domains/rst.py:234 -msgid "directive" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "rola" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Adi" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Kontuz" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Arriskua" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Errorea" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Argibidea" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Garrantzitsua" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Oharra" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Ikusi baita ere" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Iradokizuna" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Kontuz" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: cmd/quickstart.py:234 +#: cmd/quickstart.py:786 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: cmd/quickstart.py:810 +#, python-format +msgid "Invalid template variable: %s" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" msgstr "" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: directives/other.py:203 +msgid "Section author: " +msgstr "Atalaren egilea: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Moduluaren egilea: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Kodearen egilea: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Egilea:" + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: cmd/quickstart.py:286 +#: directives/patches.py:70 msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "" + +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: cmd/quickstart.py:308 +#: directives/code.py:235 +#, python-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "" + +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: cmd/quickstart.py:323 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%Y %b %d" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Indizea" + +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Oin-oharrak" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[irudia]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" msgstr "" -#: cmd/quickstart.py:367 +#: writers/html5.py:441 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "Any IDs not assigned for %s node" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" + +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:386 #, python-format -msgid "Creating file %s." +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "File %s already exists, skipping." +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:519 +#: writers/latex.py:616 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: cmd/quickstart.py:526 +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "" + +#: writers/latex.py:1198 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:530 +#: writers/latex.py:1228 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:809 +#: util/i18n.py:244 #, python-format -msgid "Invalid template variable: %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/build.py:74 +#: util/osutil.py:131 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:131 +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "aurreko orritik jarraitzen du" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "" + +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Argitalpena" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Alboko barra tolestu" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Nabigazioa" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Bilatu %(docstitle)s(e)n" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Dokumentu hauen inguruan" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Bilatu" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Joan" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Azken aldaketa: %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Aurreko gaia" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "aurreko kapitulua" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Hurrengo gaia" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "hurrengo kapitulua" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Indize guztia orri batean" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Orri hau" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Iturburua ikusi" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Edukiak" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Bilaketa azkarra" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "%(docstitle)s bilatu" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Joan" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2683,7 +2883,7 @@ msgstr "Modulu indize globala" msgid "quick access to all modules" msgstr "modulu guztietara atzipen azkarra" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Indize orokorra" @@ -2691,23 +2891,15 @@ msgstr "Indize orokorra" msgid "all functions, classes, terms" msgstr "funtzio, klase, termino guztiak" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Orri hau" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Indize guztia orri batean" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Bilaketa azkarra" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "%(docstitle)s bilatu" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2717,57 +2909,6 @@ msgstr "Indize orriak hizkika" msgid "can be huge" msgstr "handia izan daiteke" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Aurreko gaia" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "aurreko kapitulua" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Hurrengo gaia" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "hurrengo kapitulua" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Nabigazioa" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Bilatu %(docstitle)s(e)n" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Dokumentu hauen inguruan" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Azken aldaketa: %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2784,21 +2925,21 @@ msgstr "" msgid "search" msgstr "bilatu" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Bilaketa bat-etortzeak ezkutatu" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Edukiak" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Bilaketa emaitzak" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2806,22 +2947,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Bilaketa bat-etortzeak ezkutatu" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2829,6 +2969,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2850,120 +2995,127 @@ msgstr "Beste aldaketak" msgid "Expand sidebar" msgstr "Alboko barra luzatu" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametroak" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Aldagaiak" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Goratzen du" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s moduluan)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (%s moduluan)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (klasea %s-(e)n)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klaseko metodoa)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s metodo estatikoa)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python moduluen indizea" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moduluak" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Zaharkitua" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "salbuespena" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "klaseko metodoa" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "metodo estatikoa" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (zaharkitua)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametroak" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Aldagaiak" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Goratzen du" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2974,746 +3126,526 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "partaidea" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "mota" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "aldagaia" - -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "makroa" - -#: domains/c/__init__.py:753 -msgid "struct" -msgstr "" - -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "inguruneko aldagaia; %s" - -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "glosarioko terminoa" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "gramatikako token-a" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "erreferentzia etiketa" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "inguruneko aldagaia" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "programako aukera" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Moduluen indizea" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "%s ikusi" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "ikusi %s baita ere" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 +#: domains/c/__init__.py:211 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +msgid "%s (C %s)" msgstr "" -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "aldagaia" + +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "makroa" + +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "" +msgid "environment variable; %s" +msgstr "inguruneko aldagaia; %s" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:116 #, python-format -msgid "%r reference target not found: %s" +msgid "%s; configuration value" msgstr "" -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:239 #, python-format -msgid "Unknown image format: %s..." +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:319 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "indizea" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "glosarioko terminoa" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "gramatikako token-a" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "hurrengoa" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "erreferentzia etiketa" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "aurrekoa" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "inguruneko aldagaia" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "programako aukera" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Moduluen indizea" + +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1153 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy static file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Failed to write build info file: %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "%s %s dokumentazioa" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Argitalpena" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "" + +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "aurreko orritik jarraitzen du" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3721,7 +3653,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3736,481 +3668,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "%s is not a directory." +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:256 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "indizea" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "hurrengoa" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "aurrekoa" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s dokumentazioa" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "%s ikusi" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "ikusi %s baita ere" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/fa/LC_MESSAGES/sphinx.mo b/sphinx/locale/fa/LC_MESSAGES/sphinx.mo index d0fe9670331..d2cfc67e42f 100644 Binary files a/sphinx/locale/fa/LC_MESSAGES/sphinx.mo and b/sphinx/locale/fa/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/fa/LC_MESSAGES/sphinx.po b/sphinx/locale/fa/LC_MESSAGES/sphinx.po index f91dda94f95..afa4c11ec97 100644 --- a/sphinx/locale/fa/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/fa/LC_MESSAGES/sphinx.po @@ -1,5 +1,5 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: @@ -11,153 +11,300 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-29 22:39+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Hadi F , 2020-2021\n" "Language-Team: Persian (http://app.transifex.com/sphinx-doc/sphinx-1/language/fa/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" "Language: fa\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" -#: events.py:77 +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "تنظیمات %s. %s در هیچ یک از پیکربندی‌های جستجو شده رخ نمی‌دهد" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "گزینه‌ی پشتیبانی نشده‌ی زمینه %r داده شده" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "پرونده‌ی %r که مسیر زمینه به آن اشاره دارد یا پرونده زیپ معتبری نیست یا هیچ زمینه‌ای درونش ندارد" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "تنظیمات needs_extensions (نیازهای افزونه) افزونه‌ی %s را نیاز دارد، ولی بارگذاری نمی شود." + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "این پروژه افزونه‌ی %s (دست کم نسخه‌ی %s) را نیاز دارد، بنابراین نمی تواند با نسخه بارگذاری شده (%s) ساخته شود." + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "نام رنگ‌مایه خوان %r شناخته شده نیست" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 #, python-format msgid "Event %r already present" msgstr "رویداد %r در حال حاضر موجود است" -#: events.py:370 +#: events.py:386 #, python-format msgid "Unknown event name: %s" msgstr "نوع اتفاق نامشخّص است: %s" -#: events.py:416 +#: events.py:451 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "مدیر %r برای رویداد %r یک باعث ایراد شد" -#: application.py:190 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "شاخه‌ی منبع(%s) پیدا نشد." -#: application.py:194 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "نشانی (%s) شاخه نیست" -#: application.py:198 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "شاخه‌های مبدأ و مقصد نمی توانند یکسان باشند" -#: application.py:228 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "اجرای اسفینکس نگارش %s" -#: application.py:250 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "این پروژه دست که به افینکس نگارش%s نیاز دارد و برای همین با این نسخه قابل ساخت نیست." -#: application.py:266 +#: application.py:305 msgid "making output directory" msgstr "ایجاد پوشه ی برون داد" -#: application.py:271 registry.py:452 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "در حال راه اندازی افزونه‌ی%s:" -#: application.py:277 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' آن طور که در conf.py تعریف شده شیئ قابل فراخوانی پایتون نیست. لطفاً تعریفش را تغییر دهید تا تابع قابل فراخوان پایتون شود. این کار لازمه‌ی conf.py است تا به عنوان افزنه‌ی اسفینکس کار کند." -#: application.py:312 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "بارگذاری ترجمه ها [%s]... " -#: application.py:329 util/display.py:88 +#: application.py:384 util/display.py:89 msgid "done" msgstr "انجام شد" -#: application.py:331 +#: application.py:386 msgid "not available for built-in messages" msgstr "برای پیام‌های داخلی در دسترس نیست" -#: application.py:345 +#: application.py:400 msgid "loading pickled environment" msgstr "بارگذاری محیط pckle شده" -#: application.py:353 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "شکست خورد: %s" -#: application.py:366 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "هیچ سازنده‌ای برگزیده نشده، استفاده از قالب خروجی پیش‌فرض: html" -#: application.py:398 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:400 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:404 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:407 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:409 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:414 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:417 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:419 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:968 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "بست کلاس %r در حال حاضر ثبت نام شده است، بازدیدکنندگان این پیوند نادیده گرفته خواهد شد" -#: application.py:1047 +#: application.py:1113 #, python-format -msgid "directive %r is already registered, it will be overridden" -msgstr "دستور %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد" +msgid "directive %r is already registered and will not be overridden" +msgstr "" -#: application.py:1069 application.py:1094 +#: application.py:1139 application.py:1167 #, python-format -msgid "role %r is already registered, it will be overridden" -msgstr "نقش %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد" +msgid "role %r is already registered and will not be overridden" +msgstr "" -#: application.py:1644 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -165,12 +312,12 @@ msgid "" "explicit" msgstr "افزونه‌ی %s مشخّص نکرده که آیا برای خواندن موازی امن هست یا نه. که فرض می‌گیریم نیست. لطفاً از نویسنده‌ی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند" -#: application.py:1648 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "افزونه ی %sبرای خواندن موازی امن نیست" -#: application.py:1651 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -178,645 +325,357 @@ msgid "" "explicit" msgstr "افزونه‌ی %s مشخّص نکرده که آیا برای نوشتن موازی امن هست یا نه. که فرض می‌گیریم نیست. لطفاً از نویسنده‌ی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند" -#: application.py:1655 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "افزونه‌ی %s برای نوشتن موازی امن نیست" -#: application.py:1663 application.py:1667 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "انجام چندباره‌ی %s" -#: roles.py:208 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:231 -#, python-format -msgid "invalid CVE number %s" -msgstr "" - -#: roles.py:253 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" - -#: roles.py:276 -#, python-format -msgid "invalid CWE number %s" -msgstr "" - -#: roles.py:296 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:319 -#, python-format -msgid "invalid PEP number %s" -msgstr "" - -#: roles.py:357 -#, python-format -msgid "invalid RFC number %s" -msgstr "" - -#: registry.py:144 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "کلاس سازنده %s هیچ ویژگی‌ای به عنوان \"name\" ندارد" -#: registry.py:146 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "سازنده %r در حال حاضر وجود دارد (در پیمانه‌ی %s)" -#: registry.py:159 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "نام سازنده %s یا ثبت شده نیست و یا فقط از طریق نقطه ورود در دسترس است" -#: registry.py:166 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "نام سازنده %s ثبت نشده است" -#: registry.py:173 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "دامنه ی %sپیش تر ثبت شده" -#: registry.py:196 registry.py:209 registry.py:220 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "دامنه %s هنوز ثبت نشده است" -#: registry.py:200 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "دستورالعمل %r قبلاً برای دامنه %s ثبت شده" -#: registry.py:212 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "نقش %r قبلاً برای دامنه %s ثبت شده" -#: registry.py:223 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "شاخص %r قبلاً برای دامنه %s ثبت شده" -#: registry.py:254 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "نوع شیئ (object_type) %r قبلاً برای دامنه ثبت شده" -#: registry.py:280 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "ارجاع متقابل (crossref_type) %r قبلاً ثبت شده" -#: registry.py:287 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "پسوند (source_suffix) %r قبلاً ثبت شده است" -#: registry.py:296 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "تحلیل‌گر منبع (source_parser) %r قبلاً ثبت شده است" -#: registry.py:304 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "تجزیه کننده مبدإ برای %s ثبت نشده است" -#: registry.py:320 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "در حال حاضر برای %r مترجم وجود دارد" -#: registry.py:336 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "مؤلّفه‌های کلیدی برای تابع add_node() باید تاپل تابعی (بازدید، خروج) باشند: %r=%r" -#: registry.py:419 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "بست قابل شمارش (enumerable_node) %r قبلاً ثبت شده است" -#: registry.py:431 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "ترسیم‌گر ریاضی %s قبلاً ثبت شده" -#: registry.py:446 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "افزونه‌ی %r از نسخه‌ی %s اسفینکس به بعد، در آن ادغام شده؛ بنابراین نادیده گرفته می‌شود." -#: registry.py:457 +#: registry.py:545 msgid "Original exception:\n" msgstr "ایراد اصلی:\n" -#: registry.py:458 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "امکان وارد کردن افزونه‌ی %s نبود" -#: registry.py:463 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "افزونه‌ی %r هیچ تابع setup()ی ندارد؛ آیا این مورد واقعاً یک پیمانه‌ی افزونه‌ی اسفینکس است؟" -#: registry.py:472 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "افزونه‌ی %s که در این پروژه استفاده شده دست کم نیازمند اسفینکس نسخه‌ی %s است؛ بنابراین با این نسخه قابل ساخت نیست." -#: registry.py:480 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "افزونه‌ی %r شیئ پشتیبانی نشده‌‌ای از تابع setup()ش برگرداند؛ در حالی که می بایست مقدار تهی/هیچ و یا یک دیکشنری فراداده‌ برمی‌گرداند" -#: registry.py:514 +#: registry.py:605 #, python-format msgid "`None` is not a valid filetype for %r." msgstr "" -#: project.py:71 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" - -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" - -#: highlighting.py:168 +#: config.py:351 #, python-format -msgid "Pygments lexer name %r is not known" -msgstr "نام رنگ‌مایه خوان %r شناخته شده نیست" +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "شاخه‌ی پیکربندی(%s)، پرونده‌ی conf.py را ندارد" -#: highlighting.py:202 +#: config.py:374 #, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: extension.py:55 +#: config.py:379 #, python-format msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." -msgstr "تنظیمات needs_extensions (نیازهای افزونه) افزونه‌ی %s را نیاز دارد، ولی بارگذاری نمی شود." +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" +msgstr "امکان لغو تنظیمات پیکربندیdictionary %r ، نادیده گرفته می‌شود (برای تعیین تک تک عناصر %r را به کار ببرید)" -#: extension.py:76 +#: config.py:391 #, python-format -msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." -msgstr "این پروژه افزونه‌ی %s (دست کم نسخه‌ی %s) را نیاز دارد، بنابراین نمی تواند با نسخه بارگذاری شده (%s) ساخته شود." +msgid "invalid number %r for config value %r, ignoring" +msgstr "شماره نامعتبر %r برای پیکربندی مقدار %r، نادیده گرفته می‌شود" -#: theming.py:114 +#: config.py:399 #, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +msgid "cannot override config setting %r with unsupported type, ignoring" +msgstr "امکان لغو تنظیمات پیکربندی %r با نوع پشتیبانی نشده نبود، نادیده گرفته می‌شود" -#: theming.py:120 +#: config.py:422 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "تنظیمات %s. %s در هیچ یک از پیکربندی‌های جستجو شده رخ نمی‌دهد" +msgid "unknown config value %r in override, ignoring" +msgstr "مقدار پیکربندی ناشناخته %r در ابطال، نادیده گرفته شد" -#: theming.py:135 +#: config.py:476 #, python-format -msgid "unsupported theme option %r given" -msgstr "گزینه‌ی پشتیبانی نشده‌ی زمینه %r داده شده" +msgid "No such config value: %r" +msgstr "" -#: theming.py:207 +#: config.py:504 #, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "پرونده‌ی %r که مسیر زمینه به آن اشاره دارد یا پرونده زیپ معتبری نیست یا هیچ زمینه‌ای درونش ندارد" +msgid "Config value %r already present" +msgstr "مقدار پیکربندی %r از قبل موجود است" -#: theming.py:228 +#: config.py:541 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" msgstr "" -#: theming.py:268 -#, python-format -msgid "The %r theme has circular inheritance" +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." msgstr "" -#: theming.py:275 +#: config.py:599 #, python-format +msgid "There is a syntax error in your configuration file: %s\n" +msgstr "خطای نحوی در پرونده‌ی پیکربندی شما وجود دارد: %s\n" + +#: config.py:603 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "" +"The configuration file (or one of the modules it imports) called sys.exit()" +msgstr "پرونده‌ی پیکربندی (یا یکی از ماژول هایی که وارد می کند) sys.exit() را فراخواند" -#: theming.py:282 +#: config.py:611 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "" +msgid "" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" +msgstr "یک خطای قابل برنامه ریزی در پرونده‌ی پیکربندی شما وجود دارد:\n\n%s" -#: theming.py:310 +#: config.py:633 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to convert %r to a frozenset" msgstr "" -#: theming.py:335 theming.py:388 +#: config.py:651 config.py:659 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: theming.py:339 +#: config.py:665 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." msgstr "" -#: theming.py:343 theming.py:391 +#: config.py:686 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +msgid "Section %s" +msgstr "بخش%s" -#: theming.py:347 +#: config.py:687 #, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +msgid "Fig. %s" +msgstr "شکل %s" -#: theming.py:366 +#: config.py:688 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +msgid "Table %s" +msgstr "جدول %s" -#: config.py:309 +#: config.py:689 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "شاخه‌ی پیکربندی(%s)، پرونده‌ی conf.py را ندارد" +msgid "Listing %s" +msgstr "فهرست %s" -#: config.py:318 -msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "" - -#: config.py:341 -#, python-format -msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" -msgstr "امکان لغو تنظیمات پیکربندیdictionary %r ، نادیده گرفته می‌شود (برای تعیین تک تک عناصر %r را به کار ببرید)" - -#: config.py:350 -#, python-format -msgid "invalid number %r for config value %r, ignoring" -msgstr "شماره نامعتبر %r برای پیکربندی مقدار %r، نادیده گرفته می‌شود" - -#: config.py:356 -#, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" -msgstr "امکان لغو تنظیمات پیکربندی %r با نوع پشتیبانی نشده نبود، نادیده گرفته می‌شود" - -#: config.py:377 -#, python-format -msgid "unknown config value %r in override, ignoring" -msgstr "مقدار پیکربندی ناشناخته %r در ابطال، نادیده گرفته شد" - -#: config.py:430 -#, python-format -msgid "No such config value: %r" -msgstr "" - -#: config.py:453 -#, python-format -msgid "Config value %r already present" -msgstr "مقدار پیکربندی %r از قبل موجود است" - -#: config.py:489 -#, python-format -msgid "" -"cannot cache unpickable configuration value: %r (because it contains a " -"function, class, or module object)" -msgstr "" - -#: config.py:527 -#, python-format -msgid "There is a syntax error in your configuration file: %s\n" -msgstr "خطای نحوی در پرونده‌ی پیکربندی شما وجود دارد: %s\n" - -#: config.py:530 -msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" -msgstr "پرونده‌ی پیکربندی (یا یکی از ماژول هایی که وارد می کند) sys.exit() را فراخواند" - -#: config.py:537 -#, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" -msgstr "یک خطای قابل برنامه ریزی در پرونده‌ی پیکربندی شما وجود دارد:\n\n%s" - -#: config.py:560 -#, python-format -msgid "Failed to convert %r to a set or tuple" -msgstr "" - -#: config.py:581 config.py:586 -#, python-format -msgid "Converting `source_suffix = %r` to `source_suffix = %r`." -msgstr "" - -#: config.py:589 -#, python-format -msgid "" -"The config value `source_suffix' expects a dictionary, a string, or a list " -"of strings. Got `%r' instead (type %s)." -msgstr "" - -#: config.py:608 -#, python-format -msgid "Section %s" -msgstr "بخش%s" - -#: config.py:609 -#, python-format -msgid "Fig. %s" -msgstr "شکل %s" - -#: config.py:610 -#, python-format -msgid "Table %s" -msgstr "جدول %s" - -#: config.py:611 -#, python-format -msgid "Listing %s" -msgstr "فهرست %s" - -#: config.py:718 +#: config.py:798 +#, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "مقدار پیکربندی '{name}' باید یکی از {candidates} باشد، اما '{current}' داده شده." -#: config.py:742 +#: config.py:829 +#, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، ولی انتظار می‌رفت {permitted} می‌بود." -#: config.py:755 +#: config.py:846 +#, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، حالت پیش‌فرض {permitted} است." -#: config.py:766 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "دامنه‌ی اصلی %r یافت نشد، نادیده گرفته می‌شوند." -#: config.py:778 +#: config.py:878 msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." -msgstr "از زمان نسخه‌ی ۲ تا به حال، اسفیکنس به صورت پیش فرض از \"index\" به عنوان ریشه‌ی سند(root_doc) استفاده می‌کند. لطفاً \"root_doc = 'contents'\" را به پرونده conf.py تان اضافه کنید." - -#: domains/rst.py:128 domains/rst.py:185 -#, python-format -msgid "%s (directive)" -msgstr "%s (دستورالمعل)" - -#: domains/rst.py:186 domains/rst.py:190 -#, python-format -msgid ":%s: (directive option)" -msgstr "%s (گزینه‌ی دستورالمعل)" - -#: domains/rst.py:214 -#, python-format -msgid "%s (role)" -msgstr "%s (نقش)" - -#: domains/rst.py:224 -msgid "directive" -msgstr "دستورالمعل" - -#: domains/rst.py:225 -msgid "directive-option" -msgstr "گزینه‌ی دستورالمعل" - -#: domains/rst.py:226 -msgid "role" -msgstr "نقش" - -#: domains/rst.py:248 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "توضیح تکراری از %s %s، مورد دیگر در %s قرار دارد" - -#: domains/javascript.py:165 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (توابع درونی)" - -#: domains/javascript.py:166 domains/python/__init__.py:253 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s متد)" - -#: domains/javascript.py:168 -#, python-format -msgid "%s() (class)" -msgstr "%s (کلاس)" - -#: domains/javascript.py:170 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (متغیّر عمومی یا مقدار ثابت)" - -#: domains/javascript.py:172 domains/python/__init__.py:338 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s مشخصه)" - -#: domains/javascript.py:255 -msgid "Arguments" -msgstr "نشانوندها" - -#: domains/cpp/__init__.py:447 domains/javascript.py:258 -msgid "Throws" -msgstr "ایجاد" - -#: domains/c/__init__.py:310 domains/cpp/__init__.py:458 -#: domains/javascript.py:261 domains/python/_object.py:176 -msgid "Returns" -msgstr "بازگشت ها" - -#: domains/c/__init__.py:312 domains/javascript.py:263 -#: domains/python/_object.py:178 -msgid "Return type" -msgstr "نوع برگشتی" - -#: domains/javascript.py:334 -#, python-format -msgid "%s (module)" -msgstr "%s (ماژول)" - -#: domains/c/__init__.py:681 domains/cpp/__init__.py:859 -#: domains/javascript.py:371 domains/python/__init__.py:660 -msgid "function" -msgstr "تابع" - -#: domains/javascript.py:372 domains/python/__init__.py:664 -msgid "method" -msgstr "متد" - -#: domains/cpp/__init__.py:857 domains/javascript.py:373 -#: domains/python/__init__.py:662 -msgid "class" -msgstr "کلاس" - -#: domains/javascript.py:374 domains/python/__init__.py:661 -msgid "data" -msgstr "داده" - -#: domains/javascript.py:375 domains/python/__init__.py:667 -msgid "attribute" -msgstr "مشخّصه" - -#: domains/javascript.py:376 domains/python/__init__.py:670 -msgid "module" -msgstr "ماژول" - -#: domains/javascript.py:407 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "توضیح %s تکراری از %s، مورد دیگر%s در %s قرار دارد" - -#: domains/changeset.py:25 -#, python-format -msgid "Added in version %s" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Changed in version %s" -msgstr "تغییر داده شده در نسخه %s" - -#: domains/changeset.py:27 -#, python-format -msgid "Deprecated since version %s" -msgstr "منسوخ شده از نسخه %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Removed in version %s" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: domains/__init__.py:299 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/citation.py:73 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "نقل‌قول %s تکراری، مورد دیگر در %s قرار دارد" - -#: domains/citation.py:84 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "نقل [%s] قول ارجاع داده نشده." - -#: domains/math.py:63 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "بر چسب معادله ی %s تکرار است، مورد دیگر در %s قرار دارد" - -#: domains/math.py:119 writers/latex.py:2479 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "قالب مرجع معادله‌‌ی ریاضی (math_eqref_format) نامعتبر: %r" - -#: environment/__init__.py:81 +#: environment/__init__.py:89 msgid "new config" msgstr "پیکربندی جدید" -#: environment/__init__.py:82 +#: environment/__init__.py:90 msgid "config changed" msgstr "پیکربندی تغییر داده شد" -#: environment/__init__.py:83 +#: environment/__init__.py:91 msgid "extensions changed" msgstr "افزونه‌ها تغییر کردند" -#: environment/__init__.py:249 +#: environment/__init__.py:261 msgid "build environment version not current" msgstr "نسخه‌ی محیط ساخت به‌روز نیست" -#: environment/__init__.py:251 +#: environment/__init__.py:263 msgid "source directory has changed" msgstr "شاخه ی منبع تغییر کرد" -#: environment/__init__.py:313 +#: environment/__init__.py:350 #, python-format msgid "The configuration has changed (1 option: %r)" msgstr "" -#: environment/__init__.py:318 +#: environment/__init__.py:355 #, python-format msgid "The configuration has changed (%d options: %s)" msgstr "" -#: environment/__init__.py:324 +#: environment/__init__.py:361 #, python-format msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: environment/__init__.py:366 +#: environment/__init__.py:404 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "این محیط با سازنده‌ی انتخاب شده سازگار نیست، لطفاً یک خوشه‌ی اسناد دیگری را انتخاب کنید." -#: environment/__init__.py:473 +#: environment/__init__.py:518 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "پویش اسناد %s: %r شکست خورد" -#: environment/__init__.py:626 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format msgid "Domain %r is not registered" msgstr "دامنه ی %r ثبت نشده" -#: environment/__init__.py:777 +#: environment/__init__.py:811 msgid "document isn't included in any toctree" msgstr "سند در هیچ درختواره‌ی فهرست مطالبی گنجانده نشده" -#: environment/__init__.py:810 +#: environment/__init__.py:922 msgid "self referenced toctree found. Ignored." msgstr "درختواره‌ی فهرست مطالب با ارجاع به خود پیدا شده. نادیده گرفته می‌شود." -#: environment/__init__.py:839 +#: environment/__init__.py:952 #, python-format msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" @@ -861,2224 +720,2038 @@ msgstr "نکته" msgid "Warning" msgstr "هشدار" -#: cmd/quickstart.py:43 -msgid "automatically insert docstrings from modules" -msgstr "درج خودکار رشته‌مستندات را از پیمانه‌ها" - -#: cmd/quickstart.py:44 -msgid "automatically test code snippets in doctest blocks" -msgstr "آزمایش خودکار تکّه‌کدها در قسمت‌های مختلف پیمانه‌ی doctest" +#: builders/texinfo.py:41 +#, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "پرونده‌ی اطّلاعات متن در پوشه‌ی %(outdir)s است." -#: cmd/quickstart.py:45 -msgid "link between Sphinx documentation of different projects" -msgstr "پیوند بین اسناد Sphinx از پروژه های گوناگون" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nدر آن شاخه فرمان 'make' را اجرا کنید تا این‌ها رh با makeinfo اجرا کند\n(برای انجام خودکار `make info' را به کار ببرید)." -#: cmd/quickstart.py:46 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "نوشتن مدخل‌های لیست اقدام‌ها (\"todo\")که در ساخت می تواند نشان داده و یا پنهان شوند" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "هیچ تنظیماتی برای «صفحات راهنما» پیدا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد" -#: cmd/quickstart.py:47 -msgid "checks for documentation coverage" -msgstr "بررسی برای پوشش اسناد" +#: builders/texinfo.py:85 +#, python-format +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "مقدار پیکربندی اطّلاعات متن سندها (texinfo_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد" -#: cmd/quickstart.py:48 -msgid "include math, rendered as PNG or SVG images" -msgstr "گنجاندن رابطه‌های ریاضی که در قالب PNG یا SVG به نمایش در آمده" +#: builders/latex/__init__.py:310 builders/texinfo.py:105 +#, python-format +msgid "processing %s" +msgstr "در حال پردازش %s" -#: cmd/quickstart.py:49 -msgid "include math, rendered in the browser by MathJax" -msgstr "گنجاندن رابطه‌های ریاضی که MathJax در مرورگر نمایش در آورده" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "در حال نوشتن" -#: cmd/quickstart.py:50 -msgid "conditional inclusion of content based on config values" -msgstr "گنجاندن شرطی محتوا بر اساس مقادیر پیکربندی" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "حل ارجاع‌ها..." -#: cmd/quickstart.py:51 -msgid "include links to the source code of documented Python objects" -msgstr "گنجاندن ویندهای کد منبع اشیاء مستند شده‌ی پایتون" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (در " -#: cmd/quickstart.py:52 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "ساخت پرونده‌ی nojekyll برای انتشار سند در صفحات گیت-هاب" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "در حال رونوشت از تصاویر... " -#: cmd/quickstart.py:94 -msgid "Please enter a valid path name." -msgstr "لطفاً نام مسیر معتبری را وارد کنید." +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 +#, python-format +msgid "cannot copy image file %r: %s" +msgstr "نمی تواند پرونده‌ی تصویر %r: %s را کپی کند" -#: cmd/quickstart.py:110 -msgid "Please enter some text." -msgstr "لطفاً متنی وارد کنید." +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "رونوشت از پرونده‌های با پشتیبانی اطلاعات متن" -#: cmd/quickstart.py:117 +#: builders/texinfo.py:218 #, python-format -msgid "Please enter one of %s." -msgstr "لطفاً یکی از %s وارد کنید." +msgid "error writing file Makefile: %s" +msgstr "خطای نوشتن پرونده‌ی ساخت (Makefile) : %s" -#: cmd/quickstart.py:125 -msgid "Please enter either 'y' or 'n'." -msgstr "لطفاً یا y و یا n وارد کنید." - -#: cmd/quickstart.py:131 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "لطفاً یک پسوند را وارد کنید، مثل: '.rst' یا '.txt'." - -#: cmd/quickstart.py:215 +#: builders/manpage.py:37 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "به ابزار شروع سریع اسفینکس %s خوش آمدید." +msgid "The manual pages are in %(outdir)s." +msgstr "صفحات راهنما در %(outdir)s است." -#: cmd/quickstart.py:219 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "لطفاً مقدارهای تنظیمات زیر را وارد کنید\n(اگر مقدار پیش‌گزیده‌ای درون داده کروشه شده بود، برای برای پذیرش آن فقط کلید Enter‌را فشار دهید)." +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "هیچ مقداری برای تنظیمات «صفحات راهنما» ا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد" -#: cmd/quickstart.py:227 +#: builders/manpage.py:64 #, python-format -msgid "Selected root path: %s" -msgstr "مسیر برگزیده‌ی ریشه‌ی مستندات: %s" - -#: cmd/quickstart.py:230 -msgid "Enter the root path for documentation." -msgstr "مسیر ریشه‌ی مستندات را وارد کنید." - -#: cmd/quickstart.py:231 -msgid "Root path for the documentation" -msgstr "مسیر ریشه‌ی مستندات" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "پیکربندی مقدارهای «صفحات راهنما» به سند ناشناخته‌ای ارجاع می‌دهند %s" -#: cmd/quickstart.py:239 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "خطا: در مسیر ریشه‌ی انتخاب شده‌، پرونده‌ی conf.pyی دیگری یپدا شد." +#: builders/singlehtml.py:35 +#, python-format +msgid "The HTML page is in %(outdir)s." +msgstr "صفحه HTML در %(outdir)s است." -#: cmd/quickstart.py:245 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "ابراز شروع سریع اسفینکس روی پروژه‌های از قبل موجود اسفینکس بازنویسی نمی‌کند." +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "سر جمع کرد تک سند" -#: cmd/quickstart.py:248 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "لطفاً یک مسیر ریشه‌ی جدید وارد کنید (یا برای خروج Enter‌ را بزنید)" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "نوشتن پرونده‌های اضافی" -#: cmd/quickstart.py:258 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "شما برای تعیین شاخه‌ی ساخت برای برون‌داد اسفینکس دو گزینه دارید.\nیا از شاخه‌ای با نام \"_build\" درون شاخه‌ی ریشه استفاده کنید،\nو یا شاخه‌های را درون یک مسیر ریشه با نام‌های منبع (source) و ساخت (build) جدا کنید." +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "سازنده‌ی بدلی هیچ پرونده‌ای تولید نمی کند." -#: cmd/quickstart.py:265 -msgid "Separate source and build directories (y/n)" -msgstr "شاخه‌های منبع و ساخت از یکدیگر جدا شوند؟(y/n)" +#: builders/gettext.py:243 +#, python-format +msgid "The message catalogs are in %(outdir)s." +msgstr "سیاهه‌های پیام‌ها در %(outdir)s است." -#: cmd/quickstart.py:271 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "درون شاخه‌ی ریشه، دو شاخه‌ی دیگر ساخته خواهد شد؛\n\"_templates\" برای قالب‌های سفارشی HTML و \"_static\" برای قالب برگه‌ها و بقیّه‌ی پرونده‌های ثابت.\nشما می‌توانید پیشوند دیگری (مانند «.») برای جایگزینی نویسه‌ی خط به کار ببرید." +#: builders/__init__.py:400 builders/gettext.py:264 +#, python-format +msgid "building [%s]: " +msgstr "ساخت [%s]: " -#: cmd/quickstart.py:277 -msgid "Name prefix for templates and static dir" -msgstr "برای شاخه‌های قالب‌ها (templates) و ثابت‌ها (static) نویسه‌ی پیشوندی را بنویسید" +#: builders/gettext.py:265 +#, python-format +msgid "targets for %d template files" +msgstr "مقصد‌های قالب پرونده‌های %d" -#: cmd/quickstart.py:282 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "نام پروژه در چندین جا در سند ساخته شده به کار می‌رود." +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "خواندن قالب‌ها... " -#: cmd/quickstart.py:286 -msgid "Project name" -msgstr "نام پروژه" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "نوشتن سیاهه‌های پیام... " -#: cmd/quickstart.py:288 -msgid "Author name(s)" -msgstr "نام نویسنده (ها)" +#: builders/linkcheck.py:87 +#, python-format +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "به دنبال هر یک از خطاهای بالا در یا در برون‌داد و یا در %(outdir)s/output.txt بگردید" -#: cmd/quickstart.py:293 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "اسفینکس نظریّه‌ای برای یک «نسخه» و یک «نگارش» برای نرم افزار دارد.\nهر نسخه‌ای می تواند چندید نگارش داشته باشد.\n مثلاً برای پایتون نسخه‌ چیزی شبیه به ۲/۵ یا ۳/۰ است،\n در حالی که انتشار چیزیست شبیه به ۲/۵/۱ یا ۳/۰a۱ \n.\nاگر شما نیازی به این ساختار دوگانه ندارید، هر دو را یکی تعیین کنید." +#: builders/linkcheck.py:159 +#, python-format +msgid "broken link: %s (%s)" +msgstr "پیوند خراب: %s (%s)" -#: cmd/quickstart.py:301 -msgid "Project version" -msgstr "نسخه انتشار پروژه" +#: builders/linkcheck.py:561 +#, python-format +msgid "Anchor '%s' not found" +msgstr "مهار '%s' پیدا نشد" -#: cmd/quickstart.py:303 -msgid "Project release" -msgstr "انتشار پروژه" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "اگر مستندات قرار است با زبانی غیر از انگلیسی نوشته شود،\nمی توانید همین‌جا یک زبان را با انتخاب کد زبانیش انتخاب کنید.\nاسفینکس سپس متن‌هایی را که تولید می‌کند را به آن زبان ترجمه می‌کند.\n\nبرای فهرست زبان‌های پشتیبانی شده، به این نشانی مراجعه کنید\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "شکست در گردآوری عبارات باقاعده در linkcheck_allowed_redirects: %r %s" -#: cmd/quickstart.py:317 -msgid "Project language" -msgstr "زبان پروژه" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." +msgstr "پرونده‌ی ePub در پوشه‌ی %(outdir)s است." -#: cmd/quickstart.py:324 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "پسوند نام پرونده برای پرونده‌های منبع. معمولاً این پسوند یا \".txt\" است و یا \".rst\".\nفقط پرونده‌هایی بای این پسوند به عنوان اسناد در نظر گرفته می‌شوند." +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "نوشتن پرونده‌ی nav.xhtml..." -#: cmd/quickstart.py:329 -msgid "Source file suffix" -msgstr "پسوند پرونده‌ی منبع" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "مقدار پیکربندی زبان پرونده epub (\"epub_language\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" -#: cmd/quickstart.py:334 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "یک سند از آن جهت خاص است که به عنوان بست بالایی «درختواره‌ی محتوا» در نظر گرفته می‌شود.\nیعنی، این سند ریشه‌ی ساختار سلسله مراتبی اسناد است.\nمعمولاً سند این کار «نمایه» است، ولی اگر سند «نمایه‌»‌ی شما قالب سفارشی است؛ می توانید آن را به نام دیگری تغییر دهید." +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "مقدار پیکربندی شناسه‌ی یکتای انتشار الکترونیکی (\"epub_uid\") باید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) یک XML NAME باشد" -#: cmd/quickstart.py:342 -msgid "Name of your master document (without suffix)" -msgstr "نام سند اصلی شما (بدون پسوند)" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "مقدار پیکربندی عنوان (\"html_title\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" -#: cmd/quickstart.py:352 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "خطا: پرونده‌ی اصلی %s از قبل در مسیر ریشه‌ی برگزیده بوده‌است." +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "مقدار پیکربندی مؤلّف (\"epub_author\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" -#: cmd/quickstart.py:359 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "ابراز شروع سریع اسفینکس روی پرونده‌های از قبل موجود بازنویسی نمی‌کند." +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "مقدار پیکربندی حامی (\"epub_contributor\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" -#: cmd/quickstart.py:362 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "لطفاُ یک نام جدید وارد کنید، یا نام پرونده‌ی موجود را تغییر دهید و Enter‌ را فشار دهید" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "مقدار پیکربندی توضیحات (\"epub_description\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" -#: cmd/quickstart.py:371 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "مشخّص کنید کدام یک از این افزونه‌های اسفینکس باید فعّال باشد:" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "مقدار پیکربندی ناشر (\"epub_publisher\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" -#: cmd/quickstart.py:381 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "یادداشت: ابزارهای‌ imgmath و mathjax نمی‌توانند در یک زمان فعّال باشند. انتخاب imgmath لغو شد." +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "مقدار پیکربندی حق انتشار (\"epub_copyright\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" -#: cmd/quickstart.py:391 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "پرونده‌های خط‌فرمان ویندوز و Makefile می‌توانند برای شما تولید شوند، به گونه‌ای که شما فقط نیاز باشد تا مثلاً فرمان `make html' را به جای فراخوان مستقیم ابزار ساخت اسفینکس اجرا کنید." +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "مقدار پیکربندی شناسه (\"epub_identifier\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" -#: cmd/quickstart.py:397 -msgid "Create Makefile? (y/n)" -msgstr "آیا پرونده‌ی‌ make ایجاد شود؟ (y/n)" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "مقدار پیکربندی ویراست (\"version\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" -#: cmd/quickstart.py:401 -msgid "Create Windows command file? (y/n)" -msgstr "آیا پرونده‌ی خط فرمان ویندوز ساخته شود؟ (y/n)ٍ" +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" +msgstr "پرونده‌ی css نامعتبر%r: نادیده گرفته می‌شود" -#: cmd/quickstart.py:453 ext/apidoc.py:92 +#: builders/xml.py:29 #, python-format -msgid "Creating file %s." -msgstr "ایجاد پرونده‌ی %s." +msgid "The XML files are in %(outdir)s." +msgstr "پرونده‌ی XML در پوشه‌ی %(outdir)s است." -#: cmd/quickstart.py:458 ext/apidoc.py:89 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "File %s already exists, skipping." -msgstr "پرونده‌ی %s در حال حاضر وجود دارد، رد شدن." +msgid "error writing file %s: %s" +msgstr "خطای نوشتن پرونده: %s, %s" -#: cmd/quickstart.py:501 -msgid "Finished: An initial directory structure has been created." -msgstr "پایان یافت: ساختار آغازین شاخه ایجاد شد." +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "پرونده‌های شبه XML در پوشه‌ی %(outdir)s." -#: cmd/quickstart.py:504 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "شما باید حالا دیگر پرونده‌ی اصلی‌تان %s را جمع آوری کنید\n و بقیّه‌ی پرونده‌های منبع مستندات را ایجاد کنید. " +msgid "duplicated ToC entry found: %s" +msgstr "عنوان تکراری در فهرست مطالب پیدا شد:%s" -#: cmd/quickstart.py:512 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "از Makefile برای ساختن مستندات استفاده کنید، مانند این:\n make builder" +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" +msgstr "امکان خواندن پرونده‌ی تصویری %r نبود: در عوض کپی می‌شود" -#: cmd/quickstart.py:515 +#: builders/_epub_base.py:467 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "از فرمان ساخت اسفینکس برای ساختن مستندات استفاده کنید، مانند این:\n sphinx-build -b builder %s %s" +msgid "cannot write image file %r: %s" +msgstr "نمی تواند پرونده‌ی تصویری %r: %s را بنویسد" -#: cmd/quickstart.py:522 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "که در آن سازنده یکی از سازنده‌های پشتیبانی شده است، مانند html, latex و یا linkcheck." +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow پیدا نشد- رونوشت برداشتن از پرونده‌های تصویری" -#: cmd/quickstart.py:557 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nتولید پرونده‌های مورد نیاز برای یک پروژه‌ی اسفینکس\n\nابزار شروع سریع اسفینکس ابزاری تعاملی است که شماری سؤال درباره‌ی پروژه‌یتان از شما می پرسد\nو سپس یک شاخه‌ی کامل مستندات و پرونده ساخت Makefile را برای استفاده به همراه ابزار ساخت اسفینکس تولید می‌کند.\n" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "نوشتن پرونده‌های نوع رسانه..." -#: cmd/build.py:153 cmd/quickstart.py:567 ext/apidoc.py:374 -#: ext/autosummary/generate.py:766 -msgid "For more information, visit ." -msgstr "برای اطّلاعات بیشتر به بروید." +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "نوشتن پرونده META-INF/container.xml..." -#: cmd/quickstart.py:577 -msgid "quiet mode" -msgstr "حالت سکوت" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "نوشتن پرونده‌ی content.opf..." -#: cmd/quickstart.py:587 -msgid "project root" -msgstr "ریشه‌ی پروژه" +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "نوع رسانه‌ی ناشناخته %s، نادیده گرفته شد" -#: cmd/quickstart.py:590 -msgid "Structure options" -msgstr "گزینه‌های ساختار" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" -#: cmd/quickstart.py:596 -msgid "if specified, separate source and build dirs" -msgstr "در صورتی مشخّص شدن، شاخه‌های منبع و ساخت از یکدیگر جدا می‌شوند" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "نوشتن پرونده‌ی خلاصه toc.ncx..." -#: cmd/quickstart.py:602 -msgid "if specified, create build dir under source dir" -msgstr "در صورت مشخّص بودن، شاخه‌ی build (ساخت) را درون شاخه‌ی منبع بساز" +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "نوشتن پرونده‌ی %s..." -#: cmd/quickstart.py:608 -msgid "replacement for dot in _templates etc." -msgstr "جایگزینی نقطه در _templates (قالب‌ها) و ... ." +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "پرونده‌ی متنی در پوشه‌ی %(outdir)s است." -#: cmd/quickstart.py:611 -msgid "Project basic options" -msgstr "گزینه‌های اساسی پروژه" +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s (%s)" -#: cmd/quickstart.py:613 -msgid "project name" -msgstr "نام پروژه" +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s" -#: cmd/quickstart.py:616 -msgid "author names" -msgstr "نام نویسندگان" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "ساخت پرونده‌ی [mo]: " -#: cmd/quickstart.py:623 -msgid "version of project" -msgstr "نسخه انتشار پروژه" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "نوشتن برون‌داد... " -#: cmd/quickstart.py:630 -msgid "release of project" -msgstr "انتشار پروژه" +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "همه‌ی پرونده‌های %d po" -#: cmd/quickstart.py:637 -msgid "document language" -msgstr "زبان سند" +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "اهداف برای %d پرونده‌های poی که مشخّص شده" -#: cmd/quickstart.py:640 -msgid "source file suffix" -msgstr "پسوند پرونده‌ی منبع" +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "مقصد‌های %d پرونده‌های poی هستند که منسوخ شده‌اند" -#: cmd/quickstart.py:643 -msgid "master document name" -msgstr "نام سند اصلی" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "همه‌ی پرونده‌های منبع" -#: cmd/quickstart.py:646 -msgid "use epub" -msgstr "استفاده epub" +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" -#: cmd/quickstart.py:649 -msgid "Extension options" -msgstr "گزینه‌های افزونه" +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "پرونده‌ی %r که در خط فرمان داده شده، در شاخه‌ی منبع نیست, نادیده گرفته می‌شود" -#: cmd/quickstart.py:656 ext/apidoc.py:578 +#: builders/__init__.py:353 #, python-format -msgid "enable %s extension" -msgstr "فعّال‌سازی %s افزونه" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" -#: cmd/quickstart.py:663 ext/apidoc.py:570 -msgid "enable arbitrary extensions" -msgstr "فعّال‌سازی افزونه‌های اختیاری" +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "پرونده‌های منبع %d داده شده در خط فرمان" -#: cmd/quickstart.py:666 -msgid "Makefile and Batchfile creation" -msgstr "ایجاد Makefile و Batchfile" +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "مقصد‌های %d پرونده‌های منبعی هستند که منسوخ شده‌اند" -#: cmd/quickstart.py:672 -msgid "create makefile" -msgstr "ایجاد پرونده‌ی سازنده (makefile)" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "در پی پرونده‌هایی که الآن منسوخ هستند... " -#: cmd/quickstart.py:678 -msgid "do not create makefile" -msgstr "پرونده‌ی سازنده (makefile) را ایجاد نکن" +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "%d تا مورد پیدا شد" -#: cmd/quickstart.py:685 -msgid "create batchfile" -msgstr "ایجاد Batchfile" +#: builders/__init__.py:417 +msgid "none found" +msgstr "چیزی پیدا نشد" -#: cmd/quickstart.py:691 -msgid "do not create batchfile" -msgstr "batchfile را ایجاد نکن" +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "بارگذاری محیط pickle شده" -#: cmd/quickstart.py:700 -msgid "use make-mode for Makefile/make.bat" -msgstr "اسفتاده از حالت ایجاد برای پرونده‌های Makefile/make.bat" +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "بررسی ثبات" -#: cmd/quickstart.py:703 ext/apidoc.py:581 -msgid "Project templating" -msgstr "قالب سازی پروژه" +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "هیچ مقدار تاریخ منسوخ نیست." -#: cmd/quickstart.py:709 ext/apidoc.py:587 -msgid "template directory for template files" -msgstr "شاخه‌ی قالب شامل پرونده‌های قالب" +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "به روز رسانی محیط: " -#: cmd/quickstart.py:716 -msgid "define a template variable" -msgstr "تعریف متغیّر قالب" +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "%s اضافه شد، %s تغییر کرد، %s حذف شد" -#: cmd/quickstart.py:751 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "حالت «ساکت» تعیین شده، ولی یکی از موارد «پروژه» یا «نویسنده» مشخّص نشده." +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" -#: cmd/quickstart.py:770 +#: builders/__init__.py:545 +#, python-format msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "خطا: مسیر مشخّص شده پوشه نیست، یا از قبل پرونده‌های اسفینکس وجود داشته‌اند." +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" -#: cmd/quickstart.py:777 +#: builders/__init__.py:556 +#, python-format msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "ابزار شروع سریع اسفینکس فقط یک پوشه‌ی خالی درست می کند. لطفاً یک مسیر ریشه‌ی جدید مشخّص کنید." +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" -#: cmd/quickstart.py:795 +#: builders/__init__.py:563 #, python-format -msgid "Invalid template variable: %s" -msgstr "متغیرهای نامعتبرقالب؛ %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" -#: cmd/build.py:49 -msgid "Exception occurred while building, starting debugger:" -msgstr "در حین ساخت ایرادی رخ داد، شروع اشکال زدا:" +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "خواندن منبع‌ها... " -#: _cli/util/errors.py:129 cmd/build.py:65 -msgid "Interrupted!" -msgstr "قطع شد!" +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "نام مستندات برای نوشتن: %s" -#: cmd/build.py:67 -msgid "reST markup error:" -msgstr "خطای نشانه‌گذاری متن بازساختمند (reST)" +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" -#: _cli/util/errors.py:143 cmd/build.py:73 -msgid "Encoding error:" -msgstr "خطای کدگذاری نویسه:" +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "آماده سازی اسناد" -#: cmd/build.py:78 cmd/build.py:108 -#, python-format -msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." -msgstr "اگر می‌‌خواهید مشکل را به توسعه‌دهندگان گزارش دهید، ردیابی کامل خطا در %s ذخیره شده است." +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" -#: _cli/util/errors.py:148 cmd/build.py:90 -msgid "Recursion error:" -msgstr "خطای بازگشتی:" +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "پرونده‌ی بازبینی در پوشه‌ی %(outdir)s است." -#: _cli/util/errors.py:152 cmd/build.py:94 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" -msgstr "این اتّفاق ممکن است برای پرونده‌های بسیار تو در توی منبع بیافتد. شما می‌توانید محدودیّت ۱۰۰۰ تایی مقدار پیش‌فرض اجرای بازگشت پایتون را در conf.py زیاد کنید، مثلاً با:" +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "بدون تغییرات در نسخه‌ی %s." -#: _cli/util/errors.py:165 cmd/build.py:103 -msgid "Exception occurred:" -msgstr "ایراد رخ داد:" +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "نوشتن پرونده‌ی خلاصه..." -#: _cli/util/errors.py:178 cmd/build.py:117 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "لطفاً اگر این مورد خطای کاربر بوده، آن را گزارش دهید تا برای بارهای بعدی پیام خطای بهتری بتواند ارائه شود." +#: builders/changes.py:79 +msgid "Builtins" +msgstr "درونی سازی" -#: cmd/build.py:124 -msgid "" -"A bug report can be filed in the tracker at . Thanks!" -msgstr "گزارش اشکال می تواند در ردیاب در مسیر ثبت شود. با سپاس!" +#: builders/changes.py:81 +msgid "Module level" +msgstr "در سطح ماژول" -#: cmd/build.py:144 -msgid "job number should be a positive number" -msgstr "شماره‌ی کار باید یک عدد مثبت باشد" +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "رونوشت از پرونده‌های مبدأ..." -#: cmd/build.py:154 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\nایجاد مستندات از پرونده‌های مبدأ.\n\nسازنده‌ی اسفنکس مستندات را از روی پرونده های مبنع در پوشه‌‌ی منبع تولید کرده در پوشه‌ی برون‌داد قرار می‌دهد.\nاین سازنده در پوشه‌ی مبدأ به دنبال پرونده 'conf.py' تنظیمات پیکربندی می‌گردد.\nاین امکان وجود دارد که از ابزار شروع سریع اسفینکس ('sphinx-quickstart') برای تولید پرونده‌های قالب، که شامل پرونده 'conf.py' هم می‌شود استفاده شود.\n\nسازنده‌ی اسفینکس می توند مستندات را در قالب‌های گوناگونی از پرونده‌های خروجی ایجاد کند. قالب پرونده خروجی با مشخّص کردن نام سازنده در خط فرمان مشخّص می‌شود که به صورت پیش فرض HTML است. همچنین، سازنده‌ها می‌توانند کارهای دیگر مربوط به فرآیند پردازش مستندسازی را انجام دهند.\n\nبه صورت پیش فرض، هر چیزی که منسوخ شده باشد تولید می‌شود. برون‌داد برای پرونده‌های منتخب می‌تواند فقط با مشخّص کردن نام تک تک پرونده‌ها ساخته شود.\n" +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "نمی‌توان %r را برای ایجاد گزارش تغییرات خواند" -#: cmd/build.py:180 -msgid "path to documentation source files" -msgstr "مسیر پرونده‌های مستندات" +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "عبارت باقاعده‌ی نامعتبر %r در %s" -#: cmd/build.py:183 -msgid "path to output directory" -msgstr "مسیری برای شاخه‌ی برون داد" +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "امکان وارد کردن پیمانه‎ی %s نبود: %s" -#: cmd/build.py:188 +#: ext/coverage.py:148 +#, python-format msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +"the following modules are documented but were not specified in " +"coverage_modules: %s" msgstr "" -#: cmd/build.py:194 -msgid "general options" -msgstr "گزینه‌های کلی" - -#: cmd/build.py:201 -msgid "builder to use (default: 'html')" +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" msgstr "" -#: cmd/build.py:210 +#: ext/coverage.py:172 +#, python-brace-format, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." msgstr "" -#: cmd/build.py:220 -msgid "write all files (default: only write new and changed files)" -msgstr "نوشتن همه‌ی پرونده‌ها (پیش‌گزیده: فقط پرونده‌های جدید نو تغییر یافته را بنویس)" +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "عبارات باقاعده‌ی نامعتبر %r در پوشش عبارت باقاعده‌ی زبان سی (coverage_c_regexes)" -#: cmd/build.py:227 -msgid "don't use a saved environment, always read all files" -msgstr "از محیط ذخیره شده استفاده نکن، همیشه همه پرونده ها را بخوان" +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "رابط برنامه‌نویسی مستند نشده‌ی C: %s [%s] در پرونده‌ی %s" -#: cmd/build.py:230 -msgid "path options" -msgstr "" +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "تابع پایتونی بدون مستندات: %s :: %s" -#: cmd/build.py:236 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "کلاس مستندسازی نشده‌ی پایتون: %s :: %s" -#: cmd/build.py:246 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "شگرد مستندسازی نشده‌ی پایتون: %s :: %s :: %s" -#: cmd/build.py:255 -msgid "use no configuration file, only use settings from -D options" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: cmd/build.py:264 -msgid "override a setting in configuration file" -msgstr "نادیده گرفتن تنظیماتی در پرونده‌ی پیکره‌بندی" - -#: cmd/build.py:273 -msgid "pass a value into HTML templates" -msgstr "مقداری را به قالب‌های HTML بدهید" - -#: cmd/build.py:282 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "تعریف برچسب: «فقط» تکّه‌های با برچسب گنجانده شود" - -#: cmd/build.py:289 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:292 -msgid "console output options" -msgstr "گزنیه‌های برون‌داد میز فرمان" - -#: cmd/build.py:299 -msgid "increase verbosity (can be repeated)" -msgstr "افزایش ارائه‌ی جزئیّات (می تواند تکرار شود)" +#: ext/todo.py:61 +msgid "Todo" +msgstr "در دست انجام" -#: cmd/build.py:306 ext/apidoc.py:413 -msgid "no output on stdout, just warnings on stderr" -msgstr "بدون برون‌داد در درگاه خروجی استاندارد(stdout)، فقط هشدارها در درگاه استاندارد خطاها (stderr)" +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "مدخل فهرست اقدام پیدا شد: %s" -#: cmd/build.py:313 -msgid "no output at all, not even warnings" -msgstr "بدون هیچ برون‌داد، حتّی بدون هشدار" +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" -#: cmd/build.py:321 -msgid "do emit colored output (default: auto-detect)" -msgstr "خروجی رنگ شده منتشر شود (پیش‌فرض: تشخیص خودکار)" +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "( در%s و سطر %d جای گرفته است.)" -#: cmd/build.py:329 -msgid "do not emit colored output (default: auto-detect)" -msgstr "خروجی رنگ شده منتشر نشود (پیش‌فرض: تشخیص خودکار)" +#: ext/todo.py:166 +msgid "original entry" +msgstr "مدخل اصلی" -#: cmd/build.py:332 -msgid "warning control options" +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" msgstr "" -#: cmd/build.py:338 -msgid "write warnings (and errors) to given file" -msgstr "نوشتن هشدارها (و خطاها) در پرونده‌ی داده شده" +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "تبدیل با خطایی از کار افتاد:\n[stderr]\n%r\n[stdout]\n%r" -#: cmd/build.py:345 -msgid "turn warnings into errors" -msgstr "تغییر هشدارها به خطاها" +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" +msgstr "فرمان تبدیل %r را نمی توان اجرا کرد، تنظیمات image_converter را بررسی کنید" -#: cmd/build.py:353 -msgid "show full traceback on exception" -msgstr "نمایش گزارش کامل ردیابی ایراد" +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" +msgstr "دستورالعمل Graphviz نمی تواند هم نشانوند محتوا را داشته باشد و هم نام پرونده" -#: cmd/build.py:356 -msgid "run Pdb on exception" -msgstr "ایراد در اجرای Pdb" +#: ext/graphviz.py:153 +#, python-format +msgid "External Graphviz file %r not found or reading it failed" +msgstr "پرونده گنجانده شده‌ی خارجی Graphviz %r یا پیدا نشد و یا خواندنش با شکست رو به رو شد" -#: cmd/build.py:362 -msgid "raise an exception on warnings" +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "نادیده گرفتن دستورالعمل «graphviz» بدون محتوا." + +#: ext/graphviz.py:287 +#, python-format +msgid "graphviz_dot executable path must be set! %r" msgstr "" -#: cmd/build.py:405 -msgid "cannot combine -a option and filenames" -msgstr "نمی توان گزینه‌ی -a را با نام پرونده‌ها ترکیب کرد" +#: ext/graphviz.py:328 +#, python-format +msgid "" +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" +msgstr "فرمان dot %r نمی‌تواند اجرا شود (زیرا نیازمند برون‌داد graphviz است)، تنظیمات graphviz_dot را بررسی کنید" -#: cmd/build.py:437 +#: ext/graphviz.py:339 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" +msgid "" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "dot با خطایی از کار افتاد:\n[stderr]\n%r\n[stdout]\n%r" -#: cmd/build.py:456 -msgid "-D option argument must be in the form name=value" -msgstr "نشانوند گزینه‌ی D- می‌بایست در قالب نام=مقدار (name=value) باشد" +#: ext/graphviz.py:344 +#, python-format +msgid "" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "dot هیچ پرونده‌ی برون‌دادی تولید نکرد:\n[stderr]\n%r\n[stdout]\n%r" -#: cmd/build.py:463 -msgid "-A option argument must be in the form name=value" -msgstr "نشانوند گزینه‌ی A- می‌بایست در قالب نام=مقدار (name=value) باشد" +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" +msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "سازنده‌ی بدلی هیچ پرونده‌ای تولید نمی کند." +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" +msgstr "کد دات: %r: %s" -#: builders/linkcheck.py:75 +#: ext/graphviz.py:493 ext/graphviz.py:501 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "به دنبال هر یک از خطاهای بالا در یا در برون‌داد و یا در %(outdir)s/output.txt بگردید" +msgid "[graph: %s]" +msgstr "[گراف:%s]" -#: builders/linkcheck.py:146 +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" +msgstr "[گراف:]" + +#: ext/imgmath.py:148 #, python-format -msgid "broken link: %s (%s)" -msgstr "پیوند خراب: %s (%s)" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "فرمان لتکس %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_latex را بررسی کنید" -#: builders/linkcheck.py:540 +#: ext/imgmath.py:167 #, python-format -msgid "Anchor '%s' not found" -msgstr "مهار '%s' پیدا نشد" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%sفرمان %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_%s را بررسی کنید" -#: builders/linkcheck.py:742 +#: ext/imgmath.py:326 #, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "شکست در گردآوری عبارات باقاعده در linkcheck_allowed_redirects: %r %s" +msgid "display latex %r: %s" +msgstr "نمایش لتکس: %r: %s" -#: builders/singlehtml.py:37 +#: ext/imgmath.py:362 #, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "صفحه HTML در %(outdir)s است." +msgid "inline latex %r: %s" +msgstr "لتکس بین سطری: %r: %s" -#: builders/singlehtml.py:173 -msgid "assembling single document" -msgstr "سر جمع کرد تک سند" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" -#: builders/latex/__init__.py:346 builders/manpage.py:56 -#: builders/singlehtml.py:178 builders/texinfo.py:121 -msgid "writing" -msgstr "در حال نوشتن" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "فاقد «+» یا «-» در گزینه‌ی '%s'." -#: builders/singlehtml.py:191 -msgid "writing additional files" -msgstr "نوشتن پرونده‌های اضافی" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "\"%s\" یک گزینه‌ی معتبر نیست." -#: builders/manpage.py:39 +#: ext/doctest.py:139 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "صفحات راهنما در %(outdir)s است." +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' یک گزینه‌ی معتبر نسخه‌ی پایتون (pyversion) نیست" -#: builders/manpage.py:47 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "هیچ مقداری برای تنظیمات «صفحات راهنما» ا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "نوع TestCode نامعتبر" -#: builders/manpage.py:73 +#: ext/doctest.py:297 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "پیکربندی مقدارهای «صفحات راهنما» به سند ناشناخته‌ای ارجاع می‌دهند %s" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "آزمایش مستندات منابع به پایان رسید، به نتایج در %(outdir)s/output.txt نگاهی بیاندازید." -#: builders/text.py:34 +#: ext/doctest.py:451 #, python-format -msgid "The text files are in %(outdir)s." -msgstr "پرونده‌ی متنی در پوشه‌ی %(outdir)s است." +msgid "no code/output in %s block at %s:%s" +msgstr "بدون کد/خروجی در تکّه‌ی %s در %s:%s" -#: builders/html/__init__.py:1239 builders/text.py:81 builders/xml.py:97 +#: ext/doctest.py:568 #, python-format -msgid "error writing file %s: %s" -msgstr "خطای نوشتن پرونده: %s, %s" +msgid "ignoring invalid doctest code: %r" +msgstr "نادیده گرفتن کد پیمانه‌ی doctest : %r" -#: builders/xml.py:38 +#: ext/autosectionlabel.py:52 #, python-format -msgid "The XML files are in %(outdir)s." -msgstr "پرونده‌ی XML در پوشه‌ی %(outdir)s است." +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "" -#: builders/xml.py:110 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "پرونده‌های شبه XML در پوشه‌ی %(outdir)s." +msgid "duplicate label %s, other instance in %s" +msgstr "بر چسب تکراری %s، مورد دیگر در %s قرار دارد" -#: builders/texinfo.py:47 +#: ext/duration.py:47 #, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "پرونده‌ی اطّلاعات متن در پوشه‌ی %(outdir)s است." +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" -#: builders/texinfo.py:49 +#: ext/duration.py:117 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nدر آن شاخه فرمان 'make' را اجرا کنید تا این‌ها رh با makeinfo اجرا کند\n(برای انجام خودکار `make info' را به کار ببرید)." - -#: builders/texinfo.py:78 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "هیچ تنظیماتی برای «صفحات راهنما» پیدا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد" +"====================== total reading duration ==========================" +msgstr "" -#: builders/texinfo.py:90 +#: ext/duration.py:124 #, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "مقدار پیکربندی اطّلاعات متن سندها (texinfo_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" + +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "====================== کند ترین زمان خواندن =======================" -#: builders/latex/__init__.py:324 builders/texinfo.py:115 +#: ext/duration.py:139 #, python-format -msgid "processing %s" -msgstr "در حال پردازش %s" +msgid "%.3fs %s" +msgstr "" -#: builders/latex/__init__.py:404 builders/texinfo.py:174 -msgid "resolving references..." -msgstr "حل ارجاع‌ها..." +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[منبع]" -#: builders/latex/__init__.py:415 builders/texinfo.py:184 -msgid " (in " -msgstr " (در " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "برجسته کردن کد پیمانه... " -#: builders/_epub_base.py:423 builders/html/__init__.py:778 -#: builders/latex/__init__.py:482 builders/texinfo.py:202 -msgid "copying images... " -msgstr "در حال رونوشت از تصاویر... " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[مستندات]" + +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "کد ماژول" -#: builders/_epub_base.py:445 builders/latex/__init__.py:497 -#: builders/texinfo.py:219 +#: ext/viewcode.py:359 #, python-format -msgid "cannot copy image file %r: %s" -msgstr "نمی تواند پرونده‌ی تصویر %r: %s را کپی کند" +msgid "

        Source code for %s

        " +msgstr "

        کد منبع برای %s

        " -#: builders/texinfo.py:226 -msgid "copying Texinfo support files" -msgstr "رونوشت از پرونده‌های با پشتیبانی اطلاعات متن" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "بررسی اجمالی: کد ماژول" -#: builders/texinfo.py:234 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "خطای نوشتن پرونده‌ی ساخت (Makefile) : %s" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        همه‌ی پیمانه‌هایی که برایشان کد در دسترس است

        " -#: builders/gettext.py:230 +#: domains/citation.py:75 #, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "سیاهه‌های پیام‌ها در %(outdir)s است." +msgid "duplicate citation %s, other instance in %s" +msgstr "نقل‌قول %s تکراری، مورد دیگر در %s قرار دارد" -#: builders/__init__.py:383 builders/gettext.py:251 +#: domains/citation.py:92 #, python-format -msgid "building [%s]: " -msgstr "ساخت [%s]: " +msgid "Citation [%s] is not referenced." +msgstr "نقل [%s] قول ارجاع داده نشده." -#: builders/gettext.py:252 +#: domains/math.py:73 #, python-format -msgid "targets for %d template files" -msgstr "مقصد‌های قالب پرونده‌های %d" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "بر چسب معادله ی %s تکرار است، مورد دیگر در %s قرار دارد" -#: builders/gettext.py:257 -msgid "reading templates... " -msgstr "خواندن قالب‌ها... " +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "قالب مرجع معادله‌‌ی ریاضی (math_eqref_format) نامعتبر: %r" -#: builders/gettext.py:292 -msgid "writing message catalogs... " -msgstr "نوشتن سیاهه‌های پیام... " +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (توابع درونی)" -#: builders/__init__.py:212 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s (%s)" +msgid "%s() (%s method)" +msgstr "%s() (%s متد)" -#: builders/__init__.py:220 +#: domains/javascript.py:186 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s" +msgid "%s() (class)" +msgstr "%s (کلاس)" -#: builders/__init__.py:243 -msgid "building [mo]: " -msgstr "ساخت پرونده‌ی [mo]: " +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" +msgstr "%s (متغیّر عمومی یا مقدار ثابت)" -#: builders/__init__.py:246 builders/__init__.py:741 builders/__init__.py:773 -msgid "writing output... " -msgstr "نوشتن برون‌داد... " +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" +msgstr "%s (%s مشخصه)" + +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "نشانوندها" + +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "ایجاد" + +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "بازگشت ها" + +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "نوع برگشتی" -#: builders/__init__.py:263 +#: domains/javascript.py:374 #, python-format -msgid "all of %d po files" -msgstr "همه‌ی پرونده‌های %d po" +msgid "%s (module)" +msgstr "%s (ماژول)" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "تابع" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "متد" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "کلاس" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "داده" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "مشخّصه" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "ماژول" -#: builders/__init__.py:285 +#: domains/javascript.py:458 #, python-format -msgid "targets for %d po files that are specified" -msgstr "اهداف برای %d پرونده‌های poی که مشخّص شده" +msgid "duplicate %s description of %s, other %s in %s" +msgstr "توضیح %s تکراری از %s، مورد دیگر%s در %s قرار دارد" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "مقصد‌های %d پرونده‌های poی هستند که منسوخ شده‌اند" +msgid "%s (directive)" +msgstr "%s (دستورالمعل)" -#: builders/__init__.py:307 -msgid "all source files" -msgstr "همه‌ی پرونده‌های منبع" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr "%s (گزینه‌ی دستورالمعل)" -#: builders/__init__.py:319 +#: domains/rst.py:224 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +msgid "%s (role)" +msgstr "%s (نقش)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "دستورالمعل" + +#: domains/rst.py:235 +msgid "directive-option" +msgstr "گزینه‌ی دستورالمعل" -#: builders/__init__.py:325 +#: domains/rst.py:236 +msgid "role" +msgstr "نقش" + +#: domains/rst.py:262 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "پرونده‌ی %r که در خط فرمان داده شده، در شاخه‌ی منبع نیست, نادیده گرفته می‌شود" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "توضیح تکراری از %s %s، مورد دیگر در %s قرار دارد" -#: builders/__init__.py:336 +#: domains/changeset.py:32 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:351 +#: domains/changeset.py:33 #, python-format -msgid "%d source files given on command line" -msgstr "پرونده‌های منبع %d داده شده در خط فرمان" +msgid "Changed in version %s" +msgstr "تغییر داده شده در نسخه %s" -#: builders/__init__.py:366 +#: domains/changeset.py:34 #, python-format -msgid "targets for %d source files that are out of date" -msgstr "مقصد‌های %d پرونده‌های منبعی هستند که منسوخ شده‌اند" - -#: builders/__init__.py:394 -msgid "looking for now-outdated files... " -msgstr "در پی پرونده‌هایی که الآن منسوخ هستند... " +msgid "Deprecated since version %s" +msgstr "منسوخ شده از نسخه %s" -#: builders/__init__.py:398 +#: domains/changeset.py:35 #, python-format -msgid "%d found" -msgstr "%d تا مورد پیدا شد" +msgid "Removed in version %s" +msgstr "" -#: builders/__init__.py:400 -msgid "none found" -msgstr "چیزی پیدا نشد" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:407 -msgid "pickling environment" -msgstr "بارگذاری محیط pickle شده" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "شماره‌ی کار باید یک عدد مثبت باشد" -#: builders/__init__.py:414 -msgid "checking consistency" -msgstr "بررسی ثبات" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "برای اطّلاعات بیشتر به بروید." -#: builders/__init__.py:418 -msgid "no targets are out of date." -msgstr "هیچ مقدار تاریخ منسوخ نیست." +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nایجاد مستندات از پرونده‌های مبدأ.\n\nسازنده‌ی اسفنکس مستندات را از روی پرونده های مبنع در پوشه‌‌ی منبع تولید کرده در پوشه‌ی برون‌داد قرار می‌دهد.\nاین سازنده در پوشه‌ی مبدأ به دنبال پرونده 'conf.py' تنظیمات پیکربندی می‌گردد.\nاین امکان وجود دارد که از ابزار شروع سریع اسفینکس ('sphinx-quickstart') برای تولید پرونده‌های قالب، که شامل پرونده 'conf.py' هم می‌شود استفاده شود.\n\nسازنده‌ی اسفینکس می توند مستندات را در قالب‌های گوناگونی از پرونده‌های خروجی ایجاد کند. قالب پرونده خروجی با مشخّص کردن نام سازنده در خط فرمان مشخّص می‌شود که به صورت پیش فرض HTML است. همچنین، سازنده‌ها می‌توانند کارهای دیگر مربوط به فرآیند پردازش مستندسازی را انجام دهند.\n\nبه صورت پیش فرض، هر چیزی که منسوخ شده باشد تولید می‌شود. برون‌داد برای پرونده‌های منتخب می‌تواند فقط با مشخّص کردن نام تک تک پرونده‌ها ساخته شود.\n" -#: builders/__init__.py:458 -msgid "updating environment: " -msgstr "به روز رسانی محیط: " +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "مسیر پرونده‌های مستندات" -#: builders/__init__.py:483 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s اضافه شد، %s تغییر کرد، %s حذف شد" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "مسیری برای شاخه‌ی برون داد" -#: builders/__init__.py:519 -#, python-format +#: cmd/build.py:109 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:528 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +#: cmd/build.py:114 +msgid "general options" +msgstr "گزینه‌های کلی" -#: builders/__init__.py:539 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:546 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:565 builders/__init__.py:581 -msgid "reading sources... " -msgstr "خواندن منبع‌ها... " +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "نوشتن همه‌ی پرونده‌ها (پیش‌گزیده: فقط پرونده‌های جدید نو تغییر یافته را بنویس)" -#: builders/__init__.py:698 -#, python-format -msgid "docnames to write: %s" -msgstr "نام مستندات برای نوشتن: %s" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "از محیط ذخیره شده استفاده نکن، همیشه همه پرونده ها را بخوان" -#: builders/__init__.py:711 -msgid "preparing documents" -msgstr "آماده سازی اسناد" +#: cmd/build.py:150 +msgid "path options" +msgstr "" -#: builders/__init__.py:714 -msgid "copying assets" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:866 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "نویسه‌ی منبع غیرقابل رمزگشایی، جایگزین با «؟» : %r" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "" -#: builders/epub3.py:83 -#, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "پرونده‌ی ePub در پوشه‌ی %(outdir)s است." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "نوشتن پرونده‌ی nav.xhtml..." +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "نادیده گرفتن تنظیماتی در پرونده‌ی پیکره‌بندی" -#: builders/epub3.py:220 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "مقدار پیکربندی زبان پرونده epub (\"epub_language\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "مقداری را به قالب‌های HTML بدهید" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "مقدار پیکربندی شناسه‌ی یکتای انتشار الکترونیکی (\"epub_uid\") باید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) یک XML NAME باشد" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "تعریف برچسب: «فقط» تکّه‌های با برچسب گنجانده شود" -#: builders/epub3.py:231 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "مقدار پیکربندی عنوان (\"html_title\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "مقدار پیکربندی مؤلّف (\"epub_author\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" +#: cmd/build.py:212 +msgid "console output options" +msgstr "گزنیه‌های برون‌داد میز فرمان" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "مقدار پیکربندی حامی (\"epub_contributor\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "افزایش ارائه‌ی جزئیّات (می تواند تکرار شود)" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "مقدار پیکربندی توضیحات (\"epub_description\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "بدون برون‌داد در درگاه خروجی استاندارد(stdout)، فقط هشدارها در درگاه استاندارد خطاها (stderr)" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "مقدار پیکربندی ناشر (\"epub_publisher\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "بدون هیچ برون‌داد، حتّی بدون هشدار" -#: builders/epub3.py:255 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "مقدار پیکربندی حق انتشار (\"epub_copyright\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "خروجی رنگ شده منتشر شود (پیش‌فرض: تشخیص خودکار)" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "مقدار پیکربندی شناسه (\"epub_identifier\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "خروجی رنگ شده منتشر نشود (پیش‌فرض: تشخیص خودکار)" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "مقدار پیکربندی ویراست (\"version\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" +#: cmd/build.py:252 +msgid "warning control options" +msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1289 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "پرونده‌ی css نامعتبر%r: نادیده گرفته می‌شود" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "نوشتن هشدارها (و خطاها) در پرونده‌ی داده شده" -#: builders/_epub_base.py:222 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "عنوان تکراری در فهرست مطالب پیدا شد:%s" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "تغییر هشدارها به خطاها" -#: builders/_epub_base.py:434 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "امکان خواندن پرونده‌ی تصویری %r نبود: در عوض کپی می‌شود" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "نمایش گزارش کامل ردیابی ایراد" -#: builders/_epub_base.py:465 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "نمی تواند پرونده‌ی تصویری %r: %s را بنویسد" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "ایراد در اجرای Pdb" -#: builders/_epub_base.py:477 -msgid "Pillow not found - copying image files" -msgstr "Pillow پیدا نشد- رونوشت برداشتن از پرونده‌های تصویری" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" -#: builders/_epub_base.py:512 -msgid "writing mimetype file..." -msgstr "نوشتن پرونده‌های نوع رسانه..." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "نمی توان گزینه‌ی -a را با نام پرونده‌ها ترکیب کرد" -#: builders/_epub_base.py:521 -msgid "writing META-INF/container.xml file..." -msgstr "نوشتن پرونده META-INF/container.xml..." +#: cmd/build.py:357 +#, python-format +msgid "cannot open warning file '%s': %s" +msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "نوشتن پرونده‌ی content.opf..." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "نشانوند گزینه‌ی D- می‌بایست در قالب نام=مقدار (name=value) باشد" -#: builders/_epub_base.py:590 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "نوع رسانه‌ی ناشناخته %s، نادیده گرفته شد" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "نشانوند گزینه‌ی A- می‌بایست در قالب نام=مقدار (name=value) باشد" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "درج خودکار رشته‌مستندات را از پیمانه‌ها" -#: builders/_epub_base.py:764 -msgid "writing toc.ncx file..." -msgstr "نوشتن پرونده‌ی خلاصه toc.ncx..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "آزمایش خودکار تکّه‌کدها در قسمت‌های مختلف پیمانه‌ی doctest" -#: builders/_epub_base.py:793 -#, python-format -msgid "writing %s file..." -msgstr "نوشتن پرونده‌ی %s..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "پیوند بین اسناد Sphinx از پروژه های گوناگون" -#: builders/changes.py:33 -#, python-format -msgid "The overview file is in %(outdir)s." -msgstr "پرونده‌ی بازبینی در پوشه‌ی %(outdir)s است." +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "نوشتن مدخل‌های لیست اقدام‌ها (\"todo\")که در ساخت می تواند نشان داده و یا پنهان شوند" -#: builders/changes.py:60 -#, python-format -msgid "no changes in version %s." -msgstr "بدون تغییرات در نسخه‌ی %s." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "بررسی برای پوشش اسناد" -#: builders/changes.py:62 -msgid "writing summary file..." -msgstr "نوشتن پرونده‌ی خلاصه..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "گنجاندن رابطه‌های ریاضی که در قالب PNG یا SVG به نمایش در آمده" -#: builders/changes.py:74 -msgid "Builtins" -msgstr "درونی سازی" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "گنجاندن رابطه‌های ریاضی که MathJax در مرورگر نمایش در آورده" -#: builders/changes.py:76 -msgid "Module level" -msgstr "در سطح ماژول" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "گنجاندن شرطی محتوا بر اساس مقادیر پیکربندی" -#: builders/changes.py:128 -msgid "copying source files..." -msgstr "رونوشت از پرونده‌های مبدأ..." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "گنجاندن ویندهای کد منبع اشیاء مستند شده‌ی پایتون" -#: builders/changes.py:137 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "نمی‌توان %r را برای ایجاد گزارش تغییرات خواند" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "ساخت پرونده‌ی nojekyll برای انتشار سند در صفحات گیت-هاب" -#: util/rst.py:72 -#, python-format -msgid "default role %s not found" -msgstr "نقش پیش‌فرض %s یافت نشد" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "لطفاً نام مسیر معتبری را وارد کنید." -#: util/docfields.py:95 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "لطفاً متنی وارد کنید." -#: util/osutil.py:130 +#: cmd/quickstart.py:134 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +msgid "Please enter one of %s." +msgstr "لطفاً یکی از %s وارد کنید." -#: util/nodes.py:419 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "لطفاً یا y و یا n وارد کنید." -#: util/nodes.py:487 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "درختواره‌ی فهرست مطالب شامل ارجاع به پرونده ناموجود %r است" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "لطفاً یک پسوند را وارد کنید، مثل: '.rst' یا '.txt'." -#: util/nodes.py:701 +#: cmd/quickstart.py:230 #, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "ایراد در هنگام ارزیابی تنها عبارت دستور العمل: %s" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "به ابزار شروع سریع اسفینکس %s خوش آمدید." -#: util/fileutil.py:74 -#, python-format +#: cmd/quickstart.py:235 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "لطفاً مقدارهای تنظیمات زیر را وارد کنید\n(اگر مقدار پیش‌گزیده‌ای درون داده کروشه شده بود، برای برای پذیرش آن فقط کلید Enter‌را فشار دهید)." -#: util/fileutil.py:89 +#: cmd/quickstart.py:242 #, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +msgid "Selected root path: %s" +msgstr "مسیر برگزیده‌ی ریشه‌ی مستندات: %s" -#: util/inventory.py:170 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "مسیر ریشه‌ی مستندات را وارد کنید." -#: util/inventory.py:185 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "مسیر ریشه‌ی مستندات" -#: util/docutils.py:284 -#, python-format -msgid "unknown directive or role name: %s:%s" -msgstr "نام نقش یا دستورالعمل ناشناخته: %s:%s" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "خطا: در مسیر ریشه‌ی انتخاب شده‌، پرونده‌ی conf.pyی دیگری یپدا شد." -#: util/docutils.py:747 -#, python-format -msgid "unknown node type: %r" -msgstr "بست از نوع ناشناخته: %r" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "ابراز شروع سریع اسفینکس روی پروژه‌های از قبل موجود اسفینکس بازنویسی نمی‌کند." -#: util/display.py:81 -msgid "skipped" -msgstr "رد شدن و نادیده انگاشتن" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "لطفاً یک مسیر ریشه‌ی جدید وارد کنید (یا برای خروج Enter‌ را بزنید)" -#: util/display.py:86 -msgid "failed" -msgstr "شکست خورد" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "شما برای تعیین شاخه‌ی ساخت برای برون‌داد اسفینکس دو گزینه دارید.\nیا از شاخه‌ای با نام \"_build\" درون شاخه‌ی ریشه استفاده کنید،\nو یا شاخه‌های را درون یک مسیر ریشه با نام‌های منبع (source) و ساخت (build) جدا کنید." -#: util/i18n.py:103 -#, python-format -msgid "reading error: %s, %s" -msgstr "خطای خواندن: %s, %s" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "شاخه‌های منبع و ساخت از یکدیگر جدا شوند؟(y/n)" -#: util/i18n.py:110 -#, python-format -msgid "writing error: %s, %s" -msgstr "خطای نوشتن: %s, %s" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "درون شاخه‌ی ریشه، دو شاخه‌ی دیگر ساخته خواهد شد؛\n\"_templates\" برای قالب‌های سفارشی HTML و \"_static\" برای قالب برگه‌ها و بقیّه‌ی پرونده‌های ثابت.\nشما می‌توانید پیشوند دیگری (مانند «.») برای جایگزینی نویسه‌ی خط به کار ببرید." -#: util/i18n.py:138 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "برای شاخه‌های قالب‌ها (templates) و ثابت‌ها (static) نویسه‌ی پیشوندی را بنویسید" -#: util/i18n.py:230 -#, python-format +#: cmd/quickstart.py:298 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "قالب تاریخ ناشناخته. اگر می‌خواهید از رشته‌متن مستقیماً خروجی بگیرید، آن را با نقل قول رشته‌متنی محصور کنید: %s" +"The project name will occur in several places in the built documentation." +msgstr "نام پروژه در چندین جا در سند ساخته شده به کار می‌رود." -#: directives/patches.py:66 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "گزینه‌ی \":file:\" برای دستورالمعل جدول داده‌های جداشده با کاما (csv-table) حالا دیگر مسیر ثابت را یک مسیر نسبی از شاخه‌ی منبع در نظر می گیرد. لطفاُ سندتان را به روز رسانی کنید." +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "نام پروژه" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "غیرفاصله‌ در فرآیند حذف فاصله‌ از ابتدای سطر حذف شد" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "نام نویسنده (ها)" -#: directives/code.py:87 -#, python-format -msgid "Invalid caption: %s" -msgstr "برچسب نامعتبر:%s" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "اسفینکس نظریّه‌ای برای یک «نسخه» و یک «نگارش» برای نرم افزار دارد.\nهر نسخه‌ای می تواند چندید نگارش داشته باشد.\n مثلاً برای پایتون نسخه‌ چیزی شبیه به ۲/۵ یا ۳/۰ است،\n در حالی که انتشار چیزیست شبیه به ۲/۵/۱ یا ۳/۰a۱ \n.\nاگر شما نیازی به این ساختار دوگانه ندارید، هر دو را یکی تعیین کنید." -#: directives/code.py:132 directives/code.py:297 directives/code.py:484 -#, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "شماره‌ی سطر مشخّص شده خارج از بازه‌ی (1-%d) است: %r" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "نسخه انتشار پروژه" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "امکان استفاده از هر دوی %sو%s نیست" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "انتشار پروژه" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "اگر مستندات قرار است با زبانی غیر از انگلیسی نوشته شود،\nمی توانید همین‌جا یک زبان را با انتخاب کد زبانیش انتخاب کنید.\nاسفینکس سپس متن‌هایی را که تولید می‌کند را به آن زبان ترجمه می‌کند.\n\nبرای فهرست زبان‌های پشتیبانی شده، به این نشانی مراجعه کنید\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: directives/code.py:234 -#, python-format +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "زبان پروژه" + +#: cmd/quickstart.py:340 msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "پسوند نام پرونده برای پرونده‌های منبع. معمولاً این پسوند یا \".txt\" است و یا \".rst\".\nفقط پرونده‌هایی بای این پسوند به عنوان اسناد در نظر گرفته می‌شوند." -#: directives/code.py:276 -#, python-format -msgid "Object named %r not found in include file %r" -msgstr "شیئ با نام %r در پرونده‌ی %r پیدا نشد" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "پسوند پرونده‌ی منبع" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "امکان استفاده‌ی گزینه‌ی «هم‌خوان شماره‌ی سطر» (lineno-match) با مجموعه‌ی سطرهای گسیخته وجود ندارد" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "یک سند از آن جهت خاص است که به عنوان بست بالایی «درختواره‌ی محتوا» در نظر گرفته می‌شود.\nیعنی، این سند ریشه‌ی ساختار سلسله مراتبی اسناد است.\nمعمولاً سند این کار «نمایه» است، ولی اگر سند «نمایه‌»‌ی شما قالب سفارشی است؛ می توانید آن را به نام دیگری تغییر دهید." -#: directives/code.py:314 -#, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "سطر مشخّص شده %r: هیچ سطری از پرونده‌ی گنجانده شده %r بیرون کشیده نشده" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "نام سند اصلی شما (بدون پسوند)" -#: directives/other.py:122 +#: cmd/quickstart.py:368 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "" +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "خطا: پرونده‌ی اصلی %s از قبل در مسیر ریشه‌ی برگزیده بوده‌است." -#: directives/other.py:155 environment/adapters/toctree.py:355 -#, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "درختواره‌ی فهرست مطالب ارجاعی به سند کنار گذاشته شده %r را دارد" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "ابراز شروع سریع اسفینکس روی پرونده‌های از قبل موجود بازنویسی نمی‌کند." -#: directives/other.py:158 environment/adapters/toctree.py:359 +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "لطفاُ یک نام جدید وارد کنید، یا نام پرونده‌ی موجود را تغییر دهید و Enter‌ را فشار دهید" + +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "مشخّص کنید کدام یک از این افزونه‌های اسفینکس باید فعّال باشد:" + +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "یادداشت: ابزارهای‌ imgmath و mathjax نمی‌توانند در یک زمان فعّال باشند. انتخاب imgmath لغو شد." + +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "پرونده‌های خط‌فرمان ویندوز و Makefile می‌توانند برای شما تولید شوند، به گونه‌ای که شما فقط نیاز باشد تا مثلاً فرمان `make html' را به جای فراخوان مستقیم ابزار ساخت اسفینکس اجرا کنید." + +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "آیا پرونده‌ی‌ make ایجاد شود؟ (y/n)" + +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "آیا پرونده‌ی خط فرمان ویندوز ساخته شود؟ (y/n)ٍ" + +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "فهرست مطالب شامل ارجاع به سند ناموجود %r است" +msgid "Creating file %s." +msgstr "ایجاد پرونده‌ی %s." -#: directives/other.py:171 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" +msgid "File %s already exists, skipping." +msgstr "پرونده‌ی %s در حال حاضر وجود دارد، رد شدن." -#: directives/other.py:204 -msgid "Section author: " -msgstr "نویسنده این بخش: " +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "پایان یافت: ساختار آغازین شاخه ایجاد شد." -#: directives/other.py:206 -msgid "Module author: " -msgstr "نویسنده این ماژول: " +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "شما باید حالا دیگر پرونده‌ی اصلی‌تان %s را جمع آوری کنید\n و بقیّه‌ی پرونده‌های منبع مستندات را ایجاد کنید. " -#: directives/other.py:208 -msgid "Code author: " -msgstr "نویسنده ی کد: " +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "از Makefile برای ساختن مستندات استفاده کنید، مانند این:\n make builder" -#: directives/other.py:210 -msgid "Author: " -msgstr "نویسنده: " +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "از فرمان ساخت اسفینکس برای ساختن مستندات استفاده کنید، مانند این:\n sphinx-build -b builder %s %s" -#: directives/other.py:284 -msgid ".. acks content is not a list" -msgstr "" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "که در آن سازنده یکی از سازنده‌های پشتیبانی شده است، مانند html, latex و یا linkcheck." -#: directives/other.py:309 -msgid ".. hlist content is not a list" -msgstr "" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nتولید پرونده‌های مورد نیاز برای یک پروژه‌ی اسفینکس\n\nابزار شروع سریع اسفینکس ابزاری تعاملی است که شماری سؤال درباره‌ی پروژه‌یتان از شما می پرسد\nو سپس یک شاخه‌ی کامل مستندات و پرونده ساخت Makefile را برای استفاده به همراه ابزار ساخت اسفینکس تولید می‌کند.\n" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "حالت سکوت" -#: _cli/__init__.py:75 -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "ریشه‌ی پروژه" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "گزینه‌های ساختار" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "در صورتی مشخّص شدن، شاخه‌های منبع و ساخت از یکدیگر جدا می‌شوند" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "در صورت مشخّص بودن، شاخه‌ی build (ساخت) را درون شاخه‌ی منبع بساز" -#: _cli/__init__.py:112 _cli/__init__.py:183 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "جایگزینی نقطه در _templates (قالب‌ها) و ... ." -#: _cli/__init__.py:172 -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "گزینه‌های اساسی پروژه" -#: _cli/__init__.py:182 -msgid " Manage documentation with Sphinx." -msgstr "" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "نام پروژه" -#: _cli/__init__.py:194 -msgid "Show the version and exit." -msgstr "" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "نام نویسندگان" -#: _cli/__init__.py:202 -msgid "Show this message and exit." -msgstr "" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "نسخه انتشار پروژه" -#: _cli/__init__.py:206 -msgid "Logging" -msgstr "" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "انتشار پروژه" -#: _cli/__init__.py:213 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "زبان سند" -#: _cli/__init__.py:221 -msgid "Only print errors and warnings." -msgstr "" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "پسوند پرونده‌ی منبع" -#: _cli/__init__.py:228 -msgid "No output at all" -msgstr "" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "نام سند اصلی" -#: _cli/__init__.py:234 -msgid "" -msgstr "" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "استفاده epub" -#: _cli/__init__.py:265 -msgid "See 'sphinx --help'.\n" -msgstr "" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "گزینه‌های افزونه" -#: builders/html/__init__.py:486 builders/latex/__init__.py:198 -#: transforms/__init__.py:133 writers/manpage.py:102 writers/texinfo.py:219 +#: cmd/quickstart.py:671 #, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" +msgid "enable %s extension" +msgstr "فعّال‌سازی %s افزونه" -#: transforms/__init__.py:143 -msgid "could not calculate translation progress!" -msgstr "" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "فعّال‌سازی افزونه‌های اختیاری" -#: transforms/__init__.py:148 -msgid "no translated elements!" -msgstr "" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "ایجاد Makefile و Batchfile" -#: transforms/__init__.py:267 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "نمایه‌ای بر پایه‌ی ۴ ستون پیدا شد. شاید یک اشکال برنامه‌نویسی از افزونه‌هایی که استفاده می‌کنید باشد: %r" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "ایجاد پرونده‌ی سازنده (makefile)" -#: transforms/__init__.py:313 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "پانویس [%s] ارجاع داده نشده است." +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "پرونده‌ی سازنده (makefile) را ایجاد نکن" -#: transforms/__init__.py:322 -msgid "Footnote [*] is not referenced." -msgstr "" +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "ایجاد Batchfile" -#: transforms/__init__.py:333 -msgid "Footnote [#] is not referenced." -msgstr "پانویس [#] ارجاع داده نشده است." +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "batchfile را ایجاد نکن" -#: transforms/i18n.py:228 transforms/i18n.py:303 -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "ارجاعات پانویس ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "اسفتاده از حالت ایجاد برای پرونده‌های Makefile/make.bat" -#: transforms/i18n.py:273 -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "ارجاعات ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "قالب سازی پروژه" -#: transforms/i18n.py:323 -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "ارجاعات نقل قول ادبی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "شاخه‌ی قالب شامل پرونده‌های قالب" -#: transforms/i18n.py:345 -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "ارجاعات اصطلاحی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "تعریف متغیّر قالب" -#: ext/linkcode.py:75 ext/viewcode.py:201 -msgid "[source]" -msgstr "[منبع]" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "حالت «ساکت» تعیین شده، ولی یکی از موارد «پروژه» یا «نویسنده» مشخّص نشده." -#: ext/imgconverter.py:40 -#, python-format +#: cmd/quickstart.py:786 msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "خطا: مسیر مشخّص شده پوشه نیست، یا از قبل پرونده‌های اسفینکس وجود داشته‌اند." -#: ext/imgconverter.py:49 ext/imgconverter.py:73 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "تبدیل با خطایی از کار افتاد:\n[stderr]\n%r\n[stdout]\n%r" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "ابزار شروع سریع اسفینکس فقط یک پوشه‌ی خالی درست می کند. لطفاً یک مسیر ریشه‌ی جدید مشخّص کنید." -#: ext/imgconverter.py:68 +#: cmd/quickstart.py:810 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "فرمان تبدیل %r را نمی توان اجرا کرد، تنظیمات image_converter را بررسی کنید" - -#: ext/viewcode.py:258 -msgid "highlighting module code... " -msgstr "برجسته کردن کد پیمانه... " - -#: ext/viewcode.py:286 -msgid "[docs]" -msgstr "[مستندات]" - -#: ext/viewcode.py:306 -msgid "Module code" -msgstr "کد ماژول" +msgid "Invalid template variable: %s" +msgstr "متغیرهای نامعتبرقالب؛ %s" -#: ext/viewcode.py:312 +#: directives/other.py:119 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        کد منبع برای %s

        " - -#: ext/viewcode.py:338 -msgid "Overview: module code" -msgstr "بررسی اجمالی: کد ماژول" - -#: ext/viewcode.py:339 -msgid "

        All modules for which code is available

        " -msgstr "

        همه‌ی پیمانه‌هایی که برایشان کد در دسترس است

        " +msgid "toctree glob pattern %r didn't match any documents" +msgstr "" -#: ext/coverage.py:47 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "invalid regex %r in %s" -msgstr "عبارت باقاعده‌ی نامعتبر %r در %s" +msgid "toctree contains reference to excluded document %r" +msgstr "درختواره‌ی فهرست مطالب ارجاعی به سند کنار گذاشته شده %r را دارد" -#: ext/coverage.py:134 ext/coverage.py:280 +#: directives/other.py:156 #, python-format -msgid "module %s could not be imported: %s" -msgstr "امکان وارد کردن پیمانه‎ی %s نبود: %s" +msgid "toctree contains reference to nonexisting document %r" +msgstr "فهرست مطالب شامل ارجاع به سند ناموجود %r است" -#: ext/coverage.py:141 +#: directives/other.py:169 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: ext/coverage.py:149 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +#: directives/other.py:203 +msgid "Section author: " +msgstr "نویسنده این بخش: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "نویسنده این ماژول: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "نویسنده ی کد: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "نویسنده: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: ext/coverage.py:163 -#, python-format +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." -msgstr "آزمودن پوشش منابع پایان یافت، به نتایج در %(outdir)spython.txt نگاهی بیاندازید." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "گزینه‌ی \":file:\" برای دستورالمعل جدول داده‌های جداشده با کاما (csv-table) حالا دیگر مسیر ثابت را یک مسیر نسبی از شاخه‌ی منبع در نظر می گیرد. لطفاُ سندتان را به روز رسانی کنید." -#: ext/coverage.py:177 -#, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "عبارات باقاعده‌ی نامعتبر %r در پوشش عبارت باقاعده‌ی زبان سی (coverage_c_regexes)" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "غیرفاصله‌ در فرآیند حذف فاصله‌ از ابتدای سطر حذف شد" -#: ext/coverage.py:245 +#: directives/code.py:87 #, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "رابط برنامه‌نویسی مستند نشده‌ی C: %s [%s] در پرونده‌ی %s" +msgid "Invalid caption: %s" +msgstr "برچسب نامعتبر:%s" -#: ext/coverage.py:429 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "undocumented python function: %s :: %s" -msgstr "تابع پایتونی بدون مستندات: %s :: %s" +msgid "line number spec is out of range(1-%d): %r" +msgstr "شماره‌ی سطر مشخّص شده خارج از بازه‌ی (1-%d) است: %r" -#: ext/coverage.py:445 +#: directives/code.py:216 #, python-format -msgid "undocumented python class: %s :: %s" -msgstr "کلاس مستندسازی نشده‌ی پایتون: %s :: %s" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "امکان استفاده از هر دوی %sو%s نیست" -#: ext/coverage.py:458 +#: directives/code.py:231 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "شگرد مستندسازی نشده‌ی پایتون: %s :: %s :: %s" +msgid "Include file '%s' not found or reading it failed" +msgstr "" -#: ext/todo.py:71 -msgid "Todo" -msgstr "در دست انجام" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" -#: ext/todo.py:104 +#: directives/code.py:276 #, python-format -msgid "TODO entry found: %s" -msgstr "مدخل فهرست اقدام پیدا شد: %s" +msgid "Object named %r not found in include file %r" +msgstr "شیئ با نام %r در پرونده‌ی %r پیدا نشد" -#: ext/todo.py:163 -msgid "<>" -msgstr "<>" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "امکان استفاده‌ی گزینه‌ی «هم‌خوان شماره‌ی سطر» (lineno-match) با مجموعه‌ی سطرهای گسیخته وجود ندارد" -#: ext/todo.py:165 +#: directives/code.py:314 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "( در%s و سطر %d جای گرفته است.)" - -#: ext/todo.py:175 -msgid "original entry" -msgstr "مدخل اصلی" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "سطر مشخّص شده %r: هیچ سطری از پرونده‌ی گنجانده شده %r بیرون کشیده نشده" -#: ext/extlinks.py:82 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "فهرست" + +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "به بست عنوانی برخورد که در قسمت، موضوع، جدول، اندرز یا نوارکناری نبود" -#: ext/doctest.py:115 -#, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "فاقد «+» یا «-» در گزینه‌ی '%s'." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "پانویس ها" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "عنوان درون شکل نیست." -#: ext/doctest.py:120 +#: writers/texinfo.py:1303 #, python-format -msgid "'%s' is not a valid option." -msgstr "\"%s\" یک گزینه‌ی معتبر نیست." +msgid "unimplemented node type: %r" +msgstr "بست به کار نرفته: %r" -#: ext/doctest.py:134 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' یک گزینه‌ی معتبر نسخه‌ی پایتون (pyversion) نیست" +msgid "[image: %s]" +msgstr "[تصویر%s]" -#: ext/doctest.py:220 -msgid "invalid TestCode type" -msgstr "نوع TestCode نامعتبر" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[تصویر]" -#: ext/doctest.py:281 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "آزمایش مستندات منابع به پایان رسید، به نتایج در %(outdir)s/output.txt نگاهی بیاندازید." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "" -#: ext/doctest.py:434 +#: writers/html5.py:431 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "بدون کد/خروجی در تکّه‌ی %s در %s:%s" +msgid "numfig_format is not defined for %s" +msgstr "قالب عدد شکل برای %s تعریف نشده" -#: ext/doctest.py:522 +#: writers/html5.py:441 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "نادیده گرفتن کد پیمانه‌ی doctest : %r" +msgid "Any IDs not assigned for %s node" +msgstr "هر کدام از شناسه‌هایی که به بست %s اختصاص داده نشده" -#: ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" -msgstr "دستورالعمل Graphviz نمی تواند هم نشانوند محتوا را داشته باشد و هم نام پرونده" +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" -#: ext/graphviz.py:145 -#, python-format -msgid "External Graphviz file %r not found or reading it failed" -msgstr "پرونده گنجانده شده‌ی خارجی Graphviz %r یا پیدا نشد و یا خواندنش با شکست رو به رو شد" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" -#: ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." -msgstr "نادیده گرفتن دستورالعمل «graphviz» بدون محتوا." +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" -#: ext/graphviz.py:268 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "graphviz_dot executable path must be set! %r" +msgid "unsupported rubric heading level: %s" msgstr "" -#: ext/graphviz.py:303 -#, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" -msgstr "فرمان dot %r نمی‌تواند اجرا شود (زیرا نیازمند برون‌داد graphviz است)، تنظیمات graphviz_dot را بررسی کنید" +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" -#: ext/graphviz.py:310 -#, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "dot با خطایی از کار افتاد:\n[stderr]\n%r\n[stdout]\n%r" +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" -#: ext/graphviz.py:313 -#, python-format -msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "dot هیچ پرونده‌ی برون‌دادی تولید نکرد:\n[stderr]\n%r\n[stdout]\n%r" +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" -#: ext/graphviz.py:329 -#, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" -msgstr "قالب خروجی graphviz باید یکی از قالب های 'png' یا 'svg' باشد ولی %r است" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "امکان دست یابی به اندازه‌ی عکس نبود. گزینه‌ی تغییر اندازه :scale: نادیده گرفته می‌شود." -#: ext/graphviz.py:333 ext/graphviz.py:386 ext/graphviz.py:423 +#: writers/latex.py:386 #, python-format -msgid "dot code %r: %s" -msgstr "کد دات: %r: %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "قسمت‌بندی رده‌بالای %r ناشناخته برای کلاس %r" -#: ext/graphviz.py:436 ext/graphviz.py:444 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "[graph: %s]" -msgstr "[گراف:%s]" +msgid "no Babel option known for language %r" +msgstr "بدون گزینه‌ی Babel شناخته شده برای زبان %r" -#: ext/graphviz.py:438 ext/graphviz.py:446 -msgid "[graph]" -msgstr "[گراف:]" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "مقدار بسیار بزرگ :maxdepth:، نادیده گرفته شد." -#: ext/imgmath.py:369 ext/mathjax.py:52 -msgid "Link to this equation" +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: ext/apidoc.py:85 -#, python-format -msgid "Would create file %s." -msgstr "پرونده‌ی %s را می سازد." +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "عنوان سند یک بست متنی نیست" -#: ext/apidoc.py:375 +#: writers/latex.py:1198 msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nبه صورت بازگشتی در مسیر دنبال پیمانه‌هاو بسته‌های پایتون بگرد و \nبا به ازای دستورالمعل‌های خودکار پیمانه‌ی هر بسته در مسیر خروجی یک پرونده‌ی reST بساز.\n\nالگوی استثتاء های می‌تواند الگوی پرونده‌ها و یا شاخه‌هایی باشد که از تولید کنار گذاشته شده‌اند.\n\nتوجّه: به صورت پیش فرض این اسکریپت روی پرونده‌های از پیش ساخته شده دوباره نویسی نمی‌کند." - -#: ext/apidoc.py:392 -msgid "path to module to document" -msgstr "مسیر پیمانه به سند" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "هر دو مقدار tabularcolumns و :widths: داده شده، بنابراین :widths: حذف می شود." -#: ext/apidoc.py:396 +#: writers/latex.py:1228 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "الگوها‌ی به سبک fnmatch در پرونده و یا شاخه برای کنار گذاشتن از تولید" - -#: ext/apidoc.py:407 -msgid "directory to place all output" -msgstr "پوشه‌ای برای قرار دادن همه‌ی برون دادها" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: ext/apidoc.py:422 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "نهایت عمق زیر پیمانه‌ها برای نشان دادن در فهرست مطالب (پیش‌گزیده: ۴)" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "ابعاد واحد %sنامعتبر است و نادیده گرفته شد." -#: ext/apidoc.py:429 -msgid "overwrite existing files" -msgstr "بازنویسی پرونده‌های موجود" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "نوع ناشناخته مدخل نمایه%s پیدا شد" -#: ext/apidoc.py:437 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "ردگیری پیوند نمادین. وقتی با collective.recipe.omelette ترکیب می‌شود توانمند است." +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: ext/apidoc.py:446 -msgid "run the script without creating files" -msgstr "اجرای اسکریپت بدون ساخت پرونده" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: ext/apidoc.py:453 -msgid "put documentation for each module on its own page" -msgstr "قرار دادن مستندات هر پیمانه در صفحه‌ی خودش" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" -#: ext/apidoc.py:460 -msgid "include \"_private\" modules" -msgstr "در برداشتن پیمانه‌های «خصوصی»(_private)" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: ext/apidoc.py:467 -msgid "filename of table of contents (default: modules)" -msgstr "نام پرونده فهرست مطالب (پیش‌گزیده: پیمانه‌ها)" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "" -#: ext/apidoc.py:474 -msgid "don't create a table of contents file" -msgstr "پرونده‌ی فهرست مطالب را ایجاد نکن" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: ext/apidoc.py:481 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "برای بسته‌ها و پیمانه‌ها سربرگ نساز (مثلاً وقتی رشته‌متن‌های مستندات از قبل آن‌ها را داشته باشند)" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "" -#: ext/apidoc.py:492 -msgid "put module documentation before submodule documentation" -msgstr "قرار دادن مستندات پیمانه پیش از مستندات پیمانه‌ی زیرمجموعه‌‌اش" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" -#: ext/apidoc.py:498 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "تفسیر مسیرهای پیمانه بر اساس ویژگی‌های ضمنی فضای نام‌ها در PEP -0420" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "" -#: ext/apidoc.py:508 -msgid "file suffix (default: rst)" -msgstr "پسوند پرونده ( پیش فرض: rst)" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: ext/apidoc.py:515 ext/autosummary/generate.py:839 -msgid "Remove existing files in the output directory that were not generated" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: ext/apidoc.py:524 -msgid "generate a full project with sphinx-quickstart" -msgstr "تولید یک پروژه‌ی کامل با ابزار شروع سریع اسفینکس" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: ext/apidoc.py:531 -msgid "append module_path to sys.path, used when --full is given" -msgstr "پیوست مسیر پیمانه (module_path) به مسیر سیستم (sys.path)، هنگامی به کار می‌رود که گزینه‌ی full-- داده شود" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: ext/apidoc.py:538 -msgid "project name (default: root module name)" -msgstr "نام پروژه (پیش‌گزیده: نام پیمانه‌ی ریشه)" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: ext/apidoc.py:545 -msgid "project author(s), used when --full is given" -msgstr "نویسنده(های) پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: ext/apidoc.py:552 -msgid "project version, used when --full is given" -msgstr "نسخه‌ی پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: ext/apidoc.py:559 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "نگارش پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود، پیش‌گزیده همان شماره‌ی نسخه (--doc-version) است" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "ارجاعات پانویس ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" -#: ext/apidoc.py:564 -msgid "extension options" -msgstr "گزینه های افزونه" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "ارجاعات ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" + +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "ارجاعات نقل قول ادبی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" + +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "ارجاعات اصطلاحی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" + +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" -#: ext/apidoc.py:638 +#: transforms/__init__.py:258 #, python-format -msgid "%s is not a directory." -msgstr "%s شاخه نیست." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "نمایه‌ای بر پایه‌ی ۴ ستون پیدا شد. شاید یک اشکال برنامه‌نویسی از افزونه‌هایی که استفاده می‌کنید باشد: %r" -#: ext/apidoc.py:710 ext/autosummary/generate.py:875 +#: transforms/__init__.py:299 #, python-format -msgid "Failed to remove %s: %s" +msgid "Footnote [%s] is not referenced." +msgstr "پانویس [%s] ارجاع داده نشده است." + +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: ext/autosectionlabel.py:48 +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "پانویس [#] ارجاع داده نشده است." + +#: util/inventory.py:147 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: domains/std/__init__.py:703 domains/std/__init__.py:812 -#: ext/autosectionlabel.py:52 +#: util/inventory.py:166 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "بر چسب تکراری %s، مورد دیگر در %s قرار دارد" - -#: ext/duration.py:85 -msgid "" -"====================== slowest reading durations =======================" -msgstr "====================== کند ترین زمان خواندن =======================" +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: ext/imgmath.py:159 +#: util/i18n.py:100 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "فرمان لتکس %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_latex را بررسی کنید" +msgid "reading error: %s, %s" +msgstr "خطای خواندن: %s, %s" -#: ext/imgmath.py:174 +#: util/i18n.py:113 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%sفرمان %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_%s را بررسی کنید" +msgid "writing error: %s, %s" +msgstr "خطای نوشتن: %s, %s" -#: ext/imgmath.py:328 +#: util/i18n.py:146 #, python-format -msgid "display latex %r: %s" -msgstr "نمایش لتکس: %r: %s" +msgid "locale_dir %s does not exist" +msgstr "" -#: ext/imgmath.py:362 +#: util/i18n.py:244 #, python-format -msgid "inline latex %r: %s" -msgstr "لتکس بین سطری: %r: %s" +msgid "Invalid Babel locale: %r." +msgstr "" -#: writers/latex.py:1090 writers/manpage.py:263 writers/texinfo.py:662 -msgid "Footnotes" -msgstr "پانویس ها" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "قالب تاریخ ناشناخته. اگر می‌خواهید از رشته‌متن مستقیماً خروجی بگیرید، آن را با نقل قول رشته‌متنی محصور کنید: %s" -#: writers/manpage.py:309 writers/text.py:936 +#: util/osutil.py:131 #, python-format -msgid "[image: %s]" -msgstr "[تصویر%s]" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "" -#: writers/manpage.py:310 writers/text.py:937 -msgid "[image]" -msgstr "[تصویر]" +#: util/display.py:82 +msgid "skipped" +msgstr "رد شدن و نادیده انگاشتن" -#: writers/html5.py:99 writers/html5.py:108 -msgid "Link to this definition" +#: util/display.py:87 +msgid "failed" +msgstr "شکست خورد" + +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: writers/html5.py:415 +#: util/docutils.py:361 #, python-format -msgid "numfig_format is not defined for %s" -msgstr "قالب عدد شکل برای %s تعریف نشده" +msgid "unknown role name: %s" +msgstr "" -#: writers/html5.py:427 +#: util/docutils.py:805 #, python-format -msgid "Any IDs not assigned for %s node" -msgstr "هر کدام از شناسه‌هایی که به بست %s اختصاص داده نشده" +msgid "unknown node type: %r" +msgstr "بست از نوع ناشناخته: %r" -#: writers/html5.py:482 -msgid "Link to this term" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: writers/html5.py:525 writers/html5.py:530 -msgid "Link to this heading" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: writers/html5.py:535 -msgid "Link to this table" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: writers/html5.py:549 writers/latex.py:1099 +#: util/rst.py:73 #, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" +msgid "default role %s not found" +msgstr "نقش پیش‌فرض %s یافت نشد" -#: writers/html5.py:613 -msgid "Link to this code" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: writers/html5.py:615 -msgid "Link to this image" -msgstr "" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "درختواره‌ی فهرست مطالب شامل ارجاع به پرونده ناموجود %r است" -#: writers/html5.py:617 -msgid "Link to this toctree" -msgstr "" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "ایراد در هنگام ارزیابی تنها عبارت دستور العمل: %s" -#: writers/html5.py:758 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "امکان دست یابی به اندازه‌ی عکس نبود. گزینه‌ی تغییر اندازه :scale: نادیده گرفته می‌شود." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "ادامه از صفحه‌ی قبل" -#: builders/latex/__init__.py:205 domains/std/__init__.py:646 -#: domains/std/__init__.py:658 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:513 -msgid "Index" -msgstr "فهرست" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "ادامه در صفحه‌ی بعد" -#: writers/latex.py:743 writers/texinfo.py:644 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "به بست عنوانی برخورد که در قسمت، موضوع، جدول، اندرز یا نوارکناری نبود" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "غیر الفبایی" -#: writers/texinfo.py:1216 -msgid "caption not inside a figure." -msgstr "عنوان درون شکل نیست." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "نماد ها" -#: writers/texinfo.py:1302 -#, python-format -msgid "unimplemented node type: %r" -msgstr "بست به کار نرفته: %r" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "شماره ها" -#: writers/latex.py:360 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "قسمت‌بندی رده‌بالای %r ناشناخته برای کلاس %r" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "صفحه" -#: builders/latex/__init__.py:223 writers/latex.py:410 -#, python-format -msgid "no Babel option known for language %r" -msgstr "بدون گزینه‌ی Babel شناخته شده برای زبان %r" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "انتشار" -#: writers/latex.py:428 -msgid "too large :maxdepth:, ignored." -msgstr "مقدار بسیار بزرگ :maxdepth:، نادیده گرفته شد." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "امکان دریافت تصویر از منبع راه دور نبود: %s [%s]" -#: writers/latex.py:590 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" +msgid "Could not fetch remote image: %s [%d]" +msgstr "امکان دریافت تصویر از منبع راه دور نبود: %s [%d]" -#: writers/latex.py:708 -msgid "document title is not a single Text node" -msgstr "عنوان سند یک بست متنی نیست" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "قالب تصویر ناشناخته: %s..." -#: writers/latex.py:1175 +#: transforms/post_transforms/__init__.py:88 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "هر دو مقدار tabularcolumns و :widths: داده شده، بنابراین :widths: حذف می شود." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "امکان تشخیص متن جایگزین برای ارجاع متقابل نبود. شاید یک اشکال برنامه نویسی باشد." -#: writers/latex.py:1573 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "ابعاد واحد %sنامعتبر است و نادیده گرفته شد." +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "برای «هر» ارجاع متقابل بیشتر از یک هفد پیدا شد: %r شاید %s باشد" -#: writers/latex.py:1931 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "unknown index entry type %s found" -msgstr "نوع ناشناخته مدخل نمایه%s پیدا شد" +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s مرجع هدف پیدا نشد: %s" -#: domains/std/__init__.py:87 domains/std/__init__.py:104 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "environment variable; %s" -msgstr "متغیرهای عمومی؛ %s" +msgid "%r reference target not found: %s" +msgstr "مقصد ارجاع %r پیدا نشد %s" -#: domains/std/__init__.py:112 -#, python-format -msgid "%s; configuration value" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "قطع شد!" + +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: domains/std/__init__.py:166 -msgid "Type" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: domains/std/__init__.py:176 -msgid "Default" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: domains/std/__init__.py:235 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "توضیح بدشکل برای گزینه‌ی %r، باید شبیه این‌ها باشد \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" یا \"+opt args\"" - -#: domains/std/__init__.py:306 -#, python-format -msgid "%s command line option" -msgstr "%s گزینه‌ی خط فرمان" - -#: domains/std/__init__.py:308 -msgid "command line option" -msgstr "گزینه خط فرمان" - -#: domains/std/__init__.py:430 -msgid "glossary term must be preceded by empty line" -msgstr "یک خط خالی باید پیش از اصطلاح واژه‌نامه باشد" - -#: domains/std/__init__.py:438 -msgid "glossary terms must not be separated by empty lines" -msgstr "اصطلاحات واژه‌نامه نباید با خطوط خالی از هم جدا شوند" - -#: domains/std/__init__.py:444 domains/std/__init__.py:457 -msgid "glossary seems to be misformatted, check indentation" -msgstr "به نظر می رسد واژه‌نامه اشتباه شکل داده شده است، فاصله‌گذاری از ابتدای سطر را بررسی کنید" - -#: domains/std/__init__.py:602 -msgid "glossary term" -msgstr "اصطلاح واژه‌نامه" - -#: domains/std/__init__.py:603 -msgid "grammar token" -msgstr "نشانه ی گرامری" - -#: domains/std/__init__.py:604 -msgid "reference label" -msgstr "برچسب ارجاع" - -#: domains/std/__init__.py:607 -msgid "environment variable" -msgstr "متغیّر عمومی" - -#: domains/std/__init__.py:608 -msgid "program option" -msgstr "اختیارات برنامه" - -#: domains/std/__init__.py:609 -msgid "document" -msgstr "سند" - -#: domains/std/__init__.py:647 domains/std/__init__.py:659 -msgid "Module Index" -msgstr "فهرست ماژول ها" - -#: domains/std/__init__.py:648 domains/std/__init__.py:660 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "صفحه جستجو" - -#: domains/std/__init__.py:722 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "تکرار توضیح %s از %s، مورد دیگر در%s قرار دارد" - -#: domains/std/__init__.py:932 -msgid "numfig is disabled. :numref: is ignored." -msgstr "شماره‌ی شکل غیر فعّال است. گزینه‌ی :numref: نادیده گرفته می‌شود." - -#: domains/std/__init__.py:940 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "شکست در ایجاد ارجاع متقابل. هیچ شماره انتساب داده نشده: %s" - -#: domains/std/__init__.py:952 -#, python-format -msgid "the link has no caption: %s" -msgstr "پیوند هیچ برچسبی ندارد: %s" - -#: domains/std/__init__.py:966 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "قالب شماره‌ی شکل نامعتبر: %s (%r)" - -#: domains/std/__init__.py:969 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "قالب شماره‌ی شکل نامعتبر: %s" - -#: domains/std/__init__.py:1200 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1202 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: domains/python/__init__.py:107 domains/python/__init__.py:244 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (در ماژول %s)" - -#: domains/python/__init__.py:167 domains/python/__init__.py:334 -#: domains/python/__init__.py:385 domains/python/__init__.py:424 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (در ماژول %s)" - -#: domains/python/__init__.py:169 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (متغیر درونی)" - -#: domains/python/__init__.py:194 -#, python-format -msgid "%s (built-in class)" -msgstr "%s (کلاس درونی)" - -#: domains/python/__init__.py:195 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (کلاس در %s)" - -#: domains/python/__init__.py:249 -#, python-format -msgid "%s() (%s class method)" -msgstr "%s() (%s شگرد کلاس)" - -#: domains/python/__init__.py:251 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (%s متد استاتیک)" - -#: domains/python/__init__.py:389 -#, python-format -msgid "%s (%s property)" -msgstr "%s(%sویژگی)" - -#: domains/python/__init__.py:428 -#, python-format -msgid "%s (type alias in %s)" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: domains/python/__init__.py:559 -msgid "Python Module Index" -msgstr "نمایه ی ماژول های پایتون" - -#: domains/python/__init__.py:560 -msgid "modules" -msgstr "ماژول ها" - -#: domains/python/__init__.py:637 -msgid "Deprecated" -msgstr "منسوخ شده" - -#: domains/python/__init__.py:663 -msgid "exception" -msgstr "ایراد" - -#: domains/python/__init__.py:665 -msgid "class method" -msgstr "class method" - -#: domains/python/__init__.py:666 -msgid "static method" -msgstr "متد استاتیک" - -#: domains/python/__init__.py:668 -msgid "property" -msgstr "ویژگی" - -#: domains/python/__init__.py:669 -msgid "type alias" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: domains/python/__init__.py:729 -#, python-format -msgid "" -"duplicate object description of %s, other instance in %s, use :no-index: for" -" one of them" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: domains/python/__init__.py:858 -#, python-format -msgid "more than one target found for cross-reference %r: %s" -msgstr "برای ارجاع متقابل %r بیش از یک هدف پیدا شد: %s" - -#: domains/python/__init__.py:920 -msgid " (deprecated)" -msgstr " (منسوخ)" - -#: domains/c/__init__.py:304 domains/cpp/__init__.py:441 -#: domains/python/_object.py:164 ext/napoleon/docstring.py:786 -msgid "Parameters" -msgstr "پارامترها" - -#: domains/python/_object.py:169 -msgid "Variables" -msgstr "متغیر ها" - -#: domains/python/_object.py:173 -msgid "Raises" -msgstr "برانگیختن" - -#: domains/c/__init__.py:199 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:260 domains/c/_symbol.py:510 -#, python-format +#: _cli/util/errors.py:240 msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." -msgstr "اعلان C تکراری، که در %s:%s هم تعریف شده.\nاعلان '.. c:%s:: %s' است." - -#: domains/c/__init__.py:307 domains/cpp/__init__.py:454 -msgid "Return values" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: domains/c/__init__.py:679 domains/cpp/__init__.py:860 -msgid "member" -msgstr "عضو" - -#: domains/c/__init__.py:680 -msgid "variable" -msgstr "متغیّر" - -#: domains/c/__init__.py:682 -msgid "macro" -msgstr "ماکرو" - -#: domains/c/__init__.py:683 -msgid "struct" -msgstr "ساختار" - -#: domains/c/__init__.py:684 domains/cpp/__init__.py:858 -msgid "union" -msgstr "اجتماع" - -#: domains/c/__init__.py:685 domains/cpp/__init__.py:863 -msgid "enum" -msgstr "شمارش" - -#: domains/c/__init__.py:686 domains/cpp/__init__.py:864 -msgid "enumerator" -msgstr "شمارنده" - -#: domains/c/__init__.py:687 domains/cpp/__init__.py:861 -msgid "type" -msgstr "گونه" - -#: domains/c/__init__.py:689 domains/cpp/__init__.py:866 -msgid "function parameter" -msgstr "مؤلّفه‌ی تابع" - -#: domains/cpp/__init__.py:155 -msgid "Template Parameters" -msgstr "پارامترهای قالب" - -#: domains/cpp/__init__.py:277 -#, python-format -msgid "%s (C++ %s)" -msgstr "%s (C++ %s)" - -#: domains/cpp/__init__.py:360 domains/cpp/_symbol.py:793 -#, python-format +#: _cli/util/errors.py:246 msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "اعلان ++C تکراری، که در %s:%s هم تعریف شده.\nاعلان '.. cpp:%s:: %s' است." - -#: domains/cpp/__init__.py:862 -msgid "concept" -msgstr "کانسپت" - -#: domains/cpp/__init__.py:867 -msgid "template parameter" -msgstr "مؤلّفه‌ی قالب" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "محتوا ها" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "فهرست عناوین" - -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "جستجو" - -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "برو" - -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "نمایش سورس" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "لطفاً اگر این مورد خطای کاربر بوده، آن را گزارش دهید تا برای بارهای بعدی پیام خطای بهتری بتواند ارائه شود." #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" @@ -3097,6 +2770,11 @@ msgstr "جستجو در %(docstitle)s" msgid "About these documents" msgstr "درباره این مستندات" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "جستجو" + #: themes/basic/layout.html:133 themes/basic/layout.html:177 #: themes/basic/layout.html:179 msgid "Copyright" @@ -3119,33 +2797,49 @@ msgid "" "%(sphinx_version)s." msgstr "ایجاد شده باSphinx %(sphinx_version)s." -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "موضوع قبلی" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "فهرست کامل در یک صفحه" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "فصل قبلی" -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "فهرست صفحات بر اساس حروف" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "موضوع بعدی" -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "ممکن است سترگ باشد" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "فصل بعدی" -#: themes/basic/opensearch.xml:4 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "Search %(docstitle)s" -msgstr "جستجو %(docstitle)s" +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "فهرست کامل در یک صفحه" #: themes/basic/sourcelink.html:4 msgid "This Page" msgstr "صفحه فعلی" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "نمایش سورس" + +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "جستجو سریع" + +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "برو" + #: themes/basic/defindex.html:4 msgid "Overview" msgstr "بررسی اجمالی" @@ -3174,6 +2868,11 @@ msgstr "فهرست کامل مطالب" msgid "lists all sections and subsections" msgstr "فهرست تمامی بخش ها و زیر مجموعه ها" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "صفحه جستجو" + #: themes/basic/defindex.html:19 msgid "search this documentation" msgstr "جستجو در این اسناد" @@ -3186,7 +2885,7 @@ msgstr "فهرست کلی ماژول ها" msgid "quick access to all modules" msgstr "دسترسی سریع به تمامی متدها" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "فهرست کلی" @@ -3194,9 +2893,23 @@ msgstr "فهرست کلی" msgid "all functions, classes, terms" msgstr "تمامی توابع ، کلاس ها ، اصطلاحات" -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "جستجو سریع" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "فهرست عناوین" + +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "جستجو %(docstitle)s" + +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "فهرست صفحات بر اساس حروف" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "ممکن است سترگ باشد" #: themes/basic/search.html:20 msgid "" @@ -3214,25 +2927,43 @@ msgstr "در حال جستجو برای چندین واژه. فقط واژگان msgid "search" msgstr "جستجو" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "موضوع قبلی" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "محتوا ها" -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "فصل قبلی" +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "نتایج جستجو" -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "موضوع بعدی" +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." +msgstr "جستجوی شما با هیچ سندی هم خوانی نداشت. لطفاً اطمینان حاصل کنید که همه ی واژه ها املای درستی دارند و دسته بندی های کافی را انتخاب کرده اید." -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "فصل بعدی" +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" -msgstr "گسترش نوار کناره" +#: themes/basic/static/searchtools.js:276 +msgid "Searching" +msgstr "در حال جست و جو" + +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "آماده سازی جست و جو..." + +#: themes/basic/static/searchtools.js:526 +msgid ", in " +msgstr "، در " + +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "عدم نمایش نتایج یافت شده" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -3240,6 +2971,11 @@ msgstr "گسترش نوار کناره" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "تغییرات در نسخه %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -3257,861 +2993,1316 @@ msgstr "C API تغییرات" msgid "Other changes" msgstr "دگر تغییرات" -#: themes/basic/changes/rstsource.html:5 +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" +msgstr "گسترش نوار کناره" + +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" +msgstr "" + +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "پارامترها" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "متغیر ها" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "برانگیختن" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +msgid "%s() (in module %s)" +msgstr "%s() (در ماژول %s)" + +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 +#, python-format +msgid "%s (in module %s)" +msgstr "%s (در ماژول %s)" + +#: domains/python/__init__.py:174 +#, python-format +msgid "%s (built-in variable)" +msgstr "%s (متغیر درونی)" + +#: domains/python/__init__.py:209 +#, python-format +msgid "%s (built-in class)" +msgstr "%s (کلاس درونی)" + +#: domains/python/__init__.py:210 +#, python-format +msgid "%s (class in %s)" +msgstr "%s (کلاس در %s)" + +#: domains/python/__init__.py:275 +#, python-format +msgid "%s() (%s class method)" +msgstr "%s() (%s شگرد کلاس)" + +#: domains/python/__init__.py:277 +#, python-format +msgid "%s() (%s static method)" +msgstr "%s() (%s متد استاتیک)" + +#: domains/python/__init__.py:430 +#, python-format +msgid "%s (%s property)" +msgstr "%s(%sویژگی)" + +#: domains/python/__init__.py:470 +#, python-format +msgid "%s (type alias in %s)" +msgstr "" + +#: domains/python/__init__.py:624 +msgid "Python Module Index" +msgstr "نمایه ی ماژول های پایتون" + +#: domains/python/__init__.py:625 +msgid "modules" +msgstr "ماژول ها" + +#: domains/python/__init__.py:703 +msgid "Deprecated" +msgstr "منسوخ شده" + +#: domains/python/__init__.py:729 +msgid "exception" +msgstr "ایراد" + +#: domains/python/__init__.py:731 +msgid "class method" +msgstr "class method" + +#: domains/python/__init__.py:732 +msgid "static method" +msgstr "متد استاتیک" + +#: domains/python/__init__.py:734 +msgid "property" +msgstr "ویژگی" + +#: domains/python/__init__.py:735 +msgid "type alias" +msgstr "" + +#: domains/python/__init__.py:804 +#, python-format +msgid "" +"duplicate object description of %s, other instance in %s, use :no-index: for" +" one of them" +msgstr "" + +#: domains/python/__init__.py:974 +#, python-format +msgid "more than one target found for cross-reference %r: %s" +msgstr "برای ارجاع متقابل %r بیش از یک هدف پیدا شد: %s" + +#: domains/python/__init__.py:1048 +msgid " (deprecated)" +msgstr " (منسوخ)" + +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "اعلان ++C تکراری، که در %s:%s هم تعریف شده.\nاعلان '.. cpp:%s:: %s' است." + +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" +msgstr "پارامترهای قالب" + +#: domains/cpp/__init__.py:302 +#, python-format +msgid "%s (C++ %s)" +msgstr "%s (C++ %s)" + +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 +msgid "Return values" +msgstr "" + +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "اجتماع" + +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" +msgstr "عضو" + +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "گونه" + +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "کانسپت" + +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 +msgid "enum" +msgstr "شمارش" + +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 +msgid "enumerator" +msgstr "شمارنده" + +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 +msgid "function parameter" +msgstr "مؤلّفه‌ی تابع" + +#: domains/cpp/__init__.py:954 +msgid "template parameter" +msgstr "مؤلّفه‌ی قالب" + +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 +#, python-format +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." +msgstr "اعلان C تکراری، که در %s:%s هم تعریف شده.\nاعلان '.. c:%s:: %s' است." + +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "متغیّر" + +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "ماکرو" + +#: domains/c/__init__.py:781 +msgid "struct" +msgstr "ساختار" + +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" +msgstr "متغیرهای عمومی؛ %s" + +#: domains/std/__init__.py:116 +#, python-format +msgid "%s; configuration value" +msgstr "" + +#: domains/std/__init__.py:172 +msgid "Type" +msgstr "" + +#: domains/std/__init__.py:182 +msgid "Default" +msgstr "" + +#: domains/std/__init__.py:239 +#, python-format +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" +msgstr "توضیح بدشکل برای گزینه‌ی %r، باید شبیه این‌ها باشد \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" یا \"+opt args\"" + +#: domains/std/__init__.py:319 +#, python-format +msgid "%s command line option" +msgstr "%s گزینه‌ی خط فرمان" + +#: domains/std/__init__.py:321 +msgid "command line option" +msgstr "گزینه خط فرمان" + +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" +msgstr "یک خط خالی باید پیش از اصطلاح واژه‌نامه باشد" + +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" +msgstr "اصطلاحات واژه‌نامه نباید با خطوط خالی از هم جدا شوند" + +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "به نظر می رسد واژه‌نامه اشتباه شکل داده شده است، فاصله‌گذاری از ابتدای سطر را بررسی کنید" + +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "اصطلاح واژه‌نامه" + +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "نشانه ی گرامری" + +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "برچسب ارجاع" + +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "متغیّر عمومی" + +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "اختیارات برنامه" + +#: domains/std/__init__.py:735 +msgid "document" +msgstr "سند" + +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "فهرست ماژول ها" + +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" +msgstr "تکرار توضیح %s از %s، مورد دیگر در%s قرار دارد" + +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "شماره‌ی شکل غیر فعّال است. گزینه‌ی :numref: نادیده گرفته می‌شود." + +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" +msgstr "شکست در ایجاد ارجاع متقابل. هیچ شماره انتساب داده نشده: %s" + +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" +msgstr "پیوند هیچ برچسبی ندارد: %s" + +#: domains/std/__init__.py:1153 +#, python-format +msgid "invalid numfig_format: %s (%r)" +msgstr "قالب شماره‌ی شکل نامعتبر: %s (%r)" + +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" +msgstr "قالب شماره‌ی شکل نامعتبر: %s" + +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" +msgstr "" + +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "" + +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" +msgstr "مقدار نامعتبر تعیین شده (بدون کمانک انتهایی): %s" + +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" +msgstr "مقدار نامعتبر تعیین شده (بدون کمانک ابتدایی): %s" + +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" +msgstr "رشته‌متن ادبی ناقص (بدون علامت نقل‌قول انتهایی): %s" + +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" +msgstr "رشته‌متن ادبی ناقص (بدون علامت نقل‌قول ابتدایی): %s" + +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "مثال" + +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "نمونه‎ها" + +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "نشانوندهای کلیدی" + +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "یادداشت‌ها" + +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "مؤلّفه‌های دیگر" + +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "دریافت‌ها" + +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "منابع" + +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "هشدارها" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "فرآورده" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" +msgstr "شیئ ساختگی شناسایی شد: %r" + +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 +#, python-format +msgid "alias of %s" +msgstr "نام جانشین %s" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" +msgstr "پایه ها:%s" + +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" +msgstr "مقدار نامعتبر برای گزینه‌ی ترتیب اعضا (member-order): %s" + +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "مقدار نامعتبر برای گزینه‌ی «از مستندات کلاس» class-doc-from:%s" + +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" +msgstr "امضای ناشناخته‌ برای %s (%r)" + +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "مشخّص نیست کدام پیمانه را برای مستندسازی خودکار فراخوان کند %r (سعی کنید دستورالعمل «module» یا «currentmodule» را در سند قرار دهید، یا یک نام واضح برای پیمانه ارائه دهید)" + +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" +msgstr "" + +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "\"::\" در پیمانه‌ی خودکار معنی نمی‌دهد" + +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" +msgstr "" + +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "پرونده‌ی %s را می سازد." + +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nبه صورت بازگشتی در مسیر دنبال پیمانه‌هاو بسته‌های پایتون بگرد و \nبا به ازای دستورالمعل‌های خودکار پیمانه‌ی هر بسته در مسیر خروجی یک پرونده‌ی reST بساز.\n\nالگوی استثتاء های می‌تواند الگوی پرونده‌ها و یا شاخه‌هایی باشد که از تولید کنار گذاشته شده‌اند.\n\nتوجّه: به صورت پیش فرض این اسکریپت روی پرونده‌های از پیش ساخته شده دوباره نویسی نمی‌کند." + +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "مسیر پیمانه به سند" + +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "الگوها‌ی به سبک fnmatch در پرونده و یا شاخه برای کنار گذاشتن از تولید" + +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "پوشه‌ای برای قرار دادن همه‌ی برون دادها" + +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "نهایت عمق زیر پیمانه‌ها برای نشان دادن در فهرست مطالب (پیش‌گزیده: ۴)" + +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "بازنویسی پرونده‌های موجود" + +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "ردگیری پیوند نمادین. وقتی با collective.recipe.omelette ترکیب می‌شود توانمند است." + +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "اجرای اسکریپت بدون ساخت پرونده" + +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "قرار دادن مستندات هر پیمانه در صفحه‌ی خودش" + +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "در برداشتن پیمانه‌های «خصوصی»(_private)" + +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "نام پرونده فهرست مطالب (پیش‌گزیده: پیمانه‌ها)" + +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "پرونده‌ی فهرست مطالب را ایجاد نکن" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "عدم نمایش نتایج یافت شده" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "برای بسته‌ها و پیمانه‌ها سربرگ نساز (مثلاً وقتی رشته‌متن‌های مستندات از قبل آن‌ها را داشته باشند)" -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" -msgstr "نتایج جستجو" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "قرار دادن مستندات پیمانه پیش از مستندات پیمانه‌ی زیرمجموعه‌‌اش" -#: themes/basic/static/searchtools.js:119 +#: ext/apidoc/_cli.py:152 msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." -msgstr "جستجوی شما با هیچ سندی هم خوانی نداشت. لطفاً اطمینان حاصل کنید که همه ی واژه ها املای درستی دارند و دسته بندی های کافی را انتخاب کرده اید." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "تفسیر مسیرهای پیمانه بر اساس ویژگی‌های ضمنی فضای نام‌ها در PEP -0420" -#: themes/basic/static/searchtools.js:123 -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: themes/basic/static/searchtools.js:253 -msgid "Searching" -msgstr "در حال جست و جو" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "پسوند پرونده ( پیش فرض: rst)" -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." -msgstr "آماده سازی جست و جو..." +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" -#: themes/basic/static/searchtools.js:474 -msgid ", in " -msgstr "، در " +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "تولید یک پروژه‌ی کامل با ابزار شروع سریع اسفینکس" -#: environment/collectors/asset.py:96 -#, python-format -msgid "image file not readable: %s" -msgstr "پرونده‌ی تصویر خوانا نیست: %s" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "پیوست مسیر پیمانه (module_path) به مسیر سیستم (sys.path)، هنگامی به کار می‌رود که گزینه‌ی full-- داده شود" -#: environment/collectors/asset.py:124 -#, python-format -msgid "image file %s not readable: %s" -msgstr "پرونده‌ی عکس %s خوانا نیست: %s" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "نام پروژه (پیش‌گزیده: نام پیمانه‌ی ریشه)" -#: environment/collectors/asset.py:161 -#, python-format -msgid "download file not readable: %s" -msgstr "پرونده‌ی دریافت شده خوانا نیست: %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "نویسنده(های) پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود" -#: environment/collectors/toctree.py:258 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "شماره‌ی قسمت‌ها پیش‌تر به %s نسبت داده شده ( آیا درختواره‌ی فهرست مطالب شماره‌گذاری تو در تو دارد؟)" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "نسخه‌ی پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود" -#: environment/adapters/toctree.py:318 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "دور تسلسل در درختواره‌ی ارجاعات فهرست مطالب تشخیص داده شده، نادیده گرفته می‌شوند: %s <- %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "نگارش پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود، پیش‌گزیده همان شماره‌ی نسخه (--doc-version) است" -#: environment/adapters/toctree.py:342 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "فهرست مطالب دارای ارجاع به سند %r است که عنوانی ندارد: هیچ پیوندی تولید نخواهد شد" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "گزینه های افزونه" -#: environment/adapters/toctree.py:357 -#, python-format -msgid "toctree contains reference to non-included document %r" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: environment/adapters/indexentries.py:126 -#, python-format -msgid "see %s" -msgstr "%s را ببینید" - -#: environment/adapters/indexentries.py:136 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "see also %s" -msgstr "%s را هم ببینید" +msgid "enable %s extension, used when --full is given" +msgstr "" -#: environment/adapters/indexentries.py:144 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "unknown index entry type %r" -msgstr "نوع ناشناخته مدخل نمایه %r" - -#: environment/adapters/indexentries.py:270 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "نماد ها" +msgid "%s is not a directory." +msgstr "%s شاخه نیست." -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:113 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "صفحات HTML در %(outdir)s است." +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "" -#: builders/html/__init__.py:348 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to read build info file: %r" -msgstr "شکست در خواندن پرونده‌ی اطّلاعات ساخت: %r" - -#: builders/html/__init__.py:363 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/apidoc/_extension.py:133 +#, python-format +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/__init__.py:382 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "فهرست" - -#: builders/html/__init__.py:560 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "Logo of %s" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "بعدی" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "قبلی" - -#: builders/html/__init__.py:695 -msgid "generating indices" -msgstr "تولید نمایه‌ها" - -#: builders/html/__init__.py:710 -msgid "writing additional pages" -msgstr "نوشتن صفحات اضافی" - -#: builders/html/__init__.py:793 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/html/__init__.py:805 -msgid "copying downloadable files... " -msgstr "رونوشت از پرونده‌های قابل دریافت... " +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" -#: builders/html/__init__.py:817 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "نمی تواند از پرونده‌ی قابل دریافت %r: %s رونوشت بگیرد" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: builders/html/__init__.py:863 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/html/__init__.py:881 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "شکست در رونوشت یک پرونده‌ی به html_static_file: %s: %r" +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "" -#: builders/html/__init__.py:916 -msgid "copying static files" -msgstr "رونوشت از پرونده‌های ثابت" +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "" -#: builders/html/__init__.py:933 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "cannot copy static file %r" -msgstr "نمی تواند از پرونده‌ی ثابت %r رونوشت بگیرد" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "خلاصه‌ی خودکار: شکست در تشخیص %r برای مستندسازی، این ایراد به وجود آمد:\n%s" -#: builders/html/__init__.py:938 -msgid "copying extra files" -msgstr "رونوشت برداری از پرونده‌های اضافی" +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" +msgstr "[خلاصه‌ی خودکار] تولید خلاصه‌ی خودکار برای: %s" -#: builders/html/__init__.py:948 +#: ext/autosummary/generate.py:634 #, python-format -msgid "cannot copy extra file %r" -msgstr "نمی تواند از پرونده‌ی اضافه‌ی %r رونوشت بگیرد" +msgid "[autosummary] writing to %s" +msgstr "[خلاصه‌ی خودکار] نوشتن در %s" -#: builders/html/__init__.py:954 +#: ext/autosummary/generate.py:679 #, python-format -msgid "Failed to write build info file: %r" -msgstr "شکست در نوشتن پرونده‌ی اطّلاعات ساخت: %r" +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" -#: builders/html/__init__.py:1003 +#: ext/autosummary/generate.py:877 msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "نمایه‌ی جستجو نمی‌تواند بارگزاری شود، ولی برای همه‌ی مستندات ساخته‌ نمی‌شود: نمایه‌ ناقص خواهد بود." +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nتولید ReStructuredText با استفاده از دستورالعمل‌های خلاصه‌ی خودکار.\n\nخودکارساز اسفینکس رابط کابر پسندی برای sphinx.ext.autosummary.generate (پیمانه‌ی افزونه‌ی خلاصه‌ساز اسفنیکس) است.\nاین افزونه پرونده های متن reStructuredText را از دستورالعمل‌های خلاصه‌ی خودکاری تولید می‌کند که در پرونده‌های درون‌داد مشخّص شده قرار دارد.\n\nقالب دستورالعمل خلاصه‌ی خودکار درپیمانه‌ی افزونه‌ی خلاصه‌ی خودکار اسفنیکس (sphinx.ext.autosummary) مستند سازی شده می توان آن را با دستور زیر خواند::\n\n pydoc sphinx.ext.autosummary\n" -#: builders/html/__init__.py:1051 +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "پرونده‌های منبع برای تولید پرونده‌های rST" + +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "پوشه‌ای برای قرار دادن همه‌ی برون دادها در آن" + +#: ext/autosummary/generate.py:915 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "صفحه‌ی %s با دو الگو در نوار کناری صفحه (html_sidebars) هم‌خوانی دارد: %r و%r" +msgid "default suffix for files (default: %(default)s)" +msgstr "پسوند پیش فرض برای پرونده‌ها (پیش‌فرض: %(default)s)" -#: builders/html/__init__.py:1213 +#: ext/autosummary/generate.py:923 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "هنگام ارائه‌ی صفحه‌ی %s خطای یونیکد رخ داد. لطفاً اطمینان حاصل کنید که تمام مقدارهای پیکربندی‌ها دارای محتوای غیر اَسکی، رشته‌متن‌های یونکد هستند." +msgid "custom template directory (default: %(default)s)" +msgstr "شاخه‌ی سفارشی قالب (پیش‌گزیده: %(default)s)" -#: builders/html/__init__.py:1222 +#: ext/autosummary/generate.py:931 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "خطایی در نمایش صفحه‌ی %s رخ داد.\nعلّت: %r" +msgid "document imported members (default: %(default)s)" +msgstr "اجزای فراخوان شده‌ی سند (پیش‌گزیده: %(default)s)" -#: builders/html/__init__.py:1255 -msgid "dumping object inventory" -msgstr "خالی کردن فهرست اشیاء" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "" -#: builders/html/__init__.py:1263 +#: ext/autosummary/__init__.py:235 #, python-format -msgid "dumping search index in %s" -msgstr "خالی کردن نمایه‌ی جستجو در %s" +msgid "autosummary references excluded document %r. Ignored." +msgstr "ارجاعات خلاصه‌ی خودکار سند %r حذف کنار گذاشته. نادیده گرفته می‌شود." -#: builders/html/__init__.py:1306 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "invalid js_file: %r, ignored" -msgstr "پرونده‌ی js نامعتبر%r: نادیده گرفته می‌شود" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." +msgstr "خلاصه‌ی خودکار: خرده‌پرونده‌ی %r پیدا نشد. تنظیمات تولید خلاصه‌ی خودکار(autosummary_generate) را بررسی کنید." -#: builders/html/__init__.py:1339 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "ارا‌ئه کننده‌های ریاضی زیادی ثبت شده‌اند، ولی هیچ کدام انتخاب نشده." +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "خلاصه‌ی خودکار عنوان‌ٔار نیازمند گزینه‌ی :toctree: است، نادیده گرفته می‌شود." -#: builders/html/__init__.py:1344 +#: ext/autosummary/__init__.py:329 #, python-format -msgid "Unknown math_renderer %r is given." -msgstr "نمایش‌دهنده‌ی ریاضی نامشخّص %r داده شده." +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" -#: builders/html/__init__.py:1358 +#: ext/autosummary/__init__.py:358 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "مدخل مسیر اضافی (html_extra_path) %r درون شاخه‌ی خارجی قرار دارد" +msgid "failed to import object %s" +msgstr "شکست در وارد کردن شیئ %s" -#: builders/html/__init__.py:1363 +#: ext/autosummary/__init__.py:652 #, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "مدخل مسیر اضافی (html_extra_path) %r وجود ندارد" +msgid "" +"Summarised items should not include the current module. Replace %r with %r." +msgstr "" -#: builders/html/__init__.py:1378 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "مدخل مسیر ثابت (html_static_path) %r درون شاخه‌ی خارجی قرار دارد" +msgid "autosummary_generate: file not found: %s" +msgstr "تولید خلاصه خودکار: پرونده پیدا نشد: %s" + +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." +msgstr "" -#: builders/html/__init__.py:1383 +#: ext/intersphinx/_load.py:61 #, python-format -msgid "html_static_path entry %r does not exist" -msgstr "مدخل مسیر ثابت (html_static_path) %r وجود ندارد" +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" -#: builders/html/__init__.py:1394 builders/latex/__init__.py:504 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "logo file %r does not exist" -msgstr "پرونده‌ی آرم %r وجود ندارد" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" -#: builders/html/__init__.py:1405 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "favicon file %r does not exist" -msgstr "پرونده‌ی آیکون مورد علاقه %r وجود ندارد" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" -#: builders/html/__init__.py:1417 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: builders/html/__init__.py:1430 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: builders/html/__init__.py:1447 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "%s %s documentation" -msgstr "مستندات %s%s" +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" -#: builders/latex/transforms.py:118 -msgid "Failed to get a docname!" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: builders/latex/transforms.py:119 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: builders/latex/transforms.py:485 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: builders/latex/__init__.py:117 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "پرونده‌ی LaTeX در پوشه‌ی %(outdir)s است." +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" -#: builders/latex/__init__.py:119 +#: ext/intersphinx/_load.py:324 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nدر آن شاخه فرمان 'make' را اجرا کنید تا این‌ها را با لتکس(pdf) اجرا کند\n(برای انجام خودکار `make latexpdf' را به کار ببرید)." - -#: builders/latex/__init__.py:157 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "هیچ مقدار پیکربندی اسناد لتکسی (latex_documents) پیدا نشد؛ بنابراین هیچ سندی نوشته نخواهد شد" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "مشکلاتی در برخی از سیاهه‌ها به وجود آمد،ولی این مشکلات راه‌های جایگزین های داشته‌اند:" -#: builders/latex/__init__.py:169 +#: ext/intersphinx/_load.py:332 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "مقدار پیکربندی سندهای لتکس (latex_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد" - -#: builders/latex/__init__.py:208 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "انتشار" - -#: builders/latex/__init__.py:429 -msgid "copying TeX support files" -msgstr "رونوشت از پرونده‌های پشتیبانی لتکس" - -#: builders/latex/__init__.py:466 -msgid "copying additional files" -msgstr "رونوشت برداری از پرونده‌های اضافی" +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: builders/latex/__init__.py:540 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "کلید پیکربندی ناشناخته: latex_elements[%r]، نادیده گرفته می‌شود." +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "سیاهه‌ی بین اسفینکس جا به جایی را انجام داد: %s -> %s" -#: builders/latex/__init__.py:548 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "کلید زمینه‌ی ناشناخته: latex_theme_options[%r]، نادیده گرفته می‌شود." +msgid "(in %s %s)" +msgstr "" -#: builders/latex/theming.py:87 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r فاقد تنظیمات زمینه است" +msgid "(in %s)" +msgstr "(در %s )" -#: builders/latex/theming.py:90 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r فاقد تنظیمات \"%s\" است" - -#: _cli/util/errors.py:124 -msgid "Exception occurred, starting debugger:" +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: _cli/util/errors.py:133 -msgid "reStructuredText markup error:" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: _cli/util/errors.py:168 -msgid "The full traceback has been saved in:" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: _cli/util/errors.py:172 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: transforms/post_transforms/__init__.py:125 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "امکان تشخیص متن جایگزین برای ارجاع متقابل نبود. شاید یک اشکال برنامه نویسی باشد." - -#: transforms/post_transforms/__init__.py:185 +#: ext/intersphinx/_resolve.py:407 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "برای «هر» ارجاع متقابل بیشتر از یک هفد پیدا شد: %r شاید %s باشد" +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: transforms/post_transforms/__init__.py:251 +#: ext/intersphinx/_resolve.py:561 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s مرجع هدف پیدا نشد: %s" +msgid "external %s:%s reference target not found: %s" +msgstr "" -#: transforms/post_transforms/__init__.py:257 +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 #, python-format -msgid "%r reference target not found: %s" -msgstr "مقصد ارجاع %r پیدا نشد %s" +msgid "error while formatting signature for %s: %s" +msgstr "خطا در قالب بندی امضا برای %s: %s" -#: transforms/post_transforms/images.py:77 +#: ext/autodoc/_dynamic/_loader.py:193 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "امکان دریافت تصویر از منبع راه دور نبود: %s [%s]" +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: transforms/post_transforms/images.py:94 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "امکان دریافت تصویر از منبع راه دور نبود: %s [%d]" +msgid "Failed to get a function signature for %s: %s" +msgstr "شکست در دریافت امضای تابع برای %s: مؤلّفه پیدا نشد: %s" -#: transforms/post_transforms/images.py:141 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "Unknown image format: %s..." -msgstr "قالب تصویر ناشناخته: %s..." - -#: ext/napoleon/docstring.py:707 -msgid "Example" -msgstr "مثال" - -#: ext/napoleon/docstring.py:708 -msgid "Examples" -msgstr "نمونه‎ها" - -#: ext/napoleon/__init__.py:344 ext/napoleon/docstring.py:752 -msgid "Keyword Arguments" -msgstr "نشانوندهای کلیدی" - -#: ext/napoleon/docstring.py:768 -msgid "Notes" -msgstr "یادداشت‌ها" - -#: ext/napoleon/docstring.py:777 -msgid "Other Parameters" -msgstr "مؤلّفه‌های دیگر" - -#: ext/napoleon/docstring.py:813 -msgid "Receives" -msgstr "دریافت‌ها" - -#: ext/napoleon/docstring.py:817 -msgid "References" -msgstr "منابع" +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "شکست در به روز رسانی امضا برای %r: مؤلّفه پیدا نشد: %s" -#: ext/napoleon/docstring.py:849 -msgid "Warns" -msgstr "هشدارها" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "شکست در تحلیل نوع یادداشت برای %r: %s" -#: ext/napoleon/docstring.py:853 -msgid "Yields" -msgstr "فرآورده" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "__slots__ نامعتبر در %sیدا شد و نادیده گرفته شد." -#: ext/napoleon/docstring.py:1015 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "مقدار نامعتبر تعیین شده (بدون کمانک انتهایی): %s" +msgid "error while formatting arguments for %s: %s" +msgstr "خطا در قالب بندی نشانوند برای %s: %s" -#: ext/napoleon/docstring.py:1022 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "مقدار نامعتبر تعیین شده (بدون کمانک ابتدایی): %s" +msgid "Failed to get a constructor signature for %s: %s" +msgstr "شکست در دریافت امضای سازنده‌ی شیئ برای %s: مؤلّفه پیدا نشد: %s" -#: ext/napoleon/docstring.py:1029 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "رشته‌متن ادبی ناقص (بدون علامت نقل‌قول انتهایی): %s" +msgid "Failed to get a method signature for %s: %s" +msgstr "شکست در دریافت امضای شگرد برای %s: مؤلّفه پیدا نشد: %s" -#: ext/napoleon/docstring.py:1036 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "رشته‌متن ادبی ناقص (بدون علامت نقل‌قول ابتدایی): %s" +msgid "Failed to get a signature for %s: %s" +msgstr "" -#: ext/autosummary/__init__.py:256 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "autosummary references excluded document %r. Ignored." -msgstr "ارجاعات خلاصه‌ی خودکار سند %r حذف کنار گذاشته. نادیده گرفته می‌شود." +msgid "Failed to parse a default argument value for %r: %s" +msgstr "شکست در تحلیل مقدار پیش‌گزیده‌‌ی نشانوند برای %r: %s" -#: ext/autosummary/__init__.py:258 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." -msgstr "خلاصه‌ی خودکار: خرده‌پرونده‌ی %r پیدا نشد. تنظیمات تولید خلاصه‌ی خودکار(autosummary_generate) را بررسی کنید." - -#: ext/autosummary/__init__.py:277 -msgid "A captioned autosummary requires :toctree: option. ignored." -msgstr "خلاصه‌ی خودکار عنوان‌ٔار نیازمند گزینه‌ی :toctree: است، نادیده گرفته می‌شود." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" +msgstr "" -#: ext/autosummary/__init__.py:330 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/__init__.py:344 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "failed to parse name %s" -msgstr "شکست در تجزیه تحلیل نام %s" +msgid "signature arguments or return annotation given for automodule %s" +msgstr "نشانوند‌های امضا یا یادداشت مقدار برگشتی داده شده برای پیمانه‌ی خودکار %s" -#: ext/autosummary/__init__.py:349 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "failed to import object %s" -msgstr "شکست در وارد کردن شیئ %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ باید لیستی از رشته‌متن ها باشد، نه %r (در پیمانه‌ی %s) -- __all__ نادیده گرفته می‌شود" -#: ext/autosummary/__init__.py:648 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format msgid "" -"Summarised items should not include the current module. Replace %r with %r." -msgstr "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "ویژگی نایاب در گزینه‌ی :members: قید شده: پیمانه‌ی:%s، ویژگی %s" -#: ext/autosummary/__init__.py:819 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "autosummary_generate: file not found: %s" -msgstr "تولید خلاصه خودکار: پرونده پیدا نشد: %s" +msgid "missing attribute %s in object %s" +msgstr "ویژگی ناموجود %s در شیئ %s" -#: ext/autosummary/__init__.py:827 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "نام جانشین نوع متغیر(%s)" + +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/autosummary/generate.py:215 ext/autosummary/generate.py:391 -#, python-format -msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "خلاصه‌ی خودکار: شکست در تشخیص %r برای مستندسازی، این ایراد به وجود آمد:\n%s" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" -#: ext/autosummary/generate.py:526 +#: builders/html/__init__.py:114 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[خلاصه‌ی خودکار] تولید خلاصه‌ی خودکار برای: %s" +msgid "The HTML pages are in %(outdir)s." +msgstr "صفحات HTML در %(outdir)s است." -#: ext/autosummary/generate.py:530 +#: builders/html/__init__.py:337 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[خلاصه‌ی خودکار] نوشتن در %s" +msgid "Failed to read build info file: %r" +msgstr "شکست در خواندن پرونده‌ی اطّلاعات ساخت: %r" -#: ext/autosummary/generate.py:572 +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" + +#: builders/html/__init__.py:372 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/autosummary/generate.py:767 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nتولید ReStructuredText با استفاده از دستورالعمل‌های خلاصه‌ی خودکار.\n\nخودکارساز اسفینکس رابط کابر پسندی برای sphinx.ext.autosummary.generate (پیمانه‌ی افزونه‌ی خلاصه‌ساز اسفنیکس) است.\nاین افزونه پرونده های متن reStructuredText را از دستورالعمل‌های خلاصه‌ی خودکاری تولید می‌کند که در پرونده‌های درون‌داد مشخّص شده قرار دارد.\n\nقالب دستورالعمل خلاصه‌ی خودکار درپیمانه‌ی افزونه‌ی خلاصه‌ی خودکار اسفنیکس (sphinx.ext.autosummary) مستند سازی شده می توان آن را با دستور زیر خواند::\n\n pydoc sphinx.ext.autosummary\n" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "فهرست" -#: ext/autosummary/generate.py:789 -msgid "source files to generate rST files for" -msgstr "پرونده‌های منبع برای تولید پرونده‌های rST" +#: builders/html/__init__.py:549 +#, python-format +msgid "Logo of %s" +msgstr "" -#: ext/autosummary/generate.py:797 -msgid "directory to place all output in" -msgstr "پوشه‌ای برای قرار دادن همه‌ی برون دادها در آن" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "بعدی" -#: ext/autosummary/generate.py:805 -#, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "پسوند پیش فرض برای پرونده‌ها (پیش‌فرض: %(default)s)" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "قبلی" -#: ext/autosummary/generate.py:813 -#, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "شاخه‌ی سفارشی قالب (پیش‌گزیده: %(default)s)" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "تولید نمایه‌ها" -#: ext/autosummary/generate.py:821 -#, python-format -msgid "document imported members (default: %(default)s)" -msgstr "اجزای فراخوان شده‌ی سند (پیش‌گزیده: %(default)s)" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "نوشتن صفحات اضافی" -#: ext/autosummary/generate.py:829 +#: builders/html/__init__.py:783 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:47 -#, python-format -msgid "(in %s v%s)" -msgstr "(در %s v%s)" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "رونوشت از پرونده‌های قابل دریافت... " -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:807 #, python-format -msgid "(in %s)" -msgstr "(در %s )" +msgid "cannot copy downloadable file %r: %s" +msgstr "نمی تواند از پرونده‌ی قابل دریافت %r: %s رونوشت بگیرد" -#: ext/intersphinx/_resolve.py:103 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:113 +#: builders/html/__init__.py:871 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "شکست در رونوشت یک پرونده‌ی به html_static_file: %s: %r" -#: ext/intersphinx/_resolve.py:359 -#, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "رونوشت از پرونده‌های ثابت" -#: ext/intersphinx/_resolve.py:367 +#: builders/html/__init__.py:923 #, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "" +msgid "cannot copy static file %r" +msgstr "نمی تواند از پرونده‌ی ثابت %r رونوشت بگیرد" -#: ext/intersphinx/_resolve.py:378 -#, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "رونوشت برداری از پرونده‌های اضافی" -#: ext/intersphinx/_resolve.py:585 +#: builders/html/__init__.py:938 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "" +msgid "cannot copy extra file %r" +msgstr "نمی تواند از پرونده‌ی اضافه‌ی %r رونوشت بگیرد" -#: ext/intersphinx/_load.py:59 +#: builders/html/__init__.py:944 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "Failed to write build info file: %r" +msgstr "شکست در نوشتن پرونده‌ی اطّلاعات ساخت: %r" -#: ext/intersphinx/_load.py:70 -#, python-format +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "نمایه‌ی جستجو نمی‌تواند بارگزاری شود، ولی برای همه‌ی مستندات ساخته‌ نمی‌شود: نمایه‌ ناقص خواهد بود." -#: ext/intersphinx/_load.py:81 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "صفحه‌ی %s با دو الگو در نوار کناری صفحه (html_sidebars) هم‌خوانی دارد: %r و%r" -#: ext/intersphinx/_load.py:92 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "هنگام ارائه‌ی صفحه‌ی %s خطای یونیکد رخ داد. لطفاً اطمینان حاصل کنید که تمام مقدارهای پیکربندی‌ها دارای محتوای غیر اَسکی، رشته‌متن‌های یونکد هستند." -#: ext/intersphinx/_load.py:101 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:120 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "خطایی در نمایش صفحه‌ی %s رخ داد.\nعلّت: %r" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "خالی کردن فهرست اشیاء" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:155 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +msgid "dumping search index in %s" +msgstr "خالی کردن نمایه‌ی جستجو در %s" -#: ext/intersphinx/_load.py:240 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "" - -#: ext/intersphinx/_load.py:265 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "مشکلاتی در برخی از سیاهه‌ها به وجود آمد،ولی این مشکلات راه‌های جایگزین های داشته‌اند:" +msgid "invalid js_file: %r, ignored" +msgstr "پرونده‌ی js نامعتبر%r: نادیده گرفته می‌شود" -#: ext/intersphinx/_load.py:275 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "شکست در رسیدن به یکی از سیاهه‌ها به خاطر مشکلات زیر:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "ارا‌ئه کننده‌های ریاضی زیادی ثبت شده‌اند، ولی هیچ کدام انتخاب نشده." -#: ext/intersphinx/_load.py:319 +#: builders/html/__init__.py:1351 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "سیاهه‌ی بین اسفینکس جا به جایی را انجام داد: %s -> %s" +msgid "Unknown math_renderer %r is given." +msgstr "نمایش‌دهنده‌ی ریاضی نامشخّص %r داده شده." -#: ext/autodoc/type_comment.py:132 +#: builders/html/__init__.py:1365 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "شکست در به روز رسانی امضا برای %r: مؤلّفه پیدا نشد: %s" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "مدخل مسیر اضافی (html_extra_path) %r درون شاخه‌ی خارجی قرار دارد" -#: ext/autodoc/type_comment.py:135 +#: builders/html/__init__.py:1370 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "شکست در تحلیل نوع یادداشت برای %r: %s" +msgid "html_extra_path entry %r does not exist" +msgstr "مدخل مسیر اضافی (html_extra_path) %r وجود ندارد" -#: ext/autodoc/__init__.py:142 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "مقدار نامعتبر برای گزینه‌ی ترتیب اعضا (member-order): %s" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "مدخل مسیر ثابت (html_static_path) %r درون شاخه‌ی خارجی قرار دارد" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "مقدار نامعتبر برای گزینه‌ی «از مستندات کلاس» class-doc-from:%s" +msgid "html_static_path entry %r does not exist" +msgstr "مدخل مسیر ثابت (html_static_path) %r وجود ندارد" -#: ext/autodoc/__init__.py:415 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "امضای ناشناخته‌ برای %s (%r)" +msgid "logo file %r does not exist" +msgstr "پرونده‌ی آرم %r وجود ندارد" -#: ext/autodoc/__init__.py:532 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "خطا در قالب بندی نشانوند برای %s: %s" +msgid "favicon file %r does not exist" +msgstr "پرونده‌ی آیکون مورد علاقه %r وجود ندارد" -#: ext/autodoc/__init__.py:807 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:902 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "مشخّص نیست کدام پیمانه را برای مستندسازی خودکار فراخوان کند %r (سعی کنید دستورالعمل «module» یا «currentmodule» را در سند قرار دهید، یا یک نام واضح برای پیمانه ارائه دهید)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "" -#: ext/autodoc/__init__.py:946 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" -msgstr "شیئ ساختگی شناسایی شد: %r" +msgid "%s %s documentation" +msgstr "مستندات %s%s" -#: ext/autodoc/__init__.py:965 +#: builders/latex/theming.py:87 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "خطا در قالب بندی امضا برای %s: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r فاقد تنظیمات زمینه است" -#: ext/autodoc/__init__.py:1028 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "\"::\" در پیمانه‌ی خودکار معنی نمی‌دهد" +#: builders/latex/theming.py:90 +#, python-format +msgid "%r doesn't have \"%s\" setting" +msgstr "%r فاقد تنظیمات \"%s\" است" -#: ext/autodoc/__init__.py:1035 +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "" + +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "نشانوند‌های امضا یا یادداشت مقدار برگشتی داده شده برای پیمانه‌ی خودکار %s" +msgid "Failed to get a docname for source %r!" +msgstr "" -#: ext/autodoc/__init__.py:1048 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ باید لیستی از رشته‌متن ها باشد، نه %r (در پیمانه‌ی %s) -- __all__ نادیده گرفته می‌شود" +msgid "No footnote was found for given reference node %r" +msgstr "" -#: ext/autodoc/__init__.py:1114 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "پرونده‌ی LaTeX در پوشه‌ی %(outdir)s است." + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "ویژگی نایاب در گزینه‌ی :members: قید شده: پیمانه‌ی:%s، ویژگی %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nدر آن شاخه فرمان 'make' را اجرا کنید تا این‌ها را با لتکس(pdf) اجرا کند\n(برای انجام خودکار `make latexpdf' را به کار ببرید)." + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "هیچ مقدار پیکربندی اسناد لتکسی (latex_documents) پیدا نشد؛ بنابراین هیچ سندی نوشته نخواهد شد" -#: ext/autodoc/__init__.py:1337 ext/autodoc/__init__.py:1414 -#: ext/autodoc/__init__.py:2829 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "شکست در دریافت امضای تابع برای %s: مؤلّفه پیدا نشد: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "مقدار پیکربندی سندهای لتکس (latex_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "رونوشت از پرونده‌های پشتیبانی لتکس" -#: ext/autodoc/__init__.py:1633 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "رونوشت برداری از پرونده‌های اضافی" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "شکست در دریافت امضای سازنده‌ی شیئ برای %s: مؤلّفه پیدا نشد: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "کلید پیکربندی ناشناخته: latex_elements[%r]، نادیده گرفته می‌شود." -#: ext/autodoc/__init__.py:1760 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" -msgstr "پایه ها:%s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "کلید زمینه‌ی ناشناخته: latex_theme_options[%r]، نادیده گرفته می‌شود." -#: ext/autodoc/__init__.py:1774 +#: environment/collectors/toctree.py:259 #, python-format -msgid "missing attribute %s in object %s" -msgstr "ویژگی ناموجود %s در شیئ %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "شماره‌ی قسمت‌ها پیش‌تر به %s نسبت داده شده ( آیا درختواره‌ی فهرست مطالب شماره‌گذاری تو در تو دارد؟)" -#: ext/autodoc/__init__.py:1855 ext/autodoc/__init__.py:1892 -#: ext/autodoc/__init__.py:1987 +#: environment/collectors/asset.py:98 #, python-format -msgid "alias of %s" -msgstr "نام جانشین %s" +msgid "image file not readable: %s" +msgstr "پرونده‌ی تصویر خوانا نیست: %s" -#: ext/autodoc/__init__.py:1875 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "نام جانشین نوع متغیر(%s)" +msgid "image file %s not readable: %s" +msgstr "پرونده‌ی عکس %s خوانا نیست: %s" -#: ext/autodoc/__init__.py:2217 ext/autodoc/__init__.py:2317 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "شکست در دریافت امضای شگرد برای %s: مؤلّفه پیدا نشد: %s" +msgid "download file not readable: %s" +msgstr "پرونده‌ی دریافت شده خوانا نیست: %s" -#: ext/autodoc/__init__.py:2448 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "__slots__ نامعتبر در %sیدا شد و نادیده گرفته شد." +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "دور تسلسل در درختواره‌ی ارجاعات فهرست مطالب تشخیص داده شده، نادیده گرفته می‌شوند: %s <- %s" -#: ext/autodoc/preserve_defaults.py:190 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "شکست در تحلیل مقدار پیش‌گزیده‌‌ی نشانوند برای %r: %s" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "فهرست مطالب دارای ارجاع به سند %r است که عنوانی ندارد: هیچ پیوندی تولید نخواهد شد" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "ادامه از صفحه‌ی قبل" +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "ادامه در صفحه‌ی بعد" +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "غیر الفبایی" +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "%s را ببینید" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "شماره ها" +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "%s را هم ببینید" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "صفحه" +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "نوع ناشناخته مدخل نمایه %r" diff --git a/sphinx/locale/fi/LC_MESSAGES/sphinx.mo b/sphinx/locale/fi/LC_MESSAGES/sphinx.mo index 00433e59179..5ed53f938ec 100644 Binary files a/sphinx/locale/fi/LC_MESSAGES/sphinx.mo and b/sphinx/locale/fi/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/fi/LC_MESSAGES/sphinx.po b/sphinx/locale/fi/LC_MESSAGES/sphinx.po index 12a6479da1c..ec0fe50ed03 100644 --- a/sphinx/locale/fi/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/fi/LC_MESSAGES/sphinx.po @@ -1,5 +1,5 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: @@ -8,153 +8,300 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-29 22:39+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FIRST AUTHOR , 2009\n" "Language-Team: Finnish (http://app.transifex.com/sphinx-doc/sphinx-1/language/fi/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" "Language: fi\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" -#: events.py:77 +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "" + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "" + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 #, python-format msgid "Event %r already present" msgstr "" -#: events.py:370 +#: events.py:386 #, python-format msgid "Unknown event name: %s" msgstr "" -#: events.py:416 +#: events.py:451 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" -#: application.py:190 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:194 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:198 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:228 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:250 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:266 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:271 registry.py:452 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:277 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:312 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:329 util/display.py:88 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:331 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:345 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:353 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:366 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:398 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:400 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:404 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:407 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:409 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:414 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:417 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:419 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:968 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1047 +#: application.py:1113 #, python-format -msgid "directive %r is already registered, it will be overridden" +msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1069 application.py:1094 +#: application.py:1139 application.py:1167 #, python-format -msgid "role %r is already registered, it will be overridden" +msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1644 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1648 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1651 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,1153 +322,1307 @@ msgid "" "explicit" msgstr "" -#: application.py:1655 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1663 application.py:1667 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: roles.py:208 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:231 -#, python-format -msgid "invalid CVE number %s" -msgstr "" - -#: roles.py:253 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" - -#: roles.py:276 -#, python-format -msgid "invalid CWE number %s" -msgstr "" - -#: roles.py:296 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:319 -#, python-format -msgid "invalid PEP number %s" -msgstr "" - -#: roles.py:357 -#, python-format -msgid "invalid RFC number %s" -msgstr "" - -#: registry.py:144 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" -#: registry.py:146 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" -#: registry.py:159 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" -#: registry.py:166 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "" -#: registry.py:173 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "" -#: registry.py:196 registry.py:209 registry.py:220 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "" -#: registry.py:200 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" -#: registry.py:212 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" -#: registry.py:223 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" -#: registry.py:254 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "" -#: registry.py:280 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "" -#: registry.py:287 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "" -#: registry.py:296 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "" -#: registry.py:304 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "" -#: registry.py:320 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "" -#: registry.py:336 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: registry.py:419 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "" -#: registry.py:431 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "" -#: registry.py:446 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" -#: registry.py:457 +#: registry.py:545 msgid "Original exception:\n" msgstr "" -#: registry.py:458 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "" -#: registry.py:463 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" -#: registry.py:472 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" -#: registry.py:480 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" -#: registry.py:514 +#: registry.py:605 #, python-format msgid "`None` is not a valid filetype for %r." msgstr "" -#: project.py:71 +#: config.py:351 #, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: project.py:87 +#: config.py:374 #, python-format -msgid "Ignored unreadable document %r." +msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: highlighting.py:168 +#: config.py:379 #, python-format -msgid "Pygments lexer name %r is not known" +msgid "" +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" msgstr "" -#: highlighting.py:202 +#: config.py:391 #, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: extension.py:55 +#: config.py:399 #, python-format -msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." +msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: extension.py:76 +#: config.py:422 #, python-format -msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." +msgid "unknown config value %r in override, ignoring" msgstr "" -#: theming.py:114 +#: config.py:476 #, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +msgid "No such config value: %r" msgstr "" -#: theming.py:120 +#: config.py:504 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +msgid "Config value %r already present" msgstr "" -#: theming.py:135 +#: config.py:541 #, python-format -msgid "unsupported theme option %r given" +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" msgstr "" -#: theming.py:207 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." msgstr "" -#: theming.py:228 +#: config.py:599 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: theming.py:268 -#, python-format -msgid "The %r theme has circular inheritance" +#: config.py:603 +msgid "" +"The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: theming.py:275 +#: config.py:611 #, python-format msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" msgstr "" -#: theming.py:282 +#: config.py:633 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to convert %r to a frozenset" msgstr "" -#: theming.py:310 +#: config.py:651 config.py:659 #, python-format -msgid "no theme configuration file found in %r" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: theming.py:335 theming.py:388 +#: config.py:665 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." msgstr "" -#: theming.py:339 +#: config.py:686 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" +msgid "Section %s" msgstr "" -#: theming.py:343 theming.py:391 +#: config.py:687 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "Fig. %s" msgstr "" -#: theming.py:347 +#: config.py:688 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "Table %s" msgstr "" -#: theming.py:366 +#: config.py:689 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgid "Listing %s" msgstr "" -#: config.py:309 -#, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +#: config.py:798 +#, python-brace-format +msgid "" +"The config value `{name}` has to be a one of {candidates}, but `{current}` " +"is given." msgstr "" -#: config.py:318 +#: config.py:829 +#, python-brace-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"The config value `{name}' has type `{current.__name__}'; expected " +"{permitted}." msgstr "" -#: config.py:341 -#, python-format +#: config.py:846 +#, python-brace-format msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" +"The config value `{name}' has type `{current.__name__}', defaults to " +"`{default.__name__}'." msgstr "" -#: config.py:350 +#: config.py:858 #, python-format -msgid "invalid number %r for config value %r, ignoring" +msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:356 -#, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" +#: config.py:878 +msgid "" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: config.py:377 -#, python-format -msgid "unknown config value %r in override, ignoring" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: config.py:430 -#, python-format -msgid "No such config value: %r" +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: config.py:453 -#, python-format -msgid "Config value %r already present" +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: config.py:489 -#, python-format -msgid "" -"cannot cache unpickable configuration value: %r (because it contains a " -"function, class, or module object)" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: config.py:527 -#, python-format -msgid "There is a syntax error in your configuration file: %s\n" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: config.py:530 -msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: config.py:537 +#: environment/__init__.py:350 #, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: config.py:560 +#: environment/__init__.py:355 #, python-format -msgid "Failed to convert %r to a set or tuple" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: config.py:581 config.py:586 +#: environment/__init__.py:361 #, python-format -msgid "Converting `source_suffix = %r` to `source_suffix = %r`." +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: config.py:589 -#, python-format +#: environment/__init__.py:404 msgid "" -"The config value `source_suffix' expects a dictionary, a string, or a list " -"of strings. Got `%r' instead (type %s)." +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: config.py:608 +#: environment/__init__.py:518 #, python-format -msgid "Section %s" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: config.py:609 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "Fig. %s" +msgid "Domain %r is not registered" +msgstr "" + +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "" + +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: config.py:610 +#: environment/__init__.py:952 #, python-format -msgid "Table %s" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: config.py:611 +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Huom" + +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Varoitus" + +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Vaara" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Virhe" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Vihje" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Tärkeä" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Muista" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Katso myös" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Vihje" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Varoitus" + +#: builders/texinfo.py:41 #, python-format -msgid "Listing %s" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: config.py:718 +#: builders/texinfo.py:44 msgid "" -"The config value `{name}` has to be a one of {candidates}, but `{current}` " -"is given." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: config.py:742 -msgid "" -"The config value `{name}' has type `{current.__name__}'; expected " -"{permitted}." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: config.py:755 -msgid "" -"The config value `{name}' has type `{current.__name__}', defaults to " -"`{default.__name__}'." +#: builders/texinfo.py:85 +#, python-format +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: config.py:766 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "primary_domain %r not found, ignored." +msgid "processing %s" msgstr "" -#: config.py:778 -msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "" + +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "" + +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "" + +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: domains/rst.py:128 domains/rst.py:185 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "%s (directive)" +msgid "cannot copy image file %r: %s" +msgstr "" + +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: domains/rst.py:186 domains/rst.py:190 +#: builders/texinfo.py:218 #, python-format -msgid ":%s: (directive option)" +msgid "error writing file Makefile: %s" msgstr "" -#: domains/rst.py:214 +#: builders/manpage.py:37 #, python-format -msgid "%s (role)" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: domains/rst.py:224 -msgid "directive" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: domains/rst.py:225 -msgid "directive-option" +#: builders/manpage.py:64 +#, python-format +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: domains/rst.py:226 -msgid "role" +#: builders/singlehtml.py:35 +#, python-format +msgid "The HTML page is in %(outdir)s." +msgstr "" + +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "" + +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "" + +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: domains/rst.py:248 +#: builders/gettext.py:243 #, python-format -msgid "duplicate description of %s %s, other instance in %s" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: domains/javascript.py:165 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "%s() (built-in function)" +msgid "building [%s]: " msgstr "" -#: domains/javascript.py:166 domains/python/__init__.py:253 +#: builders/gettext.py:265 #, python-format -msgid "%s() (%s method)" +msgid "targets for %d template files" +msgstr "" + +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "" + +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: domains/javascript.py:168 +#: builders/linkcheck.py:87 #, python-format -msgid "%s() (class)" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: domains/javascript.py:170 +#: builders/linkcheck.py:159 #, python-format -msgid "%s (global variable or constant)" +msgid "broken link: %s (%s)" msgstr "" -#: domains/javascript.py:172 domains/python/__init__.py:338 +#: builders/linkcheck.py:561 #, python-format -msgid "%s (%s attribute)" +msgid "Anchor '%s' not found" msgstr "" -#: domains/javascript.py:255 -msgid "Arguments" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: domains/cpp/__init__.py:447 domains/javascript.py:258 -msgid "Throws" +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: domains/c/__init__.py:310 domains/cpp/__init__.py:458 -#: domains/javascript.py:261 domains/python/_object.py:176 -msgid "Returns" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: domains/c/__init__.py:312 domains/javascript.py:263 -#: domains/python/_object.py:178 -msgid "Return type" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: domains/javascript.py:334 -#, python-format -msgid "%s (module)" -msgstr "%s (moduuli)" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "" -#: domains/c/__init__.py:681 domains/cpp/__init__.py:859 -#: domains/javascript.py:371 domains/python/__init__.py:660 -msgid "function" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: domains/javascript.py:372 domains/python/__init__.py:664 -msgid "method" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: domains/cpp/__init__.py:857 domains/javascript.py:373 -#: domains/python/__init__.py:662 -msgid "class" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: domains/javascript.py:374 domains/python/__init__.py:661 -msgid "data" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: domains/javascript.py:375 domains/python/__init__.py:667 -msgid "attribute" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: domains/javascript.py:376 domains/python/__init__.py:670 -msgid "module" -msgstr "moduuli" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: domains/javascript.py:407 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: domains/changeset.py:25 -#, python-format -msgid "Added in version %s" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Changed in version %s" -msgstr "Muutettu versiossa %s" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" -#: domains/changeset.py:27 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "Deprecated since version %s" -msgstr "Poistettu versiosta %s alkaen" +msgid "invalid css_file: %r, ignored" +msgstr "" -#: domains/changeset.py:28 +#: builders/xml.py:29 #, python-format -msgid "Removed in version %s" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/__init__.py:299 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "%s %s" +msgid "error writing file %s: %s" msgstr "" -#: domains/citation.py:73 +#: builders/xml.py:103 #, python-format -msgid "duplicate citation %s, other instance in %s" +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: domains/citation.py:84 +#: builders/_epub_base.py:223 #, python-format -msgid "Citation [%s] is not referenced." +msgid "duplicated ToC entry found: %s" msgstr "" -#: domains/math.py:63 +#: builders/_epub_base.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: domains/math.py:119 writers/latex.py:2479 +#: builders/_epub_base.py:467 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: environment/__init__.py:81 -msgid "new config" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: environment/__init__.py:82 -msgid "config changed" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: environment/__init__.py:83 -msgid "extensions changed" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: environment/__init__.py:249 -msgid "build environment version not current" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: environment/__init__.py:251 -msgid "source directory has changed" +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: environment/__init__.py:313 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: environment/__init__.py:318 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." msgstr "" -#: environment/__init__.py:324 +#: builders/_epub_base.py:802 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "writing %s file..." msgstr "" -#: environment/__init__.py:366 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." msgstr "" -#: environment/__init__.py:473 +#: builders/__init__.py:229 #, python-format -msgid "Failed to scan documents in %s: %r" +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: environment/__init__.py:626 +#: builders/__init__.py:237 #, python-format -msgid "Domain %r is not registered" +msgid "a suitable image for %s builder not found: %s" msgstr "" -#: environment/__init__.py:777 -msgid "document isn't included in any toctree" +#: builders/__init__.py:260 +msgid "building [mo]: " msgstr "" -#: environment/__init__.py:810 -msgid "self referenced toctree found. Ignored." +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " msgstr "" -#: environment/__init__.py:839 +#: builders/__init__.py:280 #, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgid "all of %d po files" msgstr "" -#: locale/__init__.py:229 -msgid "Attention" -msgstr "Huom" - -#: locale/__init__.py:230 -msgid "Caution" -msgstr "Varoitus" +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" -#: locale/__init__.py:231 -msgid "Danger" -msgstr "Vaara" +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" -#: locale/__init__.py:232 -msgid "Error" -msgstr "Virhe" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" -#: locale/__init__.py:233 -msgid "Hint" -msgstr "Vihje" - -#: locale/__init__.py:234 -msgid "Important" -msgstr "Tärkeä" - -#: locale/__init__.py:235 -msgid "Note" -msgstr "Muista" - -#: locale/__init__.py:236 -msgid "See also" -msgstr "Katso myös" - -#: locale/__init__.py:237 -msgid "Tip" -msgstr "Vihje" - -#: locale/__init__.py:238 -msgid "Warning" -msgstr "Varoitus" - -#: cmd/quickstart.py:43 -msgid "automatically insert docstrings from modules" +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: cmd/quickstart.py:44 -msgid "automatically test code snippets in doctest blocks" +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: cmd/quickstart.py:45 -msgid "link between Sphinx documentation of different projects" +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: cmd/quickstart.py:46 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" msgstr "" -#: cmd/quickstart.py:47 -msgid "checks for documentation coverage" +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" msgstr "" -#: cmd/quickstart.py:48 -msgid "include math, rendered as PNG or SVG images" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " msgstr "" -#: cmd/quickstart.py:49 -msgid "include math, rendered in the browser by MathJax" +#: builders/__init__.py:415 +#, python-format +msgid "%d found" msgstr "" -#: cmd/quickstart.py:50 -msgid "conditional inclusion of content based on config values" +#: builders/__init__.py:417 +msgid "none found" msgstr "" -#: cmd/quickstart.py:51 -msgid "include links to the source code of documented Python objects" +#: builders/__init__.py:424 +msgid "pickling environment" msgstr "" -#: cmd/quickstart.py:52 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: builders/__init__.py:431 +msgid "checking consistency" msgstr "" -#: cmd/quickstart.py:94 -msgid "Please enter a valid path name." +#: builders/__init__.py:435 +msgid "no targets are out of date." msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter some text." +#: builders/__init__.py:474 +msgid "updating environment: " msgstr "" -#: cmd/quickstart.py:117 +#: builders/__init__.py:499 #, python-format -msgid "Please enter one of %s." -msgstr "" - -#: cmd/quickstart.py:125 -msgid "Please enter either 'y' or 'n'." +msgid "%s added, %s changed, %s removed" msgstr "" -#: cmd/quickstart.py:131 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: cmd/quickstart.py:215 +#: builders/__init__.py:545 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: cmd/quickstart.py:219 +#: builders/__init__.py:556 +#, python-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: cmd/quickstart.py:227 +#: builders/__init__.py:563 #, python-format -msgid "Selected root path: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." msgstr "" -#: cmd/quickstart.py:230 -msgid "Enter the root path for documentation." +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " msgstr "" -#: cmd/quickstart.py:231 -msgid "Root path for the documentation" +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" msgstr "" -#: cmd/quickstart.py:239 -msgid "Error: an existing conf.py has been found in the selected root path." +#: builders/__init__.py:727 +msgid "no docnames to write!" msgstr "" -#: cmd/quickstart.py:245 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: builders/__init__.py:740 +msgid "preparing documents" msgstr "" -#: cmd/quickstart.py:248 -msgid "Please enter a new root path (or just Enter to exit)" +#: builders/__init__.py:743 +msgid "copying assets" msgstr "" -#: cmd/quickstart.py:258 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." msgstr "" -#: cmd/quickstart.py:265 -msgid "Separate source and build directories (y/n)" +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." msgstr "" -#: cmd/quickstart.py:271 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: builders/changes.py:67 +msgid "writing summary file..." msgstr "" -#: cmd/quickstart.py:277 -msgid "Name prefix for templates and static dir" +#: builders/changes.py:79 +msgid "Builtins" msgstr "" -#: cmd/quickstart.py:282 -msgid "" -"The project name will occur in several places in the built documentation." +#: builders/changes.py:81 +msgid "Module level" +msgstr "Moduulitaso" + +#: builders/changes.py:137 +msgid "copying source files..." msgstr "" -#: cmd/quickstart.py:286 -msgid "Project name" +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" -#: cmd/quickstart.py:288 -msgid "Author name(s)" +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" msgstr "" -#: cmd/quickstart.py:293 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" msgstr "" -#: cmd/quickstart.py:301 -msgid "Project version" +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" msgstr "" -#: cmd/quickstart.py:303 -msgid "Project release" +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" msgstr "" -#: cmd/quickstart.py:308 +#: ext/coverage.py:172 +#, python-brace-format, python-format msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." msgstr "" -#: cmd/quickstart.py:317 -msgid "Project language" +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" msgstr "" -#: cmd/quickstart.py:324 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" msgstr "" -#: cmd/quickstart.py:329 -msgid "Source file suffix" +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" msgstr "" -#: cmd/quickstart.py:334 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" msgstr "" -#: cmd/quickstart.py:342 -msgid "Name of your master document (without suffix)" +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" msgstr "" -#: cmd/quickstart.py:352 +#: ext/extlinks.py:82 #, python-format msgid "" -"Error: the master file %s has already been found in the selected root path." +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: cmd/quickstart.py:359 -msgid "sphinx-quickstart will not overwrite the existing file." +#: ext/todo.py:61 +msgid "Todo" +msgstr "Tehtävä vielä" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" msgstr "" -#: cmd/quickstart.py:362 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: ext/todo.py:152 +msgid "<>" msgstr "" -#: cmd/quickstart.py:371 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" msgstr "" -#: cmd/quickstart.py:381 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: ext/todo.py:166 +msgid "original entry" msgstr "" -#: cmd/quickstart.py:391 +#: ext/imgconverter.py:44 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" msgstr "" -#: cmd/quickstart.py:397 -msgid "Create Makefile? (y/n)" +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:401 -msgid "Create Windows command file? (y/n)" +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" -#: cmd/quickstart.py:453 ext/apidoc.py:92 -#, python-format -msgid "Creating file %s." +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" -#: cmd/quickstart.py:458 ext/apidoc.py:89 +#: ext/graphviz.py:153 #, python-format -msgid "File %s already exists, skipping." +msgid "External Graphviz file %r not found or reading it failed" msgstr "" -#: cmd/quickstart.py:501 -msgid "Finished: An initial directory structure has been created." +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." msgstr "" -#: cmd/quickstart.py:504 +#: ext/graphviz.py:287 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "graphviz_dot executable path must be set! %r" msgstr "" -#: cmd/quickstart.py:512 +#: ext/graphviz.py:328 +#, python-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" msgstr "" -#: cmd/quickstart.py:515 +#: ext/graphviz.py:339 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:522 +#: ext/graphviz.py:344 +#, python-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:557 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" msgstr "" -#: cmd/build.py:153 cmd/quickstart.py:567 ext/apidoc.py:374 -#: ext/autosummary/generate.py:766 -msgid "For more information, visit ." +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" msgstr "" -#: cmd/quickstart.py:577 -msgid "quiet mode" +#: ext/graphviz.py:493 ext/graphviz.py:501 +#, python-format +msgid "[graph: %s]" msgstr "" -#: cmd/quickstart.py:587 -msgid "project root" +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" msgstr "" -#: cmd/quickstart.py:590 -msgid "Structure options" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: cmd/quickstart.py:596 -msgid "if specified, separate source and build dirs" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: cmd/quickstart.py:602 -msgid "if specified, create build dir under source dir" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" msgstr "" -#: cmd/quickstart.py:608 -msgid "replacement for dot in _templates etc." +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: cmd/quickstart.py:611 -msgid "Project basic options" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: cmd/quickstart.py:613 -msgid "project name" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: cmd/quickstart.py:616 -msgid "author names" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." msgstr "" -#: cmd/quickstart.py:623 -msgid "version of project" +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" msgstr "" -#: cmd/quickstart.py:630 -msgid "release of project" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: cmd/quickstart.py:637 -msgid "document language" +#: ext/doctest.py:297 +#, python-format +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: cmd/quickstart.py:640 -msgid "source file suffix" +#: ext/doctest.py:451 +#, python-format +msgid "no code/output in %s block at %s:%s" msgstr "" -#: cmd/quickstart.py:643 -msgid "master document name" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: cmd/quickstart.py:646 -msgid "use epub" +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: cmd/quickstart.py:649 -msgid "Extension options" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: cmd/quickstart.py:656 ext/apidoc.py:578 +#: ext/duration.py:47 #, python-format -msgid "enable %s extension" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: cmd/quickstart.py:663 ext/apidoc.py:570 -msgid "enable arbitrary extensions" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: cmd/quickstart.py:666 -msgid "Makefile and Batchfile creation" +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: cmd/quickstart.py:672 -msgid "create makefile" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: cmd/quickstart.py:678 -msgid "do not create makefile" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: cmd/quickstart.py:685 -msgid "create batchfile" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: cmd/quickstart.py:691 -msgid "do not create batchfile" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: cmd/quickstart.py:700 -msgid "use make-mode for Makefile/make.bat" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: cmd/quickstart.py:703 ext/apidoc.py:581 -msgid "Project templating" +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: cmd/quickstart.py:709 ext/apidoc.py:587 -msgid "template directory for template files" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " msgstr "" -#: cmd/quickstart.py:716 -msgid "define a template variable" +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: cmd/quickstart.py:751 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: cmd/quickstart.py:770 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: cmd/quickstart.py:777 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:795 +#: domains/math.py:73 #, python-format -msgid "Invalid template variable: %s" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: cmd/build.py:49 -msgid "Exception occurred while building, starting debugger:" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: _cli/util/errors.py:129 cmd/build.py:65 -msgid "Interrupted!" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "" + +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: cmd/build.py:67 -msgid "reST markup error:" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" msgstr "" -#: _cli/util/errors.py:143 cmd/build.py:73 -msgid "Encoding error:" +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" msgstr "" -#: cmd/build.py:78 cmd/build.py:108 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." +msgid "%s (%s attribute)" msgstr "" -#: _cli/util/errors.py:148 cmd/build.py:90 -msgid "Recursion error:" +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: _cli/util/errors.py:152 cmd/build.py:94 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: _cli/util/errors.py:165 cmd/build.py:103 -msgid "Exception occurred:" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: _cli/util/errors.py:178 cmd/build.py:117 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: cmd/build.py:124 -msgid "" -"A bug report can be filed in the tracker at . Thanks!" +#: domains/javascript.py:374 +#, python-format +msgid "%s (module)" +msgstr "%s (moduuli)" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "moduuli" + +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" +msgstr "" + +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" +msgstr "" + +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr "" + +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "" + +#: domains/rst.py:234 +msgid "directive" +msgstr "" + +#: domains/rst.py:235 +msgid "directive-option" +msgstr "" + +#: domains/rst.py:236 +msgid "role" +msgstr "" + +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "" + +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" +msgstr "" + +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "Muutettu versiossa %s" + +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "Poistettu versiosta %s alkaen" + +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" +msgstr "" + +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" msgstr "" -#: cmd/build.py:144 +#: cmd/build.py:64 msgid "job number should be a positive number" msgstr "" -#: cmd/build.py:154 +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" + +#: cmd/build.py:74 msgid "" "\n" "Generate documentation from source files.\n" @@ -1340,767 +1641,772 @@ msgid "" "files can be built by specifying individual filenames.\n" msgstr "" -#: cmd/build.py:180 +#: cmd/build.py:100 msgid "path to documentation source files" msgstr "" -#: cmd/build.py:183 +#: cmd/build.py:103 msgid "path to output directory" msgstr "" -#: cmd/build.py:188 +#: cmd/build.py:109 msgid "" "(optional) a list of specific files to rebuild. Ignored if --write-all is " "specified" msgstr "" -#: cmd/build.py:194 +#: cmd/build.py:114 msgid "general options" msgstr "" -#: cmd/build.py:201 +#: cmd/build.py:121 msgid "builder to use (default: 'html')" msgstr "" -#: cmd/build.py:210 +#: cmd/build.py:131 msgid "" "run in parallel with N processes, when possible. 'auto' uses the number of " "CPU cores" msgstr "" -#: cmd/build.py:220 +#: cmd/build.py:140 msgid "write all files (default: only write new and changed files)" msgstr "" -#: cmd/build.py:227 +#: cmd/build.py:147 msgid "don't use a saved environment, always read all files" msgstr "" -#: cmd/build.py:230 +#: cmd/build.py:150 msgid "path options" msgstr "" -#: cmd/build.py:236 +#: cmd/build.py:157 msgid "" "directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: cmd/build.py:246 +#: cmd/build.py:166 msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: cmd/build.py:255 +#: cmd/build.py:175 msgid "use no configuration file, only use settings from -D options" msgstr "" -#: cmd/build.py:264 +#: cmd/build.py:184 msgid "override a setting in configuration file" msgstr "" -#: cmd/build.py:273 +#: cmd/build.py:193 msgid "pass a value into HTML templates" msgstr "" -#: cmd/build.py:282 +#: cmd/build.py:202 msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: cmd/build.py:289 +#: cmd/build.py:209 msgid "nitpicky mode: warn about all missing references" msgstr "" -#: cmd/build.py:292 +#: cmd/build.py:212 msgid "console output options" msgstr "" -#: cmd/build.py:299 +#: cmd/build.py:219 msgid "increase verbosity (can be repeated)" msgstr "" -#: cmd/build.py:306 ext/apidoc.py:413 +#: cmd/build.py:226 ext/apidoc/_cli.py:66 msgid "no output on stdout, just warnings on stderr" msgstr "" -#: cmd/build.py:313 +#: cmd/build.py:233 msgid "no output at all, not even warnings" msgstr "" -#: cmd/build.py:321 +#: cmd/build.py:241 msgid "do emit colored output (default: auto-detect)" msgstr "" -#: cmd/build.py:329 +#: cmd/build.py:249 msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: cmd/build.py:332 +#: cmd/build.py:252 msgid "warning control options" msgstr "" -#: cmd/build.py:338 +#: cmd/build.py:258 msgid "write warnings (and errors) to given file" msgstr "" -#: cmd/build.py:345 +#: cmd/build.py:265 msgid "turn warnings into errors" msgstr "" -#: cmd/build.py:353 +#: cmd/build.py:273 msgid "show full traceback on exception" msgstr "" -#: cmd/build.py:356 +#: cmd/build.py:276 msgid "run Pdb on exception" msgstr "" -#: cmd/build.py:362 +#: cmd/build.py:282 msgid "raise an exception on warnings" msgstr "" -#: cmd/build.py:405 +#: cmd/build.py:325 msgid "cannot combine -a option and filenames" msgstr "" -#: cmd/build.py:437 +#: cmd/build.py:357 #, python-format msgid "cannot open warning file '%s': %s" msgstr "" -#: cmd/build.py:456 +#: cmd/build.py:376 msgid "-D option argument must be in the form name=value" msgstr "" -#: cmd/build.py:463 +#: cmd/build.py:383 msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "" - -#: builders/linkcheck.py:75 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/linkcheck.py:146 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/linkcheck.py:540 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/linkcheck.py:742 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/singlehtml.py:37 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/singlehtml.py:173 -msgid "assembling single document" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/latex/__init__.py:346 builders/manpage.py:56 -#: builders/singlehtml.py:178 builders/texinfo.py:121 -msgid "writing" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/singlehtml.py:191 -msgid "writing additional files" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/manpage.py:39 -#, python-format -msgid "The manual pages are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/manpage.py:47 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/manpage.py:73 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/text.py:34 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/html/__init__.py:1239 builders/text.py:81 builders/xml.py:97 +#: cmd/quickstart.py:134 #, python-format -msgid "error writing file %s: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/xml.py:38 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/xml.py:110 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/texinfo.py:47 +#: cmd/quickstart.py:230 #, python-format -msgid "The Texinfo files are in %(outdir)s." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/texinfo.py:49 +#: cmd/quickstart.py:235 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "" - -#: builders/texinfo.py:78 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/texinfo.py:90 +#: cmd/quickstart.py:242 #, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +msgid "Selected root path: %s" msgstr "" -#: builders/latex/__init__.py:324 builders/texinfo.py:115 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/latex/__init__.py:404 builders/texinfo.py:174 -msgid "resolving references..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/latex/__init__.py:415 builders/texinfo.py:184 -msgid " (in " -msgstr "" - -#: builders/_epub_base.py:423 builders/html/__init__.py:778 -#: builders/latex/__init__.py:482 builders/texinfo.py:202 -msgid "copying images... " -msgstr "" - -#: builders/_epub_base.py:445 builders/latex/__init__.py:497 -#: builders/texinfo.py:219 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/texinfo.py:226 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/texinfo.py:234 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:230 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/__init__.py:383 builders/gettext.py:251 -#, python-format -msgid "building [%s]: " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/gettext.py:252 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/gettext.py:257 -msgid "reading templates... " +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/gettext.py:292 -msgid "writing message catalogs... " +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/__init__.py:212 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/__init__.py:220 -#, python-format -msgid "a suitable image for %s builder not found: %s" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/__init__.py:243 -msgid "building [mo]: " +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/__init__.py:246 builders/__init__.py:741 builders/__init__.py:773 -msgid "writing output... " +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/__init__.py:263 -#, python-format -msgid "all of %d po files" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: builders/__init__.py:285 -#, python-format -msgid "targets for %d po files that are specified" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are out of date" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: builders/__init__.py:307 -msgid "all source files" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: builders/__init__.py:319 -#, python-format -msgid "file %r given on command line does not exist, " +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/__init__.py:325 -#, python-format +#: cmd/quickstart.py:350 msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "" - -#: builders/__init__.py:336 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: builders/__init__.py:351 -#, python-format -msgid "%d source files given on command line" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: builders/__init__.py:366 +#: cmd/quickstart.py:368 #, python-format -msgid "targets for %d source files that are out of date" +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: builders/__init__.py:394 -msgid "looking for now-outdated files... " +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: builders/__init__.py:398 -#, python-format -msgid "%d found" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: builders/__init__.py:400 -msgid "none found" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: builders/__init__.py:407 -msgid "pickling environment" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: builders/__init__.py:414 -msgid "checking consistency" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: builders/__init__.py:418 -msgid "no targets are out of date." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: builders/__init__.py:458 -msgid "updating environment: " +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: builders/__init__.py:483 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Creating file %s." msgstr "" -#: builders/__init__.py:519 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "File %s already exists, skipping." msgstr "" -#: builders/__init__.py:528 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: builders/__init__.py:539 +#: cmd/quickstart.py:520 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: builders/__init__.py:546 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" - -#: builders/__init__.py:565 builders/__init__.py:581 -msgid "reading sources... " +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: builders/__init__.py:698 +#: cmd/quickstart.py:531 #, python-format -msgid "docnames to write: %s" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: builders/__init__.py:711 -msgid "preparing documents" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: builders/__init__.py:714 -msgid "copying assets" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: builders/__init__.py:866 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: builders/epub3.py:83 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: builders/epub3.py:220 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: builders/epub3.py:231 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: builders/epub3.py:255 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1289 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: builders/_epub_base.py:222 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: builders/_epub_base.py:434 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: builders/_epub_base.py:465 +#: cmd/quickstart.py:671 #, python-format -msgid "cannot write image file %r: %s" +msgid "enable %s extension" msgstr "" -#: builders/_epub_base.py:477 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: builders/_epub_base.py:512 -msgid "writing mimetype file..." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: builders/_epub_base.py:521 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: builders/_epub_base.py:590 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: builders/_epub_base.py:764 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: builders/_epub_base.py:793 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: builders/changes.py:33 -#, python-format -msgid "The overview file is in %(outdir)s." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: builders/changes.py:60 -#, python-format -msgid "no changes in version %s." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: builders/changes.py:62 -msgid "writing summary file..." +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: builders/changes.py:74 -msgid "Builtins" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: builders/changes.py:76 -msgid "Module level" -msgstr "Moduulitaso" - -#: builders/changes.py:128 -msgid "copying source files..." +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: builders/changes.py:137 +#: cmd/quickstart.py:810 #, python-format -msgid "could not read %r for changelog creation" +msgid "Invalid template variable: %s" msgstr "" -#: util/rst.py:72 +#: directives/other.py:119 #, python-format -msgid "default role %s not found" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/docfields.py:95 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/osutil.py:130 +#: directives/other.py:156 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/nodes.py:419 +#: directives/other.py:169 #, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/nodes.py:487 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Luvun kirjoittaja: " -#: util/nodes.py:701 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Moduulin kirjoittaja: " + +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: util/fileutil.py:74 -#, python-format +#: directives/other.py:209 +msgid "Author: " +msgstr "Tekijä: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: util/fileutil.py:89 +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "" + +#: directives/code.py:87 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Invalid caption: %s" msgstr "" -#: util/inventory.py:170 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: util/inventory.py:185 +#: directives/code.py:216 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: util/docutils.py:284 +#: directives/code.py:231 #, python-format -msgid "unknown directive or role name: %s:%s" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/docutils.py:747 +#: directives/code.py:235 #, python-format -msgid "unknown node type: %r" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: util/display.py:81 -msgid "skipped" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" msgstr "" -#: util/display.py:86 -msgid "failed" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: util/i18n.py:103 +#: directives/code.py:314 #, python-format -msgid "reading error: %s, %s" +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: util/i18n.py:110 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format -msgid "writing error: %s, %s" +msgid "%b %d, %Y" +msgstr "%d.%m.%Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Sisällysluettelo" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: util/i18n.py:138 +#: writers/texinfo.py:1303 #, python-format -msgid "locale_dir %s does not exist" +msgid "unimplemented node type: %r" msgstr "" -#: util/i18n.py:230 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +msgid "[image: %s]" msgstr "" -#: directives/patches.py:66 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: directives/code.py:87 +#: writers/html5.py:431 #, python-format -msgid "Invalid caption: %s" +msgid "numfig_format is not defined for %s" msgstr "" -#: directives/code.py:132 directives/code.py:297 directives/code.py:484 +#: writers/html5.py:441 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "Any IDs not assigned for %s node" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: directives/code.py:234 -#, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: directives/code.py:276 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "Object named %r not found in include file %r" +msgid "unsupported rubric heading level: %s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: directives/code.py:314 -#, python-format -msgid "Line spec %r: no lines pulled from include file %r" +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: directives/other.py:122 -#, python-format -msgid "toctree glob pattern %r didn't match any documents" +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: directives/other.py:155 environment/adapters/toctree.py:355 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: directives/other.py:158 environment/adapters/toctree.py:359 +#: writers/latex.py:386 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: directives/other.py:171 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "no Babel option known for language %r" msgstr "" -#: directives/other.py:204 -msgid "Section author: " -msgstr "Luvun kirjoittaja: " +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "" -#: directives/other.py:206 -msgid "Module author: " -msgstr "Moduulin kirjoittaja: " +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: directives/other.py:208 -msgid "Code author: " +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: directives/other.py:210 -msgid "Author: " -msgstr "Tekijä: " +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "" -#: directives/other.py:284 -msgid ".. acks content is not a list" +#: writers/latex.py:1228 +#, python-format +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: directives/other.py:309 -msgid ".. hlist content is not a list" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "" + +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" #: _cli/__init__.py:73 @@ -2108,6 +2414,7 @@ msgid "Usage:" msgstr "" #: _cli/__init__.py:75 +#, python-brace-format msgid "{0} [OPTIONS] []" msgstr "" @@ -2123,1992 +2430,1876 @@ msgstr "" msgid "Options" msgstr "" -#: _cli/__init__.py:112 _cli/__init__.py:183 +#: _cli/__init__.py:113 _cli/__init__.py:181 msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: _cli/__init__.py:172 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" "{0}: error: {1}\n" "Run '{0} --help' for information" msgstr "" -#: _cli/__init__.py:182 +#: _cli/__init__.py:179 msgid " Manage documentation with Sphinx." msgstr "" -#: _cli/__init__.py:194 +#: _cli/__init__.py:191 msgid "Show the version and exit." msgstr "" -#: _cli/__init__.py:202 +#: _cli/__init__.py:199 msgid "Show this message and exit." msgstr "" -#: _cli/__init__.py:206 +#: _cli/__init__.py:203 msgid "Logging" msgstr "" -#: _cli/__init__.py:213 +#: _cli/__init__.py:210 msgid "Increase verbosity (can be repeated)" msgstr "" -#: _cli/__init__.py:221 +#: _cli/__init__.py:218 msgid "Only print errors and warnings." msgstr "" -#: _cli/__init__.py:228 +#: _cli/__init__.py:225 msgid "No output at all" msgstr "" -#: _cli/__init__.py:234 +#: _cli/__init__.py:231 msgid "" msgstr "" -#: _cli/__init__.py:265 +#: _cli/__init__.py:263 msgid "See 'sphinx --help'.\n" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:198 -#: transforms/__init__.py:133 writers/manpage.py:102 writers/texinfo.py:219 -#, python-format -msgid "%b %d, %Y" -msgstr "%d.%m.%Y" - -#: transforms/__init__.py:143 -msgid "could not calculate translation progress!" -msgstr "" - -#: transforms/__init__.py:148 -msgid "no translated elements!" -msgstr "" - -#: transforms/__init__.py:267 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "" - -#: transforms/__init__.py:313 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" - -#: transforms/__init__.py:322 -msgid "Footnote [*] is not referenced." -msgstr "" - -#: transforms/__init__.py:333 -msgid "Footnote [#] is not referenced." -msgstr "" - -#: transforms/i18n.py:228 transforms/i18n.py:303 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: transforms/i18n.py:273 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" -#: transforms/i18n.py:323 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: transforms/i18n.py:345 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: ext/linkcode.py:75 ext/viewcode.py:201 -msgid "[source]" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: ext/imgconverter.py:40 -#, python-format -msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: ext/imgconverter.py:49 ext/imgconverter.py:73 +#: transforms/__init__.py:258 #, python-format msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: ext/imgconverter.py:68 +#: transforms/__init__.py:299 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "" - -#: ext/viewcode.py:258 -msgid "highlighting module code... " +msgid "Footnote [%s] is not referenced." msgstr "" -#: ext/viewcode.py:286 -msgid "[docs]" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: ext/viewcode.py:306 -msgid "Module code" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: ext/viewcode.py:312 +#: util/inventory.py:147 #, python-format -msgid "

        Source code for %s

        " +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: ext/viewcode.py:338 -msgid "Overview: module code" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: ext/viewcode.py:339 -msgid "

        All modules for which code is available

        " +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: ext/coverage.py:47 +#: util/i18n.py:113 #, python-format -msgid "invalid regex %r in %s" +msgid "writing error: %s, %s" msgstr "" -#: ext/coverage.py:134 ext/coverage.py:280 +#: util/i18n.py:146 #, python-format -msgid "module %s could not be imported: %s" +msgid "locale_dir %s does not exist" msgstr "" -#: ext/coverage.py:141 +#: util/i18n.py:244 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: ext/coverage.py:149 +#: util/i18n.py:253 +#, python-format msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: ext/coverage.py:163 +#: util/osutil.py:131 #, python-format msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: ext/coverage.py:177 -#, python-format -msgid "invalid regex %r in coverage_c_regexes" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: ext/coverage.py:245 -#, python-format -msgid "undocumented c api: %s [%s] in file %s" +#: util/display.py:87 +msgid "failed" msgstr "" -#: ext/coverage.py:429 +#: util/docutils.py:325 #, python-format -msgid "undocumented python function: %s :: %s" +msgid "unknown directive name: %s" msgstr "" -#: ext/coverage.py:445 +#: util/docutils.py:361 #, python-format -msgid "undocumented python class: %s :: %s" +msgid "unknown role name: %s" msgstr "" -#: ext/coverage.py:458 +#: util/docutils.py:805 #, python-format -msgid "undocumented python method: %s :: %s :: %s" +msgid "unknown node type: %r" msgstr "" -#: ext/todo.py:71 -msgid "Todo" -msgstr "Tehtävä vielä" - -#: ext/todo.py:104 +#: util/fileutil.py:76 #, python-format -msgid "TODO entry found: %s" +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: ext/todo.py:163 -msgid "<>" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: ext/todo.py:165 +#: util/docfields.py:103 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: ext/todo.py:175 -msgid "original entry" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: ext/extlinks.py:82 +#: util/nodes.py:462 #, python-format msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: ext/doctest.py:115 +#: util/nodes.py:523 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: ext/doctest.py:120 +#: util/nodes.py:739 #, python-format -msgid "'%s' is not a valid option." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: ext/doctest.py:134 -#, python-format -msgid "'%s' is not a valid pyversion option" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: ext/doctest.py:220 -msgid "invalid TestCode type" -msgstr "" - -#: ext/doctest.py:281 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: ext/doctest.py:434 -#, python-format -msgid "no code/output in %s block at %s:%s" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: ext/doctest.py:522 -#, python-format -msgid "ignoring invalid doctest code: %r" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: ext/graphviz.py:145 -#, python-format -msgid "External Graphviz file %r not found or reading it failed" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: ext/graphviz.py:268 +#: transforms/post_transforms/images.py:79 #, python-format -msgid "graphviz_dot executable path must be set! %r" +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: ext/graphviz.py:303 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: ext/graphviz.py:310 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +msgid "Unknown image format: %s..." msgstr "" -#: ext/graphviz.py:313 -#, python-format +#: transforms/post_transforms/__init__.py:88 msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: ext/graphviz.py:329 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: ext/graphviz.py:333 ext/graphviz.py:386 ext/graphviz.py:423 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "dot code %r: %s" +msgid "%s:%s reference target not found: %s" msgstr "" -#: ext/graphviz.py:436 ext/graphviz.py:444 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "[graph: %s]" -msgstr "" - -#: ext/graphviz.py:438 ext/graphviz.py:446 -msgid "[graph]" +msgid "%r reference target not found: %s" msgstr "" -#: ext/imgmath.py:369 ext/mathjax.py:52 -msgid "Link to this equation" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: ext/apidoc.py:85 -#, python-format -msgid "Would create file %s." +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: ext/apidoc.py:375 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: ext/apidoc.py:392 -msgid "path to module to document" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: ext/apidoc.py:396 +#: _cli/util/errors.py:207 msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: ext/apidoc.py:407 -msgid "directory to place all output" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: ext/apidoc.py:422 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: ext/apidoc.py:429 -msgid "overwrite existing files" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: ext/apidoc.py:437 +#: _cli/util/errors.py:246 msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: ext/apidoc.py:446 -msgid "run the script without creating files" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: ext/apidoc.py:453 -msgid "put documentation for each module on its own page" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navikointi" -#: ext/apidoc.py:460 -msgid "include \"_private\" modules" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" msgstr "" -#: ext/apidoc.py:467 -msgid "filename of table of contents (default: modules)" -msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Tietoja tästä documentistä" -#: ext/apidoc.py:474 -msgid "don't create a table of contents file" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Etsi" + +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: ext/apidoc.py:481 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: ext/apidoc.py:492 -msgid "put module documentation before submodule documentation" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." msgstr "" -#: ext/apidoc.py:498 +#: themes/basic/layout.html:204 +#, python-format msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: ext/apidoc.py:508 -msgid "file suffix (default: rst)" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "<<" -#: ext/apidoc.py:515 ext/autosummary/generate.py:839 -msgid "Remove existing files in the output directory that were not generated" -msgstr "" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "<<" -#: ext/apidoc.py:524 -msgid "generate a full project with sphinx-quickstart" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr ">>" -#: ext/apidoc.py:531 -msgid "append module_path to sys.path, used when --full is given" -msgstr "" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr ">>" -#: ext/apidoc.py:538 -msgid "project name (default: root module name)" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" msgstr "" -#: ext/apidoc.py:545 -msgid "project author(s), used when --full is given" -msgstr "" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Hakemisto yhtenä luettelona" -#: ext/apidoc.py:552 -msgid "project version, used when --full is given" -msgstr "" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Tämä sivu" -#: ext/apidoc.py:559 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "Näytä lähdekoodina" -#: ext/apidoc.py:564 -msgid "extension options" -msgstr "" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Pikahaku" -#: ext/apidoc.py:638 -#, python-format -msgid "%s is not a directory." -msgstr "" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Siirry" -#: ext/apidoc.py:710 ext/autosummary/generate.py:875 -#, python-format -msgid "Failed to remove %s: %s" -msgstr "" +#: themes/basic/defindex.html:4 +msgid "Overview" +msgstr "Yhteenveto" -#: ext/autosectionlabel.py:48 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" msgstr "" -#: domains/std/__init__.py:703 domains/std/__init__.py:812 -#: ext/autosectionlabel.py:52 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: themes/basic/defindex.html:9 +msgid "the documentation for" msgstr "" -#: ext/duration.py:85 -msgid "" -"====================== slowest reading durations =======================" +#: themes/basic/defindex.html:10 +msgid "last updated" msgstr "" -#: ext/imgmath.py:159 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" msgstr "" -#: ext/imgmath.py:174 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" msgstr "" -#: ext/imgmath.py:328 -#, python-format -msgid "display latex %r: %s" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" msgstr "" -#: ext/imgmath.py:362 -#, python-format -msgid "inline latex %r: %s" -msgstr "" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "Etsi sivu" -#: writers/latex.py:1090 writers/manpage.py:263 writers/texinfo.py:662 -msgid "Footnotes" +#: themes/basic/defindex.html:19 +msgid "search this documentation" msgstr "" -#: writers/manpage.py:309 writers/text.py:936 -#, python-format -msgid "[image: %s]" -msgstr "" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "Yleinen moduulien sisällysluettelo" -#: writers/manpage.py:310 writers/text.py:937 -msgid "[image]" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" msgstr "" -#: writers/html5.py:99 writers/html5.py:108 -msgid "Link to this definition" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Yleinen sisällysluettelo" + +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" msgstr "" -#: writers/html5.py:415 -#, python-format -msgid "numfig_format is not defined for %s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: writers/html5.py:427 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Any IDs not assigned for %s node" +msgid "Search %(docstitle)s" msgstr "" -#: writers/html5.py:482 -msgid "Link to this term" -msgstr "" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Hakemisto aakkostus sivuttain" -#: writers/html5.py:525 writers/html5.py:530 -msgid "Link to this heading" -msgstr "" +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "voi olla iso" -#: writers/html5.py:535 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:549 writers/latex.py:1099 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" - -#: writers/html5.py:613 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:615 -msgid "Link to this image" -msgstr "" - -#: writers/html5.py:617 -msgid "Link to this toctree" -msgstr "" - -#: writers/html5.py:758 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "" - -#: builders/latex/__init__.py:205 domains/std/__init__.py:646 -#: domains/std/__init__.py:658 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:513 -msgid "Index" -msgstr "Sisällysluettelo" - -#: writers/latex.py:743 writers/texinfo.py:644 +#: themes/basic/search.html:20 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" - -#: writers/texinfo.py:1216 -msgid "caption not inside a figure." -msgstr "" - -#: writers/texinfo.py:1302 -#, python-format -msgid "unimplemented node type: %r" -msgstr "" - -#: writers/latex.py:360 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" +"Please activate JavaScript to enable the search\n" +" functionality." +msgstr "Javascript pitää olla sallittu, jotta etsintä toimii." -#: builders/latex/__init__.py:223 writers/latex.py:410 -#, python-format -msgid "no Babel option known for language %r" +#: themes/basic/search.html:28 +msgid "" +"Searching for multiple words only shows matches that contain\n" +" all words." msgstr "" -#: writers/latex.py:428 -msgid "too large :maxdepth:, ignored." -msgstr "" +#: themes/basic/search.html:35 +msgid "search" +msgstr "etsi" -#: writers/latex.py:590 -#, python-format -msgid "template %s not found; loading from legacy %s instead" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: writers/latex.py:708 -msgid "document title is not a single Text node" -msgstr "" +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "Etsinnän tulos" -#: writers/latex.py:1175 +#: themes/basic/static/searchtools.js:134 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1573 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." msgstr "" -#: writers/latex.py:1931 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" -#: domains/std/__init__.py:87 domains/std/__init__.py:104 -#, python-format -msgid "environment variable; %s" +#: themes/basic/static/searchtools.js:276 +msgid "Searching" msgstr "" -#: domains/std/__init__.py:112 -#, python-format -msgid "%s; configuration value" +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." msgstr "" -#: domains/std/__init__.py:166 -msgid "Type" +#: themes/basic/static/searchtools.js:526 +msgid ", in " msgstr "" -#: domains/std/__init__.py:176 -msgid "Default" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Piilota löydetyt" -#: domains/std/__init__.py:235 +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 #, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" +msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" -#: domains/std/__init__.py:306 +#: themes/basic/changes/rstsource.html:5 #, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:308 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:430 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:438 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:444 domains/std/__init__.py:457 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:602 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:603 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:604 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:607 -msgid "environment variable" +msgid "%(filename)s — %(docstitle)s" msgstr "" -#: domains/std/__init__.py:608 -msgid "program option" -msgstr "" +#: themes/basic/changes/versionchanges.html:17 +#, python-format +msgid "Automatically generated list of changes in version %(version)s" +msgstr "Automaattisesti luotu muutoshistoria alkaen versiosta %(version)s" -#: domains/std/__init__.py:609 -msgid "document" +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" msgstr "" -#: domains/std/__init__.py:647 domains/std/__init__.py:659 -msgid "Module Index" -msgstr "Moduuli sisällysluettelo" - -#: domains/std/__init__.py:648 domains/std/__init__.py:660 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "Etsi sivu" - -#: domains/std/__init__.py:722 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" msgstr "" -#: domains/std/__init__.py:932 -msgid "numfig is disabled. :numref: is ignored." +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" msgstr "" -#: domains/std/__init__.py:940 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" msgstr "" -#: domains/std/__init__.py:952 -#, python-format -msgid "the link has no caption: %s" +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/std/__init__.py:966 -#, python-format -msgid "invalid numfig_format: %s (%r)" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/std/__init__.py:969 -#, python-format -msgid "invalid numfig_format: %s" +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" msgstr "" -#: domains/std/__init__.py:1200 -#, python-format -msgid "undefined label: %r" +#: domains/python/_object.py:206 +msgid "Variables" msgstr "" -#: domains/std/__init__.py:1202 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" +#: domains/python/_object.py:214 +msgid "Raises" msgstr "" -#: domains/python/__init__.py:107 domains/python/__init__.py:244 +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:167 domains/python/__init__.py:334 -#: domains/python/__init__.py:385 domains/python/__init__.py:424 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:169 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:194 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:195 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:249 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:251 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:389 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:428 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:559 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:560 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moduulit" -#: domains/python/__init__.py:637 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Poistettu" -#: domains/python/__init__.py:663 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:665 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:666 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:668 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:669 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:729 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:858 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:920 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (poistettu)" -#: domains/c/__init__.py:304 domains/cpp/__init__.py:441 -#: domains/python/_object.py:164 ext/napoleon/docstring.py:786 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:169 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:173 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" -#: domains/c/__init__.py:199 -#, python-format -msgid "%s (C %s)" +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" msgstr "" -#: domains/c/__init__.py:260 domains/c/_symbol.py:510 +#: domains/cpp/__init__.py:302 #, python-format -msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." +msgid "%s (C++ %s)" msgstr "" -#: domains/c/__init__.py:307 domains/cpp/__init__.py:454 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:679 domains/cpp/__init__.py:860 -msgid "member" -msgstr "" - -#: domains/c/__init__.py:680 -msgid "variable" +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" msgstr "" -#: domains/c/__init__.py:682 -msgid "macro" +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" msgstr "" -#: domains/c/__init__.py:683 -msgid "struct" +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" msgstr "" -#: domains/c/__init__.py:684 domains/cpp/__init__.py:858 -msgid "union" +#: domains/cpp/__init__.py:946 +msgid "concept" msgstr "" -#: domains/c/__init__.py:685 domains/cpp/__init__.py:863 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:686 domains/cpp/__init__.py:864 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:687 domains/cpp/__init__.py:861 -msgid "type" -msgstr "" - -#: domains/c/__init__.py:689 domains/cpp/__init__.py:866 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:155 -msgid "Template Parameters" +#: domains/cpp/__init__.py:954 +msgid "template parameter" msgstr "" -#: domains/cpp/__init__.py:277 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format -msgid "%s (C++ %s)" +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/cpp/__init__.py:360 domains/cpp/_symbol.py:793 +#: domains/c/__init__.py:211 #, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." +msgid "%s (C %s)" msgstr "" -#: domains/cpp/__init__.py:862 -msgid "concept" +#: domains/c/__init__.py:778 +msgid "variable" msgstr "" -#: domains/cpp/__init__.py:867 -msgid "template parameter" +#: domains/c/__init__.py:780 +msgid "macro" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Etsi" - -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Siirry" +#: domains/std/__init__.py:116 +#, python-format +msgid "%s; configuration value" +msgstr "" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "Näytä lähdekoodina" +#: domains/std/__init__.py:172 +msgid "Type" +msgstr "" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navikointi" +#: domains/std/__init__.py:239 +#, python-format +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" +msgstr "" -#: themes/basic/layout.html:115 +#: domains/std/__init__.py:319 #, python-format -msgid "Search within %(docstitle)s" +msgid "%s command line option" msgstr "" -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Tietoja tästä documentistä" +#: domains/std/__init__.py:321 +msgid "command line option" +msgstr "" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Hakemisto yhtenä luettelona" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "" -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Hakemisto aakkostus sivuttain" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "" -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "voi olla iso" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Tämä sivu" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Moduuli sisällysluettelo" -#: themes/basic/defindex.html:4 -msgid "Overview" -msgstr "Yhteenveto" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" +msgstr "" -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: themes/basic/defindex.html:9 -msgid "the documentation for" +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: themes/basic/defindex.html:10 -msgid "last updated" +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" +#: domains/std/__init__.py:1153 +#, python-format +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" msgstr "" -#: themes/basic/defindex.html:19 -msgid "search this documentation" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "Yleinen moduulien sisällysluettelo" +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" +msgstr "" -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Yleinen sisällysluettelo" +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" +msgstr "" -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Pikahaku" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "" -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." -msgstr "Javascript pitää olla sallittu, jotta etsintä toimii." +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "" -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: themes/basic/search.html:35 -msgid "search" -msgstr "etsi" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "<<" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "<<" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr ">>" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr ">>" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "" -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" +msgid "A mocked object is detected: %r" msgstr "" -#: themes/basic/changes/versionchanges.html:17 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Automaattisesti luotu muutoshistoria alkaen versiosta %(version)s" - -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" +msgid "alias of %s" msgstr "" -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" msgstr "" -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" msgstr "" -#: themes/basic/changes/rstsource.html:5 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "%(filename)s — %(docstitle)s" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Piilota löydetyt" - -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" -msgstr "Etsinnän tulos" - -#: themes/basic/static/searchtools.js:119 -msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" msgstr "" -#: themes/basic/static/searchtools.js:123 -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" - -#: themes/basic/static/searchtools.js:253 -msgid "Searching" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: themes/basic/static/searchtools.js:474 -msgid ", in " +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: environment/collectors/asset.py:96 -#, python-format -msgid "image file not readable: %s" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: environment/collectors/asset.py:124 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "image file %s not readable: %s" +msgid "Failed to remove %s: %s" msgstr "" -#: environment/collectors/asset.py:161 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "download file not readable: %s" +msgid "Would create file %s." msgstr "" -#: environment/collectors/toctree.py:258 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: environment/adapters/toctree.py:318 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: environment/adapters/toctree.py:342 -#, python-format +#: ext/apidoc/_cli.py:50 msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: environment/adapters/toctree.py:357 -#, python-format -msgid "toctree contains reference to non-included document %r" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: environment/adapters/indexentries.py:126 -#, python-format -msgid "see %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: environment/adapters/indexentries.py:136 -#, python-format -msgid "see also %s" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: environment/adapters/indexentries.py:144 -#, python-format -msgid "unknown index entry type %r" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: environment/adapters/indexentries.py:270 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:363 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:382 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "hakemisto" - -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr ">" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "<" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" -#: builders/html/__init__.py:695 -msgid "generating indices" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/__init__.py:710 -msgid "writing additional pages" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/html/__init__.py:793 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/html/__init__.py:805 -msgid "copying downloadable files... " +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/html/__init__.py:817 -#, python-format -msgid "cannot copy downloadable file %r: %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/html/__init__.py:863 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: builders/html/__init__.py:881 -#, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: builders/html/__init__.py:916 -msgid "copying static files" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/html/__init__.py:933 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "cannot copy static file %r" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/html/__init__.py:938 -msgid "copying extra files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/html/__init__.py:948 -#, python-format -msgid "cannot copy extra file %r" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/__init__.py:954 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Failed to write build info file: %r" +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/__init__.py:1003 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:1051 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/__init__.py:1213 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/__init__.py:1222 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/__init__.py:1255 -msgid "dumping object inventory" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:1263 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "dumping search index in %s" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/__init__.py:1306 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "invalid js_file: %r, ignored" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/html/__init__.py:1339 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: builders/html/__init__.py:1344 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "Unknown math_renderer %r is given." +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/html/__init__.py:1358 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/html/__init__.py:1363 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: builders/html/__init__.py:1378 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: builders/html/__init__.py:1383 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1394 builders/latex/__init__.py:504 +#: ext/autosummary/generate.py:630 #, python-format -msgid "logo file %r does not exist" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: builders/html/__init__.py:1405 +#: ext/autosummary/generate.py:634 #, python-format -msgid "favicon file %r does not exist" +msgid "[autosummary] writing to %s" msgstr "" -#: builders/html/__init__.py:1417 +#: ext/autosummary/generate.py:679 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1430 +#: ext/autosummary/generate.py:877 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: builders/html/__init__.py:1447 -#, python-format -msgid "%s %s documentation" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: builders/latex/transforms.py:118 -msgid "Failed to get a docname!" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: builders/latex/transforms.py:119 +#: ext/autosummary/generate.py:915 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: builders/latex/transforms.py:485 +#: ext/autosummary/generate.py:923 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "custom template directory (default: %(default)s)" msgstr "" -#: builders/latex/__init__.py:117 +#: ext/autosummary/generate.py:931 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "document imported members (default: %(default)s)" msgstr "" -#: builders/latex/__init__.py:119 +#: ext/autosummary/generate.py:940 +#, python-format msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: builders/latex/__init__.py:157 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: builders/latex/__init__.py:169 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: builders/latex/__init__.py:208 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: builders/latex/__init__.py:429 -msgid "copying TeX support files" +#: ext/autosummary/__init__.py:329 +#, python-format +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/latex/__init__.py:466 -msgid "copying additional files" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: builders/latex/__init__.py:540 +#: ext/autosummary/__init__.py:652 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: builders/latex/__init__.py:548 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "autosummary_generate: file not found: %s" msgstr "" -#: builders/latex/theming.py:87 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: builders/latex/theming.py:90 +#: ext/intersphinx/_load.py:61 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: _cli/util/errors.py:124 -msgid "Exception occurred, starting debugger:" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: _cli/util/errors.py:133 -msgid "reStructuredText markup error:" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: _cli/util/errors.py:168 -msgid "The full traceback has been saved in:" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: _cli/util/errors.py:172 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: transforms/post_transforms/__init__.py:125 +#: ext/intersphinx/_load.py:122 +#, python-format msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: transforms/post_transforms/__init__.py:185 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: transforms/post_transforms/__init__.py:251 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" + +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: transforms/post_transforms/__init__.py:257 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "%r reference target not found: %s" +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: transforms/post_transforms/images.py:77 +#: ext/intersphinx/_load.py:332 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: transforms/post_transforms/images.py:94 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: transforms/post_transforms/images.py:141 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Unknown image format: %s..." +msgid "(in %s %s)" msgstr "" -#: ext/napoleon/docstring.py:707 -msgid "Example" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/napoleon/docstring.py:708 -msgid "Examples" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/napoleon/__init__.py:344 ext/napoleon/docstring.py:752 -msgid "Keyword Arguments" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/napoleon/docstring.py:768 -msgid "Notes" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:777 -msgid "Other Parameters" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/napoleon/docstring.py:813 -msgid "Receives" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:817 -msgid "References" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/napoleon/docstring.py:849 -msgid "Warns" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:853 -msgid "Yields" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/napoleon/docstring.py:1015 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1022 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/napoleon/docstring.py:1029 +#: ext/autodoc/_dynamic/_type_comments.py:123 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/napoleon/docstring.py:1036 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/autosummary/__init__.py:256 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:258 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:277 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:330 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:344 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "failed to parse name %s" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/autosummary/__init__.py:349 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "failed to import object %s" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/autosummary/__init__.py:648 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format msgid "" -"Summarised items should not include the current module. Replace %r with %r." +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/autosummary/__init__.py:819 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/autosummary/__init__.py:827 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/autosummary/generate.py:215 ext/autosummary/generate.py:391 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/autosummary/generate.py:526 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/autosummary/generate.py:530 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "[autosummary] writing to %s" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/autosummary/generate.py:572 -#, python-format -msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/autosummary/generate.py:767 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/autosummary/generate.py:789 -msgid "source files to generate rST files for" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/autosummary/generate.py:797 -msgid "directory to place all output in" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/autosummary/generate.py:805 +#: builders/html/__init__.py:337 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Failed to read build info file: %r" msgstr "" -#: ext/autosummary/generate.py:813 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/autosummary/generate.py:821 -#, python-format -msgid "document imported members (default: %(default)s)" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/autosummary/generate.py:829 +#: builders/html/__init__.py:372 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:47 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "hakemisto" + +#: builders/html/__init__.py:549 #, python-format -msgid "(in %s v%s)" +msgid "Logo of %s" msgstr "" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:578 +msgid "next" +msgstr ">" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "<" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/intersphinx/_resolve.py:103 -#, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:113 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:359 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:367 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:378 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "" + +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:585 +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:59 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:70 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:81 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:92 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:101 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:120 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:155 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:240 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:265 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:275 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:319 +#: builders/html/__init__.py:1365 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/type_comment.py:132 +#: builders/html/__init__.py:1370 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/type_comment.py:135 +#: builders/html/__init__.py:1385 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:142 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:415 +#: builders/html/__init__.py:1412 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:532 +#: builders/html/__init__.py:1425 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:807 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:902 +#: builders/html/__init__.py:1454 #, python-format -msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +msgid "%s %s documentation" msgstr "" -#: ext/autodoc/__init__.py:946 +#: builders/latex/theming.py:87 #, python-format -msgid "A mocked object is detected: %r" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:965 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1028 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1035 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1048 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1114 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "" + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1337 ext/autodoc/__init__.py:1414 -#: ext/autodoc/__init__.py:2829 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1633 +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1760 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1774 +#: environment/collectors/toctree.py:259 #, python-format -msgid "missing attribute %s in object %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1855 ext/autodoc/__init__.py:1892 -#: ext/autodoc/__init__.py:1987 +#: environment/collectors/asset.py:98 #, python-format -msgid "alias of %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1875 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of TypeVar(%s)" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2217 ext/autodoc/__init__.py:2317 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2448 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/preserve_defaults.py:190 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/fr/LC_MESSAGES/sphinx.mo b/sphinx/locale/fr/LC_MESSAGES/sphinx.mo index 3bf81a9c898..b6356cecaea 100644 Binary files a/sphinx/locale/fr/LC_MESSAGES/sphinx.mo and b/sphinx/locale/fr/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/fr/LC_MESSAGES/sphinx.po b/sphinx/locale/fr/LC_MESSAGES/sphinx.po index 896a1190ce1..b30bba597dd 100644 --- a/sphinx/locale/fr/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/fr/LC_MESSAGES/sphinx.po @@ -1,5 +1,5 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: @@ -10,7 +10,7 @@ # cyrille gachot , 2019 # David Georges, 2021 # Larlet David , 2008 -# Denis Bitouzé , 2020-2024 +# Denis Bitouzé , 2020-2025 # fgallaire , 2010 # fgallaire , 2010 # François Poirotte , 2016-2017,2020 @@ -35,153 +35,300 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-29 22:39+0000\n" +"POT-Creation-Date: 2025-12-04 06:45+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" -"Last-Translator: Denis Bitouzé , 2020-2024\n" +"Last-Translator: Denis Bitouzé , 2020-2025\n" "Language-Team: French (http://app.transifex.com/sphinx-doc/sphinx-1/language/fr/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" "Language: fr\n" "Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n" -#: events.py:77 +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "Vulnérabilités et expositions communes ; CVE %s" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "numéro CVE non valide %s" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "Énumération des faiblesses communes ; CWE %s" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "numéro de CWE non valide %s" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "numéro PEP %s non valide" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "numéro RFC %snon valide" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "Les sections de configuration autres que [theme] et [options] ne sont pas acceptées (on a essayé d'obtenir une valeur à partir de %r)." + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "le paramètre %s.%s n'apparaît dans aucune des configurations de thème recherchées" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "l'option %r n'est pas supportée pour ce thème" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "le fichier %r dans le dossier des thèmes n'est pas une archive zip valide ou ne contient aucun thème" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "aucun thème nommé %r trouvé (theme.toml manquant ?)" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "Le thème %r a un héritage circulaire" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "Le thème %r hérite de %r, qui n'est pas un thème chargé. Les thèmes chargés sont : %s" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "Le thème %r a trop d'ancêtres" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "aucun fichier de configuration de thème n'a été trouvé dans %r" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "Le thème %r n'a pas la table « thème »" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "La table thème « [theme] » %r n'est pas une table" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "Le thème %r doit définir la clé \"theme.inherit\" dans les paramètres" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "La table thème « [options » %r n'est pas une table" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "Le paramètre « theme.pygments_style » doit être une table. Conseil : « %s »" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "plusieurs fichiers trouvés pour le document « %s » : %s\nUtilisez %r pour la compilation." + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "Document illisible %r ignoré." + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "L'extension %s est exigée par le paramètre needs_extensions, mais n'est pas chargée." + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "Ce projet nécessite que l'extension %s soit au minimum en version %s et par conséquent il ne peut pas être construit avec la version chargée (%s)." + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Le nom du l'analyseur Pygments %r est inconnu" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "Le lexème du bloc_littéral %r en tant que \"%s\" a entraîné une erreur au niveau du jeton : %r. Réessayer en mode relaxé." + +#: events.py:92 #, python-format msgid "Event %r already present" msgstr "Évènement %r déjà présent" -#: events.py:370 +#: events.py:386 #, python-format msgid "Unknown event name: %s" msgstr "Nom d'évènement inconnu : %s" -#: events.py:416 +#: events.py:451 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "Le gestionnaire %r de l'évènement %r a créé une exception." -#: application.py:190 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Impossible de trouver le répertoire source (%s)" -#: application.py:194 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Le répertoire de sortie (%s) n'est pas un répertoire" -#: application.py:198 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Les dossiers source et destination ne doivent pas être identiques" -#: application.py:228 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx v%s en cours d'exécution" -#: application.py:250 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Ce projet nécessite au minimum Sphinx v%s et ne peut donc être construit avec cette version." -#: application.py:266 +#: application.py:305 msgid "making output directory" msgstr "création du répertoire de sortie" -#: application.py:271 registry.py:452 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "lors de l'initialisation de l'extension %s :" -#: application.py:277 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' tel que défini dans conf.py n'est pas un objet Python appelable. Veuillez modifier sa définition pour en faire une fonction appelable. Ceci est nécessaire pour que conf.py se comporte comme une extension Sphinx." -#: application.py:312 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "chargement des traductions [%s]... " -#: application.py:329 util/display.py:88 +#: application.py:384 util/display.py:89 msgid "done" msgstr "fait" -#: application.py:331 +#: application.py:386 msgid "not available for built-in messages" msgstr "traductions indisponibles" -#: application.py:345 +#: application.py:400 msgid "loading pickled environment" msgstr "chargement de l'environnement pickled" -#: application.py:353 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "échec : %s" -#: application.py:366 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Aucun constructeur sélectionné, utilisation du défaut : html" -#: application.py:398 +#: application.py:455 msgid "build finished with problems." msgstr "La compilation s'est terminée avec des problèmes." -#: application.py:400 +#: application.py:457 msgid "build succeeded." msgstr "La compilation a réussi." -#: application.py:404 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "La compilation s'est terminée avec des problèmes, 1 avertissement (avec les avertissements considérés comme des erreurs)." -#: application.py:407 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "La compilation s'est terminée avec des problèmes, 1 avertissement." -#: application.py:409 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "La compilation a réussi, 1 avertissement." -#: application.py:414 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "La compilation s'est terminée avec des problèmes, %s avertissements (avec les avertissements considérés comme des erreurs)." -#: application.py:417 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "La compilation s'est terminée avec des problèmes, %s avertissements." -#: application.py:419 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "La compilation a réussi, %s avertissements." -#: application.py:968 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "la classe de nœud %r est déjà enregistrée, ses visiteurs seront écrasés" -#: application.py:1047 +#: application.py:1113 #, python-format -msgid "directive %r is already registered, it will be overridden" -msgstr "la directive %r est déjà enregistrée, elle sera écrasée" +msgid "directive %r is already registered and will not be overridden" +msgstr "la directive %r est déjà enregistrée et ne sera pas remplacé." -#: application.py:1069 application.py:1094 +#: application.py:1139 application.py:1167 #, python-format -msgid "role %r is already registered, it will be overridden" -msgstr "le rôle %r est déjà enregistré, il sera écrasé" +msgid "role %r is already registered and will not be overridden" +msgstr "le rôle %r est déjà enregistré et ne sera pas remplacé." -#: application.py:1644 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -189,12 +336,12 @@ msgid "" "explicit" msgstr "l’extension %s ne se déclare pas compatible à la lecture en parallèle, on supposera qu’elle ne l'est pas - merci de demander à l'auteur de l’extension de vérifier ce qu’il en est et de le préciser explicitement" -#: application.py:1648 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "l'extension %s n'est pas compatible avec les lectures parallèles" -#: application.py:1651 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -202,645 +349,357 @@ msgid "" "explicit" msgstr "l’extension %s ne se déclare pas compatible à l’écriture en parallèle, on supposera qu’elle ne l’est pas - merci de demander à l'auteur de l’extension de vérifier ce qu’il en est et de le préciser explicitement" -#: application.py:1655 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "l'extension %s n'est pas compatible avec les écritures parallèles" -#: application.py:1663 application.py:1667 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "sérialisation en cours %s" -#: roles.py:208 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "Vulnérabilités et expositions communes ; CVE %s" - -#: roles.py:231 -#, python-format -msgid "invalid CVE number %s" -msgstr "numéro CVE non valide %s" - -#: roles.py:253 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "Énumération des faiblesses communes ; CWE %s" - -#: roles.py:276 -#, python-format -msgid "invalid CWE number %s" -msgstr "numéro de CWE non valide %s" - -#: roles.py:296 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:319 -#, python-format -msgid "invalid PEP number %s" -msgstr "numéro PEP %s non valide" - -#: roles.py:357 -#, python-format -msgid "invalid RFC number %s" -msgstr "numéro RFC %snon valide" - -#: registry.py:144 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "La classe Builder %s n'a pas d'attribut « name »" -#: registry.py:146 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Le constructeur %r existe déjà (dans le module %s)" -#: registry.py:159 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Le nom de Constructeur %s n'est ni enregistré ni accessible par point d'entrée" -#: registry.py:166 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "Constructeur %s non enregistré" -#: registry.py:173 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "le domaine %s a déjà été enregistré" -#: registry.py:196 registry.py:209 registry.py:220 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "le domaine %s n'a pas encore été enregistré" -#: registry.py:200 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "La directive %r est déjà enregistrée sur le domaine %s" -#: registry.py:212 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "Le rôle %r est déjà enregistré sur le domaine %s" -#: registry.py:223 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "L'index %r est déjà enregistré sur le domaine %s" -#: registry.py:254 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "Le type de l'objet %r est déjà enregistré" -#: registry.py:280 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "Le type %r crossref_type est déjà enregistré" -#: registry.py:287 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "L'extension source %r est déjà enregistrée" -#: registry.py:296 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser pour %r est déjà enregistré" -#: registry.py:304 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "source_parser pour %s non enregistré" -#: registry.py:320 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "Il existe déjà un traducteur pour %r" -#: registry.py:336 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "Les kwargs pour add_node() doivent être un tuple de fonction (visite, départ) : %r=%r" -#: registry.py:419 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r est déjà enregistré" -#: registry.py:431 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "le moteur de rendu mathématique %s est déjà enregistré" -#: registry.py:446 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "l'extension %r a été intégrée à Sphinx depuis la version %s ; cette extension est ignorée." -#: registry.py:457 +#: registry.py:545 msgid "Original exception:\n" msgstr "Exception initiale :\n" -#: registry.py:458 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "L'extension %s ne peut pas être importée" -#: registry.py:463 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "l'extension %r n'a pas de fonction setup(); est-elle réellement un module d'extension de Sphinx ?" -#: registry.py:472 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "L'extension %s utilisée par ce projet nécessite au moins Sphinx v%s ; il ne peut donc pas être construit avec la version courante." -#: registry.py:480 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "l'extension %r a renvoyé par sa fonction setup() un type d'objet non supporté ; elle devrait renvoyer None ou un dictionnaire de méta-données" -#: registry.py:514 +#: registry.py:605 #, python-format msgid "`None` is not a valid filetype for %r." msgstr "`None` n'est pas un type de fichier valide pour %r." -#: project.py:71 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "plusieurs fichiers trouvés pour le document « %s » : %s\nUtilisez %r pour la compilation." - -#: project.py:87 +#: config.py:351 #, python-format -msgid "Ignored unreadable document %r." -msgstr "Document illisible %r ignoré." +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "Le dossier de configuration ne contient pas de fichier conf.py (%s)" -#: highlighting.py:168 +#: config.py:374 #, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Le nom du l'analyseur Pygments %r est inconnu" +msgid "'%s' must be '0' or '1', got '%s'" +msgstr "'%s' doit être '0' ou '1', a '%s'" -#: highlighting.py:202 +#: config.py:379 #, python-format msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "Le lexème du bloc_littéral %r en tant que \"%s\" a entraîné une erreur au niveau du jeton : %r. Réessayer en mode relaxé." +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" +msgstr "impossible d'écraser le dictionnaire de configuration %r ; ignoré (utilisez %r pour modifier les éléments individuellement)" -#: extension.py:55 +#: config.py:391 #, python-format -msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." -msgstr "L'extension %s est exigée par le paramètre needs_extensions, mais n'est pas chargée." +msgid "invalid number %r for config value %r, ignoring" +msgstr "nombre non valide %r pour l'option de configuration %r ; ignoré" -#: extension.py:76 +#: config.py:399 #, python-format -msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." -msgstr "Ce projet nécessite que l'extension %s soit au minimum en version %s et par conséquent il ne peut pas être construit avec la version chargée (%s)." +msgid "cannot override config setting %r with unsupported type, ignoring" +msgstr "impossible de remplacer le paramètre de configuration %r par un type non-supporté ; ignoré" -#: theming.py:114 +#: config.py:422 #, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "Les sections de configuration autres que [theme] et [options] ne sont pas acceptées (on a essayé d'obtenir une valeur à partir de %r)." +msgid "unknown config value %r in override, ignoring" +msgstr "paramètre de configuration %r inconnu dans override ; ignoré" -#: theming.py:120 +#: config.py:476 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "le paramètre %s.%s n'apparaît dans aucune des configurations de thème recherchées" +msgid "No such config value: %r" +msgstr "Aucune valeur de configuration du type : %r" -#: theming.py:135 +#: config.py:504 #, python-format -msgid "unsupported theme option %r given" -msgstr "l'option %r n'est pas supportée pour ce thème" +msgid "Config value %r already present" +msgstr "L'option de configuration %r est déjà présente" -#: theming.py:207 +#: config.py:541 #, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "le fichier %r dans le dossier des thèmes n'est pas une archive zip valide ou ne contient aucun thème" +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" +msgstr "ne peut pas mettre en cache une valeur de configuration non piquable : %r (parce qu'il contient une fonction, une classe ou un objet de module)" -#: theming.py:228 -#, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "aucun thème nommé %r trouvé (theme.toml manquant ?)" +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "Valeur de configuration non valide trouvée: 'language = None'. Mettez à jour la configuration avec un code de langage valide. Utilisation de 'en' (English) comme substitut." -#: theming.py:268 +#: config.py:599 #, python-format -msgid "The %r theme has circular inheritance" -msgstr "Le thème %r a un héritage circulaire" +msgid "There is a syntax error in your configuration file: %s\n" +msgstr "Votre fichier de configuration comporte une erreur de syntaxe : %s\n" -#: theming.py:275 -#, python-format +#: config.py:603 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "Le thème %r hérite de %r, qui n'est pas un thème chargé. Les thèmes chargés sont : %s" +"The configuration file (or one of the modules it imports) called sys.exit()" +msgstr "Le fichier de configuration (ou un des modules qu'il utilise) génère un sys.exit()" -#: theming.py:282 +#: config.py:611 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "Le thème %r a trop d'ancêtres" +msgid "" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" +msgstr "Votre fichier de configuration comporte une erreur de programmation : \n\n%s" -#: theming.py:310 +#: config.py:633 #, python-format -msgid "no theme configuration file found in %r" -msgstr "aucun fichier de configuration de thème n'a été trouvé dans %r" +msgid "Failed to convert %r to a frozenset" +msgstr "Échec de la conversion %r à un ensemble fixé" -#: theming.py:335 theming.py:388 +#: config.py:651 config.py:659 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "Le thème %r n'a pas la table « thème »" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." +msgstr "Conversion de `source_suffix = %r` en `source_suffix = %r`." -#: theming.py:339 +#: config.py:665 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "La table thème « [theme] » %r n'est pas une table" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." +msgstr "La valeur de configuration `source_suffix' attend un dictionnaire, une chaîne ou une liste de chaînes. Obtenu à la place : `%r' (type %s)." -#: theming.py:343 theming.py:391 +#: config.py:686 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "Le thème %r doit définir la clé \"theme.inherit\" dans les paramètres" +msgid "Section %s" +msgstr "Section %s" -#: theming.py:347 +#: config.py:687 #, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "La table thème « [options » %r n'est pas une table" +msgid "Fig. %s" +msgstr "Fig. %s" -#: theming.py:366 +#: config.py:688 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "Le paramètre « theme.pygments_style » doit être une table. Conseil : « %s »" +msgid "Table %s" +msgstr "Tableau %s" -#: config.py:309 -#, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "Le dossier de configuration ne contient pas de fichier conf.py (%s)" - -#: config.py:318 -msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "Valeur de configuration non valide trouvée: 'language = None'. Mettez à jour la configuration avec un code de langage valide. Utilisation de 'en' (English) comme substitut." - -#: config.py:341 -#, python-format -msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" -msgstr "impossible d'écraser le dictionnaire de configuration %r ; ignoré (utilisez %r pour modifier les éléments individuellement)" - -#: config.py:350 -#, python-format -msgid "invalid number %r for config value %r, ignoring" -msgstr "nombre non valide %r pour l'option de configuration %r ; ignoré" - -#: config.py:356 -#, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" -msgstr "impossible de remplacer le paramètre de configuration %r par un type non-supporté ; ignoré" - -#: config.py:377 -#, python-format -msgid "unknown config value %r in override, ignoring" -msgstr "paramètre de configuration %r inconnu dans override ; ignoré" - -#: config.py:430 -#, python-format -msgid "No such config value: %r" -msgstr "Aucune valeur de configuration du type : %r" - -#: config.py:453 -#, python-format -msgid "Config value %r already present" -msgstr "L'option de configuration %r est déjà présente" - -#: config.py:489 -#, python-format -msgid "" -"cannot cache unpickable configuration value: %r (because it contains a " -"function, class, or module object)" -msgstr "ne peut pas mettre en cache une valeur de configuration non sélectionnable : %r (parce qu'il contient une fonction, une classe ou un objet de module)" - -#: config.py:527 -#, python-format -msgid "There is a syntax error in your configuration file: %s\n" -msgstr "Votre fichier de configuration comporte une erreur de syntaxe : %s\n" - -#: config.py:530 -msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" -msgstr "Le fichier de configuration (ou un des modules qu'il utilise) génère un sys.exit()" - -#: config.py:537 -#, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" -msgstr "Votre fichier de configuration comporte une erreur de programmation : \n\n%s" - -#: config.py:560 -#, python-format -msgid "Failed to convert %r to a set or tuple" -msgstr "Échec de la conversion de %r en un ensemble ou un tuple " - -#: config.py:581 config.py:586 -#, python-format -msgid "Converting `source_suffix = %r` to `source_suffix = %r`." -msgstr "Conversion de `source_suffix = %r` en `source_suffix = %r`." - -#: config.py:589 -#, python-format -msgid "" -"The config value `source_suffix' expects a dictionary, a string, or a list " -"of strings. Got `%r' instead (type %s)." -msgstr "La valeur de configuration `source_suffix' attend un dictionnaire, une chaîne ou une liste de chaînes. Obtenu à la place : `%r' (type %s)." - -#: config.py:608 -#, python-format -msgid "Section %s" -msgstr "Section %s" - -#: config.py:609 -#, python-format -msgid "Fig. %s" -msgstr "Fig. %s" - -#: config.py:610 -#, python-format -msgid "Table %s" -msgstr "Tableau %s" - -#: config.py:611 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Code source %s" -#: config.py:718 +#: config.py:798 +#, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "La valeur « {current} » du paramètre « {name} » ne figure pas dans la liste des possibilités valables « {candidates} »." -#: config.py:742 +#: config.py:829 +#, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Le type du paramètre de configuration « {name} » doit être {permitted} et non « {current.__name__} »." -#: config.py:755 +#: config.py:846 +#, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Le paramètre de configuration « {name} » a pour type « {current.__name__} », tandis que le type par défaut est « {default.__name__} »." -#: config.py:766 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r non trouvé; ignoré." -#: config.py:778 +#: config.py:878 msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." -msgstr "Depuis sa version 2.0, Sphinx utilise \"index\" comme root_doc par défaut. Veuillez ajouter \"root_doc = 'contents'\" à votre conf.py." - -#: domains/rst.py:128 domains/rst.py:185 -#, python-format -msgid "%s (directive)" -msgstr "%s (directive)" - -#: domains/rst.py:186 domains/rst.py:190 -#, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (option de directive)" - -#: domains/rst.py:214 -#, python-format -msgid "%s (role)" -msgstr "%s (role)" - -#: domains/rst.py:224 -msgid "directive" -msgstr "directive" - -#: domains/rst.py:225 -msgid "directive-option" -msgstr "option de directive" - -#: domains/rst.py:226 -msgid "role" -msgstr "role" - -#: domains/rst.py:248 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "description dupliquée pour %s %s; l'autre instance se trouve dans %s" - -#: domains/javascript.py:165 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (fonction de base)" - -#: domains/javascript.py:166 domains/python/__init__.py:253 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (méthode %s)" - -#: domains/javascript.py:168 -#, python-format -msgid "%s() (class)" -msgstr "%s() (classe)" - -#: domains/javascript.py:170 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (variable globale ou constante)" - -#: domains/javascript.py:172 domains/python/__init__.py:338 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (attribut %s)" - -#: domains/javascript.py:255 -msgid "Arguments" -msgstr "Arguments" - -#: domains/cpp/__init__.py:447 domains/javascript.py:258 -msgid "Throws" -msgstr "Déclenche" - -#: domains/c/__init__.py:310 domains/cpp/__init__.py:458 -#: domains/javascript.py:261 domains/python/_object.py:176 -msgid "Returns" -msgstr "Renvoie" - -#: domains/c/__init__.py:312 domains/javascript.py:263 -#: domains/python/_object.py:178 -msgid "Return type" -msgstr "Type renvoyé" - -#: domains/javascript.py:334 -#, python-format -msgid "%s (module)" -msgstr "%s (module)" - -#: domains/c/__init__.py:681 domains/cpp/__init__.py:859 -#: domains/javascript.py:371 domains/python/__init__.py:660 -msgid "function" -msgstr "fonction" - -#: domains/javascript.py:372 domains/python/__init__.py:664 -msgid "method" -msgstr "méthode" - -#: domains/cpp/__init__.py:857 domains/javascript.py:373 -#: domains/python/__init__.py:662 -msgid "class" -msgstr "classe" - -#: domains/javascript.py:374 domains/python/__init__.py:661 -msgid "data" -msgstr "données" - -#: domains/javascript.py:375 domains/python/__init__.py:667 -msgid "attribute" -msgstr "attribut" - -#: domains/javascript.py:376 domains/python/__init__.py:670 -msgid "module" -msgstr "module" - -#: domains/javascript.py:407 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "description de %s dupliquée pour%s; l'autre %s se trouve dans %s" - -#: domains/changeset.py:25 -#, python-format -msgid "Added in version %s" -msgstr "Ajouté dans la version %s" - -#: domains/changeset.py:26 -#, python-format -msgid "Changed in version %s" -msgstr "Modifié dans la version %s" - -#: domains/changeset.py:27 -#, python-format -msgid "Deprecated since version %s" -msgstr "Obsolète depuis la version %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Removed in version %s" -msgstr "Supprimé dans la version %s" - -#: domains/__init__.py:299 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/citation.py:73 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "citation dupliquée %s, une autre instance dans %s" - -#: domains/citation.py:84 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "La citation [%s] n'est pas référencée" - -#: domains/math.py:63 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "Libellé dupliqué pour l'équation %s, autre instance dans %s" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." +msgstr "Sphinx utilise désormais \"index\" comme document maître par défaut. Pour conserver le comportement antérieur à la version 2.0, définissez \"master_doc = 'contents'\"." -#: domains/math.py:119 writers/latex.py:2479 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "math_eqref_format invalide : %r" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "La prise en charge des encodages source autres que UTF-8 est obsolète et sera supprimée dans Sphinx 10. Veuillez signaler tout problème à l'adresse https://github.com/sphinx-doc/sphinx/issues/13665." -#: environment/__init__.py:81 +#: environment/__init__.py:89 msgid "new config" msgstr "nouvelle configuration" -#: environment/__init__.py:82 +#: environment/__init__.py:90 msgid "config changed" msgstr "la configuration a changé" -#: environment/__init__.py:83 +#: environment/__init__.py:91 msgid "extensions changed" msgstr "les extensions ont changé" -#: environment/__init__.py:249 +#: environment/__init__.py:261 msgid "build environment version not current" msgstr "version non à jour de l’environnement de construction" -#: environment/__init__.py:251 +#: environment/__init__.py:263 msgid "source directory has changed" msgstr "le répertoire racine a changé" -#: environment/__init__.py:313 +#: environment/__init__.py:350 #, python-format msgid "The configuration has changed (1 option: %r)" msgstr "La configuration a changé (1 option : %r)" -#: environment/__init__.py:318 +#: environment/__init__.py:355 #, python-format msgid "The configuration has changed (%d options: %s)" msgstr "La configuration a changé (%d options : %s)" -#: environment/__init__.py:324 +#: environment/__init__.py:361 #, python-format msgid "The configuration has changed (%d options: %s, ...)" msgstr "La configuration a changé (%d options : %s, ...)" -#: environment/__init__.py:366 +#: environment/__init__.py:404 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "Cet environnement est incompatible avec le constructeur sélectionné, veuillez choisir un autre répertoire doctree." -#: environment/__init__.py:473 +#: environment/__init__.py:518 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "Échec du scan des documents dans %s : %r" -#: environment/__init__.py:626 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format msgid "Domain %r is not registered" msgstr "le domaine %r n'est pas enregistré." -#: environment/__init__.py:777 +#: environment/__init__.py:811 msgid "document isn't included in any toctree" msgstr "Le document n'est inclus dans aucune toctree." -#: environment/__init__.py:810 +#: environment/__init__.py:922 msgid "self referenced toctree found. Ignored." msgstr "une table des matières auto-référencée a été trouvée. Elle sera ignorée." -#: environment/__init__.py:839 +#: environment/__init__.py:952 #, python-format msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "document référencé dans plusieurs arborescences : %s, sélectionnant : %s <- %s" @@ -885,470 +744,912 @@ msgstr "Astuce" msgid "Warning" msgstr "Avertissement" -#: cmd/quickstart.py:43 -msgid "automatically insert docstrings from modules" -msgstr "insère automatiquement les docstrings des modules" +#: builders/texinfo.py:41 +#, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Les fichiers Texinfo se trouvent dans %(outdir)s." -#: cmd/quickstart.py:44 -msgid "automatically test code snippets in doctest blocks" -msgstr "tester automatiquement des extraits de code dans des blocs doctest" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nExécuter 'make' dans ce répertoire pour les soumettre à makeinfo\n(ou 'make info' directement ici pour l'automatiser)." -#: cmd/quickstart.py:45 -msgid "link between Sphinx documentation of different projects" -msgstr "lien entre la documentation Sphinx de différents projets" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "aucun paramètre de configuration \"texinfo_documents\" trouvé: aucun document ne sera écrit" -#: cmd/quickstart.py:46 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "entrées \"todo\" pouvant être montrées ou cachées à la compilation" +#: builders/texinfo.py:85 +#, python-format +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "La valeur du paramètre \"texinfo_documents\" référence un document inconnu %s" -#: cmd/quickstart.py:47 -msgid "checks for documentation coverage" -msgstr "vérification de la couverture de la documentation" +#: builders/latex/__init__.py:310 builders/texinfo.py:105 +#, python-format +msgid "processing %s" +msgstr "traitement de %s en cours" -#: cmd/quickstart.py:48 -msgid "include math, rendered as PNG or SVG images" -msgstr "expressions mathématiques, traduites en images PNG ou SVG" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "enregistrement" -#: cmd/quickstart.py:49 -msgid "include math, rendered in the browser by MathJax" -msgstr "expressions mathématiques, transmises dans le navigateur à MathJax" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "résolution des références..." -#: cmd/quickstart.py:50 -msgid "conditional inclusion of content based on config values" -msgstr "inclusion conditionnelle du contenu basé sur la valeur de configuration" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "(dans" -#: cmd/quickstart.py:51 -msgid "include links to the source code of documented Python objects" -msgstr "inclure des liens vers le code source documenté des objets Python" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "copie des images... " -#: cmd/quickstart.py:52 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "crée un fichier .nojekyll pour publier le document sur GitHub pages" +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 +#, python-format +msgid "cannot copy image file %r: %s" +msgstr "impossible de copier le fichier image %r: %s" -#: cmd/quickstart.py:94 -msgid "Please enter a valid path name." -msgstr "Merci de saisir un chemin valide." +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "copie des fichiers de support Texinfo" -#: cmd/quickstart.py:110 -msgid "Please enter some text." -msgstr "Merci de saisir du texte." +#: builders/texinfo.py:218 +#, python-format +msgid "error writing file Makefile: %s" +msgstr "erreur lors l'écriture du fichier Makefile : %s" -#: cmd/quickstart.py:117 +#: builders/manpage.py:37 #, python-format -msgid "Please enter one of %s." -msgstr "Merci de saisir un des %s." +msgid "The manual pages are in %(outdir)s." +msgstr "Le manuel se trouve dans %(outdir)s." -#: cmd/quickstart.py:125 -msgid "Please enter either 'y' or 'n'." -msgstr "Merci de saisir 'y' ou 'n'." +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "aucun valeur de configuration \"man_pages\" trouvée; aucun page du manuel ne sera enregistrée" -#: cmd/quickstart.py:131 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Merci de saisir l'extension du fichier, par exemple '.rst' ou '.txt'." +#: builders/manpage.py:64 +#, python-format +msgid "\"man_pages\" config value references unknown document %s" +msgstr "le paramètre de configuration \"man_pages\" référence un document inconnu %s" -#: cmd/quickstart.py:215 +#: builders/singlehtml.py:35 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Bienvenue dans le kit de démarrage rapide de Sphinx %s." +msgid "The HTML page is in %(outdir)s." +msgstr "Les pages HTML sont dans %(outdir)s." + +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "création du document unique" + +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "Enregistrement des fichiers supplémentaires" + +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "Le constructeur factice ne génère aucun fichier." + +#: builders/gettext.py:243 +#, python-format +msgid "The message catalogs are in %(outdir)s." +msgstr "La liste des messages se trouve dans %(outdir)s." + +#: builders/__init__.py:400 builders/gettext.py:264 +#, python-format +msgid "building [%s]: " +msgstr "construction [%s] : " + +#: builders/gettext.py:265 +#, python-format +msgid "targets for %d template files" +msgstr "cibles pour les modèles de fichiers %d" + +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "lecture des gabarits... " + +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "écriture des catalogues de messages... " + +#: builders/linkcheck.py:87 +#, python-format +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Recherchez les éventuelles erreurs dans la sortie ci-dessus ou dans %(outdir)s/output.txt" + +#: builders/linkcheck.py:159 +#, python-format +msgid "broken link: %s (%s)" +msgstr "lien mort: %s (%s)" + +#: builders/linkcheck.py:561 +#, python-format +msgid "Anchor '%s' not found" +msgstr "Ancre '%s' non trouvée" + +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "linkcheck_allowed_redirects. Un dictionnaire est attendu." + +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "Échec de la compilation de la regex dans linkcheck_allowed_redirects : %r%s" + +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." +msgstr "Le fichier ePub se trouve dans %(outdir)s ." + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "Enregistrement du fichier nav.xhtml..." + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "la variable de configuration \"epub_language\" (ou \"language\") ne peut pas être vide pour EPUB3" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "le paramètre de configuration \"epub_uid\" ne peut pas être vide pour EPUB3" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "le paramètre de configuration \"epub_title\" (ou \"html_title\") ne peut pas être vide pour EPUB3" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "le paramètre de configuration \"epub_author\" ne peut pas être vide pour EPUB3" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "le paramètre de configuration \"epub_contributor\" ne peut pas être vide pour EPUB3" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "le paramètre de configuration \"epub_description\" ne peut pas être vide pour EPUB3" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "le paramètre de configuration \"epub_publisher\" ne peut pas être vide pour EPUB3" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "le paramètre de configuration \"epub_copyright\" (ou \"copyright\") ne peut pas être vide pour EPUB3" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "le paramètre de configuration \"epub_identifier\" ne peut pas être vide pour EPUB3" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "le paramètre de configuration \"version\" ne peut pas être vide pour EPUB3" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" +msgstr "Fichier CSS non valide : %r, il sera ignoré" + +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." +msgstr "Les fichiers XML se trouvent dans %(outdir)s." + +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" +msgstr "erreur lors l'écriture du fichier %s : %s" + +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Le fichier pseudo-XML se trouve dans %(outdir)s." + +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" +msgstr "entrées dupliquées de la table des matières trouvées : %s" + +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" +msgstr "impossible de lire le fichier image %r: il sera copié à la place" -#: cmd/quickstart.py:219 +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" +msgstr "impossible d'écrire le fichier image %r: %s" + +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow n'a pas été trouvé - copie des fichiers image" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "écriture du type MIME du fichier ..." + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "écriture du fichier META-INF/container.xml..." + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "Enregistrement du fichier content.opf..." + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "type MIME inconnu pour %s, il sera ignoré" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "nœud de niveau invalide" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "Enregistrement du fichier toc.ncx..." + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "fichier %s en cours d'écriture..." + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "Les fichiers texte se trouvent dans %(outdir)s." + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "l'image appropriée pour le constructeur %s n'a pas été trouvée : %s (%s)" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "l'image appropriée pour le constructeur %s n'a pas été trouvée : %s" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "construction en cours [mo] : " + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "écriture... " + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "tous les %d fichiers po" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "cibles spécifiées pour les fichiers po %d" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "cibles périmées pour les fichiers po %d" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "tous les fichiers source" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "le fichier %r passé dans la ligne de commande n'existe pas, " + +#: builders/__init__.py:342 +#, python-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Veuillez saisir des valeurs pour les paramètres suivants (tapez Entrée pour accepter la valeur par défaut, lorsque celle-ci est indiquée entre crochets)." +"file %r given on command line is not under the source directory, ignoring" +msgstr "le fichier %r saisi en ligne de commande n'est pas présent dans le dossier source, il sera ignoré" -#: cmd/quickstart.py:227 +#: builders/__init__.py:353 #, python-format -msgid "Selected root path: %s" -msgstr "Chemin racine sélectionné : %s" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "le fichier %r passé dans la ligne de commande n'est pas un document valide, ignoré" -#: cmd/quickstart.py:230 -msgid "Enter the root path for documentation." -msgstr "Saisissez le répertoire racine de la documentation." +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "%d fichiers source saisis en ligne de commande" -#: cmd/quickstart.py:231 -msgid "Root path for the documentation" -msgstr "racine de la documentation." +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "cibles périmées pour les fichiers sources %d" -#: cmd/quickstart.py:239 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Erreur : un fichier conf.py a été trouvé dans le répertoire racine." +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "recherche des fichiers périmés... " -#: cmd/quickstart.py:245 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart n'écrasera pas un projet Sphinx existant." +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "%d trouvé" -#: cmd/quickstart.py:248 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Merci de saisir un nouveau répertoire racine (ou tapez juste Entrée)" +#: builders/__init__.py:417 +msgid "none found" +msgstr "aucun résultat trouvé" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "Environnement de sérialisation" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "vérification de la cohérence" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "aucune cible n'est périmée." -#: cmd/quickstart.py:258 +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "mise à jour de l'environnement : " + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "%s ajouté(s), %s modifié(s), %s supprimé(s)" + +#: builders/__init__.py:536 +#, python-format msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Vous avez deux options pour l'emplacement du répertoire de construction de la sortie de Sphinx.\nSoit vous utilisez un répertoire \"_build\" dans le chemin racine, soit vous séparez les répertoires \"source\" et \"build\" dans le chemin racine." +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "Sphinx ne peut pas charger le document maître (%s) parce qu'il correspond à un motif d'exclusion intégré %r. Veuillez déplacer votre document principal vers un autre emplacement." -#: cmd/quickstart.py:265 -msgid "Separate source and build directories (y/n)" -msgstr "Séparer les répertoires source et de sortie (y/n)" +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "Sphinx ne peut pas charger le document maître (%s) parce qu'il correspond à un motif d'exclusion spécifié dans conf.py, %r. Veuillez supprimer ce motif de conf.py." -#: cmd/quickstart.py:271 +#: builders/__init__.py:556 +#, python-format msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "Dans le répertoire racine, deux autres répertoires seront créés : \"_templates\" pour les modèles HTML personnalisés et \"_static\" pour les feuilles de style personnalisées et autres fichiers statiques. Vous pouvez entrer un autre préfixe (p. ex. \".\") pour remplacer le tiret bas (\"_\")." +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "Sphinx ne peut pas charger le document maître (%s) parce qu'il n'est pas inclus dans le motif personnalisé include_patterns = %r. Assurez-vous qu'un motif dans include_patterns correspond au document maître." -#: cmd/quickstart.py:277 -msgid "Name prefix for templates and static dir" -msgstr "Préfixe de nom pour les répertoires static et de gabarits (templates)" +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "Sphinx ne parvient pas à charger le document maître (%s). Le document maître doit se trouver dans le répertoire source ou dans un sous-répertoire de celui-ci." + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "lecture des sources... " + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "documents à écrire : %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "pas de noms de documents à écrire !" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "documents en préparation" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "copie des ressources" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "Le fichier d'aperçu se trouve dans %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "aucun changement dans la version %s" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "écriture du fichier de résumé..." + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Fonctions de base" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Module" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "copie des fichiers sources..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "impossible de lire %r pour la création du changelog" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "regex invalide %r dans %s" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "le module %s ne pas être importé : %s" -#: cmd/quickstart.py:282 +#: ext/coverage.py:148 +#, python-format msgid "" -"The project name will occur in several places in the built documentation." -msgstr "Le nom du projet apparaîtra à plusieurs endroits dans la documentation construite." +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "les modules suivants sont documentés mais n'ont pas été spécifiés dans coverage_modules : %s" -#: cmd/quickstart.py:286 -msgid "Project name" -msgstr "Nom du projet" +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "Les modules suivants sont spécifiés dans coverage_modules mais n'ont pas été documentés : %s" -#: cmd/quickstart.py:288 -msgid "Author name(s)" -msgstr "Nom(s) de(s) l'auteur(s)" +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "Les tests de couverture dans les sources sont terminés. %(outdir)s{sep}python.txt." + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "regex invalide %r dans coverage_c_regexes" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "API C non documentée : %s [%s] dans le fichier %s" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "fonction python non documentée: %s :: %s" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "classe python non documentée: %s :: %s" -#: cmd/quickstart.py:293 +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "méthode python non documentée: %s :: %s :: %s" + +#: ext/extlinks.py:82 +#, python-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "Sphinx a la notion de « version » et de « release » pour le\nlogiciel. Chaque version peut avoir plusieurs « releases ». Par exemple, pour\nPython, la version est quelque chose comme 2.5 ou 3.0, tandis que la « release » est\nquelque chose comme 2.5.1 ou 3.0a1. Si vous n'avez pas besoin de cette double structure,\nmettez simplement la même valeur aux deux." +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "le lien %r codé en dur pourrait être remplacé par un extlink (essayez d'utiliser %r à la place)" -#: cmd/quickstart.py:301 -msgid "Project version" -msgstr "Version du projet" +#: ext/todo.py:61 +msgid "Todo" +msgstr "À faire" -#: cmd/quickstart.py:303 -msgid "Project release" -msgstr "Version du projet" +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "Entrée TODO trouvée : %s" -#: cmd/quickstart.py:308 +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(l'<> se trouve dans %s, à la ligne %d)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "entrée originale" + +#: ext/imgconverter.py:44 +#, python-format msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" "\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "Si les documents doivent être rédigés dans une langue autre que l’anglais, vous pouvez sélectionner une langue ici grâce à son identifiant. Sphinx utilisera ensuite cette langue pour traduire les textes que lui-même génère.\n\nPour une liste des identifiants supportés, voir\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +"Traceback: %s" +msgstr "Impossible d’exécuter la commande de conversion d'image %r. 'sphinx.ext.imgconverter' nécessite par défaut ImageMagick. Assurez-vous que ce dernier est installé, ou configurez l’option 'image_converter' pour faire référence à une commande de conversion ad hoc.\n\nTrace d’appels : %s" -#: cmd/quickstart.py:317 -msgid "Project language" -msgstr "Langue du projet" +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "convert a terminé avec une erreur :\n[stderr]\n%r\n[stdout]\n%r" -#: cmd/quickstart.py:324 +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" +msgstr "la commande convert %r ne peut pas être exécutée; vérifiez le paramètre image_converter" + +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" +msgstr "La directive Graphviz ne peut pas avoir simultanément du contenu et un argument de nom de fichier" + +#: ext/graphviz.py:153 +#, python-format +msgid "External Graphviz file %r not found or reading it failed" +msgstr "Fichier externe Graphviz %r non trouvé ou échec de sa lecture" + +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "Directive « graphviz » sans contenu ignorée." + +#: ext/graphviz.py:287 +#, python-format +msgid "graphviz_dot executable path must be set! %r" +msgstr "Le chemin de l'exécutable de graphviz_dot doit être défini ! %r" + +#: ext/graphviz.py:328 +#, python-format msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "L'extension de fichier pour les fichiers sources. En général : \".txt\" ou \".rst\". Seuls les fichiers avec cette extension sont considérés." +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" +msgstr "la commande dot %r ne peut pas être exécutée (nécessaire pour le rendu graphviz). Vérifiez le paramètre graphviz_dot" -#: cmd/quickstart.py:329 -msgid "Source file suffix" -msgstr "Extension des fichiers sources" +#: ext/graphviz.py:339 +#, python-format +msgid "" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "dot a terminé avec une erreur :\n[stderr]\n%r\n[stdout]\n%r" -#: cmd/quickstart.py:334 +#: ext/graphviz.py:344 +#, python-format msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "Un document est particulier en ce sens qu'il est considéré comme le nœud supérieur de \"l'arbre des contenus\", c'est-à-dire la racine de la structure hiérarchique des documents. Normalement, il s'agit d'un \"index\", mais si votre \"index\" est un modèle personnalisé, vous pouvez également le définir sous un autre nom de fichier." +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "dot n'a pas produit de fichier de sortie : \n[stderr]\n%r\n[stdout]\n%r" -#: cmd/quickstart.py:342 -msgid "Name of your master document (without suffix)" -msgstr "Non du fichier principal (sans extension)" +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" +msgstr "graphviz_output_format doit être soit \"png\", soit \"svg\", mais il est %r" + +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" +msgstr "dot code %r: %s" -#: cmd/quickstart.py:352 +#: ext/graphviz.py:493 ext/graphviz.py:501 +#, python-format +msgid "[graph: %s]" +msgstr "[graphe: %s]" + +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" +msgstr "[graphe]" + +#: ext/imgmath.py:148 #, python-format msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Erreur : le fichier principal %s est déjà présent dans le répertoire racine du projet." +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "La commande LaTeX %r (nécessaire pour le rendu des équations mathématiques), ne peut pas être exécutée, vérifier le paramètre imgmath_latex" + +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "La commande de %s, %r, ne pas être exécuté (nécessaire pour display mathématique), vérifier la configuration imgmath_%s" + +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "latex de type display %r : %s" + +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "latex en ligne %r : %s" + +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "Lien vers cette équation" -#: cmd/quickstart.py:359 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart n'écrasera pas les fichiers existants." +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "option '+' ou '-' manquante dans %s." -#: cmd/quickstart.py:362 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Merci de saisir un nouveau nom de fichier, ou de renommer le fichier existant et valider avec Entrée" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "'%s' n'est pas une option valide." -#: cmd/quickstart.py:371 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Indiquer lesquelles de ces extensions Sphinx doivent être activées :" +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" +msgstr "%s n'est pas une option pyversion valide" -#: cmd/quickstart.py:381 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Note : imgmath et mathjax ne peuvent pas être activés en même temps. imgmath a été désactivé." +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "type invalide de TestCode" -#: cmd/quickstart.py:391 +#: ext/doctest.py:297 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Un fichier Makefile et un fichier de commandes Windows peuvent être générés pour vous, afin que vous puissiez exécuter par exemple `make html' au lieu d'appeler directement sphinx-build." - -#: cmd/quickstart.py:397 -msgid "Create Makefile? (y/n)" -msgstr "Création du Makefile ? (y/n)" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Exécution des doctests des sources achevée, voir les résultats dans %(outdir)s/output.txt." -#: cmd/quickstart.py:401 -msgid "Create Windows command file? (y/n)" -msgstr "Création du fichier de commandes Windows ? (y/n)" +#: ext/doctest.py:451 +#, python-format +msgid "no code/output in %s block at %s:%s" +msgstr "pas de code ou sortie dans le bloc %s en %s : %s" -#: cmd/quickstart.py:453 ext/apidoc.py:92 +#: ext/doctest.py:568 #, python-format -msgid "Creating file %s." -msgstr "Fichier en cours de création %s." +msgid "ignoring invalid doctest code: %r" +msgstr "code doctest invalide sera ignoré : %r" -#: cmd/quickstart.py:458 ext/apidoc.py:89 +#: ext/autosectionlabel.py:52 #, python-format -msgid "File %s already exists, skipping." -msgstr "Le fichier %s existe déjà, il ne sera pas remplacé" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "la section \"%s\" est étiquettée \"%s\"" -#: cmd/quickstart.py:501 -msgid "Finished: An initial directory structure has been created." -msgstr "Terminé : la structure initiale a été créée." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "libellé dupliqué %s, l'autre instance se trouve dans %s" -#: cmd/quickstart.py:504 +#: ext/duration.py:47 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "Vous devez maintenant compléter votre fichier principal %s et créer d'autres fichiers sources de documentation. " +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "La durée de lecture %.3fs a dépassé la limite de durée %.3fs" -#: cmd/quickstart.py:512 +#: ext/duration.py:117 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Utilisez le Makefile pour construire la documentation comme ceci :\n make builder" +"====================== total reading duration ==========================" +msgstr "====================== durée totale de lecture ==========================" -#: cmd/quickstart.py:515 +#: ext/duration.py:124 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Utilisez sphinx-build pour construire la documentation comme ceci : \n sphinx-build -b builder %s %s" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "Temps total de lecture %d fichier%s: %dm %.3fs" -#: cmd/quickstart.py:522 +#: ext/duration.py:136 msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "où « builder » est l'un des constructeurs disponibles, tel que html, latex, ou linkcheck." - -#: cmd/quickstart.py:557 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nEngendre les fichiers requis pour un projet Sphinx.\n\nsphinx-quickstart est un outil interactif qui pose des questions à propos de votre projet et génère un répertoire avec la structure complète nécessaire ainsi qu'un Makefile qui peut être utilisé comme alternative à sphinx-build.\n" - -#: cmd/build.py:153 cmd/quickstart.py:567 ext/apidoc.py:374 -#: ext/autosummary/generate.py:766 -msgid "For more information, visit ." -msgstr "Pour plus d'informations, visitez le site ." +"====================== slowest reading durations =======================" +msgstr "====================== durées de lecture les plus lentes =======================" -#: cmd/quickstart.py:577 -msgid "quiet mode" -msgstr "mode silencieux" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" +msgstr "%.3fs %s" -#: cmd/quickstart.py:587 -msgid "project root" -msgstr "racine du projet" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[source]" -#: cmd/quickstart.py:590 -msgid "Structure options" -msgstr "Options de structure" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "Coloration syntaxique du code du module..." -#: cmd/quickstart.py:596 -msgid "if specified, separate source and build dirs" -msgstr "si spécifié, les répertoires source et build seront séparés" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[docs]" -#: cmd/quickstart.py:602 -msgid "if specified, create build dir under source dir" -msgstr "si spécifié, créé le dossier build dans le dossier source" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Code du module" -#: cmd/quickstart.py:608 -msgid "replacement for dot in _templates etc." -msgstr "remplace le point dans _templates etc." +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Code source de %s

        " -#: cmd/quickstart.py:611 -msgid "Project basic options" -msgstr "Options basiques du projet." +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Vue d'ensemble : code du module" -#: cmd/quickstart.py:613 -msgid "project name" -msgstr "nom du projet" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Modules pour lesquels le code est disponible

        " -#: cmd/quickstart.py:616 -msgid "author names" -msgstr "nom de l'auteur" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" +msgstr "citation dupliquée %s, une autre instance dans %s" -#: cmd/quickstart.py:623 -msgid "version of project" -msgstr "version du projet" +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." +msgstr "La citation [%s] n'est pas référencée" -#: cmd/quickstart.py:630 -msgid "release of project" -msgstr "version du projet" +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" +msgstr "Libellé dupliqué pour l'équation %s, autre instance dans %s" -#: cmd/quickstart.py:637 -msgid "document language" -msgstr "langue du document" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "math_eqref_format invalide : %r" -#: cmd/quickstart.py:640 -msgid "source file suffix" -msgstr "préfixe des fichiers source" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (fonction de base)" -#: cmd/quickstart.py:643 -msgid "master document name" -msgstr "nom du document principal" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (méthode %s)" -#: cmd/quickstart.py:646 -msgid "use epub" -msgstr "utilisé epub" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (classe)" -#: cmd/quickstart.py:649 -msgid "Extension options" -msgstr "Options d'extension" +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" +msgstr "%s (variable globale ou constante)" -#: cmd/quickstart.py:656 ext/apidoc.py:578 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "enable %s extension" -msgstr "autoriser l'extension %s" +msgid "%s (%s attribute)" +msgstr "%s (attribut %s)" -#: cmd/quickstart.py:663 ext/apidoc.py:570 -msgid "enable arbitrary extensions" -msgstr "active l'emploi d'extensions quelconques" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Arguments" -#: cmd/quickstart.py:666 -msgid "Makefile and Batchfile creation" -msgstr "Création des fichiers Batchfile et Makefile" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Déclenche" -#: cmd/quickstart.py:672 -msgid "create makefile" -msgstr "créer un fichier makefile" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Renvoie" -#: cmd/quickstart.py:678 -msgid "do not create makefile" -msgstr "ne pas créer un fichier makefile" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Type renvoyé" -#: cmd/quickstart.py:685 -msgid "create batchfile" -msgstr "créer un fichier batch" +#: domains/javascript.py:374 +#, python-format +msgid "%s (module)" +msgstr "%s (module)" -#: cmd/quickstart.py:691 -msgid "do not create batchfile" -msgstr "ne pas créer un fichier batch" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "fonction" -#: cmd/quickstart.py:700 -msgid "use make-mode for Makefile/make.bat" -msgstr "utiliser make-mode pour Makefile/make.bat" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "méthode" -#: cmd/quickstart.py:703 ext/apidoc.py:581 -msgid "Project templating" -msgstr "Gabarits de projet" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "classe" -#: cmd/quickstart.py:709 ext/apidoc.py:587 -msgid "template directory for template files" -msgstr "répertoire des templates" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "données" -#: cmd/quickstart.py:716 -msgid "define a template variable" -msgstr "définissez une variable de template" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "attribut" -#: cmd/quickstart.py:751 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "vous avez spécifiez \"quit\" , mais \"project\" ou \"author\" ne sont pas spécifiés." +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "module" -#: cmd/quickstart.py:770 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Erreur : le chemin spécifié n'est pas un répertoire, ou les fichiers Sphinx existent déjà." +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" +msgstr "description de %s dupliquée pour%s; l'autre %s se trouve dans %s" -#: cmd/quickstart.py:777 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart peut générer ces fichiers seulement dans un répertoire vide. Merci de spécifier un nouveau répertoire racine." +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" +msgstr "%s (directive)" -#: cmd/quickstart.py:795 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "Invalid template variable: %s" -msgstr "Variable de template invalide : %s" +msgid ":%s: (directive option)" +msgstr ":%s: (option de directive)" -#: cmd/build.py:49 -msgid "Exception occurred while building, starting debugger:" -msgstr "Une exception a été levée lors de la génération, démarrage du débogueur :" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (role)" -#: _cli/util/errors.py:129 cmd/build.py:65 -msgid "Interrupted!" -msgstr "Interrompu !" +#: domains/rst.py:234 +msgid "directive" +msgstr "directive" -#: cmd/build.py:67 -msgid "reST markup error:" -msgstr "Erreur de balise reST :" +#: domains/rst.py:235 +msgid "directive-option" +msgstr "option de directive" -#: _cli/util/errors.py:143 cmd/build.py:73 -msgid "Encoding error:" -msgstr "Erreur d'encodage :" +#: domains/rst.py:236 +msgid "role" +msgstr "role" -#: cmd/build.py:78 cmd/build.py:108 +#: domains/rst.py:262 #, python-format -msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." -msgstr "La trace d’appels complète a été sauvegardée dans %s, au cas où vous souhaiteriez signaler le problème aux développeurs." +msgid "duplicate description of %s %s, other instance in %s" +msgstr "description dupliquée pour %s %s; l'autre instance se trouve dans %s" -#: _cli/util/errors.py:148 cmd/build.py:90 -msgid "Recursion error:" -msgstr "Erreur de récursion :" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" +msgstr "Ajouté dans la version %s" -#: _cli/util/errors.py:152 cmd/build.py:94 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" -msgstr "Cela peut se produire avec des fichiers sources très volumineux ou profondément imbriqués. Vous pouvez augmenter avec attention la limite de récursivité par défaut de Python de 1000 dans conf.py avec p. ex. :" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "Modifié dans la version %s" -#: _cli/util/errors.py:165 cmd/build.py:103 -msgid "Exception occurred:" -msgstr "Une exception a été levée :" +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "Obsolète depuis la version %s" -#: _cli/util/errors.py:178 cmd/build.py:117 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Merci de rapporter ceci s'il s'agit d'une erreur utilisateur, afin d'améliorer le message d'erreur à l'avenir." +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" +msgstr "Supprimé dans la version %s" -#: cmd/build.py:124 -msgid "" -"A bug report can be filed in the tracker at . Thanks!" -msgstr "Un rapport d'erreur peut être déposé dans le système de tickets à . Merci !" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: cmd/build.py:144 +#: cmd/build.py:64 msgid "job number should be a positive number" msgstr "Le numéro du job doit être strictement positif" -#: cmd/build.py:154 +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "Pour plus d'informations, visitez le site ." + +#: cmd/build.py:74 msgid "" "\n" "Generate documentation from source files.\n" @@ -1367,675 +1668,589 @@ msgid "" "files can be built by specifying individual filenames.\n" msgstr "\nGénération de la documentation à partir des fichiers sources.\n\nsphinx-build génère de la documentation à partir des fichiers de SOURCEDIR et la place\ndans OUTPUTDIR. Il recherche 'conf.py' dans SOURCEDIR pour les paramètres de configuration.\nL'outil 'sphinx-quickstart' peut être utilisé pour générer des fichiers modèles,\ny compris 'conf.py'.\n\nsphinx-build peut créer de la documentation dans différents formats. Un format est\nsélectionné en spécifiant le nom du constructeur sur la ligne de commande ; le format par défaut est\nHTML. Les constructeurs peuvent également effectuer d'autres tâches liées au traitement de la documentation.\n\nPar défaut, tout ce qui est obsolète est construit. La sortie pour les fichiers sélectionnés seulement\npeut être construite en spécifiant des noms de fichiers individuels.\n" -#: cmd/build.py:180 +#: cmd/build.py:100 msgid "path to documentation source files" msgstr "chemin des fichiers sources de la documentation" -#: cmd/build.py:183 +#: cmd/build.py:103 msgid "path to output directory" msgstr "chemin du répertoire de sortie" -#: cmd/build.py:188 +#: cmd/build.py:109 msgid "" "(optional) a list of specific files to rebuild. Ignored if --write-all is " "specified" msgstr "(optionnel) une liste de fichiers spécifiques à reconstruire. Ignoré si --write-all est spécifié" -#: cmd/build.py:194 +#: cmd/build.py:114 msgid "general options" msgstr "options générales" -#: cmd/build.py:201 +#: cmd/build.py:121 msgid "builder to use (default: 'html')" msgstr "constructeur à utiliser (par défaut: 'html')" -#: cmd/build.py:210 +#: cmd/build.py:131 msgid "" "run in parallel with N processes, when possible. 'auto' uses the number of " "CPU cores" msgstr "exécuter en parallèle avec N processus, lorsque cela est possible. 'auto' utilise le nombre de cœurs du processeur" -#: cmd/build.py:220 +#: cmd/build.py:140 msgid "write all files (default: only write new and changed files)" msgstr "enregistrer tous les fichiers (par défaut : enregistrer seulement les fichiers nouveaux ou modifiés)" -#: cmd/build.py:227 +#: cmd/build.py:147 msgid "don't use a saved environment, always read all files" msgstr "ne pas utiliser un environnement sauvegardé, relire toujours tous les fichiers" -#: cmd/build.py:230 +#: cmd/build.py:150 msgid "path options" msgstr "options de chemin" -#: cmd/build.py:236 +#: cmd/build.py:157 msgid "" "directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "répertoire pour les doctree et les fichiers d'environnement (par défaut : OUTPUT_DIR/.doctrees)" -#: cmd/build.py:246 +#: cmd/build.py:166 msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "répertoire du fichier de configuration (conf.py) (par défaut : SOURCE_DIR)" -#: cmd/build.py:255 +#: cmd/build.py:175 msgid "use no configuration file, only use settings from -D options" msgstr "n'utilise pas de fichier de configuration, utilise uniquement les paramètres des options -D" -#: cmd/build.py:264 +#: cmd/build.py:184 msgid "override a setting in configuration file" msgstr "outre passer un paramètre du fichier de configuration" -#: cmd/build.py:273 +#: cmd/build.py:193 msgid "pass a value into HTML templates" msgstr "passer une valeur aux templates HTML" -#: cmd/build.py:282 +#: cmd/build.py:202 msgid "define tag: include \"only\" blocks with TAG" msgstr "définit une balise : seules les blocs \"only\" avec TAG seront inclus" -#: cmd/build.py:289 +#: cmd/build.py:209 msgid "nitpicky mode: warn about all missing references" msgstr "mode tatillon : avertir de toutes les références manquantes" -#: cmd/build.py:292 +#: cmd/build.py:212 msgid "console output options" msgstr "options de la console de sortie" -#: cmd/build.py:299 +#: cmd/build.py:219 msgid "increase verbosity (can be repeated)" msgstr "augmenter la verbosité (peut être répété)" -#: cmd/build.py:306 ext/apidoc.py:413 +#: cmd/build.py:226 ext/apidoc/_cli.py:66 msgid "no output on stdout, just warnings on stderr" msgstr "aucune sortie vers stdout, seulement les avertissements vers stderr" -#: cmd/build.py:313 +#: cmd/build.py:233 msgid "no output at all, not even warnings" msgstr "aucune sortie du tout, même pas les avertissements" -#: cmd/build.py:321 +#: cmd/build.py:241 msgid "do emit colored output (default: auto-detect)" msgstr "émettre une sortie de couleur (par défaut : auto-détection)" -#: cmd/build.py:329 +#: cmd/build.py:249 msgid "do not emit colored output (default: auto-detect)" msgstr "ne pas émettre une sortie de couleur (par défaut : auto-détection)" -#: cmd/build.py:332 +#: cmd/build.py:252 msgid "warning control options" msgstr "options de contrôle des avertissements" -#: cmd/build.py:338 +#: cmd/build.py:258 msgid "write warnings (and errors) to given file" msgstr "écrire les avertissements (et les erreurs) vers le fichier spécifié" -#: cmd/build.py:345 +#: cmd/build.py:265 msgid "turn warnings into errors" msgstr "modifier les avertissements en erreurs" -#: cmd/build.py:353 +#: cmd/build.py:273 msgid "show full traceback on exception" msgstr "montrer la trace d’appels complète si une exception est levée" -#: cmd/build.py:356 +#: cmd/build.py:276 msgid "run Pdb on exception" msgstr "exécuter Pdb si une exception se produit." -#: cmd/build.py:362 +#: cmd/build.py:282 msgid "raise an exception on warnings" msgstr "lever une exception en cas d'avertissement" -#: cmd/build.py:405 +#: cmd/build.py:325 msgid "cannot combine -a option and filenames" msgstr "impossible de combiner l'option -a avec le nom du fichier" -#: cmd/build.py:437 +#: cmd/build.py:357 #, python-format msgid "cannot open warning file '%s': %s" msgstr "impossible d'ouvrir le fichier d'avertissement '%s' : %s" -#: cmd/build.py:456 +#: cmd/build.py:376 msgid "-D option argument must be in the form name=value" msgstr "l'option -D doit être sous la forme nom=valeur" -#: cmd/build.py:463 +#: cmd/build.py:383 msgid "-A option argument must be in the form name=value" msgstr "l'option -A doit être sous la forme nom=valeur" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "Le constructeur factice ne génère aucun fichier." - -#: builders/linkcheck.py:75 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Recherchez les éventuelles erreurs dans la sortie ci-dessus ou dans %(outdir)s/output.txt" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "insère automatiquement les docstrings des modules" -#: builders/linkcheck.py:146 -#, python-format -msgid "broken link: %s (%s)" -msgstr "lien mort: %s (%s)" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "tester automatiquement des extraits de code dans des blocs doctest" -#: builders/linkcheck.py:540 -#, python-format -msgid "Anchor '%s' not found" -msgstr "Ancre '%s' non trouvée" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "lien entre la documentation Sphinx de différents projets" -#: builders/linkcheck.py:742 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "Échec de la compilation de la regex dans linkcheck_allowed_redirects : %r%s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "entrées \"todo\" pouvant être montrées ou cachées à la compilation" -#: builders/singlehtml.py:37 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "Les pages HTML sont dans %(outdir)s." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "vérification de la couverture de la documentation" -#: builders/singlehtml.py:173 -msgid "assembling single document" -msgstr "création du document unique" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "expressions mathématiques, traduites en images PNG ou SVG" -#: builders/latex/__init__.py:346 builders/manpage.py:56 -#: builders/singlehtml.py:178 builders/texinfo.py:121 -msgid "writing" -msgstr "enregistrement" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "expressions mathématiques, transmises dans le navigateur à MathJax" -#: builders/singlehtml.py:191 -msgid "writing additional files" -msgstr "Enregistrement des fichiers supplémentaires" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "inclusion conditionnelle du contenu basé sur la valeur de configuration" -#: builders/manpage.py:39 -#, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Le manuel se trouve dans %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "inclure des liens vers le code source documenté des objets Python" -#: builders/manpage.py:47 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "aucun valeur de configuration \"man_pages\" trouvée; aucun page du manuel ne sera enregistrée" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "crée un fichier .nojekyll pour publier le document sur GitHub pages" -#: builders/manpage.py:73 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "le paramètre de configuration \"man_pages\" référence un document inconnu %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Merci de saisir un chemin valide." -#: builders/text.py:34 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Les fichiers texte se trouvent dans %(outdir)s." +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Merci de saisir du texte." -#: builders/html/__init__.py:1239 builders/text.py:81 builders/xml.py:97 +#: cmd/quickstart.py:134 #, python-format -msgid "error writing file %s: %s" -msgstr "erreur lors l'écriture du fichier %s : %s" +msgid "Please enter one of %s." +msgstr "Merci de saisir un des %s." -#: builders/xml.py:38 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Les fichiers XML se trouvent dans %(outdir)s." +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Merci de saisir 'y' ou 'n'." -#: builders/xml.py:110 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Le fichier pseudo-XML se trouve dans %(outdir)s." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Merci de saisir l'extension du fichier, par exemple '.rst' ou '.txt'." -#: builders/texinfo.py:47 +#: cmd/quickstart.py:230 #, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Les fichiers Texinfo se trouvent dans %(outdir)s." +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Bienvenue dans le kit de démarrage rapide de Sphinx %s." -#: builders/texinfo.py:49 +#: cmd/quickstart.py:235 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nExécuter 'make' dans ce répertoire pour les soumettre à makeinfo\n(ou 'make info' directement ici pour l'automatiser)." - -#: builders/texinfo.py:78 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "aucun paramètre de configuration \"texinfo_documents\" trouvé: aucun document ne sera écrit" - -#: builders/texinfo.py:90 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "La valeur du paramètre \"texinfo_documents\" référence un document inconnu %s" - -#: builders/latex/__init__.py:324 builders/texinfo.py:115 -#, python-format -msgid "processing %s" -msgstr "traitement de %s en cours" - -#: builders/latex/__init__.py:404 builders/texinfo.py:174 -msgid "resolving references..." -msgstr "résolution des références..." - -#: builders/latex/__init__.py:415 builders/texinfo.py:184 -msgid " (in " -msgstr "(dans" - -#: builders/_epub_base.py:423 builders/html/__init__.py:778 -#: builders/latex/__init__.py:482 builders/texinfo.py:202 -msgid "copying images... " -msgstr "copie des images... " - -#: builders/_epub_base.py:445 builders/latex/__init__.py:497 -#: builders/texinfo.py:219 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "impossible de copier le fichier image %r: %s" - -#: builders/texinfo.py:226 -msgid "copying Texinfo support files" -msgstr "copie des fichiers de support Texinfo" - -#: builders/texinfo.py:234 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "erreur lors l'écriture du fichier Makefile : %s" - -#: builders/gettext.py:230 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "La liste des messages se trouve dans %(outdir)s." - -#: builders/__init__.py:383 builders/gettext.py:251 -#, python-format -msgid "building [%s]: " -msgstr "construction [%s] : " +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Veuillez saisir des valeurs pour les paramètres suivants (tapez Entrée pour accepter la valeur par défaut, lorsque celle-ci est indiquée entre crochets)." -#: builders/gettext.py:252 +#: cmd/quickstart.py:242 #, python-format -msgid "targets for %d template files" -msgstr "cibles pour les modèles de fichiers %d" - -#: builders/gettext.py:257 -msgid "reading templates... " -msgstr "lecture des gabarits... " - -#: builders/gettext.py:292 -msgid "writing message catalogs... " -msgstr "écriture des catalogues de messages... " +msgid "Selected root path: %s" +msgstr "Chemin racine sélectionné : %s" -#: builders/__init__.py:212 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "l'image appropriée pour le constructeur %s n'a pas été trouvée : %s (%s)" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Saisissez le répertoire racine de la documentation." -#: builders/__init__.py:220 -#, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "l'image appropriée pour le constructeur %s n'a pas été trouvée : %s" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "racine de la documentation." -#: builders/__init__.py:243 -msgid "building [mo]: " -msgstr "construction en cours [mo] : " +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Erreur : un fichier conf.py a été trouvé dans le répertoire racine." -#: builders/__init__.py:246 builders/__init__.py:741 builders/__init__.py:773 -msgid "writing output... " -msgstr "écriture... " +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart n'écrasera pas un projet Sphinx existant." -#: builders/__init__.py:263 -#, python-format -msgid "all of %d po files" -msgstr "tous les %d fichiers po" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Merci de saisir un nouveau répertoire racine (ou tapez juste Entrée)" -#: builders/__init__.py:285 -#, python-format -msgid "targets for %d po files that are specified" -msgstr "cibles spécifiées pour les fichiers po %d" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Vous avez deux options pour l'emplacement du répertoire de construction de la sortie de Sphinx.\nSoit vous utilisez un répertoire \"_build\" dans le chemin racine, soit vous séparez les répertoires \"source\" et \"build\" dans le chemin racine." -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are out of date" -msgstr "cibles périmées pour les fichiers po %d" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Séparer les répertoires source et de sortie (y/n)" -#: builders/__init__.py:307 -msgid "all source files" -msgstr "tous les fichiers source" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "Dans le répertoire racine, deux autres répertoires seront créés : \"_templates\" pour les modèles HTML personnalisés et \"_static\" pour les feuilles de style personnalisées et autres fichiers statiques. Vous pouvez entrer un autre préfixe (p. ex. \".\") pour remplacer le tiret bas (\"_\")." -#: builders/__init__.py:319 -#, python-format -msgid "file %r given on command line does not exist, " -msgstr "le fichier %r passé dans la ligne de commande n'existe pas, " +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Préfixe de nom pour les répertoires static et de gabarits (templates)" -#: builders/__init__.py:325 -#, python-format +#: cmd/quickstart.py:298 msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "le fichier %r saisi en ligne de commande n'est pas présent dans le dossier source, il sera ignoré" +"The project name will occur in several places in the built documentation." +msgstr "Le nom du projet apparaîtra à plusieurs endroits dans la documentation construite." -#: builders/__init__.py:336 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "le fichier %r passé dans la ligne de commande n'est pas un document valide, ignoré" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Nom du projet" -#: builders/__init__.py:351 -#, python-format -msgid "%d source files given on command line" -msgstr "%d fichiers source saisis en ligne de commande" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Nom(s) de(s) l'auteur(s)" -#: builders/__init__.py:366 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "cibles périmées pour les fichiers sources %d" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx a la notion de « version » et de « release » pour le\nlogiciel. Chaque version peut avoir plusieurs « releases ». Par exemple, pour\nPython, la version est quelque chose comme 2.5 ou 3.0, tandis que la « release » est\nquelque chose comme 2.5.1 ou 3.0a1. Si vous n'avez pas besoin de cette double structure,\nmettez simplement la même valeur aux deux." -#: builders/__init__.py:394 -msgid "looking for now-outdated files... " -msgstr "recherche des fichiers périmés... " +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Version du projet" -#: builders/__init__.py:398 -#, python-format -msgid "%d found" -msgstr "%d trouvé" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Version du projet" -#: builders/__init__.py:400 -msgid "none found" -msgstr "aucun résultat trouvé" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "Si les documents doivent être rédigés dans une langue autre que l’anglais, vous pouvez sélectionner une langue ici grâce à son identifiant. Sphinx utilisera ensuite cette langue pour traduire les textes que lui-même génère.\n\nPour une liste des identifiants supportés, voir\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: builders/__init__.py:407 -msgid "pickling environment" -msgstr "Environnement de sérialisation" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Langue du projet" -#: builders/__init__.py:414 -msgid "checking consistency" -msgstr "vérification de la cohérence" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "L'extension de fichier pour les fichiers sources. En général : \".txt\" ou \".rst\". Seuls les fichiers avec cette extension sont considérés." -#: builders/__init__.py:418 -msgid "no targets are out of date." -msgstr "aucune cible n'est périmée." +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Extension des fichiers sources" -#: builders/__init__.py:458 -msgid "updating environment: " -msgstr "mise à jour de l'environnement : " +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "Un document est particulier en ce sens qu'il est considéré comme le nœud supérieur de \"l'arbre des contenus\", c'est-à-dire la racine de la structure hiérarchique des documents. Normalement, il s'agit d'un \"index\", mais si votre \"index\" est un modèle personnalisé, vous pouvez également le définir sous un autre nom de fichier." -#: builders/__init__.py:483 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s ajouté(s), %s modifié(s), %s supprimé(s)" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Non du fichier principal (sans extension)" -#: builders/__init__.py:519 +#: cmd/quickstart.py:368 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "Sphinx ne peut pas charger le document maître (%s) parce qu'il correspond à un motif d'exclusion intégré %r. Veuillez déplacer votre document principal vers un autre emplacement." +"Error: the master file %s has already been found in the selected root path." +msgstr "Erreur : le fichier principal %s est déjà présent dans le répertoire racine du projet." -#: builders/__init__.py:528 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "Sphinx ne peut pas charger le document maître (%s) parce qu'il correspond à un motif d'exclusion spécifié dans conf.py, %r. Veuillez supprimer ce motif de conf.py." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart n'écrasera pas les fichiers existants." -#: builders/__init__.py:539 -#, python-format +#: cmd/quickstart.py:378 msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "Sphinx ne peut pas charger le document maître (%s) parce qu'il n'est pas inclus dans le motif personnalisé include_patterns = %r. Assurez-vous qu'un motif dans include_patterns correspond au document maître." +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Merci de saisir un nouveau nom de fichier, ou de renommer le fichier existant et valider avec Entrée" -#: builders/__init__.py:546 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "Sphinx ne parvient pas à charger le document maître (%s). Le document maître doit se trouver dans le répertoire source ou dans un sous-répertoire de celui-ci." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Indiquer lesquelles de ces extensions Sphinx doivent être activées :" -#: builders/__init__.py:565 builders/__init__.py:581 -msgid "reading sources... " -msgstr "lecture des sources... " +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Note : imgmath et mathjax ne peuvent pas être activés en même temps. imgmath a été désactivé." -#: builders/__init__.py:698 -#, python-format -msgid "docnames to write: %s" -msgstr "documents à écrire : %s" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Un fichier Makefile et un fichier de commandes Windows peuvent être générés pour vous, afin que vous puissiez exécuter par exemple `make html' au lieu d'appeler directement sphinx-build." -#: builders/__init__.py:711 -msgid "preparing documents" -msgstr "documents en préparation" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Création du Makefile ? (y/n)" -#: builders/__init__.py:714 -msgid "copying assets" -msgstr "copie des ressources" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Création du fichier de commandes Windows ? (y/n)" -#: builders/__init__.py:866 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "le caractère source est indécodable, il sera remplacé par \"?\" : %r" +msgid "Creating file %s." +msgstr "Fichier en cours de création %s." -#: builders/epub3.py:83 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "Le fichier ePub se trouve dans %(outdir)s ." - -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "Enregistrement du fichier nav.xhtml..." +msgid "File %s already exists, skipping." +msgstr "Le fichier %s existe déjà, il ne sera pas remplacé" -#: builders/epub3.py:220 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "la variable de configuration \"epub_language\" (ou \"language\") ne peut pas être vide pour EPUB3" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Terminé : la structure initiale a été créée." -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "le paramètre de configuration \"epub_uid\" ne peut pas être vide pour EPUB3" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Vous devez maintenant compléter votre fichier principal %s et créer d'autres fichiers sources de documentation. " -#: builders/epub3.py:231 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "le paramètre de configuration \"epub_title\" (ou \"html_title\") ne peut pas être vide pour EPUB3" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Utilisez le Makefile pour construire la documentation comme ceci :\n make builder" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "le paramètre de configuration \"epub_author\" ne peut pas être vide pour EPUB3" +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Utilisez sphinx-build pour construire la documentation comme ceci : \n sphinx-build -b builder %s %s" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "le paramètre de configuration \"epub_contributor\" ne peut pas être vide pour EPUB3" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "où « builder » est l'un des constructeurs disponibles, tel que html, latex, ou linkcheck." -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "le paramètre de configuration \"epub_description\" ne peut pas être vide pour EPUB3" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nEngendre les fichiers requis pour un projet Sphinx.\n\nsphinx-quickstart est un outil interactif qui pose des questions à propos de votre projet et génère un répertoire avec la structure complète nécessaire ainsi qu'un Makefile qui peut être utilisé comme alternative à sphinx-build.\n" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "le paramètre de configuration \"epub_publisher\" ne peut pas être vide pour EPUB3" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "mode silencieux" -#: builders/epub3.py:255 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "le paramètre de configuration \"epub_copyright\" (ou \"copyright\") ne peut pas être vide pour EPUB3" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "racine du projet" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "le paramètre de configuration \"epub_identifier\" ne peut pas être vide pour EPUB3" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Options de structure" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "le paramètre de configuration \"version\" ne peut pas être vide pour EPUB3" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "si spécifié, les répertoires source et build seront séparés" -#: builders/epub3.py:279 builders/html/__init__.py:1289 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "Fichier CSS non valide : %r, il sera ignoré" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "si spécifié, créé le dossier build dans le dossier source" -#: builders/_epub_base.py:222 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "entrées dupliquées de la table des matières trouvées : %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "remplace le point dans _templates etc." -#: builders/_epub_base.py:434 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "impossible de lire le fichier image %r: il sera copié à la place" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Options basiques du projet." -#: builders/_epub_base.py:465 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "impossible d'écrire le fichier image %r: %s" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "nom du projet" -#: builders/_epub_base.py:477 -msgid "Pillow not found - copying image files" -msgstr "Pillow n'a pas été trouvé - copie des fichiers image" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "nom de l'auteur" -#: builders/_epub_base.py:512 -msgid "writing mimetype file..." -msgstr "écriture du type MIME du fichier ..." +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "version du projet" -#: builders/_epub_base.py:521 -msgid "writing META-INF/container.xml file..." -msgstr "écriture du fichier META-INF/container.xml..." +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "version du projet" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "Enregistrement du fichier content.opf..." +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "langue du document" -#: builders/_epub_base.py:590 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "type MIME inconnu pour %s, il sera ignoré" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "préfixe des fichiers source" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "nœud de niveau invalide" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "nom du document principal" -#: builders/_epub_base.py:764 -msgid "writing toc.ncx file..." -msgstr "Enregistrement du fichier toc.ncx..." +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "utilisé epub" -#: builders/_epub_base.py:793 -#, python-format -msgid "writing %s file..." -msgstr "fichier %s en cours d'écriture..." +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Options d'extension" -#: builders/changes.py:33 +#: cmd/quickstart.py:671 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "Le fichier d'aperçu se trouve dans %(outdir)s." +msgid "enable %s extension" +msgstr "autoriser l'extension %s" -#: builders/changes.py:60 -#, python-format -msgid "no changes in version %s." -msgstr "aucun changement dans la version %s" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "active l'emploi d'extensions quelconques" -#: builders/changes.py:62 -msgid "writing summary file..." -msgstr "écriture du fichier de résumé..." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Création des fichiers Batchfile et Makefile" -#: builders/changes.py:74 -msgid "Builtins" -msgstr "Fonctions de base" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "créer un fichier makefile" -#: builders/changes.py:76 -msgid "Module level" -msgstr "Module" +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "ne pas créer un fichier makefile" -#: builders/changes.py:128 -msgid "copying source files..." -msgstr "copie des fichiers sources..." +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "créer un fichier batch" -#: builders/changes.py:137 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "impossible de lire %r pour la création du changelog" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "ne pas créer un fichier batch" -#: util/rst.py:72 -#, python-format -msgid "default role %s not found" -msgstr "rôle par défaut %s introuvable" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "utiliser make-mode pour Makefile/make.bat" -#: util/docfields.py:95 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "Problème dans le domaine %s : le champ est censé utiliser le rôle '%s', mais ce rôle ne figure pas dans le domaine." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Gabarits de projet" -#: util/osutil.py:130 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "Tentative de copie interrompue de %s vers %s (le chemin de destination contient des données existantes)." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "répertoire des templates" -#: util/nodes.py:419 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "%r est obsolète pour les entrées d'index (à partir de l'entrée %r). Utilisez plutôt 'pair:%s'." +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "définissez une variable de template" -#: util/nodes.py:487 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "la table des matières contient des références à des fichiers inexistants %r" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "vous avez spécifiez \"quit\" , mais \"project\" ou \"author\" ne sont pas spécifiés." -#: util/nodes.py:701 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "exception pendant l’évaluation de l'expression de la directive only : %s" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Erreur : le chemin spécifié n'est pas un répertoire, ou les fichiers Sphinx existent déjà." -#: util/fileutil.py:74 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "Tentative de copie interrompue du modèle rendu %s vers %s (le chemin de destination contient des données existantes)." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart peut générer ces fichiers seulement dans un répertoire vide. Merci de spécifier un nouveau répertoire racine." -#: util/fileutil.py:89 +#: cmd/quickstart.py:810 #, python-format -msgid "Writing evaluated template result to %s" -msgstr "Écriture du résultat du modèle évalué dans %s" +msgid "Invalid template variable: %s" +msgstr "Variable de template invalide : %s" -#: util/inventory.py:170 +#: directives/other.py:119 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "l'inventaire <%s> contient des définitions dupliquées de %s" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "le motif global toctree %r ne correspond à aucun document" -#: util/inventory.py:185 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "l'inventaire <%s> contient des définitions multiples de %s" +msgid "toctree contains reference to excluded document %r" +msgstr "le toctree contient une référence à des documents exclus %r" -#: util/docutils.py:284 +#: directives/other.py:156 #, python-format -msgid "unknown directive or role name: %s:%s" -msgstr "nom de rôle ou de directive inconnu: %s:%s" +msgid "toctree contains reference to nonexisting document %r" +msgstr "la table des matières contient des références à des documents inexistants %r" -#: util/docutils.py:747 +#: directives/other.py:169 #, python-format -msgid "unknown node type: %r" -msgstr "type de node inconnu : %r" +msgid "duplicated entry found in toctree: %s" +msgstr "entrée dupliquée trouvée dans toctree: %s" -#: util/display.py:81 -msgid "skipped" -msgstr "ignoré" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Auteur de la section : " -#: util/display.py:86 -msgid "failed" -msgstr "échoué" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Auteur du module : " -#: util/i18n.py:103 -#, python-format -msgid "reading error: %s, %s" -msgstr "erreur de lecture : %s,%s" +#: directives/other.py:207 +msgid "Code author: " +msgstr "Auteur du code : " -#: util/i18n.py:110 -#, python-format -msgid "writing error: %s, %s" -msgstr "erreur d'écriture : %s,%s" +#: directives/other.py:209 +msgid "Author: " +msgstr "Auteur : " -#: util/i18n.py:138 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "locale_dir %s n'existe pas" +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "... le contenu de acks n'est pas une liste" -#: util/i18n.py:230 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Format de date invalide. Insérez la chaîne de caractères entre des guillemets simples si vous voulez l'afficher telle quelle : %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "... le contenu de hlist n'est pas une liste" -#: directives/patches.py:66 +#: directives/patches.py:70 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." @@ -2050,7 +2265,7 @@ msgstr "les espaces non blancs sont supprimés par dedent" msgid "Invalid caption: %s" msgstr "Légende invalide: %s" -#: directives/code.py:132 directives/code.py:297 directives/code.py:484 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "le numéro de ligne spécifiée est en dehors des limites (1-%d):%r" @@ -2065,7 +2280,7 @@ msgstr "Impossible d'utiliser les options \"%s\" et \"%s\" en même temps." msgid "Include file '%s' not found or reading it failed" msgstr "fichier inclus '%s' pas trouvé ou dont la lecture a échoué" -#: directives/code.py:234 +#: directives/code.py:235 #, python-format msgid "" "Encoding %r used for reading included file '%s' seems to be wrong, try " @@ -2086,55 +2301,147 @@ msgstr "On ne peut pas utiliser \"lineno-match\" avec un \"lines\" non contigu " msgid "Line spec %r: no lines pulled from include file %r" msgstr "Spécification de lignes %r : aucune ligne extraite du fichier inclus %r" -#: directives/other.py:122 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "le motif global toctree %r ne correspond à aucun document" +msgid "%b %d, %Y" +msgstr "%d %B %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Index" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "le titre de node rencontré n'est apparenté à aucun parmi section, topic, table, admonition ou sidebar" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Notes de bas de page" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "la légende n'est pas à l'intérieur de la figure." -#: directives/other.py:155 environment/adapters/toctree.py:355 +#: writers/texinfo.py:1303 #, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "le toctree contient une référence à des documents exclus %r" +msgid "unimplemented node type: %r" +msgstr "type de node non-implémenté : %r" -#: directives/other.py:158 environment/adapters/toctree.py:359 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "la table des matières contient des références à des documents inexistants %r" +msgid "[image: %s]" +msgstr "[image: %s]" -#: directives/other.py:171 +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[image]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "Lien vers cette définition" + +#: writers/html5.py:431 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "entrée dupliquée trouvée dans toctree: %s" +msgid "numfig_format is not defined for %s" +msgstr "numfig_format n'est pas défini %s" -#: directives/other.py:204 -msgid "Section author: " -msgstr "Auteur de la section : " +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "Aucun ID assigné au node %s" -#: directives/other.py:206 -msgid "Module author: " -msgstr "Auteur du module : " +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "Lien vers ce terme" -#: directives/other.py:208 -msgid "Code author: " -msgstr "Auteur du code : " +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "Lien vers cette rubrique" -#: directives/other.py:210 -msgid "Author: " -msgstr "Auteur : " +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "Lien vers ce tableau" -#: directives/other.py:284 -msgid ".. acks content is not a list" -msgstr "... le contenu de acks n'est pas une liste" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "niveau de rubrique non pris en charge : %s" -#: directives/other.py:309 -msgid ".. hlist content is not a list" -msgstr "... le contenu de hlist n'est pas une liste" +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "Lien vers ce code" + +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "Lien vers cette image" + +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "Lien vers cette table des matières" + +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "impossible d'obtenir la taille de l'image. L'option :scale: est ignorée." + +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "toplevel_sectioning %r inconnu pour la classe %r" + +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" +msgstr "Aucune option Babel disponible pour la langue %r" + +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":maxdepth: trop grand, ignoré." + +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" +msgstr "modèle %s introuvable ; chargement à partir de l'ancien %s à la place" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "le titre du document n'est pas un unique node de type Text" + +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "options tabularcolumns et :widths: simultanément présentes. :widths: sera ignoré." + +#: writers/latex.py:1228 +#, python-format +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "colspec %s a été donné, qui semble utiliser la syntaxe tabulary. Mais ce tableau ne peut pas être rendu comme un tabulary ; le colspec donné sera ignoré." + +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "%s est invalide comme unité de dimension. Ignoré." + +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "le type inconnu d’entrée d’index %s a été trouvé" #: _cli/__init__.py:73 msgid "Usage:" msgstr "Usage :" #: _cli/__init__.py:75 +#, python-brace-format msgid "{0} [OPTIONS] []" msgstr "{0} [OPTIONS] []" @@ -2150,1993 +2457,1877 @@ msgstr "Commandes:" msgid "Options" msgstr "Options" -#: _cli/__init__.py:112 _cli/__init__.py:183 +#: _cli/__init__.py:113 _cli/__init__.py:181 msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "Pour plus d'informations, consultez le site https://www.sphinx-doc.org/en/master/man/." -#: _cli/__init__.py:172 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" "{0}: error: {1}\n" "Run '{0} --help' for information" msgstr "{0}: erreur : {1}\nExécuter '{0} --help' pour information" -#: _cli/__init__.py:182 +#: _cli/__init__.py:179 msgid " Manage documentation with Sphinx." msgstr " Gérer la documentation avec Sphinx." -#: _cli/__init__.py:194 +#: _cli/__init__.py:191 msgid "Show the version and exit." msgstr "Afficher la version et quitter." -#: _cli/__init__.py:202 +#: _cli/__init__.py:199 msgid "Show this message and exit." msgstr "Afficher ce message et quitter." -#: _cli/__init__.py:206 +#: _cli/__init__.py:203 msgid "Logging" msgstr "Journalisation" -#: _cli/__init__.py:213 +#: _cli/__init__.py:210 msgid "Increase verbosity (can be repeated)" msgstr "Augmenter la verbosité (peut être répété)" -#: _cli/__init__.py:221 +#: _cli/__init__.py:218 msgid "Only print errors and warnings." msgstr "N'imprimez que les erreurs et les avertissements." -#: _cli/__init__.py:228 +#: _cli/__init__.py:225 msgid "No output at all" msgstr "Pas de sortie du tout" -#: _cli/__init__.py:234 +#: _cli/__init__.py:231 msgid "" msgstr "" -#: _cli/__init__.py:265 +#: _cli/__init__.py:263 msgid "See 'sphinx --help'.\n" msgstr "Voir 'sphinx --help'.\n" -#: builders/html/__init__.py:486 builders/latex/__init__.py:198 -#: transforms/__init__.py:133 writers/manpage.py:102 writers/texinfo.py:219 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %B %Y" - -#: transforms/__init__.py:143 -msgid "could not calculate translation progress!" -msgstr "impossible de calculer l'avancement de la traduction !" - -#: transforms/__init__.py:148 -msgid "no translated elements!" -msgstr "pas d'éléments traduits !" - -#: transforms/__init__.py:267 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "index trouvé avec style ancien à 4 colonnes. Possiblement un bogue d’extensions que vous utilisez : %r" - -#: transforms/__init__.py:313 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "La note de bas de page [%s] n'est pas référencée." - -#: transforms/__init__.py:322 -msgid "Footnote [*] is not referenced." -msgstr "La note de bas de page [*] n'est pas référencée." - -#: transforms/__init__.py:333 -msgid "Footnote [#] is not referenced." -msgstr "La note de bas de page [#] n'est pas référencée." - -#: transforms/i18n.py:228 transforms/i18n.py:303 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "incohérences de références de notes de bas de page dans le message traduit. Original : {0}, traduit : {1} " -#: transforms/i18n.py:273 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "incohérences de références dans le message traduit. Original : {0}, traduit : {1}" -#: transforms/i18n.py:323 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "incohérences de références de citation dans le message traduit. Original : {0}, traduit : {1}" -#: transforms/i18n.py:345 -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "incohérences de références de terme dans le message traduit. Original : {0}, traduit : {1}" - -#: ext/linkcode.py:75 ext/viewcode.py:201 -msgid "[source]" -msgstr "[source]" - -#: ext/imgconverter.py:40 -#, python-format -msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "Impossible d’exécuter la commande de conversion d'image %r. 'sphinx.ext.imgconverter' nécessite par défaut ImageMagick. Assurez-vous que ce dernier est installé, ou configurez l’option 'image_converter' pour faire référence à une commande de conversion ad hoc.\n\nTrace d’appels : %s" - -#: ext/imgconverter.py:49 ext/imgconverter.py:73 -#, python-format -msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "convert a terminé avec une erreur :\n[stderr]\n%r\n[stdout]\n%r" - -#: ext/imgconverter.py:68 -#, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "la commande convert %r ne peut pas être exécutée; vérifiez le paramètre image_converter" - -#: ext/viewcode.py:258 -msgid "highlighting module code... " -msgstr "Coloration syntaxique du code du module..." - -#: ext/viewcode.py:286 -msgid "[docs]" -msgstr "[docs]" - -#: ext/viewcode.py:306 -msgid "Module code" -msgstr "Code du module" - -#: ext/viewcode.py:312 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Code source de %s

        " - -#: ext/viewcode.py:338 -msgid "Overview: module code" -msgstr "Vue d'ensemble : code du module" - -#: ext/viewcode.py:339 -msgid "

        All modules for which code is available

        " -msgstr "

        Modules pour lesquels le code est disponible

        " - -#: ext/coverage.py:47 -#, python-format -msgid "invalid regex %r in %s" -msgstr "regex invalide %r dans %s" - -#: ext/coverage.py:134 ext/coverage.py:280 -#, python-format -msgid "module %s could not be imported: %s" -msgstr "le module %s ne pas être importé : %s" - -#: ext/coverage.py:141 -#, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "les modules suivants sont documentés mais n'ont pas été spécifiés dans coverage_modules : %s" - -#: ext/coverage.py:149 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" -msgstr "les modules suivants sont spécifiés dans coverage_modules mais n'ont pas été documentés" - -#: ext/coverage.py:163 -#, python-format +#: transforms/i18n.py:347 +#, python-brace-format msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." -msgstr "Vérification du taux de couverture documentaire dans les sources achevée, voir les résultats dans %(outdir)spython.txt." +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "incohérences de références de terme dans le message traduit. Original : {0}, traduit : {1}" -#: ext/coverage.py:177 -#, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "regex invalide %r dans coverage_c_regexes" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "impossible de calculer l'avancement de la traduction !" -#: ext/coverage.py:245 -#, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "API C non documentée : %s [%s] dans le fichier %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "pas d'éléments traduits !" -#: ext/coverage.py:429 +#: transforms/__init__.py:258 #, python-format -msgid "undocumented python function: %s :: %s" -msgstr "fonction python non documentée: %s :: %s" +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "index trouvé avec style ancien à 4 colonnes. Possiblement un bogue d’extensions que vous utilisez : %r" -#: ext/coverage.py:445 +#: transforms/__init__.py:299 #, python-format -msgid "undocumented python class: %s :: %s" -msgstr "classe python non documentée: %s :: %s" +msgid "Footnote [%s] is not referenced." +msgstr "La note de bas de page [%s] n'est pas référencée." -#: ext/coverage.py:458 -#, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "méthode python non documentée: %s :: %s :: %s" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "La note de bas de page [*] n'est pas référencée." -#: ext/todo.py:71 -msgid "Todo" -msgstr "À faire" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "La note de bas de page [#] n'est pas référencée." -#: ext/todo.py:104 +#: util/inventory.py:147 #, python-format -msgid "TODO entry found: %s" -msgstr "Entrée TODO trouvée : %s" - -#: ext/todo.py:163 -msgid "<>" -msgstr "<>" +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "l'inventaire <%s> contient des définitions dupliquées de %s" -#: ext/todo.py:165 +#: util/inventory.py:166 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(l'<> se trouve dans %s, à la ligne %d)" - -#: ext/todo.py:175 -msgid "original entry" -msgstr "entrée originale" +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "l'inventaire <%s> contient des définitions multiples de %s" -#: ext/extlinks.py:82 +#: util/i18n.py:100 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "le lien %r codé en dur pourrait être remplacé par un extlink (essayez d'utiliser %r à la place)" +msgid "reading error: %s, %s" +msgstr "erreur de lecture : %s,%s" -#: ext/doctest.py:115 +#: util/i18n.py:113 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "option '+' ou '-' manquante dans %s." +msgid "writing error: %s, %s" +msgstr "erreur d'écriture : %s,%s" -#: ext/doctest.py:120 +#: util/i18n.py:146 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' n'est pas une option valide." +msgid "locale_dir %s does not exist" +msgstr "locale_dir %s n'existe pas" -#: ext/doctest.py:134 +#: util/i18n.py:244 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "%s n'est pas une option pyversion valide" - -#: ext/doctest.py:220 -msgid "invalid TestCode type" -msgstr "type invalide de TestCode" +msgid "Invalid Babel locale: %r." +msgstr "Locale Babel non valide : %r." -#: ext/doctest.py:281 +#: util/i18n.py:253 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Exécution des doctests des sources achevée, voir les résultats dans %(outdir)s/output.txt." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Format de date invalide. Insérez la chaîne de caractères entre des guillemets simples si vous voulez l'afficher telle quelle : %s" -#: ext/doctest.py:434 +#: util/osutil.py:131 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "pas de code ou sortie dans le bloc %s en %s : %s" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "Tentative de copie interrompue de %s vers %s (le chemin de destination contient des données existantes)." -#: ext/doctest.py:522 -#, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "code doctest invalide sera ignoré : %r" +#: util/display.py:82 +msgid "skipped" +msgstr "ignoré" -#: ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" -msgstr "La directive Graphviz ne peut pas avoir simultanément du contenu et un argument de nom de fichier" +#: util/display.py:87 +msgid "failed" +msgstr "échoué" -#: ext/graphviz.py:145 +#: util/docutils.py:325 #, python-format -msgid "External Graphviz file %r not found or reading it failed" -msgstr "Fichier externe Graphviz %r non trouvé ou échec de sa lecture" +msgid "unknown directive name: %s" +msgstr "nom de directive inconnu : %s" -#: ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." -msgstr "Directive « graphviz » sans contenu ignorée." +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "nom de rôle inconnu : %s" -#: ext/graphviz.py:268 +#: util/docutils.py:805 #, python-format -msgid "graphviz_dot executable path must be set! %r" -msgstr "Le chemin de l'exécutable de graphviz_dot doit être défini ! %r" +msgid "unknown node type: %r" +msgstr "type de node inconnu : %r" -#: ext/graphviz.py:303 +#: util/fileutil.py:76 #, python-format msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" -msgstr "la commande dot %r ne peut pas être exécutée (nécessaire pour le rendu graphviz). Vérifiez le paramètre graphviz_dot" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "Tentative de copie interrompue du modèle rendu %s vers %s (le chemin de destination contient des données existantes)." -#: ext/graphviz.py:310 +#: util/fileutil.py:89 #, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "dot a terminé avec une erreur :\n[stderr]\n%r\n[stdout]\n%r" +msgid "Writing evaluated template result to %s" +msgstr "Écriture du résultat du modèle évalué dans %s" -#: ext/graphviz.py:313 +#: util/docfields.py:103 #, python-format msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "dot n'a pas produit de fichier de sortie : \n[stderr]\n%r\n[stdout]\n%r" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "Problème dans le domaine %s : le champ est censé utiliser le rôle '%s', mais ce rôle ne figure pas dans le domaine." -#: ext/graphviz.py:329 +#: util/rst.py:73 #, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" -msgstr "graphviz_output_format doit être « png » ou « svg », mais est %r" +msgid "default role %s not found" +msgstr "rôle par défaut %s introuvable" -#: ext/graphviz.py:333 ext/graphviz.py:386 ext/graphviz.py:423 +#: util/nodes.py:462 #, python-format -msgid "dot code %r: %s" -msgstr "dot code %r: %s" +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "%r n'est plus pris en charge pour les entrées d'index (à partir de l'entrée %r). Utilisez 'pair: %s' à la place." -#: ext/graphviz.py:436 ext/graphviz.py:444 +#: util/nodes.py:523 #, python-format -msgid "[graph: %s]" -msgstr "[graphe: %s]" - -#: ext/graphviz.py:438 ext/graphviz.py:446 -msgid "[graph]" -msgstr "[graphe]" - -#: ext/imgmath.py:369 ext/mathjax.py:52 -msgid "Link to this equation" -msgstr "Lien vers cette équation" +msgid "toctree contains ref to nonexisting file %r" +msgstr "la table des matières contient des références à des fichiers inexistants %r" -#: ext/apidoc.py:85 +#: util/nodes.py:739 #, python-format -msgid "Would create file %s." -msgstr "Créerait le fichier %s." - -#: ext/apidoc.py:375 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nCherche récursivement dans des modules et packages Python et crée\ndans un fichier reST par package avec des directives automodule.\n\nLes s peuvent être tout pattern de fichiers et/ou de répertoires à exclure.\n\nNote : par défaut ce script n'écrasera pas des fichiers déjà créés." - -#: ext/apidoc.py:392 -msgid "path to module to document" -msgstr "chemin vers le module à documenter" - -#: ext/apidoc.py:396 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "patterns de fichier fnmatch-style et/ou répertoire à exclure" - -#: ext/apidoc.py:407 -msgid "directory to place all output" -msgstr "répertoire où placer toutes les sorties" +msgid "exception while evaluating only directive expression: %s" +msgstr "exception pendant l’évaluation de l'expression de la directive only : %s" -#: ext/apidoc.py:422 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "Nombre maximum de sous-modules visibles dans la table des matières (par défaut : 4)" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "suite de la page précédente" -#: ext/apidoc.py:429 -msgid "overwrite existing files" -msgstr "remplacer les fichiers existants" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "suite sur la page suivante" -#: ext/apidoc.py:437 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "suivre les liens symboliques. Très utile en combinaison avec collective.recipe.omelette." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "Non alphabétique" -#: ext/apidoc.py:446 -msgid "run the script without creating files" -msgstr "exécuter le script sans créer les fichiers" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Symboles" -#: ext/apidoc.py:453 -msgid "put documentation for each module on its own page" -msgstr "afficher la documentation de chaque module sur sa propre page" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Chiffres" -#: ext/apidoc.py:460 -msgid "include \"_private\" modules" -msgstr "inclure le module \"_private\"" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "page" -#: ext/apidoc.py:467 -msgid "filename of table of contents (default: modules)" -msgstr "nom du fichier de table des matières (défaut : modules)" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Version" -#: ext/apidoc.py:474 -msgid "don't create a table of contents file" -msgstr "ne pas créer de fichier de table des matières" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "impossible d'atteindre l'image distante %s[%s]" -#: ext/apidoc.py:481 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "ne pas créer de titres pour le module ou package (e.g. lorsque les doctrings en fournissent déjà)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "impossible d'atteindre l'image distante %s[%d]" -#: ext/apidoc.py:492 -msgid "put module documentation before submodule documentation" -msgstr "mettre la documentation du module avant celle du sous-module" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Format d'image inconnu : %s..." -#: ext/apidoc.py:498 +#: transforms/post_transforms/__init__.py:88 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "interprète les chemins de module selon la spécification PEP-0420 des espaces implicites de noms" - -#: ext/apidoc.py:508 -msgid "file suffix (default: rst)" -msgstr "extension du fichier (par défaut : rst)" - -#: ext/apidoc.py:515 ext/autosummary/generate.py:839 -msgid "Remove existing files in the output directory that were not generated" -msgstr "Supprimer les fichiers existants dans le répertoire de sortie qui n'ont pas été générés" - -#: ext/apidoc.py:524 -msgid "generate a full project with sphinx-quickstart" -msgstr "générer un projet complet avec sphinx-quickstart" - -#: ext/apidoc.py:531 -msgid "append module_path to sys.path, used when --full is given" -msgstr "ajoute module_path à la fin de sys.path, utilisé lorsque --full est présent" - -#: ext/apidoc.py:538 -msgid "project name (default: root module name)" -msgstr "nom du projet (par défaut : nom du module principal)" - -#: ext/apidoc.py:545 -msgid "project author(s), used when --full is given" -msgstr "auteur(s) du projet, utilisé quand l'option -full est précisée" - -#: ext/apidoc.py:552 -msgid "project version, used when --full is given" -msgstr "version du projet, utilisé quand l'option -full est précisée" - -#: ext/apidoc.py:559 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "révision du projet, utilisé lorsque --full est présent, par défaut reprend --doc-version" - -#: ext/apidoc.py:564 -msgid "extension options" -msgstr "options relatives aux extensions" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "Impossible de déterminer le texte de remplacement pour le renvoi. Il peut s'agir d'un bogue." -#: ext/apidoc.py:638 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "%s is not a directory." -msgstr "%s n'est pas un répertoire" +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "plus d'une cible trouvée pour la référence %r de type 'any' : pourrait être %s" -#: ext/apidoc.py:710 ext/autosummary/generate.py:875 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "Failed to remove %s: %s" -msgstr "Échec de la suppression de %s: %s" +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s cible de référence non trouvée : %s" -#: ext/autosectionlabel.py:48 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "la section \"%s\" est étiquettée \"%s\"" +msgid "%r reference target not found: %s" +msgstr "%r cible de référence non trouvée : %s" -#: domains/std/__init__.py:703 domains/std/__init__.py:812 -#: ext/autosectionlabel.py:52 -#, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "libellé dupliqué %s, l'autre instance se trouve dans %s" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "Interrompu !" + +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "erreur de balisage reStructuredText !" + +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "Erreur d'encodage !" -#: ext/duration.py:85 +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "Erreur de récursivité !" + +#: _cli/util/errors.py:207 msgid "" -"====================== slowest reading durations =======================" -msgstr "====================== durées de lecture les plus lentes =======================" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "Cela peut se produire dans le cas de fichiers sources très volumineux ou profondément imbriqués. Vous pouvez soigneusement augmenter la limite de récursivité de 1 000 par défaut de Python dans conf.py avec par exemple :" -#: ext/imgmath.py:159 -#, python-format +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "Démarrage du débogueur :" + +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "La trace complète a été sauvegardée dans :" + +#: _cli/util/errors.py:240 msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "La commande LaTeX %r (nécessaire pour le rendu des équations mathématiques), ne peut pas être exécutée, vérifier le paramètre imgmath_latex" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "Pour signaler cette erreur aux développeurs, veuillez ouvrir un ticket à l'adresse . Merci !" -#: ext/imgmath.py:174 -#, python-format +#: _cli/util/errors.py:246 msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "La commande de %s, %r, ne pas être exécuté (nécessaire pour display mathématique), vérifier la configuration imgmath_%s" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Merci de rapporter ceci s'il s'agit d'une erreur utilisateur, afin d'améliorer le message d'erreur à l'avenir." -#: ext/imgmath.py:328 -#, python-format -msgid "display latex %r: %s" -msgstr "latex de type display %r : %s" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Réduire la barre latérale" -#: ext/imgmath.py:362 +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigation" + +#: themes/basic/layout.html:115 #, python-format -msgid "inline latex %r: %s" -msgstr "latex en ligne %r : %s" +msgid "Search within %(docstitle)s" +msgstr "Recherchez dans %(docstitle)s" -#: writers/latex.py:1090 writers/manpage.py:263 writers/texinfo.py:662 -msgid "Footnotes" -msgstr "Notes de bas de page" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "À propos de ces documents" -#: writers/manpage.py:309 writers/text.py:936 -#, python-format -msgid "[image: %s]" -msgstr "[image: %s]" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Recherche" -#: writers/manpage.py:310 writers/text.py:937 -msgid "[image]" -msgstr "[image]" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" -#: writers/html5.py:99 writers/html5.py:108 -msgid "Link to this definition" -msgstr "Lien vers cette définition" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." -#: writers/html5.py:415 +#: themes/basic/layout.html:201 #, python-format -msgid "numfig_format is not defined for %s" -msgstr "numfig_format n'est pas défini %s" +msgid "Last updated on %(last_updated)s." +msgstr "Mis à jour le %(last_updated)s." -#: writers/html5.py:427 +#: themes/basic/layout.html:204 #, python-format -msgid "Any IDs not assigned for %s node" -msgstr "Aucun ID assigné au node %s" +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Créé en utilisant Sphinx %(sphinx_version)s." -#: writers/html5.py:482 -msgid "Link to this term" -msgstr "Lien vers ce terme" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Sujet précédent" -#: writers/html5.py:525 writers/html5.py:530 -msgid "Link to this heading" -msgstr "Lien vers cette rubrique" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "Chapitre précédent" -#: writers/html5.py:535 -msgid "Link to this table" -msgstr "Lien vers ce tableau" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Sujet suivant" -#: writers/html5.py:549 writers/latex.py:1099 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "niveau de rubrique non pris en charge : %s" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "Chapitre suivant" -#: writers/html5.py:613 -msgid "Link to this code" -msgstr "Lien vers ce code" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "Index – %(key)s" -#: writers/html5.py:615 -msgid "Link to this image" -msgstr "Lien vers cette image" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Index complet sur une seule page" -#: writers/html5.py:617 -msgid "Link to this toctree" -msgstr "Lien vers cette table des matières" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Cette page" -#: writers/html5.py:758 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "impossible d'obtenir la taille de l'image. L'option :scale: est ignorée." +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "Montrer le code source" -#: builders/latex/__init__.py:205 domains/std/__init__.py:646 -#: domains/std/__init__.py:658 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:513 -msgid "Index" -msgstr "Index" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Recherche rapide" -#: writers/latex.py:743 writers/texinfo.py:644 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "le titre de node rencontré n'est apparenté à aucun parmi section, topic, table, admonition ou sidebar" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Go" -#: writers/texinfo.py:1216 -msgid "caption not inside a figure." -msgstr "la légende n'est pas à l'intérieur de la figure." +#: themes/basic/defindex.html:4 +msgid "Overview" +msgstr "Résumé" -#: writers/texinfo.py:1302 -#, python-format -msgid "unimplemented node type: %r" -msgstr "type de node non-implémenté : %r" +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" +msgstr "Bienvenue ! Ceci est" -#: writers/latex.py:360 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "toplevel_sectioning %r inconnu pour la classe %r" +#: themes/basic/defindex.html:9 +msgid "the documentation for" +msgstr "la documentation pour" -#: builders/latex/__init__.py:223 writers/latex.py:410 -#, python-format -msgid "no Babel option known for language %r" -msgstr "Aucune option Babel disponible pour la langue %r" +#: themes/basic/defindex.html:10 +msgid "last updated" +msgstr "dernière modification" -#: writers/latex.py:428 -msgid "too large :maxdepth:, ignored." -msgstr ":maxdepth: trop grand, ignoré." +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" +msgstr "Index et tables :" -#: writers/latex.py:590 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "modèle %s introuvable ; chargement à partir de l'ancien %s à la place" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "Table des matières complète" -#: writers/latex.py:708 -msgid "document title is not a single Text node" -msgstr "le titre du document n'est pas un unique node de type Text" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "lister l'ensemble des sections et sous-sections" -#: writers/latex.py:1175 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "options tabularcolumns et :widths: simultanément présentes. :widths: sera ignoré." +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "Page de recherche" -#: writers/latex.py:1573 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "%s est invalide comme unité de dimension. Ignoré." +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "rechercher dans cette documentation" -#: writers/latex.py:1931 -#, python-format -msgid "unknown index entry type %s found" -msgstr "le type inconnu d’entrée d’index %s a été trouvé" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "Index général des modules" -#: domains/std/__init__.py:87 domains/std/__init__.py:104 -#, python-format -msgid "environment variable; %s" -msgstr "variable d'environnement; %s" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "accès rapide à l'ensemble des modules" -#: domains/std/__init__.py:112 -#, python-format -msgid "%s; configuration value" -msgstr "%s; valeur de configuration" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Index général" -#: domains/std/__init__.py:166 -msgid "Type" -msgstr "Type" +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "toutes les fonctions, classes, termes" -#: domains/std/__init__.py:176 -msgid "Default" -msgstr "Défaut" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Table des matières" -#: domains/std/__init__.py:235 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "description de l'option malformée, elle doit ressembler à \nMalformed option description %r, should look like \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" or \"+opt args\"" +msgid "Search %(docstitle)s" +msgstr "Rechercher %(docstitle)s" -#: domains/std/__init__.py:306 -#, python-format -msgid "%s command line option" -msgstr "option de ligne de commande %s" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Indexer les pages par lettre" -#: domains/std/__init__.py:308 -msgid "command line option" -msgstr "option de ligne de commande" +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "peut être énorme" -#: domains/std/__init__.py:430 -msgid "glossary term must be preceded by empty line" -msgstr "le terme du glossaire doit être précédé d'une ligne vide" +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." +msgstr "Veuillez activer le JavaScript pour que la recherche fonctionne." -#: domains/std/__init__.py:438 -msgid "glossary terms must not be separated by empty lines" -msgstr "les termes du glossaire ne doivent pas être séparés par des lignes vides" +#: themes/basic/search.html:28 +msgid "" +"Searching for multiple words only shows matches that contain\n" +" all words." +msgstr "Une recherche sur plusieurs mots ne retourne que les résultats contenant tous les mots." -#: domains/std/__init__.py:444 domains/std/__init__.py:457 -msgid "glossary seems to be misformatted, check indentation" -msgstr "le glossaire semble être mal formaté; vérifiez l'indentation" +#: themes/basic/search.html:35 +msgid "search" +msgstr "rechercher" -#: domains/std/__init__.py:602 -msgid "glossary term" -msgstr "terme du glossaire" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Contenu" -#: domains/std/__init__.py:603 -msgid "grammar token" -msgstr "élément de grammaire" +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "Résultats de la recherche" -#: domains/std/__init__.py:604 -msgid "reference label" -msgstr "étiquette de référence" +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." +msgstr "Votre recherche ne correspond à aucun document. Veuillez vérifier que les mots sont correctement orthographiés et que vous avez sélectionné assez de catégories." -#: domains/std/__init__.py:607 -msgid "environment variable" -msgstr "variable d'environnement" +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "La recherche est terminée, une page correspondant à la requête a été trouvée." +msgstr[1] "Recherche terminée, ${resultCount} pages trouvées correspondant à la requête." +msgstr[2] "Recherche terminée, ${resultCount} pages trouvées correspondant à la requête." -#: domains/std/__init__.py:608 -msgid "program option" -msgstr "option du programme" +#: themes/basic/static/searchtools.js:276 +msgid "Searching" +msgstr "Recherche en cours" -#: domains/std/__init__.py:609 -msgid "document" -msgstr "document" +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "Préparation de la recherche..." -#: domains/std/__init__.py:647 domains/std/__init__.py:659 -msgid "Module Index" -msgstr "Index du module" +#: themes/basic/static/searchtools.js:526 +msgid ", in " +msgstr ", dans " -#: domains/std/__init__.py:648 domains/std/__init__.py:660 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "Page de recherche" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Cacher les résultats de la recherche" -#: domains/std/__init__.py:722 +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 #, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "description %s dupliquée pour %s; l'autre instance se trouve dans %s" - -#: domains/std/__init__.py:932 -msgid "numfig is disabled. :numref: is ignored." -msgstr "le paramètre numfig est désactivé : le paramètre :numref: est ignoré" +msgid "Changes in Version %(version)s — %(docstitle)s" +msgstr "Changements dans la version %(version)s — %(docstitle)s" -#: domains/std/__init__.py:940 +#: themes/basic/changes/rstsource.html:5 #, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "Impossible de créer une référence croisée. Aucun nombre n'est attribué: %s" +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" -#: domains/std/__init__.py:952 +#: themes/basic/changes/versionchanges.html:17 #, python-format -msgid "the link has no caption: %s" -msgstr "le lien n'a pas de légende : %s" +msgid "Automatically generated list of changes in version %(version)s" +msgstr "Liste auto-générée des modifications dans la version %(version)s" -#: domains/std/__init__.py:966 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "numfig_format invalide : %s (%r)" +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" +msgstr "Modifications de la bibliothèque" -#: domains/std/__init__.py:969 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "numfig_format invalide : %s" +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" +msgstr "Modifications de l'API C" -#: domains/std/__init__.py:1200 -#, python-format -msgid "undefined label: %r" -msgstr "label non défini: %r" +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" +msgstr "Autres modifications" -#: domains/std/__init__.py:1202 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "Échec de création d'une référence. Ni titre ni légende trouvé : %r" +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" +msgstr "Agrandir la barre latérale" + +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" +msgstr "Séparateur de paramètres positionnels uniquement (PEP 570)" + +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "Séparateur de paramètres par mot-clé uniquement (PEP 3102)" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Paramètres" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variables" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Lève" -#: domains/python/__init__.py:107 domains/python/__init__.py:244 +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (dans le module %s)" -#: domains/python/__init__.py:167 domains/python/__init__.py:334 -#: domains/python/__init__.py:385 domains/python/__init__.py:424 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (dans le module %s)" -#: domains/python/__init__.py:169 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (variable de base)" -#: domains/python/__init__.py:194 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (classe de base)" -#: domains/python/__init__.py:195 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (classe dans %s)" -#: domains/python/__init__.py:249 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (méthode de la classe %s)" -#: domains/python/__init__.py:251 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (méthode statique %s)" -#: domains/python/__init__.py:389 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (propriété %s)" -#: domains/python/__init__.py:428 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "%s (type alias dans %s)" -#: domains/python/__init__.py:559 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Index des modules Python" -#: domains/python/__init__.py:560 +#: domains/python/__init__.py:625 msgid "modules" msgstr "modules" -#: domains/python/__init__.py:637 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Obsolète" -#: domains/python/__init__.py:663 +#: domains/python/__init__.py:729 msgid "exception" msgstr "exception" -#: domains/python/__init__.py:665 +#: domains/python/__init__.py:731 msgid "class method" msgstr "méthode de classe" -#: domains/python/__init__.py:666 +#: domains/python/__init__.py:732 msgid "static method" msgstr "méthode statique" -#: domains/python/__init__.py:668 +#: domains/python/__init__.py:734 msgid "property" msgstr "propriété" -#: domains/python/__init__.py:669 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "type alias" -#: domains/python/__init__.py:729 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "description dupliquée de l'objet %s, autre instance dans %s, utiliser :no-index: pour l'un d'eux" -#: domains/python/__init__.py:858 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "plusieurs cibles trouvées pour le renvoi %r : %s" -#: domains/python/__init__.py:920 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (obsolète)" -#: domains/c/__init__.py:304 domains/cpp/__init__.py:441 -#: domains/python/_object.py:164 ext/napoleon/docstring.py:786 -msgid "Parameters" -msgstr "Paramètres" - -#: domains/python/_object.py:169 -msgid "Variables" -msgstr "Variables" - -#: domains/python/_object.py:173 -msgid "Raises" -msgstr "Lève" - -#: domains/c/__init__.py:199 +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 #, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "Déclaration C++ dupliquée, également définie à %s:%s.\nLa déclaration est '.. cpp:%s:: %s'." + +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" +msgstr "Paramètres du modèle" -#: domains/c/__init__.py:260 domains/c/_symbol.py:510 +#: domains/cpp/__init__.py:302 #, python-format -msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." -msgstr "Déclaration C dupliquée, également définie à %s:%s.\nLa déclaration est '.. c:%s:: %s'." +msgid "%s (C++ %s)" +msgstr "%s (C++ %s)" -#: domains/c/__init__.py:307 domains/cpp/__init__.py:454 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "Valeurs retournées" -#: domains/c/__init__.py:679 domains/cpp/__init__.py:860 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "union" + +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "membre" -#: domains/c/__init__.py:680 -msgid "variable" -msgstr "variable" - -#: domains/c/__init__.py:682 -msgid "macro" -msgstr "macro" - -#: domains/c/__init__.py:683 -msgid "struct" -msgstr "structure" +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "type" -#: domains/c/__init__.py:684 domains/cpp/__init__.py:858 -msgid "union" -msgstr "union" +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "concept" -#: domains/c/__init__.py:685 domains/cpp/__init__.py:863 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "énumération" -#: domains/c/__init__.py:686 domains/cpp/__init__.py:864 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "énumérateur" -#: domains/c/__init__.py:687 domains/cpp/__init__.py:861 -msgid "type" -msgstr "type" - -#: domains/c/__init__.py:689 domains/cpp/__init__.py:866 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "paramètre de fonction" -#: domains/cpp/__init__.py:155 -msgid "Template Parameters" -msgstr "Paramètres du modèle" - -#: domains/cpp/__init__.py:277 -#, python-format -msgid "%s (C++ %s)" -msgstr "%s (C++ %s)" - -#: domains/cpp/__init__.py:360 domains/cpp/_symbol.py:793 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "Déclaration C++ dupliquée, également définie à %s:%s.\nLa déclaration est '.. cpp:%s:: %s'." - -#: domains/cpp/__init__.py:862 -msgid "concept" -msgstr "concept" - -#: domains/cpp/__init__.py:867 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "paramètre du modèle" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Contenu" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Table des matières" - -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Recherche" - -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Go" - -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "Montrer le code source" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Réduire la barre latérale" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigation" - -#: themes/basic/layout.html:115 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format -msgid "Search within %(docstitle)s" -msgstr "Recherchez dans %(docstitle)s" +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." +msgstr "Déclaration C dupliquée, également définie à %s:%s.\nLa déclaration est '.. c:%s:: %s'." -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "À propos de ces documents" +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "variable" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "© %(copyright_prefix)s %(copyright)s." +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "macro" -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Mis à jour le %(last_updated)s." +#: domains/c/__init__.py:781 +msgid "struct" +msgstr "structure" -#: themes/basic/layout.html:204 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Créé en utilisant Sphinx %(sphinx_version)s." +msgid "environment variable; %s" +msgstr "variable d'environnement; %s" -#: themes/basic/genindex-single.html:26 +#: domains/std/__init__.py:116 #, python-format -msgid "Index – %(key)s" -msgstr "Index – %(key)s" +msgid "%s; configuration value" +msgstr "%s; valeur de configuration" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Index complet sur une seule page" +#: domains/std/__init__.py:172 +msgid "Type" +msgstr "Type" -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Indexer les pages par lettre" +#: domains/std/__init__.py:182 +msgid "Default" +msgstr "Défaut" -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "peut être énorme" +#: domains/std/__init__.py:239 +#, python-format +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" +msgstr "description de l'option malformée, elle doit ressembler à \nMalformed option description %r, should look like \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" or \"+opt args\"" -#: themes/basic/opensearch.xml:4 +#: domains/std/__init__.py:319 #, python-format -msgid "Search %(docstitle)s" -msgstr "Rechercher %(docstitle)s" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Cette page" - -#: themes/basic/defindex.html:4 -msgid "Overview" -msgstr "Résumé" +msgid "%s command line option" +msgstr "option de ligne de commande %s" -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" -msgstr "Bienvenue ! Ceci est" +#: domains/std/__init__.py:321 +msgid "command line option" +msgstr "option de ligne de commande" -#: themes/basic/defindex.html:9 -msgid "the documentation for" -msgstr "la documentation pour" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" +msgstr "le terme du glossaire doit être précédé d'une ligne vide" -#: themes/basic/defindex.html:10 -msgid "last updated" -msgstr "dernière modification" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" +msgstr "les termes du glossaire ne doivent pas être séparés par des lignes vides" -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" -msgstr "Index et tables :" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "le glossaire semble être mal formaté; vérifiez l'indentation" -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" -msgstr "Table des matières complète" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "terme du glossaire" -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "lister l'ensemble des sections et sous-sections" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "élément de grammaire" -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "rechercher dans cette documentation" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "étiquette de référence" -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "Index général des modules" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "variable d'environnement" -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "accès rapide à l'ensemble des modules" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "option du programme" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Index général" +#: domains/std/__init__.py:735 +msgid "document" +msgstr "document" -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "toutes les fonctions, classes, termes" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Index du module" -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Recherche rapide" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" +msgstr "description %s dupliquée pour %s; l'autre instance se trouve dans %s" -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." -msgstr "Veuillez activer le JavaScript pour que la recherche fonctionne." +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "le paramètre numfig est désactivé : le paramètre :numref: est ignoré" -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." -msgstr "Une recherche sur plusieurs mots ne retourne que les résultats contenant tous les mots." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" +msgstr "Impossible de créer une référence croisée. Aucun nombre n'est attribué: %s" -#: themes/basic/search.html:35 -msgid "search" -msgstr "rechercher" +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" +msgstr "le lien n'a pas de légende : %s" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Sujet précédent" +#: domains/std/__init__.py:1153 +#, python-format +msgid "invalid numfig_format: %s (%r)" +msgstr "numfig_format invalide : %s (%r)" -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "Chapitre précédent" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" +msgstr "numfig_format invalide : %s" -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Sujet suivant" +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" +msgstr "label non défini: %r" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "Chapitre suivant" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "Échec de création d'une référence. Ni titre ni légende trouvé : %r" -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" -msgstr "Agrandir la barre latérale" +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" +msgstr "ensemble invalide de valeurs (accolade fermante manquante) : %s" -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "Changements dans la version %(version)s — %(docstitle)s" +msgid "invalid value set (missing opening brace): %s" +msgstr "ensemble invalide de valeurs (accolade ouvrante manquante) :%s" -#: themes/basic/changes/versionchanges.html:17 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Liste auto-générée des modifications dans la version %(version)s" +msgid "malformed string literal (missing closing quote): %s" +msgstr "chaîne littérale malformée (guillemet fermant manquant) : %s" -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Modifications de la bibliothèque" +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" +msgstr "chaîne littérale malformée (guillemet ouvrant manquant) : %s" -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "Modifications de l'API C" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Exemple" -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Autres modifications" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Exemples" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Arguments de mots-clés" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Cacher les résultats de la recherche" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Notes" -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" -msgstr "Résultats de la recherche" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Autres paramètres" -#: themes/basic/static/searchtools.js:119 -msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." -msgstr "Votre recherche ne correspond à aucun document. Veuillez vérifier que les mots sont correctement orthographiés et que vous avez sélectionné assez de catégories." +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "Reçoit" -#: themes/basic/static/searchtools.js:123 -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "La recherche est terminée, une page correspondant à la requête a été trouvée." -msgstr[1] "Recherche terminée, ${resultCount} pages trouvées correspondant à la requête." -msgstr[2] "Recherche terminée, ${resultCount} pages trouvées correspondant à la requête." +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Références" -#: themes/basic/static/searchtools.js:253 -msgid "Searching" -msgstr "Recherche en cours" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Avertissements" -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." -msgstr "Préparation de la recherche..." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "Yields" -#: themes/basic/static/searchtools.js:474 -msgid ", in " -msgstr ", dans " +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" +msgstr "Un faux objet a été détecté : %r" -#: environment/collectors/asset.py:96 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "image file not readable: %s" -msgstr "fichier image %s illisible " +msgid "alias of %s" +msgstr "alias de %s" -#: environment/collectors/asset.py:124 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "image file %s not readable: %s" -msgstr "fichier image %s illisible : %s" +msgid "Bases: %s" +msgstr "Bases : %s" -#: environment/collectors/asset.py:161 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "download file not readable: %s" -msgstr "le fichier téléchargé n’est pas lisible: %s" +msgid "invalid value for member-order option: %s" +msgstr "valeur invalide pour l'option member-order : %s" -#: environment/collectors/toctree.py:258 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s a déjà des numéros de section attribués (toctree numérotés emboîtés ?)" +msgid "invalid value for class-doc-from option: %s" +msgstr "valeur invalide pour l'option class-doc-from : %s" -#: environment/adapters/toctree.py:318 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "table des matières avec une référence circulaire détectée, elle sera ignorée : %s <- %s" +msgid "invalid signature for auto%s (%r)" +msgstr "signature invalide pour auto%s (%r)" -#: environment/adapters/toctree.py:342 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "la table des matières contient une référence à un document %r qui n'a pas de titre : aucun lien ne sera généré" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "module à importer pour auto-documenter %r est inconnu (essayer de placer une directive \"module\" ou \"currentmodule\" dans le document, ou de donner un nom de module explicite)" -#: environment/adapters/toctree.py:357 +#: ext/autodoc/_names.py:89 #, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "toctree contient une référence au document non inclu %r" +msgid "signature arguments given for automodule: '%s'" +msgstr "Arguments de signature fournis pour automodule : '%s'" + +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" +msgstr "Annotation de retour fournie pour automodule : '%s'" + +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "\"::\" dans le nom d'automodule n'a pas de sens" + +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" +msgstr "Échec de la suppression de %s: %s" + +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "Créerait le fichier %s." + +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nCherche récursivement dans des modules et packages Python et crée\ndans un fichier reST par package avec des directives automodule.\n\nLes s peuvent être tout pattern de fichiers et/ou de répertoires à exclure.\n\nNote : par défaut ce script n'écrasera pas des fichiers déjà créés." + +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "chemin vers le module à documenter" + +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "patterns de fichier fnmatch-style et/ou répertoire à exclure" + +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "répertoire où placer toutes les sorties" -#: environment/adapters/indexentries.py:126 -#, python-format -msgid "see %s" -msgstr "voir %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "Nombre maximum de sous-modules visibles dans la table des matières (par défaut : 4)" -#: environment/adapters/indexentries.py:136 -#, python-format -msgid "see also %s" -msgstr "voir aussi %s" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "remplacer les fichiers existants" -#: environment/adapters/indexentries.py:144 -#, python-format -msgid "unknown index entry type %r" -msgstr "type d'index saisie inconnu %r" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "suivre les liens symboliques. Très utile en combinaison avec collective.recipe.omelette." -#: environment/adapters/indexentries.py:270 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Symboles" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "exécuter le script sans créer les fichiers" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" -msgstr "échec de la lecture d'un fichier cassé d'informations de compilation (version inconnue)" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "afficher la documentation de chaque module sur sa propre page" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" -msgstr "échec de la lecture d'un fichier cassé d'informations de compilation (entrée de configuration manquante)" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "inclure le module \"_private\"" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" -msgstr "échec de la lecture d'un fichier cassé d'informations de compilation (entrée de tags manquante)" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "nom du fichier de table des matières (défaut : modules)" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "Les pages HTML sont dans %(outdir)s." +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "ne pas créer de fichier de table des matières" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" -msgstr "Échec de lecture du fichier de configuration de construction : %r" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "ne pas créer de titres pour le module ou package (e.g. lorsque les doctrings en fournissent déjà)" -#: builders/html/__init__.py:363 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "non-concordance de build_info, copie de .buildinfo vers .buildinfo.bak" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "mettre la documentation du module avant celle du sous-module" -#: builders/html/__init__.py:366 -msgid "building [html]: " -msgstr "compilation [html] :" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "interprète les chemins de module selon la spécification PEP-0420 des espaces implicites de noms" -#: builders/html/__init__.py:382 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "le modèle %s a été modifié depuis la compilation précédente, tous les documents seront reconstruits." +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "Liste d'options séparées par des virgules à passer à la directive automodule (ou utiliser SPHINX_APIDOC_OPTIONS)." -#: builders/html/__init__.py:507 -msgid "index" -msgstr "index" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "extension du fichier (par défaut : rst)" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "Logo de %s" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "Supprimer les fichiers existants dans le répertoire de sortie qui n'ont pas été générés" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "suivant" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "générer un projet complet avec sphinx-quickstart" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "précédent" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "ajoute module_path à la fin de sys.path, utilisé lorsque --full est présent" -#: builders/html/__init__.py:695 -msgid "generating indices" -msgstr "génération des index" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "nom du projet (par défaut : nom du module principal)" -#: builders/html/__init__.py:710 -msgid "writing additional pages" -msgstr "Écriture des pages additionnelles" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "auteur(s) du projet, utilisé quand l'option -full est précisée" -#: builders/html/__init__.py:793 -#, python-format -msgid "cannot copy image file '%s': %s" -msgstr "Impossible de copier le fichier image '%s' : %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "version du projet, utilisé quand l'option -full est précisée" -#: builders/html/__init__.py:805 -msgid "copying downloadable files... " -msgstr "Copie des fichiers téléchargeables... " +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "révision du projet, utilisé lorsque --full est présent, par défaut reprend --doc-version" -#: builders/html/__init__.py:817 -#, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "impossible de copier le fichier téléchargeable %r: %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "options relatives aux extensions" -#: builders/html/__init__.py:863 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "Échec de la copie du fichier dans le répertoire 'static' du thème : %s : %r" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "permet des extensions arbitraires, utilisé lorsque --full est donné" -#: builders/html/__init__.py:881 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "Échec de la copie du fichier dans html_static_file : %s : %r" - -#: builders/html/__init__.py:916 -msgid "copying static files" -msgstr "Copie des fichiers statiques" +msgid "enable %s extension, used when --full is given" +msgstr "permettre l'extension %s, utilisée lorsque --full est donné" -#: builders/html/__init__.py:933 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "cannot copy static file %r" -msgstr "impossible de copier le fichier static %r" +msgid "%s is not a directory." +msgstr "%s n'est pas un répertoire" -#: builders/html/__init__.py:938 -msgid "copying extra files" -msgstr "copie des fichiers complémentaires" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "Exécution de l'apidoc" -#: builders/html/__init__.py:948 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "cannot copy extra file %r" -msgstr "copie des fichiers supplémentaires impossible %r" +msgid "apidoc_modules item %i must be a dict" +msgstr "l'item apidoc_modules %i doit être un dict" -#: builders/html/__init__.py:954 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Failed to write build info file: %r" -msgstr "Échec d'écriture du fichier de configuration de construction : %r" - -#: builders/html/__init__.py:1003 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "L'index de recherche n'a pas pu être chargé, mais tous les documents ne seront pas construits: l'index sera incomplet." +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "l'item apidoc_modules %i doit avoir une clé \"path\"." -#: builders/html/__init__.py:1051 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "La page %s correspond à deux motifs dans html_sidebars: %r et %r" +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "l'item apidoc_modules %i 'path' doit être une chaîne de caractères" -#: builders/html/__init__.py:1213 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "une erreur Unicode est survenue lors du rendu de la page %s. Veuillez vous assurer que toutes les valeurs de configuration comportant des caractères non-ASCII sont des chaînes Unicode." +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "l'item apidoc_modules %i 'path' n'est pas un dossier existant : %s" -#: builders/html/__init__.py:1222 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "Un erreur est survenue lors de la génération de la page: %s.\nLa raison est: %r" +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "l'item apidoc_modules %i doit avoir une clé 'destination'" -#: builders/html/__init__.py:1255 -msgid "dumping object inventory" -msgstr "Export de l'inventaire des objets" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "l'item apidoc_modules %i 'destination' doit être une chaîne de caractères" -#: builders/html/__init__.py:1263 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "dumping search index in %s" -msgstr "Export de l'index de recherche en %s" +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "l'item apidoc_modules %i 'destination' doit être un chemin relatif" -#: builders/html/__init__.py:1306 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "invalid js_file: %r, ignored" -msgstr "Fichier js_file : %r invalide, sera ignoré" +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "l'item apidoc_modules %i ne peut pas créer de répertoire de destination : %s" -#: builders/html/__init__.py:1339 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "Plusieurs math_renderers sont enregistrés. Mais aucun n'est sélectionné." +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "l'item apidoc_modules %i '%s' doit être un entier" -#: builders/html/__init__.py:1344 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "Unknown math_renderer %r is given." -msgstr "math_renderer inconnu %r saisi." +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "l'item apidoc_modules %i '%s' doit être un booléen" -#: builders/html/__init__.py:1358 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "L’entrée %r de html_extra_path se trouve à l’intérieur de outdir" +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "l'item apidoc_modules %i a des clés inattendues : %s" -#: builders/html/__init__.py:1363 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "L’entrée %r de html_extra_path n’existe pas" +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "l'item apidoc_modules %i '%s' doit être une séquence" -#: builders/html/__init__.py:1378 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "L’entrée %r de html_static_path se trouve à l’intérieur de outdir" +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "l'item apidoc_modules %i '%s' doit contenir des chaînes de caractères" -#: builders/html/__init__.py:1383 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "html_static_path entry %r does not exist" -msgstr "L’entrée %r de html_static_path n’existe pas" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "autosummary : impossible de déterminer si %r est documenté; l'exception suivante a été levée :\n%s" -#: builders/html/__init__.py:1394 builders/latex/__init__.py:504 +#: ext/autosummary/generate.py:630 #, python-format -msgid "logo file %r does not exist" -msgstr "Le fichier de logo %r n’existe pas" +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] engendrement d’un auto-sommaire pour : %s" -#: builders/html/__init__.py:1405 +#: ext/autosummary/generate.py:634 #, python-format -msgid "favicon file %r does not exist" -msgstr "Le fichier de favicon %r n’existe pas " +msgid "[autosummary] writing to %s" +msgstr "[autosummary] écriture dans %s" -#: builders/html/__init__.py:1417 +#: ext/autosummary/generate.py:679 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." -msgstr "Les valeurs de \"html_sidebars\" doivent être une liste de chaînes. Au moins un motif a une valeur de chaîne : %s. Remplacé par `html_sidebars = %r`." +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "[autosummary] échec de l'importation de %s.\nIndications possibles :\n%s" -#: builders/html/__init__.py:1430 +#: ext/autosummary/generate.py:877 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "HTML 4 n'est plus pris en charge par Sphinx. (\"html4_writer=True\" détecté dans les options de configuration)" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nEngendre du ReStructuredText par les directives autosummary.\n\nsphinx-autogen est une interface à sphinx.ext.autosummary.generate. Il\nengendre les fichiers reStructuredText à partir des directives autosummary\ncontenues dans les fichiers donnés en entrée.\n\nLe format de la directive autosummary est documentée dans le module\nPython \"sphinx.ext.autosummary\" et peut être lu via : ::\n\npydoc sphinx.ext.autosummary\n" + +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "fichiers sources pour lesquels il faut produire des fichiers rST" + +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "répertoire où placer toutes les sorties" -#: builders/html/__init__.py:1447 +#: ext/autosummary/generate.py:915 #, python-format -msgid "%s %s documentation" -msgstr "Documentation %s %s" +msgid "default suffix for files (default: %(default)s)" +msgstr "extension par défaut pour les fichiers (par défaut : %(default)s)" -#: builders/latex/transforms.py:118 -msgid "Failed to get a docname!" -msgstr "Échec de l'obtention d'un nom de document !" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "répertoire des templates spécifiques (par défaut : %(default)s)" -#: builders/latex/transforms.py:119 +#: ext/autosummary/generate.py:931 #, python-format -msgid "Failed to get a docname for source %r!" -msgstr "Échec de l'obtention d'un nom de document pour la source %r !" +msgid "document imported members (default: %(default)s)" +msgstr "membres importés du document (défaut : %(default)s)" -#: builders/latex/transforms.py:485 +#: ext/autosummary/generate.py:940 #, python-format -msgid "No footnote was found for given reference node %r" -msgstr "Aucune note de bas de page n'a été trouvée pour la référence de nœud %r donnée" +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "documenter exactement les membres dans l'attribut __all__ du module. (par défaut : %(default)s)" -#: builders/latex/__init__.py:117 +#: ext/autosummary/__init__.py:235 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Les fichiers LaTeX se trouvent dans %(outdir)s." +msgid "autosummary references excluded document %r. Ignored." +msgstr "autosummary fait référence au document exclu %r. Ignoré" -#: builders/latex/__init__.py:119 +#: ext/autosummary/__init__.py:239 +#, python-format msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nExécuter 'make' dans ce répertoire pour les soumettre à (pdf)latex\n(ou 'make latexpdf' directement ici pour l’automatiser)." +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." +msgstr "autosummary : fichier stub non trouvé %r. Vérifiez votre paramètre autosummary_generate." -#: builders/latex/__init__.py:157 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "aucune valeur de configuration \"latex_documents\" trouvée; aucun document de sera généré" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "Un résumé automatique sous-titré nécessite l'option :toctree:. Ignoré." -#: builders/latex/__init__.py:169 +#: ext/autosummary/__init__.py:329 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "La valeur du paramètre \"latex_documents\" référence un document inconnu %s" +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "autosummary : échec de l'importation de %s.\nIndications possibles :\n%s" -#: builders/latex/__init__.py:208 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Version" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" +msgstr "échec d’importation de l'object %s" + +#: ext/autosummary/__init__.py:652 +#, python-format +msgid "" +"Summarised items should not include the current module. Replace %r with %r." +msgstr "Les éléments résumés ne doivent pas inclure le module actuel. Remplacer %r par %r." + +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" +msgstr "autosummary_generate : fichier nontrouvé : %s" + +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." +msgstr "autosummary génère des fichiers .rst en interne. Mais votre source_suffix ne contient pas .rst. Ignoré." -#: builders/latex/__init__.py:429 -msgid "copying TeX support files" -msgstr "copie des fichiers de support TeX" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "Identifiant de projet intersphinx `%r` invalide dans intersphinx_mapping. Les identifiants de projet doivent être des chaînes non vides." -#: builders/latex/__init__.py:466 -msgid "copying additional files" -msgstr "copie de fichiers supplémentaires" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "Valeur `%r` invalide dans intersphinx_mapping[%r]. Un tuple ou une liste à deux éléments attendus." -#: builders/latex/__init__.py:540 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "Clé de configuration inconnue : latex_elements[%r]; ignorée." +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "Valeur `%r` invalide dans intersphinx_mapping[%r]. Les valeurs doivent être une paire (URI cible, lieux d'inventaire)." -#: builders/latex/__init__.py:548 +#: ext/intersphinx/_load.py:94 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "Option de thème inconnue : latex_theme_options[%r], ignoré." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "Valeur URI cible `%r` invalide dans intersphinx_mapping[%r][0]. Les URI cibles doivent être des chaînes uniques non vides." -#: builders/latex/theming.py:87 +#: ext/intersphinx/_load.py:103 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r n'a pas d'option « theme »" +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "Valeur URI cible `%r` invalide dans intersphinx_mapping[%r][0]. Les URI cibles doivent être uniques (autre instance dans intersphinx_mapping[%r])." -#: builders/latex/theming.py:90 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r n'a pas d'option « %s »" +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "Valeur d'emplacement d'inventaire `%r` invalide dans intersphinx_mapping[%r][1]. Les emplacements d'inventaire doivent être des chaînes non vides ou None." -#: _cli/util/errors.py:124 -msgid "Exception occurred, starting debugger:" -msgstr "Une exception s'est produite, démarrage du débogueur :" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "Configuration `intersphinx_mapping` invalide (1 erreur)." -#: _cli/util/errors.py:133 -msgid "reStructuredText markup error:" -msgstr "erreur de balisage reStructuredText :" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "Configuration `intersphinx_mapping` invalide (%s erreurs)." -#: _cli/util/errors.py:168 -msgid "The full traceback has been saved in:" -msgstr "La trace complète a été sauvegardée dans :" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "Une entrée intersphinx_mapping non valide a été ajoutée après normalisation." + +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "chargement de l'inventaire intersphinx '%s' de %s ..." -#: _cli/util/errors.py:172 +#: ext/intersphinx/_load.py:324 msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "Pour signaler cette erreur aux développeurs, veuillez ouvrir un ticket à l'adresse . Merci !" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "quelques problèmes ont été rencontrés avec quelques uns des inventaires, mais ils disposaient d'alternatives fonctionnelles :" -#: transforms/post_transforms/__init__.py:125 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "Impossible de déterminer le texte de remplacement pour le renvoi. Il peut s'agir d'un bogue." +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "n'a réussi à atteindre aucun des inventaires en raison des problèmes suivants :\n%s" -#: transforms/post_transforms/__init__.py:185 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "plus d'une cible trouvée pour la référence %r de type 'any' : pourrait être %s" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "l’inventaire intersphinx a bougé : %s -> %s" -#: transforms/post_transforms/__init__.py:251 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s cible de référence non trouvée : %s" +msgid "(in %s %s)" +msgstr "(dans %s %s)" -#: transforms/post_transforms/__init__.py:257 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "%r reference target not found: %s" -msgstr "%r cible de référence non trouvée : %s" +msgid "(in %s)" +msgstr "(dans %s)" -#: transforms/post_transforms/images.py:77 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "impossible d'atteindre l'image distante %s[%s]" +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "inventaire '%s' : doublons trouvés pour %s:%s" -#: transforms/post_transforms/images.py:94 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "impossible d'atteindre l'image distante %s[%d]" +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "inventaire '%s' : plusieurs correspondances trouvées pour %s:%s" -#: transforms/post_transforms/images.py:141 +#: ext/intersphinx/_resolve.py:387 #, python-format -msgid "Unknown image format: %s..." -msgstr "Format d'image inconnu : %s..." +msgid "inventory for external cross-reference not found: %r" +msgstr "inventaire des références croisées externes non trouvé : %r" -#: ext/napoleon/docstring.py:707 -msgid "Example" -msgstr "Exemple" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "suffixe de référence croisée externe non valide : %r" -#: ext/napoleon/docstring.py:708 -msgid "Examples" -msgstr "Exemples" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "domaine pour la référence croisée externe non trouvé : %r" -#: ext/napoleon/__init__.py:344 ext/napoleon/docstring.py:752 -msgid "Keyword Arguments" -msgstr "Arguments de mots-clés" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "%sexterne :%s cible de référence non trouvée : %s" -#: ext/napoleon/docstring.py:768 -msgid "Notes" -msgstr "Notes" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "erreur lors du formatage de la signature pour %s : %s" -#: ext/napoleon/docstring.py:777 -msgid "Other Parameters" -msgstr "Autres paramètres" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "Ignorer __all__ invalide dans le module %s: %r" -#: ext/napoleon/docstring.py:813 -msgid "Receives" -msgstr "Reçoit" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "Échec pour obtenir la signature de la fonction pour %s : %s" -#: ext/napoleon/docstring.py:817 -msgid "References" -msgstr "Références" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "Échec de la mise à jour de la signature pour %r : paramètre non trouvé : %s" -#: ext/napoleon/docstring.py:849 -msgid "Warns" -msgstr "Avertissements" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "Échec de l'analyse de type_comment pour %r : %s" -#: ext/napoleon/docstring.py:853 -msgid "Yields" -msgstr "Yields" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "Invalide __slots__ trouvé sur %s. Ignoré." -#: ext/napoleon/docstring.py:1015 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "ensemble invalide de valeurs (accolade fermante manquante) : %s" +msgid "error while formatting arguments for %s: %s" +msgstr "erreur pendant la mise en forme de l'argument %s:%s" -#: ext/napoleon/docstring.py:1022 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "ensemble invalide de valeurs (accolade ouvrante manquante) :%s" +msgid "Failed to get a constructor signature for %s: %s" +msgstr "Échec pour obtenir la signature du constructeur pour %s : %s" -#: ext/napoleon/docstring.py:1029 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "chaîne littérale malformée (guillemet fermant manquant) : %s" +msgid "Failed to get a method signature for %s: %s" +msgstr "Échec pour obtenir la signature de la méthode pour %s : %s" -#: ext/napoleon/docstring.py:1036 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "chaîne littérale malformée (guillemet ouvrant manquant) : %s" +msgid "Failed to get a signature for %s: %s" +msgstr "Impossible d'obtenir une signature pour %s: %s" -#: ext/autosummary/__init__.py:256 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "autosummary references excluded document %r. Ignored." -msgstr "autosummary fait référence au document exclu %r. Ignoré" +msgid "Failed to parse a default argument value for %r: %s" +msgstr "Impossible d'analyser une valeur d'argument par défaut pour %r : %s" -#: ext/autosummary/__init__.py:258 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." -msgstr "autosummary : fichier stub non trouvé %r. Vérifiez votre paramètre autosummary_generate." - -#: ext/autosummary/__init__.py:277 -msgid "A captioned autosummary requires :toctree: option. ignored." -msgstr "Un résumé automatique sous-titré nécessite l'option :toctree:. Ignoré." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" +msgstr "attribut %s est répertorié dans :members: mais il manque car il n'a pas été trouvé dans l'objet %r" -#: ext/autosummary/__init__.py:330 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" "%s" -msgstr "autosummary : échec de l'importation de %s.\nIndications possibles :\n%s" - -#: ext/autosummary/__init__.py:344 -#, python-format -msgid "failed to parse name %s" -msgstr "échec de l’analyse du nom %s" +msgstr "autodoc : n'a pas réussi à déterminer %s.%s (%r) devait être documenté, l'exception suivante a été levée :\n%s" -#: ext/autosummary/__init__.py:349 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "failed to import object %s" -msgstr "échec d’importation de l'object %s" +msgid "signature arguments or return annotation given for automodule %s" +msgstr "arguments de signature ou annotation de return donnés pour l’automodule %s" -#: ext/autosummary/__init__.py:648 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format msgid "" -"Summarised items should not include the current module. Replace %r with %r." -msgstr "Les éléments résumés ne doivent pas inclure le module actuel. Remplacer %r par %r." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ devrait être une liste de chaînes, pas %r (dans module %s) -- __all__ sera ignoré" -#: ext/autosummary/__init__.py:819 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "autosummary_generate: file not found: %s" -msgstr "autosummary_generate : fichier nontrouvé : %s" - -#: ext/autosummary/__init__.py:827 msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." -msgstr "autosummary génère des fichiers .rst en interne. Mais votre source_suffix ne contient pas .rst. Ignoré." +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "attribut manquant mentionné dans l'option :members: : module %s, attribut %s" -#: ext/autosummary/generate.py:215 ext/autosummary/generate.py:391 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "autosummary : impossible de déterminer si %r est documenté; l'exception suivante a été levée :\n%s" +msgid "missing attribute %s in object %s" +msgstr "attribut manquant %s dans l'objet %s" -#: ext/autosummary/generate.py:526 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[autosummary] engendrement d’un auto-sommaire pour : %s" +msgid "alias of TypeVar(%s)" +msgstr "alias de TypeVar(%s)" -#: ext/autosummary/generate.py:530 -#, python-format -msgid "[autosummary] writing to %s" -msgstr "[autosummary] écriture dans %s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "échec de la lecture d'un fichier cassé d'informations de compilation (version inconnue)" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "échec de la lecture d'un fichier cassé d'informations de compilation (entrée de configuration manquante)" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "échec de la lecture d'un fichier cassé d'informations de compilation (entrée de tags manquante)" -#: ext/autosummary/generate.py:572 +#: builders/html/__init__.py:114 #, python-format -msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "[autosummary] échec de l'importation de %s.\nIndications possibles :\n%s" +msgid "The HTML pages are in %(outdir)s." +msgstr "Les pages HTML sont dans %(outdir)s." -#: ext/autosummary/generate.py:767 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nEngendre du ReStructuredText par les directives autosummary.\n\nsphinx-autogen est une interface à sphinx.ext.autosummary.generate. Il\nengendre les fichiers reStructuredText à partir des directives autosummary\ncontenues dans les fichiers donnés en entrée.\n\nLe format de la directive autosummary est documentée dans le module\nPython \"sphinx.ext.autosummary\" et peut être lu via : ::\n\npydoc sphinx.ext.autosummary\n" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" +msgstr "Échec de lecture du fichier de configuration de construction : %r" -#: ext/autosummary/generate.py:789 -msgid "source files to generate rST files for" -msgstr "fichiers sources pour lesquels il faut produire des fichiers rST" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "non-concordance de build_info, copie de .buildinfo vers .buildinfo.bak" -#: ext/autosummary/generate.py:797 -msgid "directory to place all output in" -msgstr "répertoire où placer toutes les sorties" +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "compilation [html] :" -#: ext/autosummary/generate.py:805 +#: builders/html/__init__.py:372 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "extension par défaut pour les fichiers (par défaut : %(default)s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "le modèle %s a été modifié depuis la compilation précédente, tous les documents seront reconstruits." -#: ext/autosummary/generate.py:813 -#, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "répertoire des templates spécifiques (par défaut : %(default)s)" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "index" -#: ext/autosummary/generate.py:821 +#: builders/html/__init__.py:549 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "membres importés du document (défaut : %(default)s)" +msgid "Logo of %s" +msgstr "Logo de %s" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "suivant" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "précédent" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "génération des index" -#: ext/autosummary/generate.py:829 -#, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "documenter exactement les membres dans l'attribut __all__ du module. (par défaut : %(default)s)" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "Écriture des pages additionnelles" -#: ext/intersphinx/_resolve.py:47 +#: builders/html/__init__.py:783 #, python-format -msgid "(in %s v%s)" -msgstr "(disponible dans %s v%s)" +msgid "cannot copy image file '%s': %s" +msgstr "Impossible de copier le fichier image '%s' : %s" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s)" -msgstr "(dans %s)" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "Copie des fichiers téléchargeables... " -#: ext/intersphinx/_resolve.py:103 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "inventaire '%s' : doublons trouvés pour %s:%s" +msgid "cannot copy downloadable file %r: %s" +msgstr "impossible de copier le fichier téléchargeable %r: %s" -#: ext/intersphinx/_resolve.py:113 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "inventaire '%s' : plusieurs correspondances trouvées pour %s:%s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgstr "Échec de la copie du fichier dans le répertoire 'static' du thème : %s : %r" -#: ext/intersphinx/_resolve.py:359 +#: builders/html/__init__.py:871 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "inventaire des références croisées externes non trouvé : %r" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "Échec de la copie du fichier dans html_static_file : %s : %r" -#: ext/intersphinx/_resolve.py:367 -#, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "suffixe de référence croisée externe non valide : %r" +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "Copie des fichiers statiques" -#: ext/intersphinx/_resolve.py:378 +#: builders/html/__init__.py:923 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "domaine pour la référence croisée externe non trouvé : %r" +msgid "cannot copy static file %r" +msgstr "impossible de copier le fichier static %r" -#: ext/intersphinx/_resolve.py:585 -#, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "%sexterne :%s cible de référence non trouvée : %s" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "copie des fichiers complémentaires" -#: ext/intersphinx/_load.py:59 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "Identifiant de projet intersphinx `%r` invalide dans intersphinx_mapping. Les identifiants de projet doivent être des chaînes non vides." +msgid "cannot copy extra file %r" +msgstr "copie des fichiers supplémentaires impossible %r" -#: ext/intersphinx/_load.py:70 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "Échec d'écriture du fichier de configuration de construction : %r" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "Valeur `%r` invalide dans intersphinx_mapping[%r]. Un tuple ou une liste à deux éléments attendus." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "L'index de recherche n'a pas pu être chargé, mais tous les documents ne seront pas construits: l'index sera incomplet." -#: ext/intersphinx/_load.py:81 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "Valeur `%r` invalide dans intersphinx_mapping[%r]. Les valeurs doivent être une paire (URI cible, lieux d'inventaire)." +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "La page %s correspond à deux motifs dans html_sidebars: %r et %r" -#: ext/intersphinx/_load.py:92 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "Valeur URI cible `%r` invalide dans intersphinx_mapping[%r][0]. Les URI cibles doivent être des chaînes uniques non vides." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "une erreur Unicode est survenue lors du rendu de la page %s. Veuillez vous assurer que toutes les valeurs de configuration comportant des caractères non-ASCII sont des chaînes Unicode." -#: ext/intersphinx/_load.py:101 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "Valeur URI cible `%r` invalide dans intersphinx_mapping[%r][0]. Les URI cibles doivent être uniques (autre instance dans intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" +msgstr "Le thème '%s' n'est pas compatible avec cette version de Sphinx, car il utilise le champ \"style\" dans les modèles HTML, qui a été déprécié dans Sphinx 5.1 et supprimé dans Sphinx 7.0. Le thème doit être mis à jour pour utiliser le champ \"styles\" à la place. Voir https://www.sphinx-doc.org/en/master/development/html_themes/templating.html#styles" -#: ext/intersphinx/_load.py:120 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "Valeur d'emplacement d'inventaire `%r` invalide dans intersphinx_mapping[%r][1]. Les emplacements d'inventaire doivent être des chaînes non vides ou None." +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "Un erreur est survenue lors de la génération de la page: %s.\nLa raison est: %r" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "Configuration `intersphinx_mapping` invalide (1 erreur)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "Export de l'inventaire des objets" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "Configuration `intersphinx_mapping` invalide (%s erreurs)." - -#: ext/intersphinx/_load.py:155 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "Une entrée intersphinx_mapping non valide a été ajoutée après normalisation." +msgid "dumping search index in %s" +msgstr "Export de l'index de recherche en %s" -#: ext/intersphinx/_load.py:240 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "chargement de l'inventaire intersphinx '%s' de %s ..." - -#: ext/intersphinx/_load.py:265 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "quelques problèmes ont été rencontrés avec quelques uns des inventaires, mais ils disposaient d'alternatives fonctionnelles :" +msgid "invalid js_file: %r, ignored" +msgstr "Fichier js_file : %r invalide, sera ignoré" -#: ext/intersphinx/_load.py:275 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "échec d'accès à un quelconque inventaire, messages de contexte suivants :" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Plusieurs math_renderers sont enregistrés. Mais aucun n'est sélectionné." -#: ext/intersphinx/_load.py:319 +#: builders/html/__init__.py:1351 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "l’inventaire intersphinx a bougé : %s -> %s" +msgid "Unknown math_renderer %r is given." +msgstr "math_renderer inconnu %r saisi." -#: ext/autodoc/type_comment.py:132 +#: builders/html/__init__.py:1365 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "Échec de la mise à jour de la signature pour %r : paramètre non trouvé : %s" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "L’entrée %r de html_extra_path se trouve à l’intérieur de outdir" -#: ext/autodoc/type_comment.py:135 +#: builders/html/__init__.py:1370 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "Échec de l'analyse de type_comment pour %r : %s" +msgid "html_extra_path entry %r does not exist" +msgstr "L’entrée %r de html_extra_path n’existe pas" -#: ext/autodoc/__init__.py:142 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "valeur invalide pour l'option member-order : %s" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "L’entrée %r de html_static_path se trouve à l’intérieur de outdir" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "valeur invalide pour l'option class-doc-from : %s" +msgid "html_static_path entry %r does not exist" +msgstr "L’entrée %r de html_static_path n’existe pas" -#: ext/autodoc/__init__.py:415 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "signature invalide pour auto%s (%r)" +msgid "logo file %r does not exist" +msgstr "Le fichier de logo %r n’existe pas" -#: ext/autodoc/__init__.py:532 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "erreur pendant la mise en forme de l'argument %s:%s" +msgid "favicon file %r does not exist" +msgstr "Le fichier de favicon %r n’existe pas " -#: ext/autodoc/__init__.py:807 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "autodoc : n'a pas réussi à déterminer %s.%s (%r) devait être documenté, l'exception suivante a été levée :\n%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." +msgstr "Les valeurs de \"html_sidebars\" doivent être une liste de chaînes. Au moins un motif a une valeur de chaîne : %s. Remplacé par `html_sidebars = %r`." -#: ext/autodoc/__init__.py:902 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "module à importer pour auto-documenter %r est inconnu (essayer de placer une directive \"module\" ou \"currentmodule\" dans le document, ou de donner un nom de module explicite)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "HTML 4 n'est plus pris en charge par Sphinx. (\"html4_writer=True\" détecté dans les options de configuration)" -#: ext/autodoc/__init__.py:946 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" -msgstr "Un faux objet a été détecté : %r" +msgid "%s %s documentation" +msgstr "Documentation %s %s" -#: ext/autodoc/__init__.py:965 +#: builders/latex/theming.py:87 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "erreur lors du formatage de la signature pour %s : %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r n'a pas d'option « theme »" -#: ext/autodoc/__init__.py:1028 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "\"::\" dans le nom d'automodule n'a pas de sens" +#: builders/latex/theming.py:90 +#, python-format +msgid "%r doesn't have \"%s\" setting" +msgstr "%r n'a pas d'option « %s »" + +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "Échec de l'obtention d'un nom de document !" -#: ext/autodoc/__init__.py:1035 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "arguments de signature ou annotation de return donnés pour l’automodule %s" +msgid "Failed to get a docname for source %r!" +msgstr "Échec de l'obtention d'un nom de document pour la source %r !" -#: ext/autodoc/__init__.py:1048 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ devrait être une liste de chaînes, pas %r (dans module %s) -- __all__ sera ignoré" +msgid "No footnote was found for given reference node %r" +msgstr "Aucune note de bas de page n'a été trouvée pour la référence de nœud %r donnée" -#: ext/autodoc/__init__.py:1114 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Les fichiers LaTeX se trouvent dans %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "attribut manquant mentionné dans l'option :members: : module %s, attribut %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nExécuter 'make' dans ce répertoire pour les soumettre à (pdf)latex\n(ou 'make latexpdf' directement ici pour l’automatiser)." + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "aucune valeur de configuration \"latex_documents\" trouvée; aucun document de sera généré" -#: ext/autodoc/__init__.py:1337 ext/autodoc/__init__.py:1414 -#: ext/autodoc/__init__.py:2829 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "Échec pour obtenir la signature de la fonction pour %s : %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "La valeur du paramètre \"latex_documents\" référence un document inconnu %s" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "copie des fichiers de support TeX" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "copie de fichiers supplémentaires" -#: ext/autodoc/__init__.py:1633 +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "Échec pour obtenir la signature du constructeur pour %s : %s" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Clé de configuration inconnue : latex_elements[%r]; ignorée." -#: ext/autodoc/__init__.py:1760 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" -msgstr "Bases : %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "Option de thème inconnue : latex_theme_options[%r], ignoré." -#: ext/autodoc/__init__.py:1774 +#: environment/collectors/toctree.py:259 #, python-format -msgid "missing attribute %s in object %s" -msgstr "attribut manquant %s dans l'objet %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s a déjà des numéros de section attribués (toctree numérotés emboîtés ?)" -#: ext/autodoc/__init__.py:1855 ext/autodoc/__init__.py:1892 -#: ext/autodoc/__init__.py:1987 +#: environment/collectors/asset.py:98 #, python-format -msgid "alias of %s" -msgstr "alias de %s" +msgid "image file not readable: %s" +msgstr "fichier image %s illisible " -#: ext/autodoc/__init__.py:1875 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "alias de TypeVar(%s)" +msgid "image file %s not readable: %s" +msgstr "fichier image %s illisible : %s" -#: ext/autodoc/__init__.py:2217 ext/autodoc/__init__.py:2317 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "Échec pour obtenir la signature de la méthode pour %s : %s" +msgid "download file not readable: %s" +msgstr "le fichier téléchargé n’est pas lisible: %s" -#: ext/autodoc/__init__.py:2448 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "Invalide __slots__ trouvé sur %s. Ignoré." +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "table des matières avec une référence circulaire détectée, elle sera ignorée : %s <- %s" -#: ext/autodoc/preserve_defaults.py:190 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "Impossible d'analyser une valeur d'argument par défaut pour %r : %s" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "la table des matières contient une référence à un document %r qui n'a pas de titre : aucun lien ne sera généré" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "suite de la page précédente" +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" +msgstr "toctree contient une référence au document non inclu %r" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "suite sur la page suivante" +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" +msgstr "toctree contient une référence à un document inexistant %r" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "Non alphabétique" +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "voir %s" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Chiffres" +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "voir aussi %s" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "page" +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "type d'index saisie inconnu %r" diff --git a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo index 2f589d2d81f..e5ea6bba555 100644 Binary files a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo and b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po index 730edca8517..7ca291f6baa 100644 --- a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po @@ -1,5 +1,5 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: @@ -7,153 +7,300 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-29 22:39+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: French (France) (http://app.transifex.com/sphinx-doc/sphinx-1/language/fr_FR/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" "Language: fr_FR\n" "Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n" -#: events.py:77 +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "" + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "" + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 #, python-format msgid "Event %r already present" msgstr "" -#: events.py:370 +#: events.py:386 #, python-format msgid "Unknown event name: %s" msgstr "" -#: events.py:416 +#: events.py:451 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" -#: application.py:190 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:194 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:198 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:228 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:250 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:266 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:271 registry.py:452 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:277 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:312 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:329 util/display.py:88 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:331 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:345 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:353 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:366 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:398 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:400 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:404 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:407 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:409 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:414 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:417 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:419 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:968 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1047 +#: application.py:1113 #, python-format -msgid "directive %r is already registered, it will be overridden" +msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1069 application.py:1094 +#: application.py:1139 application.py:1167 #, python-format -msgid "role %r is already registered, it will be overridden" +msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1644 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1648 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1651 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,1153 +321,1307 @@ msgid "" "explicit" msgstr "" -#: application.py:1655 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1663 application.py:1667 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: roles.py:208 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:231 -#, python-format -msgid "invalid CVE number %s" -msgstr "" - -#: roles.py:253 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" - -#: roles.py:276 -#, python-format -msgid "invalid CWE number %s" -msgstr "" - -#: roles.py:296 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "" - -#: roles.py:319 -#, python-format -msgid "invalid PEP number %s" -msgstr "" - -#: roles.py:357 -#, python-format -msgid "invalid RFC number %s" -msgstr "" - -#: registry.py:144 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" -#: registry.py:146 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" -#: registry.py:159 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" -#: registry.py:166 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "" -#: registry.py:173 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "" -#: registry.py:196 registry.py:209 registry.py:220 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "" -#: registry.py:200 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" -#: registry.py:212 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" -#: registry.py:223 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" -#: registry.py:254 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "" -#: registry.py:280 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "" -#: registry.py:287 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "" -#: registry.py:296 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "" -#: registry.py:304 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "" -#: registry.py:320 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "" -#: registry.py:336 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: registry.py:419 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "" -#: registry.py:431 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "" -#: registry.py:446 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" -#: registry.py:457 +#: registry.py:545 msgid "Original exception:\n" msgstr "" -#: registry.py:458 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "" -#: registry.py:463 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" -#: registry.py:472 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" -#: registry.py:480 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" -#: registry.py:514 +#: registry.py:605 #, python-format msgid "`None` is not a valid filetype for %r." msgstr "" -#: project.py:71 +#: config.py:351 #, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: project.py:87 +#: config.py:374 #, python-format -msgid "Ignored unreadable document %r." +msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: highlighting.py:168 +#: config.py:379 #, python-format -msgid "Pygments lexer name %r is not known" +msgid "" +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" msgstr "" -#: highlighting.py:202 +#: config.py:391 #, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: extension.py:55 +#: config.py:399 #, python-format -msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." +msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: extension.py:76 +#: config.py:422 #, python-format -msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." +msgid "unknown config value %r in override, ignoring" msgstr "" -#: theming.py:114 +#: config.py:476 #, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +msgid "No such config value: %r" msgstr "" -#: theming.py:120 +#: config.py:504 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +msgid "Config value %r already present" msgstr "" -#: theming.py:135 +#: config.py:541 #, python-format -msgid "unsupported theme option %r given" +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" msgstr "" -#: theming.py:207 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." msgstr "" -#: theming.py:228 +#: config.py:599 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: theming.py:268 -#, python-format -msgid "The %r theme has circular inheritance" +#: config.py:603 +msgid "" +"The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: theming.py:275 +#: config.py:611 #, python-format msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" msgstr "" -#: theming.py:282 +#: config.py:633 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to convert %r to a frozenset" msgstr "" -#: theming.py:310 +#: config.py:651 config.py:659 #, python-format -msgid "no theme configuration file found in %r" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: theming.py:335 theming.py:388 +#: config.py:665 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." msgstr "" -#: theming.py:339 +#: config.py:686 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" +msgid "Section %s" msgstr "" -#: theming.py:343 theming.py:391 +#: config.py:687 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "Fig. %s" msgstr "" -#: theming.py:347 +#: config.py:688 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "Table %s" msgstr "" -#: theming.py:366 +#: config.py:689 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgid "Listing %s" msgstr "" -#: config.py:309 -#, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +#: config.py:798 +#, python-brace-format +msgid "" +"The config value `{name}` has to be a one of {candidates}, but `{current}` " +"is given." msgstr "" -#: config.py:318 +#: config.py:829 +#, python-brace-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"The config value `{name}' has type `{current.__name__}'; expected " +"{permitted}." msgstr "" -#: config.py:341 -#, python-format +#: config.py:846 +#, python-brace-format msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" +"The config value `{name}' has type `{current.__name__}', defaults to " +"`{default.__name__}'." msgstr "" -#: config.py:350 +#: config.py:858 #, python-format -msgid "invalid number %r for config value %r, ignoring" +msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:356 -#, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" +#: config.py:878 +msgid "" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: config.py:377 -#, python-format -msgid "unknown config value %r in override, ignoring" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: config.py:430 -#, python-format -msgid "No such config value: %r" +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: config.py:453 -#, python-format -msgid "Config value %r already present" +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: config.py:489 -#, python-format -msgid "" -"cannot cache unpickable configuration value: %r (because it contains a " -"function, class, or module object)" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: config.py:527 -#, python-format -msgid "There is a syntax error in your configuration file: %s\n" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: config.py:530 -msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: config.py:537 +#: environment/__init__.py:350 #, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: config.py:560 +#: environment/__init__.py:355 #, python-format -msgid "Failed to convert %r to a set or tuple" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: config.py:581 config.py:586 +#: environment/__init__.py:361 #, python-format -msgid "Converting `source_suffix = %r` to `source_suffix = %r`." +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: config.py:589 -#, python-format +#: environment/__init__.py:404 msgid "" -"The config value `source_suffix' expects a dictionary, a string, or a list " -"of strings. Got `%r' instead (type %s)." +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: config.py:608 +#: environment/__init__.py:518 #, python-format -msgid "Section %s" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: config.py:609 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "Fig. %s" +msgid "Domain %r is not registered" msgstr "" -#: config.py:610 -#, python-format -msgid "Table %s" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: config.py:611 -#, python-format -msgid "Listing %s" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: config.py:718 -msgid "" -"The config value `{name}` has to be a one of {candidates}, but `{current}` " -"is given." +#: environment/__init__.py:952 +#, python-format +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: config.py:742 -msgid "" -"The config value `{name}' has type `{current.__name__}'; expected " -"{permitted}." +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: config.py:755 -msgid "" -"The config value `{name}' has type `{current.__name__}', defaults to " -"`{default.__name__}'." +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: config.py:766 -#, python-format -msgid "primary_domain %r not found, ignored." +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: config.py:778 -msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: domains/rst.py:128 domains/rst.py:185 -#, python-format -msgid "%s (directive)" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: domains/rst.py:186 domains/rst.py:190 -#, python-format -msgid ":%s: (directive option)" +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: domains/rst.py:214 -#, python-format -msgid "%s (role)" +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: domains/rst.py:224 -msgid "directive" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: domains/rst.py:225 -msgid "directive-option" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: domains/rst.py:226 -msgid "role" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: domains/rst.py:248 +#: builders/texinfo.py:41 #, python-format -msgid "duplicate description of %s %s, other instance in %s" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: domains/javascript.py:165 -#, python-format -msgid "%s() (built-in function)" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: domains/javascript.py:166 domains/python/__init__.py:253 -#, python-format -msgid "%s() (%s method)" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: domains/javascript.py:168 +#: builders/texinfo.py:85 #, python-format -msgid "%s() (class)" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: domains/javascript.py:170 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "%s (global variable or constant)" +msgid "processing %s" msgstr "" -#: domains/javascript.py:172 domains/python/__init__.py:338 -#, python-format -msgid "%s (%s attribute)" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: domains/javascript.py:255 -msgid "Arguments" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: domains/cpp/__init__.py:447 domains/javascript.py:258 -msgid "Throws" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: domains/c/__init__.py:310 domains/cpp/__init__.py:458 -#: domains/javascript.py:261 domains/python/_object.py:176 -msgid "Returns" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: domains/c/__init__.py:312 domains/javascript.py:263 -#: domains/python/_object.py:178 -msgid "Return type" +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 +#, python-format +msgid "cannot copy image file %r: %s" msgstr "" -#: domains/javascript.py:334 -#, python-format -msgid "%s (module)" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: domains/c/__init__.py:681 domains/cpp/__init__.py:859 -#: domains/javascript.py:371 domains/python/__init__.py:660 -msgid "function" +#: builders/texinfo.py:218 +#, python-format +msgid "error writing file Makefile: %s" msgstr "" -#: domains/javascript.py:372 domains/python/__init__.py:664 -msgid "method" +#: builders/manpage.py:37 +#, python-format +msgid "The manual pages are in %(outdir)s." msgstr "" -#: domains/cpp/__init__.py:857 domains/javascript.py:373 -#: domains/python/__init__.py:662 -msgid "class" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: domains/javascript.py:374 domains/python/__init__.py:661 -msgid "data" +#: builders/manpage.py:64 +#, python-format +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: domains/javascript.py:375 domains/python/__init__.py:667 -msgid "attribute" +#: builders/singlehtml.py:35 +#, python-format +msgid "The HTML page is in %(outdir)s." msgstr "" -#: domains/javascript.py:376 domains/python/__init__.py:670 -msgid "module" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: domains/javascript.py:407 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: domains/changeset.py:25 -#, python-format -msgid "Added in version %s" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: domains/changeset.py:26 +#: builders/gettext.py:243 #, python-format -msgid "Changed in version %s" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: domains/changeset.py:27 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "Deprecated since version %s" +msgid "building [%s]: " msgstr "" -#: domains/changeset.py:28 +#: builders/gettext.py:265 #, python-format -msgid "Removed in version %s" +msgid "targets for %d template files" msgstr "" -#: domains/__init__.py:299 -#, python-format -msgid "%s %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: domains/citation.py:73 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: domains/citation.py:84 +#: builders/linkcheck.py:87 #, python-format -msgid "Citation [%s] is not referenced." +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: domains/math.py:63 +#: builders/linkcheck.py:159 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "broken link: %s (%s)" msgstr "" -#: domains/math.py:119 writers/latex.py:2479 +#: builders/linkcheck.py:561 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "Anchor '%s' not found" msgstr "" -#: environment/__init__.py:81 -msgid "new config" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: environment/__init__.py:82 -msgid "config changed" +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: environment/__init__.py:83 -msgid "extensions changed" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: environment/__init__.py:249 -msgid "build environment version not current" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: environment/__init__.py:251 -msgid "source directory has changed" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:313 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: environment/__init__.py:318 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:324 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:366 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:473 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:626 -#, python-format -msgid "Domain %r is not registered" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:777 -msgid "document isn't included in any toctree" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:810 -msgid "self referenced toctree found. Ignored." +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:839 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: locale/__init__.py:229 -msgid "Attention" +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" msgstr "" -#: locale/__init__.py:230 -msgid "Caution" +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." msgstr "" -#: locale/__init__.py:231 -msgid "Danger" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: locale/__init__.py:232 -msgid "Error" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: locale/__init__.py:233 -msgid "Hint" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: locale/__init__.py:234 -msgid "Important" +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" msgstr "" -#: locale/__init__.py:235 -msgid "Note" +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" msgstr "" -#: locale/__init__.py:236 -msgid "See also" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: locale/__init__.py:237 -msgid "Tip" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: locale/__init__.py:238 -msgid "Warning" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: cmd/quickstart.py:43 -msgid "automatically insert docstrings from modules" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: cmd/quickstart.py:44 -msgid "automatically test code snippets in doctest blocks" +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: cmd/quickstart.py:45 -msgid "link between Sphinx documentation of different projects" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: cmd/quickstart.py:46 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." msgstr "" -#: cmd/quickstart.py:47 -msgid "checks for documentation coverage" +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." msgstr "" -#: cmd/quickstart.py:48 -msgid "include math, rendered as PNG or SVG images" +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:49 -msgid "include math, rendered in the browser by MathJax" +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: cmd/quickstart.py:50 -msgid "conditional inclusion of content based on config values" +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" msgstr "" -#: cmd/quickstart.py:51 -msgid "include links to the source code of documented Python objects" +#: builders/__init__.py:260 +msgid "building [mo]: " msgstr "" -#: cmd/quickstart.py:52 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " msgstr "" -#: cmd/quickstart.py:94 -msgid "Please enter a valid path name." +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter some text." +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" msgstr "" -#: cmd/quickstart.py:117 +#: builders/__init__.py:314 #, python-format -msgid "Please enter one of %s." +msgid "targets for %d po files that are out of date" msgstr "" -#: cmd/quickstart.py:125 -msgid "Please enter either 'y' or 'n'." +#: builders/__init__.py:324 +msgid "all source files" msgstr "" -#: cmd/quickstart.py:131 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: cmd/quickstart.py:215 +#: builders/__init__.py:342 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "" +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: cmd/quickstart.py:219 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: cmd/quickstart.py:227 +#: builders/__init__.py:366 #, python-format -msgid "Selected root path: %s" +msgid "%d source files given on command line" msgstr "" -#: cmd/quickstart.py:230 -msgid "Enter the root path for documentation." +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" msgstr "" -#: cmd/quickstart.py:231 -msgid "Root path for the documentation" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " msgstr "" -#: cmd/quickstart.py:239 -msgid "Error: an existing conf.py has been found in the selected root path." +#: builders/__init__.py:415 +#, python-format +msgid "%d found" msgstr "" -#: cmd/quickstart.py:245 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: builders/__init__.py:417 +msgid "none found" msgstr "" -#: cmd/quickstart.py:248 -msgid "Please enter a new root path (or just Enter to exit)" +#: builders/__init__.py:424 +msgid "pickling environment" msgstr "" -#: cmd/quickstart.py:258 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: builders/__init__.py:431 +msgid "checking consistency" msgstr "" -#: cmd/quickstart.py:265 -msgid "Separate source and build directories (y/n)" +#: builders/__init__.py:435 +msgid "no targets are out of date." msgstr "" -#: cmd/quickstart.py:271 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: builders/__init__.py:474 +msgid "updating environment: " msgstr "" -#: cmd/quickstart.py:277 -msgid "Name prefix for templates and static dir" +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: cmd/quickstart.py:282 +#: builders/__init__.py:536 +#, python-format msgid "" -"The project name will occur in several places in the built documentation." +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: cmd/quickstart.py:286 -msgid "Project name" +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: cmd/quickstart.py:288 -msgid "Author name(s)" +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: cmd/quickstart.py:293 +#: builders/__init__.py:563 +#, python-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." msgstr "" -#: cmd/quickstart.py:301 -msgid "Project version" +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " msgstr "" -#: cmd/quickstart.py:303 -msgid "Project release" +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: builders/__init__.py:727 +msgid "no docnames to write!" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project language" +#: builders/__init__.py:740 +msgid "preparing documents" msgstr "" -#: cmd/quickstart.py:324 +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +"the following modules are documented but were not specified in " +"coverage_modules: %s" msgstr "" -#: cmd/quickstart.py:329 -msgid "Source file suffix" +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" msgstr "" -#: cmd/quickstart.py:334 +#: ext/coverage.py:172 +#, python-brace-format, python-format msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." msgstr "" -#: cmd/quickstart.py:342 -msgid "Name of your master document (without suffix)" +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" msgstr "" -#: cmd/quickstart.py:352 +#: ext/coverage.py:260 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "undocumented c api: %s [%s] in file %s" msgstr "" -#: cmd/quickstart.py:359 -msgid "sphinx-quickstart will not overwrite the existing file." +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" msgstr "" -#: cmd/quickstart.py:362 +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "" + +#: ext/extlinks.py:82 +#, python-format msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: cmd/quickstart.py:371 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" msgstr "" -#: cmd/quickstart.py:381 +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + +#: ext/imgconverter.py:44 +#, python-format msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" msgstr "" -#: cmd/quickstart.py:391 +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:397 -msgid "Create Makefile? (y/n)" +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" -#: cmd/quickstart.py:401 -msgid "Create Windows command file? (y/n)" +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" -#: cmd/quickstart.py:453 ext/apidoc.py:92 +#: ext/graphviz.py:153 #, python-format -msgid "Creating file %s." +msgid "External Graphviz file %r not found or reading it failed" msgstr "" -#: cmd/quickstart.py:458 ext/apidoc.py:89 +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "" + +#: ext/graphviz.py:287 #, python-format -msgid "File %s already exists, skipping." +msgid "graphviz_dot executable path must be set! %r" msgstr "" -#: cmd/quickstart.py:501 -msgid "Finished: An initial directory structure has been created." +#: ext/graphviz.py:328 +#, python-format +msgid "" +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" msgstr "" -#: cmd/quickstart.py:504 +#: ext/graphviz.py:339 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:512 +#: ext/graphviz.py:344 +#, python-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "" + +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" +msgstr "" + +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" +msgstr "" + +#: ext/graphviz.py:493 ext/graphviz.py:501 +#, python-format +msgid "[graph: %s]" +msgstr "" + +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" msgstr "" -#: cmd/quickstart.py:515 +#: ext/imgmath.py:148 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: cmd/quickstart.py:522 +#: ext/imgmath.py:167 +#, python-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "" + +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "" + +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" + +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" + +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "" + +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "" + +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" msgstr "" -#: cmd/quickstart.py:557 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "" + +#: ext/doctest.py:297 +#, python-format msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: cmd/build.py:153 cmd/quickstart.py:567 ext/apidoc.py:374 -#: ext/autosummary/generate.py:766 -msgid "For more information, visit ." +#: ext/doctest.py:451 +#, python-format +msgid "no code/output in %s block at %s:%s" msgstr "" -#: cmd/quickstart.py:577 -msgid "quiet mode" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: cmd/quickstart.py:587 -msgid "project root" +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: cmd/quickstart.py:590 -msgid "Structure options" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: cmd/quickstart.py:596 -msgid "if specified, separate source and build dirs" +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: cmd/quickstart.py:602 -msgid "if specified, create build dir under source dir" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: cmd/quickstart.py:608 -msgid "replacement for dot in _templates etc." +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: cmd/quickstart.py:611 -msgid "Project basic options" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: cmd/quickstart.py:613 -msgid "project name" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: cmd/quickstart.py:616 -msgid "author names" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: cmd/quickstart.py:623 -msgid "version of project" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: cmd/quickstart.py:630 -msgid "release of project" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: cmd/quickstart.py:637 -msgid "document language" +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: cmd/quickstart.py:640 -msgid "source file suffix" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " msgstr "" -#: cmd/quickstart.py:643 -msgid "master document name" +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: cmd/quickstart.py:646 -msgid "use epub" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "" + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" +msgstr "" + +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." +msgstr "" + +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" +msgstr "" + +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "" + +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "" + +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "" + +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" msgstr "" -#: cmd/quickstart.py:649 -msgid "Extension options" +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" msgstr "" -#: cmd/quickstart.py:656 ext/apidoc.py:578 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "enable %s extension" +msgid "%s (%s attribute)" msgstr "" -#: cmd/quickstart.py:663 ext/apidoc.py:570 -msgid "enable arbitrary extensions" +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: cmd/quickstart.py:666 -msgid "Makefile and Batchfile creation" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: cmd/quickstart.py:672 -msgid "create makefile" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: cmd/quickstart.py:678 -msgid "do not create makefile" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: cmd/quickstart.py:685 -msgid "create batchfile" +#: domains/javascript.py:374 +#, python-format +msgid "%s (module)" msgstr "" -#: cmd/quickstart.py:691 -msgid "do not create batchfile" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: cmd/quickstart.py:700 -msgid "use make-mode for Makefile/make.bat" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: cmd/quickstart.py:703 ext/apidoc.py:581 -msgid "Project templating" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: cmd/quickstart.py:709 ext/apidoc.py:587 -msgid "template directory for template files" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: cmd/quickstart.py:716 -msgid "define a template variable" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: cmd/quickstart.py:751 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: cmd/quickstart.py:770 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: cmd/quickstart.py:777 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: cmd/quickstart.py:795 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "Invalid template variable: %s" +msgid ":%s: (directive option)" msgstr "" -#: cmd/build.py:49 -msgid "Exception occurred while building, starting debugger:" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: _cli/util/errors.py:129 cmd/build.py:65 -msgid "Interrupted!" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: cmd/build.py:67 -msgid "reST markup error:" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: _cli/util/errors.py:143 cmd/build.py:73 -msgid "Encoding error:" +#: domains/rst.py:236 +msgid "role" msgstr "" -#: cmd/build.py:78 cmd/build.py:108 +#: domains/rst.py:262 #, python-format -msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:148 cmd/build.py:90 -msgid "Recursion error:" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" msgstr "" -#: _cli/util/errors.py:152 cmd/build.py:94 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" msgstr "" -#: _cli/util/errors.py:165 cmd/build.py:103 -msgid "Exception occurred:" +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" msgstr "" -#: _cli/util/errors.py:178 cmd/build.py:117 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: cmd/build.py:124 -msgid "" -"A bug report can be filed in the tracker at . Thanks!" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" msgstr "" -#: cmd/build.py:144 +#: cmd/build.py:64 msgid "job number should be a positive number" msgstr "" -#: cmd/build.py:154 +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" + +#: cmd/build.py:74 msgid "" "\n" "Generate documentation from source files.\n" @@ -1339,675 +1640,589 @@ msgid "" "files can be built by specifying individual filenames.\n" msgstr "" -#: cmd/build.py:180 +#: cmd/build.py:100 msgid "path to documentation source files" msgstr "" -#: cmd/build.py:183 +#: cmd/build.py:103 msgid "path to output directory" msgstr "" -#: cmd/build.py:188 +#: cmd/build.py:109 msgid "" "(optional) a list of specific files to rebuild. Ignored if --write-all is " "specified" msgstr "" -#: cmd/build.py:194 +#: cmd/build.py:114 msgid "general options" msgstr "" -#: cmd/build.py:201 +#: cmd/build.py:121 msgid "builder to use (default: 'html')" msgstr "" -#: cmd/build.py:210 +#: cmd/build.py:131 msgid "" "run in parallel with N processes, when possible. 'auto' uses the number of " "CPU cores" msgstr "" -#: cmd/build.py:220 +#: cmd/build.py:140 msgid "write all files (default: only write new and changed files)" msgstr "" -#: cmd/build.py:227 +#: cmd/build.py:147 msgid "don't use a saved environment, always read all files" msgstr "" -#: cmd/build.py:230 +#: cmd/build.py:150 msgid "path options" msgstr "" -#: cmd/build.py:236 +#: cmd/build.py:157 msgid "" "directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: cmd/build.py:246 +#: cmd/build.py:166 msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: cmd/build.py:255 +#: cmd/build.py:175 msgid "use no configuration file, only use settings from -D options" msgstr "" -#: cmd/build.py:264 +#: cmd/build.py:184 msgid "override a setting in configuration file" msgstr "" -#: cmd/build.py:273 +#: cmd/build.py:193 msgid "pass a value into HTML templates" msgstr "" -#: cmd/build.py:282 +#: cmd/build.py:202 msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: cmd/build.py:289 +#: cmd/build.py:209 msgid "nitpicky mode: warn about all missing references" msgstr "" -#: cmd/build.py:292 +#: cmd/build.py:212 msgid "console output options" msgstr "" -#: cmd/build.py:299 +#: cmd/build.py:219 msgid "increase verbosity (can be repeated)" msgstr "" -#: cmd/build.py:306 ext/apidoc.py:413 +#: cmd/build.py:226 ext/apidoc/_cli.py:66 msgid "no output on stdout, just warnings on stderr" msgstr "" -#: cmd/build.py:313 +#: cmd/build.py:233 msgid "no output at all, not even warnings" msgstr "" -#: cmd/build.py:321 +#: cmd/build.py:241 msgid "do emit colored output (default: auto-detect)" msgstr "" -#: cmd/build.py:329 +#: cmd/build.py:249 msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: cmd/build.py:332 +#: cmd/build.py:252 msgid "warning control options" msgstr "" -#: cmd/build.py:338 +#: cmd/build.py:258 msgid "write warnings (and errors) to given file" msgstr "" -#: cmd/build.py:345 +#: cmd/build.py:265 msgid "turn warnings into errors" msgstr "" -#: cmd/build.py:353 +#: cmd/build.py:273 msgid "show full traceback on exception" msgstr "" -#: cmd/build.py:356 +#: cmd/build.py:276 msgid "run Pdb on exception" msgstr "" -#: cmd/build.py:362 +#: cmd/build.py:282 msgid "raise an exception on warnings" msgstr "" -#: cmd/build.py:405 +#: cmd/build.py:325 msgid "cannot combine -a option and filenames" msgstr "" -#: cmd/build.py:437 +#: cmd/build.py:357 #, python-format msgid "cannot open warning file '%s': %s" msgstr "" -#: cmd/build.py:456 +#: cmd/build.py:376 msgid "-D option argument must be in the form name=value" msgstr "" -#: cmd/build.py:463 +#: cmd/build.py:383 msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "" - -#: builders/linkcheck.py:75 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/linkcheck.py:146 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/linkcheck.py:540 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/linkcheck.py:742 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/singlehtml.py:37 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/singlehtml.py:173 -msgid "assembling single document" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/latex/__init__.py:346 builders/manpage.py:56 -#: builders/singlehtml.py:178 builders/texinfo.py:121 -msgid "writing" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/singlehtml.py:191 -msgid "writing additional files" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/manpage.py:39 -#, python-format -msgid "The manual pages are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/manpage.py:47 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/manpage.py:73 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/text.py:34 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/html/__init__.py:1239 builders/text.py:81 builders/xml.py:97 +#: cmd/quickstart.py:134 #, python-format -msgid "error writing file %s: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/xml.py:38 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/xml.py:110 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/texinfo.py:47 +#: cmd/quickstart.py:230 #, python-format -msgid "The Texinfo files are in %(outdir)s." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/texinfo.py:49 +#: cmd/quickstart.py:235 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "" - -#: builders/texinfo.py:78 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:90 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:324 builders/texinfo.py:115 -#, python-format -msgid "processing %s" -msgstr "" - -#: builders/latex/__init__.py:404 builders/texinfo.py:174 -msgid "resolving references..." -msgstr "" - -#: builders/latex/__init__.py:415 builders/texinfo.py:184 -msgid " (in " -msgstr "" - -#: builders/_epub_base.py:423 builders/html/__init__.py:778 -#: builders/latex/__init__.py:482 builders/texinfo.py:202 -msgid "copying images... " -msgstr "" - -#: builders/_epub_base.py:445 builders/latex/__init__.py:497 -#: builders/texinfo.py:219 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "" - -#: builders/texinfo.py:226 -msgid "copying Texinfo support files" -msgstr "" - -#: builders/texinfo.py:234 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "" - -#: builders/gettext.py:230 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "" - -#: builders/__init__.py:383 builders/gettext.py:251 -#, python-format -msgid "building [%s]: " -msgstr "" - -#: builders/gettext.py:252 -#, python-format -msgid "targets for %d template files" -msgstr "" - -#: builders/gettext.py:257 -msgid "reading templates... " -msgstr "" - -#: builders/gettext.py:292 -msgid "writing message catalogs... " -msgstr "" - -#: builders/__init__.py:212 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/__init__.py:220 +#: cmd/quickstart.py:242 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "Selected root path: %s" msgstr "" -#: builders/__init__.py:243 -msgid "building [mo]: " +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/__init__.py:246 builders/__init__.py:741 builders/__init__.py:773 -msgid "writing output... " +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/__init__.py:263 -#, python-format -msgid "all of %d po files" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/__init__.py:285 -#, python-format -msgid "targets for %d po files that are specified" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are out of date" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/__init__.py:307 -msgid "all source files" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/__init__.py:319 -#, python-format -msgid "file %r given on command line does not exist, " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/__init__.py:325 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"file %r given on command line is not under the source directory, ignoring" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/__init__.py:336 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/__init__.py:351 -#, python-format -msgid "%d source files given on command line" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/__init__.py:366 -#, python-format -msgid "targets for %d source files that are out of date" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/__init__.py:394 -msgid "looking for now-outdated files... " +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/__init__.py:398 -#, python-format -msgid "%d found" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/__init__.py:400 -msgid "none found" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/__init__.py:407 -msgid "pickling environment" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: builders/__init__.py:414 -msgid "checking consistency" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: builders/__init__.py:418 -msgid "no targets are out of date." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: builders/__init__.py:458 -msgid "updating environment: " +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: builders/__init__.py:483 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/__init__.py:519 -#, python-format +#: cmd/quickstart.py:350 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: builders/__init__.py:528 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: builders/__init__.py:539 +#: cmd/quickstart.py:368 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: builders/__init__.py:546 -#, python-format +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "" + +#: cmd/quickstart.py:378 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: builders/__init__.py:565 builders/__init__.py:581 -msgid "reading sources... " +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: builders/__init__.py:698 -#, python-format -msgid "docnames to write: %s" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: builders/__init__.py:711 -msgid "preparing documents" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: builders/__init__.py:714 -msgid "copying assets" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: builders/__init__.py:866 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: builders/epub3.py:83 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "The ePub file is in %(outdir)s." +msgid "Creating file %s." msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: builders/epub3.py:220 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: builders/epub3.py:231 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: builders/epub3.py:255 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1289 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: builders/_epub_base.py:222 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: builders/_epub_base.py:434 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: builders/_epub_base.py:465 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: builders/_epub_base.py:477 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: builders/_epub_base.py:512 -msgid "writing mimetype file..." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: builders/_epub_base.py:521 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: builders/_epub_base.py:590 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: builders/_epub_base.py:764 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: builders/_epub_base.py:793 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: builders/changes.py:33 +#: cmd/quickstart.py:671 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "enable %s extension" msgstr "" -#: builders/changes.py:60 -#, python-format -msgid "no changes in version %s." +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: builders/changes.py:62 -msgid "writing summary file..." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: builders/changes.py:74 -msgid "Builtins" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: builders/changes.py:76 -msgid "Module level" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: builders/changes.py:128 -msgid "copying source files..." +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: builders/changes.py:137 -#, python-format -msgid "could not read %r for changelog creation" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/rst.py:72 -#, python-format -msgid "default role %s not found" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/docfields.py:95 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/osutil.py:130 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: util/nodes.py:419 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: util/nodes.py:487 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: util/nodes.py:701 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/fileutil.py:74 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/fileutil.py:89 +#: cmd/quickstart.py:810 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/inventory.py:170 +#: directives/other.py:119 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/inventory.py:185 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/docutils.py:284 +#: directives/other.py:156 #, python-format -msgid "unknown directive or role name: %s:%s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/docutils.py:747 +#: directives/other.py:169 #, python-format -msgid "unknown node type: %r" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/display.py:81 -msgid "skipped" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/display.py:86 -msgid "failed" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: util/i18n.py:103 -#, python-format -msgid "reading error: %s, %s" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: util/i18n.py:110 -#, python-format -msgid "writing error: %s, %s" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: util/i18n.py:138 -#, python-format -msgid "locale_dir %s does not exist" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/i18n.py:230 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: directives/patches.py:66 +#: directives/patches.py:70 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." @@ -2022,7 +2237,7 @@ msgstr "" msgid "Invalid caption: %s" msgstr "" -#: directives/code.py:132 directives/code.py:297 directives/code.py:484 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" @@ -2037,7 +2252,7 @@ msgstr "" msgid "Include file '%s' not found or reading it failed" msgstr "" -#: directives/code.py:234 +#: directives/code.py:235 #, python-format msgid "" "Encoding %r used for reading included file '%s' seems to be wrong, try " @@ -2058,48 +2273,139 @@ msgstr "" msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: directives/other.py:122 -#, python-format -msgid "toctree glob pattern %r didn't match any documents" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "" + +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "" + +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "" + +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" +msgstr "" + +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "" + +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" + +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" + +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" + +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" + +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" + +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" + +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: directives/other.py:155 environment/adapters/toctree.py:355 +#: writers/latex.py:386 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: directives/other.py:158 environment/adapters/toctree.py:359 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "no Babel option known for language %r" msgstr "" -#: directives/other.py:171 -#, python-format -msgid "duplicated entry found in toctree: %s" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: directives/other.py:204 -msgid "Section author: " +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: directives/other.py:206 -msgid "Module author: " +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: directives/other.py:208 -msgid "Code author: " +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: directives/other.py:210 -msgid "Author: " +#: writers/latex.py:1228 +#, python-format +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: directives/other.py:284 -msgid ".. acks content is not a list" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: directives/other.py:309 -msgid ".. hlist content is not a list" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" #: _cli/__init__.py:73 @@ -2107,6 +2413,7 @@ msgid "Usage:" msgstr "" #: _cli/__init__.py:75 +#, python-brace-format msgid "{0} [OPTIONS] []" msgstr "" @@ -2122,1993 +2429,1877 @@ msgstr "" msgid "Options" msgstr "" -#: _cli/__init__.py:112 _cli/__init__.py:183 +#: _cli/__init__.py:113 _cli/__init__.py:181 msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: _cli/__init__.py:172 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" "{0}: error: {1}\n" "Run '{0} --help' for information" msgstr "" -#: _cli/__init__.py:182 +#: _cli/__init__.py:179 msgid " Manage documentation with Sphinx." msgstr "" -#: _cli/__init__.py:194 +#: _cli/__init__.py:191 msgid "Show the version and exit." msgstr "" -#: _cli/__init__.py:202 +#: _cli/__init__.py:199 msgid "Show this message and exit." msgstr "" -#: _cli/__init__.py:206 +#: _cli/__init__.py:203 msgid "Logging" msgstr "" -#: _cli/__init__.py:213 +#: _cli/__init__.py:210 msgid "Increase verbosity (can be repeated)" msgstr "" -#: _cli/__init__.py:221 +#: _cli/__init__.py:218 msgid "Only print errors and warnings." msgstr "" -#: _cli/__init__.py:228 +#: _cli/__init__.py:225 msgid "No output at all" msgstr "" -#: _cli/__init__.py:234 +#: _cli/__init__.py:231 msgid "" msgstr "" -#: _cli/__init__.py:265 +#: _cli/__init__.py:263 msgid "See 'sphinx --help'.\n" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:198 -#: transforms/__init__.py:133 writers/manpage.py:102 writers/texinfo.py:219 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:143 -msgid "could not calculate translation progress!" -msgstr "" - -#: transforms/__init__.py:148 -msgid "no translated elements!" -msgstr "" - -#: transforms/__init__.py:267 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "" - -#: transforms/__init__.py:313 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" - -#: transforms/__init__.py:322 -msgid "Footnote [*] is not referenced." -msgstr "" - -#: transforms/__init__.py:333 -msgid "Footnote [#] is not referenced." -msgstr "" - -#: transforms/i18n.py:228 transforms/i18n.py:303 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: transforms/i18n.py:273 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" -#: transforms/i18n.py:323 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: transforms/i18n.py:345 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: ext/linkcode.py:75 ext/viewcode.py:201 -msgid "[source]" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: ext/imgconverter.py:40 -#, python-format -msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: ext/imgconverter.py:49 ext/imgconverter.py:73 +#: transforms/__init__.py:258 #, python-format msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "" - -#: ext/imgconverter.py:68 -#, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "" - -#: ext/viewcode.py:258 -msgid "highlighting module code... " -msgstr "" - -#: ext/viewcode.py:286 -msgid "[docs]" -msgstr "" - -#: ext/viewcode.py:306 -msgid "Module code" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: ext/viewcode.py:312 +#: transforms/__init__.py:299 #, python-format -msgid "

        Source code for %s

        " +msgid "Footnote [%s] is not referenced." msgstr "" -#: ext/viewcode.py:338 -msgid "Overview: module code" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: ext/viewcode.py:339 -msgid "

        All modules for which code is available

        " +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: ext/coverage.py:47 +#: util/inventory.py:147 #, python-format -msgid "invalid regex %r in %s" +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: ext/coverage.py:134 ext/coverage.py:280 +#: util/inventory.py:166 #, python-format -msgid "module %s could not be imported: %s" +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: ext/coverage.py:141 +#: util/i18n.py:100 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "" - -#: ext/coverage.py:149 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +msgid "reading error: %s, %s" msgstr "" -#: ext/coverage.py:163 +#: util/i18n.py:113 #, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." +msgid "writing error: %s, %s" msgstr "" -#: ext/coverage.py:177 +#: util/i18n.py:146 #, python-format -msgid "invalid regex %r in coverage_c_regexes" +msgid "locale_dir %s does not exist" msgstr "" -#: ext/coverage.py:245 +#: util/i18n.py:244 #, python-format -msgid "undocumented c api: %s [%s] in file %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: ext/coverage.py:429 +#: util/i18n.py:253 #, python-format -msgid "undocumented python function: %s :: %s" +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: ext/coverage.py:445 +#: util/osutil.py:131 #, python-format -msgid "undocumented python class: %s :: %s" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: ext/coverage.py:458 -#, python-format -msgid "undocumented python method: %s :: %s :: %s" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: ext/todo.py:71 -msgid "Todo" +#: util/display.py:87 +msgid "failed" msgstr "" -#: ext/todo.py:104 +#: util/docutils.py:325 #, python-format -msgid "TODO entry found: %s" -msgstr "" - -#: ext/todo.py:163 -msgid "<>" +msgid "unknown directive name: %s" msgstr "" -#: ext/todo.py:165 +#: util/docutils.py:361 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "unknown role name: %s" msgstr "" -#: ext/todo.py:175 -msgid "original entry" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: ext/extlinks.py:82 +#: util/fileutil.py:76 #, python-format msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: ext/doctest.py:115 +#: util/fileutil.py:89 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "Writing evaluated template result to %s" msgstr "" -#: ext/doctest.py:120 +#: util/docfields.py:103 #, python-format -msgid "'%s' is not a valid option." +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: ext/doctest.py:134 +#: util/rst.py:73 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "" - -#: ext/doctest.py:220 -msgid "invalid TestCode type" +msgid "default role %s not found" msgstr "" -#: ext/doctest.py:281 +#: util/nodes.py:462 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: ext/doctest.py:434 +#: util/nodes.py:523 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: ext/doctest.py:522 +#: util/nodes.py:739 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "" - -#: ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: ext/graphviz.py:145 -#, python-format -msgid "External Graphviz file %r not found or reading it failed" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: ext/graphviz.py:268 -#, python-format -msgid "graphviz_dot executable path must be set! %r" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: ext/graphviz.py:303 -#, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: ext/graphviz.py:310 -#, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: ext/graphviz.py:313 -#, python-format -msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: ext/graphviz.py:329 -#, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: ext/graphviz.py:333 ext/graphviz.py:386 ext/graphviz.py:423 +#: transforms/post_transforms/images.py:79 #, python-format -msgid "dot code %r: %s" +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: ext/graphviz.py:436 ext/graphviz.py:444 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "[graph: %s]" -msgstr "" - -#: ext/graphviz.py:438 ext/graphviz.py:446 -msgid "[graph]" -msgstr "" - -#: ext/imgmath.py:369 ext/mathjax.py:52 -msgid "Link to this equation" +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: ext/apidoc.py:85 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "Would create file %s." -msgstr "" - -#: ext/apidoc.py:375 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "" - -#: ext/apidoc.py:392 -msgid "path to module to document" -msgstr "" - -#: ext/apidoc.py:396 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "" - -#: ext/apidoc.py:407 -msgid "directory to place all output" -msgstr "" - -#: ext/apidoc.py:422 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "" - -#: ext/apidoc.py:429 -msgid "overwrite existing files" +msgid "Unknown image format: %s..." msgstr "" -#: ext/apidoc.py:437 +#: transforms/post_transforms/__init__.py:88 msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "" - -#: ext/apidoc.py:446 -msgid "run the script without creating files" -msgstr "" - -#: ext/apidoc.py:453 -msgid "put documentation for each module on its own page" -msgstr "" - -#: ext/apidoc.py:460 -msgid "include \"_private\" modules" -msgstr "" - -#: ext/apidoc.py:467 -msgid "filename of table of contents (default: modules)" -msgstr "" - -#: ext/apidoc.py:474 -msgid "don't create a table of contents file" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: ext/apidoc.py:481 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: ext/apidoc.py:492 -msgid "put module documentation before submodule documentation" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: ext/apidoc.py:498 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: ext/apidoc.py:508 -msgid "file suffix (default: rst)" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: ext/apidoc.py:515 ext/autosummary/generate.py:839 -msgid "Remove existing files in the output directory that were not generated" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: ext/apidoc.py:524 -msgid "generate a full project with sphinx-quickstart" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: ext/apidoc.py:531 -msgid "append module_path to sys.path, used when --full is given" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: ext/apidoc.py:538 -msgid "project name (default: root module name)" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: ext/apidoc.py:545 -msgid "project author(s), used when --full is given" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: ext/apidoc.py:552 -msgid "project version, used when --full is given" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: ext/apidoc.py:559 -msgid "project release, used when --full is given, defaults to --doc-version" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: ext/apidoc.py:564 -msgid "extension options" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: ext/apidoc.py:638 -#, python-format -msgid "%s is not a directory." +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: ext/apidoc.py:710 ext/autosummary/generate.py:875 -#, python-format -msgid "Failed to remove %s: %s" +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: ext/autosectionlabel.py:48 +#: themes/basic/layout.html:115 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "Search within %(docstitle)s" msgstr "" -#: domains/std/__init__.py:703 domains/std/__init__.py:812 -#: ext/autosectionlabel.py:52 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: ext/duration.py:85 -msgid "" -"====================== slowest reading durations =======================" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: ext/imgmath.py:159 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: ext/imgmath.py:174 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: ext/imgmath.py:328 +#: themes/basic/layout.html:201 #, python-format -msgid "display latex %r: %s" +msgid "Last updated on %(last_updated)s." msgstr "" -#: ext/imgmath.py:362 +#: themes/basic/layout.html:204 #, python-format -msgid "inline latex %r: %s" -msgstr "" - -#: writers/latex.py:1090 writers/manpage.py:263 writers/texinfo.py:662 -msgid "Footnotes" +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: writers/manpage.py:309 writers/text.py:936 -#, python-format -msgid "[image: %s]" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: writers/manpage.py:310 writers/text.py:937 -msgid "[image]" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: writers/html5.py:99 writers/html5.py:108 -msgid "Link to this definition" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: writers/html5.py:415 -#, python-format -msgid "numfig_format is not defined for %s" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: writers/html5.py:427 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:482 -msgid "Link to this term" +msgid "Index – %(key)s" msgstr "" -#: writers/html5.py:525 writers/html5.py:530 -msgid "Link to this heading" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: writers/html5.py:535 -msgid "Link to this table" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" -#: writers/html5.py:549 writers/latex.py:1099 -#, python-format -msgid "unsupported rubric heading level: %s" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" msgstr "" -#: writers/html5.py:613 -msgid "Link to this code" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: writers/html5.py:615 -msgid "Link to this image" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" -#: writers/html5.py:617 -msgid "Link to this toctree" +#: themes/basic/defindex.html:4 +msgid "Overview" msgstr "" -#: writers/html5.py:758 -msgid "Could not obtain image size. :scale: option is ignored." +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" msgstr "" -#: builders/latex/__init__.py:205 domains/std/__init__.py:646 -#: domains/std/__init__.py:658 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:513 -msgid "Index" +#: themes/basic/defindex.html:9 +msgid "the documentation for" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:644 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +#: themes/basic/defindex.html:10 +msgid "last updated" msgstr "" -#: writers/texinfo.py:1216 -msgid "caption not inside a figure." +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" msgstr "" -#: writers/texinfo.py:1302 -#, python-format -msgid "unimplemented node type: %r" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" msgstr "" -#: writers/latex.py:360 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" msgstr "" -#: builders/latex/__init__.py:223 writers/latex.py:410 -#, python-format -msgid "no Babel option known for language %r" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" msgstr "" -#: writers/latex.py:428 -msgid "too large :maxdepth:, ignored." +#: themes/basic/defindex.html:19 +msgid "search this documentation" msgstr "" -#: writers/latex.py:590 -#, python-format -msgid "template %s not found; loading from legacy %s instead" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" msgstr "" -#: writers/latex.py:708 -msgid "document title is not a single Text node" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" msgstr "" -#: writers/latex.py:1175 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" msgstr "" -#: writers/latex.py:1573 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" msgstr "" -#: writers/latex.py:1931 -#, python-format -msgid "unknown index entry type %s found" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: domains/std/__init__.py:87 domains/std/__init__.py:104 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "environment variable; %s" +msgid "Search %(docstitle)s" msgstr "" -#: domains/std/__init__.py:112 -#, python-format -msgid "%s; configuration value" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" msgstr "" -#: domains/std/__init__.py:166 -msgid "Type" +#: themes/basic/genindex-split.html:17 +msgid "can be huge" msgstr "" -#: domains/std/__init__.py:176 -msgid "Default" +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." msgstr "" -#: domains/std/__init__.py:235 -#, python-format +#: themes/basic/search.html:28 msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" +"Searching for multiple words only shows matches that contain\n" +" all words." msgstr "" -#: domains/std/__init__.py:306 -#, python-format -msgid "%s command line option" +#: themes/basic/search.html:35 +msgid "search" msgstr "" -#: domains/std/__init__.py:308 -msgid "command line option" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: domains/std/__init__.py:430 -msgid "glossary term must be preceded by empty line" +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" msgstr "" -#: domains/std/__init__.py:438 -msgid "glossary terms must not be separated by empty lines" +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." msgstr "" -#: domains/std/__init__.py:444 domains/std/__init__.py:457 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" +msgstr[2] "" -#: domains/std/__init__.py:602 -msgid "glossary term" +#: themes/basic/static/searchtools.js:276 +msgid "Searching" msgstr "" -#: domains/std/__init__.py:603 -msgid "grammar token" +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." msgstr "" -#: domains/std/__init__.py:604 -msgid "reference label" +#: themes/basic/static/searchtools.js:526 +msgid ", in " msgstr "" -#: domains/std/__init__.py:607 -msgid "environment variable" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" -#: domains/std/__init__.py:608 -msgid "program option" +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 +#, python-format +msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" -#: domains/std/__init__.py:609 -msgid "document" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" msgstr "" -#: domains/std/__init__.py:647 domains/std/__init__.py:659 -msgid "Module Index" +#: themes/basic/changes/versionchanges.html:17 +#, python-format +msgid "Automatically generated list of changes in version %(version)s" msgstr "" -#: domains/std/__init__.py:648 domains/std/__init__.py:660 -#: themes/basic/defindex.html:18 -msgid "Search Page" +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" msgstr "" -#: domains/std/__init__.py:722 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" msgstr "" -#: domains/std/__init__.py:932 -msgid "numfig is disabled. :numref: is ignored." +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" msgstr "" -#: domains/std/__init__.py:940 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" msgstr "" -#: domains/std/__init__.py:952 -#, python-format -msgid "the link has no caption: %s" +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/std/__init__.py:966 -#, python-format -msgid "invalid numfig_format: %s (%r)" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/std/__init__.py:969 -#, python-format -msgid "invalid numfig_format: %s" +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" msgstr "" -#: domains/std/__init__.py:1200 -#, python-format -msgid "undefined label: %r" +#: domains/python/_object.py:206 +msgid "Variables" msgstr "" -#: domains/std/__init__.py:1202 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" +#: domains/python/_object.py:214 +msgid "Raises" msgstr "" -#: domains/python/__init__.py:107 domains/python/__init__.py:244 +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:167 domains/python/__init__.py:334 -#: domains/python/__init__.py:385 domains/python/__init__.py:424 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:169 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:194 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:195 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:249 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:251 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:389 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:428 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:559 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:560 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:637 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:663 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:665 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:666 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:668 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:669 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:729 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:858 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:920 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:304 domains/cpp/__init__.py:441 -#: domains/python/_object.py:164 ext/napoleon/docstring.py:786 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:169 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:173 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" -#: domains/c/__init__.py:199 -#, python-format -msgid "%s (C %s)" +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" msgstr "" -#: domains/c/__init__.py:260 domains/c/_symbol.py:510 +#: domains/cpp/__init__.py:302 #, python-format -msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." +msgid "%s (C++ %s)" msgstr "" -#: domains/c/__init__.py:307 domains/cpp/__init__.py:454 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:679 domains/cpp/__init__.py:860 -msgid "member" -msgstr "" - -#: domains/c/__init__.py:680 -msgid "variable" +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" msgstr "" -#: domains/c/__init__.py:682 -msgid "macro" +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" msgstr "" -#: domains/c/__init__.py:683 -msgid "struct" +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" msgstr "" -#: domains/c/__init__.py:684 domains/cpp/__init__.py:858 -msgid "union" +#: domains/cpp/__init__.py:946 +msgid "concept" msgstr "" -#: domains/c/__init__.py:685 domains/cpp/__init__.py:863 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:686 domains/cpp/__init__.py:864 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:687 domains/cpp/__init__.py:861 -msgid "type" -msgstr "" - -#: domains/c/__init__.py:689 domains/cpp/__init__.py:866 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:155 -msgid "Template Parameters" +#: domains/cpp/__init__.py:954 +msgid "template parameter" msgstr "" -#: domains/cpp/__init__.py:277 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format -msgid "%s (C++ %s)" +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/cpp/__init__.py:360 domains/cpp/_symbol.py:793 +#: domains/c/__init__.py:211 #, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." +msgid "%s (C %s)" msgstr "" -#: domains/cpp/__init__.py:862 -msgid "concept" +#: domains/c/__init__.py:778 +msgid "variable" msgstr "" -#: domains/cpp/__init__.py:867 -msgid "template parameter" +#: domains/c/__init__.py:780 +msgid "macro" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: domains/std/__init__.py:116 +#, python-format +msgid "%s; configuration value" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" +#: domains/std/__init__.py:239 +#, python-format +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: themes/basic/layout.html:18 -msgid "Navigation" +#: domains/std/__init__.py:319 +#, python-format +msgid "%s command line option" msgstr "" -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: themes/basic/layout.html:124 -msgid "About these documents" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: themes/basic/genindex-split.html:17 -msgid "can be huge" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: themes/basic/defindex.html:4 -msgid "Overview" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: themes/basic/defindex.html:9 -msgid "the documentation for" +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: themes/basic/defindex.html:10 -msgid "last updated" +#: domains/std/__init__.py:1153 +#, python-format +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" msgstr "" -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: themes/basic/defindex.html:19 -msgid "search this documentation" +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: themes/basic/defindex.html:21 -msgid "Global Module Index" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: themes/basic/searchbox.html:4 -msgid "Quick search" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: themes/basic/search.html:35 -msgid "search" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: themes/basic/relations.html:6 -msgid "previous chapter" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: themes/basic/relations.html:11 -msgid "Next topic" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: themes/basic/relations.html:13 -msgid "next chapter" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" msgstr "" -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" +msgid "alias of %s" msgstr "" -#: themes/basic/changes/versionchanges.html:17 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Automatically generated list of changes in version %(version)s" +msgid "Bases: %s" msgstr "" -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" msgstr "" -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" msgstr "" -#: themes/basic/changes/rstsource.html:5 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "%(filename)s — %(docstitle)s" +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: themes/basic/static/searchtools.js:119 -msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: themes/basic/static/searchtools.js:123 -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" -msgstr[2] "" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" +msgstr "" -#: themes/basic/static/searchtools.js:253 -msgid "Searching" +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." msgstr "" -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: themes/basic/static/searchtools.js:474 -msgid ", in " +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: environment/collectors/asset.py:96 -#, python-format -msgid "image file not readable: %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: environment/collectors/asset.py:124 -#, python-format -msgid "image file %s not readable: %s" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: environment/collectors/asset.py:161 -#, python-format -msgid "download file not readable: %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: environment/collectors/toctree.py:258 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: environment/adapters/toctree.py:318 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: environment/adapters/toctree.py:342 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: environment/adapters/toctree.py:357 -#, python-format -msgid "toctree contains reference to non-included document %r" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: environment/adapters/indexentries.py:126 -#, python-format -msgid "see %s" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: environment/adapters/indexentries.py:136 -#, python-format -msgid "see also %s" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: environment/adapters/indexentries.py:144 -#, python-format -msgid "unknown index entry type %r" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: environment/adapters/indexentries.py:270 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/__init__.py:363 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/html/__init__.py:382 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: builders/html/__init__.py:695 -msgid "generating indices" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/html/__init__.py:710 -msgid "writing additional pages" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/html/__init__.py:793 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "%s is not a directory." msgstr "" -#: builders/html/__init__.py:805 -msgid "copying downloadable files... " +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/__init__.py:817 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/__init__.py:863 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:881 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/__init__.py:916 -msgid "copying static files" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/__init__.py:933 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "cannot copy static file %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/__init__.py:938 -msgid "copying extra files" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:948 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "cannot copy extra file %r" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/__init__.py:954 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "Failed to write build info file: %r" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/html/__init__.py:1003 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: builders/html/__init__.py:1051 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/html/__init__.py:1213 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/html/__init__.py:1222 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: builders/html/__init__.py:1255 -msgid "dumping object inventory" +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: builders/html/__init__.py:1263 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "dumping search index in %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1306 +#: ext/autosummary/generate.py:630 #, python-format -msgid "invalid js_file: %r, ignored" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: builders/html/__init__.py:1339 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/autosummary/generate.py:634 +#, python-format +msgid "[autosummary] writing to %s" msgstr "" -#: builders/html/__init__.py:1344 +#: ext/autosummary/generate.py:679 #, python-format -msgid "Unknown math_renderer %r is given." +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1358 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: builders/html/__init__.py:1363 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: builders/html/__init__.py:1378 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: builders/html/__init__.py:1383 +#: ext/autosummary/generate.py:915 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1394 builders/latex/__init__.py:504 +#: ext/autosummary/generate.py:923 #, python-format -msgid "logo file %r does not exist" +msgid "custom template directory (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1405 +#: ext/autosummary/generate.py:931 #, python-format -msgid "favicon file %r does not exist" +msgid "document imported members (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1417 +#: ext/autosummary/generate.py:940 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: builders/html/__init__.py:1430 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: builders/html/__init__.py:1447 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "%s %s documentation" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: builders/latex/transforms.py:118 -msgid "Failed to get a docname!" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: builders/latex/transforms.py:119 +#: ext/autosummary/__init__.py:329 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/latex/transforms.py:485 +#: ext/autosummary/__init__.py:358 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "failed to import object %s" msgstr "" -#: builders/latex/__init__.py:117 +#: ext/autosummary/__init__.py:652 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "" - -#: builders/latex/__init__.py:119 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "" - -#: builders/latex/__init__.py:157 -msgid "no \"latex_documents\" config value found; no documents will be written" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: builders/latex/__init__.py:169 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "autosummary_generate: file not found: %s" msgstr "" -#: builders/latex/__init__.py:208 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: builders/latex/__init__.py:429 -msgid "copying TeX support files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: builders/latex/__init__.py:466 -msgid "copying additional files" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: builders/latex/__init__.py:540 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: builders/latex/__init__.py:548 +#: ext/intersphinx/_load.py:94 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: builders/latex/theming.py:87 +#: ext/intersphinx/_load.py:103 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: builders/latex/theming.py:90 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: _cli/util/errors.py:124 -msgid "Exception occurred, starting debugger:" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: _cli/util/errors.py:133 -msgid "reStructuredText markup error:" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: _cli/util/errors.py:168 -msgid "The full traceback has been saved in:" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: _cli/util/errors.py:172 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: transforms/post_transforms/__init__.py:125 +#: ext/intersphinx/_load.py:324 msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: transforms/post_transforms/__init__.py:185 +#: ext/intersphinx/_load.py:332 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: transforms/post_transforms/__init__.py:251 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: transforms/post_transforms/__init__.py:257 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "%r reference target not found: %s" +msgid "(in %s %s)" msgstr "" -#: transforms/post_transforms/images.py:77 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "(in %s)" msgstr "" -#: transforms/post_transforms/images.py:94 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: transforms/post_transforms/images.py:141 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Unknown image format: %s..." +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/napoleon/docstring.py:707 -msgid "Example" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:708 -msgid "Examples" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/napoleon/__init__.py:344 ext/napoleon/docstring.py:752 -msgid "Keyword Arguments" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:768 -msgid "Notes" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/napoleon/docstring.py:777 -msgid "Other Parameters" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:813 -msgid "Receives" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/napoleon/docstring.py:817 -msgid "References" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:849 -msgid "Warns" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/napoleon/docstring.py:853 -msgid "Yields" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/napoleon/docstring.py:1015 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/napoleon/docstring.py:1022 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1029 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1036 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:256 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:258 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/autosummary/__init__.py:277 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/autosummary/__init__.py:330 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/__init__.py:344 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "failed to parse name %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/autosummary/__init__.py:349 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "failed to import object %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/autosummary/__init__.py:648 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format msgid "" -"Summarised items should not include the current module. Replace %r with %r." +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/autosummary/__init__.py:819 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/autosummary/__init__.py:827 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/autosummary/generate.py:215 ext/autosummary/generate.py:391 -#, python-format -msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/autosummary/generate.py:526 +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/autosummary/generate.py:530 +#: builders/html/__init__.py:337 #, python-format -msgid "[autosummary] writing to %s" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/autosummary/generate.py:572 +#: builders/html/__init__.py:372 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/autosummary/generate.py:767 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/autosummary/generate.py:789 -msgid "source files to generate rST files for" +#: builders/html/__init__.py:549 +#, python-format +msgid "Logo of %s" msgstr "" -#: ext/autosummary/generate.py:797 -msgid "directory to place all output in" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/autosummary/generate.py:805 -#, python-format -msgid "default suffix for files (default: %(default)s)" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/autosummary/generate.py:813 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/autosummary/generate.py:821 -#, python-format -msgid "document imported members (default: %(default)s)" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/autosummary/generate.py:829 +#: builders/html/__init__.py:783 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:47 -#, python-format -msgid "(in %s v%s)" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:807 #, python-format -msgid "(in %s)" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:103 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:113 +#: builders/html/__init__.py:871 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:359 -#, python-format -msgid "inventory for external cross-reference not found: %r" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:367 +#: builders/html/__init__.py:923 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "cannot copy static file %r" msgstr "" -#: ext/intersphinx/_resolve.py:378 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_resolve.py:585 +#: builders/html/__init__.py:938 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:59 +#: builders/html/__init__.py:944 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_load.py:70 -#, python-format +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:81 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:92 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:101 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:120 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:155 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:240 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:265 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:275 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:319 +#: builders/html/__init__.py:1365 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/type_comment.py:132 +#: builders/html/__init__.py:1370 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/type_comment.py:135 +#: builders/html/__init__.py:1385 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:142 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:415 +#: builders/html/__init__.py:1412 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:532 +#: builders/html/__init__.py:1425 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:807 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:902 +#: builders/html/__init__.py:1454 #, python-format -msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +msgid "%s %s documentation" msgstr "" -#: ext/autodoc/__init__.py:946 +#: builders/latex/theming.py:87 #, python-format -msgid "A mocked object is detected: %r" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:965 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1028 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1035 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1048 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1114 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "" + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1337 ext/autodoc/__init__.py:1414 -#: ext/autodoc/__init__.py:2829 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1633 +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1760 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1774 +#: environment/collectors/toctree.py:259 #, python-format -msgid "missing attribute %s in object %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1855 ext/autodoc/__init__.py:1892 -#: ext/autodoc/__init__.py:1987 +#: environment/collectors/asset.py:98 #, python-format -msgid "alias of %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1875 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of TypeVar(%s)" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2217 ext/autodoc/__init__.py:2317 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2448 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/preserve_defaults.py:190 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/he/LC_MESSAGES/sphinx.mo b/sphinx/locale/he/LC_MESSAGES/sphinx.mo index e9be342b78f..72013c5703c 100644 Binary files a/sphinx/locale/he/LC_MESSAGES/sphinx.mo and b/sphinx/locale/he/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/he/LC_MESSAGES/sphinx.po b/sphinx/locale/he/LC_MESSAGES/sphinx.po index 704aa34cda1..374ef936974 100644 --- a/sphinx/locale/he/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/he/LC_MESSAGES/sphinx.po @@ -1,5 +1,5 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: @@ -8,153 +8,300 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-29 22:39+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FIRST AUTHOR , 2011\n" "Language-Team: Hebrew (http://app.transifex.com/sphinx-doc/sphinx-1/language/he/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" "Language: he\n" "Plural-Forms: nplurals=3; plural=(n == 1 && n % 1 == 0) ? 0 : (n == 2 && n % 1 == 0) ? 1: 2;\n" -#: events.py:77 +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "" + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "" + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 #, python-format msgid "Event %r already present" msgstr "" -#: events.py:370 +#: events.py:386 #, python-format msgid "Unknown event name: %s" msgstr "" -#: events.py:416 +#: events.py:451 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" -#: application.py:190 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:194 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:198 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:228 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:250 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:266 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:271 registry.py:452 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:277 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:312 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:329 util/display.py:88 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:331 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:345 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:353 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:366 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:398 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:400 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:404 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:407 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:409 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:414 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:417 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:419 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:968 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1047 +#: application.py:1113 #, python-format -msgid "directive %r is already registered, it will be overridden" +msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1069 application.py:1094 +#: application.py:1139 application.py:1167 #, python-format -msgid "role %r is already registered, it will be overridden" +msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1644 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1648 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1651 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,1153 +322,1307 @@ msgid "" "explicit" msgstr "" -#: application.py:1655 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1663 application.py:1667 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: roles.py:208 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:231 -#, python-format -msgid "invalid CVE number %s" -msgstr "" - -#: roles.py:253 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" - -#: roles.py:276 -#, python-format -msgid "invalid CWE number %s" -msgstr "" - -#: roles.py:296 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "" - -#: roles.py:319 -#, python-format -msgid "invalid PEP number %s" -msgstr "" - -#: roles.py:357 -#, python-format -msgid "invalid RFC number %s" -msgstr "" - -#: registry.py:144 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" -#: registry.py:146 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" -#: registry.py:159 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" -#: registry.py:166 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "" -#: registry.py:173 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "" -#: registry.py:196 registry.py:209 registry.py:220 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "" -#: registry.py:200 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" -#: registry.py:212 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" -#: registry.py:223 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" -#: registry.py:254 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "" -#: registry.py:280 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "" -#: registry.py:287 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "" -#: registry.py:296 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "" -#: registry.py:304 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "" -#: registry.py:320 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "" -#: registry.py:336 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: registry.py:419 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "" -#: registry.py:431 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "" -#: registry.py:446 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" -#: registry.py:457 +#: registry.py:545 msgid "Original exception:\n" msgstr "" -#: registry.py:458 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "" -#: registry.py:463 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" -#: registry.py:472 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" -#: registry.py:480 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" -#: registry.py:514 +#: registry.py:605 #, python-format msgid "`None` is not a valid filetype for %r." msgstr "" -#: project.py:71 +#: config.py:351 #, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: project.py:87 +#: config.py:374 #, python-format -msgid "Ignored unreadable document %r." +msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: highlighting.py:168 +#: config.py:379 #, python-format -msgid "Pygments lexer name %r is not known" +msgid "" +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" msgstr "" -#: highlighting.py:202 +#: config.py:391 #, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: extension.py:55 +#: config.py:399 #, python-format -msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." +msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: extension.py:76 +#: config.py:422 #, python-format -msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." +msgid "unknown config value %r in override, ignoring" msgstr "" -#: theming.py:114 +#: config.py:476 #, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +msgid "No such config value: %r" msgstr "" -#: theming.py:120 +#: config.py:504 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +msgid "Config value %r already present" msgstr "" -#: theming.py:135 +#: config.py:541 #, python-format -msgid "unsupported theme option %r given" +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" msgstr "" -#: theming.py:207 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." msgstr "" -#: theming.py:228 +#: config.py:599 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: theming.py:268 -#, python-format -msgid "The %r theme has circular inheritance" +#: config.py:603 +msgid "" +"The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: theming.py:275 +#: config.py:611 #, python-format msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" msgstr "" -#: theming.py:282 +#: config.py:633 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to convert %r to a frozenset" msgstr "" -#: theming.py:310 +#: config.py:651 config.py:659 #, python-format -msgid "no theme configuration file found in %r" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: theming.py:335 theming.py:388 +#: config.py:665 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." msgstr "" -#: theming.py:339 +#: config.py:686 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" +msgid "Section %s" msgstr "" -#: theming.py:343 theming.py:391 +#: config.py:687 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "Fig. %s" msgstr "" -#: theming.py:347 +#: config.py:688 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "Table %s" msgstr "" -#: theming.py:366 +#: config.py:689 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgid "Listing %s" msgstr "" -#: config.py:309 -#, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +#: config.py:798 +#, python-brace-format +msgid "" +"The config value `{name}` has to be a one of {candidates}, but `{current}` " +"is given." msgstr "" -#: config.py:318 +#: config.py:829 +#, python-brace-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"The config value `{name}' has type `{current.__name__}'; expected " +"{permitted}." msgstr "" -#: config.py:341 -#, python-format +#: config.py:846 +#, python-brace-format msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" +"The config value `{name}' has type `{current.__name__}', defaults to " +"`{default.__name__}'." msgstr "" -#: config.py:350 +#: config.py:858 #, python-format -msgid "invalid number %r for config value %r, ignoring" +msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:356 -#, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" +#: config.py:878 +msgid "" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: config.py:377 -#, python-format -msgid "unknown config value %r in override, ignoring" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: config.py:430 -#, python-format -msgid "No such config value: %r" +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: config.py:453 -#, python-format -msgid "Config value %r already present" +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: config.py:489 -#, python-format -msgid "" -"cannot cache unpickable configuration value: %r (because it contains a " -"function, class, or module object)" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: config.py:527 -#, python-format -msgid "There is a syntax error in your configuration file: %s\n" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: config.py:530 -msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: config.py:537 +#: environment/__init__.py:350 #, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: config.py:560 +#: environment/__init__.py:355 #, python-format -msgid "Failed to convert %r to a set or tuple" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: config.py:581 config.py:586 +#: environment/__init__.py:361 #, python-format -msgid "Converting `source_suffix = %r` to `source_suffix = %r`." +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: config.py:589 -#, python-format +#: environment/__init__.py:404 msgid "" -"The config value `source_suffix' expects a dictionary, a string, or a list " -"of strings. Got `%r' instead (type %s)." +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: config.py:608 +#: environment/__init__.py:518 #, python-format -msgid "Section %s" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: config.py:609 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "Fig. %s" +msgid "Domain %r is not registered" +msgstr "" + +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "" + +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: config.py:610 +#: environment/__init__.py:952 #, python-format -msgid "Table %s" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: config.py:611 +#: locale/__init__.py:229 +msgid "Attention" +msgstr "תשומת לב" + +#: locale/__init__.py:230 +msgid "Caution" +msgstr "זהירות" + +#: locale/__init__.py:231 +msgid "Danger" +msgstr "סכנה" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "שגיאה" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "רמז" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "חשוב" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "הערה" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "ראה גם" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "טיפ" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "אזהרה" + +#: builders/texinfo.py:41 #, python-format -msgid "Listing %s" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: config.py:718 +#: builders/texinfo.py:44 msgid "" -"The config value `{name}` has to be a one of {candidates}, but `{current}` " -"is given." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: config.py:742 -msgid "" -"The config value `{name}' has type `{current.__name__}'; expected " -"{permitted}." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: config.py:755 -msgid "" -"The config value `{name}' has type `{current.__name__}', defaults to " -"`{default.__name__}'." +#: builders/texinfo.py:85 +#, python-format +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: config.py:766 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "primary_domain %r not found, ignored." +msgid "processing %s" msgstr "" -#: config.py:778 -msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "" + +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "" + +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "(בתוך" + +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: domains/rst.py:128 domains/rst.py:185 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "%s (directive)" +msgid "cannot copy image file %r: %s" +msgstr "" + +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: domains/rst.py:186 domains/rst.py:190 +#: builders/texinfo.py:218 #, python-format -msgid ":%s: (directive option)" +msgid "error writing file Makefile: %s" msgstr "" -#: domains/rst.py:214 +#: builders/manpage.py:37 #, python-format -msgid "%s (role)" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: domains/rst.py:224 -msgid "directive" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: domains/rst.py:225 -msgid "directive-option" +#: builders/manpage.py:64 +#, python-format +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: domains/rst.py:226 -msgid "role" +#: builders/singlehtml.py:35 +#, python-format +msgid "The HTML page is in %(outdir)s." +msgstr "" + +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "" + +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "" + +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: domains/rst.py:248 +#: builders/gettext.py:243 #, python-format -msgid "duplicate description of %s %s, other instance in %s" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: domains/javascript.py:165 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "%s() (built-in function)" +msgid "building [%s]: " msgstr "" -#: domains/javascript.py:166 domains/python/__init__.py:253 +#: builders/gettext.py:265 #, python-format -msgid "%s() (%s method)" +msgid "targets for %d template files" +msgstr "" + +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "" + +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: domains/javascript.py:168 +#: builders/linkcheck.py:87 #, python-format -msgid "%s() (class)" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: domains/javascript.py:170 +#: builders/linkcheck.py:159 #, python-format -msgid "%s (global variable or constant)" +msgid "broken link: %s (%s)" msgstr "" -#: domains/javascript.py:172 domains/python/__init__.py:338 +#: builders/linkcheck.py:561 #, python-format -msgid "%s (%s attribute)" +msgid "Anchor '%s' not found" msgstr "" -#: domains/javascript.py:255 -msgid "Arguments" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: domains/cpp/__init__.py:447 domains/javascript.py:258 -msgid "Throws" +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: domains/c/__init__.py:310 domains/cpp/__init__.py:458 -#: domains/javascript.py:261 domains/python/_object.py:176 -msgid "Returns" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: domains/c/__init__.py:312 domains/javascript.py:263 -#: domains/python/_object.py:178 -msgid "Return type" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: domains/javascript.py:334 -#, python-format -msgid "%s (module)" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: domains/c/__init__.py:681 domains/cpp/__init__.py:859 -#: domains/javascript.py:371 domains/python/__init__.py:660 -msgid "function" -msgstr "פונקציה" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "" -#: domains/javascript.py:372 domains/python/__init__.py:664 -msgid "method" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: domains/cpp/__init__.py:857 domains/javascript.py:373 -#: domains/python/__init__.py:662 -msgid "class" -msgstr "מחלקה" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "" -#: domains/javascript.py:374 domains/python/__init__.py:661 -msgid "data" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: domains/javascript.py:375 domains/python/__init__.py:667 -msgid "attribute" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: domains/javascript.py:376 domains/python/__init__.py:670 -msgid "module" -msgstr "מודול" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: domains/javascript.py:407 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: domains/changeset.py:25 -#, python-format -msgid "Added in version %s" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Changed in version %s" -msgstr "השתנה בגרסה %s" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" -#: domains/changeset.py:27 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "Deprecated since version %s" -msgstr " לא מומלץ לשימוש מגרסה %s" +msgid "invalid css_file: %r, ignored" +msgstr "" -#: domains/changeset.py:28 +#: builders/xml.py:29 #, python-format -msgid "Removed in version %s" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/__init__.py:299 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "%s %s" +msgid "error writing file %s: %s" msgstr "" -#: domains/citation.py:73 +#: builders/xml.py:103 #, python-format -msgid "duplicate citation %s, other instance in %s" +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: domains/citation.py:84 +#: builders/_epub_base.py:223 #, python-format -msgid "Citation [%s] is not referenced." +msgid "duplicated ToC entry found: %s" msgstr "" -#: domains/math.py:63 +#: builders/_epub_base.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: domains/math.py:119 writers/latex.py:2479 +#: builders/_epub_base.py:467 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: environment/__init__.py:81 -msgid "new config" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: environment/__init__.py:82 -msgid "config changed" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: environment/__init__.py:83 -msgid "extensions changed" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: environment/__init__.py:249 -msgid "build environment version not current" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: environment/__init__.py:251 -msgid "source directory has changed" +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: environment/__init__.py:313 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: environment/__init__.py:318 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." msgstr "" -#: environment/__init__.py:324 +#: builders/_epub_base.py:802 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "writing %s file..." msgstr "" -#: environment/__init__.py:366 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." msgstr "" -#: environment/__init__.py:473 +#: builders/__init__.py:229 #, python-format -msgid "Failed to scan documents in %s: %r" +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: environment/__init__.py:626 +#: builders/__init__.py:237 #, python-format -msgid "Domain %r is not registered" +msgid "a suitable image for %s builder not found: %s" msgstr "" -#: environment/__init__.py:777 -msgid "document isn't included in any toctree" +#: builders/__init__.py:260 +msgid "building [mo]: " msgstr "" -#: environment/__init__.py:810 -msgid "self referenced toctree found. Ignored." +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " msgstr "" -#: environment/__init__.py:839 +#: builders/__init__.py:280 #, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgid "all of %d po files" msgstr "" -#: locale/__init__.py:229 -msgid "Attention" -msgstr "תשומת לב" +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" -#: locale/__init__.py:230 -msgid "Caution" -msgstr "זהירות" +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" -#: locale/__init__.py:231 -msgid "Danger" -msgstr "סכנה" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" -#: locale/__init__.py:232 -msgid "Error" -msgstr "שגיאה" - -#: locale/__init__.py:233 -msgid "Hint" -msgstr "רמז" +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" -#: locale/__init__.py:234 -msgid "Important" -msgstr "חשוב" +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" -#: locale/__init__.py:235 -msgid "Note" -msgstr "הערה" +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" -#: locale/__init__.py:236 -msgid "See also" -msgstr "ראה גם" +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" -#: locale/__init__.py:237 -msgid "Tip" -msgstr "טיפ" +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" -#: locale/__init__.py:238 -msgid "Warning" -msgstr "אזהרה" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" -#: cmd/quickstart.py:43 -msgid "automatically insert docstrings from modules" +#: builders/__init__.py:415 +#, python-format +msgid "%d found" msgstr "" -#: cmd/quickstart.py:44 -msgid "automatically test code snippets in doctest blocks" +#: builders/__init__.py:417 +msgid "none found" msgstr "" -#: cmd/quickstart.py:45 -msgid "link between Sphinx documentation of different projects" +#: builders/__init__.py:424 +msgid "pickling environment" msgstr "" -#: cmd/quickstart.py:46 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: builders/__init__.py:431 +msgid "checking consistency" msgstr "" -#: cmd/quickstart.py:47 -msgid "checks for documentation coverage" +#: builders/__init__.py:435 +msgid "no targets are out of date." msgstr "" -#: cmd/quickstart.py:48 -msgid "include math, rendered as PNG or SVG images" +#: builders/__init__.py:474 +msgid "updating environment: " msgstr "" -#: cmd/quickstart.py:49 -msgid "include math, rendered in the browser by MathJax" +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: cmd/quickstart.py:50 -msgid "conditional inclusion of content based on config values" +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: cmd/quickstart.py:51 -msgid "include links to the source code of documented Python objects" +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: cmd/quickstart.py:52 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: cmd/quickstart.py:94 -msgid "Please enter a valid path name." +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter some text." +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " msgstr "" -#: cmd/quickstart.py:117 +#: builders/__init__.py:725 #, python-format -msgid "Please enter one of %s." +msgid "docnames to write: %s" msgstr "" -#: cmd/quickstart.py:125 -msgid "Please enter either 'y' or 'n'." +#: builders/__init__.py:727 +msgid "no docnames to write!" msgstr "" -#: cmd/quickstart.py:131 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: builders/__init__.py:740 +msgid "preparing documents" msgstr "" -#: cmd/quickstart.py:215 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: builders/__init__.py:743 +msgid "copying assets" msgstr "" -#: cmd/quickstart.py:219 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." msgstr "" -#: cmd/quickstart.py:227 +#: builders/changes.py:65 #, python-format -msgid "Selected root path: %s" +msgid "no changes in version %s." msgstr "" -#: cmd/quickstart.py:230 -msgid "Enter the root path for documentation." +#: builders/changes.py:67 +msgid "writing summary file..." msgstr "" -#: cmd/quickstart.py:231 -msgid "Root path for the documentation" +#: builders/changes.py:79 +msgid "Builtins" msgstr "" -#: cmd/quickstart.py:239 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "" +#: builders/changes.py:81 +msgid "Module level" +msgstr "רמת המודול" -#: cmd/quickstart.py:245 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: builders/changes.py:137 +msgid "copying source files..." msgstr "" -#: cmd/quickstart.py:248 -msgid "Please enter a new root path (or just Enter to exit)" +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" -#: cmd/quickstart.py:258 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" msgstr "" -#: cmd/quickstart.py:265 -msgid "Separate source and build directories (y/n)" +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" msgstr "" -#: cmd/quickstart.py:271 +#: ext/coverage.py:148 +#, python-format msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"the following modules are documented but were not specified in " +"coverage_modules: %s" msgstr "" -#: cmd/quickstart.py:277 -msgid "Name prefix for templates and static dir" +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" msgstr "" -#: cmd/quickstart.py:282 +#: ext/coverage.py:172 +#, python-brace-format, python-format msgid "" -"The project name will occur in several places in the built documentation." +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." msgstr "" -#: cmd/quickstart.py:286 -msgid "Project name" +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" msgstr "" -#: cmd/quickstart.py:288 -msgid "Author name(s)" +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" msgstr "" -#: cmd/quickstart.py:293 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" msgstr "" -#: cmd/quickstart.py:301 -msgid "Project version" +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" msgstr "" -#: cmd/quickstart.py:303 -msgid "Project release" +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" msgstr "" -#: cmd/quickstart.py:308 +#: ext/extlinks.py:82 +#, python-format msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project language" +#: ext/todo.py:61 +msgid "Todo" +msgstr "לעשות" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" msgstr "" -#: cmd/quickstart.py:324 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: ext/todo.py:152 +msgid "<>" msgstr "" -#: cmd/quickstart.py:329 -msgid "Source file suffix" +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" msgstr "" -#: cmd/quickstart.py:334 +#: ext/todo.py:166 +msgid "original entry" +msgstr "הטקסט המקורי" + +#: ext/imgconverter.py:44 +#, python-format msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" msgstr "" -#: cmd/quickstart.py:342 -msgid "Name of your master document (without suffix)" +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:352 +#: ext/imgconverter.py:83 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" -#: cmd/quickstart.py:359 -msgid "sphinx-quickstart will not overwrite the existing file." +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" -#: cmd/quickstart.py:362 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: ext/graphviz.py:153 +#, python-format +msgid "External Graphviz file %r not found or reading it failed" msgstr "" -#: cmd/quickstart.py:371 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "" + +#: ext/graphviz.py:287 +#, python-format +msgid "graphviz_dot executable path must be set! %r" msgstr "" -#: cmd/quickstart.py:381 +#: ext/graphviz.py:328 +#, python-format msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" msgstr "" -#: cmd/quickstart.py:391 +#: ext/graphviz.py:339 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:397 -msgid "Create Makefile? (y/n)" +#: ext/graphviz.py:344 +#, python-format +msgid "" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:401 -msgid "Create Windows command file? (y/n)" +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" msgstr "" -#: cmd/quickstart.py:453 ext/apidoc.py:92 +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 #, python-format -msgid "Creating file %s." +msgid "dot code %r: %s" msgstr "" -#: cmd/quickstart.py:458 ext/apidoc.py:89 +#: ext/graphviz.py:493 ext/graphviz.py:501 #, python-format -msgid "File %s already exists, skipping." +msgid "[graph: %s]" msgstr "" -#: cmd/quickstart.py:501 -msgid "Finished: An initial directory structure has been created." +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" msgstr "" -#: cmd/quickstart.py:504 +#: ext/imgmath.py:148 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: cmd/quickstart.py:512 +#: ext/imgmath.py:167 +#, python-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: cmd/quickstart.py:515 +#: ext/imgmath.py:326 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +msgid "display latex %r: %s" msgstr "" -#: cmd/quickstart.py:522 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: cmd/quickstart.py:557 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: cmd/build.py:153 cmd/quickstart.py:567 ext/apidoc.py:374 -#: ext/autosummary/generate.py:766 -msgid "For more information, visit ." +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: cmd/quickstart.py:577 -msgid "quiet mode" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." msgstr "" -#: cmd/quickstart.py:587 -msgid "project root" +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" msgstr "" -#: cmd/quickstart.py:590 -msgid "Structure options" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: cmd/quickstart.py:596 -msgid "if specified, separate source and build dirs" +#: ext/doctest.py:297 +#, python-format +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: cmd/quickstart.py:602 -msgid "if specified, create build dir under source dir" +#: ext/doctest.py:451 +#, python-format +msgid "no code/output in %s block at %s:%s" msgstr "" -#: cmd/quickstart.py:608 -msgid "replacement for dot in _templates etc." +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: cmd/quickstart.py:611 -msgid "Project basic options" +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: cmd/quickstart.py:613 -msgid "project name" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: cmd/quickstart.py:616 -msgid "author names" +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: cmd/quickstart.py:623 -msgid "version of project" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: cmd/quickstart.py:630 -msgid "release of project" +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: cmd/quickstart.py:637 -msgid "document language" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: cmd/quickstart.py:640 -msgid "source file suffix" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: cmd/quickstart.py:643 -msgid "master document name" -msgstr "" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[מקור]" -#: cmd/quickstart.py:646 -msgid "use epub" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: cmd/quickstart.py:649 -msgid "Extension options" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[תיעוד]" + +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: cmd/quickstart.py:656 ext/apidoc.py:578 +#: ext/viewcode.py:359 #, python-format -msgid "enable %s extension" +msgid "

        Source code for %s

        " +msgstr "

        הראה קוד מקור ל %s

        " + +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: cmd/quickstart.py:663 ext/apidoc.py:570 -msgid "enable arbitrary extensions" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        כל המודולים שיש להם קוד זמין

        " + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: cmd/quickstart.py:666 -msgid "Makefile and Batchfile creation" +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:672 -msgid "create makefile" +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: cmd/quickstart.py:678 -msgid "do not create makefile" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: cmd/quickstart.py:685 -msgid "create batchfile" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: cmd/quickstart.py:691 -msgid "do not create batchfile" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: cmd/quickstart.py:700 -msgid "use make-mode for Makefile/make.bat" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" msgstr "" -#: cmd/quickstart.py:703 ext/apidoc.py:581 -msgid "Project templating" +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" msgstr "" -#: cmd/quickstart.py:709 ext/apidoc.py:587 -msgid "template directory for template files" +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" msgstr "" -#: cmd/quickstart.py:716 -msgid "define a template variable" +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: cmd/quickstart.py:751 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: cmd/quickstart.py:770 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: cmd/quickstart.py:777 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: cmd/quickstart.py:795 +#: domains/javascript.py:374 #, python-format -msgid "Invalid template variable: %s" +msgid "%s (module)" +msgstr "" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "פונקציה" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: cmd/build.py:49 -msgid "Exception occurred while building, starting debugger:" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "מחלקה" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: _cli/util/errors.py:129 cmd/build.py:65 -msgid "Interrupted!" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: cmd/build.py:67 -msgid "reST markup error:" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "מודול" + +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: _cli/util/errors.py:143 cmd/build.py:73 -msgid "Encoding error:" +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: cmd/build.py:78 cmd/build.py:108 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." +msgid ":%s: (directive option)" msgstr "" -#: _cli/util/errors.py:148 cmd/build.py:90 -msgid "Recursion error:" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: _cli/util/errors.py:152 cmd/build.py:94 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: _cli/util/errors.py:165 cmd/build.py:103 -msgid "Exception occurred:" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: _cli/util/errors.py:178 cmd/build.py:117 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: cmd/build.py:124 -msgid "" -"A bug report can be filed in the tracker at . Thanks!" +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "" + +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" +msgstr "" + +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "השתנה בגרסה %s" + +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr " לא מומלץ לשימוש מגרסה %s" + +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" +msgstr "" + +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" msgstr "" -#: cmd/build.py:144 +#: cmd/build.py:64 msgid "job number should be a positive number" msgstr "" -#: cmd/build.py:154 +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" + +#: cmd/build.py:74 msgid "" "\n" "Generate documentation from source files.\n" @@ -1340,675 +1641,589 @@ msgid "" "files can be built by specifying individual filenames.\n" msgstr "" -#: cmd/build.py:180 +#: cmd/build.py:100 msgid "path to documentation source files" msgstr "" -#: cmd/build.py:183 +#: cmd/build.py:103 msgid "path to output directory" msgstr "" -#: cmd/build.py:188 +#: cmd/build.py:109 msgid "" "(optional) a list of specific files to rebuild. Ignored if --write-all is " "specified" msgstr "" -#: cmd/build.py:194 +#: cmd/build.py:114 msgid "general options" msgstr "" -#: cmd/build.py:201 +#: cmd/build.py:121 msgid "builder to use (default: 'html')" msgstr "" -#: cmd/build.py:210 +#: cmd/build.py:131 msgid "" "run in parallel with N processes, when possible. 'auto' uses the number of " "CPU cores" msgstr "" -#: cmd/build.py:220 +#: cmd/build.py:140 msgid "write all files (default: only write new and changed files)" msgstr "" -#: cmd/build.py:227 +#: cmd/build.py:147 msgid "don't use a saved environment, always read all files" msgstr "" -#: cmd/build.py:230 +#: cmd/build.py:150 msgid "path options" msgstr "" -#: cmd/build.py:236 +#: cmd/build.py:157 msgid "" "directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: cmd/build.py:246 +#: cmd/build.py:166 msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: cmd/build.py:255 +#: cmd/build.py:175 msgid "use no configuration file, only use settings from -D options" msgstr "" -#: cmd/build.py:264 +#: cmd/build.py:184 msgid "override a setting in configuration file" msgstr "" -#: cmd/build.py:273 +#: cmd/build.py:193 msgid "pass a value into HTML templates" msgstr "" -#: cmd/build.py:282 +#: cmd/build.py:202 msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: cmd/build.py:289 +#: cmd/build.py:209 msgid "nitpicky mode: warn about all missing references" msgstr "" -#: cmd/build.py:292 +#: cmd/build.py:212 msgid "console output options" msgstr "" -#: cmd/build.py:299 +#: cmd/build.py:219 msgid "increase verbosity (can be repeated)" msgstr "" -#: cmd/build.py:306 ext/apidoc.py:413 +#: cmd/build.py:226 ext/apidoc/_cli.py:66 msgid "no output on stdout, just warnings on stderr" msgstr "" -#: cmd/build.py:313 +#: cmd/build.py:233 msgid "no output at all, not even warnings" msgstr "" -#: cmd/build.py:321 +#: cmd/build.py:241 msgid "do emit colored output (default: auto-detect)" msgstr "" -#: cmd/build.py:329 +#: cmd/build.py:249 msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: cmd/build.py:332 +#: cmd/build.py:252 msgid "warning control options" msgstr "" -#: cmd/build.py:338 +#: cmd/build.py:258 msgid "write warnings (and errors) to given file" msgstr "" -#: cmd/build.py:345 +#: cmd/build.py:265 msgid "turn warnings into errors" msgstr "" -#: cmd/build.py:353 +#: cmd/build.py:273 msgid "show full traceback on exception" msgstr "" -#: cmd/build.py:356 +#: cmd/build.py:276 msgid "run Pdb on exception" msgstr "" -#: cmd/build.py:362 +#: cmd/build.py:282 msgid "raise an exception on warnings" msgstr "" -#: cmd/build.py:405 +#: cmd/build.py:325 msgid "cannot combine -a option and filenames" msgstr "" -#: cmd/build.py:437 +#: cmd/build.py:357 #, python-format msgid "cannot open warning file '%s': %s" msgstr "" -#: cmd/build.py:456 +#: cmd/build.py:376 msgid "-D option argument must be in the form name=value" msgstr "" -#: cmd/build.py:463 +#: cmd/build.py:383 msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "" - -#: builders/linkcheck.py:75 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/linkcheck.py:146 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/linkcheck.py:540 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/linkcheck.py:742 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/singlehtml.py:37 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/singlehtml.py:173 -msgid "assembling single document" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/latex/__init__.py:346 builders/manpage.py:56 -#: builders/singlehtml.py:178 builders/texinfo.py:121 -msgid "writing" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/singlehtml.py:191 -msgid "writing additional files" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/manpage.py:39 -#, python-format -msgid "The manual pages are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/manpage.py:47 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/manpage.py:73 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/text.py:34 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/html/__init__.py:1239 builders/text.py:81 builders/xml.py:97 +#: cmd/quickstart.py:134 #, python-format -msgid "error writing file %s: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/xml.py:38 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/xml.py:110 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/texinfo.py:47 +#: cmd/quickstart.py:230 #, python-format -msgid "The Texinfo files are in %(outdir)s." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/texinfo.py:49 +#: cmd/quickstart.py:235 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "" - -#: builders/texinfo.py:78 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/texinfo.py:90 +#: cmd/quickstart.py:242 #, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +msgid "Selected root path: %s" msgstr "" -#: builders/latex/__init__.py:324 builders/texinfo.py:115 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/latex/__init__.py:404 builders/texinfo.py:174 -msgid "resolving references..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/latex/__init__.py:415 builders/texinfo.py:184 -msgid " (in " -msgstr "(בתוך" - -#: builders/_epub_base.py:423 builders/html/__init__.py:778 -#: builders/latex/__init__.py:482 builders/texinfo.py:202 -msgid "copying images... " +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/_epub_base.py:445 builders/latex/__init__.py:497 -#: builders/texinfo.py:219 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/texinfo.py:226 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/texinfo.py:234 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "" - -#: builders/gettext.py:230 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/__init__.py:383 builders/gettext.py:251 -#, python-format -msgid "building [%s]: " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/gettext.py:252 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/gettext.py:257 -msgid "reading templates... " +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/gettext.py:292 -msgid "writing message catalogs... " +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/__init__.py:212 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/__init__.py:220 -#, python-format -msgid "a suitable image for %s builder not found: %s" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/__init__.py:243 -msgid "building [mo]: " +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/__init__.py:246 builders/__init__.py:741 builders/__init__.py:773 -msgid "writing output... " +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/__init__.py:263 -#, python-format -msgid "all of %d po files" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: builders/__init__.py:285 -#, python-format -msgid "targets for %d po files that are specified" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are out of date" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: builders/__init__.py:307 -msgid "all source files" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: builders/__init__.py:319 -#, python-format -msgid "file %r given on command line does not exist, " +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/__init__.py:325 -#, python-format +#: cmd/quickstart.py:350 msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "" - -#: builders/__init__.py:336 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: builders/__init__.py:351 -#, python-format -msgid "%d source files given on command line" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: builders/__init__.py:366 +#: cmd/quickstart.py:368 #, python-format -msgid "targets for %d source files that are out of date" +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: builders/__init__.py:394 -msgid "looking for now-outdated files... " +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: builders/__init__.py:398 -#, python-format -msgid "%d found" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: builders/__init__.py:400 -msgid "none found" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: builders/__init__.py:407 -msgid "pickling environment" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: builders/__init__.py:414 -msgid "checking consistency" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: builders/__init__.py:418 -msgid "no targets are out of date." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: builders/__init__.py:458 -msgid "updating environment: " +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: builders/__init__.py:483 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Creating file %s." msgstr "" -#: builders/__init__.py:519 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "File %s already exists, skipping." msgstr "" -#: builders/__init__.py:528 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: builders/__init__.py:539 +#: cmd/quickstart.py:520 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: builders/__init__.py:546 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" - -#: builders/__init__.py:565 builders/__init__.py:581 -msgid "reading sources... " +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: builders/__init__.py:698 +#: cmd/quickstart.py:531 #, python-format -msgid "docnames to write: %s" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: builders/__init__.py:711 -msgid "preparing documents" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: builders/__init__.py:714 -msgid "copying assets" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: builders/__init__.py:866 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: builders/epub3.py:83 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: builders/epub3.py:220 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: builders/epub3.py:231 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: builders/epub3.py:255 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1289 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: builders/_epub_base.py:222 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: builders/_epub_base.py:434 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: builders/_epub_base.py:465 +#: cmd/quickstart.py:671 #, python-format -msgid "cannot write image file %r: %s" +msgid "enable %s extension" msgstr "" -#: builders/_epub_base.py:477 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: builders/_epub_base.py:512 -msgid "writing mimetype file..." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: builders/_epub_base.py:521 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: builders/_epub_base.py:590 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: builders/_epub_base.py:764 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: builders/_epub_base.py:793 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: builders/changes.py:33 -#, python-format -msgid "The overview file is in %(outdir)s." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: builders/changes.py:60 -#, python-format -msgid "no changes in version %s." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: builders/changes.py:62 -msgid "writing summary file..." +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: builders/changes.py:74 -msgid "Builtins" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: builders/changes.py:76 -msgid "Module level" -msgstr "רמת המודול" - -#: builders/changes.py:128 -msgid "copying source files..." +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: builders/changes.py:137 +#: cmd/quickstart.py:810 #, python-format -msgid "could not read %r for changelog creation" +msgid "Invalid template variable: %s" msgstr "" -#: util/rst.py:72 +#: directives/other.py:119 #, python-format -msgid "default role %s not found" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/docfields.py:95 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/osutil.py:130 +#: directives/other.py:156 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/nodes.py:419 +#: directives/other.py:169 #, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/nodes.py:487 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" +#: directives/other.py:203 +msgid "Section author: " +msgstr "מחבר הקטע:" -#: util/nodes.py:701 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" +#: directives/other.py:205 +msgid "Module author: " +msgstr "מחבר המודול:" -#: util/fileutil.py:74 -#, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +#: directives/other.py:207 +msgid "Code author: " +msgstr "מחבר הקוד:" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" - -#: util/inventory.py:170 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" - -#: util/inventory.py:185 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" - -#: util/docutils.py:284 -#, python-format -msgid "unknown directive or role name: %s:%s" -msgstr "" - -#: util/docutils.py:747 -#, python-format -msgid "unknown node type: %r" -msgstr "" - -#: util/display.py:81 -msgid "skipped" -msgstr "" - -#: util/display.py:86 -msgid "failed" -msgstr "" - -#: util/i18n.py:103 -#, python-format -msgid "reading error: %s, %s" -msgstr "" - -#: util/i18n.py:110 -#, python-format -msgid "writing error: %s, %s" -msgstr "" +#: directives/other.py:209 +msgid "Author: " +msgstr "מחבר:" -#: util/i18n.py:138 -#, python-format -msgid "locale_dir %s does not exist" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/i18n.py:230 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: directives/patches.py:66 +#: directives/patches.py:70 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." @@ -2023,7 +2238,7 @@ msgstr "" msgid "Invalid caption: %s" msgstr "" -#: directives/code.py:132 directives/code.py:297 directives/code.py:484 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" @@ -2038,7 +2253,7 @@ msgstr "" msgid "Include file '%s' not found or reading it failed" msgstr "" -#: directives/code.py:234 +#: directives/code.py:235 #, python-format msgid "" "Encoding %r used for reading included file '%s' seems to be wrong, try " @@ -2059,48 +2274,139 @@ msgstr "" msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: directives/other.py:122 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "אינדקס" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: directives/other.py:155 environment/adapters/toctree.py:355 +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "הערות שוליים" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "" + +#: writers/texinfo.py:1303 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "unimplemented node type: %r" msgstr "" -#: directives/other.py:158 environment/adapters/toctree.py:359 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[תמונה]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: directives/other.py:171 +#: writers/html5.py:431 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "numfig_format is not defined for %s" msgstr "" -#: directives/other.py:204 -msgid "Section author: " -msgstr "מחבר הקטע:" +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "" -#: directives/other.py:206 -msgid "Module author: " -msgstr "מחבר המודול:" +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" -#: directives/other.py:208 -msgid "Code author: " -msgstr "מחבר הקוד:" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" -#: directives/other.py:210 -msgid "Author: " -msgstr "מחבר:" +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" -#: directives/other.py:284 -msgid ".. acks content is not a list" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" msgstr "" -#: directives/other.py:309 -msgid ".. hlist content is not a list" +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" + +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" + +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" + +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "" + +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" + +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" +msgstr "" + +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "" + +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "" + +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "" + +#: writers/latex.py:1228 +#, python-format +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" + +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "" + +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" #: _cli/__init__.py:73 @@ -2108,6 +2414,7 @@ msgid "Usage:" msgstr "" #: _cli/__init__.py:75 +#, python-brace-format msgid "{0} [OPTIONS] []" msgstr "" @@ -2123,1993 +2430,1877 @@ msgstr "" msgid "Options" msgstr "" -#: _cli/__init__.py:112 _cli/__init__.py:183 +#: _cli/__init__.py:113 _cli/__init__.py:181 msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: _cli/__init__.py:172 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" "{0}: error: {1}\n" "Run '{0} --help' for information" msgstr "" -#: _cli/__init__.py:182 +#: _cli/__init__.py:179 msgid " Manage documentation with Sphinx." msgstr "" -#: _cli/__init__.py:194 +#: _cli/__init__.py:191 msgid "Show the version and exit." msgstr "" -#: _cli/__init__.py:202 +#: _cli/__init__.py:199 msgid "Show this message and exit." msgstr "" -#: _cli/__init__.py:206 +#: _cli/__init__.py:203 msgid "Logging" msgstr "" -#: _cli/__init__.py:213 +#: _cli/__init__.py:210 msgid "Increase verbosity (can be repeated)" msgstr "" -#: _cli/__init__.py:221 +#: _cli/__init__.py:218 msgid "Only print errors and warnings." msgstr "" -#: _cli/__init__.py:228 +#: _cli/__init__.py:225 msgid "No output at all" msgstr "" -#: _cli/__init__.py:234 +#: _cli/__init__.py:231 msgid "" msgstr "" -#: _cli/__init__.py:265 +#: _cli/__init__.py:263 msgid "See 'sphinx --help'.\n" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:198 -#: transforms/__init__.py:133 writers/manpage.py:102 writers/texinfo.py:219 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:143 -msgid "could not calculate translation progress!" -msgstr "" - -#: transforms/__init__.py:148 -msgid "no translated elements!" -msgstr "" - -#: transforms/__init__.py:267 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "" - -#: transforms/__init__.py:313 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" - -#: transforms/__init__.py:322 -msgid "Footnote [*] is not referenced." -msgstr "" - -#: transforms/__init__.py:333 -msgid "Footnote [#] is not referenced." -msgstr "" - -#: transforms/i18n.py:228 transforms/i18n.py:303 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: transforms/i18n.py:273 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" -#: transforms/i18n.py:323 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: transforms/i18n.py:345 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: ext/linkcode.py:75 ext/viewcode.py:201 -msgid "[source]" -msgstr "[מקור]" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" -#: ext/imgconverter.py:40 -#, python-format -msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: ext/imgconverter.py:49 ext/imgconverter.py:73 +#: transforms/__init__.py:258 #, python-format msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: ext/imgconverter.py:68 +#: transforms/__init__.py:299 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" +msgid "Footnote [%s] is not referenced." msgstr "" -#: ext/viewcode.py:258 -msgid "highlighting module code... " +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: ext/viewcode.py:286 -msgid "[docs]" -msgstr "[תיעוד]" - -#: ext/viewcode.py:306 -msgid "Module code" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: ext/viewcode.py:312 +#: util/inventory.py:147 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        הראה קוד מקור ל %s

        " - -#: ext/viewcode.py:338 -msgid "Overview: module code" +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: ext/viewcode.py:339 -msgid "

        All modules for which code is available

        " -msgstr "

        כל המודולים שיש להם קוד זמין

        " +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: ext/coverage.py:47 +#: util/i18n.py:100 #, python-format -msgid "invalid regex %r in %s" +msgid "reading error: %s, %s" msgstr "" -#: ext/coverage.py:134 ext/coverage.py:280 +#: util/i18n.py:113 #, python-format -msgid "module %s could not be imported: %s" +msgid "writing error: %s, %s" msgstr "" -#: ext/coverage.py:141 +#: util/i18n.py:146 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" +msgid "locale_dir %s does not exist" msgstr "" -#: ext/coverage.py:149 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: ext/coverage.py:163 +#: util/i18n.py:253 #, python-format msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: ext/coverage.py:177 +#: util/osutil.py:131 #, python-format -msgid "invalid regex %r in coverage_c_regexes" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: ext/coverage.py:245 -#, python-format -msgid "undocumented c api: %s [%s] in file %s" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: ext/coverage.py:429 -#, python-format -msgid "undocumented python function: %s :: %s" +#: util/display.py:87 +msgid "failed" msgstr "" -#: ext/coverage.py:445 +#: util/docutils.py:325 #, python-format -msgid "undocumented python class: %s :: %s" +msgid "unknown directive name: %s" msgstr "" -#: ext/coverage.py:458 +#: util/docutils.py:361 #, python-format -msgid "undocumented python method: %s :: %s :: %s" +msgid "unknown role name: %s" msgstr "" -#: ext/todo.py:71 -msgid "Todo" -msgstr "לעשות" - -#: ext/todo.py:104 +#: util/docutils.py:805 #, python-format -msgid "TODO entry found: %s" +msgid "unknown node type: %r" msgstr "" -#: ext/todo.py:163 -msgid "<>" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: ext/todo.py:165 +#: util/fileutil.py:89 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "Writing evaluated template result to %s" msgstr "" -#: ext/todo.py:175 -msgid "original entry" -msgstr "הטקסט המקורי" - -#: ext/extlinks.py:82 +#: util/docfields.py:103 #, python-format msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: ext/doctest.py:115 +#: util/rst.py:73 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "default role %s not found" msgstr "" -#: ext/doctest.py:120 +#: util/nodes.py:462 #, python-format -msgid "'%s' is not a valid option." +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: ext/doctest.py:134 +#: util/nodes.py:523 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: ext/doctest.py:220 -msgid "invalid TestCode type" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: ext/doctest.py:281 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "המשך מעמוד קודם" -#: ext/doctest.py:434 -#, python-format -msgid "no code/output in %s block at %s:%s" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: ext/doctest.py:522 -#, python-format -msgid "ignoring invalid doctest code: %r" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: ext/graphviz.py:145 -#, python-format -msgid "External Graphviz file %r not found or reading it failed" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: ext/graphviz.py:268 +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "מהדורה" + +#: transforms/post_transforms/images.py:79 #, python-format -msgid "graphviz_dot executable path must be set! %r" +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: ext/graphviz.py:303 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: ext/graphviz.py:310 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +msgid "Unknown image format: %s..." msgstr "" -#: ext/graphviz.py:313 -#, python-format +#: transforms/post_transforms/__init__.py:88 msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: ext/graphviz.py:329 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: ext/graphviz.py:333 ext/graphviz.py:386 ext/graphviz.py:423 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "dot code %r: %s" +msgid "%s:%s reference target not found: %s" msgstr "" -#: ext/graphviz.py:436 ext/graphviz.py:444 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "[graph: %s]" -msgstr "" - -#: ext/graphviz.py:438 ext/graphviz.py:446 -msgid "[graph]" +msgid "%r reference target not found: %s" msgstr "" -#: ext/imgmath.py:369 ext/mathjax.py:52 -msgid "Link to this equation" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: ext/apidoc.py:85 -#, python-format -msgid "Would create file %s." +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: ext/apidoc.py:375 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: ext/apidoc.py:392 -msgid "path to module to document" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: ext/apidoc.py:396 +#: _cli/util/errors.py:207 msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: ext/apidoc.py:407 -msgid "directory to place all output" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: ext/apidoc.py:422 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: ext/apidoc.py:429 -msgid "overwrite existing files" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: ext/apidoc.py:437 +#: _cli/util/errors.py:246 msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: ext/apidoc.py:446 -msgid "run the script without creating files" -msgstr "" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "כווץ סרגל צד" -#: ext/apidoc.py:453 -msgid "put documentation for each module on its own page" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "ניווט" -#: ext/apidoc.py:460 -msgid "include \"_private\" modules" -msgstr "" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "חפש בתוך %(docstitle)s" -#: ext/apidoc.py:467 -msgid "filename of table of contents (default: modules)" -msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "על מסמכים אלו" -#: ext/apidoc.py:474 -msgid "don't create a table of contents file" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "חיפוש" -#: ext/apidoc.py:481 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "זכויות שמורות" -#: ext/apidoc.py:492 -msgid "put module documentation before submodule documentation" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: ext/apidoc.py:498 +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "עודכן לאחרונה ב %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: ext/apidoc.py:508 -msgid "file suffix (default: rst)" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "נושא קודם" -#: ext/apidoc.py:515 ext/autosummary/generate.py:839 -msgid "Remove existing files in the output directory that were not generated" -msgstr "" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "פרק קודם" -#: ext/apidoc.py:524 -msgid "generate a full project with sphinx-quickstart" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "נושא הבא" -#: ext/apidoc.py:531 -msgid "append module_path to sys.path, used when --full is given" -msgstr "" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "פרק הבא" -#: ext/apidoc.py:538 -msgid "project name (default: root module name)" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" msgstr "" -#: ext/apidoc.py:545 -msgid "project author(s), used when --full is given" -msgstr "" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "אינדקס מלא בעמוד אחד" -#: ext/apidoc.py:552 -msgid "project version, used when --full is given" -msgstr "" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "עמוד זה" -#: ext/apidoc.py:559 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "הצג מקור" -#: ext/apidoc.py:564 -msgid "extension options" -msgstr "" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "חיפוש מהיר" -#: ext/apidoc.py:638 -#, python-format -msgid "%s is not a directory." -msgstr "" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "לך" -#: ext/apidoc.py:710 ext/autosummary/generate.py:875 -#, python-format -msgid "Failed to remove %s: %s" -msgstr "" +#: themes/basic/defindex.html:4 +msgid "Overview" +msgstr "סקירה כללית" -#: ext/autosectionlabel.py:48 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" msgstr "" -#: domains/std/__init__.py:703 domains/std/__init__.py:812 -#: ext/autosectionlabel.py:52 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: themes/basic/defindex.html:9 +msgid "the documentation for" msgstr "" -#: ext/duration.py:85 -msgid "" -"====================== slowest reading durations =======================" +#: themes/basic/defindex.html:10 +msgid "last updated" msgstr "" -#: ext/imgmath.py:159 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" msgstr "" -#: ext/imgmath.py:174 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "תוכן עניינים מלא" -#: ext/imgmath.py:328 -#, python-format -msgid "display latex %r: %s" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" msgstr "" -#: ext/imgmath.py:362 -#, python-format -msgid "inline latex %r: %s" -msgstr "" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "דף חיפוש" -#: writers/latex.py:1090 writers/manpage.py:263 writers/texinfo.py:662 -msgid "Footnotes" -msgstr "הערות שוליים" +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "חפש בתיעוד זה" -#: writers/manpage.py:309 writers/text.py:936 -#, python-format -msgid "[image: %s]" -msgstr "" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "אינדקס מודולים גלובלי" -#: writers/manpage.py:310 writers/text.py:937 -msgid "[image]" -msgstr "[תמונה]" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "גישה מהירה לכל המודולים" -#: writers/html5.py:99 writers/html5.py:108 -msgid "Link to this definition" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" msgstr "" -#: writers/html5.py:415 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "כל הפונקציות, המחלקות, המושגים" -#: writers/html5.py:427 +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "" + +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Any IDs not assigned for %s node" +msgid "Search %(docstitle)s" +msgstr "חפש %(docstitle)s" + +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "עמודי אינדקס לפי אותיות" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "עשוי להיות עצום" + +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." +msgstr "אנא הפעל ג'אואסקריפט ע\"מ לאפשר את\n החיפוש." + +#: themes/basic/search.html:28 +msgid "" +"Searching for multiple words only shows matches that contain\n" +" all words." msgstr "" -#: writers/html5.py:482 -msgid "Link to this term" +#: themes/basic/search.html:35 +msgid "search" +msgstr "חיפוש" + +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "תוכן" + +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "תוצאות החיפוש" + +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." msgstr "" -#: writers/html5.py:525 writers/html5.py:530 -msgid "Link to this heading" +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" +msgstr[2] "" + +#: themes/basic/static/searchtools.js:276 +msgid "Searching" msgstr "" -#: writers/html5.py:535 -msgid "Link to this table" +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "" + +#: themes/basic/static/searchtools.js:526 +msgid ", in " msgstr "" -#: writers/html5.py:549 writers/latex.py:1099 +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "הסתר תוצאות חיפוש" + +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" -#: writers/html5.py:613 -msgid "Link to this code" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" msgstr "" -#: writers/html5.py:615 -msgid "Link to this image" +#: themes/basic/changes/versionchanges.html:17 +#, python-format +msgid "Automatically generated list of changes in version %(version)s" +msgstr "יצר אוטומטית רשימה של שינויים בגרסה %(version)s" + +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" msgstr "" -#: writers/html5.py:617 -msgid "Link to this toctree" +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" msgstr "" -#: writers/html5.py:758 -msgid "Could not obtain image size. :scale: option is ignored." +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" +msgstr "שינויים אחרים" + +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" +msgstr "הרחב סרגל צד" + +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: builders/latex/__init__.py:205 domains/std/__init__.py:646 -#: domains/std/__init__.py:658 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:513 -msgid "Index" -msgstr "אינדקס" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "" -#: writers/latex.py:743 writers/texinfo.py:644 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "פרמטרים" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "משתנים" + +#: domains/python/_object.py:214 +msgid "Raises" msgstr "" -#: writers/texinfo.py:1216 -msgid "caption not inside a figure." +#: domains/python/__init__.py:105 domains/python/__init__.py:270 +#, python-format +msgid "%s() (in module %s)" msgstr "" -#: writers/texinfo.py:1302 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format -msgid "unimplemented node type: %r" +msgid "%s (in module %s)" msgstr "" -#: writers/latex.py:360 +#: domains/python/__init__.py:174 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "%s (built-in variable)" msgstr "" -#: builders/latex/__init__.py:223 writers/latex.py:410 +#: domains/python/__init__.py:209 #, python-format -msgid "no Babel option known for language %r" +msgid "%s (built-in class)" msgstr "" -#: writers/latex.py:428 -msgid "too large :maxdepth:, ignored." +#: domains/python/__init__.py:210 +#, python-format +msgid "%s (class in %s)" msgstr "" -#: writers/latex.py:590 +#: domains/python/__init__.py:275 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "%s() (%s class method)" msgstr "" -#: writers/latex.py:708 -msgid "document title is not a single Text node" +#: domains/python/__init__.py:277 +#, python-format +msgid "%s() (%s static method)" +msgstr "" + +#: domains/python/__init__.py:430 +#, python-format +msgid "%s (%s property)" +msgstr "" + +#: domains/python/__init__.py:470 +#, python-format +msgid "%s (type alias in %s)" +msgstr "" + +#: domains/python/__init__.py:624 +msgid "Python Module Index" +msgstr "" + +#: domains/python/__init__.py:625 +msgid "modules" +msgstr "" + +#: domains/python/__init__.py:703 +msgid "Deprecated" +msgstr "" + +#: domains/python/__init__.py:729 +msgid "exception" +msgstr "" + +#: domains/python/__init__.py:731 +msgid "class method" +msgstr "" + +#: domains/python/__init__.py:732 +msgid "static method" +msgstr "" + +#: domains/python/__init__.py:734 +msgid "property" msgstr "" -#: writers/latex.py:1175 +#: domains/python/__init__.py:735 +msgid "type alias" +msgstr "" + +#: domains/python/__init__.py:804 +#, python-format msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"duplicate object description of %s, other instance in %s, use :no-index: for" +" one of them" msgstr "" -#: writers/latex.py:1573 +#: domains/python/__init__.py:974 #, python-format -msgid "dimension unit %s is invalid. Ignored." +msgid "more than one target found for cross-reference %r: %s" +msgstr "" + +#: domains/python/__init__.py:1048 +msgid " (deprecated)" msgstr "" -#: writers/latex.py:1931 +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 #, python-format -msgid "unknown index entry type %s found" +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" + +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" +msgstr "" + +#: domains/cpp/__init__.py:302 +#, python-format +msgid "%s (C++ %s)" +msgstr "" + +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 +msgid "Return values" +msgstr "" + +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "" + +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" +msgstr "" + +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "" + +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "" + +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 +msgid "enum" +msgstr "" + +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 +msgid "enumerator" +msgstr "" + +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 +msgid "function parameter" +msgstr "" + +#: domains/cpp/__init__.py:954 +msgid "template parameter" +msgstr "" + +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 +#, python-format +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/std/__init__.py:87 domains/std/__init__.py:104 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "משתנה" + +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "מאקרו" + +#: domains/c/__init__.py:781 +msgid "struct" +msgstr "" + +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "משתנה סביבה; %s" -#: domains/std/__init__.py:112 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:166 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:176 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:235 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: domains/std/__init__.py:306 +#: domains/std/__init__.py:319 #, python-format msgid "%s command line option" msgstr "" -#: domains/std/__init__.py:308 +#: domains/std/__init__.py:321 msgid "command line option" msgstr "" -#: domains/std/__init__.py:430 +#: domains/std/__init__.py:461 msgid "glossary term must be preceded by empty line" msgstr "" -#: domains/std/__init__.py:438 +#: domains/std/__init__.py:474 msgid "glossary terms must not be separated by empty lines" msgstr "" -#: domains/std/__init__.py:444 domains/std/__init__.py:457 +#: domains/std/__init__.py:486 domains/std/__init__.py:504 msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:602 +#: domains/std/__init__.py:729 msgid "glossary term" msgstr "" -#: domains/std/__init__.py:603 +#: domains/std/__init__.py:730 msgid "grammar token" msgstr "" -#: domains/std/__init__.py:604 +#: domains/std/__init__.py:731 msgid "reference label" msgstr "" -#: domains/std/__init__.py:607 +#: domains/std/__init__.py:733 msgid "environment variable" msgstr "משתנה סביבה" -#: domains/std/__init__.py:608 +#: domains/std/__init__.py:734 msgid "program option" msgstr "" -#: domains/std/__init__.py:609 +#: domains/std/__init__.py:735 msgid "document" msgstr "" -#: domains/std/__init__.py:647 domains/std/__init__.py:659 +#: domains/std/__init__.py:772 domains/std/__init__.py:785 msgid "Module Index" msgstr "מודול אינדקס" -#: domains/std/__init__.py:648 domains/std/__init__.py:660 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "דף חיפוש" - -#: domains/std/__init__.py:722 +#: domains/std/__init__.py:857 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: domains/std/__init__.py:932 +#: domains/std/__init__.py:1113 msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: domains/std/__init__.py:940 +#: domains/std/__init__.py:1124 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: domains/std/__init__.py:952 +#: domains/std/__init__.py:1138 #, python-format msgid "the link has no caption: %s" msgstr "" -#: domains/std/__init__.py:966 +#: domains/std/__init__.py:1153 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" -#: domains/std/__init__.py:969 +#: domains/std/__init__.py:1157 #, python-format msgid "invalid numfig_format: %s" msgstr "" -#: domains/std/__init__.py:1200 +#: domains/std/__init__.py:1453 #, python-format msgid "undefined label: %r" msgstr "" -#: domains/std/__init__.py:1202 +#: domains/std/__init__.py:1456 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: domains/python/__init__.py:107 domains/python/__init__.py:244 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "%s() (in module %s)" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: domains/python/__init__.py:167 domains/python/__init__.py:334 -#: domains/python/__init__.py:385 domains/python/__init__.py:424 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "%s (in module %s)" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: domains/python/__init__.py:169 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "%s (built-in variable)" +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: domains/python/__init__.py:194 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "%s (built-in class)" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: domains/python/__init__.py:195 -#, python-format -msgid "%s (class in %s)" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: domains/python/__init__.py:249 -#, python-format -msgid "%s() (%s class method)" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: domains/python/__init__.py:251 -#, python-format -msgid "%s() (%s static method)" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: domains/python/__init__.py:389 -#, python-format -msgid "%s (%s property)" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: domains/python/__init__.py:428 -#, python-format -msgid "%s (type alias in %s)" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: domains/python/__init__.py:559 -msgid "Python Module Index" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: domains/python/__init__.py:560 -msgid "modules" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: domains/python/__init__.py:637 -msgid "Deprecated" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: domains/python/__init__.py:663 -msgid "exception" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: domains/python/__init__.py:665 -msgid "class method" -msgstr "" - -#: domains/python/__init__.py:666 -msgid "static method" -msgstr "" - -#: domains/python/__init__.py:668 -msgid "property" -msgstr "" - -#: domains/python/__init__.py:669 -msgid "type alias" -msgstr "" - -#: domains/python/__init__.py:729 -#, python-format -msgid "" -"duplicate object description of %s, other instance in %s, use :no-index: for" -" one of them" -msgstr "" - -#: domains/python/__init__.py:858 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "more than one target found for cross-reference %r: %s" -msgstr "" - -#: domains/python/__init__.py:920 -msgid " (deprecated)" -msgstr "" - -#: domains/c/__init__.py:304 domains/cpp/__init__.py:441 -#: domains/python/_object.py:164 ext/napoleon/docstring.py:786 -msgid "Parameters" -msgstr "פרמטרים" - -#: domains/python/_object.py:169 -msgid "Variables" -msgstr "משתנים" - -#: domains/python/_object.py:173 -msgid "Raises" +msgid "A mocked object is detected: %r" msgstr "" -#: domains/c/__init__.py:199 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "%s (C %s)" +msgid "alias of %s" msgstr "" -#: domains/c/__init__.py:260 domains/c/_symbol.py:510 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:307 domains/cpp/__init__.py:454 -msgid "Return values" -msgstr "" - -#: domains/c/__init__.py:679 domains/cpp/__init__.py:860 -msgid "member" -msgstr "" - -#: domains/c/__init__.py:680 -msgid "variable" -msgstr "משתנה" - -#: domains/c/__init__.py:682 -msgid "macro" -msgstr "מאקרו" - -#: domains/c/__init__.py:683 -msgid "struct" -msgstr "" - -#: domains/c/__init__.py:684 domains/cpp/__init__.py:858 -msgid "union" -msgstr "" - -#: domains/c/__init__.py:685 domains/cpp/__init__.py:863 -msgid "enum" -msgstr "" - -#: domains/c/__init__.py:686 domains/cpp/__init__.py:864 -msgid "enumerator" -msgstr "" - -#: domains/c/__init__.py:687 domains/cpp/__init__.py:861 -msgid "type" -msgstr "" - -#: domains/c/__init__.py:689 domains/cpp/__init__.py:866 -msgid "function parameter" -msgstr "" - -#: domains/cpp/__init__.py:155 -msgid "Template Parameters" +msgid "Bases: %s" msgstr "" -#: domains/cpp/__init__.py:277 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "%s (C++ %s)" +msgid "invalid value for member-order option: %s" msgstr "" -#: domains/cpp/__init__.py:360 domains/cpp/_symbol.py:793 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/cpp/__init__.py:862 -msgid "concept" -msgstr "" - -#: domains/cpp/__init__.py:867 -msgid "template parameter" -msgstr "" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "תוכן" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "חיפוש" - -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "לך" - -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "הצג מקור" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "כווץ סרגל צד" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "ניווט" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "חפש בתוך %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "על מסמכים אלו" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "זכויות שמורות" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "עודכן לאחרונה ב %(last_updated)s." - -#: themes/basic/layout.html:204 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: themes/basic/genindex-single.html:26 +#: ext/autodoc/_names.py:89 #, python-format -msgid "Index – %(key)s" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "אינדקס מלא בעמוד אחד" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "עמודי אינדקס לפי אותיות" - -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "עשוי להיות עצום" - -#: themes/basic/opensearch.xml:4 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Search %(docstitle)s" -msgstr "חפש %(docstitle)s" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "עמוד זה" - -#: themes/basic/defindex.html:4 -msgid "Overview" -msgstr "סקירה כללית" - -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" -msgstr "" - -#: themes/basic/defindex.html:9 -msgid "the documentation for" -msgstr "" - -#: themes/basic/defindex.html:10 -msgid "last updated" -msgstr "" - -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" -msgstr "" - -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" -msgstr "תוכן עניינים מלא" - -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "" - -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "חפש בתיעוד זה" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "אינדקס מודולים גלובלי" - -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "גישה מהירה לכל המודולים" - -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "כל הפונקציות, המחלקות, המושגים" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "חיפוש מהיר" - -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." -msgstr "אנא הפעל ג'אואסקריפט ע\"מ לאפשר את\n החיפוש." - -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: themes/basic/search.html:35 -msgid "search" -msgstr "חיפוש" - -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "נושא קודם" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "פרק קודם" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "נושא הבא" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "פרק הבא" - -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" -msgstr "הרחב סרגל צד" - -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" +msgid "Failed to remove %s: %s" msgstr "" -#: themes/basic/changes/versionchanges.html:17 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "יצר אוטומטית רשימה של שינויים בגרסה %(version)s" - -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" +msgid "Would create file %s." msgstr "" -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "שינויים אחרים" - -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "הסתר תוצאות חיפוש" - -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" -msgstr "תוצאות החיפוש" - -#: themes/basic/static/searchtools.js:119 +#: ext/apidoc/_cli.py:50 msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: themes/basic/static/searchtools.js:123 -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" -msgstr[2] "" - -#: themes/basic/static/searchtools.js:253 -msgid "Searching" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: themes/basic/static/searchtools.js:474 -msgid ", in " +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: environment/collectors/asset.py:96 -#, python-format -msgid "image file not readable: %s" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: environment/collectors/asset.py:124 -#, python-format -msgid "image file %s not readable: %s" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "" + +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: environment/collectors/asset.py:161 -#, python-format -msgid "download file not readable: %s" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: environment/collectors/toctree.py:258 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: environment/adapters/toctree.py:318 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: environment/adapters/toctree.py:342 -#, python-format +#: ext/apidoc/_cli.py:135 msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: environment/adapters/toctree.py:357 -#, python-format -msgid "toctree contains reference to non-included document %r" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: environment/adapters/indexentries.py:126 -#, python-format -msgid "see %s" -msgstr "ראה %s" - -#: environment/adapters/indexentries.py:136 -#, python-format -msgid "see also %s" -msgstr "ראה גם %s" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" -#: environment/adapters/indexentries.py:144 -#, python-format -msgid "unknown index entry type %r" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: environment/adapters/indexentries.py:270 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/html/__init__.py:363 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: builders/html/__init__.py:382 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "אינדקס" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: builders/html/__init__.py:560 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "Logo of %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "הבא" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "הקודם" - -#: builders/html/__init__.py:695 -msgid "generating indices" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/html/__init__.py:710 -msgid "writing additional pages" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/__init__.py:793 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/__init__.py:805 -msgid "copying downloadable files... " +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:817 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/__init__.py:863 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/__init__.py:881 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/__init__.py:916 -msgid "copying static files" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:933 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "cannot copy static file %r" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/__init__.py:938 -msgid "copying extra files" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/html/__init__.py:948 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: builders/html/__init__.py:954 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "Failed to write build info file: %r" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/html/__init__.py:1003 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/html/__init__.py:1051 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: builders/html/__init__.py:1213 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: builders/html/__init__.py:1222 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1255 -msgid "dumping object inventory" +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: builders/html/__init__.py:1263 +#: ext/autosummary/generate.py:634 #, python-format -msgid "dumping search index in %s" +msgid "[autosummary] writing to %s" msgstr "" -#: builders/html/__init__.py:1306 +#: ext/autosummary/generate.py:679 #, python-format -msgid "invalid js_file: %r, ignored" +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1339 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: builders/html/__init__.py:1344 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: builders/html/__init__.py:1358 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: builders/html/__init__.py:1363 +#: ext/autosummary/generate.py:915 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1378 +#: ext/autosummary/generate.py:923 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "custom template directory (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1383 +#: ext/autosummary/generate.py:931 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "document imported members (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1394 builders/latex/__init__.py:504 +#: ext/autosummary/generate.py:940 #, python-format -msgid "logo file %r does not exist" +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: builders/html/__init__.py:1405 +#: ext/autosummary/__init__.py:235 #, python-format -msgid "favicon file %r does not exist" +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: builders/html/__init__.py:1417 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: builders/html/__init__.py:1430 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: builders/html/__init__.py:1447 +#: ext/autosummary/__init__.py:329 #, python-format -msgid "%s %s documentation" -msgstr "תיעוד %s %s" - -#: builders/latex/transforms.py:118 -msgid "Failed to get a docname!" +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/latex/transforms.py:119 +#: ext/autosummary/__init__.py:358 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "failed to import object %s" msgstr "" -#: builders/latex/transforms.py:485 +#: ext/autosummary/__init__.py:652 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: builders/latex/__init__.py:117 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "autosummary_generate: file not found: %s" msgstr "" -#: builders/latex/__init__.py:119 +#: ext/autosummary/__init__.py:860 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "" - -#: builders/latex/__init__.py:157 -msgid "no \"latex_documents\" config value found; no documents will be written" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: builders/latex/__init__.py:169 +#: ext/intersphinx/_load.py:61 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: builders/latex/__init__.py:208 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "מהדורה" - -#: builders/latex/__init__.py:429 -msgid "copying TeX support files" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: builders/latex/__init__.py:466 -msgid "copying additional files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: builders/latex/__init__.py:540 +#: ext/intersphinx/_load.py:94 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: builders/latex/__init__.py:548 +#: ext/intersphinx/_load.py:103 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: builders/latex/theming.py:87 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: builders/latex/theming.py:90 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: _cli/util/errors.py:124 -msgid "Exception occurred, starting debugger:" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: _cli/util/errors.py:133 -msgid "reStructuredText markup error:" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: _cli/util/errors.py:168 -msgid "The full traceback has been saved in:" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: _cli/util/errors.py:172 +#: ext/intersphinx/_load.py:324 msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: transforms/post_transforms/__init__.py:125 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: transforms/post_transforms/__init__.py:185 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: transforms/post_transforms/__init__.py:251 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "(in %s %s)" msgstr "" -#: transforms/post_transforms/__init__.py:257 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "%r reference target not found: %s" +msgid "(in %s)" msgstr "" -#: transforms/post_transforms/images.py:77 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: transforms/post_transforms/images.py:94 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: transforms/post_transforms/images.py:141 +#: ext/intersphinx/_resolve.py:387 #, python-format -msgid "Unknown image format: %s..." +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:707 -msgid "Example" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/napoleon/docstring.py:708 -msgid "Examples" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/__init__.py:344 ext/napoleon/docstring.py:752 -msgid "Keyword Arguments" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/napoleon/docstring.py:768 -msgid "Notes" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:777 -msgid "Other Parameters" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/napoleon/docstring.py:813 -msgid "Receives" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:817 -msgid "References" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/napoleon/docstring.py:849 -msgid "Warns" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/napoleon/docstring.py:853 -msgid "Yields" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/napoleon/docstring.py:1015 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1022 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1029 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1036 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:256 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/autosummary/__init__.py:258 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/autosummary/__init__.py:277 -msgid "A captioned autosummary requires :toctree: option. ignored." -msgstr "" - -#: ext/autosummary/__init__.py:330 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/__init__.py:344 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "failed to parse name %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/autosummary/__init__.py:349 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "failed to import object %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/autosummary/__init__.py:648 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format msgid "" -"Summarised items should not include the current module. Replace %r with %r." +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/autosummary/__init__.py:819 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/autosummary/__init__.py:827 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/autosummary/generate.py:215 ext/autosummary/generate.py:391 -#, python-format -msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/autosummary/generate.py:526 -#, python-format -msgid "[autosummary] generating autosummary for: %s" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/autosummary/generate.py:530 -#, python-format -msgid "[autosummary] writing to %s" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/autosummary/generate.py:572 +#: builders/html/__init__.py:114 #, python-format -msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/autosummary/generate.py:767 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/autosummary/generate.py:789 -msgid "source files to generate rST files for" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/autosummary/generate.py:797 -msgid "directory to place all output in" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/autosummary/generate.py:805 +#: builders/html/__init__.py:372 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/autosummary/generate.py:813 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "אינדקס" + +#: builders/html/__init__.py:549 #, python-format -msgid "custom template directory (default: %(default)s)" +msgid "Logo of %s" msgstr "" -#: ext/autosummary/generate.py:821 -#, python-format -msgid "document imported members (default: %(default)s)" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "הבא" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "הקודם" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/autosummary/generate.py:829 -#, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:47 +#: builders/html/__init__.py:783 #, python-format -msgid "(in %s v%s)" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:103 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:113 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:359 +#: builders/html/__init__.py:871 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:367 -#, python-format -msgid "invalid external cross-reference suffix: %r" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:378 +#: builders/html/__init__.py:923 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "cannot copy static file %r" msgstr "" -#: ext/intersphinx/_resolve.py:585 -#, python-format -msgid "external %s:%s reference target not found: %s" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:59 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:70 +#: builders/html/__init__.py:944 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_load.py:81 -#, python-format +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:92 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:101 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:120 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" - -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1225 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:155 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:240 +#: builders/html/__init__.py:1266 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:265 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:275 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:319 +#: builders/html/__init__.py:1351 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/autodoc/type_comment.py:132 +#: builders/html/__init__.py:1365 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/type_comment.py:135 +#: builders/html/__init__.py:1370 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:142 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:415 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:532 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:807 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:902 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:946 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "תיעוד %s %s" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:965 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1028 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1035 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1048 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1114 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1337 ext/autodoc/__init__.py:1414 -#: ext/autodoc/__init__.py:2829 -#, python-format -msgid "Failed to get a function signature for %s: %s" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1633 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1760 -#, python-format -msgid "Bases: %s" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1774 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "missing attribute %s in object %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1855 ext/autodoc/__init__.py:1892 -#: ext/autodoc/__init__.py:1987 +#: builders/latex/__init__.py:537 #, python-format -msgid "alias of %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1875 +#: environment/collectors/toctree.py:259 #, python-format -msgid "alias of TypeVar(%s)" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:2217 ext/autodoc/__init__.py:2317 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2448 +#: environment/collectors/asset.py:126 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/preserve_defaults.py:190 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "download file not readable: %s" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "המשך מעמוד קודם" +#: environment/adapters/toctree.py:335 +#, python-format +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: environment/adapters/toctree.py:360 +#, python-format +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "ראה %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "ראה גם %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/hi/LC_MESSAGES/sphinx.mo b/sphinx/locale/hi/LC_MESSAGES/sphinx.mo index d90ff11c0b5..3b51a7c0e1f 100644 Binary files a/sphinx/locale/hi/LC_MESSAGES/sphinx.mo and b/sphinx/locale/hi/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/hi/LC_MESSAGES/sphinx.po b/sphinx/locale/hi/LC_MESSAGES/sphinx.po index 7e954fc3eb2..4a712f50297 100644 --- a/sphinx/locale/hi/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/hi/LC_MESSAGES/sphinx.po @@ -1,5 +1,5 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: @@ -11,153 +11,300 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-29 22:39+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Sumanjali Damarla , 2020\n" "Language-Team: Hindi (http://app.transifex.com/sphinx-doc/sphinx-1/language/hi/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" "Language: hi\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" -#: events.py:77 +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "पाइथन अभिवृद्धि प्रस्ताव; पी.ई.पी. %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "विन्यास मान %s.%s खोजे गए किसी भी रूप विन्यास में नहीं दिखा" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "विन्यास का असमर्थित रूप विकल्प %r दिया गया" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "रुपविन्यास के पथ में फाइल %r कोई प्रमाणिक ज़िप फाइल नहीं है या इसमें कोई रुपविन्यास नहीं सहेजा गया है" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "आयाम %s की needs_extensions मान में आवश्कता है, पर यह नहीं चढ़ाया गया है." + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "इस परियोजना में आयाम %s का कम से कम %s संस्करण चाहिए इसलिए उपलब्ध संस्करण (%s) से बनाना संभव नहीं है." + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "पिगमेंटस लेक्सर नाम %r अज्ञात है" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 #, python-format msgid "Event %r already present" msgstr "%r घटना पहले से विद्यमान है" -#: events.py:370 +#: events.py:386 #, python-format msgid "Unknown event name: %s" msgstr "अज्ञात घटना नाम: %s" -#: events.py:416 +#: events.py:451 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" -#: application.py:190 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "स्रोत निर्देशिका (%s) नहीं मिली" -#: application.py:194 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:198 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "स्रोत निर्देशिका और गंतव्य निर्देशिका समरूप नहीं हो सकतीं" -#: application.py:228 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "स्फिंक्स %s संस्करण चल रहा है" -#: application.py:250 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "इस परियोजना में स्फिंक्स का कम से कम %s संस्करण चाहिए और इसलिए इस संस्करण से बनाना संभव नहीं है." -#: application.py:266 +#: application.py:305 msgid "making output directory" msgstr "परिणाम निर्देशिका बनाई जा रही है" -#: application.py:271 registry.py:452 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "%s आयाम को स्थापित करते हुए:" -#: application.py:277 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'स्थापना' को जैसा कि अभी कोन्फ़.पाई में परिभाषित किया गया है, पाइथन से निर्देशित नहीं है. कृपया इसकी परिभाषा में परिवर्तन करके इसे निर्देश योग्य कर्म बनाएं. कोन्फ़.पाई को स्फिंक्स के आयाम की तरह व्यवहार के लिए इसकी आवश्कयता है." -#: application.py:312 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "[%s] अनुवाद पढ़ा जा रहा है..." -#: application.py:329 util/display.py:88 +#: application.py:384 util/display.py:89 msgid "done" msgstr "संपन्न" -#: application.py:331 +#: application.py:386 msgid "not available for built-in messages" msgstr "अंतर्निर्मित संदेशों में उपलब्ध नहीं है" -#: application.py:345 +#: application.py:400 msgid "loading pickled environment" msgstr "रक्षित स्थिति को लागू किया जा रहा है" -#: application.py:353 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "असफल: %s" -#: application.py:366 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "किसी निर्माता को नहीं चुना गया, मानक उपयोग: एच्.टी.ऍम.एल." -#: application.py:398 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:400 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:404 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:407 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:409 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:414 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:417 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:419 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:968 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "निर्देशक कक्षा #node class# %r पहले से पंजीकृत है, इसके अभ्यागत निरस्त हो जाएंगे " -#: application.py:1047 +#: application.py:1113 #, python-format -msgid "directive %r is already registered, it will be overridden" -msgstr "निर्देश %r पहले से पंजीकृत है, यह निरस्त हो जाएगा" +msgid "directive %r is already registered and will not be overridden" +msgstr "" -#: application.py:1069 application.py:1094 +#: application.py:1139 application.py:1167 #, python-format -msgid "role %r is already registered, it will be overridden" -msgstr "भूमिका %r पहले से पंजीकृत है, यह निरस्त हो जाएगी" +msgid "role %r is already registered and will not be overridden" +msgstr "" -#: application.py:1644 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -165,12 +312,12 @@ msgid "" "explicit" msgstr "%s आयाम यह घोषित नहीं करता कि यह समानांतर पाठन के लिए सुरक्षित है. यह मानते हुए की ऐसा नहीं है - कृपया आयाम के लेखक को जांच करने और स्पष्ट व्यक्त करने के लिए कहें." -#: application.py:1648 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "समानांतर पठन के लिए यह %s विस्तार अथवा आयाम सुरक्षित नहीं है | " -#: application.py:1651 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -178,645 +325,357 @@ msgid "" "explicit" msgstr "%s आयाम यह घोषित नहीं करता कि यह समानांतर लेखन के लिए सुरक्षित है. यह मानते हुए की ऐसा नहीं है - कृपया आयाम के लेखक को जांच करने और स्पष्ट व्यक्त करने के लिए कहें." -#: application.py:1655 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "समानांतर लेखन के लिए %s विस्तार अथवा आयाम सुरक्षित नहीं है | " -#: application.py:1663 application.py:1667 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "%s पर काम कर रहे हैं" -#: roles.py:208 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:231 -#, python-format -msgid "invalid CVE number %s" -msgstr "" - -#: roles.py:253 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" - -#: roles.py:276 -#, python-format -msgid "invalid CWE number %s" -msgstr "" - -#: roles.py:296 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "पाइथन अभिवृद्धि प्रस्ताव; पी.ई.पी. %s" - -#: roles.py:319 -#, python-format -msgid "invalid PEP number %s" -msgstr "" - -#: roles.py:357 -#, python-format -msgid "invalid RFC number %s" -msgstr "" - -#: registry.py:144 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "निर्माण वर्ग %s का कोई \"नाम\" भाव नहीं है" -#: registry.py:146 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "निर्माता %r पहले से (%s प्रभाग में) उपलब्ध है" -#: registry.py:159 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "निर्माता नाम %s पंजीकृत नहीं है अथवा प्रवेश स्थान पर उपलब्ध नहीं है." -#: registry.py:166 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "निर्माता नाम %s पंजीकृत नहीं है" -#: registry.py:173 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "अधिकारक्षेत्र %s पहले से पंजीकृत है" -#: registry.py:196 registry.py:209 registry.py:220 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "अधिकारक्षेत्र %s अभी पंजीकृत नहीं है" -#: registry.py:200 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "%r निर्देश पहले से अधिकार-क्षेत्र %s में पंजीकृत है, " -#: registry.py:212 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "%r भूमिका पहले से अधिकार-क्षेत्र %s में पंजीकृत है, " -#: registry.py:223 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "%r अनुक्रमणिका पहले से अधिकार-क्षेत्र %s में पंजीकृत है" -#: registry.py:254 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "%r object_type पहले से पंजीकृत है" -#: registry.py:280 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "%r crossref_type पहले से पंजीकृत है" -#: registry.py:287 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r पहले से पंजीकृत है" -#: registry.py:296 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "%r का source_parser पहले से पंजीकृत है" -#: registry.py:304 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "%s का स्रोत व्याख्याता पंजीकृत नहीं है" -#: registry.py:320 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "%r के लिए अनुवादक पहले से विद्यमान है" -#: registry.py:336 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "add_node() के kwargs एक (visit, depart) फंक्शन टपल #function tuple# होने चाहिए: %r=%r" -#: registry.py:419 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r पहले से पंजीकृत है" -#: registry.py:431 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "" -#: registry.py:446 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "%r आयाम को %sसंस्करण से स्फिंक्स में सम्मिलित किया जा चुका है; आयाम की उपेक्षा की गयी." -#: registry.py:457 +#: registry.py:545 msgid "Original exception:\n" msgstr "मौलिक अपवाद:\n" -#: registry.py:458 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "%s आयाम का आयात नहीं किया जा सका" -#: registry.py:463 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "आयाम %r में कोई सेटअप #setup()# कारक नहीं है; क्या यह वास्तव में स्फिंक्स का परिवर्धक प्रभाग है?" -#: registry.py:472 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "इस परियोजना में प्रयुक्त %s परिवर्धक को स्फिंक्स का कम से कम %s संस्करण चाहिए; इसलिए इस संस्करण से बनाना संभव नहीं है." -#: registry.py:480 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "परिवर्धक %r के सेटअप() कर्म से एक असहाय वस्तु वापस मिली है; इसको 'कुछ नहीं' अथवा मेटाडाटा कोश भेजना चाहिए था" -#: registry.py:514 +#: registry.py:605 #, python-format msgid "`None` is not a valid filetype for %r." msgstr "" -#: project.py:71 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" - -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" - -#: highlighting.py:168 +#: config.py:351 #, python-format -msgid "Pygments lexer name %r is not known" -msgstr "पिगमेंटस लेक्सर नाम %r अज्ञात है" +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "विन्यास निर्देशिका में कोन्फ़.पाय #conf.py# फाइल (%s) नहीं है " -#: highlighting.py:202 +#: config.py:374 #, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: extension.py:55 +#: config.py:379 #, python-format msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." -msgstr "आयाम %s की needs_extensions मान में आवश्कता है, पर यह नहीं चढ़ाया गया है." +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" +msgstr "शब्दकोष विन्यास मान %r की उल्लंघन नहीं किया जा सकता, अनदेखा किया गया (प्रत्येक अवयव का मान रखने के लिए %r का उपयोग करें)" -#: extension.py:76 +#: config.py:391 #, python-format -msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." -msgstr "इस परियोजना में आयाम %s का कम से कम %s संस्करण चाहिए इसलिए उपलब्ध संस्करण (%s) से बनाना संभव नहीं है." +msgid "invalid number %r for config value %r, ignoring" +msgstr "विन्यास मान %r के लिए अमान्य संख्या %r, अनदेखा किया गया" -#: theming.py:114 +#: config.py:399 #, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +msgid "cannot override config setting %r with unsupported type, ignoring" +msgstr "असमर्थित प्रकार के साथ विन्यास मान %r का उल्लंघन नहीं किया जा सकता, अनदेखा किया गया" -#: theming.py:120 +#: config.py:422 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "विन्यास मान %s.%s खोजे गए किसी भी रूप विन्यास में नहीं दिखा" +msgid "unknown config value %r in override, ignoring" +msgstr "आरोहण में अज्ञात विन्यास मान %r, अनदेखा किया गया" -#: theming.py:135 +#: config.py:476 #, python-format -msgid "unsupported theme option %r given" -msgstr "विन्यास का असमर्थित रूप विकल्प %r दिया गया" +msgid "No such config value: %r" +msgstr "" -#: theming.py:207 +#: config.py:504 #, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "रुपविन्यास के पथ में फाइल %r कोई प्रमाणिक ज़िप फाइल नहीं है या इसमें कोई रुपविन्यास नहीं सहेजा गया है" +msgid "Config value %r already present" +msgstr "विन्यास मान %r पहले से विद्यमान है" -#: theming.py:228 +#: config.py:541 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" msgstr "" -#: theming.py:268 -#, python-format -msgid "The %r theme has circular inheritance" +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." msgstr "" -#: theming.py:275 +#: config.py:599 #, python-format +msgid "There is a syntax error in your configuration file: %s\n" +msgstr "आपकी विन्यास फाइल में रचनाक्रम की त्रुटि है: %s\n" + +#: config.py:603 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "" +"The configuration file (or one of the modules it imports) called sys.exit()" +msgstr "विन्यास फाइल (अथवा इसके द्वारा आयातित प्रभागों) द्वारा sys.exit() का आह्वान किया गया" -#: theming.py:282 +#: config.py:611 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "" +msgid "" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" +msgstr "विन्यास फाइल में प्रोग्राम के योग्य त्रुटि है:\n\n%s" -#: theming.py:310 +#: config.py:633 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to convert %r to a frozenset" msgstr "" -#: theming.py:335 theming.py:388 +#: config.py:651 config.py:659 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: theming.py:339 +#: config.py:665 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." msgstr "" -#: theming.py:343 theming.py:391 +#: config.py:686 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +msgid "Section %s" +msgstr "भाग %s" -#: theming.py:347 +#: config.py:687 #, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +msgid "Fig. %s" +msgstr "चित्र %s" -#: theming.py:366 +#: config.py:688 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +msgid "Table %s" +msgstr "सारणी %s" -#: config.py:309 +#: config.py:689 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "विन्यास निर्देशिका में कोन्फ़.पाय #conf.py# फाइल (%s) नहीं है " +msgid "Listing %s" +msgstr "सूची %s" -#: config.py:318 -msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "" - -#: config.py:341 -#, python-format -msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" -msgstr "शब्दकोष विन्यास मान %r की उल्लंघन नहीं किया जा सकता, अनदेखा किया गया (प्रत्येक अवयव का मान रखने के लिए %r का उपयोग करें)" - -#: config.py:350 -#, python-format -msgid "invalid number %r for config value %r, ignoring" -msgstr "विन्यास मान %r के लिए अमान्य संख्या %r, अनदेखा किया गया" - -#: config.py:356 -#, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" -msgstr "असमर्थित प्रकार के साथ विन्यास मान %r का उल्लंघन नहीं किया जा सकता, अनदेखा किया गया" - -#: config.py:377 -#, python-format -msgid "unknown config value %r in override, ignoring" -msgstr "आरोहण में अज्ञात विन्यास मान %r, अनदेखा किया गया" - -#: config.py:430 -#, python-format -msgid "No such config value: %r" -msgstr "" - -#: config.py:453 -#, python-format -msgid "Config value %r already present" -msgstr "विन्यास मान %r पहले से विद्यमान है" - -#: config.py:489 -#, python-format -msgid "" -"cannot cache unpickable configuration value: %r (because it contains a " -"function, class, or module object)" -msgstr "" - -#: config.py:527 -#, python-format -msgid "There is a syntax error in your configuration file: %s\n" -msgstr "आपकी विन्यास फाइल में रचनाक्रम की त्रुटि है: %s\n" - -#: config.py:530 -msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" -msgstr "विन्यास फाइल (अथवा इसके द्वारा आयातित प्रभागों) द्वारा sys.exit() का आह्वान किया गया" - -#: config.py:537 -#, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" -msgstr "विन्यास फाइल में प्रोग्राम के योग्य त्रुटि है:\n\n%s" - -#: config.py:560 -#, python-format -msgid "Failed to convert %r to a set or tuple" -msgstr "" - -#: config.py:581 config.py:586 -#, python-format -msgid "Converting `source_suffix = %r` to `source_suffix = %r`." -msgstr "" - -#: config.py:589 -#, python-format -msgid "" -"The config value `source_suffix' expects a dictionary, a string, or a list " -"of strings. Got `%r' instead (type %s)." -msgstr "" - -#: config.py:608 -#, python-format -msgid "Section %s" -msgstr "भाग %s" - -#: config.py:609 -#, python-format -msgid "Fig. %s" -msgstr "चित्र %s" - -#: config.py:610 -#, python-format -msgid "Table %s" -msgstr "सारणी %s" - -#: config.py:611 -#, python-format -msgid "Listing %s" -msgstr "सूची %s" - -#: config.py:718 +#: config.py:798 +#, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "`{name}` विन्यास मान, {candidates} में से एक होना चाहिए, परन्तु `{current}` दिया गया है." -#: config.py:742 +#: config.py:829 +#, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "विन्यास मान `{name}' का प्रकार `{current.__name__}' है; अपेक्षित {permitted}." -#: config.py:755 +#: config.py:846 +#, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "विन्यास मान `{name}' का प्रकार `{current.__name__}' है; मानक `{default.__name__}' का प्रयोग किया गया." -#: config.py:766 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r नहीं मिला, अनदेखा किया गया." -#: config.py:778 +#: config.py:878 msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." -msgstr "" - -#: domains/rst.py:128 domains/rst.py:185 -#, python-format -msgid "%s (directive)" -msgstr "%s (निर्देश)" - -#: domains/rst.py:186 domains/rst.py:190 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:214 -#, python-format -msgid "%s (role)" -msgstr "%s (भूमिका)" - -#: domains/rst.py:224 -msgid "directive" -msgstr "निर्देश" - -#: domains/rst.py:225 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:226 -msgid "role" -msgstr "भूमिका" - -#: domains/rst.py:248 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:165 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (अंतर्निर्मित फंक्शन)" - -#: domains/javascript.py:166 domains/python/__init__.py:253 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s विधि)" - -#: domains/javascript.py:168 -#, python-format -msgid "%s() (class)" -msgstr "%s() (वर्ग)" - -#: domains/javascript.py:170 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (वैश्विक चरपद अथवा अचर) " - -#: domains/javascript.py:172 domains/python/__init__.py:338 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s लक्षण)" - -#: domains/javascript.py:255 -msgid "Arguments" -msgstr "चर " - -#: domains/cpp/__init__.py:447 domains/javascript.py:258 -msgid "Throws" -msgstr "देता है " - -#: domains/c/__init__.py:310 domains/cpp/__init__.py:458 -#: domains/javascript.py:261 domains/python/_object.py:176 -msgid "Returns" -msgstr "प्रदत्त " - -#: domains/c/__init__.py:312 domains/javascript.py:263 -#: domains/python/_object.py:178 -msgid "Return type" -msgstr "प्रदत्त प्रकार " - -#: domains/javascript.py:334 -#, python-format -msgid "%s (module)" -msgstr "%s (प्रभाग)" - -#: domains/c/__init__.py:681 domains/cpp/__init__.py:859 -#: domains/javascript.py:371 domains/python/__init__.py:660 -msgid "function" -msgstr "फंक्शन" - -#: domains/javascript.py:372 domains/python/__init__.py:664 -msgid "method" -msgstr "पद्धति" - -#: domains/cpp/__init__.py:857 domains/javascript.py:373 -#: domains/python/__init__.py:662 -msgid "class" -msgstr "वर्ग" - -#: domains/javascript.py:374 domains/python/__init__.py:661 -msgid "data" -msgstr "आंकड़े " - -#: domains/javascript.py:375 domains/python/__init__.py:667 -msgid "attribute" -msgstr "लक्षण" - -#: domains/javascript.py:376 domains/python/__init__.py:670 -msgid "module" -msgstr "प्रभाग" - -#: domains/javascript.py:407 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:25 -#, python-format -msgid "Added in version %s" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Changed in version %s" -msgstr "संस्करण %s से अलग " - -#: domains/changeset.py:27 -#, python-format -msgid "Deprecated since version %s" -msgstr "संस्करण %s से प्रतिबंधित " - -#: domains/changeset.py:28 -#, python-format -msgid "Removed in version %s" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: domains/__init__.py:299 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/citation.py:73 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "प्रतिरूप उद्धरण %s, दूसरी प्रतिकृति %s में है " - -#: domains/citation.py:84 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "उद्धरण [%s] सन्दर्भ कहीं नहीं है" - -#: domains/math.py:63 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "समीकरण का प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है " - -#: domains/math.py:119 writers/latex.py:2479 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "अमान्य math_eqref_format: %r" - -#: environment/__init__.py:81 +#: environment/__init__.py:89 msgid "new config" msgstr "नव विन्यास" -#: environment/__init__.py:82 +#: environment/__init__.py:90 msgid "config changed" msgstr "विन्यास परिवर्तित" -#: environment/__init__.py:83 +#: environment/__init__.py:91 msgid "extensions changed" msgstr "आयाम परिवर्तित" -#: environment/__init__.py:249 +#: environment/__init__.py:261 msgid "build environment version not current" msgstr "निर्मित परिस्थिति वर्तमान संस्करण नहीं है " -#: environment/__init__.py:251 +#: environment/__init__.py:263 msgid "source directory has changed" msgstr "स्रोत निर्देशिका परिवर्तित हो चुकी है " -#: environment/__init__.py:313 +#: environment/__init__.py:350 #, python-format msgid "The configuration has changed (1 option: %r)" msgstr "" -#: environment/__init__.py:318 +#: environment/__init__.py:355 #, python-format msgid "The configuration has changed (%d options: %s)" msgstr "" -#: environment/__init__.py:324 +#: environment/__init__.py:361 #, python-format msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: environment/__init__.py:366 +#: environment/__init__.py:404 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "यह परिस्थिति चुने गए निर्माता से मेल नहीं खाती, कृपया दूसरी डॉक-ट्री निर्देशिका चुनें. " -#: environment/__init__.py:473 +#: environment/__init__.py:518 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "लेखपत्रों के पर्यवेक्षण में असफलता %s: %r" -#: environment/__init__.py:626 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format msgid "Domain %r is not registered" msgstr "अधिकारक्षेत्र %r पंजीकृत नहीं है" -#: environment/__init__.py:777 +#: environment/__init__.py:811 msgid "document isn't included in any toctree" msgstr "लेखपत्र किसी भी विषय-सूची-संरचना में सम्मिलित नहीं है" -#: environment/__init__.py:810 +#: environment/__init__.py:922 msgid "self referenced toctree found. Ignored." msgstr "स्वयं-संदर्भित विषय-सूची-संरचना मिली है. उपेक्षा की गई." -#: environment/__init__.py:839 +#: environment/__init__.py:952 #, python-format msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" @@ -861,470 +720,912 @@ msgstr "सलाह" msgid "Warning" msgstr "चेतावनी" -#: cmd/quickstart.py:43 -msgid "automatically insert docstrings from modules" -msgstr "प्रभागों में से डॉक्-स्ट्रिंग स्वतःसम्मिलित करें" +#: builders/texinfo.py:41 +#, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "टेक्सइन्फो पृष्ठ %(outdir)sमें हैं." -#: cmd/quickstart.py:44 -msgid "automatically test code snippets in doctest blocks" -msgstr "डॉक्-टेस्ट अंशों के निर्देश भाग की स्वतः जाँच करें" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nइन्हें मेकइन्फो से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें\n(ऐसा स्वचालित रूप से करने के लिए यहाँ 'मेक इन्फो' आदेश का उपयोग करें)" -#: cmd/quickstart.py:45 -msgid "link between Sphinx documentation of different projects" -msgstr "भिन्न परियोजनाओं के स्फिंक्स प्रलेखों का पारस्परिक सम्बन्ध करने दें" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "कोई \"texinfo_documents\" विन्यास मान नहीं मिला; कोई लेखपत्र नहीं लिखे जाएंगे" -#: cmd/quickstart.py:46 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "वह \"शेष\" प्रविष्टियाँ लिख लें, जिन्हें निर्माण के समय दिखाया या छिपाया जा सकता है" +#: builders/texinfo.py:85 +#, python-format +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "\"texinfo_documents\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है" -#: cmd/quickstart.py:47 -msgid "checks for documentation coverage" -msgstr "प्रलेखों की व्याप्ति की जाँच करें" +#: builders/latex/__init__.py:310 builders/texinfo.py:105 +#, python-format +msgid "processing %s" +msgstr "%s की प्रक्रिया जारी" -#: cmd/quickstart.py:48 -msgid "include math, rendered as PNG or SVG images" -msgstr "गणित को सम्मिलित करें, पी.एन.जी. अथवा एस.वी.जी. में चित्रित" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "लिखा जा रहा है" -#: cmd/quickstart.py:49 -msgid "include math, rendered in the browser by MathJax" -msgstr "गणित को सम्मिलित करें, दिग्दर्शक में मैथजाक्स #MathJax# द्वारा प्रदर्शित" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "सन्दर्भों का विश्लेषण किया जा रहा है..." -#: cmd/quickstart.py:50 -msgid "conditional inclusion of content based on config values" -msgstr "विन्यास मान के आधार पर सामिग्री का सशर्त समावेश" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (में" -#: cmd/quickstart.py:51 -msgid "include links to the source code of documented Python objects" -msgstr "पाइथन विषयवस्तुओं के प्रलेखों के स्रोत निर्देश की कड़ी जोड़ें" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "चित्रों की प्रतिलिपि बनाई जा रही है..." -#: cmd/quickstart.py:52 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "गिटहब GitHub पर लेखपत्र प्रकाशित करने के लिए .nojekyll फाइल बनाएं" +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 +#, python-format +msgid "cannot copy image file %r: %s" +msgstr "चित्रलेख फाइल %r की प्रतिलिपि नहीं की जा सकी:%s" -#: cmd/quickstart.py:94 -msgid "Please enter a valid path name." -msgstr "कृपया एक मान्य पथ का नाम दें" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "टेक्सइन्फो सहायक फाइलों की प्रतिलिपि की जा रही है..." -#: cmd/quickstart.py:110 -msgid "Please enter some text." -msgstr "कृपया कुछ वाक्यांश लिखें" +#: builders/texinfo.py:218 +#, python-format +msgid "error writing file Makefile: %s" +msgstr "मेकफाइल लिखने में त्रुटि: %s" -#: cmd/quickstart.py:117 +#: builders/manpage.py:37 #, python-format -msgid "Please enter one of %s." -msgstr "%s में से एक चुनें" +msgid "The manual pages are in %(outdir)s." +msgstr "पुस्तिका पृष्ठ %(outdir)sमें हैं." -#: cmd/quickstart.py:125 -msgid "Please enter either 'y' or 'n'." -msgstr "कृपया हाँ के लिए 'y' अथवा नहीं के लिए 'n' मात्र दें. " +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "कोई \"man_pages\" विन्यास मान नहीं मिला; कोई नियमावली पृष्ठ नहीं लिखे जाएंगे" -#: cmd/quickstart.py:131 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "कृपया एक फाइल प्रत्यय दें, जैसे कि '.rst' अथवा '.txt'." +#: builders/manpage.py:64 +#, python-format +msgid "\"man_pages\" config value references unknown document %s" +msgstr "\"man_pages\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है" -#: cmd/quickstart.py:215 +#: builders/singlehtml.py:35 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "स्फिंक्स %s त्वरित-आरंभ #sphinx-quickstart# उपकरण के लिए अभिनन्दन" +msgid "The HTML page is in %(outdir)s." +msgstr "एच.टी.एम्.एल. पृष्ठ %(outdir)sमें है." + +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "एकल लेखपत्र संकलन किया जा रहा है" + +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "अतिरिक्त फाइलों को लिखा जा रहा है" + +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "मूक निर्माता से किसी फाइलों की उत्पत्ति नहीं होती." + +#: builders/gettext.py:243 +#, python-format +msgid "The message catalogs are in %(outdir)s." +msgstr "सन्देश सूचीपत्र %(outdir)s में हैं." + +#: builders/__init__.py:400 builders/gettext.py:264 +#, python-format +msgid "building [%s]: " +msgstr "निर्माणाधीन [%s]: " + +#: builders/gettext.py:265 +#, python-format +msgid "targets for %d template files" +msgstr "%d नमूना फाइलों के लक्ष्य" + +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "नमूनों को पढ़ा जा रहा है..." + +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "सन्देश सूचीपत्रों को लिखा जा रहा है..." + +#: builders/linkcheck.py:87 +#, python-format +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "उपरोक्त परिणाम में अथवा %(outdir)s /output.txt में त्रुटियाँ ढूँढने का प्रयास " + +#: builders/linkcheck.py:159 +#, python-format +msgid "broken link: %s (%s)" +msgstr "खंडित कड़ी: %s (%s)" + +#: builders/linkcheck.py:561 +#, python-format +msgid "Anchor '%s' not found" +msgstr "लक्ष्य '%s' नहीं मिला" + +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "" + +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "" + +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." +msgstr "ई-पब फाइल %(outdir)s में है." + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "" + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "ई-पब3 के लिए विन्यास मान \"epub_language\" (अथवा \"language\") खाली नहीं होना चाहिए" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "ई-पब3 के लिए विन्यास मान \"epub_uid\" एक्स.एम्.एल. नाम होना चाहिए" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "ई-पब3 के लिए विन्यास मान \"epub_title\" (अथवा \"html_title\") खाली नहीं होना चाहिए" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "ई-पब3 के लिए विन्यास मान \"epub_author\" खाली नहीं होना चाहिए" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "ई-पब3 के लिए विन्यास मान \"epub_contributor\" खाली नहीं होना चाहिए" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "ई-पब3 के लिए विन्यास मान \"epub_description\" खाली नहीं होना चाहिए" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "ई-पब3 के लिए विन्यास मान \"epub_publisher\" खाली नहीं होना चाहिए" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "ई-पब3 के लिए विन्यास मान \"epub_copyright\" (अथवा \"copyright\") खाली नहीं होना चाहिए" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "ई-पब3 के लिए विन्यास मान \"epub_identifier\" खाली नहीं होना चाहिए" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "ई-पब3 के लिए विन्यास मान \"version\" खाली नहीं होना चाहिए" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" +msgstr "अमान्य css_file: %r, उपेक्षित" + +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." +msgstr "एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं." + +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" +msgstr "%s फाइल लिखने में व्यवधान: %s" + +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "छद्म-एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं." + +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" +msgstr "विषय-सूची प्रविष्टि की प्रतिलिपि पायी गई: %s" -#: cmd/quickstart.py:219 +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" +msgstr "चित्रलेख फाइल %r नहीं पढ़ा जा सका: इसकी प्रतिलिपि बनाई जा रही है" + +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" +msgstr "चित्रलेख फाइल %r नहीं लिखा जा सका:%s" + +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "पिलो नहीं मिला - चित्र फाइलों की प्रतिलिपि बनाई जा रही है" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "%s के लिए अज्ञात लेख प्रकार, छोड़ा गया" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "%s फाइल को लिखा जा रहा है..." + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "पाठ फाइल %(outdir)s में हैं." + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "%s निर्माता के लिए योग्य चित्र नहीं मिला: %s.(%s)" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "%s निर्माता के लिए योग्य चित्र नहीं मिला: %s" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "निर्माणाधीन [mo]: " + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "परिणाम लिखा जा रहा है..." + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "सभी %d पी.ओ. फाइलें" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "निर्दिष्ट %d पी.ओ. फाइलों के लक्ष्य" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "%d पी.ओ. फाइलों के लक्ष्य कालातीत है" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "सभी स्रोत फाइलें" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "कृपया निम्न विन्यासों के लिए मान प्रदान करें (मानक मान, यदि कोष्ठक में हो तो, स्वीकार करने के लिए एन्टर दबाएँ)" +"file %r given on command line is not under the source directory, ignoring" +msgstr "आदेश स्थान में दी गयी फाइल %r स्रोत निर्देशिका में नहीं है, उपेक्षा की जा रही है" -#: cmd/quickstart.py:227 +#: builders/__init__.py:353 #, python-format -msgid "Selected root path: %s" -msgstr "चुना हुआ बुनियादी तथा मूल स्थान: %s" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" -#: cmd/quickstart.py:230 -msgid "Enter the root path for documentation." -msgstr "आलेख का बुनियादी स्थान बताएं." +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "%d स्रोत फाइलें आदेश स्थान में दी " -#: cmd/quickstart.py:231 -msgid "Root path for the documentation" -msgstr "आलेख का बुनियादी पथ" +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "%d फाइलों के लक्ष्य कालातीत है" -#: cmd/quickstart.py:239 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "त्रुटि: एक मौजूदा conf.py फाइल दिए गए मूल पथ में प्राप्त हुई है." +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "अप्रचलित फाइलों को चिन्हित किया जा रहा है..." -#: cmd/quickstart.py:245 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "स्फिंक्स-त्वरित-आरम्भ #sphinx-quickstart# मौजूदा स्फिंक्स परियोजनाओं पर पुनर्लेखन नहीं करेगा." +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "%d मिला" -#: cmd/quickstart.py:248 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "कृपया एक नया मूल पथ दें (अथवा निकलने हेतु सिर्फ एन्टर #Enter# कर दें)" +#: builders/__init__.py:417 +msgid "none found" +msgstr "एक भी नहीं मिला" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "स्थिति को परिरक्षित किया जा रहा है" -#: cmd/quickstart.py:258 +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "संगतता की जांच की जा रही है" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "कोई प्रयोजन कालातीत नहीं है" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "स्थिति का नवीनीकरण किया जा रहा है" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "%s जोड़ा गया, %s बदला गया, %s हटाया गया" + +#: builders/__init__.py:536 +#, python-format msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "आपके पास Sphinx द्वारा बनाई गई फाइलों को सहेजने के लिए दो विकल्प हैं.\nया तो आप मूल स्थान में ही \"_build\" निर्देशिका प्रयोग करें, अथवा\nमूल पथ में भिन्न \"स्रोत\" और \"build\" निर्देशिका प्रयोग करें." +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" -#: cmd/quickstart.py:265 -msgid "Separate source and build directories (y/n)" -msgstr "विभिन्न स्रोत और निर्माण डायरेक्टरी (y/n)" +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" -#: cmd/quickstart.py:271 +#: builders/__init__.py:556 +#, python-format msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "मूल निर्देशिका के अन्दर, दो और निर्देशिका बनाई जाएँगी;\nपरिवर्धित एच.टी.एम्.एल. नमूनों के लिए \"_templates\" और परिवर्धित रुपपत्रों और अन्य स्थैतिक फाइलों के लिए \"_static\"\nआप अधोरेखा के स्थान पर अन्य पूर्व-प्रत्यय (जैसे कि \".\") का प्रयोग कर सकते हैं." +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" -#: cmd/quickstart.py:277 -msgid "Name prefix for templates and static dir" -msgstr "नमूने और स्थैतिक डायरेक्टरी के लिए पूर्व-प्रत्यय" +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "स्रोतों को पढ़ा जा रहा है..." + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "लेखन के लिए शेष लेखपत्र: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "लेखपत्र बनाए जा रहे हैं" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "संक्षिप्त विवरण फाइल %(outdir)s में है." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "%s संस्करण में कोई परिवर्तन नहीं हैं." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "सार फाइल को लिखा जा रहा है..." -#: cmd/quickstart.py:282 +#: builders/changes.py:79 +msgid "Builtins" +msgstr "अंतर्निर्मित" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "प्रभाग स्तर" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "स्रोत फाइलों की प्रतिलिपि बनाई जा रही है..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "परिवर्तन सूची बनाने के लिए %r को नहीं पढ़ा जा सका" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "अमान्य रेगएक्स #regex# %r, %s में " + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "प्रभाग %s का आयत नहीं किया जा सका: %s" + +#: ext/coverage.py:148 +#, python-format msgid "" -"The project name will occur in several places in the built documentation." -msgstr "परियोजना का नाम बनाये गए प्रपत्रों में बहुत से स्थानों पर प्रयुक्त होगा." +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "" -#: cmd/quickstart.py:286 -msgid "Project name" -msgstr "परियोजना का नाम" +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" -#: cmd/quickstart.py:288 -msgid "Author name(s)" -msgstr "लेखक(कों) का नाम" +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "" + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "अमान्य रेगएक्स #regex# %r, coverage_c_regexes में " + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "" -#: cmd/quickstart.py:293 +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "" + +#: ext/extlinks.py:82 +#, python-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: cmd/quickstart.py:301 -msgid "Project version" -msgstr "परियोजना संस्करण" +#: ext/todo.py:61 +msgid "Todo" +msgstr "अपूर्ण " -#: cmd/quickstart.py:303 -msgid "Project release" -msgstr "परियोजना आवृत्ति" +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "अपूर्ण प्रविष्टि मिली: %s " + +#: ext/todo.py:152 +msgid "<>" +msgstr "<<मूल प्रविष्टि>>" -#: cmd/quickstart.py:308 +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<<मूल प्रविष्टि>> %s, पंक्ति %d में उपस्थित है.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "मौलिक प्रविष्टि" + +#: ext/imgconverter.py:44 +#, python-format msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" "\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "यदि प्रलेखों को अंग्रेजी के अलावा अन्य किसी भाषा में लिखा जाना है,\nतो यहाँ पर आप भाषा का कूटशब्द दे सकते हैं. स्फिंक्स तदपुरांत,\nजो वाक्यांश बनाता है उसे उस भाषा में अनुवादित करेगा.\n\nमान्य भाषा कूटशब्द सूची यहाँ पर देखें\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." - -#: cmd/quickstart.py:317 -msgid "Project language" -msgstr "परियोजना की भाषा" +"Traceback: %s" +msgstr "" -#: cmd/quickstart.py:324 +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "परिवर्तक त्रुटि के साथ बहार आ गया:\n[stderr]\n%r\n[stdout]\n%r" + +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" -#: cmd/quickstart.py:329 -msgid "Source file suffix" -msgstr "स्रोत फाइल का प्रत्यय" +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" +msgstr "ग्राफविज़ निर्देश में दोनों मापदंड, विषय-वस्तु और फाइल का नाम, नहीं हो सकते" + +#: ext/graphviz.py:153 +#, python-format +msgid "External Graphviz file %r not found or reading it failed" +msgstr "बाहरी ग्राफविज़ फाइल %r नहीं मिली अथवा पढने में असफलता मिली" + +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "विषय-वस्तु के बिना ग्राफविज़ निर्देश की उपेक्षा की जा रही है. " -#: cmd/quickstart.py:334 +#: ext/graphviz.py:287 +#, python-format +msgid "graphviz_dot executable path must be set! %r" +msgstr "" + +#: ext/graphviz.py:328 +#, python-format msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" +msgstr "डॉट निर्देश %r नहीं चलाया जा सकता (ग्राफविज़ परिणाम के लिए आवश्यक), ग्राफविज़_डॉट मान की जांच करें" + +#: ext/graphviz.py:339 +#, python-format +msgid "" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "डॉट त्रुटि के साथ बहार आ गया:\n[stderr]\n%r\n[stdout]\n%r" + +#: ext/graphviz.py:344 +#, python-format +msgid "" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "डॉट ने किसी परिणाम फाइल का नहीं बनाया:\n[stderr]\n%r\n[stdout]\n%r" + +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" msgstr "" -#: cmd/quickstart.py:342 -msgid "Name of your master document (without suffix)" -msgstr "आपने मुख्य लेखपत्र का नाम दें (प्रत्यय रहित)" +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" +msgstr "डॉट निर्देश %r: %s" + +#: ext/graphviz.py:493 ext/graphviz.py:501 +#, python-format +msgid "[graph: %s]" +msgstr "[graph: %s]" + +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" +msgstr "[graph]" + +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "लाटेक्स आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). आई.एम्.जी.मैथ_लाटेक्स मान की जाँच करें" + +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). imgmath_%s मान की जाँच करें" + +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "लाटेक्स दिखाएँ %r: %s" -#: cmd/quickstart.py:352 +#: ext/imgmath.py:362 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "त्रुटि: मुख्य फाइल %s चुने हुए मूल पथ में पहले से उपलब्ध है." +msgid "inline latex %r: %s" +msgstr "पंक्तिबद्ध लाटेक्स %r: %s" -#: cmd/quickstart.py:359 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "स्फिंक्स-त्वरित-आरम्भ मौजूदा फाइलों पर पुनर्लेखन नहीं करेगा." +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" -#: cmd/quickstart.py:362 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "कृपया एक नया फाइल नाम दें, अथवा मौजूदा फाइल का पुनर्नामकरण करें और एन्टर दबाएँ" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "'%s' विकल्प में अनुपस्थित '+' या '-'." -#: cmd/quickstart.py:371 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "इनमें से कौन सा स्फिंक्स आयाम प्रयोग करना है, इंगित करें:" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "'%s' एक मान्य विकल्प नहीं है." -#: cmd/quickstart.py:381 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "टिप्पणी: imgmath और mathjax एक साथ समर्थ नहीं हो सकते. imgmath को अचिन्हित कर दिया गया है." +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' एक मान्य पाईवर्शन #pyversion# विकल्प नहीं है. " -#: cmd/quickstart.py:391 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "अमान्य टेस्टकोड का प्रकार " -#: cmd/quickstart.py:397 -msgid "Create Makefile? (y/n)" -msgstr "मेकफाइल बनाएं? (हाँ के लिए y/ ना के लिए n)" +#: ext/doctest.py:297 +#, python-format +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "स्रोतों में डॉकटेस्ट्स की जांच पूरी, परिणाम %(outdir)s/output.txt में देखें. " -#: cmd/quickstart.py:401 -msgid "Create Windows command file? (y/n)" -msgstr "विंडोज़ कमांड फाइल बनाएं? (हाँ के लिए y/ ना के लिए n)" +#: ext/doctest.py:451 +#, python-format +msgid "no code/output in %s block at %s:%s" +msgstr "%s भाग में %s पर कोई निर्देश / परिणाम नहीं: %s" -#: cmd/quickstart.py:453 ext/apidoc.py:92 +#: ext/doctest.py:568 #, python-format -msgid "Creating file %s." -msgstr "फाइल बनाई जा रही है ...%s" +msgid "ignoring invalid doctest code: %r" +msgstr "अमान्य डॉकटेस्ट निर्देश की उपेक्षा की जा रही है: %r" -#: cmd/quickstart.py:458 ext/apidoc.py:89 +#: ext/autosectionlabel.py:52 #, python-format -msgid "File %s already exists, skipping." -msgstr "फाइल %s पहले से उपस्थित है, छोड़ दी गई." +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "" -#: cmd/quickstart.py:501 -msgid "Finished: An initial directory structure has been created." -msgstr "समाप्त: एक प्रारंभिक निर्देशिका का ढांचा बना दिया गया है." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है " -#: cmd/quickstart.py:504 +#: ext/duration.py:47 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: cmd/quickstart.py:512 +#: ext/duration.py:117 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"====================== total reading duration ==========================" msgstr "" -#: cmd/quickstart.py:515 +#: ext/duration.py:124 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: cmd/quickstart.py:522 +#: ext/duration.py:136 msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +"====================== slowest reading durations =======================" msgstr "" -#: cmd/quickstart.py:557 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nस्फिंक्स परियोजना के लिए आवश्यक फाइल बनाएं.\n\nस्फिंक्स-त्वरित-आरम्भ एक संवादपूर्ण उपकरण है जो आपकी परियोजना के \nबारे में कुछ प्रश्न पूछकर पूरी प्रलेखों की निर्देशिका और नमूना मेकफाइल \nबना देता है जिसे स्फिंक्स-बिल्ड में प्रयोग किया जा सकता है.\n" - -#: cmd/build.py:153 cmd/quickstart.py:567 ext/apidoc.py:374 -#: ext/autosummary/generate.py:766 -msgid "For more information, visit ." +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: cmd/quickstart.py:577 -msgid "quiet mode" -msgstr "शांत ढंग " - -#: cmd/quickstart.py:587 -msgid "project root" -msgstr "" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[स्रोत]" -#: cmd/quickstart.py:590 -msgid "Structure options" -msgstr "ढांचे के विकल्प" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "प्रभाग निर्देश विशिष्ट रूप से दर्शाया जा रहा है..." -#: cmd/quickstart.py:596 -msgid "if specified, separate source and build dirs" -msgstr "यदि निर्दिष्ट हो तो विभिन्न स्रोत और निर्माण पथ" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[docs]" -#: cmd/quickstart.py:602 -msgid "if specified, create build dir under source dir" -msgstr "" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "प्रभाग निर्देश" -#: cmd/quickstart.py:608 -msgid "replacement for dot in _templates etc." -msgstr "_templates आदि में बिंदु का बदलाव" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        %s का स्रोत निर्देश

        " -#: cmd/quickstart.py:611 -msgid "Project basic options" -msgstr "परोयोजना के मूलभूत विकल्प" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "सिंहावलोकन: प्रभाग निर्देश" -#: cmd/quickstart.py:613 -msgid "project name" -msgstr "परियोजना का नाम" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        सभी प्रभाग जिनके लिए निर्देश उपलब्ध है

        " -#: cmd/quickstart.py:616 -msgid "author names" -msgstr "लेखकों के नाम" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" +msgstr "प्रतिरूप उद्धरण %s, दूसरी प्रतिकृति %s में है " -#: cmd/quickstart.py:623 -msgid "version of project" -msgstr "परियोजना का संस्करण" +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." +msgstr "उद्धरण [%s] सन्दर्भ कहीं नहीं है" -#: cmd/quickstart.py:630 -msgid "release of project" -msgstr "परियोजना की आवृत्ति" +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" +msgstr "समीकरण का प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है " -#: cmd/quickstart.py:637 -msgid "document language" -msgstr "लेखपत्र की भाषा" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "अमान्य math_eqref_format: %r" -#: cmd/quickstart.py:640 -msgid "source file suffix" -msgstr "स्रोत फाइल का प्रत्यय" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (अंतर्निर्मित फंक्शन)" -#: cmd/quickstart.py:643 -msgid "master document name" -msgstr "मुख्य लेखपत्र का नाम" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s विधि)" -#: cmd/quickstart.py:646 -msgid "use epub" -msgstr "ई-पब प्रयोग करें" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (वर्ग)" -#: cmd/quickstart.py:649 -msgid "Extension options" -msgstr "आयाम के विकल्प" +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" +msgstr "%s (वैश्विक चरपद अथवा अचर) " -#: cmd/quickstart.py:656 ext/apidoc.py:578 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "enable %s extension" -msgstr "आयाम %s सक्षम करें" +msgid "%s (%s attribute)" +msgstr "%s (%s लक्षण)" -#: cmd/quickstart.py:663 ext/apidoc.py:570 -msgid "enable arbitrary extensions" -msgstr "स्वेच्छित आयाम सक्षम करें" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "चर " -#: cmd/quickstart.py:666 -msgid "Makefile and Batchfile creation" -msgstr "मेकफाइल और बैचफाइल का सर्जन" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "देता है " -#: cmd/quickstart.py:672 -msgid "create makefile" -msgstr "मेकफाइल बनाएं" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "प्रदत्त " -#: cmd/quickstart.py:678 -msgid "do not create makefile" -msgstr "मेकफाइल नहीं बनाएं" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "प्रदत्त प्रकार " -#: cmd/quickstart.py:685 -msgid "create batchfile" -msgstr "बैचफाइल बनाएं" +#: domains/javascript.py:374 +#, python-format +msgid "%s (module)" +msgstr "%s (प्रभाग)" -#: cmd/quickstart.py:691 -msgid "do not create batchfile" -msgstr "बैचफाइल नहीं बनाएं" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "फंक्शन" -#: cmd/quickstart.py:700 -msgid "use make-mode for Makefile/make.bat" -msgstr "Makefile/make.bat के लिए make-mode का प्रयोग करें" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "पद्धति" -#: cmd/quickstart.py:703 ext/apidoc.py:581 -msgid "Project templating" -msgstr "परियोजना नमूनावृत्ति" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "वर्ग" -#: cmd/quickstart.py:709 ext/apidoc.py:587 -msgid "template directory for template files" -msgstr "नमूना फाइलों के लिए नमूना निर्देशिका" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "आंकड़े " -#: cmd/quickstart.py:716 -msgid "define a template variable" -msgstr "नमूना चर-पद का निरूपण करें" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "लक्षण" -#: cmd/quickstart.py:751 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "\"शांत\" निर्दिष्ट है, परन्तु कोई भी \"परियोजना\" अथवा \"लेखक\" निर्दिष्ट नहीं है." +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "प्रभाग" -#: cmd/quickstart.py:770 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "त्रुटि: दिया गया पथ निर्देशिका नहीं है, अथवा स्फिंक्स फाइलें पहले से उपस्थित हैं." +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" +msgstr "" -#: cmd/quickstart.py:777 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "स्फिंक्स-त्वरित-आरम्भ केवल एक खाली निर्देशिका में कार्यशील हो सकती है. कृपया एक नया मूल पथ निर्दिष्ट करें." +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" +msgstr "%s (निर्देश)" -#: cmd/quickstart.py:795 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "Invalid template variable: %s" -msgstr "अमान्य नमूना चर-पद: %s" +msgid ":%s: (directive option)" +msgstr "" -#: cmd/build.py:49 -msgid "Exception occurred while building, starting debugger:" -msgstr "निर्माण के दौरान अपवाद घटित हुआ है, दोष-मुक्तक चालू किया जा रहा " +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (भूमिका)" -#: _cli/util/errors.py:129 cmd/build.py:65 -msgid "Interrupted!" -msgstr "कार्य खंडित " +#: domains/rst.py:234 +msgid "directive" +msgstr "निर्देश" -#: cmd/build.py:67 -msgid "reST markup error:" -msgstr "रेस्ट सुसज्जा त्रुटि:" +#: domains/rst.py:235 +msgid "directive-option" +msgstr "" + +#: domains/rst.py:236 +msgid "role" +msgstr "भूमिका" + +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "" + +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" +msgstr "" -#: _cli/util/errors.py:143 cmd/build.py:73 -msgid "Encoding error:" -msgstr "कूटलेखन त्रुटि:" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "संस्करण %s से अलग " -#: cmd/build.py:78 cmd/build.py:108 +#: domains/changeset.py:34 #, python-format -msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." -msgstr "यदि आप इस विषय को कूटलिपिकारों के संज्ञान में लाना चाहते है तो पिछला पूरा विवरण %s में सहेज दिया गया है" - -#: _cli/util/errors.py:148 cmd/build.py:90 -msgid "Recursion error:" -msgstr "पुनरावर्तन त्रुटि:" +msgid "Deprecated since version %s" +msgstr "संस्करण %s से प्रतिबंधित " -#: _cli/util/errors.py:152 cmd/build.py:94 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: _cli/util/errors.py:165 cmd/build.py:103 -msgid "Exception occurred:" -msgstr "अपवाद घटित:" - -#: _cli/util/errors.py:178 cmd/build.py:117 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "यदि यह प्रयोक्ता की गलती थी तो कृपया इसको भी रिपोर्ट करें ताकि अगली बार गलती होने पर अधिक अर्थपूर्ण सन्देश दिया जा सके." - -#: cmd/build.py:124 -msgid "" -"A bug report can be filed in the tracker at . Thanks!" -msgstr "त्रुटि की सूचना पर उपस्थित पंजिका में दर्ज की जा सकती है. धन्यवाद!" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: cmd/build.py:144 +#: cmd/build.py:64 msgid "job number should be a positive number" msgstr "कार्य संख्या एक धनात्मक संख्या होनी चाहिए" -#: cmd/build.py:154 +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" + +#: cmd/build.py:74 msgid "" "\n" "Generate documentation from source files.\n" @@ -1343,675 +1644,589 @@ msgid "" "files can be built by specifying individual filenames.\n" msgstr "" -#: cmd/build.py:180 +#: cmd/build.py:100 msgid "path to documentation source files" msgstr "अभिलेख की स्रोत फाइलों का पथ" -#: cmd/build.py:183 +#: cmd/build.py:103 msgid "path to output directory" msgstr "परिणाम निर्देशिका का पथ" -#: cmd/build.py:188 +#: cmd/build.py:109 msgid "" "(optional) a list of specific files to rebuild. Ignored if --write-all is " "specified" msgstr "" -#: cmd/build.py:194 +#: cmd/build.py:114 msgid "general options" msgstr "सामान्य विकल्प" -#: cmd/build.py:201 +#: cmd/build.py:121 msgid "builder to use (default: 'html')" msgstr "" -#: cmd/build.py:210 +#: cmd/build.py:131 msgid "" "run in parallel with N processes, when possible. 'auto' uses the number of " "CPU cores" msgstr "" -#: cmd/build.py:220 +#: cmd/build.py:140 msgid "write all files (default: only write new and changed files)" msgstr "सभी फाइलें लिखें (मानक: केवल नई और परिवर्तित फाइलें लिखें)" -#: cmd/build.py:227 +#: cmd/build.py:147 msgid "don't use a saved environment, always read all files" msgstr "सहेजी गयी परिस्थिति का प्रयोग न करें, सदैव सभी फाइलों को पढ़ें" -#: cmd/build.py:230 +#: cmd/build.py:150 msgid "path options" msgstr "" -#: cmd/build.py:236 +#: cmd/build.py:157 msgid "" "directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: cmd/build.py:246 +#: cmd/build.py:166 msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: cmd/build.py:255 +#: cmd/build.py:175 msgid "use no configuration file, only use settings from -D options" msgstr "" -#: cmd/build.py:264 +#: cmd/build.py:184 msgid "override a setting in configuration file" msgstr "विन्यास फाइल के एक मान का उल्लंघन करें " -#: cmd/build.py:273 +#: cmd/build.py:193 msgid "pass a value into HTML templates" msgstr "एच.टी.एम्.एल. के नमूने में राशि प्रेषित करें" -#: cmd/build.py:282 +#: cmd/build.py:202 msgid "define tag: include \"only\" blocks with TAG" msgstr "नाम-पत्र परिभाषित करें: केवल नाम-पत्र वाले खण्डों का समावेश करें" -#: cmd/build.py:289 +#: cmd/build.py:209 msgid "nitpicky mode: warn about all missing references" msgstr "" -#: cmd/build.py:292 +#: cmd/build.py:212 msgid "console output options" msgstr "प्रदर्शित परिणामों के विकल्प" -#: cmd/build.py:299 +#: cmd/build.py:219 msgid "increase verbosity (can be repeated)" msgstr "शब्द-प्रयोग बढ़ाएं (पुनरावृत्ति की जा सकती है) " -#: cmd/build.py:306 ext/apidoc.py:413 +#: cmd/build.py:226 ext/apidoc/_cli.py:66 msgid "no output on stdout, just warnings on stderr" msgstr "एस.टी.डी आउट #stdout# पर कोई परिणाम नहीं, एस.टी.डी एरर #stderr# पर चेतावनियाँ " -#: cmd/build.py:313 +#: cmd/build.py:233 msgid "no output at all, not even warnings" msgstr "कुछ भी निर्गमित नहीं, यहाँ तक कि चेतावनी भी नहीं" -#: cmd/build.py:321 +#: cmd/build.py:241 msgid "do emit colored output (default: auto-detect)" msgstr "रंगीन परिणाम ही दिखाएँ (मानक: स्वतः अनुमानित)" -#: cmd/build.py:329 +#: cmd/build.py:249 msgid "do not emit colored output (default: auto-detect)" msgstr "रंगीन परिणाम नहीं दिखाएँ (मानक: स्वतः अनुमानित)" -#: cmd/build.py:332 +#: cmd/build.py:252 msgid "warning control options" msgstr "" -#: cmd/build.py:338 +#: cmd/build.py:258 msgid "write warnings (and errors) to given file" msgstr "चेतावनियाँ (और त्रुटियाँ) दी गई फाइल में लिखें" -#: cmd/build.py:345 +#: cmd/build.py:265 msgid "turn warnings into errors" msgstr "चेतावनियों को अशुद्धि मानें" -#: cmd/build.py:353 +#: cmd/build.py:273 msgid "show full traceback on exception" msgstr "अपवाद होने पर पूरा विलोम-अनुगमन देखें" -#: cmd/build.py:356 +#: cmd/build.py:276 msgid "run Pdb on exception" msgstr "अपवाद होने पर पी.डी.बी. चलाएं" -#: cmd/build.py:362 +#: cmd/build.py:282 msgid "raise an exception on warnings" msgstr "" -#: cmd/build.py:405 +#: cmd/build.py:325 msgid "cannot combine -a option and filenames" msgstr "-a विकल्प और फाइल के नामों को सम्मिलित नहीं किया जा सकता" -#: cmd/build.py:437 +#: cmd/build.py:357 #, python-format msgid "cannot open warning file '%s': %s" msgstr "" -#: cmd/build.py:456 +#: cmd/build.py:376 msgid "-D option argument must be in the form name=value" msgstr "-D विकल्प का मान नाम = मान के रूप में होना आवश्यक है" -#: cmd/build.py:463 +#: cmd/build.py:383 msgid "-A option argument must be in the form name=value" msgstr "-A विकल्प का मान नाम = मान के रूप में होना आवश्यक है" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "मूक निर्माता से किसी फाइलों की उत्पत्ति नहीं होती." - -#: builders/linkcheck.py:75 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "उपरोक्त परिणाम में अथवा %(outdir)s /output.txt में त्रुटियाँ ढूँढने का प्रयास " +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "प्रभागों में से डॉक्-स्ट्रिंग स्वतःसम्मिलित करें" -#: builders/linkcheck.py:146 -#, python-format -msgid "broken link: %s (%s)" -msgstr "खंडित कड़ी: %s (%s)" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "डॉक्-टेस्ट अंशों के निर्देश भाग की स्वतः जाँच करें" -#: builders/linkcheck.py:540 -#, python-format -msgid "Anchor '%s' not found" -msgstr "लक्ष्य '%s' नहीं मिला" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "भिन्न परियोजनाओं के स्फिंक्स प्रलेखों का पारस्परिक सम्बन्ध करने दें" -#: builders/linkcheck.py:742 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "वह \"शेष\" प्रविष्टियाँ लिख लें, जिन्हें निर्माण के समय दिखाया या छिपाया जा सकता है" -#: builders/singlehtml.py:37 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "एच.टी.एम्.एल. पृष्ठ %(outdir)sमें है." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "प्रलेखों की व्याप्ति की जाँच करें" -#: builders/singlehtml.py:173 -msgid "assembling single document" -msgstr "एकल लेखपत्र संकलन किया जा रहा है" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "गणित को सम्मिलित करें, पी.एन.जी. अथवा एस.वी.जी. में चित्रित" -#: builders/latex/__init__.py:346 builders/manpage.py:56 -#: builders/singlehtml.py:178 builders/texinfo.py:121 -msgid "writing" -msgstr "लिखा जा रहा है" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "गणित को सम्मिलित करें, दिग्दर्शक में मैथजाक्स #MathJax# द्वारा प्रदर्शित" -#: builders/singlehtml.py:191 -msgid "writing additional files" -msgstr "अतिरिक्त फाइलों को लिखा जा रहा है" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "विन्यास मान के आधार पर सामिग्री का सशर्त समावेश" -#: builders/manpage.py:39 -#, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "पुस्तिका पृष्ठ %(outdir)sमें हैं." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "पाइथन विषयवस्तुओं के प्रलेखों के स्रोत निर्देश की कड़ी जोड़ें" -#: builders/manpage.py:47 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "कोई \"man_pages\" विन्यास मान नहीं मिला; कोई नियमावली पृष्ठ नहीं लिखे जाएंगे" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "गिटहब GitHub पर लेखपत्र प्रकाशित करने के लिए .nojekyll फाइल बनाएं" -#: builders/manpage.py:73 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "\"man_pages\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "कृपया एक मान्य पथ का नाम दें" -#: builders/text.py:34 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "पाठ फाइल %(outdir)s में हैं." +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "कृपया कुछ वाक्यांश लिखें" -#: builders/html/__init__.py:1239 builders/text.py:81 builders/xml.py:97 +#: cmd/quickstart.py:134 #, python-format -msgid "error writing file %s: %s" -msgstr "%s फाइल लिखने में व्यवधान: %s" +msgid "Please enter one of %s." +msgstr "%s में से एक चुनें" -#: builders/xml.py:38 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं." +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "कृपया हाँ के लिए 'y' अथवा नहीं के लिए 'n' मात्र दें. " -#: builders/xml.py:110 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "छद्म-एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "कृपया एक फाइल प्रत्यय दें, जैसे कि '.rst' अथवा '.txt'." -#: builders/texinfo.py:47 +#: cmd/quickstart.py:230 #, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "टेक्सइन्फो पृष्ठ %(outdir)sमें हैं." +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "स्फिंक्स %s त्वरित-आरंभ #sphinx-quickstart# उपकरण के लिए अभिनन्दन" -#: builders/texinfo.py:49 +#: cmd/quickstart.py:235 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nइन्हें मेकइन्फो से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें\n(ऐसा स्वचालित रूप से करने के लिए यहाँ 'मेक इन्फो' आदेश का उपयोग करें)" - -#: builders/texinfo.py:78 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "कोई \"texinfo_documents\" विन्यास मान नहीं मिला; कोई लेखपत्र नहीं लिखे जाएंगे" - -#: builders/texinfo.py:90 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "\"texinfo_documents\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "कृपया निम्न विन्यासों के लिए मान प्रदान करें (मानक मान, यदि कोष्ठक में हो तो, स्वीकार करने के लिए एन्टर दबाएँ)" -#: builders/latex/__init__.py:324 builders/texinfo.py:115 +#: cmd/quickstart.py:242 #, python-format -msgid "processing %s" -msgstr "%s की प्रक्रिया जारी" - -#: builders/latex/__init__.py:404 builders/texinfo.py:174 -msgid "resolving references..." -msgstr "सन्दर्भों का विश्लेषण किया जा रहा है..." - -#: builders/latex/__init__.py:415 builders/texinfo.py:184 -msgid " (in " -msgstr " (में" +msgid "Selected root path: %s" +msgstr "चुना हुआ बुनियादी तथा मूल स्थान: %s" -#: builders/_epub_base.py:423 builders/html/__init__.py:778 -#: builders/latex/__init__.py:482 builders/texinfo.py:202 -msgid "copying images... " -msgstr "चित्रों की प्रतिलिपि बनाई जा रही है..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "आलेख का बुनियादी स्थान बताएं." -#: builders/_epub_base.py:445 builders/latex/__init__.py:497 -#: builders/texinfo.py:219 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "चित्रलेख फाइल %r की प्रतिलिपि नहीं की जा सकी:%s" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "आलेख का बुनियादी पथ" -#: builders/texinfo.py:226 -msgid "copying Texinfo support files" -msgstr "टेक्सइन्फो सहायक फाइलों की प्रतिलिपि की जा रही है..." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "त्रुटि: एक मौजूदा conf.py फाइल दिए गए मूल पथ में प्राप्त हुई है." -#: builders/texinfo.py:234 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "मेकफाइल लिखने में त्रुटि: %s" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "स्फिंक्स-त्वरित-आरम्भ #sphinx-quickstart# मौजूदा स्फिंक्स परियोजनाओं पर पुनर्लेखन नहीं करेगा." -#: builders/gettext.py:230 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "सन्देश सूचीपत्र %(outdir)s में हैं." +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "कृपया एक नया मूल पथ दें (अथवा निकलने हेतु सिर्फ एन्टर #Enter# कर दें)" -#: builders/__init__.py:383 builders/gettext.py:251 -#, python-format -msgid "building [%s]: " -msgstr "निर्माणाधीन [%s]: " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "आपके पास Sphinx द्वारा बनाई गई फाइलों को सहेजने के लिए दो विकल्प हैं.\nया तो आप मूल स्थान में ही \"_build\" निर्देशिका प्रयोग करें, अथवा\nमूल पथ में भिन्न \"स्रोत\" और \"build\" निर्देशिका प्रयोग करें." -#: builders/gettext.py:252 -#, python-format -msgid "targets for %d template files" -msgstr "%d नमूना फाइलों के लक्ष्य" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "विभिन्न स्रोत और निर्माण डायरेक्टरी (y/n)" -#: builders/gettext.py:257 -msgid "reading templates... " -msgstr "नमूनों को पढ़ा जा रहा है..." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "मूल निर्देशिका के अन्दर, दो और निर्देशिका बनाई जाएँगी;\nपरिवर्धित एच.टी.एम्.एल. नमूनों के लिए \"_templates\" और परिवर्धित रुपपत्रों और अन्य स्थैतिक फाइलों के लिए \"_static\"\nआप अधोरेखा के स्थान पर अन्य पूर्व-प्रत्यय (जैसे कि \".\") का प्रयोग कर सकते हैं." -#: builders/gettext.py:292 -msgid "writing message catalogs... " -msgstr "सन्देश सूचीपत्रों को लिखा जा रहा है..." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "नमूने और स्थैतिक डायरेक्टरी के लिए पूर्व-प्रत्यय" -#: builders/__init__.py:212 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "%s निर्माता के लिए योग्य चित्र नहीं मिला: %s.(%s)" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "परियोजना का नाम बनाये गए प्रपत्रों में बहुत से स्थानों पर प्रयुक्त होगा." -#: builders/__init__.py:220 -#, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "%s निर्माता के लिए योग्य चित्र नहीं मिला: %s" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "परियोजना का नाम" -#: builders/__init__.py:243 -msgid "building [mo]: " -msgstr "निर्माणाधीन [mo]: " +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "लेखक(कों) का नाम" -#: builders/__init__.py:246 builders/__init__.py:741 builders/__init__.py:773 -msgid "writing output... " -msgstr "परिणाम लिखा जा रहा है..." +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "" -#: builders/__init__.py:263 -#, python-format -msgid "all of %d po files" -msgstr "सभी %d पी.ओ. फाइलें" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "परियोजना संस्करण" -#: builders/__init__.py:285 -#, python-format -msgid "targets for %d po files that are specified" -msgstr "निर्दिष्ट %d पी.ओ. फाइलों के लक्ष्य" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "परियोजना आवृत्ति" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are out of date" -msgstr "%d पी.ओ. फाइलों के लक्ष्य कालातीत है" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "यदि प्रलेखों को अंग्रेजी के अलावा अन्य किसी भाषा में लिखा जाना है,\nतो यहाँ पर आप भाषा का कूटशब्द दे सकते हैं. स्फिंक्स तदपुरांत,\nजो वाक्यांश बनाता है उसे उस भाषा में अनुवादित करेगा.\n\nमान्य भाषा कूटशब्द सूची यहाँ पर देखें\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: builders/__init__.py:307 -msgid "all source files" -msgstr "सभी स्रोत फाइलें" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "परियोजना की भाषा" -#: builders/__init__.py:319 -#, python-format -msgid "file %r given on command line does not exist, " +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: builders/__init__.py:325 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "आदेश स्थान में दी गयी फाइल %r स्रोत निर्देशिका में नहीं है, उपेक्षा की जा रही है" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "स्रोत फाइल का प्रत्यय" -#: builders/__init__.py:336 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: builders/__init__.py:351 +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "आपने मुख्य लेखपत्र का नाम दें (प्रत्यय रहित)" + +#: cmd/quickstart.py:368 #, python-format -msgid "%d source files given on command line" -msgstr "%d स्रोत फाइलें आदेश स्थान में दी " +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "त्रुटि: मुख्य फाइल %s चुने हुए मूल पथ में पहले से उपलब्ध है." -#: builders/__init__.py:366 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "%d फाइलों के लक्ष्य कालातीत है" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "स्फिंक्स-त्वरित-आरम्भ मौजूदा फाइलों पर पुनर्लेखन नहीं करेगा." -#: builders/__init__.py:394 -msgid "looking for now-outdated files... " -msgstr "अप्रचलित फाइलों को चिन्हित किया जा रहा है..." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "कृपया एक नया फाइल नाम दें, अथवा मौजूदा फाइल का पुनर्नामकरण करें और एन्टर दबाएँ" -#: builders/__init__.py:398 -#, python-format -msgid "%d found" -msgstr "%d मिला" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "इनमें से कौन सा स्फिंक्स आयाम प्रयोग करना है, इंगित करें:" -#: builders/__init__.py:400 -msgid "none found" -msgstr "एक भी नहीं मिला" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "टिप्पणी: imgmath और mathjax एक साथ समर्थ नहीं हो सकते. imgmath को अचिन्हित कर दिया गया है." -#: builders/__init__.py:407 -msgid "pickling environment" -msgstr "स्थिति को परिरक्षित किया जा रहा है" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "" -#: builders/__init__.py:414 -msgid "checking consistency" -msgstr "संगतता की जांच की जा रही है" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "मेकफाइल बनाएं? (हाँ के लिए y/ ना के लिए n)" -#: builders/__init__.py:418 -msgid "no targets are out of date." -msgstr "कोई प्रयोजन कालातीत नहीं है" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "विंडोज़ कमांड फाइल बनाएं? (हाँ के लिए y/ ना के लिए n)" -#: builders/__init__.py:458 -msgid "updating environment: " -msgstr "स्थिति का नवीनीकरण किया जा रहा है" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." +msgstr "फाइल बनाई जा रही है ...%s" -#: builders/__init__.py:483 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s जोड़ा गया, %s बदला गया, %s हटाया गया" +msgid "File %s already exists, skipping." +msgstr "फाइल %s पहले से उपस्थित है, छोड़ दी गई." + +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "समाप्त: एक प्रारंभिक निर्देशिका का ढांचा बना दिया गया है." -#: builders/__init__.py:519 +#: cmd/quickstart.py:520 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: builders/__init__.py:528 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: builders/__init__.py:539 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: builders/__init__.py:546 -#, python-format +#: cmd/quickstart.py:538 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: builders/__init__.py:565 builders/__init__.py:581 -msgid "reading sources... " -msgstr "स्रोतों को पढ़ा जा रहा है..." - -#: builders/__init__.py:698 -#, python-format -msgid "docnames to write: %s" -msgstr "लेखन के लिए शेष लेखपत्र: %s" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nस्फिंक्स परियोजना के लिए आवश्यक फाइल बनाएं.\n\nस्फिंक्स-त्वरित-आरम्भ एक संवादपूर्ण उपकरण है जो आपकी परियोजना के \nबारे में कुछ प्रश्न पूछकर पूरी प्रलेखों की निर्देशिका और नमूना मेकफाइल \nबना देता है जिसे स्फिंक्स-बिल्ड में प्रयोग किया जा सकता है.\n" -#: builders/__init__.py:711 -msgid "preparing documents" -msgstr "लेखपत्र बनाए जा रहे हैं" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "शांत ढंग " -#: builders/__init__.py:714 -msgid "copying assets" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: builders/__init__.py:866 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "असाधनीय स्रोत अक्षर, \"?\" द्वारा बदले जा रहे हैं: %r" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "ढांचे के विकल्प" -#: builders/epub3.py:83 -#, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "ई-पब फाइल %(outdir)s में है." +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "यदि निर्दिष्ट हो तो विभिन्न स्रोत और निर्माण पथ" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: builders/epub3.py:220 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "ई-पब3 के लिए विन्यास मान \"epub_language\" (अथवा \"language\") खाली नहीं होना चाहिए" - -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "ई-पब3 के लिए विन्यास मान \"epub_uid\" एक्स.एम्.एल. नाम होना चाहिए" - -#: builders/epub3.py:231 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "ई-पब3 के लिए विन्यास मान \"epub_title\" (अथवा \"html_title\") खाली नहीं होना चाहिए" - -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "ई-पब3 के लिए विन्यास मान \"epub_author\" खाली नहीं होना चाहिए" - -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "ई-पब3 के लिए विन्यास मान \"epub_contributor\" खाली नहीं होना चाहिए" - -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "ई-पब3 के लिए विन्यास मान \"epub_description\" खाली नहीं होना चाहिए" - -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "ई-पब3 के लिए विन्यास मान \"epub_publisher\" खाली नहीं होना चाहिए" - -#: builders/epub3.py:255 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "ई-पब3 के लिए विन्यास मान \"epub_copyright\" (अथवा \"copyright\") खाली नहीं होना चाहिए" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "_templates आदि में बिंदु का बदलाव" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "ई-पब3 के लिए विन्यास मान \"epub_identifier\" खाली नहीं होना चाहिए" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "परोयोजना के मूलभूत विकल्प" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "ई-पब3 के लिए विन्यास मान \"version\" खाली नहीं होना चाहिए" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "परियोजना का नाम" -#: builders/epub3.py:279 builders/html/__init__.py:1289 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "अमान्य css_file: %r, उपेक्षित" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "लेखकों के नाम" -#: builders/_epub_base.py:222 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "विषय-सूची प्रविष्टि की प्रतिलिपि पायी गई: %s" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "परियोजना का संस्करण" -#: builders/_epub_base.py:434 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "चित्रलेख फाइल %r नहीं पढ़ा जा सका: इसकी प्रतिलिपि बनाई जा रही है" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "परियोजना की आवृत्ति" -#: builders/_epub_base.py:465 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "चित्रलेख फाइल %r नहीं लिखा जा सका:%s" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "लेखपत्र की भाषा" -#: builders/_epub_base.py:477 -msgid "Pillow not found - copying image files" -msgstr "पिलो नहीं मिला - चित्र फाइलों की प्रतिलिपि बनाई जा रही है" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "स्रोत फाइल का प्रत्यय" -#: builders/_epub_base.py:512 -msgid "writing mimetype file..." -msgstr "" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "मुख्य लेखपत्र का नाम" -#: builders/_epub_base.py:521 -msgid "writing META-INF/container.xml file..." -msgstr "" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "ई-पब प्रयोग करें" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "आयाम के विकल्प" -#: builders/_epub_base.py:590 +#: cmd/quickstart.py:671 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "%s के लिए अज्ञात लेख प्रकार, छोड़ा गया" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "" +msgid "enable %s extension" +msgstr "आयाम %s सक्षम करें" -#: builders/_epub_base.py:764 -msgid "writing toc.ncx file..." -msgstr "" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "स्वेच्छित आयाम सक्षम करें" -#: builders/_epub_base.py:793 -#, python-format -msgid "writing %s file..." -msgstr "%s फाइल को लिखा जा रहा है..." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "मेकफाइल और बैचफाइल का सर्जन" -#: builders/changes.py:33 -#, python-format -msgid "The overview file is in %(outdir)s." -msgstr "संक्षिप्त विवरण फाइल %(outdir)s में है." +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "मेकफाइल बनाएं" -#: builders/changes.py:60 -#, python-format -msgid "no changes in version %s." -msgstr "%s संस्करण में कोई परिवर्तन नहीं हैं." +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "मेकफाइल नहीं बनाएं" -#: builders/changes.py:62 -msgid "writing summary file..." -msgstr "सार फाइल को लिखा जा रहा है..." +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "बैचफाइल बनाएं" -#: builders/changes.py:74 -msgid "Builtins" -msgstr "अंतर्निर्मित" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "बैचफाइल नहीं बनाएं" -#: builders/changes.py:76 -msgid "Module level" -msgstr "प्रभाग स्तर" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "Makefile/make.bat के लिए make-mode का प्रयोग करें" -#: builders/changes.py:128 -msgid "copying source files..." -msgstr "स्रोत फाइलों की प्रतिलिपि बनाई जा रही है..." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "परियोजना नमूनावृत्ति" -#: builders/changes.py:137 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "परिवर्तन सूची बनाने के लिए %r को नहीं पढ़ा जा सका" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "नमूना फाइलों के लिए नमूना निर्देशिका" -#: util/rst.py:72 -#, python-format -msgid "default role %s not found" -msgstr "मानक भूमिका '%s' नहीं मिली" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "नमूना चर-पद का निरूपण करें" -#: util/docfields.py:95 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "\"शांत\" निर्दिष्ट है, परन्तु कोई भी \"परियोजना\" अथवा \"लेखक\" निर्दिष्ट नहीं है." -#: util/osutil.py:130 -#, python-format +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "त्रुटि: दिया गया पथ निर्देशिका नहीं है, अथवा स्फिंक्स फाइलें पहले से उपस्थित हैं." -#: util/nodes.py:419 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" - -#: util/nodes.py:487 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "विषय-सूची-संरचना में अविद्यमान फाइल %r का सन्दर्भ है" - -#: util/nodes.py:701 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "केवल निर्देशक भाव का मूल्यांकन करते समय अपवाद: %s" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "स्फिंक्स-त्वरित-आरम्भ केवल एक खाली निर्देशिका में कार्यशील हो सकती है. कृपया एक नया मूल पथ निर्दिष्ट करें." -#: util/fileutil.py:74 +#: cmd/quickstart.py:810 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +msgid "Invalid template variable: %s" +msgstr "अमान्य नमूना चर-पद: %s" -#: util/fileutil.py:89 +#: directives/other.py:119 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/inventory.py:170 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" +msgid "toctree contains reference to excluded document %r" +msgstr "विषय-सूची-संरचना में छोड़े गए लेखपत्र %r का सन्दर्भ है" -#: util/inventory.py:185 +#: directives/other.py:156 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" +msgid "toctree contains reference to nonexisting document %r" +msgstr "विषय-सूची-संरचना में अविद्यमान लेखपत्र %r का सन्दर्भ है" -#: util/docutils.py:284 +#: directives/other.py:169 #, python-format -msgid "unknown directive or role name: %s:%s" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/docutils.py:747 -#, python-format -msgid "unknown node type: %r" -msgstr "अज्ञात बिंदु प्रकार: %r" - -#: util/display.py:81 -msgid "skipped" -msgstr "छोड़ा " +#: directives/other.py:203 +msgid "Section author: " +msgstr "भाग के लेखक:" -#: util/display.py:86 -msgid "failed" -msgstr "असफल" +#: directives/other.py:205 +msgid "Module author: " +msgstr "प्रभाग लेखक:" -#: util/i18n.py:103 -#, python-format -msgid "reading error: %s, %s" -msgstr "अशुद्धि पाठन: %s, %s" +#: directives/other.py:207 +msgid "Code author: " +msgstr "निर्देश लेखक:" -#: util/i18n.py:110 -#, python-format -msgid "writing error: %s, %s" -msgstr "अशुद्धि लेखन: %s, %s" +#: directives/other.py:209 +msgid "Author: " +msgstr "लेखक:" -#: util/i18n.py:138 -#, python-format -msgid "locale_dir %s does not exist" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/i18n.py:230 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "अमान्य तिथि प्रारूप. यदि आप सीधे परिणाम में दर्शाना चाहते हैं तो अक्षरमाला को एकाकी उद्धरण चिन्ह द्वारा चिन्हित करें: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" -#: directives/patches.py:66 +#: directives/patches.py:70 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." @@ -2026,7 +2241,7 @@ msgstr "" msgid "Invalid caption: %s" msgstr "अमान्य शीर्षक: %s" -#: directives/code.py:132 directives/code.py:297 directives/code.py:484 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "पंक्ति संख्या का ब्यौरा सीमा से बाहर है (1-%d): %r" @@ -2041,7 +2256,7 @@ msgstr "दोनों \"%s\" और \"%s\" विकल्पों का प msgid "Include file '%s' not found or reading it failed" msgstr "" -#: directives/code.py:234 +#: directives/code.py:235 #, python-format msgid "" "Encoding %r used for reading included file '%s' seems to be wrong, try " @@ -2062,2056 +2277,2032 @@ msgstr "\"lineno-match\" का प्रयोग बिना जुडी \"l msgid "Line spec %r: no lines pulled from include file %r" msgstr "लाइन ब्यौरा %r: सम्मिलित फाइल %r से कोई लाइन नहीं ली जा सकीं" -#: directives/other.py:122 -#, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "" - -#: directives/other.py:155 environment/adapters/toctree.py:355 -#, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "विषय-सूची-संरचना में छोड़े गए लेखपत्र %r का सन्दर्भ है" - -#: directives/other.py:158 environment/adapters/toctree.py:359 -#, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "विषय-सूची-संरचना में अविद्यमान लेखपत्र %r का सन्दर्भ है" - -#: directives/other.py:171 -#, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:204 -msgid "Section author: " -msgstr "भाग के लेखक:" - -#: directives/other.py:206 -msgid "Module author: " -msgstr "प्रभाग लेखक:" - -#: directives/other.py:208 -msgid "Code author: " -msgstr "निर्देश लेखक:" - -#: directives/other.py:210 -msgid "Author: " -msgstr "लेखक:" - -#: directives/other.py:284 -msgid ".. acks content is not a list" -msgstr "" - -#: directives/other.py:309 -msgid ".. hlist content is not a list" -msgstr "" - -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" - -#: _cli/__init__.py:75 -msgid "{0} [OPTIONS] []" -msgstr "" - -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" - -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" - -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" - -#: _cli/__init__.py:112 _cli/__init__.py:183 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" - -#: _cli/__init__.py:172 -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:182 -msgid " Manage documentation with Sphinx." -msgstr "" - -#: _cli/__init__.py:194 -msgid "Show the version and exit." -msgstr "" - -#: _cli/__init__.py:202 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:206 -msgid "Logging" -msgstr "" - -#: _cli/__init__.py:213 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:221 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:228 -msgid "No output at all" -msgstr "" - -#: _cli/__init__.py:234 -msgid "" -msgstr "" - -#: _cli/__init__.py:265 -msgid "See 'sphinx --help'.\n" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:198 -#: transforms/__init__.py:133 writers/manpage.py:102 writers/texinfo.py:219 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" -#: transforms/__init__.py:143 -msgid "could not calculate translation progress!" -msgstr "" - -#: transforms/__init__.py:148 -msgid "no translated elements!" -msgstr "" - -#: transforms/__init__.py:267 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "4 पंक्तिबद्ध सूचियाँ मिलीं. यह आपके द्वारा उपयोग किए गए आयाम की त्रुटि हो सकती है: %r" - -#: transforms/__init__.py:313 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "पाद-टिप्पणी [%s] का कोई सन्दर्भ नहीं है." - -#: transforms/__init__.py:322 -msgid "Footnote [*] is not referenced." -msgstr "" - -#: transforms/__init__.py:333 -msgid "Footnote [#] is not referenced." -msgstr "पाद-टिप्पणी [#] सन्दर्भ कहीं नहीं है" - -#: transforms/i18n.py:228 transforms/i18n.py:303 -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "अनुवादित संदेश में असंगत पाद-टिप्पणी के प्रसंग. मूल: {0}, अनुवादित: {1}" - -#: transforms/i18n.py:273 -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "अनुवादित संदेश में असंगत प्रसंग. मूल: {0}, अनुवादित: {1}" - -#: transforms/i18n.py:323 -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "अनुवादित संदेश में असंगत उद्धरण के प्रसंग. मूल: {0}, अनुवादित: {1}" - -#: transforms/i18n.py:345 -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "अनुवादित संदेश में असंगत शब्द के प्रसंग. मूल: {0}, अनुवादित: {1}" - -#: ext/linkcode.py:75 ext/viewcode.py:201 -msgid "[source]" -msgstr "[स्रोत]" - -#: ext/imgconverter.py:40 -#, python-format -msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "अनुक्रमणिका" -#: ext/imgconverter.py:49 ext/imgconverter.py:73 -#, python-format +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "परिवर्तक त्रुटि के साथ बहार आ गया:\n[stderr]\n%r\n[stdout]\n%r" - -#: ext/imgconverter.py:68 -#, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "" - -#: ext/viewcode.py:258 -msgid "highlighting module code... " -msgstr "प्रभाग निर्देश विशिष्ट रूप से दर्शाया जा रहा है..." - -#: ext/viewcode.py:286 -msgid "[docs]" -msgstr "[docs]" - -#: ext/viewcode.py:306 -msgid "Module code" -msgstr "प्रभाग निर्देश" - -#: ext/viewcode.py:312 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        %s का स्रोत निर्देश

        " +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "पाया गया शीर्ष बिंदु किसी भाग, प्रसंग, तालिका, विषय-प्रबोध अथवा पार्श्व-स्थान में नहीं है" -#: ext/viewcode.py:338 -msgid "Overview: module code" -msgstr "सिंहावलोकन: प्रभाग निर्देश" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "पाद टिप्पणियां" -#: ext/viewcode.py:339 -msgid "

        All modules for which code is available

        " -msgstr "

        सभी प्रभाग जिनके लिए निर्देश उपलब्ध है

        " +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "शीर्षक रेखाचित्र के भीतर नहीं है" -#: ext/coverage.py:47 +#: writers/texinfo.py:1303 #, python-format -msgid "invalid regex %r in %s" -msgstr "अमान्य रेगएक्स #regex# %r, %s में " +msgid "unimplemented node type: %r" +msgstr "अकार्यान्वित बिंदु प्रकार: %r" -#: ext/coverage.py:134 ext/coverage.py:280 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "module %s could not be imported: %s" -msgstr "प्रभाग %s का आयत नहीं किया जा सका: %s" +msgid "[image: %s]" +msgstr "[चित्र: %s]" -#: ext/coverage.py:141 -#, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[चित्र]" -#: ext/coverage.py:149 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: ext/coverage.py:163 +#: writers/html5.py:431 #, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." -msgstr "स्रोतों की व्यापकता की जांच पूरी, परिणाम %(outdir)spython.txt में देखें. " +msgid "numfig_format is not defined for %s" +msgstr "%s के लिए नमफिग_फॉर्मेट नहीं बताया गया है" -#: ext/coverage.py:177 +#: writers/html5.py:441 #, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "अमान्य रेगएक्स #regex# %r, coverage_c_regexes में " +msgid "Any IDs not assigned for %s node" +msgstr "%s बिंदु के लिए कोई पहचान-चिन्ह नहीं दिया गया" + +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" -#: ext/coverage.py:245 -#, python-format -msgid "undocumented c api: %s [%s] in file %s" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: ext/coverage.py:429 -#, python-format -msgid "undocumented python function: %s :: %s" +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: ext/coverage.py:445 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "undocumented python class: %s :: %s" +msgid "unsupported rubric heading level: %s" msgstr "" -#: ext/coverage.py:458 -#, python-format -msgid "undocumented python method: %s :: %s :: %s" +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: ext/todo.py:71 -msgid "Todo" -msgstr "अपूर्ण " +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" -#: ext/todo.py:104 -#, python-format -msgid "TODO entry found: %s" -msgstr "अपूर्ण प्रविष्टि मिली: %s " +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" -#: ext/todo.py:163 -msgid "<>" -msgstr "<<मूल प्रविष्टि>>" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "चित्र का आकार नहीं मिल सका. :scale: विकल्प की उपेक्षा की जा रही है." -#: ext/todo.py:165 +#: writers/latex.py:386 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<<मूल प्रविष्टि>> %s, पंक्ति %d में उपस्थित है.)" - -#: ext/todo.py:175 -msgid "original entry" -msgstr "मौलिक प्रविष्टि" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "अज्ञात %r उच्चतमस्तर_विभाजन #toplevel_sectioning# %r वर्ग के लिए" -#: ext/extlinks.py:82 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "" +msgid "no Babel option known for language %r" +msgstr "%r भाषा के लिए कोई बाबेल विकल्प नहीं " -#: ext/doctest.py:115 -#, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "'%s' विकल्प में अनुपस्थित '+' या '-'." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "अत्याधिक अधिकतम गहराई # :maxdepth: #, उपेक्षित किया गया." -#: ext/doctest.py:120 +#: writers/latex.py:616 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' एक मान्य विकल्प नहीं है." +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: ext/doctest.py:134 -#, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' एक मान्य पाईवर्शन #pyversion# विकल्प नहीं है. " +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "लेखपत्र का शीर्षक एकल पाठ बिंदु नहीं है" -#: ext/doctest.py:220 -msgid "invalid TestCode type" -msgstr "अमान्य टेस्टकोड का प्रकार " +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "दोनों तालिका-स्तंभ और :चौड़ाई: विकल्प दिए गए हैं. :चौड़ाई: मान की उपेक्षा की जाएगी." -#: ext/doctest.py:281 +#: writers/latex.py:1228 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "स्रोतों में डॉकटेस्ट्स की जांच पूरी, परिणाम %(outdir)s/output.txt में देखें. " +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: ext/doctest.py:434 +#: writers/latex.py:1615 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "%s भाग में %s पर कोई निर्देश / परिणाम नहीं: %s" +msgid "dimension unit %s is invalid. Ignored." +msgstr "परिमाण मात्रक %s अमान्य है. उपेक्षा की जाएगी." -#: ext/doctest.py:522 +#: writers/latex.py:1950 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "अमान्य डॉकटेस्ट निर्देश की उपेक्षा की जा रही है: %r" +msgid "unknown index entry type %s found" +msgstr "अनुक्रमणिका की प्रविष्टि का प्रकार %s मिला" -#: ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" -msgstr "ग्राफविज़ निर्देश में दोनों मापदंड, विषय-वस्तु और फाइल का नाम, नहीं हो सकते" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: ext/graphviz.py:145 -#, python-format -msgid "External Graphviz file %r not found or reading it failed" -msgstr "बाहरी ग्राफविज़ फाइल %r नहीं मिली अथवा पढने में असफलता मिली" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." -msgstr "विषय-वस्तु के बिना ग्राफविज़ निर्देश की उपेक्षा की जा रही है. " +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" -#: ext/graphviz.py:268 -#, python-format -msgid "graphviz_dot executable path must be set! %r" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: ext/graphviz.py:303 -#, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" -msgstr "डॉट निर्देश %r नहीं चलाया जा सकता (ग्राफविज़ परिणाम के लिए आवश्यक), ग्राफविज़_डॉट मान की जांच करें" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "" -#: ext/graphviz.py:310 -#, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "डॉट त्रुटि के साथ बहार आ गया:\n[stderr]\n%r\n[stdout]\n%r" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: ext/graphviz.py:313 -#, python-format +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "डॉट ने किसी परिणाम फाइल का नहीं बनाया:\n[stderr]\n%r\n[stdout]\n%r" - -#: ext/graphviz.py:329 -#, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" -msgstr "ग्राफविज़_आउटपुट_फॉर्मेट का 'पी.एन.जी', 'एस.वी.जी.', होना आवश्यक है, पर यह %r है" - -#: ext/graphviz.py:333 ext/graphviz.py:386 ext/graphviz.py:423 -#, python-format -msgid "dot code %r: %s" -msgstr "डॉट निर्देश %r: %s" - -#: ext/graphviz.py:436 ext/graphviz.py:444 -#, python-format -msgid "[graph: %s]" -msgstr "[graph: %s]" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "" -#: ext/graphviz.py:438 ext/graphviz.py:446 -msgid "[graph]" -msgstr "[graph]" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" -#: ext/imgmath.py:369 ext/mathjax.py:52 -msgid "Link to this equation" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: ext/apidoc.py:85 -#, python-format -msgid "Would create file %s." -msgstr "%s फाइल बन जाएगी." +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: ext/apidoc.py:375 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\n में पाइथन प्रभाग और पैकेज की पुनरावर्तित खोज करें और\nस्वतःप्रभाग निर्देश द्वारा में प्रति पैकेज एक रेस्ट #reST# फाइल बनाएं.\n\n फाइल और/ अथवा निर्देशिका स्वरुप हो सकते हैं\nजो निर्माण प्रकिया में छोड़ दिए जाएंगे.\n\nनोट: सामान्यतया यह स्क्रिप्ट किसी पहले से बनाई गई फाइल पर पुनर्लेखन नहीं करती." +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: ext/apidoc.py:392 -msgid "path to module to document" -msgstr "प्रभाग से लेखपत्र का पथ" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: ext/apidoc.py:396 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "fnmatch-style फाइल और/ अथवा निर्देशिका स्वरुप जो निर्माण प्रक्रिया से छोड़ने हैं" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: ext/apidoc.py:407 -msgid "directory to place all output" -msgstr "सभी परिणामों को सहेजने के लिए निर्देशिका" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: ext/apidoc.py:422 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "विषय-सूची में दिखाए जाने वाले उपप्रभागों की अधिकतम गहराई (मानक: 4)" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: ext/apidoc.py:429 -msgid "overwrite existing files" -msgstr "मौजूदा फाइलों पर पुनर्लेखन करें" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: ext/apidoc.py:437 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "सांकेतिक कड़ियों का अनुसरण करें. कलेक्टिव.रेसिपी.ऑमलेट के साथ प्रभावशाली. " +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "अनुवादित संदेश में असंगत पाद-टिप्पणी के प्रसंग. मूल: {0}, अनुवादित: {1}" -#: ext/apidoc.py:446 -msgid "run the script without creating files" -msgstr "फाइलों को बनाए बिना स्क्रिप्ट चलाएं " +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "अनुवादित संदेश में असंगत प्रसंग. मूल: {0}, अनुवादित: {1}" -#: ext/apidoc.py:453 -msgid "put documentation for each module on its own page" -msgstr "प्रत्येक प्रभाग के आलेख उसके अपने पृष्ठ में रखें" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "अनुवादित संदेश में असंगत उद्धरण के प्रसंग. मूल: {0}, अनुवादित: {1}" -#: ext/apidoc.py:460 -msgid "include \"_private\" modules" -msgstr "\"_private\" प्रभाग को सम्मिलित करें " +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "अनुवादित संदेश में असंगत शब्द के प्रसंग. मूल: {0}, अनुवादित: {1}" -#: ext/apidoc.py:467 -msgid "filename of table of contents (default: modules)" -msgstr "विषय-सूची की फाइल का नाम (मानक: प्रभाग) " +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" -#: ext/apidoc.py:474 -msgid "don't create a table of contents file" -msgstr "विषय-सूची की फाइल न बनाएं " +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" -#: ext/apidoc.py:481 +#: transforms/__init__.py:258 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "प्रभाग/पैकेज पैकेजों का शीर्षक न बनाएं (उदाहरणार्थ, जब डॉकस्ट्रिंग्स में यह पहले से हों) " +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "4 पंक्तिबद्ध सूचियाँ मिलीं. यह आपके द्वारा उपयोग किए गए आयाम की त्रुटि हो सकती है: %r" -#: ext/apidoc.py:492 -msgid "put module documentation before submodule documentation" -msgstr " मुख्य प्रभाग के आलेख को उपप्रभाग के आलेख से पहले रखें" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "पाद-टिप्पणी [%s] का कोई सन्दर्भ नहीं है." -#: ext/apidoc.py:498 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "प्रभाग पथ की व्याख्या 'पी.ई.पी.-0420 निहित नामराशि विवरण' के आधार पर करें " +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" -#: ext/apidoc.py:508 -msgid "file suffix (default: rst)" -msgstr "फाइल प्रत्यय (मानक: rst)" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "पाद-टिप्पणी [#] सन्दर्भ कहीं नहीं है" -#: ext/apidoc.py:515 ext/autosummary/generate.py:839 -msgid "Remove existing files in the output directory that were not generated" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: ext/apidoc.py:524 -msgid "generate a full project with sphinx-quickstart" -msgstr "स्फिंक्स-त्वरित-आरम्भ के साथ पूर्ण परियोजना उत्पन्न करें " +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: ext/apidoc.py:531 -msgid "append module_path to sys.path, used when --full is given" -msgstr "मोड्यूल_पाथ #module_path# को सिस.पाथ #sys.path# में जोड़ें, जब --full दिया जाता है तब इसका प्रयोग होता है " +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "अशुद्धि पाठन: %s, %s" -#: ext/apidoc.py:538 -msgid "project name (default: root module name)" -msgstr "परियोजना का नाम (मानक: मूल प्रभाग का नाम) " +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "अशुद्धि लेखन: %s, %s" -#: ext/apidoc.py:545 -msgid "project author(s), used when --full is given" -msgstr "परियोजना लेखक(गण), जब --full दिया जाता है तब इसका प्रयोग होता है " +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" + +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" + +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "अमान्य तिथि प्रारूप. यदि आप सीधे परिणाम में दर्शाना चाहते हैं तो अक्षरमाला को एकाकी उद्धरण चिन्ह द्वारा चिन्हित करें: %s" -#: ext/apidoc.py:552 -msgid "project version, used when --full is given" -msgstr "परियोजना संस्करण, जब --full दिया जाता है तब इसका प्रयोग होता है " +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "" -#: ext/apidoc.py:559 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "परियोजना आवृत्ति, जब --full दिया जाता है तब इसका प्रयोग होता है " +#: util/display.py:82 +msgid "skipped" +msgstr "छोड़ा " -#: ext/apidoc.py:564 -msgid "extension options" -msgstr "आयाम विकल्प " +#: util/display.py:87 +msgid "failed" +msgstr "असफल" -#: ext/apidoc.py:638 +#: util/docutils.py:325 #, python-format -msgid "%s is not a directory." -msgstr "%s एक निर्देशिका नहीं है. " +msgid "unknown directive name: %s" +msgstr "" -#: ext/apidoc.py:710 ext/autosummary/generate.py:875 +#: util/docutils.py:361 #, python-format -msgid "Failed to remove %s: %s" +msgid "unknown role name: %s" msgstr "" -#: ext/autosectionlabel.py:48 +#: util/docutils.py:805 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "unknown node type: %r" +msgstr "अज्ञात बिंदु प्रकार: %r" + +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: domains/std/__init__.py:703 domains/std/__init__.py:812 -#: ext/autosectionlabel.py:52 +#: util/fileutil.py:89 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है " +msgid "Writing evaluated template result to %s" +msgstr "" -#: ext/duration.py:85 +#: util/docfields.py:103 +#, python-format msgid "" -"====================== slowest reading durations =======================" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: ext/imgmath.py:159 +#: util/rst.py:73 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "लाटेक्स आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). आई.एम्.जी.मैथ_लाटेक्स मान की जाँच करें" +msgid "default role %s not found" +msgstr "मानक भूमिका '%s' नहीं मिली" -#: ext/imgmath.py:174 +#: util/nodes.py:462 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%s आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). imgmath_%s मान की जाँच करें" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: ext/imgmath.py:328 +#: util/nodes.py:523 #, python-format -msgid "display latex %r: %s" -msgstr "लाटेक्स दिखाएँ %r: %s" +msgid "toctree contains ref to nonexisting file %r" +msgstr "विषय-सूची-संरचना में अविद्यमान फाइल %r का सन्दर्भ है" -#: ext/imgmath.py:362 +#: util/nodes.py:739 #, python-format -msgid "inline latex %r: %s" -msgstr "पंक्तिबद्ध लाटेक्स %r: %s" +msgid "exception while evaluating only directive expression: %s" +msgstr "केवल निर्देशक भाव का मूल्यांकन करते समय अपवाद: %s" -#: writers/latex.py:1090 writers/manpage.py:263 writers/texinfo.py:662 -msgid "Footnotes" -msgstr "पाद टिप्पणियां" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "पिछले पृष्ठ से जारी" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "अगले पृष्ठ पर जारी" + +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "अकारादि-क्रमहीन " + +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "संकेत " + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "संख्याएं " -#: writers/manpage.py:309 writers/text.py:936 +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "पृष्ठ" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "आवृत्ति" + +#: transforms/post_transforms/images.py:79 #, python-format -msgid "[image: %s]" -msgstr "[चित्र: %s]" +msgid "Could not fetch remote image: %s [%s]" +msgstr "दूरस्थ चित्र नहीं लाया जा सका: %s [%s]" -#: writers/manpage.py:310 writers/text.py:937 -msgid "[image]" -msgstr "[चित्र]" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "दूरस्थ चित्र नहीं लाया जा सका: %s [%d]" -#: writers/html5.py:99 writers/html5.py:108 -msgid "Link to this definition" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "अज्ञात चित्र प्रारूप: %s..." + +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: writers/html5.py:415 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "numfig_format is not defined for %s" -msgstr "%s के लिए नमफिग_फॉर्मेट नहीं बताया गया है" +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "किसी भी पारस्परिक-सन्दर्भ के लिए एक से अधिक लक्ष्य मिले %r: %s संभव" -#: writers/html5.py:427 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "Any IDs not assigned for %s node" -msgstr "%s बिंदु के लिए कोई पहचान-चिन्ह नहीं दिया गया" - -#: writers/html5.py:482 -msgid "Link to this term" +msgid "%s:%s reference target not found: %s" msgstr "" -#: writers/html5.py:525 writers/html5.py:530 -msgid "Link to this heading" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: writers/html5.py:535 -msgid "Link to this table" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "कार्य खंडित " + +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: writers/html5.py:549 writers/latex.py:1099 -#, python-format -msgid "unsupported rubric heading level: %s" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: writers/html5.py:613 -msgid "Link to this code" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: writers/html5.py:615 -msgid "Link to this image" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: writers/html5.py:617 -msgid "Link to this toctree" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: writers/html5.py:758 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "चित्र का आकार नहीं मिल सका. :scale: विकल्प की उपेक्षा की जा रही है." +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "" -#: builders/latex/__init__.py:205 domains/std/__init__.py:646 -#: domains/std/__init__.py:658 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:513 -msgid "Index" -msgstr "अनुक्रमणिका" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "" -#: writers/latex.py:743 writers/texinfo.py:644 +#: _cli/util/errors.py:246 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "पाया गया शीर्ष बिंदु किसी भाग, प्रसंग, तालिका, विषय-प्रबोध अथवा पार्श्व-स्थान में नहीं है" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "यदि यह प्रयोक्ता की गलती थी तो कृपया इसको भी रिपोर्ट करें ताकि अगली बार गलती होने पर अधिक अर्थपूर्ण सन्देश दिया जा सके." -#: writers/texinfo.py:1216 -msgid "caption not inside a figure." -msgstr "शीर्षक रेखाचित्र के भीतर नहीं है" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "किनारे का स्थान घटाएं" -#: writers/texinfo.py:1302 +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "संचालन" + +#: themes/basic/layout.html:115 #, python-format -msgid "unimplemented node type: %r" -msgstr "अकार्यान्वित बिंदु प्रकार: %r" +msgid "Search within %(docstitle)s" +msgstr "%(docstitle)s में खोजें" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "इन लेखपत्रों के बारे में" + +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "खोज" + +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "सर्वाधिकार" -#: writers/latex.py:360 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "अज्ञात %r उच्चतमस्तर_विभाजन #toplevel_sectioning# %r वर्ग के लिए" +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" -#: builders/latex/__init__.py:223 writers/latex.py:410 +#: themes/basic/layout.html:201 #, python-format -msgid "no Babel option known for language %r" -msgstr "%r भाषा के लिए कोई बाबेल विकल्प नहीं " +msgid "Last updated on %(last_updated)s." +msgstr "अंतिम बार सम्पादित %(last_updated)s." -#: writers/latex.py:428 -msgid "too large :maxdepth:, ignored." -msgstr "अत्याधिक अधिकतम गहराई # :maxdepth: #, उपेक्षित किया गया." +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "पिछला प्रकरण" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "पिछला अध्याय" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "अगला प्रकरण" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "अगला अध्याय" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "एक पृष्ठ पर पूरी अनुक्रमणिका" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "यह पृष्ठ " + +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "स्रोत दिखाएँ" + +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "त्वरित खोज" + +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "चलिए" + +#: themes/basic/defindex.html:4 +msgid "Overview" +msgstr "सिंहावलोकन" + +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" +msgstr "नमस्ते! यह है" + +#: themes/basic/defindex.html:9 +msgid "the documentation for" +msgstr "आलेख विषय" + +#: themes/basic/defindex.html:10 +msgid "last updated" +msgstr "अंतिम परिवर्धन" + +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" +msgstr "सूचियाँ और सारणियाँ:" -#: writers/latex.py:590 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "विस्तृत विषय-सूची" -#: writers/latex.py:708 -msgid "document title is not a single Text node" -msgstr "लेखपत्र का शीर्षक एकल पाठ बिंदु नहीं है" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "सभी अनुभागों एवं उप-अनुभागों की सूची" -#: writers/latex.py:1175 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "दोनों तालिका-स्तंभ और :चौड़ाई: विकल्प दिए गए हैं. :चौड़ाई: मान की उपेक्षा की जाएगी." +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "खोज पृष्ठ" -#: writers/latex.py:1573 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "परिमाण मात्रक %s अमान्य है. उपेक्षा की जाएगी." +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "इस आलेख में खोजें" -#: writers/latex.py:1931 -#, python-format -msgid "unknown index entry type %s found" -msgstr "अनुक्रमणिका की प्रविष्टि का प्रकार %s मिला" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "सार्वभौमिक प्रभाग सूची" -#: domains/std/__init__.py:87 domains/std/__init__.py:104 -#, python-format -msgid "environment variable; %s" -msgstr "परिस्थिति चर पद; %s" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "सभी प्रभाग तक तुरंत पहुँच" -#: domains/std/__init__.py:112 -#, python-format -msgid "%s; configuration value" -msgstr "" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "सामान्य अनुक्रमाणिका" -#: domains/std/__init__.py:166 -msgid "Type" -msgstr "" +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "सभी कार्ययुक्तियां, वर्ग, शब्द" -#: domains/std/__init__.py:176 -msgid "Default" -msgstr "" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "विषय-सूची" -#: domains/std/__init__.py:235 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "अशुद्ध रूप विकल्प विवरण %r, अपेक्षित प्रारूप \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" अथवा \"+opt args\"" +msgid "Search %(docstitle)s" +msgstr " %(docstitle)s में खोजें" -#: domains/std/__init__.py:306 -#, python-format -msgid "%s command line option" -msgstr "" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "अक्षर द्वारा अनुक्रमित पृष्ठ" -#: domains/std/__init__.py:308 -msgid "command line option" -msgstr "" +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "बृहदाकार हो सकता है" -#: domains/std/__init__.py:430 -msgid "glossary term must be preceded by empty line" -msgstr "" +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." +msgstr "खोज कार्य के लिए जावा स्क्रिप्ट का होना आवश्यक है. कृपया जावा स्क्रिप्ट को शुरू करें." -#: domains/std/__init__.py:438 -msgid "glossary terms must not be separated by empty lines" +#: themes/basic/search.html:28 +msgid "" +"Searching for multiple words only shows matches that contain\n" +" all words." msgstr "" -#: domains/std/__init__.py:444 domains/std/__init__.py:457 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" +#: themes/basic/search.html:35 +msgid "search" +msgstr "खोज" -#: domains/std/__init__.py:602 -msgid "glossary term" -msgstr "पारिभाषिक पद" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "विषय सामिग्री" -#: domains/std/__init__.py:603 -msgid "grammar token" -msgstr "व्याकरण संकेत " +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "खोज परीणाम " -#: domains/std/__init__.py:604 -msgid "reference label" -msgstr "सन्दर्भ शीर्षक" +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." +msgstr "आपके खोज परिणामों में कोई प्रलेख नहीं मिला. कृपया सुनिश्चित करें कि सभी शब्दों की वर्तनी शुद्ध है और आपने यथेष्ट श्रेणियां चुनी हैं." -#: domains/std/__init__.py:607 -msgid "environment variable" -msgstr "परिस्थिति चर पद " +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" -#: domains/std/__init__.py:608 -msgid "program option" -msgstr "प्रोग्राम विकल्प " +#: themes/basic/static/searchtools.js:276 +msgid "Searching" +msgstr "खोज जारी" -#: domains/std/__init__.py:609 -msgid "document" -msgstr "लेखपत्र" +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "खोज की तैयारी" -#: domains/std/__init__.py:647 domains/std/__init__.py:659 -msgid "Module Index" -msgstr "प्रभाग सूची" +#: themes/basic/static/searchtools.js:526 +msgid ", in " +msgstr ", में " -#: domains/std/__init__.py:648 domains/std/__init__.py:660 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "खोज पृष्ठ" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "खोजे गए जोड़े छिपाएं" -#: domains/std/__init__.py:722 +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 #, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:932 -msgid "numfig is disabled. :numref: is ignored." -msgstr "numfig असमर्थ है. :numref: उपेक्षित है." +msgid "Changes in Version %(version)s — %(docstitle)s" +msgstr "परिवर्तित संस्करण %(version)s — %(docstitle)s" -#: domains/std/__init__.py:940 +#: themes/basic/changes/rstsource.html:5 #, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" -#: domains/std/__init__.py:952 +#: themes/basic/changes/versionchanges.html:17 #, python-format -msgid "the link has no caption: %s" -msgstr "कड़ी का कोई शीर्षक नहीं है: %s" +msgid "Automatically generated list of changes in version %(version)s" +msgstr "संस्करण %(version)s में स्वतः रचित परिवर्तनों की सूची" -#: domains/std/__init__.py:966 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "अमान्य numfig_format: %s (%r)" +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" +msgstr "पुस्तकालय में परिवर्तन" -#: domains/std/__init__.py:969 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "अमान्य numfig_format: %s" +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" +msgstr "सी ऐ.पी.आई. परिवर्तन" -#: domains/std/__init__.py:1200 -#, python-format -msgid "undefined label: %r" +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" +msgstr "अन्य परिवर्तन" + +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" +msgstr "किनारे का स्थान बढ़ाएं" + +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/std/__init__.py:1202 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:107 domains/python/__init__.py:244 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "मापदण्ड" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "चर पद " + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "उभारता है " + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s प्रभाग में )" -#: domains/python/__init__.py:167 domains/python/__init__.py:334 -#: domains/python/__init__.py:385 domains/python/__init__.py:424 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (%s प्रभाग में )" -#: domains/python/__init__.py:169 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (अंतर्निर्मित चर पद)" -#: domains/python/__init__.py:194 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (अंतर्निर्मित वर्ग)" -#: domains/python/__init__.py:195 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (%s वर्ग में)" -#: domains/python/__init__.py:249 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s वर्ग विधि) " -#: domains/python/__init__.py:251 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s स्थैतिक विधि)" -#: domains/python/__init__.py:389 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:428 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:559 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "पाइथन प्रभाग सूची" -#: domains/python/__init__.py:560 +#: domains/python/__init__.py:625 msgid "modules" msgstr "प्रभाग" -#: domains/python/__init__.py:637 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "अवमानित " -#: domains/python/__init__.py:663 +#: domains/python/__init__.py:729 msgid "exception" msgstr "अपवाद " -#: domains/python/__init__.py:665 +#: domains/python/__init__.py:731 msgid "class method" msgstr "वर्ग विधि" -#: domains/python/__init__.py:666 +#: domains/python/__init__.py:732 msgid "static method" msgstr "स्थैतिक पद्धति" -#: domains/python/__init__.py:668 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:669 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:729 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:858 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "पारस्परिक-सन्दर्भों के लिए एक से अधिक लक्ष्य मिले %r: %s" -#: domains/python/__init__.py:920 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "(अवमानित)" -#: domains/c/__init__.py:304 domains/cpp/__init__.py:441 -#: domains/python/_object.py:164 ext/napoleon/docstring.py:786 -msgid "Parameters" -msgstr "मापदण्ड" - -#: domains/python/_object.py:169 -msgid "Variables" -msgstr "चर पद " +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" -#: domains/python/_object.py:173 -msgid "Raises" -msgstr "उभारता है " +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" +msgstr "नमूना मानदण्ड " -#: domains/c/__init__.py:199 +#: domains/cpp/__init__.py:302 #, python-format -msgid "%s (C %s)" +msgid "%s (C++ %s)" +msgstr "%s (C++ %s)" + +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 +msgid "Return values" +msgstr "" + +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "युग्म" + +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" +msgstr "सदस्य" + +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "प्रकार" + +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "अवधारणा " + +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 +msgid "enum" +msgstr "गणक" + +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 +msgid "enumerator" +msgstr "प्रगणक " + +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 +msgid "function parameter" msgstr "" -#: domains/c/__init__.py:260 domains/c/_symbol.py:510 +#: domains/cpp/__init__.py:954 +msgid "template parameter" +msgstr "" + +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:307 domains/cpp/__init__.py:454 -msgid "Return values" +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" msgstr "" -#: domains/c/__init__.py:679 domains/cpp/__init__.py:860 -msgid "member" -msgstr "सदस्य" - -#: domains/c/__init__.py:680 +#: domains/c/__init__.py:778 msgid "variable" msgstr "चर पद" -#: domains/c/__init__.py:682 +#: domains/c/__init__.py:780 msgid "macro" msgstr "मैक्रो" -#: domains/c/__init__.py:683 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/c/__init__.py:684 domains/cpp/__init__.py:858 -msgid "union" -msgstr "युग्म" - -#: domains/c/__init__.py:685 domains/cpp/__init__.py:863 -msgid "enum" -msgstr "गणक" - -#: domains/c/__init__.py:686 domains/cpp/__init__.py:864 -msgid "enumerator" -msgstr "प्रगणक " +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" +msgstr "परिस्थिति चर पद; %s" -#: domains/c/__init__.py:687 domains/cpp/__init__.py:861 -msgid "type" -msgstr "प्रकार" +#: domains/std/__init__.py:116 +#, python-format +msgid "%s; configuration value" +msgstr "" -#: domains/c/__init__.py:689 domains/cpp/__init__.py:866 -msgid "function parameter" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: domains/cpp/__init__.py:155 -msgid "Template Parameters" -msgstr "नमूना मानदण्ड " +#: domains/std/__init__.py:182 +msgid "Default" +msgstr "" -#: domains/cpp/__init__.py:277 +#: domains/std/__init__.py:239 #, python-format -msgid "%s (C++ %s)" -msgstr "%s (C++ %s)" +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" +msgstr "अशुद्ध रूप विकल्प विवरण %r, अपेक्षित प्रारूप \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" अथवा \"+opt args\"" -#: domains/cpp/__init__.py:360 domains/cpp/_symbol.py:793 +#: domains/std/__init__.py:319 #, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." +msgid "%s command line option" msgstr "" -#: domains/cpp/__init__.py:862 -msgid "concept" -msgstr "अवधारणा " - -#: domains/cpp/__init__.py:867 -msgid "template parameter" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "विषय सामिग्री" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" +msgstr "" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "विषय-सूची" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" +msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "खोज" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "चलिए" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "पारिभाषिक पद" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "स्रोत दिखाएँ" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "व्याकरण संकेत " -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "किनारे का स्थान घटाएं" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "सन्दर्भ शीर्षक" -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "संचालन" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "परिस्थिति चर पद " -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "%(docstitle)s में खोजें" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "प्रोग्राम विकल्प " -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "इन लेखपत्रों के बारे में" +#: domains/std/__init__.py:735 +msgid "document" +msgstr "लेखपत्र" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "सर्वाधिकार" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "प्रभाग सूची" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#: domains/std/__init__.py:857 #, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "अंतिम बार सम्पादित %(last_updated)s." +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "numfig असमर्थ है. :numref: उपेक्षित है." -#: themes/basic/layout.html:204 +#: domains/std/__init__.py:1124 #, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: themes/basic/genindex-single.html:26 +#: domains/std/__init__.py:1138 #, python-format -msgid "Index – %(key)s" -msgstr "" +msgid "the link has no caption: %s" +msgstr "कड़ी का कोई शीर्षक नहीं है: %s" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "एक पृष्ठ पर पूरी अनुक्रमणिका" +#: domains/std/__init__.py:1153 +#, python-format +msgid "invalid numfig_format: %s (%r)" +msgstr "अमान्य numfig_format: %s (%r)" -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "अक्षर द्वारा अनुक्रमित पृष्ठ" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" +msgstr "अमान्य numfig_format: %s" -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "बृहदाकार हो सकता है" +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" +msgstr "" -#: themes/basic/opensearch.xml:4 +#: domains/std/__init__.py:1456 #, python-format -msgid "Search %(docstitle)s" -msgstr " %(docstitle)s में खोजें" +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "यह पृष्ठ " +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" +msgstr "" -#: themes/basic/defindex.html:4 -msgid "Overview" -msgstr "सिंहावलोकन" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" +msgstr "" -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" -msgstr "नमस्ते! यह है" +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" +msgstr "" -#: themes/basic/defindex.html:9 -msgid "the documentation for" -msgstr "आलेख विषय" +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" +msgstr "" -#: themes/basic/defindex.html:10 -msgid "last updated" -msgstr "अंतिम परिवर्धन" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "उदाहरण" -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" -msgstr "सूचियाँ और सारणियाँ:" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "कुछ उदाहरण" -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" -msgstr "विस्तृत विषय-सूची" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "मुख्य शब्दों के चर-पद" -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "सभी अनुभागों एवं उप-अनुभागों की सूची" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "टिप्पणियाँ" -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "इस आलेख में खोजें" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "अन्य मापदण्ड" -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "सार्वभौमिक प्रभाग सूची" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "सभी प्रभाग तक तुरंत पहुँच" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "सन्दर्भ" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "सामान्य अनुक्रमाणिका" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "चेतावनी देता है" -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "सभी कार्ययुक्तियां, वर्ग, शब्द" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "मिलता है" -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "त्वरित खोज" +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" +msgstr "" -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." -msgstr "खोज कार्य के लिए जावा स्क्रिप्ट का होना आवश्यक है. कृपया जावा स्क्रिप्ट को शुरू करें." +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 +#, python-format +msgid "alias of %s" +msgstr "" -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" +msgstr "आधार: %s" + +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" msgstr "" -#: themes/basic/search.html:35 -msgid "search" -msgstr "खोज" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "पिछला प्रकरण" +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" +msgstr "स्वतः %s (%r) के लिए अमान्य हस्ताक्षर" -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "पिछला अध्याय" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "पता नहीं है कि कौन सा प्रभाग स्वतःप्रलेखन %r के लिए आयात करना है (लेखपत्र में \"प्रभाग\" या \"वर्तमान-प्रभाग\" निर्देश रख कर देखें; अथवा स्पष्ट प्रभाग नाम देकर देखें)" -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "अगला प्रकरण" +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "अगला अध्याय" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" +msgstr "" -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" -msgstr "किनारे का स्थान बढ़ाएं" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "स्वतः प्रभाग नाम में \"::\" विवेकहीन है" -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "परिवर्तित संस्करण %(version)s — %(docstitle)s" +msgid "Failed to remove %s: %s" +msgstr "" -#: themes/basic/changes/versionchanges.html:17 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "संस्करण %(version)s में स्वतः रचित परिवर्तनों की सूची" +msgid "Would create file %s." +msgstr "%s फाइल बन जाएगी." -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "पुस्तकालय में परिवर्तन" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\n में पाइथन प्रभाग और पैकेज की पुनरावर्तित खोज करें और\nस्वतःप्रभाग निर्देश द्वारा में प्रति पैकेज एक रेस्ट #reST# फाइल बनाएं.\n\n फाइल और/ अथवा निर्देशिका स्वरुप हो सकते हैं\nजो निर्माण प्रकिया में छोड़ दिए जाएंगे.\n\nनोट: सामान्यतया यह स्क्रिप्ट किसी पहले से बनाई गई फाइल पर पुनर्लेखन नहीं करती." -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "सी ऐ.पी.आई. परिवर्तन" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "प्रभाग से लेखपत्र का पथ" -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "अन्य परिवर्तन" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "fnmatch-style फाइल और/ अथवा निर्देशिका स्वरुप जो निर्माण प्रक्रिया से छोड़ने हैं" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "सभी परिणामों को सहेजने के लिए निर्देशिका" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "खोजे गए जोड़े छिपाएं" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "विषय-सूची में दिखाए जाने वाले उपप्रभागों की अधिकतम गहराई (मानक: 4)" -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" -msgstr "खोज परीणाम " +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "मौजूदा फाइलों पर पुनर्लेखन करें" -#: themes/basic/static/searchtools.js:119 +#: ext/apidoc/_cli.py:91 msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." -msgstr "आपके खोज परिणामों में कोई प्रलेख नहीं मिला. कृपया सुनिश्चित करें कि सभी शब्दों की वर्तनी शुद्ध है और आपने यथेष्ट श्रेणियां चुनी हैं." - -#: themes/basic/static/searchtools.js:123 -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "सांकेतिक कड़ियों का अनुसरण करें. कलेक्टिव.रेसिपी.ऑमलेट के साथ प्रभावशाली. " -#: themes/basic/static/searchtools.js:253 -msgid "Searching" -msgstr "खोज जारी" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "फाइलों को बनाए बिना स्क्रिप्ट चलाएं " -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." -msgstr "खोज की तैयारी" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "प्रत्येक प्रभाग के आलेख उसके अपने पृष्ठ में रखें" -#: themes/basic/static/searchtools.js:474 -msgid ", in " -msgstr ", में " +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "\"_private\" प्रभाग को सम्मिलित करें " -#: environment/collectors/asset.py:96 -#, python-format -msgid "image file not readable: %s" -msgstr "चित्र फाइल पठनीय नहीं है: %s" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "विषय-सूची की फाइल का नाम (मानक: प्रभाग) " -#: environment/collectors/asset.py:124 -#, python-format -msgid "image file %s not readable: %s" -msgstr "चित्र फाइल %s पठनीय नहीं है: %s" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "विषय-सूची की फाइल न बनाएं " -#: environment/collectors/asset.py:161 -#, python-format -msgid "download file not readable: %s" -msgstr "उतारी गई फाइल पठनीय नहीं है: %s" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "प्रभाग/पैकेज पैकेजों का शीर्षक न बनाएं (उदाहरणार्थ, जब डॉकस्ट्रिंग्स में यह पहले से हों) " -#: environment/collectors/toctree.py:258 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s में पहले से भाग संख्या नियत है (एक के अन्दर दूसरा अंकित विषय-सूची-संरचना)" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr " मुख्य प्रभाग के आलेख को उपप्रभाग के आलेख से पहले रखें" -#: environment/adapters/toctree.py:318 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "पारस्परिक संदर्भित विषय-सूची-संरचना सन्दर्भ पाए गए, उपेक्षा की जा रही है: %s <- %s" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "प्रभाग पथ की व्याख्या 'पी.ई.पी.-0420 निहित नामराशि विवरण' के आधार पर करें " -#: environment/adapters/toctree.py:342 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "विषय-सूची-संरचना में लेखपत्र %r, जिसका कोई शीर्षक नहीं है, का सन्दर्भ है: कोई सम्बन्ध नहीं बनाया जा सकेगा" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: environment/adapters/toctree.py:357 -#, python-format -msgid "toctree contains reference to non-included document %r" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "फाइल प्रत्यय (मानक: rst)" + +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: environment/adapters/indexentries.py:126 -#, python-format -msgid "see %s" -msgstr "%s देखिए" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "स्फिंक्स-त्वरित-आरम्भ के साथ पूर्ण परियोजना उत्पन्न करें " -#: environment/adapters/indexentries.py:136 -#, python-format -msgid "see also %s" -msgstr "%s भी देखिए" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "मोड्यूल_पाथ #module_path# को सिस.पाथ #sys.path# में जोड़ें, जब --full दिया जाता है तब इसका प्रयोग होता है " -#: environment/adapters/indexentries.py:144 -#, python-format -msgid "unknown index entry type %r" -msgstr "अनुक्रमणिका की प्रविष्टि का प्रकार अज्ञात %r" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "परियोजना का नाम (मानक: मूल प्रभाग का नाम) " -#: environment/adapters/indexentries.py:270 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "संकेत " +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "परियोजना लेखक(गण), जब --full दिया जाता है तब इसका प्रयोग होता है " -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" -msgstr "" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "परियोजना संस्करण, जब --full दिया जाता है तब इसका प्रयोग होता है " -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" -msgstr "" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "परियोजना आवृत्ति, जब --full दिया जाता है तब इसका प्रयोग होता है " -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "आयाम विकल्प " + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/html/__init__.py:113 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "एच.टी.एम्.एल. पृष्ठ %(outdir)sमें हैं." +msgid "enable %s extension, used when --full is given" +msgstr "" -#: builders/html/__init__.py:348 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "Failed to read build info file: %r" -msgstr "निर्माण सूचनापत्र फाइल को नहीं पढ़ा जा सका: %r" +msgid "%s is not a directory." +msgstr "%s एक निर्देशिका नहीं है. " -#: builders/html/__init__.py:363 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/__init__.py:382 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "अनुक्रमणिका" - -#: builders/html/__init__.py:560 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Logo of %s" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "आगामी" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "पूर्ववर्ती" - -#: builders/html/__init__.py:695 -msgid "generating indices" -msgstr "अनुक्रमाणिका निर्मित की जा रही है" - -#: builders/html/__init__.py:710 -msgid "writing additional pages" -msgstr "अतिरिक्त पृष्ठ लिखे जा रहे हैं" - -#: builders/html/__init__.py:793 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/__init__.py:805 -msgid "copying downloadable files... " -msgstr "उतारी गई फाइलों की प्रतिलिपि बनाई जा रही है..." - -#: builders/html/__init__.py:817 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "उतारी गई फाइलों %r की प्रतिलिपि नहीं की जा सकी: %s" +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "" -#: builders/html/__init__.py:863 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:881 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/__init__.py:916 -msgid "copying static files" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/html/__init__.py:933 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "cannot copy static file %r" -msgstr "स्थैतिक फाइल %r की प्रतिलिपि नहीं की जा सकी" - -#: builders/html/__init__.py:938 -msgid "copying extra files" -msgstr "अतिरिक्त फाइलों की प्रतिलिपियां बनाये जा रहे है| " +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" -#: builders/html/__init__.py:948 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "cannot copy extra file %r" -msgstr "अतिरिक्त फाइल %r की प्रतिलिपि नहीं की जा सकी" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: builders/html/__init__.py:954 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "Failed to write build info file: %r" -msgstr "निर्माण फाइल को नहीं लिखा जा सका: %r" - -#: builders/html/__init__.py:1003 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "खोज अनुक्रमाणिका नहीं चढाई जा सकी, लेकिन सभी लेखपत्र नहीं बनाए जाएंगे: अनुक्रमणिका अपूर्ण रहेगी." +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "" -#: builders/html/__init__.py:1051 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "पृष्ठ %s html_sidebars में दो आकृतियों से मिलता है: %r %r" +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "" -#: builders/html/__init__.py:1213 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "पृष्ठ %s की प्रस्तुति करते समय यूनिकोड त्रुटि हुई. कृपया यह सुनिश्चित कर लें कि सभी नॉन-असकी #non-ASCII# विहित विन्यास मान यूनिकोड अक्षरों में हैं." +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "" -#: builders/html/__init__.py:1222 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "पृष्ठ %s की प्रस्तुति करते समय एक त्रुटि हुई.\nकारण: %r" - -#: builders/html/__init__.py:1255 -msgid "dumping object inventory" -msgstr "विषयवस्तुओं का भंडार बनाया जा रहा है" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "" -#: builders/html/__init__.py:1263 +#: ext/autosummary/generate.py:630 #, python-format -msgid "dumping search index in %s" -msgstr "%s में खोज अनुक्रमाणिका भंडार बनाया जा रहा है" +msgid "[autosummary] generating autosummary for: %s" +msgstr "[ऑटोसमरी] अब इसका स्वतःसारांश बना रहा है: %s" -#: builders/html/__init__.py:1306 +#: ext/autosummary/generate.py:634 #, python-format -msgid "invalid js_file: %r, ignored" -msgstr "अमान्य js_file: %r, उपेक्षित" - -#: builders/html/__init__.py:1339 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "कई math_renderers पंजीकृत हैं. लेकिन कोई math_renderers नहीं चुना गया है." +msgid "[autosummary] writing to %s" +msgstr "[ऑटोसमरी] %s पर लिख रहा है" -#: builders/html/__init__.py:1344 +#: ext/autosummary/generate.py:679 #, python-format -msgid "Unknown math_renderer %r is given." -msgstr "अज्ञात math_renderer %r दिया गया." +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" -#: builders/html/__init__.py:1358 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "html_extra_path का प्रविष्टि %r outdir में है| " +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nस्वतः सारांश #autosummary# निर्देश का प्रयोग करते हुए पुर्नसरंचितपाठ बनाता है.\n\nस्फिंक्स-ऑटोजेन स्फिंक्स.एक्स्ट.ऑटोसमरी.जेनेरेट का मुखड़ा है.\nयह प्रदत्त फाइलों में सम्मिलित ऑटो समरी निर्देशों के अनुसार पुर्नसरंचितपाठ बनाता है\n\nस्वतः सारांश #autosummary# निर्देश का प्रारूप स्फिंक्स.एक्स्ट.ऑटोसमरी \nपाइथन प्रभाग में निबंधित है और इसे आप निम्नलिखित माध्यम से पढ़ सकते हैं:\n\n pydoc sphinx.ext.autosummary\n" -#: builders/html/__init__.py:1363 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "html_extra_path प्रविष्टि %r का अस्तित्व नहीं है" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "आर.एस.टी. फाइलें बनाने के लिए स्रोत फाइलें" -#: builders/html/__init__.py:1378 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "html_static_path का प्रविष्टि %r outdir में है| " +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "सभी परिणाम रखने के लिए निर्देशिका" -#: builders/html/__init__.py:1383 +#: ext/autosummary/generate.py:915 #, python-format -msgid "html_static_path entry %r does not exist" -msgstr "html_static_path प्रविष्टि %r का अस्तित्व नहीं है" +msgid "default suffix for files (default: %(default)s)" +msgstr "फाइलों के लिए मानक प्रत्यय (मानक: %(default)s)" -#: builders/html/__init__.py:1394 builders/latex/__init__.py:504 +#: ext/autosummary/generate.py:923 #, python-format -msgid "logo file %r does not exist" -msgstr "प्रतीकचिन्ह फाइल %r का अस्तित्व नहीं है" +msgid "custom template directory (default: %(default)s)" +msgstr "पारंपरिक प्रारूप निर्देशिका (मानक: %(default)s)" -#: builders/html/__init__.py:1405 +#: ext/autosummary/generate.py:931 #, python-format -msgid "favicon file %r does not exist" -msgstr "इष्ट चिन्ह फाइल %r का अस्तित्व नहीं है" +msgid "document imported members (default: %(default)s)" +msgstr "लेखपत्र आयातित सदस्य (मानक: %(default)s)" -#: builders/html/__init__.py:1417 +#: ext/autosummary/generate.py:940 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: builders/html/__init__.py:1430 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: builders/html/__init__.py:1447 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "%s %s documentation" -msgstr "%s %s दिग्दर्शिका" - -#: builders/latex/transforms.py:118 -msgid "Failed to get a docname!" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: builders/latex/transforms.py:119 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: builders/latex/transforms.py:485 +#: ext/autosummary/__init__.py:329 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/latex/__init__.py:117 +#: ext/autosummary/__init__.py:358 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "लाटेक्स लेखपत्र %(outdir)s में हैं." +msgid "failed to import object %s" +msgstr "विषय-वस्तु के आयात में असफलता: %s" -#: builders/latex/__init__.py:119 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nइन्हें (pdf)latex से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें\n(ऐसा स्वचालित रूप से करने के लिए यहाँ 'make latexpdf' आदेश का उपयोग करें)" - -#: builders/latex/__init__.py:157 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "कोई \"latex_documents\" विन्यास मान नहीं मिला; कोई नहीं लिखे जाएंगे" +"Summarised items should not include the current module. Replace %r with %r." +msgstr "" -#: builders/latex/__init__.py:169 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "\"latex_documents\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है" +msgid "autosummary_generate: file not found: %s" +msgstr "" -#: builders/latex/__init__.py:208 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "आवृत्ति" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." +msgstr "" -#: builders/latex/__init__.py:429 -msgid "copying TeX support files" -msgstr "टेक्स सहायक फाइलों की प्रतिलिपि की जा रही है..." +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" -#: builders/latex/__init__.py:466 -msgid "copying additional files" -msgstr "अतिरिक्त फाइलों की प्रतिकृति बनाई जा रही है" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" -#: builders/latex/__init__.py:540 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: builders/latex/__init__.py:548 +#: ext/intersphinx/_load.py:94 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: builders/latex/theming.py:87 +#: ext/intersphinx/_load.py:103 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r में कोई \"रूप\" मान नहीं है" +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "" -#: builders/latex/theming.py:90 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r में कोई \"%s \" मान नहीं है" +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" -#: _cli/util/errors.py:124 -msgid "Exception occurred, starting debugger:" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: _cli/util/errors.py:133 -msgid "reStructuredText markup error:" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: _cli/util/errors.py:168 -msgid "The full traceback has been saved in:" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: _cli/util/errors.py:172 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: transforms/post_transforms/__init__.py:125 +#: ext/intersphinx/_load.py:324 msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "कुछ चीजों के साथ कुछ समस्या है, लेकिन काम के दूसरे विकल्प उपलब्ध हैं: " -#: transforms/post_transforms/__init__.py:185 +#: ext/intersphinx/_load.py:332 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "किसी भी पारस्परिक-सन्दर्भ के लिए एक से अधिक लक्ष्य मिले %r: %s संभव" +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: transforms/post_transforms/__init__.py:251 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "इन्टरस्फिंक्स सामान स्थानांतरित हो चुका है: %s -> %s" -#: transforms/post_transforms/__init__.py:257 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "%r reference target not found: %s" +msgid "(in %s %s)" msgstr "" -#: transforms/post_transforms/images.py:77 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "दूरस्थ चित्र नहीं लाया जा सका: %s [%s]" +msgid "(in %s)" +msgstr "(%s में)" -#: transforms/post_transforms/images.py:94 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "दूरस्थ चित्र नहीं लाया जा सका: %s [%d]" +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "" -#: transforms/post_transforms/images.py:141 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Unknown image format: %s..." -msgstr "अज्ञात चित्र प्रारूप: %s..." - -#: ext/napoleon/docstring.py:707 -msgid "Example" -msgstr "उदाहरण" - -#: ext/napoleon/docstring.py:708 -msgid "Examples" -msgstr "कुछ उदाहरण" - -#: ext/napoleon/__init__.py:344 ext/napoleon/docstring.py:752 -msgid "Keyword Arguments" -msgstr "मुख्य शब्दों के चर-पद" - -#: ext/napoleon/docstring.py:768 -msgid "Notes" -msgstr "टिप्पणियाँ" - -#: ext/napoleon/docstring.py:777 -msgid "Other Parameters" -msgstr "अन्य मापदण्ड" - -#: ext/napoleon/docstring.py:813 -msgid "Receives" +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/napoleon/docstring.py:817 -msgid "References" -msgstr "सन्दर्भ" - -#: ext/napoleon/docstring.py:849 -msgid "Warns" -msgstr "चेतावनी देता है" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "" -#: ext/napoleon/docstring.py:853 -msgid "Yields" -msgstr "मिलता है" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "" -#: ext/napoleon/docstring.py:1015 +#: ext/intersphinx/_resolve.py:407 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:1022 +#: ext/intersphinx/_resolve.py:561 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/napoleon/docstring.py:1029 +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1036 +#: ext/autodoc/_dynamic/_loader.py:193 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/autosummary/__init__.py:256 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:258 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/autosummary/__init__.py:277 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/autosummary/__init__.py:330 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/autosummary/__init__.py:344 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "failed to parse name %s" -msgstr "पद-विच्छेदन में असफलता: %s" +msgid "error while formatting arguments for %s: %s" +msgstr "%s के पदों का प्रारूप बनाने में व्यवधान: %s" -#: ext/autosummary/__init__.py:349 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "failed to import object %s" -msgstr "विषय-वस्तु के आयात में असफलता: %s" +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" -#: ext/autosummary/__init__.py:648 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:819 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/autosummary/__init__.py:827 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/autosummary/generate.py:215 ext/autosummary/generate.py:391 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:526 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[ऑटोसमरी] अब इसका स्वतःसारांश बना रहा है: %s" +msgid "signature arguments or return annotation given for automodule %s" +msgstr "स्वतः-प्रभाग %s के लिए हस्ताक्षर पद अथवा प्रत्युत्तरित टिप्पणी प्रदान की गई" -#: ext/autosummary/generate.py:530 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[ऑटोसमरी] %s पर लिख रहा है" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ अंतिम अक्षरमाला होनी चाहिए, न कि %r (%s प्रभाग में) -- __all__ की उपेक्षा की जाएगी" -#: ext/autosummary/generate.py:572 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/autosummary/generate.py:767 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nस्वतः सारांश #autosummary# निर्देश का प्रयोग करते हुए पुर्नसरंचितपाठ बनाता है.\n\nस्फिंक्स-ऑटोजेन स्फिंक्स.एक्स्ट.ऑटोसमरी.जेनेरेट का मुखड़ा है.\nयह प्रदत्त फाइलों में सम्मिलित ऑटो समरी निर्देशों के अनुसार पुर्नसरंचितपाठ बनाता है\n\nस्वतः सारांश #autosummary# निर्देश का प्रारूप स्फिंक्स.एक्स्ट.ऑटोसमरी \nपाइथन प्रभाग में निबंधित है और इसे आप निम्नलिखित माध्यम से पढ़ सकते हैं:\n\n pydoc sphinx.ext.autosummary\n" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "%s गुण %s वस्तु में अनुपस्थित" -#: ext/autosummary/generate.py:789 -msgid "source files to generate rST files for" -msgstr "आर.एस.टी. फाइलें बनाने के लिए स्रोत फाइलें" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "" -#: ext/autosummary/generate.py:797 -msgid "directory to place all output in" -msgstr "सभी परिणाम रखने के लिए निर्देशिका" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" -#: ext/autosummary/generate.py:805 -#, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "फाइलों के लिए मानक प्रत्यय (मानक: %(default)s)" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" -#: ext/autosummary/generate.py:813 +#: builders/html/__init__.py:114 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "पारंपरिक प्रारूप निर्देशिका (मानक: %(default)s)" +msgid "The HTML pages are in %(outdir)s." +msgstr "एच.टी.एम्.एल. पृष्ठ %(outdir)sमें हैं." -#: ext/autosummary/generate.py:821 +#: builders/html/__init__.py:337 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "लेखपत्र आयातित सदस्य (मानक: %(default)s)" +msgid "Failed to read build info file: %r" +msgstr "निर्माण सूचनापत्र फाइल को नहीं पढ़ा जा सका: %r" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" -#: ext/autosummary/generate.py:829 +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" + +#: builders/html/__init__.py:372 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:47 -#, python-format -msgid "(in %s v%s)" -msgstr "(%s v%s में)" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "अनुक्रमणिका" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:549 #, python-format -msgid "(in %s)" -msgstr "(%s में)" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "आगामी" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "पूर्ववर्ती" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "अनुक्रमाणिका निर्मित की जा रही है" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "अतिरिक्त पृष्ठ लिखे जा रहे हैं" -#: ext/intersphinx/_resolve.py:103 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:113 +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "उतारी गई फाइलों की प्रतिलिपि बनाई जा रही है..." + +#: builders/html/__init__.py:807 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "उतारी गई फाइलों %r की प्रतिलिपि नहीं की जा सकी: %s" -#: ext/intersphinx/_resolve.py:359 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:367 +#: builders/html/__init__.py:871 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:378 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:585 +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "" +msgid "cannot copy static file %r" +msgstr "स्थैतिक फाइल %r की प्रतिलिपि नहीं की जा सकी" + +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "अतिरिक्त फाइलों की प्रतिलिपियां बनाये जा रहे है| " -#: ext/intersphinx/_load.py:59 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "cannot copy extra file %r" +msgstr "अतिरिक्त फाइल %r की प्रतिलिपि नहीं की जा सकी" -#: ext/intersphinx/_load.py:70 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "निर्माण फाइल को नहीं लिखा जा सका: %r" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "खोज अनुक्रमाणिका नहीं चढाई जा सकी, लेकिन सभी लेखपत्र नहीं बनाए जाएंगे: अनुक्रमणिका अपूर्ण रहेगी." -#: ext/intersphinx/_load.py:81 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "पृष्ठ %s html_sidebars में दो आकृतियों से मिलता है: %r %r" -#: ext/intersphinx/_load.py:92 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "पृष्ठ %s की प्रस्तुति करते समय यूनिकोड त्रुटि हुई. कृपया यह सुनिश्चित कर लें कि सभी नॉन-असकी #non-ASCII# विहित विन्यास मान यूनिकोड अक्षरों में हैं." -#: ext/intersphinx/_load.py:101 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:120 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "पृष्ठ %s की प्रस्तुति करते समय एक त्रुटि हुई.\nकारण: %r" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "विषयवस्तुओं का भंडार बनाया जा रहा है" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:155 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +msgid "dumping search index in %s" +msgstr "%s में खोज अनुक्रमाणिका भंडार बनाया जा रहा है" -#: ext/intersphinx/_load.py:240 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "" - -#: ext/intersphinx/_load.py:265 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "कुछ चीजों के साथ कुछ समस्या है, लेकिन काम के दूसरे विकल्प उपलब्ध हैं: " +msgid "invalid js_file: %r, ignored" +msgstr "अमान्य js_file: %r, उपेक्षित" -#: ext/intersphinx/_load.py:275 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "कुछ चीजों पहुँचने में असफलता मिली और यह समस्याएँ मिलीं: " +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "कई math_renderers पंजीकृत हैं. लेकिन कोई math_renderers नहीं चुना गया है." -#: ext/intersphinx/_load.py:319 +#: builders/html/__init__.py:1351 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "इन्टरस्फिंक्स सामान स्थानांतरित हो चुका है: %s -> %s" +msgid "Unknown math_renderer %r is given." +msgstr "अज्ञात math_renderer %r दिया गया." -#: ext/autodoc/type_comment.py:132 +#: builders/html/__init__.py:1365 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "html_extra_path का प्रविष्टि %r outdir में है| " -#: ext/autodoc/type_comment.py:135 +#: builders/html/__init__.py:1370 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "html_extra_path प्रविष्टि %r का अस्तित्व नहीं है" -#: ext/autodoc/__init__.py:142 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "html_static_path का प्रविष्टि %r outdir में है| " -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "" +msgid "html_static_path entry %r does not exist" +msgstr "html_static_path प्रविष्टि %r का अस्तित्व नहीं है" -#: ext/autodoc/__init__.py:415 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "स्वतः %s (%r) के लिए अमान्य हस्ताक्षर" +msgid "logo file %r does not exist" +msgstr "प्रतीकचिन्ह फाइल %r का अस्तित्व नहीं है" -#: ext/autodoc/__init__.py:532 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "%s के पदों का प्रारूप बनाने में व्यवधान: %s" +msgid "favicon file %r does not exist" +msgstr "इष्ट चिन्ह फाइल %r का अस्तित्व नहीं है" -#: ext/autodoc/__init__.py:807 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:902 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "पता नहीं है कि कौन सा प्रभाग स्वतःप्रलेखन %r के लिए आयात करना है (लेखपत्र में \"प्रभाग\" या \"वर्तमान-प्रभाग\" निर्देश रख कर देखें; अथवा स्पष्ट प्रभाग नाम देकर देखें)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "" -#: ext/autodoc/__init__.py:946 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" -msgstr "" +msgid "%s %s documentation" +msgstr "%s %s दिग्दर्शिका" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" +msgstr "%r में कोई \"रूप\" मान नहीं है" -#: ext/autodoc/__init__.py:965 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r में कोई \"%s \" मान नहीं है" + +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1028 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "स्वतः प्रभाग नाम में \"::\" विवेकहीन है" +#: builders/latex/transforms.py:121 +#, python-format +msgid "Failed to get a docname for source %r!" +msgstr "" -#: ext/autodoc/__init__.py:1035 +#: builders/latex/transforms.py:487 #, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "स्वतः-प्रभाग %s के लिए हस्ताक्षर पद अथवा प्रत्युत्तरित टिप्पणी प्रदान की गई" +msgid "No footnote was found for given reference node %r" +msgstr "" -#: ext/autodoc/__init__.py:1048 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "लाटेक्स लेखपत्र %(outdir)s में हैं." + +#: builders/latex/__init__.py:118 msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ अंतिम अक्षरमाला होनी चाहिए, न कि %r (%s प्रभाग में) -- __all__ की उपेक्षा की जाएगी" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nइन्हें (pdf)latex से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें\n(ऐसा स्वचालित रूप से करने के लिए यहाँ 'make latexpdf' आदेश का उपयोग करें)" + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "कोई \"latex_documents\" विन्यास मान नहीं मिला; कोई नहीं लिखे जाएंगे" -#: ext/autodoc/__init__.py:1114 +#: builders/latex/__init__.py:167 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "\"latex_documents\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "टेक्स सहायक फाइलों की प्रतिलिपि की जा रही है..." -#: ext/autodoc/__init__.py:1337 ext/autodoc/__init__.py:1414 -#: ext/autodoc/__init__.py:2829 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "अतिरिक्त फाइलों की प्रतिकृति बनाई जा रही है" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1633 +#: builders/latex/__init__.py:537 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1760 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Bases: %s" -msgstr "आधार: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s में पहले से भाग संख्या नियत है (एक के अन्दर दूसरा अंकित विषय-सूची-संरचना)" -#: ext/autodoc/__init__.py:1774 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" -msgstr "%s गुण %s वस्तु में अनुपस्थित" +msgid "image file not readable: %s" +msgstr "चित्र फाइल पठनीय नहीं है: %s" -#: ext/autodoc/__init__.py:1855 ext/autodoc/__init__.py:1892 -#: ext/autodoc/__init__.py:1987 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" -msgstr "" +msgid "image file %s not readable: %s" +msgstr "चित्र फाइल %s पठनीय नहीं है: %s" -#: ext/autodoc/__init__.py:1875 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "" +msgid "download file not readable: %s" +msgstr "उतारी गई फाइल पठनीय नहीं है: %s" -#: ext/autodoc/__init__.py:2217 ext/autodoc/__init__.py:2317 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "पारस्परिक संदर्भित विषय-सूची-संरचना सन्दर्भ पाए गए, उपेक्षा की जा रही है: %s <- %s" -#: ext/autodoc/__init__.py:2448 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "विषय-सूची-संरचना में लेखपत्र %r, जिसका कोई शीर्षक नहीं है, का सन्दर्भ है: कोई सम्बन्ध नहीं बनाया जा सकेगा" -#: ext/autodoc/preserve_defaults.py:190 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "पिछले पृष्ठ से जारी" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "अगले पृष्ठ पर जारी" +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "अकारादि-क्रमहीन " +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "%s देखिए" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "संख्याएं " +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "%s भी देखिए" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "पृष्ठ" +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "अनुक्रमणिका की प्रविष्टि का प्रकार अज्ञात %r" diff --git a/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo b/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo index 34d4dd389cf..17958dd31b6 100644 Binary files a/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo and b/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po b/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po index 6805e517878..e477a36b2d8 100644 --- a/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po @@ -1,5 +1,5 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: @@ -7,153 +7,300 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-29 22:39+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Hindi (India) (http://app.transifex.com/sphinx-doc/sphinx-1/language/hi_IN/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" "Language: hi_IN\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" -#: events.py:77 +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "" + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "" + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 #, python-format msgid "Event %r already present" msgstr "" -#: events.py:370 +#: events.py:386 #, python-format msgid "Unknown event name: %s" msgstr "" -#: events.py:416 +#: events.py:451 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" -#: application.py:190 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:194 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:198 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:228 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:250 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:266 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:271 registry.py:452 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:277 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:312 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:329 util/display.py:88 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:331 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:345 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:353 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:366 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:398 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:400 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:404 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:407 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:409 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:414 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:417 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:419 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:968 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1047 +#: application.py:1113 #, python-format -msgid "directive %r is already registered, it will be overridden" +msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1069 application.py:1094 +#: application.py:1139 application.py:1167 #, python-format -msgid "role %r is already registered, it will be overridden" +msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1644 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1648 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1651 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,1153 +321,1307 @@ msgid "" "explicit" msgstr "" -#: application.py:1655 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1663 application.py:1667 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: roles.py:208 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:231 -#, python-format -msgid "invalid CVE number %s" -msgstr "" - -#: roles.py:253 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" - -#: roles.py:276 -#, python-format -msgid "invalid CWE number %s" -msgstr "" - -#: roles.py:296 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "" - -#: roles.py:319 -#, python-format -msgid "invalid PEP number %s" -msgstr "" - -#: roles.py:357 -#, python-format -msgid "invalid RFC number %s" -msgstr "" - -#: registry.py:144 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" -#: registry.py:146 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" -#: registry.py:159 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" -#: registry.py:166 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "" -#: registry.py:173 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "" -#: registry.py:196 registry.py:209 registry.py:220 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "" -#: registry.py:200 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" -#: registry.py:212 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" -#: registry.py:223 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" -#: registry.py:254 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "" -#: registry.py:280 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "" -#: registry.py:287 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "" -#: registry.py:296 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "" -#: registry.py:304 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "" -#: registry.py:320 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "" -#: registry.py:336 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: registry.py:419 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "" -#: registry.py:431 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "" -#: registry.py:446 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" -#: registry.py:457 +#: registry.py:545 msgid "Original exception:\n" msgstr "" -#: registry.py:458 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "" -#: registry.py:463 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" -#: registry.py:472 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" -#: registry.py:480 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" -#: registry.py:514 +#: registry.py:605 #, python-format msgid "`None` is not a valid filetype for %r." msgstr "" -#: project.py:71 +#: config.py:351 #, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: project.py:87 +#: config.py:374 #, python-format -msgid "Ignored unreadable document %r." +msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: highlighting.py:168 +#: config.py:379 #, python-format -msgid "Pygments lexer name %r is not known" +msgid "" +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" msgstr "" -#: highlighting.py:202 +#: config.py:391 #, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: extension.py:55 +#: config.py:399 #, python-format -msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." +msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: extension.py:76 +#: config.py:422 #, python-format -msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." +msgid "unknown config value %r in override, ignoring" msgstr "" -#: theming.py:114 +#: config.py:476 #, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +msgid "No such config value: %r" msgstr "" -#: theming.py:120 +#: config.py:504 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +msgid "Config value %r already present" msgstr "" -#: theming.py:135 +#: config.py:541 #, python-format -msgid "unsupported theme option %r given" +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" msgstr "" -#: theming.py:207 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." msgstr "" -#: theming.py:228 +#: config.py:599 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: theming.py:268 -#, python-format -msgid "The %r theme has circular inheritance" +#: config.py:603 +msgid "" +"The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: theming.py:275 +#: config.py:611 #, python-format msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" msgstr "" -#: theming.py:282 +#: config.py:633 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to convert %r to a frozenset" msgstr "" -#: theming.py:310 +#: config.py:651 config.py:659 #, python-format -msgid "no theme configuration file found in %r" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: theming.py:335 theming.py:388 +#: config.py:665 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." msgstr "" -#: theming.py:339 +#: config.py:686 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" +msgid "Section %s" msgstr "" -#: theming.py:343 theming.py:391 +#: config.py:687 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "Fig. %s" msgstr "" -#: theming.py:347 +#: config.py:688 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "Table %s" msgstr "" -#: theming.py:366 +#: config.py:689 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgid "Listing %s" msgstr "" -#: config.py:309 -#, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +#: config.py:798 +#, python-brace-format +msgid "" +"The config value `{name}` has to be a one of {candidates}, but `{current}` " +"is given." msgstr "" -#: config.py:318 +#: config.py:829 +#, python-brace-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"The config value `{name}' has type `{current.__name__}'; expected " +"{permitted}." msgstr "" -#: config.py:341 -#, python-format +#: config.py:846 +#, python-brace-format msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" +"The config value `{name}' has type `{current.__name__}', defaults to " +"`{default.__name__}'." msgstr "" -#: config.py:350 +#: config.py:858 #, python-format -msgid "invalid number %r for config value %r, ignoring" +msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:356 -#, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" +#: config.py:878 +msgid "" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: config.py:377 -#, python-format -msgid "unknown config value %r in override, ignoring" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: config.py:430 -#, python-format -msgid "No such config value: %r" +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: config.py:453 -#, python-format -msgid "Config value %r already present" +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: config.py:489 -#, python-format -msgid "" -"cannot cache unpickable configuration value: %r (because it contains a " -"function, class, or module object)" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: config.py:527 -#, python-format -msgid "There is a syntax error in your configuration file: %s\n" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: config.py:530 -msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: config.py:537 +#: environment/__init__.py:350 #, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: config.py:560 +#: environment/__init__.py:355 #, python-format -msgid "Failed to convert %r to a set or tuple" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: config.py:581 config.py:586 +#: environment/__init__.py:361 #, python-format -msgid "Converting `source_suffix = %r` to `source_suffix = %r`." +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: config.py:589 -#, python-format +#: environment/__init__.py:404 msgid "" -"The config value `source_suffix' expects a dictionary, a string, or a list " -"of strings. Got `%r' instead (type %s)." +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: config.py:608 +#: environment/__init__.py:518 #, python-format -msgid "Section %s" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: config.py:609 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "Fig. %s" +msgid "Domain %r is not registered" msgstr "" -#: config.py:610 -#, python-format -msgid "Table %s" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: config.py:611 -#, python-format -msgid "Listing %s" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: config.py:718 -msgid "" -"The config value `{name}` has to be a one of {candidates}, but `{current}` " -"is given." +#: environment/__init__.py:952 +#, python-format +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: config.py:742 -msgid "" -"The config value `{name}' has type `{current.__name__}'; expected " -"{permitted}." +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: config.py:755 -msgid "" -"The config value `{name}' has type `{current.__name__}', defaults to " -"`{default.__name__}'." +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: config.py:766 -#, python-format -msgid "primary_domain %r not found, ignored." +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: config.py:778 -msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: domains/rst.py:128 domains/rst.py:185 -#, python-format -msgid "%s (directive)" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: domains/rst.py:186 domains/rst.py:190 -#, python-format -msgid ":%s: (directive option)" +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: domains/rst.py:214 -#, python-format -msgid "%s (role)" +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: domains/rst.py:224 -msgid "directive" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: domains/rst.py:225 -msgid "directive-option" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: domains/rst.py:226 -msgid "role" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: domains/rst.py:248 +#: builders/texinfo.py:41 #, python-format -msgid "duplicate description of %s %s, other instance in %s" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: domains/javascript.py:165 -#, python-format -msgid "%s() (built-in function)" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: domains/javascript.py:166 domains/python/__init__.py:253 -#, python-format -msgid "%s() (%s method)" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: domains/javascript.py:168 +#: builders/texinfo.py:85 #, python-format -msgid "%s() (class)" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: domains/javascript.py:170 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "%s (global variable or constant)" +msgid "processing %s" msgstr "" -#: domains/javascript.py:172 domains/python/__init__.py:338 -#, python-format -msgid "%s (%s attribute)" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: domains/javascript.py:255 -msgid "Arguments" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: domains/cpp/__init__.py:447 domains/javascript.py:258 -msgid "Throws" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: domains/c/__init__.py:310 domains/cpp/__init__.py:458 -#: domains/javascript.py:261 domains/python/_object.py:176 -msgid "Returns" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: domains/c/__init__.py:312 domains/javascript.py:263 -#: domains/python/_object.py:178 -msgid "Return type" +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 +#, python-format +msgid "cannot copy image file %r: %s" msgstr "" -#: domains/javascript.py:334 -#, python-format -msgid "%s (module)" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: domains/c/__init__.py:681 domains/cpp/__init__.py:859 -#: domains/javascript.py:371 domains/python/__init__.py:660 -msgid "function" +#: builders/texinfo.py:218 +#, python-format +msgid "error writing file Makefile: %s" msgstr "" -#: domains/javascript.py:372 domains/python/__init__.py:664 -msgid "method" +#: builders/manpage.py:37 +#, python-format +msgid "The manual pages are in %(outdir)s." msgstr "" -#: domains/cpp/__init__.py:857 domains/javascript.py:373 -#: domains/python/__init__.py:662 -msgid "class" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: domains/javascript.py:374 domains/python/__init__.py:661 -msgid "data" +#: builders/manpage.py:64 +#, python-format +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: domains/javascript.py:375 domains/python/__init__.py:667 -msgid "attribute" +#: builders/singlehtml.py:35 +#, python-format +msgid "The HTML page is in %(outdir)s." msgstr "" -#: domains/javascript.py:376 domains/python/__init__.py:670 -msgid "module" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: domains/javascript.py:407 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: domains/changeset.py:25 -#, python-format -msgid "Added in version %s" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: domains/changeset.py:26 +#: builders/gettext.py:243 #, python-format -msgid "Changed in version %s" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: domains/changeset.py:27 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "Deprecated since version %s" +msgid "building [%s]: " msgstr "" -#: domains/changeset.py:28 +#: builders/gettext.py:265 #, python-format -msgid "Removed in version %s" +msgid "targets for %d template files" msgstr "" -#: domains/__init__.py:299 -#, python-format -msgid "%s %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: domains/citation.py:73 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: domains/citation.py:84 +#: builders/linkcheck.py:87 #, python-format -msgid "Citation [%s] is not referenced." +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: domains/math.py:63 +#: builders/linkcheck.py:159 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "broken link: %s (%s)" msgstr "" -#: domains/math.py:119 writers/latex.py:2479 +#: builders/linkcheck.py:561 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "Anchor '%s' not found" msgstr "" -#: environment/__init__.py:81 -msgid "new config" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: environment/__init__.py:82 -msgid "config changed" +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: environment/__init__.py:83 -msgid "extensions changed" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: environment/__init__.py:249 -msgid "build environment version not current" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: environment/__init__.py:251 -msgid "source directory has changed" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:313 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: environment/__init__.py:318 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:324 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:366 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:473 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:626 -#, python-format -msgid "Domain %r is not registered" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:777 -msgid "document isn't included in any toctree" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:810 -msgid "self referenced toctree found. Ignored." +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: environment/__init__.py:839 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: locale/__init__.py:229 -msgid "Attention" +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" msgstr "" -#: locale/__init__.py:230 -msgid "Caution" +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." msgstr "" -#: locale/__init__.py:231 -msgid "Danger" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: locale/__init__.py:232 -msgid "Error" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: locale/__init__.py:233 -msgid "Hint" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: locale/__init__.py:234 -msgid "Important" +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" msgstr "" -#: locale/__init__.py:235 -msgid "Note" +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" msgstr "" -#: locale/__init__.py:236 -msgid "See also" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: locale/__init__.py:237 -msgid "Tip" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: locale/__init__.py:238 -msgid "Warning" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: cmd/quickstart.py:43 -msgid "automatically insert docstrings from modules" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: cmd/quickstart.py:44 -msgid "automatically test code snippets in doctest blocks" +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: cmd/quickstart.py:45 -msgid "link between Sphinx documentation of different projects" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: cmd/quickstart.py:46 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." msgstr "" -#: cmd/quickstart.py:47 -msgid "checks for documentation coverage" +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." msgstr "" -#: cmd/quickstart.py:48 -msgid "include math, rendered as PNG or SVG images" +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:49 -msgid "include math, rendered in the browser by MathJax" +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: cmd/quickstart.py:50 -msgid "conditional inclusion of content based on config values" +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" msgstr "" -#: cmd/quickstart.py:51 -msgid "include links to the source code of documented Python objects" +#: builders/__init__.py:260 +msgid "building [mo]: " msgstr "" -#: cmd/quickstart.py:52 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " msgstr "" -#: cmd/quickstart.py:94 -msgid "Please enter a valid path name." +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter some text." +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" msgstr "" -#: cmd/quickstart.py:117 +#: builders/__init__.py:314 #, python-format -msgid "Please enter one of %s." +msgid "targets for %d po files that are out of date" msgstr "" -#: cmd/quickstart.py:125 -msgid "Please enter either 'y' or 'n'." +#: builders/__init__.py:324 +msgid "all source files" msgstr "" -#: cmd/quickstart.py:131 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: cmd/quickstart.py:215 +#: builders/__init__.py:342 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "" +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: cmd/quickstart.py:219 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: cmd/quickstart.py:227 +#: builders/__init__.py:366 #, python-format -msgid "Selected root path: %s" +msgid "%d source files given on command line" msgstr "" -#: cmd/quickstart.py:230 -msgid "Enter the root path for documentation." +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" msgstr "" -#: cmd/quickstart.py:231 -msgid "Root path for the documentation" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " msgstr "" -#: cmd/quickstart.py:239 -msgid "Error: an existing conf.py has been found in the selected root path." +#: builders/__init__.py:415 +#, python-format +msgid "%d found" msgstr "" -#: cmd/quickstart.py:245 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: builders/__init__.py:417 +msgid "none found" msgstr "" -#: cmd/quickstart.py:248 -msgid "Please enter a new root path (or just Enter to exit)" +#: builders/__init__.py:424 +msgid "pickling environment" msgstr "" -#: cmd/quickstart.py:258 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: builders/__init__.py:431 +msgid "checking consistency" msgstr "" -#: cmd/quickstart.py:265 -msgid "Separate source and build directories (y/n)" +#: builders/__init__.py:435 +msgid "no targets are out of date." msgstr "" -#: cmd/quickstart.py:271 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: builders/__init__.py:474 +msgid "updating environment: " msgstr "" -#: cmd/quickstart.py:277 -msgid "Name prefix for templates and static dir" +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: cmd/quickstart.py:282 +#: builders/__init__.py:536 +#, python-format msgid "" -"The project name will occur in several places in the built documentation." +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: cmd/quickstart.py:286 -msgid "Project name" +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: cmd/quickstart.py:288 -msgid "Author name(s)" +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: cmd/quickstart.py:293 +#: builders/__init__.py:563 +#, python-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." msgstr "" -#: cmd/quickstart.py:301 -msgid "Project version" +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " msgstr "" -#: cmd/quickstart.py:303 -msgid "Project release" +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: builders/__init__.py:727 +msgid "no docnames to write!" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project language" +#: builders/__init__.py:740 +msgid "preparing documents" msgstr "" -#: cmd/quickstart.py:324 +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +"the following modules are documented but were not specified in " +"coverage_modules: %s" msgstr "" -#: cmd/quickstart.py:329 -msgid "Source file suffix" +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" msgstr "" -#: cmd/quickstart.py:334 +#: ext/coverage.py:172 +#, python-brace-format, python-format msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." msgstr "" -#: cmd/quickstart.py:342 -msgid "Name of your master document (without suffix)" +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" msgstr "" -#: cmd/quickstart.py:352 +#: ext/coverage.py:260 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "undocumented c api: %s [%s] in file %s" msgstr "" -#: cmd/quickstart.py:359 -msgid "sphinx-quickstart will not overwrite the existing file." +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" msgstr "" -#: cmd/quickstart.py:362 +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "" + +#: ext/extlinks.py:82 +#, python-format msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: cmd/quickstart.py:371 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" msgstr "" -#: cmd/quickstart.py:381 +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + +#: ext/imgconverter.py:44 +#, python-format msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" msgstr "" -#: cmd/quickstart.py:391 +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:397 -msgid "Create Makefile? (y/n)" +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" -#: cmd/quickstart.py:401 -msgid "Create Windows command file? (y/n)" +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" -#: cmd/quickstart.py:453 ext/apidoc.py:92 +#: ext/graphviz.py:153 #, python-format -msgid "Creating file %s." +msgid "External Graphviz file %r not found or reading it failed" msgstr "" -#: cmd/quickstart.py:458 ext/apidoc.py:89 +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "" + +#: ext/graphviz.py:287 #, python-format -msgid "File %s already exists, skipping." +msgid "graphviz_dot executable path must be set! %r" msgstr "" -#: cmd/quickstart.py:501 -msgid "Finished: An initial directory structure has been created." +#: ext/graphviz.py:328 +#, python-format +msgid "" +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" msgstr "" -#: cmd/quickstart.py:504 +#: ext/graphviz.py:339 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:512 +#: ext/graphviz.py:344 +#, python-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "" + +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" +msgstr "" + +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" +msgstr "" + +#: ext/graphviz.py:493 ext/graphviz.py:501 +#, python-format +msgid "[graph: %s]" +msgstr "" + +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" msgstr "" -#: cmd/quickstart.py:515 +#: ext/imgmath.py:148 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: cmd/quickstart.py:522 +#: ext/imgmath.py:167 +#, python-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "" + +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "" + +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" + +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" + +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "" + +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "" + +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" msgstr "" -#: cmd/quickstart.py:557 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "" + +#: ext/doctest.py:297 +#, python-format msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: cmd/build.py:153 cmd/quickstart.py:567 ext/apidoc.py:374 -#: ext/autosummary/generate.py:766 -msgid "For more information, visit ." +#: ext/doctest.py:451 +#, python-format +msgid "no code/output in %s block at %s:%s" msgstr "" -#: cmd/quickstart.py:577 -msgid "quiet mode" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: cmd/quickstart.py:587 -msgid "project root" +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: cmd/quickstart.py:590 -msgid "Structure options" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: cmd/quickstart.py:596 -msgid "if specified, separate source and build dirs" +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: cmd/quickstart.py:602 -msgid "if specified, create build dir under source dir" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: cmd/quickstart.py:608 -msgid "replacement for dot in _templates etc." +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: cmd/quickstart.py:611 -msgid "Project basic options" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: cmd/quickstart.py:613 -msgid "project name" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: cmd/quickstart.py:616 -msgid "author names" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: cmd/quickstart.py:623 -msgid "version of project" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: cmd/quickstart.py:630 -msgid "release of project" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: cmd/quickstart.py:637 -msgid "document language" +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: cmd/quickstart.py:640 -msgid "source file suffix" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " msgstr "" -#: cmd/quickstart.py:643 -msgid "master document name" +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: cmd/quickstart.py:646 -msgid "use epub" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "" + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" +msgstr "" + +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." +msgstr "" + +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" +msgstr "" + +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "" + +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "" + +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "" + +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" msgstr "" -#: cmd/quickstart.py:649 -msgid "Extension options" +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" msgstr "" -#: cmd/quickstart.py:656 ext/apidoc.py:578 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "enable %s extension" +msgid "%s (%s attribute)" msgstr "" -#: cmd/quickstart.py:663 ext/apidoc.py:570 -msgid "enable arbitrary extensions" +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: cmd/quickstart.py:666 -msgid "Makefile and Batchfile creation" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: cmd/quickstart.py:672 -msgid "create makefile" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: cmd/quickstart.py:678 -msgid "do not create makefile" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: cmd/quickstart.py:685 -msgid "create batchfile" +#: domains/javascript.py:374 +#, python-format +msgid "%s (module)" msgstr "" -#: cmd/quickstart.py:691 -msgid "do not create batchfile" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: cmd/quickstart.py:700 -msgid "use make-mode for Makefile/make.bat" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: cmd/quickstart.py:703 ext/apidoc.py:581 -msgid "Project templating" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: cmd/quickstart.py:709 ext/apidoc.py:587 -msgid "template directory for template files" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: cmd/quickstart.py:716 -msgid "define a template variable" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: cmd/quickstart.py:751 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: cmd/quickstart.py:770 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: cmd/quickstart.py:777 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: cmd/quickstart.py:795 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "Invalid template variable: %s" +msgid ":%s: (directive option)" msgstr "" -#: cmd/build.py:49 -msgid "Exception occurred while building, starting debugger:" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: _cli/util/errors.py:129 cmd/build.py:65 -msgid "Interrupted!" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: cmd/build.py:67 -msgid "reST markup error:" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: _cli/util/errors.py:143 cmd/build.py:73 -msgid "Encoding error:" +#: domains/rst.py:236 +msgid "role" msgstr "" -#: cmd/build.py:78 cmd/build.py:108 +#: domains/rst.py:262 #, python-format -msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:148 cmd/build.py:90 -msgid "Recursion error:" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" msgstr "" -#: _cli/util/errors.py:152 cmd/build.py:94 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" msgstr "" -#: _cli/util/errors.py:165 cmd/build.py:103 -msgid "Exception occurred:" +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" msgstr "" -#: _cli/util/errors.py:178 cmd/build.py:117 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: cmd/build.py:124 -msgid "" -"A bug report can be filed in the tracker at . Thanks!" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" msgstr "" -#: cmd/build.py:144 +#: cmd/build.py:64 msgid "job number should be a positive number" msgstr "" -#: cmd/build.py:154 +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" + +#: cmd/build.py:74 msgid "" "\n" "Generate documentation from source files.\n" @@ -1339,675 +1640,589 @@ msgid "" "files can be built by specifying individual filenames.\n" msgstr "" -#: cmd/build.py:180 +#: cmd/build.py:100 msgid "path to documentation source files" msgstr "" -#: cmd/build.py:183 +#: cmd/build.py:103 msgid "path to output directory" msgstr "" -#: cmd/build.py:188 +#: cmd/build.py:109 msgid "" "(optional) a list of specific files to rebuild. Ignored if --write-all is " "specified" msgstr "" -#: cmd/build.py:194 +#: cmd/build.py:114 msgid "general options" msgstr "" -#: cmd/build.py:201 +#: cmd/build.py:121 msgid "builder to use (default: 'html')" msgstr "" -#: cmd/build.py:210 +#: cmd/build.py:131 msgid "" "run in parallel with N processes, when possible. 'auto' uses the number of " "CPU cores" msgstr "" -#: cmd/build.py:220 +#: cmd/build.py:140 msgid "write all files (default: only write new and changed files)" msgstr "" -#: cmd/build.py:227 +#: cmd/build.py:147 msgid "don't use a saved environment, always read all files" msgstr "" -#: cmd/build.py:230 +#: cmd/build.py:150 msgid "path options" msgstr "" -#: cmd/build.py:236 +#: cmd/build.py:157 msgid "" "directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: cmd/build.py:246 +#: cmd/build.py:166 msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: cmd/build.py:255 +#: cmd/build.py:175 msgid "use no configuration file, only use settings from -D options" msgstr "" -#: cmd/build.py:264 +#: cmd/build.py:184 msgid "override a setting in configuration file" msgstr "" -#: cmd/build.py:273 +#: cmd/build.py:193 msgid "pass a value into HTML templates" msgstr "" -#: cmd/build.py:282 +#: cmd/build.py:202 msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: cmd/build.py:289 +#: cmd/build.py:209 msgid "nitpicky mode: warn about all missing references" msgstr "" -#: cmd/build.py:292 +#: cmd/build.py:212 msgid "console output options" msgstr "" -#: cmd/build.py:299 +#: cmd/build.py:219 msgid "increase verbosity (can be repeated)" msgstr "" -#: cmd/build.py:306 ext/apidoc.py:413 +#: cmd/build.py:226 ext/apidoc/_cli.py:66 msgid "no output on stdout, just warnings on stderr" msgstr "" -#: cmd/build.py:313 +#: cmd/build.py:233 msgid "no output at all, not even warnings" msgstr "" -#: cmd/build.py:321 +#: cmd/build.py:241 msgid "do emit colored output (default: auto-detect)" msgstr "" -#: cmd/build.py:329 +#: cmd/build.py:249 msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: cmd/build.py:332 +#: cmd/build.py:252 msgid "warning control options" msgstr "" -#: cmd/build.py:338 +#: cmd/build.py:258 msgid "write warnings (and errors) to given file" msgstr "" -#: cmd/build.py:345 +#: cmd/build.py:265 msgid "turn warnings into errors" msgstr "" -#: cmd/build.py:353 +#: cmd/build.py:273 msgid "show full traceback on exception" msgstr "" -#: cmd/build.py:356 +#: cmd/build.py:276 msgid "run Pdb on exception" msgstr "" -#: cmd/build.py:362 +#: cmd/build.py:282 msgid "raise an exception on warnings" msgstr "" -#: cmd/build.py:405 +#: cmd/build.py:325 msgid "cannot combine -a option and filenames" msgstr "" -#: cmd/build.py:437 +#: cmd/build.py:357 #, python-format msgid "cannot open warning file '%s': %s" msgstr "" -#: cmd/build.py:456 +#: cmd/build.py:376 msgid "-D option argument must be in the form name=value" msgstr "" -#: cmd/build.py:463 +#: cmd/build.py:383 msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "" - -#: builders/linkcheck.py:75 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/linkcheck.py:146 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/linkcheck.py:540 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/linkcheck.py:742 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/singlehtml.py:37 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/singlehtml.py:173 -msgid "assembling single document" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/latex/__init__.py:346 builders/manpage.py:56 -#: builders/singlehtml.py:178 builders/texinfo.py:121 -msgid "writing" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/singlehtml.py:191 -msgid "writing additional files" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/manpage.py:39 -#, python-format -msgid "The manual pages are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/manpage.py:47 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/manpage.py:73 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/text.py:34 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/html/__init__.py:1239 builders/text.py:81 builders/xml.py:97 +#: cmd/quickstart.py:134 #, python-format -msgid "error writing file %s: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/xml.py:38 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/xml.py:110 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/texinfo.py:47 +#: cmd/quickstart.py:230 #, python-format -msgid "The Texinfo files are in %(outdir)s." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/texinfo.py:49 +#: cmd/quickstart.py:235 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "" - -#: builders/texinfo.py:78 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:90 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:324 builders/texinfo.py:115 -#, python-format -msgid "processing %s" -msgstr "" - -#: builders/latex/__init__.py:404 builders/texinfo.py:174 -msgid "resolving references..." -msgstr "" - -#: builders/latex/__init__.py:415 builders/texinfo.py:184 -msgid " (in " -msgstr "" - -#: builders/_epub_base.py:423 builders/html/__init__.py:778 -#: builders/latex/__init__.py:482 builders/texinfo.py:202 -msgid "copying images... " -msgstr "" - -#: builders/_epub_base.py:445 builders/latex/__init__.py:497 -#: builders/texinfo.py:219 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "" - -#: builders/texinfo.py:226 -msgid "copying Texinfo support files" -msgstr "" - -#: builders/texinfo.py:234 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "" - -#: builders/gettext.py:230 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "" - -#: builders/__init__.py:383 builders/gettext.py:251 -#, python-format -msgid "building [%s]: " -msgstr "" - -#: builders/gettext.py:252 -#, python-format -msgid "targets for %d template files" -msgstr "" - -#: builders/gettext.py:257 -msgid "reading templates... " -msgstr "" - -#: builders/gettext.py:292 -msgid "writing message catalogs... " -msgstr "" - -#: builders/__init__.py:212 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/__init__.py:220 +#: cmd/quickstart.py:242 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "Selected root path: %s" msgstr "" -#: builders/__init__.py:243 -msgid "building [mo]: " +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/__init__.py:246 builders/__init__.py:741 builders/__init__.py:773 -msgid "writing output... " +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/__init__.py:263 -#, python-format -msgid "all of %d po files" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/__init__.py:285 -#, python-format -msgid "targets for %d po files that are specified" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are out of date" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/__init__.py:307 -msgid "all source files" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/__init__.py:319 -#, python-format -msgid "file %r given on command line does not exist, " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/__init__.py:325 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"file %r given on command line is not under the source directory, ignoring" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/__init__.py:336 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/__init__.py:351 -#, python-format -msgid "%d source files given on command line" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/__init__.py:366 -#, python-format -msgid "targets for %d source files that are out of date" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/__init__.py:394 -msgid "looking for now-outdated files... " +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/__init__.py:398 -#, python-format -msgid "%d found" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/__init__.py:400 -msgid "none found" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/__init__.py:407 -msgid "pickling environment" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: builders/__init__.py:414 -msgid "checking consistency" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: builders/__init__.py:418 -msgid "no targets are out of date." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: builders/__init__.py:458 -msgid "updating environment: " +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: builders/__init__.py:483 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/__init__.py:519 -#, python-format +#: cmd/quickstart.py:350 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: builders/__init__.py:528 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: builders/__init__.py:539 +#: cmd/quickstart.py:368 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: builders/__init__.py:546 -#, python-format +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "" + +#: cmd/quickstart.py:378 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: builders/__init__.py:565 builders/__init__.py:581 -msgid "reading sources... " +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: builders/__init__.py:698 -#, python-format -msgid "docnames to write: %s" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: builders/__init__.py:711 -msgid "preparing documents" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: builders/__init__.py:714 -msgid "copying assets" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: builders/__init__.py:866 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: builders/epub3.py:83 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "The ePub file is in %(outdir)s." +msgid "Creating file %s." msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: builders/epub3.py:220 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: builders/epub3.py:231 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: builders/epub3.py:255 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1289 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: builders/_epub_base.py:222 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: builders/_epub_base.py:434 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: builders/_epub_base.py:465 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: builders/_epub_base.py:477 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: builders/_epub_base.py:512 -msgid "writing mimetype file..." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: builders/_epub_base.py:521 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: builders/_epub_base.py:590 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: builders/_epub_base.py:764 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: builders/_epub_base.py:793 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: builders/changes.py:33 +#: cmd/quickstart.py:671 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "enable %s extension" msgstr "" -#: builders/changes.py:60 -#, python-format -msgid "no changes in version %s." +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: builders/changes.py:62 -msgid "writing summary file..." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: builders/changes.py:74 -msgid "Builtins" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: builders/changes.py:76 -msgid "Module level" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: builders/changes.py:128 -msgid "copying source files..." +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: builders/changes.py:137 -#, python-format -msgid "could not read %r for changelog creation" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/rst.py:72 -#, python-format -msgid "default role %s not found" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/docfields.py:95 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/osutil.py:130 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: util/nodes.py:419 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: util/nodes.py:487 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: util/nodes.py:701 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/fileutil.py:74 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/fileutil.py:89 +#: cmd/quickstart.py:810 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/inventory.py:170 +#: directives/other.py:119 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/inventory.py:185 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/docutils.py:284 +#: directives/other.py:156 #, python-format -msgid "unknown directive or role name: %s:%s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/docutils.py:747 +#: directives/other.py:169 #, python-format -msgid "unknown node type: %r" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/display.py:81 -msgid "skipped" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/display.py:86 -msgid "failed" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: util/i18n.py:103 -#, python-format -msgid "reading error: %s, %s" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: util/i18n.py:110 -#, python-format -msgid "writing error: %s, %s" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: util/i18n.py:138 -#, python-format -msgid "locale_dir %s does not exist" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/i18n.py:230 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: directives/patches.py:66 +#: directives/patches.py:70 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." @@ -2022,7 +2237,7 @@ msgstr "" msgid "Invalid caption: %s" msgstr "" -#: directives/code.py:132 directives/code.py:297 directives/code.py:484 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" @@ -2037,7 +2252,7 @@ msgstr "" msgid "Include file '%s' not found or reading it failed" msgstr "" -#: directives/code.py:234 +#: directives/code.py:235 #, python-format msgid "" "Encoding %r used for reading included file '%s' seems to be wrong, try " @@ -2058,48 +2273,139 @@ msgstr "" msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: directives/other.py:122 -#, python-format -msgid "toctree glob pattern %r didn't match any documents" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "" + +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "" + +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "" + +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" +msgstr "" + +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "" + +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" + +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" + +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" + +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" + +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" + +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" + +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: directives/other.py:155 environment/adapters/toctree.py:355 +#: writers/latex.py:386 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: directives/other.py:158 environment/adapters/toctree.py:359 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "no Babel option known for language %r" msgstr "" -#: directives/other.py:171 -#, python-format -msgid "duplicated entry found in toctree: %s" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: directives/other.py:204 -msgid "Section author: " +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: directives/other.py:206 -msgid "Module author: " +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: directives/other.py:208 -msgid "Code author: " +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: directives/other.py:210 -msgid "Author: " +#: writers/latex.py:1228 +#, python-format +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: directives/other.py:284 -msgid ".. acks content is not a list" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: directives/other.py:309 -msgid ".. hlist content is not a list" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" #: _cli/__init__.py:73 @@ -2107,6 +2413,7 @@ msgid "Usage:" msgstr "" #: _cli/__init__.py:75 +#, python-brace-format msgid "{0} [OPTIONS] []" msgstr "" @@ -2122,1992 +2429,1876 @@ msgstr "" msgid "Options" msgstr "" -#: _cli/__init__.py:112 _cli/__init__.py:183 +#: _cli/__init__.py:113 _cli/__init__.py:181 msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: _cli/__init__.py:172 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" "{0}: error: {1}\n" "Run '{0} --help' for information" msgstr "" -#: _cli/__init__.py:182 +#: _cli/__init__.py:179 msgid " Manage documentation with Sphinx." msgstr "" -#: _cli/__init__.py:194 +#: _cli/__init__.py:191 msgid "Show the version and exit." msgstr "" -#: _cli/__init__.py:202 +#: _cli/__init__.py:199 msgid "Show this message and exit." msgstr "" -#: _cli/__init__.py:206 +#: _cli/__init__.py:203 msgid "Logging" msgstr "" -#: _cli/__init__.py:213 +#: _cli/__init__.py:210 msgid "Increase verbosity (can be repeated)" msgstr "" -#: _cli/__init__.py:221 +#: _cli/__init__.py:218 msgid "Only print errors and warnings." msgstr "" -#: _cli/__init__.py:228 +#: _cli/__init__.py:225 msgid "No output at all" msgstr "" -#: _cli/__init__.py:234 +#: _cli/__init__.py:231 msgid "" msgstr "" -#: _cli/__init__.py:265 +#: _cli/__init__.py:263 msgid "See 'sphinx --help'.\n" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:198 -#: transforms/__init__.py:133 writers/manpage.py:102 writers/texinfo.py:219 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:143 -msgid "could not calculate translation progress!" -msgstr "" - -#: transforms/__init__.py:148 -msgid "no translated elements!" -msgstr "" - -#: transforms/__init__.py:267 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "" - -#: transforms/__init__.py:313 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" - -#: transforms/__init__.py:322 -msgid "Footnote [*] is not referenced." -msgstr "" - -#: transforms/__init__.py:333 -msgid "Footnote [#] is not referenced." -msgstr "" - -#: transforms/i18n.py:228 transforms/i18n.py:303 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: transforms/i18n.py:273 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" -#: transforms/i18n.py:323 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: transforms/i18n.py:345 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: ext/linkcode.py:75 ext/viewcode.py:201 -msgid "[source]" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: ext/imgconverter.py:40 -#, python-format -msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: ext/imgconverter.py:49 ext/imgconverter.py:73 +#: transforms/__init__.py:258 #, python-format msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "" - -#: ext/imgconverter.py:68 -#, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "" - -#: ext/viewcode.py:258 -msgid "highlighting module code... " -msgstr "" - -#: ext/viewcode.py:286 -msgid "[docs]" -msgstr "" - -#: ext/viewcode.py:306 -msgid "Module code" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: ext/viewcode.py:312 +#: transforms/__init__.py:299 #, python-format -msgid "

        Source code for %s

        " +msgid "Footnote [%s] is not referenced." msgstr "" -#: ext/viewcode.py:338 -msgid "Overview: module code" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: ext/viewcode.py:339 -msgid "

        All modules for which code is available

        " +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: ext/coverage.py:47 +#: util/inventory.py:147 #, python-format -msgid "invalid regex %r in %s" +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: ext/coverage.py:134 ext/coverage.py:280 +#: util/inventory.py:166 #, python-format -msgid "module %s could not be imported: %s" +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: ext/coverage.py:141 +#: util/i18n.py:100 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "" - -#: ext/coverage.py:149 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +msgid "reading error: %s, %s" msgstr "" -#: ext/coverage.py:163 +#: util/i18n.py:113 #, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." +msgid "writing error: %s, %s" msgstr "" -#: ext/coverage.py:177 +#: util/i18n.py:146 #, python-format -msgid "invalid regex %r in coverage_c_regexes" +msgid "locale_dir %s does not exist" msgstr "" -#: ext/coverage.py:245 +#: util/i18n.py:244 #, python-format -msgid "undocumented c api: %s [%s] in file %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: ext/coverage.py:429 +#: util/i18n.py:253 #, python-format -msgid "undocumented python function: %s :: %s" +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: ext/coverage.py:445 +#: util/osutil.py:131 #, python-format -msgid "undocumented python class: %s :: %s" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: ext/coverage.py:458 -#, python-format -msgid "undocumented python method: %s :: %s :: %s" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: ext/todo.py:71 -msgid "Todo" +#: util/display.py:87 +msgid "failed" msgstr "" -#: ext/todo.py:104 +#: util/docutils.py:325 #, python-format -msgid "TODO entry found: %s" -msgstr "" - -#: ext/todo.py:163 -msgid "<>" +msgid "unknown directive name: %s" msgstr "" -#: ext/todo.py:165 +#: util/docutils.py:361 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "unknown role name: %s" msgstr "" -#: ext/todo.py:175 -msgid "original entry" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: ext/extlinks.py:82 +#: util/fileutil.py:76 #, python-format msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: ext/doctest.py:115 +#: util/fileutil.py:89 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "Writing evaluated template result to %s" msgstr "" -#: ext/doctest.py:120 +#: util/docfields.py:103 #, python-format -msgid "'%s' is not a valid option." +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: ext/doctest.py:134 +#: util/rst.py:73 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "" - -#: ext/doctest.py:220 -msgid "invalid TestCode type" +msgid "default role %s not found" msgstr "" -#: ext/doctest.py:281 +#: util/nodes.py:462 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: ext/doctest.py:434 +#: util/nodes.py:523 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: ext/doctest.py:522 +#: util/nodes.py:739 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "" - -#: ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: ext/graphviz.py:145 -#, python-format -msgid "External Graphviz file %r not found or reading it failed" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: ext/graphviz.py:268 -#, python-format -msgid "graphviz_dot executable path must be set! %r" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: ext/graphviz.py:303 -#, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: ext/graphviz.py:310 -#, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: ext/graphviz.py:313 -#, python-format -msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: ext/graphviz.py:329 -#, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: ext/graphviz.py:333 ext/graphviz.py:386 ext/graphviz.py:423 +#: transforms/post_transforms/images.py:79 #, python-format -msgid "dot code %r: %s" +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: ext/graphviz.py:436 ext/graphviz.py:444 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "[graph: %s]" -msgstr "" - -#: ext/graphviz.py:438 ext/graphviz.py:446 -msgid "[graph]" -msgstr "" - -#: ext/imgmath.py:369 ext/mathjax.py:52 -msgid "Link to this equation" +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: ext/apidoc.py:85 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "Would create file %s." -msgstr "" - -#: ext/apidoc.py:375 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "" - -#: ext/apidoc.py:392 -msgid "path to module to document" -msgstr "" - -#: ext/apidoc.py:396 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "" - -#: ext/apidoc.py:407 -msgid "directory to place all output" -msgstr "" - -#: ext/apidoc.py:422 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "" - -#: ext/apidoc.py:429 -msgid "overwrite existing files" -msgstr "" - -#: ext/apidoc.py:437 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "" - -#: ext/apidoc.py:446 -msgid "run the script without creating files" -msgstr "" - -#: ext/apidoc.py:453 -msgid "put documentation for each module on its own page" -msgstr "" - -#: ext/apidoc.py:460 -msgid "include \"_private\" modules" -msgstr "" - -#: ext/apidoc.py:467 -msgid "filename of table of contents (default: modules)" -msgstr "" - -#: ext/apidoc.py:474 -msgid "don't create a table of contents file" +msgid "Unknown image format: %s..." msgstr "" -#: ext/apidoc.py:481 +#: transforms/post_transforms/__init__.py:88 msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: ext/apidoc.py:492 -msgid "put module documentation before submodule documentation" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: ext/apidoc.py:498 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: ext/apidoc.py:508 -msgid "file suffix (default: rst)" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: ext/apidoc.py:515 ext/autosummary/generate.py:839 -msgid "Remove existing files in the output directory that were not generated" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: ext/apidoc.py:524 -msgid "generate a full project with sphinx-quickstart" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: ext/apidoc.py:531 -msgid "append module_path to sys.path, used when --full is given" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: ext/apidoc.py:538 -msgid "project name (default: root module name)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: ext/apidoc.py:545 -msgid "project author(s), used when --full is given" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: ext/apidoc.py:552 -msgid "project version, used when --full is given" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: ext/apidoc.py:559 -msgid "project release, used when --full is given, defaults to --doc-version" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: ext/apidoc.py:564 -msgid "extension options" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: ext/apidoc.py:638 -#, python-format -msgid "%s is not a directory." +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: ext/apidoc.py:710 ext/autosummary/generate.py:875 -#, python-format -msgid "Failed to remove %s: %s" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: ext/autosectionlabel.py:48 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: domains/std/__init__.py:703 domains/std/__init__.py:812 -#: ext/autosectionlabel.py:52 +#: themes/basic/layout.html:115 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "Search within %(docstitle)s" msgstr "" -#: ext/duration.py:85 -msgid "" -"====================== slowest reading durations =======================" +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: ext/imgmath.py:159 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: ext/imgmath.py:174 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: ext/imgmath.py:328 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "display latex %r: %s" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: ext/imgmath.py:362 +#: themes/basic/layout.html:201 #, python-format -msgid "inline latex %r: %s" -msgstr "" - -#: writers/latex.py:1090 writers/manpage.py:263 writers/texinfo.py:662 -msgid "Footnotes" +msgid "Last updated on %(last_updated)s." msgstr "" -#: writers/manpage.py:309 writers/text.py:936 +#: themes/basic/layout.html:204 #, python-format -msgid "[image: %s]" +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: writers/manpage.py:310 writers/text.py:937 -msgid "[image]" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: writers/html5.py:99 writers/html5.py:108 -msgid "Link to this definition" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: writers/html5.py:415 -#, python-format -msgid "numfig_format is not defined for %s" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: writers/html5.py:427 -#, python-format -msgid "Any IDs not assigned for %s node" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: writers/html5.py:482 -msgid "Link to this term" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" msgstr "" -#: writers/html5.py:525 writers/html5.py:530 -msgid "Link to this heading" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: writers/html5.py:535 -msgid "Link to this table" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" -#: writers/html5.py:549 writers/latex.py:1099 -#, python-format -msgid "unsupported rubric heading level: %s" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" msgstr "" -#: writers/html5.py:613 -msgid "Link to this code" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: writers/html5.py:615 -msgid "Link to this image" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" -#: writers/html5.py:617 -msgid "Link to this toctree" +#: themes/basic/defindex.html:4 +msgid "Overview" msgstr "" -#: writers/html5.py:758 -msgid "Could not obtain image size. :scale: option is ignored." +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" msgstr "" -#: builders/latex/__init__.py:205 domains/std/__init__.py:646 -#: domains/std/__init__.py:658 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:513 -msgid "Index" +#: themes/basic/defindex.html:9 +msgid "the documentation for" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:644 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +#: themes/basic/defindex.html:10 +msgid "last updated" msgstr "" -#: writers/texinfo.py:1216 -msgid "caption not inside a figure." +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" msgstr "" -#: writers/texinfo.py:1302 -#, python-format -msgid "unimplemented node type: %r" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" msgstr "" -#: writers/latex.py:360 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" msgstr "" -#: builders/latex/__init__.py:223 writers/latex.py:410 -#, python-format -msgid "no Babel option known for language %r" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" msgstr "" -#: writers/latex.py:428 -msgid "too large :maxdepth:, ignored." +#: themes/basic/defindex.html:19 +msgid "search this documentation" msgstr "" -#: writers/latex.py:590 -#, python-format -msgid "template %s not found; loading from legacy %s instead" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" msgstr "" -#: writers/latex.py:708 -msgid "document title is not a single Text node" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" msgstr "" -#: writers/latex.py:1175 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" msgstr "" -#: writers/latex.py:1573 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" msgstr "" -#: writers/latex.py:1931 -#, python-format -msgid "unknown index entry type %s found" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: domains/std/__init__.py:87 domains/std/__init__.py:104 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "environment variable; %s" +msgid "Search %(docstitle)s" msgstr "" -#: domains/std/__init__.py:112 -#, python-format -msgid "%s; configuration value" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" msgstr "" -#: domains/std/__init__.py:166 -msgid "Type" +#: themes/basic/genindex-split.html:17 +msgid "can be huge" msgstr "" -#: domains/std/__init__.py:176 -msgid "Default" +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." msgstr "" -#: domains/std/__init__.py:235 -#, python-format +#: themes/basic/search.html:28 msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" +"Searching for multiple words only shows matches that contain\n" +" all words." msgstr "" -#: domains/std/__init__.py:306 -#, python-format -msgid "%s command line option" +#: themes/basic/search.html:35 +msgid "search" msgstr "" -#: domains/std/__init__.py:308 -msgid "command line option" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: domains/std/__init__.py:430 -msgid "glossary term must be preceded by empty line" +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" msgstr "" -#: domains/std/__init__.py:438 -msgid "glossary terms must not be separated by empty lines" +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." msgstr "" -#: domains/std/__init__.py:444 domains/std/__init__.py:457 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" -#: domains/std/__init__.py:602 -msgid "glossary term" +#: themes/basic/static/searchtools.js:276 +msgid "Searching" msgstr "" -#: domains/std/__init__.py:603 -msgid "grammar token" +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." msgstr "" -#: domains/std/__init__.py:604 -msgid "reference label" +#: themes/basic/static/searchtools.js:526 +msgid ", in " msgstr "" -#: domains/std/__init__.py:607 -msgid "environment variable" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" -#: domains/std/__init__.py:608 -msgid "program option" +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 +#, python-format +msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" -#: domains/std/__init__.py:609 -msgid "document" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" msgstr "" -#: domains/std/__init__.py:647 domains/std/__init__.py:659 -msgid "Module Index" +#: themes/basic/changes/versionchanges.html:17 +#, python-format +msgid "Automatically generated list of changes in version %(version)s" msgstr "" -#: domains/std/__init__.py:648 domains/std/__init__.py:660 -#: themes/basic/defindex.html:18 -msgid "Search Page" +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" msgstr "" -#: domains/std/__init__.py:722 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" msgstr "" -#: domains/std/__init__.py:932 -msgid "numfig is disabled. :numref: is ignored." +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" msgstr "" -#: domains/std/__init__.py:940 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" msgstr "" -#: domains/std/__init__.py:952 -#, python-format -msgid "the link has no caption: %s" +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/std/__init__.py:966 -#, python-format -msgid "invalid numfig_format: %s (%r)" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/std/__init__.py:969 -#, python-format -msgid "invalid numfig_format: %s" +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" msgstr "" -#: domains/std/__init__.py:1200 -#, python-format -msgid "undefined label: %r" +#: domains/python/_object.py:206 +msgid "Variables" msgstr "" -#: domains/std/__init__.py:1202 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" +#: domains/python/_object.py:214 +msgid "Raises" msgstr "" -#: domains/python/__init__.py:107 domains/python/__init__.py:244 +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:167 domains/python/__init__.py:334 -#: domains/python/__init__.py:385 domains/python/__init__.py:424 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:169 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:194 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:195 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:249 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:251 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:389 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:428 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:559 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:560 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:637 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:663 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:665 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:666 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:668 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:669 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:729 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:858 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:920 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:304 domains/cpp/__init__.py:441 -#: domains/python/_object.py:164 ext/napoleon/docstring.py:786 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:169 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:173 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" -#: domains/c/__init__.py:199 -#, python-format -msgid "%s (C %s)" +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" msgstr "" -#: domains/c/__init__.py:260 domains/c/_symbol.py:510 +#: domains/cpp/__init__.py:302 #, python-format -msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." +msgid "%s (C++ %s)" msgstr "" -#: domains/c/__init__.py:307 domains/cpp/__init__.py:454 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:679 domains/cpp/__init__.py:860 -msgid "member" -msgstr "" - -#: domains/c/__init__.py:680 -msgid "variable" +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" msgstr "" -#: domains/c/__init__.py:682 -msgid "macro" +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" msgstr "" -#: domains/c/__init__.py:683 -msgid "struct" +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" msgstr "" -#: domains/c/__init__.py:684 domains/cpp/__init__.py:858 -msgid "union" +#: domains/cpp/__init__.py:946 +msgid "concept" msgstr "" -#: domains/c/__init__.py:685 domains/cpp/__init__.py:863 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:686 domains/cpp/__init__.py:864 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:687 domains/cpp/__init__.py:861 -msgid "type" -msgstr "" - -#: domains/c/__init__.py:689 domains/cpp/__init__.py:866 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:155 -msgid "Template Parameters" +#: domains/cpp/__init__.py:954 +msgid "template parameter" msgstr "" -#: domains/cpp/__init__.py:277 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format -msgid "%s (C++ %s)" +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/cpp/__init__.py:360 domains/cpp/_symbol.py:793 +#: domains/c/__init__.py:211 #, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." +msgid "%s (C %s)" msgstr "" -#: domains/cpp/__init__.py:862 -msgid "concept" +#: domains/c/__init__.py:778 +msgid "variable" msgstr "" -#: domains/cpp/__init__.py:867 -msgid "template parameter" +#: domains/c/__init__.py:780 +msgid "macro" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: domains/std/__init__.py:116 +#, python-format +msgid "%s; configuration value" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" +#: domains/std/__init__.py:239 +#, python-format +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: themes/basic/layout.html:18 -msgid "Navigation" +#: domains/std/__init__.py:319 +#, python-format +msgid "%s command line option" msgstr "" -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: themes/basic/layout.html:124 -msgid "About these documents" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: themes/basic/genindex-split.html:17 -msgid "can be huge" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: themes/basic/defindex.html:4 -msgid "Overview" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: themes/basic/defindex.html:9 -msgid "the documentation for" +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: themes/basic/defindex.html:10 -msgid "last updated" +#: domains/std/__init__.py:1153 +#, python-format +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" msgstr "" -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: themes/basic/defindex.html:19 -msgid "search this documentation" +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: themes/basic/defindex.html:21 -msgid "Global Module Index" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: themes/basic/searchbox.html:4 -msgid "Quick search" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: themes/basic/search.html:35 -msgid "search" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: themes/basic/relations.html:6 -msgid "previous chapter" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: themes/basic/relations.html:11 -msgid "Next topic" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: themes/basic/relations.html:13 -msgid "next chapter" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" msgstr "" -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" +msgid "alias of %s" msgstr "" -#: themes/basic/changes/versionchanges.html:17 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Automatically generated list of changes in version %(version)s" +msgid "Bases: %s" msgstr "" -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" msgstr "" -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" msgstr "" -#: themes/basic/changes/rstsource.html:5 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "%(filename)s — %(docstitle)s" +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: themes/basic/static/searchtools.js:119 -msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: themes/basic/static/searchtools.js:123 -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" +msgstr "" -#: themes/basic/static/searchtools.js:253 -msgid "Searching" +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." msgstr "" -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: themes/basic/static/searchtools.js:474 -msgid ", in " +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: environment/collectors/asset.py:96 -#, python-format -msgid "image file not readable: %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: environment/collectors/asset.py:124 -#, python-format -msgid "image file %s not readable: %s" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: environment/collectors/asset.py:161 -#, python-format -msgid "download file not readable: %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: environment/collectors/toctree.py:258 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: environment/adapters/toctree.py:318 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: environment/adapters/toctree.py:342 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: environment/adapters/toctree.py:357 -#, python-format -msgid "toctree contains reference to non-included document %r" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: environment/adapters/indexentries.py:126 -#, python-format -msgid "see %s" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: environment/adapters/indexentries.py:136 -#, python-format -msgid "see also %s" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: environment/adapters/indexentries.py:144 -#, python-format -msgid "unknown index entry type %r" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: environment/adapters/indexentries.py:270 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/__init__.py:363 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/html/__init__.py:382 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: builders/html/__init__.py:695 -msgid "generating indices" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/html/__init__.py:710 -msgid "writing additional pages" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/html/__init__.py:793 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "%s is not a directory." msgstr "" -#: builders/html/__init__.py:805 -msgid "copying downloadable files... " +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/__init__.py:817 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/__init__.py:863 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:881 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/__init__.py:916 -msgid "copying static files" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/__init__.py:933 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "cannot copy static file %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/__init__.py:938 -msgid "copying extra files" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:948 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "cannot copy extra file %r" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/__init__.py:954 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "Failed to write build info file: %r" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/html/__init__.py:1003 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: builders/html/__init__.py:1051 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/html/__init__.py:1213 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/html/__init__.py:1222 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: builders/html/__init__.py:1255 -msgid "dumping object inventory" +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: builders/html/__init__.py:1263 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "dumping search index in %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1306 +#: ext/autosummary/generate.py:630 #, python-format -msgid "invalid js_file: %r, ignored" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: builders/html/__init__.py:1339 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/autosummary/generate.py:634 +#, python-format +msgid "[autosummary] writing to %s" msgstr "" -#: builders/html/__init__.py:1344 +#: ext/autosummary/generate.py:679 #, python-format -msgid "Unknown math_renderer %r is given." +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1358 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: builders/html/__init__.py:1363 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: builders/html/__init__.py:1378 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: builders/html/__init__.py:1383 +#: ext/autosummary/generate.py:915 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1394 builders/latex/__init__.py:504 +#: ext/autosummary/generate.py:923 #, python-format -msgid "logo file %r does not exist" +msgid "custom template directory (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1405 +#: ext/autosummary/generate.py:931 #, python-format -msgid "favicon file %r does not exist" +msgid "document imported members (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1417 +#: ext/autosummary/generate.py:940 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: builders/html/__init__.py:1430 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: builders/html/__init__.py:1447 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "%s %s documentation" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: builders/latex/transforms.py:118 -msgid "Failed to get a docname!" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: builders/latex/transforms.py:119 +#: ext/autosummary/__init__.py:329 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/latex/transforms.py:485 +#: ext/autosummary/__init__.py:358 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "failed to import object %s" msgstr "" -#: builders/latex/__init__.py:117 +#: ext/autosummary/__init__.py:652 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "" - -#: builders/latex/__init__.py:119 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "" - -#: builders/latex/__init__.py:157 -msgid "no \"latex_documents\" config value found; no documents will be written" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: builders/latex/__init__.py:169 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "autosummary_generate: file not found: %s" msgstr "" -#: builders/latex/__init__.py:208 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: builders/latex/__init__.py:429 -msgid "copying TeX support files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: builders/latex/__init__.py:466 -msgid "copying additional files" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: builders/latex/__init__.py:540 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: builders/latex/__init__.py:548 +#: ext/intersphinx/_load.py:94 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: builders/latex/theming.py:87 +#: ext/intersphinx/_load.py:103 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: builders/latex/theming.py:90 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: _cli/util/errors.py:124 -msgid "Exception occurred, starting debugger:" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: _cli/util/errors.py:133 -msgid "reStructuredText markup error:" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: _cli/util/errors.py:168 -msgid "The full traceback has been saved in:" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: _cli/util/errors.py:172 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: transforms/post_transforms/__init__.py:125 +#: ext/intersphinx/_load.py:324 msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: transforms/post_transforms/__init__.py:185 +#: ext/intersphinx/_load.py:332 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: transforms/post_transforms/__init__.py:251 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: transforms/post_transforms/__init__.py:257 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "%r reference target not found: %s" +msgid "(in %s %s)" msgstr "" -#: transforms/post_transforms/images.py:77 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "(in %s)" msgstr "" -#: transforms/post_transforms/images.py:94 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: transforms/post_transforms/images.py:141 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Unknown image format: %s..." +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/napoleon/docstring.py:707 -msgid "Example" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:708 -msgid "Examples" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/napoleon/__init__.py:344 ext/napoleon/docstring.py:752 -msgid "Keyword Arguments" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:768 -msgid "Notes" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/napoleon/docstring.py:777 -msgid "Other Parameters" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:813 -msgid "Receives" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/napoleon/docstring.py:817 -msgid "References" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:849 -msgid "Warns" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/napoleon/docstring.py:853 -msgid "Yields" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/napoleon/docstring.py:1015 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/napoleon/docstring.py:1022 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1029 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1036 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:256 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:258 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/autosummary/__init__.py:277 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/autosummary/__init__.py:330 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/__init__.py:344 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "failed to parse name %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/autosummary/__init__.py:349 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "failed to import object %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/autosummary/__init__.py:648 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format msgid "" -"Summarised items should not include the current module. Replace %r with %r." +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/autosummary/__init__.py:819 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/autosummary/__init__.py:827 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/autosummary/generate.py:215 ext/autosummary/generate.py:391 -#, python-format -msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/autosummary/generate.py:526 +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/autosummary/generate.py:530 +#: builders/html/__init__.py:337 #, python-format -msgid "[autosummary] writing to %s" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/autosummary/generate.py:572 +#: builders/html/__init__.py:372 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/autosummary/generate.py:767 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/autosummary/generate.py:789 -msgid "source files to generate rST files for" +#: builders/html/__init__.py:549 +#, python-format +msgid "Logo of %s" msgstr "" -#: ext/autosummary/generate.py:797 -msgid "directory to place all output in" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/autosummary/generate.py:805 -#, python-format -msgid "default suffix for files (default: %(default)s)" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/autosummary/generate.py:813 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/autosummary/generate.py:821 -#, python-format -msgid "document imported members (default: %(default)s)" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/autosummary/generate.py:829 +#: builders/html/__init__.py:783 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:47 -#, python-format -msgid "(in %s v%s)" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:807 #, python-format -msgid "(in %s)" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:103 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:113 +#: builders/html/__init__.py:871 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:359 -#, python-format -msgid "inventory for external cross-reference not found: %r" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:367 +#: builders/html/__init__.py:923 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "cannot copy static file %r" msgstr "" -#: ext/intersphinx/_resolve.py:378 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_resolve.py:585 +#: builders/html/__init__.py:938 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:59 +#: builders/html/__init__.py:944 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_load.py:70 -#, python-format +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:81 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:92 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:101 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:120 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:155 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:240 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:265 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:275 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:319 +#: builders/html/__init__.py:1365 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/type_comment.py:132 +#: builders/html/__init__.py:1370 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/type_comment.py:135 +#: builders/html/__init__.py:1385 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:142 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:415 +#: builders/html/__init__.py:1412 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:532 +#: builders/html/__init__.py:1425 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:807 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:902 +#: builders/html/__init__.py:1454 #, python-format -msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +msgid "%s %s documentation" msgstr "" -#: ext/autodoc/__init__.py:946 +#: builders/latex/theming.py:87 #, python-format -msgid "A mocked object is detected: %r" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:965 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1028 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1035 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1048 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1114 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "" + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1337 ext/autodoc/__init__.py:1414 -#: ext/autodoc/__init__.py:2829 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1633 +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1760 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1774 +#: environment/collectors/toctree.py:259 #, python-format -msgid "missing attribute %s in object %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1855 ext/autodoc/__init__.py:1892 -#: ext/autodoc/__init__.py:1987 +#: environment/collectors/asset.py:98 #, python-format -msgid "alias of %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1875 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of TypeVar(%s)" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2217 ext/autodoc/__init__.py:2317 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2448 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/preserve_defaults.py:190 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/hr/LC_MESSAGES/sphinx.mo b/sphinx/locale/hr/LC_MESSAGES/sphinx.mo index 99c0c40f778..5ca40d4685c 100644 Binary files a/sphinx/locale/hr/LC_MESSAGES/sphinx.mo and b/sphinx/locale/hr/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/hr/LC_MESSAGES/sphinx.po b/sphinx/locale/hr/LC_MESSAGES/sphinx.po index 96a08c526e9..f13b61fd2f6 100644 --- a/sphinx/locale/hr/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/hr/LC_MESSAGES/sphinx.po @@ -1,5 +1,5 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: @@ -8,153 +8,300 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-29 22:39+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Mario Šarić, 2015-2020\n" "Language-Team: Croatian (http://app.transifex.com/sphinx-doc/sphinx-1/language/hr/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" "Language: hr\n" "Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" -#: events.py:77 +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "postavka %s.%s ne pojavljuje se u pretraženim konfiguracijama tema" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "datoteka %r iz teme nije ispravna (zip) arhiva ili ne sadrži temu" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "" + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "Ovaj projekt treba proširenje %s najmanje u verziji %si stoga se ne može izraditi s postojećom verzijom (%s)." + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 #, python-format msgid "Event %r already present" msgstr "Događaj %r već postoji" -#: events.py:370 +#: events.py:386 #, python-format msgid "Unknown event name: %s" msgstr "Nepoznato ime događaja: %s" -#: events.py:416 +#: events.py:451 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" -#: application.py:190 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Nema izvornog direktorija (%s)" -#: application.py:194 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:198 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Izvorni i odredišni direktorij ne smiju biti jednaki" -#: application.py:228 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Izrada pomoću Sphinx v%s" -#: application.py:250 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Ovaj projekt se ne može izgraditi s instaliranom verzijom, potrebno je instalirati Sphinx v%s ili višu verziju." -#: application.py:266 +#: application.py:305 msgid "making output directory" msgstr "izrada izlazne mape" -#: application.py:271 registry.py:452 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:277 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' koji je postavljen u conf.py nije moguće pozvati. Molimo izmijenite definiciju 'setup' funkcije kako bi ju mogli izvršiti iz Pythona. Ovo je potrebno kako bi conf.py imao karakter Sphinx proširenja. " -#: application.py:312 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "učitavanje prijevoda [%s]... " -#: application.py:329 util/display.py:88 +#: application.py:384 util/display.py:89 msgid "done" msgstr "napravljeno" -#: application.py:331 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:345 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:353 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "neuspješno: %s" -#: application.py:366 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Nije odabran format, koristi se zadani: html" -#: application.py:398 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:400 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:404 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:407 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:409 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:414 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:417 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:419 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:968 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1047 +#: application.py:1113 #, python-format -msgid "directive %r is already registered, it will be overridden" +msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1069 application.py:1094 +#: application.py:1139 application.py:1167 #, python-format -msgid "role %r is already registered, it will be overridden" +msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1644 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +309,12 @@ msgid "" "explicit" msgstr "%s proširenje nema deklaraciju paralelnog čitanja, uz pretpostavku da nije - zamolite autora za provjeru i postavljanje deklaracije" -#: application.py:1648 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1651 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,645 +322,357 @@ msgid "" "explicit" msgstr "%s proširenje nema deklaraciju paralelnog čitanja, uz pretpostavku da nije - zamolite autora za provjeru i postavljanje deklaracije" -#: application.py:1655 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1663 application.py:1667 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: roles.py:208 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:231 -#, python-format -msgid "invalid CVE number %s" -msgstr "" - -#: roles.py:253 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" - -#: roles.py:276 -#, python-format -msgid "invalid CWE number %s" -msgstr "" - -#: roles.py:296 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:319 -#, python-format -msgid "invalid PEP number %s" -msgstr "" - -#: roles.py:357 -#, python-format -msgid "invalid RFC number %s" -msgstr "" - -#: registry.py:144 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Klasa %s nema \"name\" svojstvo" -#: registry.py:146 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Builder %r već postoji (u modulu %s)" -#: registry.py:159 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Builder imena %s nije registriran ili dostupan pomoću poziva" -#: registry.py:166 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "Builder %s nije registriran" -#: registry.py:173 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "domena %s je već registrirana" -#: registry.py:196 registry.py:209 registry.py:220 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "domena %s nije još registrirana" -#: registry.py:200 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" -#: registry.py:212 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" -#: registry.py:223 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" -#: registry.py:254 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "" -#: registry.py:280 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "" -#: registry.py:287 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "" -#: registry.py:296 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser za %r je već registriran" -#: registry.py:304 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "" -#: registry.py:320 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "" -#: registry.py:336 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: registry.py:419 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "" -#: registry.py:431 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "" -#: registry.py:446 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "proširenje %r se već nalazi u Sphinxu od verzije %s; ovo proširenje se zanemaruje." -#: registry.py:457 +#: registry.py:545 msgid "Original exception:\n" msgstr "Izvorna iznimka:\n" -#: registry.py:458 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "Proširenje %s ne može biti uvezena" -#: registry.py:463 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "proširenje %r nema funkciju setup(); radi li se o ispravnom Sphinx modulu proširenja?" -#: registry.py:472 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "%s proširenje traži Sphinx verzije v%s; stoga projekt ne može biti izgrađen s ovom verzijom." -#: registry.py:480 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "proširenje %r vratio je nepodržan objekt iz setup() funkcije; rezultat treba biti None ili riječnik metapodataka" -#: registry.py:514 +#: registry.py:605 #, python-format msgid "`None` is not a valid filetype for %r." msgstr "" -#: project.py:71 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" - -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" - -#: highlighting.py:168 +#: config.py:351 #, python-format -msgid "Pygments lexer name %r is not known" -msgstr "" +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "u konfiguracijskom direktoriju ne postoji datoteka conf.py (%s)" -#: highlighting.py:202 +#: config.py:374 #, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: extension.py:55 +#: config.py:379 #, python-format msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." -msgstr "" +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" +msgstr "ne može se nadjačati osnovna konf. postavka %r, zanemarena je (koristite %r za postavljanje pojedinačnih elemenata)" -#: extension.py:76 +#: config.py:391 #, python-format -msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." -msgstr "Ovaj projekt treba proširenje %s najmanje u verziji %si stoga se ne može izraditi s postojećom verzijom (%s)." +msgid "invalid number %r for config value %r, ignoring" +msgstr "nepravilan broj %r za konf. vrijednost %r, zanemaruje se" -#: theming.py:114 +#: config.py:399 #, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +msgid "cannot override config setting %r with unsupported type, ignoring" +msgstr "ne može se nadjačati konf. vrijednost %r zbog nepodržanog tipa, zanemareno" -#: theming.py:120 +#: config.py:422 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "postavka %s.%s ne pojavljuje se u pretraženim konfiguracijama tema" +msgid "unknown config value %r in override, ignoring" +msgstr "nepoznata konfiguracijska vrijednost %r, zanemaruje se" -#: theming.py:135 +#: config.py:476 #, python-format -msgid "unsupported theme option %r given" +msgid "No such config value: %r" msgstr "" -#: theming.py:207 +#: config.py:504 #, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "datoteka %r iz teme nije ispravna (zip) arhiva ili ne sadrži temu" +msgid "Config value %r already present" +msgstr "Konfiguracijska vrijednost %r već postoji" -#: theming.py:228 +#: config.py:541 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" msgstr "" -#: theming.py:268 -#, python-format -msgid "The %r theme has circular inheritance" +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." msgstr "" -#: theming.py:275 +#: config.py:599 #, python-format +msgid "There is a syntax error in your configuration file: %s\n" +msgstr "Postoji sintaksna greška u konfiguracijskoj datoteci: %s\n" + +#: config.py:603 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: theming.py:282 +#: config.py:611 #, python-format -msgid "The %r theme has too many ancestors" +msgid "" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" msgstr "" -#: theming.py:310 +#: config.py:633 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to convert %r to a frozenset" msgstr "" -#: theming.py:335 theming.py:388 +#: config.py:651 config.py:659 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: theming.py:339 +#: config.py:665 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." msgstr "" -#: theming.py:343 theming.py:391 +#: config.py:686 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +msgid "Section %s" +msgstr "Poglavlje %s" -#: theming.py:347 +#: config.py:687 #, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +msgid "Fig. %s" +msgstr "Slika %s" -#: theming.py:366 +#: config.py:688 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +msgid "Table %s" +msgstr "Tablica %s" -#: config.py:309 +#: config.py:689 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "u konfiguracijskom direktoriju ne postoji datoteka conf.py (%s)" +msgid "Listing %s" +msgstr "Ispis %s" -#: config.py:318 +#: config.py:798 +#, python-brace-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"The config value `{name}` has to be a one of {candidates}, but `{current}` " +"is given." msgstr "" -#: config.py:341 -#, python-format -msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" -msgstr "ne može se nadjačati osnovna konf. postavka %r, zanemarena je (koristite %r za postavljanje pojedinačnih elemenata)" - -#: config.py:350 -#, python-format -msgid "invalid number %r for config value %r, ignoring" -msgstr "nepravilan broj %r za konf. vrijednost %r, zanemaruje se" - -#: config.py:356 -#, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" -msgstr "ne može se nadjačati konf. vrijednost %r zbog nepodržanog tipa, zanemareno" - -#: config.py:377 -#, python-format -msgid "unknown config value %r in override, ignoring" -msgstr "nepoznata konfiguracijska vrijednost %r, zanemaruje se" - -#: config.py:430 -#, python-format -msgid "No such config value: %r" -msgstr "" - -#: config.py:453 -#, python-format -msgid "Config value %r already present" -msgstr "Konfiguracijska vrijednost %r već postoji" - -#: config.py:489 -#, python-format -msgid "" -"cannot cache unpickable configuration value: %r (because it contains a " -"function, class, or module object)" -msgstr "" - -#: config.py:527 -#, python-format -msgid "There is a syntax error in your configuration file: %s\n" -msgstr "Postoji sintaksna greška u konfiguracijskoj datoteci: %s\n" - -#: config.py:530 -msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" -msgstr "" - -#: config.py:537 -#, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" -msgstr "" - -#: config.py:560 -#, python-format -msgid "Failed to convert %r to a set or tuple" -msgstr "" - -#: config.py:581 config.py:586 -#, python-format -msgid "Converting `source_suffix = %r` to `source_suffix = %r`." -msgstr "" - -#: config.py:589 -#, python-format -msgid "" -"The config value `source_suffix' expects a dictionary, a string, or a list " -"of strings. Got `%r' instead (type %s)." -msgstr "" - -#: config.py:608 -#, python-format -msgid "Section %s" -msgstr "Poglavlje %s" - -#: config.py:609 -#, python-format -msgid "Fig. %s" -msgstr "Slika %s" - -#: config.py:610 -#, python-format -msgid "Table %s" -msgstr "Tablica %s" - -#: config.py:611 -#, python-format -msgid "Listing %s" -msgstr "Ispis %s" - -#: config.py:718 -msgid "" -"The config value `{name}` has to be a one of {candidates}, but `{current}` " -"is given." -msgstr "" - -#: config.py:742 +#: config.py:829 +#, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:755 +#: config.py:846 +#, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:766 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r nije pronađen, zanemareno je." -#: config.py:778 +#: config.py:878 msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." -msgstr "" - -#: domains/rst.py:128 domains/rst.py:185 -#, python-format -msgid "%s (directive)" -msgstr "%s (directive)" - -#: domains/rst.py:186 domains/rst.py:190 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:214 -#, python-format -msgid "%s (role)" -msgstr "%s (role)" - -#: domains/rst.py:224 -msgid "directive" -msgstr "Direktive" - -#: domains/rst.py:225 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:226 -msgid "role" -msgstr "uloga" - -#: domains/rst.py:248 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:165 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (ugrađene funkcije)" - -#: domains/javascript.py:166 domains/python/__init__.py:253 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metoda)" - -#: domains/javascript.py:168 -#, python-format -msgid "%s() (class)" -msgstr "%s() (razred)" - -#: domains/javascript.py:170 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (globalna varijabla ili konstanta)" - -#: domains/javascript.py:172 domains/python/__init__.py:338 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s atribut)" - -#: domains/javascript.py:255 -msgid "Arguments" -msgstr "Argumenti" - -#: domains/cpp/__init__.py:447 domains/javascript.py:258 -msgid "Throws" -msgstr "Baca (iznimke)" - -#: domains/c/__init__.py:310 domains/cpp/__init__.py:458 -#: domains/javascript.py:261 domains/python/_object.py:176 -msgid "Returns" -msgstr "Vraća" - -#: domains/c/__init__.py:312 domains/javascript.py:263 -#: domains/python/_object.py:178 -msgid "Return type" -msgstr "Vraća tip" - -#: domains/javascript.py:334 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" - -#: domains/c/__init__.py:681 domains/cpp/__init__.py:859 -#: domains/javascript.py:371 domains/python/__init__.py:660 -msgid "function" -msgstr "funkcija" - -#: domains/javascript.py:372 domains/python/__init__.py:664 -msgid "method" -msgstr "metoda" - -#: domains/cpp/__init__.py:857 domains/javascript.py:373 -#: domains/python/__init__.py:662 -msgid "class" -msgstr "razred" - -#: domains/javascript.py:374 domains/python/__init__.py:661 -msgid "data" -msgstr "podaci" - -#: domains/javascript.py:375 domains/python/__init__.py:667 -msgid "attribute" -msgstr "atribut" - -#: domains/javascript.py:376 domains/python/__init__.py:670 -msgid "module" -msgstr "modul" - -#: domains/javascript.py:407 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:25 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Changed in version %s" -msgstr "Promijenjeno u verziji %s" - -#: domains/changeset.py:27 -#, python-format -msgid "Deprecated since version %s" -msgstr "Zastarijelo od verzije %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/__init__.py:299 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/citation.py:73 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "" - -#: domains/citation.py:84 -#, python-format -msgid "Citation [%s] is not referenced." +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: domains/math.py:63 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "dvostruka oznaka jednakosti %s, drugo pojavljivanje u %s" - -#: domains/math.py:119 writers/latex.py:2479 -#, python-format -msgid "Invalid math_eqref_format: %r" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: environment/__init__.py:81 +#: environment/__init__.py:89 msgid "new config" msgstr "" -#: environment/__init__.py:82 +#: environment/__init__.py:90 msgid "config changed" msgstr "" -#: environment/__init__.py:83 +#: environment/__init__.py:91 msgid "extensions changed" msgstr "" -#: environment/__init__.py:249 +#: environment/__init__.py:261 msgid "build environment version not current" msgstr "" -#: environment/__init__.py:251 +#: environment/__init__.py:263 msgid "source directory has changed" msgstr "" -#: environment/__init__.py:313 +#: environment/__init__.py:350 #, python-format msgid "The configuration has changed (1 option: %r)" msgstr "" -#: environment/__init__.py:318 +#: environment/__init__.py:355 #, python-format msgid "The configuration has changed (%d options: %s)" msgstr "" -#: environment/__init__.py:324 +#: environment/__init__.py:361 #, python-format msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: environment/__init__.py:366 +#: environment/__init__.py:404 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" -#: environment/__init__.py:473 +#: environment/__init__.py:518 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" -#: environment/__init__.py:626 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format msgid "Domain %r is not registered" msgstr "" -#: environment/__init__.py:777 +#: environment/__init__.py:811 msgid "document isn't included in any toctree" msgstr "" -#: environment/__init__.py:810 +#: environment/__init__.py:922 msgid "self referenced toctree found. Ignored." msgstr "" -#: environment/__init__.py:839 +#: environment/__init__.py:952 #, python-format msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" @@ -858,3258 +717,3590 @@ msgstr "Savjet" msgid "Warning" msgstr "Upozorenje" -#: cmd/quickstart.py:43 -msgid "automatically insert docstrings from modules" +#: builders/texinfo.py:41 +#, python-format +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:44 -msgid "automatically test code snippets in doctest blocks" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: cmd/quickstart.py:45 -msgid "link between Sphinx documentation of different projects" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: cmd/quickstart.py:46 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: builders/texinfo.py:85 +#, python-format +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: cmd/quickstart.py:47 -msgid "checks for documentation coverage" +#: builders/latex/__init__.py:310 builders/texinfo.py:105 +#, python-format +msgid "processing %s" msgstr "" -#: cmd/quickstart.py:48 -msgid "include math, rendered as PNG or SVG images" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: cmd/quickstart.py:49 -msgid "include math, rendered in the browser by MathJax" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: cmd/quickstart.py:50 -msgid "conditional inclusion of content based on config values" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (u " -#: cmd/quickstart.py:51 -msgid "include links to the source code of documented Python objects" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: cmd/quickstart.py:52 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 +#, python-format +msgid "cannot copy image file %r: %s" msgstr "" -#: cmd/quickstart.py:94 -msgid "Please enter a valid path name." +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter some text." +#: builders/texinfo.py:218 +#, python-format +msgid "error writing file Makefile: %s" msgstr "" -#: cmd/quickstart.py:117 +#: builders/manpage.py:37 #, python-format -msgid "Please enter one of %s." +msgid "The manual pages are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:125 -msgid "Please enter either 'y' or 'n'." +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: cmd/quickstart.py:131 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: builders/manpage.py:64 +#, python-format +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: cmd/quickstart.py:215 +#: builders/singlehtml.py:35 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: cmd/quickstart.py:219 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: cmd/quickstart.py:227 -#, python-format -msgid "Selected root path: %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: cmd/quickstart.py:230 -msgid "Enter the root path for documentation." +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: cmd/quickstart.py:231 -msgid "Root path for the documentation" +#: builders/gettext.py:243 +#, python-format +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:239 -msgid "Error: an existing conf.py has been found in the selected root path." +#: builders/__init__.py:400 builders/gettext.py:264 +#, python-format +msgid "building [%s]: " msgstr "" -#: cmd/quickstart.py:245 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "" - -#: cmd/quickstart.py:248 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:258 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:265 -msgid "Separate source and build directories (y/n)" +#: builders/gettext.py:265 +#, python-format +msgid "targets for %d template files" msgstr "" -#: cmd/quickstart.py:271 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: cmd/quickstart.py:277 -msgid "Name prefix for templates and static dir" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: cmd/quickstart.py:282 -msgid "" -"The project name will occur in several places in the built documentation." +#: builders/linkcheck.py:87 +#, python-format +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: cmd/quickstart.py:286 -msgid "Project name" +#: builders/linkcheck.py:159 +#, python-format +msgid "broken link: %s (%s)" msgstr "" -#: cmd/quickstart.py:288 -msgid "Author name(s)" +#: builders/linkcheck.py:561 +#, python-format +msgid "Anchor '%s' not found" msgstr "" -#: cmd/quickstart.py:293 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: cmd/quickstart.py:301 -msgid "Project version" +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: cmd/quickstart.py:303 -msgid "Project release" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: cmd/quickstart.py:317 -msgid "Project language" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:324 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: cmd/quickstart.py:329 -msgid "Source file suffix" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:334 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:342 -msgid "Name of your master document (without suffix)" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:352 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:359 -msgid "sphinx-quickstart will not overwrite the existing file." +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:362 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:371 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:381 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:391 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" msgstr "" -#: cmd/quickstart.py:397 -msgid "Create Makefile? (y/n)" +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:401 -msgid "Create Windows command file? (y/n)" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: cmd/quickstart.py:453 ext/apidoc.py:92 +#: builders/xml.py:103 #, python-format -msgid "Creating file %s." +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:458 ext/apidoc.py:89 +#: builders/_epub_base.py:223 #, python-format -msgid "File %s already exists, skipping." +msgid "duplicated ToC entry found: %s" msgstr "" -#: cmd/quickstart.py:501 -msgid "Finished: An initial directory structure has been created." +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" msgstr "" -#: cmd/quickstart.py:504 +#: builders/_epub_base.py:467 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "cannot write image file %r: %s" msgstr "" -#: cmd/quickstart.py:512 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: cmd/quickstart.py:515 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: cmd/quickstart.py:522 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: cmd/quickstart.py:557 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: cmd/build.py:153 cmd/quickstart.py:567 ext/apidoc.py:374 -#: ext/autosummary/generate.py:766 -msgid "For more information, visit ." +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: cmd/quickstart.py:577 -msgid "quiet mode" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: cmd/quickstart.py:587 -msgid "project root" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." msgstr "" -#: cmd/quickstart.py:590 -msgid "Structure options" +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." msgstr "" -#: cmd/quickstart.py:596 -msgid "if specified, separate source and build dirs" +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:602 -msgid "if specified, create build dir under source dir" +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: cmd/quickstart.py:608 -msgid "replacement for dot in _templates etc." +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" msgstr "" -#: cmd/quickstart.py:611 -msgid "Project basic options" +#: builders/__init__.py:260 +msgid "building [mo]: " msgstr "" -#: cmd/quickstart.py:613 -msgid "project name" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " msgstr "" -#: cmd/quickstart.py:616 -msgid "author names" +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" msgstr "" -#: cmd/quickstart.py:623 -msgid "version of project" +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" msgstr "" -#: cmd/quickstart.py:630 -msgid "release of project" +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" msgstr "" -#: cmd/quickstart.py:637 -msgid "document language" +#: builders/__init__.py:324 +msgid "all source files" msgstr "" -#: cmd/quickstart.py:640 -msgid "source file suffix" +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: cmd/quickstart.py:643 -msgid "master document name" +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: cmd/quickstart.py:646 -msgid "use epub" +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: cmd/quickstart.py:649 -msgid "Extension options" +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" msgstr "" -#: cmd/quickstart.py:656 ext/apidoc.py:578 +#: builders/__init__.py:382 #, python-format -msgid "enable %s extension" +msgid "targets for %d source files that are out of date" msgstr "" -#: cmd/quickstart.py:663 ext/apidoc.py:570 -msgid "enable arbitrary extensions" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " msgstr "" -#: cmd/quickstart.py:666 -msgid "Makefile and Batchfile creation" +#: builders/__init__.py:415 +#, python-format +msgid "%d found" msgstr "" -#: cmd/quickstart.py:672 -msgid "create makefile" +#: builders/__init__.py:417 +msgid "none found" msgstr "" -#: cmd/quickstart.py:678 -msgid "do not create makefile" +#: builders/__init__.py:424 +msgid "pickling environment" msgstr "" -#: cmd/quickstart.py:685 -msgid "create batchfile" +#: builders/__init__.py:431 +msgid "checking consistency" msgstr "" -#: cmd/quickstart.py:691 -msgid "do not create batchfile" +#: builders/__init__.py:435 +msgid "no targets are out of date." msgstr "" -#: cmd/quickstart.py:700 -msgid "use make-mode for Makefile/make.bat" +#: builders/__init__.py:474 +msgid "updating environment: " msgstr "" -#: cmd/quickstart.py:703 ext/apidoc.py:581 -msgid "Project templating" +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: cmd/quickstart.py:709 ext/apidoc.py:587 -msgid "template directory for template files" +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: cmd/quickstart.py:716 -msgid "define a template variable" +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: cmd/quickstart.py:751 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: cmd/quickstart.py:770 +#: builders/__init__.py:563 +#, python-format msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." msgstr "" -#: cmd/quickstart.py:777 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " msgstr "" -#: cmd/quickstart.py:795 +#: builders/__init__.py:725 #, python-format -msgid "Invalid template variable: %s" +msgid "docnames to write: %s" msgstr "" -#: cmd/build.py:49 -msgid "Exception occurred while building, starting debugger:" +#: builders/__init__.py:727 +msgid "no docnames to write!" msgstr "" -#: _cli/util/errors.py:129 cmd/build.py:65 -msgid "Interrupted!" +#: builders/__init__.py:740 +msgid "preparing documents" msgstr "" -#: cmd/build.py:67 -msgid "reST markup error:" +#: builders/__init__.py:743 +msgid "copying assets" msgstr "" -#: _cli/util/errors.py:143 cmd/build.py:73 -msgid "Encoding error:" +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." msgstr "" -#: cmd/build.py:78 cmd/build.py:108 +#: builders/changes.py:65 #, python-format -msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." +msgid "no changes in version %s." msgstr "" -#: _cli/util/errors.py:148 cmd/build.py:90 -msgid "Recursion error:" +#: builders/changes.py:67 +msgid "writing summary file..." msgstr "" -#: _cli/util/errors.py:152 cmd/build.py:94 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" -msgstr "" +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Ugrađeni dijelovi" -#: _cli/util/errors.py:165 cmd/build.py:103 -msgid "Exception occurred:" -msgstr "" +#: builders/changes.py:81 +msgid "Module level" +msgstr "Nivo modula" -#: _cli/util/errors.py:178 cmd/build.py:117 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: builders/changes.py:137 +msgid "copying source files..." msgstr "" -#: cmd/build.py:124 -msgid "" -"A bug report can be filed in the tracker at . Thanks!" -msgstr "" - -#: cmd/build.py:144 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:154 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" -#: cmd/build.py:180 -msgid "path to documentation source files" +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" msgstr "" -#: cmd/build.py:183 -msgid "path to output directory" +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" msgstr "" -#: cmd/build.py:188 +#: ext/coverage.py:148 +#, python-format msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:194 -msgid "general options" -msgstr "" - -#: cmd/build.py:201 -msgid "builder to use (default: 'html')" +"the following modules are documented but were not specified in " +"coverage_modules: %s" msgstr "" -#: cmd/build.py:210 +#: ext/coverage.py:158 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:220 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:227 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:230 -msgid "path options" +"the following modules are specified in coverage_modules but were not " +"documented: %s" msgstr "" -#: cmd/build.py:236 +#: ext/coverage.py:172 +#, python-brace-format, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." msgstr "" -#: cmd/build.py:246 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" msgstr "" -#: cmd/build.py:255 -msgid "use no configuration file, only use settings from -D options" +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" msgstr "" -#: cmd/build.py:264 -msgid "override a setting in configuration file" +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" msgstr "" -#: cmd/build.py:273 -msgid "pass a value into HTML templates" +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" msgstr "" -#: cmd/build.py:282 -msgid "define tag: include \"only\" blocks with TAG" +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" msgstr "" -#: cmd/build.py:289 -msgid "nitpicky mode: warn about all missing references" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: cmd/build.py:292 -msgid "console output options" -msgstr "" +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" -#: cmd/build.py:299 -msgid "increase verbosity (can be repeated)" +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" msgstr "" -#: cmd/build.py:306 ext/apidoc.py:413 -msgid "no output on stdout, just warnings on stderr" -msgstr "" +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" -#: cmd/build.py:313 -msgid "no output at all, not even warnings" -msgstr "" +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<> se nalazi u %s, redak %d.)" -#: cmd/build.py:321 -msgid "do emit colored output (default: auto-detect)" -msgstr "" +#: ext/todo.py:166 +msgid "original entry" +msgstr "izvorna stavka" -#: cmd/build.py:329 -msgid "do not emit colored output (default: auto-detect)" +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" msgstr "" -#: cmd/build.py:332 -msgid "warning control options" +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/build.py:338 -msgid "write warnings (and errors) to given file" +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" -#: cmd/build.py:345 -msgid "turn warnings into errors" -msgstr "" +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" +msgstr "Graphviz direktiva ne može imati i sadržaj i ime datoteke za argumente" -#: cmd/build.py:353 -msgid "show full traceback on exception" -msgstr "" +#: ext/graphviz.py:153 +#, python-format +msgid "External Graphviz file %r not found or reading it failed" +msgstr "Vanjska Graphviz datoteka %r ne postoji ili se ne može čitati" -#: cmd/build.py:356 -msgid "run Pdb on exception" -msgstr "" +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "Ignoriranje \"graphviz\" direktive bez sadržaja." -#: cmd/build.py:362 -msgid "raise an exception on warnings" +#: ext/graphviz.py:287 +#, python-format +msgid "graphviz_dot executable path must be set! %r" msgstr "" -#: cmd/build.py:405 -msgid "cannot combine -a option and filenames" -msgstr "" +#: ext/graphviz.py:328 +#, python-format +msgid "" +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" +msgstr "dot naredba %r ne može se pokrenuti (potrebna za graphviz izlaz), provjerite postavku graphviz_dot" -#: cmd/build.py:437 +#: ext/graphviz.py:339 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/build.py:456 -msgid "-D option argument must be in the form name=value" +#: ext/graphviz.py:344 +#, python-format +msgid "" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/build.py:463 -msgid "-A option argument must be in the form name=value" +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" msgstr "" -#: builders/linkcheck.py:75 +#: ext/graphviz.py:493 ext/graphviz.py:501 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "" +msgid "[graph: %s]" +msgstr "[graph: %s]" + +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" +msgstr "[graph]" -#: builders/linkcheck.py:146 +#: ext/imgmath.py:148 #, python-format -msgid "broken link: %s (%s)" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: builders/linkcheck.py:540 +#: ext/imgmath.py:167 #, python-format -msgid "Anchor '%s' not found" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: builders/linkcheck.py:742 +#: ext/imgmath.py:326 #, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgid "display latex %r: %s" msgstr "" -#: builders/singlehtml.py:37 +#: ext/imgmath.py:362 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "inline latex %r: %s" msgstr "" -#: builders/singlehtml.py:173 -msgid "assembling single document" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: builders/latex/__init__.py:346 builders/manpage.py:56 -#: builders/singlehtml.py:178 builders/texinfo.py:121 -msgid "writing" -msgstr "" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "nedostaje '+' ili '-' u '%s' opciji." -#: builders/singlehtml.py:191 -msgid "writing additional files" -msgstr "" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "'%s' nije valjana opcija." -#: builders/manpage.py:39 +#: ext/doctest.py:139 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' nije valjana pyversion opcija" -#: builders/manpage.py:47 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: builders/manpage.py:73 +#: ext/doctest.py:297 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: builders/text.py:34 +#: ext/doctest.py:451 #, python-format -msgid "The text files are in %(outdir)s." +msgid "no code/output in %s block at %s:%s" msgstr "" -#: builders/html/__init__.py:1239 builders/text.py:81 builders/xml.py:97 +#: ext/doctest.py:568 #, python-format -msgid "error writing file %s: %s" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: builders/xml.py:38 +#: ext/autosectionlabel.py:52 #, python-format -msgid "The XML files are in %(outdir)s." +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: builders/xml.py:110 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "The pseudo-XML files are in %(outdir)s." +msgid "duplicate label %s, other instance in %s" msgstr "" -#: builders/texinfo.py:47 +#: ext/duration.py:47 #, python-format -msgid "The Texinfo files are in %(outdir)s." +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: builders/texinfo.py:49 +#: ext/duration.py:117 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +"====================== total reading duration ==========================" msgstr "" -#: builders/texinfo.py:78 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: builders/texinfo.py:90 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: builders/latex/__init__.py:324 builders/texinfo.py:115 +#: ext/duration.py:139 #, python-format -msgid "processing %s" +msgid "%.3fs %s" msgstr "" -#: builders/latex/__init__.py:404 builders/texinfo.py:174 -msgid "resolving references..." +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[source]" + +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: builders/latex/__init__.py:415 builders/texinfo.py:184 -msgid " (in " -msgstr " (u " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[docs]" -#: builders/_epub_base.py:423 builders/html/__init__.py:778 -#: builders/latex/__init__.py:482 builders/texinfo.py:202 -msgid "copying images... " -msgstr "" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Kod modula" -#: builders/_epub_base.py:445 builders/latex/__init__.py:497 -#: builders/texinfo.py:219 +#: ext/viewcode.py:359 #, python-format -msgid "cannot copy image file %r: %s" -msgstr "" +msgid "

        Source code for %s

        " +msgstr "

        Izvorni kod za %s

        " -#: builders/texinfo.py:226 -msgid "copying Texinfo support files" -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Pregled: kod modula" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Svi moduli za koje je dostupan kod

        " -#: builders/texinfo.py:234 +#: domains/citation.py:75 #, python-format -msgid "error writing file Makefile: %s" +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/gettext.py:230 +#: domains/citation.py:92 #, python-format -msgid "The message catalogs are in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/__init__.py:383 builders/gettext.py:251 +#: domains/math.py:73 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "dvostruka oznaka jednakosti %s, drugo pojavljivanje u %s" -#: builders/gettext.py:252 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "targets for %d template files" +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/gettext.py:257 -msgid "reading templates... " -msgstr "" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (ugrađene funkcije)" -#: builders/gettext.py:292 -msgid "writing message catalogs... " -msgstr "" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s metoda)" -#: builders/__init__.py:212 +#: domains/javascript.py:186 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +msgid "%s() (class)" +msgstr "%s() (razred)" -#: builders/__init__.py:220 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (globalna varijabla ili konstanta)" -#: builders/__init__.py:243 -msgid "building [mo]: " -msgstr "" +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" +msgstr "%s (%s atribut)" -#: builders/__init__.py:246 builders/__init__.py:741 builders/__init__.py:773 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumenti" + +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Baca (iznimke)" + +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Vraća" -#: builders/__init__.py:263 +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Vraća tip" + +#: domains/javascript.py:374 #, python-format -msgid "all of %d po files" -msgstr "" +msgid "%s (module)" +msgstr "%s (modul)" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funkcija" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metoda" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "razred" -#: builders/__init__.py:285 +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "podaci" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribut" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" + +#: domains/javascript.py:458 #, python-format -msgid "targets for %d po files that are specified" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "" +msgid "%s (directive)" +msgstr "%s (directive)" -#: builders/__init__.py:307 -msgid "all source files" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 +#: domains/rst.py:224 #, python-format -msgid "file %r given on command line does not exist, " +msgid "%s (role)" +msgstr "%s (role)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "Direktive" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:325 +#: domains/rst.py:236 +msgid "role" +msgstr "uloga" + +#: domains/rst.py:262 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:336 +#: domains/changeset.py:32 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:351 +#: domains/changeset.py:33 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Changed in version %s" +msgstr "Promijenjeno u verziji %s" -#: builders/__init__.py:366 +#: domains/changeset.py:34 #, python-format -msgid "targets for %d source files that are out of date" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Zastarijelo od verzije %s" -#: builders/__init__.py:394 -msgid "looking for now-outdated files... " +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:398 +#: domains/__init__.py:322 #, python-format -msgid "%d found" +msgid "%s %s" +msgstr "%s %s" + +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:400 -msgid "none found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:407 -msgid "pickling environment" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:414 -msgid "checking consistency" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:418 -msgid "no targets are out of date." +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:458 -msgid "updating environment: " +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:483 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:519 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:528 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:539 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:546 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:565 builders/__init__.py:581 -msgid "reading sources... " +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:698 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:711 -msgid "preparing documents" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:714 -msgid "copying assets" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:866 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:83 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:220 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:231 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:255 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1289 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/_epub_base.py:222 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/_epub_base.py:434 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" + +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:465 +#: cmd/build.py:357 #, python-format -msgid "cannot write image file %r: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:477 -msgid "Pillow not found - copying image files" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:512 -msgid "writing mimetype file..." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:521 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:590 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:764 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:793 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/changes.py:33 -#, python-format -msgid "The overview file is in %(outdir)s." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/changes.py:60 -#, python-format -msgid "no changes in version %s." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/changes.py:62 -msgid "writing summary file..." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/changes.py:74 -msgid "Builtins" -msgstr "Ugrađeni dijelovi" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "" -#: builders/changes.py:76 -msgid "Module level" -msgstr "Nivo modula" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "" -#: builders/changes.py:128 -msgid "copying source files..." +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/changes.py:137 +#: cmd/quickstart.py:134 #, python-format -msgid "could not read %r for changelog creation" +msgid "Please enter one of %s." msgstr "" -#: util/rst.py:72 -#, python-format -msgid "default role %s not found" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: util/docfields.py:95 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: util/osutil.py:130 +#: cmd/quickstart.py:230 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: util/nodes.py:419 -#, python-format +#: cmd/quickstart.py:235 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: util/nodes.py:487 +#: cmd/quickstart.py:242 #, python-format -msgid "toctree contains ref to nonexisting file %r" +msgid "Selected root path: %s" msgstr "" -#: util/nodes.py:701 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: util/fileutil.py:74 -#, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: util/inventory.py:170 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: util/inventory.py:185 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: util/docutils.py:284 -#, python-format -msgid "unknown directive or role name: %s:%s" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: util/docutils.py:747 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: util/display.py:81 -msgid "skipped" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: util/display.py:86 -msgid "failed" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: util/i18n.py:103 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: util/i18n.py:110 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: util/i18n.py:138 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: util/i18n.py:230 -#, python-format +#: cmd/quickstart.py:309 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: directives/patches.py:66 +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "" + +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "" + +#: cmd/quickstart.py:324 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: directives/code.py:87 -#, python-format -msgid "Invalid caption: %s" -msgstr "Neispravan navod: %s" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "" -#: directives/code.py:132 directives/code.py:297 directives/code.py:484 -#, python-format -msgid "line number spec is out of range(1-%d): %r" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Ne mogu se istovremeno koristiti *%s* i *%s* opcije" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: directives/code.py:234 +#: cmd/quickstart.py:368 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: directives/code.py:276 -#, python-format -msgid "Object named %r not found in include file %r" -msgstr "Objekt %r nije pronađen u include datoteci %r" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "Ne može se koristiti \"lineno-match\" sa nespojivom grupom \"lines\"" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "" -#: directives/code.py:314 -#, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Specifikacija retka %r: nema redaka preuzetih iz include datoteke %r" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "" -#: directives/other.py:122 -#, python-format -msgid "toctree glob pattern %r didn't match any documents" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: directives/other.py:155 environment/adapters/toctree.py:355 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "" + +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "" + +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: directives/other.py:158 environment/adapters/toctree.py:359 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Creating file %s." msgstr "" -#: directives/other.py:171 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "File %s already exists, skipping." msgstr "" -#: directives/other.py:204 -msgid "Section author: " -msgstr "Autor sekcije: " +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "" -#: directives/other.py:206 -msgid "Module author: " -msgstr "Autor modula: " +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "" -#: directives/other.py:208 -msgid "Code author: " -msgstr "Autor koda:" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "" -#: directives/other.py:210 -msgid "Author: " -msgstr "Autor:" +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "" -#: directives/other.py:284 -msgid ".. acks content is not a list" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: directives/other.py:309 -msgid ".. hlist content is not a list" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: _cli/__init__.py:75 -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: _cli/__init__.py:112 _cli/__init__.py:183 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: _cli/__init__.py:172 -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: _cli/__init__.py:182 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: _cli/__init__.py:194 -msgid "Show the version and exit." +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: _cli/__init__.py:202 -msgid "Show this message and exit." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: _cli/__init__.py:206 -msgid "Logging" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: _cli/__init__.py:213 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: _cli/__init__.py:221 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: _cli/__init__.py:228 -msgid "No output at all" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: _cli/__init__.py:234 -msgid "" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: _cli/__init__.py:265 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:198 -#: transforms/__init__.py:133 writers/manpage.py:102 writers/texinfo.py:219 +#: cmd/quickstart.py:671 #, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" - -#: transforms/__init__.py:143 -msgid "could not calculate translation progress!" +msgid "enable %s extension" msgstr "" -#: transforms/__init__.py:148 -msgid "no translated elements!" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: transforms/__init__.py:267 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: transforms/__init__.py:313 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: transforms/__init__.py:322 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: transforms/__init__.py:333 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: transforms/i18n.py:228 transforms/i18n.py:303 -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: transforms/i18n.py:273 -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: transforms/i18n.py:323 -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: transforms/i18n.py:345 -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: ext/linkcode.py:75 ext/viewcode.py:201 -msgid "[source]" -msgstr "[source]" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" -#: ext/imgconverter.py:40 -#, python-format +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: ext/imgconverter.py:49 ext/imgconverter.py:73 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: ext/imgconverter.py:68 +#: cmd/quickstart.py:810 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" +msgid "Invalid template variable: %s" msgstr "" -#: ext/viewcode.py:258 -msgid "highlighting module code... " +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: ext/viewcode.py:286 -msgid "[docs]" -msgstr "[docs]" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" +msgstr "" -#: ext/viewcode.py:306 -msgid "Module code" -msgstr "Kod modula" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "" -#: ext/viewcode.py:312 +#: directives/other.py:169 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        Izvorni kod za %s

        " +msgid "duplicated entry found in toctree: %s" +msgstr "" -#: ext/viewcode.py:338 -msgid "Overview: module code" -msgstr "Pregled: kod modula" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autor sekcije: " -#: ext/viewcode.py:339 -msgid "

        All modules for which code is available

        " -msgstr "

        Svi moduli za koje je dostupan kod

        " +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autor modula: " -#: ext/coverage.py:47 -#, python-format -msgid "invalid regex %r in %s" +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autor koda:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor:" + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: ext/coverage.py:134 ext/coverage.py:280 -#, python-format -msgid "module %s could not be imported: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: ext/coverage.py:141 -#, python-format +#: directives/patches.py:70 msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: ext/coverage.py:149 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: ext/coverage.py:163 +#: directives/code.py:87 #, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." -msgstr "" +msgid "Invalid caption: %s" +msgstr "Neispravan navod: %s" -#: ext/coverage.py:177 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "invalid regex %r in coverage_c_regexes" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: ext/coverage.py:245 +#: directives/code.py:216 #, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Ne mogu se istovremeno koristiti *%s* i *%s* opcije" -#: ext/coverage.py:429 +#: directives/code.py:231 #, python-format -msgid "undocumented python function: %s :: %s" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: ext/coverage.py:445 +#: directives/code.py:235 #, python-format -msgid "undocumented python class: %s :: %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: ext/coverage.py:458 +#: directives/code.py:276 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "" +msgid "Object named %r not found in include file %r" +msgstr "Objekt %r nije pronađen u include datoteci %r" -#: ext/todo.py:71 -msgid "Todo" -msgstr "Todo" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "Ne može se koristiti \"lineno-match\" sa nespojivom grupom \"lines\"" -#: ext/todo.py:104 +#: directives/code.py:314 #, python-format -msgid "TODO entry found: %s" -msgstr "" - -#: ext/todo.py:163 -msgid "<>" -msgstr "<>" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Specifikacija retka %r: nema redaka preuzetih iz include datoteke %r" -#: ext/todo.py:165 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<> se nalazi u %s, redak %d.)" +msgid "%b %d, %Y" +msgstr "%b %d, %Y" -#: ext/todo.py:175 -msgid "original entry" -msgstr "izvorna stavka" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Abecedni popis" -#: ext/extlinks.py:82 -#, python-format +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: ext/doctest.py:115 -#, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "nedostaje '+' ili '-' u '%s' opciji." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Fusnote" -#: ext/doctest.py:120 -#, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' nije valjana opcija." +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "" -#: ext/doctest.py:134 +#: writers/texinfo.py:1303 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' nije valjana pyversion opcija" - -#: ext/doctest.py:220 -msgid "invalid TestCode type" +msgid "unimplemented node type: %r" msgstr "" -#: ext/doctest.py:281 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "[image: %s]" +msgstr "[slika: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[slika]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: ext/doctest.py:434 +#: writers/html5.py:431 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "numfig_format is not defined for %s" msgstr "" -#: ext/doctest.py:522 +#: writers/html5.py:441 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "Any IDs not assigned for %s node" msgstr "" -#: ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" -msgstr "Graphviz direktiva ne može imati i sadržaj i ime datoteke za argumente" +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" -#: ext/graphviz.py:145 -#, python-format -msgid "External Graphviz file %r not found or reading it failed" -msgstr "Vanjska Graphviz datoteka %r ne postoji ili se ne može čitati" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" -#: ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." -msgstr "Ignoriranje \"graphviz\" direktive bez sadržaja." +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" -#: ext/graphviz.py:268 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "graphviz_dot executable path must be set! %r" +msgid "unsupported rubric heading level: %s" msgstr "" -#: ext/graphviz.py:303 -#, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" -msgstr "dot naredba %r ne može se pokrenuti (potrebna za graphviz izlaz), provjerite postavku graphviz_dot" +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" -#: ext/graphviz.py:310 -#, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: ext/graphviz.py:313 -#, python-format -msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: ext/graphviz.py:329 -#, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" -msgstr "graphviz_output_format mora biti 'png' ili 'svg', ali je %r" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "" -#: ext/graphviz.py:333 ext/graphviz.py:386 ext/graphviz.py:423 +#: writers/latex.py:386 #, python-format -msgid "dot code %r: %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: ext/graphviz.py:436 ext/graphviz.py:444 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "[graph: %s]" -msgstr "[graph: %s]" - -#: ext/graphviz.py:438 ext/graphviz.py:446 -msgid "[graph]" -msgstr "[graph]" - -#: ext/imgmath.py:369 ext/mathjax.py:52 -msgid "Link to this equation" +msgid "no Babel option known for language %r" msgstr "" -#: ext/apidoc.py:85 -#, python-format -msgid "Would create file %s." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: ext/apidoc.py:375 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: ext/apidoc.py:392 -msgid "path to module to document" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: ext/apidoc.py:396 +#: writers/latex.py:1198 msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: ext/apidoc.py:407 -msgid "directory to place all output" +#: writers/latex.py:1228 +#, python-format +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: ext/apidoc.py:422 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: ext/apidoc.py:429 -msgid "overwrite existing files" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: ext/apidoc.py:437 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: ext/apidoc.py:446 -msgid "run the script without creating files" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: ext/apidoc.py:453 -msgid "put documentation for each module on its own page" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: ext/apidoc.py:460 -msgid "include \"_private\" modules" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: ext/apidoc.py:467 -msgid "filename of table of contents (default: modules)" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: ext/apidoc.py:474 -msgid "don't create a table of contents file" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: ext/apidoc.py:481 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: ext/apidoc.py:492 -msgid "put module documentation before submodule documentation" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: ext/apidoc.py:498 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: ext/apidoc.py:508 -msgid "file suffix (default: rst)" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: ext/apidoc.py:515 ext/autosummary/generate.py:839 -msgid "Remove existing files in the output directory that were not generated" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: ext/apidoc.py:524 -msgid "generate a full project with sphinx-quickstart" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: ext/apidoc.py:531 -msgid "append module_path to sys.path, used when --full is given" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: ext/apidoc.py:538 -msgid "project name (default: root module name)" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: ext/apidoc.py:545 -msgid "project author(s), used when --full is given" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: ext/apidoc.py:552 -msgid "project version, used when --full is given" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: ext/apidoc.py:559 -msgid "project release, used when --full is given, defaults to --doc-version" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: ext/apidoc.py:564 -msgid "extension options" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: ext/apidoc.py:638 -#, python-format -msgid "%s is not a directory." +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: ext/apidoc.py:710 ext/autosummary/generate.py:875 -#, python-format -msgid "Failed to remove %s: %s" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: ext/autosectionlabel.py:48 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/std/__init__.py:703 domains/std/__init__.py:812 -#: ext/autosectionlabel.py:52 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: ext/duration.py:85 +#: transforms/__init__.py:258 +#, python-format msgid "" -"====================== slowest reading durations =======================" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: ext/imgmath.py:159 +#: transforms/__init__.py:299 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +msgid "Footnote [%s] is not referenced." msgstr "" -#: ext/imgmath.py:174 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: ext/imgmath.py:328 -#, python-format -msgid "display latex %r: %s" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: ext/imgmath.py:362 +#: util/inventory.py:147 #, python-format -msgid "inline latex %r: %s" +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: writers/latex.py:1090 writers/manpage.py:263 writers/texinfo.py:662 -msgid "Footnotes" -msgstr "Fusnote" - -#: writers/manpage.py:309 writers/text.py:936 +#: util/inventory.py:166 #, python-format -msgid "[image: %s]" -msgstr "[slika: %s]" - -#: writers/manpage.py:310 writers/text.py:937 -msgid "[image]" -msgstr "[slika]" - -#: writers/html5.py:99 writers/html5.py:108 -msgid "Link to this definition" +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: writers/html5.py:415 +#: util/i18n.py:100 #, python-format -msgid "numfig_format is not defined for %s" +msgid "reading error: %s, %s" msgstr "" -#: writers/html5.py:427 +#: util/i18n.py:113 #, python-format -msgid "Any IDs not assigned for %s node" +msgid "writing error: %s, %s" msgstr "" -#: writers/html5.py:482 -msgid "Link to this term" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: writers/html5.py:525 writers/html5.py:530 -msgid "Link to this heading" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: writers/html5.py:535 -msgid "Link to this table" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: writers/html5.py:549 writers/latex.py:1099 +#: util/osutil.py:131 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: writers/html5.py:613 -msgid "Link to this code" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: writers/html5.py:615 -msgid "Link to this image" +#: util/display.py:87 +msgid "failed" msgstr "" -#: writers/html5.py:617 -msgid "Link to this toctree" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: writers/html5.py:758 -msgid "Could not obtain image size. :scale: option is ignored." +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: builders/latex/__init__.py:205 domains/std/__init__.py:646 -#: domains/std/__init__.py:658 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:513 -msgid "Index" -msgstr "Abecedni popis" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "" -#: writers/latex.py:743 writers/texinfo.py:644 +#: util/fileutil.py:76 +#, python-format msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: writers/texinfo.py:1216 -msgid "caption not inside a figure." +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: writers/texinfo.py:1302 +#: util/docfields.py:103 #, python-format -msgid "unimplemented node type: %r" +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: writers/latex.py:360 +#: util/rst.py:73 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "default role %s not found" msgstr "" -#: builders/latex/__init__.py:223 writers/latex.py:410 +#: util/nodes.py:462 #, python-format -msgid "no Babel option known for language %r" +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: writers/latex.py:428 -msgid "too large :maxdepth:, ignored." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: writers/latex.py:590 +#: util/nodes.py:739 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: writers/latex.py:708 -msgid "document title is not a single Text node" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "nastavak sa prethodne stranice" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: writers/latex.py:1175 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: writers/latex.py:1573 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Simboli" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: writers/latex.py:1931 +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "stranica" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Distribucija" + +#: transforms/post_transforms/images.py:79 #, python-format -msgid "unknown index entry type %s found" +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: domains/std/__init__.py:87 domains/std/__init__.py:104 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "environment variable; %s" -msgstr "varijabla okruženja; %s" +msgid "Could not fetch remote image: %s [%d]" +msgstr "" -#: domains/std/__init__.py:112 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "%s; configuration value" +msgid "Unknown image format: %s..." msgstr "" -#: domains/std/__init__.py:166 -msgid "Type" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: domains/std/__init__.py:176 -msgid "Default" -msgstr "" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "više od jednog targeta za 'any' referencu %r: može biti %s" -#: domains/std/__init__.py:235 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" +msgid "%s:%s reference target not found: %s" msgstr "" -#: domains/std/__init__.py:306 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "%s command line option" +msgid "%r reference target not found: %s" msgstr "" -#: domains/std/__init__.py:308 -msgid "command line option" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: domains/std/__init__.py:430 -msgid "glossary term must be preceded by empty line" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: domains/std/__init__.py:438 -msgid "glossary terms must not be separated by empty lines" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: domains/std/__init__.py:444 domains/std/__init__.py:457 -msgid "glossary seems to be misformatted, check indentation" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: domains/std/__init__.py:602 -msgid "glossary term" -msgstr "termin rječnika" - -#: domains/std/__init__.py:603 -msgid "grammar token" -msgstr "token gramatike" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "" -#: domains/std/__init__.py:604 -msgid "reference label" -msgstr "referentna oznaka" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "" -#: domains/std/__init__.py:607 -msgid "environment variable" -msgstr "varijabla okruženja" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "" -#: domains/std/__init__.py:608 -msgid "program option" -msgstr "programske mogućnosti" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "" -#: domains/std/__init__.py:609 -msgid "document" -msgstr "dokument" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "" -#: domains/std/__init__.py:647 domains/std/__init__.py:659 -msgid "Module Index" -msgstr "Popis modula" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Sakrij pomoćnu traku" -#: domains/std/__init__.py:648 domains/std/__init__.py:660 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "Tražilica" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigacija" -#: domains/std/__init__.py:722 +#: themes/basic/layout.html:115 #, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" +msgid "Search within %(docstitle)s" +msgstr "Traži između %(docstitle)s" -#: domains/std/__init__.py:932 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "O ovim dokumentima" -#: domains/std/__init__.py:940 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Traži" -#: domains/std/__init__.py:952 -#, python-format -msgid "the link has no caption: %s" -msgstr "" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Sva prava zadržana" -#: domains/std/__init__.py:966 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "invalid numfig_format: %s (%r)" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: domains/std/__init__.py:969 +#: themes/basic/layout.html:201 #, python-format -msgid "invalid numfig_format: %s" +msgid "Last updated on %(last_updated)s." +msgstr "Zadnji put ažurirano %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: domains/std/__init__.py:1200 +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Prijašnja tema" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "Prijašnje poglavlje" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Sljedeća tema" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "sljedeće poglavlje" + +#: themes/basic/genindex-single.html:26 #, python-format -msgid "undefined label: %r" +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Potpun indeks na jednoj stranici" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Trenutna stranica" + +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "Prikaži izvorni kod" + +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Brzo pretraživanje" + +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Traži" + +#: themes/basic/defindex.html:4 +msgid "Overview" +msgstr "Pregled" + +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" +msgstr "Dobro došli! Ovo je" + +#: themes/basic/defindex.html:9 +msgid "the documentation for" +msgstr "dokumentacija za" + +#: themes/basic/defindex.html:10 +msgid "last updated" +msgstr "posljednja promjena" + +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" +msgstr "Kazala i tablice:" + +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "Detaljni sadržaj" + +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "prikaži sve sekcije i podsekcije" + +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "Tražilica" + +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "traži po dokumentaciji" + +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "Općeniti popis modula" + +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "brz dostup do svih modula" + +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Opceniti abecedni indeks" + +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "sve funkcije, razredi, izrazi" + +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: domains/std/__init__.py:1202 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" +msgid "Search %(docstitle)s" +msgstr "Traži %(docstitle)s" + +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Indeksiraj stranice po slovu" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "može biti ogromno" + +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." +msgstr "Molimo omogućite JavaScript\n za djelovanje tražilice." + +#: themes/basic/search.html:28 +msgid "" +"Searching for multiple words only shows matches that contain\n" +" all words." +msgstr "" + +#: themes/basic/search.html:35 +msgid "search" +msgstr "traži" + +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Sadržaj" + +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "Rezultati pretrage" + +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." +msgstr "Zadanim uvjetima nije pronađen dokument. Molim provjerite točnost upisanih riječi i odabir označenih kategija." + +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" +msgstr[2] "" + +#: themes/basic/static/searchtools.js:276 +msgid "Searching" +msgstr "Pretraživanje" + +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "Priprema pretrage..." + +#: themes/basic/static/searchtools.js:526 +msgid ", in " +msgstr ", u " + +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Sakrij rezultate pretrage" + +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 +#, python-format +msgid "Changes in Version %(version)s — %(docstitle)s" +msgstr "Promjene u verziji %(version)s — %(docstitle)s" + +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + +#: themes/basic/changes/versionchanges.html:17 +#, python-format +msgid "Automatically generated list of changes in version %(version)s" +msgstr "Automatski generirani popis promjena u verziji %(version)s" + +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" +msgstr "Promjene lib-ova" + +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" +msgstr "C API promjene" + +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" +msgstr "Ostale promjene" + +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" +msgstr "Pokaži pomoćnu traku" + +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/__init__.py:107 domains/python/__init__.py:244 +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametri" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Varijable" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Podiže" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (u modulu %s)" -#: domains/python/__init__.py:167 domains/python/__init__.py:334 -#: domains/python/__init__.py:385 domains/python/__init__.py:424 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (u modulu %s)" -#: domains/python/__init__.py:169 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (ugrađene variable)" -#: domains/python/__init__.py:194 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (ugrađen razred)" -#: domains/python/__init__.py:195 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (razred u %s)" -#: domains/python/__init__.py:249 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s metoda klase)" -#: domains/python/__init__.py:251 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statična metoda)" -#: domains/python/__init__.py:389 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:428 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:559 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python indeks modula" -#: domains/python/__init__.py:560 +#: domains/python/__init__.py:625 msgid "modules" msgstr "Moduli" -#: domains/python/__init__.py:637 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Zastarjelo" -#: domains/python/__init__.py:663 +#: domains/python/__init__.py:729 msgid "exception" msgstr "izuzetak" -#: domains/python/__init__.py:665 +#: domains/python/__init__.py:731 msgid "class method" msgstr "metoda klase" -#: domains/python/__init__.py:666 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statična metoda" -#: domains/python/__init__.py:668 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:669 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:729 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:858 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:920 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (zastarjelo)" -#: domains/c/__init__.py:304 domains/cpp/__init__.py:441 -#: domains/python/_object.py:164 ext/napoleon/docstring.py:786 -msgid "Parameters" -msgstr "Parametri" - -#: domains/python/_object.py:169 -msgid "Variables" -msgstr "Varijable" - -#: domains/python/_object.py:173 -msgid "Raises" -msgstr "Podiže" - -#: domains/c/__init__.py:199 +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 #, python-format -msgid "%s (C %s)" +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" -#: domains/c/__init__.py:260 domains/c/_symbol.py:510 +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" +msgstr "Parametri predloška" + +#: domains/cpp/__init__.py:302 #, python-format -msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." +msgid "%s (C++ %s)" msgstr "" -#: domains/c/__init__.py:307 domains/cpp/__init__.py:454 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:679 domains/cpp/__init__.py:860 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "" + +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "član" -#: domains/c/__init__.py:680 -msgid "variable" -msgstr "varijabla" - -#: domains/c/__init__.py:682 -msgid "macro" -msgstr "makro" - -#: domains/c/__init__.py:683 -msgid "struct" -msgstr "" +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "tip" -#: domains/c/__init__.py:684 domains/cpp/__init__.py:858 -msgid "union" -msgstr "" +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "koncept" -#: domains/c/__init__.py:685 domains/cpp/__init__.py:863 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:686 domains/cpp/__init__.py:864 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerator" -#: domains/c/__init__.py:687 domains/cpp/__init__.py:861 -msgid "type" -msgstr "tip" - -#: domains/c/__init__.py:689 domains/cpp/__init__.py:866 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:155 -msgid "Template Parameters" -msgstr "Parametri predloška" - -#: domains/cpp/__init__.py:277 +#: domains/cpp/__init__.py:954 +msgid "template parameter" +msgstr "" + +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format -msgid "%s (C++ %s)" +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/cpp/__init__.py:360 domains/cpp/_symbol.py:793 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "varijabla" + +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "makro" + +#: domains/c/__init__.py:781 +msgid "struct" +msgstr "" + +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" +msgstr "varijabla okruženja; %s" + +#: domains/std/__init__.py:116 +#, python-format +msgid "%s; configuration value" +msgstr "" + +#: domains/std/__init__.py:172 +msgid "Type" +msgstr "" + +#: domains/std/__init__.py:182 +msgid "Default" +msgstr "" + +#: domains/std/__init__.py:239 #, python-format msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: domains/cpp/__init__.py:862 -msgid "concept" -msgstr "koncept" +#: domains/std/__init__.py:319 +#, python-format +msgid "%s command line option" +msgstr "" -#: domains/cpp/__init__.py:867 -msgid "template parameter" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Sadržaj" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" +msgstr "" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Traži" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Traži" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "termin rječnika" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "Prikaži izvorni kod" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "token gramatike" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Sakrij pomoćnu traku" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "referentna oznaka" -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigacija" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "varijabla okruženja" -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Traži između %(docstitle)s" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "programske mogućnosti" -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "O ovim dokumentima" +#: domains/std/__init__.py:735 +msgid "document" +msgstr "dokument" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Sva prava zadržana" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Popis modula" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#: domains/std/__init__.py:857 #, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: themes/basic/layout.html:201 +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "" + +#: domains/std/__init__.py:1124 #, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Zadnji put ažurirano %(last_updated)s." +msgid "Failed to create a cross reference. Any number is not assigned: %s" +msgstr "" -#: themes/basic/layout.html:204 +#: domains/std/__init__.py:1138 #, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +msgid "the link has no caption: %s" msgstr "" -#: themes/basic/genindex-single.html:26 +#: domains/std/__init__.py:1153 #, python-format -msgid "Index – %(key)s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Potpun indeks na jednoj stranici" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" +msgstr "" -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Indeksiraj stranice po slovu" +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" +msgstr "" -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "može biti ogromno" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "" -#: themes/basic/opensearch.xml:4 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Search %(docstitle)s" -msgstr "Traži %(docstitle)s" +msgid "invalid value set (missing closing brace): %s" +msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Trenutna stranica" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" +msgstr "" -#: themes/basic/defindex.html:4 -msgid "Overview" -msgstr "Pregled" +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" +msgstr "" -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" -msgstr "Dobro došli! Ovo je" +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" +msgstr "" -#: themes/basic/defindex.html:9 -msgid "the documentation for" -msgstr "dokumentacija za" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "" -#: themes/basic/defindex.html:10 -msgid "last updated" -msgstr "posljednja promjena" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Primjeri" -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" -msgstr "Kazala i tablice:" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Argumenti" -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" -msgstr "Detaljni sadržaj" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "" -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "prikaži sve sekcije i podsekcije" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "traži po dokumentaciji" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "Općeniti popis modula" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "" -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "brz dostup do svih modula" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Opceniti abecedni indeks" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "sve funkcije, razredi, izrazi" +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" +msgstr "" -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Brzo pretraživanje" +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 +#, python-format +msgid "alias of %s" +msgstr "" -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." -msgstr "Molimo omogućite JavaScript\n za djelovanje tražilice." +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" +msgstr "Osnovice: %s" -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" msgstr "" -#: themes/basic/search.html:35 -msgid "search" -msgstr "traži" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Prijašnja tema" +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" +msgstr "" -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "Prijašnje poglavlje" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "" -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Sljedeća tema" +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "sljedeće poglavlje" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" +msgstr "" -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" -msgstr "Pokaži pomoćnu traku" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "" -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "Promjene u verziji %(version)s — %(docstitle)s" +msgid "Failed to remove %s: %s" +msgstr "" -#: themes/basic/changes/versionchanges.html:17 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Automatski generirani popis promjena u verziji %(version)s" +msgid "Would create file %s." +msgstr "" -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Promjene lib-ova" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "" -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "C API promjene" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Ostale promjene" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Sakrij rezultate pretrage" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "" -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" -msgstr "Rezultati pretrage" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "" -#: themes/basic/static/searchtools.js:119 +#: ext/apidoc/_cli.py:91 msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." -msgstr "Zadanim uvjetima nije pronađen dokument. Molim provjerite točnost upisanih riječi i odabir označenih kategija." - -#: themes/basic/static/searchtools.js:123 -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" -msgstr[2] "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "" -#: themes/basic/static/searchtools.js:253 -msgid "Searching" -msgstr "Pretraživanje" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "" -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." -msgstr "Priprema pretrage..." +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "" -#: themes/basic/static/searchtools.js:474 -msgid ", in " -msgstr ", u " +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "" -#: environment/collectors/asset.py:96 -#, python-format -msgid "image file not readable: %s" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: environment/collectors/asset.py:124 -#, python-format -msgid "image file %s not readable: %s" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: environment/collectors/asset.py:161 -#, python-format -msgid "download file not readable: %s" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: environment/collectors/toctree.py:258 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: environment/adapters/toctree.py:318 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: environment/adapters/toctree.py:342 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: environment/adapters/toctree.py:357 -#, python-format -msgid "toctree contains reference to non-included document %r" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: environment/adapters/indexentries.py:126 -#, python-format -msgid "see %s" -msgstr "pogledajte %s" - -#: environment/adapters/indexentries.py:136 -#, python-format -msgid "see also %s" -msgstr "Dodatne informacije: %s" - -#: environment/adapters/indexentries.py:144 -#, python-format -msgid "unknown index entry type %r" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: environment/adapters/indexentries.py:270 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Simboli" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/html/__init__.py:363 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: builders/html/__init__.py:382 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "abecedni indeks" - -#: builders/html/__init__.py:560 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "Logo of %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "naprijed" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "nazad" - -#: builders/html/__init__.py:695 -msgid "generating indices" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/html/__init__.py:710 -msgid "writing additional pages" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/__init__.py:793 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/__init__.py:805 -msgid "copying downloadable files... " +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:817 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/__init__.py:863 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/__init__.py:881 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/__init__.py:916 -msgid "copying static files" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:933 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "cannot copy static file %r" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/__init__.py:938 -msgid "copying extra files" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/html/__init__.py:948 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: builders/html/__init__.py:954 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "Failed to write build info file: %r" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/html/__init__.py:1003 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/html/__init__.py:1051 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: builders/html/__init__.py:1213 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: builders/html/__init__.py:1222 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1255 -msgid "dumping object inventory" +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: builders/html/__init__.py:1263 +#: ext/autosummary/generate.py:634 #, python-format -msgid "dumping search index in %s" +msgid "[autosummary] writing to %s" msgstr "" -#: builders/html/__init__.py:1306 +#: ext/autosummary/generate.py:679 #, python-format -msgid "invalid js_file: %r, ignored" +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1339 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: builders/html/__init__.py:1344 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: builders/html/__init__.py:1358 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: builders/html/__init__.py:1363 +#: ext/autosummary/generate.py:915 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1378 +#: ext/autosummary/generate.py:923 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "custom template directory (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1383 +#: ext/autosummary/generate.py:931 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "document imported members (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1394 builders/latex/__init__.py:504 +#: ext/autosummary/generate.py:940 #, python-format -msgid "logo file %r does not exist" +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: builders/html/__init__.py:1405 +#: ext/autosummary/__init__.py:235 #, python-format -msgid "favicon file %r does not exist" +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: builders/html/__init__.py:1417 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: builders/html/__init__.py:1430 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: builders/html/__init__.py:1447 +#: ext/autosummary/__init__.py:329 #, python-format -msgid "%s %s documentation" -msgstr "%s %s dokumentacija" - -#: builders/latex/transforms.py:118 -msgid "Failed to get a docname!" +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/latex/transforms.py:119 +#: ext/autosummary/__init__.py:358 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "failed to import object %s" msgstr "" -#: builders/latex/transforms.py:485 +#: ext/autosummary/__init__.py:652 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: builders/latex/__init__.py:117 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "autosummary_generate: file not found: %s" msgstr "" -#: builders/latex/__init__.py:119 +#: ext/autosummary/__init__.py:860 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "" - -#: builders/latex/__init__.py:157 -msgid "no \"latex_documents\" config value found; no documents will be written" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: builders/latex/__init__.py:169 +#: ext/intersphinx/_load.py:61 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: builders/latex/__init__.py:208 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Distribucija" - -#: builders/latex/__init__.py:429 -msgid "copying TeX support files" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: builders/latex/__init__.py:466 -msgid "copying additional files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: builders/latex/__init__.py:540 +#: ext/intersphinx/_load.py:94 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: builders/latex/__init__.py:548 +#: ext/intersphinx/_load.py:103 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: builders/latex/theming.py:87 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: builders/latex/theming.py:90 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: _cli/util/errors.py:124 -msgid "Exception occurred, starting debugger:" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: _cli/util/errors.py:133 -msgid "reStructuredText markup error:" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: _cli/util/errors.py:168 -msgid "The full traceback has been saved in:" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: _cli/util/errors.py:172 +#: ext/intersphinx/_load.py:324 msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: transforms/post_transforms/__init__.py:125 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: transforms/post_transforms/__init__.py:185 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "više od jednog targeta za 'any' referencu %r: može biti %s" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "" -#: transforms/post_transforms/__init__.py:251 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "(in %s %s)" msgstr "" -#: transforms/post_transforms/__init__.py:257 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "%r reference target not found: %s" +msgid "(in %s)" msgstr "" -#: transforms/post_transforms/images.py:77 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: transforms/post_transforms/images.py:94 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: transforms/post_transforms/images.py:141 +#: ext/intersphinx/_resolve.py:387 #, python-format -msgid "Unknown image format: %s..." +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:707 -msgid "Example" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/napoleon/docstring.py:708 -msgid "Examples" -msgstr "Primjeri" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: ext/napoleon/__init__.py:344 ext/napoleon/docstring.py:752 -msgid "Keyword Arguments" -msgstr "Argumenti" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" -#: ext/napoleon/docstring.py:768 -msgid "Notes" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:777 -msgid "Other Parameters" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/napoleon/docstring.py:813 -msgid "Receives" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:817 -msgid "References" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/napoleon/docstring.py:849 -msgid "Warns" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/napoleon/docstring.py:853 -msgid "Yields" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/napoleon/docstring.py:1015 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1022 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1029 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1036 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:256 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/autosummary/__init__.py:258 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." -msgstr "" - -#: ext/autosummary/__init__.py:277 -msgid "A captioned autosummary requires :toctree: option. ignored." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/autosummary/__init__.py:330 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/__init__.py:344 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "failed to parse name %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/autosummary/__init__.py:349 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "failed to import object %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/autosummary/__init__.py:648 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format msgid "" -"Summarised items should not include the current module. Replace %r with %r." +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/autosummary/__init__.py:819 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/autosummary/__init__.py:827 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/autosummary/generate.py:215 ext/autosummary/generate.py:391 -#, python-format -msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/autosummary/generate.py:526 -#, python-format -msgid "[autosummary] generating autosummary for: %s" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/autosummary/generate.py:530 -#, python-format -msgid "[autosummary] writing to %s" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/autosummary/generate.py:572 +#: builders/html/__init__.py:114 #, python-format -msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/autosummary/generate.py:767 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/autosummary/generate.py:789 -msgid "source files to generate rST files for" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/autosummary/generate.py:797 -msgid "directory to place all output in" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/autosummary/generate.py:805 +#: builders/html/__init__.py:372 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/autosummary/generate.py:813 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "abecedni indeks" + +#: builders/html/__init__.py:549 #, python-format -msgid "custom template directory (default: %(default)s)" +msgid "Logo of %s" msgstr "" -#: ext/autosummary/generate.py:821 -#, python-format -msgid "document imported members (default: %(default)s)" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "naprijed" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "nazad" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/autosummary/generate.py:829 -#, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:47 +#: builders/html/__init__.py:783 #, python-format -msgid "(in %s v%s)" -msgstr "(u %s v%s)" +msgid "cannot copy image file '%s': %s" +msgstr "" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:103 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:113 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:359 +#: builders/html/__init__.py:871 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:367 -#, python-format -msgid "invalid external cross-reference suffix: %r" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:378 +#: builders/html/__init__.py:923 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "cannot copy static file %r" msgstr "" -#: ext/intersphinx/_resolve.py:585 -#, python-format -msgid "external %s:%s reference target not found: %s" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:59 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:70 +#: builders/html/__init__.py:944 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_load.py:81 -#, python-format +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:92 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:101 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:120 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" - -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1225 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:155 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:240 +#: builders/html/__init__.py:1266 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:265 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:275 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:319 +#: builders/html/__init__.py:1351 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/autodoc/type_comment.py:132 +#: builders/html/__init__.py:1365 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/type_comment.py:135 +#: builders/html/__init__.py:1370 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:142 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:415 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:532 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:807 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:902 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:946 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s dokumentacija" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:965 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1028 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1035 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1048 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1114 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1337 ext/autodoc/__init__.py:1414 -#: ext/autodoc/__init__.py:2829 -#, python-format -msgid "Failed to get a function signature for %s: %s" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1633 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1760 -#, python-format -msgid "Bases: %s" -msgstr "Osnovice: %s" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" -#: ext/autodoc/__init__.py:1774 +#: builders/latex/__init__.py:529 #, python-format -msgid "missing attribute %s in object %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1855 ext/autodoc/__init__.py:1892 -#: ext/autodoc/__init__.py:1987 +#: builders/latex/__init__.py:537 #, python-format -msgid "alias of %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1875 +#: environment/collectors/toctree.py:259 #, python-format -msgid "alias of TypeVar(%s)" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:2217 ext/autodoc/__init__.py:2317 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2448 +#: environment/collectors/asset.py:126 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/preserve_defaults.py:190 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "download file not readable: %s" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "nastavak sa prethodne stranice" +#: environment/adapters/toctree.py:335 +#, python-format +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: environment/adapters/toctree.py:360 +#, python-format +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "stranica" +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "pogledajte %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "Dodatne informacije: %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "" diff --git a/sphinx/locale/hu/LC_MESSAGES/sphinx.mo b/sphinx/locale/hu/LC_MESSAGES/sphinx.mo index 51f44ec0382..1b86a8db88a 100644 Binary files a/sphinx/locale/hu/LC_MESSAGES/sphinx.mo and b/sphinx/locale/hu/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/hu/LC_MESSAGES/sphinx.po b/sphinx/locale/hu/LC_MESSAGES/sphinx.po index b341280fa2d..bbaaf99bb1b 100644 --- a/sphinx/locale/hu/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/hu/LC_MESSAGES/sphinx.po @@ -1,5 +1,5 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: @@ -13,153 +13,300 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-29 22:39+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Balázs Úr, 2020\n" "Language-Team: Hungarian (http://app.transifex.com/sphinx-doc/sphinx-1/language/hu/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" "Language: hu\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" -#: events.py:77 +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Fejlesztési Javaslatok; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "" + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "" + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 #, python-format msgid "Event %r already present" msgstr "" -#: events.py:370 +#: events.py:386 #, python-format msgid "Unknown event name: %s" msgstr "" -#: events.py:416 +#: events.py:451 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" -#: application.py:190 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Nem található a forráskönyvtár (%s)" -#: application.py:194 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:198 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "A forráskönyvtár és célkönyvtár nem lehet azonos" -#: application.py:228 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx %s verzió futtatása" -#: application.py:250 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Ez a projekt legalább a Sphinx %s verzióját igényli, és emiatt nem állítható össze ezzel a verzióval." -#: application.py:266 +#: application.py:305 msgid "making output directory" msgstr "kimeneti könyvtár elkészítése" -#: application.py:271 registry.py:452 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "a(z) %s kiterjesztés beállításakor:" -#: application.py:277 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "A „setup”, ahogy jelenleg a conf.py fájlban meg van határozva, nem meghívható Python függvény. Módosítsa a meghatározását, hogy meghívható függvénnyé tegye. Ez ahhoz szükséges, hogy a conf.py Sphinx kiterjesztésként viselkedjen." -#: application.py:312 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "fordítások betöltése [%s]…" -#: application.py:329 util/display.py:88 +#: application.py:384 util/display.py:89 msgid "done" msgstr "kész" -#: application.py:331 +#: application.py:386 msgid "not available for built-in messages" msgstr "nem érhető el beépített üzenetekhez" -#: application.py:345 +#: application.py:400 msgid "loading pickled environment" msgstr "pickle-t környezet betöltése" -#: application.py:353 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "sikertelen: %s" -#: application.py:366 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Nincs összeállító kiválasztva, az alapértelmezett használata: html" -#: application.py:398 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:400 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:404 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:407 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:409 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:414 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:417 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:419 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:968 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "a(z) %r csomópontosztály már regisztrálva van, a látogatói felül lesznek bírálva" -#: application.py:1047 +#: application.py:1113 #, python-format -msgid "directive %r is already registered, it will be overridden" -msgstr "a(z) %r direktíva már regisztrálva van, felül lesz bírálva" +msgid "directive %r is already registered and will not be overridden" +msgstr "" -#: application.py:1069 application.py:1094 +#: application.py:1139 application.py:1167 #, python-format -msgid "role %r is already registered, it will be overridden" +msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1644 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -167,12 +314,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1648 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1651 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -180,645 +327,357 @@ msgid "" "explicit" msgstr "" -#: application.py:1655 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1663 application.py:1667 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: roles.py:208 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:231 -#, python-format -msgid "invalid CVE number %s" -msgstr "" - -#: roles.py:253 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" - -#: roles.py:276 -#, python-format -msgid "invalid CWE number %s" -msgstr "" - -#: roles.py:296 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Fejlesztési Javaslatok; PEP %s" - -#: roles.py:319 -#, python-format -msgid "invalid PEP number %s" -msgstr "" - -#: roles.py:357 -#, python-format -msgid "invalid RFC number %s" -msgstr "" - -#: registry.py:144 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" -#: registry.py:146 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" -#: registry.py:159 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" -#: registry.py:166 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "" -#: registry.py:173 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "" -#: registry.py:196 registry.py:209 registry.py:220 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "" -#: registry.py:200 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" -#: registry.py:212 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" -#: registry.py:223 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" -#: registry.py:254 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "" -#: registry.py:280 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "" -#: registry.py:287 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "" -#: registry.py:296 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "" -#: registry.py:304 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "" -#: registry.py:320 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "" -#: registry.py:336 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: registry.py:419 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "" -#: registry.py:431 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "" -#: registry.py:446 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" -#: registry.py:457 +#: registry.py:545 msgid "Original exception:\n" msgstr "" -#: registry.py:458 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "" -#: registry.py:463 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" -#: registry.py:472 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" -#: registry.py:480 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" -#: registry.py:514 +#: registry.py:605 #, python-format msgid "`None` is not a valid filetype for %r." msgstr "" -#: project.py:71 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" - -#: project.py:87 +#: config.py:351 #, python-format -msgid "Ignored unreadable document %r." -msgstr "" +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "a beállítási könyvtár nem tartalmaz conf.py fájlt (%s)" -#: highlighting.py:168 +#: config.py:374 #, python-format -msgid "Pygments lexer name %r is not known" +msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: highlighting.py:202 +#: config.py:379 #, python-format msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" msgstr "" -#: extension.py:55 +#: config.py:391 #, python-format -msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." +msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: extension.py:76 +#: config.py:399 #, python-format -msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." +msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: theming.py:114 +#: config.py:422 #, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +msgid "unknown config value %r in override, ignoring" msgstr "" -#: theming.py:120 +#: config.py:476 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +msgid "No such config value: %r" msgstr "" -#: theming.py:135 +#: config.py:504 #, python-format -msgid "unsupported theme option %r given" +msgid "Config value %r already present" msgstr "" -#: theming.py:207 +#: config.py:541 #, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" msgstr "" -#: theming.py:228 -#, python-format -msgid "no theme named %r found (missing theme.toml?)" +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." msgstr "" -#: theming.py:268 +#: config.py:599 #, python-format -msgid "The %r theme has circular inheritance" +msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: theming.py:275 -#, python-format +#: config.py:603 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: theming.py:282 +#: config.py:611 #, python-format -msgid "The %r theme has too many ancestors" +msgid "" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" msgstr "" -#: theming.py:310 +#: config.py:633 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to convert %r to a frozenset" msgstr "" -#: theming.py:335 theming.py:388 +#: config.py:651 config.py:659 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: theming.py:339 +#: config.py:665 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." msgstr "" -#: theming.py:343 theming.py:391 +#: config.py:686 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +msgid "Section %s" +msgstr "%s. bekezdés" -#: theming.py:347 +#: config.py:687 #, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +msgid "Fig. %s" +msgstr "%s. ábra" -#: theming.py:366 +#: config.py:688 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +msgid "Table %s" +msgstr "%s. táblázat" -#: config.py:309 +#: config.py:689 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "a beállítási könyvtár nem tartalmaz conf.py fájlt (%s)" +msgid "Listing %s" +msgstr "%s. felsorlás" -#: config.py:318 +#: config.py:798 +#, python-brace-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"The config value `{name}` has to be a one of {candidates}, but `{current}` " +"is given." msgstr "" -#: config.py:341 -#, python-format +#: config.py:829 +#, python-brace-format msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" +"The config value `{name}' has type `{current.__name__}'; expected " +"{permitted}." msgstr "" -#: config.py:350 -#, python-format -msgid "invalid number %r for config value %r, ignoring" +#: config.py:846 +#, python-brace-format +msgid "" +"The config value `{name}' has type `{current.__name__}', defaults to " +"`{default.__name__}'." msgstr "" -#: config.py:356 +#: config.py:858 #, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" +msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:377 -#, python-format -msgid "unknown config value %r in override, ignoring" +#: config.py:878 +msgid "" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: config.py:430 -#, python-format -msgid "No such config value: %r" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: config.py:453 -#, python-format -msgid "Config value %r already present" -msgstr "" - -#: config.py:489 -#, python-format -msgid "" -"cannot cache unpickable configuration value: %r (because it contains a " -"function, class, or module object)" -msgstr "" - -#: config.py:527 -#, python-format -msgid "There is a syntax error in your configuration file: %s\n" -msgstr "" - -#: config.py:530 -msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" -msgstr "" - -#: config.py:537 -#, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" -msgstr "" - -#: config.py:560 -#, python-format -msgid "Failed to convert %r to a set or tuple" -msgstr "" - -#: config.py:581 config.py:586 -#, python-format -msgid "Converting `source_suffix = %r` to `source_suffix = %r`." -msgstr "" - -#: config.py:589 -#, python-format -msgid "" -"The config value `source_suffix' expects a dictionary, a string, or a list " -"of strings. Got `%r' instead (type %s)." -msgstr "" - -#: config.py:608 -#, python-format -msgid "Section %s" -msgstr "%s. bekezdés" - -#: config.py:609 -#, python-format -msgid "Fig. %s" -msgstr "%s. ábra" - -#: config.py:610 -#, python-format -msgid "Table %s" -msgstr "%s. táblázat" - -#: config.py:611 -#, python-format -msgid "Listing %s" -msgstr "%s. felsorlás" - -#: config.py:718 -msgid "" -"The config value `{name}` has to be a one of {candidates}, but `{current}` " -"is given." -msgstr "" - -#: config.py:742 -msgid "" -"The config value `{name}' has type `{current.__name__}'; expected " -"{permitted}." -msgstr "" - -#: config.py:755 -msgid "" -"The config value `{name}' has type `{current.__name__}', defaults to " -"`{default.__name__}'." -msgstr "" - -#: config.py:766 -#, python-format -msgid "primary_domain %r not found, ignored." -msgstr "" - -#: config.py:778 -msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." -msgstr "" - -#: domains/rst.py:128 domains/rst.py:185 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktíva)" - -#: domains/rst.py:186 domains/rst.py:190 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:214 -#, python-format -msgid "%s (role)" -msgstr "%s (szerepkör)" - -#: domains/rst.py:224 -msgid "directive" -msgstr "direktíva" - -#: domains/rst.py:225 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:226 -msgid "role" -msgstr "szerepkör" - -#: domains/rst.py:248 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:165 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (beépített függvény)" - -#: domains/javascript.py:166 domains/python/__init__.py:253 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metódus)" - -#: domains/javascript.py:168 -#, python-format -msgid "%s() (class)" -msgstr "%s() (osztály)" - -#: domains/javascript.py:170 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (globális változó vagy konstans)" - -#: domains/javascript.py:172 domains/python/__init__.py:338 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s attribútum)" - -#: domains/javascript.py:255 -msgid "Arguments" -msgstr "Argumentum" - -#: domains/cpp/__init__.py:447 domains/javascript.py:258 -msgid "Throws" -msgstr "Dob" - -#: domains/c/__init__.py:310 domains/cpp/__init__.py:458 -#: domains/javascript.py:261 domains/python/_object.py:176 -msgid "Returns" -msgstr "Visszatérési érték" - -#: domains/c/__init__.py:312 domains/javascript.py:263 -#: domains/python/_object.py:178 -msgid "Return type" -msgstr "Visszatérés típusa" - -#: domains/javascript.py:334 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" - -#: domains/c/__init__.py:681 domains/cpp/__init__.py:859 -#: domains/javascript.py:371 domains/python/__init__.py:660 -msgid "function" -msgstr "függvény" - -#: domains/javascript.py:372 domains/python/__init__.py:664 -msgid "method" -msgstr "metódus" - -#: domains/cpp/__init__.py:857 domains/javascript.py:373 -#: domains/python/__init__.py:662 -msgid "class" -msgstr "osztály" - -#: domains/javascript.py:374 domains/python/__init__.py:661 -msgid "data" -msgstr "adat" - -#: domains/javascript.py:375 domains/python/__init__.py:667 -msgid "attribute" -msgstr "attribútum" - -#: domains/javascript.py:376 domains/python/__init__.py:670 -msgid "module" -msgstr "modul" - -#: domains/javascript.py:407 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:25 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Changed in version %s" -msgstr "A %s verzióban változott" - -#: domains/changeset.py:27 -#, python-format -msgid "Deprecated since version %s" -msgstr "Elavult a(z) %s verzió óta" - -#: domains/changeset.py:28 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/__init__.py:299 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/citation.py:73 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "" - -#: domains/citation.py:84 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: domains/math.py:63 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" - -#: domains/math.py:119 writers/latex.py:2479 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: environment/__init__.py:81 +#: environment/__init__.py:89 msgid "new config" msgstr "" -#: environment/__init__.py:82 +#: environment/__init__.py:90 msgid "config changed" msgstr "" -#: environment/__init__.py:83 +#: environment/__init__.py:91 msgid "extensions changed" msgstr "" -#: environment/__init__.py:249 +#: environment/__init__.py:261 msgid "build environment version not current" msgstr "" -#: environment/__init__.py:251 +#: environment/__init__.py:263 msgid "source directory has changed" msgstr "forrás mappa megváltozott" -#: environment/__init__.py:313 +#: environment/__init__.py:350 #, python-format msgid "The configuration has changed (1 option: %r)" msgstr "" -#: environment/__init__.py:318 +#: environment/__init__.py:355 #, python-format msgid "The configuration has changed (%d options: %s)" msgstr "" -#: environment/__init__.py:324 +#: environment/__init__.py:361 #, python-format msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: environment/__init__.py:366 +#: environment/__init__.py:404 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" -#: environment/__init__.py:473 +#: environment/__init__.py:518 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" -#: environment/__init__.py:626 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format msgid "Domain %r is not registered" msgstr "" -#: environment/__init__.py:777 +#: environment/__init__.py:811 msgid "document isn't included in any toctree" msgstr "" -#: environment/__init__.py:810 +#: environment/__init__.py:922 msgid "self referenced toctree found. Ignored." msgstr "" -#: environment/__init__.py:839 +#: environment/__init__.py:952 #, python-format msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" @@ -863,3257 +722,3589 @@ msgstr "Javaslat" msgid "Warning" msgstr "Figyelem" -#: cmd/quickstart.py:43 -msgid "automatically insert docstrings from modules" +#: builders/texinfo.py:41 +#, python-format +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:44 -msgid "automatically test code snippets in doctest blocks" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: cmd/quickstart.py:45 -msgid "link between Sphinx documentation of different projects" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: cmd/quickstart.py:46 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: builders/texinfo.py:85 +#, python-format +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: cmd/quickstart.py:47 -msgid "checks for documentation coverage" +#: builders/latex/__init__.py:310 builders/texinfo.py:105 +#, python-format +msgid "processing %s" msgstr "" -#: cmd/quickstart.py:48 -msgid "include math, rendered as PNG or SVG images" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: cmd/quickstart.py:49 -msgid "include math, rendered in the browser by MathJax" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: cmd/quickstart.py:50 -msgid "conditional inclusion of content based on config values" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (" -#: cmd/quickstart.py:51 -msgid "include links to the source code of documented Python objects" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: cmd/quickstart.py:52 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 +#, python-format +msgid "cannot copy image file %r: %s" msgstr "" -#: cmd/quickstart.py:94 -msgid "Please enter a valid path name." +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter some text." +#: builders/texinfo.py:218 +#, python-format +msgid "error writing file Makefile: %s" msgstr "" -#: cmd/quickstart.py:117 +#: builders/manpage.py:37 #, python-format -msgid "Please enter one of %s." +msgid "The manual pages are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:125 -msgid "Please enter either 'y' or 'n'." +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: cmd/quickstart.py:131 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: builders/manpage.py:64 +#, python-format +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: cmd/quickstart.py:215 +#: builders/singlehtml.py:35 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: cmd/quickstart.py:219 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: cmd/quickstart.py:227 -#, python-format -msgid "Selected root path: %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: cmd/quickstart.py:230 -msgid "Enter the root path for documentation." +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: cmd/quickstart.py:231 -msgid "Root path for the documentation" +#: builders/gettext.py:243 +#, python-format +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:239 -msgid "Error: an existing conf.py has been found in the selected root path." +#: builders/__init__.py:400 builders/gettext.py:264 +#, python-format +msgid "building [%s]: " msgstr "" -#: cmd/quickstart.py:245 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "" - -#: cmd/quickstart.py:248 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:258 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:265 -msgid "Separate source and build directories (y/n)" +#: builders/gettext.py:265 +#, python-format +msgid "targets for %d template files" msgstr "" -#: cmd/quickstart.py:271 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: cmd/quickstart.py:277 -msgid "Name prefix for templates and static dir" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: cmd/quickstart.py:282 -msgid "" -"The project name will occur in several places in the built documentation." +#: builders/linkcheck.py:87 +#, python-format +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: cmd/quickstart.py:286 -msgid "Project name" +#: builders/linkcheck.py:159 +#, python-format +msgid "broken link: %s (%s)" msgstr "" -#: cmd/quickstart.py:288 -msgid "Author name(s)" +#: builders/linkcheck.py:561 +#, python-format +msgid "Anchor '%s' not found" msgstr "" -#: cmd/quickstart.py:293 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: cmd/quickstart.py:301 -msgid "Project version" +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: cmd/quickstart.py:303 -msgid "Project release" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: cmd/quickstart.py:317 -msgid "Project language" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:324 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: cmd/quickstart.py:329 -msgid "Source file suffix" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:334 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:342 -msgid "Name of your master document (without suffix)" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:352 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:359 -msgid "sphinx-quickstart will not overwrite the existing file." +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:362 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:371 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:381 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: cmd/quickstart.py:391 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" msgstr "" -#: cmd/quickstart.py:397 -msgid "Create Makefile? (y/n)" +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:401 -msgid "Create Windows command file? (y/n)" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: cmd/quickstart.py:453 ext/apidoc.py:92 +#: builders/xml.py:103 #, python-format -msgid "Creating file %s." +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:458 ext/apidoc.py:89 +#: builders/_epub_base.py:223 #, python-format -msgid "File %s already exists, skipping." +msgid "duplicated ToC entry found: %s" msgstr "" -#: cmd/quickstart.py:501 -msgid "Finished: An initial directory structure has been created." +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" msgstr "" -#: cmd/quickstart.py:504 +#: builders/_epub_base.py:467 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "cannot write image file %r: %s" msgstr "" -#: cmd/quickstart.py:512 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: cmd/quickstart.py:515 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: cmd/quickstart.py:522 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: cmd/quickstart.py:557 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: cmd/build.py:153 cmd/quickstart.py:567 ext/apidoc.py:374 -#: ext/autosummary/generate.py:766 -msgid "For more information, visit ." +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: cmd/quickstart.py:577 -msgid "quiet mode" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: cmd/quickstart.py:587 -msgid "project root" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." msgstr "" -#: cmd/quickstart.py:590 -msgid "Structure options" +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." msgstr "" -#: cmd/quickstart.py:596 -msgid "if specified, separate source and build dirs" +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." msgstr "" -#: cmd/quickstart.py:602 -msgid "if specified, create build dir under source dir" +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: cmd/quickstart.py:608 -msgid "replacement for dot in _templates etc." +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" msgstr "" -#: cmd/quickstart.py:611 -msgid "Project basic options" +#: builders/__init__.py:260 +msgid "building [mo]: " msgstr "" -#: cmd/quickstart.py:613 -msgid "project name" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " msgstr "" -#: cmd/quickstart.py:616 -msgid "author names" +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" msgstr "" -#: cmd/quickstart.py:623 -msgid "version of project" +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" msgstr "" -#: cmd/quickstart.py:630 -msgid "release of project" +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" msgstr "" -#: cmd/quickstart.py:637 -msgid "document language" +#: builders/__init__.py:324 +msgid "all source files" msgstr "" -#: cmd/quickstart.py:640 -msgid "source file suffix" +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: cmd/quickstart.py:643 -msgid "master document name" +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: cmd/quickstart.py:646 -msgid "use epub" +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: cmd/quickstart.py:649 -msgid "Extension options" +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" msgstr "" -#: cmd/quickstart.py:656 ext/apidoc.py:578 +#: builders/__init__.py:382 #, python-format -msgid "enable %s extension" +msgid "targets for %d source files that are out of date" msgstr "" -#: cmd/quickstart.py:663 ext/apidoc.py:570 -msgid "enable arbitrary extensions" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " msgstr "" -#: cmd/quickstart.py:666 -msgid "Makefile and Batchfile creation" +#: builders/__init__.py:415 +#, python-format +msgid "%d found" msgstr "" -#: cmd/quickstart.py:672 -msgid "create makefile" +#: builders/__init__.py:417 +msgid "none found" msgstr "" -#: cmd/quickstart.py:678 -msgid "do not create makefile" +#: builders/__init__.py:424 +msgid "pickling environment" msgstr "" -#: cmd/quickstart.py:685 -msgid "create batchfile" +#: builders/__init__.py:431 +msgid "checking consistency" msgstr "" -#: cmd/quickstart.py:691 -msgid "do not create batchfile" +#: builders/__init__.py:435 +msgid "no targets are out of date." msgstr "" -#: cmd/quickstart.py:700 -msgid "use make-mode for Makefile/make.bat" +#: builders/__init__.py:474 +msgid "updating environment: " msgstr "" -#: cmd/quickstart.py:703 ext/apidoc.py:581 -msgid "Project templating" +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: cmd/quickstart.py:709 ext/apidoc.py:587 -msgid "template directory for template files" +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: cmd/quickstart.py:716 -msgid "define a template variable" +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: cmd/quickstart.py:751 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: cmd/quickstart.py:770 +#: builders/__init__.py:563 +#, python-format msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "A megadott útvonal nem egy mappa vagy a sphinx állományok már léteznek." +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" -#: cmd/quickstart.py:777 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " msgstr "" -#: cmd/quickstart.py:795 +#: builders/__init__.py:725 #, python-format -msgid "Invalid template variable: %s" +msgid "docnames to write: %s" msgstr "" -#: cmd/build.py:49 -msgid "Exception occurred while building, starting debugger:" +#: builders/__init__.py:727 +msgid "no docnames to write!" msgstr "" -#: _cli/util/errors.py:129 cmd/build.py:65 -msgid "Interrupted!" +#: builders/__init__.py:740 +msgid "preparing documents" msgstr "" -#: cmd/build.py:67 -msgid "reST markup error:" +#: builders/__init__.py:743 +msgid "copying assets" msgstr "" -#: _cli/util/errors.py:143 cmd/build.py:73 -msgid "Encoding error:" +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." msgstr "" -#: cmd/build.py:78 cmd/build.py:108 +#: builders/changes.py:65 #, python-format -msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." +msgid "no changes in version %s." msgstr "" -#: _cli/util/errors.py:148 cmd/build.py:90 -msgid "Recursion error:" +#: builders/changes.py:67 +msgid "writing summary file..." msgstr "" -#: _cli/util/errors.py:152 cmd/build.py:94 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" -msgstr "" +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Beépített" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Modul szint" -#: _cli/util/errors.py:165 cmd/build.py:103 -msgid "Exception occurred:" +#: builders/changes.py:137 +msgid "copying source files..." msgstr "" -#: _cli/util/errors.py:178 cmd/build.py:117 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: cmd/build.py:124 -msgid "" -"A bug report can be filed in the tracker at . Thanks!" -msgstr "" - -#: cmd/build.py:144 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:154 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" -#: cmd/build.py:180 -msgid "path to documentation source files" +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" msgstr "" -#: cmd/build.py:183 -msgid "path to output directory" +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" msgstr "" -#: cmd/build.py:188 +#: ext/coverage.py:148 +#, python-format msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:194 -msgid "general options" -msgstr "" - -#: cmd/build.py:201 -msgid "builder to use (default: 'html')" +"the following modules are documented but were not specified in " +"coverage_modules: %s" msgstr "" -#: cmd/build.py:210 +#: ext/coverage.py:158 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:220 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:227 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:230 -msgid "path options" +"the following modules are specified in coverage_modules but were not " +"documented: %s" msgstr "" -#: cmd/build.py:236 +#: ext/coverage.py:172 +#, python-brace-format, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." msgstr "" -#: cmd/build.py:246 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" msgstr "" -#: cmd/build.py:255 -msgid "use no configuration file, only use settings from -D options" +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" msgstr "" -#: cmd/build.py:264 -msgid "override a setting in configuration file" +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" msgstr "" -#: cmd/build.py:273 -msgid "pass a value into HTML templates" +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" msgstr "" -#: cmd/build.py:282 -msgid "define tag: include \"only\" blocks with TAG" +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" msgstr "" -#: cmd/build.py:289 -msgid "nitpicky mode: warn about all missing references" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: cmd/build.py:292 -msgid "console output options" -msgstr "" +#: ext/todo.py:61 +msgid "Todo" +msgstr "Tennivaló" -#: cmd/build.py:299 -msgid "increase verbosity (can be repeated)" +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" msgstr "" -#: cmd/build.py:306 ext/apidoc.py:413 -msgid "no output on stdout, just warnings on stderr" +#: ext/todo.py:152 +msgid "<>" msgstr "" -#: cmd/build.py:313 -msgid "no output at all, not even warnings" +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" msgstr "" -#: cmd/build.py:321 -msgid "do emit colored output (default: auto-detect)" -msgstr "" +#: ext/todo.py:166 +msgid "original entry" +msgstr "eredeti bejegyzés" -#: cmd/build.py:329 -msgid "do not emit colored output (default: auto-detect)" +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" msgstr "" -#: cmd/build.py:332 -msgid "warning control options" +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/build.py:338 -msgid "write warnings (and errors) to given file" +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" -#: cmd/build.py:345 -msgid "turn warnings into errors" +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" -#: cmd/build.py:353 -msgid "show full traceback on exception" +#: ext/graphviz.py:153 +#, python-format +msgid "External Graphviz file %r not found or reading it failed" msgstr "" -#: cmd/build.py:356 -msgid "run Pdb on exception" +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." msgstr "" -#: cmd/build.py:362 -msgid "raise an exception on warnings" +#: ext/graphviz.py:287 +#, python-format +msgid "graphviz_dot executable path must be set! %r" msgstr "" -#: cmd/build.py:405 -msgid "cannot combine -a option and filenames" +#: ext/graphviz.py:328 +#, python-format +msgid "" +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" msgstr "" -#: cmd/build.py:437 +#: ext/graphviz.py:339 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/build.py:456 -msgid "-D option argument must be in the form name=value" +#: ext/graphviz.py:344 +#, python-format +msgid "" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/build.py:463 -msgid "-A option argument must be in the form name=value" +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" msgstr "" -#: builders/linkcheck.py:75 +#: ext/graphviz.py:493 ext/graphviz.py:501 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "" +msgid "[graph: %s]" +msgstr "[graph: %s]" -#: builders/linkcheck.py:146 +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" +msgstr "[graph]" + +#: ext/imgmath.py:148 #, python-format -msgid "broken link: %s (%s)" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: builders/linkcheck.py:540 +#: ext/imgmath.py:167 #, python-format -msgid "Anchor '%s' not found" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: builders/linkcheck.py:742 +#: ext/imgmath.py:326 #, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgid "display latex %r: %s" msgstr "" -#: builders/singlehtml.py:37 +#: ext/imgmath.py:362 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "inline latex %r: %s" msgstr "" -#: builders/singlehtml.py:173 -msgid "assembling single document" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: builders/latex/__init__.py:346 builders/manpage.py:56 -#: builders/singlehtml.py:178 builders/texinfo.py:121 -msgid "writing" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: builders/singlehtml.py:191 -msgid "writing additional files" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." msgstr "" -#: builders/manpage.py:39 +#: ext/doctest.py:139 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "'%s' is not a valid pyversion option" msgstr "" -#: builders/manpage.py:47 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: builders/manpage.py:73 +#: ext/doctest.py:297 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: builders/text.py:34 +#: ext/doctest.py:451 #, python-format -msgid "The text files are in %(outdir)s." +msgid "no code/output in %s block at %s:%s" msgstr "" -#: builders/html/__init__.py:1239 builders/text.py:81 builders/xml.py:97 +#: ext/doctest.py:568 #, python-format -msgid "error writing file %s: %s" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: builders/xml.py:38 +#: ext/autosectionlabel.py:52 #, python-format -msgid "The XML files are in %(outdir)s." +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: builders/xml.py:110 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "The pseudo-XML files are in %(outdir)s." +msgid "duplicate label %s, other instance in %s" msgstr "" -#: builders/texinfo.py:47 +#: ext/duration.py:47 #, python-format -msgid "The Texinfo files are in %(outdir)s." +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: builders/texinfo.py:49 +#: ext/duration.py:117 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +"====================== total reading duration ==========================" msgstr "" -#: builders/texinfo.py:78 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: builders/texinfo.py:90 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: builders/latex/__init__.py:324 builders/texinfo.py:115 +#: ext/duration.py:139 #, python-format -msgid "processing %s" +msgid "%.3fs %s" msgstr "" -#: builders/latex/__init__.py:404 builders/texinfo.py:174 -msgid "resolving references..." +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[source]" + +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: builders/latex/__init__.py:415 builders/texinfo.py:184 -msgid " (in " -msgstr " (" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[docs]" -#: builders/_epub_base.py:423 builders/html/__init__.py:778 -#: builders/latex/__init__.py:482 builders/texinfo.py:202 -msgid "copying images... " -msgstr "" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Modul forráskód" -#: builders/_epub_base.py:445 builders/latex/__init__.py:497 -#: builders/texinfo.py:219 +#: ext/viewcode.py:359 #, python-format -msgid "cannot copy image file %r: %s" -msgstr "" +msgid "

        Source code for %s

        " +msgstr "

        %s forráskódja

        " -#: builders/texinfo.py:226 -msgid "copying Texinfo support files" -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Áttekintés: modul forráskód" -#: builders/texinfo.py:234 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Az összes modul, melynek forrása elérhető

        " -#: builders/gettext.py:230 +#: domains/citation.py:75 #, python-format -msgid "The message catalogs are in %(outdir)s." +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/__init__.py:383 builders/gettext.py:251 +#: domains/citation.py:92 #, python-format -msgid "building [%s]: " +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/gettext.py:252 +#: domains/math.py:73 #, python-format -msgid "targets for %d template files" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/gettext.py:257 -msgid "reading templates... " +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/gettext.py:292 -msgid "writing message catalogs... " -msgstr "" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (beépített függvény)" -#: builders/__init__.py:212 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +msgid "%s() (%s method)" +msgstr "%s() (%s metódus)" -#: builders/__init__.py:220 +#: domains/javascript.py:186 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s() (class)" +msgstr "%s() (osztály)" -#: builders/__init__.py:243 -msgid "building [mo]: " -msgstr "" +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" +msgstr "%s (globális változó vagy konstans)" -#: builders/__init__.py:246 builders/__init__.py:741 builders/__init__.py:773 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" +msgstr "%s (%s attribútum)" + +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumentum" + +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Dob" -#: builders/__init__.py:263 +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Visszatérési érték" + +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Visszatérés típusa" + +#: domains/javascript.py:374 #, python-format -msgid "all of %d po files" -msgstr "" +msgid "%s (module)" +msgstr "%s (modul)" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "függvény" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metódus" -#: builders/__init__.py:285 +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "osztály" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "adat" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "attribútum" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" + +#: domains/javascript.py:458 #, python-format -msgid "targets for %d po files that are specified" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "" +msgid "%s (directive)" +msgstr "%s (direktíva)" -#: builders/__init__.py:307 -msgid "all source files" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 +#: domains/rst.py:224 #, python-format -msgid "file %r given on command line does not exist, " +msgid "%s (role)" +msgstr "%s (szerepkör)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "direktíva" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:325 +#: domains/rst.py:236 +msgid "role" +msgstr "szerepkör" + +#: domains/rst.py:262 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:336 +#: domains/changeset.py:32 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:351 +#: domains/changeset.py:33 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Changed in version %s" +msgstr "A %s verzióban változott" -#: builders/__init__.py:366 +#: domains/changeset.py:34 #, python-format -msgid "targets for %d source files that are out of date" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Elavult a(z) %s verzió óta" -#: builders/__init__.py:394 -msgid "looking for now-outdated files... " +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:398 +#: domains/__init__.py:322 #, python-format -msgid "%d found" +msgid "%s %s" +msgstr "%s %s" + +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:400 -msgid "none found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:407 -msgid "pickling environment" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:414 -msgid "checking consistency" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:418 -msgid "no targets are out of date." +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:458 -msgid "updating environment: " +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:483 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:519 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:528 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:539 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:546 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:565 builders/__init__.py:581 -msgid "reading sources... " +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:698 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:711 -msgid "preparing documents" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:714 -msgid "copying assets" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:866 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:83 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:220 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:231 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:255 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1289 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/_epub_base.py:222 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/_epub_base.py:434 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" + +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:465 +#: cmd/build.py:357 #, python-format -msgid "cannot write image file %r: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:477 -msgid "Pillow not found - copying image files" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:512 -msgid "writing mimetype file..." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:521 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:590 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:764 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:793 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/changes.py:33 -#, python-format -msgid "The overview file is in %(outdir)s." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/changes.py:60 -#, python-format -msgid "no changes in version %s." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/changes.py:62 -msgid "writing summary file..." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/changes.py:74 -msgid "Builtins" -msgstr "Beépített" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "" -#: builders/changes.py:76 -msgid "Module level" -msgstr "Modul szint" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "" -#: builders/changes.py:128 -msgid "copying source files..." +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/changes.py:137 +#: cmd/quickstart.py:134 #, python-format -msgid "could not read %r for changelog creation" +msgid "Please enter one of %s." msgstr "" -#: util/rst.py:72 -#, python-format -msgid "default role %s not found" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: util/docfields.py:95 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: util/osutil.py:130 +#: cmd/quickstart.py:230 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: util/nodes.py:419 -#, python-format +#: cmd/quickstart.py:235 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: util/nodes.py:487 +#: cmd/quickstart.py:242 #, python-format -msgid "toctree contains ref to nonexisting file %r" +msgid "Selected root path: %s" msgstr "" -#: util/nodes.py:701 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "" -#: util/fileutil.py:74 -#, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: util/inventory.py:170 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: util/inventory.py:185 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: util/docutils.py:284 -#, python-format -msgid "unknown directive or role name: %s:%s" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: util/docutils.py:747 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: util/display.py:81 -msgid "skipped" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: util/display.py:86 -msgid "failed" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: util/i18n.py:103 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: util/i18n.py:110 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: util/i18n.py:138 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: util/i18n.py:230 -#, python-format +#: cmd/quickstart.py:309 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "" + +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: directives/patches.py:66 +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "" + +#: cmd/quickstart.py:324 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: directives/code.py:87 -#, python-format -msgid "Invalid caption: %s" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: directives/code.py:132 directives/code.py:297 directives/code.py:484 -#, python-format -msgid "line number spec is out of range(1-%d): %r" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: directives/code.py:234 +#: cmd/quickstart.py:368 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: directives/code.py:276 -#, python-format -msgid "Object named %r not found in include file %r" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: directives/code.py:314 -#, python-format -msgid "Line spec %r: no lines pulled from include file %r" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: directives/other.py:122 -#, python-format -msgid "toctree glob pattern %r didn't match any documents" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: directives/other.py:155 environment/adapters/toctree.py:355 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "" + +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "" + +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: directives/other.py:158 environment/adapters/toctree.py:359 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Creating file %s." msgstr "" -#: directives/other.py:171 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "File %s already exists, skipping." msgstr "" -#: directives/other.py:204 -msgid "Section author: " -msgstr "Fejezet szerző: " +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "" -#: directives/other.py:206 -msgid "Module author: " -msgstr "Modul szerző: " +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "" -#: directives/other.py:208 -msgid "Code author: " -msgstr "Kód szerző: " +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "" -#: directives/other.py:210 -msgid "Author: " -msgstr "Szerző: " +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "" -#: directives/other.py:284 -msgid ".. acks content is not a list" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: directives/other.py:309 -msgid ".. hlist content is not a list" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: _cli/__init__.py:75 -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: _cli/__init__.py:112 _cli/__init__.py:183 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: _cli/__init__.py:172 -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: _cli/__init__.py:182 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: _cli/__init__.py:194 -msgid "Show the version and exit." +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: _cli/__init__.py:202 -msgid "Show this message and exit." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: _cli/__init__.py:206 -msgid "Logging" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: _cli/__init__.py:213 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: _cli/__init__.py:221 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: _cli/__init__.py:228 -msgid "No output at all" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: _cli/__init__.py:234 -msgid "" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: _cli/__init__.py:265 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:198 -#: transforms/__init__.py:133 writers/manpage.py:102 writers/texinfo.py:219 +#: cmd/quickstart.py:671 #, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" +msgid "enable %s extension" +msgstr "" -#: transforms/__init__.py:143 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: transforms/__init__.py:148 -msgid "no translated elements!" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: transforms/__init__.py:267 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: transforms/__init__.py:313 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: transforms/__init__.py:322 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: transforms/__init__.py:333 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: transforms/i18n.py:228 transforms/i18n.py:303 -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: transforms/i18n.py:273 -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: transforms/i18n.py:323 -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: transforms/i18n.py:345 -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: ext/linkcode.py:75 ext/viewcode.py:201 -msgid "[source]" -msgstr "[source]" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" -#: ext/imgconverter.py:40 -#, python-format +#: cmd/quickstart.py:786 msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "A megadott útvonal nem egy mappa vagy a sphinx állományok már léteznek." -#: ext/imgconverter.py:49 ext/imgconverter.py:73 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: ext/imgconverter.py:68 +#: cmd/quickstart.py:810 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" +msgid "Invalid template variable: %s" msgstr "" -#: ext/viewcode.py:258 -msgid "highlighting module code... " +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: ext/viewcode.py:286 -msgid "[docs]" -msgstr "[docs]" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" +msgstr "" -#: ext/viewcode.py:306 -msgid "Module code" -msgstr "Modul forráskód" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "" -#: ext/viewcode.py:312 +#: directives/other.py:169 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        %s forráskódja

        " +msgid "duplicated entry found in toctree: %s" +msgstr "" -#: ext/viewcode.py:338 -msgid "Overview: module code" -msgstr "Áttekintés: modul forráskód" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Fejezet szerző: " -#: ext/viewcode.py:339 -msgid "

        All modules for which code is available

        " -msgstr "

        Az összes modul, melynek forrása elérhető

        " +#: directives/other.py:205 +msgid "Module author: " +msgstr "Modul szerző: " -#: ext/coverage.py:47 -#, python-format -msgid "invalid regex %r in %s" +#: directives/other.py:207 +msgid "Code author: " +msgstr "Kód szerző: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Szerző: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: ext/coverage.py:134 ext/coverage.py:280 -#, python-format -msgid "module %s could not be imported: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: ext/coverage.py:141 -#, python-format +#: directives/patches.py:70 msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: ext/coverage.py:149 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: ext/coverage.py:163 +#: directives/code.py:87 #, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." +msgid "Invalid caption: %s" msgstr "" -#: ext/coverage.py:177 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "invalid regex %r in coverage_c_regexes" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: ext/coverage.py:245 +#: directives/code.py:216 #, python-format -msgid "undocumented c api: %s [%s] in file %s" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: ext/coverage.py:429 +#: directives/code.py:231 #, python-format -msgid "undocumented python function: %s :: %s" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: ext/coverage.py:445 +#: directives/code.py:235 #, python-format -msgid "undocumented python class: %s :: %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: ext/coverage.py:458 +#: directives/code.py:276 #, python-format -msgid "undocumented python method: %s :: %s :: %s" +msgid "Object named %r not found in include file %r" msgstr "" -#: ext/todo.py:71 -msgid "Todo" -msgstr "Tennivaló" - -#: ext/todo.py:104 -#, python-format -msgid "TODO entry found: %s" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: ext/todo.py:163 -msgid "<>" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: ext/todo.py:165 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "%b %d, %Y" +msgstr "%b %d, %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Tárgymutató" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: ext/todo.py:175 -msgid "original entry" -msgstr "eredeti bejegyzés" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Lábjegyzetek" -#: ext/extlinks.py:82 +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "" + +#: writers/texinfo.py:1303 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "unimplemented node type: %r" msgstr "" -#: ext/doctest.py:115 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "[image: %s]" +msgstr "[image: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[image]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: ext/doctest.py:120 +#: writers/html5.py:431 #, python-format -msgid "'%s' is not a valid option." +msgid "numfig_format is not defined for %s" msgstr "" -#: ext/doctest.py:134 +#: writers/html5.py:441 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "Any IDs not assigned for %s node" msgstr "" -#: ext/doctest.py:220 -msgid "invalid TestCode type" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: ext/doctest.py:281 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: ext/doctest.py:434 -#, python-format -msgid "no code/output in %s block at %s:%s" +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: ext/doctest.py:522 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "unsupported rubric heading level: %s" msgstr "" -#: ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: ext/graphviz.py:145 -#, python-format -msgid "External Graphviz file %r not found or reading it failed" +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: ext/graphviz.py:268 +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "" + +#: writers/latex.py:386 #, python-format -msgid "graphviz_dot executable path must be set! %r" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: ext/graphviz.py:303 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" +msgid "no Babel option known for language %r" +msgstr "" + +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: ext/graphviz.py:310 +#: writers/latex.py:616 #, python-format +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "" + +#: writers/latex.py:1198 msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: ext/graphviz.py:313 +#: writers/latex.py:1228 #, python-format msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: ext/graphviz.py:329 +#: writers/latex.py:1615 #, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: ext/graphviz.py:333 ext/graphviz.py:386 ext/graphviz.py:423 +#: writers/latex.py:1950 #, python-format -msgid "dot code %r: %s" +msgid "unknown index entry type %s found" msgstr "" -#: ext/graphviz.py:436 ext/graphviz.py:444 -#, python-format -msgid "[graph: %s]" -msgstr "[graph: %s]" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: ext/graphviz.py:438 ext/graphviz.py:446 -msgid "[graph]" -msgstr "[graph]" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: ext/imgmath.py:369 ext/mathjax.py:52 -msgid "Link to this equation" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: ext/apidoc.py:85 -#, python-format -msgid "Would create file %s." +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: ext/apidoc.py:375 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: ext/apidoc.py:392 -msgid "path to module to document" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: ext/apidoc.py:396 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: ext/apidoc.py:407 -msgid "directory to place all output" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: ext/apidoc.py:422 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: ext/apidoc.py:429 -msgid "overwrite existing files" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: ext/apidoc.py:437 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: ext/apidoc.py:446 -msgid "run the script without creating files" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: ext/apidoc.py:453 -msgid "put documentation for each module on its own page" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: ext/apidoc.py:460 -msgid "include \"_private\" modules" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: ext/apidoc.py:467 -msgid "filename of table of contents (default: modules)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: ext/apidoc.py:474 -msgid "don't create a table of contents file" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: ext/apidoc.py:481 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: ext/apidoc.py:492 -msgid "put module documentation before submodule documentation" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: ext/apidoc.py:498 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: ext/apidoc.py:508 -msgid "file suffix (default: rst)" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: ext/apidoc.py:515 ext/autosummary/generate.py:839 -msgid "Remove existing files in the output directory that were not generated" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: ext/apidoc.py:524 -msgid "generate a full project with sphinx-quickstart" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: ext/apidoc.py:531 -msgid "append module_path to sys.path, used when --full is given" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: ext/apidoc.py:538 -msgid "project name (default: root module name)" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: ext/apidoc.py:545 -msgid "project author(s), used when --full is given" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: ext/apidoc.py:552 -msgid "project version, used when --full is given" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: ext/apidoc.py:559 -msgid "project release, used when --full is given, defaults to --doc-version" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: ext/apidoc.py:564 -msgid "extension options" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: ext/apidoc.py:638 +#: util/i18n.py:100 #, python-format -msgid "%s is not a directory." -msgstr "%s nem mappa" +msgid "reading error: %s, %s" +msgstr "" -#: ext/apidoc.py:710 ext/autosummary/generate.py:875 +#: util/i18n.py:113 #, python-format -msgid "Failed to remove %s: %s" +msgid "writing error: %s, %s" msgstr "" -#: ext/autosectionlabel.py:48 +#: util/i18n.py:146 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "locale_dir %s does not exist" msgstr "" -#: domains/std/__init__.py:703 domains/std/__init__.py:812 -#: ext/autosectionlabel.py:52 +#: util/i18n.py:244 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: ext/duration.py:85 +#: util/i18n.py:253 +#, python-format msgid "" -"====================== slowest reading durations =======================" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: ext/imgmath.py:159 +#: util/osutil.py:131 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: ext/imgmath.py:174 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: ext/imgmath.py:328 -#, python-format -msgid "display latex %r: %s" +#: util/display.py:87 +msgid "failed" msgstr "" -#: ext/imgmath.py:362 +#: util/docutils.py:325 #, python-format -msgid "inline latex %r: %s" +msgid "unknown directive name: %s" msgstr "" -#: writers/latex.py:1090 writers/manpage.py:263 writers/texinfo.py:662 -msgid "Footnotes" -msgstr "Lábjegyzetek" - -#: writers/manpage.py:309 writers/text.py:936 +#: util/docutils.py:361 #, python-format -msgid "[image: %s]" -msgstr "[image: %s]" - -#: writers/manpage.py:310 writers/text.py:937 -msgid "[image]" -msgstr "[image]" - -#: writers/html5.py:99 writers/html5.py:108 -msgid "Link to this definition" +msgid "unknown role name: %s" msgstr "" -#: writers/html5.py:415 +#: util/docutils.py:805 #, python-format -msgid "numfig_format is not defined for %s" +msgid "unknown node type: %r" msgstr "" -#: writers/html5.py:427 +#: util/fileutil.py:76 #, python-format -msgid "Any IDs not assigned for %s node" +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: writers/html5.py:482 -msgid "Link to this term" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: writers/html5.py:525 writers/html5.py:530 -msgid "Link to this heading" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: writers/html5.py:535 -msgid "Link to this table" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: writers/html5.py:549 writers/latex.py:1099 +#: util/nodes.py:462 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: writers/html5.py:613 -msgid "Link to this code" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: writers/html5.py:615 -msgid "Link to this image" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: writers/html5.py:617 -msgid "Link to this toctree" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "folytatás az előző oldalról" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: writers/html5.py:758 -msgid "Could not obtain image size. :scale: option is ignored." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: builders/latex/__init__.py:205 domains/std/__init__.py:646 -#: domains/std/__init__.py:658 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:513 -msgid "Index" -msgstr "Tárgymutató" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Szimbólumok" -#: writers/latex.py:743 writers/texinfo.py:644 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: writers/texinfo.py:1216 -msgid "caption not inside a figure." -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "oldal" -#: writers/texinfo.py:1302 -#, python-format -msgid "unimplemented node type: %r" -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Kiadás" -#: writers/latex.py:360 +#: transforms/post_transforms/images.py:79 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: builders/latex/__init__.py:223 writers/latex.py:410 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:428 -msgid "too large :maxdepth:, ignored." +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: writers/latex.py:590 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:708 -msgid "document title is not a single Text node" +msgid "Unknown image format: %s..." msgstr "" -#: writers/latex.py:1175 +#: transforms/post_transforms/__init__.py:88 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: writers/latex.py:1573 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "dimension unit %s is invalid. Ignored." +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: writers/latex.py:1931 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "unknown index entry type %s found" +msgid "%s:%s reference target not found: %s" msgstr "" -#: domains/std/__init__.py:87 domains/std/__init__.py:104 -#, python-format -msgid "environment variable; %s" -msgstr "környezeti változó; %s" - -#: domains/std/__init__.py:112 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "%s; configuration value" +msgid "%r reference target not found: %s" msgstr "" -#: domains/std/__init__.py:166 -msgid "Type" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: domains/std/__init__.py:176 -msgid "Default" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: domains/std/__init__.py:235 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: domains/std/__init__.py:306 -#, python-format -msgid "%s command line option" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: domains/std/__init__.py:308 -msgid "command line option" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: domains/std/__init__.py:430 -msgid "glossary term must be preceded by empty line" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: domains/std/__init__.py:438 -msgid "glossary terms must not be separated by empty lines" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: domains/std/__init__.py:444 domains/std/__init__.py:457 -msgid "glossary seems to be misformatted, check indentation" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: domains/std/__init__.py:602 -msgid "glossary term" -msgstr "szójegyzék" - -#: domains/std/__init__.py:603 -msgid "grammar token" -msgstr "nyelvtani jel" - -#: domains/std/__init__.py:604 -msgid "reference label" -msgstr "referencia cimke" - -#: domains/std/__init__.py:607 -msgid "environment variable" -msgstr "környezeti változó" - -#: domains/std/__init__.py:608 -msgid "program option" -msgstr "program opció" - -#: domains/std/__init__.py:609 -msgid "document" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: domains/std/__init__.py:647 domains/std/__init__.py:659 -msgid "Module Index" -msgstr "Modulok" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Oldalsáv összezárása" -#: domains/std/__init__.py:648 domains/std/__init__.py:660 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "Keresés" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigáció" -#: domains/std/__init__.py:722 +#: themes/basic/layout.html:115 #, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" +msgid "Search within %(docstitle)s" +msgstr "Keresés köztük: %(docstitle)s" -#: domains/std/__init__.py:932 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Névjegy ezekről a dokumentumokról" -#: domains/std/__init__.py:940 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Keresés" -#: domains/std/__init__.py:952 -#, python-format -msgid "the link has no caption: %s" -msgstr "" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Minden jog fenntartva" -#: domains/std/__init__.py:966 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "invalid numfig_format: %s (%r)" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: domains/std/__init__.py:969 +#: themes/basic/layout.html:201 #, python-format -msgid "invalid numfig_format: %s" -msgstr "" +msgid "Last updated on %(last_updated)s." +msgstr "Utolsó frissítés %(last_updated)s." -#: domains/std/__init__.py:1200 +#: themes/basic/layout.html:204 #, python-format -msgid "undefined label: %r" +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: domains/std/__init__.py:1202 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Előző témakör" -#: domains/python/__init__.py:107 domains/python/__init__.py:244 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (%s modulban)" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "előző fejezet" -#: domains/python/__init__.py:167 domains/python/__init__.py:334 -#: domains/python/__init__.py:385 domains/python/__init__.py:424 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (%s modulban)" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Következő témakör" -#: domains/python/__init__.py:169 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (beépített változó)" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "következő fejezet" -#: domains/python/__init__.py:194 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "%s (built-in class)" -msgstr "%s (beépített osztály)" +msgid "Index – %(key)s" +msgstr "" -#: domains/python/__init__.py:195 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (osztály %s)" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Teljes tárgymutató egy oldalon" -#: domains/python/__init__.py:249 -#, python-format -msgid "%s() (%s class method)" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Ez az Oldal" + +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "Forrás megtekintése" + +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Gyorskeresés" + +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Ok" + +#: themes/basic/defindex.html:4 +msgid "Overview" +msgstr "Áttekintés" + +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" +msgstr "Üdvözöljük! Ez a" + +#: themes/basic/defindex.html:9 +msgid "the documentation for" +msgstr "dokumentáció" + +#: themes/basic/defindex.html:10 +msgid "last updated" +msgstr "utoljára frissítve" + +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" +msgstr "Tárgymutató és táblázatok" + +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "Teljes tartalomjegyzék" + +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "kilistázza az összes fejezetet és alfejezetet" + +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "Keresés" + +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "keresés ebben a dokumentációban" + +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "Teljes modul tárgymutató" + +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "gyors hozzáférés az összes modulhoz" + +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Általános tárgymutató" + +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "összes funkció, osztály és kifejezés" + +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "" + +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "Keresés %(docstitle)s" + +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Oldalak ABC sorrendben" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "nagy lehet" + +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." +msgstr "Kérem engedélyezze a JavaScriptet a kereső funkció\n használatához." + +#: themes/basic/search.html:28 +msgid "" +"Searching for multiple words only shows matches that contain\n" +" all words." +msgstr "" + +#: themes/basic/search.html:35 +msgid "search" +msgstr "keresés" + +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Tartalom" + +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "Keresési Eredmények" + +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." +msgstr "A keresése nem hozott eredményt. Ellenőrizze, a megadott kulcsszavakat és azt, hogy megfelelő számú kategória van-e kiválasztva." + +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" + +#: themes/basic/static/searchtools.js:276 +msgid "Searching" +msgstr "Keresés folyamatban" + +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "Felkészülés a keresésre..." + +#: themes/basic/static/searchtools.js:526 +msgid ", in " +msgstr ", " + +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Keresési Találatok Elrejtése" + +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 +#, python-format +msgid "Changes in Version %(version)s — %(docstitle)s" +msgstr "" + +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + +#: themes/basic/changes/versionchanges.html:17 +#, python-format +msgid "Automatically generated list of changes in version %(version)s" +msgstr "Automatikusan generált változáslista a(z) %(version)s változathoz" + +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" +msgstr "Könyvtár változások" + +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" +msgstr "C API változások" + +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" +msgstr "Egyéb változások" + +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" +msgstr "Oldalsáv kinyitása" + +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" +msgstr "" + +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Paraméterek" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Változók" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Kivétel" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 +#, python-format +msgid "%s() (in module %s)" +msgstr "%s() (%s modulban)" + +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 +#, python-format +msgid "%s (in module %s)" +msgstr "%s (%s modulban)" + +#: domains/python/__init__.py:174 +#, python-format +msgid "%s (built-in variable)" +msgstr "%s (beépített változó)" + +#: domains/python/__init__.py:209 +#, python-format +msgid "%s (built-in class)" +msgstr "%s (beépített osztály)" + +#: domains/python/__init__.py:210 +#, python-format +msgid "%s (class in %s)" +msgstr "%s (osztály %s)" + +#: domains/python/__init__.py:275 +#, python-format +msgid "%s() (%s class method)" msgstr "%s() (%s osztály metódus)" -#: domains/python/__init__.py:251 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statikus metódus)" -#: domains/python/__init__.py:389 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:428 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:559 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python Modul Mutató" -#: domains/python/__init__.py:560 +#: domains/python/__init__.py:625 msgid "modules" msgstr "modulok" -#: domains/python/__init__.py:637 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Elavult" -#: domains/python/__init__.py:663 +#: domains/python/__init__.py:729 msgid "exception" msgstr "kivétel" -#: domains/python/__init__.py:665 +#: domains/python/__init__.py:731 msgid "class method" msgstr "osztály szintű metódus" -#: domains/python/__init__.py:666 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statikus metódus" -#: domains/python/__init__.py:668 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:669 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:729 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:858 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:920 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (elavult)" -#: domains/c/__init__.py:304 domains/cpp/__init__.py:441 -#: domains/python/_object.py:164 ext/napoleon/docstring.py:786 -msgid "Parameters" -msgstr "Paraméterek" - -#: domains/python/_object.py:169 -msgid "Variables" -msgstr "Változók" - -#: domains/python/_object.py:173 -msgid "Raises" -msgstr "Kivétel" - -#: domains/c/__init__.py:199 +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 #, python-format -msgid "%s (C %s)" +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" -#: domains/c/__init__.py:260 domains/c/_symbol.py:510 +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" +msgstr "Sablonparaméterek" + +#: domains/cpp/__init__.py:302 #, python-format -msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." +msgid "%s (C++ %s)" msgstr "" -#: domains/c/__init__.py:307 domains/cpp/__init__.py:454 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:679 domains/cpp/__init__.py:860 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "" + +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "tag" -#: domains/c/__init__.py:680 -msgid "variable" -msgstr "változó" - -#: domains/c/__init__.py:682 -msgid "macro" -msgstr "makró" - -#: domains/c/__init__.py:683 -msgid "struct" -msgstr "" +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "típus" -#: domains/c/__init__.py:684 domains/cpp/__init__.py:858 -msgid "union" +#: domains/cpp/__init__.py:946 +msgid "concept" msgstr "" -#: domains/c/__init__.py:685 domains/cpp/__init__.py:863 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enumeráció" -#: domains/c/__init__.py:686 domains/cpp/__init__.py:864 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerátor" -#: domains/c/__init__.py:687 domains/cpp/__init__.py:861 -msgid "type" -msgstr "típus" - -#: domains/c/__init__.py:689 domains/cpp/__init__.py:866 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:155 -msgid "Template Parameters" -msgstr "Sablonparaméterek" - -#: domains/cpp/__init__.py:277 -#, python-format -msgid "%s (C++ %s)" +#: domains/cpp/__init__.py:954 +msgid "template parameter" msgstr "" -#: domains/cpp/__init__.py:360 domains/cpp/_symbol.py:793 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/cpp/__init__.py:862 -msgid "concept" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/cpp/__init__.py:867 -msgid "template parameter" +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Tartalom" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "változó" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "makró" + +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Keresés" +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" +msgstr "környezeti változó; %s" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Ok" +#: domains/std/__init__.py:116 +#, python-format +msgid "%s; configuration value" +msgstr "" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "Forrás megtekintése" +#: domains/std/__init__.py:172 +msgid "Type" +msgstr "" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Oldalsáv összezárása" +#: domains/std/__init__.py:182 +msgid "Default" +msgstr "" -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigáció" +#: domains/std/__init__.py:239 +#, python-format +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" +msgstr "" -#: themes/basic/layout.html:115 +#: domains/std/__init__.py:319 #, python-format -msgid "Search within %(docstitle)s" -msgstr "Keresés köztük: %(docstitle)s" +msgid "%s command line option" +msgstr "" -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Névjegy ezekről a dokumentumokról" +#: domains/std/__init__.py:321 +msgid "command line option" +msgstr "" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Minden jog fenntartva" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" +msgstr "" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Utolsó frissítés %(last_updated)s." +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "szójegyzék" + +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "nyelvtani jel" + +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "referencia cimke" + +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "környezeti változó" + +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "program opció" + +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: themes/basic/genindex-single.html:26 +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Modulok" + +#: domains/std/__init__.py:857 #, python-format -msgid "Index – %(key)s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Teljes tárgymutató egy oldalon" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "" -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Oldalak ABC sorrendben" +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" +msgstr "" -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "nagy lehet" +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" +msgstr "" -#: themes/basic/opensearch.xml:4 +#: domains/std/__init__.py:1153 #, python-format -msgid "Search %(docstitle)s" -msgstr "Keresés %(docstitle)s" +msgid "invalid numfig_format: %s (%r)" +msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Ez az Oldal" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" +msgstr "" -#: themes/basic/defindex.html:4 -msgid "Overview" -msgstr "Áttekintés" +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" +msgstr "" -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" -msgstr "Üdvözöljük! Ez a" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "" -#: themes/basic/defindex.html:9 -msgid "the documentation for" -msgstr "dokumentáció" +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" +msgstr "" -#: themes/basic/defindex.html:10 -msgid "last updated" -msgstr "utoljára frissítve" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" +msgstr "" -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" -msgstr "Tárgymutató és táblázatok" +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" +msgstr "" -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" -msgstr "Teljes tartalomjegyzék" +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" +msgstr "" -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "kilistázza az összes fejezetet és alfejezetet" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "" -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "keresés ebben a dokumentációban" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "" -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "Teljes modul tárgymutató" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "" -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "gyors hozzáférés az összes modulhoz" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Általános tárgymutató" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "összes funkció, osztály és kifejezés" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Gyorskeresés" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "" -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." -msgstr "Kérem engedélyezze a JavaScriptet a kereső funkció\n használatához." +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "" -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: themes/basic/search.html:35 -msgid "search" -msgstr "keresés" +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" +msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Előző témakör" +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 +#, python-format +msgid "alias of %s" +msgstr "" -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "előző fejezet" +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" +msgstr "" -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Következő témakör" +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" +msgstr "" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "következő fejezet" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "" -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" -msgstr "Oldalsáv kinyitása" +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" +msgstr "" -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: themes/basic/changes/versionchanges.html:17 +#: ext/autodoc/_names.py:89 #, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Automatikusan generált változáslista a(z) %(version)s változathoz" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Könyvtár változások" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" +msgstr "" -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "C API változások" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "" -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Egyéb változások" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" +msgstr "" -#: themes/basic/changes/rstsource.html:5 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "%(filename)s — %(docstitle)s" +msgid "Would create file %s." msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Keresési Találatok Elrejtése" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "" -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" -msgstr "Keresési Eredmények" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" -#: themes/basic/static/searchtools.js:119 +#: ext/apidoc/_cli.py:50 msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." -msgstr "A keresése nem hozott eredményt. Ellenőrizze, a megadott kulcsszavakat és azt, hogy megfelelő számú kategória van-e kiválasztva." +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "" -#: themes/basic/static/searchtools.js:123 -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: themes/basic/static/searchtools.js:253 -msgid "Searching" -msgstr "Keresés folyamatban" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "" -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." -msgstr "Felkészülés a keresésre..." +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "" -#: themes/basic/static/searchtools.js:474 -msgid ", in " -msgstr ", " +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "" -#: environment/collectors/asset.py:96 -#, python-format -msgid "image file not readable: %s" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: environment/collectors/asset.py:124 -#, python-format -msgid "image file %s not readable: %s" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: environment/collectors/asset.py:161 -#, python-format -msgid "download file not readable: %s" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: environment/collectors/toctree.py:258 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: environment/adapters/toctree.py:318 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: environment/adapters/toctree.py:342 -#, python-format +#: ext/apidoc/_cli.py:135 msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: environment/adapters/toctree.py:357 -#, python-format -msgid "toctree contains reference to non-included document %r" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: environment/adapters/indexentries.py:126 -#, python-format -msgid "see %s" -msgstr "lásd %s" - -#: environment/adapters/indexentries.py:136 -#, python-format -msgid "see also %s" -msgstr "lásd még %s" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" -#: environment/adapters/indexentries.py:144 -#, python-format -msgid "unknown index entry type %r" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: environment/adapters/indexentries.py:270 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Szimbólumok" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/html/__init__.py:363 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: builders/html/__init__.py:382 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "nyitóoldal" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: builders/html/__init__.py:560 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "Logo of %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "következő" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "előző" - -#: builders/html/__init__.py:695 -msgid "generating indices" -msgstr "" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "%s nem mappa" -#: builders/html/__init__.py:710 -msgid "writing additional pages" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/__init__.py:793 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/__init__.py:805 -msgid "copying downloadable files... " +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:817 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/__init__.py:863 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/__init__.py:881 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/__init__.py:916 -msgid "copying static files" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:933 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "cannot copy static file %r" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/__init__.py:938 -msgid "copying extra files" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/html/__init__.py:948 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: builders/html/__init__.py:954 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "Failed to write build info file: %r" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/html/__init__.py:1003 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/html/__init__.py:1051 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: builders/html/__init__.py:1213 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: builders/html/__init__.py:1222 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1255 -msgid "dumping object inventory" +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: builders/html/__init__.py:1263 +#: ext/autosummary/generate.py:634 #, python-format -msgid "dumping search index in %s" +msgid "[autosummary] writing to %s" msgstr "" -#: builders/html/__init__.py:1306 +#: ext/autosummary/generate.py:679 #, python-format -msgid "invalid js_file: %r, ignored" +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1339 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: builders/html/__init__.py:1344 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: builders/html/__init__.py:1358 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: builders/html/__init__.py:1363 +#: ext/autosummary/generate.py:915 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1378 +#: ext/autosummary/generate.py:923 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "custom template directory (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1383 +#: ext/autosummary/generate.py:931 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "document imported members (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1394 builders/latex/__init__.py:504 +#: ext/autosummary/generate.py:940 #, python-format -msgid "logo file %r does not exist" +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: builders/html/__init__.py:1405 +#: ext/autosummary/__init__.py:235 #, python-format -msgid "favicon file %r does not exist" +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: builders/html/__init__.py:1417 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: builders/html/__init__.py:1430 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: builders/html/__init__.py:1447 +#: ext/autosummary/__init__.py:329 #, python-format -msgid "%s %s documentation" -msgstr "%s %s dokumentáció" - -#: builders/latex/transforms.py:118 -msgid "Failed to get a docname!" +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/latex/transforms.py:119 +#: ext/autosummary/__init__.py:358 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "failed to import object %s" msgstr "" -#: builders/latex/transforms.py:485 +#: ext/autosummary/__init__.py:652 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: builders/latex/__init__.py:117 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "autosummary_generate: file not found: %s" msgstr "" -#: builders/latex/__init__.py:119 +#: ext/autosummary/__init__.py:860 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "" - -#: builders/latex/__init__.py:157 -msgid "no \"latex_documents\" config value found; no documents will be written" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: builders/latex/__init__.py:169 +#: ext/intersphinx/_load.py:61 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: builders/latex/__init__.py:208 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Kiadás" - -#: builders/latex/__init__.py:429 -msgid "copying TeX support files" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: builders/latex/__init__.py:466 -msgid "copying additional files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: builders/latex/__init__.py:540 +#: ext/intersphinx/_load.py:94 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: builders/latex/__init__.py:548 +#: ext/intersphinx/_load.py:103 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: builders/latex/theming.py:87 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: builders/latex/theming.py:90 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: _cli/util/errors.py:124 -msgid "Exception occurred, starting debugger:" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: _cli/util/errors.py:133 -msgid "reStructuredText markup error:" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: _cli/util/errors.py:168 -msgid "The full traceback has been saved in:" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: _cli/util/errors.py:172 +#: ext/intersphinx/_load.py:324 msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: transforms/post_transforms/__init__.py:125 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: transforms/post_transforms/__init__.py:185 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: transforms/post_transforms/__init__.py:251 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "(in %s %s)" msgstr "" -#: transforms/post_transforms/__init__.py:257 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "%r reference target not found: %s" +msgid "(in %s)" msgstr "" -#: transforms/post_transforms/images.py:77 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: transforms/post_transforms/images.py:94 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: transforms/post_transforms/images.py:141 +#: ext/intersphinx/_resolve.py:387 #, python-format -msgid "Unknown image format: %s..." +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:707 -msgid "Example" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/napoleon/docstring.py:708 -msgid "Examples" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/__init__.py:344 ext/napoleon/docstring.py:752 -msgid "Keyword Arguments" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/napoleon/docstring.py:768 -msgid "Notes" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:777 -msgid "Other Parameters" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/napoleon/docstring.py:813 -msgid "Receives" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:817 -msgid "References" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/napoleon/docstring.py:849 -msgid "Warns" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/napoleon/docstring.py:853 -msgid "Yields" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/napoleon/docstring.py:1015 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1022 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1029 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1036 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:256 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/autosummary/__init__.py:258 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." -msgstr "" - -#: ext/autosummary/__init__.py:277 -msgid "A captioned autosummary requires :toctree: option. ignored." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/autosummary/__init__.py:330 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/__init__.py:344 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "failed to parse name %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/autosummary/__init__.py:349 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "failed to import object %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/autosummary/__init__.py:648 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format msgid "" -"Summarised items should not include the current module. Replace %r with %r." +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/autosummary/__init__.py:819 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/autosummary/__init__.py:827 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/autosummary/generate.py:215 ext/autosummary/generate.py:391 -#, python-format -msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/autosummary/generate.py:526 -#, python-format -msgid "[autosummary] generating autosummary for: %s" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/autosummary/generate.py:530 -#, python-format -msgid "[autosummary] writing to %s" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/autosummary/generate.py:572 +#: builders/html/__init__.py:114 #, python-format -msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/autosummary/generate.py:767 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/autosummary/generate.py:789 -msgid "source files to generate rST files for" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/autosummary/generate.py:797 -msgid "directory to place all output in" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/autosummary/generate.py:805 +#: builders/html/__init__.py:372 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/autosummary/generate.py:813 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "nyitóoldal" + +#: builders/html/__init__.py:549 #, python-format -msgid "custom template directory (default: %(default)s)" +msgid "Logo of %s" msgstr "" -#: ext/autosummary/generate.py:821 -#, python-format -msgid "document imported members (default: %(default)s)" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "következő" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "előző" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/autosummary/generate.py:829 -#, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:47 +#: builders/html/__init__.py:783 #, python-format -msgid "(in %s v%s)" -msgstr "(%s v%s)" +msgid "cannot copy image file '%s': %s" +msgstr "" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:103 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:113 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:359 +#: builders/html/__init__.py:871 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:367 -#, python-format -msgid "invalid external cross-reference suffix: %r" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:378 +#: builders/html/__init__.py:923 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "cannot copy static file %r" msgstr "" -#: ext/intersphinx/_resolve.py:585 -#, python-format -msgid "external %s:%s reference target not found: %s" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:59 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:70 +#: builders/html/__init__.py:944 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_load.py:81 -#, python-format +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:92 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:101 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:120 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" - -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1225 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:155 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:240 +#: builders/html/__init__.py:1266 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:265 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:275 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:319 +#: builders/html/__init__.py:1351 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/autodoc/type_comment.py:132 +#: builders/html/__init__.py:1365 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/type_comment.py:135 +#: builders/html/__init__.py:1370 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:142 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:415 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:532 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:807 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:902 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:946 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s dokumentáció" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:965 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1028 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1035 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1048 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1114 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1337 ext/autodoc/__init__.py:1414 -#: ext/autodoc/__init__.py:2829 -#, python-format -msgid "Failed to get a function signature for %s: %s" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1633 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1760 -#, python-format -msgid "Bases: %s" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1774 +#: builders/latex/__init__.py:529 #, python-format -msgid "missing attribute %s in object %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1855 ext/autodoc/__init__.py:1892 -#: ext/autodoc/__init__.py:1987 +#: builders/latex/__init__.py:537 #, python-format -msgid "alias of %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1875 +#: environment/collectors/toctree.py:259 #, python-format -msgid "alias of TypeVar(%s)" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:2217 ext/autodoc/__init__.py:2317 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2448 +#: environment/collectors/asset.py:126 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/preserve_defaults.py:190 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "download file not readable: %s" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "folytatás az előző oldalról" +#: environment/adapters/toctree.py:335 +#, python-format +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: environment/adapters/toctree.py:360 +#, python-format +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "oldal" +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "lásd %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "lásd még %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "" diff --git a/sphinx/locale/id/LC_MESSAGES/sphinx.mo b/sphinx/locale/id/LC_MESSAGES/sphinx.mo index 824aafc7ceb..64b6f218233 100644 Binary files a/sphinx/locale/id/LC_MESSAGES/sphinx.mo and b/sphinx/locale/id/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/id/LC_MESSAGES/sphinx.po b/sphinx/locale/id/LC_MESSAGES/sphinx.po index 38005e0e114..8743b27e991 100644 --- a/sphinx/locale/id/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/id/LC_MESSAGES/sphinx.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: oon arfiandwi (OonID) , 2023\n" "Language-Team: Indonesian (http://app.transifex.com/sphinx-doc/sphinx-1/language/id/)\n" @@ -24,6 +24,127 @@ msgstr "" "Language: id\n" "Plural-Forms: nplurals=1; plural=0;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "nomor PEP %s tidak valid" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "nomor RFC tidak valid %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "pengaturan %s.%s terjadi pada tak satupun konfigurasi tema yang dicari" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "opsi tema yang tidak didukung %r diberikan" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "berkas %r pada path tema merupakan berkas zip yang tidak valid atau tidak berisi tema" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -38,127 +159,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Proyek ini memerlukan ekstensi %s sedikitnya pada versi %s dan maka itu tidak bisa dibangun dengan versi yang dimuat (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Nama Pygments lexer %r tidak diketahui" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Event %r sudah ada" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Nama event tidak dikenal: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Tidak dapat menemukan direktori sumber (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Direktori keluaran (%s) bukan direktori" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Direktori sumber dan direktori tujuan tidak boleh sama" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Menjalankan Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Proyek ini memerlukan sedikitnya Sphinx v%s dan maka itu tidak bisa dibangun dengan versi ini." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "membuat direktori keluaran" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "saat menyiapkan ekstensi %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' yang saat ini didefinisikan pada conf.py bukanlah sebuah Python callable. Silakan modifikasi definisinya untuk membuatnya menjadi fungsi callable. Hal ini diperlukan guna conf.py berjalan sebagai ekstensi Sphinx." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "memuat terjemahan [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "selesai" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "tidak tersedia untuk built-in messages" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "memuat lingkungan yang diawetkan" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "gagal: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Tidak ada builder yang dipilih, menggunakan default: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "kelas simpul %r sudah terdaftar, pengunjungnya akan diganti" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -166,12 +314,12 @@ msgid "" "explicit" msgstr "ekstensi %s tidak akan dinyatakan jika itu aman untuk pembacaan paralel, dengan anggapan itu tidak aman - silakan tanya pembuat ekstensi untuk memeriksa dan membuatnya eksplisit" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "ekstensi %s tidak aman untuk pembacaan paralel" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -179,82 +327,214 @@ msgid "" "explicit" msgstr " \nekstensi %s tidak akan dinyatakan jika itu aman untuk penulisan paralel, dengan anggapan itu tidak aman - silakan tanya pembuat ekstensi untuk memeriksa dan membuatnya eksplisit" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "ekstensi %s tidak aman untuk penulisan paralel" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "mengerjakan serial %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "direktori konfigurasi tidak berisi berkas conf.py (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Class Builder %s tidak punya atribut \"name\"" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Builder %r sudah ada (di modul %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Nama Builder %s todal terdaftar atau tersedia melalui entry point" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Nama Builder %s tidak terdaftar" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "domain %s telah terdaftar" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "domain %s belum didaftarkan" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "Pengarahan %r sudah terdaftar di domain %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "Peran %r sudah terdaftar di domain %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "Indeks %r sudah terdaftar ke domain %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "object_type %r telah didaftarkan" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "crossref_type %r telah didaftarkan" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r telah didaftarkan" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser untuk %r telah didaftarkan" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Parser sumber untuk %s tidak terdaftar" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "Penerjemah untuk %r sudah ada" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "kwargs untuk add_node() harus berupa (visit, depart) function tuple: %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r telah terdaftar" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "ekstensi %r telah digabungkan dengan Sphinx sejak versi %s; ekstensi diabaikan." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Eksepsi orisinal:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Tidak dapat mengimpor ekstensi %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "ekstensi %r tidak memiliki fungsi setup(); apa itu benar-benar sebuah modul ekstensi Sphinx?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "Ekstensi %s yang digunakan proyek ini memerlukan sedikitnya Sphinx v%s; maka itu tidak bisa dibangun dengan versi ini." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "ekstensi %r mengembalikan objek yang tidak didukung dari fungsi setup() nya; seharusnya mengembalikan None atau dictionary metadata" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "direktori konfigurasi tidak berisi berkas conf.py (%s)" + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "tidak dapat menulis ulang pengaturan direktori konfigurasi %r, mengabaikan (gunakan %r untuk mengatur elemen-elemen satuan)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "nomor %r yang salah untuk konfigurasi nilai %r, mengabaikan" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "tidak dapat menulis ulang pengaturan konfigurasi %r dengan tipe yang tidak didukung, mengabaikan" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "nilai konfigurasi %r yang tidak dikenal pada penulisan ulang, mengabaikan" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Nilai konfigurasi %r sudah ada" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Ada kesalahan sintaksis dalam file konfigurasi Anda: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Berkas konfigurasi (atau salah satu dari modul terimpor) disebut sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -262,551 +542,736 @@ msgid "" "%s" msgstr "Terdapat kesalahan programmable dalam berkas konfigurasi anda:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Bab %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Gambar. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabel %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Daftar %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Nilai konfigurasi `{name}` harus salah satu dari {candidates}, tapi `{current}` diberikan." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Nilai konfigurasi `{name}' memiliki tipe `{current.__name__}'; diharapkan {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Nilai konfigurasi `{name}` bertipe `{current.__name__}', default menjadi `{default.__name__}'." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r tidak ditemukan, diabaikan." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Nama Pygments lexer %r tidak diketahui" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "konfigurasi baru" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "konfigurasi berubah" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "pengaturan %s.%s terjadi pada tak satupun konfigurasi tema yang dicari" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "ekstensi berubah" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "opsi tema yang tidak didukung %r diberikan" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "membangun lingkungan bukan versi saat ini" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "berkas %r pada path tema merupakan berkas zip yang tidak valid atau tidak berisi tema" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "direktori sumber telah berubah" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" -msgstr "" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Lingkungan ini tidak kompatibel dengan pembangun yang dipilih, silakan pilih direktori doctree lain." -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" -msgstr "" +msgid "Failed to scan documents in %s: %r" +msgstr "Gagal memindai dokumen dalam %s: %r" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +msgid "Domain %r is not registered" +msgstr "Domain %r tidak terdaftar" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "dokumen tidak termasuk dalam toctree" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "totree referensikan sendiri ditemukan. Diabaikan" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Pehatian" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Event %r sudah ada" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Hati-hati" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Nama event tidak dikenal: %s" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Bahaya" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Kesalahan" -#: project.py:72 +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Petunjuk" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Penting" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Catatan" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Lihat juga" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tip" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Peringatan" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Berkas Texinfo berada di %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nJalankan 'make' di direktori tersebut untuk menjalankannya melalui makeinfo\n(gunakan 'make info' di sini untuk melakukannya secara otomatis)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "tidak ditemukan nilai konfigurasi \"texinfo_documents\"; dokumen tidak akan ditulis" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Class Builder %s tidak punya atribut \"name\"" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "nilai konfigurasi \"texinfo_documents\" mereferensikan dokumen yang tidak dikenal %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Builder %r sudah ada (di modul %s)" +msgid "processing %s" +msgstr "memroses %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Nama Builder %s todal terdaftar atau tersedia melalui entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "penulisan" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Nama Builder %s tidak terdaftar" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "memecahkan referensi..." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "domain %s telah terdaftar" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (dalam " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "domain %s belum didaftarkan" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "menyalin gambar... " -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "Pengarahan %r sudah terdaftar di domain %s" +msgid "cannot copy image file %r: %s" +msgstr "tidak dapat menyalin berkas gambar %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "Peran %r sudah terdaftar di domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "menyalin berkas pendukung Texinfo" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "Indeks %r sudah terdaftar ke domain %s" +msgid "error writing file Makefile: %s" +msgstr "kesalahan menulis berkas Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "object_type %r telah didaftarkan" +msgid "The manual pages are in %(outdir)s." +msgstr "Halaman manual berada di %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "crossref_type %r telah didaftarkan" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "tidak ditemukan nilai konfigurasi \"man_pages\"; halaman manual tidak akan ditulis" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r telah didaftarkan" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "\"man_pages\" nilai konfigurasi mengacu pada dokumen tidak diketahui %s" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser untuk %r telah didaftarkan" +msgid "The HTML page is in %(outdir)s." +msgstr "Halaman HTML berada di %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "Parser sumber untuk %s tidak terdaftar" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "merakit dokumen tunggal" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "Penerjemah untuk %r sudah ada" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "menulis file tambahan" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "kwargs untuk add_node() harus berupa (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "Builder contoh tidak menghasilkan berkas apapun." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r telah terdaftar" +msgid "The message catalogs are in %(outdir)s." +msgstr "Katalog pesan berada di %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "" +msgid "building [%s]: " +msgstr "membangun [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "ekstensi %r telah digabungkan dengan Sphinx sejak versi %s; ekstensi diabaikan." +msgid "targets for %d template files" +msgstr "target untuk %d berkas templat" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Eksepsi orisinal:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "membaca templat... " -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "Tidak dapat mengimpor ekstensi %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "menulis katalog pesan... " -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "ekstensi %r tidak memiliki fungsi setup(); apa itu benar-benar sebuah modul ekstensi Sphinx?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Mencari kesalahan sembarang dalam keluaran di atas atau di %(outdir)s/output.txt" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "Ekstensi %s yang digunakan proyek ini memerlukan sedikitnya Sphinx v%s; maka itu tidak bisa dibangun dengan versi ini." +msgid "broken link: %s (%s)" +msgstr "tautan rusak: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "ekstensi %r mengembalikan objek yang tidak didukung dari fungsi setup() nya; seharusnya mengembalikan None atau dictionary metadata" +msgid "Anchor '%s' not found" +msgstr "Anchor '%s' tidak ditemukan" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" -msgstr "" +msgid "The ePub file is in %(outdir)s." +msgstr "Berkas ePub berada di %(outdir)s." -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" -msgstr "" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "nilai conf \"epub_language\" (atau \"language\") tidak seharsunya kosong untuk EPUB3" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "nilai conf \"epub_uid\" harus berupa XML NAME untuk EPUB3" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" -msgstr "nomor PEP %s tidak valid" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "nilai conf \"epub_title\" (atau \"html_title\") tidak seharusnya kosong untuk EPUB3" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" -msgstr "nomor RFC tidak valid %s" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "nilai conf \"epub_author\" tidak seharusnya kosong untuk EPUB3" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[sumber]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "nilai conf \"epub_contributor\" tidak seharusnya kosong untuk EPUB3" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "menyoroti kode modul..." +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "nilai conf \"epub_description\" tidak seharusnya kosong untuk EPUB3" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[docs]" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "nilai conf \"epub_publisher\" tidak seharusnya kosong untuk EPUB3" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Kode modul" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "nilai conf \"epub_copyright\" (atau \"copyright\") tidak seharusnya kosong untuk EPUB3" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "nilai conf \"epub_identifier\" tidak seharusnya kosong untuk EPUB3" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "bilai conf \"version\" tidak seharusnya kosong untuk EPUB3" -#: ext/viewcode.py:353 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        Kode sumber untuk %s

        " +msgid "invalid css_file: %r, ignored" +msgstr "css_file yang salah: %r, mengabaikan" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Tinjauan: kode modul" +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." +msgstr "Berkas XML berada di %(outdir)s." -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Semua modul dimana kode tersedia

        " +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" +msgstr "kesalahan menulis berkas %s: %s" -#: ext/extlinks.py:82 +#: builders/xml.py:103 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Berkas pseudo-XML berada di %(outdir)s." -#: ext/autosectionlabel.py:52 +#: builders/_epub_base.py:223 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "" +msgid "duplicated ToC entry found: %s" +msgstr "entri ToC ganda ditemukan: %s" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/_epub_base.py:436 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "label rangkap %s, contoh lain dalam %s" +msgid "cannot read image file %r: copying it instead" +msgstr "tidak dapat membaca berkas gambar %r: menyalin gambar sebagai gantinya" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" +msgstr "tidak dapat menulis berkas gambar %r: %s" + +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow tidak ditemukan - menyalin berkas gambar" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "====================== durasi membaca paling lambat =======================" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" -#: ext/doctest.py:118 -#, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "tidak ada '+' atau '-' dalam opsi '%s'." +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:594 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' bukan opsi yang valid." +msgid "unknown mimetype for %s, ignoring" +msgstr "mimetype yang tidak dikenal untuk %s, mengabaikan" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' bukan opsi pyversion yang valid" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "tipe TestCode tidak valid" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:802 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Pengujian dokumen di sumber selesai, lihat hasil dalam %(outdir)s/output.txt." +msgid "writing %s file..." +msgstr "menulis %s berkas..." -#: ext/doctest.py:457 +#: builders/text.py:27 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "tidak ada kode/keluaran dalam blok %s pada %s:%s" +msgid "The text files are in %(outdir)s." +msgstr "Berkas teks berada di %(outdir)s." -#: ext/doctest.py:568 +#: builders/__init__.py:229 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "mengabaikan kode dokumen yang tidak valid: %r" +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "gambar yang sesuai untuk builder %s tidak ditemukan: %s (%s)" -#: ext/imgmath.py:162 +#: builders/__init__.py:237 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "Perintah LaTeX %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_latex" +msgid "a suitable image for %s builder not found: %s" +msgstr "gambar yang sesuai untuk builder %s tidak ditemukan: %s" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%s perintah %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_%s" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "membangun [mo]: " -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" -msgstr "tampilkan latex %r: %s" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "menulis keluaran... " -#: ext/imgmath.py:380 +#: builders/__init__.py:280 #, python-format -msgid "inline latex %r: %s" -msgstr "inline latex %r: %s" +msgid "all of %d po files" +msgstr "semua dari %d berkas po" -#: ext/coverage.py:48 +#: builders/__init__.py:302 #, python-format -msgid "invalid regex %r in %s" -msgstr "regex tidak valid %r dalam %s" +msgid "targets for %d po files that are specified" +msgstr "target untuk %d berkas po yang telah ditetapkan" -#: ext/coverage.py:140 ext/coverage.py:301 +#: builders/__init__.py:314 #, python-format -msgid "module %s could not be imported: %s" -msgstr "modul %s tidak dapat diimpor: %s" +msgid "targets for %d po files that are out of date" +msgstr "target untuk %d berkas po telah usang" -#: ext/coverage.py:148 +#: builders/__init__.py:324 +msgid "all source files" +msgstr "semua berkas sumber" + +#: builders/__init__.py:335 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/coverage.py:158 +#: builders/__init__.py:342 +#, python-format msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" -msgstr "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "berkas %r yang diberikan di command line tidak berada dalam direktori sumber, mengabaikan" -#: ext/coverage.py:172 -#, python-brace-format, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/coverage.py:187 +#: builders/__init__.py:366 #, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "%r regex tidak valid di coverage_c_regexes" +msgid "%d source files given on command line" +msgstr "%d berkas sumber diberikan di command line" -#: ext/coverage.py:260 +#: builders/__init__.py:382 #, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "" +msgid "targets for %d source files that are out of date" +msgstr "target untuk %d berkas sumber yang telah usang" -#: ext/coverage.py:452 +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "mencari berkas yang kini-usang... " + +#: builders/__init__.py:415 #, python-format -msgid "undocumented python function: %s :: %s" -msgstr "" +msgid "%d found" +msgstr "%d ditemukan" -#: ext/coverage.py:473 +#: builders/__init__.py:417 +msgid "none found" +msgstr "tidak ditemukan apapun" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "lingkungan pengawetan" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "memeriksa konsistensi" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "tidak ada target yang usang." + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "memperbarui lingkungan:" + +#: builders/__init__.py:499 #, python-format -msgid "undocumented python class: %s :: %s" -msgstr "" +msgid "%s added, %s changed, %s removed" +msgstr "%s ditambahkan, %s diubah, %s dihapus" -#: ext/coverage.py:492 +#: builders/__init__.py:536 #, python-format -msgid "undocumented python method: %s :: %s :: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgconverter.py:44 +#: builders/__init__.py:545 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: builders/__init__.py:556 #, python-format msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "convert keluar dengan kesalahan: \n[stderr]\n%r\n[stdout]\n%r" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" -#: ext/imgconverter.py:83 +#: builders/__init__.py:563 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." msgstr "" -#: ext/graphviz.py:138 -msgid "Graphviz directive cannot have both content and a filename argument" -msgstr "Pengarahan Graphviz tidak dapat memiliki konten dan argumen nama berkas sekaligus" +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "membaca sumber... " + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "docnames yang akan ditulis: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "menyiapkan dokumen" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "Berkas tinjauan berada di %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "tidak ada pengubahan dalam versi %s." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "menulis berkas ringkasan..." + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Modul Internal" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Level Modul" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "menyalin berkas sumber..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "tidak dapat membaca %r untuk pembuatan changelog" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "regex tidak valid %r dalam %s" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "modul %s tidak dapat diimpor: %s" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "" + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "%r regex tidak valid di coverage_c_regexes" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "Entri TODO ditemukan: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<> terletak di %s, baris %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "entri asli" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "convert keluar dengan kesalahan: \n[stderr]\n%r\n[stdout]\n%r" + +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" +msgstr "" + +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" +msgstr "Pengarahan Graphviz tidak dapat memiliki konten dan argumen nama berkas sekaligus" #: ext/graphviz.py:153 #, python-format @@ -868,1780 +1333,1515 @@ msgstr "[graph: %s]" msgid "[graph]" msgstr "[graph]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Todo" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" -msgstr "Entri TODO ditemukan: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "Perintah LaTeX %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_latex" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s perintah %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_%s" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<> terletak di %s, baris %d.)" +msgid "display latex %r: %s" +msgstr "tampilkan latex %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "entri asli" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "inline latex %r: %s" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" -msgstr "Keterangan tidak valid: %s" +msgid "missing '+' or '-' in '%s' option." +msgstr "tidak ada '+' atau '-' dalam opsi '%s'." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "spesifikasi nomor baris di luar kisaran (1-%d): %r" +msgid "'%s' is not a valid option." +msgstr "'%s' bukan opsi yang valid." -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Tidak dapat menggunakan kedua opsi \"%s\" dan \"%s\"" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' bukan opsi pyversion yang valid" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "tipe TestCode tidak valid" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Pengujian dokumen di sumber selesai, lihat hasil dalam %(outdir)s/output.txt." -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "Objek bernama %r tidak ditemukan disertakan di berkas %r" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "Tidak dapat menggunakan \"lineno-match\" dengan rangkaian \"baris\" yang terpisah" +msgid "no code/output in %s block at %s:%s" +msgstr "tidak ada kode/keluaran dalam blok %s pada %s:%s" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Spesifikasi baris %r: tidak ada baris yang ditarik dari berkas %r" - -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" +msgid "ignoring invalid doctest code: %r" +msgstr "mengabaikan kode dokumen yang tidak valid: %r" -#: directives/other.py:119 +#: ext/autosectionlabel.py:52 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "toctree berisi referensi ke dokumen yang dikecualikan %r" +msgid "duplicate label %s, other instance in %s" +msgstr "label rangkap %s, contoh lain dalam %s" -#: directives/other.py:156 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "toctree berisi referensi ke dokumen yang tidak ada %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" -#: directives/other.py:169 +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Penyusun bagian:" - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Penyusun modul: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Penulis kode:" - -#: directives/other.py:209 -msgid "Author: " -msgstr "Penyusun: " - -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" - -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "" - -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." -msgstr "Berkas tinjauan berada di %(outdir)s." +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "====================== durasi membaca paling lambat =======================" -#: builders/changes.py:56 +#: ext/duration.py:139 #, python-format -msgid "no changes in version %s." -msgstr "tidak ada pengubahan dalam versi %s." - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "menulis berkas ringkasan..." +msgid "%.3fs %s" +msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Modul Internal" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[sumber]" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Level Modul" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "menyoroti kode modul..." -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "menyalin berkas sumber..." +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[docs]" -#: builders/changes.py:133 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "tidak dapat membaca %r untuk pembuatan changelog" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Kode modul" -#: builders/manpage.py:37 +#: ext/viewcode.py:359 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Halaman manual berada di %(outdir)s." +msgid "

        Source code for %s

        " +msgstr "

        Kode sumber untuk %s

        " -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "tidak ditemukan nilai konfigurasi \"man_pages\"; halaman manual tidak akan ditulis" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Tinjauan: kode modul" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "penulisan" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Semua modul dimana kode tersedia

        " -#: builders/manpage.py:71 +#: domains/citation.py:75 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "\"man_pages\" nilai konfigurasi mengacu pada dokumen tidak diketahui %s" +msgid "duplicate citation %s, other instance in %s" +msgstr "kutipan rangkap %s, contoh lain dalam %s" -#: builders/__init__.py:224 +#: domains/citation.py:92 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "gambar yang sesuai untuk builder %s tidak ditemukan: %s (%s)" +msgid "Citation [%s] is not referenced." +msgstr "Kutipan [%s] tidak dirujuk." -#: builders/__init__.py:232 +#: domains/math.py:73 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "gambar yang sesuai untuk builder %s tidak ditemukan: %s" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "membangun [mo]: " - -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "menulis keluaran... " +msgid "duplicate label of equation %s, other instance in %s" +msgstr "duplikasi label persamaan %s, misalnya di %s" -#: builders/__init__.py:275 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "all of %d po files" -msgstr "semua dari %d berkas po" +msgid "Invalid math_eqref_format: %r" +msgstr "Math_eqref_format tidak valid: %r" -#: builders/__init__.py:297 +#: domains/javascript.py:183 #, python-format -msgid "targets for %d po files that are specified" -msgstr "target untuk %d berkas po yang telah ditetapkan" +msgid "%s() (built-in function)" +msgstr "%s() (fungsi built-in)" -#: builders/__init__.py:309 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "target untuk %d berkas po telah usang" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "semua berkas sumber" +msgid "%s() (%s method)" +msgstr "%s() (method %s)" -#: builders/__init__.py:330 +#: domains/javascript.py:186 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +msgid "%s() (class)" +msgstr "%s() (class)" -#: builders/__init__.py:337 +#: domains/javascript.py:188 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "berkas %r yang diberikan di command line tidak berada dalam direktori sumber, mengabaikan" +msgid "%s (global variable or constant)" +msgstr "%s (variabel global atau konstan)" -#: builders/__init__.py:348 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (atribut %s)" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "%d berkas sumber diberikan di command line" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumen" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "target untuk %d berkas sumber yang telah usang" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Throws" -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " -msgstr "membangun [%s]: " +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Kembali" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "mencari berkas yang kini-usang... " +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Return type" -#: builders/__init__.py:410 +#: domains/javascript.py:374 #, python-format -msgid "%d found" -msgstr "%d ditemukan" +msgid "%s (module)" +msgstr "%s (module)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "tidak ditemukan apapun" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "fungsi" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "lingkungan pengawetan" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "method" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "memeriksa konsistensi" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "class" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "tidak ada target yang usang." +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "data" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "memperbarui lingkungan:" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribut" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s ditambahkan, %s diubah, %s dihapus" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" -#: builders/__init__.py:531 +#: domains/javascript.py:458 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:540 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "%s (directive)" +msgstr "%s (direktif)" -#: builders/__init__.py:551 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:558 +#: domains/rst.py:224 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" +msgid "%s (role)" +msgstr "%s (role)" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "membaca sumber... " +#: domains/rst.py:234 +msgid "directive" +msgstr "direktif" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" -msgstr "docnames yang akan ditulis: %s" +#: domains/rst.py:235 +msgid "directive-option" +msgstr "opsi-direktif" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" +#: domains/rst.py:236 +msgid "role" +msgstr "role" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "menyiapkan dokumen" +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:883 +#: domains/changeset.py:33 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "karakter sumber undecodable, menggantinya dengan \"?\": %r" +msgid "Changed in version %s" +msgstr "Berubah pada versi %s" -#: builders/epub3.py:84 +#: domains/changeset.py:34 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "Berkas ePub berada di %(outdir)s." +msgid "Deprecated since version %s" +msgstr "Ditinggalkan sejak versi %s" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "nilai conf \"epub_language\" (atau \"language\") tidak seharsunya kosong untuk EPUB3" - -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "nilai conf \"epub_uid\" harus berupa XML NAME untuk EPUB3" - -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "nilai conf \"epub_title\" (atau \"html_title\") tidak seharusnya kosong untuk EPUB3" - -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "nilai conf \"epub_author\" tidak seharusnya kosong untuk EPUB3" - -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "nilai conf \"epub_contributor\" tidak seharusnya kosong untuk EPUB3" - -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "nilai conf \"epub_description\" tidak seharusnya kosong untuk EPUB3" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "nilai conf \"epub_publisher\" tidak seharusnya kosong untuk EPUB3" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "job number seharusnya sebuah bilangan positif" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "nilai conf \"epub_copyright\" (atau \"copyright\") tidak seharusnya kosong untuk EPUB3" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "nilai conf \"epub_identifier\" tidak seharusnya kosong untuk EPUB3" - -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "bilai conf \"version\" tidak seharusnya kosong untuk EPUB3" - -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "css_file yang salah: %r, mengabaikan" - -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Berkas XML berada di %(outdir)s." - -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "kesalahan menulis berkas %s: %s" - -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Berkas pseudo-XML berada di %(outdir)s." - -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Berkas Texinfo berada di %(outdir)s." - -#: builders/texinfo.py:48 +#: cmd/build.py:74 msgid "" "\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nJalankan 'make' di direktori tersebut untuk menjalankannya melalui makeinfo\n(gunakan 'make info' di sini untuk melakukannya secara otomatis)." - -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "tidak ditemukan nilai konfigurasi \"texinfo_documents\"; dokumen tidak akan ditulis" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "nilai konfigurasi \"texinfo_documents\" mereferensikan dokumen yang tidak dikenal %s" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "memroses %s" - -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "memecahkan referensi..." - -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (dalam " - -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "menyalin gambar... " - -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "tidak dapat menyalin berkas gambar %r: %s" - -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "menyalin berkas pendukung Texinfo" - -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "kesalahan menulis berkas Makefile: %s" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "entri ToC ganda ditemukan: %s" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "path ke berkas sumber" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "tidak dapat membaca berkas gambar %r: menyalin gambar sebagai gantinya" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "path ke direktori output" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "tidak dapat menulis berkas gambar %r: %s" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Pillow tidak ditemukan - menyalin berkas gambar" +#: cmd/build.py:114 +msgid "general options" +msgstr "opsi umum" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "tulis semua berkas (default: hanya tulis berkas yang baru dan diubah)" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "mimetype yang tidak dikenal untuk %s, mengabaikan" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "jangan pakai saved environment, selalu baca semua berkas" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "menulis %s berkas..." - -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "Builder contoh tidak menghasilkan berkas apapun." - -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Katalog pesan berada di %(outdir)s." - -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "target untuk %d berkas templat" - -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "membaca templat... " - -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "menulis katalog pesan... " - -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "Halaman HTML berada di %(outdir)s." - -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "merakit dokumen tunggal" - -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "menulis file tambahan" - -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Mencari kesalahan sembarang dalam keluaran di atas atau di %(outdir)s/output.txt" - -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "tautan rusak: %s (%s)" - -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "Anchor '%s' tidak ditemukan" - -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Berkas teks berada di %(outdir)s." - -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "referensi catatan kaki yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" - -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "referensi yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "referensi kutipan tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "override sebuah aturan di berkas konfigurasi" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "referensi istilah yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "masukkan sebuah nilai ke templat HTML" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b, %Y" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "define tag: masukkan blok \"only\" dengan TAG" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "" +#: cmd/build.py:212 +msgid "console output options" +msgstr "opsi output konsol" -#: transforms/__init__.py:253 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "4 kolom berdasarkan indeks ditemukan. Ini mungkin bug ekstensi yang Anda gunakan: %r" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "tingkatkan verbosity (dapat diulang)" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "Catatan kaki [%s] tidak dirujuk." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "tanpa output pada stdout, hanya peringatan pada stderr" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "tanpa output sama sekali, peringatan sekalipun" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "Catatan kaki [#] tidak dirujuk." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "siarkan output berwarna (default: auto-detect)" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "jangan siarkan output berwarna (default: auto-detect)" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "tulis peringatan (dan galat) pada berkas terpilih" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "ubah peringatan menjadi galat" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "tampilkan traceback penuh pada eksepsi" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "jalankan Pdb pada eksepsi" -#: _cli/__init__.py:171 -#, python-brace-format -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "tidak dapat menggabungkan opsi -a dan nama berkas" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/build.py:357 +#, python-format +msgid "cannot open warning file '%s': %s" msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "argumen opsi -D harus dalam bentuk name=value" -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "argumen opsi -A harus dalam bentuk name=value" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "masukkan docstrings secara otomatis dari modules" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "uji snippet kode secara otomatis pada blok doctest" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "tautkan antara dokumentasi Sphinx dari berbagai proyek" -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "tulis entri \"todo\" yang dapat ditampilan atau disembunyikan dalam build" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "periksa coverage dokumentasi" -#: environment/__init__.py:86 -msgid "new config" -msgstr "konfigurasi baru" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "masukkan math, yang dirender sebagai gambar PNG atau SVG" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "konfigurasi berubah" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "masukkan math, yang dirender di perambah sebagai gambar PNG atau SVG" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "ekstensi berubah" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "inklusi bersyarat untuk isi berdasarkan nilai konfig" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "membangun lingkungan bukan versi saat ini" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "masukkan tautan ke sumber kode untuk objek Python yang terdokumentasi" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "direktori sumber telah berubah" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "buat berkas .nojekyll untuk menerbitkannya di halaman GitHub" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Mohon masukkan nama path yang sah." -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Mohon masukan teks." -#: environment/__init__.py:336 +#: cmd/quickstart.py:134 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +msgid "Please enter one of %s." +msgstr "Mohon masukkan satu dari %s." -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "Lingkungan ini tidak kompatibel dengan pembangun yang dipilih, silakan pilih direktori doctree lain." +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Mohon ketik salah satu dari 'y' atau 'n'." -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "Gagal memindai dokumen dalam %s: %r" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Mohon masukkan satu suffiks berkas, contohnya '.rst' atau '.txt'." -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 +#: cmd/quickstart.py:230 #, python-format -msgid "Domain %r is not registered" -msgstr "Domain %r tidak terdaftar" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "dokumen tidak termasuk dalam toctree" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Selamat datang ke alat quickstart Sphinx %s." -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "totree referensikan sendiri ditemukan. Diabaikan" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Silakan masukkan nilai untuk pengaturan berikut (cukup tekan Enter to\nmenerima nilai bawaan, jika diberikan dalam tanda kurung)." -#: environment/__init__.py:889 +#: cmd/quickstart.py:242 #, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgid "Selected root path: %s" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "kesalahan membaca: %s, %s" - -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "kesalahan menulis: %s, %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Masukkan jalur root untuk dokumentasi." -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Root path dokumentasi" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Galat: berkas conf.py telah ditemukan dalam root path terpilih." -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Format tanggal tidak valid. Kutip string dengan kutipan tunggal jika Anda ingin menampilkannya secara langsung: %s" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart tidak akan menulis ulang proyek Sphinx yang ada." -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Silakan masukkan root path baru (atau tekan Enter untuk keluar)" + +#: cmd/quickstart.py:274 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Pisahkan direktori source dan build (y/n)" + +#: cmd/quickstart.py:287 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "toctree berisi ref ke berkas yang tidak ada %r" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Nama prefiks untuk dir templat dan static" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "pengecualian saat mengevaluasi hanya ekspresi pengarahan: %s" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "Nama proyek akan muncul di beberapa tempat dalam dokumentasi yang dibuat." -#: util/display.py:82 -msgid "skipped" -msgstr "dilewati" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Nama proyek" -#: util/display.py:87 -msgid "failed" -msgstr "gagal" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Nama(-nama) pembuat" -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:309 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" - -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Versi proyek" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" -msgstr "tipe simpul tidak dikenal: %r" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Rilis proyek" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:324 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Bahasa proyek" + +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "peran bawaan %s tidak ditemukan" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Akhiran berkas sumber" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: util/inventory.py:166 +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Nama dokumen master Anda (tanpa akhiran)" + +#: cmd/quickstart.py:368 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Kesalahan: file master %s telah ditemukan di jalur utama yang dipilih." -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Catatan kaki" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart tidak akan menimpa berkas yang sudah ada." -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[gambar: %s]" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Silakan masukkan nama file baru, atau ganti nama file yang ada dan tekan Enter" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[gambar]" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Tunjukkan ekstensi Sphinx berikut mana yang harus diaktifkan:" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Indeks" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Catatan: imgmath dan mathjax tidak dapat diaktifkan secara bersamaan. imgmath telah diubah tidak pilih." -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:407 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "simpul judul tidak ditemui dalam bagian, topik, tabel, peringatan atau sisi bilah" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "keterangan tidak di dalam gambar." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Buat Makefile? (y/n)" -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "tipe simpul tidak diterapkan: %r" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Buat berkas perintah Windows? (y/n)" -#: writers/latex.py:361 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "%r toplevel_sectioning tidak diketahui untuk kelas %r" +msgid "Creating file %s." +msgstr "Membuat file %s." -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "no Babel option known for language %r" -msgstr "tidak ada opsi Babel yang dikenal untuk bahasa %r" +msgid "File %s already exists, skipping." +msgstr "File %s sudah ada, lewati." -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr ":maxdepth: terlalu besar, diabaikan." +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Selesai: Struktur direktori awal telah dibuat." -#: writers/latex.py:591 +#: cmd/quickstart.py:520 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "judul dokumen bukan simpul Text tunggal" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: cmd/quickstart.py:531 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: writers/latex.py:1183 +#: cmd/quickstart.py:538 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "opsi tabularcolumns dan :widths: opsi diberikan bersamaan. :widths: diabaikan." - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "unit dimensi %s tidak valid. Diabaikan" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "di mana \"pembangun\" adalah salah satu pembangun yang didukung, mis. html, lateks, atau periksa tautan." -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "entri indeks tidak diketahui ditemukan tipe %s" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nHasilkan file yang diperlukan untuk proyek Sphinx. \n\nsphinx-quickstart adalah alat interaktif yang menanyakan beberapa pertanyaan tentang proyek Anda \ndan kemudian menghasilkan direktori dokumentasi lengkap dan contoh \nMakefile untuk digunakan dengan sphinx-build.\n" -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "Math_eqref_format tidak valid: %r" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "mode diam" -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "root proyek" -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "numfig_format tidak didefinisikan untuk %s" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Opsi struktur" -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "Tidak ada ID apa pun yang ditugaskan untuk simpul %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "jika ditentukan, pisahkan direktori sumber dan pembangunan" -#: writers/html5.py:496 -msgid "Link to this term" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "pengganti dot di _templates dll." -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Opsi dasar proyek" -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "nama proyek" -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "nama penulis" -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "versi proyek" + +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "rilis proyek" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "Tidak dapat memperoleh ukuran gambar. :scale: option diabaikan." +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "bahasa dokumen" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "akhiran berkas sumber" -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "duplikasi label persamaan %s, misalnya di %s" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "nama dokumen utama" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (fungsi built-in)" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "gunakan epub" -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (method %s)" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Opsi ekstensi" -#: domains/javascript.py:185 +#: cmd/quickstart.py:671 #, python-format -msgid "%s() (class)" -msgstr "%s() (class)" +msgid "enable %s extension" +msgstr "aktifkan ekstensi %s" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (variabel global atau konstan)" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "aktifkan ekstensi berubah-ubah" -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (atribut %s)" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Pembuatan Makefile dan Batchfile" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumen" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "buat makefile" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Throws" +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "jangan membuat makefile" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Kembali" +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "buat batchfile" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Return type" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "jangan membuat batchfile" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (module)" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "gunakan mode-make untuk Makefile/make.bat" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "fungsi" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Membuat templat proyek" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "method" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "direktori templat untuk berkas templat" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "class" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "mendefinisikan variabel templat" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "data" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "\"quiet\" ditentukan, tetapi tidak ada \"project\" atau \"author\" yang ditentukan." -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atribut" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Kesalahan: jalur yang ditentukan bukan direktori, atau file sphinx sudah ada." -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modul" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart hanya menghasilkan direktori kosong. Silakan tentukan jalur utama baru." -#: domains/javascript.py:454 +#: cmd/quickstart.py:810 #, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" +msgid "Invalid template variable: %s" +msgstr "Variabel templat tidak valid: %s" -#: domains/changeset.py:26 +#: directives/other.py:119 #, python-format -msgid "Added in version %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: domains/changeset.py:27 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "Changed in version %s" -msgstr "Berubah pada versi %s" +msgid "toctree contains reference to excluded document %r" +msgstr "toctree berisi referensi ke dokumen yang dikecualikan %r" -#: domains/changeset.py:28 +#: directives/other.py:156 #, python-format -msgid "Deprecated since version %s" -msgstr "Ditinggalkan sejak versi %s" +msgid "toctree contains reference to nonexisting document %r" +msgstr "toctree berisi referensi ke dokumen yang tidak ada %r" -#: domains/changeset.py:29 +#: directives/other.py:169 #, python-format -msgid "Removed in version %s" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktif)" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Penyusun bagian:" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Penyusun modul: " -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (role)" +#: directives/other.py:207 +msgid "Code author: " +msgstr "Penulis kode:" -#: domains/rst.py:234 -msgid "directive" -msgstr "direktif" +#: directives/other.py:209 +msgid "Author: " +msgstr "Penyusun: " -#: domains/rst.py:235 -msgid "directive-option" -msgstr "opsi-direktif" +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "role" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "kutipan rangkap %s, contoh lain dalam %s" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "" -#: domains/citation.py:92 +#: directives/code.py:87 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "Kutipan [%s] tidak dirujuk." - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Pehatian" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Hati-hati" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Bahaya" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Kesalahan" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Petunjuk" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Penting" +msgid "Invalid caption: %s" +msgstr "Keterangan tidak valid: %s" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Catatan" +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" +msgstr "spesifikasi nomor baris di luar kisaran (1-%d): %r" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Lihat juga" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Tidak dapat menggunakan kedua opsi \"%s\" dan \"%s\"" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tip" +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Peringatan" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "masukkan docstrings secara otomatis dari modules" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "Objek bernama %r tidak ditemukan disertakan di berkas %r" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "uji snippet kode secara otomatis pada blok doctest" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "Tidak dapat menggunakan \"lineno-match\" dengan rangkaian \"baris\" yang terpisah" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "tautkan antara dokumentasi Sphinx dari berbagai proyek" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Spesifikasi baris %r: tidak ada baris yang ditarik dari berkas %r" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "tulis entri \"todo\" yang dapat ditampilan atau disembunyikan dalam build" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d %b, %Y" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "periksa coverage dokumentasi" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Indeks" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "masukkan math, yang dirender sebagai gambar PNG atau SVG" +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "simpul judul tidak ditemui dalam bagian, topik, tabel, peringatan atau sisi bilah" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "masukkan math, yang dirender di perambah sebagai gambar PNG atau SVG" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Catatan kaki" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "inklusi bersyarat untuk isi berdasarkan nilai konfig" +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "keterangan tidak di dalam gambar." -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "masukkan tautan ke sumber kode untuk objek Python yang terdokumentasi" +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "tipe simpul tidak diterapkan: %r" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "buat berkas .nojekyll untuk menerbitkannya di halaman GitHub" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[gambar: %s]" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Mohon masukkan nama path yang sah." +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[gambar]" -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Mohon masukan teks." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "" -#: cmd/quickstart.py:133 +#: writers/html5.py:431 #, python-format -msgid "Please enter one of %s." -msgstr "Mohon masukkan satu dari %s." +msgid "numfig_format is not defined for %s" +msgstr "numfig_format tidak didefinisikan untuk %s" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Mohon ketik salah satu dari 'y' atau 'n'." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "Tidak ada ID apa pun yang ditugaskan untuk simpul %s" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Mohon masukkan satu suffiks berkas, contohnya '.rst' atau '.txt'." +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Selamat datang ke alat quickstart Sphinx %s." +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Silakan masukkan nilai untuk pengaturan berikut (cukup tekan Enter to\nmenerima nilai bawaan, jika diberikan dalam tanda kurung)." +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" -#: cmd/quickstart.py:241 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "Selected root path: %s" +msgid "unsupported rubric heading level: %s" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "Masukkan jalur root untuk dokumentasi." +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Root path dokumentasi" +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Galat: berkas conf.py telah ditemukan dalam root path terpilih." +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart tidak akan menulis ulang proyek Sphinx yang ada." +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "Tidak dapat memperoleh ukuran gambar. :scale: option diabaikan." -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Silakan masukkan root path baru (atau tekan Enter untuk keluar)" +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "%r toplevel_sectioning tidak diketahui untuk kelas %r" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" +msgstr "tidak ada opsi Babel yang dikenal untuk bahasa %r" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Pisahkan direktori source dan build (y/n)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":maxdepth: terlalu besar, diabaikan." -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Nama prefiks untuk dir templat dan static" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "judul dokumen bukan simpul Text tunggal" -#: cmd/quickstart.py:297 +#: writers/latex.py:1198 msgid "" -"The project name will occur in several places in the built documentation." -msgstr "Nama proyek akan muncul di beberapa tempat dalam dokumentasi yang dibuat." - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Nama proyek" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Nama(-nama) pembuat" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "opsi tabularcolumns dan :widths: opsi diberikan bersamaan. :widths: diabaikan." -#: cmd/quickstart.py:308 +#: writers/latex.py:1228 +#, python-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Versi proyek" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "unit dimensi %s tidak valid. Diabaikan" -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Rilis proyek" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "entri indeks tidak diketahui ditemukan tipe %s" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Bahasa proyek" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Akhiran berkas sumber" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Nama dokumen master Anda (tanpa akhiran)" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Kesalahan: file master %s telah ditemukan di jalur utama yang dipilih." +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart tidak akan menimpa berkas yang sudah ada." +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Silakan masukkan nama file baru, atau ganti nama file yang ada dan tekan Enter" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Tunjukkan ekstensi Sphinx berikut mana yang harus diaktifkan:" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Catatan: imgmath dan mathjax tidak dapat diaktifkan secara bersamaan. imgmath telah diubah tidak pilih." +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Buat Makefile? (y/n)" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Buat berkas perintah Windows? (y/n)" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." -msgstr "Membuat file %s." +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "File %s sudah ada, lewati." +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Selesai: Struktur direktori awal telah dibuat." +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "referensi catatan kaki yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" -#: cmd/quickstart.py:519 -#, python-format +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "referensi yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" + +#: transforms/i18n.py:325 +#, python-brace-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "referensi kutipan tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" -#: cmd/quickstart.py:526 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "referensi istilah yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:537 +#: transforms/__init__.py:258 +#, python-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "di mana \"pembangun\" adalah salah satu pembangun yang didukung, mis. html, lateks, atau periksa tautan." +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "4 kolom berdasarkan indeks ditemukan. Ini mungkin bug ekstensi yang Anda gunakan: %r" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nHasilkan file yang diperlukan untuk proyek Sphinx. \n\nsphinx-quickstart adalah alat interaktif yang menanyakan beberapa pertanyaan tentang proyek Anda \ndan kemudian menghasilkan direktori dokumentasi lengkap dan contoh \nMakefile untuk digunakan dengan sphinx-build.\n" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "Catatan kaki [%s] tidak dirujuk." -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "mode diam" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "root proyek" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Opsi struktur" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "Catatan kaki [#] tidak dirujuk." -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "jika ditentukan, pisahkan direktori sumber dan pembangunan" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "pengganti dot di _templates dll." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "kesalahan membaca: %s, %s" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Opsi dasar proyek" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "kesalahan menulis: %s, %s" -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "nama proyek" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "nama penulis" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "versi proyek" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Format tanggal tidak valid. Kutip string dengan kutipan tunggal jika Anda ingin menampilkannya secara langsung: %s" -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "rilis proyek" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "bahasa dokumen" +#: util/display.py:82 +msgid "skipped" +msgstr "dilewati" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "akhiran berkas sumber" +#: util/display.py:87 +msgid "failed" +msgstr "gagal" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "nama dokumen utama" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "gunakan epub" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Opsi ekstensi" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "tipe simpul tidak dikenal: %r" -#: cmd/quickstart.py:670 +#: util/fileutil.py:76 #, python-format -msgid "enable %s extension" -msgstr "aktifkan ekstensi %s" +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "aktifkan ekstensi berubah-ubah" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" +msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Pembuatan Makefile dan Batchfile" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "buat makefile" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "peran bawaan %s tidak ditemukan" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "jangan membuat makefile" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "buat batchfile" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "toctree berisi ref ke berkas yang tidak ada %r" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "jangan membuat batchfile" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "pengecualian saat mengevaluasi hanya ekspresi pengarahan: %s" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "gunakan mode-make untuk Makefile/make.bat" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "lanjutan dari halaman sebelumnya" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Membuat templat proyek" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "berlanjut ke halaman berikutnya" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "direktori templat untuk berkas templat" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "Non-abjad" -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "mendefinisikan variabel templat" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Simbol" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "\"quiet\" ditentukan, tetapi tidak ada \"project\" atau \"author\" yang ditentukan." +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Angka" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Kesalahan: jalur yang ditentukan bukan direktori, atau file sphinx sudah ada." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "laman" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart hanya menghasilkan direktori kosong. Silakan tentukan jalur utama baru." +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Rilis" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/images.py:79 #, python-format -msgid "Invalid template variable: %s" -msgstr "Variabel templat tidak valid: %s" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "job number seharusnya sebuah bilangan positif" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" +msgid "Could not fetch remote image: %s [%s]" +msgstr "Tidak dapat mengambil gambar jarak jauh: %s [%s]" -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "path ke berkas sumber" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "Tidak dapat mengambil gambar jarak jauh: %s [%d]" -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "path ke direktori output" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Format gambar tidak dikenal: %s..." -#: cmd/build.py:109 +#: transforms/post_transforms/__init__.py:88 msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:114 -msgid "general options" -msgstr "opsi umum" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "lebih dari satu target ditemukan untuk referensi silang 'any' %r: bisa %s" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "tulis semua berkas (default: hanya tulis berkas yang baru dan diubah)" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "jangan pakai saved environment, selalu baca semua berkas" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "Diinterupsi" -#: cmd/build.py:150 -msgid "path options" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "override sebuah aturan di berkas konfigurasi" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "masukkan sebuah nilai ke templat HTML" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "define tag: masukkan blok \"only\" dengan TAG" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" -msgstr "opsi output konsol" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Mohon juga melaporkan hal ini jika sebuah kesalahan pengguna sehingga lain kali perintah salah yang lebih baik dapat disediakan." -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "tingkatkan verbosity (dapat diulang)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Tutup sidebar" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "tanpa output pada stdout, hanya peringatan pada stderr" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigasi" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "tanpa output sama sekali, peringatan sekalipun" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Pencarian dalam %(docstitle)s" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "siarkan output berwarna (default: auto-detect)" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Tentang dokumen ini" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "jangan siarkan output berwarna (default: auto-detect)" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Pencarian" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Hak Cipta" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "tulis peringatan (dan galat) pada berkas terpilih" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Terakhir diperbarui pada %(last_updated)s." -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "ubah peringatan menjadi galat" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "tampilkan traceback penuh pada eksepsi" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Topik sebelumnya" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "jalankan Pdb pada eksepsi" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "bab sebelum" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Topik berikutnya" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "tidak dapat menggabungkan opsi -a dan nama berkas" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "bab berikutnya" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "Index – %(key)s" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "argumen opsi -D harus dalam bentuk name=value" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "argumen opsi -A harus dalam bentuk name=value" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Index penuh dalam satu halaman" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Tutup sidebar" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Halaman Ini" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Daftar Isi" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "Lihat Sumber" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Pencarian" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Pencarian cepat" #: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 #: themes/basic/searchfield.html:12 msgid "Go" msgstr "Go" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "Lihat Sumber" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Konten" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Pencarian %(docstitle)s" - #: themes/basic/defindex.html:4 msgid "Overview" msgstr "Tinjauan" @@ -2676,101 +2876,42 @@ msgid "Search Page" msgstr "Pencarian Halaman" #: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "pencarian pada dokumentasi ini" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "Index Modul Global" - -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "akses cepat semua modul" - -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Indeks Umum" - -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "semua fungsi, class, term" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Halaman Ini" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Index penuh dalam satu halaman" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Pencarian cepat" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Index halaman berdasarkan huruf" - -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "dapat menjadi besar" - -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Topik sebelumnya" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "bab sebelum" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Topik berikutnya" +msgid "search this documentation" +msgstr "pencarian pada dokumentasi ini" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "bab berikutnya" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "Index Modul Global" -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigasi" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "akses cepat semua modul" -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Pencarian dalam %(docstitle)s" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Indeks Umum" -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Tentang dokumen ini" +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "semua fungsi, class, term" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Hak Cipta" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Daftar Isi" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" +msgid "Search %(docstitle)s" +msgstr "Pencarian %(docstitle)s" -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Terakhir diperbarui pada %(last_updated)s." +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Index halaman berdasarkan huruf" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "dapat menjadi besar" #: themes/basic/search.html:20 msgid "" @@ -2788,43 +2929,42 @@ msgstr "Mencari beberapa kata hanya menunjukkan kecocokan yang mengandung\n    msgid "search" msgstr "pencarian" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Sembunyikan Hasil Pencarian" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Konten" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Hasil Pencarian" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Tidak ada dokumen yang cocok dengan pencarian anda. Pastikan semua kata ditulis dengan benar dan sudah memilih cukup kategori." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" "Search finished, found ${resultCount} pages matching the search query." msgstr[0] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Pencarian" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Penyiapkan pencarian..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", di" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Sembunyikan Hasil Pencarian" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2832,6 +2972,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Perubahan pada Versi %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2853,120 +2998,127 @@ msgstr "Perubahan lain" msgid "Expand sidebar" msgstr "Buka sidebar" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parameter" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variabel" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Raises" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (di modul %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (di modul %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (variabel built-in)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (class built-in)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (class di %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (method class %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (method static %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Indeks Modul Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "modul" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Akan ditinggalkan" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "eksepsi" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "method class" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "method static" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "property" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "lebih dari satu target ditemukan untuk referensi silang %r: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (obsolet)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parameter" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variabel" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2977,92 +3129,85 @@ msgstr "Parameter Templat" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "Nilai kembalian" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "union" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "anggota" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tipe" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "konsep" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerator" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "variabel" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "macro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "struct" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "variabel environment; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3082,641 +3227,428 @@ msgstr "opsi baris perintah" msgid "glossary term must be preceded by empty line" msgstr "Daftar Istilah kata sulit harus didahului dengan baris kosong" -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "Daftar istilah kata sulit tidak boleh dipisahkan oleh garis kosong" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "Daftar istilah kata sulit tampaknya salah format, periksa indentasi" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "daftar istilah" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "token grammar" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "label referensi" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "variabel environment" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "opsi program" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "dokumen" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Indeks Modul" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "numfig dinonaktifkan. :numref: diabaikan." - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "tautan tidak memiliki teks: %s" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "numfig_format tidak valid: %s (%r)" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "numfig_format tidak valid: %s" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "label yang tidak ditentukan: %r" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "referensi toctree melingkar terdeteksi, mengabaikan: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "toctree berisi referensi ke dokumen %r yang tidak memiliki judul: tidak ada tautan yang akan dihasilkan" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "lihat %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "lihat juga %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "tipe entri indeks tidak dikenal %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Simbol" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "berkas gambar tidak dapat dibaca: %s" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "berkas gambar %s tidak dapat dibaca: %s" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "berkas unduhan tidak dapat dibaca: %s" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s sudah diberi nomor bagian (penomoran bersarang toctree?)" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "Diinterupsi" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" +msgstr "Daftar istilah kata sulit tidak boleh dipisahkan oleh garis kosong" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "Daftar istilah kata sulit tampaknya salah format, periksa indentasi" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "daftar istilah" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "token grammar" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "label referensi" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Mohon juga melaporkan hal ini jika sebuah kesalahan pengguna sehingga lain kali perintah salah yang lebih baik dapat disediakan." +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "variabel environment" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "opsi program" -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "lebih dari satu target ditemukan untuk referensi silang 'any' %r: bisa %s" +#: domains/std/__init__.py:735 +msgid "document" +msgstr "dokumen" + +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Indeks Modul" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:857 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "numfig dinonaktifkan. :numref: diabaikan." + +#: domains/std/__init__.py:1124 #, python-format -msgid "%r reference target not found: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1138 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "Tidak dapat mengambil gambar jarak jauh: %s [%s]" +msgid "the link has no caption: %s" +msgstr "tautan tidak memiliki teks: %s" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:1153 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "Tidak dapat mengambil gambar jarak jauh: %s [%d]" +msgid "invalid numfig_format: %s (%r)" +msgstr "numfig_format tidak valid: %s (%r)" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:1157 #, python-format -msgid "Unknown image format: %s..." -msgstr "Format gambar tidak dikenal: %s..." +msgid "invalid numfig_format: %s" +msgstr "numfig_format tidak valid: %s" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:1453 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "Halaman HTML berada di %(outdir)s." +msgid "undefined label: %r" +msgstr "label yang tidak ditentukan: %r" -#: builders/html/__init__.py:348 +#: domains/std/__init__.py:1456 #, python-format -msgid "Failed to read build info file: %r" -msgstr "Gagal membaca berkas info build: %r" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:383 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "index" +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" +msgstr "" -#: builders/html/__init__.py:560 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Logo of %s" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "berikut" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Contoh" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "sebelum" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Contoh-contoh" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "menghasilkan indeks" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Argumen Kata Kunci" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "menulis halaman tambahan" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Catatan" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Parameter lainnya" + +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "menyalin berkas yang dapat diunduh... " +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Referensi" -#: builders/html/__init__.py:818 -#, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "tidak dapat menyalin berkas yang dapat diunduh %r: %s" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Peringatkan" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "Hasil" -#: builders/html/__init__.py:864 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "menyalin file statis" - -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "cannot copy static file %r" -msgstr "tidak dapat menyalin berkas statik %r" - -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "menyalin berkas tambahan" +msgid "Bases: %s" +msgstr "Basis: %s" -#: builders/html/__init__.py:949 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "cannot copy extra file %r" -msgstr "tidak dapat menyalin berkas ekstra %r" +msgid "invalid value for member-order option: %s" +msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "Failed to write build info file: %r" -msgstr "Gagal menulis berkas info build: %r" - -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "indeks pencarian tidak dapat dimuat, tapi tidak semua dokumen akan dibangun: indeks akan jadi tidak lengkap." +msgid "invalid value for class-doc-from option: %s" +msgstr "" -#: builders/html/__init__.py:1052 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "halaman %s sebanding dengan dua pola dalam html_sidebars: %r dan %r" +msgid "invalid signature for auto%s (%r)" +msgstr "tanda tangan tidak valid untuk outo %s (%r)" -#: builders/html/__init__.py:1216 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "kesalahan Unicode terjadi saat render halaman %s. Silakan pastikan semua nilai konfigurasi yang berisi konten non-ASCII adalah string Unicode." +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "tidak tahu modul mana yang akan diimpor untuk autodocumenting %r (coba letakkan pengarahan \"module\" atau \"currentmodule\" dalam dokumen, atau berikan nama modul yang eksplisit)" -#: builders/html/__init__.py:1224 +#: ext/autodoc/_names.py:89 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "Kesalahan terjadi saat render halaman %s.\nAlasan: %r" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "menyisihkan persediaan obyek" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "\"::\" dalam nama automodule tidak masuk akal" -#: builders/html/__init__.py:1265 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "dumping search index in %s" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1308 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "invalid js_file: %r, ignored" -msgstr "js_file yang salah: %r, mengabaikan" +msgid "Would create file %s." +msgstr "Akan membuat berkas %s." -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "Banyak math_renderers teregistrasi. Namun tidak satu pun math_renderer yang dipilih." +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nLihat secara rekursif dalam untuk modul dan paket Python dan buat \nsatu berkas reST dengan arahan automodule per paket di . \n\n dapat berupa pola berkas dan/atau direktori yang akan \ndikecualikan dari pembuatan. \n\nCatatan: Secara bawaan skrip ini tidak akan menimpa berkas yang sudah dibuat." -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "math_renderer %r yang tidak diketahui diberikan." +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "jalur ke modul ke dokumen" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "Berkas gaya-fnmatch dan/atau pola direktori untuk dikecualikan dari pembuatan" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "entri html_extra_path %r tidak ada" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "direktori untuk menempatkan semua keluaran" + +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "kedalaman maksimum submodul untuk ditampilkan di TOC (bawaan: 4)" + +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "menimpa file yang ada" + +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "ikuti tautan simbolik. Berdaya bila digabungkan dengan collective.recipe.omelette." + +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "operasikan skrip tanpa membuat file" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "letakkan dokumentasi untuk setiap modul di halamannya sendiri" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" -msgstr "entri html_static_path %r tidak ada" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "termasuk modul \"_private\"" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "berkas logo %r tidak ada" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "nama file daftar isi (bawaan: modul)" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" -msgstr "berkas favicon %r tidak ada" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "jangan membuat berkas daftar isi" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:135 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." -msgstr "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "jangan membuat judul untuk paket modul/paket (mis. ketika docstrings sudah berisi hal tersebut)" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "letakkan dokumentasi modul sebelum dokumentasi submodul" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" -msgstr "Dokumentasi %s %s" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "menafsirkan jalur modul sesuai dengan spesifikasi namespaces implisit PEP-0420" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" -msgstr "" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "akhiran berkas (bawaan: rst)" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Berkas LaTeX berada di %(outdir)s." +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "menghasilkan proyek penuh dengan sphinx-quickstart" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nJalankan 'make' di direktori tersebut untuk menjalankannya melalui (pdf)latex\n(gunakan 'make latexpdf' di sini untuk melakukannya secara otomatis)." +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "menambahkan module_path ke sys.path, digunakan ketika --full diberikan" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "tidak ditemukan nilai konfigurasi \"latex_documents\"; dokumen tidak akan ditulis" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "nama proyek (bawaan: nama modul utama)" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "nilai konfigurasi \"latex_documents\" mereferensikan dokumen yang tidak dikenal %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "penulis-(penulis) proyek, digunakan ketika --full diberikan" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Rilis" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "versi proyek, digunakan ketika --full diberikan" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "menyalin berkas pendukung TeX" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "rilis proyek, digunakan ketika --full diberikan, bawaan ke --doc-version" -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "menyalin berkas tambahan" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "opsi ekstensi" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" -msgstr "Gagal mendapatkan docname!" - -#: builders/latex/transforms.py:121 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "Failed to get a docname for source %r!" -msgstr "" +msgid "%s is not a directory." +msgstr "%s bukan direktori." -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "lanjutan dari halaman sebelumnya" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "berlanjut ke halaman berikutnya" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "Non-abjad" - -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Angka" - -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "laman" - -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Argumen Kata Kunci" - -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "" - -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Contoh" - -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Contoh-contoh" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Catatan" - -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Parameter lainnya" - -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Referensi" - -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Peringatkan" - -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "Hasil" - -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." -msgstr "" - -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "gagal mengurai nama %s" - -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" -msgstr "gagal mengimpor objek %s" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] menghasilkan autosummary untuk: %s" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] menulis ke %s" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3724,7 +3656,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3739,481 +3671,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "\nHasilkan ReStructuredText menggunakan pengarahan autosummary.\n\nsphinx-autogen adalah tampilan depan ke sphinx.ext.autosummary.generate. Ini menghasilkan \nfile reStructuredText dari pengarahan autosummary yang terkandung dalam \nfile input yang diberikan.\n\nFormat pengarahan autosummary didokumentasikan dalam \nmodul ``sphinx.ext.autosummary`` dan dapat dibaca menggunakan::\n\n pydoc sphinx.ext.autosummary\n" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "berkas sumber untuk menghasilkan file rST untuk" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "direktori untuk menempatkan semua keluaran dalam" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "akhiran bawaan untuk berkas (bawaan: %(default)s)" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "direktori templat ubahsuai (bawaan: %(default)s)" + +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "mendokumentasikan anggota yang diimpor (bawaan: %(default)s)" + +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "" + +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." +msgstr "" + +#: ext/autosummary/__init__.py:239 +#, python-format +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." +msgstr "" + +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "direktori templat ubahsuai (bawaan: %(default)s)" +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/__init__.py:358 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "mendokumentasikan anggota yang diimpor (bawaan: %(default)s)" +msgid "failed to import object %s" +msgstr "gagal mengimpor objek %s" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "" - -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "Failed to remove %s: %s" +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:860 msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nLihat secara rekursif dalam untuk modul dan paket Python dan buat \nsatu berkas reST dengan arahan automodule per paket di . \n\n dapat berupa pola berkas dan/atau direktori yang akan \ndikecualikan dari pembuatan. \n\nCatatan: Secara bawaan skrip ini tidak akan menimpa berkas yang sudah dibuat." - -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "jalur ke modul ke dokumen" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." +msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/intersphinx/_load.py:61 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "Berkas gaya-fnmatch dan/atau pola direktori untuk dikecualikan dari pembuatan" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "direktori untuk menempatkan semua keluaran" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "kedalaman maksimum submodul untuk ditampilkan di TOC (bawaan: 4)" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "menimpa file yang ada" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "ikuti tautan simbolik. Berdaya bila digabungkan dengan collective.recipe.omelette." +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "operasikan skrip tanpa membuat file" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "letakkan dokumentasi untuk setiap modul di halamannya sendiri" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "termasuk modul \"_private\"" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "nama file daftar isi (bawaan: modul)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "jangan membuat berkas daftar isi" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/intersphinx/_load.py:324 msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "jangan membuat judul untuk paket modul/paket (mis. ketika docstrings sudah berisi hal tersebut)" - -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "letakkan dokumentasi modul sebelum dokumentasi submodul" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "mengalami beberapa masalah dengan beberapa inventaris, tetapi mereka memiliki alternatif berfungsi:" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "menafsirkan jalur modul sesuai dengan spesifikasi namespaces implisit PEP-0420" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: ext/apidoc/_cli.py:160 -msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "pengimpanan intersphinx telah dipindahkan: %s -> %s" + +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "akhiran berkas (bawaan: rst)" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "(dalam %s)" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "menghasilkan proyek penuh dengan sphinx-quickstart" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "menambahkan module_path ke sys.path, digunakan ketika --full diberikan" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "nama proyek (bawaan: nama modul utama)" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "penulis-(penulis) proyek, digunakan ketika --full diberikan" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "versi proyek, digunakan ketika --full diberikan" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "rilis proyek, digunakan ketika --full diberikan, bawaan ke --doc-version" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "opsi ekstensi" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "%s is not a directory." -msgstr "%s bukan direktori." +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "error while formatting arguments for %s: %s" +msgstr "kesalahan saat memformat argumen untuk %s: %s" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "signature arguments or return annotation given for automodule %s" +msgstr "argumen tanda tangan atau anotasi kembalian diberikan untuk automodule %s" + +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ harus berupa daftar string, bukan %r (dalam modul %s) -- mengabaikan __all__" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "missing attribute %s in object %s" +msgstr "atribut hilang %s dalam objek %s" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "" + +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:114 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "Halaman HTML berada di %(outdir)s." -#: ext/apidoc/_extension.py:210 +#: builders/html/__init__.py:337 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "Failed to read build info file: %r" +msgstr "Gagal membaca berkas info build: %r" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:247 -#, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_generate.py:69 -#, python-format -msgid "Would create file %s." -msgstr "Akan membuat berkas %s." +#: builders/html/__init__.py:496 +msgid "index" +msgstr "index" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:549 #, python-format -msgid "(in %s v%s)" -msgstr "(di %s v%s)" +msgid "Logo of %s" +msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" -msgstr "(dalam %s)" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "berikut" -#: ext/intersphinx/_resolve.py:108 -#, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "sebelum" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "menghasilkan indeks" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "menulis halaman tambahan" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "menyalin berkas yang dapat diunduh... " + +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "tidak dapat menyalin berkas yang dapat diunduh %r: %s" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "menyalin file statis" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "" +msgid "cannot copy static file %r" +msgstr "tidak dapat menyalin berkas statik %r" + +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "menyalin berkas tambahan" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "cannot copy extra file %r" +msgstr "tidak dapat menyalin berkas ekstra %r" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "Gagal menulis berkas info build: %r" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "indeks pencarian tidak dapat dimuat, tapi tidak semua dokumen akan dibangun: indeks akan jadi tidak lengkap." -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "halaman %s sebanding dengan dua pola dalam html_sidebars: %r dan %r" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "kesalahan Unicode terjadi saat render halaman %s. Silakan pastikan semua nilai konfigurasi yang berisi konten non-ASCII adalah string Unicode." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "Kesalahan terjadi saat render halaman %s.\nAlasan: %r" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "menyisihkan persediaan obyek" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "" - -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "mengalami beberapa masalah dengan beberapa inventaris, tetapi mereka memiliki alternatif berfungsi:" +msgid "invalid js_file: %r, ignored" +msgstr "js_file yang salah: %r, mengabaikan" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "gagal mencapai salah satu inventaris dengan masalah berikut:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Banyak math_renderers teregistrasi. Namun tidak satu pun math_renderer yang dipilih." -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1351 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "pengimpanan intersphinx telah dipindahkan: %s -> %s" +msgid "Unknown math_renderer %r is given." +msgstr "math_renderer %r yang tidak diketahui diberikan." -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1365 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1370 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_extra_path entry %r does not exist" +msgstr "entri html_extra_path %r tidak ada" + +#: builders/html/__init__.py:1385 +#, python-format +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "tanda tangan tidak valid untuk outo %s (%r)" +msgid "html_static_path entry %r does not exist" +msgstr "entri html_static_path %r tidak ada" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "kesalahan saat memformat argumen untuk %s: %s" +msgid "logo file %r does not exist" +msgstr "berkas logo %r tidak ada" + +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "berkas favicon %r tidak ada" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "tidak tahu modul mana yang akan diimpor untuk autodocumenting %r (coba letakkan pengarahan \"module\" atau \"currentmodule\" dalam dokumen, atau berikan nama modul yang eksplisit)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "Dokumentasi %s %s" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "\"::\" dalam nama automodule tidak masuk akal" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "Gagal mendapatkan docname!" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "argumen tanda tangan atau anotasi kembalian diberikan untuk automodule %s" +msgid "Failed to get a docname for source %r!" +msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ harus berupa daftar string, bukan %r (dalam modul %s) -- mengabaikan __all__" +msgid "No footnote was found for given reference node %r" +msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Berkas LaTeX berada di %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nJalankan 'make' di direktori tersebut untuk menjalankannya melalui (pdf)latex\n(gunakan 'make latexpdf' di sini untuk melakukannya secara otomatis)." + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "tidak ditemukan nilai konfigurasi \"latex_documents\"; dokumen tidak akan ditulis" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "nilai konfigurasi \"latex_documents\" mereferensikan dokumen yang tidak dikenal %s" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "menyalin berkas pendukung TeX" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "menyalin berkas tambahan" + +#: builders/latex/__init__.py:529 +#, python-format +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:537 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Bases: %s" -msgstr "Basis: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s sudah diberi nomor bagian (penomoran bersarang toctree?)" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" -msgstr "atribut hilang %s dalam objek %s" +msgid "image file not readable: %s" +msgstr "berkas gambar tidak dapat dibaca: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" -msgstr "" +msgid "image file %s not readable: %s" +msgstr "berkas gambar %s tidak dapat dibaca: %s" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "" +msgid "download file not readable: %s" +msgstr "berkas unduhan tidak dapat dibaca: %s" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "referensi toctree melingkar terdeteksi, mengabaikan: %s <- %s" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "toctree berisi referensi ke dokumen %r yang tidak memiliki judul: tidak ada tautan yang akan dihasilkan" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "" +msgid "see %s" +msgstr "lihat %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "lihat juga %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "tipe entri indeks tidak dikenal %r" diff --git a/sphinx/locale/is/LC_MESSAGES/sphinx.mo b/sphinx/locale/is/LC_MESSAGES/sphinx.mo index e0a0c4295b2..89bd6e13762 100644 Binary files a/sphinx/locale/is/LC_MESSAGES/sphinx.mo and b/sphinx/locale/is/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/is/LC_MESSAGES/sphinx.po b/sphinx/locale/is/LC_MESSAGES/sphinx.po index 3fde9bd05bf..462ecd91816 100644 --- a/sphinx/locale/is/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/is/LC_MESSAGES/sphinx.po @@ -1,5 +1,5 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: @@ -8,153 +8,300 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-29 22:39+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Tryggvi Kalman , 2021\n" "Language-Team: Icelandic (http://app.transifex.com/sphinx-doc/sphinx-1/language/is/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.16.0\n" +"Generated-By: Babel 2.17.0\n" "Language: is\n" "Plural-Forms: nplurals=2; plural=(n % 10 != 1 || n % 100 == 11);\n" -#: events.py:77 +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "" + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "" + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 #, python-format msgid "Event %r already present" msgstr "" -#: events.py:370 +#: events.py:386 #, python-format msgid "Unknown event name: %s" msgstr "" -#: events.py:416 +#: events.py:451 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" -#: application.py:190 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:194 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:198 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:228 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:250 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:266 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:271 registry.py:452 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:277 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:312 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:329 util/display.py:88 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:331 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:345 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:353 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:366 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:398 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:400 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:404 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:407 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:409 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:414 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:417 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:419 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:968 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1047 +#: application.py:1113 #, python-format -msgid "directive %r is already registered, it will be overridden" +msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1069 application.py:1094 +#: application.py:1139 application.py:1167 #, python-format -msgid "role %r is already registered, it will be overridden" +msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1644 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1648 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1651 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,1153 +322,1307 @@ msgid "" "explicit" msgstr "" -#: application.py:1655 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1663 application.py:1667 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: roles.py:208 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:231 -#, python-format -msgid "invalid CVE number %s" -msgstr "" - -#: roles.py:253 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" - -#: roles.py:276 -#, python-format -msgid "invalid CWE number %s" -msgstr "" - -#: roles.py:296 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "" - -#: roles.py:319 -#, python-format -msgid "invalid PEP number %s" -msgstr "" - -#: roles.py:357 -#, python-format -msgid "invalid RFC number %s" -msgstr "" - -#: registry.py:144 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" -#: registry.py:146 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" -#: registry.py:159 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" -#: registry.py:166 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "" -#: registry.py:173 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "" -#: registry.py:196 registry.py:209 registry.py:220 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "" -#: registry.py:200 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" -#: registry.py:212 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" -#: registry.py:223 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" -#: registry.py:254 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "" -#: registry.py:280 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "" -#: registry.py:287 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "" -#: registry.py:296 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "" -#: registry.py:304 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "" -#: registry.py:320 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "" -#: registry.py:336 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: registry.py:419 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "" -#: registry.py:431 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "" -#: registry.py:446 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" -#: registry.py:457 +#: registry.py:545 msgid "Original exception:\n" msgstr "" -#: registry.py:458 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "" -#: registry.py:463 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" -#: registry.py:472 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" -#: registry.py:480 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" -#: registry.py:514 +#: registry.py:605 #, python-format msgid "`None` is not a valid filetype for %r." msgstr "" -#: project.py:71 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" - -#: project.py:87 +#: config.py:351 #, python-format -msgid "Ignored unreadable document %r." +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: highlighting.py:168 +#: config.py:374 #, python-format -msgid "Pygments lexer name %r is not known" +msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: highlighting.py:202 +#: config.py:379 #, python-format msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" msgstr "" -#: extension.py:55 +#: config.py:391 #, python-format -msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." +msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: extension.py:76 +#: config.py:399 #, python-format -msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." +msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: theming.py:114 +#: config.py:422 #, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +msgid "unknown config value %r in override, ignoring" msgstr "" -#: theming.py:120 +#: config.py:476 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +msgid "No such config value: %r" msgstr "" -#: theming.py:135 +#: config.py:504 #, python-format -msgid "unsupported theme option %r given" +msgid "Config value %r already present" msgstr "" -#: theming.py:207 +#: config.py:541 #, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" msgstr "" -#: theming.py:228 -#, python-format -msgid "no theme named %r found (missing theme.toml?)" +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." msgstr "" -#: theming.py:268 +#: config.py:599 #, python-format -msgid "The %r theme has circular inheritance" +msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: theming.py:275 -#, python-format +#: config.py:603 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: theming.py:282 +#: config.py:611 #, python-format -msgid "The %r theme has too many ancestors" +msgid "" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" msgstr "" -#: theming.py:310 +#: config.py:633 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to convert %r to a frozenset" msgstr "" -#: theming.py:335 theming.py:388 +#: config.py:651 config.py:659 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: theming.py:339 +#: config.py:665 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." msgstr "" -#: theming.py:343 theming.py:391 +#: config.py:686 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +msgid "Section %s" +msgstr "Kafli %s" -#: theming.py:347 +#: config.py:687 #, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +msgid "Fig. %s" +msgstr "Mynd %s" -#: theming.py:366 +#: config.py:688 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +msgid "Table %s" +msgstr "Tafla %s" -#: config.py:309 +#: config.py:689 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Listing %s" +msgstr "Listi %s" + +#: config.py:798 +#, python-brace-format +msgid "" +"The config value `{name}` has to be a one of {candidates}, but `{current}` " +"is given." msgstr "" -#: config.py:318 +#: config.py:829 +#, python-brace-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"The config value `{name}' has type `{current.__name__}'; expected " +"{permitted}." msgstr "" -#: config.py:341 -#, python-format +#: config.py:846 +#, python-brace-format msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" +"The config value `{name}' has type `{current.__name__}', defaults to " +"`{default.__name__}'." msgstr "" -#: config.py:350 +#: config.py:858 #, python-format -msgid "invalid number %r for config value %r, ignoring" +msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:356 -#, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" +#: config.py:878 +msgid "" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: config.py:377 -#, python-format -msgid "unknown config value %r in override, ignoring" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: config.py:430 -#, python-format -msgid "No such config value: %r" +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: config.py:453 -#, python-format -msgid "Config value %r already present" +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: config.py:489 +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "" + +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "" + +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "" + +#: environment/__init__.py:350 #, python-format -msgid "" -"cannot cache unpickable configuration value: %r (because it contains a " -"function, class, or module object)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: config.py:527 +#: environment/__init__.py:355 #, python-format -msgid "There is a syntax error in your configuration file: %s\n" +msgid "The configuration has changed (%d options: %s)" +msgstr "" + +#: environment/__init__.py:361 +#, python-format +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: config.py:530 +#: environment/__init__.py:404 msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: config.py:537 +#: environment/__init__.py:518 #, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: config.py:560 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "Failed to convert %r to a set or tuple" +msgid "Domain %r is not registered" +msgstr "" + +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "" + +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: config.py:581 config.py:586 +#: environment/__init__.py:952 #, python-format -msgid "Converting `source_suffix = %r` to `source_suffix = %r`." +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: config.py:589 +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Athugið" + +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Aðgát" + +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Hætta" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Villa" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Ábending" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Mikilvægt" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Athugasemd" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Sjá einnig" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Ábending" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Aðvörun" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "" + +#: builders/texinfo.py:44 msgid "" -"The config value `source_suffix' expects a dictionary, a string, or a list " -"of strings. Got `%r' instead (type %s)." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: config.py:608 -#, python-format -msgid "Section %s" -msgstr "Kafli %s" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "" -#: config.py:609 +#: builders/texinfo.py:85 #, python-format -msgid "Fig. %s" -msgstr "Mynd %s" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "" -#: config.py:610 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Table %s" -msgstr "Tafla %s" +msgid "processing %s" +msgstr "" -#: config.py:611 -#, python-format -msgid "Listing %s" -msgstr "Listi %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "" -#: config.py:718 -msgid "" -"The config value `{name}` has to be a one of {candidates}, but `{current}` " -"is given." +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: config.py:742 -msgid "" -"The config value `{name}' has type `{current.__name__}'; expected " -"{permitted}." +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: config.py:755 -msgid "" -"The config value `{name}' has type `{current.__name__}', defaults to " -"`{default.__name__}'." +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: config.py:766 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "primary_domain %r not found, ignored." +msgid "cannot copy image file %r: %s" msgstr "" -#: config.py:778 -msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: domains/rst.py:128 domains/rst.py:185 +#: builders/texinfo.py:218 #, python-format -msgid "%s (directive)" +msgid "error writing file Makefile: %s" msgstr "" -#: domains/rst.py:186 domains/rst.py:190 +#: builders/manpage.py:37 #, python-format -msgid ":%s: (directive option)" +msgid "The manual pages are in %(outdir)s." +msgstr "" + +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: domains/rst.py:214 +#: builders/manpage.py:64 #, python-format -msgid "%s (role)" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: domains/rst.py:224 -msgid "directive" +#: builders/singlehtml.py:35 +#, python-format +msgid "The HTML page is in %(outdir)s." msgstr "" -#: domains/rst.py:225 -msgid "directive-option" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: domains/rst.py:226 -msgid "role" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "" + +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: domains/rst.py:248 +#: builders/gettext.py:243 #, python-format -msgid "duplicate description of %s %s, other instance in %s" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: domains/javascript.py:165 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "%s() (built-in function)" +msgid "building [%s]: " msgstr "" -#: domains/javascript.py:166 domains/python/__init__.py:253 +#: builders/gettext.py:265 #, python-format -msgid "%s() (%s method)" +msgid "targets for %d template files" +msgstr "" + +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: domains/javascript.py:168 +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "" + +#: builders/linkcheck.py:87 #, python-format -msgid "%s() (class)" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: domains/javascript.py:170 +#: builders/linkcheck.py:159 #, python-format -msgid "%s (global variable or constant)" +msgid "broken link: %s (%s)" msgstr "" -#: domains/javascript.py:172 domains/python/__init__.py:338 +#: builders/linkcheck.py:561 #, python-format -msgid "%s (%s attribute)" +msgid "Anchor '%s' not found" msgstr "" -#: domains/javascript.py:255 -msgid "Arguments" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: domains/cpp/__init__.py:447 domains/javascript.py:258 -msgid "Throws" +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: domains/c/__init__.py:310 domains/cpp/__init__.py:458 -#: domains/javascript.py:261 domains/python/_object.py:176 -msgid "Returns" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: domains/c/__init__.py:312 domains/javascript.py:263 -#: domains/python/_object.py:178 -msgid "Return type" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: domains/javascript.py:334 -#, python-format -msgid "%s (module)" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: domains/c/__init__.py:681 domains/cpp/__init__.py:859 -#: domains/javascript.py:371 domains/python/__init__.py:660 -msgid "function" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: domains/javascript.py:372 domains/python/__init__.py:664 -msgid "method" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: domains/cpp/__init__.py:857 domains/javascript.py:373 -#: domains/python/__init__.py:662 -msgid "class" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: domains/javascript.py:374 domains/python/__init__.py:661 -msgid "data" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: domains/javascript.py:375 domains/python/__init__.py:667 -msgid "attribute" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: domains/javascript.py:376 domains/python/__init__.py:670 -msgid "module" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/javascript.py:407 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: domains/changeset.py:25 -#, python-format -msgid "Added in version %s" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Changed in version %s" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: domains/changeset.py:27 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "Deprecated since version %s" +msgid "invalid css_file: %r, ignored" msgstr "" -#: domains/changeset.py:28 +#: builders/xml.py:29 #, python-format -msgid "Removed in version %s" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/__init__.py:299 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "%s %s" +msgid "error writing file %s: %s" msgstr "" -#: domains/citation.py:73 +#: builders/xml.py:103 #, python-format -msgid "duplicate citation %s, other instance in %s" +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: domains/citation.py:84 +#: builders/_epub_base.py:223 #, python-format -msgid "Citation [%s] is not referenced." +msgid "duplicated ToC entry found: %s" msgstr "" -#: domains/math.py:63 +#: builders/_epub_base.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: domains/math.py:119 writers/latex.py:2479 +#: builders/_epub_base.py:467 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: environment/__init__.py:81 -msgid "new config" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: environment/__init__.py:82 -msgid "config changed" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: environment/__init__.py:83 -msgid "extensions changed" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: environment/__init__.py:249 -msgid "build environment version not current" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: environment/__init__.py:251 -msgid "source directory has changed" +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: environment/__init__.py:313 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: environment/__init__.py:318 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." msgstr "" -#: environment/__init__.py:324 +#: builders/_epub_base.py:802 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "writing %s file..." msgstr "" -#: environment/__init__.py:366 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." msgstr "" -#: environment/__init__.py:473 +#: builders/__init__.py:229 #, python-format -msgid "Failed to scan documents in %s: %r" +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: environment/__init__.py:626 +#: builders/__init__.py:237 #, python-format -msgid "Domain %r is not registered" +msgid "a suitable image for %s builder not found: %s" msgstr "" -#: environment/__init__.py:777 -msgid "document isn't included in any toctree" +#: builders/__init__.py:260 +msgid "building [mo]: " msgstr "" -#: environment/__init__.py:810 -msgid "self referenced toctree found. Ignored." +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " msgstr "" -#: environment/__init__.py:839 +#: builders/__init__.py:280 #, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgid "all of %d po files" msgstr "" -#: locale/__init__.py:229 -msgid "Attention" -msgstr "Athugið" - -#: locale/__init__.py:230 -msgid "Caution" -msgstr "Aðgát" +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" -#: locale/__init__.py:231 -msgid "Danger" -msgstr "Hætta" +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" -#: locale/__init__.py:232 -msgid "Error" -msgstr "Villa" - -#: locale/__init__.py:233 -msgid "Hint" -msgstr "Ábending" - -#: locale/__init__.py:234 -msgid "Important" -msgstr "Mikilvægt" - -#: locale/__init__.py:235 -msgid "Note" -msgstr "Athugasemd" - -#: locale/__init__.py:236 -msgid "See also" -msgstr "Sjá einnig" - -#: locale/__init__.py:237 -msgid "Tip" -msgstr "Ábending" - -#: locale/__init__.py:238 -msgid "Warning" -msgstr "Aðvörun" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" -#: cmd/quickstart.py:43 -msgid "automatically insert docstrings from modules" +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: cmd/quickstart.py:44 -msgid "automatically test code snippets in doctest blocks" +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: cmd/quickstart.py:45 -msgid "link between Sphinx documentation of different projects" +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: cmd/quickstart.py:46 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" msgstr "" -#: cmd/quickstart.py:47 -msgid "checks for documentation coverage" +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" msgstr "" -#: cmd/quickstart.py:48 -msgid "include math, rendered as PNG or SVG images" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " msgstr "" -#: cmd/quickstart.py:49 -msgid "include math, rendered in the browser by MathJax" +#: builders/__init__.py:415 +#, python-format +msgid "%d found" msgstr "" -#: cmd/quickstart.py:50 -msgid "conditional inclusion of content based on config values" +#: builders/__init__.py:417 +msgid "none found" msgstr "" -#: cmd/quickstart.py:51 -msgid "include links to the source code of documented Python objects" +#: builders/__init__.py:424 +msgid "pickling environment" msgstr "" -#: cmd/quickstart.py:52 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: builders/__init__.py:431 +msgid "checking consistency" msgstr "" -#: cmd/quickstart.py:94 -msgid "Please enter a valid path name." +#: builders/__init__.py:435 +msgid "no targets are out of date." msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter some text." +#: builders/__init__.py:474 +msgid "updating environment: " msgstr "" -#: cmd/quickstart.py:117 +#: builders/__init__.py:499 #, python-format -msgid "Please enter one of %s." +msgid "%s added, %s changed, %s removed" msgstr "" -#: cmd/quickstart.py:125 -msgid "Please enter either 'y' or 'n'." +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: cmd/quickstart.py:131 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: cmd/quickstart.py:215 +#: builders/__init__.py:556 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: cmd/quickstart.py:219 +#: builders/__init__.py:563 +#, python-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " msgstr "" -#: cmd/quickstart.py:227 +#: builders/__init__.py:725 #, python-format -msgid "Selected root path: %s" +msgid "docnames to write: %s" msgstr "" -#: cmd/quickstart.py:230 -msgid "Enter the root path for documentation." +#: builders/__init__.py:727 +msgid "no docnames to write!" msgstr "" -#: cmd/quickstart.py:231 -msgid "Root path for the documentation" +#: builders/__init__.py:740 +msgid "preparing documents" msgstr "" -#: cmd/quickstart.py:239 -msgid "Error: an existing conf.py has been found in the selected root path." +#: builders/__init__.py:743 +msgid "copying assets" msgstr "" -#: cmd/quickstart.py:245 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." msgstr "" -#: cmd/quickstart.py:248 -msgid "Please enter a new root path (or just Enter to exit)" +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." msgstr "" -#: cmd/quickstart.py:258 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: builders/changes.py:67 +msgid "writing summary file..." msgstr "" -#: cmd/quickstart.py:265 -msgid "Separate source and build directories (y/n)" +#: builders/changes.py:79 +msgid "Builtins" msgstr "" -#: cmd/quickstart.py:271 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: builders/changes.py:81 +msgid "Module level" msgstr "" -#: cmd/quickstart.py:277 -msgid "Name prefix for templates and static dir" +#: builders/changes.py:137 +msgid "copying source files..." msgstr "" -#: cmd/quickstart.py:282 -msgid "" -"The project name will occur in several places in the built documentation." +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" -#: cmd/quickstart.py:286 -msgid "Project name" +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" msgstr "" -#: cmd/quickstart.py:288 -msgid "Author name(s)" +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" msgstr "" -#: cmd/quickstart.py:293 +#: ext/coverage.py:148 +#, python-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +"the following modules are documented but were not specified in " +"coverage_modules: %s" msgstr "" -#: cmd/quickstart.py:301 -msgid "Project version" +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" msgstr "" -#: cmd/quickstart.py:303 -msgid "Project release" +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project language" +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" msgstr "" -#: cmd/quickstart.py:324 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" msgstr "" -#: cmd/quickstart.py:329 -msgid "Source file suffix" +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" msgstr "" -#: cmd/quickstart.py:334 +#: ext/extlinks.py:82 +#, python-format msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: cmd/quickstart.py:342 -msgid "Name of your master document (without suffix)" +#: ext/todo.py:61 +msgid "Todo" msgstr "" -#: cmd/quickstart.py:352 +#: ext/todo.py:94 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "TODO entry found: %s" msgstr "" -#: cmd/quickstart.py:359 -msgid "sphinx-quickstart will not overwrite the existing file." +#: ext/todo.py:152 +msgid "<>" msgstr "" -#: cmd/quickstart.py:362 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" msgstr "" -#: cmd/quickstart.py:371 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: ext/todo.py:166 +msgid "original entry" msgstr "" -#: cmd/quickstart.py:381 +#: ext/imgconverter.py:44 +#, python-format msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" msgstr "" -#: cmd/quickstart.py:391 +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:397 -msgid "Create Makefile? (y/n)" +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" -#: cmd/quickstart.py:401 -msgid "Create Windows command file? (y/n)" +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" -#: cmd/quickstart.py:453 ext/apidoc.py:92 +#: ext/graphviz.py:153 #, python-format -msgid "Creating file %s." +msgid "External Graphviz file %r not found or reading it failed" msgstr "" -#: cmd/quickstart.py:458 ext/apidoc.py:89 -#, python-format -msgid "File %s already exists, skipping." +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." msgstr "" -#: cmd/quickstart.py:501 -msgid "Finished: An initial directory structure has been created." +#: ext/graphviz.py:287 +#, python-format +msgid "graphviz_dot executable path must be set! %r" msgstr "" -#: cmd/quickstart.py:504 +#: ext/graphviz.py:328 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" msgstr "" -#: cmd/quickstart.py:512 +#: ext/graphviz.py:339 +#, python-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:515 +#: ext/graphviz.py:344 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" msgstr "" -#: cmd/quickstart.py:522 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" msgstr "" -#: cmd/quickstart.py:557 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" msgstr "" -#: cmd/build.py:153 cmd/quickstart.py:567 ext/apidoc.py:374 -#: ext/autosummary/generate.py:766 -msgid "For more information, visit ." +#: ext/graphviz.py:493 ext/graphviz.py:501 +#, python-format +msgid "[graph: %s]" msgstr "" -#: cmd/quickstart.py:577 -msgid "quiet mode" +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" msgstr "" -#: cmd/quickstart.py:587 -msgid "project root" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: cmd/quickstart.py:590 -msgid "Structure options" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: cmd/quickstart.py:596 -msgid "if specified, separate source and build dirs" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" msgstr "" -#: cmd/quickstart.py:602 -msgid "if specified, create build dir under source dir" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: cmd/quickstart.py:608 -msgid "replacement for dot in _templates etc." +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: cmd/quickstart.py:611 -msgid "Project basic options" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: cmd/quickstart.py:613 -msgid "project name" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." msgstr "" -#: cmd/quickstart.py:616 -msgid "author names" +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" msgstr "" -#: cmd/quickstart.py:623 -msgid "version of project" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: cmd/quickstart.py:630 -msgid "release of project" +#: ext/doctest.py:297 +#, python-format +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: cmd/quickstart.py:637 -msgid "document language" +#: ext/doctest.py:451 +#, python-format +msgid "no code/output in %s block at %s:%s" msgstr "" -#: cmd/quickstart.py:640 -msgid "source file suffix" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: cmd/quickstart.py:643 -msgid "master document name" +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: cmd/quickstart.py:646 -msgid "use epub" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: cmd/quickstart.py:649 -msgid "Extension options" +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" + +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: cmd/quickstart.py:656 ext/apidoc.py:578 +#: ext/duration.py:124 #, python-format -msgid "enable %s extension" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: cmd/quickstart.py:663 ext/apidoc.py:570 -msgid "enable arbitrary extensions" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: cmd/quickstart.py:666 -msgid "Makefile and Batchfile creation" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: cmd/quickstart.py:672 -msgid "create makefile" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: cmd/quickstart.py:678 -msgid "do not create makefile" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: cmd/quickstart.py:685 -msgid "create batchfile" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: cmd/quickstart.py:691 -msgid "do not create batchfile" +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: cmd/quickstart.py:700 -msgid "use make-mode for Makefile/make.bat" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " msgstr "" -#: cmd/quickstart.py:703 ext/apidoc.py:581 -msgid "Project templating" +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: cmd/quickstart.py:709 ext/apidoc.py:587 -msgid "template directory for template files" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: cmd/quickstart.py:716 -msgid "define a template variable" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: cmd/quickstart.py:751 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:770 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: cmd/quickstart.py:777 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: cmd/quickstart.py:795 +#: domains/javascript.py:183 #, python-format -msgid "Invalid template variable: %s" +msgid "%s() (built-in function)" msgstr "" -#: cmd/build.py:49 -msgid "Exception occurred while building, starting debugger:" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: _cli/util/errors.py:129 cmd/build.py:65 -msgid "Interrupted!" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "" + +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" +msgstr "" + +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" +msgstr "" + +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "" + +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: cmd/build.py:67 -msgid "reST markup error:" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: _cli/util/errors.py:143 cmd/build.py:73 -msgid "Encoding error:" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: cmd/build.py:78 cmd/build.py:108 +#: domains/javascript.py:374 #, python-format -msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." +msgid "%s (module)" msgstr "" -#: _cli/util/errors.py:148 cmd/build.py:90 -msgid "Recursion error:" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: _cli/util/errors.py:152 cmd/build.py:94 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: _cli/util/errors.py:165 cmd/build.py:103 -msgid "Exception occurred:" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: _cli/util/errors.py:178 cmd/build.py:117 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: cmd/build.py:124 -msgid "" -"A bug report can be filed in the tracker at . Thanks!" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "" + +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" +msgstr "" + +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" +msgstr "" + +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr "" + +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "" + +#: domains/rst.py:234 +msgid "directive" +msgstr "" + +#: domains/rst.py:235 +msgid "directive-option" +msgstr "" + +#: domains/rst.py:236 +msgid "role" +msgstr "" + +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "" + +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" +msgstr "" + +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "" + +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "" + +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" +msgstr "" + +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" msgstr "" -#: cmd/build.py:144 +#: cmd/build.py:64 msgid "job number should be a positive number" msgstr "" -#: cmd/build.py:154 +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" + +#: cmd/build.py:74 msgid "" "\n" "Generate documentation from source files.\n" @@ -1340,767 +1641,772 @@ msgid "" "files can be built by specifying individual filenames.\n" msgstr "" -#: cmd/build.py:180 +#: cmd/build.py:100 msgid "path to documentation source files" msgstr "" -#: cmd/build.py:183 +#: cmd/build.py:103 msgid "path to output directory" msgstr "" -#: cmd/build.py:188 +#: cmd/build.py:109 msgid "" "(optional) a list of specific files to rebuild. Ignored if --write-all is " "specified" msgstr "" -#: cmd/build.py:194 +#: cmd/build.py:114 msgid "general options" msgstr "" -#: cmd/build.py:201 +#: cmd/build.py:121 msgid "builder to use (default: 'html')" msgstr "" -#: cmd/build.py:210 +#: cmd/build.py:131 msgid "" "run in parallel with N processes, when possible. 'auto' uses the number of " "CPU cores" msgstr "" -#: cmd/build.py:220 +#: cmd/build.py:140 msgid "write all files (default: only write new and changed files)" msgstr "" -#: cmd/build.py:227 +#: cmd/build.py:147 msgid "don't use a saved environment, always read all files" msgstr "" -#: cmd/build.py:230 +#: cmd/build.py:150 msgid "path options" msgstr "" -#: cmd/build.py:236 +#: cmd/build.py:157 msgid "" "directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: cmd/build.py:246 +#: cmd/build.py:166 msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: cmd/build.py:255 +#: cmd/build.py:175 msgid "use no configuration file, only use settings from -D options" msgstr "" -#: cmd/build.py:264 +#: cmd/build.py:184 msgid "override a setting in configuration file" msgstr "" -#: cmd/build.py:273 +#: cmd/build.py:193 msgid "pass a value into HTML templates" msgstr "" -#: cmd/build.py:282 +#: cmd/build.py:202 msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: cmd/build.py:289 +#: cmd/build.py:209 msgid "nitpicky mode: warn about all missing references" msgstr "" -#: cmd/build.py:292 +#: cmd/build.py:212 msgid "console output options" msgstr "" -#: cmd/build.py:299 +#: cmd/build.py:219 msgid "increase verbosity (can be repeated)" msgstr "" -#: cmd/build.py:306 ext/apidoc.py:413 +#: cmd/build.py:226 ext/apidoc/_cli.py:66 msgid "no output on stdout, just warnings on stderr" msgstr "" -#: cmd/build.py:313 +#: cmd/build.py:233 msgid "no output at all, not even warnings" msgstr "" -#: cmd/build.py:321 +#: cmd/build.py:241 msgid "do emit colored output (default: auto-detect)" msgstr "" -#: cmd/build.py:329 +#: cmd/build.py:249 msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: cmd/build.py:332 +#: cmd/build.py:252 msgid "warning control options" msgstr "" -#: cmd/build.py:338 +#: cmd/build.py:258 msgid "write warnings (and errors) to given file" msgstr "" -#: cmd/build.py:345 +#: cmd/build.py:265 msgid "turn warnings into errors" msgstr "" -#: cmd/build.py:353 +#: cmd/build.py:273 msgid "show full traceback on exception" msgstr "" -#: cmd/build.py:356 +#: cmd/build.py:276 msgid "run Pdb on exception" msgstr "" -#: cmd/build.py:362 +#: cmd/build.py:282 msgid "raise an exception on warnings" msgstr "" -#: cmd/build.py:405 +#: cmd/build.py:325 msgid "cannot combine -a option and filenames" msgstr "" -#: cmd/build.py:437 +#: cmd/build.py:357 #, python-format msgid "cannot open warning file '%s': %s" msgstr "" -#: cmd/build.py:456 +#: cmd/build.py:376 msgid "-D option argument must be in the form name=value" msgstr "" -#: cmd/build.py:463 +#: cmd/build.py:383 msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "" - -#: builders/linkcheck.py:75 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/linkcheck.py:146 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/linkcheck.py:540 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/linkcheck.py:742 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/singlehtml.py:37 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/singlehtml.py:173 -msgid "assembling single document" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/latex/__init__.py:346 builders/manpage.py:56 -#: builders/singlehtml.py:178 builders/texinfo.py:121 -msgid "writing" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/singlehtml.py:191 -msgid "writing additional files" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/manpage.py:39 -#, python-format -msgid "The manual pages are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/manpage.py:47 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/manpage.py:73 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/text.py:34 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/html/__init__.py:1239 builders/text.py:81 builders/xml.py:97 +#: cmd/quickstart.py:134 #, python-format -msgid "error writing file %s: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/xml.py:38 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/xml.py:110 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/texinfo.py:47 +#: cmd/quickstart.py:230 #, python-format -msgid "The Texinfo files are in %(outdir)s." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/texinfo.py:49 +#: cmd/quickstart.py:235 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "" - -#: builders/texinfo.py:78 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/texinfo.py:90 +#: cmd/quickstart.py:242 #, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +msgid "Selected root path: %s" msgstr "" -#: builders/latex/__init__.py:324 builders/texinfo.py:115 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/latex/__init__.py:404 builders/texinfo.py:174 -msgid "resolving references..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/latex/__init__.py:415 builders/texinfo.py:184 -msgid " (in " +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/_epub_base.py:423 builders/html/__init__.py:778 -#: builders/latex/__init__.py:482 builders/texinfo.py:202 -msgid "copying images... " +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/_epub_base.py:445 builders/latex/__init__.py:497 -#: builders/texinfo.py:219 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/texinfo.py:226 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/texinfo.py:234 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/gettext.py:230 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/__init__.py:383 builders/gettext.py:251 -#, python-format -msgid "building [%s]: " +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/gettext.py:252 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/gettext.py:257 -msgid "reading templates... " +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/gettext.py:292 -msgid "writing message catalogs... " +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/__init__.py:212 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/__init__.py:220 -#, python-format -msgid "a suitable image for %s builder not found: %s" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/__init__.py:243 -msgid "building [mo]: " +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: builders/__init__.py:246 builders/__init__.py:741 builders/__init__.py:773 -msgid "writing output... " +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: builders/__init__.py:263 -#, python-format -msgid "all of %d po files" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: builders/__init__.py:285 -#, python-format -msgid "targets for %d po files that are specified" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are out of date" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/__init__.py:307 -msgid "all source files" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: builders/__init__.py:319 -#, python-format -msgid "file %r given on command line does not exist, " +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: builders/__init__.py:325 +#: cmd/quickstart.py:368 #, python-format msgid "" -"file %r given on command line is not under the source directory, ignoring" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: builders/__init__.py:336 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: builders/__init__.py:351 -#, python-format -msgid "%d source files given on command line" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: builders/__init__.py:366 -#, python-format -msgid "targets for %d source files that are out of date" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: builders/__init__.py:394 -msgid "looking for now-outdated files... " +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: builders/__init__.py:398 -#, python-format -msgid "%d found" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: builders/__init__.py:400 -msgid "none found" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: builders/__init__.py:407 -msgid "pickling environment" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: builders/__init__.py:414 -msgid "checking consistency" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: builders/__init__.py:418 -msgid "no targets are out of date." +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: builders/__init__.py:458 -msgid "updating environment: " +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: builders/__init__.py:483 +#: cmd/quickstart.py:520 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: builders/__init__.py:519 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: builders/__init__.py:528 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: builders/__init__.py:539 -#, python-format +#: cmd/quickstart.py:538 msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: builders/__init__.py:546 -#, python-format +#: cmd/quickstart.py:573 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: builders/__init__.py:565 builders/__init__.py:581 -msgid "reading sources... " +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: builders/__init__.py:698 -#, python-format -msgid "docnames to write: %s" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: builders/__init__.py:711 -msgid "preparing documents" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: builders/__init__.py:714 -msgid "copying assets" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: builders/__init__.py:866 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: builders/epub3.py:83 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: builders/epub3.py:220 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: builders/epub3.py:231 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: builders/epub3.py:255 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1289 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: builders/_epub_base.py:222 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: builders/_epub_base.py:434 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: builders/_epub_base.py:465 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: builders/_epub_base.py:477 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: builders/_epub_base.py:512 -msgid "writing mimetype file..." +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: builders/_epub_base.py:521 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: builders/_epub_base.py:590 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: builders/_epub_base.py:764 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "" + +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: builders/_epub_base.py:793 +#: cmd/quickstart.py:810 #, python-format -msgid "writing %s file..." +msgid "Invalid template variable: %s" msgstr "" -#: builders/changes.py:33 +#: directives/other.py:119 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: builders/changes.py:60 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "no changes in version %s." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: builders/changes.py:62 -msgid "writing summary file..." +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: builders/changes.py:74 -msgid "Builtins" +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" msgstr "" -#: builders/changes.py:76 -msgid "Module level" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: builders/changes.py:128 -msgid "copying source files..." +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: builders/changes.py:137 -#, python-format -msgid "could not read %r for changelog creation" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: util/rst.py:72 -#, python-format -msgid "default role %s not found" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: util/docfields.py:95 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/osutil.py:130 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: util/nodes.py:419 -#, python-format +#: directives/patches.py:70 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: util/nodes.py:487 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: util/nodes.py:701 +#: directives/code.py:87 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "Invalid caption: %s" msgstr "" -#: util/fileutil.py:74 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: util/fileutil.py:89 +#: directives/code.py:216 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: util/inventory.py:170 +#: directives/code.py:231 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/inventory.py:185 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: util/docutils.py:284 +#: directives/code.py:276 #, python-format -msgid "unknown directive or role name: %s:%s" +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: util/docutils.py:747 +#: directives/code.py:314 #, python-format -msgid "unknown node type: %r" +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: util/display.py:81 -msgid "skipped" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" msgstr "" -#: util/display.py:86 -msgid "failed" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Yfirlit" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: util/i18n.py:103 -#, python-format -msgid "reading error: %s, %s" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" msgstr "" -#: util/i18n.py:110 -#, python-format -msgid "writing error: %s, %s" +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: util/i18n.py:138 +#: writers/texinfo.py:1303 #, python-format -msgid "locale_dir %s does not exist" +msgid "unimplemented node type: %r" msgstr "" -#: util/i18n.py:230 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "" +msgid "[image: %s]" +msgstr "[mynd: %s]" -#: directives/patches.py:66 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[mynd]" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: directives/code.py:87 +#: writers/html5.py:431 #, python-format -msgid "Invalid caption: %s" +msgid "numfig_format is not defined for %s" msgstr "" -#: directives/code.py:132 directives/code.py:297 directives/code.py:484 +#: writers/html5.py:441 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "Any IDs not assigned for %s node" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: directives/code.py:234 -#, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: directives/code.py:276 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "Object named %r not found in include file %r" +msgid "unsupported rubric heading level: %s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: directives/code.py:314 -#, python-format -msgid "Line spec %r: no lines pulled from include file %r" +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: directives/other.py:122 -#, python-format -msgid "toctree glob pattern %r didn't match any documents" +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: directives/other.py:155 environment/adapters/toctree.py:355 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: directives/other.py:158 environment/adapters/toctree.py:359 +#: writers/latex.py:386 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: directives/other.py:171 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "no Babel option known for language %r" msgstr "" -#: directives/other.py:204 -msgid "Section author: " +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: directives/other.py:206 -msgid "Module author: " +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: directives/other.py:208 -msgid "Code author: " +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: directives/other.py:210 -msgid "Author: " +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: directives/other.py:284 -msgid ".. acks content is not a list" +#: writers/latex.py:1228 +#, python-format +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: directives/other.py:309 -msgid ".. hlist content is not a list" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "" + +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" #: _cli/__init__.py:73 @@ -2108,6 +2414,7 @@ msgid "Usage:" msgstr "" #: _cli/__init__.py:75 +#, python-brace-format msgid "{0} [OPTIONS] []" msgstr "" @@ -2123,1992 +2430,1876 @@ msgstr "" msgid "Options" msgstr "" -#: _cli/__init__.py:112 _cli/__init__.py:183 +#: _cli/__init__.py:113 _cli/__init__.py:181 msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: _cli/__init__.py:172 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" "{0}: error: {1}\n" "Run '{0} --help' for information" msgstr "" -#: _cli/__init__.py:182 +#: _cli/__init__.py:179 msgid " Manage documentation with Sphinx." msgstr "" -#: _cli/__init__.py:194 +#: _cli/__init__.py:191 msgid "Show the version and exit." msgstr "" -#: _cli/__init__.py:202 +#: _cli/__init__.py:199 msgid "Show this message and exit." msgstr "" -#: _cli/__init__.py:206 +#: _cli/__init__.py:203 msgid "Logging" msgstr "" -#: _cli/__init__.py:213 +#: _cli/__init__.py:210 msgid "Increase verbosity (can be repeated)" msgstr "" -#: _cli/__init__.py:221 +#: _cli/__init__.py:218 msgid "Only print errors and warnings." msgstr "" -#: _cli/__init__.py:228 +#: _cli/__init__.py:225 msgid "No output at all" msgstr "" -#: _cli/__init__.py:234 +#: _cli/__init__.py:231 msgid "" msgstr "" -#: _cli/__init__.py:265 +#: _cli/__init__.py:263 msgid "See 'sphinx --help'.\n" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:198 -#: transforms/__init__.py:133 writers/manpage.py:102 writers/texinfo.py:219 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:143 -msgid "could not calculate translation progress!" -msgstr "" - -#: transforms/__init__.py:148 -msgid "no translated elements!" -msgstr "" - -#: transforms/__init__.py:267 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "" - -#: transforms/__init__.py:313 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" - -#: transforms/__init__.py:322 -msgid "Footnote [*] is not referenced." -msgstr "" - -#: transforms/__init__.py:333 -msgid "Footnote [#] is not referenced." -msgstr "" - -#: transforms/i18n.py:228 transforms/i18n.py:303 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: transforms/i18n.py:273 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" -#: transforms/i18n.py:323 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: transforms/i18n.py:345 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" -#: ext/linkcode.py:75 ext/viewcode.py:201 -msgid "[source]" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: ext/imgconverter.py:40 -#, python-format -msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: ext/imgconverter.py:49 ext/imgconverter.py:73 +#: transforms/__init__.py:258 #, python-format msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: ext/imgconverter.py:68 +#: transforms/__init__.py:299 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "" - -#: ext/viewcode.py:258 -msgid "highlighting module code... " +msgid "Footnote [%s] is not referenced." msgstr "" -#: ext/viewcode.py:286 -msgid "[docs]" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: ext/viewcode.py:306 -msgid "Module code" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: ext/viewcode.py:312 +#: util/inventory.py:147 #, python-format -msgid "

        Source code for %s

        " +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: ext/viewcode.py:338 -msgid "Overview: module code" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: ext/viewcode.py:339 -msgid "

        All modules for which code is available

        " +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: ext/coverage.py:47 +#: util/i18n.py:113 #, python-format -msgid "invalid regex %r in %s" +msgid "writing error: %s, %s" msgstr "" -#: ext/coverage.py:134 ext/coverage.py:280 +#: util/i18n.py:146 #, python-format -msgid "module %s could not be imported: %s" +msgid "locale_dir %s does not exist" msgstr "" -#: ext/coverage.py:141 +#: util/i18n.py:244 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: ext/coverage.py:149 +#: util/i18n.py:253 +#, python-format msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: ext/coverage.py:163 +#: util/osutil.py:131 #, python-format msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: ext/coverage.py:177 -#, python-format -msgid "invalid regex %r in coverage_c_regexes" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: ext/coverage.py:245 -#, python-format -msgid "undocumented c api: %s [%s] in file %s" +#: util/display.py:87 +msgid "failed" msgstr "" -#: ext/coverage.py:429 +#: util/docutils.py:325 #, python-format -msgid "undocumented python function: %s :: %s" +msgid "unknown directive name: %s" msgstr "" -#: ext/coverage.py:445 +#: util/docutils.py:361 #, python-format -msgid "undocumented python class: %s :: %s" +msgid "unknown role name: %s" msgstr "" -#: ext/coverage.py:458 +#: util/docutils.py:805 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "" - -#: ext/todo.py:71 -msgid "Todo" +msgid "unknown node type: %r" msgstr "" -#: ext/todo.py:104 +#: util/fileutil.py:76 #, python-format -msgid "TODO entry found: %s" +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: ext/todo.py:163 -msgid "<>" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: ext/todo.py:165 +#: util/docfields.py:103 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: ext/todo.py:175 -msgid "original entry" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: ext/extlinks.py:82 +#: util/nodes.py:462 #, python-format msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: ext/doctest.py:115 +#: util/nodes.py:523 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: ext/doctest.py:120 +#: util/nodes.py:739 #, python-format -msgid "'%s' is not a valid option." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: ext/doctest.py:134 -#, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "framhald frá fyrri síðu" -#: ext/doctest.py:220 -msgid "invalid TestCode type" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "framhald á næstu síðu" + +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: ext/doctest.py:281 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: ext/doctest.py:434 -#, python-format -msgid "no code/output in %s block at %s:%s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: ext/doctest.py:522 -#, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "" - -#: ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" -msgstr "" - -#: ext/graphviz.py:145 -#, python-format -msgid "External Graphviz file %r not found or reading it failed" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Útgáfa" -#: ext/graphviz.py:268 +#: transforms/post_transforms/images.py:79 #, python-format -msgid "graphviz_dot executable path must be set! %r" +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: ext/graphviz.py:303 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: ext/graphviz.py:310 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" +msgid "Unknown image format: %s..." msgstr "" -#: ext/graphviz.py:313 -#, python-format +#: transforms/post_transforms/__init__.py:88 msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "" - -#: ext/graphviz.py:329 -#, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: ext/graphviz.py:333 ext/graphviz.py:386 ext/graphviz.py:423 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "dot code %r: %s" +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: ext/graphviz.py:436 ext/graphviz.py:444 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "[graph: %s]" -msgstr "" - -#: ext/graphviz.py:438 ext/graphviz.py:446 -msgid "[graph]" -msgstr "" - -#: ext/imgmath.py:369 ext/mathjax.py:52 -msgid "Link to this equation" +msgid "%s:%s reference target not found: %s" msgstr "" -#: ext/apidoc.py:85 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "Would create file %s." -msgstr "" - -#: ext/apidoc.py:375 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "" - -#: ext/apidoc.py:392 -msgid "path to module to document" +msgid "%r reference target not found: %s" msgstr "" -#: ext/apidoc.py:396 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: ext/apidoc.py:407 -msgid "directory to place all output" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: ext/apidoc.py:422 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: ext/apidoc.py:429 -msgid "overwrite existing files" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: ext/apidoc.py:437 +#: _cli/util/errors.py:207 msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "" - -#: ext/apidoc.py:446 -msgid "run the script without creating files" -msgstr "" - -#: ext/apidoc.py:453 -msgid "put documentation for each module on its own page" -msgstr "" - -#: ext/apidoc.py:460 -msgid "include \"_private\" modules" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: ext/apidoc.py:467 -msgid "filename of table of contents (default: modules)" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: ext/apidoc.py:474 -msgid "don't create a table of contents file" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: ext/apidoc.py:481 +#: _cli/util/errors.py:240 msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "" - -#: ext/apidoc.py:492 -msgid "put module documentation before submodule documentation" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: ext/apidoc.py:498 +#: _cli/util/errors.py:246 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "" - -#: ext/apidoc.py:508 -msgid "file suffix (default: rst)" -msgstr "" - -#: ext/apidoc.py:515 ext/autosummary/generate.py:839 -msgid "Remove existing files in the output directory that were not generated" -msgstr "" - -#: ext/apidoc.py:524 -msgid "generate a full project with sphinx-quickstart" -msgstr "" - -#: ext/apidoc.py:531 -msgid "append module_path to sys.path, used when --full is given" -msgstr "" - -#: ext/apidoc.py:538 -msgid "project name (default: root module name)" -msgstr "" - -#: ext/apidoc.py:545 -msgid "project author(s), used when --full is given" -msgstr "" - -#: ext/apidoc.py:552 -msgid "project version, used when --full is given" -msgstr "" - -#: ext/apidoc.py:559 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "" - -#: ext/apidoc.py:564 -msgid "extension options" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: ext/apidoc.py:638 -#, python-format -msgid "%s is not a directory." +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: ext/apidoc.py:710 ext/autosummary/generate.py:875 -#, python-format -msgid "Failed to remove %s: %s" +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: ext/autosectionlabel.py:48 +#: themes/basic/layout.html:115 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "" +msgid "Search within %(docstitle)s" +msgstr "Leita í %(docstitle)s" -#: domains/std/__init__.py:703 domains/std/__init__.py:812 -#: ext/autosectionlabel.py:52 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: ext/duration.py:85 -msgid "" -"====================== slowest reading durations =======================" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Leit" -#: ext/imgmath.py:159 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: ext/imgmath.py:174 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: ext/imgmath.py:328 +#: themes/basic/layout.html:201 #, python-format -msgid "display latex %r: %s" +msgid "Last updated on %(last_updated)s." msgstr "" -#: ext/imgmath.py:362 +#: themes/basic/layout.html:204 #, python-format -msgid "inline latex %r: %s" -msgstr "" - -#: writers/latex.py:1090 writers/manpage.py:263 writers/texinfo.py:662 -msgid "Footnotes" +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: writers/manpage.py:309 writers/text.py:936 -#, python-format -msgid "[image: %s]" -msgstr "[mynd: %s]" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Fyrra efni" -#: writers/manpage.py:310 writers/text.py:937 -msgid "[image]" -msgstr "[mynd]" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "fyrri kafli" -#: writers/html5.py:99 writers/html5.py:108 -msgid "Link to this definition" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Næsta efni" -#: writers/html5.py:415 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "næsti kafli" -#: writers/html5.py:427 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "Any IDs not assigned for %s node" +msgid "Index – %(key)s" msgstr "" -#: writers/html5.py:482 -msgid "Link to this term" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: writers/html5.py:525 writers/html5.py:530 -msgid "Link to this heading" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" -#: writers/html5.py:535 -msgid "Link to this table" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" msgstr "" -#: writers/html5.py:549 writers/latex.py:1099 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Flýtileit" -#: writers/html5.py:613 -msgid "Link to this code" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" -#: writers/html5.py:615 -msgid "Link to this image" +#: themes/basic/defindex.html:4 +msgid "Overview" msgstr "" -#: writers/html5.py:617 -msgid "Link to this toctree" +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" msgstr "" -#: writers/html5.py:758 -msgid "Could not obtain image size. :scale: option is ignored." +#: themes/basic/defindex.html:9 +msgid "the documentation for" msgstr "" -#: builders/latex/__init__.py:205 domains/std/__init__.py:646 -#: domains/std/__init__.py:658 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:513 -msgid "Index" -msgstr "Yfirlit" - -#: writers/latex.py:743 writers/texinfo.py:644 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +#: themes/basic/defindex.html:10 +msgid "last updated" msgstr "" -#: writers/texinfo.py:1216 -msgid "caption not inside a figure." -msgstr "" +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" +msgstr "Atriðaskrá og töflur:" -#: writers/texinfo.py:1302 -#, python-format -msgid "unimplemented node type: %r" -msgstr "" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "Heildarefnisyfirlit" -#: writers/latex.py:360 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" msgstr "" -#: builders/latex/__init__.py:223 writers/latex.py:410 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "Leitarsíða" -#: writers/latex.py:428 -msgid "too large :maxdepth:, ignored." -msgstr "" +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "leita" -#: writers/latex.py:590 -#, python-format -msgid "template %s not found; loading from legacy %s instead" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" msgstr "" -#: writers/latex.py:708 -msgid "document title is not a single Text node" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" msgstr "" -#: writers/latex.py:1175 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Almennt yfirlit" -#: writers/latex.py:1573 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" msgstr "" -#: writers/latex.py:1931 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Efnisyfirlit" -#: domains/std/__init__.py:87 domains/std/__init__.py:104 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "environment variable; %s" -msgstr "" +msgid "Search %(docstitle)s" +msgstr "Leita í %(docstitle)s" -#: domains/std/__init__.py:112 -#, python-format -msgid "%s; configuration value" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" msgstr "" -#: domains/std/__init__.py:166 -msgid "Type" +#: themes/basic/genindex-split.html:17 +msgid "can be huge" msgstr "" -#: domains/std/__init__.py:176 -msgid "Default" +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." msgstr "" -#: domains/std/__init__.py:235 -#, python-format +#: themes/basic/search.html:28 msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" +"Searching for multiple words only shows matches that contain\n" +" all words." msgstr "" -#: domains/std/__init__.py:306 -#, python-format -msgid "%s command line option" -msgstr "" +#: themes/basic/search.html:35 +msgid "search" +msgstr "leita" -#: domains/std/__init__.py:308 -msgid "command line option" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: domains/std/__init__.py:430 -msgid "glossary term must be preceded by empty line" -msgstr "" +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "Leitarniðurstöður" -#: domains/std/__init__.py:438 -msgid "glossary terms must not be separated by empty lines" -msgstr "" +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." +msgstr "Leitin bar ekki árangur. Vinsamlegast gangið úr skugga um að orðin séu rétt skrifuð og að þú hafir valið nægilega marga flokka." -#: domains/std/__init__.py:444 domains/std/__init__.py:457 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" -#: domains/std/__init__.py:602 -msgid "glossary term" -msgstr "" +#: themes/basic/static/searchtools.js:276 +msgid "Searching" +msgstr "Leitar" -#: domains/std/__init__.py:603 -msgid "grammar token" -msgstr "" +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "Undirbýr leit..." -#: domains/std/__init__.py:604 -msgid "reference label" +#: themes/basic/static/searchtools.js:526 +msgid ", in " msgstr "" -#: domains/std/__init__.py:607 -msgid "environment variable" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Fela leitarniðurstöður" -#: domains/std/__init__.py:608 -msgid "program option" +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 +#, python-format +msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" -#: domains/std/__init__.py:609 -msgid "document" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" msgstr "" -#: domains/std/__init__.py:647 domains/std/__init__.py:659 -msgid "Module Index" +#: themes/basic/changes/versionchanges.html:17 +#, python-format +msgid "Automatically generated list of changes in version %(version)s" msgstr "" -#: domains/std/__init__.py:648 domains/std/__init__.py:660 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "Leitarsíða" +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" +msgstr "" -#: domains/std/__init__.py:722 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" msgstr "" -#: domains/std/__init__.py:932 -msgid "numfig is disabled. :numref: is ignored." +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" msgstr "" -#: domains/std/__init__.py:940 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" msgstr "" -#: domains/std/__init__.py:952 -#, python-format -msgid "the link has no caption: %s" +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/std/__init__.py:966 -#, python-format -msgid "invalid numfig_format: %s (%r)" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/std/__init__.py:969 -#, python-format -msgid "invalid numfig_format: %s" +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" msgstr "" -#: domains/std/__init__.py:1200 -#, python-format -msgid "undefined label: %r" +#: domains/python/_object.py:206 +msgid "Variables" msgstr "" -#: domains/std/__init__.py:1202 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" +#: domains/python/_object.py:214 +msgid "Raises" msgstr "" -#: domains/python/__init__.py:107 domains/python/__init__.py:244 +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:167 domains/python/__init__.py:334 -#: domains/python/__init__.py:385 domains/python/__init__.py:424 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:169 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:194 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:195 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:249 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:251 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:389 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:428 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:559 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:560 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:637 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:663 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:665 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:666 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:668 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:669 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:729 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:858 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:920 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:304 domains/cpp/__init__.py:441 -#: domains/python/_object.py:164 ext/napoleon/docstring.py:786 -msgid "Parameters" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" -#: domains/python/_object.py:169 -msgid "Variables" +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" msgstr "" -#: domains/python/_object.py:173 -msgid "Raises" +#: domains/cpp/__init__.py:302 +#, python-format +msgid "%s (C++ %s)" msgstr "" -#: domains/c/__init__.py:199 -#, python-format -msgid "%s (C %s)" +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 +msgid "Return values" +msgstr "" + +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "" + +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" +msgstr "" + +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" msgstr "" -#: domains/c/__init__.py:260 domains/c/_symbol.py:510 +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "" + +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 +msgid "enum" +msgstr "" + +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 +msgid "enumerator" +msgstr "" + +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 +msgid "function parameter" +msgstr "" + +#: domains/cpp/__init__.py:954 +msgid "template parameter" +msgstr "" + +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:307 domains/cpp/__init__.py:454 -msgid "Return values" -msgstr "" - -#: domains/c/__init__.py:679 domains/cpp/__init__.py:860 -msgid "member" +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" msgstr "" -#: domains/c/__init__.py:680 +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:682 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:683 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/c/__init__.py:684 domains/cpp/__init__.py:858 -msgid "union" +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" msgstr "" -#: domains/c/__init__.py:685 domains/cpp/__init__.py:863 -msgid "enum" +#: domains/std/__init__.py:116 +#, python-format +msgid "%s; configuration value" msgstr "" -#: domains/c/__init__.py:686 domains/cpp/__init__.py:864 -msgid "enumerator" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: domains/c/__init__.py:687 domains/cpp/__init__.py:861 -msgid "type" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: domains/c/__init__.py:689 domains/cpp/__init__.py:866 -msgid "function parameter" +#: domains/std/__init__.py:239 +#, python-format +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: domains/cpp/__init__.py:155 -msgid "Template Parameters" +#: domains/std/__init__.py:319 +#, python-format +msgid "%s command line option" msgstr "" -#: domains/cpp/__init__.py:277 -#, python-format -msgid "%s (C++ %s)" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: domains/cpp/__init__.py:360 domains/cpp/_symbol.py:793 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: domains/cpp/__init__.py:862 -msgid "concept" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: domains/cpp/__init__.py:867 -msgid "template parameter" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Efnisyfirlit" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Leit" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: themes/basic/layout.html:18 -msgid "Navigation" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: themes/basic/layout.html:115 +#: domains/std/__init__.py:857 #, python-format -msgid "Search within %(docstitle)s" -msgstr "Leita í %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#: domains/std/__init__.py:1124 #, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: themes/basic/layout.html:201 +#: domains/std/__init__.py:1138 #, python-format -msgid "Last updated on %(last_updated)s." +msgid "the link has no caption: %s" msgstr "" -#: themes/basic/layout.html:204 +#: domains/std/__init__.py:1153 #, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: themes/basic/genindex-single.html:26 +#: domains/std/__init__.py:1157 #, python-format -msgid "Index – %(key)s" +msgid "invalid numfig_format: %s" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" msgstr "" -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: themes/basic/genindex-split.html:17 -msgid "can be huge" +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: themes/basic/opensearch.xml:4 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Search %(docstitle)s" -msgstr "Leita í %(docstitle)s" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: themes/basic/defindex.html:4 -msgid "Overview" +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: themes/basic/defindex.html:9 -msgid "the documentation for" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: themes/basic/defindex.html:10 -msgid "last updated" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" -msgstr "Atriðaskrá og töflur:" - -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" -msgstr "Heildarefnisyfirlit" - -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "leita" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Almennt yfirlit" - -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Flýtileit" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "" -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: themes/basic/search.html:35 -msgid "search" -msgstr "leita" +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" +msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Fyrra efni" +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 +#, python-format +msgid "alias of %s" +msgstr "" -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "fyrri kafli" +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" +msgstr "" -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Næsta efni" +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" +msgstr "" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "næsti kafli" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "" -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" msgstr "" -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: themes/basic/changes/versionchanges.html:17 +#: ext/autodoc/_names.py:89 #, python-format -msgid "Automatically generated list of changes in version %(version)s" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: themes/basic/changes/rstsource.html:5 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "%(filename)s — %(docstitle)s" +msgid "Would create file %s." msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Fela leitarniðurstöður" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "" -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" -msgstr "Leitarniðurstöður" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" -#: themes/basic/static/searchtools.js:119 +#: ext/apidoc/_cli.py:50 msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." -msgstr "Leitin bar ekki árangur. Vinsamlegast gangið úr skugga um að orðin séu rétt skrifuð og að þú hafir valið nægilega marga flokka." - -#: themes/basic/static/searchtools.js:123 -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "" -#: themes/basic/static/searchtools.js:253 -msgid "Searching" -msgstr "Leitar" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." -msgstr "Undirbýr leit..." +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "" -#: themes/basic/static/searchtools.js:474 -msgid ", in " +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: environment/collectors/asset.py:96 -#, python-format -msgid "image file not readable: %s" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: environment/collectors/asset.py:124 -#, python-format -msgid "image file %s not readable: %s" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "" + +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: environment/collectors/asset.py:161 -#, python-format -msgid "download file not readable: %s" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: environment/collectors/toctree.py:258 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: environment/adapters/toctree.py:318 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: environment/adapters/toctree.py:342 -#, python-format +#: ext/apidoc/_cli.py:135 msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: environment/adapters/toctree.py:357 -#, python-format -msgid "toctree contains reference to non-included document %r" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: environment/adapters/indexentries.py:126 -#, python-format -msgid "see %s" -msgstr "sjá %s" - -#: environment/adapters/indexentries.py:136 -#, python-format -msgid "see also %s" -msgstr "sjá einnig %s" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" -#: environment/adapters/indexentries.py:144 -#, python-format -msgid "unknown index entry type %r" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: environment/adapters/indexentries.py:270 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/html/__init__.py:363 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: builders/html/__init__.py:382 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "yfirlit" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: builders/html/__init__.py:560 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "Logo of %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "næsta" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "fyrri" - -#: builders/html/__init__.py:695 -msgid "generating indices" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/html/__init__.py:710 -msgid "writing additional pages" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/__init__.py:793 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/__init__.py:805 -msgid "copying downloadable files... " +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:817 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/__init__.py:863 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/__init__.py:881 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/__init__.py:916 -msgid "copying static files" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:933 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "cannot copy static file %r" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/__init__.py:938 -msgid "copying extra files" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/html/__init__.py:948 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: builders/html/__init__.py:954 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "Failed to write build info file: %r" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/html/__init__.py:1003 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/html/__init__.py:1051 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: builders/html/__init__.py:1213 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: builders/html/__init__.py:1222 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1255 -msgid "dumping object inventory" +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: builders/html/__init__.py:1263 +#: ext/autosummary/generate.py:634 #, python-format -msgid "dumping search index in %s" +msgid "[autosummary] writing to %s" msgstr "" -#: builders/html/__init__.py:1306 +#: ext/autosummary/generate.py:679 #, python-format -msgid "invalid js_file: %r, ignored" +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/html/__init__.py:1339 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: builders/html/__init__.py:1344 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: builders/html/__init__.py:1358 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: builders/html/__init__.py:1363 +#: ext/autosummary/generate.py:915 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1378 +#: ext/autosummary/generate.py:923 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "custom template directory (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1383 +#: ext/autosummary/generate.py:931 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "document imported members (default: %(default)s)" msgstr "" -#: builders/html/__init__.py:1394 builders/latex/__init__.py:504 +#: ext/autosummary/generate.py:940 #, python-format -msgid "logo file %r does not exist" +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: builders/html/__init__.py:1405 +#: ext/autosummary/__init__.py:235 #, python-format -msgid "favicon file %r does not exist" +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: builders/html/__init__.py:1417 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: builders/html/__init__.py:1430 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: builders/html/__init__.py:1447 +#: ext/autosummary/__init__.py:329 #, python-format -msgid "%s %s documentation" -msgstr "" - -#: builders/latex/transforms.py:118 -msgid "Failed to get a docname!" +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: builders/latex/transforms.py:119 +#: ext/autosummary/__init__.py:358 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "failed to import object %s" msgstr "" -#: builders/latex/transforms.py:485 +#: ext/autosummary/__init__.py:652 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: builders/latex/__init__.py:117 +#: ext/autosummary/__init__.py:850 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "autosummary_generate: file not found: %s" msgstr "" -#: builders/latex/__init__.py:119 +#: ext/autosummary/__init__.py:860 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "" - -#: builders/latex/__init__.py:157 -msgid "no \"latex_documents\" config value found; no documents will be written" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: builders/latex/__init__.py:169 +#: ext/intersphinx/_load.py:61 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: builders/latex/__init__.py:208 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Útgáfa" - -#: builders/latex/__init__.py:429 -msgid "copying TeX support files" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: builders/latex/__init__.py:466 -msgid "copying additional files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: builders/latex/__init__.py:540 +#: ext/intersphinx/_load.py:94 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: builders/latex/__init__.py:548 +#: ext/intersphinx/_load.py:103 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: builders/latex/theming.py:87 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: builders/latex/theming.py:90 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: _cli/util/errors.py:124 -msgid "Exception occurred, starting debugger:" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: _cli/util/errors.py:133 -msgid "reStructuredText markup error:" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: _cli/util/errors.py:168 -msgid "The full traceback has been saved in:" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: _cli/util/errors.py:172 +#: ext/intersphinx/_load.py:324 msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: transforms/post_transforms/__init__.py:125 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: transforms/post_transforms/__init__.py:185 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: transforms/post_transforms/__init__.py:251 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "(in %s %s)" msgstr "" -#: transforms/post_transforms/__init__.py:257 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "%r reference target not found: %s" +msgid "(in %s)" msgstr "" -#: transforms/post_transforms/images.py:77 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: transforms/post_transforms/images.py:94 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: transforms/post_transforms/images.py:141 +#: ext/intersphinx/_resolve.py:387 #, python-format -msgid "Unknown image format: %s..." +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/docstring.py:707 -msgid "Example" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/napoleon/docstring.py:708 -msgid "Examples" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/napoleon/__init__.py:344 ext/napoleon/docstring.py:752 -msgid "Keyword Arguments" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/napoleon/docstring.py:768 -msgid "Notes" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:777 -msgid "Other Parameters" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/napoleon/docstring.py:813 -msgid "Receives" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:817 -msgid "References" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/napoleon/docstring.py:849 -msgid "Warns" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/napoleon/docstring.py:853 -msgid "Yields" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/napoleon/docstring.py:1015 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1022 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1029 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/napoleon/docstring.py:1036 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/autosummary/__init__.py:256 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/autosummary/__init__.py:258 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/autosummary/__init__.py:277 -msgid "A captioned autosummary requires :toctree: option. ignored." -msgstr "" - -#: ext/autosummary/__init__.py:330 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/__init__.py:344 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "failed to parse name %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/autosummary/__init__.py:349 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "failed to import object %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/autosummary/__init__.py:648 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format msgid "" -"Summarised items should not include the current module. Replace %r with %r." +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/autosummary/__init__.py:819 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/autosummary/__init__.py:827 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/autosummary/generate.py:215 ext/autosummary/generate.py:391 -#, python-format -msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/autosummary/generate.py:526 -#, python-format -msgid "[autosummary] generating autosummary for: %s" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/autosummary/generate.py:530 -#, python-format -msgid "[autosummary] writing to %s" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/autosummary/generate.py:572 +#: builders/html/__init__.py:114 #, python-format -msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/autosummary/generate.py:767 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/autosummary/generate.py:789 -msgid "source files to generate rST files for" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/autosummary/generate.py:797 -msgid "directory to place all output in" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/autosummary/generate.py:805 +#: builders/html/__init__.py:372 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/autosummary/generate.py:813 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "yfirlit" + +#: builders/html/__init__.py:549 #, python-format -msgid "custom template directory (default: %(default)s)" +msgid "Logo of %s" msgstr "" -#: ext/autosummary/generate.py:821 -#, python-format -msgid "document imported members (default: %(default)s)" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "næsta" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "fyrri" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/autosummary/generate.py:829 -#, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:47 +#: builders/html/__init__.py:783 #, python-format -msgid "(in %s v%s)" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:103 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:113 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:359 +#: builders/html/__init__.py:871 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:367 -#, python-format -msgid "invalid external cross-reference suffix: %r" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:378 +#: builders/html/__init__.py:923 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "cannot copy static file %r" msgstr "" -#: ext/intersphinx/_resolve.py:585 -#, python-format -msgid "external %s:%s reference target not found: %s" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:59 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:70 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:81 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:92 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:101 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:120 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:155 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:240 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:265 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:275 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:319 +#: builders/html/__init__.py:1365 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/type_comment.py:132 +#: builders/html/__init__.py:1370 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/type_comment.py:135 +#: builders/html/__init__.py:1385 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:142 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:415 +#: builders/html/__init__.py:1412 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:532 +#: builders/html/__init__.py:1425 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:807 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:902 +#: builders/html/__init__.py:1454 #, python-format -msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +msgid "%s %s documentation" msgstr "" -#: ext/autodoc/__init__.py:946 +#: builders/latex/theming.py:87 #, python-format -msgid "A mocked object is detected: %r" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:965 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1028 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1035 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1048 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1114 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1337 ext/autodoc/__init__.py:1414 -#: ext/autodoc/__init__.py:2829 -#, python-format -msgid "Failed to get a function signature for %s: %s" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1633 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1760 -#, python-format -msgid "Bases: %s" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1774 +#: builders/latex/__init__.py:529 #, python-format -msgid "missing attribute %s in object %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1855 ext/autodoc/__init__.py:1892 -#: ext/autodoc/__init__.py:1987 +#: builders/latex/__init__.py:537 #, python-format -msgid "alias of %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1875 +#: environment/collectors/toctree.py:259 #, python-format -msgid "alias of TypeVar(%s)" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:2217 ext/autodoc/__init__.py:2317 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2448 +#: environment/collectors/asset.py:126 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/preserve_defaults.py:190 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "download file not readable: %s" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "framhald frá fyrri síðu" +#: environment/adapters/toctree.py:335 +#, python-format +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "framhald á næstu síðu" +#: environment/adapters/toctree.py:360 +#, python-format +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "sjá %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "sjá einnig %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/it/LC_MESSAGES/sphinx.mo b/sphinx/locale/it/LC_MESSAGES/sphinx.mo index 44cc7219469..96fcee8d38a 100644 Binary files a/sphinx/locale/it/LC_MESSAGES/sphinx.mo and b/sphinx/locale/it/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/it/LC_MESSAGES/sphinx.po b/sphinx/locale/it/LC_MESSAGES/sphinx.po index 48d98cc7b59..1b54762ce98 100644 --- a/sphinx/locale/it/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/it/LC_MESSAGES/sphinx.po @@ -14,7 +14,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Alessandro Cucci , 2024\n" "Language-Team: Italian (http://app.transifex.com/sphinx-doc/sphinx-1/language/it/)\n" @@ -25,6 +25,127 @@ msgstr "" "Language: it\n" "Plural-Forms: nplurals=3; plural=n == 1 ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -39,127 +160,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Impossibile trovare la cartella sorgente ( %s )" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "La cartella di output (%s) non è una cartella" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "La cartella sorgente e la cartella di destinazione non possono essere identiche" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Sto eseguendo Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Questo progetto necessita almeno di Sphinx v%s per cui non può essere creato con la versione attuale." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "sto creando la cartella di output" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "caricamento traduzioni [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "fatto" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -167,12 +315,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -180,82 +328,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -263,468 +543,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Sezione %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Fig. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabella %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Listato %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "il primary_domain %r non è stato trovato, tralasciato." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Attenzione" + +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Attenzione" + +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Pericolo" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Errore" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Suggerimento" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Importante" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Nota" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Vedi anche" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Suggerimento" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Avvertimento" + +#: builders/texinfo.py:41 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: events.py:370 +#: builders/texinfo.py:85 #, python-format -msgid "Unknown event name: %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: events.py:416 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "processing %s" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (in " + +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:171 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:218 #, python-format -msgid "Builder name %s not registered" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:204 +#: builders/manpage.py:37 #, python-format -msgid "domain %s already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:235 +#: builders/manpage.py:64 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/singlehtml.py:35 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:353 +#: builders/gettext.py:243 #, python-format -msgid "source_suffix %r is already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:363 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "source_parser for %r is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:372 +#: builders/gettext.py:265 #, python-format -msgid "Source parser for %s not registered" +msgid "targets for %d template files" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:496 +#: builders/linkcheck.py:87 #, python-format -msgid "enumerable_node %r already registered" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:512 +#: builders/linkcheck.py:159 #, python-format -msgid "math renderer %s is already registered" +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:529 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: registry.py:545 +#: builders/linkcheck.py:799 #, python-format -msgid "Could not import extension %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: registry.py:552 +#: builders/epub3.py:83 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: registry.py:565 -#, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: registry.py:577 -#, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[sorgente]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[documenti]" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Codice del modulo" +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" +msgstr "" -#: ext/viewcode.py:353 +#: builders/xml.py:29 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        Codice sorgente per %s

        " +msgid "The XML files are in %(outdir)s." +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Vista generale: codice del modulo" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Tutti i moduli di cui è disponibile il codice

        " +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "" -#: ext/extlinks.py:82 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/_epub_base.py:436 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/_epub_base.py:467 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/doctest.py:118 -#, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "manca '+' or'-' nell'opzione '%s'." +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' non è un'opzione valida." +msgid "unknown mimetype for %s, ignoring" +msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "writing %s file..." msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Builtins" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Al livello del modulo" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -745,9 +1181,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -782,6 +1219,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Da fare" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(L'<> si trova in %s, linea %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "riga originale" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -869,1779 +1334,1514 @@ msgstr "[grafico: %s]" msgid "[graph]" msgstr "[grafico]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Da fare" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(L'<> si trova in %s, linea %d.)" +msgid "display latex %r: %s" +msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "riga originale" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" -msgstr "Didascalia non valida: %s" +msgid "missing '+' or '-' in '%s' option." +msgstr "manca '+' or'-' nell'opzione '%s'." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "" +msgid "'%s' is not a valid option." +msgstr "'%s' non è un'opzione valida." -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Impossibile usare contemporaneamente le opzioni \"%s\" e \"%s\"" +msgid "'%s' is not a valid pyversion option" +msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:47 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autore della sezione: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[sorgente]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autore del modulo: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autore del codice: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[documenti]" -#: directives/other.py:209 -msgid "Author: " -msgstr "Autore: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Codice del modulo" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Codice sorgente per %s

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Vista generale: codice del modulo" -#: builders/changes.py:29 +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Tutti i moduli di cui è disponibile il codice

        " + +#: domains/citation.py:75 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:56 +#: domains/citation.py:92 #, python-format -msgid "no changes in version %s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" +msgstr "etichetta dell'equazione %s duplicata, altra istanza in %s" + +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Builtins" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (funzione built-in)" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Al livello del modulo" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s metodo)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (classe)" -#: builders/changes.py:133 +#: domains/javascript.py:188 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (variabile globale o costante)" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s attributo)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Parametri" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Solleva" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Ritorna" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Tipo di ritorno" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (modulo)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funzione" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metodo" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "classe" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "dati" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "attributo" -#: builders/__init__.py:275 +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modulo" + +#: domains/javascript.py:458 #, python-format -msgid "all of %d po files" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s (directive)" +msgstr "%s (direttiva)" -#: builders/__init__.py:309 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are out of date" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (ruolo)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "direttiva" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:330 +#: domains/rst.py:236 +msgid "role" +msgstr "ruolo" + +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/changeset.py:32 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:348 +#: domains/changeset.py:33 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "Changed in version %s" +msgstr "Cambiato nella versione %s" -#: builders/__init__.py:361 +#: domains/changeset.py:34 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Deprecato dalla versione %s" -#: builders/__init__.py:377 +#: domains/changeset.py:35 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/__init__.py:322 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:410 -#, python-format -msgid "%d found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: cmd/build.py:357 #, python-format -msgid "error writing file %s: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (in " +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:464 +#: cmd/quickstart.py:134 #, python-format -msgid "cannot write image file %r: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:242 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" - -#: _cli/__init__.py:98 -msgid "Options" -msgstr "Opzioni" - -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" - -#: _cli/__init__.py:171 -#, python-brace-format -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" - -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" - -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" - -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" - -#: _cli/__init__.py:231 -msgid "" -msgstr "" - -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" - -#: environment/__init__.py:86 -msgid "new config" -msgstr "" - -#: environment/__init__.py:87 -msgid "config changed" -msgstr "" - -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "" - -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" - -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "" - -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" - -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" - -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" - -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "" - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "" - -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "" - -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "" - -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" - -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "" - -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "" - -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: util/i18n.py:236 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "Invalid Babel locale: %r." +msgid "Creating file %s." msgstr "" -#: util/i18n.py:245 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +msgid "File %s already exists, skipping." msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: util/nodes.py:423 +#: cmd/quickstart.py:520 #, python-format msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" - -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" - -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" - -#: util/display.py:82 -msgid "skipped" -msgstr "" - -#: util/display.py:87 -msgid "failed" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" - -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" - -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" - -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: util/fileutil.py:76 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" - -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" - -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "" - -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" - -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Note a piè di pagina" - -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[immagine: %s]" - -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[immagine]" - -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Indice" - -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:538 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" - -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "" - -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "" - -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: writers/latex.py:1183 +#: cmd/quickstart.py:573 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" - -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" - -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "etichetta dell'equazione %s duplicata, altra istanza in %s" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (funzione built-in)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metodo)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (classe)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (variabile globale o costante)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s attributo)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Parametri" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Solleva" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Ritorna" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Tipo di ritorno" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modulo)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funzione" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metodo" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "classe" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "dati" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "attributo" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modulo" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Cambiato nella versione %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Deprecato dalla versione %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direttiva)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (ruolo)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "direttiva" - -#: domains/rst.py:235 -msgid "directive-option" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "ruolo" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Attenzione" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Attenzione" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Pericolo" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Errore" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Suggerimento" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Importante" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Nota" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Vedi anche" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Suggerimento" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Avvertimento" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Template di progetto" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: cmd/quickstart.py:234 +#: cmd/quickstart.py:793 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: cmd/quickstart.py:241 +#: cmd/quickstart.py:810 #, python-format -msgid "Selected root path: %s" +msgid "Invalid template variable: %s" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autore della sezione: " -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autore del modulo: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autore del codice: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autore: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: cmd/quickstart.py:286 +#: directives/patches.py:70 msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" +msgstr "Didascalia non valida: %s" -#: cmd/quickstart.py:300 -msgid "Project name" +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Impossibile usare contemporaneamente le opzioni \"%s\" e \"%s\"" + +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: cmd/quickstart.py:308 +#: directives/code.py:235 +#, python-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d %b %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Indice" -#: cmd/quickstart.py:339 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Note a piè di pagina" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[immagine: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[immagine]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: cmd/quickstart.py:367 +#: writers/html5.py:431 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "numfig_format is not defined for %s" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" + +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" + +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:386 #, python-format -msgid "Creating file %s." +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" + +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" +msgstr "" + +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: writers/latex.py:616 #, python-format -msgid "File %s already exists, skipping." +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:519 -#, python-format +#: writers/latex.py:1198 msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:526 +#: writers/latex.py:1228 +#, python-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:530 +#: writers/latex.py:1615 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "Opzioni" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Template di progetto" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:809 +#: util/i18n.py:244 #, python-format -msgid "Invalid template variable: %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/build.py:74 +#: util/osutil.py:131 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:131 +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "continua dalla pagina precedente" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Simboli" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "pagina" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Release" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Comprimi la barra laterale" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigazione" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Cerca in %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "A proposito di questi documenti" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Cerca" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Vai" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Ultimo aggiornamento %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Argomento precedente" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "capitolo precedente" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Argomento successivo" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "capitolo successivo" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Indice completo in una pagina" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Questa pagina" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Mostra sorgente" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Contenuti" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Ricerca veloce" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Cerca %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Vai" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2688,7 +2888,7 @@ msgstr "Indice dei moduli" msgid "quick access to all modules" msgstr "accesso veloce ai moduli" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Indice generale" @@ -2696,23 +2896,15 @@ msgstr "Indice generale" msgid "all functions, classes, terms" msgstr "tutte le funzioni, classi e moduli" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Questa pagina" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Indice completo in una pagina" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Ricerca veloce" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "Cerca %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2722,57 +2914,6 @@ msgstr "Indice delle pagine per lettera" msgid "can be huge" msgstr "può essere enorme" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Argomento precedente" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "capitolo precedente" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Argomento successivo" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "capitolo successivo" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigazione" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Cerca in %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "A proposito di questi documenti" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Ultimo aggiornamento %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2789,21 +2930,21 @@ msgstr "" msgid "search" msgstr "cerca" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Nascondi i risultati della ricerca" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Contenuti" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Risultati della ricerca" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "La tua ricerca non corrisponde a nessun documento. Verifica che tutte le parole siano scritte correttamente e di aver scelto un numero sufficiente di categorie." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2812,22 +2953,21 @@ msgstr[0] "" msgstr[1] "" msgstr[2] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Cerca" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Preparo la ricerca..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", in " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Nascondi i risultati della ricerca" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2835,6 +2975,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Cambiamenti nella Versione %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2856,120 +3001,127 @@ msgstr "Altre modifiche" msgid "Expand sidebar" msgstr "Espandi la barra laterale" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametri" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variabili" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Solleva" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (nel modulo %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (nel modulo %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (variabile built-in)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (classe built-in)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (classe in %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s metodo della classe)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s metodo statico)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Indice del modulo Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moduli" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Deprecato" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "eccezione" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "metodo della classe" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "metodo statico" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (deprecato)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametri" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variabili" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Solleva" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2980,746 +3132,526 @@ msgstr "Parametri del modello" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "Valori restituiti" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "membro" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tipo" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "concetto" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumeratore" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "variabile" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "macro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "variabile d'ambiente, %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "voce del glossario" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "elemento grammaticale" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "etichetta di riferimento" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "variabile d'ambiente" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "opzione del programma" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "documento" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Indice dei moduli" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "vedi %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "vedi anche %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Simboli" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" - -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "" - -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "" - -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "" - -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:239 #, python-format -msgid "Unknown image format: %s..." +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:319 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "indice" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "voce del glossario" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "elemento grammaticale" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "successivo" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "etichetta di riferimento" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "precedente" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "variabile d'ambiente" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "opzione del programma" + +#: domains/std/__init__.py:735 +msgid "document" +msgstr "documento" + +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Indice dei moduli" + +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1153 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1157 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1453 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:934 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy static file %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "cannot copy extra file %r" +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to write build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Esempio" + +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Esempi" + +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Argomenti parole chiave" + +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Note" + +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:1265 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "dumping search index in %s" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1308 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "invalid js_file: %r, ignored" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "" +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" +msgstr " Basi: %s" -#: builders/html/__init__.py:1346 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Unknown math_renderer %r is given." +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1360 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_names.py:89 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_names.py:93 #, python-format -msgid "logo file %r does not exist" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "" + +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "favicon file %r does not exist" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "Would create file %s." msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:28 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" -msgstr "Documentazione %s %s " +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:91 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Release" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "continua dalla pagina precedente" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "pagina" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Argomenti parole chiave" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Esempio" - -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Esempi" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Note" - -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3727,7 +3659,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3742,481 +3674,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "%s is not a directory." +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:256 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" -msgstr "(in %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "indice" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "successivo" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "precedente" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "" + +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "" + +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "Documentazione %s %s " + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "" + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" -msgstr " Basi: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "vedi %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "vedi anche %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/ja/LC_MESSAGES/sphinx.mo b/sphinx/locale/ja/LC_MESSAGES/sphinx.mo index 5874884e9e3..3b6e1214982 100644 Binary files a/sphinx/locale/ja/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ja/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/ja/LC_MESSAGES/sphinx.po b/sphinx/locale/ja/LC_MESSAGES/sphinx.po index cbe5c92da82..3ce6f74aeab 100644 --- a/sphinx/locale/ja/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/ja/LC_MESSAGES/sphinx.po @@ -24,7 +24,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Takayuki SHIMIZUKAWA , 2016-2017,2019,2024\n" "Language-Team: Japanese (http://app.transifex.com/sphinx-doc/sphinx-1/language/ja/)\n" @@ -35,6 +35,127 @@ msgstr "" "Language: ja\n" "Plural-Forms: nplurals=1; plural=0;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "無効なPEP番号 %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "無効なRFC番号 %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "設定 %s.%s がテーマ設定にありません" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "サポートされていないテーマオプション %r が指定されました" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "テーマパス上のファイル %r は正しいzipファイルではないか、テーマを含んでいません" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -49,127 +170,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "このプロジェクトは拡張 %s の %s 以降のバージョンが必要なため、現在のバージョン(%s)ではビルドできません。" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Pygments に %r というlexerがありません" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "イベント %r はすでに登録されています" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "不明なイベント名: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "イベント %r のハンドラ %r で例外が発生しました。" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "ソースディレクトリが存在しません (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "出力先ディレクトリ (%s) はディレクトリではありません" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "出力先ディレクトリにはソースディレクトリと異なるディレクトリを指定してください" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx v%s を実行中" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "このプロジェクトはSphinx v%s以降のバージョンでなければビルドできません。" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "出力先ディレクトリを作成しています" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "拡張機能のセットアップ中 %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "conf.pyにある'setup'はPythonのcallableではありません。定義を修正してcallableである関数にしてください。これはconf.pyがSphinx拡張として動作するのに必要です。" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "翻訳カタログをロードしています [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "完了" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "翻訳が用意されていません" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "保存された環境データを読み込み中" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "失敗: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "ビルダーが選択されていないので、デフォルトの html を使用します" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "nodeクラス %r は既に登録されています。visitor関数は上書きされます" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -177,12 +325,12 @@ msgid "" "explicit" msgstr "拡張 %s は並列読み込みが可能かどうかを宣言していないため、おそらく並列読み込みに対応していないでしょう。拡張の実装者に連絡して、明示してもらってください。" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "%s拡張は並列読み込みに対して安全ではありません" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -190,82 +338,214 @@ msgid "" "explicit" msgstr "拡張 %s は並列書き込みが可能かどうかを宣言していないため、おそらく並列書き込みに対応していないでしょう。拡張の実装者に連絡して、明示してもらってください。" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "%s拡張は並列書き込みに対して安全ではありません" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "直列で %sします" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "conf.py が設定ディレクトリに存在しません (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "ビルダークラス %s には\"name\"属性がありません" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "ビルダー %r (モジュール %s) がすでに登録されています" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "ビルダー名 %s は登録されておらず、entry pointにもありません" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "ビルダー名 %s は登録されていません" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "ドメイン %s はすでに登録されています" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "ドメイン %s はまだ登録されていません" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "ディレクティブ %r は既に%sドメインに登録されています" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "ロール %r は既にドメイン%sに登録されています" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "インデックス %r はすでに%sドメインに登録されています" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "object_type %r はすでに登録されています" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "classref_type %r はすでに登録されています" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r はすでに登録されています" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "%r のsource_parserはすでに登録されています" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "%s のsource_parserは登録されていません" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "%r のTranslatorはすでに登録されています" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "add_node() のキーワード引数は (visit, depart) の形式で関数をタプルで指定してください: %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r はすでに登録されています" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "math renderer %s はすでに登録されています" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "無効な設定値が見つかりました: 'language = None' 。設定を有効な言語コードに更新してください。 'en' (英語)にフォールバックしています。" +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "拡張 %r はSphinxのバージョン%sでSphinxに統合されています。この拡張は無視されます。" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "元の例外:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "拡張 %s をimportできません" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "拡張 %r には setup() 関数がありません。これは本当にSphinx拡張ですか?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "このプロジェクトで使われている拡張 %s はSphinx v%s 以降が必要なため、現在のバージョンではビルドできません。" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "拡張 %r のsetup()関数が、対応していないオブジェクトを返しました。Noneまたはメタデータ辞書を返してください" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "conf.py が設定ディレクトリに存在しません (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "設定値の辞書 %r は上書きないため無視されました (%r を使って個別に設定してください)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "%r は設定値 %r の正しい値ではないため無視されました" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "%r は正しい型ではないため無視されました" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "不明な設定値 %r による上書きは無視されました" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "設定値 %r は既に登録済みです" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "無効な設定値が見つかりました: 'language = None' 。設定を有効な言語コードに更新してください。 'en' (英語)にフォールバックしています。" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "設定ファイルに文法エラーが見つかりました: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "設定ファイル(あるいはインポートしたどれかのモジュール)がsys.exit()を呼びました" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -273,543 +553,728 @@ msgid "" "%s" msgstr "設定ファイルにプログラム上のエラーがあります:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "設定値 `source_suffix' に `%r' (%s型)が指定されましたが、文字列、文字列のリスト、辞書、のいずれかを指定してください。" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "%s 章" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "図 %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "表 %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "リスト %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr " 設定値 `{name}` に `{current}` が指定されましたが、 {candidates} のいずれかを指定してください。" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "設定値 `{name}' に `{current.__name__}' 型が指定されていますが、 {permitted} 型を指定してください。" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "設定値 `{name}' に `{current.__name__}' 型が指定されています。デフォルト値は `{default.__name__}' です。" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r が見つかりません。無視します。" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Pygments に %r というlexerがありません" - -#: highlighting.py:209 -#, python-format +#: config.py:892 msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "新しい設定" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "設定 %s.%s がテーマ設定にありません" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "変更された設定" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "サポートされていないテーマオプション %r が指定されました" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "変更された拡張" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "テーマパス上のファイル %r は正しいzipファイルではないか、テーマを含んでいません" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "ビルド環境のバージョンが最新ではありません" -#: theming.py:228 -#, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "ソースディレクトリが変更されました" -#: theming.py:268 +#: environment/__init__.py:350 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:355 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:282 +#: environment/__init__.py:361 #, python-format -msgid "The %r theme has too many ancestors" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:310 -#, python-format -msgid "no theme configuration file found in %r" -msgstr "" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "この環境は選択したビルダーと互換性がありません。別の doctree ディレクトリーを選択してください。" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:518 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +msgid "Failed to scan documents in %s: %r" +msgstr "%s のドキュメントをスキャンできませんでした: %r " -#: theming.py:339 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +msgid "Domain %r is not registered" +msgstr "ドメイン %r はまだ登録されていません" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "ドキュメントはどの toctree にも含まれていません" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "自己参照している toctree が見つかりました。無視します。" -#: theming.py:366 +#: environment/__init__.py:952 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "イベント %r はすでに登録されています" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "注意" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "不明なイベント名: %s" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "注意" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "イベント %r のハンドラ %r で例外が発生しました。" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "危険" -#: project.py:72 +#: locale/__init__.py:232 +msgid "Error" +msgstr "エラー" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "ヒント" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "重要" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "注釈" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "参考" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tip" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "警告" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Texinfoファイルは%(outdir)sにあります。" + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nmakeinfo コマンドで処理するため、そのディレクトリで 'make' を実行してください。\n(これを自動的に行うには、ここで 'make info' を使用してください)。" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "設定値 \"texinfo_documents\" が見つかりません。ドキュメントは書き込まれません" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "ビルダークラス %s には\"name\"属性がありません" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "設定値 \"texinfo_documents\" は、不明なドキュメント %s を参照しています" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "ビルダー %r (モジュール %s) がすでに登録されています" +msgid "processing %s" +msgstr "処理中 %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "ビルダー名 %s は登録されておらず、entry pointにもありません" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "書き込み中" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "ビルダー名 %s は登録されていません" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "参照を解決しています..." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "ドメイン %s はすでに登録されています" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (in " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "ドメイン %s はまだ登録されていません" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "画像をコピー中... " -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "ディレクティブ %r は既に%sドメインに登録されています" +msgid "cannot copy image file %r: %s" +msgstr "画像ファイル %r をコピーできません: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "ロール %r は既にドメイン%sに登録されています" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "Texinfo 関連ファイルをコピーしています" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "インデックス %r はすでに%sドメインに登録されています" +msgid "error writing file Makefile: %s" +msgstr "Makefile の書き込みエラー: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "object_type %r はすでに登録されています" +msgid "The manual pages are in %(outdir)s." +msgstr "マニュアルページは %(outdir)s にあります。" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "classref_type %r はすでに登録されています" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "設定値 \"man_pages\" が見つかりません。マニュアルページは書かれません" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r はすでに登録されています" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "設定値 \"man_pages\" が不明なドキュメント %s を参照しています" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "%r のsource_parserはすでに登録されています" +msgid "The HTML page is in %(outdir)s." +msgstr "HTML ページは%(outdir)sにあります。" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "%s のsource_parserは登録されていません" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "ドキュメントを1ページにまとめています" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "%r のTranslatorはすでに登録されています" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "追加のファイルを出力" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "add_node() のキーワード引数は (visit, depart) の形式で関数をタプルで指定してください: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "dummyビルダーはファイルを出力しません" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r はすでに登録されています" +msgid "The message catalogs are in %(outdir)s." +msgstr "メッセージカタログは%(outdir)sにあります。" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "math renderer %s はすでに登録されています" +msgid "building [%s]: " +msgstr "ビルド中 [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "拡張 %r はSphinxのバージョン%sでSphinxに統合されています。この拡張は無視されます。" +msgid "targets for %d template files" +msgstr "指定された %d 件のテンプレートファイル" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "元の例外:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "テンプレートの読み込み中..." -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "拡張 %s をimportできません" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "メッセージカタログを出力中... " -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "拡張 %r には setup() 関数がありません。これは本当にSphinx拡張ですか?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "上記の出力結果、または %(outdir)s /output.txt を見てエラーを確認してください" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "このプロジェクトで使われている拡張 %s はSphinx v%s 以降が必要なため、現在のバージョンではビルドできません。" +msgid "broken link: %s (%s)" +msgstr "リンクが切れています: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "拡張 %r のsetup()関数が、対応していないオブジェクトを返しました。Noneまたはメタデータ辞書を返してください" +msgid "Anchor '%s' not found" +msgstr "アンカー '%s' が見つかりません" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" -msgstr "" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "linkcheck_allowed_redirects 内の正規表現のコンパイルに失敗しました: %r %s" -#: roles.py:251 +#: builders/epub3.py:83 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +msgid "The ePub file is in %(outdir)s." +msgstr "ePubファイルは%(outdir)sにあります。" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" -msgstr "" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "nav.xhtml を書き込み中..." -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "EPUB3出力では設定値 \"epub_language\" (あるいは \"language\") の指定が必要です" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" -msgstr "無効なPEP番号 %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "EPUB3では設定値 \"epub_uid\" はXML NAMEにするべきです" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" -msgstr "無効なRFC番号 %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "EPUB3出力では設定値 \"epub_title\" (あるいは \"html_title\") の指定が必要です" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[ソース]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "EPUB3出力では設定値 \"epub_author\" の指定が必要です" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "モジュールコードをハイライトしています..." +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "EPUB3出力では設定値 \"epub_contributor\" が必要です" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[ドキュメント]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "EPUB3出力では設定値 \"epub_description\" が必要です" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "モジュールコード" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "EPUB3出力では設定値 \"epub_publisher\" の指定が必要です" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        %s のソースコード

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "EPUB3出力では設定値 \"epub_copyright\" (あるいは \"copyright\") の指定が必要です" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "概要: モジュールコード" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "EPUB3出力では設定値 \"epub_identifier\" の指定が必要です" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        全モジュールのうち、コードを読めるもの

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "EPUB3出力では設定値 \"version\" が必要です" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "ハードコードされたリンク %r は 拡張リンクに置き換えられる可能性があります (代わりに %r を使用してみてください)。" +msgid "invalid css_file: %r, ignored" +msgstr "無効な css_file %r は無視されました" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "" +msgid "The XML files are in %(outdir)s." +msgstr "XMLファイルは%(outdir)sにあります。" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "ラベル %s はすでに %s で使われています" - -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "" +msgid "error writing file %s: %s" +msgstr "ファイル書き込みエラー %s: %s" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "====================== 最も遅い読み取り時間 =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "pseudo-XMLファイルは%(outdir)sにあります。" -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "'%s' オプション内に '+' または '-' が不足しています" +msgid "duplicated ToC entry found: %s" +msgstr "Tocエントリーが重複しています: %s" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' は正しいオプションではありません" +msgid "cannot read image file %r: copying it instead" +msgstr "画像ファイル %r をPILで読み込めないため、そのままコピーします" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' は正しい pyversion オプションではありません" +msgid "cannot write image file %r: %s" +msgstr "画像ファイル %r を書き込めません: %s" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "無効な TestCode タイプ" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillowがインストールされていません。代わりに画像をコピーします" -#: ext/doctest.py:297 +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "mimetype を書き込み中..." + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "META-INF/container.xml を書き込み中..." + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "content.opf を書き込み中..." + +#: builders/_epub_base.py:594 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "ソース内の doctests のテストが終了したら、%(outdir)s/output.txt の結果を確認してください。" +msgid "unknown mimetype for %s, ignoring" +msgstr "不明なmimetype %sのため無視します" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "tox.ncx を書き込み中..." -#: ext/doctest.py:457 +#: builders/_epub_base.py:802 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "%sブロックにあるコード/出力 が %s にありません: %s" +msgid "writing %s file..." +msgstr "ファイル %s を書き込み中..." -#: ext/doctest.py:568 +#: builders/text.py:27 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "無効な doctest コードは無視されます: %r" +msgid "The text files are in %(outdir)s." +msgstr "テキストファイルは%(outdir)sにあります。" -#: ext/imgmath.py:162 +#: builders/__init__.py:229 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "LaTeX コマンド %r を実行できません (数式表示のために必要です)。imgmath_latex の設定を確認してください" +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "%sビルダー向けの画像形式が見つかりません: %s (%s)" -#: ext/imgmath.py:181 +#: builders/__init__.py:237 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%s コマンド %r を実行できません (数式表示のために必要です)。imgmath_%s の設定を確認してください" +msgid "a suitable image for %s builder not found: %s" +msgstr "%sビルダー向けの画像形式が見つかりません: %s" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "ビルド中 [mo]: " -#: ext/imgmath.py:344 +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "出力中..." + +#: builders/__init__.py:280 #, python-format -msgid "display latex %r: %s" -msgstr "latex の表示 %r: %s" +msgid "all of %d po files" +msgstr "全%d件のpoファイル" -#: ext/imgmath.py:380 +#: builders/__init__.py:302 #, python-format -msgid "inline latex %r: %s" -msgstr "latex のインライン表示 %r: %s" +msgid "targets for %d po files that are specified" +msgstr "指定された %d 件のpoファイル" -#: ext/coverage.py:48 +#: builders/__init__.py:314 #, python-format -msgid "invalid regex %r in %s" -msgstr "無効な正規表現 %r が %s 内に見つかりました" +msgid "targets for %d po files that are out of date" +msgstr "更新された %d 件のpoファイル" -#: ext/coverage.py:140 ext/coverage.py:301 +#: builders/__init__.py:324 +msgid "all source files" +msgstr "全てのソースファイル" + +#: builders/__init__.py:335 #, python-format -msgid "module %s could not be imported: %s" -msgstr "モジュール %s をインポートできませんでした: %s" +msgid "file %r given on command line does not exist, " +msgstr "コマンドラインに指定されたファイル %r がないため, " -#: ext/coverage.py:148 +#: builders/__init__.py:342 #, python-format msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "コマンドラインに指定されたファイル %r はソースディレクトリ以下にないため無視されます" -#: ext/coverage.py:158 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/coverage.py:172 -#, python-brace-format, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." -msgstr "" +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "コマンドラインで指定された%d件のソースファイル" -#: ext/coverage.py:187 +#: builders/__init__.py:382 #, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "coverage_c_regexes 内に無効な正規表現 %r があります" +msgid "targets for %d source files that are out of date" +msgstr "更新された %d 件のソースファイル" -#: ext/coverage.py:260 +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "更新されたファイルを探しています... " + +#: builders/__init__.py:415 #, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "" +msgid "%d found" +msgstr "%d 件見つかりました" -#: ext/coverage.py:452 +#: builders/__init__.py:417 +msgid "none found" +msgstr "見つかりませんでした" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "環境データを保存中" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "整合性をチェック中" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "更新が必要な対象はありませんでした" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "環境データを更新中" + +#: builders/__init__.py:499 #, python-format -msgid "undocumented python function: %s :: %s" -msgstr "" +msgid "%s added, %s changed, %s removed" +msgstr "%s 件追加, %s 件更新, %s 件削除" -#: ext/coverage.py:473 +#: builders/__init__.py:536 #, python-format -msgid "undocumented python class: %s :: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/coverage.py:492 +#: builders/__init__.py:545 #, python-format -msgid "undocumented python method: %s :: %s :: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgconverter.py:44 +#: builders/__init__.py:556 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: builders/__init__.py:563 #, python-format msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "変換処理はエラー終了しました:\n[stderr]\n%r\n[stdout]\n%r" - +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "ソースを読み込み中..." + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "書き込むdocname: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "ドキュメントの出力準備中" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "ファイルは%(outdir)sにあります" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "バージョン %s での変更はありません" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "概要ファイルを書き出し中..." + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "組み込み" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "モジュールレベル" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "ソースファイルをコピー中..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "Changelog作成中に %r を読み込めませんでした" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "無効な正規表現 %r が %s 内に見つかりました" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "モジュール %s をインポートできませんでした: %s" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "" + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "coverage_c_regexes 内に無効な正規表現 %r があります" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "ハードコードされたリンク %r は 拡張リンクに置き換えられる可能性があります (代わりに %r を使用してみてください)。" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "課題" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "TODO エントリーが見つかりました: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<> は、 %s の %d 行目です)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "元のエントリ" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "変換処理はエラー終了しました:\n[stderr]\n%r\n[stdout]\n%r" + #: ext/imgconverter.py:83 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" @@ -879,879 +1344,960 @@ msgstr "[グラフ: %s]" msgid "[graph]" msgstr "[グラフ]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "課題" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "LaTeX コマンド %r を実行できません (数式表示のために必要です)。imgmath_latex の設定を確認してください" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" -msgstr "TODO エントリーが見つかりました: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s コマンド %r を実行できません (数式表示のために必要です)。imgmath_%s の設定を確認してください" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "latex の表示 %r: %s" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<> は、 %s の %d 行目です)" +msgid "inline latex %r: %s" +msgstr "latex のインライン表示 %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "元のエントリ" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "デデントによる空白の除去" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "'%s' オプション内に '+' または '-' が不足しています" -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" -msgstr "不正な caption です: %s" +msgid "'%s' is not a valid option." +msgstr "'%s' は正しいオプションではありません" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "行番号の指定が範囲外です (1-%d): %r" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' は正しい pyversion オプションではありません" -#: directives/code.py:216 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "無効な TestCode タイプ" + +#: ext/doctest.py:297 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "\"%s\" と \"%s\" のオプションは同時に使用できません" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "ソース内の doctests のテストが終了したら、%(outdir)s/output.txt の結果を確認してください。" -#: directives/code.py:231 +#: ext/doctest.py:451 #, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "" +msgid "no code/output in %s block at %s:%s" +msgstr "%sブロックにあるコード/出力 が %s にありません: %s" -#: directives/code.py:235 +#: ext/doctest.py:568 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +msgid "ignoring invalid doctest code: %r" +msgstr "無効な doctest コードは無視されます: %r" -#: directives/code.py:276 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "%r という名前のオブジェクトがインクルードファイル %r 内に見つかりません" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr " \"lineno-match\" は不連続な \"lines\" に対して使用できません" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "ラベル %s はすでに %s で使われています" -#: directives/code.py:314 +#: ext/duration.py:47 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "指定された %r に一致する行がインクルードファイル %r にありませんでした" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" -#: directives/patches.py:71 +#: ext/duration.py:117 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "csv-table ディレクティブの \":file:\" オプションは、絶対パスをソースディレクトリからの相対パスとして認識するようになりました。ドキュメントを更新してください。" +"====================== total reading duration ==========================" +msgstr "" -#: directives/other.py:119 +#: ext/duration.py:124 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "toctree グローブ・パターン %r はどのドキュメントにもマッチしませんでした。" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "toctree に除外したドキュメントへの参照が含まれています %r" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "====================== 最も遅い読み取り時間 =======================" -#: directives/other.py:156 +#: ext/duration.py:139 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "toctree に存在しないドキュメントへの参照が含まれています %r" +msgid "%.3fs %s" +msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "toctree で重複したエントリが見つかりました: %s" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[ソース]" -#: directives/other.py:203 -msgid "Section author: " -msgstr "この節の作者: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "モジュールコードをハイライトしています..." -#: directives/other.py:205 -msgid "Module author: " -msgstr "モジュールの作者: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[ドキュメント]" -#: directives/other.py:207 -msgid "Code author: " -msgstr "コードの作者: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "モジュールコード" -#: directives/other.py:209 -msgid "Author: " -msgstr "作者: " +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        %s のソースコード

        " -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "概要: モジュールコード" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        全モジュールのうち、コードを読めるもの

        " -#: builders/changes.py:29 +#: domains/citation.py:75 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "ファイルは%(outdir)sにあります" +msgid "duplicate citation %s, other instance in %s" +msgstr "引用 %s はすでに %s で使われています" -#: builders/changes.py:56 +#: domains/citation.py:92 #, python-format -msgid "no changes in version %s." -msgstr "バージョン %s での変更はありません" - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "概要ファイルを書き出し中..." - -#: builders/changes.py:70 -msgid "Builtins" -msgstr "組み込み" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "モジュールレベル" - -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "ソースファイルをコピー中..." +msgid "Citation [%s] is not referenced." +msgstr "引用 [%s] は参照されていません。" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" -msgstr "Changelog作成中に %r を読み込めませんでした" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "数式 %s のラベルはすでに %s で使われています" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "マニュアルページは %(outdir)s にあります。" +msgid "Invalid math_eqref_format: %r" +msgstr "無効な math_eqref_format: %r" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "設定値 \"man_pages\" が見つかりません。マニュアルページは書かれません" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (組み込み関数)" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "書き込み中" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s のメソッド)" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "設定値 \"man_pages\" が不明なドキュメント %s を参照しています" +msgid "%s() (class)" +msgstr "%s() (クラス)" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "%sビルダー向けの画像形式が見つかりません: %s (%s)" +msgid "%s (global variable or constant)" +msgstr "%s (グローバル変数または定数)" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "%sビルダー向けの画像形式が見つかりません: %s" +msgid "%s (%s attribute)" +msgstr "%s (%s の属性)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "ビルド中 [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "引数" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "出力中..." +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "例外" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" -msgstr "全%d件のpoファイル" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "戻り値" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" -msgstr "指定された %d 件のpoファイル" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "戻り値の型" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "更新された %d 件のpoファイル" +msgid "%s (module)" +msgstr "%s (モジュール)" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "全てのソースファイル" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "の関数" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " -msgstr "コマンドラインに指定されたファイル %r がないため, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "メソッド" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "コマンドラインに指定されたファイル %r はソースディレクトリ以下にないため無視されます" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "クラス" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "データ" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "コマンドラインで指定された%d件のソースファイル" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "の属性" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "更新された %d 件のソースファイル" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "モジュール" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " -msgstr "ビルド中 [%s]: " - -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "更新されたファイルを探しています... " +msgid "duplicate %s description of %s, other %s in %s" +msgstr "%s の記述 %s はすでに %s で %s が使われています" -#: builders/__init__.py:410 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "%d found" -msgstr "%d 件見つかりました" +msgid "%s (directive)" +msgstr "%s (ディレクティブ)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "見つかりませんでした" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr ":%s: (ディレクティブオプション)" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "環境データを保存中" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (ロール)" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "整合性をチェック中" +#: domains/rst.py:234 +msgid "directive" +msgstr "ディレクティブ" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "更新が必要な対象はありませんでした" +#: domains/rst.py:235 +msgid "directive-option" +msgstr "ディレクティブオプション" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "環境データを更新中" +#: domains/rst.py:236 +msgid "role" +msgstr "ロール" -#: builders/__init__.py:494 +#: domains/rst.py:262 #, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s 件追加, %s 件更新, %s 件削除" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "%s の記述 %s はすでに %s で使われています" -#: builders/__init__.py:531 +#: domains/changeset.py:32 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "Changed in version %s" +msgstr "バージョン %s で変更" -#: builders/__init__.py:551 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "" +msgid "Deprecated since version %s" +msgstr "バージョン %s で非推奨" -#: builders/__init__.py:558 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "ソースを読み込み中..." - -#: builders/__init__.py:713 +#: domains/__init__.py:322 #, python-format -msgid "docnames to write: %s" -msgstr "書き込むdocname: %s" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "ジョブ番号は正数でなければなりません" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "ドキュメントの出力準備中" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "詳しくは、を見てください。" -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nソースファイルからドキュメントを生成します。\n\nsphinx-build は、SOURCEDIR 内のファイルをもとにドキュメントを生成し、\nOUTPUTDIR 内に配置します。またコンフィグ\n設定用に SOURCEDIR 内から\n 'conf.py' を探します。'sphinx-quickstart' ツールを使うと\n 'conf.py' を含むテンプレートファイルを生成することができます。\n\nsphinx-build は、さまざまな形式のドキュメントを作成することができます。フォーマットは、\nコマンドラインでビルダー名を指定して選択します。デフォルトは\nHTML です。ビルダーはドキュメント化処理に関連した他のタスクも実行できます。\n\nデフォルトでは、古いものはすべてビルドされています。個別にファイル名を指定することで、\n選択したファイルのみ出力することもできます。\n" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "デコードできないソース文字です。\"?\" に置き換えます: %r" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "ドキュメントソースファイルへのパス" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "ePubファイルは%(outdir)sにあります。" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "出力先ディレクトリへのパス" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "nav.xhtml を書き込み中..." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "EPUB3出力では設定値 \"epub_language\" (あるいは \"language\") の指定が必要です" +#: cmd/build.py:114 +msgid "general options" +msgstr "一般的なオプション" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "EPUB3では設定値 \"epub_uid\" はXML NAMEにするべきです" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "EPUB3出力では設定値 \"epub_title\" (あるいは \"html_title\") の指定が必要です" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "EPUB3出力では設定値 \"epub_author\" の指定が必要です" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "すべてのファイルに書き込む(デフォルト: 新規ファイルまたは変更されたファイルのみ)" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "EPUB3出力では設定値 \"epub_contributor\" が必要です" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "保存された環境は使わず、常に全てのファイルを読み込む" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "EPUB3出力では設定値 \"epub_description\" が必要です" +#: cmd/build.py:150 +msgid "path options" +msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "EPUB3出力では設定値 \"epub_publisher\" の指定が必要です" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "EPUB3出力では設定値 \"epub_copyright\" (あるいは \"copyright\") の指定が必要です" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "EPUB3出力では設定値 \"epub_identifier\" の指定が必要です" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "EPUB3出力では設定値 \"version\" が必要です" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "設定ファイルの設定を上書きする" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "無効な css_file %r は無視されました" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "HTMLテンプレートに値を渡す" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "XMLファイルは%(outdir)sにあります。" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "定義タグ: TAG ブロック\"のみ\"含む" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "ファイル書き込みエラー %s: %s" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "pseudo-XMLファイルは%(outdir)sにあります。" +#: cmd/build.py:212 +msgid "console output options" +msgstr "コンソール出力オプション" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Texinfoファイルは%(outdir)sにあります。" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "精度の増加(繰り返し可能)" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nmakeinfo コマンドで処理するため、そのディレクトリで 'make' を実行してください。\n(これを自動的に行うには、ここで 'make info' を使用してください)。" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "標準出力には出力せず、標準エラー出力に警告を出すのみ" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "設定値 \"texinfo_documents\" が見つかりません。ドキュメントは書き込まれません" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "何も出力せず、警告もしない" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "設定値 \"texinfo_documents\" は、不明なドキュメント %s を参照しています" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "色分けで出力する(デフォルト:自動検出)" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "処理中 %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "色分けの出力をしない(デフォルト:自動検出)" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "参照を解決しています..." +#: cmd/build.py:252 +msgid "warning control options" +msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "指定ファイルに警告(およびエラー)を書き込む" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "画像をコピー中... " +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "警告をエラーとして扱う" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "画像ファイル %r をコピーできません: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "例外時にフルトレースバックを表示する" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "Texinfo 関連ファイルをコピーしています" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "例外が発生したときにPdbを実行する" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "Makefile の書き込みエラー: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "Tocエントリーが重複しています: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "-aオプションとファイル名を組み合わせることはできません" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "画像ファイル %r をPILで読み込めないため、そのままコピーします" +msgid "cannot open warning file '%s': %s" +msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "画像ファイル %r を書き込めません: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "-Dオプション引数は name = value の形式でなければなりません" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Pillowがインストールされていません。代わりに画像をコピーします" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "-Aオプション引数は name = value の形式でなければなりません" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "mimetype を書き込み中..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "モジュールから自動的に docstring を挿入する" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "META-INF/container.xml を書き込み中..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "doctest ブロック内のコードスニペットを自動的にテストする" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "content.opf を書き込み中..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "異なるプロジェクトのSphinxドキュメント間のリンク" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "不明なmimetype %sのため無視します" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "ビルド時に表示または非表示にできる \"todo\" エントリを書く" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "ドキュメントの適用範囲を確認する" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "tox.ncx を書き込み中..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "PNG または SVG 画像としてレンダリングされた数学を含む" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "ファイル %s を書き込み中..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "MathJax によってブラウザにレンダリングされた数学を含む" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "dummyビルダーはファイルを出力しません" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "設定値に基づくコンテンツの条件付き包含" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "メッセージカタログは%(outdir)sにあります。" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "文書化された Python オブジェクトのソースコードへのリンクを含める" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "指定された %d 件のテンプレートファイル" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "GitHub ページにドキュメントを公開するための .nojekyll ファイルを作成する" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "テンプレートの読み込み中..." +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "有効なパス名を入力してください。" -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "メッセージカタログを出力中... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "何か入力してください。" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "HTML ページは%(outdir)sにあります。" +msgid "Please enter one of %s." +msgstr "%sのいずれかを入力してください。 " -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "ドキュメントを1ページにまとめています" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "'y' または 'n' を入力してください。" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "追加のファイルを出力" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "ファイルの拡張子を入力してください。例: '.rst' または '.txt'。" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "上記の出力結果、または %(outdir)s /output.txt を見てエラーを確認してください" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Sphinx %s クイックスタートユーティリティへようこそ。" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "リンクが切れています: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "以下の設定値を入力してください(Enter キーのみ押した場合、\nかっこで囲まれた値をデフォルト値として受け入れます)。" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" -msgstr "アンカー '%s' が見つかりません" +msgid "Selected root path: %s" +msgstr "選択されたルートパス: %s" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "linkcheck_allowed_redirects 内の正規表現のコンパイルに失敗しました: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "ドキュメントのルートパスを入力してください。" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "テキストファイルは%(outdir)sにあります。" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "ドキュメントのルートパス" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "翻訳されたメッセージの footnote 参照が矛盾しています。原文: {0}、翻訳: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "エラー:選択されたルートパスに既存の conf.py が見つかりました。" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "翻訳されたメッセージの参照が矛盾しています。原文: {0}、翻訳: {1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart は、既存の Sphinx プロジェクトを上書きしません。" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "翻訳されたメッセージの引用参照が矛盾しています。原文: {0}、翻訳: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "新しいルートパスを入力してください(または Enter を押すことで終了します)。" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "翻訳されたメッセージの用語参照が矛盾しています。原文: {0}、翻訳: {1}" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%Y年%m月%d日" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Sphinx 出力用のビルドディレクトリを配置する方法は2つあります。\nルートパス内にある \"_build\" ディレクトリを使うか、\nルートパス内に \"source\" と \"build\" ディレクトリを分ける方法です。" -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "ソースディレクトリとビルドディレクトリを分ける(y / n)" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "4列ベースのインデックスが見つかりました。あなたが使っている拡張子のバグかもしれません: %r" - -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "Footnote [%s] は参照されていません。" - -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "プロジェクトのルートディレクトリに 2つ以上のディレクトリが作成されます。\nカスタマイズしたHTMLテンプレート用の\"_templates\"ディレクトリと、カスタマイズしたスタイルシート等を置く\"_static\"ディレクトリがあります。\nこれらのディレクトリは \"_\" で始まっていますが、別の文字(\".\"など)で始まるように指定できます。" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "Footnote [#] は参照されていません。" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "テンプレートと静的ディレクトリの名前プレフィックス" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "プロジェクト名は、ビルドされたドキュメントのいくつかの場所にあります。" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "プロジェクト名" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "著者名(複数可)" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx には、ソフトウェアに対して \"バージョン\" と \"リリース\" という概念が\nあります。各バージョンは複数のリリースを持つことができます。\n例えば、Python だとバージョンが 2.5 や 3.0 のように分かれているように、\nリリースも 2.5.1 や 3.0a1 のように分けて持つことができます。もしこのような多重構成が必要ない場合は、\n両方を同じ値に設定するだけです。" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "オプション" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "プロジェクトのバージョン" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "プロジェクトのリリース" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "ドキュメントを英語以外の言語で書く場合は、\n 言語コードで言語を選択できます。Sphinx は生成したテキストをその言語に翻訳します。\n\nサポートされているコードのリストについては、\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language を参照してください。" -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "プロジェクトの言語" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "ソースファイルのファイル名の拡張子。一般的には、\".txt\"または\".rst \"のどちらかです。この拡張子を持つファイルだけがドキュメントとみなされます。" -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "ソース・ファイルサフィックス" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "1つのドキュメントは、\"コンテンツツリー\"の最上位ノードと\n見なされるという点で特別です。つまり、それはドキュメントにおける階層構造のルートである\nということです。通常、これは \"index\" ですが、\n\"index\" ドキュメントがカスタムテンプレートの場合、これを別のファイル名に設定することもできます。" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "マスター文書の名前(拡張子を除く)" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "エラー:マスタファイル %s は、選択されたルートパス上で既に存在します。" -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart は既存のファイルを上書きしません。" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "新しいファイル名を入力するか、既存のファイルの名前を変更してEnterキーを押してください。" -#: environment/__init__.py:86 -msgid "new config" -msgstr "新しい設定" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "次の Sphinx 拡張機能のうちどれを有効にするかを指定します。" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "変更された設定" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "注:imgmath と mathjax を同時に有効にすることはできません。 imgmath は未選択になります。" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "変更された拡張" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Makefile と Windows コマンドファイルは生成することができるので、\n後は実行するだけです。例えば、直接 sphinx-build を実行する代わりに `make html` を\n実行します。" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "ビルド環境のバージョンが最新ではありません" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Makefile を作成しますか? (y/n)" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "ソースディレクトリが変更されました" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Windows コマンドファイルを作成しますか?(y/n)" -#: environment/__init__.py:325 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +msgid "Creating file %s." +msgstr "ファイル %s を作成しています。" -#: environment/__init__.py:330 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" +msgid "File %s already exists, skipping." +msgstr "ファイル %s は既に存在しますのでスキップします。" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "終了:初期ディレクトリ構造が作成されました。" -#: environment/__init__.py:379 +#: cmd/quickstart.py:520 +#, python-format msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "この環境は選択したビルダーと互換性がありません。別の doctree ディレクトリーを選択してください。" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "マスターファイル %s を作成して\n他のドキュメントソースファイルを作成します。" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "%s のドキュメントをスキャンできませんでした: %r " +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "次のように Makefile を使ってドキュメントを作成します。\n make builder" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 +#: cmd/quickstart.py:531 #, python-format -msgid "Domain %r is not registered" -msgstr "ドメイン %r はまだ登録されていません" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "ドキュメントはどの toctree にも含まれていません" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "次のように、ドキュメントを構築するには sphinx-build コマンドを使用してください。\n sphinx-build -b builder %s %s" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "自己参照している toctree が見つかりました。無視します。" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "\"builder\" はサポートされているビルダーの 1 つです。 例: html, latex, または linkcheck。" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nSphinx プロジェクトに必要なファイルを生成します。\n\nsphinx-quickstart は、いくつかの質問であなたの\nプロジェクトを生成するためのディレクトリと、sphinx-build と一緒に使える\nサンプルのMakefileを作成してくれるインタラクティブなツールです。\n" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "読み取りエラー: %s, %s" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "Quiet モード" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "書き込みエラー: %s, %s" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "project root" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "構成オプション" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "記述した場合、ソースとビルドのディレクトリを分割します。" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "日付形式が無効です。直接出力したい場合は、文字列を一重引用符で囲みます: %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "指定された場合、ソースディレクトリの下にビルドディレクトリを作成します。" -#: util/docfields.py:103 +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "_templates などのドットの置き換え" + +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "プロジェクトの基本オプション" + +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "プロジェクト名" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "著者名" + +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "プロジェクトのバージョン" + +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "プロジェクトのリリース" + +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "ドキュメント言語" + +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "ソース・ファイルサフィックス" + +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "マスタードキュメント名" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "epubを利用する" + +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "拡張オプション" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "%s 拡張を有効にする" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "任意の拡張を有効にする" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Makefileとbatファイルの生成オプション" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "makefileを作成する" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "makefileを作成しない" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "batファイルを作成する" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "batファイルを作成しない" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "Makefile / make.bat 向けに make-mode を使う" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "プロジェクトテンプレート" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "テンプレートファイルのテンプレートディレクトリ" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "テンプレート変数の定義" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "\"quiet\" が指定されていますが、 \"project\" または \"author\" のいずれも指定されていません。" + +#: cmd/quickstart.py:786 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "エラー:指定されたパスはディレクトリではないか、または sphinx ファイルが既に存在します。" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart は空のディレクトリにのみ生成します。新しいルートパスを指定してください。" -#: util/nodes.py:490 +#: cmd/quickstart.py:810 #, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "toctree に存在しないファイルへの参照が含まれています %r" +msgid "Invalid template variable: %s" +msgstr "無効なテンプレート変数: %s" -#: util/nodes.py:706 +#: directives/other.py:119 #, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "only ディレクティブの条件式の評価中に例外が発生しました: %s" - -#: util/display.py:82 -msgid "skipped" -msgstr "スキップしました" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "toctree グローブ・パターン %r はどのドキュメントにもマッチしませんでした。" -#: util/display.py:87 -msgid "failed" -msgstr "失敗しました" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" +msgstr "toctree に除外したドキュメントへの参照が含まれています %r" -#: util/osutil.py:131 +#: directives/other.py:156 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +msgid "toctree contains reference to nonexisting document %r" +msgstr "toctree に存在しないドキュメントへの参照が含まれています %r" -#: util/docutils.py:309 +#: directives/other.py:169 #, python-format -msgid "unknown directive name: %s" +msgid "duplicated entry found in toctree: %s" +msgstr "toctree で重複したエントリが見つかりました: %s" + +#: directives/other.py:203 +msgid "Section author: " +msgstr "この節の作者: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "モジュールの作者: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "コードの作者: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "作者: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" -msgstr "不明なノードタイプ: %r" +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "csv-table ディレクティブの \":file:\" オプションは、絶対パスをソースディレクトリからの相対パスとして認識するようになりました。ドキュメントを更新してください。" -#: util/fileutil.py:76 +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "デデントによる空白の除去" + +#: directives/code.py:87 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +msgid "Invalid caption: %s" +msgstr "不正な caption です: %s" -#: util/fileutil.py:89 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +msgid "line number spec is out of range(1-%d): %r" +msgstr "行番号の指定が範囲外です (1-%d): %r" -#: util/rst.py:73 +#: directives/code.py:216 #, python-format -msgid "default role %s not found" -msgstr "デフォルトのロール %s が見つかりません" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "\"%s\" と \"%s\" のオプションは同時に使用できません" -#: util/inventory.py:147 +#: directives/code.py:231 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/inventory.py:166 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "注記" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "%r という名前のオブジェクトがインクルードファイル %r 内に見つかりません" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr " \"lineno-match\" は不連続な \"lines\" に対して使用できません" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" -msgstr "[画像: %s]" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "指定された %r に一致する行がインクルードファイル %r にありませんでした" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[画像]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%Y年%m月%d日" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1760,11 +2306,15 @@ msgstr "[画像]" msgid "Index" msgstr "索引" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "セクション、トピック、表、訓戒またはサイドバーにないタイトルノードが見つかりました。" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "注記" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "キャプションは図の中にはありません。" @@ -1774,59 +2324,20 @@ msgstr "キャプションは図の中にはありません。" msgid "unimplemented node type: %r" msgstr "未実装のノードタイプ: %r" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "不明なクラス %r の toplevel_sectioning %r" - -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "no Babel option known for language %r" -msgstr "%r 言語向けの 既知の Babel オプションはありません" +msgid "[image: %s]" +msgstr "[画像: %s]" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr ":maxdepth: が大きすぎるので無視されます。" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[画像]" -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "ドキュメントのタイトルは、単一の Text ノードではありません" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "tabularcolumns と :widths: オプションの両方が設定されています。:widths: は無視されます。" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "ディメンション単位 %s が無効です。無視されます。" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "不明なインデックスエントリタイプ %s が見つかりました" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "無効な math_eqref_format: %r" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 +#: writers/html5.py:431 #, python-format msgid "numfig_format is not defined for %s" msgstr "%s に numfig_format は定義されていません" @@ -1848,6 +2359,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1864,794 +2380,478 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "画像サイズを取得できませんでした。:scale: オプションは無視されます。" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "数式 %s のラベルはすでに %s で使われています" - -#: domains/javascript.py:182 +#: writers/latex.py:386 #, python-format -msgid "%s() (built-in function)" -msgstr "%s() (組み込み関数)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s のメソッド)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (クラス)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (グローバル変数または定数)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s の属性)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "引数" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "例外" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "戻り値" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "戻り値の型" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "不明なクラス %r の toplevel_sectioning %r" -#: domains/javascript.py:370 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "%s (module)" -msgstr "%s (モジュール)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "の関数" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "メソッド" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "クラス" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "データ" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "の属性" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "モジュール" +msgid "no Babel option known for language %r" +msgstr "%r 言語向けの 既知の Babel オプションはありません" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "%s の記述 %s はすでに %s で %s が使われています" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":maxdepth: が大きすぎるので無視されます。" -#: domains/changeset.py:26 +#: writers/latex.py:616 #, python-format -msgid "Added in version %s" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "バージョン %s で変更" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "ドキュメントのタイトルは、単一の Text ノードではありません" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "バージョン %s で非推奨" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "tabularcolumns と :widths: オプションの両方が設定されています。:widths: は無視されます。" -#: domains/changeset.py:29 +#: writers/latex.py:1228 #, python-format -msgid "Removed in version %s" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (ディレクティブ)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (ディレクティブオプション)" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (ロール)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "ディレクティブ" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "ディレクティブオプション" - -#: domains/rst.py:236 -msgid "role" -msgstr "ロール" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "%s の記述 %s はすでに %s で使われています" - -#: domains/citation.py:75 +#: writers/latex.py:1615 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "引用 %s はすでに %s で使われています" - -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "引用 [%s] は参照されていません。" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "注意" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "注意" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "危険" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "エラー" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "ヒント" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "重要" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "注釈" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "参考" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tip" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "警告" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "モジュールから自動的に docstring を挿入する" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "doctest ブロック内のコードスニペットを自動的にテストする" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "異なるプロジェクトのSphinxドキュメント間のリンク" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "ビルド時に表示または非表示にできる \"todo\" エントリを書く" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "ドキュメントの適用範囲を確認する" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "PNG または SVG 画像としてレンダリングされた数学を含む" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "MathJax によってブラウザにレンダリングされた数学を含む" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "設定値に基づくコンテンツの条件付き包含" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "文書化された Python オブジェクトのソースコードへのリンクを含める" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "GitHub ページにドキュメントを公開するための .nojekyll ファイルを作成する" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "有効なパス名を入力してください。" - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "何か入力してください。" - -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "%sのいずれかを入力してください。 " - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "'y' または 'n' を入力してください。" - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "ファイルの拡張子を入力してください。例: '.rst' または '.txt'。" - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Sphinx %s クイックスタートユーティリティへようこそ。" - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "以下の設定値を入力してください(Enter キーのみ押した場合、\nかっこで囲まれた値をデフォルト値として受け入れます)。" +msgid "dimension unit %s is invalid. Ignored." +msgstr "ディメンション単位 %s が無効です。無視されます。" -#: cmd/quickstart.py:241 +#: writers/latex.py:1950 #, python-format -msgid "Selected root path: %s" -msgstr "選択されたルートパス: %s" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "ドキュメントのルートパスを入力してください。" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "ドキュメントのルートパス" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "エラー:選択されたルートパスに既存の conf.py が見つかりました。" - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart は、既存の Sphinx プロジェクトを上書きしません。" - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "新しいルートパスを入力してください(または Enter を押すことで終了します)。" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Sphinx 出力用のビルドディレクトリを配置する方法は2つあります。\nルートパス内にある \"_build\" ディレクトリを使うか、\nルートパス内に \"source\" と \"build\" ディレクトリを分ける方法です。" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "ソースディレクトリとビルドディレクトリを分ける(y / n)" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "プロジェクトのルートディレクトリに 2つ以上のディレクトリが作成されます。\nカスタマイズしたHTMLテンプレート用の\"_templates\"ディレクトリと、カスタマイズしたスタイルシート等を置く\"_static\"ディレクトリがあります。\nこれらのディレクトリは \"_\" で始まっていますが、別の文字(\".\"など)で始まるように指定できます。" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "テンプレートと静的ディレクトリの名前プレフィックス" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "プロジェクト名は、ビルドされたドキュメントのいくつかの場所にあります。" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "プロジェクト名" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "著者名(複数可)" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "Sphinx には、ソフトウェアに対して \"バージョン\" と \"リリース\" という概念が\nあります。各バージョンは複数のリリースを持つことができます。\n例えば、Python だとバージョンが 2.5 や 3.0 のように分かれているように、\nリリースも 2.5.1 や 3.0a1 のように分けて持つことができます。もしこのような多重構成が必要ない場合は、\n両方を同じ値に設定するだけです。" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "プロジェクトのバージョン" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "プロジェクトのリリース" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "ドキュメントを英語以外の言語で書く場合は、\n 言語コードで言語を選択できます。Sphinx は生成したテキストをその言語に翻訳します。\n\nサポートされているコードのリストについては、\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language を参照してください。" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "プロジェクトの言語" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "ソースファイルのファイル名の拡張子。一般的には、\".txt\"または\".rst \"のどちらかです。この拡張子を持つファイルだけがドキュメントとみなされます。" +msgid "unknown index entry type %s found" +msgstr "不明なインデックスエントリタイプ %s が見つかりました" -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "ソース・ファイルサフィックス" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "1つのドキュメントは、\"コンテンツツリー\"の最上位ノードと\n見なされるという点で特別です。つまり、それはドキュメントにおける階層構造のルートである\nということです。通常、これは \"index\" ですが、\n\"index\" ドキュメントがカスタムテンプレートの場合、これを別のファイル名に設定することもできます。" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "マスター文書の名前(拡張子を除く)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "エラー:マスタファイル %s は、選択されたルートパス上で既に存在します。" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart は既存のファイルを上書きしません。" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "オプション" + +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: cmd/quickstart.py:377 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "新しいファイル名を入力するか、既存のファイルの名前を変更してEnterキーを押してください。" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "次の Sphinx 拡張機能のうちどれを有効にするかを指定します。" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "注:imgmath と mathjax を同時に有効にすることはできません。 imgmath は未選択になります。" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Makefile と Windows コマンドファイルは生成することができるので、\n後は実行するだけです。例えば、直接 sphinx-build を実行する代わりに `make html` を\n実行します。" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Makefile を作成しますか? (y/n)" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Windows コマンドファイルを作成しますか?(y/n)" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." -msgstr "ファイル %s を作成しています。" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "ファイル %s は既に存在しますのでスキップします。" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "終了:初期ディレクトリ構造が作成されました。" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: cmd/quickstart.py:519 -#, python-format +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" + +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "マスターファイル %s を作成して\n他のドキュメントソースファイルを作成します。" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "翻訳されたメッセージの footnote 参照が矛盾しています。原文: {0}、翻訳: {1}" -#: cmd/quickstart.py:526 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "次のように Makefile を使ってドキュメントを作成します。\n make builder" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "翻訳されたメッセージの参照が矛盾しています。原文: {0}、翻訳: {1}" -#: cmd/quickstart.py:530 -#, python-format +#: transforms/i18n.py:325 +#, python-brace-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "次のように、ドキュメントを構築するには sphinx-build コマンドを使用してください。\n sphinx-build -b builder %s %s" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "翻訳されたメッセージの引用参照が矛盾しています。原文: {0}、翻訳: {1}" -#: cmd/quickstart.py:537 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "\"builder\" はサポートされているビルダーの 1 つです。 例: html, latex, または linkcheck。" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "翻訳されたメッセージの用語参照が矛盾しています。原文: {0}、翻訳: {1}" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" + +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" -#: cmd/quickstart.py:572 +#: transforms/__init__.py:258 +#, python-format msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nSphinx プロジェクトに必要なファイルを生成します。\n\nsphinx-quickstart は、いくつかの質問であなたの\nプロジェクトを生成するためのディレクトリと、sphinx-build と一緒に使える\nサンプルのMakefileを作成してくれるインタラクティブなツールです。\n" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "4列ベースのインデックスが見つかりました。あなたが使っている拡張子のバグかもしれません: %r" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "詳しくは、を見てください。" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "Footnote [%s] は参照されていません。" -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "Quiet モード" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "project root" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "Footnote [#] は参照されていません。" -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "構成オプション" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "記述した場合、ソースとビルドのディレクトリを分割します。" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "指定された場合、ソースディレクトリの下にビルドディレクトリを作成します。" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "読み取りエラー: %s, %s" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "_templates などのドットの置き換え" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "書き込みエラー: %s, %s" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "プロジェクトの基本オプション" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "プロジェクト名" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "著者名" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "日付形式が無効です。直接出力したい場合は、文字列を一重引用符で囲みます: %s" -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "プロジェクトのバージョン" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "プロジェクトのリリース" +#: util/display.py:82 +msgid "skipped" +msgstr "スキップしました" -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "ドキュメント言語" +#: util/display.py:87 +msgid "failed" +msgstr "失敗しました" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "ソース・ファイルサフィックス" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "マスタードキュメント名" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "epubを利用する" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "不明なノードタイプ: %r" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "拡張オプション" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" -#: cmd/quickstart.py:670 +#: util/fileutil.py:89 #, python-format -msgid "enable %s extension" -msgstr "%s 拡張を有効にする" +msgid "Writing evaluated template result to %s" +msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "任意の拡張を有効にする" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Makefileとbatファイルの生成オプション" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "デフォルトのロール %s が見つかりません" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "makefileを作成する" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "makefileを作成しない" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "toctree に存在しないファイルへの参照が含まれています %r" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "batファイルを作成する" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "only ディレクティブの条件式の評価中に例外が発生しました: %s" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "batファイルを作成しない" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "前のページからの続き" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "Makefile / make.bat 向けに make-mode を使う" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "次のページに続く" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "プロジェクトテンプレート" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "アルファベット以外" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "テンプレートファイルのテンプレートディレクトリ" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "記号" -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "テンプレート変数の定義" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "番号" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "\"quiet\" が指定されていますが、 \"project\" または \"author\" のいずれも指定されていません。" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "ページ" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "エラー:指定されたパスはディレクトリではないか、または sphinx ファイルが既に存在します。" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "リリース" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart は空のディレクトリにのみ生成します。新しいルートパスを指定してください。" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "リモート画像を取得できませんでした: %s [%s]" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "Invalid template variable: %s" -msgstr "無効なテンプレート変数: %s" +msgid "Could not fetch remote image: %s [%d]" +msgstr "リモート画像を取得できませんでした: %s [%d]" -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "ジョブ番号は正数でなければなりません" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "不明な画像フォーマット: %s..." -#: cmd/build.py:74 +#: transforms/post_transforms/__init__.py:88 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\nソースファイルからドキュメントを生成します。\n\nsphinx-build は、SOURCEDIR 内のファイルをもとにドキュメントを生成し、\nOUTPUTDIR 内に配置します。またコンフィグ\n設定用に SOURCEDIR 内から\n 'conf.py' を探します。'sphinx-quickstart' ツールを使うと\n 'conf.py' を含むテンプレートファイルを生成することができます。\n\nsphinx-build は、さまざまな形式のドキュメントを作成することができます。フォーマットは、\nコマンドラインでビルダー名を指定して選択します。デフォルトは\nHTML です。ビルダーはドキュメント化処理に関連した他のタスクも実行できます。\n\nデフォルトでは、古いものはすべてビルドされています。個別にファイル名を指定することで、\n選択したファイルのみ出力することもできます。\n" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "相互参照用のフォールバックテキストを決定できませんでした。バグかもしれません。" -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "ドキュメントソースファイルへのパス" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "'any' クロスリファレンス %r のターゲットが1つ以上みつかりました。 %s に参照を設定します。" -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "出力先ディレクトリへのパス" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s 参照先が見つかりません: %s" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r 参照先が見つかりません: %s" -#: cmd/build.py:114 -msgid "general options" -msgstr "一般的なオプション" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "割り込まれました!" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "すべてのファイルに書き込む(デフォルト: 新規ファイルまたは変更されたファイルのみ)" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "保存された環境は使わず、常に全てのファイルを読み込む" - -#: cmd/build.py:150 -msgid "path options" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:157 +#: _cli/util/errors.py:207 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "設定ファイルの設定を上書きする" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "HTMLテンプレートに値を渡す" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "定義タグ: TAG ブロック\"のみ\"含む" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" -msgstr "コンソール出力オプション" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "精度の増加(繰り返し可能)" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "標準出力には出力せず、標準エラー出力に警告を出すのみ" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "何も出力せず、警告もしない" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "色分けで出力する(デフォルト:自動検出)" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "次期バージョンでのエラーメッセージ改善のために、ユーザーエラーの場合にも報告してください。" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "色分けの出力をしない(デフォルト:自動検出)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "サイドバーをたたむ" -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "ナビゲーション" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "指定ファイルに警告(およびエラー)を書き込む" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "%(docstitle)s 内を検索" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "警告をエラーとして扱う" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "このドキュメントについて" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "例外時にフルトレースバックを表示する" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "検索" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "例外が発生したときにPdbを実行する" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "著作権" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "-aオプションとファイル名を組み合わせることはできません" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "最終更新: %(last_updated)s" -#: cmd/build.py:357 +#: themes/basic/layout.html:204 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "-Dオプション引数は name = value の形式でなければなりません" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "前のトピックへ" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "-Aオプション引数は name = value の形式でなければなりません" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "前の章へ" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "次のトピックへ" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "サイドバーをたたむ" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "次の章へ" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "目次" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "検索" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "総索引" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "検索" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "このページ" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "ソースコードを表示" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "コンテンツ" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "クイック検索" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "%(docstitle)s 内を検索" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "検索" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2698,7 +2898,7 @@ msgstr "モジュール総索引" msgid "quick access to all modules" msgstr "全モジュール早見表" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "総合索引" @@ -2706,23 +2906,15 @@ msgstr "総合索引" msgid "all functions, classes, terms" msgstr "関数、クラスおよび用語総覧" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "このページ" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "目次" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "総索引" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "クイック検索" +msgid "Search %(docstitle)s" +msgstr "%(docstitle)s 内を検索" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2732,57 +2924,6 @@ msgstr "頭文字別索引" msgid "can be huge" msgstr "大きい場合があるので注意" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "前のトピックへ" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "前の章へ" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "次のトピックへ" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "次の章へ" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "ナビゲーション" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "%(docstitle)s 内を検索" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "このドキュメントについて" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "著作権" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "最終更新: %(last_updated)s" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2799,43 +2940,42 @@ msgstr "複数の単語を検索すると、次を含む一致のみが表示さ msgid "search" msgstr "検索" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "検索結果を隠す" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "コンテンツ" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "検索結果" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "検索した文字列はどの文書にも見つかりませんでした。すべての単語が正確に記述されているか、あるいは、十分なカテゴリーが選択されているか確認してください。" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" "Search finished, found ${resultCount} pages matching the search query." msgstr[0] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "検索中" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "検索を準備しています..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", in " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "検索結果を隠す" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2843,6 +2983,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "バージョン %(version)s の変更点 — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2864,120 +3009,127 @@ msgstr "その他の変更" msgid "Expand sidebar" msgstr "サイドバーを展開" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "パラメータ" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "変数" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "例外" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s モジュール)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (%s モジュール)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (組み込み変数)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (組み込みクラス)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (%s のクラス)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s のクラスメソッド)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s の静的メソッド)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (%s のプロパティ)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Pythonモジュール索引" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "モジュール" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "非推奨" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "例外" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "クラスメソッド" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "の静的メソッド" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "プロパティ" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "相互参照 %r に複数のターゲットが見つかりました: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (非推奨)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "パラメータ" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "変数" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "例外" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2988,92 +3140,85 @@ msgstr "テンプレートパラメータ" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "戻り値" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "union" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "のメンバ変数" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "のデータ型" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "コンセプト" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "列挙型" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerator" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "関数パラメータ" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "テンプレート・パラメータ" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "変数" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "のマクロ" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "struct" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "環境変数; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" -msgstr "" +msgstr "タイプ" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" -msgstr "" +msgstr "デフォルト" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3168,514 +3313,422 @@ msgstr "" msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "循環参照している toctree が検出されましたので無視します: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "toctree にはタイトルのないドキュメント %r への参照が含まれています: リンクは生成されません" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "%sを参照" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "%sも参照" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "不明なインデックスエントリタイプ %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "記号" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "画像ファイルが読み込めません: %s" +msgid "invalid value set (missing closing brace): %s" +msgstr "無効な値セット (終了括弧がありません): %s" -#: environment/collectors/asset.py:126 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "image file %s not readable: %s" -msgstr "画像ファイル %s が読み込めません: %s" +msgid "invalid value set (missing opening brace): %s" +msgstr "無効な値セット (開始括弧がありません): %s" -#: environment/collectors/asset.py:163 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "download file not readable: %s" -msgstr "ダウンロードファイルが読み込めません: %s" +msgid "malformed string literal (missing closing quote): %s" +msgstr "不正な文字列リテラル (終了引用符がありません): %s" -#: environment/collectors/toctree.py:259 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s はすでにセクション番号が割り当てられています (入れ子になった番号の toctree ?)" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "割り込まれました!" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +msgid "malformed string literal (missing opening quote): %s" +msgstr "不正な文字列リテラル (開始引用符がありません): %s" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "サンプル" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "サンプル" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "キーワード引数" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "メモ" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "その他のパラメータ" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "次期バージョンでのエラーメッセージ改善のために、ユーザーエラーの場合にも報告してください。" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "受け取る" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "相互参照用のフォールバックテキストを決定できませんでした。バグかもしれません。" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "参照" -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "'any' クロスリファレンス %r のターゲットが1つ以上みつかりました。 %s に参照を設定します。" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "警告" -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s 参照先が見つかりません: %s" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "列挙" -#: transforms/post_transforms/__init__.py:305 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "%r reference target not found: %s" -msgstr "%r 参照先が見つかりません: %s" +msgid "A mocked object is detected: %r" +msgstr "モックオブジェクトが検出されました: %r" -#: transforms/post_transforms/images.py:79 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "リモート画像を取得できませんでした: %s [%s]" +msgid "alias of %s" +msgstr "%sの別名です。" -#: transforms/post_transforms/images.py:96 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "リモート画像を取得できませんでした: %s [%d]" +msgid "Bases: %s" +msgstr "ベースクラス: %s" -#: transforms/post_transforms/images.py:143 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Unknown image format: %s..." -msgstr "不明な画像フォーマット: %s..." +msgid "invalid value for member-order option: %s" +msgstr "member-order オプションに無効な値があります: %s" -#: builders/html/__init__.py:113 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "HTMLページは%(outdir)sにあります。" +msgid "invalid value for class-doc-from option: %s" +msgstr "class-doc-from オプションに無効な値があります: %s" -#: builders/html/__init__.py:348 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "Failed to read build info file: %r" -msgstr "build info ファイルの読み込みに失敗しました: %r" +msgid "invalid signature for auto%s (%r)" +msgstr "auto%s (%r) の署名が無効です" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "ドキュメントの自動生成 %r のためにどのモジュールをインポートするのか分かりません (ドキュメントに \"module\"または \"currentmodule\"ディレクティブを配置するか、明示的なモジュール名を指定してください)" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:383 +#: ext/autodoc/_names.py:93 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "索引" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "automodule 名の \"::\" は意味がありません" -#: builders/html/__init__.py:560 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "Logo of %s" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "次へ" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "前へ" +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "ファイル %s を作成したものとします。" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "索引を生成中" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\n 内を再帰的に調べてPython のモジュールとパッケージ、\n後は1つのreST ファイルを 内にあるパッケージ毎の automodule ディレクティブに作成します。\n\n は、ファイル、またはディレクトリ、または両方のパターンを\n生成処理から除外することができます。\n\n注:デフォルトでは、このスクリプトはすでに作成されているファイルを上書きしません。" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "追加のページを出力中" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "ドキュメントへのモジュールパス" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "生成処理から除外するための、ファイル、ディレクトリ、または両方のパターンを記した fnmatch-style 形式" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "ダウンロードファイルをコピー中..." +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "すべての生成データを配置するディレクトリ" -#: builders/html/__init__.py:818 -#, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "ダウンロードファイル %r をコピーできません: %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "目次に表示するサブモジュールの最大深度 (デフォルト: 4)" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "存在するファイルは上書きする" -#: builders/html/__init__.py:882 -#, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "html_static_file 内のファイルのコピーに失敗しました: %s: %r" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "シンボリックリンクをたどります。collective.recipe.omeletteと組み合わせると強力です。" -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "静的ファイルをコピー中" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "ファイルを作成せずにスクリプトを実行する" -#: builders/html/__init__.py:934 -#, python-format -msgid "cannot copy static file %r" -msgstr "静的ファイル %r をコピーできません" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "各モジュールのドキュメントをそれぞれのページに配置する" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "extraファイルをコピー中" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "\"_private\" モジュールを含めます。" -#: builders/html/__init__.py:949 -#, python-format -msgid "cannot copy extra file %r" -msgstr "extraファイル %r をコピーできませんでした" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "目次のファイル名 (デフォルト: モジュール)" -#: builders/html/__init__.py:955 -#, python-format -msgid "Failed to write build info file: %r" -msgstr "build info ファイル %r の出力に失敗しました" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "目次ファイルを生成しない" -#: builders/html/__init__.py:1005 +#: ext/apidoc/_cli.py:135 msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "検索インデックスを読み込めず、ドキュメントビルドの一部が不完全です。" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "module/package パッケージの見出しを生成しない (例: docstring にすでにそれらが含まれている場合など)" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "ページ %s がhtml_sidebarsの複数のパターンに一致しました: %r と %r" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "サブモジュールのドキュメントの前に、モジュールのドキュメントを置く" -#: builders/html/__init__.py:1216 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "ページ%sの読み込み中にUnicodeエラーが発生しました。非アスキー文字を含む設定値は全てUnicode文字列にしてください。" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "PEP-0420 暗黙の名前空間の指定に従って、モジュールパスを解釈する" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "%sページのレンダリング中にエラーが発生しました。\n理由: %r " +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "オブジェクト インベントリを出力" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "ファイルの拡張子 (デフォルト: rst)" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "%s の検索インデックスを出力" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "無効な js_file %r は無視されました" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "sphinx-quickstart を使って完全なプロジェクトを生成する" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "複数の math_renderer が登録されています。しかし math_renderer は選択されていません。" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "module_pathを sys.path に追加します。--full が与えられたときに使用されます。" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "不明な math_renderer %r が指定されました。" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "プロジェクト名 (デフォルト: ルートモジュール名)" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "html_extra_path %r がoutdir内に配置されます" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "プロジェクト著者名(複数可)。--full が与えられたときに使用されます。" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "html_extra_path %r が見つかりません" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "プロジェクトバージョン。--full が与えられたときに使用されます。" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "html_static_path %r がoutdir内に配置されます" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "プロジェクトのリリースバージョン。--full が与えられたときに使用されます。デフォルトは --doc-version" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "拡張オプション" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1385 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "html_static_path entry %r does not exist" -msgstr "html_static_path %r が見つかりません" +msgid "enable %s extension, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "logo file %r does not exist" -msgstr "ロゴファイル %r がありません" +msgid "%s is not a directory." +msgstr "%s はディレクトリではありません。" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" -msgstr "favicon ファイル %r がありません" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "%s %s documentation" -msgstr "%s %s ドキュメント" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_extension.py:133 +#, python-format +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "LaTeXファイルは%(outdir)sにあります。" - -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\n(pdf)latex コマンドで処理するために、そのディレクトリで 'make' を実行してください。\n(これを自動的に行うには、ここで 'make latexpdf' を使用してください)。" - -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "設定値 \"latex_documents\" が見つかりません。ドキュメントは書き込まれません" +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "設定値 \"latex_documents\" は、不明なドキュメント %s を参照しています" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "リリース" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "TeX 関連ファイルをコピーしています" - -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "追加のファイルをコピーしています" +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "不明な設定値 latex_elements[%r] は無視されました。" +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "不明なテーマオプション latex_theme_options[%r] は無視されました。" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r に \"theme\" 設定がありません" +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r に \"%s\" 設定がありません" - -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "前のページからの続き" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "次のページに続く" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "アルファベット以外" - -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "番号" - -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "ページ" - -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "キーワード引数" +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "無効な値セット (終了括弧がありません): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "autosummary: ドキュメント化する %r の決定に失敗しました。次の例外が発生しました:\n%s" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:630 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "無効な値セット (開始括弧がありません): %s" +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] %s の autosummary を生成中" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "不正な文字列リテラル (終了引用符がありません): %s" +msgid "[autosummary] writing to %s" +msgstr "[autosummary] %s に書き込み中" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:679 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "不正な文字列リテラル (開始引用符がありません): %s" - -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "サンプル" +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "サンプル" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nautosummary ディレクティブを使って ReStructuredText を生成します。\n\nsphinx-autogen は sphinx.ext.autosummary.generate のフロントエンドです。\n入力されたファイルを含む autosummary ディレクティブから reStructuredText ファイルを\n生成します。\n\nautosummary ディレクティブのフォーマットは\n``sphinx.ext.autosummary`` に記載されています。Pythonモジュールと :: を使って読むことができます。\n\npydoc sphinx.ext.autosummary\n" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "メモ" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "rST ファイルを生成するためのソースファイル" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "その他のパラメータ" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "すべての生成データを配置するディレクトリ" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "受け取る" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "ファイルのデフォルト拡張子 (デフォルト: %(default)s)" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "参照" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "カスタムテンプレートディレクトリ (デフォルト: %(default)s)" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "警告" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "インポートしたメンバーのドキュメント (デフォルト: %(default)s)" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "列挙" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "モジュール __all__ 属性に含まれるメンバーのみを対象としたドキュメントを作成します。(デフォルト: %(default)s)" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "autosummary は除外したドキュメント %r を参照しています。無視されます。" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: stubファイルが見つかりません%r。autosummary_generate設定を確認してください。" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "キャプション付きオートサマリーには :toctree: オプションが必要です。" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3683,548 +3736,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "%sの名前を解析できませんでした " - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "%sオブジェクトをインポートできませんでした " -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: ファイルが見つかりません: %s" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "autosummary: ドキュメント化する %r の決定に失敗しました。次の例外が発生しました:\n%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[autosummary] %s の autosummary を生成中" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[autosummary] %s に書き込み中" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" + +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "" + +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "" + +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" + +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "" + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" + +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "" + +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "いくつかのインベントリでいくつかの問題に遭遇しましたが、代替手段を持っていました:" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" +"failed to reach any of the inventories with the following issues:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:836 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nautosummary ディレクティブを使って ReStructuredText を生成します。\n\nsphinx-autogen は sphinx.ext.autosummary.generate のフロントエンドです。\n入力されたファイルを含む autosummary ディレクティブから reStructuredText ファイルを\n生成します。\n\nautosummary ディレクティブのフォーマットは\n``sphinx.ext.autosummary`` に記載されています。Pythonモジュールと :: を使って読むことができます。\n\npydoc sphinx.ext.autosummary\n" - -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "rST ファイルを生成するためのソースファイル" - -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "すべての生成データを配置するディレクトリ" - -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "ファイルのデフォルト拡張子 (デフォルト: %(default)s)" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "intersphinx インベントリは移動しました: %s -> %s" -#: ext/autosummary/generate.py:882 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "カスタムテンプレートディレクトリ (デフォルト: %(default)s)" +msgid "(in %s %s)" +msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "インポートしたメンバーのドキュメント (デフォルト: %(default)s)" +msgid "(in %s)" +msgstr "(in %s)" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "モジュール __all__ 属性に含まれるメンバーのみを対象としたドキュメントを作成します。(デフォルト: %(default)s)" +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:387 #, python-format -msgid "Failed to remove %s: %s" +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\n 内を再帰的に調べてPython のモジュールとパッケージ、\n後は1つのreST ファイルを 内にあるパッケージ毎の automodule ディレクティブに作成します。\n\n は、ファイル、またはディレクトリ、または両方のパターンを\n生成処理から除外することができます。\n\n注:デフォルトでは、このスクリプトはすでに作成されているファイルを上書きしません。" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "ドキュメントへのモジュールパス" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "生成処理から除外するための、ファイル、ディレクトリ、または両方のパターンを記した fnmatch-style 形式" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "すべての生成データを配置するディレクトリ" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "%s のシグネチャをフォーマット中にエラーが発生しました: %s" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "目次に表示するサブモジュールの最大深度 (デフォルト: 4)" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "存在するファイルは上書きする" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "%s の関数シグネチャの取得に失敗しました: %s" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "シンボリックリンクをたどります。collective.recipe.omeletteと組み合わせると強力です。" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "%r のシグネチャの更新に失敗しました: パラメータが見つかりません: %s。" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "ファイルを作成せずにスクリプトを実行する" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "%rのtype_commentを解析できませんでした: %s" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "各モジュールのドキュメントをそれぞれのページに配置する" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "無効な __slots__ が %s で見つかりました。無視されました。" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "\"_private\" モジュールを含めます。" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "%sの引数のフォーマット中にエラーが発生しました: %s " -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "目次のファイル名 (デフォルト: モジュール)" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "%s のコンストラクタ署名の取得に失敗しました: %s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "目次ファイルを生成しない" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "%s のメソッド・シグネチャの取得に失敗しました: %s" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "module/package パッケージの見出しを生成しない (例: docstring にすでにそれらが含まれている場合など)" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "サブモジュールのドキュメントの前に、モジュールのドキュメントを置く" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "%r の既定の引数値の解析に失敗しました: %s。" -#: ext/apidoc/_cli.py:152 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "PEP-0420 暗黙の名前空間の指定に従って、モジュールパスを解釈する" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" +msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "ファイルの拡張子 (デフォルト: rst)" - -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "sphinx-quickstart を使って完全なプロジェクトを生成する" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "automodule に与えられた署名引数、または戻り値となるアノテーション %s" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "module_pathを sys.path に追加します。--full が与えられたときに使用されます。" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ は文字列のリストでなければなりません。%r (%s モジュールの中) ではないです -- ignoring __all__" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "プロジェクト名 (デフォルト: ルートモジュール名)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "members: オプションで指定された属性がありません: モジュール %s、属性 %s" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "プロジェクト著者名(複数可)。--full が与えられたときに使用されます。" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "オブジェクト %s に属性 %s がありません" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "プロジェクトバージョン。--full が与えられたときに使用されます。" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "TypeVar(%s)のエイリアスです。" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "プロジェクトのリリースバージョン。--full が与えられたときに使用されます。デフォルトは --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "拡張オプション" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "HTMLページは%(outdir)sにあります。" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." -msgstr "%s はディレクトリではありません。" +msgid "Failed to read build info file: %r" +msgstr "build info ファイルの読み込みに失敗しました: %r" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" -msgstr "" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "索引" -#: ext/apidoc/_extension.py:121 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "次へ" -#: ext/apidoc/_extension.py:140 -#, python-format -msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "前へ" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "索引を生成中" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "追加のページを出力中" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:178 -#, python-format -msgid "apidoc_modules item %i '%s' must be an int" -msgstr "" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "ダウンロードファイルをコピー中..." -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "ダウンロードファイル %r をコピーできません: %s" -#: ext/apidoc/_extension.py:210 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" -msgstr "" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "html_static_file 内のファイルのコピーに失敗しました: %s: %r" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "" +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "静的ファイルをコピー中" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:923 #, python-format -msgid "Would create file %s." -msgstr "ファイル %s を作成したものとします。" +msgid "cannot copy static file %r" +msgstr "静的ファイル %r をコピーできません" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s v%s)" -msgstr "(in %s v%s)" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "extraファイルをコピー中" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:938 #, python-format -msgid "(in %s)" -msgstr "(in %s)" +msgid "cannot copy extra file %r" +msgstr "extraファイル %r をコピーできませんでした" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:944 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "" +msgid "Failed to write build info file: %r" +msgstr "build info ファイル %r の出力に失敗しました" -#: ext/intersphinx/_resolve.py:118 -#, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "検索インデックスを読み込めず、ドキュメントビルドの一部が不完全です。" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "ページ %s がhtml_sidebarsの複数のパターンに一致しました: %r と %r" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1204 #, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "ページ%sの読み込み中にUnicodeエラーが発生しました。非アスキー文字を含む設定値は全てUnicode文字列にしてください。" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:1217 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1225 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "%sページのレンダリング中にエラーが発生しました。\n理由: %r " -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "オブジェクト インベントリを出力" + +#: builders/html/__init__.py:1266 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "dumping search index in %s" +msgstr "%s の検索インデックスを出力" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +msgid "invalid js_file: %r, ignored" +msgstr "無効な js_file %r は無視されました" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "複数の math_renderer が登録されています。しかし math_renderer は選択されていません。" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "Unknown math_renderer %r is given." +msgstr "不明な math_renderer %r が指定されました。" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "html_extra_path %r がoutdir内に配置されます" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "html_extra_path %r が見つかりません" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "html_static_path %r がoutdir内に配置されます" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" +msgstr "html_static_path %r が見つかりません" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" +msgid "logo file %r does not exist" +msgstr "ロゴファイル %r がありません" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "favicon ファイル %r がありません" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "いくつかのインベントリでいくつかの問題に遭遇しましたが、代替手段を持っていました:" - -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "以下の問題があるため、いくつかのインベントリは到達できませんでした:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "intersphinx インベントリは移動しました: %s -> %s" +msgid "%s %s documentation" +msgstr "%s %s ドキュメント" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "member-order オプションに無効な値があります: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r に \"theme\" 設定がありません" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "class-doc-from オプションに無効な値があります: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r に \"%s\" 設定がありません" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "auto%s (%r) の署名が無効です" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "%sの引数のフォーマット中にエラーが発生しました: %s " +msgid "Failed to get a docname for source %r!" +msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "LaTeXファイルは%(outdir)sにあります。" + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "ドキュメントの自動生成 %r のためにどのモジュールをインポートするのか分かりません (ドキュメントに \"module\"または \"currentmodule\"ディレクティブを配置するか、明示的なモジュール名を指定してください)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\n(pdf)latex コマンドで処理するために、そのディレクトリで 'make' を実行してください。\n(これを自動的に行うには、ここで 'make latexpdf' を使用してください)。" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" -msgstr "モックオブジェクトが検出されました: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "設定値 \"latex_documents\" が見つかりません。ドキュメントは書き込まれません" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "%s のシグネチャをフォーマット中にエラーが発生しました: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "設定値 \"latex_documents\" は、不明なドキュメント %s を参照しています" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "automodule 名の \"::\" は意味がありません" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "TeX 関連ファイルをコピーしています" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "automodule に与えられた署名引数、または戻り値となるアノテーション %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "追加のファイルをコピーしています" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ は文字列のリストでなければなりません。%r (%s モジュールの中) ではないです -- ignoring __all__" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "不明な設定値 latex_elements[%r] は無視されました。" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "members: オプションで指定された属性がありません: モジュール %s、属性 %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "不明なテーマオプション latex_theme_options[%r] は無視されました。" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "%s の関数シグネチャの取得に失敗しました: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s はすでにセクション番号が割り当てられています (入れ子になった番号の toctree ?)" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "%s のコンストラクタ署名の取得に失敗しました: %s" +msgid "image file not readable: %s" +msgstr "画像ファイルが読み込めません: %s" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" -msgstr "ベースクラス: %s" +msgid "image file %s not readable: %s" +msgstr "画像ファイル %s が読み込めません: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" -msgstr "オブジェクト %s に属性 %s がありません" +msgid "download file not readable: %s" +msgstr "ダウンロードファイルが読み込めません: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" -msgstr "%sの別名です。" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "循環参照している toctree が検出されましたので無視します: %s <- %s" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "TypeVar(%s)のエイリアスです。" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "toctree にはタイトルのないドキュメント %r への参照が含まれています: リンクは生成されません" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "%s のメソッド・シグネチャの取得に失敗しました: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "無効な __slots__ が %s で見つかりました。無視されました。" +msgid "toctree contains reference to non-existing document %r" +msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "%r の既定の引数値の解析に失敗しました: %s。" +msgid "see %s" +msgstr "%sを参照" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "%r のシグネチャの更新に失敗しました: パラメータが見つかりません: %s。" +msgid "see also %s" +msgstr "%sも参照" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "%rのtype_commentを解析できませんでした: %s" +msgid "unknown index entry type %r" +msgstr "不明なインデックスエントリタイプ %r" diff --git a/sphinx/locale/ka/LC_MESSAGES/sphinx.mo b/sphinx/locale/ka/LC_MESSAGES/sphinx.mo index c9170caa2e4..7d9fd37e013 100644 Binary files a/sphinx/locale/ka/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ka/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/ka/LC_MESSAGES/sphinx.po b/sphinx/locale/ka/LC_MESSAGES/sphinx.po index 11a49fb8e37..0e9d22ca9d6 100644 --- a/sphinx/locale/ka/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/ka/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Georgian (http://app.transifex.com/sphinx-doc/sphinx-1/language/ka/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: ka\n" "Plural-Forms: nplurals=2; plural=(n!=1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python-ის განვითარების შეთავაზებები; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "არასწორი PEP ნომერი %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "არასწორი RFC ნომერი %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "პარამეტრი %s.%s თემის კონფიგურაციებში აღმოჩენილი არაა" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "თემის პარამეტრი %r მხარდაჭერილი არაა" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "პროექტს გაფართოების %s ვერსია მინიმუმ %s სჭირდება და ამიტომ ჩატვირთული ვერსიით (%s) აგებული ვერ იქნება." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Pygments lexer-ის სახელი %r უცნობია" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "მოვლენა %r უკვე არსებობს" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "უცნობი მოვლენის სახელი: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "დამმუშავებელმა %r მოვლენისთვის %r გამონაკლისი გადმოგვცა" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "წყარო საქაღალდე ვერ ვიპოვე (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "გამოტანის საქაღალდე (%s) საქაღალდე არაა" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "საწყისი და სამიზნე საქაღალდე ერთი და იგივე არ შეიძლება, იყოს" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "გაშვებულია Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "პროექტს Sphinx-ის მინიმალური v%s სჭირდება და ამიტომ ამ ვერსიით ვერ აიგება." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "გამოტანის საქაღალდის შექმნა" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "გაფართოების %s მორგებისას:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup', როგორც ის conf.py-შია ამჟამად აღწერილი, Python-ის მიერ გამოძახებადი არაა. შეცვალეთ აღწერა, რათა ის გამოძახებადი ფუნქცია გახდეს. ეს საჭიროა, რათა conf.py-ი, როგორც Sphinx-ის გაფართოება, მოიქცეს." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "თარგმანების ჩატვირთვა [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "შესრულებულია" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "ჩაშენებული შეტყობინებებისთვის ხელმისაწვდომი არაა" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "დამჟავებული გარემოს ჩატვირთვა" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "შეცდომით: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "ამგები არჩეული არაა. ვიყენებ ნაგულისხმევს: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "კვანძის კლასი %r უკვე რეგისტრირებულია. მისი მნახველები გადაფარული იქნება" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "გაფართოება %s არ აღწერს, არის თუ არა ის უსაფრთხო პარალელური წაკითხვისთვის. ვთვლით, რომ არა - კითხეთ გაფართოების ავტორს და აშკარად აღწერეთ ის" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "%s გაფართოება პარალელური წაკითხვისთვის უსაფრთხო არაა" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "გაფართოება %s არ აღწერს, არის თუ არა ის უსაფრთხო პარალელური ჩაწერისთვის. ვთვლით, რომ არა - კითხეთ გაფართოების ავტორს და აშკარად აღწერეთ ის" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "%s გაფართოება პარალელური ჩაწერისთვის უსაფრთხო არაა" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "ვაკეთებ სერიულს %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "კონფიგურაციის საქაღალდე ფაილს conf.py არ შეიცავს (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "ამგებ კლასს %s \"name\" ატრიბუტი არ გააჩნია" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "ამგები %r უკვე არსებობს (მოდულში %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "ამგების სახელი %s რეგისტრირებული არაა ან შესვლის წერტილში ხელმისაწვდომი არაა" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "ამგების სახელი %s რეგისტრირებული არაა" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "დომენი %s უკვე რეგისტრირებულია" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "დომენის %s ჯერ რეგისტრირებული არაა" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "%r დირექტივა დომენისთვის %s უკვე რეგისტრირებულია" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "%r როლი დომენისთვის %s უკვე რეგისტრირებულია" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "%r ინდექსი დომენისთვის %s უკვე რეგისტრირებულია" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "%r ობიექტის ტიპი უკვე რეგისტრირებულია" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "%r ჯვარედინი მიმართვის ტიპი უკვე რეგისტრირებულია" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r უკვე რეგისტრირებულია" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser %r-სთვის უკვე რეგისტრირებულია" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "წყაროს დამმუშავებელი %s-სთვის რეგისტრირებული არაა" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "მთარგმნელი %r-სთვის უკვე არსებობს" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "kwarg-ები add_node()-სთვის (შემომავალი, გამავალი) ფუნქციის კორტეჟი უნდა იყოს: %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r უკვე რეგისტრირებულია" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "მათემატიკის რენდერერი %s უკვე რეგისტრირებულია" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "აღმოჩენილია არასწორი კონფიგურაციის მნიშვნელობა: 'language = None'. განაახლეთ კონფიგურაცია და მიუთითეთ სწორი ენა. გადაირთვება 'en'-ზე (ინგლისური)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "გაფართოება %r %s ვერსიის შემდეგ Sphinx-ის ნაწილია. გაფართოება გამოტოვებულია." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "საწყისი გამონაკლისი:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "გაფართოების (%s) შემოტანა შეუძლებელია" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "გაფართოებას %r ფუნქცია setup() არ აქვს. დარწმუნებული ბრძანდებით, რომ ეს ნამდვილად Sphinx-ის გაფართოების მოდულია?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "ამ პროექტში გამოყენებულ გაფართოებას %s Sphinx-ის მინიმუმ v%s სჭირდება. ამიტომ მას ამ ვერსიით ვერ ააგებთ." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "გაფართოებამ %r setup() ფუნქციიდან მხარდაუჭერელი ობიექტი დააბრუნა. მან ან არაფერი, ან მეტამონაცემების ლექსიკონი უნდა დააბრუნოს" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "კონფიგურაციის საქაღალდე ფაილს conf.py არ შეიცავს (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "ლექსიკონის კონფიგურაციის პარამეტრის %r გადაფარვა შეუძლებელია. ის გამოტოვებული იქნება (ინდივიდუალური ელემენტების დასაყენებლად გამოიყენეთ %r)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "რიცხვი %r კონფიგურაციის მნიშვნელობისთვის %r არასწორია. ის გამოტოვებული იქნება" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "მხარდაუჭერელი ტიპის მქონე კონფიგურაციის პარამეტრის %r გადაფარვა შეუძლებელია. ის გამოტოვებული იქნება" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "გადაფარვაში მითითებული კონფიგურაციის მნიშვნელობა %r უცნობია. ის გამოტოვებული იქნება" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "კონფიგურაციის მნიშვნელობა %r უკვე არსებობს" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "აღმოჩენილია არასწორი კონფიგურაციის მნიშვნელობა: 'language = None'. განაახლეთ კონფიგურაცია და მიუთითეთ სწორი ენა. გადაირთვება 'en'-ზე (ინგლისური)." + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "თქვენს კონფიგურაციის ფაილში აღმოჩენილია შეცდომა: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "კონფგურაციის ფაილმა (ან მოდულმა, რომელის მან შემოიტანა) sys.exit() გამოიძახა" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,470 +536,626 @@ msgid "" "%s" msgstr "თქვენს კონფიგურაციის ფაილში პროგრამირებადი შეცდომაა:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "სექცია %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "ნახ. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "ცხრილი %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "ჩამონათვალი %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "კონფიგურაციის მნიშვნელობა `{name}` შეიძლება იყოს ერთ-ერთ სიიდან `{candidates}`, თქვენ კი `{current}` მიუთითეთ." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "კონფიგურაციის მნიშვნელობის `{name}` ტიპია `{current.__name__}`, მე კი {permitted}-ს ველოდებოდი." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "კონფიგურაციის მნიშვნელობის `{name}` ტიპია `{current.__name__}`, ნაგულისხმებია `{default.__name__}`." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r ვერ ვიპოვე. ის გამოტოვებული იქნება." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Pygments lexer-ის სახელი %r უცნობია" - -#: highlighting.py:209 -#, python-format +#: config.py:892 msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "ახალი კონფიგურაცია" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "პარამეტრი %s.%s თემის კონფიგურაციებში აღმოჩენილი არაა" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "კონფიგურაცია შეიცვალა" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "თემის პარამეტრი %r მხარდაჭერილი არაა" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "გაფართოებები შეიცვალა" + +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "აგების გარემოს ვერსია მიმდინარე არაა" + +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "საწყისი საქაღალდე შეიცვალა" -#: theming.py:208 +#: environment/__init__.py:350 #, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:228 +#: environment/__init__.py:355 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:361 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:276 -#, python-format +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "გარემო არჩეულ ამგებთან თავსებადი არაა. აირჩიეთ სხვა დოკუმენტების ხის საქაღალდე." -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "" +msgid "Failed to scan documents in %s: %r" +msgstr "%s-ში დოკუმენტების სკანირება შეუძლებელია: %r" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" -msgstr "" +msgid "Domain %r is not registered" +msgstr "დომენი %r რეგისტრირებული არაა" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "დოკუმენტი არც ერთ სარჩევის ხეში ჩასმული არაა" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "აღმოჩენილია თვითმიმართვადი სარჩევის ხე. გამოტოვებულია." -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "ყურადღება" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "გაფრთხილება" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "მოვლენა %r უკვე არსებობს" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "საფრთხე" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "უცნობი მოვლენის სახელი: %s" +#: locale/__init__.py:232 +msgid "Error" +msgstr "შეცდომა" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "დამმუშავებელმა %r მოვლენისთვის %r გამონაკლისი გადმოგვცა" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "მინიშნება" -#: project.py:72 +#: locale/__init__.py:234 +msgid "Important" +msgstr "მნიშვნელოვანი" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "ნოტი" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "ასევე იხილეთ" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "რჩევა" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "ყურადღება" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Texinfo-ის ფაილების საქაღალდეა %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "კონფიგურაციის პარამეტრის \"texinfo_documents\" მნიშვნელობა მითითებული არაა. დოკუმენტების ჩაწერი არ იქნება" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "ამგებ კლასს %s \"name\" ატრიბუტი არ გააჩნია" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "\"texinfo_documents\" კონფიგურაციის პარამეტრი მიუთითებს უცნობ დოკუმენტზე %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "ამგები %r უკვე არსებობს (მოდულში %s)" +msgid "processing %s" +msgstr "დამუშავება %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "ამგების სახელი %s რეგისტრირებული არაა ან შესვლის წერტილში ხელმისაწვდომი არაა" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "ჩაწერა" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "ამგების სახელი %s რეგისტრირებული არაა" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "მიმართვების ამოხსნა..." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "დომენი %s უკვე რეგისტრირებულია" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " ( " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "დომენის %s ჯერ რეგისტრირებული არაა" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "გამოსახულებების კოპირება... " -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "%r დირექტივა დომენისთვის %s უკვე რეგისტრირებულია" +msgid "cannot copy image file %r: %s" +msgstr "გამოსახულების ფაილის %r კოპირების შეცდომა: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "%r როლი დომენისთვის %s უკვე რეგისტრირებულია" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "მიმდინარეობს Texinfo-ის მხარდაჭერის ფაილების კოპირება" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "%r ინდექსი დომენისთვის %s უკვე რეგისტრირებულია" +msgid "error writing file Makefile: %s" +msgstr "შეცდომა Makefile-ის ჩაწერისას: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "%r ობიექტის ტიპი უკვე რეგისტრირებულია" +msgid "The manual pages are in %(outdir)s." +msgstr "სახელმძღვანელოს გვერდების საქაღალდეა %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "%r ჯვარედინი მიმართვის ტიპი უკვე რეგისტრირებულია" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r უკვე რეგისტრირებულია" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "\"man_pages\" პარამეტრის მნიშვნელობა უცნობ დოკუმენტზე %s მიუთითებს" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser %r-სთვის უკვე რეგისტრირებულია" +msgid "The HTML page is in %(outdir)s." +msgstr "HTML გვერდის საქაღალდეა %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "წყაროს დამმუშავებელი %s-სთვის რეგისტრირებული არაა" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "ერთი დოკუმენტის აწყობა" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "მთარგმნელი %r-სთვის უკვე არსებობს" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "დამატებითი ფაილების ჩაწერა" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "kwarg-ები add_node()-სთვის (შემომავალი, გამავალი) ფუნქციის კორტეჟი უნდა იყოს: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "სულელი ამგები, რომელიც ფაილებს არ აგენერირებს." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r უკვე რეგისტრირებულია" +msgid "The message catalogs are in %(outdir)s." +msgstr "შეტყობინების კატალოგების საქაღალდეა %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "მათემატიკის რენდერერი %s უკვე რეგისტრირებულია" +msgid "building [%s]: " +msgstr "აგება [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "გაფართოება %r %s ვერსიის შემდეგ Sphinx-ის ნაწილია. გაფართოება გამოტოვებულია." +msgid "targets for %d template files" +msgstr "%d ნიმუშის ფაილის სამიზნეები" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "საწყისი გამონაკლისი:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "ნიმუშების კითხვა... " -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "გაფართოების (%s) შემოტანა შეუძლებელია" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "შეტყობინების კატალოგების ჩაწერა... " -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "გაფართოებას %r ფუნქცია setup() არ აქვს. დარწმუნებული ბრძანდებით, რომ ეს ნამდვილად Sphinx-ის გაფართოების მოდულია?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "ამ პროექტში გამოყენებულ გაფართოებას %s Sphinx-ის მინიმუმ v%s სჭირდება. ამიტომ მას ამ ვერსიით ვერ ააგებთ." +msgid "broken link: %s (%s)" +msgstr "გაფუჭებული ბმული: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "გაფართოებამ %r setup() ფუნქციიდან მხარდაუჭერელი ობიექტი დააბრუნა. მან ან არაფერი, ან მეტამონაცემების ლექსიკონი უნდა დააბრუნოს" +msgid "Anchor '%s' not found" +msgstr "მიმაგრება '%s' ვერ ვიპოვე" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" -msgstr "" +msgid "The ePub file is in %(outdir)s." +msgstr "EPub ფაილი %(outdir)s-შია." -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "nav.xhtml ფაილის ჩაწერა..." + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "კონფიგურაციის მნიშვნელობა \"epub_language\" (ან \"language\") EPUB3-სთვის ცარიელი არ უნდა ყოფილიყო" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "კონფიგურაციის მნიშვნელობა \"epub_uid\" EPUB3-სთვის XML NAME უნდა იყოს" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "კონფიგურაციის მნიშვნელობა \"epub_title\" (ან \"html_title\") EPUB3-სთვის ცარიელი არ უნდა იყოს" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "კონფიგურაციის მნიშვნელობა \"epub_author\" EPUB3-სთვის ცარიელი არ უნდა იყოს" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "კონფიგურაციის მნიშვნელობა \"epub_contributor\" EPUB3-სთვის ცარიელი არ უნდა იყოს" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "კონფიგურაციის მნიშვნელობა \"epub_description\" EPUB3-სთვის ცარიელი არ უნდა იყოს" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "კონფიგურაციის მნიშვნელობა \"epub_publisher\" EPUB3-სთვის ცარიელი არ უნდა იყოს" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "კონფიგურაციის მნიშვნელობა \"epub_copyright\" (ან \"copyright\") EPUB3-სთვის ცარიელი არ უნდა იყოს" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "კონფიგურაციის მნიშვნელობა \"epub_identifier\" EPUB3-სთვის ცარიელი არ უნდა იყოს" -#: roles.py:274 +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "კონფიგურაციის მნიშვნელობა \"version\" EPUB3-სთვის ცარიელი არ უნდა იყოს" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "invalid CWE number %s" -msgstr "" +msgid "invalid css_file: %r, ignored" +msgstr "არასწორი css_file: %r. გამოტოვება" -#: roles.py:294 +#: builders/xml.py:29 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python-ის განვითარების შეთავაზებები; PEP %s" +msgid "The XML files are in %(outdir)s." +msgstr "XML ფაილების საქაღალდეა %(outdir)s." -#: roles.py:317 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "invalid PEP number %s" -msgstr "არასწორი PEP ნომერი %s" +msgid "error writing file %s: %s" +msgstr "შეცდომა '%s' ფაილის ჩაწერისას: %s" -#: roles.py:355 +#: builders/xml.py:103 #, python-format -msgid "invalid RFC number %s" -msgstr "არასწორი RFC ნომერი %s" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "ფსევდო-XML ფაილებს საქაღალდეა %(outdir)s." -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" +msgstr "აღმოჩენილია დუბლირებული სარჩევის ჩანაწერი: %s" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "მოდულის კოდის გამოკვეთა... " +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" +msgstr "გამოსახულების ფაილი %r ვერ წავიკითხე: ის, სამაგიეროდ, დაკოპირდება" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "" +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" +msgstr "გამოსახულების ფაილის %r ჩაწერის შეცდომა: %s" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "მოდულის კოდი" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow ვერ ვიპოვე - სურათის ფაილების კოპირება" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "mimetype ფაილის ჩაწერა..." + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "მიმდინარეობს META-INF/container.xml ფაილის ჩაწერა..." + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "content.opf ფაილის ჩაწერა..." -#: ext/viewcode.py:353 +#: builders/_epub_base.py:594 #, python-format -msgid "

        Source code for %s

        " +msgid "unknown mimetype for %s, ignoring" +msgstr "უცნობი mimetype ფაილისთვის %s. გამოტოვება" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "გადახედვა: მოდულის კოდი" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "toc.ncx ფაილის ჩაწერა..." -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "%s ფაილის ჩაწერა..." + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "ტექსტური ფაილების საქაღლდეა %(outdir)s." + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: ext/extlinks.py:82 +#: builders/__init__.py:237 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "a suitable image for %s builder not found: %s" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "აგება [mo]: " + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "გამოტანის ჩაწერა... " + +#: builders/__init__.py:280 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "სექცია \"%s\" მიიღებს ჭდეს \"%s\"" +msgid "all of %d po files" +msgstr "სულ %d po ფაილი" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/__init__.py:302 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "დუბლირებული ჭდე %s. სხვა აღწერა %s-შია" +msgid "targets for %d po files that are specified" +msgstr "%d po ფაილისთვის სამიზნე მითითებული არაა" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "" +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "%d po ფაილისთვის სამიზნე მოძველებულია" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "ყველა კოდის ფაილი" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "ბრძანების სტრიქონში მითითებული ფაილი %r არ არსებობს. " -#: ext/duration.py:90 +#: builders/__init__.py:342 +#, python-format msgid "" -"====================== slowest reading durations =======================" -msgstr "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "ბრძანების სტრიქონში მითითებული ფაილი %r კოდის საქაღალდეში არაა. გამოტოვება" -#: ext/doctest.py:118 +#: builders/__init__.py:353 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "ბრძანების სტრიქონში მითითებული ფაილი %r სწორი დოკუმენტი არაა. გამოტოვება" -#: ext/doctest.py:124 +#: builders/__init__.py:366 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' სწორი პარამეტრი არაა." +msgid "%d source files given on command line" +msgstr "ბრძანების სტრიქონში მითითებულია %d კოდის ფაილი" -#: ext/doctest.py:139 +#: builders/__init__.py:382 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' სწორი pyversion-ის პარამეტრი არაა" +msgid "targets for %d source files that are out of date" +msgstr "%d კოდის ფაილის სამიზნე მოძველებულია" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "არასწორი TestCode ტიპი" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "მოძველებული ფაილების ძებნა... " -#: ext/doctest.py:297 +#: builders/__init__.py:415 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "" +msgid "%d found" +msgstr "ნაპოვნია %d" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "არაფერია ნაპოვნი" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "დამჟავების გარემო" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "თანმიმდევრულობის შემოწმება" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "მოძველებული სამიზნეები აღმოჩენილი არაა." + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "გარემოს განახლება: " -#: ext/doctest.py:457 +#: builders/__init__.py:499 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "" +msgid "%s added, %s changed, %s removed" +msgstr "%s დაემატა, %s შეიცვალა, %s წაიშალა" -#: ext/doctest.py:568 +#: builders/__init__.py:536 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:545 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:556 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:563 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "წყაროების კითხვა... " + +#: builders/__init__.py:725 #, python-format -msgid "inline latex %r: %s" +msgid "docnames to write: %s" +msgstr "ჩასაწერი დოკუმენტის სახელები: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "დოკუმენტების მომზადება" + +#: builders/__init__.py:743 +msgid "copying assets" msgstr "" +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "გადახედვის ფაილის მდებარეობაა %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "ვერსიაში %s ცვლილებები არაა." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "შეჯამების ფაილის ჩაწერა..." + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "ჩაშენებულები" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "მოდულის დონე" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "კოდის ფაილების კოპირება..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "ცვლილებების ჟურნალის შესაქმნელად %r-ის წაკითხვა შეუძლებელია" + #: ext/coverage.py:48 #, python-format msgid "invalid regex %r in %s" @@ -738,9 +1174,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,15 +1212,43 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" -#: ext/imgconverter.py:44 +#: ext/extlinks.py:82 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: ext/todo.py:61 +msgid "Todo" +msgstr "განრიგის სია" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<<საწყისი ჩანაწერი>>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "საწყისი ჩანაწერი" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 #, python-format msgid "" "convert exited with error:\n" @@ -862,1780 +1327,1515 @@ msgstr "[გრაფიკი: %s]" msgid "[graph]" msgstr "[გრაფიკი]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "განრიგის სია" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" -msgstr "<<საწყისი ჩანაწერი>>" - -#: ext/todo.py:154 +#: ext/imgmath.py:167 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "" - -#: ext/todo.py:166 -msgid "original entry" -msgstr "საწყისი ჩანაწერი" - -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: directives/code.py:87 +#: ext/imgmath.py:326 #, python-format -msgid "Invalid caption: %s" -msgstr "არასწორი წარწერა: %s" +msgid "display latex %r: %s" +msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/imgmath.py:362 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "\"%s\" და \"%s\" პარამეტრების ერთდროული გამოყენება შეუძლებელია" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" -#: directives/code.py:231 +#: ext/doctest.py:118 #, python-format -msgid "Include file '%s' not found or reading it failed" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:124 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +msgid "'%s' is not a valid option." +msgstr "'%s' სწორი პარამეტრი არაა." -#: directives/code.py:276 +#: ext/doctest.py:139 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "ობიექტი სახელად %r ჩასასმელი ფაილში %r აღმოჩენილი არაა" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' სწორი pyversion-ის პარამეტრი არაა" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "არასწორი TestCode ტიპი" -#: directives/code.py:314 +#: ext/doctest.py:297 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "" - -#: directives/patches.py:71 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/other.py:119 +#: ext/doctest.py:451 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/doctest.py:568 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/other.py:156 +#: ext/autosectionlabel.py:52 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "სექცია \"%s\" მიიღებს ჭდეს \"%s\"" -#: directives/other.py:169 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "აღმოჩენილია დუბლირებული სარჩევის ჩანაწერი: %s" - -#: directives/other.py:203 -msgid "Section author: " -msgstr "სექციის ავტორი: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "მოდულის ავტორი: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "კოდის ავტორი: " - -#: directives/other.py:209 -msgid "Author: " -msgstr "ავტორი: " +msgid "duplicate label %s, other instance in %s" +msgstr "დუბლირებული ჭდე %s. სხვა აღწერა %s-შია" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: builders/changes.py:29 +#: ext/duration.py:124 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "გადახედვის ფაილის მდებარეობაა %(outdir)s." +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" -#: builders/changes.py:56 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "no changes in version %s." -msgstr "ვერსიაში %s ცვლილებები არაა." +msgid "%.3fs %s" +msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "შეჯამების ფაილის ჩაწერა..." +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "ჩაშენებულები" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "მოდულის კოდის გამოკვეთა... " -#: builders/changes.py:72 -msgid "Module level" -msgstr "მოდულის დონე" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "კოდის ფაილების კოპირება..." +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "მოდულის კოდი" -#: builders/changes.py:133 +#: ext/viewcode.py:359 #, python-format -msgid "could not read %r for changelog creation" -msgstr "ცვლილებების ჟურნალის შესაქმნელად %r-ის წაკითხვა შეუძლებელია" +msgid "

        Source code for %s

        " +msgstr "" -#: builders/manpage.py:37 -#, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "სახელმძღვანელოს გვერდების საქაღალდეა %(outdir)s." +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "გადახედვა: მოდულის კოდი" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "ჩაწერა" - -#: builders/manpage.py:71 +#: domains/citation.py:75 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "\"man_pages\" პარამეტრის მნიშვნელობა უცნობ დოკუმენტზე %s მიუთითებს" +msgid "duplicate citation %s, other instance in %s" +msgstr "" -#: builders/__init__.py:224 +#: domains/citation.py:92 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/__init__.py:232 +#: domains/math.py:73 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "აგება [mo]: " - -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "გამოტანის ჩაწერა... " - -#: builders/__init__.py:275 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "all of %d po files" -msgstr "სულ %d po ფაილი" +msgid "Invalid math_eqref_format: %r" +msgstr "არასწორი math_eqref_format: %r" -#: builders/__init__.py:297 +#: domains/javascript.py:183 #, python-format -msgid "targets for %d po files that are specified" -msgstr "%d po ფაილისთვის სამიზნე მითითებული არაა" +msgid "%s() (built-in function)" +msgstr "%s () (ჩაშენებული ფუნქცია)" -#: builders/__init__.py:309 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "%d po ფაილისთვის სამიზნე მოძველებულია" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "ყველა კოდის ფაილი" +msgid "%s() (%s method)" +msgstr "%s () (%s მეთოდი)" -#: builders/__init__.py:330 +#: domains/javascript.py:186 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "ბრძანების სტრიქონში მითითებული ფაილი %r არ არსებობს. " +msgid "%s() (class)" +msgstr "%s () (კლასი)" -#: builders/__init__.py:337 +#: domains/javascript.py:188 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "ბრძანების სტრიქონში მითითებული ფაილი %r კოდის საქაღალდეში არაა. გამოტოვება" +msgid "%s (global variable or constant)" +msgstr "%s (გლობალური ცვლადი ან მუდმივა)" -#: builders/__init__.py:348 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "ბრძანების სტრიქონში მითითებული ფაილი %r სწორი დოკუმენტი არაა. გამოტოვება" +msgid "%s (%s attribute)" +msgstr "%s (%s ატრიბუტი)" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "ბრძანების სტრიქონში მითითებულია %d კოდის ფაილი" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "არგუმენტები" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "%d კოდის ფაილის სამიზნე მოძველებულია" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "ისვრის" -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " -msgstr "აგება [%s]: " +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "აბრუნებს" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "მოძველებული ფაილების ძებნა... " +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "დაბრუნების ტიპი" -#: builders/__init__.py:410 +#: domains/javascript.py:374 #, python-format -msgid "%d found" -msgstr "ნაპოვნია %d" +msgid "%s (module)" +msgstr "%s (მოდული)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "არაფერია ნაპოვნი" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "ფუნქცია" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "დამჟავების გარემო" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "მეთოდი" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "თანმიმდევრულობის შემოწმება" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "კლასი" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "მოძველებული სამიზნეები აღმოჩენილი არაა." +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "მონაცემები" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "გარემოს განახლება: " +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "ატრიბუტი" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s დაემატა, %s შეიცვალა, %s წაიშალა" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "მოდული" -#: builders/__init__.py:531 +#: domains/javascript.py:458 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:540 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "%s (directive)" +msgstr "%s (დირექტივა)" -#: builders/__init__.py:551 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "" +msgid ":%s: (directive option)" +msgstr ":%s: (დირექტივის პარამეტრი)" -#: builders/__init__.py:558 +#: domains/rst.py:224 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "წყაროების კითხვა... " +msgid "%s (role)" +msgstr "%s (როლი)" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" -msgstr "ჩასაწერი დოკუმენტის სახელები: %s" +#: domains/rst.py:234 +msgid "directive" +msgstr "დირექტივა" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" +#: domains/rst.py:235 +msgid "directive-option" +msgstr "დირექტივის-პარამეტრი" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "დოკუმენტების მომზადება" +#: domains/rst.py:236 +msgid "role" +msgstr "როლები" -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "" +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "%s %s-ის დუბლირებული აღწერა. სხვა ასლი %s-შია" -#: builders/__init__.py:883 +#: domains/changeset.py:32 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +msgid "Added in version %s" msgstr "" -#: builders/epub3.py:84 +#: domains/changeset.py:33 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "EPub ფაილი %(outdir)s-შია." - -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "nav.xhtml ფაილის ჩაწერა..." - -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "კონფიგურაციის მნიშვნელობა \"epub_language\" (ან \"language\") EPUB3-სთვის ცარიელი არ უნდა ყოფილიყო" - -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "კონფიგურაციის მნიშვნელობა \"epub_uid\" EPUB3-სთვის XML NAME უნდა იყოს" - -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "კონფიგურაციის მნიშვნელობა \"epub_title\" (ან \"html_title\") EPUB3-სთვის ცარიელი არ უნდა იყოს" - -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "კონფიგურაციის მნიშვნელობა \"epub_author\" EPUB3-სთვის ცარიელი არ უნდა იყოს" - -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "კონფიგურაციის მნიშვნელობა \"epub_contributor\" EPUB3-სთვის ცარიელი არ უნდა იყოს" - -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "კონფიგურაციის მნიშვნელობა \"epub_description\" EPUB3-სთვის ცარიელი არ უნდა იყოს" - -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "კონფიგურაციის მნიშვნელობა \"epub_publisher\" EPUB3-სთვის ცარიელი არ უნდა იყოს" - -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "კონფიგურაციის მნიშვნელობა \"epub_copyright\" (ან \"copyright\") EPUB3-სთვის ცარიელი არ უნდა იყოს" - -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "კონფიგურაციის მნიშვნელობა \"epub_identifier\" EPUB3-სთვის ცარიელი არ უნდა იყოს" - -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "კონფიგურაციის მნიშვნელობა \"version\" EPUB3-სთვის ცარიელი არ უნდა იყოს" +msgid "Changed in version %s" +msgstr "ცვლილებები ვერსიაში %s" -#: builders/epub3.py:279 builders/html/__init__.py:1291 +#: domains/changeset.py:34 #, python-format -msgid "invalid css_file: %r, ignored" -msgstr "არასწორი css_file: %r. გამოტოვება" +msgid "Deprecated since version %s" +msgstr "მოძველებულია ვერსიაში %s" -#: builders/xml.py:31 +#: domains/changeset.py:35 #, python-format -msgid "The XML files are in %(outdir)s." -msgstr "XML ფაილების საქაღალდეა %(outdir)s." +msgid "Removed in version %s" +msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: domains/__init__.py:322 #, python-format -msgid "error writing file %s: %s" -msgstr "შეცდომა '%s' ფაილის ჩაწერისას: %s" +msgid "%s %s" +msgstr "%s %s" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "ფსევდო-XML ფაილებს საქაღალდეა %(outdir)s." +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "დავალების ნომერი დადებითი რიცხვი უნდა იყოს" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Texinfo-ის ფაილების საქაღალდეა %(outdir)s." +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "მეტი ინფორმაციის მისაღებად ეწვიეთ ." -#: builders/texinfo.py:48 +#: cmd/build.py:74 msgid "" "\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "კონფიგურაციის პარამეტრის \"texinfo_documents\" მნიშვნელობა მითითებული არაა. დოკუმენტების ჩაწერი არ იქნება" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "\"texinfo_documents\" კონფიგურაციის პარამეტრი მიუთითებს უცნობ დოკუმენტზე %s" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "დამუშავება %s" - -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "მიმართვების ამოხსნა..." - -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " ( " - -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "გამოსახულებების კოპირება... " - -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "გამოსახულების ფაილის %r კოპირების შეცდომა: %s" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "ბილიკი დოკუმენტაციის კოდის ფაილებამდე" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "მიმდინარეობს Texinfo-ის მხარდაჭერის ფაილების კოპირება" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "ბილიკი გამოტანის საქაღალდემდე" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "შეცდომა Makefile-ის ჩაწერისას: %s" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "აღმოჩენილია დუბლირებული სარჩევის ჩანაწერი: %s" +#: cmd/build.py:114 +msgid "general options" +msgstr "ზოგადი პარამეტრები" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "გამოსახულების ფაილი %r ვერ წავიკითხე: ის, სამაგიეროდ, დაკოპირდება" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "გამოსახულების ფაილის %r ჩაწერის შეცდომა: %s" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Pillow ვერ ვიპოვე - სურათის ფაილების კოპირება" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "ყველა ფაილის ჩაწერა (ნაგულისხმევი: მხოლოდ ახალი და შეცვლილი ფაილების ჩაწერა)" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "mimetype ფაილის ჩაწერა..." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "შენახული გარემო გამოყენებული არ იქნება. ყოველთვის მოხდება ყველა ფაილის წაკითხვა" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "მიმდინარეობს META-INF/container.xml ფაილის ჩაწერა..." +#: cmd/build.py:150 +msgid "path options" +msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "content.opf ფაილის ჩაწერა..." +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "უცნობი mimetype ფაილისთვის %s. გამოტოვება" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "toc.ncx ფაილის ჩაწერა..." +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "კონფიგურაციის ფაილის პარამეტრის გადაფარვა" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "%s ფაილის ჩაწერა..." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "მნიშვნელობის გადაცემა HTML ნიმუშებში" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "სულელი ამგები, რომელიც ფაილებს არ აგენერირებს." +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "შეტყობინების კატალოგების საქაღალდეა %(outdir)s." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "%d ნიმუშის ფაილის სამიზნეები" +#: cmd/build.py:212 +msgid "console output options" +msgstr "კონსოლის გამოტანის პარამეტრები" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "ნიმუშების კითხვა... " +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "დიაგნოსტიკური შეტყობინებების სიხშირის გაზრდა (შეგიძლიათ, გაიმეოროთ)" -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "შეტყობინების კატალოგების ჩაწერა... " +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "stdout-ზე გამოტანილი არაფერი იქნება. მხოლოდ გაფრთხილებები, stderr-ზე" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "HTML გვერდის საქაღალდეა %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "არაფრი გამოტანა. გაფრთხილებებისაც კი" -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "ერთი დოკუმენტის აწყობა" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "ფერადი გამოტანის ჩართვა (ნაგულისხმევი: ავტომატურად-აღმოჩენა)" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "დამატებითი ფაილების ჩაწერა" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "ფერადი გამოტანის გამორთვა (ნაგულისხმევი: ავტომატურად-აღმოჩენა)" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "გაფუჭებული ბმული: %s (%s)" - -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "მიმაგრება '%s' ვერ ვიპოვე" - -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "გაფრთხილებების (და შეცდომების) მითითებულ ფაილში ჩაწერა" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "ტექსტური ფაილების საქაღლდეა %(outdir)s." +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "გაფრთხილებების შეცდომად აღქმა" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "გამონაკლისისას Pdb-ის გაშვება" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "-a პარამეტრის და ფაილის სახელების ერთად მითითება შეუძლებელია" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 +#: cmd/build.py:357 #, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +msgid "cannot open warning file '%s': %s" msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: transforms/__init__.py:253 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "ნაკვალევი [%s] მიმართული არაა." - -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "ნაკვალევი [#] მიმართული არაა." - -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "დოკუმენტაციის დაფარვის შემოწმება" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "მათემატიკის ჩასმა, რომელიც PNG ან SVG გამოსახულების სახითაა დარენდერებული" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "ბრაუზერში MathJax-ის მიერ დარენდერებული მათემატიკის ჩასმა" -#: _cli/__init__.py:171 -#, python-brace-format -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "გთხოვთ შეიყვანოთ ბილიკის სწორი სახელი." -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "შეიყვანეთ რაიმე ტექსტი." -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/quickstart.py:134 +#, python-format +msgid "Please enter one of %s." +msgstr "შეიყვანეთ %s-დან ერთ-ერთი." -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "შეიყვანეთ 'y' (დიახ) ან 'n' (არა)" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "მიუთითეთ ფაილის სუფიქსი. მაგ: '.rst' ან '.txt'." -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "მოგესალმებით Sphinx %s-ის სწრაფი მორგების პროგრამა." -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: environment/__init__.py:86 -msgid "new config" -msgstr "ახალი კონფიგურაცია" +#: cmd/quickstart.py:242 +#, python-format +msgid "Selected root path: %s" +msgstr "არჩეული root ბილიკი: %s" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "კონფიგურაცია შეიცვალა" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "შეიყვანეთ დოკუმენტაციის ძირითადი ბილიკი." -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "გაფართოებები შეიცვალა" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "დოკუმენტაციის ძირითადი ბილიკი" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "აგების გარემოს ვერსია მიმდინარე არაა" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "შეცდომა: არჩეულ ძირითად ბილიკზე აღმოჩენილია არსებული conf.py ფაილი." -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "საწყისი საქაღალდე შეიცვალა" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart-ი არსებულ Sphinx-ის პროექტებს თავზე არ გადააწერს." -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "შეიყვანეთ ახალი საწყისი ბილიკი (გასასვლელად უბრალოდ დააწექით ღილაკს 'Enter')" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "კოდის და აგების საქაღალდეები განსხვავდება? (y(დიახ)/n(არა))" -#: environment/__init__.py:379 +#: cmd/quickstart.py:287 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "გარემო არჩეულ ამგებთან თავსებადი არაა. აირჩიეთ სხვა დოკუმენტების ხის საქაღალდე." +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "%s-ში დოკუმენტების სკანირება შეუძლებელია: %r" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "სახელის პრეფიქსი ნიმუშებისა და სტატიკის საქაღალდეებისთვის" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "დომენი %r რეგისტრირებული არაა" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "პროექტს სახელი აგებულ დოკუმენტაციაში რამდენიმე ადგილას გამოჩნდება." -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "დოკუმენტი არც ერთ სარჩევის ხეში ჩასმული არაა" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "პროექტის სახელი" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "აღმოჩენილია თვითმიმართვადი სარჩევის ხე. გამოტოვებულია." +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "ავტორის სახელები" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "წაკითხვის შეცდომა: %s, %s" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "პროექტის ვერსია" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "ჩაწერის შეცდომა: %s, %s" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "პროექტის რელიზი" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "პროექტის ენა" -#: util/i18n.py:245 -#, python-format +#: cmd/quickstart.py:340 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:350 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "თქვენი მთავარი დოკუმენტის სახელი (სუფიქსს გარეშე)" -#: util/nodes.py:706 +#: cmd/quickstart.py:368 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: util/display.py:82 -msgid "skipped" -msgstr "გამოტოვებული" - -#: util/display.py:87 -msgid "failed" -msgstr "შეცდომით" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart არსებულ ფაილებს თავზე არ გადააწერს." -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:378 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" -msgstr "უცნობი კვანძის ტიპი: %r" - -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:407 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "შევქმნა Makefile? (y(დიახ)/n(არა))" -#: util/rst.py:73 +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "შევქმნა Windows-ის ბრძანებების ფაილი? (y(დიახ)/n(არა))" + +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "default role %s not found" -msgstr "ნაგულისხმევი როლი %s ვერ ვიპოვე" +msgid "Creating file %s." +msgstr "ფაილის შექმნა %s." -#: util/inventory.py:147 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" +msgid "File %s already exists, skipping." +msgstr "ფაილი %s უკვე არსებობს. ის გამოტოვებული იქნება." -#: util/inventory.py:166 +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "დასრულდა: საწყისი საქაღალდეების სტრუქტურა შეიქმნა." + +#: cmd/quickstart.py:520 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "სქოლიოები" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: cmd/quickstart.py:531 #, python-format -msgid "[image: %s]" -msgstr "[გამოსახულება: %s]" - -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "ინდექსი" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:573 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "წარწერა ფიგურის შიგნით არაა." +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "ჩუმი რეჟიმი" -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "განუხორციელებელი კვანძის ტიპი: %r" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "პროექტის საწყისი საქაღალდე" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "სტრუქტურის მორგება" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "ენისთვის %r Babel-ის პარამეტრი ცნობილი არაა" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "თუ მითითებულია, კოდის და აგების საქაღალდეები ცალ-ცალკე იქნება" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "ძალიან დიდი :maxdepth:. გამოტოვება." +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "თუ მითითებულია, აგების საქაღალდე კოდის საქაღალდეში იქნება" -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "დოკუმენტის სათაური ერთი ტექსტური კვანძი არაა" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "პროექტის ძირითადი პარამეტრები" -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "პროექტის დასახელება" -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "ავტორის სახელები" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "ზომის ერთეული %s არასწორია. გამოტოვება." +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "პროექტის ვერსია" -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "აღმოჩენილია ინდექსის ჩანაწერის უცნობი ტიპი %s" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "პროექტის რელიზი" -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "არასწორი math_eqref_format: %r" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "დოკუმენტის ენა" -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "წყაროს ფაილის სუფიქსი" -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "numfig_format-ი %s-სთვის აღწერილი არაა" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "მთავარი დოკუმენტის სახელი" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "epub-ის გამოყენება" + +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "გაფართოების პარამეტრები" -#: writers/html5.py:441 +#: cmd/quickstart.py:671 #, python-format -msgid "Any IDs not assigned for %s node" -msgstr "ნებისმიერი ID, რომელიც %s კვანძზე მინიჭებული არაა" +msgid "enable %s extension" +msgstr "%s გაფართოების ჩართვა" -#: writers/html5.py:496 -msgid "Link to this term" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Makefile და Batchfile-ის შექმნა" -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "makefile-ის შექმნა" -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "makefile-ის არ შეიქმნება" -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "batchfile-ის შექმნა" -#: writers/html5.py:640 -msgid "Link to this toctree" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "batchfile-ი არ შეიქმნება" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "გამოსახულების ზომის მიღება შეუძლებელია. :scale: მოხდება პარამეტრის გამოტოვება." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "პროექტის ნიმუშები" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "ნიმუშების საქაღალდე ნიმუშის ფაილებისთვის" -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "აღწერეთ სანიმუშე ცვლადი" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s () (ჩაშენებული ფუნქცია)" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s () (%s მეთოდი)" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "" -#: domains/javascript.py:185 +#: cmd/quickstart.py:810 #, python-format -msgid "%s() (class)" -msgstr "%s () (კლასი)" +msgid "Invalid template variable: %s" +msgstr "არასწორი ნიმუშის ცვლადი: %s" -#: domains/javascript.py:187 +#: directives/other.py:119 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s (გლობალური ცვლადი ან მუდმივა)" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s ატრიბუტი)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "არგუმენტები" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "ისვრის" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "აბრუნებს" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "დაბრუნების ტიპი" +msgid "toctree contains reference to excluded document %r" +msgstr "" -#: domains/javascript.py:370 +#: directives/other.py:156 #, python-format -msgid "%s (module)" -msgstr "%s (მოდული)" +msgid "toctree contains reference to nonexisting document %r" +msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "ფუნქცია" +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "აღმოჩენილია დუბლირებული სარჩევის ჩანაწერი: %s" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "მეთოდი" +#: directives/other.py:203 +msgid "Section author: " +msgstr "სექციის ავტორი: " -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "კლასი" +#: directives/other.py:205 +msgid "Module author: " +msgstr "მოდულის ავტორი: " -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "მონაცემები" +#: directives/other.py:207 +msgid "Code author: " +msgstr "კოდის ავტორი: " -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "ატრიბუტი" +#: directives/other.py:209 +msgid "Author: " +msgstr "ავტორი: " -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "მოდული" +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "ცვლილებები ვერსიაში %s" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "" -#: domains/changeset.py:28 +#: directives/code.py:87 #, python-format -msgid "Deprecated since version %s" -msgstr "მოძველებულია ვერსიაში %s" +msgid "Invalid caption: %s" +msgstr "არასწორი წარწერა: %s" -#: domains/changeset.py:29 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "Removed in version %s" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 +#: directives/code.py:216 #, python-format -msgid "%s (directive)" -msgstr "%s (დირექტივა)" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "\"%s\" და \"%s\" პარამეტრების ერთდროული გამოყენება შეუძლებელია" -#: domains/rst.py:191 domains/rst.py:202 +#: directives/code.py:231 #, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (დირექტივის პარამეტრი)" +msgid "Include file '%s' not found or reading it failed" +msgstr "" -#: domains/rst.py:224 +#: directives/code.py:235 #, python-format -msgid "%s (role)" -msgstr "%s (როლი)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "დირექტივა" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "დირექტივის-პარამეტრი" - -#: domains/rst.py:236 -msgid "role" -msgstr "როლები" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" -#: domains/rst.py:262 +#: directives/code.py:276 #, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "%s %s-ის დუბლირებული აღწერა. სხვა ასლი %s-შია" +msgid "Object named %r not found in include file %r" +msgstr "ობიექტი სახელად %r ჩასასმელი ფაილში %r აღმოჩენილი არაა" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: domains/citation.py:92 +#: directives/code.py:314 #, python-format -msgid "Citation [%s] is not referenced." +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "ყურადღება" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "გაფრთხილება" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "საფრთხე" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "შეცდომა" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "მინიშნება" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "ინდექსი" -#: locale/__init__.py:233 -msgid "Important" -msgstr "მნიშვნელოვანი" +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "ნოტი" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "სქოლიოები" -#: locale/__init__.py:235 -msgid "See also" -msgstr "ასევე იხილეთ" +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "წარწერა ფიგურის შიგნით არაა." -#: locale/__init__.py:236 -msgid "Tip" -msgstr "რჩევა" +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "განუხორციელებელი კვანძის ტიპი: %r" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "ყურადღება" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[გამოსახულება: %s]" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" +msgstr "numfig_format-ი %s-სთვის აღწერილი არაა" + +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "ნებისმიერი ID, რომელიც %s კვანძზე მინიჭებული არაა" + +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "დოკუმენტაციის დაფარვის შემოწმება" +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "მათემატიკის ჩასმა, რომელიც PNG ან SVG გამოსახულების სახითაა დარენდერებული" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "ბრაუზერში MathJax-ის მიერ დარენდერებული მათემატიკის ჩასმა" +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "გამოსახულების ზომის მიღება შეუძლებელია. :scale: მოხდება პარამეტრის გამოტოვება." + +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "გთხოვთ შეიყვანოთ ბილიკის სწორი სახელი." +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" +msgstr "ენისთვის %r Babel-ის პარამეტრი ცნობილი არაა" -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "შეიყვანეთ რაიმე ტექსტი." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "ძალიან დიდი :maxdepth:. გამოტოვება." -#: cmd/quickstart.py:133 +#: writers/latex.py:616 #, python-format -msgid "Please enter one of %s." -msgstr "შეიყვანეთ %s-დან ერთ-ერთი." +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "შეიყვანეთ 'y' (დიახ) ან 'n' (არა)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "დოკუმენტის სათაური ერთი ტექსტური კვანძი არაა" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "მიუთითეთ ფაილის სუფიქსი. მაგ: '.rst' ან '.txt'." +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "" -#: cmd/quickstart.py:229 +#: writers/latex.py:1228 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "მოგესალმებით Sphinx %s-ის სწრაფი მორგების პროგრამა." - -#: cmd/quickstart.py:234 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:241 +#: writers/latex.py:1615 #, python-format -msgid "Selected root path: %s" -msgstr "არჩეული root ბილიკი: %s" +msgid "dimension unit %s is invalid. Ignored." +msgstr "ზომის ერთეული %s არასწორია. გამოტოვება." -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "შეიყვანეთ დოკუმენტაციის ძირითადი ბილიკი." +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "აღმოჩენილია ინდექსის ჩანაწერის უცნობი ტიპი %s" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "დოკუმენტაციის ძირითადი ბილიკი" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "შეცდომა: არჩეულ ძირითად ბილიკზე აღმოჩენილია არსებული conf.py ფაილი." +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart-ი არსებულ Sphinx-ის პროექტებს თავზე არ გადააწერს." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "შეიყვანეთ ახალი საწყისი ბილიკი (გასასვლელად უბრალოდ დააწექით ღილაკს 'Enter')" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "კოდის და აგების საქაღალდეები განსხვავდება? (y(დიახ)/n(არა))" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: cmd/quickstart.py:286 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "სახელის პრეფიქსი ნიმუშებისა და სტატიკის საქაღალდეებისთვის" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "პროექტს სახელი აგებულ დოკუმენტაციაში რამდენიმე ადგილას გამოჩნდება." +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "პროექტის სახელი" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "ავტორის სახელები" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "პროექტის ვერსია" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "პროექტის რელიზი" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "პროექტის ენა" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: cmd/quickstart.py:339 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:349 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "თქვენი მთავარი დოკუმენტის სახელი (სუფიქსს გარეშე)" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" -#: cmd/quickstart.py:367 +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" + +#: transforms/__init__.py:258 #, python-format msgid "" -"Error: the master file %s has already been found in the selected root path." +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart არსებულ ფაილებს თავზე არ გადააწერს." +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "ნაკვალევი [%s] მიმართული არაა." -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" + +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "ნაკვალევი [#] მიმართული არაა." + +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" + +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" + +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "წაკითხვის შეცდომა: %s, %s" + +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "ჩაწერის შეცდომა: %s, %s" + +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:396 +#: util/i18n.py:253 +#, python-format msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:406 +#: util/osutil.py:131 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "შევქმნა Makefile? (y(დიახ)/n(არა))" +#: util/display.py:82 +msgid "skipped" +msgstr "გამოტოვებული" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "შევქმნა Windows-ის ბრძანებების ფაილი? (y(დიახ)/n(არა))" +#: util/display.py:87 +msgid "failed" +msgstr "შეცდომით" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: util/docutils.py:325 #, python-format -msgid "Creating file %s." -msgstr "ფაილის შექმნა %s." +msgid "unknown directive name: %s" +msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: util/docutils.py:361 #, python-format -msgid "File %s already exists, skipping." -msgstr "ფაილი %s უკვე არსებობს. ის გამოტოვებული იქნება." +msgid "unknown role name: %s" +msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "დასრულდა: საწყისი საქაღალდეების სტრუქტურა შეიქმნა." +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "უცნობი კვანძის ტიპი: %r" -#: cmd/quickstart.py:519 +#: util/fileutil.py:76 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:530 +#: util/docfields.py:103 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "ნაგულისხმევი როლი %s ვერ ვიპოვე" -#: cmd/quickstart.py:572 +#: util/nodes.py:462 +#, python-format msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "მეტი ინფორმაციის მისაღებად ეწვიეთ ." - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "ჩუმი რეჟიმი" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "პროექტის საწყისი საქაღალდე" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "სტრუქტურის მორგება" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "თუ მითითებულია, კოდის და აგების საქაღალდეები ცალ-ცალკე იქნება" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "თუ მითითებულია, აგების საქაღალდე კოდის საქაღალდეში იქნება" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "პროექტის ძირითადი პარამეტრები" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "პროექტის დასახელება" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "ავტორის სახელები" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "პროექტის ვერსია" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "პროექტის რელიზი" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "დოკუმენტის ენა" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "წყაროს ფაილის სუფიქსი" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "მთავარი დოკუმენტის სახელი" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "epub-ის გამოყენება" - -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "გაფართოების პარამეტრები" - -#: cmd/quickstart.py:670 +#: util/nodes.py:739 #, python-format -msgid "enable %s extension" -msgstr "%s გაფართოების ჩართვა" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Makefile და Batchfile-ის შექმნა" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "makefile-ის შექმნა" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "წინა გვერდიდან" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "makefile-ის არ შეიქმნება" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "გრძელდება შემდეგ გვერდზე" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "batchfile-ის შექმნა" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "არაანბანური" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "batchfile-ი არ შეიქმნება" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "სიმბოლოები" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "რიცხვები" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "პროექტის ნიმუშები" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "პანელი" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "ნიმუშების საქაღალდე ნიმუშის ფაილებისთვის" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "გამოცემა" -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "აღწერეთ სანიმუშე ცვლადი" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "დაშორებული გამოსახულების მიღების შეცდომა: %s [%s]" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "დაშორებული გამოსახულების მიღების შეცდომა: %s [%d]" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "უცნობი გამოსახულების ფორმატი: %s..." -#: cmd/quickstart.py:792 +#: transforms/post_transforms/__init__.py:88 msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "Invalid template variable: %s" -msgstr "არასწორი ნიმუშის ცვლადი: %s" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "დავალების ნომერი დადებითი რიცხვი უნდა იყოს" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "ბილიკი დოკუმენტაციის კოდის ფაილებამდე" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "ბილიკი გამოტანის საქაღალდემდე" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s მიმართვის სამიზნე ვერ ვიპოვე: %s" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r მიმართვის სამიზნე ვერ ვიპოვე: %s" -#: cmd/build.py:114 -msgid "general options" -msgstr "ზოგადი პარამეტრები" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "შეწყდა!" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "ყველა ფაილის ჩაწერა (ნაგულისხმევი: მხოლოდ ახალი და შეცვლილი ფაილების ჩაწერა)" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "შენახული გარემო გამოყენებული არ იქნება. ყოველთვის მოხდება ყველა ფაილის წაკითხვა" - -#: cmd/build.py:150 -msgid "path options" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:157 +#: _cli/util/errors.py:207 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "კონფიგურაციის ფაილის პარამეტრის გადაფარვა" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "მნიშვნელობის გადაცემა HTML ნიმუშებში" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/build.py:212 -msgid "console output options" -msgstr "კონსოლის გამოტანის პარამეტრები" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "გვერდითი ზოლის ჩაკეცვა" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "დიაგნოსტიკური შეტყობინებების სიხშირის გაზრდა (შეგიძლიათ, გაიმეოროთ)" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "ნავიგაცია" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "stdout-ზე გამოტანილი არაფერი იქნება. მხოლოდ გაფრთხილებები, stderr-ზე" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "%(docstitle)s-ში ძებნა" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "არაფრი გამოტანა. გაფრთხილებებისაც კი" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "ამ დოკუმენტების შესახებ" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "ფერადი გამოტანის ჩართვა (ნაგულისხმევი: ავტომატურად-აღმოჩენა)" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "ძებნა" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "ფერადი გამოტანის გამორთვა (ნაგულისხმევი: ავტომატურად-აღმოჩენა)" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "საავტორო უფლებები" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "გაფრთხილებების (და შეცდომების) მითითებულ ფაილში ჩაწერა" - -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "გაფრთხილებების შეცდომად აღქმა" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "ბოლო განახლების დრო %(last_updated)s." -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "გამონაკლისისას Pdb-ის გაშვება" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "წინა თემა" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "წინა თავი" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "-a პარამეტრის და ფაილის სახელების ერთად მითითება შეუძლებელია" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "შემდეგი თემა" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "შემდეგი თავი" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "სრული ინდექსი ერთ გვერდზე" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "გვერდითი ზოლის ჩაკეცვა" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "ეს გვერდი" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "სარჩევი" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "წყაროს ჩვენება" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "ძებნა" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "სწრაფი ძებნა" #: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 #: themes/basic/searchfield.html:12 msgid "Go" msgstr "გადასვლა" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "წყაროს ჩვენება" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "შიგთავსი" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "%(docstitle)s-შ ძებნა" - #: themes/basic/defindex.html:4 msgid "Overview" msgstr "მიმოხილვა" @@ -2681,7 +2881,7 @@ msgstr "გლობალური მოდულების ინდექ msgid "quick access to all modules" msgstr "სწრაფი წვდომა ყველა მოდულთან" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "ზოგადი ინდექსი" @@ -2689,23 +2889,15 @@ msgstr "ზოგადი ინდექსი" msgid "all functions, classes, terms" msgstr "ყველა ფუნქცია, კლასი, წესი" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "ეს გვერდი" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "სარჩევი" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "სრული ინდექსი ერთ გვერდზე" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "სწრაფი ძებნა" +msgid "Search %(docstitle)s" +msgstr "%(docstitle)s-შ ძებნა" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2715,57 +2907,6 @@ msgstr "ინდექსის გვერდები ასოების msgid "can be huge" msgstr "შეიძლება უზარმაზარი იყოს" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "წინა თემა" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "წინა თავი" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "შემდეგი თემა" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "შემდეგი თავი" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "ნავიგაცია" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "%(docstitle)s-ში ძებნა" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "ამ დოკუმენტების შესახებ" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "საავტორო უფლებები" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "ბოლო განახლების დრო %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "ძებნა" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "ძებნის დამთხვევების დამალვა" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "შიგთავსი" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "ძებნს შედეგები" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2804,22 +2945,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "ძებნა" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "ძებნის მომზადება..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "ძებნის დამთხვევების დამალვა" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2827,6 +2967,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2848,120 +2993,127 @@ msgstr "სხვა ცვლილებები" msgid "Expand sidebar" msgstr "გვერდითი ზოლის გაფართოება" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "პარამეტრები" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "ცვლადები" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "გამონაკლისები" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s () (მოდულში %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (მოდულში %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (ჩაშენებული ცვლადი)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (ჩაშენებული კლასი)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (კლასი %s-ში)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s () (%s კლასის მეთოდი)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s () (%s სტატიკური მეთოდი)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (%s თვისება)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python-ის მოდულის ინდექსი" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "მოდულები" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "მოძველებულია" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "გამონაკლისი" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "კლასის მეთოდი" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "სტატიკური მეთოდი" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "თვისება" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (მოძველებული)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "პარამეტრები" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "ცვლადები" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "გამონაკლისები" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2972,746 +3124,526 @@ msgstr "შაბლონის პარამეტრები" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "დაბრუნებული მნიშვნელობები" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" -msgstr "გაერთიანება" - -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 -msgid "member" -msgstr "წვერი" - -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 -msgid "type" -msgstr "ტიპი" - -#: domains/cpp/__init__.py:944 -msgid "concept" -msgstr "კონცეფცია" - -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 -msgid "enum" -msgstr "ჩამონათვალი" - -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 -msgid "enumerator" -msgstr "დამთვლელი" - -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 -msgid "function parameter" -msgstr "ფუნქციის პარამეტრი" - -#: domains/cpp/__init__.py:952 -msgid "template parameter" -msgstr "შაბლონის პარამეტრი" - -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 -#, python-format -msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "ცვლადი" - -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "მაკრო" - -#: domains/c/__init__.py:753 -msgid "struct" -msgstr "სტრუქტურა" - -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "გარემოს ცვლადი; %s" - -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "%s ბრძანების სტრიქონის პარამეტრი" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "ბრძანების სტრიქონის ვარიანტი" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "სარჩევის ელემენტებს წინ ცარიელი ხაზი უნდა იყოს" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "სარჩევის ელემენტები ცარიელი ხაზებით უნდა გამოყოთ" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "სარჩევის ფორმატი არასწორია. გადაამოწმეთ შეწევა" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "სარჩევის ელემენტი" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "გრამატიკის კოდი" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "მიმართვის ჭდე" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "გარემოს ცვლადი" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "პროგრამის პარამეტრი" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "დოკუმენტი" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "მოდულის ინდექსი" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "დუბლირებული %s აღწერისთვის %s. სხვა ასლი %s-შია" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "numfig გამორთულია. :numref: გამოტოვებული იქნება." - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "ბმულს წარწერა არ გააჩნია: %s" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "არასწორი numfig_format: %s (%r)" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "არასწორი numfig_format: %s" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "აღუწერელი ჭდე: %r" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "აღმოჩენილია სარჩევის ხის წრიული მიმართვები. გამოტოვებული იქნება: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "სარჩევის ხე შეიცავს მიმართვას დოკუმენტამდე %r, რომელსაც სათაური არ გააჩნია. ბმული არ შეიქმნება" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "სარჩევის ხე არ-ჩართულ დოკუმენტამდე, %r, მიმართვას შეიცავს" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "იხილეთ %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "აგრეთვე იხილეთ %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "უცნობი ინდექსის ჩანაწერის ტიპი %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "სიმბოლოები" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "გამოსახულების ფაილი წაკითხვადი არაა: %s" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "გამოსახულების ფაილი %s წაკითხვადი არაა: %s" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "გადმოწერილი ფაილი წაკითხვადი არაა: %s" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "შეწყდა!" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +msgstr "გაერთიანება" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" +msgstr "წვერი" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "ტიპი" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "კონცეფცია" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 +msgid "enum" +msgstr "ჩამონათვალი" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 +msgid "enumerator" +msgstr "დამთვლელი" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 +msgid "function parameter" +msgstr "ფუნქციის პარამეტრი" -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "" +#: domains/cpp/__init__.py:954 +msgid "template parameter" +msgstr "შაბლონის პარამეტრი" -#: transforms/post_transforms/__init__.py:299 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s მიმართვის სამიზნე ვერ ვიპოვე: %s" +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." +msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/c/__init__.py:211 #, python-format -msgid "%r reference target not found: %s" -msgstr "%r მიმართვის სამიზნე ვერ ვიპოვე: %s" +msgid "%s (C %s)" +msgstr "%s (C %s)" -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "დაშორებული გამოსახულების მიღების შეცდომა: %s [%s]" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "ცვლადი" -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "დაშორებული გამოსახულების მიღების შეცდომა: %s [%d]" +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "მაკრო" -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." -msgstr "უცნობი გამოსახულების ფორმატი: %s..." +#: domains/c/__init__.py:781 +msgid "struct" +msgstr "სტრუქტურა" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "HTML გვერდების საქაღალდეა %(outdir)s." +msgid "environment variable; %s" +msgstr "გარემოს ცვლადი; %s" -#: builders/html/__init__.py:348 +#: domains/std/__init__.py:116 #, python-format -msgid "Failed to read build info file: %r" -msgstr "აგების ინფორმაციის ფაილის წაკითხვის შეცდომა: %r" +msgid "%s; configuration value" +msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: builders/html/__init__.py:383 +#: domains/std/__init__.py:239 #, python-format msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "ინდექსი" - -#: builders/html/__init__.py:560 +#: domains/std/__init__.py:319 #, python-format -msgid "Logo of %s" -msgstr "" +msgid "%s command line option" +msgstr "%s ბრძანების სტრიქონის პარამეტრი" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "შემდეგი" +#: domains/std/__init__.py:321 +msgid "command line option" +msgstr "ბრძანების სტრიქონის ვარიანტი" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "წინა" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" +msgstr "სარჩევის ელემენტებს წინ ცარიელი ხაზი უნდა იყოს" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "ინდექსების გენერაცია" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" +msgstr "სარჩევის ელემენტები ცარიელი ხაზებით უნდა გამოყოთ" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "დამატებითი გვერდების ჩაწერა" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "სარჩევის ფორმატი არასწორია. გადაამოწმეთ შეწევა" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "სარჩევის ელემენტი" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "გადმოწერადი ფაილების კოპირება... " +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "გრამატიკის კოდი" + +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "მიმართვის ჭდე" + +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "გარემოს ცვლადი" + +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "პროგრამის პარამეტრი" + +#: domains/std/__init__.py:735 +msgid "document" +msgstr "დოკუმენტი" + +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "მოდულის ინდექსი" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "გადმოწერადი ფაილის %r კოპირების შეცდომა:%s" +msgid "duplicate %s description of %s, other instance in %s" +msgstr "დუბლირებული %s აღწერისთვის %s. სხვა ასლი %s-შია" + +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "numfig გამორთულია. :numref: გამოტოვებული იქნება." -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1124 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "ფაილის html_static_file-ში კოპირებს შეცდომა: %s: %r" +msgid "the link has no caption: %s" +msgstr "ბმულს წარწერა არ გააჩნია: %s" -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "სტატიკური ფაილების კოპირება" +#: domains/std/__init__.py:1153 +#, python-format +msgid "invalid numfig_format: %s (%r)" +msgstr "არასწორი numfig_format: %s (%r)" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1157 #, python-format -msgid "cannot copy static file %r" -msgstr "სტატიკური ფაილის %r კოპირების შეცდომა" +msgid "invalid numfig_format: %s" +msgstr "არასწორი numfig_format: %s" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "დამატებითი ფაილების კოპირება" +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" +msgstr "აღუწერელი ჭდე: %r" -#: builders/html/__init__.py:949 +#: domains/std/__init__.py:1456 #, python-format -msgid "cannot copy extra file %r" -msgstr "დამატებითი ფაილის %r კოპირების შეცდომა" +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Failed to write build info file: %r" -msgstr "აგების ინფორმაციის ფაილის ჩაწერის შეცდომა: %r" +msgid "invalid value set (missing closing brace): %s" +msgstr "არასწორი მნიშვნელობების ნაკრები (აკლია დამხურავი ფრჩხილი): %s" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "ძებნის ინდექსის ჩატვირთვა შეუძლებელია, მაგრამ ყველა დოკუმენტის აგება არ მოხდება: ინდექსი დაუსრულებელი იქნება." +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" +msgstr "არასწორი მნიშვნელობების ნაკრები (აკლია გამხსნელი ფრჩხილი): %s" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "შეცდომა %s გვერდის რენდერისას.\nმიზეზი: %r" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "მაგალითი" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "ობიექტის ინვენტარის დამპი" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "მაგალითები" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "%s-ში არსებული ძებნის ინდექსის დამპი" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "საკვანძო სიტყვების არგუმენტები" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "არასწორი js_file: %r, გამოტოვებულია" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "ჩანაწერები" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "სხვა პარამეტრები" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "მითითებული math_renderer %r უცნობია." +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "იღებს" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "html_extra_path ჩანაწერი %r გამოტანის საქაღალდეშია" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "ბმები" -#: builders/html/__init__.py:1365 +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "გაფრთხილებები" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "html_extra_path ჩანაწერი %r არ არსებობს" +msgid "A mocked object is detected: %r" +msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "html_static_path ჩანაწერი %r გამოტანის საქაღალდეშია" +msgid "alias of %s" +msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" -msgstr "html_static_path ჩანაწერი %r არ არსებობს" +msgid "Bases: %s" +msgstr "ძირითადი კლასები: %s" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" -msgstr "ლოგოს ფაილი %r არ არსებობს" +msgid "invalid value for member-order option: %s" +msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" -msgstr "favicon ფაილი %r არ არსებობს" +msgid "invalid value for class-doc-from option: %s" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "%s %s დოკუმენტაცია" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "LaTeX-ის ფაილების საქაღალდეა %(outdir)s." +msgid "Would create file %s." +msgstr "შეიქმნებოდა ფაილი %s." -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "ბილიკი მოდულიდან დოკუმენტამდე" + +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "გამოცემა" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "მიმდინარეობს TeX-ის მხარდაჭერის ფაილების კოპირება" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "არსებულ ფაილებზე გადაწერა" -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "დამატებითი ფაილების კოპირება" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "უცნობი კონფიგურაციის პარამეტრი: latex_elements[%r]. გამოტოვება." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "სკრიპტის ფაილების შექმნის გარეშე გაშვება" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "უცნობი თემის პარამეტრი: latex_theme_options[%r]. გამოტოვება." +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "\"_private\" მოდულების ჩასმა" + +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "სარჩევის ფაილი არ შეიქმნება" + +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r-ს პარამეტრი \"theme\" არ აქვს" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r-ს \"%s\" პარამეტრი არ აქვს" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "წინა გვერდიდან" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "ფაილის სუფიქსი (ნაგულისხმევი: rst)" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "გრძელდება შემდეგ გვერდზე" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "არაანბანური" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "sphinx-quickstart-ით სრული პროექტის გენარაცია" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "რიცხვები" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "როცა მითითებულია --full, module_path-ი sys.path-ის ბოლოში მიეწერება" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "პანელი" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "პროექტის სახელი (ნაგულისხმევი: ძირითადი მოდულის სახელი)" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "საკვანძო სიტყვების არგუმენტები" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "პროექტის ავტორ(ებ)-ი. გამოიყენება, როცა მიუთითებთ პარამეტრს --full" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "არასწორი მნიშვნელობების ნაკრები (აკლია დამხურავი ფრჩხილი): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "პროექტის ვერსია. გამოიყენება, როცა მითითებულია --full" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "არასწორი მნიშვნელობების ნაკრები (აკლია გამხსნელი ფრჩხილი): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "პროექტის რელიზი. გამოიყენება, როცა მითითებულია --full. ნაგულისხმებ მნიშვნელობაა იგივე, რაც --doc-version" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "გაფართოების პარამეტრები" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "მაგალითი" - -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "მაგალითები" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "ჩანაწერები" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "%s საქაღალდეს არ წარმოადგენს." -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "სხვა პარამეტრები" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "იღებს" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" +msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "ბმები" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "გაფრთხილებები" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" -msgstr "სახელის %s დამუშავების შეცომა" +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" -msgstr "ობიექტის %s შემოტანის შეცდომა" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" -msgstr "autosummary_generate: ფაილი ვერ ვიპოვე: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] %s-ში ჩაწერა" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3719,7 +3651,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3734,481 +3666,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "rST ფაილების დასაგენერირებელიკოდის ფაილები" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "გამოტანის ჩასაწერი საქაღალდე" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "ფაილის ნაგულიხმევი სუფიქსი (ნაგულისხმევი: %(default)s)" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "მომხმარებლის ნიმუშების საქაღალდე (ნაგულისხმევი: %(default)s)" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "ბილიკი მოდულიდან დოკუმენტამდე" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" +msgstr "ობიექტის %s შემოტანის შეცდომა" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" +msgstr "autosummary_generate: ფაილი ვერ ვიპოვე: %s" + +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "არსებულ ფაილებზე გადაწერა" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:83 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "სკრიპტის ფაილების შექმნის გარეშე გაშვება" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "\"_private\" მოდულების ჩასმა" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "სარჩევის ფაილი არ შეიქმნება" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "ფაილის სუფიქსი (ნაგულისხმევი: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "sphinx-quickstart-ით სრული პროექტის გენარაცია" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" +msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "როცა მითითებულია --full, module_path-ი sys.path-ის ბოლოში მიეწერება" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "პროექტის სახელი (ნაგულისხმევი: ძირითადი მოდულის სახელი)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "პროექტის ავტორ(ებ)-ი. გამოიყენება, როცა მიუთითებთ პარამეტრს --full" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "პროექტის ვერსია. გამოიყენება, როცა მითითებულია --full" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "პროექტის რელიზი. გამოიყენება, როცა მითითებულია --full. ნაგულისხმებ მნიშვნელობაა იგივე, რაც --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "გაფართოების პარამეტრები" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_loader.py:193 #, python-format -msgid "%s is not a directory." -msgstr "%s საქაღალდეს არ წარმოადგენს." +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "%r-სთვის ხელმოწერის განახლების შეცდომა: პარამეტრი ვერ ვიპოვე: %s" + +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "%s-ზე აღმოჩენილია არასწორი __slots__: გამოტოვებულია." + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a method signature for %s: %s" +msgstr "%s-სთვის მეთოდის ხელმოწერის მიღება შეუძლებელია: %s" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to parse a default argument value for %r: %s" +msgstr "%r-სთვის ნაგულისხმევი არგუმენტის მნიშვნელობის დამუშავების შეცდომა: %s" + +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "ატრიბუტი %s ობიექტში %s აღმოჩენილი არაა" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "მეტსახელი TypeVar(%s)-სთვის" + +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:114 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "HTML გვერდების საქაღალდეა %(outdir)s." -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:337 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to read build info file: %r" +msgstr "აგების ინფორმაციის ფაილის წაკითხვის შეცდომა: %r" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "ინდექსი" + +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_generate.py:69 -#, python-format -msgid "Would create file %s." -msgstr "შეიქმნებოდა ფაილი %s." +#: builders/html/__init__.py:578 +msgid "next" +msgstr "შემდეგი" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s v%s)" -msgstr "(%s v%s-ში)" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "წინა" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" -msgstr "" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "ინდექსების გენერაცია" -#: ext/intersphinx/_resolve.py:108 -#, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "დამატებითი გვერდების ჩაწერა" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "გადმოწერადი ფაილების კოპირება... " + +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "გადმოწერადი ფაილის %r კოპირების შეცდომა:%s" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "ფაილის html_static_file-ში კოპირებს შეცდომა: %s: %r" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "სტატიკური ფაილების კოპირება" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "" +msgid "cannot copy static file %r" +msgstr "სტატიკური ფაილის %r კოპირების შეცდომა" + +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "დამატებითი ფაილების კოპირება" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "cannot copy extra file %r" +msgstr "დამატებითი ფაილის %r კოპირების შეცდომა" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "აგების ინფორმაციის ფაილის ჩაწერის შეცდომა: %r" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "ძებნის ინდექსის ჩატვირთვა შეუძლებელია, მაგრამ ყველა დოკუმენტის აგება არ მოხდება: ინდექსი დაუსრულებელი იქნება." -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "შეცდომა %s გვერდის რენდერისას.\nმიზეზი: %r" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "ობიექტის ინვენტარის დამპი" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +msgid "dumping search index in %s" +msgstr "%s-ში არსებული ძებნის ინდექსის დამპი" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "" +msgid "invalid js_file: %r, ignored" +msgstr "არასწორი js_file: %r, გამოტოვებულია" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." +msgstr "მითითებული math_renderer %r უცნობია." -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1365 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "html_extra_path ჩანაწერი %r გამოტანის საქაღალდეშია" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1370 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "html_extra_path ჩანაწერი %r არ არსებობს" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "html_static_path ჩანაწერი %r გამოტანის საქაღალდეშია" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "" +msgid "html_static_path entry %r does not exist" +msgstr "html_static_path ჩანაწერი %r არ არსებობს" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "" +msgid "logo file %r does not exist" +msgstr "ლოგოს ფაილი %r არ არსებობს" + +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "favicon ფაილი %r არ არსებობს" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" -msgstr "" +msgid "%s %s documentation" +msgstr "%s %s დოკუმენტაცია" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:87 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r-ს პარამეტრი \"theme\" არ აქვს" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/theming.py:90 +#, python-format +msgid "%r doesn't have \"%s\" setting" +msgstr "%r-ს \"%s\" პარამეტრი არ აქვს" + +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "LaTeX-ის ფაილების საქაღალდეა %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 -#, python-format -msgid "Failed to get a function signature for %s: %s" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "მიმდინარეობს TeX-ის მხარდაჭერის ფაილების კოპირება" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "დამატებითი ფაილების კოპირება" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Bases: %s" -msgstr "ძირითადი კლასები: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "უცნობი კონფიგურაციის პარამეტრი: latex_elements[%r]. გამოტოვება." -#: ext/autodoc/__init__.py:1985 +#: builders/latex/__init__.py:537 #, python-format -msgid "missing attribute %s in object %s" -msgstr "ატრიბუტი %s ობიექტში %s აღმოჩენილი არაა" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "უცნობი თემის პარამეტრი: latex_theme_options[%r]. გამოტოვება." -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/toctree.py:259 #, python-format -msgid "alias of %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:98 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "მეტსახელი TypeVar(%s)-სთვის" +msgid "image file not readable: %s" +msgstr "გამოსახულების ფაილი წაკითხვადი არაა: %s" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/collectors/asset.py:126 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "%s-სთვის მეთოდის ხელმოწერის მიღება შეუძლებელია: %s" +msgid "image file %s not readable: %s" +msgstr "გამოსახულების ფაილი %s წაკითხვადი არაა: %s" -#: ext/autodoc/__init__.py:2720 +#: environment/collectors/asset.py:165 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "%s-ზე აღმოჩენილია არასწორი __slots__: გამოტოვებულია." +msgid "download file not readable: %s" +msgstr "გადმოწერილი ფაილი წაკითხვადი არაა: %s" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "%r-სთვის ნაგულისხმევი არგუმენტის მნიშვნელობის დამუშავების შეცდომა: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "აღმოჩენილია სარჩევის ხის წრიული მიმართვები. გამოტოვებული იქნება: %s <- %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "%r-სთვის ხელმოწერის განახლების შეცდომა: პარამეტრი ვერ ვიპოვე: %s" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "სარჩევის ხე შეიცავს მიმართვას დოკუმენტამდე %r, რომელსაც სათაური არ გააჩნია. ბმული არ შეიქმნება" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "სარჩევის ხე არ-ჩართულ დოკუმენტამდე, %r, მიმართვას შეიცავს" + +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" msgstr "" + +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "იხილეთ %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "აგრეთვე იხილეთ %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "უცნობი ინდექსის ჩანაწერის ტიპი %r" diff --git a/sphinx/locale/ko/LC_MESSAGES/sphinx.mo b/sphinx/locale/ko/LC_MESSAGES/sphinx.mo index 0d85ed47b89..2792bbca36b 100644 Binary files a/sphinx/locale/ko/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ko/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/ko/LC_MESSAGES/sphinx.po b/sphinx/locale/ko/LC_MESSAGES/sphinx.po index e3bde07f941..b3ed54352c2 100644 --- a/sphinx/locale/ko/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/ko/LC_MESSAGES/sphinx.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: YT H , 2019-2022\n" "Language-Team: Korean (http://app.transifex.com/sphinx-doc/sphinx-1/language/ko/)\n" @@ -20,6 +20,127 @@ msgstr "" "Language: ko\n" "Plural-Forms: nplurals=1; plural=0;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python 향상 제안; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "잘못된 PEP 번호 %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "잘못된 RFC 번호 %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "검색된 테마 구성에서 %s.%s 설정이 존재하지 않습니다" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "지원하지 않는 테마 옵션 %r을(를) 설정했습니다" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "테마 경로의 %r 파일이 유효한 ZIP 파일이 아니거나 테마를 포함하지 않습니다" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -34,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "이 프로젝트에는 최소한 %s 버전의 %s 확장 기능이 필요하므로 로드 된 버전(%s)으로 빌드 할 수 없습니다." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Pygments 구문 분석기 이름 %r을(를) 확인할 수 없습니다" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "이벤트 %r이(가) 이미 존재합니다" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "알 수 없는 이벤트 이름: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "처리기 %r (이벤트 %r에 대한) 에서 예외를 발생했습니다" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "원본 디렉토리를 찾을 수 없습니다 (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "출력 디렉토리 %s은(는) 디렉토리가 아닙니다." -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "원본 디렉토리와 대상 디렉토리는 같을 수 없습니다" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx 버전 %s 실행 중" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "이 프로젝트는 최소 Sphinx 버전 %s이(가) 필요하므로 현재 버전으로 빌드할 수 없습니다." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "출력 디렉토리 만드는 중" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "확장 기능 %s 설정 중:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "현재 conf.py 파일에 정의된 'setup'은 호출 가능한 Python 객체가 아닙니다. 호출 가능한 함수가 되도록 정의를 수정하십시오.\n이것은 conf.py가 Sphinx 확장 기능으로 동작하는 데 필요합니다." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "번역을 불러오는 중 [%s]… " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "완료" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "기본 제공 메시지를 사용할 수 없습니다" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "pickle로 저장된 환경을 불러오는 중" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "실패: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "선택한 빌더가 없으므로, 기본값인 html을 사용합니다" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "%r 노드 클래스가 이미 등록되어 있으며, 방문자를 무시합니다" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +310,12 @@ msgid "" "explicit" msgstr "%s 확장 기능은 병렬 읽기에 안전한지 선언하지 않았으므로, 그렇지 않다고 가정합니다. 확장 기능 작성자에게 확인하고 명시하도록 요청하십시오" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "%s 확장 기능은 병렬 읽기에 안전하지 않습니다" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +323,214 @@ msgid "" "explicit" msgstr "%s 확장 기능은 병렬 쓰기에 안전한지 선언하지 않았으므로, 그렇지 않다고 가정합니다. 확장 기능 작성자에게 확인하고 명시하도록 요청하십시오" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "%s 확장 기능은 병렬 쓰기에 안전하지 않습니다" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "병렬 %s 처리" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "설정 디렉토리에 conf.py 파일이 없습니다 (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "빌더 클래스 %s에 \"name\" 속성이 없습니다" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "%r 빌더가 이미 존재합니다 (%s 모듈에 있음)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "빌더 이름 %s이(가) 등록되지 않았거나 진입점을 통해서만 사용할 수 있습니다" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "빌더 이름 %s이(가) 등록되지 않았습니다" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "%s 영역이 이미 등록되었습니다" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "%s 영역이 아직 등록되지 않았습니다" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "%r 지시문이 %s 영역에 이미 등록되었습니다" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "%r 역할이 %s 영역에 이미 등록되었습니다" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "%r 색인이 %s 영역에 이미 등록되었습니다" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "%r object_type이 이미 등록되었습니다" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "%r crossref_type이 이미 등록되었습니다" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r이(가) 이미 등록되었습니다" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "%r에 대한 source_parser가 이미 등록되었습니다" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "%s에 대한 소스 해석기가 등록되지 않았습니다" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "%r에 대한 변환기가 이미 존재합니다" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "add_node()에 대한 kwargs는 반드시 (visit, depart)의 함수 튜플이어야 합니다: %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r이(가) 이미 등록되었습니다" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "수식 렌더러 %s이(가) 이미 등록되었습니다" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "잘못된 구성 값을 찾았습니다: 'language = None'. 유효한 언어 코드로 구성을 업데이트하십시오. 대신 'en'(영어)을 사용합니다." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "%r 확장 기능은 Sphinx에 버전 %s 이후로 이미 병합되었습니다. 이 확장 기능은 무시됩니다." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "원래 예외:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "확장 기능 %s을(를) 가져올 수 없습니다" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "확장 기능 %r에 setup() 함수가 없습니다. Sphinx 확장 모듈이 맞습니까?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "이 프로젝트에서 사용하는 %s 확장 기능에는 최소한 Sphinx v%s이(가) 필요합니다. 따라서 이 버전으로 빌드 할 수 없습니다." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "확장 기능 %r이(가) setup() 함수에서 지원되지 않는 개체를 반환했습니다. None 또는 메타데이터 dictionary를 반환해야 합니다" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "설정 디렉토리에 conf.py 파일이 없습니다 (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "Dictionary 구성 설정 %r을(를) 재정의할 수 없으며, 무시합니다 (개별 요소를 설정하기 위해 %r 사용)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "숫자 %r이(가) 설정값 %r에 대해 유효하지 않으며, 무시합니다" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "지원되지 않는 유형의 구성 설정 %r을(를) 재정의 할 수 없으며, 무시합니다" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "재정의 중 알 수 없는 설정값 %r, 무시합니다" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "설정값 %r이(가) 이미 존재합니다" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "잘못된 구성 값을 찾았습니다: 'language = None'. 유효한 언어 코드로 구성을 업데이트하십시오. 대신 'en'(영어)을 사용합니다." + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "구성 파일에 구문 오류가 있습니다: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "구성 파일(또는 가져온 모듈 중 하나)에서 sys.exit()을 호출했습니다" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,547 +538,732 @@ msgid "" "%s" msgstr "구성 파일에 프로그램 오류가 있습니다:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "제 %s 절" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "그림 %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "표 %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "예시 %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "설정값 `{name}`은(는) {candidates} 중 하나여야 하지만, `{current}`이(가) 지정되었습니다." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "설정값 `{name}'은(는) `{current.__name__}' 유형이지만, {permitted} 유형을 기대했습니다." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "설정값 `{name}'은(는) `{current.__name__}' 유형이지만, 기본값은 `{default.__name__}'입니다." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r(이)가 없으므로, 무시합니다." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Pygments 구문 분석기 이름 %r을(를) 확인할 수 없습니다" - -#: highlighting.py:209 -#, python-format +#: config.py:892 msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "새로운 설정" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "검색된 테마 구성에서 %s.%s 설정이 존재하지 않습니다" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "설정이 변경됨" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "지원하지 않는 테마 옵션 %r을(를) 설정했습니다" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "확장 기능이 변경됨" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "테마 경로의 %r 파일이 유효한 ZIP 파일이 아니거나 테마를 포함하지 않습니다" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "빌드 환경 버전이 최신이 아님" -#: theming.py:228 -#, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "원본 디렉토리가 변경됨" -#: theming.py:268 +#: environment/__init__.py:350 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:355 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:282 +#: environment/__init__.py:361 #, python-format -msgid "The %r theme has too many ancestors" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:310 -#, python-format -msgid "no theme configuration file found in %r" -msgstr "" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "이 환경은 선택한 빌더와 호환되지 않습니다. 다른 doctree 디렉토리를 선택하십시오." -#: theming.py:335 theming.py:388 +#: environment/__init__.py:518 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +msgid "Failed to scan documents in %s: %r" +msgstr "%s에서 문서를 탐색하지 못했습니다: %r" -#: theming.py:339 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +msgid "Domain %r is not registered" +msgstr "%r 영역이 등록되지 않았습니다" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "문서가 어느 toctree에도 포함되어 있지 않음" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "자체 참조된 toctree가 발견되었습니다. 무시합니다." -#: theming.py:366 +#: environment/__init__.py:952 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "이벤트 %r이(가) 이미 존재합니다" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "주의" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "알 수 없는 이벤트 이름: %s" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "조심" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "처리기 %r (이벤트 %r에 대한) 에서 예외를 발생했습니다" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "위험" -#: project.py:72 +#: locale/__init__.py:232 +msgid "Error" +msgstr "오류" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "힌트" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "중요" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "참고" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "더 보기" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "팁" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "경고" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Texinfo 파일은 %(outdir)s에 있습니다." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nmakeinfo를 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오\n(자동으로 수행하려면 여기에서 'make info'를 사용하십시오)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "\"texinfo_documents\" 설정값이 없으므로, 문서를 작성하지 않습니다" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "빌더 클래스 %s에 \"name\" 속성이 없습니다" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "\"texinfo_documents\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "%r 빌더가 이미 존재합니다 (%s 모듈에 있음)" +msgid "processing %s" +msgstr "%s 처리 중" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "빌더 이름 %s이(가) 등록되지 않았거나 진입점을 통해서만 사용할 수 있습니다" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "작성 중" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "빌더 이름 %s이(가) 등록되지 않았습니다" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "참조 처리 중…" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "%s 영역이 이미 등록되었습니다" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (문서 " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "%s 영역이 아직 등록되지 않았습니다" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "이미지를 복사하는 중… " -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "%r 지시문이 %s 영역에 이미 등록되었습니다" +msgid "cannot copy image file %r: %s" +msgstr "이미지 파일 %r을(를) 복사할 수 없습니다: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "%r 역할이 %s 영역에 이미 등록되었습니다" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "Texinfo 지원 파일을 복사하는 중" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "%r 색인이 %s 영역에 이미 등록되었습니다" +msgid "error writing file Makefile: %s" +msgstr "Makefile 쓰기 오류: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "%r object_type이 이미 등록되었습니다" +msgid "The manual pages are in %(outdir)s." +msgstr "매뉴얼 페이지는 %(outdir)s에 있습니다." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "%r crossref_type이 이미 등록되었습니다" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "\"man_pages\" 설정값이 없으므로, 매뉴얼 페이지를 작성하지 않습니다" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r이(가) 이미 등록되었습니다" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "\"man_pages\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "%r에 대한 source_parser가 이미 등록되었습니다" +msgid "The HTML page is in %(outdir)s." +msgstr "HTML 페이지는 %(outdir)s에 있습니다." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "%s에 대한 소스 해석기가 등록되지 않았습니다" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "단일 문서 조합 중" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "%r에 대한 변환기가 이미 존재합니다" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "추가 파일 작성 중" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "add_node()에 대한 kwargs는 반드시 (visit, depart)의 함수 튜플이어야 합니다: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "더미 빌더는 파일을 생성하지 않습니다." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r이(가) 이미 등록되었습니다" +msgid "The message catalogs are in %(outdir)s." +msgstr "메시지 카탈로그는 %(outdir)s에 있습니다." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "수식 렌더러 %s이(가) 이미 등록되었습니다" +msgid "building [%s]: " +msgstr "빌드 중 [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "%r 확장 기능은 Sphinx에 버전 %s 이후로 이미 병합되었습니다. 이 확장 기능은 무시됩니다." +msgid "targets for %d template files" +msgstr "%d 개의 템플릿 파일 대상" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "원래 예외:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "템플릿을 읽는 중… " -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "확장 기능 %s을(를) 가져올 수 없습니다" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "메시지 카탈로그 작성 중… " -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "확장 기능 %r에 setup() 함수가 없습니다. Sphinx 확장 모듈이 맞습니까?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "위의 출력 또는 %(outdir)s/output.txt 파일에서 오류를 확인하십시오" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "이 프로젝트에서 사용하는 %s 확장 기능에는 최소한 Sphinx v%s이(가) 필요합니다. 따라서 이 버전으로 빌드 할 수 없습니다." +msgid "broken link: %s (%s)" +msgstr "끊어진 링크: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "확장 기능 %r이(가) setup() 함수에서 지원되지 않는 개체를 반환했습니다. None 또는 메타데이터 dictionary를 반환해야 합니다" +msgid "Anchor '%s' not found" +msgstr "앵커 '%s'을(를) 찾을 수 없습니다" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" - -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" -msgstr "" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "linkcheck_allowed_redirects에서 정규식을 컴파일하지 못했습니다: %r %s" -#: roles.py:251 +#: builders/epub3.py:83 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +msgid "The ePub file is in %(outdir)s." +msgstr "ePub 파일은 %(outdir)s에 있습니다." -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" -msgstr "" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "nav.xhtml 파일 쓰는 중…" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python 향상 제안; PEP %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "설정값 \"epub_language\"(또는 \"language\")는 EPUB3의 경우 비워 둘 수 없습니다" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" -msgstr "잘못된 PEP 번호 %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "설정값 \"epub_uid\"는 EPUB3의 경우 XML 이름이어야 합니다" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" -msgstr "잘못된 RFC 번호 %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "설정값 \"epub_title\"은 EPUB3의 경우 비워 둘 수 없습니다" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[소스]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "설정값 \"epub_author\"는 EPUB3의 경우 비워 둘 수 없습니다" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "모듈 코드 강조 중… " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "설정값 \"epub_contributor\"는 EPUB3의 경우 비워 둘 수 없습니다" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[문서]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "설정값 \"epub_description\"은 EPUB3의 경우 비워 둘 수 없습니다" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "모듈 코드" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "설정값 \"epub_publisher\"는 EPUB3의 경우 비워 둘 수 없습니다" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        %s의 소스 코드

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "설정값 \"epub_copyright\"(또는 \"copyright\")는 EPUB3의 경우 비워 둘 수 없습니다" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "개요: 모듈 코드" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "설정값 \"epub_identifier\"는 EPUB3의 경우 비워 둘 수 없습니다" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        코드를 확인할 수 있는 모든 모듈

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "설정값 \"version\"은 EPUB3의 경우 비워 둘 수 없습니다" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "하드코딩 된 링크 %r은(는) extlink로 대체할 수 있습니다 (대신 %r을(를) 사용해 보십시오)" +msgid "invalid css_file: %r, ignored" +msgstr "잘못된 css_file: %r, 무시합니다" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "" +msgid "The XML files are in %(outdir)s." +msgstr "XML 파일은 %(outdir)s에 있습니다." -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "중복 레이블 %s, 다른 인스턴스는 %s에 있음" - -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "" +msgid "error writing file %s: %s" +msgstr "%s 파일 쓰기 오류: %s" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "====================== 가장 느린 읽기 시간 =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "의사 XML 파일은 %(outdir)s에 있습니다." -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "'%s' 옵션에 '+'나 '-'가 없습니다." +msgid "duplicated ToC entry found: %s" +msgstr "중복된 목차 항목 발견: %s" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s'은(는) 유효한 옵션이 아닙니다." +msgid "cannot read image file %r: copying it instead" +msgstr "이미지 파일 %r을(를) 읽을 수 없으며, 대신 복사합니다" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s'은(는) 유효한 pyversion 옵션이 아닙니다" +msgid "cannot write image file %r: %s" +msgstr "이미지 파일 %r을(를) 기록할 수 없습니다: %s" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "잘못된 TestCode 유형" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow를 찾을 수 없습니다 - 이미지 파일을 복사합니다" -#: ext/doctest.py:297 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "소스에서 doctest 테스트가 완료되었으며, %(outdir)s/output.txt 에서 결과를 확인하십시오." +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "mimetype 파일 쓰는 중…" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "META-INF/container.xml 파일 쓰는 중…" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "content.opf 파일 쓰는 중…" -#: ext/doctest.py:457 +#: builders/_epub_base.py:594 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "%s 블록(%s:%s)에 코드/출력 없음" +msgid "unknown mimetype for %s, ignoring" +msgstr "%s은(는) 알 수 없는 MIME 유형이며, 무시합니다" -#: ext/doctest.py:568 +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "toc.ncx 파일 쓰는 중…" + +#: builders/_epub_base.py:802 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "잘못된 doctest 코드 무시: %r" +msgid "writing %s file..." +msgstr "%s 파일을 기록하는 중…" -#: ext/imgmath.py:162 +#: builders/text.py:27 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "LaTeX 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_latex 설정을 확인하십시오" +msgid "The text files are in %(outdir)s." +msgstr "텍스트 파일은 %(outdir)s에 있습니다." -#: ext/imgmath.py:181 +#: builders/__init__.py:229 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%s 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_%s 설정을 확인하십시오" +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "%s 빌더에 적합한 이미지를 찾을 수 없음: %s (%s)" -#: ext/imgmath.py:344 +#: builders/__init__.py:237 #, python-format -msgid "display latex %r: %s" -msgstr "표시 LaTeX %r: %s" +msgid "a suitable image for %s builder not found: %s" +msgstr "%s 빌더에 적합한 이미지를 찾을 수 없음: %s" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "빌드 중 [mo]: " + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "출력을 쓰는 중… " -#: ext/imgmath.py:380 +#: builders/__init__.py:280 #, python-format -msgid "inline latex %r: %s" -msgstr "인라인 LaTeX %r: %s" +msgid "all of %d po files" +msgstr "모든 %d 개의 po 파일" -#: ext/coverage.py:48 +#: builders/__init__.py:302 #, python-format -msgid "invalid regex %r in %s" -msgstr "잘못된 정규식 %r (%s에서)" +msgid "targets for %d po files that are specified" +msgstr "지정된 %d 개의 po 파일 대상" -#: ext/coverage.py:140 ext/coverage.py:301 +#: builders/__init__.py:314 #, python-format -msgid "module %s could not be imported: %s" -msgstr "%s 모듈을 가져올 수 없습니다: %s" +msgid "targets for %d po files that are out of date" +msgstr "오래된 %d 개의 po 파일 대상" -#: ext/coverage.py:148 +#: builders/__init__.py:324 +msgid "all source files" +msgstr "모든 원본 파일" + +#: builders/__init__.py:335 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/coverage.py:158 +#: builders/__init__.py:342 +#, python-format msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" -msgstr "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "명령줄에 지정된 파일 %r이(가) 원본 디렉토리에 있지 않으므로, 무시합니다" -#: ext/coverage.py:172 -#, python-brace-format, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/coverage.py:187 +#: builders/__init__.py:366 #, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "coverage_c_regexes의 잘못된 정규표현식 %r" +msgid "%d source files given on command line" +msgstr "명령줄에 지정된 %d 개의 원본 파일" -#: ext/coverage.py:260 +#: builders/__init__.py:382 #, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "문서화되지 않은 C API: %s [%s], 파일 %s" +msgid "targets for %d source files that are out of date" +msgstr "오래된 %d 개의 원본 파일 대상" -#: ext/coverage.py:452 -#, python-format -msgid "undocumented python function: %s :: %s" -msgstr "문서화되지 않은 Python 함수: %s :: %s" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "오래된 파일을 찾는 중… " -#: ext/coverage.py:473 +#: builders/__init__.py:415 #, python-format -msgid "undocumented python class: %s :: %s" -msgstr "문서화되지 않은 Python 클래스: %s :: %s" +msgid "%d found" +msgstr "%d 개 찾음" -#: ext/coverage.py:492 +#: builders/__init__.py:417 +msgid "none found" +msgstr "찾은 것이 없음" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "pickle로 환경을 저장하는 중" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "일관성 확인 중" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "오래된 대상이 없습니다." + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "환경을 갱신하는 중: " + +#: builders/__init__.py:499 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "문서화되지 않은 Python 메소드: %s :: %s :: %s" +msgid "%s added, %s changed, %s removed" +msgstr "%s 개 추가됨, %s 개 변경됨, %s 개 제거됨" -#: ext/imgconverter.py:44 +#: builders/__init__.py:536 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "이미지 변환 명령 %r을(를) 실행할 수 없습니다. 'sphinx.ext.imgconverter'에는 기본적으로 ImageMagick이 필요합니다. 해당 프로그램이 설치되어 있는지 확인하거나, 'image_converter' 옵션을 사용자 정의 변환 명령으로 설정하십시오.\n\n역추적: %s" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: builders/__init__.py:545 #, python-format msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "convert가 오류와 함께 종료되었습니다:\n[stderr]\n%r\n[stdout]\n%r" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" -#: ext/imgconverter.py:83 +#: builders/__init__.py:556 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "변환 명령 %r을(를) 실행할 수 없습니다. image_converter 설정을 확인하십시오." +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "원본을 읽는 중… " + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "기록할 문서 이름: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "문서 준비 중" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "개요 파일은 %(outdir)s에 있습니다." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "버전 %s에는 변경 사항이 없습니다." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "요약 파일 작성 중…" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "내장" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "모듈 수준" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "원본 파일을 복사하는 중…" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "변경 로그 생성을 위해 %r을(를) 읽을 수 없습니다" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "잘못된 정규식 %r (%s에서)" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "%s 모듈을 가져올 수 없습니다: %s" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "" + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "coverage_c_regexes의 잘못된 정규표현식 %r" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "문서화되지 않은 C API: %s [%s], 파일 %s" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "문서화되지 않은 Python 함수: %s :: %s" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "문서화되지 않은 Python 클래스: %s :: %s" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "문서화되지 않은 Python 메소드: %s :: %s :: %s" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "하드코딩 된 링크 %r은(는) extlink로 대체할 수 있습니다 (대신 %r을(를) 사용해 보십시오)" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "할 일" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "TODO 항목 발견: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<<원래 항목>>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<<원래 항목>>은 %s 파일, %d 행에 있습니다.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "원래 항목" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "이미지 변환 명령 %r을(를) 실행할 수 없습니다. 'sphinx.ext.imgconverter'에는 기본적으로 ImageMagick이 필요합니다. 해당 프로그램이 설치되어 있는지 확인하거나, 'image_converter' 옵션을 사용자 정의 변환 명령으로 설정하십시오.\n\n역추적: %s" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "convert가 오류와 함께 종료되었습니다:\n[stderr]\n%r\n[stdout]\n%r" + +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" +msgstr "변환 명령 %r을(를) 실행할 수 없습니다. image_converter 설정을 확인하십시오." #: ext/graphviz.py:138 msgid "Graphviz directive cannot have both content and a filename argument" @@ -864,1780 +1329,1515 @@ msgstr "[그래프: %s]" msgid "[graph]" msgstr "[그래프]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "할 일" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "LaTeX 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_latex 설정을 확인하십시오" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" -msgstr "TODO 항목 발견: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_%s 설정을 확인하십시오" -#: ext/todo.py:152 -msgid "<>" -msgstr "<<원래 항목>>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "표시 LaTeX %r: %s" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<<원래 항목>>은 %s 파일, %d 행에 있습니다.)" +msgid "inline latex %r: %s" +msgstr "인라인 LaTeX %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "원래 항목" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "내어쓰기에 의해 비 공백 문자가 제거됨" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "'%s' 옵션에 '+'나 '-'가 없습니다." -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" -msgstr "잘못된 캡션: %s" +msgid "'%s' is not a valid option." +msgstr "'%s'은(는) 유효한 옵션이 아닙니다." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "줄 번호 지정이 범위를 벗어남 (1-%d): %r" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s'은(는) 유효한 pyversion 옵션이 아닙니다" -#: directives/code.py:216 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "잘못된 TestCode 유형" + +#: ext/doctest.py:297 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "\"%s\"과(와) \"%s\" 옵션을 모두 사용할 수 없습니다" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "소스에서 doctest 테스트가 완료되었으며, %(outdir)s/output.txt 에서 결과를 확인하십시오." -#: directives/code.py:231 +#: ext/doctest.py:451 #, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "" +msgid "no code/output in %s block at %s:%s" +msgstr "%s 블록(%s:%s)에 코드/출력 없음" -#: directives/code.py:235 +#: ext/doctest.py:568 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +msgid "ignoring invalid doctest code: %r" +msgstr "잘못된 doctest 코드 무시: %r" -#: directives/code.py:276 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "포함 파일 %r에서 이름이 %r 인 객체를 찾을 수 없습니다" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "분리된 \"lines\" 집합과 함께 \"lineno-match\"를 사용할 수 없습니다" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "중복 레이블 %s, 다른 인스턴스는 %s에 있음" -#: directives/code.py:314 +#: ext/duration.py:47 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "행 지정 %r: 포함 파일 %r에서 가져온 줄이 없습니다" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" -#: directives/patches.py:71 +#: ext/duration.py:117 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "csv-table 지시문의 \":file:\" 옵션은 이제 절대 경로를 소스 디렉토리의 상대 경로로 인식합니다. 문서를 업데이트하십시오." +"====================== total reading duration ==========================" +msgstr "" -#: directives/other.py:119 +#: ext/duration.py:124 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "toctree glob 패턴 %r 이(가) 어느 문서와도 일치하지 않습니다" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "toctree에 제외된 문서 %r에 대한 참조가 있음" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "====================== 가장 느린 읽기 시간 =======================" -#: directives/other.py:156 +#: ext/duration.py:139 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "toctree에 존재하지 않는 문서 %r에 대한 참조가 있음" +msgid "%.3fs %s" +msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "toctree에서 중복 항목이 발견됨: %s" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[소스]" -#: directives/other.py:203 -msgid "Section author: " -msgstr "구역 작성자: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "모듈 코드 강조 중… " -#: directives/other.py:205 -msgid "Module author: " -msgstr "모듈 작성자: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[문서]" -#: directives/other.py:207 -msgid "Code author: " -msgstr "코드 작성자: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "모듈 코드" -#: directives/other.py:209 -msgid "Author: " -msgstr "작성자: " +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        %s의 소스 코드

        " -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr ".. acks 내용이 목록이 아닙니다" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "개요: 모듈 코드" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr ".. hlist 내용이 목록이 아닙니다" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        코드를 확인할 수 있는 모든 모듈

        " -#: builders/changes.py:29 +#: domains/citation.py:75 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "개요 파일은 %(outdir)s에 있습니다." +msgid "duplicate citation %s, other instance in %s" +msgstr "중복 인용 %s, 다른 인스턴스는 %s에 있음" -#: builders/changes.py:56 +#: domains/citation.py:92 #, python-format -msgid "no changes in version %s." -msgstr "버전 %s에는 변경 사항이 없습니다." - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "요약 파일 작성 중…" - -#: builders/changes.py:70 -msgid "Builtins" -msgstr "내장" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "모듈 수준" - -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "원본 파일을 복사하는 중…" +msgid "Citation [%s] is not referenced." +msgstr "인용 [%s]이(가) 참조되지 않았습니다." -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" -msgstr "변경 로그 생성을 위해 %r을(를) 읽을 수 없습니다" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "중복 레이블의 수식 %s, 다른 인스턴스는 %s에 있음" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "매뉴얼 페이지는 %(outdir)s에 있습니다." +msgid "Invalid math_eqref_format: %r" +msgstr "잘못된 math_eqref_format: %r" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "\"man_pages\" 설정값이 없으므로, 매뉴얼 페이지를 작성하지 않습니다" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (내장 함수)" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "작성 중" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s 메서드)" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "\"man_pages\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다" +msgid "%s() (class)" +msgstr "%s() (클래스)" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "%s 빌더에 적합한 이미지를 찾을 수 없음: %s (%s)" +msgid "%s (global variable or constant)" +msgstr "%s (전역 변수 또는 상수)" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "%s 빌더에 적합한 이미지를 찾을 수 없음: %s" +msgid "%s (%s attribute)" +msgstr "%s (%s의 속성)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "빌드 중 [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "인수" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "출력을 쓰는 중… " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "예외" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" -msgstr "모든 %d 개의 po 파일" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "반환" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" -msgstr "지정된 %d 개의 po 파일 대상" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "반환 형식" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "오래된 %d 개의 po 파일 대상" +msgid "%s (module)" +msgstr "%s (모듈)" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "모든 원본 파일" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "함수" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "메서드" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "명령줄에 지정된 파일 %r이(가) 원본 디렉토리에 있지 않으므로, 무시합니다" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "클래스" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "데이터" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "명령줄에 지정된 %d 개의 원본 파일" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "속성" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "오래된 %d 개의 원본 파일 대상" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "모듈" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " -msgstr "빌드 중 [%s]: " - -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "오래된 파일을 찾는 중… " +msgid "duplicate %s description of %s, other %s in %s" +msgstr "중복된 %s 설명 (%s에 대한), 다른 항목은 %s (%s)에 있음" -#: builders/__init__.py:410 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "%d found" -msgstr "%d 개 찾음" - -#: builders/__init__.py:412 -msgid "none found" -msgstr "찾은 것이 없음" +msgid "%s (directive)" +msgstr "%s (지시문)" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "pickle로 환경을 저장하는 중" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr ":%s: (지시문 옵션)" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "일관성 확인 중" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (역할)" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "오래된 대상이 없습니다." +#: domains/rst.py:234 +msgid "directive" +msgstr "지시문" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "환경을 갱신하는 중: " +#: domains/rst.py:235 +msgid "directive-option" +msgstr "지시문 옵션" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s 개 추가됨, %s 개 변경됨, %s 개 제거됨" +#: domains/rst.py:236 +msgid "role" +msgstr "역할" -#: builders/__init__.py:531 +#: domains/rst.py:262 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "중복된 %s %s 설명, 다른 인스턴스는 %s에 있음" -#: builders/__init__.py:540 +#: domains/changeset.py:32 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "" +msgid "Changed in version %s" +msgstr "버전 %s에서 변경" -#: builders/__init__.py:558 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "원본을 읽는 중… " +msgid "Deprecated since version %s" +msgstr "버전 %s부터 폐지됨" -#: builders/__init__.py:713 +#: domains/changeset.py:35 #, python-format -msgid "docnames to write: %s" -msgstr "기록할 문서 이름: %s" - -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" - -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "문서 준비 중" - -#: builders/__init__.py:731 -msgid "copying assets" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:883 +#: domains/__init__.py:322 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "디코드 할 수 없는 원본 문자이며, \"?\"로 대체합니다: %r" +msgid "%s %s" +msgstr "%s %s" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "ePub 파일은 %(outdir)s에 있습니다." +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "작업 숫자는 양수여야 합니다" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "nav.xhtml 파일 쓰는 중…" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "자세한 내용은 를 참조하십시오." -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "설정값 \"epub_language\"(또는 \"language\")는 EPUB3의 경우 비워 둘 수 없습니다" - -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "설정값 \"epub_uid\"는 EPUB3의 경우 XML 이름이어야 합니다" - -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "설정값 \"epub_title\"은 EPUB3의 경우 비워 둘 수 없습니다" - -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "설정값 \"epub_author\"는 EPUB3의 경우 비워 둘 수 없습니다" - -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "설정값 \"epub_contributor\"는 EPUB3의 경우 비워 둘 수 없습니다" - -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "설정값 \"epub_description\"은 EPUB3의 경우 비워 둘 수 없습니다" - -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "설정값 \"epub_publisher\"는 EPUB3의 경우 비워 둘 수 없습니다" - -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "설정값 \"epub_copyright\"(또는 \"copyright\")는 EPUB3의 경우 비워 둘 수 없습니다" - -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "설정값 \"epub_identifier\"는 EPUB3의 경우 비워 둘 수 없습니다" - -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "설정값 \"version\"은 EPUB3의 경우 비워 둘 수 없습니다" - -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "잘못된 css_file: %r, 무시합니다" - -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "XML 파일은 %(outdir)s에 있습니다." - -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "%s 파일 쓰기 오류: %s" - -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "의사 XML 파일은 %(outdir)s에 있습니다." - -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Texinfo 파일은 %(outdir)s에 있습니다." - -#: builders/texinfo.py:48 +#: cmd/build.py:74 msgid "" "\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nmakeinfo를 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오\n(자동으로 수행하려면 여기에서 'make info'를 사용하십시오)." - -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "\"texinfo_documents\" 설정값이 없으므로, 문서를 작성하지 않습니다" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "\"texinfo_documents\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "%s 처리 중" - -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "참조 처리 중…" - -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (문서 " - -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "이미지를 복사하는 중… " - -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "이미지 파일 %r을(를) 복사할 수 없습니다: %s" - -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "Texinfo 지원 파일을 복사하는 중" - -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "Makefile 쓰기 오류: %s" - -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "중복된 목차 항목 발견: %s" - -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "이미지 파일 %r을(를) 읽을 수 없으며, 대신 복사합니다" - -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "이미지 파일 %r을(를) 기록할 수 없습니다: %s" - -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Pillow를 찾을 수 없습니다 - 이미지 파일을 복사합니다" - -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "mimetype 파일 쓰는 중…" - -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "META-INF/container.xml 파일 쓰는 중…" - -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "content.opf 파일 쓰는 중…" - -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "%s은(는) 알 수 없는 MIME 유형이며, 무시합니다" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "" - -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "toc.ncx 파일 쓰는 중…" - -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "%s 파일을 기록하는 중…" - -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "더미 빌더는 파일을 생성하지 않습니다." - -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "메시지 카탈로그는 %(outdir)s에 있습니다." - -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "%d 개의 템플릿 파일 대상" - -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "템플릿을 읽는 중… " - -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "메시지 카탈로그 작성 중… " - -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "HTML 페이지는 %(outdir)s에 있습니다." - -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "단일 문서 조합 중" - -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "추가 파일 작성 중" - -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "위의 출력 또는 %(outdir)s/output.txt 파일에서 오류를 확인하십시오" - -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "끊어진 링크: %s (%s)" - -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "앵커 '%s'을(를) 찾을 수 없습니다" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\n소스 파일로부터 문서를 생성합니다.\n\nsphinx-build는 SOURCEDIR에 있는 파일로부터 문서를 생성하여 OUTPUTDIR에 저장합니다.\n구성 설정을 위해 SOURCEDIR에서 'conf.py' 파일을 찾습니다.\n'sphinx-quickstart' 도구는 'conf.py'를 포함하여 템플릿 파일을 생성하는 데 사용할 수 있습니다.\n\nsphinx-build는 다양한 형식으로 문서를 생성할 수 있습니다.\n형식은 명령줄에서 빌더 이름을 지정하여 선택하며, 기본값은 HTML입니다.\n빌더는 문서 처리와 관련한 다른 태스크를 수행할 수도 있습니다.\n\n기본적으로 오래된 모든 항목을 빌드합니다.\n개별 파일명을 지정하여 선택한 파일에 대한 출력만 빌드할 수 있습니다.\n" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "linkcheck_allowed_redirects에서 정규식을 컴파일하지 못했습니다: %r %s" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "문서 원본 파일의 경로" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "텍스트 파일은 %(outdir)s에 있습니다." +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "출력 디렉토리 경로" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/build.py:109 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "번역된 메시지의 각주 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "번역된 메시지의 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" +#: cmd/build.py:114 +msgid "general options" +msgstr "일반 옵션" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "번역된 메시지의 인용 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/build.py:131 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "번역된 메시지의 용어 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%Y년 %m월 %d일" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "모든 파일 기록 (기본값: 새 파일과 변경된 파일만 기록)" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "저장된 환경을 사용하지 않고, 항상 모든 파일 읽기" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/build.py:157 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "4 개 열 기반 색인을 찾았습니다. 사용하고 있는 확장 기능의 버그일 수 있습니다: %r" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "각주 [%s]이(가) 참조되지 않았습니다." +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "각주 [#]이 참조되지 않았습니다." +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "구성 파일의 설정 무시" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "HTML 템플릿에 값 전달" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "태그를 정의: 태그가 있는 \"only\" 블록을 포함" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/build.py:212 +msgid "console output options" +msgstr "콘솔 출력 옵션" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "상세도 높임 (반복 가능)" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "stdout에 출력하지 않고, stderr에 경고만 표시" -#: _cli/__init__.py:171 -#, python-brace-format -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "경고를 포함하여 아무 출력도 하지 않음" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "컬러 출력 허용 (기본값: 자동 감지)" -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "컬러 출력을 허용하지 않음 (기본값: 자동 감지)" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "주어진 파일에 경고(및 오류)를 기록" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "경고를 오류로 바꿈" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "예외 발생 시 전체 추적 표시" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "예외 발생 시 Pdb 실행" -#: _cli/__init__.py:231 -msgid "" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "-a 옵션과 파일 이름을 함께 사용할 수 없습니다" -#: environment/__init__.py:86 -msgid "new config" -msgstr "새로운 설정" +#: cmd/build.py:357 +#, python-format +msgid "cannot open warning file '%s': %s" +msgstr "" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "설정이 변경됨" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "-D 옵션 인수는 name=value 형식이어야 합니다" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "확장 기능이 변경됨" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "-A 옵션 인수는 name=value 형식이어야 합니다" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "빌드 환경 버전이 최신이 아님" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "모듈에서 자동으로 docstring 삽입" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "원본 디렉토리가 변경됨" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "doctest 블록의 코드 조각을 자동으로 테스트" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "다른 프로젝트의 Sphinx 문서 간 링크" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "빌드 시 표시하거나 숨길 수 있는 \"할 일\" 항목 작성" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "문서의 커버리지 확인" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "이 환경은 선택한 빌더와 호환되지 않습니다. 다른 doctree 디렉토리를 선택하십시오." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "PNG나 SVG 이미지로 렌더링 된 수식 포함" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "%s에서 문서를 탐색하지 못했습니다: %r" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "MathJax로 브라우저에서 렌더링 하는 수식 포함" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "%r 영역이 등록되지 않았습니다" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "설정값을 기반으로 콘텐츠를 조건부 포함" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "문서가 어느 toctree에도 포함되어 있지 않음" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "문서화 된 Python 객체의 소스 코드에 대한 링크 포함" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "자체 참조된 toctree가 발견되었습니다. 무시합니다." +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "GitHub 페이지에 문서를 게시하기 위해 .nojekyll 파일 생성" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "유효한 경로 이름을 입력하십시오." -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "읽기 오류: %s, %s" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "텍스트를 입력하십시오." -#: util/i18n.py:113 +#: cmd/quickstart.py:134 #, python-format -msgid "writing error: %s, %s" -msgstr "쓰기 오류: %s, %s" +msgid "Please enter one of %s." +msgstr "%s 중 하나를 입력하십시오." -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "'y' 또는 'n'을 입력하십시오." -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "파일 접미사를 입력하십시오 (예: '.rst' 또는 '.txt')." -#: util/i18n.py:245 +#: cmd/quickstart.py:230 #, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "잘못된 날짜 형식입니다. 바로 출력하려면 작은 따옴표로 문자열을 인용하십시오: %s" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Sphinx %s 빠른 시작 유틸리티에 오신 것을 환영합니다." -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:235 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "%s 영역에서 문제 발생: 필드가 '%s' 역할을 사용해야 하지만, 해당 역할이 도메인에 없습니다." +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "다음 설정에 대한 값을 입력하십시오 (대괄호로 묶여 있는 기본값이 존재하고\n이 값을 사용하려면 바로 Enter를 누릅니다)." -#: util/nodes.py:423 +#: cmd/quickstart.py:242 #, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" +msgid "Selected root path: %s" +msgstr "선택한 루트 경로: %s" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "toctree에 존재하지 않는 파일 %r에 대한 참조가 있음" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "문서의 루트 경로를 입력하십시오." -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "only 지시문 식을 평가하는 동안 예외 발생: %s" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "문서의 루트 경로" -#: util/display.py:82 -msgid "skipped" -msgstr "건너뜀" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "오류: 선택한 루트 경로에서 기존 conf.py 파일이 발견되었습니다." -#: util/display.py:87 -msgid "failed" -msgstr "실패" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart는 기존 Sphinx 프로젝트를 덮어 쓰지 않습니다." -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "새 루트 경로를 입력하십시오 (또는 Enter를 눌러 종료)" + +#: cmd/quickstart.py:274 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Sphinx 출력을 위한 빌드 디렉토리를 배치하는 두 가지 옵션이 있습니다.\n루트 경로 내에서 \"_build\" 디렉토리를 사용하거나, 루트 경로 내에서\n\"source\"와 \"build\" 디렉토리로 분리합니다." -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "원본과 빌드 디렉토리 분리 (y/n)" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "루트 디렉토리 내에 두 개의 추가 디렉토리가 생성됩니다. 사용자 정의 HTML 템플릿의\n경우 \"_templates\", 사용자 정의 스타일시트 및 기타 정적 파일의 경우 \"_static\"\n입니다. 다른 접두사(\".\" 과 같은)를 입력하여 밑줄 문자를 변경할 수 있습니다." -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" -msgstr "알 수 없는 노드 유형: %r" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "템플릿 및 정적 디렉토리의 이름 접두사" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:298 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" - -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +"The project name will occur in several places in the built documentation." +msgstr "프로젝트 이름은 빌드 된 문서의 여러 위치에 표시됩니다." -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "기본 역할 %s을(를) 찾을 수 없음" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "프로젝트 이름" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "작성자 이름" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx는 소프트웨어에 대한 \"버전\"과 \"릴리스\"라는 개념을 가지고 있습니다.\n각 버전에는 여러 릴리스가 있을 수 있습니다. 예를 들어 Python의 경우 버전은\n2.5나 3.0과 같은 반면 릴리스는 2.5.1 또는 3.0a1과 같습니다.\n이러한 이중 구조가 필요하지 않으면 둘 다 동일한 값으로 설정하십시오." -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "각주" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "프로젝트 버전" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[그림: %s]" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "프로젝트 릴리스" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[그림]" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "문서를 영어 이외의 언어로 작성하려는 경우, 여기에서 해당 언어 코드로 언어를\n선택할 수 있습니다. 그러면 Sphinx가 생성한 텍스트를 해당 언어로 번역합니다.\n\n지원되는 코드 목록은\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language\n를 참조하십시오." -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "색인" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "프로젝트 언어" -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:340 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "구역, 주제, 표, 조언, 사이드바 안에 있지 않은 제목 노드가 발견됨" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "원본 파일의 파일 이름 접미사. 일반적으로 \".txt\" 또는 \".rst\" 입니다. 이 접미사가\n있는 파일만 문서로 간주됩니다." -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "캡션이 그림 안에 있지 않습니다." +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "원본 파일 접미사" -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "구현되지 않은 노드 유형: %r" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "한 문서는 \"컨텐츠 트리\"의 최상위 노드, 즉 문서 계층 구조의 루트로 간주된다는\n점에서 특별합니다. 일반적으로 이 값은 \"index\" 이지만, \"index\" 문서가\n사용자 정의 템플릿일 경우 이를 다른 파일 이름으로 설정할 수도 있습니다." -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "알 수 없는 %r toplevel_sectioning (클래스 %r)" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "마스터 문서의 이름 (접미사 없이)" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: cmd/quickstart.py:368 #, python-format -msgid "no Babel option known for language %r" -msgstr "%r 언어에 대해 알려진 Babel 옵션이 없습니다" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr ":maxdepth:가 너무 크며, 무시합니다." +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "오류: 선택한 루트 경로에 마스터 파일 %s이(가) 이미 있습니다." -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart는 기존 파일을 덮어 쓰지 않습니다." -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "문서 제목이 단일 텍스트 노드가 아님" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "새 파일 이름을 입력하거나 기존 파일의 이름을 바꾸고, Enter를 누르십시오" -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "다음 Sphinx 확장 기능 중 사용 설정해야 하는 항목을 지정하십시오:" -#: writers/latex.py:1183 +#: cmd/quickstart.py:397 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "tabularcolumns와 :widths: 옵션이 모두 설정되었습니다. :widths:는 무시됩니다." - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "치수 단위 %s이(가) 잘못되었습니다. 무시합니다." +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "참고: imgmath와 mathjax는 동시에 활성화 할 수 없습니다. imgmath가 선택 취소되었습니다." -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "알 수 없는 색인 항목 유형 %s이(가) 발견됨" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Makefile 및 Windows 명령 파일을 생성할 수 있으므로, sphinx-build를 직접 호출하는\n대신 (예를 들어) `make html'을 실행하기만 하면 됩니다." -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "잘못된 math_eqref_format: %r" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Makefile을 만드시겠습니까? (y/n)" -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Windows 명령 파일을 만드시겠습니까? (y/n)" -#: writers/html5.py:431 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "numfig_format is not defined for %s" -msgstr "numfig_format이 %s에 대해 정의되지 않음" +msgid "Creating file %s." +msgstr "%s 파일을 만드는 중입니다." -#: writers/html5.py:441 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "Any IDs not assigned for %s node" -msgstr "%s 노드에 할당되지 않은 ID" +msgid "File %s already exists, skipping." +msgstr "%s 파일이 이미 존재하여, 건너뜁니다." -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "완료됨: 초기 디렉토리 구조가 생성되었습니다." -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "이제 마스터 파일 %s을(를) 채우고 다른 원본 문서 파일을 만들어야 합니다. " -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Makefile을 사용하여 다음과 같이 문서를 빌드하십시오:\n make builder" -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "sphinx-build 명령을 사용하여 다음과 같이 문서를 빌드하십시오:\n sphinx-build -b builder %s %s" -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "여기서 \"builder\"는 지원되는 빌더 중 하나(예: html, latex, linkcheck)입니다." -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nSphinx 프로젝트에 필요한 파일을 생성합니다.\n\nsphinx-quickstart는 대화형 도구로서, 프로젝트에 대한 몇 가지 질문을 한 다음\n완전한 문서 디렉토리와 (sphinx-build와 함께 사용할 수 있는) 견본 Makefile을 생성합니다.\n" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "이미지 크기를 얻어올 수 없습니다. :scale: 옵션을 무시합니다." +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "조용한 모드" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "프로젝트 루트 디렉토리" -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "중복 레이블의 수식 %s, 다른 인스턴스는 %s에 있음" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "구조 옵션" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (내장 함수)" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "지정된 경우, 원본과 빌드 디렉토리를 구분합니다" -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s 메서드)" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "지정된 경우, 원본 디렉토리 아래에 빌드 디렉토리를 만듭니다" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (클래스)" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "_templates 등에서 마침표의 대체 문자" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (전역 변수 또는 상수)" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "프로젝트 기본 옵션" -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s의 속성)" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "프로젝트 이름" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "인수" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "작성자 이름" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "예외" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "프로젝트의 버전" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "반환" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "프로젝트의 릴리스" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "반환 형식" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "문서 언어" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (모듈)" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "원본 파일의 접미사" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "함수" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "마스터 문서 이름" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "메서드" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "EPUB 사용" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "클래스" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "확장 기능 옵션" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "데이터" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" +msgstr "%s 확장 기능 사용" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "속성" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "임의의 확장 기능 사용" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "모듈" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Makefile과 배치 파일 생성" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "중복된 %s 설명 (%s에 대한), 다른 항목은 %s (%s)에 있음" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "makefile 생성" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "makefile을 생성하지 않음" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "버전 %s에서 변경" +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "배치 파일 생성" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "버전 %s부터 폐지됨" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "배치 파일을 생성하지 않음" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "Makefile/make.bat에서 make 모드 사용" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (지시문)" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "프로젝트 템플릿" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (지시문 옵션)" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "템플릿 파일에 대한 템플릿 디렉토리" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (역할)" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "템플릿 변수 정의" -#: domains/rst.py:234 -msgid "directive" -msgstr "지시문" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "\"quiet\"이 지정되었지만, \"project\" 또는 \"author\"가 정의되지 않았습니다." -#: domains/rst.py:235 -msgid "directive-option" -msgstr "지시문 옵션" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "오류: 지정된 경로가 디렉토리가 아니거나, Sphinx 파일이 이미 있습니다." -#: domains/rst.py:236 -msgid "role" -msgstr "역할" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart는 빈 디렉토리에만 생성됩니다. 새 루트 경로를 지정하십시오." -#: domains/rst.py:262 +#: cmd/quickstart.py:810 #, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "중복된 %s %s 설명, 다른 인스턴스는 %s에 있음" +msgid "Invalid template variable: %s" +msgstr "잘못된 템플릿 변수: %s" -#: domains/citation.py:75 +#: directives/other.py:119 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "중복 인용 %s, 다른 인스턴스는 %s에 있음" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "toctree glob 패턴 %r 이(가) 어느 문서와도 일치하지 않습니다" -#: domains/citation.py:92 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "인용 [%s]이(가) 참조되지 않았습니다." - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "주의" +msgid "toctree contains reference to excluded document %r" +msgstr "toctree에 제외된 문서 %r에 대한 참조가 있음" -#: locale/__init__.py:229 -msgid "Caution" -msgstr "조심" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "toctree에 존재하지 않는 문서 %r에 대한 참조가 있음" -#: locale/__init__.py:230 -msgid "Danger" -msgstr "위험" +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "toctree에서 중복 항목이 발견됨: %s" -#: locale/__init__.py:231 -msgid "Error" -msgstr "오류" +#: directives/other.py:203 +msgid "Section author: " +msgstr "구역 작성자: " -#: locale/__init__.py:232 -msgid "Hint" -msgstr "힌트" +#: directives/other.py:205 +msgid "Module author: " +msgstr "모듈 작성자: " -#: locale/__init__.py:233 -msgid "Important" -msgstr "중요" +#: directives/other.py:207 +msgid "Code author: " +msgstr "코드 작성자: " -#: locale/__init__.py:234 -msgid "Note" -msgstr "참고" +#: directives/other.py:209 +msgid "Author: " +msgstr "작성자: " -#: locale/__init__.py:235 -msgid "See also" -msgstr "더 보기" +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr ".. acks 내용이 목록이 아닙니다" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "팁" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr ".. hlist 내용이 목록이 아닙니다" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "경고" +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "csv-table 지시문의 \":file:\" 옵션은 이제 절대 경로를 소스 디렉토리의 상대 경로로 인식합니다. 문서를 업데이트하십시오." -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "모듈에서 자동으로 docstring 삽입" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "내어쓰기에 의해 비 공백 문자가 제거됨" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "doctest 블록의 코드 조각을 자동으로 테스트" +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" +msgstr "잘못된 캡션: %s" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "다른 프로젝트의 Sphinx 문서 간 링크" +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" +msgstr "줄 번호 지정이 범위를 벗어남 (1-%d): %r" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "빌드 시 표시하거나 숨길 수 있는 \"할 일\" 항목 작성" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "\"%s\"과(와) \"%s\" 옵션을 모두 사용할 수 없습니다" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "문서의 커버리지 확인" +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" +msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "PNG나 SVG 이미지로 렌더링 된 수식 포함" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "MathJax로 브라우저에서 렌더링 하는 수식 포함" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "포함 파일 %r에서 이름이 %r 인 객체를 찾을 수 없습니다" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "설정값을 기반으로 콘텐츠를 조건부 포함" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "분리된 \"lines\" 집합과 함께 \"lineno-match\"를 사용할 수 없습니다" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "문서화 된 Python 객체의 소스 코드에 대한 링크 포함" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "행 지정 %r: 포함 파일 %r에서 가져온 줄이 없습니다" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "GitHub 페이지에 문서를 게시하기 위해 .nojekyll 파일 생성" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%Y년 %m월 %d일" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "유효한 경로 이름을 입력하십시오." +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "색인" -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "텍스트를 입력하십시오." +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "구역, 주제, 표, 조언, 사이드바 안에 있지 않은 제목 노드가 발견됨" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "%s 중 하나를 입력하십시오." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "각주" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "'y' 또는 'n'을 입력하십시오." +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "캡션이 그림 안에 있지 않습니다." -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "파일 접미사를 입력하십시오 (예: '.rst' 또는 '.txt')." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "구현되지 않은 노드 유형: %r" -#: cmd/quickstart.py:229 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Sphinx %s 빠른 시작 유틸리티에 오신 것을 환영합니다." +msgid "[image: %s]" +msgstr "[그림: %s]" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "다음 설정에 대한 값을 입력하십시오 (대괄호로 묶여 있는 기본값이 존재하고\n이 값을 사용하려면 바로 Enter를 누릅니다)." +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[그림]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "" -#: cmd/quickstart.py:241 +#: writers/html5.py:431 #, python-format -msgid "Selected root path: %s" -msgstr "선택한 루트 경로: %s" +msgid "numfig_format is not defined for %s" +msgstr "numfig_format이 %s에 대해 정의되지 않음" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "문서의 루트 경로를 입력하십시오." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "%s 노드에 할당되지 않은 ID" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "문서의 루트 경로" +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "오류: 선택한 루트 경로에서 기존 conf.py 파일이 발견되었습니다." +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart는 기존 Sphinx 프로젝트를 덮어 쓰지 않습니다." +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "새 루트 경로를 입력하십시오 (또는 Enter를 눌러 종료)" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Sphinx 출력을 위한 빌드 디렉토리를 배치하는 두 가지 옵션이 있습니다.\n루트 경로 내에서 \"_build\" 디렉토리를 사용하거나, 루트 경로 내에서\n\"source\"와 \"build\" 디렉토리로 분리합니다." +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "원본과 빌드 디렉토리 분리 (y/n)" +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "루트 디렉토리 내에 두 개의 추가 디렉토리가 생성됩니다. 사용자 정의 HTML 템플릿의\n경우 \"_templates\", 사용자 정의 스타일시트 및 기타 정적 파일의 경우 \"_static\"\n입니다. 다른 접두사(\".\" 과 같은)를 입력하여 밑줄 문자를 변경할 수 있습니다." +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "템플릿 및 정적 디렉토리의 이름 접두사" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "이미지 크기를 얻어올 수 없습니다. :scale: 옵션을 무시합니다." -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "프로젝트 이름은 빌드 된 문서의 여러 위치에 표시됩니다." +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "알 수 없는 %r toplevel_sectioning (클래스 %r)" -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "프로젝트 이름" +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" +msgstr "%r 언어에 대해 알려진 Babel 옵션이 없습니다" -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "작성자 이름" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":maxdepth:가 너무 크며, 무시합니다." -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "Sphinx는 소프트웨어에 대한 \"버전\"과 \"릴리스\"라는 개념을 가지고 있습니다.\n각 버전에는 여러 릴리스가 있을 수 있습니다. 예를 들어 Python의 경우 버전은\n2.5나 3.0과 같은 반면 릴리스는 2.5.1 또는 3.0a1과 같습니다.\n이러한 이중 구조가 필요하지 않으면 둘 다 동일한 값으로 설정하십시오." +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "프로젝트 버전" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "문서 제목이 단일 텍스트 노드가 아님" -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "프로젝트 릴리스" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "tabularcolumns와 :widths: 옵션이 모두 설정되었습니다. :widths:는 무시됩니다." -#: cmd/quickstart.py:323 +#: writers/latex.py:1228 +#, python-format msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "문서를 영어 이외의 언어로 작성하려는 경우, 여기에서 해당 언어 코드로 언어를\n선택할 수 있습니다. 그러면 Sphinx가 생성한 텍스트를 해당 언어로 번역합니다.\n\n지원되는 코드 목록은\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language\n를 참조하십시오." +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "프로젝트 언어" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "치수 단위 %s이(가) 잘못되었습니다. 무시합니다." -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "원본 파일의 파일 이름 접미사. 일반적으로 \".txt\" 또는 \".rst\" 입니다. 이 접미사가\n있는 파일만 문서로 간주됩니다." +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "알 수 없는 색인 항목 유형 %s이(가) 발견됨" + +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "원본 파일 접미사" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "한 문서는 \"컨텐츠 트리\"의 최상위 노드, 즉 문서 계층 구조의 루트로 간주된다는\n점에서 특별합니다. 일반적으로 이 값은 \"index\" 이지만, \"index\" 문서가\n사용자 정의 템플릿일 경우 이를 다른 파일 이름으로 설정할 수도 있습니다." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "마스터 문서의 이름 (접미사 없이)" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "오류: 선택한 루트 경로에 마스터 파일 %s이(가) 이미 있습니다." +#: _cli/__init__.py:98 +msgid "Options" +msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart는 기존 파일을 덮어 쓰지 않습니다." +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: cmd/quickstart.py:377 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "새 파일 이름을 입력하거나 기존 파일의 이름을 바꾸고, Enter를 누르십시오" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "다음 Sphinx 확장 기능 중 사용 설정해야 하는 항목을 지정하십시오:" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "참고: imgmath와 mathjax는 동시에 활성화 할 수 없습니다. imgmath가 선택 취소되었습니다." +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Makefile 및 Windows 명령 파일을 생성할 수 있으므로, sphinx-build를 직접 호출하는\n대신 (예를 들어) `make html'을 실행하기만 하면 됩니다." +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Makefile을 만드시겠습니까? (y/n)" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Windows 명령 파일을 만드시겠습니까? (y/n)" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." -msgstr "%s 파일을 만드는 중입니다." +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "%s 파일이 이미 존재하여, 건너뜁니다." +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "완료됨: 초기 디렉토리 구조가 생성되었습니다." +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: cmd/quickstart.py:519 -#, python-format +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" + +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "이제 마스터 파일 %s을(를) 채우고 다른 원본 문서 파일을 만들어야 합니다. " +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "번역된 메시지의 각주 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" -#: cmd/quickstart.py:526 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Makefile을 사용하여 다음과 같이 문서를 빌드하십시오:\n make builder" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "번역된 메시지의 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" -#: cmd/quickstart.py:530 -#, python-format +#: transforms/i18n.py:325 +#, python-brace-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "sphinx-build 명령을 사용하여 다음과 같이 문서를 빌드하십시오:\n sphinx-build -b builder %s %s" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "번역된 메시지의 인용 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" -#: cmd/quickstart.py:537 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "여기서 \"builder\"는 지원되는 빌더 중 하나(예: html, latex, linkcheck)입니다." +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "번역된 메시지의 용어 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" -#: cmd/quickstart.py:572 +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" + +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" + +#: transforms/__init__.py:258 +#, python-format msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nSphinx 프로젝트에 필요한 파일을 생성합니다.\n\nsphinx-quickstart는 대화형 도구로서, 프로젝트에 대한 몇 가지 질문을 한 다음\n완전한 문서 디렉토리와 (sphinx-build와 함께 사용할 수 있는) 견본 Makefile을 생성합니다.\n" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "4 개 열 기반 색인을 찾았습니다. 사용하고 있는 확장 기능의 버그일 수 있습니다: %r" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "자세한 내용은 를 참조하십시오." +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "각주 [%s]이(가) 참조되지 않았습니다." -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "조용한 모드" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "프로젝트 루트 디렉토리" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "각주 [#]이 참조되지 않았습니다." -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "구조 옵션" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "지정된 경우, 원본과 빌드 디렉토리를 구분합니다" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "지정된 경우, 원본 디렉토리 아래에 빌드 디렉토리를 만듭니다" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "읽기 오류: %s, %s" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "_templates 등에서 마침표의 대체 문자" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "쓰기 오류: %s, %s" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "프로젝트 기본 옵션" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "프로젝트 이름" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "작성자 이름" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "잘못된 날짜 형식입니다. 바로 출력하려면 작은 따옴표로 문자열을 인용하십시오: %s" -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "프로젝트의 버전" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "프로젝트의 릴리스" +#: util/display.py:82 +msgid "skipped" +msgstr "건너뜀" -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "문서 언어" +#: util/display.py:87 +msgid "failed" +msgstr "실패" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "원본 파일의 접미사" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "마스터 문서 이름" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "EPUB 사용" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "알 수 없는 노드 유형: %r" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "확장 기능 옵션" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" -#: cmd/quickstart.py:670 +#: util/fileutil.py:89 #, python-format -msgid "enable %s extension" -msgstr "%s 확장 기능 사용" +msgid "Writing evaluated template result to %s" +msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "임의의 확장 기능 사용" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "%s 영역에서 문제 발생: 필드가 '%s' 역할을 사용해야 하지만, 해당 역할이 도메인에 없습니다." -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Makefile과 배치 파일 생성" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "기본 역할 %s을(를) 찾을 수 없음" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "makefile 생성" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "makefile을 생성하지 않음" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "toctree에 존재하지 않는 파일 %r에 대한 참조가 있음" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "배치 파일 생성" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "only 지시문 식을 평가하는 동안 예외 발생: %s" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "배치 파일을 생성하지 않음" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "이전 페이지에서 계속" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "Makefile/make.bat에서 make 모드 사용" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "다음 페이지에 계속" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "프로젝트 템플릿" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "알파벳 이외" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "템플릿 파일에 대한 템플릿 디렉토리" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "기호" -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "템플릿 변수 정의" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "숫자" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "\"quiet\"이 지정되었지만, \"project\" 또는 \"author\"가 정의되지 않았습니다." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "페이지" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "오류: 지정된 경로가 디렉토리가 아니거나, Sphinx 파일이 이미 있습니다." +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "릴리스" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart는 빈 디렉토리에만 생성됩니다. 새 루트 경로를 지정하십시오." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "원격 이미지를 가져올 수 없습니다: %s [%s]" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/images.py:96 #, python-format -msgid "Invalid template variable: %s" -msgstr "잘못된 템플릿 변수: %s" +msgid "Could not fetch remote image: %s [%d]" +msgstr "원격 이미지를 가져올 수 없습니다: %s [%d]" -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "작업 숫자는 양수여야 합니다" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "알 수 없는 이미지 형식: %s…" -#: cmd/build.py:74 +#: transforms/post_transforms/__init__.py:88 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\n소스 파일로부터 문서를 생성합니다.\n\nsphinx-build는 SOURCEDIR에 있는 파일로부터 문서를 생성하여 OUTPUTDIR에 저장합니다.\n구성 설정을 위해 SOURCEDIR에서 'conf.py' 파일을 찾습니다.\n'sphinx-quickstart' 도구는 'conf.py'를 포함하여 템플릿 파일을 생성하는 데 사용할 수 있습니다.\n\nsphinx-build는 다양한 형식으로 문서를 생성할 수 있습니다.\n형식은 명령줄에서 빌더 이름을 지정하여 선택하며, 기본값은 HTML입니다.\n빌더는 문서 처리와 관련한 다른 태스크를 수행할 수도 있습니다.\n\n기본적으로 오래된 모든 항목을 빌드합니다.\n개별 파일명을 지정하여 선택한 파일에 대한 출력만 빌드할 수 있습니다.\n" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "상호 참조에 대한 대체 텍스트를 결정할 수 없습니다. 버그일 수 있습니다." -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "문서 원본 파일의 경로" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "'any' 상호 참조 %r에 대해 둘 이상의 대상이 발견되었습니다: %s 일 수 있습니다" -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "출력 디렉토리 경로" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s 참조 대상을 찾을 수 없음: %s" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r 참조 대상을 찾을 수 없음: %s" -#: cmd/build.py:114 -msgid "general options" -msgstr "일반 옵션" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "중단되었습니다!" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "모든 파일 기록 (기본값: 새 파일과 변경된 파일만 기록)" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "저장된 환경을 사용하지 않고, 항상 모든 파일 읽기" - -#: cmd/build.py:150 -msgid "path options" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:157 +#: _cli/util/errors.py:207 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "구성 파일의 설정 무시" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "HTML 템플릿에 값 전달" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "태그를 정의: 태그가 있는 \"only\" 블록을 포함" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" -msgstr "콘솔 출력 옵션" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "사용자 오류인 경우에도 이를 보고하여, 다음에 더 나은 오류 메시지를 제공할 수 있도록 해 주십시오." -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "상세도 높임 (반복 가능)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "사이드바 닫기" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "stdout에 출력하지 않고, stderr에 경고만 표시" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "탐색" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "경고를 포함하여 아무 출력도 하지 않음" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "%(docstitle)s에서 찾기" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "컬러 출력 허용 (기본값: 자동 감지)" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "이 문서 정보" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "컬러 출력을 허용하지 않음 (기본값: 자동 감지)" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "검색" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "저작권" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "주어진 파일에 경고(및 오류)를 기록" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "최종 업데이트: %(last_updated)s" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "경고를 오류로 바꿈" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Sphinx %(sphinx_version)s 버전으로 생성되었습니다." -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "예외 발생 시 전체 추적 표시" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "이전 항목" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "예외 발생 시 Pdb 실행" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "이전 장" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "다음 항목" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "-a 옵션과 파일 이름을 함께 사용할 수 없습니다" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "다음 장" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "Index – %(key)s" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "-D 옵션 인수는 name=value 형식이어야 합니다" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "-A 옵션 인수는 name=value 형식이어야 합니다" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "한 페이지에 전체 색인 보기" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "사이드바 닫기" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "현재 문서" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "목차" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "소스 보기" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "검색" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "빠른 검색" #: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 #: themes/basic/searchfield.html:12 msgid "Go" msgstr "이동" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "소스 보기" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "내용" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "%(docstitle)s에서 찾기" - #: themes/basic/defindex.html:4 msgid "Overview" msgstr "개요" @@ -2683,7 +2883,7 @@ msgstr "모듈 총 색인" msgid "quick access to all modules" msgstr "모든 모듈 조견표" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "전체 색인" @@ -2691,23 +2891,15 @@ msgstr "전체 색인" msgid "all functions, classes, terms" msgstr "함수, 클래스 및 용어 개관" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "현재 문서" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "목차" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "한 페이지에 전체 색인 보기" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "빠른 검색" +msgid "Search %(docstitle)s" +msgstr "%(docstitle)s에서 찾기" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2717,57 +2909,6 @@ msgstr "알파벳별 색인" msgid "can be huge" msgstr "큰 경우가 있으므로 주의" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "이전 항목" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "이전 장" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "다음 항목" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "다음 장" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "탐색" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "%(docstitle)s에서 찾기" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "이 문서 정보" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "저작권" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "최종 업데이트: %(last_updated)s" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Sphinx %(sphinx_version)s 버전으로 생성되었습니다." - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2784,43 +2925,42 @@ msgstr "여러 단어를 검색하면 모든 단어가 포함된 일치 항목 msgid "search" msgstr "검색" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "검색 일치 숨기기" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "내용" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "검색 결과" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "검색어와 일치하는 문서가 없습니다. 모든 단어의 철자가 올바른지, 충분한 카테고리를 선택했는지 확인하십시오." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" "Search finished, found ${resultCount} pages matching the search query." msgstr[0] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "검색 중" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "검색 준비 중…" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", 문서 - " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "검색 일치 숨기기" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2828,6 +2968,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "버전 %(version)s의 변경 사항 — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2849,120 +2994,127 @@ msgstr "다른 변경 사항" msgid "Expand sidebar" msgstr "사이드바 열기" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "매개변수" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "변수" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "예외 발생" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s 모듈)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (%s 모듈)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (내장 변수)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (내장 클래스)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (%s 클래스)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s의 클래스 메서드)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s의 정적 메서드)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (%s의 특성)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python 모듈 목록" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "모듈" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "폐지됨" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "예외" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "클래스 메서드" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "정적 메서드" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "특성" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "상호 참조 %r에 대해 둘 이상의 대상을 찾았습니다: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (폐지됨)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "매개변수" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "변수" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "예외 발생" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "중복 C++ 선언이며, %s:%s에 정의되었습니다.\n선언은 '.. cpp:%s:: %s' 입니다." #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2973,92 +3125,85 @@ msgstr "템플릿 매개변수" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "중복 C++ 선언이며, %s:%s에 정의되었습니다.\n선언은 '.. cpp:%s:: %s' 입니다." - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "반환값" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "공용체" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "멤버 변수" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "자료형" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "콘셉트" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "열거형" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "열거자" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "함수 매개변수" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "템플릿 매개변수" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "중복 C 선언이며, %s:%s에 정의되었습니다.\n선언은 '.. c:%s:: %s' 입니다." -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "변수" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "매크로" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "구조체" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "환경 변수; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3153,514 +3298,422 @@ msgstr "정의되지 않은 레이블: %r" msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "상호 참조를 생성하지 못했습니다. 제목 또는 캡션을 찾을 수 없습니다: %r" -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "순환 toctree 참조가 감지되었으며, 무시합니다: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "toctree에 제목이 없는 문서 %r에 대한 참조가 있습니다. 링크가 생성되지 않습니다" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "%s 문서" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "%s 참조" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "알 수 없는 색인 항목 유형 %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "기호" - -#: environment/collectors/asset.py:98 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "image file not readable: %s" -msgstr "이미지 파일을 읽을 수 없음: %s" +msgid "invalid value set (missing closing brace): %s" +msgstr "잘못된 값 세트 (닫는 중괄호 누락): %s" -#: environment/collectors/asset.py:126 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "image file %s not readable: %s" -msgstr "이미지 파일 %s을(를) 읽을 수 없음: %s" +msgid "invalid value set (missing opening brace): %s" +msgstr "잘못된 값 세트 (여는 중괄호 누락): %s" -#: environment/collectors/asset.py:163 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "download file not readable: %s" -msgstr "다운로드 가능 파일을 읽을 수 없음: %s" +msgid "malformed string literal (missing closing quote): %s" +msgstr "잘못된 문자열 리터럴 (닫는 따옴표 누락): %s" -#: environment/collectors/toctree.py:259 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s에 이미 구역 번호가 할당되었습니다 (중첩된 번호 붙인 toctree?)" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "중단되었습니다!" +msgid "malformed string literal (missing opening quote): %s" +msgstr "잘못된 문자열 리터럴 (여는 따옴표 누락): %s" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "예제" -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "예제" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "키워드 매개변수" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "참고" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "기타 매개변수" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "수신" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "참조" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "사용자 오류인 경우에도 이를 보고하여, 다음에 더 나은 오류 메시지를 제공할 수 있도록 해 주십시오." +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "경고" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "상호 참조에 대한 대체 텍스트를 결정할 수 없습니다. 버그일 수 있습니다." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "생성" -#: transforms/post_transforms/__init__.py:237 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "'any' 상호 참조 %r에 대해 둘 이상의 대상이 발견되었습니다: %s 일 수 있습니다" +msgid "A mocked object is detected: %r" +msgstr "모의 객체가 감지되었습니다: %r" -#: transforms/post_transforms/__init__.py:299 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s 참조 대상을 찾을 수 없음: %s" +msgid "alias of %s" +msgstr "%s의 별칭" -#: transforms/post_transforms/__init__.py:305 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "%r reference target not found: %s" -msgstr "%r 참조 대상을 찾을 수 없음: %s" +msgid "Bases: %s" +msgstr "기반 클래스: %s" -#: transforms/post_transforms/images.py:79 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "원격 이미지를 가져올 수 없습니다: %s [%s]" +msgid "invalid value for member-order option: %s" +msgstr "member-order 옵션에 대해 잘못된 값: %s" -#: transforms/post_transforms/images.py:96 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "원격 이미지를 가져올 수 없습니다: %s [%d]" +msgid "invalid value for class-doc-from option: %s" +msgstr "class-doc-from 옵션에 대해 잘못된 값: %s" -#: transforms/post_transforms/images.py:143 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "Unknown image format: %s..." -msgstr "알 수 없는 이미지 형식: %s…" +msgid "invalid signature for auto%s (%r)" +msgstr "auto%s (%r)에 대한 잘못된 서명" -#: builders/html/__init__.py:113 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "HTML 페이지는 %(outdir)s에 있습니다." +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "%r의 자동 문서화를 위해 가져올 모듈을 알 수 없습니다 (문서에 \"module\" 또는 \"currentmodule\" 지시문을 배치하거나, 명시적으로 모듈 이름을 지정해 보십시오)" -#: builders/html/__init__.py:348 +#: ext/autodoc/_names.py:89 #, python-format -msgid "Failed to read build info file: %r" -msgstr "빌드 정보 파일을 읽을 수 없습니다: %r" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "" - -#: builders/html/__init__.py:366 -msgid "building [html]: " +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:383 +#: ext/autodoc/_names.py:93 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "색인" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "automodule 이름의 \"::\"은 의미가 없음" -#: builders/html/__init__.py:560 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "Logo of %s" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "다음" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "이전" +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "%s 파일을 작성합니다." -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "색인 생성 중" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\n에서 Python 모듈 및 패키지를 재귀적으로 찾고\nautomodule 지시문이 있는 패키지 당 하나의 reST 파일을 에 만듭니다.\n\n은 생성에서 제외할 파일 또는 디렉토리 패턴일 수 있습니다.\n\n참고: 기본적으로이 스크립트는 이미 생성된 파일을 덮어 쓰지 않습니다." -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "추가 페이지 작성 중" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "문서에 대한 모듈 경로" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "생성에서 제외할 fnmatch 형식의 파일 또는 디렉토리 패턴" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "다운로드 가능한 파일을 복사하는 중… " +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "모든 출력을 저장할 디렉토리" -#: builders/html/__init__.py:818 -#, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "다운로드 가능한 파일 %r을(를) 복사할 수 없습니다: %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "목차에 표시할 하위 모듈의 최대 깊이 (기본값: 4)" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "기존 파일 덮어쓰기" -#: builders/html/__init__.py:882 -#, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "html_static_file에 있는 파일을 복사할 수 없습니다: %s: %r" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "심볼릭 링크를 따라갑니다. collective.recipe.omelette과 결합하면 강력합니다." -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "정적 파일을 복사하는 중" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "파일을 생성하지 않고 스크립트 실행" -#: builders/html/__init__.py:934 -#, python-format -msgid "cannot copy static file %r" -msgstr "정적 파일을 복사할 수 없습니다: %r" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "각 모듈에 대한 문서를 개별 페이지에 배치" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "추가 파일을 복사하는 중" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "\"_private\" 모듈 포함" -#: builders/html/__init__.py:949 -#, python-format -msgid "cannot copy extra file %r" -msgstr "추가 파일을 복사할 수 없습니다: %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "목차의 파일 이름 (기본값: modules)" -#: builders/html/__init__.py:955 -#, python-format -msgid "Failed to write build info file: %r" -msgstr "빌드 정보 파일 쓰기 실패: %r" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "목차 파일을 만들지 않음" -#: builders/html/__init__.py:1005 +#: ext/apidoc/_cli.py:135 msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "검색 색인을 불러올 수 없지만 모든 문서가 작성되지는 않은 것은 아닙니다. 색인이 불완전합니다." +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "모듈/패키지에 대한 제목을 만들지 않음 (예: docstring에 이미 포함된 경우)" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "%s 페이지가 html_sidebars의 두 패턴(%r 및 %r)과 일치합니다" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "서브 모듈 문서 앞에 모듈 문서를 넣음" -#: builders/html/__init__.py:1216 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "%s 페이지를 렌더링 할 때 유니코드 오류가 발생했습니다. ASCII가 아닌 내용을 포함하는 모든 설정값이 유니코드 문자열인지 확인하십시오." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "PEP-0420 암시적 네임 스페이스 사양에 따라 모듈 경로 해석" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "%s 페이지를 렌더링하는 중에 오류가 발생했습니다.\n원인: %r" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "객체 인벤토리 덤프 중" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "파일 확장자 (기본값: rst)" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "%s에서 검색 인덱스 덤프 중" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "잘못된 js_file: %r, 무시합니다" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "sphinx-quickstart로 전체 프로젝트 생성" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "여러 math_renderers가 등록되어 있습니다. 하지만 math_renderer가 선택되지 않았습니다." +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "--full이 주어졌을 때, sys.path에 module_path 추가" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "알 수 없는 math_renderer %r이(가) 지정되었습니다." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "프로젝트 이름 (기본값: 루트 모듈 이름)" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "html_extra_path 항목 %r이(가) outdir 안에 있습니다" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "--full이 주어졌을 때, 프로젝트 작성자" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "html_extra_path 항목 %r이(가) 없습니다" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "--full이 주어졌을 때, 프로젝트 버전" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "--full이 주어졌을 때, 프로젝트의 릴리스이며 기본값은 --doc-version 값과 같음" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "확장 기능 옵션" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1380 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "html_static_path 항목 %r이(가) outdir 안에 있습니다" +msgid "enable %s extension, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1385 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "html_static_path entry %r does not exist" -msgstr "html_static_path 항목 %r이(가) 없습니다" +msgid "%s is not a directory." +msgstr "%s은(는) 디렉토리가 아닙니다." -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "로고 파일 %r이(가) 존재하지 않습니다" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "" -#: builders/html/__init__.py:1407 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "favicon file %r does not exist" -msgstr "Favicon 파일 %r이(가) 존재하지 않습니다" +msgid "apidoc_modules item %i must be a dict" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "%s %s documentation" -msgstr "%s %s 문서" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_extension.py:133 +#, python-format +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "LaTeX 파일은 %(outdir)s에 있습니다." - -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\n(pdf)latex을 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오\n(자동으로 수행하려면 여기에서 'make latexpdf'를 사용하십시오)." - -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "\"latex_documents\" 설정값이 없으므로, 문서를 작성하지 않습니다" +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "\"latex_documents\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "릴리스" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "TeX 지원 파일을 복사하는 중" - -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "추가 파일을 복사하는 중" +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "알 수 없는 설정 키: latex_elements[%r], 무시합니다." +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "알 수 없는 테마 옵션: latex_theme_options[%r], 무시합니다." - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r에 \"theme\" 설정이 없습니다" +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "" -#: builders/latex/theming.py:91 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r에 \"%s\" 설정이 없습니다" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "autosummary: 문서화 할 %r을(를) 결정하지 못했으며, 다음 예외가 발생했습니다:\n%s" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "이전 페이지에서 계속" +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] 자동 요약 생성: %s" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "다음 페이지에 계속" +#: ext/autosummary/generate.py:634 +#, python-format +msgid "[autosummary] writing to %s" +msgstr "[autosummary] %s에 기록" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "알파벳 이외" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "[autosummary] %s을(를) import 하지 못했습니다.\n가능한 힌트:\n%s" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "숫자" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nautosummary 지시문을 사용하여 ReStructuredText를 생성합니다.\n\nsphinx-autogen은 sphinx.ext.autosummary.generate의 프런트엔드입니다.\n주어진 입력 파일에 포함된 autosummary 지시문에서 reStructuredText 파일을 생성합니다.\n\nautosummary 지시문의 형식은 ``sphinx.ext.autosummary`` Python 모듈에 문서화되어 있으며 다음 명령을 사용하여 읽을 수 있습니다.\n\n pydoc sphinx.ext.autosummary\n" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "페이지" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "rST 파일을 생성할 원본 파일" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "키워드 매개변수" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "모든 출력을 저장할 디렉토리" -#: ext/napoleon/docstring.py:176 +#: ext/autosummary/generate.py:915 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "잘못된 값 세트 (닫는 중괄호 누락): %s" +msgid "default suffix for files (default: %(default)s)" +msgstr "파일의 기본 확장자 (기본값: %(default)s)" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:923 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "잘못된 값 세트 (여는 중괄호 누락): %s" +msgid "custom template directory (default: %(default)s)" +msgstr "사용자 정의 템플릿 디렉토리 (기본값: %(default)s)" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:931 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "잘못된 문자열 리터럴 (닫는 따옴표 누락): %s" +msgid "document imported members (default: %(default)s)" +msgstr "가져온 멤버 문서화 (기본값: %(default)s)" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:940 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "잘못된 문자열 리터럴 (여는 따옴표 누락): %s" - -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "예제" - -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "예제" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "참고" - -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "기타 매개변수" - -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "수신" - -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "참조" - -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "경고" - -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "생성" +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "모듈 __all__ 속성의 구성원만 정확히 문서화합니다. (기본값: %(default)s)" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "autosummary가 제외된 문서 %r을(를) 참조합니다. 무시합니다." -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: 스텁 파일 %r을(를) 찾을 수 없습니다. autosummary_generate 설정을 확인하십시오." -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "캡션이 있는 자동 요약에는 :toctree: 옵션이 필요합니다. 무시합니다." -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3668,548 +3721,585 @@ msgid "" "%s" msgstr "autosummary: %s을(를) import 하지 못했습니다.\n가능한 힌트:\n%s" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "이름 %s을(를) 해석하지 못함" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "객체 %s을(를) import 하지 못함" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: 파일을 찾을 수 없음: %s" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "autosummary: 문서화 할 %r을(를) 결정하지 못했으며, 다음 예외가 발생했습니다:\n%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[autosummary] 자동 요약 생성: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[autosummary] %s에 기록" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "[autosummary] %s을(를) import 하지 못했습니다.\n가능한 힌트:\n%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nautosummary 지시문을 사용하여 ReStructuredText를 생성합니다.\n\nsphinx-autogen은 sphinx.ext.autosummary.generate의 프런트엔드입니다.\n주어진 입력 파일에 포함된 autosummary 지시문에서 reStructuredText 파일을 생성합니다.\n\nautosummary 지시문의 형식은 ``sphinx.ext.autosummary`` Python 모듈에 문서화되어 있으며 다음 명령을 사용하여 읽을 수 있습니다.\n\n pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "" + +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" + +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "" + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "rST 파일을 생성할 원본 파일" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "모든 출력을 저장할 디렉토리" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "일부 인벤토리에서 몇 가지 문제가 발생했지만, 동작하는 대체 인벤토리로 처리했습니다:" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:332 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "파일의 기본 확장자 (기본값: %(default)s)" +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "사용자 정의 템플릿 디렉토리 (기본값: %(default)s)" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "intersphinx 인벤토리가 이동함: %s -> %s" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "가져온 멤버 문서화 (기본값: %(default)s)" +msgid "(in %s %s)" +msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "모듈 __all__ 속성의 구성원만 정확히 문서화합니다. (기본값: %(default)s)" +msgid "(in %s)" +msgstr "(%s에서)" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Failed to remove %s: %s" +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\n에서 Python 모듈 및 패키지를 재귀적으로 찾고\nautomodule 지시문이 있는 패키지 당 하나의 reST 파일을 에 만듭니다.\n\n은 생성에서 제외할 파일 또는 디렉토리 패턴일 수 있습니다.\n\n참고: 기본적으로이 스크립트는 이미 생성된 파일을 덮어 쓰지 않습니다." +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "문서에 대한 모듈 경로" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "생성에서 제외할 fnmatch 형식의 파일 또는 디렉토리 패턴" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "모든 출력을 저장할 디렉토리" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "외부 %s:%s 참조 대상을 찾을 수 없음: %s" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "목차에 표시할 하위 모듈의 최대 깊이 (기본값: 4)" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "%s에 대한 서명을 서식화하는 동안 오류 발생: %s" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "기존 파일 덮어쓰기" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "심볼릭 링크를 따라갑니다. collective.recipe.omelette과 결합하면 강력합니다." +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "%s에 대한 함수 서명을 가져오지 못했습니다: %s" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "파일을 생성하지 않고 스크립트 실행" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "%r에 대한 서명을 업데이트하지 못했습니다. 매개변수를 찾을 수 없습니다: %s" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "각 모듈에 대한 문서를 개별 페이지에 배치" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "%r에 대한 type_comment를 해석하지 못했습니다: %s" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "\"_private\" 모듈 포함" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "%s에서 잘못된 __slots__ 가 발견되었습니다. 무시합니다." -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "목차의 파일 이름 (기본값: modules)" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "%s에 대한 인수를 서식화하는 동안 오류 발생: %s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "목차 파일을 만들지 않음" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "%s에 대한 생성자 서명을 가져오지 못했습니다: %s" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "모듈/패키지에 대한 제목을 만들지 않음 (예: docstring에 이미 포함된 경우)" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "%s에 대한 메소드 서명을 가져오지 못했습니다: %s" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "서브 모듈 문서 앞에 모듈 문서를 넣음" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "PEP-0420 암시적 네임 스페이스 사양에 따라 모듈 경로 해석" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "%r에 대한 기본 인수 값을 해석하지 못했습니다: %s" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "파일 확장자 (기본값: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "autodoc: 문서화 할 %s.%s (%r) 을(를) 결정하지 못했으며, 다음 예외가 발생했습니다:\n%s" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "sphinx-quickstart로 전체 프로젝트 생성" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "automodule %s에 대해 서명 인수 또는 반환 값 주석이 지정됨" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "--full이 주어졌을 때, sys.path에 module_path 추가" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__은 %r이(가) 아닌 문자열의 목록이어야 합니다 (모듈 %s) -- __all__을 무시합니다" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "프로젝트 이름 (기본값: 루트 모듈 이름)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr ":members: 옵션에 언급된 속성이 없습니다: 모듈 %s, 속성 %s" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "--full이 주어졌을 때, 프로젝트 작성자" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "%s 속성이 %s 객체에 없음" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "--full이 주어졌을 때, 프로젝트 버전" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "TypeVar(%s)의 별칭" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "--full이 주어졌을 때, 프로젝트의 릴리스이며 기본값은 --doc-version 값과 같음" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "확장 기능 옵션" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "HTML 페이지는 %(outdir)s에 있습니다." -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." -msgstr "%s은(는) 디렉토리가 아닙니다." +msgid "Failed to read build info file: %r" +msgstr "빌드 정보 파일을 읽을 수 없습니다: %r" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" -msgstr "" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "색인" -#: ext/apidoc/_extension.py:121 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "다음" -#: ext/apidoc/_extension.py:140 -#, python-format -msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "이전" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "색인 생성 중" -#: ext/apidoc/_extension.py:157 -#, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" -msgstr "" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "추가 페이지 작성 중" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:192 -#, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "다운로드 가능한 파일을 복사하는 중… " -#: ext/apidoc/_extension.py:210 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "다운로드 가능한 파일 %r을(를) 복사할 수 없습니다: %s" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "html_static_file에 있는 파일을 복사할 수 없습니다: %s: %r" -#: ext/apidoc/_generate.py:69 -#, python-format -msgid "Would create file %s." -msgstr "%s 파일을 작성합니다." +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "정적 파일을 복사하는 중" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:923 #, python-format -msgid "(in %s v%s)" -msgstr "(%s v%s에서)" +msgid "cannot copy static file %r" +msgstr "정적 파일을 복사할 수 없습니다: %r" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" -msgstr "(%s에서)" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "추가 파일을 복사하는 중" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:938 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "" +msgid "cannot copy extra file %r" +msgstr "추가 파일을 복사할 수 없습니다: %r" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:944 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "" +msgid "Failed to write build info file: %r" +msgstr "빌드 정보 파일 쓰기 실패: %r" + +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "검색 색인을 불러올 수 없지만 모든 문서가 작성되지는 않은 것은 아닙니다. 색인이 불완전합니다." -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "%s 페이지가 html_sidebars의 두 패턴(%r 및 %r)과 일치합니다" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1204 #, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "%s 페이지를 렌더링 할 때 유니코드 오류가 발생했습니다. ASCII가 아닌 내용을 포함하는 모든 설정값이 유니코드 문자열인지 확인하십시오." -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:1217 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1225 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "외부 %s:%s 참조 대상을 찾을 수 없음: %s" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "%s 페이지를 렌더링하는 중에 오류가 발생했습니다.\n원인: %r" + +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "객체 인벤토리 덤프 중" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1266 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "dumping search index in %s" +msgstr "%s에서 검색 인덱스 덤프 중" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +msgid "invalid js_file: %r, ignored" +msgstr "잘못된 js_file: %r, 무시합니다" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "여러 math_renderers가 등록되어 있습니다. 하지만 math_renderer가 선택되지 않았습니다." -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "Unknown math_renderer %r is given." +msgstr "알 수 없는 math_renderer %r이(가) 지정되었습니다." -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "html_extra_path 항목 %r이(가) outdir 안에 있습니다" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "html_extra_path 항목 %r이(가) 없습니다" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "html_static_path 항목 %r이(가) outdir 안에 있습니다" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" +msgstr "html_static_path 항목 %r이(가) 없습니다" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" +msgid "logo file %r does not exist" +msgstr "로고 파일 %r이(가) 존재하지 않습니다" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "Favicon 파일 %r이(가) 존재하지 않습니다" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "일부 인벤토리에서 몇 가지 문제가 발생했지만, 동작하는 대체 인벤토리로 처리했습니다:" - -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "다음 문제가 있어 어느 인벤토리도 도달하지 못했습니다:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "intersphinx 인벤토리가 이동함: %s -> %s" +msgid "%s %s documentation" +msgstr "%s %s 문서" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "member-order 옵션에 대해 잘못된 값: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r에 \"theme\" 설정이 없습니다" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "class-doc-from 옵션에 대해 잘못된 값: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r에 \"%s\" 설정이 없습니다" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "auto%s (%r)에 대한 잘못된 서명" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "%s에 대한 인수를 서식화하는 동안 오류 발생: %s" +msgid "Failed to get a docname for source %r!" +msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "autodoc: 문서화 할 %s.%s (%r) 을(를) 결정하지 못했으며, 다음 예외가 발생했습니다:\n%s" +msgid "No footnote was found for given reference node %r" +msgstr "" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "LaTeX 파일은 %(outdir)s에 있습니다." + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "%r의 자동 문서화를 위해 가져올 모듈을 알 수 없습니다 (문서에 \"module\" 또는 \"currentmodule\" 지시문을 배치하거나, 명시적으로 모듈 이름을 지정해 보십시오)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\n(pdf)latex을 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오\n(자동으로 수행하려면 여기에서 'make latexpdf'를 사용하십시오)." -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" -msgstr "모의 객체가 감지되었습니다: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "\"latex_documents\" 설정값이 없으므로, 문서를 작성하지 않습니다" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "%s에 대한 서명을 서식화하는 동안 오류 발생: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "\"latex_documents\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "automodule 이름의 \"::\"은 의미가 없음" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "TeX 지원 파일을 복사하는 중" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "automodule %s에 대해 서명 인수 또는 반환 값 주석이 지정됨" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "추가 파일을 복사하는 중" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__은 %r이(가) 아닌 문자열의 목록이어야 합니다 (모듈 %s) -- __all__을 무시합니다" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "알 수 없는 설정 키: latex_elements[%r], 무시합니다." -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr ":members: 옵션에 언급된 속성이 없습니다: 모듈 %s, 속성 %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "알 수 없는 테마 옵션: latex_theme_options[%r], 무시합니다." -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "%s에 대한 함수 서명을 가져오지 못했습니다: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s에 이미 구역 번호가 할당되었습니다 (중첩된 번호 붙인 toctree?)" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "%s에 대한 생성자 서명을 가져오지 못했습니다: %s" +msgid "image file not readable: %s" +msgstr "이미지 파일을 읽을 수 없음: %s" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" -msgstr "기반 클래스: %s" +msgid "image file %s not readable: %s" +msgstr "이미지 파일 %s을(를) 읽을 수 없음: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" -msgstr "%s 속성이 %s 객체에 없음" +msgid "download file not readable: %s" +msgstr "다운로드 가능 파일을 읽을 수 없음: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" -msgstr "%s의 별칭" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "순환 toctree 참조가 감지되었으며, 무시합니다: %s <- %s" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "TypeVar(%s)의 별칭" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "toctree에 제목이 없는 문서 %r에 대한 참조가 있습니다. 링크가 생성되지 않습니다" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "%s에 대한 메소드 서명을 가져오지 못했습니다: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "%s에서 잘못된 __slots__ 가 발견되었습니다. 무시합니다." +msgid "toctree contains reference to non-existing document %r" +msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "%r에 대한 기본 인수 값을 해석하지 못했습니다: %s" +msgid "see %s" +msgstr "%s 문서" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "%r에 대한 서명을 업데이트하지 못했습니다. 매개변수를 찾을 수 없습니다: %s" +msgid "see also %s" +msgstr "%s 참조" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "%r에 대한 type_comment를 해석하지 못했습니다: %s" +msgid "unknown index entry type %r" +msgstr "알 수 없는 색인 항목 유형 %r" diff --git a/sphinx/locale/lt/LC_MESSAGES/sphinx.mo b/sphinx/locale/lt/LC_MESSAGES/sphinx.mo index cf199a84b91..3b6bca580f3 100644 Binary files a/sphinx/locale/lt/LC_MESSAGES/sphinx.mo and b/sphinx/locale/lt/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/lt/LC_MESSAGES/sphinx.po b/sphinx/locale/lt/LC_MESSAGES/sphinx.po index e654c99e84b..f532555aba0 100644 --- a/sphinx/locale/lt/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/lt/LC_MESSAGES/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: DALIUS DOBRAVOLSKAS , 2010\n" "Language-Team: Lithuanian (http://app.transifex.com/sphinx-doc/sphinx-1/language/lt/)\n" @@ -19,6 +19,127 @@ msgstr "" "Language: lt\n" "Plural-Forms: nplurals=4; plural=(n % 10 == 1 && (n % 100 > 19 || n % 100 < 11) ? 0 : (n % 10 >= 2 && n % 10 <=9) && (n % 100 > 19 || n % 100 < 11) ? 1 : n % 1 != 0 ? 2: 3);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -33,127 +154,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +322,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,468 +537,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Dėmesio" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Atsargiai" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Pavojinga" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Klaida" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Patarimas" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Svarbu" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Pastaba" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Taip pat žiūrėkite" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Patarimas" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Įspėjimas" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (kuris yra " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[šaltinis]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[dokumentai]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Modulio kodas" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Kodas %s

        " +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Apžvalga: modulio kodas" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Visi moduliai turintys kodą

        " +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "invalid css_file: %r, ignored" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/xml.py:29 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Įtaisytieji" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Modulio lygis" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -739,9 +1175,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -776,6 +1213,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Padaryti" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "originalus įrašas" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -863,879 +1328,960 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Padaryti" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "originalus įrašas" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Skyriaus autorius: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[šaltinis]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Modulio autorius: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Kodo autorius: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[dokumentai]" -#: directives/other.py:209 -msgid "Author: " -msgstr "Autorius: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Modulio kodas" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Kodas %s

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Apžvalga: modulio kodas" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Visi moduliai turintys kodą

        " + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:92 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:56 +#: domains/math.py:73 #, python-format -msgid "no changes in version %s." +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Įtaisytieji" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (itaisytoji funkcija)" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Modulio lygis" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s metodas)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (klasė)" -#: builders/changes.py:133 +#: domains/javascript.py:188 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (globalus kintamasis arba konstanta)" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s atributas)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumentais" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Išmeta" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Grąžinamos reikšmės" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Grąžinamos reikšmės tipas" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (modulis)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funkcija" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metodas" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klasė" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "duomenys" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribudas" -#: builders/__init__.py:275 +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modulis" + +#: domains/javascript.py:458 #, python-format -msgid "all of %d po files" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s (directive)" +msgstr "%s (direktyva)" -#: builders/__init__.py:309 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are out of date" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (rolė)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "direktyva" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:330 +#: domains/rst.py:236 +msgid "role" +msgstr "rolė" + +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/changeset.py:32 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:348 +#: domains/changeset.py:33 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "Changed in version %s" +msgstr "Pakeista %s versijoje" -#: builders/__init__.py:361 +#: domains/changeset.py:34 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Nebepalaikoma nuo %s versijos" -#: builders/__init__.py:377 +#: domains/changeset.py:35 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/__init__.py:322 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:410 -#, python-format -msgid "%d found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: cmd/build.py:357 #, python-format -msgid "error writing file %s: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (kuris yra " +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:464 +#: cmd/quickstart.py:134 #, python-format -msgid "cannot write image file %r: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:242 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%Y-%m-%d" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "" + +#: cmd/quickstart.py:520 +#, python-format msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" + +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 +#: cmd/quickstart.py:671 #, python-format -msgid "Domain %r is not registered" +msgid "enable %s extension" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/nodes.py:490 +#: cmd/quickstart.py:810 #, python-format -msgid "toctree contains ref to nonexisting file %r" +msgid "Invalid template variable: %s" msgstr "" -#: util/nodes.py:706 +#: directives/other.py:119 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/display.py:87 -msgid "failed" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/osutil.py:131 +#: directives/other.py:169 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Skyriaus autorius: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Modulio autorius: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Kodo autorius: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autorius: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "" + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: util/docutils.py:789 +#: directives/code.py:87 #, python-format -msgid "unknown node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: util/fileutil.py:76 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: util/fileutil.py:89 +#: directives/code.py:216 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: util/rst.py:73 +#: directives/code.py:231 #, python-format -msgid "default role %s not found" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/inventory.py:147 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: util/inventory.py:166 +#: directives/code.py:276 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "Object named %r not found in include file %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Išnašos" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[paveiksliukas]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%Y-%m-%d" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1744,11 +2290,15 @@ msgstr "[paveiksliukas]" msgid "Index" msgstr "Indeksas" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Išnašos" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "" @@ -1758,884 +2308,534 @@ msgstr "" msgid "unimplemented node type: %r" msgstr "" -#: writers/latex.py:361 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "[image: %s]" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[paveiksliukas]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" msgstr "" -#: writers/latex.py:591 +#: writers/html5.py:441 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "Any IDs not assigned for %s node" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: writers/latex.py:1580 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "dimension unit %s is invalid. Ignored." +msgid "unsupported rubric heading level: %s" msgstr "" -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" - -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" - -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "" - -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (itaisytoji funkcija)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metodas)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (klasė)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (globalus kintamasis arba konstanta)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s atributas)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumentais" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Išmeta" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Grąžinamos reikšmės" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Grąžinamos reikšmės tipas" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modulis)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funkcija" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metodas" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klasė" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "duomenys" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atribudas" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modulis" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Pakeista %s versijoje" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Nebepalaikoma nuo %s versijos" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktyva)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (rolė)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "direktyva" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:236 -msgid "role" -msgstr "rolė" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "" - -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Dėmesio" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Atsargiai" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Pavojinga" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Klaida" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Patarimas" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Svarbu" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Pastaba" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Taip pat žiūrėkite" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Patarimas" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Įspėjimas" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "" - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "" - -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "" - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "" - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "" - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "" - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "" - -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" -msgstr "" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "" - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:367 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:396 +#: writers/latex.py:1198 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:406 +#: writers/latex.py:1228 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:1615 #, python-format -msgid "Creating file %s." +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: writers/latex.py:1950 #, python-format -msgid "File %s already exists, skipping." -msgstr "" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:670 +#: transforms/__init__.py:258 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:809 +#: util/i18n.py:146 #, python-format -msgid "Invalid template variable: %s" +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" + +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:131 +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "" + +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "tęsinys iš praeito puslapio" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Leidimas" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "" + +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Paslėpti šoninę juostą" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigacija" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Ieškoti tarp %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Apie šiuos dokumentus" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Paieška" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Pirmyn" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Autoriaus teisės" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Paskutinis atnaujinimas %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Praeita tema" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "praeita dalis" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Kita tema" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "kita dalis" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Pilnas indeksas viename puslapyje" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Šis puslapis" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Rodyti pirminį kodą" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Turinys" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Ieškoti %(docstitle)s" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Greitoji paieška" + +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Pirmyn" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2682,7 +2882,7 @@ msgstr "Globalus Modulio Indeksas" msgid "quick access to all modules" msgstr "greitas visų modulių pasiekimas" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Bendras indeksas" @@ -2690,23 +2890,15 @@ msgstr "Bendras indeksas" msgid "all functions, classes, terms" msgstr "visos funkcijos, klasės ir terminai" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Šis puslapis" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Pilnas indeksas viename puslapyje" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Greitoji paieška" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "Ieškoti %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2716,57 +2908,6 @@ msgstr "Indekso puslapiai pagal raidę" msgid "can be huge" msgstr "gali būti didelis" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Praeita tema" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "praeita dalis" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Kita tema" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "kita dalis" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigacija" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Ieškoti tarp %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Apie šiuos dokumentus" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Autoriaus teisės" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Paskutinis atnaujinimas %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2783,21 +2924,21 @@ msgstr "" msgid "search" msgstr "ieškoti" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Paslėpti paieškos rezultatus" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Turinys" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Paieškos rezultatai" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2807,22 +2948,21 @@ msgstr[1] "" msgstr[2] "" msgstr[3] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Paslėpti paieškos rezultatus" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2830,6 +2970,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2851,120 +2996,127 @@ msgstr "Kiti pakeitimai" msgid "Expand sidebar" msgstr "Išplėsti šoninę juostą" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametrai" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Kintamieji" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Sukelia" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (modulyje %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (modulje %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (įtaisytasis kintamasis)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (įtaisytoji klasė)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (klasė iš %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klasės metodas)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statinis metodas)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moduliai" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Atmestas" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "išimtis" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "klasės metodas" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statinis metodas" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (atmestas)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametrai" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Kintamieji" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Sukelia" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2975,92 +3127,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "narys" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tipas" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "kintamasis" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "makrokomanda" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "aplinkos kintamasis; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3098,571 +3243,479 @@ msgstr "gramatinė leksema" #: domains/std/__init__.py:731 msgid "reference label" -msgstr "nuorodos požymis" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "aplinkos kintamasis" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "programos parinktis" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Modulio indeksas" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" +msgstr "nuorodos požymis" -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "aplinkos kintamasis" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "programos parinktis" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Modulio indeksas" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "indeksas" - -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "kitas" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "praeitas" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Leidimas" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "tęsinys iš praeito puslapio" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3670,548 +3723,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "indeksas" + +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "kitas" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "praeitas" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/lv/LC_MESSAGES/sphinx.mo b/sphinx/locale/lv/LC_MESSAGES/sphinx.mo index f3593f7a573..b377937aa0d 100644 Binary files a/sphinx/locale/lv/LC_MESSAGES/sphinx.mo and b/sphinx/locale/lv/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/lv/LC_MESSAGES/sphinx.po b/sphinx/locale/lv/LC_MESSAGES/sphinx.po index ecd1aa52477..0edd34a0e39 100644 --- a/sphinx/locale/lv/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/lv/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Latvian (http://app.transifex.com/sphinx-doc/sphinx-1/language/lv/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: lv\n" "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n != 0 ? 1 : 2);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,468 +536,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Uzmanību" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Uzmanies" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Bīstami" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Kļūda" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Mājiens" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Svarīgi" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Piezīme" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Skat.arī" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Padoms" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Brīdinājums" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (iekš " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[kods]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[dokumenti]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Moduļa teksts" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        %s izejas teksts

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Apskats: moduļa teksts" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Visi moduļi, kuriem ir izejas teksti

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "error writing file %s: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:436 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Iebūvētie" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Moduļu līmenis" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -738,9 +1174,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Jāizdara" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "sākotnējs ieraksts" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,879 +1327,960 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Jāizdara" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "sākotnējs ieraksts" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:47 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Sekcijas autors: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[kods]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Moduļa autors: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Koda autors: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[dokumenti]" -#: directives/other.py:209 -msgid "Author: " -msgstr "Autors: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Moduļa teksts" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        %s izejas teksts

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Apskats: moduļa teksts" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Visi moduļi, kuriem ir izejas teksti

        " + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:92 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:56 +#: domains/math.py:73 #, python-format -msgid "no changes in version %s." +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Iebūvētie" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (iebūvēta funkcija)" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Moduļu līmenis" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s metods)" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" msgstr "" -#: builders/changes.py:133 +#: domains/javascript.py:188 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (globālais mainīgais vai konstanta)" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s atributs)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumenti" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Izmet" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Atgriež" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Atgriežamais tips" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (modulis)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funkcija" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metods" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klase" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "dati" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atributs" -#: builders/__init__.py:275 +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modulis" + +#: domains/javascript.py:458 #, python-format -msgid "all of %d po files" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s (directive)" +msgstr "%s (direktīva)" -#: builders/__init__.py:309 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are out of date" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (role)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "direktīva" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:330 +#: domains/rst.py:236 +msgid "role" +msgstr "role" + +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/changeset.py:32 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:348 +#: domains/changeset.py:33 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "Changed in version %s" +msgstr "Mainīts versijā %s" -#: builders/__init__.py:361 +#: domains/changeset.py:34 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Neieteicams no versijas %s" -#: builders/__init__.py:377 +#: domains/changeset.py:35 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/__init__.py:322 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:410 -#, python-format -msgid "%d found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: cmd/build.py:357 #, python-format -msgid "error writing file %s: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (iekš " +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:464 +#: cmd/quickstart.py:134 #, python-format -msgid "cannot write image file %r: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:242 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d.%m.%Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "" + +#: cmd/quickstart.py:520 +#, python-format msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" + +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 +#: cmd/quickstart.py:671 #, python-format -msgid "Domain %r is not registered" +msgid "enable %s extension" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/nodes.py:490 +#: cmd/quickstart.py:810 #, python-format -msgid "toctree contains ref to nonexisting file %r" +msgid "Invalid template variable: %s" msgstr "" -#: util/nodes.py:706 +#: directives/other.py:119 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/display.py:87 -msgid "failed" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/osutil.py:131 +#: directives/other.py:169 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Sekcijas autors: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Moduļa autors: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Koda autors: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autors: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "" + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: util/docutils.py:789 +#: directives/code.py:87 #, python-format -msgid "unknown node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: util/fileutil.py:76 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: util/fileutil.py:89 +#: directives/code.py:216 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: util/rst.py:73 +#: directives/code.py:231 #, python-format -msgid "default role %s not found" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/inventory.py:147 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: util/inventory.py:166 +#: directives/code.py:276 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "Object named %r not found in include file %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Vēres" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" -msgstr "[attēls: %s]" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[attēls]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d.%m.%Y" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1743,11 +2289,15 @@ msgstr "[attēls]" msgid "Index" msgstr "Indekss" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Vēres" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "" @@ -1757,884 +2307,534 @@ msgstr "" msgid "unimplemented node type: %r" msgstr "" -#: writers/latex.py:361 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" +msgid "[image: %s]" +msgstr "[attēls: %s]" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[attēls]" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: writers/latex.py:591 +#: writers/html5.py:431 #, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" +msgid "numfig_format is not defined for %s" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: writers/html5.py:441 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Any IDs not assigned for %s node" msgstr "" -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "unsupported rubric heading level: %s" msgstr "" -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" - -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" - -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "" - -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (iebūvēta funkcija)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metods)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (globālais mainīgais vai konstanta)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s atributs)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumenti" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Izmet" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Atgriež" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Atgriežamais tips" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modulis)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funkcija" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metods" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klase" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "dati" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atributs" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modulis" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Mainīts versijā %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Neieteicams no versijas %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktīva)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (role)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "direktīva" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:236 -msgid "role" -msgstr "role" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "" - -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Uzmanību" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Uzmanies" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Bīstami" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Kļūda" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Mājiens" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Svarīgi" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Piezīme" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Skat.arī" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Padoms" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Brīdinājums" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "" - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "" - -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "" - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "" - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "" - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "" - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "" - -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" -msgstr "" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "" - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:367 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:396 +#: writers/latex.py:1198 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:406 +#: writers/latex.py:1228 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:1615 #, python-format -msgid "Creating file %s." +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: writers/latex.py:1950 #, python-format -msgid "File %s already exists, skipping." -msgstr "" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:670 +#: transforms/__init__.py:258 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:809 +#: util/i18n.py:146 #, python-format -msgid "Invalid template variable: %s" +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" + +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:131 +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "" + +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "turpinājums no iepriekšējās lappuses" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Izlaidums" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "" + +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Savērst sānjoslu" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigācija" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Meklēt iekš %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Par šiem dokumentiem" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Meklēt" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Izpildīt" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Pēdējas izmaiņas %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "iepriekšēja tēma" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "iepriekšēja sadaļa" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "nākoša tēma" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "nākoša sadaļa" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Pilns indekss vienā lappusē" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Šī lappuse" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Rādīt izejas tekstu" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Saturs" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "%(docstitle)s meklēšana" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Ātra meklēšana" + +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Izpildīt" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2681,7 +2881,7 @@ msgstr "Vispārējs moduļu indekss" msgid "quick access to all modules" msgstr "ātra piekļuve visiem moduliem" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Vispārējs indekss" @@ -2689,23 +2889,15 @@ msgstr "Vispārējs indekss" msgid "all functions, classes, terms" msgstr "visas funkcijas, klases un termini" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Šī lappuse" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Pilns indekss vienā lappusē" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Ātra meklēšana" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "%(docstitle)s meklēšana" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2715,57 +2907,6 @@ msgstr "Lappušu indekss pēc burtiem" msgid "can be huge" msgstr "var būt milzīgs" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "iepriekšēja tēma" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "iepriekšēja sadaļa" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "nākoša tēma" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "nākoša sadaļa" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigācija" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Meklēt iekš %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Par šiem dokumentiem" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Pēdējas izmaiņas %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "meklēt" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Paslēpt atlases vārdus" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Saturs" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Atlases rezultāti" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2805,22 +2946,21 @@ msgstr[0] "" msgstr[1] "" msgstr[2] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Paslēpt atlases vārdus" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2828,6 +2968,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2849,120 +2994,127 @@ msgstr "Citas izmaiņas" msgid "Expand sidebar" msgstr "Izplest sānjoslu" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametri" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Mainīgie" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Ceļ" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (moduļī %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (moduļī %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (iebūvētais mainīgais)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (iebūvēta klase)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (klase iekš %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klases metods)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statiskais metods)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moduļi" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Nav ieteicams" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "izņēmums" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "klases metods" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statiskais metods" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametri" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Mainīgie" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Ceļ" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2973,92 +3125,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "loceklis" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tips" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "mainīgais" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "makross" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "apkārtnes mainīgais; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3096,571 +3241,479 @@ msgstr "gramatiskais marķieris" #: domains/std/__init__.py:731 msgid "reference label" -msgstr "atsauces virsraksts" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "apkārtnes mainīgais" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "programmas opcija" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Moduļu indekss" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" +msgstr "atsauces virsraksts" -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "apkārtnes mainīgais" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "programmas opcija" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Moduļu indekss" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "indekss" - -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "nākošais" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "iepriekšējs" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Izlaidums" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "turpinājums no iepriekšējās lappuses" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3668,548 +3721,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "indekss" + +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "nākošais" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "iepriekšējs" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/mk/LC_MESSAGES/sphinx.mo b/sphinx/locale/mk/LC_MESSAGES/sphinx.mo index a7c10a1c516..09ebc75bfbe 100644 Binary files a/sphinx/locale/mk/LC_MESSAGES/sphinx.mo and b/sphinx/locale/mk/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/mk/LC_MESSAGES/sphinx.po b/sphinx/locale/mk/LC_MESSAGES/sphinx.po index 15ea01bd440..a0c12c1eeee 100644 --- a/sphinx/locale/mk/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/mk/LC_MESSAGES/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Vasil Vangelovski , 2013\n" "Language-Team: Macedonian (http://app.transifex.com/sphinx-doc/sphinx-1/language/mk/)\n" @@ -19,6 +19,127 @@ msgstr "" "Language: mk\n" "Plural-Forms: nplurals=2; plural=(n % 10 == 1 && n % 100 != 11) ? 0 : 1;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Предлог за подобрување на Python; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -33,127 +154,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +322,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,476 +537,632 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (во " + +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:353 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_suffix %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:363 -#, python-format -msgid "source_parser for %r is already registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:372 +#: builders/texinfo.py:218 #, python-format -msgid "Source parser for %s not registered" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:390 +#: builders/manpage.py:37 #, python-format -msgid "Translator for %r already exists" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:496 +#: builders/manpage.py:64 #, python-format -msgid "enumerable_node %r already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:512 +#: builders/singlehtml.py:35 #, python-format -msgid "math renderer %s is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:529 -#, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:552 +#: builders/gettext.py:243 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:565 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "building [%s]: " msgstr "" -#: registry.py:577 +#: builders/gettext.py:265 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "targets for %d template files" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:229 +#: builders/linkcheck.py:87 #, python-format -msgid "invalid CVE number %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:159 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:561 #, python-format -msgid "invalid CWE number %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Предлог за подобрување на Python; PEP %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "" -#: roles.py:317 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid PEP number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:355 +#: builders/epub3.py:83 #, python-format -msgid "invalid RFC number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:118 +#: builders/xml.py:29 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:124 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid option." +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:139 +#: builders/xml.py:103 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:436 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:467 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:568 -#, python-format -msgid "ignoring invalid doctest code: %r" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/imgmath.py:380 +#: builders/_epub_base.py:594 #, python-format -msgid "inline latex %r: %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:48 -#, python-format -msgid "invalid regex %r in %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Вградени" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Ниво на модул" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 #, python-format msgid "module %s could not be imported: %s" msgstr "" @@ -739,9 +1175,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -776,6 +1213,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -863,947 +1328,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "inline latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "" + +#: ext/doctest.py:297 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:231 +#: ext/doctest.py:451 #, python-format -msgid "Include file '%s' not found or reading it failed" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:568 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:276 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Object named %r not found in include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/code.py:314 +#: ext/duration.py:47 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/patches.py:71 +#: ext/duration.py:117 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:124 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:139 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Автор на секцијата:" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Автор на модул:" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Автор на код:" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "" -#: directives/other.py:209 -msgid "Author: " -msgstr "Автор: " +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:75 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:56 +#: domains/citation.py:92 #, python-format -msgid "no changes in version %s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Вградени" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Ниво на модул" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (вградена функција)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s метод)" -#: builders/changes.py:133 +#: domains/javascript.py:186 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s() (class)" +msgstr "%s() (класа)" -#: builders/manpage.py:37 +#: domains/javascript.py:188 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "%s (global variable or constant)" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/manpage.py:71 +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Фрла" + +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Враќа" + +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Повратен тип" + +#: domains/javascript.py:374 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "функција" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:232 -#, python-format -msgid "a suitable image for %s builder not found: %s" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "класа" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:275 +#: domains/javascript.py:458 #, python-format -msgid "all of %d po files" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are specified" +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:309 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are out of date" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:361 +#: domains/rst.py:262 #, python-format -msgid "%d source files given on command line" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:377 +#: domains/changeset.py:32 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/changeset.py:33 #, python-format -msgid "building [%s]: " +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:410 +#: domains/changeset.py:35 #, python-format -msgid "%d found" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:412 -msgid "none found" -msgstr "" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:109 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:558 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "" - -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "" - -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/texinfo.py:89 +#: cmd/build.py:357 #, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (во " +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:134 #, python-format -msgid "unknown mimetype for %s, ignoring" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:794 +#: cmd/quickstart.py:230 #, python-format -msgid "writing %s file..." -msgstr "" - -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/gettext.py:266 +#: cmd/quickstart.py:242 #, python-format -msgid "targets for %d template files" -msgstr "" - -#: builders/gettext.py:271 -msgid "reading templates... " +msgid "Selected root path: %s" msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:298 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:309 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:324 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:397 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: util/i18n.py:245 +#: cmd/quickstart.py:671 #, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +msgid "enable %s extension" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/rst.py:73 +#: cmd/quickstart.py:810 #, python-format -msgid "default role %s not found" +msgid "Invalid template variable: %s" msgstr "" -#: util/inventory.py:147 +#: directives/other.py:119 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/inventory.py:166 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/other.py:169 #, python-format -msgid "[image: %s]" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Автор на секцијата:" + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Автор на модул:" + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Автор на код:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "Автор: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d %b, %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1832,6 +2343,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1848,1871 +2364,1287 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (вградена функција)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s метод)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (класа)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Фрла" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Враќа" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Повратен тип" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "функција" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "класа" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/rst.py:224 +#: writers/latex.py:1228 #, python-format -msgid "%s (role)" -msgstr "" - -#: domains/rst.py:234 -msgid "directive" -msgstr "" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:236 -msgid "role" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/rst.py:262 +#: writers/latex.py:1615 #, python-format -msgid "duplicate description of %s %s, other instance in %s" +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/citation.py:75 +#: writers/latex.py:1950 #, python-format -msgid "duplicate citation %s, other instance in %s" +msgid "unknown index entry type %s found" msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:133 +#: transforms/__init__.py:299 #, python-format -msgid "Please enter one of %s." +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:229 +#: util/inventory.py:147 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "" - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:241 +#: util/inventory.py:166 #, python-format -msgid "Selected root path: %s" -msgstr "" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:273 +#: util/i18n.py:253 +#, python-format msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:286 +#: util/osutil.py:131 +#, python-format msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "" - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "" - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "" - -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "" - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "" - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "" - -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." -msgstr "" - -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "" - -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "" - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "" - -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "" - -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "" - -#: cmd/quickstart.py:809 -#, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "" - -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "" - -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "" - -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" - -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "" - -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" - -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "" - -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "" - -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "" - -#: themes/basic/defindex.html:4 -msgid "Overview" -msgstr "" - -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" -msgstr "" - -#: themes/basic/defindex.html:9 -msgid "the documentation for" -msgstr "" - -#: themes/basic/defindex.html:10 -msgid "last updated" -msgstr "" - -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" -msgstr "" - -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" -msgstr "" - -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "" - -#: domains/std/__init__.py:773 domains/std/__init__.py:786 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "" - -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "" - -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "" - -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Главна содржина" - -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "" - -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "" - -#: themes/basic/relations.html:4 -msgid "Previous topic" +#: util/display.py:87 +msgid "failed" msgstr "" -#: themes/basic/relations.html:6 -msgid "previous chapter" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: themes/basic/relations.html:11 -msgid "Next topic" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: themes/basic/relations.html:13 -msgid "next chapter" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: themes/basic/layout.html:18 -msgid "Navigation" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: themes/basic/layout.html:115 +#: util/fileutil.py:89 #, python-format -msgid "Search within %(docstitle)s" +msgid "Writing evaluated template result to %s" msgstr "" -#: themes/basic/layout.html:124 -msgid "About these documents" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#: util/nodes.py:462 #, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: themes/basic/layout.html:201 +#: util/nodes.py:523 #, python-format -msgid "Last updated on %(last_updated)s." +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: themes/basic/layout.html:204 +#: util/nodes.py:739 #, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: themes/basic/search.html:35 -msgid "search" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Симболи" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: themes/basic/static/searchtools.js:119 -msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: themes/basic/static/searchtools.js:123 -#, python-brace-format -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "" -#: themes/basic/static/searchtools.js:253 -msgid "Searching" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: themes/basic/static/searchtools.js:474 -msgid ", in " +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: themes/basic/changes/rstsource.html:5 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "%(filename)s — %(docstitle)s" +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" +msgid "%s:%s reference target not found: %s" msgstr "" -#: themes/basic/changes/versionchanges.html:17 +#: transforms/post_transforms/__init__.py:297 #, python-format -msgid "Automatically generated list of changes in version %(version)s" +msgid "%r reference target not found: %s" msgstr "" -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: domains/python/_annotations.py:529 -msgid "Positional-only parameter separator (PEP 570)" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: domains/python/_annotations.py:540 -msgid "Keyword-only parameters separator (PEP 3102)" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 -#, python-format -msgid "%s() (in module %s)" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 -#, python-format -msgid "%s (in module %s)" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: domains/python/__init__.py:182 -#, python-format -msgid "%s (built-in variable)" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: domains/python/__init__.py:217 -#, python-format -msgid "%s (built-in class)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: domains/python/__init__.py:218 -#, python-format -msgid "%s (class in %s)" +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: domains/python/__init__.py:283 +#: themes/basic/layout.html:115 #, python-format -msgid "%s() (%s class method)" +msgid "Search within %(docstitle)s" +msgstr "" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "" + +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "" + +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: domains/python/__init__.py:285 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "%s() (%s static method)" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: domains/python/__init__.py:438 +#: themes/basic/layout.html:201 #, python-format -msgid "%s (%s property)" +msgid "Last updated on %(last_updated)s." msgstr "" -#: domains/python/__init__.py:478 +#: themes/basic/layout.html:204 #, python-format -msgid "%s (type alias in %s)" +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: domains/python/__init__.py:638 -msgid "Python Module Index" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: domains/python/__init__.py:639 -msgid "modules" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: domains/python/__init__.py:717 -msgid "Deprecated" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: domains/python/__init__.py:743 -msgid "exception" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: domains/python/__init__.py:745 -msgid "class method" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" msgstr "" -#: domains/python/__init__.py:746 -msgid "static method" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: domains/python/__init__.py:748 -msgid "property" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" -#: domains/python/__init__.py:749 -msgid "type alias" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" msgstr "" -#: domains/python/__init__.py:818 -#, python-format -msgid "" -"duplicate object description of %s, other instance in %s, use :no-index: for" -" one of them" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: domains/python/__init__.py:978 -#, python-format -msgid "more than one target found for cross-reference %r: %s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" -#: domains/python/__init__.py:1052 -msgid " (deprecated)" +#: themes/basic/defindex.html:4 +msgid "Overview" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Параметри" +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" +msgstr "" -#: domains/python/_object.py:206 -msgid "Variables" +#: themes/basic/defindex.html:9 +msgid "the documentation for" msgstr "" -#: domains/python/_object.py:214 -msgid "Raises" +#: themes/basic/defindex.html:10 +msgid "last updated" msgstr "" -#: domains/cpp/__init__.py:159 -msgid "Template Parameters" +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" msgstr "" -#: domains/cpp/__init__.py:302 -#, python-format -msgid "%s (C++ %s)" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "" + +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" msgstr "" -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 -msgid "Return values" +#: themes/basic/defindex.html:19 +msgid "search this documentation" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 -msgid "union" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 -msgid "member" -msgstr "член" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 -msgid "type" -msgstr "тип" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Главна содржина" -#: domains/cpp/__init__.py:944 -msgid "concept" +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 -msgid "enum" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 -msgid "enumerator" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 -msgid "function parameter" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" msgstr "" -#: domains/cpp/__init__.py:952 -msgid "template parameter" +#: themes/basic/genindex-split.html:17 +msgid "can be huge" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." msgstr "" -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 -#, python-format +#: themes/basic/search.html:28 msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." +"Searching for multiple words only shows matches that contain\n" +" all words." msgstr "" -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "променлива" +#: themes/basic/search.html:35 +msgid "search" +msgstr "" -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "макро" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "" -#: domains/c/__init__.py:753 -msgid "struct" +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." msgstr "" -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" + +#: themes/basic/static/searchtools.js:276 +msgid "Searching" msgstr "" -#: domains/std/__init__.py:175 -msgid "Type" +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." msgstr "" -#: domains/std/__init__.py:185 -msgid "Default" +#: themes/basic/static/searchtools.js:526 +msgid ", in " msgstr "" -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" -#: domains/std/__init__.py:319 +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 #, python-format -msgid "%s command line option" +msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" -#: domains/std/__init__.py:321 -msgid "command line option" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" msgstr "" -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" +#: themes/basic/changes/versionchanges.html:17 +#, python-format +msgid "Automatically generated list of changes in version %(version)s" msgstr "" -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" msgstr "" -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" msgstr "" -#: domains/std/__init__.py:730 -msgid "grammar token" +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" msgstr "" -#: domains/std/__init__.py:731 -msgid "reference label" +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/std/__init__.py:733 -msgid "environment variable" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Параметри" -#: domains/std/__init__.py:735 -msgid "document" +#: domains/python/_object.py:206 +msgid "Variables" msgstr "" -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" +#: domains/python/_object.py:214 +msgid "Raises" msgstr "" -#: domains/std/__init__.py:857 +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format -msgid "duplicate %s description of %s, other instance in %s" +msgid "%s() (in module %s)" msgstr "" -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 +#, python-format +msgid "%s (in module %s)" msgstr "" -#: domains/std/__init__.py:1124 +#: domains/python/__init__.py:174 #, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" +msgid "%s (built-in variable)" msgstr "" -#: domains/std/__init__.py:1138 +#: domains/python/__init__.py:209 #, python-format -msgid "the link has no caption: %s" +msgid "%s (built-in class)" msgstr "" -#: domains/std/__init__.py:1153 +#: domains/python/__init__.py:210 #, python-format -msgid "invalid numfig_format: %s (%r)" +msgid "%s (class in %s)" msgstr "" -#: domains/std/__init__.py:1157 +#: domains/python/__init__.py:275 #, python-format -msgid "invalid numfig_format: %s" +msgid "%s() (%s class method)" msgstr "" -#: domains/std/__init__.py:1453 +#: domains/python/__init__.py:277 #, python-format -msgid "undefined label: %r" +msgid "%s() (%s static method)" msgstr "" -#: domains/std/__init__.py:1456 +#: domains/python/__init__.py:430 #, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" +msgid "%s (%s property)" msgstr "" -#: environment/adapters/toctree.py:324 +#: domains/python/__init__.py:470 #, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" +msgid "%s (type alias in %s)" msgstr "" -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" +#: domains/python/__init__.py:624 +msgid "Python Module Index" msgstr "" -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" +#: domains/python/__init__.py:625 +msgid "modules" msgstr "" -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" +#: domains/python/__init__.py:703 +msgid "Deprecated" msgstr "" -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "погледни %s" +#: domains/python/__init__.py:729 +msgid "exception" +msgstr "" -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "погледни %s" +#: domains/python/__init__.py:731 +msgid "class method" +msgstr "" -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" +#: domains/python/__init__.py:732 +msgid "static method" msgstr "" -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Симболи" +#: domains/python/__init__.py:734 +msgid "property" +msgstr "" -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" +#: domains/python/__init__.py:735 +msgid "type alias" msgstr "" -#: environment/collectors/asset.py:126 +#: domains/python/__init__.py:804 #, python-format -msgid "image file %s not readable: %s" +msgid "" +"duplicate object description of %s, other instance in %s, use :no-index: for" +" one of them" msgstr "" -#: environment/collectors/asset.py:163 +#: domains/python/__init__.py:974 #, python-format -msgid "download file not readable: %s" +msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/python/__init__.py:1048 +msgid " (deprecated)" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/cpp/__init__.py:302 +#, python-format +msgid "%s (C++ %s)" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 +msgid "Return values" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" +msgstr "член" + +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "тип" + +#: domains/cpp/__init__.py:946 +msgid "concept" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 +msgid "enum" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 +msgid "enumerator" msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 +msgid "function parameter" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/cpp/__init__.py:954 +msgid "template parameter" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/c/__init__.py:211 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "%s (C %s)" msgstr "" -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "променлива" + +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "макро" + +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "environment variable; %s" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:116 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "%s; configuration value" msgstr "" -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." +#: domains/std/__init__.py:172 +msgid "Type" +msgstr "" + +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:239 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: builders/html/__init__.py:348 +#: domains/std/__init__.py:319 #, python-format -msgid "Failed to read build info file: %r" +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "содржина" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "следна" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "претходна" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1124 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1153 #, python-format -msgid "cannot copy static file %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:949 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy extra file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:955 +#: domains/std/__init__.py:1456 #, python-format -msgid "Failed to write build info file: %r" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1224 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "" + +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "%s %s документација" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "" + +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3720,7 +3652,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3735,481 +3667,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "%s is not a directory." +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:256 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "содржина" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "следна" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "претходна" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s документација" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "погледни %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "погледни %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/nb/LC_MESSAGES/sphinx.js b/sphinx/locale/nb/LC_MESSAGES/sphinx.js new file mode 100644 index 00000000000..abe98cfbaf2 --- /dev/null +++ b/sphinx/locale/nb/LC_MESSAGES/sphinx.js @@ -0,0 +1,63 @@ +Documentation.addTranslations({ + "locale": "nb", + "messages": { + "%(filename)s — %(docstitle)s": "", + "© %(copyright_prefix)s %(copyright)s.": "", + ", in ": "", + "About these documents": "", + "Automatically generated list of changes in version %(version)s": "", + "C API changes": "", + "Changes in Version %(version)s — %(docstitle)s": "", + "Collapse sidebar": "", + "Complete Table of Contents": "", + "Contents": "", + "Copyright": "", + "Created using Sphinx %(sphinx_version)s.": "", + "Expand sidebar": "", + "Full index on one page": "", + "General Index": "", + "Global Module Index": "", + "Go": "", + "Hide Search Matches": "", + "Index": "", + "Index – %(key)s": "", + "Index pages by letter": "", + "Indices and tables:": "", + "Last updated on %(last_updated)s.": "", + "Library changes": "", + "Navigation": "", + "Next topic": "", + "Other changes": "", + "Overview": "", + "Please activate JavaScript to enable the search\n functionality.": "", + "Preparing search...": "", + "Previous topic": "", + "Quick search": "", + "Search": "", + "Search Page": "", + "Search Results": "", + "Search finished, found one page matching the search query.": [ + "", + "" + ], + "Search within %(docstitle)s": "", + "Searching": "", + "Searching for multiple words only shows matches that contain\n all words.": "", + "Show Source": "", + "Table of Contents": "", + "This Page": "", + "Welcome! This is": "", + "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", + "all functions, classes, terms": "", + "can be huge": "", + "last updated": "", + "lists all sections and subsections": "", + "next chapter": "", + "previous chapter": "", + "quick access to all modules": "", + "search": "", + "search this documentation": "", + "the documentation for": "" + }, + "plural_expr": "(n != 1)" +}); \ No newline at end of file diff --git a/sphinx/locale/nb/LC_MESSAGES/sphinx.mo b/sphinx/locale/nb/LC_MESSAGES/sphinx.mo new file mode 100644 index 00000000000..52352a5b117 Binary files /dev/null and b/sphinx/locale/nb/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/nb/LC_MESSAGES/sphinx.po b/sphinx/locale/nb/LC_MESSAGES/sphinx.po new file mode 100644 index 00000000000..b8d3ea7c401 --- /dev/null +++ b/sphinx/locale/nb/LC_MESSAGES/sphinx.po @@ -0,0 +1,4304 @@ +# Translations template for Sphinx. +# Copyright (C) 2025 ORGANIZATION +# This file is distributed under the same license as the Sphinx project. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: Sphinx\n" +"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" +"PO-Revision-Date: 2013-04-02 08:44+0000\n" +"Last-Translator: FULL NAME \n" +"Language-Team: Norwegian Bokmål (http://app.transifex.com/sphinx-doc/sphinx-1/language/nb/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.17.0\n" +"Language: nb\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "" + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "" + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 +#, python-format +msgid "Cannot find source directory (%s)" +msgstr "" + +#: application.py:223 +#, python-format +msgid "Output directory (%s) is not a directory" +msgstr "" + +#: application.py:228 +msgid "Source directory and destination directory cannot be identical" +msgstr "" + +#: application.py:258 +#, python-format +msgid "Running Sphinx v%s" +msgstr "" + +#: application.py:286 +#, python-format +msgid "" +"This project needs at least Sphinx v%s and therefore cannot be built with " +"this version." +msgstr "" + +#: application.py:305 +msgid "making output directory" +msgstr "" + +#: application.py:310 registry.py:540 +#, python-format +msgid "while setting up extension %s:" +msgstr "" + +#: application.py:317 +msgid "" +"'setup' as currently defined in conf.py isn't a Python callable. Please " +"modify its definition to make it a callable function. This is needed for " +"conf.py to behave as a Sphinx extension." +msgstr "" + +#: application.py:360 +#, python-format +msgid "loading translations [%s]... " +msgstr "" + +#: application.py:384 util/display.py:89 +msgid "done" +msgstr "" + +#: application.py:386 +msgid "not available for built-in messages" +msgstr "" + +#: application.py:400 +msgid "loading pickled environment" +msgstr "" + +#: application.py:408 +#, python-format +msgid "failed: %s" +msgstr "" + +#: application.py:423 +msgid "No builder selected, using default: html" +msgstr "" + +#: application.py:455 +msgid "build finished with problems." +msgstr "" + +#: application.py:457 +msgid "build succeeded." +msgstr "" + +#: application.py:462 +msgid "" +"build finished with problems, 1 warning (with warnings treated as errors)." +msgstr "" + +#: application.py:466 +msgid "build finished with problems, 1 warning." +msgstr "" + +#: application.py:468 +msgid "build succeeded, 1 warning." +msgstr "" + +#: application.py:474 +#, python-format +msgid "" +"build finished with problems, %s warnings (with warnings treated as errors)." +msgstr "" + +#: application.py:478 +#, python-format +msgid "build finished with problems, %s warnings." +msgstr "" + +#: application.py:480 +#, python-format +msgid "build succeeded, %s warnings." +msgstr "" + +#: application.py:1020 +#, python-format +msgid "node class %r is already registered, its visitors will be overridden" +msgstr "" + +#: application.py:1113 +#, python-format +msgid "directive %r is already registered and will not be overridden" +msgstr "" + +#: application.py:1139 application.py:1167 +#, python-format +msgid "role %r is already registered and will not be overridden" +msgstr "" + +#: application.py:1766 +#, python-format +msgid "" +"the %s extension does not declare if it is safe for parallel reading, " +"assuming it isn't - please ask the extension author to check and make it " +"explicit" +msgstr "" + +#: application.py:1771 +#, python-format +msgid "the %s extension is not safe for parallel reading" +msgstr "" + +#: application.py:1775 +#, python-format +msgid "" +"the %s extension does not declare if it is safe for parallel writing, " +"assuming it isn't - please ask the extension author to check and make it " +"explicit" +msgstr "" + +#: application.py:1780 +#, python-format +msgid "the %s extension is not safe for parallel writing" +msgstr "" + +#: application.py:1788 application.py:1792 +#, python-format +msgid "doing serial %s" +msgstr "" + +#: registry.py:162 +#, python-format +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format +msgid "" +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "" + +#: config.py:374 +#, python-format +msgid "'%s' must be '0' or '1', got '%s'" +msgstr "" + +#: config.py:379 +#, python-format +msgid "" +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" +msgstr "" + +#: config.py:391 +#, python-format +msgid "invalid number %r for config value %r, ignoring" +msgstr "" + +#: config.py:399 +#, python-format +msgid "cannot override config setting %r with unsupported type, ignoring" +msgstr "" + +#: config.py:422 +#, python-format +msgid "unknown config value %r in override, ignoring" +msgstr "" + +#: config.py:476 +#, python-format +msgid "No such config value: %r" +msgstr "" + +#: config.py:504 +#, python-format +msgid "Config value %r already present" +msgstr "" + +#: config.py:541 +#, python-format +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" +msgstr "" + +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 +#, python-format +msgid "There is a syntax error in your configuration file: %s\n" +msgstr "" + +#: config.py:603 +msgid "" +"The configuration file (or one of the modules it imports) called sys.exit()" +msgstr "" + +#: config.py:611 +#, python-format +msgid "" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" +msgstr "" + +#: config.py:633 +#, python-format +msgid "Failed to convert %r to a frozenset" +msgstr "" + +#: config.py:651 config.py:659 +#, python-format +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." +msgstr "" + +#: config.py:665 +#, python-format +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." +msgstr "" + +#: config.py:686 +#, python-format +msgid "Section %s" +msgstr "" + +#: config.py:687 +#, python-format +msgid "Fig. %s" +msgstr "" + +#: config.py:688 +#, python-format +msgid "Table %s" +msgstr "" + +#: config.py:689 +#, python-format +msgid "Listing %s" +msgstr "" + +#: config.py:798 +#, python-brace-format +msgid "" +"The config value `{name}` has to be a one of {candidates}, but `{current}` " +"is given." +msgstr "" + +#: config.py:829 +#, python-brace-format +msgid "" +"The config value `{name}' has type `{current.__name__}'; expected " +"{permitted}." +msgstr "" + +#: config.py:846 +#, python-brace-format +msgid "" +"The config value `{name}' has type `{current.__name__}', defaults to " +"`{default.__name__}'." +msgstr "" + +#: config.py:858 +#, python-format +msgid "primary_domain %r not found, ignored." +msgstr "" + +#: config.py:878 +msgid "" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." +msgstr "" + +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "" + +#: environment/__init__.py:89 +msgid "new config" +msgstr "" + +#: environment/__init__.py:90 +msgid "config changed" +msgstr "" + +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "" + +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "" + +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "" + +#: environment/__init__.py:350 +#, python-format +msgid "The configuration has changed (1 option: %r)" +msgstr "" + +#: environment/__init__.py:355 +#, python-format +msgid "The configuration has changed (%d options: %s)" +msgstr "" + +#: environment/__init__.py:361 +#, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "" + +#: environment/__init__.py:518 +#, python-format +msgid "Failed to scan documents in %s: %r" +msgstr "" + +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 +#, python-format +msgid "Domain %r is not registered" +msgstr "" + +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "" + +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "" + +#: environment/__init__.py:952 +#, python-format +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgstr "" + +#: locale/__init__.py:229 +msgid "Attention" +msgstr "" + +#: locale/__init__.py:230 +msgid "Caution" +msgstr "" + +#: locale/__init__.py:231 +msgid "Danger" +msgstr "" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "" + +#: builders/texinfo.py:41 +#, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "" + +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "" + +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/texinfo.py:85 +#, python-format +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:310 builders/texinfo.py:105 +#, python-format +msgid "processing %s" +msgstr "" + +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "" + +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "" + +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "" + +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "" + +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 +#, python-format +msgid "cannot copy image file %r: %s" +msgstr "" + +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "" + +#: builders/texinfo.py:218 +#, python-format +msgid "error writing file Makefile: %s" +msgstr "" + +#: builders/manpage.py:37 +#, python-format +msgid "The manual pages are in %(outdir)s." +msgstr "" + +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "" + +#: builders/manpage.py:64 +#, python-format +msgid "\"man_pages\" config value references unknown document %s" +msgstr "" + +#: builders/singlehtml.py:35 +#, python-format +msgid "The HTML page is in %(outdir)s." +msgstr "" + +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "" + +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "" + +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "" + +#: builders/gettext.py:243 +#, python-format +msgid "The message catalogs are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:400 builders/gettext.py:264 +#, python-format +msgid "building [%s]: " +msgstr "" + +#: builders/gettext.py:265 +#, python-format +msgid "targets for %d template files" +msgstr "" + +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "" + +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "" + +#: builders/linkcheck.py:87 +#, python-format +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "" + +#: builders/linkcheck.py:159 +#, python-format +msgid "broken link: %s (%s)" +msgstr "" + +#: builders/linkcheck.py:561 +#, python-format +msgid "Anchor '%s' not found" +msgstr "" + +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "" + +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "" + +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." +msgstr "" + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "" + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" +msgstr "" + +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." +msgstr "" + +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" +msgstr "" + +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "" + +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" +msgstr "" + +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" +msgstr "" + +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" +msgstr "" + +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "" + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "" + +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" +msgstr "" + +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" +msgstr "" + +#: ext/graphviz.py:153 +#, python-format +msgid "External Graphviz file %r not found or reading it failed" +msgstr "" + +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "" + +#: ext/graphviz.py:287 +#, python-format +msgid "graphviz_dot executable path must be set! %r" +msgstr "" + +#: ext/graphviz.py:328 +#, python-format +msgid "" +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" +msgstr "" + +#: ext/graphviz.py:339 +#, python-format +msgid "" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "" + +#: ext/graphviz.py:344 +#, python-format +msgid "" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "" + +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" +msgstr "" + +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" +msgstr "" + +#: ext/graphviz.py:493 ext/graphviz.py:501 +#, python-format +msgid "[graph: %s]" +msgstr "" + +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" +msgstr "" + +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "" + +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "" + +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "" + +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" + +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" + +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "" + +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "" + +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" +msgstr "" + +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "" + +#: ext/doctest.py:297 +#, python-format +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "" + +#: ext/doctest.py:451 +#, python-format +msgid "no code/output in %s block at %s:%s" +msgstr "" + +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" +msgstr "" + +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "" + +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "" + +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" + +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" + +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" +msgstr "" + +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "" + +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" + +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "" + +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "" + +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "" + +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "" + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" +msgstr "" + +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." +msgstr "" + +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" +msgstr "" + +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "" + +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "" + +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "" + +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "" + +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" +msgstr "" + +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" +msgstr "" + +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "" + +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "" + +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "" + +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "" + +#: domains/javascript.py:374 +#, python-format +msgid "%s (module)" +msgstr "" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "" + +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" +msgstr "" + +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" +msgstr "" + +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr "" + +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "" + +#: domains/rst.py:234 +msgid "directive" +msgstr "" + +#: domains/rst.py:235 +msgid "directive-option" +msgstr "" + +#: domains/rst.py:236 +msgid "role" +msgstr "" + +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "" + +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" +msgstr "" + +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "" + +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "" + +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" +msgstr "" + +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "" + +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "" + +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" + +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "" + +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "" + +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "" + +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "" + +#: cmd/build.py:114 +msgid "general options" +msgstr "" + +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "" + +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "" + +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "" + +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "" + +#: cmd/build.py:150 +msgid "path options" +msgstr "" + +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "" + +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "" + +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "" + +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "" + +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "" + +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "" + +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "" + +#: cmd/build.py:212 +msgid "console output options" +msgstr "" + +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "" + +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "" + +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "" + +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "" + +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "" + +#: cmd/build.py:252 +msgid "warning control options" +msgstr "" + +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "" + +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "" + +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "" + +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "" + +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" + +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "" + +#: cmd/build.py:357 +#, python-format +msgid "cannot open warning file '%s': %s" +msgstr "" + +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "" + +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "" + +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "" + +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "" + +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "" + +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "" + +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "" + +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" + +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "" + +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "" + +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "" + +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "" + +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "" + +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "" + +#: cmd/quickstart.py:134 +#, python-format +msgid "Please enter one of %s." +msgstr "" + +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "" + +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "" + +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "" + +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "" + +#: cmd/quickstart.py:242 +#, python-format +msgid "Selected root path: %s" +msgstr "" + +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "" + +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "" + +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "" + +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "" + +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "" + +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "" + +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "" + +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "" + +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "" + +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "" + +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "" + +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "" + +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "" + +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "" + +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "" + +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "" + +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "" + +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "" + +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "" + +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "" + +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "" + +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "" + +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "" + +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "" + +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "" + +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "" + +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "" + +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "" + +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "" + +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." +msgstr "" + +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." +msgstr "" + +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "" + +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "" + +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "" + +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "" + +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "" + +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "" + +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "" + +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "" + +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "" + +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "" + +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "" + +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "" + +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "" + +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "" + +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "" + +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "" + +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "" + +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "" + +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" + +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "" + +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "" + +#: cmd/quickstart.py:810 +#, python-format +msgid "Invalid template variable: %s" +msgstr "" + +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" +msgstr "" + +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" +msgstr "" + +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "" + +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "" + +#: directives/other.py:203 +msgid "Section author: " +msgstr "" + +#: directives/other.py:205 +msgid "Module author: " +msgstr "" + +#: directives/other.py:207 +msgid "Code author: " +msgstr "" + +#: directives/other.py:209 +msgid "Author: " +msgstr "" + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "" + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "" + +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" +msgstr "" + +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" +msgstr "" + +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "" + +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" +msgstr "" + +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" + +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "" + +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "" + +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "" + +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "" + +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" +msgstr "" + +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "" + +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" + +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" + +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" + +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" + +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" + +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" + +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "" + +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" + +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" +msgstr "" + +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "" + +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "" + +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "" + +#: writers/latex.py:1228 +#, python-format +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" + +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "" + +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "" + +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" + +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" + +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" + +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" + +#: _cli/__init__.py:98 +msgid "Options" +msgstr "" + +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" + +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "" + +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" + +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "" + +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" + +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" + +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" + +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" + +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" + +#: _cli/__init__.py:231 +msgid "" +msgstr "" + +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" + +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "" + +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "" + +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "" + +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" + +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" + +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "" + +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "" + +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" + +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "" + +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" + +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" + +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "" + +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "" + +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" + +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" + +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "" + +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "" + +#: util/display.py:82 +msgid "skipped" +msgstr "" + +#: util/display.py:87 +msgid "failed" +msgstr "" + +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "" + +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "" + +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "" + +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" + +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" +msgstr "" + +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "" + +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "" + +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" + +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "" + +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "" + +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "" + +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "" + +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "" + +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "" + +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "" + +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "" + +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "" + +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "" + +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "" + +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "" + +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "" + +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "" + +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "" + +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "" + +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "" + +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "" + +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "" + +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "" + +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "" + +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "" + +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "" + +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "" + +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "" + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "" + +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "" + +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "" + +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "" + +#: themes/basic/defindex.html:4 +msgid "Overview" +msgstr "" + +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" +msgstr "" + +#: themes/basic/defindex.html:9 +msgid "the documentation for" +msgstr "" + +#: themes/basic/defindex.html:10 +msgid "last updated" +msgstr "" + +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" +msgstr "" + +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "" + +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "" + +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "" + +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "" + +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "" + +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "" + +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "" + +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "" + +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "" + +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "" + +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "" + +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." +msgstr "" + +#: themes/basic/search.html:28 +msgid "" +"Searching for multiple words only shows matches that contain\n" +" all words." +msgstr "" + +#: themes/basic/search.html:35 +msgid "search" +msgstr "" + +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "" + +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "" + +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." +msgstr "" + +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" + +#: themes/basic/static/searchtools.js:276 +msgid "Searching" +msgstr "" + +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "" + +#: themes/basic/static/searchtools.js:526 +msgid ", in " +msgstr "" + +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "" + +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 +#, python-format +msgid "Changes in Version %(version)s — %(docstitle)s" +msgstr "" + +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + +#: themes/basic/changes/versionchanges.html:17 +#, python-format +msgid "Automatically generated list of changes in version %(version)s" +msgstr "" + +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" +msgstr "" + +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" +msgstr "" + +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" +msgstr "" + +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" +msgstr "" + +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" +msgstr "" + +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 +#, python-format +msgid "%s() (in module %s)" +msgstr "" + +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 +#, python-format +msgid "%s (in module %s)" +msgstr "" + +#: domains/python/__init__.py:174 +#, python-format +msgid "%s (built-in variable)" +msgstr "" + +#: domains/python/__init__.py:209 +#, python-format +msgid "%s (built-in class)" +msgstr "" + +#: domains/python/__init__.py:210 +#, python-format +msgid "%s (class in %s)" +msgstr "" + +#: domains/python/__init__.py:275 +#, python-format +msgid "%s() (%s class method)" +msgstr "" + +#: domains/python/__init__.py:277 +#, python-format +msgid "%s() (%s static method)" +msgstr "" + +#: domains/python/__init__.py:430 +#, python-format +msgid "%s (%s property)" +msgstr "" + +#: domains/python/__init__.py:470 +#, python-format +msgid "%s (type alias in %s)" +msgstr "" + +#: domains/python/__init__.py:624 +msgid "Python Module Index" +msgstr "" + +#: domains/python/__init__.py:625 +msgid "modules" +msgstr "" + +#: domains/python/__init__.py:703 +msgid "Deprecated" +msgstr "" + +#: domains/python/__init__.py:729 +msgid "exception" +msgstr "" + +#: domains/python/__init__.py:731 +msgid "class method" +msgstr "" + +#: domains/python/__init__.py:732 +msgid "static method" +msgstr "" + +#: domains/python/__init__.py:734 +msgid "property" +msgstr "" + +#: domains/python/__init__.py:735 +msgid "type alias" +msgstr "" + +#: domains/python/__init__.py:804 +#, python-format +msgid "" +"duplicate object description of %s, other instance in %s, use :no-index: for" +" one of them" +msgstr "" + +#: domains/python/__init__.py:974 +#, python-format +msgid "more than one target found for cross-reference %r: %s" +msgstr "" + +#: domains/python/__init__.py:1048 +msgid " (deprecated)" +msgstr "" + +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" + +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" +msgstr "" + +#: domains/cpp/__init__.py:302 +#, python-format +msgid "%s (C++ %s)" +msgstr "" + +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 +msgid "Return values" +msgstr "" + +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "" + +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" +msgstr "" + +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "" + +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "" + +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 +msgid "enum" +msgstr "" + +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 +msgid "enumerator" +msgstr "" + +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 +msgid "function parameter" +msgstr "" + +#: domains/cpp/__init__.py:954 +msgid "template parameter" +msgstr "" + +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 +#, python-format +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." +msgstr "" + +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "" + +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "" + +#: domains/c/__init__.py:781 +msgid "struct" +msgstr "" + +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" +msgstr "" + +#: domains/std/__init__.py:116 +#, python-format +msgid "%s; configuration value" +msgstr "" + +#: domains/std/__init__.py:172 +msgid "Type" +msgstr "" + +#: domains/std/__init__.py:182 +msgid "Default" +msgstr "" + +#: domains/std/__init__.py:239 +#, python-format +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" +msgstr "" + +#: domains/std/__init__.py:319 +#, python-format +msgid "%s command line option" +msgstr "" + +#: domains/std/__init__.py:321 +msgid "command line option" +msgstr "" + +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" +msgstr "" + +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" +msgstr "" + +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "" + +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "" + +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "" + +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "" + +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "" + +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "" + +#: domains/std/__init__.py:735 +msgid "document" +msgstr "" + +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "" + +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" +msgstr "" + +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "" + +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" +msgstr "" + +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" +msgstr "" + +#: domains/std/__init__.py:1153 +#, python-format +msgid "invalid numfig_format: %s (%r)" +msgstr "" + +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" +msgstr "" + +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" +msgstr "" + +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "" + +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" +msgstr "" + +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" +msgstr "" + +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" +msgstr "" + +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" +msgstr "" + +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "" + +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "" + +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "" + +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "" + +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" + +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" + +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "" + +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" +msgstr "" + +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 +#, python-format +msgid "alias of %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" +msgstr "" + +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" +msgstr "" + +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "" + +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" +msgstr "" + +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "" + +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" +msgstr "" + +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "" + +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "" + +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" + +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "" + +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "" + +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "" + +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "" + +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "" + +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "" + +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "" + +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "" + +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" + +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" + +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "" + +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" + +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "" + +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "" + +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "" + +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "" + +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" +msgstr "" + +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "" + +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "" + +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "" + +#: ext/apidoc/_extension.py:133 +#, python-format +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "" + +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "" + +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "" + +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "" + +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" + +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" + +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "" + +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "" + +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "" + +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 +#, python-format +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "" + +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" +msgstr "" + +#: ext/autosummary/generate.py:634 +#, python-format +msgid "[autosummary] writing to %s" +msgstr "" + +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" + +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "" + +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "" + +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "" + +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "" + +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "" + +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "" + +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "" + +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." +msgstr "" + +#: ext/autosummary/__init__.py:239 +#, python-format +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." +msgstr "" + +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" + +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" +msgstr "" + +#: ext/autosummary/__init__.py:652 +#, python-format +msgid "" +"Summarised items should not include the current module. Replace %r with %r." +msgstr "" + +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" +msgstr "" + +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." +msgstr "" + +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" + +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" + +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" + +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "" + +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "" + +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" + +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "" + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" + +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "" + +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 +#, python-format +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" + +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "" + +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" +msgstr "" + +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "" + +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "" + +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "" + +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" +msgstr "" + +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "" + +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." +msgstr "" + +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" + +#: builders/html/__init__.py:372 +#, python-format +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "" + +#: builders/html/__init__.py:496 +msgid "index" +msgstr "" + +#: builders/html/__init__.py:549 +#, python-format +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "" + +#: builders/html/__init__.py:783 +#, python-format +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "" + +#: builders/html/__init__.py:807 +#, python-format +msgid "cannot copy downloadable file %r: %s" +msgstr "" + +#: builders/html/__init__.py:853 +#, python-format +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgstr "" + +#: builders/html/__init__.py:871 +#, python-format +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "" + +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 +#, python-format +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "" + +#: builders/html/__init__.py:938 +#, python-format +msgid "cannot copy extra file %r" +msgstr "" + +#: builders/html/__init__.py:944 +#, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "" + +#: builders/html/__init__.py:1038 +#, python-format +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "" + +#: builders/html/__init__.py:1204 +#, python-format +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "" + +#: builders/html/__init__.py:1217 +#, python-format +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" +msgstr "" + +#: builders/html/__init__.py:1225 +#, python-format +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "" + +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "" + +#: builders/html/__init__.py:1266 +#, python-format +msgid "dumping search index in %s" +msgstr "" + +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" +msgstr "" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "" + +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." +msgstr "" + +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "" + +#: builders/html/__init__.py:1370 +#, python-format +msgid "html_extra_path entry %r does not exist" +msgstr "" + +#: builders/html/__init__.py:1385 +#, python-format +msgid "html_static_path entry %r is placed inside outdir" +msgstr "" + +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" +msgstr "" + +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 +#, python-format +msgid "logo file %r does not exist" +msgstr "" + +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "" + +#: builders/html/__init__.py:1425 +#, python-format +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." +msgstr "" + +#: builders/html/__init__.py:1438 +msgid "" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "" + +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" +msgstr "" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" +msgstr "" + +#: builders/latex/theming.py:90 +#, python-format +msgid "%r doesn't have \"%s\" setting" +msgstr "" + +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "" + +#: builders/latex/transforms.py:121 +#, python-format +msgid "Failed to get a docname for source %r!" +msgstr "" + +#: builders/latex/transforms.py:487 +#, python-format +msgid "No footnote was found for given reference node %r" +msgstr "" + +#: builders/latex/__init__.py:115 +#, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 +msgid "" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "" + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 +#, python-format +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 +#, python-format +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "" + +#: builders/latex/__init__.py:537 +#, python-format +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "" + +#: environment/collectors/asset.py:98 +#, python-format +msgid "image file not readable: %s" +msgstr "" + +#: environment/collectors/asset.py:126 +#, python-format +msgid "image file %s not readable: %s" +msgstr "" + +#: environment/collectors/asset.py:165 +#, python-format +msgid "download file not readable: %s" +msgstr "" + +#: environment/adapters/toctree.py:335 +#, python-format +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "" + +#: environment/adapters/toctree.py:360 +#, python-format +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "" + +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" +msgstr "" + +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" +msgstr "" + +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "" diff --git a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.js b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.js index b71a4740795..6378774c78a 100644 --- a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.js +++ b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.js @@ -20,7 +20,7 @@ Documentation.addTranslations({ "Go": "G\u00e5", "Hide Search Matches": "Skjul s\u00f8keresultat", "Index": "Index", - "Index – %(key)s": "", + "Index – %(key)s": "Indeks – %(key)s", "Index pages by letter": "Registersider per bokstav", "Indices and tables:": "Registre og tabeller", "Last updated on %(last_updated)s.": "Sist oppdatert %(last_updated)s.", diff --git a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo index bab6698609c..fc5bb2c0e00 100644 Binary files a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo and b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po index 1e16f14a9ec..a8c989b64df 100644 --- a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po @@ -3,14 +3,16 @@ # This file is distributed under the same license as the Sphinx project. # # Translators: +# Lars Stramd, 2025 +# Njam Dal, 2025 # Per Christian Gaustad, 2024 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" -"Last-Translator: Per Christian Gaustad, 2024\n" +"Last-Translator: Njam Dal, 2025\n" "Language-Team: Norwegian Bokmål (Norway) (http://app.transifex.com/sphinx-doc/sphinx-1/language/nb_NO/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -19,6 +21,127 @@ msgstr "" "Language: nb_NO\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -33,127 +156,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +311,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +324,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,468 +539,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" -msgstr "" +msgstr "Fig. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" -msgstr "" +msgstr "Tabell %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Obs" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Advarsel" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Fare" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Feil" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Hint" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Viktig" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Merknad" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Se også" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tips" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Advarsel" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "(i " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[kilde]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[dokumentasjon]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Modul kildekode" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Kildekode for %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Oversikt: modulkildekode" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Alla moduler hvor kildekode finnes

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "error writing file %s: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:436 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Innebygde" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Modulnivå" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -739,9 +1177,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -776,6 +1215,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "opprinnelig oppføring" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -863,879 +1330,960 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Todo" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "opprinnelig oppføring" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:47 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Forfatter av avsnitt: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[kilde]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Forfatter av modul: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Forfatter av kildekode: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[dokumentasjon]" -#: directives/other.py:209 -msgid "Author: " -msgstr "Forfatter: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Modul kildekode" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Kildekode for %s

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Oversikt: modulkildekode" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Alle moduler hvor kildekode finnes

        " + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:92 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:56 +#: domains/math.py:73 #, python-format -msgid "no changes in version %s." +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Innebygde" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (innebygd funksjon)" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Modulnivå" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s metode)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (klasse)" -#: builders/changes.py:133 +#: domains/javascript.py:188 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (global variabel eller konstant)" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s attribut)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argument" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Kaster" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Returnere" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Returtype" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (modul)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funksjon" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metode" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klasse" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "data" -#: builders/__init__.py:275 +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "attributt" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" + +#: domains/javascript.py:458 #, python-format -msgid "all of %d po files" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s (directive)" +msgstr "%s (direktiv)" -#: builders/__init__.py:309 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are out of date" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (rolle)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "direktiv" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:330 +#: domains/rst.py:236 +msgid "role" +msgstr "rolle" + +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/changeset.py:32 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:348 +#: domains/changeset.py:33 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "Changed in version %s" +msgstr "Endret i version %s" -#: builders/__init__.py:361 +#: domains/changeset.py:34 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Frarådet siden version %s" -#: builders/__init__.py:377 +#: domains/changeset.py:35 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/__init__.py:322 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:410 -#, python-format -msgid "%d found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: cmd/build.py:357 #, python-format -msgid "error writing file %s: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr "(i " +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:464 +#: cmd/quickstart.py:134 #, python-format -msgid "cannot write image file %r: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:242 #, python-format -msgid "unknown mimetype for %s, ignoring" +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:350 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d. %b %Y" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:378 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:527 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 +#: cmd/quickstart.py:671 #, python-format -msgid "Domain %r is not registered" +msgid "enable %s extension" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/nodes.py:490 +#: cmd/quickstart.py:810 #, python-format -msgid "toctree contains ref to nonexisting file %r" +msgid "Invalid template variable: %s" msgstr "" -#: util/nodes.py:706 +#: directives/other.py:119 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/display.py:87 -msgid "failed" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/osutil.py:131 +#: directives/other.py:169 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Forfatter av avsnitt: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Forfatter av modul: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Forfatter av kildekode: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Forfatter: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "" + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: util/docutils.py:789 +#: directives/code.py:87 #, python-format -msgid "unknown node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: util/fileutil.py:76 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: util/fileutil.py:89 +#: directives/code.py:216 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: util/rst.py:73 +#: directives/code.py:231 #, python-format -msgid "default role %s not found" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/inventory.py:147 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: util/inventory.py:166 +#: directives/code.py:276 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "Object named %r not found in include file %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Fotnoter" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[bilde]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d. %b %Y" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1744,11 +2292,15 @@ msgstr "[bilde]" msgid "Index" msgstr "Index" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Fotnoter" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "" @@ -1758,53 +2310,14 @@ msgstr "" msgid "unimplemented node type: %r" msgstr "" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown index entry type %s found" +msgid "[image: %s]" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[bilde]" #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" @@ -1832,7 +2345,12 @@ msgstr "" msgid "Link to this table" msgstr "" -#: writers/html5.py:636 +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + +#: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1848,794 +2366,478 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 +#: writers/latex.py:386 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (innebygd funksjon)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metode)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (klasse)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (global variabel eller konstant)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s attribut)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argument" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Kaster" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Returnere" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Retur type" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funksjon" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metode" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klasse" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "data" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "attributt" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modul" - -#: domains/javascript.py:454 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate %s description of %s, other %s in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Endret i version %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Frarådet siden version %s" - -#: domains/changeset.py:29 +#: writers/latex.py:616 #, python-format -msgid "Removed in version %s" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktiv)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (rolle)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "direktiv" - -#: domains/rst.py:235 -msgid "directive-option" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "rolle" - -#: domains/rst.py:262 +#: writers/latex.py:1228 #, python-format -msgid "duplicate description of %s %s, other instance in %s" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/citation.py:75 +#: writers/latex.py:1615 #, python-format -msgid "duplicate citation %s, other instance in %s" +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/citation.py:92 +#: writers/latex.py:1950 #, python-format -msgid "Citation [%s] is not referenced." +msgid "unknown index entry type %s found" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Obs" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Advarsel" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Fare" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Feil" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Hint" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Viktig" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Merknad" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Se også" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tips" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Advarsel" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:234 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "" - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:367 +#: util/i18n.py:100 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:396 +#: util/i18n.py:253 +#, python-format msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:406 +#: util/osutil.py:131 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: util/docutils.py:325 #, python-format -msgid "Creating file %s." +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: util/docutils.py:361 #, python-format -msgid "File %s already exists, skipping." +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:519 +#: util/fileutil.py:76 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:530 +#: util/docfields.py:103 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:572 +#: util/nodes.py:462 +#, python-format msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "" - -#: cmd/quickstart.py:670 +#: util/nodes.py:523 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "fortsettelse fra forrige side" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "fortsetter på neste side" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "Ikke-alfabetisk" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Tall" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "side" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Utgivelse" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:792 +#: transforms/post_transforms/__init__.py:88 msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:131 +#: _cli/util/errors.py:207 msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:157 +#: _cli/util/errors.py:240 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/build.py:212 -msgid "console output options" -msgstr "" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Skjul sidepanelet" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigering" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Søk blant %(docstitle)s" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Om disse dokumentene" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Søk" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Opphavsrett" -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Sist oppdatert %(last_updated)s." -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Laget med Sphinx %(sphinx_version)s." -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Forrige emne" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "forrige kapittel" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Neste emne" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "neste kapittel" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Skjul sidepanelet" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Innholdsfortegnelse" +msgid "Index – %(key)s" +msgstr "Indeks – %(key)s" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Søk" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Hele registeret på én side" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Gå" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Denne siden" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Vis kildekode" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Innhold" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Søk %(docstitle)s" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Hurtigsøk" + +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Gå" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2682,7 +2884,7 @@ msgstr "Globalt modulregister" msgid "quick access to all modules" msgstr "snarvei til alle moduler" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Hovedindex" @@ -2690,23 +2892,15 @@ msgstr "Hovedindex" msgid "all functions, classes, terms" msgstr "alla funksjoner, klasser, termer" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Denne siden" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Innholdsfortegnelse" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Hele registeret på én side" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Hurtigsøk" +msgid "Search %(docstitle)s" +msgstr "Søk %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2716,57 +2910,6 @@ msgstr "Registersider per bokstav" msgid "can be huge" msgstr "kan bli stor" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Forrige emne" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "forrige kapittel" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Neste emne" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "neste kapittel" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigering" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Søk blant %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Om disse dokumentene" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Opphavsrett" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "© %(copyright_prefix)s %(copyright)s." - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Sist oppdatert %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Laget med Sphinx %(sphinx_version)s." - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2783,21 +2926,21 @@ msgstr "Søk etter flere ord viser bare treff som inneholder\n  alle ord" msgid "search" msgstr "søk" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Skjul søkeresultat" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Innhold" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Søkeresultat" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2805,22 +2948,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Søker" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Forbereder søk …" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", i " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Skjul søkeresultat" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2828,6 +2970,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Endringer i versjon %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2849,120 +2996,127 @@ msgstr "Andre endringer" msgid "Expand sidebar" msgstr "Utvid sidepanelet" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametere" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variabler" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Hever" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (i modul %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (i modul %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (innebygd variabel)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (innebygd klasse)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (klasse i %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klassemetode)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statisk metode)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python Modulindex" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moduler" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Foreldet" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "untak" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "klassemetode" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statisk metode" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (foreldet)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametere" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variabler" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Hever" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2973,92 +3127,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "medlem" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "type" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "variabel" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "makro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "miljøvariabel; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3104,563 +3251,471 @@ msgstr "miljøvariabel" #: domains/std/__init__.py:734 msgid "program option" -msgstr "programvalg" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Modulindex" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "se %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "se også %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +msgstr "programvalg" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Modulindex" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "index" - -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "neste" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "forrige" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:240 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Utgivelse" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "fortsettelse fra forrige side" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "fortsetter på neste side" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "Ikke-alfabetisk" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Tall" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "side" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3668,548 +3723,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "index" + +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "neste" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "forrige" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "" +msgid "see %s" +msgstr "se %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "" +msgid "see also %s" +msgstr "se også %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/ne/LC_MESSAGES/sphinx.mo b/sphinx/locale/ne/LC_MESSAGES/sphinx.mo index ab15e162d40..2df44a69b25 100644 Binary files a/sphinx/locale/ne/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ne/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/ne/LC_MESSAGES/sphinx.po b/sphinx/locale/ne/LC_MESSAGES/sphinx.po index 75e021ff778..ed09f02636e 100644 --- a/sphinx/locale/ne/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/ne/LC_MESSAGES/sphinx.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Komiya Takeshi , 2016\n" "Language-Team: Nepali (http://app.transifex.com/sphinx-doc/sphinx-1/language/ne/)\n" @@ -20,6 +20,127 @@ msgstr "" "Language: ne\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -34,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +310,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +323,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,468 +538,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "ध्यानाकर्षण" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "होसियार " -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "खतरा" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "गलत" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "सङ्केत" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "जरुरी" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "टिप्पणी" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "पनि हेर्नुहोस" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tip" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "साबधान" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "(in" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[स्रोत]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[docs]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Module code" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Source code for %s

        " +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "पुनरावलोकन: module code" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        All modules for which code is available

        " +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "invalid css_file: %r, ignored" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/xml.py:29 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "बिइल्टिन्स" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "मडुलको तह" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -740,9 +1176,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -777,6 +1214,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "मौलिक इन्ट्री" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -864,879 +1329,960 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Todo" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "मौलिक इन्ट्री" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "सेक्सनको लेखक" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[स्रोत]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "मडुलको लेखक" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Codeको लेखक " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[docs]" -#: directives/other.py:209 -msgid "Author: " -msgstr "लेखक" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Module code" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Source code for %s

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "पुनरावलोकन: module code" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        All modules for which code is available

        " + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:92 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:56 +#: domains/math.py:73 #, python-format -msgid "no changes in version %s." +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "बिइल्टिन्स" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (built-in function)" -#: builders/changes.py:72 -msgid "Module level" -msgstr "मडुलको तह" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s विधी)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (कक्षा)" -#: builders/changes.py:133 +#: domains/javascript.py:188 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (global variable or constant)" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s attribute)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Arguments" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Throws" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Returns" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Return type" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (मडुल)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "फन्क्सन" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "विधी" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "कक्षा" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "data" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "attribute" -#: builders/__init__.py:275 +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "मडुल" + +#: domains/javascript.py:458 #, python-format -msgid "all of %d po files" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s (directive)" +msgstr "%s (निर्देशिक)" -#: builders/__init__.py:309 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are out of date" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (भूमिका)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "निर्देशिक" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:330 +#: domains/rst.py:236 +msgid "role" +msgstr "भूमिका" + +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/changeset.py:32 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:348 +#: domains/changeset.py:33 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "Changed in version %s" +msgstr "भर्सन %s मा बदलिएको" -#: builders/__init__.py:361 +#: domains/changeset.py:34 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Deprecated since version %s" -#: builders/__init__.py:377 +#: domains/changeset.py:35 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/__init__.py:322 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:410 -#, python-format -msgid "%d found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: cmd/build.py:357 #, python-format -msgid "error writing file %s: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr "(in" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:464 +#: cmd/quickstart.py:134 #, python-format -msgid "cannot write image file %r: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:242 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "" + +#: cmd/quickstart.py:520 +#, python-format msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" + +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 +#: cmd/quickstart.py:671 #, python-format -msgid "Domain %r is not registered" +msgid "enable %s extension" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/nodes.py:490 +#: cmd/quickstart.py:810 #, python-format -msgid "toctree contains ref to nonexisting file %r" +msgid "Invalid template variable: %s" msgstr "" -#: util/nodes.py:706 +#: directives/other.py:119 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/display.py:87 -msgid "failed" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/osutil.py:131 +#: directives/other.py:169 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: directives/other.py:203 +msgid "Section author: " +msgstr "सेक्सनको लेखक" + +#: directives/other.py:205 +msgid "Module author: " +msgstr "मडुलको लेखक" + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Codeको लेखक " + +#: directives/other.py:209 +msgid "Author: " +msgstr "लेखक" + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "" + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: util/docutils.py:789 +#: directives/code.py:87 #, python-format -msgid "unknown node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: util/fileutil.py:76 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: util/fileutil.py:89 +#: directives/code.py:216 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: util/rst.py:73 +#: directives/code.py:231 #, python-format -msgid "default role %s not found" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/inventory.py:147 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: util/inventory.py:166 +#: directives/code.py:276 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "Object named %r not found in include file %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "फूट्नोट्स" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[चित्र]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1745,11 +2291,15 @@ msgstr "[चित्र]" msgid "Index" msgstr "अनुसुची" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "फूट्नोट्स" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "" @@ -1759,885 +2309,535 @@ msgstr "" msgid "unimplemented node type: %r" msgstr "" -#: writers/latex.py:361 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "[image: %s]" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[चित्र]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" msgstr "" -#: writers/latex.py:591 +#: writers/html5.py:441 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "Any IDs not assigned for %s node" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: writers/latex.py:1580 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "dimension unit %s is invalid. Ignored." +msgid "unsupported rubric heading level: %s" msgstr "" -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" - -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" - -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "" - -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (built-in function)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s विधी)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (कक्षा)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (global variable or constant)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s attribute)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Arguments" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Throws" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Returns" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Return type" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (मडुल)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "फन्क्सन" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "विधी" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "कक्षा" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "data" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "attribute" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "मडुल" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "भर्सन %s मा बदलिएको" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Deprecated since version %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (निर्देशिक)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (भूमिका)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "निर्देशिक" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:236 -msgid "role" -msgstr "भूमिका" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "" - -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "ध्यानाकर्षण" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "होसियार " - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "खतरा" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "गलत" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "सङ्केत" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "जरुरी" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "टिप्पणी" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "पनि हेर्नुहोस" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tip" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "साबधान" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "" - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "" - -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "" - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "" - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "" - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "" - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "" - -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" -msgstr "" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "" - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:367 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:396 +#: writers/latex.py:1198 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:406 +#: writers/latex.py:1228 +#, python-format msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:1615 #, python-format -msgid "Creating file %s." +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: writers/latex.py:1950 #, python-format -msgid "File %s already exists, skipping." -msgstr "" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:670 +#: transforms/__init__.py:258 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:809 +#: util/i18n.py:113 #, python-format -msgid "Invalid template variable: %s" +msgid "writing error: %s, %s" msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:131 +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "" + +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "" + +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "अघिल्लो पानासँग जोडीएको" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "रीलीज" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "" + +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "साइडबर सानो बनाउनुहोस्" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "नेभिगेसन " + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "यी डकुमेन्टहरुको बारेमा" + #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "खोज्नुहोस् " -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "जानुहोस्" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "कपिराइट " -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "स्रोत देखाउनुहोस् " +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "विषयसूची" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "यो भन्दा अगाडी %(last_updated)s मा अपडेट भएको" -#: themes/basic/opensearch.xml:4 +#: themes/basic/layout.html:204 #, python-format -msgid "Search %(docstitle)s" +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "अघिल्लो विषय " + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "अघिल्लो खन्ड" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "पछिल्लो विषय" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "पछिल्लो खन्ड" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" msgstr "" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "पुरा अनुसुची एकै पानामा" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "यो पाना" + +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "स्रोत देखाउनुहोस् " + +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "छिट्टो खोज्नुहोस्" + +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "जानुहोस्" + #: themes/basic/defindex.html:4 msgid "Overview" msgstr "पुनरावलोकन " @@ -2683,7 +2883,7 @@ msgstr "ग्लोबल मडुल अनुसुची" msgid "quick access to all modules" msgstr "सबै मोदुलेसमा छिटै जानुहोस्" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "सामान्य अनुसुची" @@ -2691,24 +2891,16 @@ msgstr "सामान्य अनुसुची" msgid "all functions, classes, terms" msgstr "सबै फन्क्सनस्, कक्षाहरू र टर्मस्" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "यो पाना" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" +msgid "Search %(docstitle)s" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "पुरा अनुसुची एकै पानामा" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "छिट्टो खोज्नुहोस्" - #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" msgstr "अक्षर अनुसार अनुसुचीका पाना" @@ -2717,57 +2909,6 @@ msgstr "अक्षर अनुसार अनुसुचीका पान msgid "can be huge" msgstr "धेरै ठुलो हुन सक्छ" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "अघिल्लो विषय " - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "अघिल्लो खन्ड" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "पछिल्लो विषय" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "पछिल्लो खन्ड" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "नेभिगेसन " - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "यी डकुमेन्टहरुको बारेमा" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "कपिराइट " - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "यो भन्दा अगाडी %(last_updated)s मा अपडेट भएको" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2784,21 +2925,21 @@ msgstr "" msgid "search" msgstr "खोज्नुहोस्" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "खोजेको नतिजाहरु लुकाउनुहोस्" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "विषयसूची" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "खोजेको नतिजा" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2806,22 +2947,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "खोजेको नतिजाहरु लुकाउनुहोस्" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2829,6 +2969,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2850,120 +2995,127 @@ msgstr "अरु परिवर्तनहरु " msgid "Expand sidebar" msgstr "साइडबर ठुलो बनाउनुहोस्" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parameters" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "चलहरू" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Raises" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (in मडुल %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (in मडुल %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (built-in चल)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (built-in कक्षा)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (कक्षा in %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s कक्षा विधी)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s static विधी)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python Module Index" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "modules" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Deprecated" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "अपबाद" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "कक्षा विधी" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "static विधी" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "(deprecated)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parameters" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "चलहरू" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2974,92 +3126,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "सदस्य" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "किसिम" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "चल" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "बृहत" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "environment variable; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3099,569 +3244,477 @@ msgstr "grammar token" msgid "reference label" msgstr "सन्दर्व सामग्री" -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "environment variable" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "कार्यक्रमका बिकल्प" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "मडुल अनुसुची" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "%s हेर्नुहोस्" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "%s पनि हेर्नुहोस् " - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "environment variable" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "कार्यक्रमका बिकल्प" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "मडुल अनुसुची" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "अनुसुची" - -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "पछिल्लो" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "अघिल्लो" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "रीलीज" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "अघिल्लो पानासँग जोडीएको" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3669,548 +3722,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "अनुसुची" + +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "पछिल्लो" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "अघिल्लो" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "" +msgid "see %s" +msgstr "%s हेर्नुहोस्" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "" +msgid "see also %s" +msgstr "%s पनि हेर्नुहोस् " -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/nl/LC_MESSAGES/sphinx.mo b/sphinx/locale/nl/LC_MESSAGES/sphinx.mo index 12d58495281..f93d3657606 100644 Binary files a/sphinx/locale/nl/LC_MESSAGES/sphinx.mo and b/sphinx/locale/nl/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/nl/LC_MESSAGES/sphinx.po b/sphinx/locale/nl/LC_MESSAGES/sphinx.po index 2c02226dd7b..f37a3977f86 100644 --- a/sphinx/locale/nl/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/nl/LC_MESSAGES/sphinx.po @@ -14,7 +14,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Komiya Takeshi , 2021\n" "Language-Team: Dutch (http://app.transifex.com/sphinx-doc/sphinx-1/language/nl/)\n" @@ -25,6 +25,127 @@ msgstr "" "Language: nl\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "instelling %s.%s komt niet voor in de doorzochte thema configuraties" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "bestand %r in thema pad is geen geldige zipfile of bevat geen thema" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -39,127 +160,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Dit project vereist extensie %s met versie %s of hoger, en kan daarom niet met de geladen versie (%s) worden gebouwd" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Gebeurtenis %r bestaat reeds" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Onbekende gebeurtenisnaam: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Kan bronmap niet vinden (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Bron- en doelmap kunnen niet identiek zijn" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx v%s start op" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Dit project vereist tenminste Sphinx v%s, en kan daarom niet worden gebouwd met deze versie." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "aanmaken doelmap" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' gedefinieerd in conf.py is niet aanroepbaar (geen Python-callable). Pas a.u.b. de definitie aan zodat het een oproepbare functie wordt. Dit is nodig voor conf.py om zich als een Sphinx extensie te gedragen." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "laden van vertalingen [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "klaar" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "mislukt: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Geen bouwer geselecteerd, dus de standaardbouwer wordt gebruikt: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -167,12 +315,12 @@ msgid "" "explicit" msgstr "de %s extensie geeft niet aan of deze veilig is voor parallel lezen, er wordt aangenomen dat dit niet zo is - vraag de auteur van de extensie om dit te controleren en expliciet te maken" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -180,82 +328,214 @@ msgid "" "explicit" msgstr "de %s extensie geeft niet aan of deze veilig is voor parallel schrijven, er wordt aangenomen dat dit niet zo is - vraag de auteur van de extensie om dit te controleren en expliciet te maken" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "seriële verwerking van %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "configuratiemap bevat geen conf.py bestand (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Bouwerklasse %s heeft geen \"name\"-attribuut" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Bouwer %r bestaat reeds (in module %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Bouwernaam %s is niet geregistreerd of beschikbaar via entrypoint" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Bouwernaam %s is niet geregistreerd" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "domein %s was reeds geregistreerd" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "domein %s nog niet geregistreerd" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser voor %r is reeds geregistreerd" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Broncode-parser voor %s is niet geregistreerd" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "extensie %r is reeds in Sphinx ingevoegd sinds Sphinx-versie %s; deze extensie wordt genegeerd." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Oorspronkelijke exceptie:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Kon extensie %s niet importeren" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "extensie %r heeft geen setup() functie; weet u zeker dat het een Sphinx-extensiemodule is?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "Dit project gebruikt extensie %s, maar die extensie heeft Sphinx-versie v%s of hoger nodig; het project kan daarom niet worden gebouwd met deze versie." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "de setup() functie van extensie %r retourneerde een niet-ondersteund object; dit moet None of een metadata dictionary zijn" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "configuratiemap bevat geen conf.py bestand (%s)" + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "kan dictionary-instelling %r niet overschrijven in configuratie, wordt genegeerd (gebruik %r om individuele elementen te overschrijven)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "ongeldig getal %r voor configuratiewaarde %r, wordt genegeerd" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "kan instelling %r niet overschrijven met zo'n waarde van een niet-ondersteund type; wordt genegeerd" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "onbekende configuratiewaarde %r tijdens overschrijven, wordt genegeerd" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Configuratiewaarde %r was reeds aangevoerd" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -263,468 +543,624 @@ msgid "" "%s" msgstr "Een fout heeft zich voorgedaan in uw configuratiebestand:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Sectie %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Fig. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabel %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Codefragment %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r onbekend, wordt genegeerd." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "instelling %s.%s komt niet voor in de doorzochte thema configuraties" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "bestand %r in thema pad is geen geldige zipfile of bevat geen thema" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "bronmap is gewijzigd" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Let op" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Gebeurtenis %r bestaat reeds" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Pas op" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Onbekende gebeurtenisnaam: %s" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Gevaar" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Fout" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Hint" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Belangrijk" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Notitie" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Zie ook" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tip" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Waarschuwing" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Bouwerklasse %s heeft geen \"name\"-attribuut" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Bouwer %r bestaat reeds (in module %s)" +msgid "processing %s" +msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Bouwernaam %s is niet geregistreerd of beschikbaar via entrypoint" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Bouwernaam %s is niet geregistreerd" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "domein %s was reeds geregistreerd" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (in " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "domein %s nog niet geregistreerd" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser voor %r is reeds geregistreerd" +msgid "The HTML page is in %(outdir)s." +msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "Broncode-parser voor %s is niet geregistreerd" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "extensie %r is reeds in Sphinx ingevoegd sinds Sphinx-versie %s; deze extensie wordt genegeerd." +msgid "targets for %d template files" +msgstr "" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Oorspronkelijke exceptie:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "Kon extensie %s niet importeren" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "extensie %r heeft geen setup() functie; weet u zeker dat het een Sphinx-extensiemodule is?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "Dit project gebruikt extensie %s, maar die extensie heeft Sphinx-versie v%s of hoger nodig; het project kan daarom niet worden gebouwd met deze versie." +msgid "broken link: %s (%s)" +msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "de setup() functie van extensie %r retourneerde een niet-ondersteund object; dit moet None of een metadata dictionary zijn" +msgid "Anchor '%s' not found" +msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[broncode]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[documentatie]" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Modulebroncode" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Broncode voor %s

        " +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Overzicht: module broncode" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Alle modules waarvoor de broncode beschikbaar is

        " +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" +msgstr "" -#: ext/extlinks.py:82 +#: builders/xml.py:29 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "error writing file %s: %s" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/xml.py:103 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:467 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "ontbrekende '+' of '-' in optie '%s'." +msgid "cannot write image file %r: %s" +msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' is geen geldige optie." +msgid "unknown mimetype for %s, ignoring" +msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' is geen geldige pyversion optie" +msgid "writing %s file..." +msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" +msgstr "bestand %r zoals gegeven op de opdrachtregel is niet aanwezig in de bronmap, wordt genegeerd" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:366 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "%d source files given on command line" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:382 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Builtins" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Moduleniveau" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -745,9 +1181,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -782,6 +1219,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Te doen" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(Het <> bevindt zich in %s, regel %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "originele item" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -869,1779 +1334,1514 @@ msgstr "[graaf: %s]" msgid "[graph]" msgstr "[graaf]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Te doen" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" - -#: ext/todo.py:154 +#: ext/imgmath.py:167 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(Het <> bevindt zich in %s, regel %d.)" - -#: ext/todo.py:166 -msgid "original entry" -msgstr "originele item" - -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: directives/code.py:87 +#: ext/imgmath.py:326 #, python-format -msgid "Invalid caption: %s" -msgstr "Ongeldig onderschrift: %s" +msgid "display latex %r: %s" +msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/imgmath.py:362 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Gebruik van zowel \"%s\" als \"%s\" opties is niet toegestaan" - -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:118 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +msgid "missing '+' or '-' in '%s' option." +msgstr "ontbrekende '+' of '-' in optie '%s'." -#: directives/code.py:276 +#: ext/doctest.py:124 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "Object met naam %r is niet gevonden in include bestand %r" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "\"lineno-match\" kan niet gebruikt worden met een disjuncte set \"lines\"" +msgid "'%s' is not a valid option." +msgstr "'%s' is geen geldige optie." -#: directives/code.py:314 +#: ext/doctest.py:139 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Regels %r: geen regels gebruikt uit include-bestand %r" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' is geen geldige pyversion optie" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/other.py:119 +#: ext/doctest.py:297 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/doctest.py:451 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/other.py:156 +#: ext/doctest.py:568 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/other.py:169 +#: ext/autosectionlabel.py:52 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " -msgstr "Auteur van deze sectie: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Auteur van deze module: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Auteur van deze broncode:" - -#: directives/other.py:209 -msgid "Author: " -msgstr "Auteur: " - -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" - -#: directives/other.py:292 -msgid ".. hlist content is not a list" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: builders/changes.py:29 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "duplicate label %s, other instance in %s" msgstr "" -#: builders/changes.py:56 +#: ext/duration.py:47 #, python-format -msgid "no changes in version %s." +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Builtins" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "Moduleniveau" - -#: builders/changes.py:124 -msgid "copying source files..." +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: builders/changes.py:133 -#, python-format -msgid "could not read %r for changelog creation" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: builders/manpage.py:37 +#: ext/duration.py:139 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "%.3fs %s" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[broncode]" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[documentatie]" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Modulebroncode" -#: builders/__init__.py:232 +#: ext/viewcode.py:359 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "

        Source code for %s

        " +msgstr "

        Broncode voor %s

        " -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Overzicht: module broncode" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Alle modules waarvoor de broncode beschikbaar is

        " -#: builders/__init__.py:275 +#: domains/citation.py:75 #, python-format -msgid "all of %d po files" +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/citation.py:92 #, python-format -msgid "targets for %d po files that are specified" +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/__init__.py:309 +#: domains/math.py:73 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "duplicaatlabel van formule %s, andere in %s" -#: builders/__init__.py:330 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "file %r given on command line does not exist, " +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/__init__.py:337 +#: domains/javascript.py:183 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "bestand %r zoals gegeven op de opdrachtregel is niet aanwezig in de bronmap, wordt genegeerd" +msgid "%s() (built-in function)" +msgstr "%s() (ingebouwde functie)" -#: builders/__init__.py:348 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "%s() (%s method)" +msgstr "%s() (%s methode)" -#: builders/__init__.py:361 +#: domains/javascript.py:186 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "%s() (class)" +msgstr "%s() (klasse)" -#: builders/__init__.py:377 +#: domains/javascript.py:188 #, python-format -msgid "targets for %d source files that are out of date" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (globale variabele of constante)" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s attribuut)" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumenten" + +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Werpt" + +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Returns" + +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Return type" -#: builders/__init__.py:410 +#: domains/javascript.py:374 #, python-format -msgid "%d found" -msgstr "" +msgid "%s (module)" +msgstr "%s (module)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "functie" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "methode" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klasse" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "data" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "attribuut" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "module" -#: builders/__init__.py:531 +#: domains/javascript.py:458 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:540 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "%s (directive)" +msgstr "%s (directive)" -#: builders/__init__.py:551 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:558 +#: domains/rst.py:224 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "" +msgid "%s (role)" +msgstr "%s (rol)" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" -msgstr "" +#: domains/rst.py:234 +msgid "directive" +msgstr "directive" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "" +#: domains/rst.py:236 +msgid "role" +msgstr "rol" -#: builders/__init__.py:731 -msgid "copying assets" +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:883 +#: domains/changeset.py:32 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +msgid "Added in version %s" msgstr "" -#: builders/epub3.py:84 +#: domains/changeset.py:33 #, python-format -msgid "The ePub file is in %(outdir)s." +msgid "Changed in version %s" +msgstr "Veranderd in versie %s" + +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "Verouderd sinds versie %s" + +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" + +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "pad naar doelmap" + +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (in " +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/build.py:357 +#, python-format +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/linkcheck.py:149 +#: cmd/quickstart.py:134 #, python-format -msgid "broken link: %s (%s)" +msgid "Please enter one of %s." msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/text.py:29 +#: cmd/quickstart.py:230 #, python-format -msgid "The text files are in %(outdir)s." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:235 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:242 +#, python-format +msgid "Selected root path: %s" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:274 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" - -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "" - -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" - -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" - -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" - -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" - -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" - -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" - -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:287 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" - -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" - -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" - -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" - -#: _cli/__init__.py:231 -msgid "" -msgstr "" - -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" - -#: environment/__init__.py:86 -msgid "new config" -msgstr "" - -#: environment/__init__.py:87 -msgid "config changed" -msgstr "" - -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "" - -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" - -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "bronmap is gewijzigd" - -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" - -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:298 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "" - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "" - -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "" - -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +"The project name will occur in several places in the built documentation." msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Naam van het project" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Auteur(s)" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Versie van het project" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Release van het project" -#: util/i18n.py:245 -#, python-format +#: cmd/quickstart.py:324 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:340 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" - -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" - -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" - -#: util/display.py:82 -msgid "skipped" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:350 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" - -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" - -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" -msgstr "" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Bestandsnaam van het hoofddocument (zonder bestandsextensie)" -#: util/fileutil.py:76 +#: cmd/quickstart.py:368 #, python-format msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Fout: hoofddocumentbestandsnaam %s is reeds aanwezig op het aangewezen pad." -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Voetnoten" - -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[afbeelding: %s]" - -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[afbeelding]" - -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Index" - -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:407 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "onderschrift niet binnen figuur." - -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +msgid "Creating file %s." msgstr "" -#: writers/latex.py:591 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "File %s already exists, skipping." msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Afgerond: een beginstructuur van mappen is aangemaakt." -#: writers/html5.py:572 writers/latex.py:1106 +#: cmd/quickstart.py:520 #, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" - -#: writers/latex.py:1183 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: writers/html5.py:431 +#: cmd/quickstart.py:531 #, python-format -msgid "numfig_format is not defined for %s" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: writers/html5.py:496 -msgid "Link to this term" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: writers/html5.py:558 -msgid "Link to this table" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: writers/html5.py:636 -msgid "Link to this code" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: writers/html5.py:638 -msgid "Link to this image" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: writers/html5.py:640 -msgid "Link to this toctree" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "duplicaatlabel van formule %s, andere in %s" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (ingebouwde functie)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s methode)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (klasse)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (globale variabele of constante)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s attribuut)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumenten" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Werpt" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Returns" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Return type" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (module)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "functie" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "methode" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klasse" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "data" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "attribuut" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "module" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Veranderd in versie %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Verouderd sinds versie %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (directive)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (rol)" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "release van project" -#: domains/rst.py:234 -msgid "directive" -msgstr "directive" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "documenttaal" -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "bestandsextensie van bronbestanden" -#: domains/rst.py:236 -msgid "role" -msgstr "rol" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "bestandsnaam van hoofddocument" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: domains/citation.py:92 +#: cmd/quickstart.py:671 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Let op" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Pas op" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Gevaar" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Fout" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Hint" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Belangrijk" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Notitie" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Zie ook" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tip" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Waarschuwing" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +msgid "enable %s extension" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "sjabloonmap voor sjabloonbestanden" + +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: cmd/quickstart.py:229 +#: cmd/quickstart.py:810 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "Invalid template variable: %s" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: cmd/quickstart.py:241 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "Selected root path: %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Auteur van deze sectie: " -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: directives/other.py:205 +msgid "Module author: " +msgstr "Auteur van deze module: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Auteur van deze broncode:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "Auteur: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: cmd/quickstart.py:273 +#: directives/patches.py:70 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" +msgstr "Ongeldig onderschrift: %s" + +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Gebruik van zowel \"%s\" als \"%s\" opties is niet toegestaan" + +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: cmd/quickstart.py:297 +#: directives/code.py:235 +#, python-format msgid "" -"The project name will occur in several places in the built documentation." +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Naam van het project" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "Object met naam %r is niet gevonden in include bestand %r" -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Auteur(s)" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "\"lineno-match\" kan niet gebruikt worden met een disjuncte set \"lines\"" -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Regels %r: geen regels gebruikt uit include-bestand %r" -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Versie van het project" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Release van het project" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Index" -#: cmd/quickstart.py:323 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Voetnoten" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "" +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "onderschrift niet binnen figuur." -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[afbeelding: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[afbeelding]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Bestandsnaam van het hoofddocument (zonder bestandsextensie)" +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" +msgstr "" -#: cmd/quickstart.py:367 +#: writers/html5.py:441 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Fout: hoofddocumentbestandsnaam %s is reeds aanwezig op het aangewezen pad." +msgid "Any IDs not assigned for %s node" +msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" + +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:386 #, python-format -msgid "Creating file %s." +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "File %s already exists, skipping." +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Afgerond: een beginstructuur van mappen is aangemaakt." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "" -#: cmd/quickstart.py:519 +#: writers/latex.py:616 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:526 +#: writers/latex.py:1198 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:530 +#: writers/latex.py:1228 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "" + +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "release van project" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "documenttaal" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "bestandsextensie van bronbestanden" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "bestandsnaam van hoofddocument" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "sjabloonmap voor sjabloonbestanden" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:809 +#: util/i18n.py:244 #, python-format -msgid "Invalid template variable: %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/build.py:74 +#: util/osutil.py:131 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "pad naar doelmap" +#: util/display.py:87 +msgid "failed" +msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:131 +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "Vervolgd van vorige pagina" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "Vervolgt op volgende pagina" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Symbolen" -#: cmd/build.py:212 -msgid "console output options" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "pagina" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Release" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "meer dan één doel gevonden voor 'any' kruisverwijzing %r: is mogelijk %s" + +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Zijpaneel inklappen" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigatie" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Zoeken in %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Over deze documenten" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Zoeken" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Zoek" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Laatste aanpassing op %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Vorig onderwerp" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "vorig hoofdstuk" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Volgend onderwerp" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "volgend hoofdstuk" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Volledige index op één pagina" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Deze pagina" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Broncode weergeven" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Inhoudsopgave" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Snel zoeken" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Zoek in %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Zoek" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2688,7 +2888,7 @@ msgstr "Globale Module-index" msgid "quick access to all modules" msgstr "sneltoegang naar alle modules" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Algemene index" @@ -2696,23 +2896,15 @@ msgstr "Algemene index" msgid "all functions, classes, terms" msgstr "alle functies, klasses en begrippen" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Deze pagina" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Volledige index op één pagina" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Snel zoeken" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "Zoek in %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2722,57 +2914,6 @@ msgstr "Index pagineerd per letter" msgid "can be huge" msgstr "kan heel groot zijn" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Vorig onderwerp" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "vorig hoofdstuk" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Volgend onderwerp" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "volgend hoofdstuk" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigatie" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Zoeken in %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Over deze documenten" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Laatste aanpassing op %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2789,21 +2930,21 @@ msgstr "" msgid "search" msgstr "zoeken" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Zoekresultaten verbergen" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Inhoudsopgave" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Zoekresultaten" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Uw zoekopdracht leverde geen resultaten op. Zorg ervoor dat alle woorden juist zijn gespeld en dat u voldoende categorieën hebt geselecteerd." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2811,22 +2952,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Bezig met zoeken" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Zoeken aan het voorbereiden..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", in" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Zoekresultaten verbergen" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2834,6 +2974,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Wijzigingen in Versie %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2855,120 +3000,127 @@ msgstr "Andere veranderingen" msgid "Expand sidebar" msgstr "Zijpaneel uitklappen" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 -msgid "Keyword-only parameters separator (PEP 3102)" -msgstr "" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parameters" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variabelen" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Veroorzaakt" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (in module %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (in module %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (geïntegreerde variabele)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (geïntegreerde klasse)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (klasse in %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klassemethode)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (statische methode van %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python-moduleïndex" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "modules" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Verouderd" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "exceptie" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "klassemethode" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statische methode" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (verouderd)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parameters" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variabelen" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Veroorzaakt" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2979,746 +3131,526 @@ msgstr "Sjabloonparameters" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "member" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "type" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "concept" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerator" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "variabele" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "macro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "omgevingsvariabele; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "woordenlijstterm" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "grammaticatoken" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "verwijzingslabel" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "omgevingsvariabele" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "programmaoptie" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "document" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Module-index" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "onderschrift ontbreekt voor link: %s" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "zie %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "zie %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Symbolen" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" - -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "meer dan één doel gevonden voor 'any' kruisverwijzing %r: is mogelijk %s" - -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "" - -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "" - -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "" - -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "" - -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:319 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "index" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "woordenlijstterm" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "grammaticatoken" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "volgende" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "verwijzingslabel" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "vorige" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "omgevingsvariabele" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "programmaoptie" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "" +#: domains/std/__init__.py:735 +msgid "document" +msgstr "document" + +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Module-index" -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "" +msgid "the link has no caption: %s" +msgstr "onderschrift ontbreekt voor link: %s" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1153 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy static file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Failed to write build info file: %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Sleutelwoordargumenten" + +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Verwijzingen" + +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:1360 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "" +msgid "Bases: %s" +msgstr "Basisklassen: %s" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:93 #, python-format -msgid "%s %s documentation" -msgstr "%s %s documentatie" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Release" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "Vervolgd van vorige pagina" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "Vervolgt op volgende pagina" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" + +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "bestandsextensie (standaardwaarde: rst)" + +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "pagina" - -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Sleutelwoordargumenten" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "%s is geen map." + +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Verwijzingen" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3726,7 +3658,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3741,481 +3673,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "bestandsextensie (standaardwaarde: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "(in %s)" + +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_type_comments.py:123 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "%s is not a directory." -msgstr "%s is geen map." - -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" -msgstr "(in %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" -msgstr "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "" + +#: builders/html/__init__.py:496 +msgid "index" +msgstr "index" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "volgende" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "vorige" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "" + +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "" + +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s documentatie" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "" + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" -msgstr "Basisklassen: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "zie %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "zie %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/no/LC_MESSAGES/sphinx.js b/sphinx/locale/no/LC_MESSAGES/sphinx.js new file mode 100644 index 00000000000..0da8306bcfb --- /dev/null +++ b/sphinx/locale/no/LC_MESSAGES/sphinx.js @@ -0,0 +1,63 @@ +Documentation.addTranslations({ + "locale": "no", + "messages": { + "%(filename)s — %(docstitle)s": "", + "© %(copyright_prefix)s %(copyright)s.": "", + ", in ": "", + "About these documents": "", + "Automatically generated list of changes in version %(version)s": "", + "C API changes": "", + "Changes in Version %(version)s — %(docstitle)s": "", + "Collapse sidebar": "", + "Complete Table of Contents": "", + "Contents": "", + "Copyright": "", + "Created using Sphinx %(sphinx_version)s.": "", + "Expand sidebar": "", + "Full index on one page": "", + "General Index": "", + "Global Module Index": "", + "Go": "", + "Hide Search Matches": "", + "Index": "", + "Index – %(key)s": "", + "Index pages by letter": "", + "Indices and tables:": "", + "Last updated on %(last_updated)s.": "", + "Library changes": "", + "Navigation": "", + "Next topic": "", + "Other changes": "", + "Overview": "", + "Please activate JavaScript to enable the search\n functionality.": "", + "Preparing search...": "", + "Previous topic": "", + "Quick search": "", + "Search": "", + "Search Page": "", + "Search Results": "", + "Search finished, found one page matching the search query.": [ + "", + "" + ], + "Search within %(docstitle)s": "", + "Searching": "", + "Searching for multiple words only shows matches that contain\n all words.": "", + "Show Source": "", + "Table of Contents": "", + "This Page": "", + "Welcome! This is": "", + "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", + "all functions, classes, terms": "", + "can be huge": "", + "last updated": "", + "lists all sections and subsections": "", + "next chapter": "", + "previous chapter": "", + "quick access to all modules": "", + "search": "", + "search this documentation": "", + "the documentation for": "" + }, + "plural_expr": "(n != 1)" +}); \ No newline at end of file diff --git a/sphinx/locale/no/LC_MESSAGES/sphinx.mo b/sphinx/locale/no/LC_MESSAGES/sphinx.mo new file mode 100644 index 00000000000..b8c6a723e4a Binary files /dev/null and b/sphinx/locale/no/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/no/LC_MESSAGES/sphinx.po b/sphinx/locale/no/LC_MESSAGES/sphinx.po new file mode 100644 index 00000000000..adfc4af0152 --- /dev/null +++ b/sphinx/locale/no/LC_MESSAGES/sphinx.po @@ -0,0 +1,4304 @@ +# Translations template for Sphinx. +# Copyright (C) 2025 ORGANIZATION +# This file is distributed under the same license as the Sphinx project. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: Sphinx\n" +"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" +"PO-Revision-Date: 2013-04-02 08:44+0000\n" +"Last-Translator: FULL NAME \n" +"Language-Team: Norwegian (http://app.transifex.com/sphinx-doc/sphinx-1/language/no/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.17.0\n" +"Language: no\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + +#: extension.py:58 +#, python-format +msgid "" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "" + +#: extension.py:79 +#, python-format +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "" + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 +#, python-format +msgid "Cannot find source directory (%s)" +msgstr "" + +#: application.py:223 +#, python-format +msgid "Output directory (%s) is not a directory" +msgstr "" + +#: application.py:228 +msgid "Source directory and destination directory cannot be identical" +msgstr "" + +#: application.py:258 +#, python-format +msgid "Running Sphinx v%s" +msgstr "" + +#: application.py:286 +#, python-format +msgid "" +"This project needs at least Sphinx v%s and therefore cannot be built with " +"this version." +msgstr "" + +#: application.py:305 +msgid "making output directory" +msgstr "" + +#: application.py:310 registry.py:540 +#, python-format +msgid "while setting up extension %s:" +msgstr "" + +#: application.py:317 +msgid "" +"'setup' as currently defined in conf.py isn't a Python callable. Please " +"modify its definition to make it a callable function. This is needed for " +"conf.py to behave as a Sphinx extension." +msgstr "" + +#: application.py:360 +#, python-format +msgid "loading translations [%s]... " +msgstr "" + +#: application.py:384 util/display.py:89 +msgid "done" +msgstr "" + +#: application.py:386 +msgid "not available for built-in messages" +msgstr "" + +#: application.py:400 +msgid "loading pickled environment" +msgstr "" + +#: application.py:408 +#, python-format +msgid "failed: %s" +msgstr "" + +#: application.py:423 +msgid "No builder selected, using default: html" +msgstr "" + +#: application.py:455 +msgid "build finished with problems." +msgstr "" + +#: application.py:457 +msgid "build succeeded." +msgstr "" + +#: application.py:462 +msgid "" +"build finished with problems, 1 warning (with warnings treated as errors)." +msgstr "" + +#: application.py:466 +msgid "build finished with problems, 1 warning." +msgstr "" + +#: application.py:468 +msgid "build succeeded, 1 warning." +msgstr "" + +#: application.py:474 +#, python-format +msgid "" +"build finished with problems, %s warnings (with warnings treated as errors)." +msgstr "" + +#: application.py:478 +#, python-format +msgid "build finished with problems, %s warnings." +msgstr "" + +#: application.py:480 +#, python-format +msgid "build succeeded, %s warnings." +msgstr "" + +#: application.py:1020 +#, python-format +msgid "node class %r is already registered, its visitors will be overridden" +msgstr "" + +#: application.py:1113 +#, python-format +msgid "directive %r is already registered and will not be overridden" +msgstr "" + +#: application.py:1139 application.py:1167 +#, python-format +msgid "role %r is already registered and will not be overridden" +msgstr "" + +#: application.py:1766 +#, python-format +msgid "" +"the %s extension does not declare if it is safe for parallel reading, " +"assuming it isn't - please ask the extension author to check and make it " +"explicit" +msgstr "" + +#: application.py:1771 +#, python-format +msgid "the %s extension is not safe for parallel reading" +msgstr "" + +#: application.py:1775 +#, python-format +msgid "" +"the %s extension does not declare if it is safe for parallel writing, " +"assuming it isn't - please ask the extension author to check and make it " +"explicit" +msgstr "" + +#: application.py:1780 +#, python-format +msgid "the %s extension is not safe for parallel writing" +msgstr "" + +#: application.py:1788 application.py:1792 +#, python-format +msgid "doing serial %s" +msgstr "" + +#: registry.py:162 +#, python-format +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format +msgid "" +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "" + +#: config.py:374 +#, python-format +msgid "'%s' must be '0' or '1', got '%s'" +msgstr "" + +#: config.py:379 +#, python-format +msgid "" +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" +msgstr "" + +#: config.py:391 +#, python-format +msgid "invalid number %r for config value %r, ignoring" +msgstr "" + +#: config.py:399 +#, python-format +msgid "cannot override config setting %r with unsupported type, ignoring" +msgstr "" + +#: config.py:422 +#, python-format +msgid "unknown config value %r in override, ignoring" +msgstr "" + +#: config.py:476 +#, python-format +msgid "No such config value: %r" +msgstr "" + +#: config.py:504 +#, python-format +msgid "Config value %r already present" +msgstr "" + +#: config.py:541 +#, python-format +msgid "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" +msgstr "" + +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 +#, python-format +msgid "There is a syntax error in your configuration file: %s\n" +msgstr "" + +#: config.py:603 +msgid "" +"The configuration file (or one of the modules it imports) called sys.exit()" +msgstr "" + +#: config.py:611 +#, python-format +msgid "" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" +msgstr "" + +#: config.py:633 +#, python-format +msgid "Failed to convert %r to a frozenset" +msgstr "" + +#: config.py:651 config.py:659 +#, python-format +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." +msgstr "" + +#: config.py:665 +#, python-format +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." +msgstr "" + +#: config.py:686 +#, python-format +msgid "Section %s" +msgstr "" + +#: config.py:687 +#, python-format +msgid "Fig. %s" +msgstr "" + +#: config.py:688 +#, python-format +msgid "Table %s" +msgstr "" + +#: config.py:689 +#, python-format +msgid "Listing %s" +msgstr "" + +#: config.py:798 +#, python-brace-format +msgid "" +"The config value `{name}` has to be a one of {candidates}, but `{current}` " +"is given." +msgstr "" + +#: config.py:829 +#, python-brace-format +msgid "" +"The config value `{name}' has type `{current.__name__}'; expected " +"{permitted}." +msgstr "" + +#: config.py:846 +#, python-brace-format +msgid "" +"The config value `{name}' has type `{current.__name__}', defaults to " +"`{default.__name__}'." +msgstr "" + +#: config.py:858 +#, python-format +msgid "primary_domain %r not found, ignored." +msgstr "" + +#: config.py:878 +msgid "" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." +msgstr "" + +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "" + +#: environment/__init__.py:89 +msgid "new config" +msgstr "" + +#: environment/__init__.py:90 +msgid "config changed" +msgstr "" + +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "" + +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "" + +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "" + +#: environment/__init__.py:350 +#, python-format +msgid "The configuration has changed (1 option: %r)" +msgstr "" + +#: environment/__init__.py:355 +#, python-format +msgid "The configuration has changed (%d options: %s)" +msgstr "" + +#: environment/__init__.py:361 +#, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "" + +#: environment/__init__.py:518 +#, python-format +msgid "Failed to scan documents in %s: %r" +msgstr "" + +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 +#, python-format +msgid "Domain %r is not registered" +msgstr "" + +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "" + +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "" + +#: environment/__init__.py:952 +#, python-format +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgstr "" + +#: locale/__init__.py:229 +msgid "Attention" +msgstr "" + +#: locale/__init__.py:230 +msgid "Caution" +msgstr "" + +#: locale/__init__.py:231 +msgid "Danger" +msgstr "" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "" + +#: builders/texinfo.py:41 +#, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "" + +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "" + +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/texinfo.py:85 +#, python-format +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:310 builders/texinfo.py:105 +#, python-format +msgid "processing %s" +msgstr "" + +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "" + +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "" + +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "" + +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "" + +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 +#, python-format +msgid "cannot copy image file %r: %s" +msgstr "" + +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "" + +#: builders/texinfo.py:218 +#, python-format +msgid "error writing file Makefile: %s" +msgstr "" + +#: builders/manpage.py:37 +#, python-format +msgid "The manual pages are in %(outdir)s." +msgstr "" + +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "" + +#: builders/manpage.py:64 +#, python-format +msgid "\"man_pages\" config value references unknown document %s" +msgstr "" + +#: builders/singlehtml.py:35 +#, python-format +msgid "The HTML page is in %(outdir)s." +msgstr "" + +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "" + +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "" + +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "" + +#: builders/gettext.py:243 +#, python-format +msgid "The message catalogs are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:400 builders/gettext.py:264 +#, python-format +msgid "building [%s]: " +msgstr "" + +#: builders/gettext.py:265 +#, python-format +msgid "targets for %d template files" +msgstr "" + +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "" + +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "" + +#: builders/linkcheck.py:87 +#, python-format +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "" + +#: builders/linkcheck.py:159 +#, python-format +msgid "broken link: %s (%s)" +msgstr "" + +#: builders/linkcheck.py:561 +#, python-format +msgid "Anchor '%s' not found" +msgstr "" + +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "" + +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "" + +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." +msgstr "" + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "" + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 +#, python-format +msgid "invalid css_file: %r, ignored" +msgstr "" + +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." +msgstr "" + +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" +msgstr "" + +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "" + +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" +msgstr "" + +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" +msgstr "" + +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" +msgstr "" + +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "" + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "" + +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" +msgstr "" + +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" +msgstr "" + +#: ext/graphviz.py:153 +#, python-format +msgid "External Graphviz file %r not found or reading it failed" +msgstr "" + +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "" + +#: ext/graphviz.py:287 +#, python-format +msgid "graphviz_dot executable path must be set! %r" +msgstr "" + +#: ext/graphviz.py:328 +#, python-format +msgid "" +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" +msgstr "" + +#: ext/graphviz.py:339 +#, python-format +msgid "" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "" + +#: ext/graphviz.py:344 +#, python-format +msgid "" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "" + +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" +msgstr "" + +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" +msgstr "" + +#: ext/graphviz.py:493 ext/graphviz.py:501 +#, python-format +msgid "[graph: %s]" +msgstr "" + +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" +msgstr "" + +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "" + +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "" + +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "" + +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" + +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "" + +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "" + +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "" + +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" +msgstr "" + +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "" + +#: ext/doctest.py:297 +#, python-format +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "" + +#: ext/doctest.py:451 +#, python-format +msgid "no code/output in %s block at %s:%s" +msgstr "" + +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" +msgstr "" + +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "" + +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "" + +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" + +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" + +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" +msgstr "" + +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "" + +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" + +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "" + +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "" + +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "" + +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "" + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" +msgstr "" + +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." +msgstr "" + +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" +msgstr "" + +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "" + +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "" + +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "" + +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "" + +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" +msgstr "" + +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" +msgstr "" + +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "" + +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "" + +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "" + +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "" + +#: domains/javascript.py:374 +#, python-format +msgid "%s (module)" +msgstr "" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "" + +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" +msgstr "" + +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" +msgstr "" + +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr "" + +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "" + +#: domains/rst.py:234 +msgid "directive" +msgstr "" + +#: domains/rst.py:235 +msgid "directive-option" +msgstr "" + +#: domains/rst.py:236 +msgid "role" +msgstr "" + +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "" + +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" +msgstr "" + +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "" + +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "" + +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" +msgstr "" + +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "" + +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "" + +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" + +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "" + +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "" + +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "" + +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "" + +#: cmd/build.py:114 +msgid "general options" +msgstr "" + +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "" + +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "" + +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "" + +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "" + +#: cmd/build.py:150 +msgid "path options" +msgstr "" + +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "" + +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "" + +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "" + +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "" + +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "" + +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "" + +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "" + +#: cmd/build.py:212 +msgid "console output options" +msgstr "" + +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "" + +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "" + +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "" + +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "" + +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "" + +#: cmd/build.py:252 +msgid "warning control options" +msgstr "" + +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "" + +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "" + +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "" + +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "" + +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" + +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "" + +#: cmd/build.py:357 +#, python-format +msgid "cannot open warning file '%s': %s" +msgstr "" + +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "" + +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "" + +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "" + +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "" + +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "" + +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "" + +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "" + +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" + +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "" + +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "" + +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "" + +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "" + +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "" + +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "" + +#: cmd/quickstart.py:134 +#, python-format +msgid "Please enter one of %s." +msgstr "" + +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "" + +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "" + +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "" + +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "" + +#: cmd/quickstart.py:242 +#, python-format +msgid "Selected root path: %s" +msgstr "" + +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "" + +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "" + +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "" + +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "" + +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "" + +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "" + +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "" + +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "" + +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "" + +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "" + +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "" + +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "" + +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "" + +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "" + +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "" + +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "" + +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "" + +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "" + +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "" + +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "" + +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "" + +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "" + +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "" + +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "" + +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "" + +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "" + +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "" + +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "" + +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "" + +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." +msgstr "" + +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." +msgstr "" + +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "" + +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "" + +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "" + +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "" + +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "" + +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "" + +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "" + +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "" + +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "" + +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "" + +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "" + +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "" + +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "" + +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "" + +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "" + +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "" + +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "" + +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "" + +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" + +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "" + +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "" + +#: cmd/quickstart.py:810 +#, python-format +msgid "Invalid template variable: %s" +msgstr "" + +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" +msgstr "" + +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" +msgstr "" + +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "" + +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "" + +#: directives/other.py:203 +msgid "Section author: " +msgstr "" + +#: directives/other.py:205 +msgid "Module author: " +msgstr "" + +#: directives/other.py:207 +msgid "Code author: " +msgstr "" + +#: directives/other.py:209 +msgid "Author: " +msgstr "" + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "" + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "" + +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" +msgstr "" + +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" +msgstr "" + +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "" + +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" +msgstr "" + +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" + +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "" + +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "" + +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "" + +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "" + +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" +msgstr "" + +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "" + +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" + +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" + +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" + +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" + +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" + +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" + +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "" + +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" + +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" +msgstr "" + +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "" + +#: writers/latex.py:616 +#, python-format +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "" + +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "" + +#: writers/latex.py:1228 +#, python-format +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" + +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "" + +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "" + +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" + +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" + +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" + +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" + +#: _cli/__init__.py:98 +msgid "Options" +msgstr "" + +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" + +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "" + +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" + +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "" + +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" + +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" + +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" + +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" + +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" + +#: _cli/__init__.py:231 +msgid "" +msgstr "" + +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" + +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "" + +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "" + +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "" + +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" + +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" + +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "" + +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "" + +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" + +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "" + +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" + +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" + +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "" + +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "" + +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" + +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" + +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "" + +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "" + +#: util/display.py:82 +msgid "skipped" +msgstr "" + +#: util/display.py:87 +msgid "failed" +msgstr "" + +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "" + +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "" + +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "" + +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" + +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" +msgstr "" + +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "" + +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "" + +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" + +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "" + +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "" + +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "" + +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "" + +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "" + +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "" + +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "" + +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "" + +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "" + +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "" + +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "" + +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "" + +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "" + +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "" + +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "" + +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "" + +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "" + +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "" + +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "" + +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "" + +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "" + +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "" + +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "" + +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "" + +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "" + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "" + +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "" + +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "" + +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "" + +#: themes/basic/defindex.html:4 +msgid "Overview" +msgstr "" + +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" +msgstr "" + +#: themes/basic/defindex.html:9 +msgid "the documentation for" +msgstr "" + +#: themes/basic/defindex.html:10 +msgid "last updated" +msgstr "" + +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" +msgstr "" + +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "" + +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "" + +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "" + +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "" + +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "" + +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "" + +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "" + +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "" + +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "" + +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "" + +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "" + +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." +msgstr "" + +#: themes/basic/search.html:28 +msgid "" +"Searching for multiple words only shows matches that contain\n" +" all words." +msgstr "" + +#: themes/basic/search.html:35 +msgid "search" +msgstr "" + +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "" + +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "" + +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." +msgstr "" + +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "" +msgstr[1] "" + +#: themes/basic/static/searchtools.js:276 +msgid "Searching" +msgstr "" + +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "" + +#: themes/basic/static/searchtools.js:526 +msgid ", in " +msgstr "" + +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "" + +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 +#, python-format +msgid "Changes in Version %(version)s — %(docstitle)s" +msgstr "" + +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + +#: themes/basic/changes/versionchanges.html:17 +#, python-format +msgid "Automatically generated list of changes in version %(version)s" +msgstr "" + +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" +msgstr "" + +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" +msgstr "" + +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" +msgstr "" + +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" +msgstr "" + +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" +msgstr "" + +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 +#, python-format +msgid "%s() (in module %s)" +msgstr "" + +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 +#, python-format +msgid "%s (in module %s)" +msgstr "" + +#: domains/python/__init__.py:174 +#, python-format +msgid "%s (built-in variable)" +msgstr "" + +#: domains/python/__init__.py:209 +#, python-format +msgid "%s (built-in class)" +msgstr "" + +#: domains/python/__init__.py:210 +#, python-format +msgid "%s (class in %s)" +msgstr "" + +#: domains/python/__init__.py:275 +#, python-format +msgid "%s() (%s class method)" +msgstr "" + +#: domains/python/__init__.py:277 +#, python-format +msgid "%s() (%s static method)" +msgstr "" + +#: domains/python/__init__.py:430 +#, python-format +msgid "%s (%s property)" +msgstr "" + +#: domains/python/__init__.py:470 +#, python-format +msgid "%s (type alias in %s)" +msgstr "" + +#: domains/python/__init__.py:624 +msgid "Python Module Index" +msgstr "" + +#: domains/python/__init__.py:625 +msgid "modules" +msgstr "" + +#: domains/python/__init__.py:703 +msgid "Deprecated" +msgstr "" + +#: domains/python/__init__.py:729 +msgid "exception" +msgstr "" + +#: domains/python/__init__.py:731 +msgid "class method" +msgstr "" + +#: domains/python/__init__.py:732 +msgid "static method" +msgstr "" + +#: domains/python/__init__.py:734 +msgid "property" +msgstr "" + +#: domains/python/__init__.py:735 +msgid "type alias" +msgstr "" + +#: domains/python/__init__.py:804 +#, python-format +msgid "" +"duplicate object description of %s, other instance in %s, use :no-index: for" +" one of them" +msgstr "" + +#: domains/python/__init__.py:974 +#, python-format +msgid "more than one target found for cross-reference %r: %s" +msgstr "" + +#: domains/python/__init__.py:1048 +msgid " (deprecated)" +msgstr "" + +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" + +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" +msgstr "" + +#: domains/cpp/__init__.py:302 +#, python-format +msgid "%s (C++ %s)" +msgstr "" + +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 +msgid "Return values" +msgstr "" + +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "" + +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" +msgstr "" + +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "" + +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "" + +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 +msgid "enum" +msgstr "" + +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 +msgid "enumerator" +msgstr "" + +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 +msgid "function parameter" +msgstr "" + +#: domains/cpp/__init__.py:954 +msgid "template parameter" +msgstr "" + +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 +#, python-format +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." +msgstr "" + +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "" + +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "" + +#: domains/c/__init__.py:781 +msgid "struct" +msgstr "" + +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" +msgstr "" + +#: domains/std/__init__.py:116 +#, python-format +msgid "%s; configuration value" +msgstr "" + +#: domains/std/__init__.py:172 +msgid "Type" +msgstr "" + +#: domains/std/__init__.py:182 +msgid "Default" +msgstr "" + +#: domains/std/__init__.py:239 +#, python-format +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" +msgstr "" + +#: domains/std/__init__.py:319 +#, python-format +msgid "%s command line option" +msgstr "" + +#: domains/std/__init__.py:321 +msgid "command line option" +msgstr "" + +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" +msgstr "" + +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" +msgstr "" + +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "" + +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "" + +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "" + +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "" + +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "" + +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "" + +#: domains/std/__init__.py:735 +msgid "document" +msgstr "" + +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "" + +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" +msgstr "" + +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "" + +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" +msgstr "" + +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" +msgstr "" + +#: domains/std/__init__.py:1153 +#, python-format +msgid "invalid numfig_format: %s (%r)" +msgstr "" + +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" +msgstr "" + +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" +msgstr "" + +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "" + +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" +msgstr "" + +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" +msgstr "" + +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" +msgstr "" + +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" +msgstr "" + +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "" + +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "" + +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "" + +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "" + +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" + +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" + +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "" + +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" +msgstr "" + +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 +#, python-format +msgid "alias of %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" +msgstr "" + +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 +#, python-format +msgid "invalid value for member-order option: %s" +msgstr "" + +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 +#, python-format +msgid "invalid signature for auto%s (%r)" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "" + +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" +msgstr "" + +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "" + +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" +msgstr "" + +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "" + +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "" + +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" + +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "" + +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "" + +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "" + +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "" + +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "" + +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "" + +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "" + +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "" + +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" + +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" + +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "" + +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" + +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "" + +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "" + +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "" + +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "" + +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" +msgstr "" + +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "" + +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "" + +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "" + +#: ext/apidoc/_extension.py:133 +#, python-format +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "" + +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "" + +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "" + +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "" + +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" + +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" + +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "" + +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "" + +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "" + +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 +#, python-format +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "" + +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" +msgstr "" + +#: ext/autosummary/generate.py:634 +#, python-format +msgid "[autosummary] writing to %s" +msgstr "" + +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" + +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "" + +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "" + +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "" + +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "" + +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "" + +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "" + +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "" + +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." +msgstr "" + +#: ext/autosummary/__init__.py:239 +#, python-format +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." +msgstr "" + +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" + +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" +msgstr "" + +#: ext/autosummary/__init__.py:652 +#, python-format +msgid "" +"Summarised items should not include the current module. Replace %r with %r." +msgstr "" + +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" +msgstr "" + +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." +msgstr "" + +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" + +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" + +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" + +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "" + +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "" + +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" + +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "" + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" + +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "" + +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 +#, python-format +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" + +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "" + +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" +msgstr "" + +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "" + +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "" + +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "" + +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" +msgstr "" + +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "" + +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "" + +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." +msgstr "" + +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" + +#: builders/html/__init__.py:372 +#, python-format +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "" + +#: builders/html/__init__.py:496 +msgid "index" +msgstr "" + +#: builders/html/__init__.py:549 +#, python-format +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "" + +#: builders/html/__init__.py:783 +#, python-format +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "" + +#: builders/html/__init__.py:807 +#, python-format +msgid "cannot copy downloadable file %r: %s" +msgstr "" + +#: builders/html/__init__.py:853 +#, python-format +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgstr "" + +#: builders/html/__init__.py:871 +#, python-format +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "" + +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 +#, python-format +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "" + +#: builders/html/__init__.py:938 +#, python-format +msgid "cannot copy extra file %r" +msgstr "" + +#: builders/html/__init__.py:944 +#, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "" + +#: builders/html/__init__.py:1038 +#, python-format +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "" + +#: builders/html/__init__.py:1204 +#, python-format +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "" + +#: builders/html/__init__.py:1217 +#, python-format +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" +msgstr "" + +#: builders/html/__init__.py:1225 +#, python-format +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "" + +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "" + +#: builders/html/__init__.py:1266 +#, python-format +msgid "dumping search index in %s" +msgstr "" + +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" +msgstr "" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "" + +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." +msgstr "" + +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "" + +#: builders/html/__init__.py:1370 +#, python-format +msgid "html_extra_path entry %r does not exist" +msgstr "" + +#: builders/html/__init__.py:1385 +#, python-format +msgid "html_static_path entry %r is placed inside outdir" +msgstr "" + +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" +msgstr "" + +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 +#, python-format +msgid "logo file %r does not exist" +msgstr "" + +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "" + +#: builders/html/__init__.py:1425 +#, python-format +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." +msgstr "" + +#: builders/html/__init__.py:1438 +msgid "" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "" + +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" +msgstr "" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" +msgstr "" + +#: builders/latex/theming.py:90 +#, python-format +msgid "%r doesn't have \"%s\" setting" +msgstr "" + +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "" + +#: builders/latex/transforms.py:121 +#, python-format +msgid "Failed to get a docname for source %r!" +msgstr "" + +#: builders/latex/transforms.py:487 +#, python-format +msgid "No footnote was found for given reference node %r" +msgstr "" + +#: builders/latex/__init__.py:115 +#, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 +msgid "" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "" + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 +#, python-format +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 +#, python-format +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "" + +#: builders/latex/__init__.py:537 +#, python-format +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "" + +#: environment/collectors/asset.py:98 +#, python-format +msgid "image file not readable: %s" +msgstr "" + +#: environment/collectors/asset.py:126 +#, python-format +msgid "image file %s not readable: %s" +msgstr "" + +#: environment/collectors/asset.py:165 +#, python-format +msgid "download file not readable: %s" +msgstr "" + +#: environment/adapters/toctree.py:335 +#, python-format +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "" + +#: environment/adapters/toctree.py:360 +#, python-format +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "" + +#: environment/adapters/toctree.py:375 +#, python-format +msgid "toctree contains reference to non-included document %r" +msgstr "" + +#: environment/adapters/toctree.py:378 +#, python-format +msgid "toctree contains reference to non-existing document %r" +msgstr "" + +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "" diff --git a/sphinx/locale/pl/LC_MESSAGES/sphinx.mo b/sphinx/locale/pl/LC_MESSAGES/sphinx.mo index 236e39b13b6..c7bc58591f9 100644 Binary files a/sphinx/locale/pl/LC_MESSAGES/sphinx.mo and b/sphinx/locale/pl/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/pl/LC_MESSAGES/sphinx.po b/sphinx/locale/pl/LC_MESSAGES/sphinx.po index 885744a3730..1f37e053571 100644 --- a/sphinx/locale/pl/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/pl/LC_MESSAGES/sphinx.po @@ -14,7 +14,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Stan Ulbrych, 2025\n" "Language-Team: Polish (http://app.transifex.com/sphinx-doc/sphinx-1/language/pl/)\n" @@ -25,6 +25,127 @@ msgstr "" "Language: pl\n" "Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && (n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "ustawienie %s.%s nie występuje w żadnej z przeszukiwanych konfiguracji motywów" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "plik %r na ścieżce motywu nie jest poprawnym plikiem zip lub nie zawiera motywu" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -39,127 +160,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Ten projekt potrzebuje rozszerzenia %s co najmniej w wersji %s, dlatego nie może zostać zbudowany z załadowaną wersją (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Zdarzenie %r już obecne" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Nieznana nazwa zdarzenia: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Nie odnaleziono katalogu źródłowego (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Katalog wyjściowy (%s) nie jest katalogiem" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Katalog źródłowy i katalog docelowy nie mogą być identyczne" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Uruchamianie Sphinksa v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Ten projekt potrzebuje Sphinksa w wersji co najmniej %s, dlatego nie może zostać zbudowany z tą wersją." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "tworzenie katalogu wyjścia" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "podczas ustawiania rozszerzenia %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' podany w conf.py nie jest wywoływalny. Prosimy zmienić jego definicję tak, aby była wywoływalną funkcją. Jest to potrzebne w conf.py, aby zachowywało się jak rozszerzenie Sphinksa." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "ładowanie tłumaczeń [%s]..." -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "gotowe" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "niedostępne dla wbudowanych wiadomości" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "ładowanie zapakowanego środowiska" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "nie powiodło się: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Nie wybrano buildera, używamy domyślnego: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "klasa %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -167,12 +315,12 @@ msgid "" "explicit" msgstr "rozszerzenie %s nie deklaruje, czy jest bezpieczne do czytania współbieżnego, zakładamy że nie jest – prosimy zapytać autora rozszerzenie o sprawdzenie i zadeklarowania tego wprost" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -180,82 +328,214 @@ msgid "" "explicit" msgstr "rozszerzenie %s nie deklaruje, czy jest bezpieczne do pisania współbieżnego, zakładamy że nie jest – prosimy zapytać autora rozszerzenia o sprawdzenie i zadeklarowanie tego wprost" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "tworzenie serii %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "folder konfiguracyjny nie zawiera pliku conf.py (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Klasa buildera %s nie ma atrybutu \"name\"" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Builder %r już istnieje (w module %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Builder o nazwie %s jest niezarejestrowany lub dostępny przez punkt wejścia" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Builder o nazwie %s jest niezarejestrowany" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "domena %s jest już zarejestrowana" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "domena %s nie została jeszcze zarejestrowana" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "%r object_type jest już zarejestrowany" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "%r crossref_type jest już zarejestrowany" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r jest już zarejestrowany" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser dla %r jest już zarejestrowany" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Parser źródeł dla %s jest nie zarejestrowany" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r już zarejestrowany" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "rozszerzenie %r zostało już włączone do Sphinx'a, począwszy od wersji %s; to rozszerzenie jest zignorowane." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Pierwotny wyjątek:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Nie można zaimportować rozszerzenia %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "rozszerzenie %r nie zawiera funkcji setup(); czy to na pewno moduł rozszerzenia Sphinx?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "Rozszerzenie %s używane przez ten projekt potrzebuje Sphinksa w wersji co najmniej %s; dlatego nie może zostać zbudowane z tą wersją." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "rozszerzenie %r zwróciło nie wspierany obiekt ze swojej funkcji setup(); powinno zwrócić None lub słownik metadanych" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "folder konfiguracyjny nie zawiera pliku conf.py (%s)" + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "nie można nadpisać słownikowego ustawienia konfiguracji %r, ignorowanie (użyj %r, by ustawić poszczególne elementy)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "niepoprawna liczba %r dla wartości konfiguracji %r, ignorowanie" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "nie można nadpisać ustawienia konfiguracji %r nie wspieranym typem, ignorowanie" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "nieznana wartość konfiguracji %r w nadpisaniu, ignorowanie" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Wartość konfiguracji %r już podana" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "W twoim piku konfiguracyjnym jest błąd składniowy: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Plik konfiguracyjny (albo jeden z modułów przez niego zaimportowanych) wywołał sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -263,468 +543,624 @@ msgid "" "%s" msgstr "W twoim piku konfiguracyjnym jest błąd programowalny: \n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Rozdział %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Rys. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabela %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Listing %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Wartość konfiguracyjna `{name}` musi być jednym z {candidates}, a podany jest `{current}`." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "Nie odnaleziono primary_domain %r, zignorowano." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "nowa konfiguracja" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "konfiguracja zmieniona" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "ustawienie %s.%s nie występuje w żadnej z przeszukiwanych konfiguracji motywów" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "rozszerzenie zmienione" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "plik %r na ścieżce motywu nie jest poprawnym plikiem zip lub nie zawiera motywu" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "katalog źródłowy został zmieniony" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +msgid "Domain %r is not registered" +msgstr "Domena %r nie jest zarejestrowana" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Uwaga" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Zdarzenie %r już obecne" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Ostrzeżenie" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Nieznana nazwa zdarzenia: %s" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Niebezpieczeństwo" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Błąd" -#: project.py:72 +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Podpowiedź" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Ważne" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Informacja" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Zobacz także" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Wskazówka" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Ostrzeżenie" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Pliki Texinfo znajdują się w %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "nie znaleziono wartości konfiguracyjnej \"texinfo_documents\"; żadne dokumenty nie zostaną zapisane" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Klasa buildera %s nie ma atrybutu \"name\"" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "wartość konfiguracyjna \"texinfo_documents\" odwołuje się do nieznanego dokumentu %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Builder %r już istnieje (w module %s)" +msgid "processing %s" +msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Builder o nazwie %s jest niezarejestrowany lub dostępny przez punkt wejścia" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "pisanie" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Builder o nazwie %s jest niezarejestrowany" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "domena %s jest już zarejestrowana" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (w " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "domena %s nie została jeszcze zarejestrowana" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "kopiowanie obrazków..." -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "%r object_type jest już zarejestrowany" +msgid "The manual pages are in %(outdir)s." +msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "%r crossref_type jest już zarejestrowany" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r jest już zarejestrowany" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser dla %r jest już zarejestrowany" +msgid "The HTML page is in %(outdir)s." +msgstr "Strona HTML jest w %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "Parser źródeł dla %s jest nie zarejestrowany" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r już zarejestrowany" +msgid "The message catalogs are in %(outdir)s." +msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "rozszerzenie %r zostało już włączone do Sphinx'a, począwszy od wersji %s; to rozszerzenie jest zignorowane." +msgid "targets for %d template files" +msgstr "" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Pierwotny wyjątek:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "wczytywanie szablonów... " -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "Nie można zaimportować rozszerzenia %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "rozszerzenie %r nie zawiera funkcji setup(); czy to na pewno moduł rozszerzenia Sphinx?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "Rozszerzenie %s używane przez ten projekt potrzebuje Sphinksa w wersji co najmniej %s; dlatego nie może zostać zbudowane z tą wersją." +msgid "broken link: %s (%s)" +msgstr "zepsuty odnośnik: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "rozszerzenie %r zwróciło nie wspierany obiekt ze swojej funkcji setup(); powinno zwrócić None lub słownik metadanych" +msgid "Anchor '%s' not found" +msgstr "Nie znaleziono kotwicy '%s'" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" -msgstr "" +msgid "The ePub file is in %(outdir)s." +msgstr "Plik ePub znajduje się w %(outdir)s." -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[źródło]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[dokumentacja]" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Kod modułu" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        Kod źródłowy modułu %s

        " +msgid "invalid css_file: %r, ignored" +msgstr "nieprawidłowy css_file: %r, zignorowano" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Przeglądanie: kod modułu" +#: builders/xml.py:29 +#, python-format +msgid "The XML files are in %(outdir)s." +msgstr "Pliki XML znajdują się w %(outdir)s." -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Wszystkie moduły, dla których jest dostępny kod

        " +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" +msgstr "błąd zapisu pliku %s: %s" -#: ext/extlinks.py:82 +#: builders/xml.py:103 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Pliki pseudo-XML są w %(outdir)s." + +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/_epub_base.py:436 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/_epub_base.py:467 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "brak '+' lub '-' w opcji '%s'." +msgid "unknown mimetype for %s, ignoring" +msgstr "nieznany mimetype dla %s, ignoruję" -#: ext/doctest.py:124 +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' nie jest prawidłową opcją." +msgid "writing %s file..." +msgstr "pisanie pliku %s..." -#: ext/doctest.py:139 +#: builders/text.py:27 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' nie jest prawidłową opcją pyversion." +msgid "The text files are in %(outdir)s." +msgstr "Pliki tekstowe są w %(outdir)s." -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" -#: ext/doctest.py:297 +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "budowanie [mo]:" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "pisanie wyjścia..." + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "wszystkie z %d plików po" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "wsztstkie pliki źródłowe" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" +msgstr "plik %r podany w wierszu poleceń nie znajduje się w katalogu źródłowym, ignoruję" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:366 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "%d source files given on command line" +msgstr "%d plików źródłowych podano w wierszu poleceń" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d found" +msgstr "znaleziono %d" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "nic nie znaleziono" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "brak zmian w wersji %s." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Wbudowane" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Poziom modułu" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "kopiowanie plików źródłowych..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -745,9 +1181,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -782,6 +1219,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<> znajduje się w pliku %s, w linii %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "oryginalny wpis" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -869,948 +1334,994 @@ msgstr "[wykres: %s]" msgid "[graph]" msgstr "[wykres]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Todo" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<> znajduje się w pliku %s, w linii %d.)" +msgid "display latex %r: %s" +msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "oryginalny wpis" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" -msgstr "Nieprawidłowy podpis: %s" +msgid "missing '+' or '-' in '%s' option." +msgstr "brak '+' lub '-' w opcji '%s'." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "" +msgid "'%s' is not a valid option." +msgstr "'%s' nie jest prawidłową opcją." -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Nie można użyć jednocześnie opcji \"%s\" i \"%s\"" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' nie jest prawidłową opcją pyversion." -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 -#, python-format -msgid "Object named %r not found in include file %r" -msgstr "Nie znaleziono obiektu o nazwie %r w pliku include %r" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "Nie można użyć „lineno-match” z rozłącznym zbiorem „lines”" - -#: directives/code.py:314 +#: ext/doctest.py:451 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Specyfikacja linii %r: nie wyciągnięto żadnych linii z pliku include %r" - -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/other.py:119 +#: ext/doctest.py:568 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/autosectionlabel.py:52 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:156 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:47 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autor rozdziału: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autor modułu: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autor kodu: " - -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor: " - -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: builders/changes.py:56 +#: ext/duration.py:139 #, python-format -msgid "no changes in version %s." -msgstr "brak zmian w wersji %s." - -#: builders/changes.py:58 -msgid "writing summary file..." +msgid "%.3fs %s" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Wbudowane" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[źródło]" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Poziom modułu" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "kopiowanie plików źródłowych..." +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[dokumentacja]" -#: builders/changes.py:133 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Kod modułu" -#: builders/manpage.py:37 +#: ext/viewcode.py:359 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "

        Source code for %s

        " +msgstr "

        Kod źródłowy modułu %s

        " -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Przeglądanie: kod modułu" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "pisanie" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Wszystkie moduły, dla których jest dostępny kod

        " -#: builders/manpage.py:71 +#: domains/citation.py:75 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/__init__.py:224 +#: domains/citation.py:92 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +msgid "Citation [%s] is not referenced." +msgstr "Cytat [%s] nie ma odniesienia." -#: builders/__init__.py:232 +#: domains/math.py:73 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "budowanie [mo]:" - -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "pisanie wyjścia..." +msgid "duplicate label of equation %s, other instance in %s" +msgstr "zduplikowana etykieta równania %s, inne wystąpienie w %s" -#: builders/__init__.py:275 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "all of %d po files" -msgstr "wszystkie z %d plików po" +msgid "Invalid math_eqref_format: %r" +msgstr "Nieprawidłowy math_eqref_format: %r" -#: builders/__init__.py:297 +#: domains/javascript.py:183 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s() (built-in function)" +msgstr "%s() (funkcja wbudowana)" -#: builders/__init__.py:309 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "wsztstkie pliki źródłowe" +msgid "%s() (%s method)" +msgstr "%s() (%s metoda)" -#: builders/__init__.py:330 +#: domains/javascript.py:186 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +msgid "%s() (class)" +msgstr "%s() (klasa)" -#: builders/__init__.py:337 +#: domains/javascript.py:188 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "plik %r podany w wierszu poleceń nie znajduje się w katalogu źródłowym, ignoruję" +msgid "%s (global variable or constant)" +msgstr "%s (zmienna globalna lub stała)" -#: builders/__init__.py:348 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s atrybut)" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "%d plików źródłowych podano w wierszu poleceń" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumenty" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Wyrzuca" -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Zwraca" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Typ zwracany" -#: builders/__init__.py:410 +#: domains/javascript.py:374 #, python-format -msgid "%d found" -msgstr "znaleziono %d" +msgid "%s (module)" +msgstr "%s (moduł)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "nic nie znaleziono" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funkcja" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metoda" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klasa" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "dane" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atrybut" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "moduł" -#: builders/__init__.py:531 +#: domains/javascript.py:458 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:540 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "%s (directive)" +msgstr "%s (dyrektywa)" -#: builders/__init__.py:551 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:558 +#: domains/rst.py:224 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +msgid "%s (role)" +msgstr "%s (rola)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "dyrektywa" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:713 +#: domains/rst.py:236 +msgid "role" +msgstr "rola" + +#: domains/rst.py:262 #, python-format -msgid "docnames to write: %s" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" +msgstr " Dodane w wersji %s" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "Zmienione w wersji %s" -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "" +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "Niezalecane od wersji %s" -#: builders/__init__.py:883 +#: domains/changeset.py:35 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +msgid "Removed in version %s" msgstr "" -#: builders/epub3.py:84 +#: domains/__init__.py:322 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "Plik ePub znajduje się w %(outdir)s." +msgid "%s %s" +msgstr "%s %s" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:114 +msgid "general options" +msgstr "ogólne opcje" + +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "zapisz wszystkie pliki (domyślnie: zapisz tylko nowe i zmienione pliki)" + +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "nieprawidłowy css_file: %r, zignorowano" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Pliki XML znajdują się w %(outdir)s." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "błąd zapisu pliku %s: %s" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "zastąp ustawienie w pliku konfiguracyjnym" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Pliki pseudo-XML są w %(outdir)s." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "przekaż wartość do szablonów HTML" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Pliki Texinfo znajdują się w %(outdir)s." +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "nie znaleziono wartości konfiguracyjnej \"texinfo_documents\"; żadne dokumenty nie zostaną zapisane" +#: cmd/build.py:212 +msgid "console output options" +msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "wartość konfiguracyjna \"texinfo_documents\" odwołuje się do nieznanego dokumentu %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "zwiększ szczegółowość (może być powtórzone)" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (w " +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "kopiowanie obrazków..." +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "zapisz ostrzeżenia (i błędy) do podanego pliku" + +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "zamień ostrzeżenia na błędy" + +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:464 +#: cmd/build.py:357 #, python-format -msgid "cannot write image file %r: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "Argument opcji -D musi mieć postać nazwa=wartość" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "Argument opcji -A musi mieć postać nazwa=wartość" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "nieznany mimetype dla %s, ignoruję" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "pisanie pliku %s..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "warunkowe włączenie treści na podstawie wartości konfiguracyjnych" + +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "wczytywanie szablonów... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Wprowadź poprawną nazwę ścieżki." -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "Strona HTML jest w %(outdir)s." +msgid "Please enter one of %s." +msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Wprowadź \"y\" lub \"n\"." -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Podaj rozszerzenie pliku, na przykład '.rst' lub '.txt'." -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Witamy w narzędziu quickstart Sphinksa %s." -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "zepsuty odnośnik: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" -msgstr "Nie znaleziono kotwicy '%s'" +msgid "Selected root path: %s" +msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Pliki tekstowe są w %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Ścieżka root dla dokumentacji" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Błąd: znaleziono istniejący conf.py na wskazanej ścieżce root." -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart nie nadpisze istniejących projektów Sphinx." -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Wprowadź, prosimy, nową ścieżkę root (lub tylko Enter, aby wyjść)" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b %Y" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Rozdziel katalogi source i build (y/n)" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Prefiks nazw dla katalogów templates i static" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:298 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Nazwa projektu" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Nazwisko autora" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Wersja projektu" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Wydanie projektu" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Język projektu" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Sufiks pliku źródłowego" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:350 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart nie nadpisze istniejącego pliku." -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Wskaż, które z następujących rozszerzeń Sphinx powinny być włączone:" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Stworzyć Makefile? (y/n)" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:86 -msgid "new config" -msgstr "nowa konfiguracja" - -#: environment/__init__.py:87 -msgid "config changed" -msgstr "konfiguracja zmieniona" - -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "rozszerzenie zmienione" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." +msgstr "Tworzenie pliku %s." -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." +msgstr "Plik %s już istnieje, pomijam." -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "katalog źródłowy został zmieniony" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Zakończono: Utworzono początkową strukturę katalogów." -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "Domena %r nie jest zarejestrowana" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "tryb cichy" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "błąd odczytu: %s, %s" - -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "błąd zapisu: %s, %s" - -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Podstawowe opcje projektu" + +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "nazwa projektu" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "nazwiska autorów" + +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "wersja projektu" + +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "język dokumentu" + +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "rozszerzenie pliku źródłowego" + +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "nazwa głównego dokumentu" + +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/nodes.py:423 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Opcje rozszerzeń" + +#: cmd/quickstart.py:671 #, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +msgid "enable %s extension" +msgstr "włącz rozszerzenie %s" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "utwórz plik makefile" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "nie twórz pliku makefile" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "twórz plik wsadowy" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "nie twórz pliku wsadowego" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: util/display.py:82 -msgid "skipped" -msgstr "pominięte" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/fileutil.py:76 +#: cmd/quickstart.py:810 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "Invalid template variable: %s" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:119 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/rst.py:73 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "default role %s not found" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/inventory.py:147 +#: directives/other.py:156 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/inventory.py:166 +#: directives/other.py:169 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Przypisy" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autor rozdziału: " -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[obraz: %s]" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autor modułu: " -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[obraz]" +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autor kodu: " -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Indeks" +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor: " -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" -msgstr "" +msgid "Invalid caption: %s" +msgstr "Nieprawidłowy podpis: %s" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" -msgstr "" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Nie można użyć jednocześnie opcji \"%s\" i \"%s\"" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "Nie znaleziono obiektu o nazwie %r w pliku include %r" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "Nie można użyć „lineno-match” z rozłącznym zbiorem „lines”" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Specyfikacja linii %r: nie wyciągnięto żadnych linii z pliku include %r" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d %b %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Indeks" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "%s" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Przypisy" -#: writers/latex.py:1939 +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "" + +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "Nieprawidłowy math_eqref_format: %r" +msgid "[image: %s]" +msgstr "[obraz: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[obraz]" #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" @@ -1838,6 +2349,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1854,794 +2370,478 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "zduplikowana etykieta równania %s, inne wystąpienie w %s" +msgid "no Babel option known for language %r" +msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (funkcja wbudowana)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metoda)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "" -#: domains/javascript.py:185 +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "" + +#: writers/latex.py:1228 #, python-format -msgid "%s() (class)" -msgstr "%s() (klasa)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: domains/javascript.py:187 +#: writers/latex.py:1615 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s (zmienna globalna lub stała)" +msgid "dimension unit %s is invalid. Ignored." +msgstr "%s" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1950 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s atrybut)" +msgid "unknown index entry type %s found" +msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumenty" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Wyrzuca" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Zwraca" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Typ zwracany" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (moduł)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funkcja" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metoda" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klasa" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "dane" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atrybut" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "moduł" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr " Dodane w wersji %s" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Zmienione w wersji %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Niezalecane od wersji %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (dyrektywa)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (rola)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "dyrektywa" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:236 -msgid "role" -msgstr "rola" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "" - -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "Cytat [%s] nie ma odniesienia." - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Uwaga" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Ostrzeżenie" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Niebezpieczeństwo" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Błąd" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Podpowiedź" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Ważne" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Informacja" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Zobacz także" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Wskazówka" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Ostrzeżenie" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "warunkowe włączenie treści na podstawie wartości konfiguracyjnych" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Wprowadź poprawną nazwę ścieżki." - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "" - -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "" - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Wprowadź \"y\" lub \"n\"." - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Podaj rozszerzenie pliku, na przykład '.rst' lub '.txt'." - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Witamy w narzędziu quickstart Sphinksa %s." - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "" - -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" -msgstr "" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Ścieżka root dla dokumentacji" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Błąd: znaleziono istniejący conf.py na wskazanej ścieżce root." - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart nie nadpisze istniejących projektów Sphinx." - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Wprowadź, prosimy, nową ścieżkę root (lub tylko Enter, aby wyjść)" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Rozdziel katalogi source i build (y/n)" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Prefiks nazw dla katalogów templates i static" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Nazwa projektu" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Nazwisko autora" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Wersja projektu" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Wydanie projektu" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Język projektu" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "" - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Sufiks pliku źródłowego" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "" - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "" - -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart nie nadpisze istniejącego pliku." - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Wskaż, które z następujących rozszerzeń Sphinx powinny być włączone:" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "" - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Stworzyć Makefile? (y/n)" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." -msgstr "Tworzenie pliku %s." - -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "Plik %s już istnieje, pomijam." - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Zakończono: Utworzono początkową strukturę katalogów." - -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "tryb cichy" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Podstawowe opcje projektu" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "nazwa projektu" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "nazwiska autorów" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "wersja projektu" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "język dokumentu" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "rozszerzenie pliku źródłowego" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "nazwa głównego dokumentu" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Opcje rozszerzeń" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "" -#: cmd/quickstart.py:670 +#: transforms/__init__.py:299 #, python-format -msgid "enable %s extension" -msgstr "włącz rozszerzenie %s" +msgid "Footnote [%s] is not referenced." +msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "utwórz plik makefile" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "nie twórz pliku makefile" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "twórz plik wsadowy" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "błąd odczytu: %s, %s" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "nie twórz pliku wsadowego" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "błąd zapisu: %s, %s" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" +#: util/display.py:82 +msgid "skipped" +msgstr "pominięte" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:809 +#: util/docutils.py:361 #, python-format -msgid "Invalid template variable: %s" +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:74 +#: util/fileutil.py:76 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:109 +#: util/docfields.py:103 +#, python-format msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:114 -msgid "general options" -msgstr "ogólne opcje" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:131 +#: util/nodes.py:462 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "zapisz wszystkie pliki (domyślnie: zapisz tylko nowe i zmienione pliki)" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "kontynuacja poprzedniej strony" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "ciąg dalszy na następnej stronie" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "Niealfabetyczny" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "zastąp ustawienie w pliku konfiguracyjnym" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Symbole" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "przekaż wartość do szablonów HTML" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Liczby" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "strona" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Wydanie" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Nieznany format obrazka: %s..." + +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "zwiększ szczegółowość (może być powtórzone)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "znaleziono więcej niż jeden cel dla cross-referencji „any” %r: może być %s" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "zapisz ostrzeżenia (i błędy) do podanego pliku" - -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "zamień ostrzeżenia na błędy" - -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "Argument opcji -D musi mieć postać nazwa=wartość" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "Argument opcji -A musi mieć postać nazwa=wartość" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Zwiń pasek boczny" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Spis treści" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Nawigacja" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Szukaj pośród %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "O tych dokumentach" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Szukaj" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Szukaj" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Ostatnia modyfikacja %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Poprzedni temat" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "poprzedni rozdział" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Następny temat" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "następny rozdział" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "Indeks – %(key)s" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Cały indeks na jednej stronie" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Ta strona" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Pokaż źródło" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Treść" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Szybkie wyszukiwanie" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Przeszukaj %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Szukaj" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2688,7 +2888,7 @@ msgstr "Globalny indeks modułów" msgid "quick access to all modules" msgstr "szybki dostęp do wszystkich modułów" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Indeks ogólny" @@ -2696,23 +2896,15 @@ msgstr "Indeks ogólny" msgid "all functions, classes, terms" msgstr "wszystkie funkcje, klasy, terminy" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Ta strona" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Spis treści" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "Indeks – %(key)s" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Cały indeks na jednej stronie" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Szybkie wyszukiwanie" +msgid "Search %(docstitle)s" +msgstr "Przeszukaj %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2722,57 +2914,6 @@ msgstr "Strony indeksu alfabetycznie" msgid "can be huge" msgstr "może być ogromny" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Poprzedni temat" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "poprzedni rozdział" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Następny temat" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "następny rozdział" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Nawigacja" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Szukaj pośród %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "O tych dokumentach" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "© %(copyright_prefix)s %(copyright)s." - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Ostatnia modyfikacja %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2789,21 +2930,21 @@ msgstr "" msgid "search" msgstr "szukaj" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Ukryj wyniki wyszukiwania" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Treść" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Wyniki wyszukiwania" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Twoje wyszukiwanie nie dało żadnych wyników. Upewnij się, że wszystkie słowa są wpisane prawidłowo i że wybrałeś dostateczną ilość kategorii." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2813,22 +2954,21 @@ msgstr[1] "" msgstr[2] "" msgstr[3] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Wyszukiwanie" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Inicjalizacja wyszukiwania..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", w " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Ukryj wyniki wyszukiwania" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2836,6 +2976,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Zmiany w wersji %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2857,120 +3002,127 @@ msgstr "Inne zmiany" msgid "Expand sidebar" msgstr "Rozwiń pasek boczny" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametry" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Zmienne" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Wyrzuca" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (w module %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (w module %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (zmienna wbudowana)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (klasa wbudowana)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (klasa w module %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s metoda klasy)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s metoda statyczna)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Indeks modułów Pythona" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moduły" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Niezalecane" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "wyjątek" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "metoda klasy" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statyczna metoda" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (niezalecane)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametry" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Zmienne" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Wyrzuca" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2981,92 +3133,85 @@ msgstr "Parametry szablonu" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "unia" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "pole" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "typ" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "koncepcja" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerator" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "zmienna" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "makro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "zmienna środowiskowa; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "Typ" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3124,603 +3269,390 @@ msgstr "Indeks modułów" #: domains/std/__init__.py:857 #, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "zobacz %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "zobacz także %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Symbole" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" - -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "znaleziono więcej niż jeden cel dla cross-referencji „any” %r: może być %s" - -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "" - -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "" - -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "" - -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "" - -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." -msgstr "Nieznany format obrazka: %s..." - -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "Strony HTML są w %(outdir)s." - -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" -msgstr "" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "" - -#: builders/html/__init__.py:366 -msgid "building [html]: " -msgstr "" - -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "" - -#: builders/html/__init__.py:507 -msgid "index" -msgstr "indeks" - -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "" - -#: builders/html/__init__.py:589 -msgid "next" -msgstr "dalej" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "wstecz" - -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "" - -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "" - -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "kopiowanie plików do pobrania..." +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1153 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy static file %r" -msgstr "nie można skopiować pliku statycznego %r" - -#: builders/html/__init__.py:939 -msgid "copying extra files" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:949 +#: domains/std/__init__.py:1456 #, python-format -msgid "cannot copy extra file %r" -msgstr "nie można skopiować dodatkowego pliku %r" +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Failed to write build info file: %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "Wystąpił błąd podczas renderowania strony %s.\nPowód: %r" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Przykład" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Przykłady" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Argumenty Nazwane" + +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Uwagi" + +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Pozostałe parametry" + +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "nieprawidłowy js_file: %r, zignorowano" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Referencje" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "Podano nieznany math_renderer %r." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" -#: builders/html/__init__.py:1360 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "" +msgid "Bases: %s" +msgstr "Klasy bazowe: %s" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "favicon file %r does not exist" -msgstr "plik favicon %r nie istnieje" +msgid "invalid signature for auto%s (%r)" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:93 #, python-format -msgid "%s %s documentation" -msgstr "%s %s - dokumentacja" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Pliki LaTeX znajdują się w %(outdir)s." +msgid "Would create file %s." +msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "nie znaleziono wartości konfiguracyjnej \"latex_documents\"; żadne dokumenty nie zostaną zapisane" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "wartość konfiguracyjna \"latex_documents\" odwołuje się do nieznanego dokumentu %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Wydanie" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "maksymalna głębokość submodułów wyświetlanych w spisie treści (domyślnie: 4)" + +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "nadpisz istniejące pliki" + +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "wykonaj skrypt bez tworzenia plików" + +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "nie twórz pliku spisu treści" + +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "rozszerzenie pliku (domyślnie: rst)" + +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "kontynuacja poprzedniej strony" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "ciąg dalszy na następnej stronie" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "Niealfabetyczny" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Liczby" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "strona" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Argumenty Nazwane" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "%s is not a directory." +msgstr "%s nie jest katalogiem." + +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Przykład" - -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Przykłady" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Uwagi" - -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Pozostałe parametry" - -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Referencje" - -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3728,7 +3660,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3743,481 +3675,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "domyślny sufiks dla plików (domyślnie: %(default)s)" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "maksymalna głębokość submodułów wyświetlanych w spisie treści (domyślnie: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." +msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "nadpisz istniejące pliki" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "wykonaj skrypt bez tworzenia plików" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "nie twórz pliku spisu treści" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "rozszerzenie pliku (domyślnie: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr " (w %s)" + +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_loader.py:193 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "%s is not a directory." -msgstr "%s nie jest katalogiem." +msgid "Failed to get a function signature for %s: %s" +msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_type_comments.py:123 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "błąd podczas formatowania argumentów dla %s: %s" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +msgid "missing attribute %s in object %s" +msgstr "brakujący atrybut %s w obiekcie %s" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:247 -#, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_generate.py:69 -#, python-format -msgid "Would create file %s." +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:114 #, python-format -msgid "(in %s v%s)" -msgstr "(w %s v%s)" +msgid "The HTML pages are in %(outdir)s." +msgstr "Strony HTML są w %(outdir)s." -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s)" -msgstr " (w %s)" +msgid "Failed to read build info file: %r" +msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" + +#: builders/html/__init__.py:372 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "indeks" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "dalej" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "wstecz" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "" + +#: builders/html/__init__.py:783 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "kopiowanie plików do pobrania..." + +#: builders/html/__init__.py:807 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:853 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:871 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "" + +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:923 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy static file %r" +msgstr "nie można skopiować pliku statycznego %r" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:938 #, python-format +msgid "cannot copy extra file %r" +msgstr "nie można skopiować dodatkowego pliku %r" + +#: builders/html/__init__.py:944 +#, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "Wystąpił błąd podczas renderowania strony %s.\nPowód: %r" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "" +msgid "invalid js_file: %r, ignored" +msgstr "nieprawidłowy js_file: %r, zignorowano" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." +msgstr "Podano nieznany math_renderer %r." + +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "błąd podczas formatowania argumentów dla %s: %s" +msgid "favicon file %r does not exist" +msgstr "plik favicon %r nie istnieje" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s - dokumentacja" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" +msgstr "" + +#: builders/latex/transforms.py:487 +#, python-format +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Pliki LaTeX znajdują się w %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "nie znaleziono wartości konfiguracyjnej \"latex_documents\"; żadne dokumenty nie zostaną zapisane" + +#: builders/latex/__init__.py:167 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "wartość konfiguracyjna \"latex_documents\" odwołuje się do nieznanego dokumentu %s" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:537 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Bases: %s" -msgstr "Klasy bazowe: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" -msgstr "brakujący atrybut %s w obiekcie %s" +msgid "image file not readable: %s" +msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "zobacz %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "zobacz także %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/pt/LC_MESSAGES/sphinx.mo b/sphinx/locale/pt/LC_MESSAGES/sphinx.mo index 63175f20804..eff76c3bf65 100644 Binary files a/sphinx/locale/pt/LC_MESSAGES/sphinx.mo and b/sphinx/locale/pt/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/pt/LC_MESSAGES/sphinx.po b/sphinx/locale/pt/LC_MESSAGES/sphinx.po index c421a0891c2..09a4f6e58dc 100644 --- a/sphinx/locale/pt/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/pt/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Portuguese (http://app.transifex.com/sphinx-doc/sphinx-1/language/pt/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: pt\n" "Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2805,21 +2946,20 @@ msgstr[0] "" msgstr[1] "" msgstr[2] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2828,6 +2968,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2849,119 +2994,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2973,92 +3125,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3086,581 +3231,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3668,548 +3721,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo b/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo index f7e1f2be597..8ae151d497c 100644 Binary files a/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo and b/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po b/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po index 061a6dae11e..0972d5e0047 100644 --- a/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 18:26+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Rafael Fontenelle , 2019-2025\n" "Language-Team: Portuguese (Brazil) (http://app.transifex.com/sphinx-doc/sphinx-1/language/pt_BR/)\n" @@ -24,6 +24,127 @@ msgstr "" "Language: pt_BR\n" "Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "Common Vulnerabilities and Exposures; CVE %s" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "número de CVE inválido %s" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "Common Weakness Enumeration; CWE %s" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "número de CWE inválido %s" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Propostas de Melhorias do Python; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "Número de PEP inválido %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "Número de RFC inválido %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "As seções de configuração de tema diferentes de [theme] e [options] não são suportadas (tentei obter um valor de %r)." + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "a configuração %s.%s ocorre em nenhuma das configurações de tema pesquisadas" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "sem suporte à opção de tema %r fornecida" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "o arquivo %r no caminho de tema não é um arquivo zip válido ou contém nenhum tema" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "nenhum tema chamado %r encontrado (faltando theme.toml?)" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "O tema %r tem uma hierarquia circular" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "O tema %r herda de %r, que não é um tema carregado. Temas carregados são: %s" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "O tema %r tem muitos ancestrais" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "nenhum arquivo de configuração de tema encontrado em %r" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "o tema %r não tem a tabela “theme”" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "A tabela \"[theme]\" do tema %r não é uma tabela" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "O tema %r deve definir a configuração \"theme.inherit\"." + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "A tabela \"[options]\" do tema %r não é uma tabela" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "A configuração \"theme.pygments_style\" deve ser uma tabela. Dica: \"%s\"" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "vários arquivos encontrados para o documento \"%s\": %s\nUse %r para a construção." + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "Ignorado documento ilegível %r." + #: extension.py:58 #, python-format msgid "" @@ -38,127 +159,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Este projeto precisa da extensão %s pelo menos na versão %s e, portanto, não pode ser construído com a versão carregada (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Nome de analisador léxico Pygments %r não é conhecido" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "Lexar literal_block %r como \"%s\" resultou em um erro no token: %r. Tentando novamente no modo relaxado." + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Evento %r já presente" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Nome de evento desconhecido: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "O manipulador %r para evento %r levantou uma exceção" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Não foi possível encontrar o diretório de origem (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "O diretório de saída (%s) não é um diretório" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Diretório de origem e o diretório de destino não podem ser idênticos" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Executando Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser construído com esta versão." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "criando o diretório de saída" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "enquanto definia a extensão %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "“setup”, conforme definido atualmente em conf.py, não é um invocável do Python. Modifique sua definição para torná-la uma função que pode ser chamada. Isso é necessário para o conf.py se comportar como uma extensão do Sphinx." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "carregando traduções [%s]… " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "feito" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "não disponível para mensagens internas" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "carregando ambiente com pickle" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "falha: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Nenhum construtor selecionado, usando padrão: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "construção finalizada com problemas." -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "construção bem-sucedida." -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "construção finalizada com problemas, 1 aviso. (com avisos tratados como erros)." -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "construção finalizada com problemas, 1 aviso." -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "construção bem-sucedida, 1 aviso." -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "construção finalizada com problemas, %s avisos. (com avisos tratados como erros)." -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "construção finalizada com problemas, %s avisos." -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "construção bem-sucedida, %s avisos." -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "classe de nodo %r já está registrada, seus visitantes serão sobrescritos" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "diretiva %r já está registrada e não será substituída" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "papel %r já está registrado e não será substituído" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -166,12 +314,12 @@ msgid "" "explicit" msgstr "a extensão %s não declara se é segura para leitura em paralelo, supondo que não seja – peça ao autor da extensão para verificar e torná-la explícita" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "a extensão %s não é segura para leitura em paralelo" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -179,82 +327,214 @@ msgid "" "explicit" msgstr "a extensão %s não declara se é segura para escrita em paralelo, supondo que não seja – peça ao autor da extensão para verificar e torná-la explícita" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "a extensão %s não é segura para escrita em paralelo" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "fazendo serial %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "o diretório de configuração não contém um arquivo conf.py (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Classe de construtor %s possui nenhum atributo “name”" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Construtor %r já existe (no módulo %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Nome do construtor %s não registrado ou disponível através do ponto de entrada" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Nome do construtor %s não registrado" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "domínio %s já registrado" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "domínio %s ainda não registrado" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "A diretiva %r já está registrada para o domínio %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "O papel %r já está registrado para o domínio %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "O índice %r já está registrado para o domínio %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "O object_type %r já está registrado" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "O crossref_type %r já está registrado" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r já está registrado" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser para %r já está registrado" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Analisador de fonte para %s não registrado" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "Tradutor para %r já existe" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "kwargs para add_node() deve ser uma tupla de função (visit, depart): %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r já registrado" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "renderizador matemático %s já está registrado" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "Valor de configuração inválido encontrado: 'language = None'. Atualize sua configuração para um código de idioma válido. Voltando para 'en' (inglês)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "a extensão %r já foi mesclada com Sphinx desde a versão %s; esta extensão é ignorada." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Extensão original:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Não foi possível importar a extensão %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "a extensão %r possui nenhuma função setup(); é realmente um módulo de extensão do Sphinx?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "A extensão %s usada por este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser construída com esta versão." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "a extensão %r retornou um objeto não suportado de sua função setup(); deve retornar None ou um dicionário de metadados" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "`None` não é um tipo de arquivo válido para %r." + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "o diretório de configuração não contém um arquivo conf.py (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "'%s' deve ser '0' ou '1', obteve '%s'" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "não foi possível sobrescrever a configuração do dicionário %r ignorando (use %r para definir elementos individuais)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "número inválido %r para valor de configuração %r, ignorando" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "não é possível sobrescrever a configuração %r com tipo sem suporte, ignorando" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "valor de configuração desconhecido %r na sobrescrita, ignorando" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "Valor de configuração inexistente: %r" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Valor da configuração %r já presente" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "não é possível armazenar em cache o valor de configuração não serializável com pickle: %r (porque contém uma função, classe ou objeto de módulo)" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "Valor de configuração inválido encontrado: 'language = None'. Atualize sua configuração para um código de idioma válido. Voltando para 'en' (inglês)." + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Há um erro de sintaxe em seu arquivo de configuração: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "O arquivo de configuração (ou um dos módulos que ele importa) chamou sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -262,537 +542,722 @@ msgid "" "%s" msgstr "Há um erro de programável em seu arquivo de configuração:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "Falha ao converter %r em um frozenset" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "Convertendo `source_suffix = %r` para `source_suffix = %r`." -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "O valor de configuração `source_suffix' espera um dicionário, uma string ou uma lista de strings. Em vez disso, obteve \"%r\" (digite %s)." -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Seção %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Fig. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabela %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Listagem %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "O valor da configuração “{name}” deve ser um entre {candidates}, mas “{current}” é fornecido." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "O valor da configuração “{name}” possui tipo “{current.__name__}”; esperava {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "O valor da configuração “{name}” possui tipo “{current.__name__}”; o padrão é “{default.__name__}”." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r não encontrado, ignorado." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "Sphinx agora usa \"index\" como o documento mestre por padrão. Para manter o comportamento pré-2.0, defina \"master_doc = 'contents'\"." -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Nome de analisador léxico Pygments %r não é conhecido" - -#: highlighting.py:209 -#, python-format +#: config.py:892 msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "Lexar literal_block %r como \"%s\" resultou em um erro no token: %r. Tentando novamente no modo relaxado." +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "O suporte para codificações fonte diferentes de UTF-8 está descontinuado e será removido no Sphinx 10. Comente em https://github.com/sphinx-doc/sphinx/issues/13665 se isso causar algum problema." -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "As seções de configuração de tema diferentes de [theme] e [options] não são suportadas (tentei obter um valor de %r)." +#: environment/__init__.py:89 +msgid "new config" +msgstr "nova configuração" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "a configuração %s.%s ocorre em nenhuma das configurações de tema pesquisadas" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "configuração alterada" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "sem suporte à opção de tema %r fornecida" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "extensões alteradas" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "o arquivo %r no caminho de tema não é um arquivo zip válido ou contém nenhum tema" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "a versão do ambiente de construção não é a atual" -#: theming.py:228 +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "diretório de fontes foi alterado" + +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "nenhum tema chamado %r encontrado (faltando theme.toml?)" +msgid "The configuration has changed (1 option: %r)" +msgstr "A configuração foi alterada (1 opção: %r)" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" -msgstr "O tema %r tem uma hierarquia circular" +msgid "The configuration has changed (%d options: %s)" +msgstr "A configuração foi alterada (%d opções: %s)" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "A configuração foi alterada (%d opções: %s, ...)" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "O tema %r herda de %r, que não é um tema carregado. Temas carregados são: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Este ambiente é incompatível com o construtor selecionado, por favor escolha outro diretório de doctree." -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "O tema %r tem muitos ancestrais" +msgid "Failed to scan documents in %s: %r" +msgstr "Falha ao procurar documentos em %s: %r" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" -msgstr "nenhum arquivo de configuração de tema encontrado em %r" +msgid "Domain %r is not registered" +msgstr "O domínio %r ainda não está registrado" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "o tema %r não tem a tabela “theme”" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "o documento não está incluído em nenhum toctree" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "A tabela \"[theme]\" do tema %r não é uma tabela" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "toctree autorreferenciada encontrada. Ignorado." -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "O tema %r deve definir a configuração \"theme.inherit\"." +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgstr "o documento é referenciado em vários toctrees: %s, selecionando: %s <- %s" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "A tabela \"[options]\" do tema %r não é uma tabela" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Atenção" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "A configuração \"theme.pygments_style\" deve ser uma tabela. Dica: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Cuidado" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Evento %r já presente" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Perigo" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Nome de evento desconhecido: %s" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Erro" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "O manipulador %r para evento %r levantou uma exceção" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Dica" -#: project.py:72 +#: locale/__init__.py:234 +msgid "Important" +msgstr "Importante" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Nota" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Ver também" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Dica" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Aviso" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Os arquivos Texinfo estão em %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "vários arquivos encontrados para o documento \"%s\": %s\nUse %r para a construção." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nExecute \"make\" nesse diretório para executá-los com makeinfo\n(use \"make info\" aqui para fazer isso automaticamente)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "Ignorado documento ilegível %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "nenhuma valor de configuração “texinfo_documents” encontrado; nenhum documento será escrito" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Classe de construtor %s possui nenhum atributo “name”" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "o valor da configuração “texinfo_documents” faz referência a documento desconhecido %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Construtor %r já existe (no módulo %s)" +msgid "processing %s" +msgstr "processando %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Nome do construtor %s não registrado ou disponível através do ponto de entrada" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "escrevendo" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Nome do construtor %s não registrado" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "resolvendo referências…" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "domínio %s já registrado" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (em " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "domínio %s ainda não registrado" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "copiando imagens… " -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "A diretiva %r já está registrada para o domínio %s" +msgid "cannot copy image file %r: %s" +msgstr "não foi possível copiar arquivo de imagem %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "O papel %r já está registrado para o domínio %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "copiando arquivos de suporte Texinfo" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "O índice %r já está registrado para o domínio %s" +msgid "error writing file Makefile: %s" +msgstr "erro ao escrever o arquivo Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "O object_type %r já está registrado" +msgid "The manual pages are in %(outdir)s." +msgstr "As páginas de manual estão em %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "O crossref_type %r já está registrado" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "nenhum valor de configuração “man_pages” encontrado; nenhuma página de manual será escrita" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r já está registrado" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "o valor da configuração “man_pages” faz referência a um documento desconhecido %s" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser para %r já está registrado" +msgid "The HTML page is in %(outdir)s." +msgstr "A página HTML está em %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "Analisador de fonte para %s não registrado" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "montando documento único" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "Tradutor para %r já existe" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "escrevendo arquivos adicionais" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "kwargs para add_node() deve ser uma tupla de função (visit, depart): %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "O construtor fictício não gera arquivos." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r já registrado" +msgid "The message catalogs are in %(outdir)s." +msgstr "Os catálogos de mensagens estão em %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "renderizador matemático %s já está registrado" +msgid "building [%s]: " +msgstr "construindo [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "a extensão %r já foi mesclada com Sphinx desde a versão %s; esta extensão é ignorada." +msgid "targets for %d template files" +msgstr "alvos para os %d arquivos de modelo" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Extensão original:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "lendo modelos… " -#: registry.py:545 +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "escrevendo catálogos de mensagens… " + +#: builders/linkcheck.py:87 #, python-format -msgid "Could not import extension %s" -msgstr "Não foi possível importar a extensão %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Procure por quaisquer erros na saída acima ou em %(outdir)s/output.txt" -#: registry.py:552 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "a extensão %r possui nenhuma função setup(); é realmente um módulo de extensão do Sphinx?" +msgid "broken link: %s (%s)" +msgstr "link quebrado: %s (%s)" -#: registry.py:565 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "A extensão %s usada por este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser construída com esta versão." +msgid "Anchor '%s' not found" +msgstr "Âncora “%s” não encontrada" -#: registry.py:577 +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "linkcheck_allowed_redirects. Esperava um dicionário." + +#: builders/linkcheck.py:799 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "a extensão %r retornou um objeto não suportado de sua função setup(); deve retornar None ou um dicionário de metadados" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "Falha ao compilar regex em linkcheck_allowed_redirects: %r %s" -#: registry.py:612 +#: builders/epub3.py:83 #, python-format -msgid "`None` is not a valid filetype for %r." -msgstr "`None` não é um tipo de arquivo válido para %r." +msgid "The ePub file is in %(outdir)s." +msgstr "O arquivo ePub está em %(outdir)s." + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "escrevendo o arquivo nav.xhtml..." + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "o valor da configuração “epub_language” (ou “language”) não deve estar vazio para EPUB3" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "o valor da configuração “epub_uid” deve ser XML NAME para EPUB3" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "o valor da configuração “epub_title” (ou “html_title”) não deve estar vazio para EPUB3" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "o valor da configuração “epub_author” não deve estar vazio para EPUB3" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "o valor da configuração “epub_contributor” não deve estar vazio para EPUB3" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "o valor da configuração “epub_description” não deve estar vazio para EPUB3" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "o valor da configuração “epub_publisher” não deve estar vazio para EPUB3" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "o valor da configuração “epub_copyright” (ou “copyright”) não deve estar vazio para EPUB3" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "o valor da configuração “epub_identifier” não deve estar vazio para EPUB3" -#: roles.py:206 +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "o valor da configuração “version” não deve estar vazio para EPUB3" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "Common Vulnerabilities and Exposures; CVE %s" +msgid "invalid css_file: %r, ignored" +msgstr "css_file inválido: %r, ignorado" -#: roles.py:229 +#: builders/xml.py:29 #, python-format -msgid "invalid CVE number %s" -msgstr "número de CVE inválido %s" +msgid "The XML files are in %(outdir)s." +msgstr "Os arquivos XML estão em %(outdir)s." -#: roles.py:251 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "Common Weakness Enumeration; CWE %s" +msgid "error writing file %s: %s" +msgstr "erro ao escrever o arquivo %s: %s" -#: roles.py:274 +#: builders/xml.py:103 #, python-format -msgid "invalid CWE number %s" -msgstr "número de CWE inválido %s" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Os arquivos pseudo-XML estão em %(outdir)s." -#: roles.py:294 +#: builders/_epub_base.py:223 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Propostas de Melhorias do Python; PEP %s" +msgid "duplicated ToC entry found: %s" +msgstr "entrada de tabela de conteúdos duplicada encontrada: %s" -#: roles.py:317 +#: builders/_epub_base.py:436 #, python-format -msgid "invalid PEP number %s" -msgstr "Número de PEP inválido %s" +msgid "cannot read image file %r: copying it instead" +msgstr "não foi possível ler o arquivo de imagem %r: copiando-o" -#: roles.py:355 +#: builders/_epub_base.py:467 #, python-format -msgid "invalid RFC number %s" -msgstr "Número de RFC inválido %s" +msgid "cannot write image file %r: %s" +msgstr "não foi possível escrever arquivo de imagem %r: %s" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[código-fonte]" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow não encontrado – copiando arquivos de imagem" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "realçando código de módulo… " +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "escrevendo o arquivo mimetype..." -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[documentos]" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "escrevendo o arquivo META-INF/container.xml..." -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Código do módulo" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "escrevendo o arquivo content.opf..." -#: ext/viewcode.py:353 +#: builders/_epub_base.py:594 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        Código-fonte para %s

        " - -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Visão geral: código do módulo" +msgid "unknown mimetype for %s, ignoring" +msgstr "tipo mime desconhecido para %s, ignorando" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Todos os módulos onde este código está disponível

        " +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "o nodo tem um nível inválido" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "O link codificado %r pode ser substituído por um extlink (tente usar %r)" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "escrevendo o arquivo toc.ncx..." -#: ext/autosectionlabel.py:52 +#: builders/_epub_base.py:802 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "a seção \"%s\" fica rotulada como \"%s\"" +msgid "writing %s file..." +msgstr "escrevendo arquivo %s…" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/text.py:27 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "rótulo duplicada %s, outra instância em %s" - -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "Link para esta equação" - -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "=================== durações de leitura mais lentas ====================" +msgid "The text files are in %(outdir)s." +msgstr "Os arquivos texto estão em %(outdir)s." -#: ext/doctest.py:118 +#: builders/__init__.py:229 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "faltando “+” ou “-” na opção “%s”." +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "uma imagem adequada para o construtor %s não encontrada: %s (%s)" -#: ext/doctest.py:124 +#: builders/__init__.py:237 #, python-format -msgid "'%s' is not a valid option." -msgstr "“%s” não é uma opção válida." +msgid "a suitable image for %s builder not found: %s" +msgstr "uma imagem adequada para o construtor %s não encontrada: %s" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "“%s” não é uma opção de pyversion válida" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "construindo [mo]: " -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "Tipo de TestCode inválido" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "escrevendo saída… " -#: ext/doctest.py:297 +#: builders/__init__.py:280 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Teste de doctests nos fontes finalizada, confira os resultados em %(outdir)s/output.txt." +msgid "all of %d po files" +msgstr "todos os %d arquivos po" -#: ext/doctest.py:457 +#: builders/__init__.py:302 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "nenhum código/saída no bloco %s em %s:%s" +msgid "targets for %d po files that are specified" +msgstr "alvos para %d arquivos po que estão especificados" -#: ext/doctest.py:568 +#: builders/__init__.py:314 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "ignorando código de doctest inválido: %r" +msgid "targets for %d po files that are out of date" +msgstr "alvos para %d arquivos po que estão desatualizados" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "todos os arquivos-fonte" -#: ext/imgmath.py:162 +#: builders/__init__.py:335 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "o comando LaTeX %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_latex" +msgid "file %r given on command line does not exist, " +msgstr "arquivo %r fornecido na linha de comando não existe," -#: ext/imgmath.py:181 +#: builders/__init__.py:342 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "o comando %s %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_%s" +"file %r given on command line is not under the source directory, ignoring" +msgstr "o arquivo %r fornecido na linha de comando não está dentro do diretório fonte, ignorando" -#: ext/imgmath.py:344 +#: builders/__init__.py:353 #, python-format -msgid "display latex %r: %s" -msgstr "exibe latex %r: %s" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "o arquivo %r fornecido na linha de comando não é um documento válido, ignorando" -#: ext/imgmath.py:380 +#: builders/__init__.py:366 #, python-format -msgid "inline latex %r: %s" -msgstr "latex em linha %r: %s" +msgid "%d source files given on command line" +msgstr "%d arquivos-fonte dados na linha de comando" -#: ext/coverage.py:48 +#: builders/__init__.py:382 #, python-format -msgid "invalid regex %r in %s" -msgstr "regex inválida %r em %s" +msgid "targets for %d source files that are out of date" +msgstr "alvos para %d arquivos fonte que estão desatualizados" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" -msgstr "o módulo %s não pôde ser importado: %s" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "procurando por arquivos agora desatualizados… " -#: ext/coverage.py:148 +#: builders/__init__.py:415 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "os seguintes módulos estão documentados, mas não foram especificados em coverage_modules: %s" +msgid "%d found" +msgstr "%d encontrado" -#: ext/coverage.py:158 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" -msgstr "os seguintes módulos estão especificados em coverage_modules, mas não foram documentados" +#: builders/__init__.py:417 +msgid "none found" +msgstr "nenhum encontrado" -#: ext/coverage.py:172 -#, python-brace-format, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." -msgstr "Teste de cobertura nos fontes finalizada, confira os resultados em %(outdir)s{sep}python.txt." +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "tornando um ambiente pickle" -#: ext/coverage.py:187 -#, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "regex inválida %r em coverage_c_regexes" +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "verificando consistência" -#: ext/coverage.py:260 -#, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "api c não documentada: %s [%s] no arquivo %s" +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "nenhum alvo está desatualizado." -#: ext/coverage.py:452 -#, python-format -msgid "undocumented python function: %s :: %s" -msgstr "função python não documentada: %s :: %s" +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "atualizando ambiente: " -#: ext/coverage.py:473 +#: builders/__init__.py:499 #, python-format -msgid "undocumented python class: %s :: %s" -msgstr "classe python não documentada: %s :: %s" +msgid "%s added, %s changed, %s removed" +msgstr "%s adicionado(s), %s alterado(s), %s removido(s)" -#: ext/coverage.py:492 +#: builders/__init__.py:536 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "método python não documentado: %s :: %s :: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "O Sphinx não consegue carregar o documento mestre (%s) porque ele corresponde a um padrão de exclusão embutido %r. Mova seu documento mestre para um local diferente." -#: ext/imgconverter.py:44 +#: builders/__init__.py:545 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "Não é possível executar o comando de conversão de imagem %r. 'sphinx.ext.imgconverter' requer ImageMagick por padrão. Verifique se ele está instalado ou defina a opção 'image_converter' para um comando de conversão personalizado.\n\nRastreamento: %s" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "O Sphinx não consegue carregar o documento mestre (%s) porque ele corresponde a um padrão de exclusão especificado no conf.py, %r. Remova este padrão do conf.py." -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: builders/__init__.py:556 #, python-format msgid "" -"convert exited with error:\n" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "O Sphinx não consegue carregar o documento mestre (%s) porque ele não está incluído no include_patterns = %r personalizado. Certifique-se de que um padrão em include_patterns corresponda ao documento mestre." + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "O Sphinx não consegue carregar o documento mestre (%s). O documento mestre deve estar no diretório fonte ou em um subdiretório dele." + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "lendo fontes… " + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "docnames para escrever: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "nenhum docname para escrever!" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "preparando documentos" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "copiando ativos" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "O arquivo de visão geral está em %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "nenhuma alteração na versão %s." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "escrevendo arquivo de resumo…" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Internos" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Nível do Módulo" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "copiando arquivos-fonte…" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "não foi possível ler %r para criação do changelog" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "regex inválida %r em %s" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "o módulo %s não pôde ser importado: %s" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "os seguintes módulos estão documentados, mas não foram especificados em coverage_modules: %s" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "os seguintes módulos estão especificados em coverage_modules, mas não foram documentados: %s" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "Teste de cobertura nos fontes finalizada, confira os resultados em %(outdir)s{sep}python.txt." + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "regex inválida %r em coverage_c_regexes" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "api c não documentada: %s [%s] no arquivo %s" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "função python não documentada: %s :: %s" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "classe python não documentada: %s :: %s" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "método python não documentado: %s :: %s :: %s" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "O link codificado %r pode ser substituído por um extlink (tente usar %r)" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Por fazer" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "Entrada de “TODO” encontrada: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(A <> está localizada na %s, linha %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "entrada original" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "Não é possível executar o comando de conversão de imagem %r. 'sphinx.ext.imgconverter' requer ImageMagick por padrão. Verifique se ele está instalado ou defina a opção 'image_converter' para um comando de conversão personalizado.\n\nRastreamento: %s" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" @@ -868,879 +1333,960 @@ msgstr "[gráfico: %s]" msgid "[graph]" msgstr "[gráfico]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Por fazer" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "o comando LaTeX %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_latex" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" -msgstr "Entrada de “TODO” encontrada: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "o comando %s %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_%s" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "exibe latex %r: %s" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(A <> está localizada na %s, linha %d.)" +msgid "inline latex %r: %s" +msgstr "latex em linha %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "entrada original" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "Link para esta equação" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "espaços não em branco eliminados por dedent" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "faltando “+” ou “-” na opção “%s”." -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" -msgstr "Legenda inválida: %s" +msgid "'%s' is not a valid option." +msgstr "“%s” não é uma opção válida." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "especificação de número de linha está fora da faixa(1-%d): %r" +msgid "'%s' is not a valid pyversion option" +msgstr "“%s” não é uma opção de pyversion válida" -#: directives/code.py:216 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "Tipo de TestCode inválido" + +#: ext/doctest.py:297 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Não é possível usar as opções “%s” e “%s” juntas" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Teste de doctests nos fontes finalizada, confira os resultados em %(outdir)s/output.txt." -#: directives/code.py:231 +#: ext/doctest.py:451 #, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "Arquivo incluído '%s' não encontrado ou sua leitura falhou" +msgid "no code/output in %s block at %s:%s" +msgstr "nenhum código/saída no bloco %s em %s:%s" -#: directives/code.py:235 +#: ext/doctest.py:568 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "A codificação %r usada para ler o arquivo incluído '%s' parece estar errada, tente passar uma opção :encoding:" +msgid "ignoring invalid doctest code: %r" +msgstr "ignorando código de doctest inválido: %r" -#: directives/code.py:276 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "O objeto chamado %r não foi encontrado no arquivo incluído %r" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "a seção \"%s\" fica rotulada como \"%s\"" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "Não é possível usar “lineo-match” com um conjunto separado de “lines”" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "rótulo duplicada %s, outra instância em %s" -#: directives/code.py:314 +#: ext/duration.py:47 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Especificação de linha %r: nenhuma linha obtida do arquivo incluído %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "A duração da leitura %.3fs excedeu a duração limite %.3fs" -#: directives/patches.py:71 +#: ext/duration.py:117 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "A opção \":file:\" para a diretiva csv-table agora reconhece um caminho absoluto como um caminho relativo do diretório de fontes. Por favor, atualize seu documento." +"====================== total reading duration ==========================" +msgstr "====================== duração total da leitura ==========================" -#: directives/other.py:119 +#: ext/duration.py:124 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "o padrão de glob do toctree %r não correspondeu a nenhum documento." +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "Tempo total da leitura de %d arquivo%s: %dm %.3fs" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "toctree contém referência ao documento excluído %r" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "=================== durações de leitura mais lentas ====================" -#: directives/other.py:156 +#: ext/duration.py:139 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "toctree contém referência ao documento inexistente %r" +msgid "%.3fs %s" +msgstr "%.3fs %s" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "entrada duplicada encontrada no toctree: %s" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[código-fonte]" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autor da seção: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "realçando código de módulo… " -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autor do módulo: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[documentos]" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autor do código: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Código do módulo" -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor: " +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Código-fonte para %s

        " -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr ".. conteúdo acks não está na lista" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Visão geral: código do módulo" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr ".. conteúdo hlist não está na lista" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Todos os módulos onde este código está disponível

        " -#: builders/changes.py:29 +#: domains/citation.py:75 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "O arquivo de visão geral está em %(outdir)s." +msgid "duplicate citation %s, other instance in %s" +msgstr "citação duplicada %s, outra instância em %s" -#: builders/changes.py:56 +#: domains/citation.py:92 #, python-format -msgid "no changes in version %s." -msgstr "nenhuma alteração na versão %s." - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "escrevendo arquivo de resumo…" - -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Internos" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "Nível do Módulo" - -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "copiando arquivos-fonte…" +msgid "Citation [%s] is not referenced." +msgstr "citação [%s] não é referenciada." -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" -msgstr "não foi possível ler %r para criação do changelog" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "rótulo duplicado da equação %s, outra instância em %s" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "As páginas de manual estão em %(outdir)s." +msgid "Invalid math_eqref_format: %r" +msgstr "math_eqref_format inválido: %r" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "nenhum valor de configuração “man_pages” encontrado; nenhuma página de manual será escrita" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (função interna)" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "escrevendo" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (método %s)" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "o valor da configuração “man_pages” faz referência a um documento desconhecido %s" +msgid "%s() (class)" +msgstr "%s() (classe)" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "uma imagem adequada para o construtor %s não encontrada: %s (%s)" +msgid "%s (global variable or constant)" +msgstr "%s (variável global ou constante)" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "uma imagem adequada para o construtor %s não encontrada: %s" +msgid "%s (%s attribute)" +msgstr "%s (atributo %s)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "construindo [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumentos" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "escrevendo saída… " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Lança" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" -msgstr "todos os %d arquivos po" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Retorna" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" -msgstr "alvos para %d arquivos po que estão especificados" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Tipo de retorno" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "alvos para %d arquivos po que estão desatualizados" +msgid "%s (module)" +msgstr "%s (módulo)" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "todos os arquivos-fonte" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "função" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " -msgstr "arquivo %r fornecido na linha de comando não existe," +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "método" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "o arquivo %r fornecido na linha de comando não está dentro do diretório fonte, ignorando" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "classe" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "o arquivo %r fornecido na linha de comando não é um documento válido, ignorando" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "dado" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "%d arquivos-fonte dados na linha de comando" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atributo" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "alvos para %d arquivos fonte que estão desatualizados" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "módulo" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " -msgstr "construindo [%s]: " - -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "procurando por arquivos agora desatualizados… " +msgid "duplicate %s description of %s, other %s in %s" +msgstr "descrição duplicada de %s de %s, outro %s em %s" -#: builders/__init__.py:410 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "%d found" -msgstr "%d encontrado" +msgid "%s (directive)" +msgstr "%s (diretiva)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "nenhum encontrado" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr ":%s: (opção diretiva)" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "tornando um ambiente pickle" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (papel)" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "verificando consistência" +#: domains/rst.py:234 +msgid "directive" +msgstr "diretiva" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "nenhum alvo está desatualizado." +#: domains/rst.py:235 +msgid "directive-option" +msgstr "opção diretiva" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "atualizando ambiente: " +#: domains/rst.py:236 +msgid "role" +msgstr "papel" -#: builders/__init__.py:494 +#: domains/rst.py:262 #, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s adicionado(s), %s alterado(s), %s removido(s)" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "descrição duplicada de %s %s, outra instância em %s" -#: builders/__init__.py:531 +#: domains/changeset.py:32 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "O Sphinx não consegue carregar o documento mestre (%s) porque ele corresponde a um padrão de exclusão embutido %r. Mova seu documento mestre para um local diferente." +msgid "Added in version %s" +msgstr "Adicionado na versão %s" -#: builders/__init__.py:540 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "O Sphinx não consegue carregar o documento mestre (%s) porque ele corresponde a um padrão de exclusão especificado no conf.py, %r. Remova este padrão do conf.py." +msgid "Changed in version %s" +msgstr "Alterado na versão %s" -#: builders/__init__.py:551 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "O Sphinx não consegue carregar o documento mestre (%s) porque ele não está incluído no include_patterns = %r personalizado. Certifique-se de que um padrão em include_patterns corresponda ao documento mestre." +msgid "Deprecated since version %s" +msgstr "Descontinuado desde a versão %s" -#: builders/__init__.py:558 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "O Sphinx não consegue carregar o documento mestre (%s). O documento mestre deve estar no diretório fonte ou em um subdiretório dele." - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "lendo fontes… " +msgid "Removed in version %s" +msgstr "Removido na versão %s" -#: builders/__init__.py:713 +#: domains/__init__.py:322 #, python-format -msgid "docnames to write: %s" -msgstr "docnames para escrever: %s" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "nenhum docname para escrever!" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "número de tarefas deve ser um número positivo" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "preparando documentos" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "Para mais informações, visite ." -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "copiando ativos" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nGera documentação de arquivos fonte.\n\nsphinx-build gera documentação a partir dos arquivos em SOURCEDIR e os coloca\nem OUTPUTDIR. Ele procura por \"conf.py\" em SOURCEDIR para a configuração\ndefinições. A ferramenta \"sphinx-quickstart\" pode ser usada para gerar\narquivos de modelo, incluindo \"conf.py\"\n\nsphinx-build pode criar documentação em diferentes formatos. Um formato é\nselecionado especificando o nome do construtor na linha de comandos; o padrão\né HTML. Os construtores também podem realizar outras tarefas relacionadas à\ndocumentação em processamento.\n\nPor padrão, tudo o que está desatualizado é construído. Saída apenas para\nselecionado os arquivos podem ser construídas especificando nomes de arquivos\nindividuais.\n" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "caracteres de origem não codificáveis, substituindo por “?”: %r" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "caminho para os arquivos-fonte da documentação" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "O arquivo ePub está em %(outdir)s." +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "caminho para o diretório de saída" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "escrevendo o arquivo nav.xhtml..." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "(opcional) uma lista de arquivos específicos para reconstruir. Ignorado se --write-all for especificado" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "o valor da configuração “epub_language” (ou “language”) não deve estar vazio para EPUB3" +#: cmd/build.py:114 +msgid "general options" +msgstr "opções gerais" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "o valor da configuração “epub_uid” deve ser XML NAME para EPUB3" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "construtor para usar (padrão: 'html')" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "o valor da configuração “epub_title” (ou “html_title”) não deve estar vazio para EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "executa em paralelo com N processos, quando possível. 'auto' usa o número de núcleos da CPU" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "o valor da configuração “epub_author” não deve estar vazio para EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "escrever todos os arquivos (padrão: escrever apenas arquivos novos e alterados)" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "o valor da configuração “epub_contributor” não deve estar vazio para EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "não usa um ambiente salvo, sempre lê todos os arquivos" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "o valor da configuração “epub_description” não deve estar vazio para EPUB3" +#: cmd/build.py:150 +msgid "path options" +msgstr "opções de caminho" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "o valor da configuração “epub_publisher” não deve estar vazio para EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "diretório para arquivos de doctree e de ambiente (padrão: OUTPUT_DIR/.doctrees)" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "o valor da configuração “epub_copyright” (ou “copyright”) não deve estar vazio para EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "diretório para o arquivo de configuração (conf.py) (padrão: SOURCE_DIR)" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "o valor da configuração “epub_identifier” não deve estar vazio para EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "usa nenhum arquivo de configuração, apenas usa configurações das opções -D" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "o valor da configuração “version” não deve estar vazio para EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "sobrescreve a configuração no arquivo de configuração" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "css_file inválido: %r, ignorado" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "passa um valor para modelos em HTML" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Os arquivos XML estão em %(outdir)s." +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "define tag: inclui blocos “only” com TAG" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "erro ao escrever o arquivo %s: %s" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "modo exigente: avisa sobre todas as referências em falta" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Os arquivos pseudo-XML estão em %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" +msgstr "opções de saída do console" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Os arquivos Texinfo estão em %(outdir)s." +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "aumenta o nível de detalhamento (pode ser repetido)" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nExecute \"make\" nesse diretório para executá-los com makeinfo\n(use \"make info\" aqui para fazer isso automaticamente)." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "nenhuma saída para stdout, apenas avisos na stderr" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "nenhuma valor de configuração “texinfo_documents” encontrado; nenhum documento será escrito" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "nenhuma saída, nem mesmo avisos" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "o valor da configuração “texinfo_documents” faz referência a documento desconhecido %s" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "emite saída colorida (padrão: detectar automaticamente)" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "processando %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "não emite saída colorida (padrão: detectar automaticamente)" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "resolvendo referências…" +#: cmd/build.py:252 +msgid "warning control options" +msgstr "opções de controle de aviso" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (em " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "escreve avisos (e erros) para o arquivo fornecido" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "copiando imagens… " +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "transforma avisos em erros" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "não foi possível copiar arquivo de imagem %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "mostra rastro completo quando ocorrer exceção" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "copiando arquivos de suporte Texinfo" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "executa Pdb quando ocorrer exceção" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "erro ao escrever o arquivo Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "levanta uma exceção quando ocorrerem avisos" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "entrada de tabela de conteúdos duplicada encontrada: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "não é possível combinar a opção -a e nomes de arquivos" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "não foi possível ler o arquivo de imagem %r: copiando-o" +msgid "cannot open warning file '%s': %s" +msgstr "não foi possível abrir o arquivo de aviso '%s': %s" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "não foi possível escrever arquivo de imagem %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "o argumento da opção -D deve estar no formato nome=valor" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Pillow não encontrado – copiando arquivos de imagem" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "o argumento da opção -A deve estar no formato nome=valor" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "escrevendo o arquivo mimetype..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "insere docstrings automaticamente a partir de módulos" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "escrevendo o arquivo META-INF/container.xml..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "testa trechos de código automaticamente em blocos de doctest" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "escrevendo o arquivo content.opf..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "cria link entre documentação Sphinx de diferentes projetos" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "tipo mime desconhecido para %s, ignorando" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "escreve entradas “todo” que podem ser mostradas ou ocultadas na construção" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "o nodo tem um nível inválido" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "verifica por cobertura da documentação" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "escrevendo o arquivo toc.ncx..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "inclui matemática, renderizada como imagens PNG ou SVG" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "escrevendo arquivo %s…" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "inclui matemática, renderizada no navegador por MathJax" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "O construtor fictício não gera arquivos." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "inclusão condicional de conteúdo com base nos valores de configuração" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Os catálogos de mensagens estão em %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "inclui links para o código-fonte dos objetos Python documentados" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "alvos para os %d arquivos de modelo" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "cria um arquivo .nojekyll para publicar o documento em páginas do GitHub" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "lendo modelos… " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Insira um nome de caminho válido." -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "escrevendo catálogos de mensagens… " +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Insira algum texto." -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "A página HTML está em %(outdir)s." +msgid "Please enter one of %s." +msgstr "Insira um entre %s." -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "montando documento único" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Insira “y” ou “n”." -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "escrevendo arquivos adicionais" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Insira um sufixo de arquivo, p.ex., “.rst” ou “.txt”." -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Procure por quaisquer erros na saída acima ou em %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Bem-vindo ao utilitário de início rápido do Sphinx %s." -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "link quebrado: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Digite valores para as seguintes configurações (basta pressionar Enter\npara aceitar um valor padrão, se houver um entre colchetes)." -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" -msgstr "Âncora “%s” não encontrada" +msgid "Selected root path: %s" +msgstr "Caminho raiz selecionado: %s" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "Falha ao compilar regex em linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Insira o caminho raiz para a documentação." -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Os arquivos texto estão em %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Caminho raiz para a documentação" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "referências de nota de rodapé inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Erro: um conf.py existente foi encontrado no caminho raiz selecionado." -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "referências inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart não vai sobrescrever projetos Sphinx existentes." -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "referências de citação inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Insira um novo caminho raiz (ou pressione Enter para sair)" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "referências de termo inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "não foi possível calcular o progresso da tradução!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Você tem duas opções para definir o diretório de construção para a saída\nSphinx. Você pode usar um diretório \"_build\" no caminho raiz ou separar\nos diretórios de \"origem\" e \"construção\" no caminho raiz." -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "nenhum elemento traduzido!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Separar os diretórios de origem e de construção (y/n)" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "Um índice de 4 colunas encontrado. Pode ser um erro de extensões que você usa: %r" - -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "Nota de rodapé [%s] não é referenciada." - -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "Nota de rodapé [*] não é referenciada." +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "Dentro do diretório raiz, mais dois diretórios serão criados; \"_templates\"\npara modelos HTML personalizados e \"_static\" para folhas de estilo (CSS)\npersonalizadas e outros arquivos estáticos. Você pode inserir outro prefixo\n(como \".\") para substituir o sublinhado." -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "Nota de rodapé [#] não é referenciada." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Prefixo do nome para o diretório de modelos e de arquivos estáticos" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "Uso:" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "O nome do projeto vai aparecer em vários lugares na documentação construída." -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "{0} [OPÇÕES] []" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Nome do projeto" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr " O gerador de documentação Sphinx." +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Nome(s) de autor(es)" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "Comandos:" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "O Sphinx tem a noção de uma \"versão\" e um \"lançamento\" para o software.\nCada versão pode ter vários lançamentos. Por exemplo, para Python a\nversão é algo como 2.5 ou 3.0, enquanto o lançamento é algo como 2.5.1\nou 3.0a1. Se você não precisa dessa estrutura dupla, apenas defina ambos\ncom o mesmo valor." -#: _cli/__init__.py:98 -msgid "Options" -msgstr "Opções" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Versão do projeto" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "Para mais informações, visite https://www.sphinx-doc.org/pt-br/master/man/." +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Lançamento do projeto" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "{0}: erro: {1}\nExecute '{0} --help' para informações" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr " Gerencia documentação com Sphinx" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "Se os documentos forem escritos em um idioma diferente do inglês, você\npode selecionar um idioma aqui pelo seu código de idioma. O Sphinx,\nentão, traduzirá o texto gerado para esse idioma.\n\nPara obter uma lista dos códigos suportados, consulte\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "Mostra a versão e sai." +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Idioma do projeto" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "Mostra esta mensagem e sai" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "O sufixo do nome de arquivo para arquivos fonte. Normalmente, isso é\n\".txt\" ou \".rst\". Apenas arquivos com este sufixo são considerados\ndocumentos." -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "Logging" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Sufixo de arquivos-fonte" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "Aumenta a verbosidade (pode ser repetido)" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "Um documento é especial por ser considerado o nó superior da \"árvore de\nconteúdo\", ou seja, é a raiz da estrutura hierárquica dos documentos.\nNormalmente, isso é \"index\", mas se o documento \"index\" for um modelo\npersonalizado, você também poderá configurá-lo para outro nome de arquivo." -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "Só imprime erros e avisos." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Nome do seu documento mestre (sem sufixo)" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "Nenhuma saída" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Erro: o arquivo mestre %s já foi encontrado no caminho raiz selecionado." -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart não vai sobrescrever o arquivo existente." -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "Veja 'sphinx --help'.\n" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Insira um novo nome de arquivo, ou renomeie o arquivo existente e pressione Enter" -#: environment/__init__.py:86 -msgid "new config" -msgstr "nova configuração" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Indique qual das seguintes extensões do Sphinx devem ser habilitadas:" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "configuração alterada" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Nota: imgmath e mathjax não podem ser habilitados ao mesmo tempo. imgmath foi desmarcado." -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "extensões alteradas" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Um Makefile e um arquivo de comando do Windows podem ser gerados para você,\npara que você só precise executar, p.ex., \"make html\" em vez de invocar o\nsphinx-build diretamente." -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "a versão do ambiente de construção não é a atual" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Criar um Makefile? (y/n)" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "diretório de fontes foi alterado" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Criar um arquivo de comando do Windows? (y/n)" -#: environment/__init__.py:325 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "A configuração foi alterada (1 opção: %r)" +msgid "Creating file %s." +msgstr "Criando o arquivo %s." -#: environment/__init__.py:330 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "A configuração foi alterada (%d opções: %s)" +msgid "File %s already exists, skipping." +msgstr "O arquivo %s já existe, ignorando." -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "A configuração foi alterada (%d opções: %s, ...)" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Finalizado: uma estrutura de diretório inicial foi criada." -#: environment/__init__.py:379 +#: cmd/quickstart.py:520 +#, python-format msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "Este ambiente é incompatível com o construtor selecionado, por favor escolha outro diretório de doctree." +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Agora você deve preencher seu arquivo mestre %s e criar outros arquivos-fonte\nda documentação. " -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "Falha ao procurar documentos em %s: %r" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Use o Makefile para construir os documentos, assim:\n make construtor" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 +#: cmd/quickstart.py:531 #, python-format -msgid "Domain %r is not registered" -msgstr "O domínio %r ainda não está registrado" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "o documento não está incluído em nenhum toctree" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Use o comando sphinx-build para construir os documentos, assim:\n sphinx-build -b construtor %s %s" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "toctree autorreferenciada encontrada. Ignorado." +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "sendo “construtor” um dos construtores aceitos, p.ex., html, latex ou linkcheck." -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "o documento é referenciado em vários toctrees: %s, selecionando: %s <- %s" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nGera os arquivos necessários para um projeto Sphinx.\n\nO sphinx-quickstart é uma ferramenta interativa que faz algumas perguntas\nsobre o seu projeto e gera um diretório de documentação completo e um\nMakefile de amostra para ser usado com o sphinx-build.\n" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "erro de leitura: %s, %s" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "modo silencioso" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "erro de escrita: %s, %s" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "raiz do projeto" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "locale_dir %s não existe" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Opção Estrutura" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "Localidade de Babel inválida: %r." +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "se especificado, separa diretórios de fonte e de construção" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Formato de data inválido. Envolva a string com aspas simples se desejar emiti-la diretamente: %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "se especificado, cria o dir de construção sob o dir fonte" -#: util/docfields.py:103 +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "substituto para ponto em _templates etc." + +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Opções básicas do projeto" + +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "nome do projeto" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "nomes de autores" + +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "versão do projeto" + +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "lançamento do projeto" + +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "idioma dos documentos" + +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "sufixo de arquivos-fonte" + +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "nome do documento mestre" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "usa epub" + +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Opções extensão" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "habilita a extensão %s" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "habilita extensões arbitrárias" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Criação de Makefile e arquivo Batch" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "cria makefile" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "não cria makefile" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "cria arquivo batch" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "não cria arquivo batch" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "usa modo make para Makefile/make.bat" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Modelo de projeto" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "diretório para arquivos de modelos" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "define uma variável modelo" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "“quiet” está especificada, mas “project” ou “author” não foi." + +#: cmd/quickstart.py:786 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "Problema no domínio %s: o campo deveria usar o papel \"%s\", mas esse papel não está no domínio." +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Erro: o caminho especificado não é um diretório, ou arquivos sphinx já existem." -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "%r foi descontinuado para entradas de índice (da entrada %r). Use \"pair: %s\"." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart só gera em um diretório vazio. Especifique um novo caminho raiz." -#: util/nodes.py:490 +#: cmd/quickstart.py:810 #, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "toctree contém referência ao arquivo inexistente %r" +msgid "Invalid template variable: %s" +msgstr "Variável de modelo inválida: %s" -#: util/nodes.py:706 +#: directives/other.py:119 #, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "exceção ao avaliar apenas a expressão da diretiva: %s" - -#: util/display.py:82 -msgid "skipped" -msgstr "ignorado" - -#: util/display.py:87 -msgid "failed" -msgstr "falhou" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "o padrão de glob do toctree %r não correspondeu a nenhum documento." -#: util/osutil.py:131 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "Cancelada a tentativa de cópia de %s para %s (o caminho de destino possui dados existentes)." +msgid "toctree contains reference to excluded document %r" +msgstr "toctree contém referência ao documento excluído %r" -#: util/docutils.py:309 +#: directives/other.py:156 #, python-format -msgid "unknown directive name: %s" -msgstr "nome de diretiva desconhecido: %s" +msgid "toctree contains reference to nonexisting document %r" +msgstr "toctree contém referência ao documento inexistente %r" -#: util/docutils.py:345 +#: directives/other.py:169 #, python-format -msgid "unknown role name: %s" -msgstr "nome de papel desconhecido: %s" +msgid "duplicated entry found in toctree: %s" +msgstr "entrada duplicada encontrada no toctree: %s" + +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autor da seção: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autor do módulo: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autor do código: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr ".. conteúdo acks não está na lista" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr ".. conteúdo hlist não está na lista" + +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "A opção \":file:\" para a diretiva csv-table agora reconhece um caminho absoluto como um caminho relativo do diretório de fontes. Por favor, atualize seu documento." + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "espaços não em branco eliminados por dedent" -#: util/docutils.py:789 +#: directives/code.py:87 #, python-format -msgid "unknown node type: %r" -msgstr "tipo de nó desconhecido: %r" +msgid "Invalid caption: %s" +msgstr "Legenda inválida: %s" -#: util/fileutil.py:76 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "Cancelada a tentativa de cópia do modelo renderizado %s para %s (o caminho de destino possui dados existentes)." +msgid "line number spec is out of range(1-%d): %r" +msgstr "especificação de número de linha está fora da faixa(1-%d): %r" -#: util/fileutil.py:89 +#: directives/code.py:216 #, python-format -msgid "Writing evaluated template result to %s" -msgstr "Escrevendo resultado do modelo avaliado para %s" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Não é possível usar as opções “%s” e “%s” juntas" -#: util/rst.py:73 +#: directives/code.py:231 #, python-format -msgid "default role %s not found" -msgstr "papel padrão %s não encontrado" +msgid "Include file '%s' not found or reading it failed" +msgstr "Arquivo incluído '%s' não encontrado ou sua leitura falhou" -#: util/inventory.py:147 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "inventário <%s> contém definições duplicadas de %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "A codificação %r usada para ler o arquivo incluído '%s' parece estar errada, tente passar uma opção :encoding:" -#: util/inventory.py:166 +#: directives/code.py:276 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "inventário <%s> contém várias definições para %s" +msgid "Object named %r not found in include file %r" +msgstr "O objeto chamado %r não foi encontrado no arquivo incluído %r" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Notas de rodapé" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "Não é possível usar “lineo-match” com um conjunto separado de “lines”" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" -msgstr "[imagem: %s]" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Especificação de linha %r: nenhuma linha obtida do arquivo incluído %r" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[imagem]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d %b %Y" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1749,11 +2295,15 @@ msgstr "[imagem]" msgid "Index" msgstr "Índice" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "nó de título encontrado não na section, topic, table, admonition ou sidebar" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Notas de rodapé" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "legenda não dentro de uma imagem." @@ -1763,59 +2313,20 @@ msgstr "legenda não dentro de uma imagem." msgid "unimplemented node type: %r" msgstr "tipo de nó não implementado: %r" -#: writers/latex.py:361 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "toplevel_sectioning %r desconhecido para a classe %r" +msgid "[image: %s]" +msgstr "[imagem: %s]" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "nenhuma opção Babel conhecida para o idioma %r" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[imagem]" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr ":maxdepth: grande demais, ignorado." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "Link para esta definição" -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "modelo %s não encontrado; carregando do legado %s em vez disso" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "título do documento não é um nó único em Text" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "nível de cabeçalho de rubric não suportado: %s" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "tabularcolumns e opção :widths: foram fornecidas. :widths: foi ignorada." - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "a unidade de dimensão %s é inválida. Ignorada." - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "tipo desconhecido de entrada de índice %s encontrado" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "math_eqref_format inválido: %r" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "Link para esta definição" - -#: writers/html5.py:431 +#: writers/html5.py:431 #, python-format msgid "numfig_format is not defined for %s" msgstr "numfig_format não está definido para %s" @@ -1837,6 +2348,11 @@ msgstr "Link para este cabeçalho" msgid "Link to this table" msgstr "Link para esta tabela" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "nível de cabeçalho de rubric não suportado: %s" + #: writers/html5.py:636 msgid "Link to this code" msgstr "Link para este código" @@ -1853,794 +2369,478 @@ msgstr "Link para este toctree" msgid "Could not obtain image size. :scale: option is ignored." msgstr "Não foi possível obter o tamanho da imagem. A opção :scale: foi ignorada." -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "toplevel_sectioning %r desconhecido para a classe %r" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "rótulo duplicado da equação %s, outra instância em %s" +msgid "no Babel option known for language %r" +msgstr "nenhuma opção Babel conhecida para o idioma %r" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (função interna)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":maxdepth: grande demais, ignorado." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (método %s)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "modelo %s não encontrado; carregando do legado %s em vez disso" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "título do documento não é um nó único em Text" + +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "tabularcolumns e opção :widths: foram fornecidas. :widths: foi ignorada." -#: domains/javascript.py:185 +#: writers/latex.py:1228 #, python-format -msgid "%s() (class)" -msgstr "%s() (classe)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "Foi fornecido o colspec %s, que parece usar sintaxe tabular. Mas esta tabela não pode ser renderizada como uma tabela; o colspec fornecido será ignorado." -#: domains/javascript.py:187 +#: writers/latex.py:1615 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s (variável global ou constante)" +msgid "dimension unit %s is invalid. Ignored." +msgstr "a unidade de dimensão %s é inválida. Ignorada." -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1950 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (atributo %s)" +msgid "unknown index entry type %s found" +msgstr "tipo desconhecido de entrada de índice %s encontrado" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumentos" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "Uso:" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Lança" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "{0} [OPÇÕES] []" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Retorna" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr " O gerador de documentação Sphinx." -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Tipo de retorno" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "Comandos:" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (módulo)" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "Opções" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "função" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "Para mais informações, visite https://www.sphinx-doc.org/pt-br/master/man/." -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "método" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "{0}: erro: {1}\nExecute '{0} --help' para informações" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "classe" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr " Gerencia documentação com Sphinx" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "dado" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "Mostra a versão e sai." -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atributo" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "Mostra esta mensagem e sai" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "módulo" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "Logging" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "descrição duplicada de %s de %s, outro %s em %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "Aumenta a verbosidade (pode ser repetido)" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "Adicionado na versão %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "Só imprime erros e avisos." -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Alterado na versão %s" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "Nenhuma saída" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Descontinuado desde a versão %s" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "Removido na versão %s" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "Veja 'sphinx --help'.\n" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (diretiva)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "referências de nota de rodapé inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" -#: domains/rst.py:191 domains/rst.py:202 +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "referências inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" + +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "referências de citação inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" + +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "referências de termo inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "não foi possível calcular o progresso da tradução!" + +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "nenhum elemento traduzido!" + +#: transforms/__init__.py:258 #, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (opção diretiva)" +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "Um índice de 4 colunas encontrado. Pode ser um erro de extensões que você usa: %r" -#: domains/rst.py:224 +#: transforms/__init__.py:299 #, python-format -msgid "%s (role)" -msgstr "%s (papel)" +msgid "Footnote [%s] is not referenced." +msgstr "Nota de rodapé [%s] não é referenciada." -#: domains/rst.py:234 -msgid "directive" -msgstr "diretiva" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "Nota de rodapé [*] não é referenciada." -#: domains/rst.py:235 -msgid "directive-option" -msgstr "opção diretiva" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "Nota de rodapé [#] não é referenciada." -#: domains/rst.py:236 -msgid "role" -msgstr "papel" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "inventário <%s> contém definições duplicadas de %s" -#: domains/rst.py:262 +#: util/inventory.py:166 #, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "descrição duplicada de %s %s, outra instância em %s" +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "inventário <%s> contém várias definições para %s" -#: domains/citation.py:75 +#: util/i18n.py:100 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "citação duplicada %s, outra instância em %s" +msgid "reading error: %s, %s" +msgstr "erro de leitura: %s, %s" -#: domains/citation.py:92 +#: util/i18n.py:113 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "citação [%s] não é referenciada." +msgid "writing error: %s, %s" +msgstr "erro de escrita: %s, %s" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Atenção" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "locale_dir %s não existe" -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Cuidado" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "Localidade de Babel inválida: %r." -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Perigo" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Erro" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Dica" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Importante" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Nota" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Ver também" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Dica" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Aviso" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "insere docstrings automaticamente a partir de módulos" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "testa trechos de código automaticamente em blocos de doctest" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "cria link entre documentação Sphinx de diferentes projetos" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "escreve entradas “todo” que podem ser mostradas ou ocultadas na construção" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "verifica por cobertura da documentação" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "inclui matemática, renderizada como imagens PNG ou SVG" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "inclui matemática, renderizada no navegador por MathJax" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "inclusão condicional de conteúdo com base nos valores de configuração" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "inclui links para o código-fonte dos objetos Python documentados" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "cria um arquivo .nojekyll para publicar o documento em páginas do GitHub" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Insira um nome de caminho válido." - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Insira algum texto." - -#: cmd/quickstart.py:133 +#: util/i18n.py:253 #, python-format -msgid "Please enter one of %s." -msgstr "Insira um entre %s." - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Insira “y” ou “n”." - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Insira um sufixo de arquivo, p.ex., “.rst” ou “.txt”." - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Bem-vindo ao utilitário de início rápido do Sphinx %s." - -#: cmd/quickstart.py:234 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Digite valores para as seguintes configurações (basta pressionar Enter\npara aceitar um valor padrão, se houver um entre colchetes)." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Formato de data inválido. Envolva a string com aspas simples se desejar emiti-la diretamente: %s" -#: cmd/quickstart.py:241 +#: util/osutil.py:131 #, python-format -msgid "Selected root path: %s" -msgstr "Caminho raiz selecionado: %s" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "Insira o caminho raiz para a documentação." - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Caminho raiz para a documentação" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Erro: um conf.py existente foi encontrado no caminho raiz selecionado." - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart não vai sobrescrever projetos Sphinx existentes." - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Insira um novo caminho raiz (ou pressione Enter para sair)" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Você tem duas opções para definir o diretório de construção para a saída\nSphinx. Você pode usar um diretório \"_build\" no caminho raiz ou separar\nos diretórios de \"origem\" e \"construção\" no caminho raiz." - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Separar os diretórios de origem e de construção (y/n)" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "Dentro do diretório raiz, mais dois diretórios serão criados; \"_templates\"\npara modelos HTML personalizados e \"_static\" para folhas de estilo (CSS)\npersonalizadas e outros arquivos estáticos. Você pode inserir outro prefixo\n(como \".\") para substituir o sublinhado." - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Prefixo do nome para o diretório de modelos e de arquivos estáticos" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "O nome do projeto vai aparecer em vários lugares na documentação construída." - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Nome do projeto" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Nome(s) de autor(es)" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "O Sphinx tem a noção de uma \"versão\" e um \"lançamento\" para o software.\nCada versão pode ter vários lançamentos. Por exemplo, para Python a\nversão é algo como 2.5 ou 3.0, enquanto o lançamento é algo como 2.5.1\nou 3.0a1. Se você não precisa dessa estrutura dupla, apenas defina ambos\ncom o mesmo valor." - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Versão do projeto" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Lançamento do projeto" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "Se os documentos forem escritos em um idioma diferente do inglês, você\npode selecionar um idioma aqui pelo seu código de idioma. O Sphinx,\nentão, traduzirá o texto gerado para esse idioma.\n\nPara obter uma lista dos códigos suportados, consulte\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Idioma do projeto" - -#: cmd/quickstart.py:339 msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "O sufixo do nome de arquivo para arquivos fonte. Normalmente, isso é\n\".txt\" ou \".rst\". Apenas arquivos com este sufixo são considerados\ndocumentos." - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Sufixo de arquivos-fonte" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "Cancelada a tentativa de cópia de %s para %s (o caminho de destino possui dados existentes)." -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "Um documento é especial por ser considerado o nó superior da \"árvore de\nconteúdo\", ou seja, é a raiz da estrutura hierárquica dos documentos.\nNormalmente, isso é \"index\", mas se o documento \"index\" for um modelo\npersonalizado, você também poderá configurá-lo para outro nome de arquivo." +#: util/display.py:82 +msgid "skipped" +msgstr "ignorado" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Nome do seu documento mestre (sem sufixo)" +#: util/display.py:87 +msgid "failed" +msgstr "falhou" -#: cmd/quickstart.py:367 +#: util/docutils.py:325 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Erro: o arquivo mestre %s já foi encontrado no caminho raiz selecionado." - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart não vai sobrescrever o arquivo existente." - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Insira um novo nome de arquivo, ou renomeie o arquivo existente e pressione Enter" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Indique qual das seguintes extensões do Sphinx devem ser habilitadas:" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Nota: imgmath e mathjax não podem ser habilitados ao mesmo tempo. imgmath foi desmarcado." - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Um Makefile e um arquivo de comando do Windows podem ser gerados para você,\npara que você só precise executar, p.ex., \"make html\" em vez de invocar o\nsphinx-build diretamente." - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Criar um Makefile? (y/n)" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Criar um arquivo de comando do Windows? (y/n)" +msgid "unknown directive name: %s" +msgstr "nome de diretiva desconhecido: %s" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: util/docutils.py:361 #, python-format -msgid "Creating file %s." -msgstr "Criando o arquivo %s." +msgid "unknown role name: %s" +msgstr "nome de papel desconhecido: %s" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: util/docutils.py:805 #, python-format -msgid "File %s already exists, skipping." -msgstr "O arquivo %s já existe, ignorando." - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Finalizado: uma estrutura de diretório inicial foi criada." +msgid "unknown node type: %r" +msgstr "tipo de nó desconhecido: %r" -#: cmd/quickstart.py:519 +#: util/fileutil.py:76 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "Agora você deve preencher seu arquivo mestre %s e criar outros arquivos-fonte\nda documentação. " - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Use o Makefile para construir os documentos, assim:\n make construtor" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "Cancelada a tentativa de cópia do modelo renderizado %s para %s (o caminho de destino possui dados existentes)." -#: cmd/quickstart.py:530 +#: util/fileutil.py:89 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Use o comando sphinx-build para construir os documentos, assim:\n sphinx-build -b construtor %s %s" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "sendo “construtor” um dos construtores aceitos, p.ex., html, latex ou linkcheck." - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nGera os arquivos necessários para um projeto Sphinx.\n\nO sphinx-quickstart é uma ferramenta interativa que faz algumas perguntas\nsobre o seu projeto e gera um diretório de documentação completo e um\nMakefile de amostra para ser usado com o sphinx-build.\n" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "Para mais informações, visite ." - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "modo silencioso" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "raiz do projeto" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Opção Estrutura" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "se especificado, separa diretórios de fonte e de construção" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "se especificado, cria o dir de construção sob o dir fonte" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "substituto para ponto em _templates etc." - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Opções básicas do projeto" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "nome do projeto" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "nomes de autores" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "versão do projeto" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "lançamento do projeto" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "idioma dos documentos" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "sufixo de arquivos-fonte" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "nome do documento mestre" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "usa epub" - -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Opções extensão" +msgid "Writing evaluated template result to %s" +msgstr "Escrevendo resultado do modelo avaliado para %s" -#: cmd/quickstart.py:670 +#: util/docfields.py:103 #, python-format -msgid "enable %s extension" -msgstr "habilita a extensão %s" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "habilita extensões arbitrárias" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Criação de Makefile e arquivo Batch" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "cria makefile" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "não cria makefile" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "cria arquivo batch" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "não cria arquivo batch" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "usa modo make para Makefile/make.bat" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Modelo de projeto" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "diretório para arquivos de modelos" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "define uma variável modelo" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "“quiet” está especificada, mas “project” ou “author” não foi." - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Erro: o caminho especificado não é um diretório, ou arquivos sphinx já existem." - -#: cmd/quickstart.py:792 msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart só gera em um diretório vazio. Especifique um novo caminho raiz." +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "Problema no domínio %s: o campo deveria usar o papel \"%s\", mas esse papel não está no domínio." -#: cmd/quickstart.py:809 +#: util/rst.py:73 #, python-format -msgid "Invalid template variable: %s" -msgstr "Variável de modelo inválida: %s" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "número de tarefas deve ser um número positivo" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\nGera documentação de arquivos fonte.\n\nsphinx-build gera documentação a partir dos arquivos em SOURCEDIR e os coloca\nem OUTPUTDIR. Ele procura por \"conf.py\" em SOURCEDIR para a configuração\ndefinições. A ferramenta \"sphinx-quickstart\" pode ser usada para gerar\narquivos de modelo, incluindo \"conf.py\"\n\nsphinx-build pode criar documentação em diferentes formatos. Um formato é\nselecionado especificando o nome do construtor na linha de comandos; o padrão\né HTML. Os construtores também podem realizar outras tarefas relacionadas à\ndocumentação em processamento.\n\nPor padrão, tudo o que está desatualizado é construído. Saída apenas para\nselecionado os arquivos podem ser construídas especificando nomes de arquivos\nindividuais.\n" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "caminho para os arquivos-fonte da documentação" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "caminho para o diretório de saída" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "(opcional) uma lista de arquivos específicos para reconstruir. Ignorado se --write-all for especificado" - -#: cmd/build.py:114 -msgid "general options" -msgstr "opções gerais" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "construtor para usar (padrão: 'html')" +msgid "default role %s not found" +msgstr "papel padrão %s não encontrado" -#: cmd/build.py:131 +#: util/nodes.py:462 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "executa em paralelo com N processos, quando possível. 'auto' usa o número de núcleos da CPU" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "%r não é mais suportsdo para entradas de índice (da entrada %r). Use \"pair: %s\"." -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "escrever todos os arquivos (padrão: escrever apenas arquivos novos e alterados)" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "não usa um ambiente salvo, sempre lê todos os arquivos" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "toctree contém referência ao arquivo inexistente %r" -#: cmd/build.py:150 -msgid "path options" -msgstr "opções de caminho" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "exceção ao avaliar apenas a expressão da diretiva: %s" -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "diretório para arquivos de doctree e de ambiente (padrão: OUTPUT_DIR/.doctrees)" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "continuação da página anterior" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "diretório para o arquivo de configuração (conf.py) (padrão: SOURCE_DIR)" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "continua na próxima página" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "usa nenhum arquivo de configuração, apenas usa configurações das opções -D" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "Não alfabético" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "sobrescreve a configuração no arquivo de configuração" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Símbolos" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "passa um valor para modelos em HTML" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Números" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "define tag: inclui blocos “only” com TAG" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "página" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "modo exigente: avisa sobre todas as referências em falta" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Release" -#: cmd/build.py:212 -msgid "console output options" -msgstr "opções de saída do console" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "Não foi possível obter imagem remota: %s [%s]" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "aumenta o nível de detalhamento (pode ser repetido)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "Não foi possível obter imagem remota: %s [%d]" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "nenhuma saída para stdout, apenas avisos na stderr" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Formato de imagem desconhecido: %s…" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "nenhuma saída, nem mesmo avisos" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "Não foi possível determinar o texto reserva para a referência cruzada. Pode ser um bug." -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "emite saída colorida (padrão: detectar automaticamente)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "mais de um alvo localizado para “any” referência cruzada %r: poderia ser %s" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "não emite saída colorida (padrão: detectar automaticamente)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:alvo de referência %s não encontrado: %s" -#: cmd/build.py:252 -msgid "warning control options" -msgstr "opções de controle de aviso" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "alvo de referência %r não encontrado: %s" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "escreve avisos (e erros) para o arquivo fornecido" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "Interrompido!" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "transforma avisos em erros" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "Erro de marcação reStructuredText!" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "mostra rastro completo quando ocorrer exceção" +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "Erro de codificação!" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "executa Pdb quando ocorrer exceção" +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "Erro de recursão!" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "levanta uma exceção quando ocorrerem avisos" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "Isso pode acontecer com arquivos fonte muito grandes ou profundamente aninhados. Você pode aumentar cuidadosamente o limite de recursão padrão do Python de 1.000 em conf.py com, por exemplo:" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "não é possível combinar a opção -a e nomes de arquivos" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "Iniciando depurador:" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" -msgstr "não foi possível abrir o arquivo de aviso '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "O traceback completo foi salvo em:" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "o argumento da opção -D deve estar no formato nome=valor" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "Para relatar este erro aos desenvolvedores, por favor abra uma issue em . Obrigado!" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "o argumento da opção -A deve estar no formato nome=valor" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Por favor, relate isso também se houver um erro do usuário, para que uma mensagem de erro melhor possa ser fornecida na próxima vez." #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Recolher painel lateral" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Tabela de Conteúdo" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navegação" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Pesquisar dentro de %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Sobre esses documentos" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Buscar" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Ir" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Última atualização em %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Criada usando Sphinx %(sphinx_version)s." + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Tópico anterior" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "capítulo anterior" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Próximo tópico" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "próximo capítulo" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "Índice – %(key)s" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Índice completo em página única" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Essa Página" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Exibir Fonte" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Conteúdos" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Busca rápida" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Buscar em %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Ir" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2668,109 +2868,50 @@ msgstr "Tabela Completa dos Conteúdos" #: themes/basic/defindex.html:17 msgid "lists all sections and subsections" -msgstr "Listar todas seções e subseções" - -#: domains/std/__init__.py:773 domains/std/__init__.py:786 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "Página de Busca" - -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "Buscar nessa documentação" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "Índice Global de Módulos" - -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "acesso rápido para todos os módulos" - -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Índice Geral" - -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "todas funções, classes, termos" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Essa Página" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "Índice – %(key)s" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Índice completo em página única" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Busca rápida" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Páginas de índice por letra" - -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "pode ser enorme" - -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Tópico anterior" +msgstr "Listar todas seções e subseções" -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "capítulo anterior" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "Página de Busca" -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Próximo tópico" +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "Buscar nessa documentação" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "próximo capítulo" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "Índice Global de Módulos" -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navegação" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "acesso rápido para todos os módulos" -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Pesquisar dentro de %(docstitle)s" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Índice Geral" -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Sobre esses documentos" +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "todas funções, classes, termos" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Tabela de Conteúdo" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "© %(copyright_prefix)s %(copyright)s." +msgid "Search %(docstitle)s" +msgstr "Buscar em %(docstitle)s" -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Última atualização em %(last_updated)s." +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Páginas de índice por letra" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Criada usando Sphinx %(sphinx_version)s." +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "pode ser enorme" #: themes/basic/search.html:20 msgid "" @@ -2788,21 +2929,21 @@ msgstr "Pesquisando por várias palavras só mostra correspondências\nque cont msgid "search" msgstr "buscar" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Esconder Resultados da Busca" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Conteúdos" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Resultados da Busca" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Sua busca não encontrou nenhum documento. Por favor, confirme se todas as palavras estão grafadas corretamente e se você selecionou categorias suficientes." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2811,22 +2952,21 @@ msgstr[0] "Pesquisa concluída, encontrada uma página que correspondendo à con msgstr[1] "Pesquisa finalizada, encontradas ${resultCount} páginas correspondendo à consulta da pesquisa." msgstr[2] "Pesquisa finalizada, encontradas ${resultCount} páginas correspondendo à consulta da pesquisa." -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Buscando" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Preparando a busca..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", em " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Esconder Resultados da Busca" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2834,6 +2974,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Modificações na versão %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2855,120 +3000,127 @@ msgstr "Outras alterações" msgid "Expand sidebar" msgstr "Expandir painel lateral" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "Separador de parâmetros somente-posicionais (PEP 570)" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "Separador de parâmetros somente-nomeados (PEP 3102)" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parâmetros" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variáveis" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Levanta" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (no módulo %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (no módulo %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (variável interna)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (classe interna)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (classe em %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (método de classe %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (método estático %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (propriedade %s )" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "%s (apelido de tipo em %s)" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Índice de Módulos Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "módulos" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Descontinuado" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "exceção" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "método de classe" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "método estático" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "propriedade" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "apelido de tipo" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "descrição duplicada de objeto de %s, outra instância em %s, use :no-index: para um deles" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "mais de um alvo localizado para referência cruzada %r: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (descontinuado)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parâmetros" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variáveis" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Levanta" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "Declaração C++ duplicada, também definida em %s:%s.\nA declaração é '.. cpp:%s:: %s'." #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2979,92 +3131,85 @@ msgstr "Parâmetros do Modelo" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "Declaração C++ duplicada, também definida em %s:%s.\nA declaração é '.. cpp:%s:: %s'." - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "Valores de retorno" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "união" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "membro" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tipo" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "conceito" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerador" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "parâmetro de função" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "parâmetro de modelo" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Declaração C duplicada, também definida em %s:%s.\nA declaração é '.. c:%s:: %s'." -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "variável" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "macro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "struct" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "variável de ambiente; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "%s; valor de configuração" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "Type" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "Default" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3159,514 +3304,422 @@ msgstr "rótulo não definido: %r" msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "Falha ao criar uma referência cruzada. Título ou legenda não encontrado: %r" -#: environment/adapters/toctree.py:324 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "referências circulares à toctree detectadas, ignorando: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "toctree contém referência ao documento %r que não possui título: nenhum link será gerado" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "toctree contém referência ao documento não incluído %r" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "toctree contém referência a documento inexistente %r" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "veja %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "veja também %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "tipo desconhecido de entrada de índice %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Símbolos" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "arquivo de imagem não legível: %s" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "arquivo de imagem %s não legível: %s" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "arquivo de download não legível: %s" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s já tem números de seção atribuídos (toctree numerada aninhada?)" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "Interrompido!" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "Erro de marcação reStructuredText!" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "Erro de codificação!" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "Erro de recursão!" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "Isso pode acontecer com arquivos fonte muito grandes ou profundamente aninhados. Você pode aumentar cuidadosamente o limite de recursão padrão do Python de 1.000 em conf.py com, por exemplo:" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "Iniciando depurador:" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "O traceback completo foi salvo em:" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "Para relatar este erro aos desenvolvedores, por favor abra uma issue em . Obrigado!" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Por favor, relate isso também se houver um erro do usuário, para que uma mensagem de erro melhor possa ser fornecida na próxima vez." - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "Não foi possível determinar o texto reserva para a referência cruzada. Pode ser um bug." - -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "mais de um alvo localizado para “any” referência cruzada %r: poderia ser %s" - -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:alvo de referência %s não encontrado: %s" - -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "alvo de referência %r não encontrado: %s" - -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "Não foi possível obter imagem remota: %s [%s]" - -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "Não foi possível obter imagem remota: %s [%d]" +msgid "invalid value set (missing closing brace): %s" +msgstr "valor inválido definido (faltando chave de fechamento): %s" -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." -msgstr "Formato de imagem desconhecido: %s…" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" +msgstr "valor inválido definido (faltando chave de abertura): %s" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "As páginas HTML estão em %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" +msgstr "string literal malformada (faltando aspas de fechamento): %s" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" -msgstr "Falha ao ler o arquivo de informações de construção: %r" +msgid "malformed string literal (missing opening quote): %s" +msgstr "string literal malformada (faltando aspas de abertura): %s" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "build_info incompatível, copiando .buildinfo para .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Exemplo" -#: builders/html/__init__.py:366 -msgid "building [html]: " -msgstr "construindo [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Exemplos" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "o modelo %s foi alterado desde a construção anterior, todos os documentos serão reconstruídos" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Argumentos de Palavras-chave" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "índice" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Notas" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "Logo de %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Outros Parâmetros" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "próximo" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "Recebe" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "anterior" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Referências" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "gerando índices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Avisos" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "escrevendo páginas adicionais" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "Yields" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "não foi possível copiar arquivo de imagem '%s': %s" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "copiando arquivos baixáveis… " +msgid "A mocked object is detected: %r" +msgstr "Um objeto simulado foi detectado: %r" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "não foi possível copiar o arquivo baixável %r: %s" +msgid "alias of %s" +msgstr "apelido de %s" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "Falha ao copiar um arquivo no diretório \"static\" do tema: %s: %r" +msgid "Bases: %s" +msgstr "Base: %s" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "Falha ao copiar um arquivo em html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" +msgstr "valor inválido para a opção member-order: %s" -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "copiando arquivos estáticos" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "valor inválido para a opção class-doc-from: %s" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" -msgstr "não foi possível copiar o arquivo estático %r" +msgid "invalid signature for auto%s (%r)" +msgstr "assinatura inválida para auto%s (%r)" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "copiando arquivos extras" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "não sei qual módulo importar para documentação automática %r (tente colocar uma diretiva “module” ou “currentmodule” no documento ou forneça um nome explícito para o módulo)" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" -msgstr "não foi possível copiar o arquivo extra %r" +msgid "signature arguments given for automodule: '%s'" +msgstr "argumentos de assinatura dados para automodule: '%s'" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" -msgstr "Falha ao escrever o arquivo de informações de construção: %r" +msgid "return annotation given for automodule: '%s'" +msgstr "anotação de retorno dada para automodule: '%s'" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "não foi possível carregar o índice de pesquisa, mas nem todos os documentos serão construídos: o índice ficará incompleto." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "“::” no nome de automodule não faz sentido" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "a página %s corresponde a dois padrões em html_sidebars: %r e %r" +msgid "Failed to remove %s: %s" +msgstr "Falha ao remover %s: %s" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "Criaria o arquivo %s." + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "ocorreu um erro Unicode ao renderizar a página %s. Verifique se todos os valores de configuração que contêm conteúdo não ASCII são strings Unicode." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nProcura recursivamente em módulos e pacotes Python e cria um\narquivo reST com diretivas automodule por pacote no .\n\nOs s podem ser padrões de arquivo e/ou diretório que serão\nexcluídos da geração.\n\nNota: Por padrão, este script não substituirá os arquivos já criados." -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "caminho para o módulo a ser documentado" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "Ocorreu um erro ao renderizar a página %s.\nMotivo: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "padrões de diretório e/ou arquivo no estilo fnmatch para excluir da geração" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "despejando inventário de objetos" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "diretório para colocar toda a saída" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "despejando índice de pesquisa em %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "profundidade máxima de submódulos para mostrar no TOC (padrão: 4)" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "js_file inválido: %r, ignorado" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "sobrescreve arquivos existentes" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "Muitos math_renders estão registrados, mas nenhum math_renderer está selecionado." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "segue links simbólicos. Poderoso quando combinado com collective.recipe.omelette." -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "math_renderer desconhecido %r é fornecido." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "escreve o script sem criar arquivos" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "entrada de html_extra_path %r está posicionada dentro de outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "coloca a documentação para cada módulo em sua própria página" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "a entrada de html_extra_path %r não existe" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "inclui módulos “_private”" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "entrada de html_static_path %r está posicionada dento de outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "nome de arquivo da tabela de conteúdo (padrão: modules)" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" -msgstr "a entrada de html_static_path %r não existe" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "não cria um arquivo de tabela de conteúdo" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "o arquivo logo %r não existe" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "não cria títulos para os pacotes de módulo/pacote (p.ex., quando as docstrings já os contêm)" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" -msgstr "o arquivo favicon %r não existe" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "coloca documentação de módulo antes da documentação do submódulo" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." -msgstr "Os valores em 'html_sidebars' devem ser uma lista de strings. Pelo menos um padrão possui um valor de string: %s. Mude para `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "interpreta caminhos de módulos de acordo com a especificação de espaços de nomes implícitos PEP-0420" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "HTML 4 não encontra mais suporte no Sphinx. (\"html4_writer=True\" detectado nas opções de configuração)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "Lista de opções separadas por vírgulas para passar para a diretiva automodule (ou usar SPHINX_APIDOC_OPTIONS)." -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" -msgstr "Documentação %s %s" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "sufixo dos arquivos (padrão: rst)" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" -msgstr "falha ao ler o arquivo quebrado de informações de construção (versão desconhecida)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "Remove os arquivos existentes no diretório de saída que não foram gerados" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" -msgstr "falha ao ler o arquivo quebrado de informações de construção: (entrada de configuração ausente)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "gera um projeto completo com sphinx-quickstart" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" -msgstr "falha ao ler o arquivo quebrado de informações de construção: (entrada de tags ausente)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "acrescenta module_path a sys.path, usando quando --full é fornecido" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Os arquivos LaTeX estão em %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "nome do projeto (padrão nome do módulo raiz)" + +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "autor(e)s do projeto, usado quando --full é fornecido" + +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "versão do projeto, usado quando --full é fornecido" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "lançamento do projeto, usado quando --full é fornecido, padrão é --doc-version" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nExecute \"make\" nesse diretório para executá-los com (pdf)latex\n(use \"make latexpdf\" aqui para fazer isso automaticamente)." +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "opções de extensão" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "nenhuma valor da configuração “latex_documents” encontrado; nenhum documento será escrito" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "habilita extensões arbitrárias, usadas quando --full é fornecido" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "o valor da configuração “latex_documents” faz referência a um documento desconhecido %s" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Release" +msgid "enable %s extension, used when --full is given" +msgstr "habilita a extensão %s, usada quando --full é fornecido" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "copiando arquivos de suporte TeX" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "%s não é um diretório." -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "copiando arquivos adicionais" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "Executando apidoc" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "Chave configuração desconhecida: latex_elements[%r], ignorado." +msgid "apidoc_modules item %i must be a dict" +msgstr "item apidoc_modules %i deve ser um dict" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "Opção de tema desconhecida: latex_theme_options[%r], ignorada." - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" -msgstr "Falha ao obter um docname!" +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "item apidoc_modules %i deve ter uma chave \"path\"" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" -msgstr "Falha ao obter o docname para a fonte %r!" +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "item apidoc_modules %i \"path\" deve ser uma string" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" -msgstr "Nenhuma nota de rodapé foi encontrada para o nó de referência %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "item apidoc_modules %i \"path\" não é uma pasta existente: %s" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r não possui a configuração \"theme\"" +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "item apidoc_modules %i deve ter uma chave \"destination\"" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r não possui a configuração \"%s\"" +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "item apidoc_modules %i \"destination\" deve ser uma string" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "continuação da página anterior" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "item apidoc_modules %i \"destination\" deveria ser uma caminho relativo" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "continua na próxima página" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "item apidoc_modules %i não consegue criar o diretório de destino: %s" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "Não alfabético" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "item apidoc_modules %i \"%s\" deve ser um int" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Números" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "item apidoc_modules %i \"%s\" deve ser um booleano" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "página" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "item apidoc_modules %i tem chaves inesperadas: %s" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Argumentos de Palavras-chave" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "item apidoc_modules %i \"%s\" deve ser uma sequência" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "valor inválido definido (faltando chave de fechamento): %s" +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "item apidoc_modules %i \"%s\" deve conter strings" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "valor inválido definido (faltando chave de abertura): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "autosummary: falhou em determinar %r a ser documentado, a seguinte exceção foi levantada:\n%s" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "string literal malformada (faltando aspas de fechamento): %s" +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] gerando autosummary para: %s" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "string literal malformada (faltando aspas de abertura): %s" +msgid "[autosummary] writing to %s" +msgstr "[autosummary] escrevendo em %s" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Exemplo" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "[autosummary] falha ao importar %s\nPossíveis dicas:\n%s" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Exemplos" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nGera ReStructuredText usando diretivas de resumo automático.\n\nsphinx-autogen é um frontend para sphinx.ext.autosummary.generate.\nEle gera os arquivos reStructuredText a partir de diretivas autosummary\ncontidas nos arquivos de entrada fornecidos.\n\nO formato da diretiva autosummary está documentado no módulo Python\n``sphinx.ext.autosummary`` e pode ser lido usando:\n\n pydoc sphinx.ext.autosummary\n" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Notas" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "arquivos-fonte para gerar arquivos rST" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Outros Parâmetros" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "diretório para colocar toda a saída" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "Recebe" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "sufixo padrão para arquivos (padrão: %(default)s)" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Referências" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "diretório de modelos personalizado (padrão: %(default)s)" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Avisos" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "documenta membros importados (padrão: %(default)s)" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "documenta exatamente os membros no módulo atributo __all__. (padrão: %(default)s)" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "referências de autosummmary excluíram o documento %r. Ignorado." -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: arquivo stub não encontrado %r. Verifique sua configuração autosummary_generate." -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "Um autosummary com legenda requer a opção :toctree:. Ignorado." -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3674,548 +3727,585 @@ msgid "" "%s" msgstr "autosummary: falha ao importar %s\nPossíveis dicas:\n%s" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "falha ao analisar o nome %s" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "falha ao importar o objecto %s" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "Os itens resumidos não devem incluir o módulo atual. Substitua %r por %r." -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: arquivo não encontrado: %s" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "autosummary gera arquivos .rst internamente. Mas seu source_suffix não contém .rst. Ignorado." -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "autosummary: falhou em determinar %r a ser documentado, a seguinte exceção foi levantada:\n%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "Identificador de projeto intersphinx `%r` inválido em intersphinx_mapping. Os identificadores do projeto devem ser strings não vazias." -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[autosummary] gerando autosummary para: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "Valor inválido `%r` em intersphinx_mapping[%r]. Esperava-se uma tupla ou lista de dois elementos." -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[autosummary] escrevendo em %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "Valor inválido `%r` em intersphinx_mapping[%r]. Os valores devem ser um par (URI alvo, locais de inventário)." -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "[autosummary] falha ao importar %s\nPossíveis dicas:\n%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "Valor de URI alvo inválido `%r` em intersphinx_mapping[%r][0]. Os URIs alvo devem ser strings exclusivas e não vazias." -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nGera ReStructuredText usando diretivas de resumo automático.\n\nsphinx-autogen é um frontend para sphinx.ext.autosummary.generate.\nEle gera os arquivos reStructuredText a partir de diretivas autosummary\ncontidas nos arquivos de entrada fornecidos.\n\nO formato da diretiva autosummary está documentado no módulo Python\n``sphinx.ext.autosummary`` e pode ser lido usando:\n\n pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "Valor de URI alvo inválido `%r` em intersphinx_mapping[%r][0]. Os URIs alvo devem ser exclusivos (outra instância em intersphinx_mapping[%r])." -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "arquivos-fonte para gerar arquivos rST" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "Valor de locais de inventário inválido `%r` em intersphinx_mapping[%r][1]. Os locais de inventário devem ser strings não vazias ou None." -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "diretório para colocar toda a saída" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "Configuração de `intersphinx_mapping` inválida (1 erro)." + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "Configuração de `intersphinx_mapping` inválida (%s erros)." + +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "Uma entrada intersphinx_mapping inválida foi adicionada após a normalização." + +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "carregando inventário intersphinx '%s' de %s ..." + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "encontrados alguns problemas com alguns dos inventários, mas eles tem alternativas em funcionamento:" + +#: ext/intersphinx/_load.py:332 +#, python-format +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "falha ao alcançar todos os inventários com os seguintes problemas:\n%s" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "sufixo padrão para arquivos (padrão: %(default)s)" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "o inventário intersphinx foi movido: %s -> %s" -#: ext/autosummary/generate.py:882 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "diretório de modelos personalizado (padrão: %(default)s)" +msgid "(in %s %s)" +msgstr "(em %s %s)" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "documenta membros importados (padrão: %(default)s)" +msgid "(in %s)" +msgstr "(em %s)" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "documenta exatamente os membros no módulo atributo __all__. (padrão: %(default)s)" +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "Inventário '%s': correspondências duplicadas encontradas para %s:%s" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" -msgstr "Remove os arquivos existentes no diretório de saída que não foram gerados" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "Inventário '%s': várias correspondências encontradas para %s:%s" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:387 #, python-format -msgid "Failed to remove %s: %s" -msgstr "Falha ao remover %s: %s" +msgid "inventory for external cross-reference not found: %r" +msgstr "inventário para referência cruzada externa não encontrado: %r" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nProcura recursivamente em módulos e pacotes Python e cria um\narquivo reST com diretivas automodule por pacote no .\n\nOs s podem ser padrões de arquivo e/ou diretório que serão\nexcluídos da geração.\n\nNota: Por padrão, este script não substituirá os arquivos já criados." +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "sufixo inválido de referência cruzada externa: %r" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "caminho para o módulo a ser documentado" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "domínio para referência cruzada externa não encontrado: %r" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "padrões de diretório e/ou arquivo no estilo fnmatch para excluir da geração" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "alvo da referência externa %s:%s não encontrado: %s" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "diretório para colocar toda a saída" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "erro ao formatar assinatura para %s: %s" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "profundidade máxima de submódulos para mostrar no TOC (padrão: 4)" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "Ignorando __all__ inválido no módulo %s: %r" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "sobrescreve arquivos existentes" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "Falha ao obter uma assinatura de função para %s: %s" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "segue links simbólicos. Poderoso quando combinado com collective.recipe.omelette." +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "Falha ao atualizar a assinatura para %r: parâmetro não encontrado: %s" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "escreve o script sem criar arquivos" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "Falha ao analisar type_comment para %r: %s" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "coloca a documentação para cada módulo em sua própria página" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "__slots__ inválido encontrado em %s. Ignorado." -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "inclui módulos “_private”" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "erro ao formatar argumentos para %s: %s" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "nome de arquivo da tabela de conteúdo (padrão: modules)" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "Falha ao obter uma assinatura de construtor para %s: %s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "não cria um arquivo de tabela de conteúdo" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "Falha ao obter uma assinatura de método para %s: %s" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "não cria títulos para os pacotes de módulo/pacote (p.ex., quando as docstrings já os contêm)" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "Falha ao obter uma assinatura para %s: %s" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "coloca documentação de módulo antes da documentação do submódulo" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "Falha ao analisar um valor de argumento padrão para %r: %s" -#: ext/apidoc/_cli.py:152 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "interpreta caminhos de módulos de acordo com a especificação de espaços de nomes implícitos PEP-0420" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" +msgstr "o atributo %s está listado em :members:, mas está faltando pois não foi encontrado no objeto %r" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." -msgstr "Lista de opções separadas por vírgulas para passar para a diretiva automodule (ou usar SPHINX_APIDOC_OPTIONS)." - -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "sufixo dos arquivos (padrão: rst)" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "autodoc: falhou em determinar %s.%s (%r) a ser documentado, a seguinte exceção foi levantada:\n%s" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "gera um projeto completo com sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "argumentos de assinatura ou anotação de retorno fornecidos para automodule %s" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "acrescenta module_path a sys.path, usando quando --full é fornecido" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ deve ser uma lista de strings, não %r (no módulo %s) -- ignorando __all__" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "nome do projeto (padrão nome do módulo raiz)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "faltando atributo mencionado na opção :members: : módulo %s, atributo %s" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "autor(e)s do projeto, usado quando --full é fornecido" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "faltando atributo %s no objeto %s" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "versão do projeto, usado quando --full é fornecido" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "apelido de TypeVar(%s)" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "lançamento do projeto, usado quando --full é fornecido, padrão é --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "falha ao ler o arquivo quebrado de informações de construção (versão desconhecida)" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "opções de extensão" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "falha ao ler o arquivo quebrado de informações de construção: (entrada de configuração ausente)" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" -msgstr "habilita extensões arbitrárias, usadas quando --full é fornecido" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "falha ao ler o arquivo quebrado de informações de construção: (entrada de tags ausente)" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" -msgstr "habilita a extensão %s, usada quando --full é fornecido" +msgid "The HTML pages are in %(outdir)s." +msgstr "As páginas HTML estão em %(outdir)s." -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." -msgstr "%s não é um diretório." - -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" -msgstr "Executando apidoc" +msgid "Failed to read build info file: %r" +msgstr "Falha ao ler o arquivo de informações de construção: %r" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" -msgstr "item apidoc_modules %i deve ser um dict" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "build_info incompatível, copiando .buildinfo para .buildinfo.bak" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" -msgstr "item apidoc_modules %i deve ter uma chave \"path\"" +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "construindo [html]: " -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" -msgstr "item apidoc_modules %i \"path\" deve ser uma string" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "o modelo %s foi alterado desde a construção anterior, todos os documentos serão reconstruídos" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" -msgstr "item apidoc_modules %i \"path\" não é uma pasta existente: %s" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "índice" -#: ext/apidoc/_extension.py:133 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "item apidoc_modules %i deve ter uma chave \"destination\"" +msgid "Logo of %s" +msgstr "Logo de %s" -#: ext/apidoc/_extension.py:140 -#, python-format -msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "item apidoc_modules %i \"destination\" deve ser uma string" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "próximo" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "item apidoc_modules %i \"destination\" deveria ser uma caminho relativo" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "anterior" -#: ext/apidoc/_extension.py:157 -#, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" -msgstr "item apidoc_modules %i não consegue criar o diretório de destino: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "gerando índices" -#: ext/apidoc/_extension.py:178 -#, python-format -msgid "apidoc_modules item %i '%s' must be an int" -msgstr "item apidoc_modules %i \"%s\" deve ser um int" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "escrevendo páginas adicionais" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "item apidoc_modules %i \"%s\" deve ser um booleano" +msgid "cannot copy image file '%s': %s" +msgstr "não foi possível copiar arquivo de imagem '%s': %s" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" -msgstr "item apidoc_modules %i tem chaves inesperadas: %s" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "copiando arquivos baixáveis… " -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" -msgstr "item apidoc_modules %i \"%s\" deve ser uma sequência" +msgid "cannot copy downloadable file %r: %s" +msgstr "não foi possível copiar o arquivo baixável %r: %s" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "item apidoc_modules %i \"%s\" deve conter strings" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgstr "Falha ao copiar um arquivo no diretório \"static\" do tema: %s: %r" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:871 #, python-format -msgid "Would create file %s." -msgstr "Criaria o arquivo %s." +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "Falha ao copiar um arquivo em html_static_file: %s: %r" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s v%s)" -msgstr "(em %s v%s)" +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "copiando arquivos estáticos" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:923 #, python-format -msgid "(in %s)" -msgstr "(em %s)" +msgid "cannot copy static file %r" +msgstr "não foi possível copiar o arquivo estático %r" -#: ext/intersphinx/_resolve.py:108 -#, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "Inventário '%s': correspondências duplicadas encontradas para %s:%s" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "copiando arquivos extras" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:938 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "Inventário '%s': várias correspondências encontradas para %s:%s" +msgid "cannot copy extra file %r" +msgstr "não foi possível copiar o arquivo extra %r" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:944 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "inventário para referência cruzada externa não encontrado: %r" +msgid "Failed to write build info file: %r" +msgstr "Falha ao escrever o arquivo de informações de construção: %r" -#: ext/intersphinx/_resolve.py:392 -#, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "sufixo inválido de referência cruzada externa: %r" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "não foi possível carregar o índice de pesquisa, mas nem todos os documentos serão construídos: o índice ficará incompleto." -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:1038 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "domínio para referência cruzada externa não encontrado: %r" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "a página %s corresponde a dois padrões em html_sidebars: %r e %r" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1204 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "alvo da referência externa %s:%s não encontrado: %s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "ocorreu um erro Unicode ao renderizar a página %s. Verifique se todos os valores de configuração que contêm conteúdo não ASCII são strings Unicode." -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "Identificador de projeto intersphinx `%r` inválido em intersphinx_mapping. Os identificadores do projeto devem ser strings não vazias." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" +msgstr "O tema '%s' não oferece suporte a esta versão do Sphinx, porque ele usa o campo 'style' em modelos HTML, que foi descontinuado no Sphinx 5.1 e removido no Sphinx 7.0. O tema deve ser atualizado para usar o campo 'styles' em vez disso. Veja https://www.sphinx-doc.org/pt-br/master/development/html_themes/templating.html#styles" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "Valor inválido `%r` em intersphinx_mapping[%r]. Esperava-se uma tupla ou lista de dois elementos." +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "Ocorreu um erro ao renderizar a página %s.\nMotivo: %r" + +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "despejando inventário de objetos" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1266 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "Valor inválido `%r` em intersphinx_mapping[%r]. Os valores devem ser um par (URI alvo, locais de inventário)." +msgid "dumping search index in %s" +msgstr "despejando índice de pesquisa em %s" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "Valor de URI alvo inválido `%r` em intersphinx_mapping[%r][0]. Os URIs alvo devem ser strings exclusivas e não vazias." +msgid "invalid js_file: %r, ignored" +msgstr "js_file inválido: %r, ignorado" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Muitos math_renders estão registrados, mas nenhum math_renderer está selecionado." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "Valor de URI alvo inválido `%r` em intersphinx_mapping[%r][0]. Os URIs alvo devem ser exclusivos (outra instância em intersphinx_mapping[%r])." +msgid "Unknown math_renderer %r is given." +msgstr "math_renderer desconhecido %r é fornecido." -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "Valor de locais de inventário inválido `%r` em intersphinx_mapping[%r][1]. Os locais de inventário devem ser strings não vazias ou None." +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "entrada de html_extra_path %r está posicionada dentro de outdir" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "Configuração de `intersphinx_mapping` inválida (1 erro)." +#: builders/html/__init__.py:1370 +#, python-format +msgid "html_extra_path entry %r does not exist" +msgstr "a entrada de html_extra_path %r não existe" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1385 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "Configuração de `intersphinx_mapping` inválida (%s erros)." +msgid "html_static_path entry %r is placed inside outdir" +msgstr "entrada de html_static_path %r está posicionada dento de outdir" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "Uma entrada intersphinx_mapping inválida foi adicionada após a normalização." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" +msgstr "a entrada de html_static_path %r não existe" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "carregando inventário intersphinx '%s' de %s ..." +msgid "logo file %r does not exist" +msgstr "o arquivo logo %r não existe" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "o arquivo favicon %r não existe" + +#: builders/html/__init__.py:1425 +#, python-format msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "encontrados alguns problemas com alguns dos inventários, mas eles tem alternativas em funcionamento:" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." +msgstr "Os valores em 'html_sidebars' devem ser uma lista de strings. Pelo menos um padrão possui um valor de string: %s. Mude para `html_sidebars = %r`." -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "falha ao alcançar todos os inventários com os seguintes problemas:" +#: builders/html/__init__.py:1438 +msgid "" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "HTML 4 não encontra mais suporte no Sphinx. (\"html4_writer=True\" detectado nas opções de configuração)" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "o inventário intersphinx foi movido: %s -> %s" +msgid "%s %s documentation" +msgstr "Documentação %s %s" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "valor inválido para a opção member-order: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r não possui a configuração \"theme\"" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "valor inválido para a opção class-doc-from: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r não possui a configuração \"%s\"" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "assinatura inválida para auto%s (%r)" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "Falha ao obter um docname!" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "erro ao formatar argumentos para %s: %s" +msgid "Failed to get a docname for source %r!" +msgstr "Falha ao obter o docname para a fonte %r!" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "autodoc: falhou em determinar %s.%s (%r) a ser documentado, a seguinte exceção foi levantada:\n%s" +msgid "No footnote was found for given reference node %r" +msgstr "Nenhuma nota de rodapé foi encontrada para o nó de referência %r" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Os arquivos LaTeX estão em %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "não sei qual módulo importar para documentação automática %r (tente colocar uma diretiva “module” ou “currentmodule” no documento ou forneça um nome explícito para o módulo)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nExecute \"make\" nesse diretório para executá-los com (pdf)latex\n(use \"make latexpdf\" aqui para fazer isso automaticamente)." -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" -msgstr "Um objeto simulado foi detectado: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "nenhuma valor da configuração “latex_documents” encontrado; nenhum documento será escrito" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "erro ao formatar assinatura para %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "o valor da configuração “latex_documents” faz referência a um documento desconhecido %s" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "“::” no nome de automodule não faz sentido" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "copiando arquivos de suporte TeX" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "argumentos de assinatura ou anotação de retorno fornecidos para automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "copiando arquivos adicionais" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ deve ser uma lista de strings, não %r (no módulo %s) -- ignorando __all__" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Chave configuração desconhecida: latex_elements[%r], ignorado." -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "faltando atributo mencionado na opção :members: : módulo %s, atributo %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "Opção de tema desconhecida: latex_theme_options[%r], ignorada." -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "Falha ao obter uma assinatura de função para %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s já tem números de seção atribuídos (toctree numerada aninhada?)" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "Falha ao obter uma assinatura de construtor para %s: %s" +msgid "image file not readable: %s" +msgstr "arquivo de imagem não legível: %s" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" -msgstr "Base: %s" +msgid "image file %s not readable: %s" +msgstr "arquivo de imagem %s não legível: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" -msgstr "faltando atributo %s no objeto %s" +msgid "download file not readable: %s" +msgstr "arquivo de download não legível: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" -msgstr "apelido de %s" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "referências circulares à toctree detectadas, ignorando: %s <- %s" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "apelido de TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "toctree contém referência ao documento %r que não possui título: nenhum link será gerado" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "Falha ao obter uma assinatura de método para %s: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "toctree contém referência ao documento não incluído %r" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "__slots__ inválido encontrado em %s. Ignorado." +msgid "toctree contains reference to non-existing document %r" +msgstr "toctree contém referência a documento inexistente %r" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "Falha ao analisar um valor de argumento padrão para %r: %s" +msgid "see %s" +msgstr "veja %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "Falha ao atualizar a assinatura para %r: parâmetro não encontrado: %s" +msgid "see also %s" +msgstr "veja também %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "Falha ao analisar type_comment para %r: %s" +msgid "unknown index entry type %r" +msgstr "tipo desconhecido de entrada de índice %r" diff --git a/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo b/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo index aa597d0e426..7e0494233e2 100644 Binary files a/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo and b/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po b/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po index e31127cdb5e..625358ad0d7 100644 --- a/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Komiya Takeshi , 2016\n" "Language-Team: Portuguese (Portugal) (http://app.transifex.com/sphinx-doc/sphinx-1/language/pt_PT/)\n" @@ -20,6 +20,127 @@ msgstr "" "Language: pt_PT\n" "Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -34,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +310,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +323,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,468 +538,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Atenção" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Cuidado" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Perigo" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Erro" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Dica" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Importante" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Nota" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Veja também" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Dica" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Aviso" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (em " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[código fonte]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[documentos]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Código do módulo" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Código fonte de %s

        " +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Visão geral: código do módulo" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Todos os módulos onde este código está disponível

        " +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "invalid css_file: %r, ignored" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/xml.py:29 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Internos" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Módulos" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -740,9 +1176,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -777,6 +1214,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Por fazer" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "entrada original" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -864,1779 +1329,1514 @@ msgstr "[gráfico: %s]" msgid "[graph]" msgstr "[gráfico]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Por fazer" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "entrada original" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autor da secção: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[código fonte]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autor do módulo: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autor do código: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[documentos]" -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Código do módulo" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Código fonte de %s

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Visão geral: código do módulo" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Todos os módulos onde este código está disponível

        " + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:92 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:56 +#: domains/math.py:73 #, python-format -msgid "no changes in version %s." +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Internos" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (função interna)" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Módulos" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (método %s)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (classe)" -#: builders/changes.py:133 +#: domains/javascript.py:188 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (variável global ou constante)" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (atributo %s)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Parâmetros" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Gera" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Retorno" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Tipo de retorno" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (módulo)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "função" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "método" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "classe" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "dados" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atributo" -#: builders/__init__.py:275 +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "módulo" + +#: domains/javascript.py:458 #, python-format -msgid "all of %d po files" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s (directive)" +msgstr "%s (directiva)" -#: builders/__init__.py:309 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are out of date" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (papel)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "directiva" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:330 +#: domains/rst.py:236 +msgid "role" +msgstr "papel" + +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/changeset.py:32 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:348 +#: domains/changeset.py:33 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "Changed in version %s" +msgstr "Alterado na versão %s" -#: builders/__init__.py:361 +#: domains/changeset.py:34 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Obsoleto desde a versão %s" -#: builders/__init__.py:377 +#: domains/changeset.py:35 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/__init__.py:322 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:410 -#, python-format -msgid "%d found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: cmd/build.py:357 #, python-format -msgid "error writing file %s: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (em " +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:464 +#: cmd/quickstart.py:134 #, python-format -msgid "cannot write image file %r: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:242 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" - -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" - -#: _cli/__init__.py:171 -#, python-brace-format -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" - -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" - -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" - -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" - -#: _cli/__init__.py:231 -msgid "" -msgstr "" - -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" - -#: environment/__init__.py:86 -msgid "new config" -msgstr "" - -#: environment/__init__.py:87 -msgid "config changed" -msgstr "" - -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "" - -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" - -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "" - -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" - -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" - -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" - -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "" - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "" - -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "" - -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "" - -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" - -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "" - -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "" - -#: util/i18n.py:146 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "locale_dir %s does not exist" -msgstr "" - -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +msgid "Creating file %s." msgstr "" -#: util/i18n.py:245 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +msgid "File %s already exists, skipping." msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: util/nodes.py:423 +#: cmd/quickstart.py:520 #, python-format msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" - -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" - -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" - -#: util/display.py:82 -msgid "skipped" -msgstr "" - -#: util/display.py:87 -msgid "failed" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" - -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" - -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" - -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: util/fileutil.py:76 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" - -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" - -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "" - -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" - -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Notas de rodapé" - -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[imagem: %s]" - -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[imagem]" - -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Índice" - -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:538 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" - -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "" - -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "" - -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: writers/latex.py:1183 +#: cmd/quickstart.py:573 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" - -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" - -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "" - -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (função interna)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (método %s)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (classe)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (variável global ou constante)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (atributo %s)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Parâmetros" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Gera" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Retorno" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Tipo de retorno" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (módulo)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "função" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "método" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "classe" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "dados" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atributo" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "módulo" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Alterado na versão %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Obsoleto desde a versão %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (directiva)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (papel)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "directiva" - -#: domains/rst.py:235 -msgid "directive-option" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "papel" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Atenção" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Cuidado" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Perigo" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Erro" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Dica" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Importante" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Nota" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Veja também" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Dica" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Aviso" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: cmd/quickstart.py:234 +#: cmd/quickstart.py:793 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: cmd/quickstart.py:241 +#: cmd/quickstart.py:810 #, python-format -msgid "Selected root path: %s" +msgid "Invalid template variable: %s" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autor da secção: " -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autor do módulo: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autor do código: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: cmd/quickstart.py:286 +#: directives/patches.py:70 msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" msgstr "" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: cmd/quickstart.py:339 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d %b, %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Índice" + +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Notas de rodapé" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[imagem: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[imagem]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: cmd/quickstart.py:367 +#: writers/html5.py:431 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "numfig_format is not defined for %s" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" + +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" + +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:386 #, python-format -msgid "Creating file %s." +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "File %s already exists, skipping." +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:519 +#: writers/latex.py:616 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:526 +#: writers/latex.py:1198 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:530 +#: writers/latex.py:1228 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:809 +#: util/i18n.py:244 #, python-format -msgid "Invalid template variable: %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/build.py:74 +#: util/osutil.py:131 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:131 +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "continuação da página anterior" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "" + +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Símbolos" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Versão" -#: cmd/build.py:212 -msgid "console output options" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Recolher painel lateral" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navegação" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Pesquisar dentro de %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Sobre estes documentos" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Pesquisar" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Ir" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Copyright" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Última actualização em %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Tópico anterior" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "capítulo anterior" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Próximo tópico" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "próximo capítulo" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Índice completo numa página" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Esta Página" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Exibir Fonte" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Conteúdo" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Pesquisa rápida" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Pesquisar %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Ir" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2683,7 +2883,7 @@ msgstr "Índice Global de Módulos" msgid "quick access to all modules" msgstr "acesso rápido a todos os módulos" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Índice Geral" @@ -2691,23 +2891,15 @@ msgstr "Índice Geral" msgid "all functions, classes, terms" msgstr "todas as funções, classes, termos" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Esta Página" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Índice completo numa página" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Pesquisa rápida" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "Pesquisar %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2717,57 +2909,6 @@ msgstr "Paginas de índice por letra" msgid "can be huge" msgstr "pode ser enorme" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Tópico anterior" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "capítulo anterior" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Próximo tópico" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "próximo capítulo" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navegação" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Pesquisar dentro de %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Sobre estes documentos" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Última actualização em %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2784,21 +2925,21 @@ msgstr "" msgid "search" msgstr "pesquisar" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Esconder Resultados da Pesquisa" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Conteúdo" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Resultados da Pesquisa" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "A sua pesquisa não encontrou nenhum documento. Por favor, confirme que todas as palavras estão escritas corretamente e que selecionou categorias suficientes." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2807,22 +2948,21 @@ msgstr[0] "" msgstr[1] "" msgstr[2] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "A Pesquisar" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "A preparar a pesquisa..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", em" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Esconder Resultados da Pesquisa" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2830,6 +2970,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2851,120 +2996,127 @@ msgstr "Outras alterações" msgid "Expand sidebar" msgstr "Expandir painel lateral" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parâmetros" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variáveis" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Levanta" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (no módulo %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (no módulo %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (variável interna)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (classe interna)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (classe em %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (método de classe %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (método estático %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Índice de Módulos do Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "módulos" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Obsoleto" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "excepção" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "método de classe" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "método estático" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (obsoleto)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parâmetros" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variáveis" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Levanta" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2975,746 +3127,526 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "membro" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tipo" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "variável" - -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "macro" - -#: domains/c/__init__.py:753 -msgid "struct" -msgstr "" - -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "variável de ambiente; %s" - -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "Termo de glossário" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "token de gramática" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "rótulo de referência" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "variável de ambiente" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "opção de programa" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Índice de Módulos" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "ver %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "ver também %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Símbolos" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 +#: domains/c/__init__.py:211 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +msgid "%s (C %s)" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "variável" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "macro" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "" +msgid "environment variable; %s" +msgstr "variável de ambiente; %s" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:116 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "%s; configuration value" msgstr "" -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:239 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:319 #, python-format -msgid "Unknown image format: %s..." +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "Termo de glossário" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "índice" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "token de gramática" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "rótulo de referência" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "próximo" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "variável de ambiente" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "anterior" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "opção de programa" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Índice de Módulos" -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1153 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy static file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Failed to write build info file: %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "Documentação %s %s" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Versão" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "continuação da página anterior" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3722,7 +3654,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3737,481 +3669,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:123 #, python-format -msgid "%s is not a directory." +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" -msgstr "(em %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "índice" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "próximo" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "anterior" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "Documentação %s %s" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "ver %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "ver também %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/ro/LC_MESSAGES/sphinx.mo b/sphinx/locale/ro/LC_MESSAGES/sphinx.mo index 1205f1588da..c499abb7717 100644 Binary files a/sphinx/locale/ro/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ro/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/ro/LC_MESSAGES/sphinx.po b/sphinx/locale/ro/LC_MESSAGES/sphinx.po index 752414c9c58..84ba52d4654 100644 --- a/sphinx/locale/ro/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/ro/LC_MESSAGES/sphinx.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Razvan Stefanescu , 2015-2017\n" "Language-Team: Romanian (http://app.transifex.com/sphinx-doc/sphinx-1/language/ro/)\n" @@ -20,6 +20,127 @@ msgstr "" "Language: ro\n" "Plural-Forms: nplurals=3; plural=(n==1?0:(((n%100>19)||((n%100==0)&&(n!=0)))?2:1));\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Propuneri de Îmbunătățire Python; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -34,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Proiectul necesită minim Sphinx v%s și de aceea nu poate fi construit cu această versiune." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "eșuat: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +310,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +323,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,468 +538,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Fig. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabelul %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Cod %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Atenție" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Avertisment" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Pericol" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Eroare" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Sugestie" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Important" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Notă" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Vezi și" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Sfat" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Atenționare" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "(în" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Propuneri de Îmbunătățire Python; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[sursă]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[documentație]" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Codul modulului" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Codul sursă pentru %s

        " +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Prezentare generală: codul modulului" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Toate modulele pentru care este disponibil codul sursă

        " +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "invalid css_file: %r, ignored" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/xml.py:29 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Integrate" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Nivelul modul" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -740,9 +1176,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -777,6 +1214,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "De făcut" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "înregistrarea inițială" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -864,1779 +1329,1514 @@ msgstr "[grafic: %s]" msgid "[graph]" msgstr "[grafic]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "De făcut" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" -msgstr "înregistrarea inițială" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autorul secțiunii:" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[sursă]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autorul modulului:" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autorul codului:" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[documentație]" -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor:" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Codul modulului" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Codul sursă pentru %s

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Prezentare generală: codul modulului" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Toate modulele pentru care este disponibil codul sursă

        " + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:92 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:56 +#: domains/math.py:73 #, python-format -msgid "no changes in version %s." +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Integrate" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (funcție integrată)" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Nivelul modul" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (metoda %s)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (clasă)" -#: builders/changes.py:133 +#: domains/javascript.py:188 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (variabilă globală sau constantă)" -#: builders/manpage.py:37 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (atribut %s)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumente" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Generează" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Întoarce" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Tipul întors" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (modul)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funcție" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metodă" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "clasă" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "data" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribut" -#: builders/__init__.py:275 +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" + +#: domains/javascript.py:458 #, python-format -msgid "all of %d po files" +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s (directive)" +msgstr "%s (directivă)" -#: builders/__init__.py:309 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are out of date" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (rol)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "directivă" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:330 +#: domains/rst.py:236 +msgid "role" +msgstr "rol" + +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/changeset.py:32 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:348 +#: domains/changeset.py:33 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "Changed in version %s" +msgstr "Schimbat în versiunea %s" -#: builders/__init__.py:361 +#: domains/changeset.py:34 #, python-format -msgid "%d source files given on command line" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Învechit începând cu versiunea %s" -#: builders/__init__.py:377 +#: domains/changeset.py:35 #, python-format -msgid "targets for %d source files that are out of date" +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/__init__.py:322 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:410 -#, python-format -msgid "%d found" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: cmd/build.py:357 #, python-format -msgid "error writing file %s: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr "(în" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:464 +#: cmd/quickstart.py:134 #, python-format -msgid "cannot write image file %r: %s" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:242 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" - -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" - -#: _cli/__init__.py:171 -#, python-brace-format -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" - -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" - -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" - -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" - -#: _cli/__init__.py:231 -msgid "" -msgstr "" - -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" - -#: environment/__init__.py:86 -msgid "new config" -msgstr "" - -#: environment/__init__.py:87 -msgid "config changed" -msgstr "" - -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "" - -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" - -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "" - -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" - -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" - -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" - -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "" - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "" - -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "" - -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "" - -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" - -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "" - -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "" - -#: util/i18n.py:146 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "locale_dir %s does not exist" -msgstr "" - -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +msgid "Creating file %s." msgstr "" -#: util/i18n.py:245 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +msgid "File %s already exists, skipping." msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: util/nodes.py:423 +#: cmd/quickstart.py:520 #, python-format msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" - -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" - -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" - -#: util/display.py:82 -msgid "skipped" -msgstr "" - -#: util/display.py:87 -msgid "failed" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" - -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" - -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" - -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: util/fileutil.py:76 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" - -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" - -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "" - -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" - -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Note de subsol" - -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[figura: %s]" - -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[figură]" - -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Index" - -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:538 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" - -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "" - -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "" - -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: writers/latex.py:1183 +#: cmd/quickstart.py:573 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" - -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" - -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "" - -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (funcție integrată)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (metoda %s)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (clasă)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (variabilă globală sau constantă)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (atribut %s)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumente" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Generează" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Întoarce" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Tipul întors" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funcție" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metodă" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "clasă" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "data" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atribut" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modul" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Schimbat în versiunea %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Învechit începând cu versiunea %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (directivă)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (rol)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "directivă" - -#: domains/rst.py:235 -msgid "directive-option" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "rol" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Atenție" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Avertisment" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Pericol" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Eroare" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Sugestie" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Important" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Notă" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Vezi și" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Sfat" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Atenționare" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: cmd/quickstart.py:234 +#: cmd/quickstart.py:793 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: cmd/quickstart.py:241 +#: cmd/quickstart.py:810 #, python-format -msgid "Selected root path: %s" +msgid "Invalid template variable: %s" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autorul secțiunii:" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autorul modulului:" + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autorul codului:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor:" + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: cmd/quickstart.py:286 +#: directives/patches.py:70 msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" msgstr "" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: cmd/quickstart.py:339 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Index" + +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Note de subsol" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[figura: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[figură]" + +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: cmd/quickstart.py:367 +#: writers/html5.py:431 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "numfig_format is not defined for %s" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" + +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" + +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:386 #, python-format -msgid "Creating file %s." +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "File %s already exists, skipping." +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:519 +#: writers/latex.py:616 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:526 +#: writers/latex.py:1198 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:530 +#: writers/latex.py:1228 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:809 +#: util/i18n.py:244 #, python-format -msgid "Invalid template variable: %s" +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/build.py:74 +#: util/osutil.py:131 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:131 +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "continuare din pagina precedentă" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "" + +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Simboluri" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Versiune" -#: cmd/build.py:212 -msgid "console output options" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Ascundere bară laterală" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigare" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Caută în %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Despre aceste documente" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Căutare" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Caută" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Drepturi de autor" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Ultima actualizare la %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Subiectul precedent" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "capitolul precedent" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Subiectul următor" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "capitolul următor" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Index complet" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Această Pagină" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Vezi Sursa" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Cuprins" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Căutare rapidă" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Caută %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Caută" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2683,7 +2883,7 @@ msgstr "Index Module Globale" msgid "quick access to all modules" msgstr "acces rapid la toate modulele" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Index General" @@ -2691,23 +2891,15 @@ msgstr "Index General" msgid "all functions, classes, terms" msgstr "toate funcțiile, clasele, termenii" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Această Pagină" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Index complet" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Căutare rapidă" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "Caută %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2717,57 +2909,6 @@ msgstr "Indexează paginile dupa literă" msgid "can be huge" msgstr "poate fi extrem de mare" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Subiectul precedent" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "capitolul precedent" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Subiectul următor" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "capitolul următor" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigare" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Caută în %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Despre aceste documente" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Drepturi de autor" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Ultima actualizare la %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2784,21 +2925,21 @@ msgstr "" msgid "search" msgstr "căutare" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Ascunde Rezultatele Căutării" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Cuprins" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Rezultatele Căutării" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Căutarea nu a identificat nici un document. Te rog să te asiguri că toate cuvintele sunt scrise corect și că ai selectat suficiente categorii." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2807,22 +2948,21 @@ msgstr[0] "" msgstr[1] "" msgstr[2] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Căutare" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Se pregătește căutarea..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", în" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Ascunde Rezultatele Căutării" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2830,6 +2970,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2851,120 +2996,127 @@ msgstr "Alte schimbări" msgid "Expand sidebar" msgstr "Expandare bară laterală" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametrii" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variabile" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Generează" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (în modulul %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (în modulul %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (variabilă integrată)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (clasă integrată)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (clasa în %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (metoda clasei %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (metoda statică %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Indexul de Module Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "module" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Învechit" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "excepție" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "metoda clasei" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "metodă statică" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "(învechit)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametrii" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variabile" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Generează" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2975,746 +3127,526 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "membru" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tip" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enumerator" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerator" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "variabilă" - -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "macro" - -#: domains/c/__init__.py:753 -msgid "struct" -msgstr "" - -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "variabilă de mediu; %s" - -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "termen de glosar" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "element de gramatică" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "etichetă de referință" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "variabilă de mediu" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "opțiune a programului" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Index al modulelor" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "vezi %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "vezi și %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Simboluri" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 +#: domains/c/__init__.py:211 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +msgid "%s (C %s)" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "variabilă" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "macro" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "" +msgid "environment variable; %s" +msgstr "variabilă de mediu; %s" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:116 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "%s; configuration value" msgstr "" -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:239 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: transforms/post_transforms/images.py:143 +#: domains/std/__init__.py:319 #, python-format -msgid "Unknown image format: %s..." +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "termen de glosar" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "index" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "element de gramatică" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "etichetă de referință" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "următor" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "variabilă de mediu" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "precedent" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "opțiune a programului" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Index al modulelor" -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1153 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy static file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Failed to write build info file: %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "%s %s documentație" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Versiune" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "continuare din pagina precedentă" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3722,7 +3654,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3737,481 +3669,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:123 #, python-format -msgid "%s is not a directory." +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" -msgstr "(în %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "index" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "următor" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "precedent" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s documentație" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "vezi %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "vezi și %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/ru/LC_MESSAGES/sphinx.mo b/sphinx/locale/ru/LC_MESSAGES/sphinx.mo index 817d79035a8..81c63b5d1f0 100644 Binary files a/sphinx/locale/ru/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ru/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/ru/LC_MESSAGES/sphinx.po b/sphinx/locale/ru/LC_MESSAGES/sphinx.po index 51b9e1cc421..5f191d8a598 100644 --- a/sphinx/locale/ru/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/ru/LC_MESSAGES/sphinx.po @@ -17,7 +17,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Dunaevsky Maxim , 2024\n" "Language-Team: Russian (http://app.transifex.com/sphinx-doc/sphinx-1/language/ru/)\n" @@ -28,6 +28,127 @@ msgstr "" "Language: ru\n" "Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || (n%100>=11 && n%100<=14)? 2 : 3);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "Common Vulnerabilities and Exposures; CVE %s" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "неправильный номер CVE %s" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "Common Weakness Enumeration; CWE %s" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "неправильный номер CWE %s" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Предложения об улучшениях Python; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "неправильный номер PEP %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "неправильный номер RFC %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "Разделы конфигурации темы, отличные от [theme] и [option], не поддерживаются (попытка получения значения из %r)." + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "параметр %s.%s не встречается ни в одной из найденных настроек тем" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "указана неподдерживаемая опция темы %r" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "файл %r указанной темы не является корректным ZIP-архивов или не содержит тему" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "не найдена тема %r (потерян theme.toml?)" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "Тема %r имеет циклическое наследование" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "Тема %r наследуется от темы %r, которая не загружена. Загруженные темы: %s" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "У темы %r слишком много предков" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "файл конфигурации темы не найден в %r" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "тема %r не имеет таблицы \"theme\"" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "В теме %r \"[theme]\" не является таблицей" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "В теме %r должна быть определена настройка \"theme.inherit\"" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "В теме %r \"[options]\" не является таблицей" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "Настройка \"theme.pygments_style\" должна быть таблицей. Подсказка: \"%s\"" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "найдено несколько файлов для документа \"%s\": %s\nДля сборки используется %r ." + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "Пропущен нечитаемый документ %r." + #: extension.py:58 #, python-format msgid "" @@ -42,127 +163,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Проекту требуется расширение %s версии не ниже %s, и, следовательно, он не может быть собран с загруженной версией (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Неизвестный лексер Pygments %r" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "Разбор literal_block %r как \"%s\" завершилось ошибкой на токене: %r. Перезапуск в relaxed mode." + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Событие %r уже существует" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Неизвестное событие: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "Обработчик %r для события %r возбудил исключение" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Не удалось найти исходный каталог (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Целевой путь (%s) не является каталогом" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Исходный и целевой каталоги не должны совпадать" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Запуск Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Проект требует версию Sphinx не ниже v%s и не может быть построен текущей версией." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "создание целевого каталога" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "при настройку расширения %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "загрузка переводов [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "готово" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "недоступно для встроенных сообщений" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "загрузка фиксированного окружения" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "ошибка: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Сборщик не указан, по умолчанию используется html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "сборка завершена с проблемами." -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "сборка успешна." -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "сборка завершена с проблемами, 1 предупреждение (с предупреждениями, рассматриваемыми как ошибки)." -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "сборка завершена с проблемами, 1 предупреждение." -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "сборка успешна, 1 предупреждение." -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "сборка завершена с проблемами, %s предупреждений (в том числе с предупреждениями, рассматриваемыми как ошибки)." -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "сборка завершена с проблемами, %s предупреждений." -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "сборка успешна, %s предупреждение(-ий)." -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "узел класса %r уже зарегистрирован, его посетители будут переопределены" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -170,12 +318,12 @@ msgid "" "explicit" msgstr "расширение %s не определено как безопасное для параллельного чтения; если вы полагаете что это не так - пожалуйста, попросите автора проверить и явно указать это" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "расширение %s не безопасно для параллельного чтения" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -183,82 +331,214 @@ msgid "" "explicit" msgstr "расширение %s не объявлено как безопасное для параллельное записи; если вы считаете что это не так - пожалуйста, попросите автора проверить и явно указать это" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "расширение %s не безопасно использует параллельную записи" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "в конфигурационной папке нет файла conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Отсутствует аттрибут \"name\" у класса сборщика %s." + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Сборщик %r уже существует (в модуле %s)." + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Сборщик %s не зарегистрирован явно или через ресурсы пакетов." + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Сборщик %s не зарегистрирован." + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "домен %s уже зарегистрирован" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "домен %s не зарегистрирован" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "Директива %r уже зарегистрирована в домене %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "Роль %r уже зарегистрирована в домене %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "Индекс %r уже зарегистрирован в домене %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "object_type %r уже зарегистрирован" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "%r crossref_type уже зарегистрирован" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r уже зарегистрирован" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser для %r уже зарегистрирован" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Парсер исходного кода %s не зарегистрирован" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "Перевод для %r уже существует" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "kwargs для функции add_node() должны быть кортежем (visit, depart): %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r уже зарегистрирован" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "Движок отрисовки math %s уже зарегистрирован" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "Обнаружено некорректное значение настройки: 'language = None'. Обновите настройки, указав корректный код языка. Откат к 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "расширение %r является частью Sphinx начиная с версии %s; это расширение игнорируется." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Изначальное исключение:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Не удалось загрузить расширение %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "расширение %r не определяет функцию setup(); это действительно модуль расширения Sphinx?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "Расширению %s, используемому в этом проекте, требуется версия Sphinx не ниже v%s, поэтому он не может быть собран с этой версией." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "расширение %r вернуло неподдерживаемый объект из функции setup() function; оно должно вернуть None или словарь метаданных" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "`None` не является корректным типом файла для %r." + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "в конфигурационной папке нет файла conf.py file (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "не удалось переопределить настройку словаря %r, пропускается (используйте %r для установки значений отдельных элементов)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "недопустимое число %r для настройки %r, пропускается" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "не удалось переопределить настройку %r с неподдерживаемым типом, пропускается" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "неизвестное значение параметра конфигурации %r в переопределении, пропускается" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "Нет такого значения конфигурации: %r" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Ключ конфигурации %r уже существует" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "Обнаружено некорректное значение настройки: 'language = None'. Обновите настройки, указав корректный код языка. Откат к 'en' (English)." + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Синтаксическая ошибка в вашем файле конфигурации: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Файл конфигурации (или один из импортированных модулей) вызвал sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -266,2385 +546,2305 @@ msgid "" "%s" msgstr "В вашем файле конфигурации программная ошибка:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "Преобразование `source_suffix = %r` в `source_suffix = %r`." -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "Значением настройки `source_suffix' может быть словарь, строка или список строк. Вместо этого указано значение `%r' (тип %s)." -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Раздел %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Рис. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Таблица %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Список %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Для настройки `{name}` возможны значения {candidates}, но указано `{current}`." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Значение настройки `{name}' имеет тип `{current.__name__}'; ожидается {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Значение настройки `{name}' имеет тип `{current.__name__}', приведено к значению по умолчанию `{default.__name__}'." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r не найден, пропускается." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Неизвестный лексер Pygments %r" - -#: highlighting.py:209 -#, python-format +#: config.py:892 msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "Разбор literal_block %r как \"%s\" завершилось ошибкой на токене: %r. Перезапуск в relaxed mode." +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "Разделы конфигурации темы, отличные от [theme] и [option], не поддерживаются (попытка получения значения из %r)." +#: environment/__init__.py:89 +msgid "new config" +msgstr "новая конфигурация" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "параметр %s.%s не встречается ни в одной из найденных настроек тем" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "конфигурация изменена" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "указана неподдерживаемая опция темы %r" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "расширения изменились" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "файл %r указанной темы не является корректным ZIP-архивов или не содержит тему" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "версия окружения сборки отличается от текущей" + +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "каталог исходных файлов изменился" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "не найдена тема %r (потерян theme.toml?)" +msgid "The configuration has changed (1 option: %r)" +msgstr "Конфигурация изменилась (1 опция: %r)" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" -msgstr "Тема %r имеет циклическое наследование" +msgid "The configuration has changed (%d options: %s)" +msgstr "Конфигурация изменилась (%d опций: %s)" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "Конфигурация изменилась (%d опций: %s, ...)" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "Тема %r наследуется от темы %r, которая не загружена. Загруженные темы: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Это окружение несовместимо с выбранным сборщиком, пожалуйста, выберите другой каталог doctree." -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "У темы %r слишком много предков" +msgid "Failed to scan documents in %s: %r" +msgstr "Ошибка сканирования документов в %s: %r" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" -msgstr "файл конфигурации темы не найден в %r" +msgid "Domain %r is not registered" +msgstr "Домен %r не зарегистрирован" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "тема %r не имеет таблицы \"theme\"" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "документ не включен ни в одно оглавление" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "В теме %r \"[theme]\" не является таблицей" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "найдено оглавление, ссылающееся на само себя. Пропускается." -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "В теме %r должна быть определена настройка \"theme.inherit\"" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "В теме %r \"[options]\" не является таблицей" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Внимание" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "Настройка \"theme.pygments_style\" должна быть таблицей. Подсказка: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Осторожно" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Событие %r уже существует" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Опасно" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Неизвестное событие: %s" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Ошибка" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "Обработчик %r для события %r возбудил исключение" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Подсказка" -#: project.py:72 +#: locale/__init__.py:234 +msgid "Important" +msgstr "Важно" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Примечание" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "См. также" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Совет" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Предупреждение" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Файлы Texinfo находятся в %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "найдено несколько файлов для документа \"%s\": %s\nДля сборки используется %r ." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "Пропущен нечитаемый документ %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "не найдено значение настройки \"texinfo_documents\"; документы не были записаны" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Отсутствует аттрибут \"name\" у класса сборщика %s." +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "значение настройки \"texinfo_documents\" указывает на несуществующий документ %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Сборщик %r уже существует (в модуле %s)." +msgid "processing %s" +msgstr "обработка %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Сборщик %s не зарегистрирован явно или через ресурсы пакетов." +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "запись" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Сборщик %s не зарегистрирован." +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "разрешение ссылок..." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "домен %s уже зарегистрирован" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (в " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "домен %s не зарегистрирован" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "копирование изображений..." -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "Директива %r уже зарегистрирована в домене %s" +msgid "cannot copy image file %r: %s" +msgstr "Не получается скопировать файл изображения %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "Роль %r уже зарегистрирована в домене %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "копирование файлов поддержки Texinfo" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "Индекс %r уже зарегистрирован в домене %s" +msgid "error writing file Makefile: %s" +msgstr "ошибка записи Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "object_type %r уже зарегистрирован" +msgid "The manual pages are in %(outdir)s." +msgstr "Страницы руководств находятся в %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "%r crossref_type уже зарегистрирован" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "не найдено значение настройки \"man_pages\"; страницы руководств не были записаны" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r уже зарегистрирован" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "Значение параметра \"man_pages\" ссылается на неизвестный документ %s" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser для %r уже зарегистрирован" +msgid "The HTML page is in %(outdir)s." +msgstr "Страница HTML находится в %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "Парсер исходного кода %s не зарегистрирован" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "сборка единого документа" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "Перевод для %r уже существует" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "запись дополнительных файлов" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "kwargs для функции add_node() должны быть кортежем (visit, depart): %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "Глупый сборщик не генерирует файлы." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r уже зарегистрирован" +msgid "The message catalogs are in %(outdir)s." +msgstr "Каталоги сообщений находятся в %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "Движок отрисовки math %s уже зарегистрирован" +msgid "building [%s]: " +msgstr "сборка [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "расширение %r является частью Sphinx начиная с версии %s; это расширение игнорируется." +msgid "targets for %d template files" +msgstr "цели для %d файлов шаблонов" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Изначальное исключение:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "чтение шаблонов..." -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "Не удалось загрузить расширение %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "запись каталогов сообщений... " -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "расширение %r не определяет функцию setup(); это действительно модуль расширения Sphinx?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "Расширению %s, используемому в этом проекте, требуется версия Sphinx не ниже v%s, поэтому он не может быть собран с этой версией." +msgid "broken link: %s (%s)" +msgstr "сломанная ссылка: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "расширение %r вернуло неподдерживаемый объект из функции setup() function; оно должно вернуть None или словарь метаданных" - -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." -msgstr "`None` не является корректным типом файла для %r." +msgid "Anchor '%s' not found" +msgstr "Якорь '%s' не найден" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "Common Vulnerabilities and Exposures; CVE %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "" -#: roles.py:229 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid CVE number %s" -msgstr "неправильный номер CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "Ошибка компиляции регулярного выражения в linkcheck_allowed_redirects: %r %s" -#: roles.py:251 +#: builders/epub3.py:83 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "Common Weakness Enumeration; CWE %s" +msgid "The ePub file is in %(outdir)s." +msgstr "Файл ePub находится в %(outdir)s." -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" -msgstr "неправильный номер CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "запись файла nav.xhtml..." -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Предложения об улучшениях Python; PEP %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "настройка \"epub_language\" (или \"language\") должна быть не пустой при использовании EPUB3" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" -msgstr "неправильный номер PEP %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "значение настройки \"epub_uid\" должно быть равно XML NAME для EPUB3" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" -msgstr "неправильный номер RFC %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "значение настройки \"epub_title\" (или \"html_title\") должно быть не пустым для EPUB3" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[исходный код]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "значение настройки \"epub_author\" должно быть не пустым для EPUB3" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "подсветка кода модуля... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "значение настройки \"epub_contributor\" должно быть не пустым для EPUB3" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[документация]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "значение настройки \"epub_description\" должно быть не пустым для EPUB3" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Код модуля" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "значение настройки \"epub_publisher\" должно быть не пустым для EPUB3" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Исходный код %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "значение настройки \"epub_copyright\" (или \"copyright\") должно быть не пустым для EPUB3" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Обзор: исходный код модуля" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "значение настройки \"epub_identifier\" должно быть не пустым для EPUB3" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Все модули, в которых есть код

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "значение настройки \"version\" должно быть не пустым для EPUB3" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "прямая ссылка %r должна быть заменена на extlink (попробуйте использовать %r)" +msgid "invalid css_file: %r, ignored" +msgstr "некорректный css_file: %r, пропускается" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "секция \"%s\" отмечена как \"%s\"" +msgid "The XML files are in %(outdir)s." +msgstr "Файлы XML находятся в %(outdir)s." -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "повтоярющаяся метка %s, другой экземпляр в %s" - -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "Ссылка на эту формулу" +msgid "error writing file %s: %s" +msgstr "ошибка записи файла %s: %s" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Файлы pseudo-XML находятся в %(outdir)s." -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "не указан '+' или '-' в опции '%s'." +msgid "duplicated ToC entry found: %s" +msgstr "найден повторяющийся элемент оглавления: %s" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' — некорректная опция." +msgid "cannot read image file %r: copying it instead" +msgstr "Не получается считать файл изображение %r: скопируйте его" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' некорректная опция pyversion" +msgid "cannot write image file %r: %s" +msgstr "Не получается записать файл изображения %r: %s" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "неправильный тип TestCode" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow не найден - копирование файлов изображений" -#: ext/doctest.py:297 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Тестирование doctests в исходном каталоге завершено, посмотрите результаты в %(outdir)s/output.txt." +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "запись файла mimetype..." -#: ext/doctest.py:457 -#, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "запись файла META-INF/container.xml..." -#: ext/doctest.py:568 -#, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "пропускается некорректный код doctest: %r" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "запись файла content.opf..." -#: ext/imgmath.py:162 +#: builders/_epub_base.py:594 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "Команда LaTeX %r не может быть выполнена (требуется для отображения математики), проверьте настройку imgmath_latex" +msgid "unknown mimetype for %s, ignoring" +msgstr "неизвестный mimetype для %s, пропускается" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "Команда %s %r не может быть выполнена (требуется для отображения математики), проверьте настройку imgmath_%s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "неправильный уровень узла" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" -msgstr "отображение latex %r: %s" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "запись файла toc.ncx..." -#: ext/imgmath.py:380 +#: builders/_epub_base.py:802 #, python-format -msgid "inline latex %r: %s" -msgstr "встроенный LaTeX %r: %s" +msgid "writing %s file..." +msgstr "записывается %s файл..." -#: ext/coverage.py:48 +#: builders/text.py:27 #, python-format -msgid "invalid regex %r in %s" -msgstr "некорректное регулярное выражение %r в %s" +msgid "The text files are in %(outdir)s." +msgstr "Текстовые файлы находятся в %(outdir)s." -#: ext/coverage.py:140 ext/coverage.py:301 +#: builders/__init__.py:229 #, python-format -msgid "module %s could not be imported: %s" -msgstr "модуль %s не может быть импортирован: %s" +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "подходящий образ для сборщика %s не найден: %s (%s)" -#: ext/coverage.py:148 +#: builders/__init__.py:237 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "следующие модули документированы но не указаны в coverage_modules: %s" +msgid "a suitable image for %s builder not found: %s" +msgstr "подходящий образ для сборщика %s не найден: %s" -#: ext/coverage.py:158 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" -msgstr "следующие модули указаны в coverage_modules но не документированы" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "сборка [mo]:" -#: ext/coverage.py:172 -#, python-brace-format, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." -msgstr "" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "запись вывода..." -#: ext/coverage.py:187 +#: builders/__init__.py:280 #, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "некорректное регулярное выражение %r в coverage_c_regexes" +msgid "all of %d po files" +msgstr "все из %d po-файлов" -#: ext/coverage.py:260 +#: builders/__init__.py:302 #, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "недокументированный C API: %s [%s] в файле %s" +msgid "targets for %d po files that are specified" +msgstr "цели для %d файлов PO указаны" -#: ext/coverage.py:452 +#: builders/__init__.py:314 #, python-format -msgid "undocumented python function: %s :: %s" -msgstr "недокументированная функция Python: %s :: %s" +msgid "targets for %d po files that are out of date" +msgstr "цели для %d файлов PO устарели" -#: ext/coverage.py:473 -#, python-format -msgid "undocumented python class: %s :: %s" -msgstr "недокументированный класс Python: %s :: %s" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "все исходные файлы" -#: ext/coverage.py:492 +#: builders/__init__.py:335 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "недокументированный метод Python: %s :: %s :: %s" +msgid "file %r given on command line does not exist, " +msgstr "файл %r, указанный в аргументах командной строки, не существует," -#: ext/imgconverter.py:44 +#: builders/__init__.py:342 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "Не удалось запустить команду преобразования изображений %r. По умолчанию для 'sphinx.ext.imgconverter' требуется ImageMagick. Убедитесь, что он установлен, или укажите в опции 'image_converter' собственную команду преобразования.\n\nВывод: %s" +"file %r given on command line is not under the source directory, ignoring" +msgstr "файл %r, переданный в командной строке, не найден в исходном каталоге, пропускается" -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: builders/__init__.py:353 #, python-format -msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "преобразование выполнено с ошибкой:\n[stderr]\n%r\n[stdout]\n%r" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "файл %r, переданный в командной строке, не является корректным документом, пропускается" -#: ext/imgconverter.py:83 +#: builders/__init__.py:366 #, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "команда преобразования %r не может быть запущена, проверьте настройку image_converter" - -#: ext/graphviz.py:138 -msgid "Graphviz directive cannot have both content and a filename argument" -msgstr "В директиве graphviz нельзя одновременно использовать аргументы content и filename" +msgid "%d source files given on command line" +msgstr "%d исходных файлов передано в командной строке" -#: ext/graphviz.py:153 +#: builders/__init__.py:382 #, python-format -msgid "External Graphviz file %r not found or reading it failed" -msgstr "Внешний файл Graphviz %r не найден или недоступен для чтения" +msgid "targets for %d source files that are out of date" +msgstr "цели для %d не обновлённых исходных файлов" -#: ext/graphviz.py:164 -msgid "Ignoring \"graphviz\" directive without content." -msgstr "Пропускается директива \"graphviz\" без содержимого." +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "ищем файлы, устаревшие на данный момент... " -#: ext/graphviz.py:287 +#: builders/__init__.py:415 #, python-format -msgid "graphviz_dot executable path must be set! %r" -msgstr "Путь к исполняемому файлу graphviz_dot должен быть задан! %r" +msgid "%d found" +msgstr "%d найден" -#: ext/graphviz.py:328 -#, python-format -msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" -msgstr "команда dot %r не может быть выполнена (требуется для graphviz output), проверьте настройки graphviz_dot" - -#: ext/graphviz.py:339 -#, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "" - -#: ext/graphviz.py:344 -#, python-format -msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "" - -#: ext/graphviz.py:367 -#, python-format -msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" -msgstr "" - -#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 -#, python-format -msgid "dot code %r: %s" -msgstr "код dot %r: %s" - -#: ext/graphviz.py:493 ext/graphviz.py:501 -#, python-format -msgid "[graph: %s]" -msgstr "[иллюстрация: %s]" - -#: ext/graphviz.py:495 ext/graphviz.py:503 -msgid "[graph]" -msgstr "[иллюстрация]" - -#: ext/todo.py:61 -msgid "Todo" -msgstr "План" - -#: ext/todo.py:94 -#, python-format -msgid "TODO entry found: %s" -msgstr "найдена запись TODO: %s" - -#: ext/todo.py:152 -msgid "<>" -msgstr "<<исходная запись>>" - -#: ext/todo.py:154 -#, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<<Исходная запись>> находится в %s, строка %d.)" - -#: ext/todo.py:166 -msgid "original entry" -msgstr "исходный элемент" +#: builders/__init__.py:417 +msgid "none found" +msgstr "ничего не найдено" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: builders/__init__.py:424 +msgid "pickling environment" msgstr "" -#: directives/code.py:87 -#, python-format -msgid "Invalid caption: %s" -msgstr "Неправильный заголовок: %s" +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "проверка целостности" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 -#, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "указанный номер строки находится за границами диапазона(1-%d): %r" +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "нет устаревших целей." -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Нельзя одновременно использовать опции \"%s\" и \"%s\"" +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "обновление окружения:" -#: directives/code.py:231 +#: builders/__init__.py:499 #, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "" +msgid "%s added, %s changed, %s removed" +msgstr "%s добавлено, %s изменено, %s удалено" -#: directives/code.py:235 +#: builders/__init__.py:536 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" - -#: directives/code.py:276 -#, python-format -msgid "Object named %r not found in include file %r" -msgstr "Объект с названием %r не найден в подключенном файле %r" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "Sphinx не может загрузить основной документ (%s) потому что он соответствует встроенному шаблону исключений %r. Пожалуйста, переместите свой основной документ в другое расположение." -#: directives/code.py:314 +#: builders/__init__.py:545 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Указаны строки %r: ни одна строка не вставлена из файла %r" - -#: directives/patches.py:71 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "Опция \":file:\" директивы csv-table теперь рассчитывает абсолютный путь относительно исходного каталога. Пожалуйста, обновите свой документ." +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "Sphinx не может загрузить основной документ (%s), потому что он соответствует шаблону исключений, указанному в conf.py, %r. Пожалуйста, удалите этот шаблон из conf.py." -#: directives/other.py:119 +#: builders/__init__.py:556 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "глобальный шаблон toctree %r не соответствует ни одному документу" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "Sphinx не может загрузить основной документ (%s), потому что он не включен ни в один из настроенных include_patterns = %r. Убедитесь, что шаблон в include_patterns соответствует основному документу." -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: builders/__init__.py:563 #, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "дерево оглавления содержит ссылку на исключённый документ %r" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "Sphinx не удалось загрузить основной документ (%s). Основной документ должен размещаться внутри исходного каталога или в одном из его подкаталогов." -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "дерево оглавления содержит ссылку на несуществующий документ %r" +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "чтение исходных файлов..." -#: directives/other.py:169 +#: builders/__init__.py:725 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "повторяющееся значение в дереве оглавления: %s" - -#: directives/other.py:203 -msgid "Section author: " -msgstr "Автор раздела: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Автор модуля: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Автор кода:" +msgid "docnames to write: %s" +msgstr "названия документов для записи: %s" -#: directives/other.py:209 -msgid "Author: " -msgstr "Автор: " +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "содержимое .. acks не является списком" +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "подготовка документов" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "содержимое .. hlist не является списком" +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "копирование материалов" #: builders/changes.py:29 #, python-format msgid "The overview file is in %(outdir)s." msgstr "Обзорный файл находится в %(outdir)s." -#: builders/changes.py:56 +#: builders/changes.py:65 #, python-format msgid "no changes in version %s." msgstr "нет изменений в версии %s." -#: builders/changes.py:58 +#: builders/changes.py:67 msgid "writing summary file..." msgstr "запись итогового файла..." -#: builders/changes.py:70 +#: builders/changes.py:79 msgid "Builtins" msgstr "Встроенные функции" -#: builders/changes.py:72 +#: builders/changes.py:81 msgid "Module level" msgstr "Модуль" -#: builders/changes.py:124 +#: builders/changes.py:137 msgid "copying source files..." msgstr "копирование исходных файлов..." -#: builders/changes.py:133 +#: builders/changes.py:146 #, python-format msgid "could not read %r for changelog creation" msgstr "не удалось прочитать %r для создания журнала изменений" -#: builders/manpage.py:37 +#: ext/coverage.py:48 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Страницы руководств находятся в %(outdir)s." - -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "не найдено значение настройки \"man_pages\"; страницы руководств не были записаны" - -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "запись" +msgid "invalid regex %r in %s" +msgstr "некорректное регулярное выражение %r в %s" -#: builders/manpage.py:71 +#: ext/coverage.py:140 ext/coverage.py:301 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "Значение параметра \"man_pages\" ссылается на неизвестный документ %s" +msgid "module %s could not be imported: %s" +msgstr "модуль %s не может быть импортирован: %s" -#: builders/__init__.py:224 +#: ext/coverage.py:148 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "подходящий образ для сборщика %s не найден: %s (%s)" +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "следующие модули документированы но не указаны в coverage_modules: %s" -#: builders/__init__.py:232 +#: ext/coverage.py:158 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "подходящий образ для сборщика %s не найден: %s" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "сборка [mo]:" +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "запись вывода..." +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "" -#: builders/__init__.py:275 +#: ext/coverage.py:187 #, python-format -msgid "all of %d po files" -msgstr "все из %d po-файлов" +msgid "invalid regex %r in coverage_c_regexes" +msgstr "некорректное регулярное выражение %r в coverage_c_regexes" -#: builders/__init__.py:297 +#: ext/coverage.py:260 #, python-format -msgid "targets for %d po files that are specified" -msgstr "цели для %d файлов PO указаны" +msgid "undocumented c api: %s [%s] in file %s" +msgstr "недокументированный C API: %s [%s] в файле %s" -#: builders/__init__.py:309 +#: ext/coverage.py:452 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "цели для %d файлов PO устарели" +msgid "undocumented python function: %s :: %s" +msgstr "недокументированная функция Python: %s :: %s" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "все исходные файлы" +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "недокументированный класс Python: %s :: %s" -#: builders/__init__.py:330 +#: ext/coverage.py:492 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "файл %r, указанный в аргументах командной строки, не существует," +msgid "undocumented python method: %s :: %s :: %s" +msgstr "недокументированный метод Python: %s :: %s :: %s" -#: builders/__init__.py:337 +#: ext/extlinks.py:82 #, python-format msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "файл %r, переданный в командной строке, не найден в исходном каталоге, пропускается" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "прямая ссылка %r должна быть заменена на extlink (попробуйте использовать %r)" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "файл %r, переданный в командной строке, не является корректным документом, пропускается" +#: ext/todo.py:61 +msgid "Todo" +msgstr "План" -#: builders/__init__.py:361 +#: ext/todo.py:94 #, python-format -msgid "%d source files given on command line" -msgstr "%d исходных файлов передано в командной строке" - -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "цели для %d не обновлённых исходных файлов" - -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " -msgstr "сборка [%s]: " +msgid "TODO entry found: %s" +msgstr "найдена запись TODO: %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "ищем файлы, устаревшие на данный момент... " +#: ext/todo.py:152 +msgid "<>" +msgstr "<<исходная запись>>" -#: builders/__init__.py:410 +#: ext/todo.py:154 #, python-format -msgid "%d found" -msgstr "%d найден" +msgid "(The <> is located in %s, line %d.)" +msgstr "(<<Исходная запись>> находится в %s, строка %d.)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "ничего не найдено" +#: ext/todo.py:166 +msgid "original entry" +msgstr "исходный элемент" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "" +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "Не удалось запустить команду преобразования изображений %r. По умолчанию для 'sphinx.ext.imgconverter' требуется ImageMagick. Убедитесь, что он установлен, или укажите в опции 'image_converter' собственную команду преобразования.\n\nВывод: %s" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "проверка целостности" +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "преобразование выполнено с ошибкой:\n[stderr]\n%r\n[stdout]\n%r" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "нет устаревших целей." +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" +msgstr "команда преобразования %r не может быть запущена, проверьте настройку image_converter" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "обновление окружения:" +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" +msgstr "В директиве graphviz нельзя одновременно использовать аргументы content и filename" -#: builders/__init__.py:494 +#: ext/graphviz.py:153 #, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s добавлено, %s изменено, %s удалено" +msgid "External Graphviz file %r not found or reading it failed" +msgstr "Внешний файл Graphviz %r не найден или недоступен для чтения" + +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "Пропускается директива \"graphviz\" без содержимого." -#: builders/__init__.py:531 +#: ext/graphviz.py:287 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "Sphinx не может загрузить основной документ (%s) потому что он соответствует встроенному шаблону исключений %r. Пожалуйста, переместите свой основной документ в другое расположение." +msgid "graphviz_dot executable path must be set! %r" +msgstr "Путь к исполняемому файлу graphviz_dot должен быть задан! %r" -#: builders/__init__.py:540 +#: ext/graphviz.py:328 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "Sphinx не может загрузить основной документ (%s), потому что он соответствует шаблону исключений, указанному в conf.py, %r. Пожалуйста, удалите этот шаблон из conf.py." +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" +msgstr "команда dot %r не может быть выполнена (требуется для graphviz output), проверьте настройки graphviz_dot" -#: builders/__init__.py:551 +#: ext/graphviz.py:339 #, python-format msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "Sphinx не может загрузить основной документ (%s), потому что он не включен ни в один из настроенных include_patterns = %r. Убедитесь, что шаблон в include_patterns соответствует основному документу." +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "" -#: builders/__init__.py:558 +#: ext/graphviz.py:344 #, python-format msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "Sphinx не удалось загрузить основной документ (%s). Основной документ должен размещаться внутри исходного каталога или в одном из его подкаталогов." - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "чтение исходных файлов..." +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "" -#: builders/__init__.py:713 +#: ext/graphviz.py:367 #, python-format -msgid "docnames to write: %s" -msgstr "названия документов для записи: %s" - -#: builders/__init__.py:715 -msgid "no docnames to write!" +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "подготовка документов" - -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "копирование материалов" - -#: builders/__init__.py:883 +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "неперекодируемые исходные символы, заменены на \"?\": %r" +msgid "dot code %r: %s" +msgstr "код dot %r: %s" -#: builders/epub3.py:84 +#: ext/graphviz.py:493 ext/graphviz.py:501 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "Файл ePub находится в %(outdir)s." +msgid "[graph: %s]" +msgstr "[иллюстрация: %s]" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "запись файла nav.xhtml..." +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" +msgstr "[иллюстрация]" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "настройка \"epub_language\" (или \"language\") должна быть не пустой при использовании EPUB3" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "Команда LaTeX %r не может быть выполнена (требуется для отображения математики), проверьте настройку imgmath_latex" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "значение настройки \"epub_uid\" должно быть равно XML NAME для EPUB3" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "Команда %s %r не может быть выполнена (требуется для отображения математики), проверьте настройку imgmath_%s" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "значение настройки \"epub_title\" (или \"html_title\") должно быть не пустым для EPUB3" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "отображение latex %r: %s" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "значение настройки \"epub_author\" должно быть не пустым для EPUB3" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "встроенный LaTeX %r: %s" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "значение настройки \"epub_contributor\" должно быть не пустым для EPUB3" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "Ссылка на эту формулу" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "значение настройки \"epub_description\" должно быть не пустым для EPUB3" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "не указан '+' или '-' в опции '%s'." -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "значение настройки \"epub_publisher\" должно быть не пустым для EPUB3" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "'%s' — некорректная опция." -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "значение настройки \"epub_copyright\" (или \"copyright\") должно быть не пустым для EPUB3" +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' некорректная опция pyversion" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "значение настройки \"epub_identifier\" должно быть не пустым для EPUB3" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "неправильный тип TestCode" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "значение настройки \"version\" должно быть не пустым для EPUB3" +#: ext/doctest.py:297 +#, python-format +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Тестирование doctests в исходном каталоге завершено, посмотрите результаты в %(outdir)s/output.txt." -#: builders/epub3.py:279 builders/html/__init__.py:1291 +#: ext/doctest.py:451 #, python-format -msgid "invalid css_file: %r, ignored" -msgstr "некорректный css_file: %r, пропускается" +msgid "no code/output in %s block at %s:%s" +msgstr "" -#: builders/xml.py:31 +#: ext/doctest.py:568 #, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Файлы XML находятся в %(outdir)s." +msgid "ignoring invalid doctest code: %r" +msgstr "пропускается некорректный код doctest: %r" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 +#: ext/autosectionlabel.py:52 #, python-format -msgid "error writing file %s: %s" -msgstr "ошибка записи файла %s: %s" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "секция \"%s\" отмечена как \"%s\"" -#: builders/xml.py:101 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Файлы pseudo-XML находятся в %(outdir)s." +msgid "duplicate label %s, other instance in %s" +msgstr "повтоярющаяся метка %s, другой экземпляр в %s" -#: builders/texinfo.py:45 +#: ext/duration.py:47 #, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Файлы Texinfo находятся в %(outdir)s." +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" -#: builders/texinfo.py:48 +#: ext/duration.py:117 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +"====================== total reading duration ==========================" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "не найдено значение настройки \"texinfo_documents\"; документы не были записаны" - -#: builders/texinfo.py:89 +#: ext/duration.py:124 #, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "значение настройки \"texinfo_documents\" указывает на несуществующий документ %s" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" + +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 +#: ext/duration.py:139 #, python-format -msgid "processing %s" -msgstr "обработка %s" +msgid "%.3fs %s" +msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "разрешение ссылок..." +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[исходный код]" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (в " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "подсветка кода модуля... " -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "копирование изображений..." +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[документация]" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Код модуля" + +#: ext/viewcode.py:359 #, python-format -msgid "cannot copy image file %r: %s" -msgstr "Не получается скопировать файл изображения %r: %s" +msgid "

        Source code for %s

        " +msgstr "

        Исходный код %s

        " -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "копирование файлов поддержки Texinfo" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Обзор: исходный код модуля" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "ошибка записи Makefile: %s" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Все модули, в которых есть код

        " -#: builders/_epub_base.py:223 +#: domains/citation.py:75 #, python-format -msgid "duplicated ToC entry found: %s" -msgstr "найден повторяющийся элемент оглавления: %s" +msgid "duplicate citation %s, other instance in %s" +msgstr "повторное цитирование %s, другой экземпляр в %s" -#: builders/_epub_base.py:433 +#: domains/citation.py:92 #, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "Не получается считать файл изображение %r: скопируйте его" +msgid "Citation [%s] is not referenced." +msgstr "Ссылка на цитату [%s] отсутствует." -#: builders/_epub_base.py:464 +#: domains/math.py:73 #, python-format -msgid "cannot write image file %r: %s" -msgstr "Не получается записать файл изображения %r: %s" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "повторяющаяся метка уравнения %s, также используется в %s" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Pillow не найден - копирование файлов изображений" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "Неправильный math_eqref_format: %r" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "запись файла mimetype..." +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (встроенная функция)" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "запись файла META-INF/container.xml..." +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (метод %s)" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "запись файла content.opf..." +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (класс)" -#: builders/_epub_base.py:591 +#: domains/javascript.py:188 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "неизвестный mimetype для %s, пропускается" +msgid "%s (global variable or constant)" +msgstr "%s (глобальная переменная или константа)" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "неправильный уровень узла" +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" +msgstr "%s (атрибут %s)" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "запись файла toc.ncx..." +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Аргументы" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "записывается %s файл..." +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Бросает исключение" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "Глупый сборщик не генерирует файлы." +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Результат" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Каталоги сообщений находятся в %(outdir)s." +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Тип результата" -#: builders/gettext.py:266 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d template files" -msgstr "цели для %d файлов шаблонов" +msgid "%s (module)" +msgstr "%s (модуль)" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "чтение шаблонов..." +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "функция" -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "запись каталогов сообщений... " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "метод" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "Страница HTML находится в %(outdir)s." +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "класс" -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "сборка единого документа" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "данные" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "запись дополнительных файлов" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "атрибут" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "модуль" -#: builders/linkcheck.py:149 +#: domains/javascript.py:458 #, python-format -msgid "broken link: %s (%s)" -msgstr "сломанная ссылка: %s (%s)" +msgid "duplicate %s description of %s, other %s in %s" +msgstr "повтор описания %s для %s, другое %s в %s" -#: builders/linkcheck.py:548 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "Anchor '%s' not found" -msgstr "Якорь '%s' не найден" +msgid "%s (directive)" +msgstr "%s (директива)" -#: builders/linkcheck.py:758 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "Ошибка компиляции регулярного выражения в linkcheck_allowed_redirects: %r %s" +msgid ":%s: (directive option)" +msgstr ":%s: (опция директивы)" -#: builders/text.py:29 +#: domains/rst.py:224 #, python-format -msgid "The text files are in %(outdir)s." -msgstr "Текстовые файлы находятся в %(outdir)s." +msgid "%s (role)" +msgstr "%s (роль)" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "противоречивые ссылки на сноску в переведённом сообщении. Оригинал: {0}, перевод: {1}" +#: domains/rst.py:234 +msgid "directive" +msgstr "директива" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "противоречивые ссылки в переведённом сообщении. Оригинал: {0}, перевод: {1}" +#: domains/rst.py:235 +msgid "directive-option" +msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "противоречивые ссылки на цитату в переведённом сообщении. Оригинал: {0}, перевод: {1}" +#: domains/rst.py:236 +msgid "role" +msgstr "роль" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "противоречивая ссылка на термин в переведённом сообщении. Оригинал: {0}, перевод: {1}" +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "повторное описание %s %s, другой экземпляр в %s" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 +#: domains/changeset.py:32 #, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" +msgid "Added in version %s" +msgstr "Добавлено в версии %s" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "не удалось рассчитать прогресс перевода!" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "Изменено в версии %s" -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "нет переведённых элементов!" +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "Устарело, начиная с версии %s" -#: transforms/__init__.py:253 +#: domains/changeset.py:35 #, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "Найден четырёхстолбцовый индекс. Это может быть ошибкой используемого вами расширения: %r" +msgid "Removed in version %s" +msgstr "Удалено в версии %s" -#: transforms/__init__.py:294 +#: domains/__init__.py:322 #, python-format -msgid "Footnote [%s] is not referenced." -msgstr "Сссылка на сноску [%s] не определена." +msgid "%s %s" +msgstr "%s %s" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "Ссылка на сноску [*] не определена." +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "номер задания должен быть положительным числом" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "Ссылка на сноску [#] отсутствует." +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "Для получения дополнительной информации посетите ." -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "Использование:" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nСоздание документации из исходных файлов.\n\nsphinx-build создает документацию из файлов в SOURCEDIR и помещает ее в\nOUTPUTDIR. Он ищет 'conf.py' в SOURCEDIR для определения настроек\nконфигурации. Инструмент 'sphinx-quickstart' может быть использован для\nсоздания файлов шаблонов, включая 'conf.py'\n\nsphinx-build может создавать документацию в различных форматах. Формат\nвыбирается путем указания названия сборщика в аргументах командной\nстроки; по умолчанию используется HTML. Сборщики также могут\n выполнять другие задачи, связанные с обработкой документации.\n\nПо умолчанию собирается все что устарело. Вывод только для выбранных\nфайлов может быть реализован путем указания отдельных имен файлов.\n" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "{0} [ОПЦИИ] []" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "путь к исходным файлам документации" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "Генератор документации Sphinx." +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "путь к целевому каталогу" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "Команды:" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "(опционально) список файлов для пересборки. Пропускается если указано --write-all" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "Опции" +#: cmd/build.py:114 +msgid "general options" +msgstr "основные опции" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "Для получения дополнительной информации посетите https://www.sphinx-doc.org/en/master/man/." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "используемый сборщик (по умолчанию: 'html')" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/build.py:131 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "{0}: ошибка: {1}\nВыполните '{0} --help' для получения информации" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "запустить параллельно N процессов, если возможно. 'auto' соответствует числу ядер CPU" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "Управление документацией со Sphinx." +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "записать все файлы (по умолчанию: записать только новые и изменённые файлы)" -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "Показать версию и выйти." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "не использовать сохраненное окружение, всегда читать все файлы" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "Показать это сообщение и выйти." +#: cmd/build.py:150 +msgid "path options" +msgstr "опции пути" -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "Журналирование" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "каталог для дерева документов и файлов окружения (по умолчанию: OUTPUT_DIR/.doctrees)" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "Увеличить подробность (можно указать несколько раз)" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "каталог с файлом конфигурации (conf.py) (по умолчанию: SOURCE_DIR)" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "Выводить только ошибки и предупреждения." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "не использовать конфигурационный файл, только настройки, указанные в опциях -D" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "переопределяет настройки в конфигурационном файле" -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "передать значение в шаблон HTML" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "См. 'sphinx --help'.\n" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "определить тег: включить \"только\" блоги с ТЕГОМ" -#: environment/__init__.py:86 -msgid "new config" -msgstr "новая конфигурация" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "придирчивый режим: предупреждать обо всех потерянных ссылках" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "конфигурация изменена" +#: cmd/build.py:212 +msgid "console output options" +msgstr "опции вывода в терминал" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "расширения изменились" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "увеличить детальность (может повторяться несколько раз)" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "версия окружения сборки отличается от текущей" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "без вывода в stdout, только предупреждения в stderr" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "каталог исходных файлов изменился" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "Конфигурация изменилась (1 опция: %r)" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "использовать цветной вывод (по умолчанию: автоопределение)" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "Конфигурация изменилась (%d опций: %s)" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "не использовать цветной вывод (по умолчанию: автоопределение)" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "Конфигурация изменилась (%d опций: %s, ...)" +#: cmd/build.py:252 +msgid "warning control options" +msgstr "настройки предупреждений" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "Это окружение несовместимо с выбранным сборщиком, пожалуйста, выберите другой каталог doctree." +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "запись предупреждений (и ошибок) в указанный файл" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "Ошибка сканирования документов в %s: %r" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "обрабатывать предупреждение как ошибки" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "Домен %r не зарегистрирован" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "отображать полный traceback при исключении" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "документ не включен ни в одно оглавление" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "запустить Pdb при исключении" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "найдено оглавление, ссылающееся на само себя. Пропускается." +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "возбудить исключение при предупреждении" + +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "Невозможно совмещать ключ -a и названия файлов" -#: environment/__init__.py:889 +#: cmd/build.py:357 #, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "ошибка чтения: %s, %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "аргументы с опцией -D должны быть указаны в виде пар название=значение" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "ошибка записи: %s, %s" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "аргумент опции -A должен быть указан в виде пары название=значение" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "locale_dir %s не существует" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "автоматически вставлены docstrings из модулей" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "автоматическое тестирование фрагментов кода в блоках doctest" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Неправильный формат даты. Оберните строку в одинарные кавычки, если хоитет вывести её \"как есть\": %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "связь между разными проектами Sphinx" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "Проблема в домене %s: предполагается, что в поле должна использоваться роль '%s', но этой роли нет в домене." +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "укажите записи \"todo\", которые могут быть показаны или скрыты при сборке" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "%r считается устаревшим для записей индекса (из записи %r). Вместо этого используйте 'pair: %s'." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "проверка полноты документации" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "оглавление содержит ссылку на несуществующий файл %r" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "включить математику, отображаемую как изображения PNG или SVG" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "исключение при вычислении значения директивы only: %s" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "включить математику, отображаемую в браузере с помомощью MathJax" -#: util/display.py:82 -msgid "skipped" -msgstr "пропущено" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "условное включение содержимого на основе значений конфигурации" -#: util/display.py:87 -msgid "failed" -msgstr "сбой" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "включить ссылки на исходный код документируемых объектов Python" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "создать файл .nojekyll для публикации документа на GitHub Pages" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Пожалуйста, укажите корректный путь." -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Пожалуйста, введите текст." -#: util/docutils.py:789 +#: cmd/quickstart.py:134 #, python-format -msgid "unknown node type: %r" -msgstr "неизвестный тип узла: %r" +msgid "Please enter one of %s." +msgstr "Пожалуйста, введите одно из %s." -#: util/fileutil.py:76 -#, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Пожалуйста, введите 'y' или 'n'." -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "Запись результатов обработки шаблона в %s" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Пожалуйста, введите расширение файла, например, '.rst' или '.txt'." -#: util/rst.py:73 +#: cmd/quickstart.py:230 #, python-format -msgid "default role %s not found" -msgstr "роль по умолчанию %s не найдена" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Добро пожаловать в утилиту quickstart Sphinx %s." -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "инвентарь <%s> содержит повторяющиеся определения %s" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Пожалуйста, введите значения для следующих настроек (нажмите Enter для\nиспользования значения по умолчанию, оно указано в квадратных скобках)." -#: util/inventory.py:166 +#: cmd/quickstart.py:242 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "инвентарь <%s> содержит множество определений для %s" +msgid "Selected root path: %s" +msgstr "Выбранный корневой путь: %s" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Сноски" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Введите корневой путь для документации." -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[рисунок: %s]" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Корневой каталог документации" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[рисунок]" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Ошибка: по указанному корневому пути уже существует conf.py." -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Алфавитный указатель" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart не будет перезаписывать существующие проекты Sphinx." + +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Пожалуйста, укажите новый корневой путь (или нажмите Enter для выхода)" -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:274 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "заголовок не внутри иллюстрации." +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Разделить каталоги исходных файлов и результатов сборки (y/n)" -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "нереализованный тип узла: %r" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "Внутри корневого каталога могут быт ьсозданы 2 каталога; \"_templates\"\nдля собственных шаблонов HTML и \"_static\" для таблиц стилей и других статичных\nфайлов. Вы можете ввести другой префикс (например, \".\") для замены знака подчёркивания." -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "неизвестный %r toplevel_sectioning для класса %r" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Префикс имен каталогов с шаблонами и статикой" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "неизвестная опция Babel для языка %r" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "Название проекта будет встречаться в нескольких местах рабочей документации." -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "слишком большое значение :maxdepth:, пропускается." +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Название проекта" -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "шаблон %s не найден; вместо этого загружается унаследованный %s" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Имя(ена) автора(ов)" -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "заголовок документа не является одиночным Text node" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx использует понятия \"версия\" и \"релиз\" для \nпрограммного обеспечения. Каждая версия может иметь несколько релизов. Например, для\nPyhon версии выглядят как 2.5 или 3.0, при этом релизы\nвыглядят как 2.5.1 или 3.0a1. Если вам не нужна двойная структура,\nпросто используйте одно и то же значение для обоих параметров." -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "неподдерживаемый уровень заголовка рубрики: %s" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Версия проекта" -#: writers/latex.py:1183 +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Релиз проекта" + +#: cmd/quickstart.py:324 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "заданы tabularcolumns и опция :widths:. :widths: пропускается." +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "Если для написания документации используется язык, отличный от английского,\nвы можете указать его здесь, выбрав нужный код языка. Затем Sphinx переведёт генерируемый текст на этот язык.\n\nДля получения списка поддерживаемых кодов см.\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "неправильная единица измерения %s. Пропускается." +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Язык проекта" -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "найдена запись неизвестного типа индекса %s" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "Расширение исходных файлов. Как правило, это \".txt\"\nили \".rst\". Только файлы с указанным расширением считаются документами." -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "Неправильный math_eqref_format: %r" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Суффикс исходный файлов" -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "Ссылка на это определение" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "" -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "numfig_format не определён для %s" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Название основного документа (без суффикса)" -#: writers/html5.py:441 +#: cmd/quickstart.py:368 #, python-format -msgid "Any IDs not assigned for %s node" -msgstr "Любые ID не разрешены для узла %s" +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Ошибка: основной файл %s уже существует в корневом каталоге по указанному пути." -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "Ссылка на этот термин" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart не перезапишет существующий файл." -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "Ссылка на этот заголовок" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Введите имя нового файла, или переименуйте существующий файл и нажмите Enter" -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "Ссылка на эту таблицу" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Укажите, какие из расширений Sphinx должны быть включены:" -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "Ссылка на этот код" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Примечание: imgmath и mathjax не могут быть включены одновременно. imgmath выключен." -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "Ссылка на это изображение" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Makefile и командный файл Windows могут быть сгенерированы,\nчтобы вы могли выполнять `make html' вместо прямого вызова\nsphinx-build." -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "Ссылка на это оглавление" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Создать Makefile? (y/n)" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "Не удалось получить размеры изображения. Опция :scale: пропускается." +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Создать файл команд Windows? (y/n)" -#: domains/__init__.py:322 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "Creating file %s." +msgstr "Создание файла %s." -#: domains/math.py:73 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "повторяющаяся метка уравнения %s, также используется в %s" +msgid "File %s already exists, skipping." +msgstr "Файл %s уже существует, пропускаем." -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (встроенная функция)" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Завершено: Исходная структура каталогов создана." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: cmd/quickstart.py:520 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (метод %s)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Теперь вам нужно заполнить свой основной файл %s и создать другие\nисходные файлы документации. " -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (класс)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Используйте Makefile для сборки документации, например:\n make builder" -#: domains/javascript.py:187 +#: cmd/quickstart.py:531 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s (глобальная переменная или константа)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Используйте команду sphinx-build для сборки документации, например:\n sphinx-build -b builder %s %s" -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (атрибут %s)" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "где \"builder\" - один из поддерживаемых сборщиков, например, html, latex или linkcheck." -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Аргументы" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nГенерирует необходимые файлы для проекта Sphinx.\n\nsphinx-quickstart это интерактивный инструмент, который задаст вам несколько вопросов о вашем\nпроекте и затем полностью сгенерирует каталог документации и пример\nMakefile для использования со sphinx-build.\n" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Бросает исключение" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "тихий режим" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Результат" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "корень проекта" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Тип результата" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Опции структуры" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (модуль)" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "если указано, разделить исходный и целевой каталоги" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "функция" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "если указано, разместить целевой каталог в исходном" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "метод" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "замена точки в _templates и т. п." -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "класс" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Основные настройки проекта" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "данные" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "название проекта" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "атрибут" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "имена авторов" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "модуль" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "повтор описания %s для %s, другое %s в %s" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "версия проекта" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "Добавлено в версии %s" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "релиз проекта" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Изменено в версии %s" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "язык документа" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Устарело, начиная с версии %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "суффикс исходных файлов" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "Удалено в версии %s" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "название основного документа" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (директива)" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "использовать epub" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (опция директивы)" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Опции расширения" -#: domains/rst.py:224 +#: cmd/quickstart.py:671 #, python-format -msgid "%s (role)" -msgstr "%s (роль)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "директива" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" +msgid "enable %s extension" +msgstr "включить расширение %s" -#: domains/rst.py:236 -msgid "role" -msgstr "роль" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "включить произвольные расширения" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "повторное описание %s %s, другой экземпляр в %s" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Создание Makefile и Batchfile" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "повторное цитирование %s, другой экземпляр в %s" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "создать Makefile" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "Ссылка на цитату [%s] отсутствует." +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "не создавать Makefile" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Внимание" +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "создать batchfile" -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Осторожно" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "не создавать batchfile" -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Опасно" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "использовать make-mode для Makefile/make.bat" -#: locale/__init__.py:231 -msgid "Error" -msgstr "Ошибка" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Шаблонизация проекта" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Подсказка" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "каталог шаблонов для файлов шаблонов" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Важно" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "определить переменную шаблона" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Примечание" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "указано \"quiet\", но \"project\" или \"author\" не заданы." -#: locale/__init__.py:235 -msgid "See also" -msgstr "См. также" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Ошибка: указанный путь не является каталогом или файлы Sphinx в нём уже существуют." -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Совет" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart генерирует только в пустой каталог. Пожалуйста, укажите новый корневой путь." -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Предупреждение" +#: cmd/quickstart.py:810 +#, python-format +msgid "Invalid template variable: %s" +msgstr "Неправильная переменная шаблона: %s" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "автоматически вставлены docstrings из модулей" +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" +msgstr "глобальный шаблон toctree %r не соответствует ни одному документу" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "автоматическое тестирование фрагментов кода в блоках doctest" +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" +msgstr "дерево оглавления содержит ссылку на исключённый документ %r" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "связь между разными проектами Sphinx" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "дерево оглавления содержит ссылку на несуществующий документ %r" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "укажите записи \"todo\", которые могут быть показаны или скрыты при сборке" +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "повторяющееся значение в дереве оглавления: %s" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "проверка полноты документации" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Автор раздела: " -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "включить математику, отображаемую как изображения PNG или SVG" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Автор модуля: " -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "включить математику, отображаемую в браузере с помомощью MathJax" +#: directives/other.py:207 +msgid "Code author: " +msgstr "Автор кода:" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "условное включение содержимого на основе значений конфигурации" +#: directives/other.py:209 +msgid "Author: " +msgstr "Автор: " -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "включить ссылки на исходный код документируемых объектов Python" +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "содержимое .. acks не является списком" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "создать файл .nojekyll для публикации документа на GitHub Pages" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "содержимое .. hlist не является списком" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Пожалуйста, укажите корректный путь." +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "Опция \":file:\" директивы csv-table теперь рассчитывает абсолютный путь относительно исходного каталога. Пожалуйста, обновите свой документ." -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Пожалуйста, введите текст." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "" -#: cmd/quickstart.py:133 +#: directives/code.py:87 #, python-format -msgid "Please enter one of %s." -msgstr "Пожалуйста, введите одно из %s." +msgid "Invalid caption: %s" +msgstr "Неправильный заголовок: %s" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Пожалуйста, введите 'y' или 'n'." +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" +msgstr "указанный номер строки находится за границами диапазона(1-%d): %r" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Пожалуйста, введите расширение файла, например, '.rst' или '.txt'." +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Нельзя одновременно использовать опции \"%s\" и \"%s\"" -#: cmd/quickstart.py:229 +#: directives/code.py:231 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Добро пожаловать в утилиту quickstart Sphinx %s." +msgid "Include file '%s' not found or reading it failed" +msgstr "" -#: cmd/quickstart.py:234 +#: directives/code.py:235 +#, python-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Пожалуйста, введите значения для следующих настроек (нажмите Enter для\nиспользования значения по умолчанию, оно указано в квадратных скобках)." +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" -#: cmd/quickstart.py:241 +#: directives/code.py:276 #, python-format -msgid "Selected root path: %s" -msgstr "Выбранный корневой путь: %s" +msgid "Object named %r not found in include file %r" +msgstr "Объект с названием %r не найден в подключенном файле %r" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "Введите корневой путь для документации." +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Корневой каталог документации" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Указаны строки %r: ни одна строка не вставлена из файла %r" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Ошибка: по указанному корневому пути уже существует conf.py." +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart не будет перезаписывать существующие проекты Sphinx." - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Пожалуйста, укажите новый корневой путь (или нажмите Enter для выхода)" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Алфавитный указатель" -#: cmd/quickstart.py:273 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Разделить каталоги исходных файлов и результатов сборки (y/n)" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "Внутри корневого каталога могут быт ьсозданы 2 каталога; \"_templates\"\nдля собственных шаблонов HTML и \"_static\" для таблиц стилей и других статичных\nфайлов. Вы можете ввести другой префикс (например, \".\") для замены знака подчёркивания." - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Префикс имен каталогов с шаблонами и статикой" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "Название проекта будет встречаться в нескольких местах рабочей документации." - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Название проекта" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Сноски" -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Имя(ена) автора(ов)" +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "заголовок не внутри иллюстрации." -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "Sphinx использует понятия \"версия\" и \"релиз\" для \nпрограммного обеспечения. Каждая версия может иметь несколько релизов. Например, для\nPyhon версии выглядят как 2.5 или 3.0, при этом релизы\nвыглядят как 2.5.1 или 3.0a1. Если вам не нужна двойная структура,\nпросто используйте одно и то же значение для обоих параметров." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "нереализованный тип узла: %r" -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Версия проекта" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[рисунок: %s]" -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Релиз проекта" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[рисунок]" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "Если для написания документации используется язык, отличный от английского,\nвы можете указать его здесь, выбрав нужный код языка. Затем Sphinx переведёт генерируемый текст на этот язык.\n\nДля получения списка поддерживаемых кодов см.\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "Ссылка на это определение" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Язык проекта" +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" +msgstr "numfig_format не определён для %s" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "Расширение исходных файлов. Как правило, это \".txt\"\nили \".rst\". Только файлы с указанным расширением считаются документами." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "Любые ID не разрешены для узла %s" -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Суффикс исходный файлов" +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "Ссылка на этот термин" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "Ссылка на этот заголовок" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Название основного документа (без суффикса)" +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "Ссылка на эту таблицу" -#: cmd/quickstart.py:367 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Ошибка: основной файл %s уже существует в корневом каталоге по указанному пути." - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart не перезапишет существующий файл." - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Введите имя нового файла, или переименуйте существующий файл и нажмите Enter" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Укажите, какие из расширений Sphinx должны быть включены:" +msgid "unsupported rubric heading level: %s" +msgstr "неподдерживаемый уровень заголовка рубрики: %s" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Примечание: imgmath и mathjax не могут быть включены одновременно. imgmath выключен." +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "Ссылка на этот код" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Makefile и командный файл Windows могут быть сгенерированы,\nчтобы вы могли выполнять `make html' вместо прямого вызова\nsphinx-build." +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "Ссылка на это изображение" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Создать Makefile? (y/n)" +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "Ссылка на это оглавление" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Создать файл команд Windows? (y/n)" +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "Не удалось получить размеры изображения. Опция :scale: пропускается." -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:386 #, python-format -msgid "Creating file %s." -msgstr "Создание файла %s." +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "неизвестный %r toplevel_sectioning для класса %r" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "File %s already exists, skipping." -msgstr "Файл %s уже существует, пропускаем." +msgid "no Babel option known for language %r" +msgstr "неизвестная опция Babel для языка %r" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Завершено: Исходная структура каталогов создана." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "слишком большое значение :maxdepth:, пропускается." -#: cmd/quickstart.py:519 +#: writers/latex.py:616 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "Теперь вам нужно заполнить свой основной файл %s и создать другие\nисходные файлы документации. " +msgid "template %s not found; loading from legacy %s instead" +msgstr "шаблон %s не найден; вместо этого загружается унаследованный %s" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "заголовок документа не является одиночным Text node" -#: cmd/quickstart.py:526 +#: writers/latex.py:1198 msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Используйте Makefile для сборки документации, например:\n make builder" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "заданы tabularcolumns и опция :widths:. :widths: пропускается." -#: cmd/quickstart.py:530 +#: writers/latex.py:1228 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Используйте команду sphinx-build для сборки документации, например:\n sphinx-build -b builder %s %s" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "где \"builder\" - один из поддерживаемых сборщиков, например, html, latex или linkcheck." +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "неправильная единица измерения %s. Пропускается." -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nГенерирует необходимые файлы для проекта Sphinx.\n\nsphinx-quickstart это интерактивный инструмент, который задаст вам несколько вопросов о вашем\nпроекте и затем полностью сгенерирует каталог документации и пример\nMakefile для использования со sphinx-build.\n" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "найдена запись неизвестного типа индекса %s" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "Для получения дополнительной информации посетите ." +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "Использование:" -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "тихий режим" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "{0} [ОПЦИИ] []" -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "корень проекта" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "Генератор документации Sphinx." -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Опции структуры" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "Команды:" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "если указано, разделить исходный и целевой каталоги" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "Опции" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "если указано, разместить целевой каталог в исходном" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "Для получения дополнительной информации посетите https://www.sphinx-doc.org/en/master/man/." -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "замена точки в _templates и т. п." +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "{0}: ошибка: {1}\nВыполните '{0} --help' для получения информации" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Основные настройки проекта" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "Управление документацией со Sphinx." -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "название проекта" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "Показать версию и выйти." -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "имена авторов" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "Показать это сообщение и выйти." -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "версия проекта" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "Журналирование" -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "релиз проекта" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "Увеличить подробность (можно указать несколько раз)" -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "язык документа" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "Выводить только ошибки и предупреждения." -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "суффикс исходных файлов" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "название основного документа" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "использовать epub" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "См. 'sphinx --help'.\n" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Опции расширения" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "противоречивые ссылки на сноску в переведённом сообщении. Оригинал: {0}, перевод: {1}" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" -msgstr "включить расширение %s" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "противоречивые ссылки в переведённом сообщении. Оригинал: {0}, перевод: {1}" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "включить произвольные расширения" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "противоречивые ссылки на цитату в переведённом сообщении. Оригинал: {0}, перевод: {1}" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Создание Makefile и Batchfile" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "противоречивая ссылка на термин в переведённом сообщении. Оригинал: {0}, перевод: {1}" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "создать Makefile" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "не удалось рассчитать прогресс перевода!" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "не создавать Makefile" +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "нет переведённых элементов!" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "создать batchfile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "Найден четырёхстолбцовый индекс. Это может быть ошибкой используемого вами расширения: %r" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "не создавать batchfile" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "Сссылка на сноску [%s] не определена." -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "использовать make-mode для Makefile/make.bat" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "Ссылка на сноску [*] не определена." -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Шаблонизация проекта" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "Ссылка на сноску [#] отсутствует." -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "каталог шаблонов для файлов шаблонов" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "инвентарь <%s> содержит повторяющиеся определения %s" -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "определить переменную шаблона" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "инвентарь <%s> содержит множество определений для %s" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "указано \"quiet\", но \"project\" или \"author\" не заданы." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "ошибка чтения: %s, %s" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Ошибка: указанный путь не является каталогом или файлы Sphinx в нём уже существуют." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "ошибка записи: %s, %s" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart генерирует только в пустой каталог. Пожалуйста, укажите новый корневой путь." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "locale_dir %s не существует" -#: cmd/quickstart.py:809 +#: util/i18n.py:244 #, python-format -msgid "Invalid template variable: %s" -msgstr "Неправильная переменная шаблона: %s" +msgid "Invalid Babel locale: %r." +msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "номер задания должен быть положительным числом" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Неправильный формат даты. Оберните строку в одинарные кавычки, если хоитет вывести её \"как есть\": %s" -#: cmd/build.py:74 +#: util/osutil.py:131 +#, python-format msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\nСоздание документации из исходных файлов.\n\nsphinx-build создает документацию из файлов в SOURCEDIR и помещает ее в\nOUTPUTDIR. Он ищет 'conf.py' в SOURCEDIR для определения настроек\nконфигурации. Инструмент 'sphinx-quickstart' может быть использован для\nсоздания файлов шаблонов, включая 'conf.py'\n\nsphinx-build может создавать документацию в различных форматах. Формат\nвыбирается путем указания названия сборщика в аргументах командной\nстроки; по умолчанию используется HTML. Сборщики также могут\n выполнять другие задачи, связанные с обработкой документации.\n\nПо умолчанию собирается все что устарело. Вывод только для выбранных\nфайлов может быть реализован путем указания отдельных имен файлов.\n" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "путь к исходным файлам документации" +#: util/display.py:82 +msgid "skipped" +msgstr "пропущено" -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "путь к целевому каталогу" +#: util/display.py:87 +msgid "failed" +msgstr "сбой" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "(опционально) список файлов для пересборки. Пропускается если указано --write-all" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "" -#: cmd/build.py:114 -msgid "general options" -msgstr "основные опции" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "используемый сборщик (по умолчанию: 'html')" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "неизвестный тип узла: %r" -#: cmd/build.py:131 +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "запустить параллельно N процессов, если возможно. 'auto' соответствует числу ядер CPU" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "записать все файлы (по умолчанию: записать только новые и изменённые файлы)" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" +msgstr "Запись результатов обработки шаблона в %s" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "не использовать сохраненное окружение, всегда читать все файлы" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "Проблема в домене %s: предполагается, что в поле должна использоваться роль '%s', но этой роли нет в домене." -#: cmd/build.py:150 -msgid "path options" -msgstr "опции пути" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "роль по умолчанию %s не найдена" -#: cmd/build.py:157 +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "каталог для дерева документов и файлов окружения (по умолчанию: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "каталог с файлом конфигурации (conf.py) (по умолчанию: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "оглавление содержит ссылку на несуществующий файл %r" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "не использовать конфигурационный файл, только настройки, указанные в опциях -D" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "исключение при вычислении значения директивы only: %s" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "переопределяет настройки в конфигурационном файле" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "продолжение с предыдущей страницы" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "передать значение в шаблон HTML" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "продолжается на следующей странице" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "определить тег: включить \"только\" блоги с ТЕГОМ" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "Не-алфавитный" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "придирчивый режим: предупреждать обо всех потерянных ссылках" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Символы" -#: cmd/build.py:212 -msgid "console output options" -msgstr "опции вывода в терминал" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Числа" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "увеличить детальность (может повторяться несколько раз)" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "страница" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "без вывода в stdout, только предупреждения в stderr" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Выпуск" + +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "Не удалось получить изображение из внешнего источника: %s [%s]" + +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "Не удалось получить изображение из внешнего источника: %s [%d]" + +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Неизвестный формат изображения: %s..." -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "использовать цветной вывод (по умолчанию: автоопределение)" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "не использовать цветной вывод (по умолчанию: автоопределение)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "для перекрёстной ссылки 'any' найдено больше одной цели %r: должно быть %s" -#: cmd/build.py:252 -msgid "warning control options" -msgstr "настройки предупреждений" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s цель перекрёстной ссылки не найдена: %s" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "запись предупреждений (и ошибок) в указанный файл" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r цель перекрёстной ссылки не найдена: %s" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "обрабатывать предупреждение как ошибки" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "Прервано!" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "отображать полный traceback при исключении" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "запустить Pdb при исключении" +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "возбудить исключение при предупреждении" +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "Невозможно совмещать ключ -a и названия файлов" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "аргументы с опцией -D должны быть указаны в виде пар название=значение" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "Полный журнал будет сохранен в:" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "аргумент опции -A должен быть указан в виде пары название=значение" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "Чтобы сообщить об этой ошибке разработчикам, пожалуйста, откройте запрос в . Спасибо!" + +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Свернуть боковую панель" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Оглавление" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Навигация" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Поиск в документе «%(docstitle)s»" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Об этих документах" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Поиск" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Искать" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Авторские права" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Обновлено: %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Создано с использованием Sphinx %(sphinx_version)s." + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Предыдущий раздел" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "предыдущая глава" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Следующий раздел" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "следующая глава" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "Индекс – %(key)s" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Полный алфавитный указатель на одной странице" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Эта страница" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Исходный текст" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Содержание" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Быстрый поиск" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Поиск в документе «%(docstitle)s»" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Искать" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2691,7 +2891,7 @@ msgstr "Алфавитный указатель модулей" msgid "quick access to all modules" msgstr "сводный список всех модулей" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Алфавитный указатель" @@ -2699,23 +2899,15 @@ msgstr "Алфавитный указатель" msgid "all functions, classes, terms" msgstr "все функции, классы, переменные и константы" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Эта страница" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Оглавление" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "Индекс – %(key)s" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Полный алфавитный указатель на одной странице" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Быстрый поиск" +msgid "Search %(docstitle)s" +msgstr "Поиск в документе «%(docstitle)s»" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2725,57 +2917,6 @@ msgstr "Указатели по буквам алфавита" msgid "can be huge" msgstr "может быть очень большим" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Предыдущий раздел" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "предыдущая глава" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Следующий раздел" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "следующая глава" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Навигация" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Поиск в документе «%(docstitle)s»" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Об этих документах" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Авторские права" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Обновлено: %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Создано с использованием Sphinx %(sphinx_version)s." - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2792,21 +2933,21 @@ msgstr "Поиск по нескольким словам отображает msgid "search" msgstr "искать" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Снять выделение" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Содержание" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Результаты поиска" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "По вашему поиску не найдено ни одного документа. Проверьте, что все слова написаны без ошибок, и что вы выбрали достаточно категорий." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2816,22 +2957,21 @@ msgstr[1] "" msgstr[2] "" msgstr[3] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Идёт поиск" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Подготовка поиска…" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " -msgstr ", в" - -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +msgstr ", в" + +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Снять выделение" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2839,6 +2979,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Изменения в версии %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2860,120 +3005,127 @@ msgstr "Другие изменения" msgid "Expand sidebar" msgstr "Развернуть боковую панель" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Параметры" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Переменные" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Исключение" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (в модуле %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (в модуле %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (встроенная переменная)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (встроенный класс)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (класс в %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (метод класса %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (статический метод %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (свойство %s)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "%s (псевдоним типа в %s)" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Содержание модулей Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "модули" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Устарело" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "исключение" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "метод класса" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "статический метод" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "свойство" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "псевдоним типа" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "повторное описание объекта %s, другой экземпляр в %s, используйте :no-index: для одного из них" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "найдено больше одной цели для перекрёстной ссылки %r: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "(использование не рекомендуется)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Параметры" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Переменные" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Исключение" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "Повторная декларация C++, также определено как %s:%s.\nДекларация в '.. cpp:%s:: %s'." #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2984,92 +3136,85 @@ msgstr "Параметры шаблона" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "Повторная декларация C++, также определено как %s:%s.\nДекларация в '.. cpp:%s:: %s'." - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "Возвращаемые значения" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "объединение" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "поле" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "тип" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "концепт" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "перечисляемый тип" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "перечислитель" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "параметр функции" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "параметр шаблона" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Повторная декларация C, также определено как %s:%s.\nДекларация в '.. c:%s:: %s'." -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "переменная" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "макрос" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "структура" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "переменная окружения; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "%s; значение настройки" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "Тип" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "По умолчанию" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3109,621 +3254,408 @@ msgstr "токен грамматики" msgid "reference label" msgstr "текст ссылки" -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "переменная окружения" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "опция программы" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "документ" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Состав модуля" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "duplicate %s description of %s, other instance in %s" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "numfig выключен. :numref: пропускается." - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "Ошибка создания перекрёстной ссылки. Какой-либо номер не присвоен: %s" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "ссылка без заголовка: %s" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "неправильный numfig_format: %s (%r)" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "неправильный numfig_format: %s" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "неопределённая метка: %r" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "Ошибка создания перекрёстной ссылки. Заголовок или подзаголовок не найдены: %r" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "обнаружены циклические ссылки в оглавлении, пропускается: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "оглавление содержит ссылку на документ %r, у которого нет заголовка: ссылка не будет сгенерирована" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "toctree содержит ссылку на не включенный документ %r" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "см. %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "также см. %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "неизвестная запись типа индекса %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Символы" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "нечитаемое изображение: %s" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "файл изображения %s не читается: %s" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "загружаемый файл не читается: %s" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "Прервано!" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "Полный журнал будет сохранен в:" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "Чтобы сообщить об этой ошибке разработчикам, пожалуйста, откройте запрос в . Спасибо!" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" - -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "для перекрёстной ссылки 'any' найдено больше одной цели %r: должно быть %s" - -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s цель перекрёстной ссылки не найдена: %s" - -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "%r цель перекрёстной ссылки не найдена: %s" - -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "Не удалось получить изображение из внешнего источника: %s [%s]" - -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "Не удалось получить изображение из внешнего источника: %s [%d]" - -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." -msgstr "Неизвестный формат изображения: %s..." - -#: builders/html/__init__.py:113 -#, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "Страницы HTML находятся в %(outdir)s." - -#: builders/html/__init__.py:348 -#, python-format -msgid "Failed to read build info file: %r" -msgstr "Ошибка чтения при сборке файла info: %r" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "несоответствие build_info, копирование .buildinfo в .buildinfo.bak" - -#: builders/html/__init__.py:366 -msgid "building [html]: " -msgstr "сборка [html]: " - -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "шаблон %s был изменён с момента предыдущей сборки, все документы будут пересобраны" - -#: builders/html/__init__.py:507 -msgid "index" -msgstr "указатель" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "переменная окружения" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "Логотип %s" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "опция программы" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "вперёд" +#: domains/std/__init__.py:735 +msgid "document" +msgstr "документ" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "назад" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Состав модуля" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "генерация индексов" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" +msgstr "duplicate %s description of %s, other instance in %s" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "запись дополнительных страниц" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "numfig выключен. :numref: пропускается." -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "не удалось скопировать файл изображения '%s': %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" +msgstr "Ошибка создания перекрёстной ссылки. Какой-либо номер не присвоен: %s" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "копирование загружаемых файлов..." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" +msgstr "ссылка без заголовка: %s" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1153 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "не удалось скопировать загружаемый файл %r: %s" +msgid "invalid numfig_format: %s (%r)" +msgstr "неправильный numfig_format: %s (%r)" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1157 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "Ошибка копирования файла в каталог 'static' темы: %s: %r" +msgid "invalid numfig_format: %s" +msgstr "неправильный numfig_format: %s" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1453 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "Ошибка копирования файла в html_static_file: %s: %r" +msgid "undefined label: %r" +msgstr "неопределённая метка: %r" -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "копирование файлов статики" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "Ошибка создания перекрёстной ссылки. Заголовок или подзаголовок не найдены: %r" -#: builders/html/__init__.py:934 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy static file %r" -msgstr "не удалось копировать файл статики %r" +msgid "invalid value set (missing closing brace): %s" +msgstr "задано неправильное значение (пропущена закрывающая скобка): %s" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "копирование дополнительных файлов" +#: ext/napoleon/docstring.py:185 +#, python-format +msgid "invalid value set (missing opening brace): %s" +msgstr "задано неправильное значение (пропущена открывающая скобка): %s" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "cannot copy extra file %r" -msgstr "не удалось скопировать дополнительный файл %r" +msgid "malformed string literal (missing closing quote): %s" +msgstr "неправильный строковый литерал (пропущена закрывающая кавычка): %s" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to write build info file: %r" -msgstr "Ошибка записи при сборке файла info: %r" +msgid "malformed string literal (missing opening quote): %s" +msgstr "неправильный стороковый литерал (пропущена открывающая кавычка): %s" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Пример" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "страница %s соответствует двум шаблонам в html_sidebars: %r и %r" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Примеры" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Именованные аргументы" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "Ошибка при рендере страницы %s.\nПричина: %r" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Заметки" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "выгрузка объекта инвентаря" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Другие параметры" + +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "Получает" + +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Ссылки" + +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Предупрждения" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" -#: builders/html/__init__.py:1265 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "dumping search index in %s" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1308 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "invalid js_file: %r, ignored" -msgstr "некорректный js_file: %r, пропускается" +msgid "alias of %s" +msgstr "псевдоним для %s" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "Зарегистрировано несколько math_renderers. Однако, ни один math_renderer не выбран." +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" +msgstr "Базовые классы: %s" -#: builders/html/__init__.py:1346 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Unknown math_renderer %r is given." -msgstr "Передан неизвестный math_renderer %r ." +msgid "invalid value for member-order option: %s" +msgstr "некорректное значение для опции member-order: %s" -#: builders/html/__init__.py:1360 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "элемент html_extra_path %r размещён внутри целевого каталога" +msgid "invalid value for class-doc-from option: %s" +msgstr "некорректное значение для опции for class-doc-from: %s" -#: builders/html/__init__.py:1365 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "элемент html_extra_path %r не существует" +msgid "invalid signature for auto%s (%r)" +msgstr "неправильная сигнатура для auto%s (%r)" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "элемент html_static_path %r размещён внутри целевого каталога" +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_names.py:89 #, python-format -msgid "html_static_path entry %r does not exist" -msgstr "элемент html_static_path %r не существует" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_names.py:93 #, python-format -msgid "logo file %r does not exist" -msgstr "файл логотипа %r не существует" +msgid "return annotation given for automodule: '%s'" +msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "\"::\" в названии автомодуля не имеет смысла" + +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "favicon file %r does not exist" -msgstr "Файл favicon %r не существует" +msgid "Failed to remove %s: %s" +msgstr "Ошибка удаления %s: %s" -#: builders/html/__init__.py:1420 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." -msgstr "Значения в 'html_sidebars' должны быть списком строк. По крайней мере один шаблон имеет строковое значение: %s. Замените на `html_sidebars = %r`." +msgid "Would create file %s." +msgstr "Нужно создать файл %s." -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:28 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "HTML 4 больше не поддерживается Sphinx. (строка \"html4_writer=True\" обнаружена в настройках)" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" -msgstr "документация %s %s" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "путь к модулю в документе" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" -msgstr "ошибка чтения файла сборки info (неизвестная версия)" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "стиль fnmatch для шаблонов файлов и/или каталогов для исключения из генерации" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" -msgstr "сбой при чтении файла info для сломанной сборки (пропущено значение настройки)" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "каталог для размещения всего вывода" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" -msgstr "ошибка чтения сломанной сборки файла info (отсутствует запись tags)" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "максимальная глубина субмодулей для отображения в оглавлении (по умолчанию: 4)" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Файлы LaTeX находятся в %(outdir)s." +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "перезаписать существующие файлы" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:91 msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nЗапустите 'make' в этом каталоге для выполнения с помощью (pdf)latex\n(используйте `make latexpdf' здесь, чтобы сделать это автоматически)." - -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "не найдено значение настройки \"latex_documents\"; документы не будут записаны" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "следовать по символическим ссылкам. Эффективно сочетается с collective.recipe.omelette." -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "значение настройки \"latex_documents\" ссылается на неизвестный документ %s" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "запуск сценария без создания файлов" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Выпуск" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "разместить документацию каждого модуля на его собственной странице" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "копирование файлов поддержки TeX" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "включая модули \"_private\"" -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "копирование дополнительных файлов" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "имя файла с оглавлением (по умолчанию: modules)" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "Неизвестный ключ конфигурации: latex_elements[%r], пропускается." +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "не создавать файл с оглавлением" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "Неизвестная опция темы: latex_theme_options[%r], пропускается." +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "не создавать заголовки для модулей/пакета пакетов (например, если docstrings уже содержат их)" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" -msgstr "Ошибка получения названия документа!" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "разместить документацию модуля перед документацией подмодуля" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" -msgstr "Сбой получения названия документа для источника %r!" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" -msgstr "Не найдена сноска для указанного узла %r" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r не имеет настройки \"theme\"" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "расширение файла (по умолчанию: rst)" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r не имеет настройки \"%s\"" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "Удалить из целевого каталога файлы, которые не были сгенерированы" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "продолжение с предыдущей страницы" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "генерация полного проекта с помощью sphinx-quickstart" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "продолжается на следующей странице" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "добавить module_path в sys.path, используется совместно с --full" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "Не-алфавитный" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "название проекта (по умолчанию: название корневого модуля)" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Числа" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "автор(ы) проекта, используется совместно с --full" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "страница" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "версия проекта, используется совместно с --full" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Именованные аргументы" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "релиз проекта, используется совместно с --full, по умолчанию --doc-version" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "задано неправильное значение (пропущена закрывающая скобка): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "опции расширения" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "задано неправильное значение (пропущена открывающая скобка): %s" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "неправильный строковый литерал (пропущена закрывающая кавычка): %s" +msgid "enable %s extension, used when --full is given" +msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "неправильный стороковый литерал (пропущена открывающая кавычка): %s" - -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Пример" - -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Примеры" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Заметки" +msgid "%s is not a directory." +msgstr "%s не каталог." -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Другие параметры" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "Получает" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" +msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Ссылки" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Предупрждения" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." -msgstr "autosummary ссылается на исключённый документ %r. Пропускается." +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." -msgstr "Озаглавленное autosummary требует опцию :toctree:. пропускается." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "autosummary: ошибка импорта %s.\nВозможные подсказки:\n%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" -msgstr "ошибка разбора имени %s" +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" -msgstr "ошибка импорта объекта %s" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" -msgstr "autosummary_generate: файл не найден: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." -msgstr "autosummary генерирует внутри файлы .rst . Но ваш source_suffix не содержит .rst. Пропускается." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] генерация autosummary для: %s" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] запись в %s" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3731,7 +3663,7 @@ msgid "" "%s" msgstr "[autosummary] ошибка импорта %s.\nВозможные подсказки:\n%s" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3746,481 +3678,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "исходные файлы для генерации файлов rST для" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "каталог для размещения всех файлов вывода" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "расширение файлов по умолчанию (по умолчанию: %(default)s)" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "собственный каталог шаблонов (по умолчанию: %(default)s)" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" -msgstr "Удалить из целевого каталога файлы, которые не были сгенерированы" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." +msgstr "autosummary ссылается на исключённый документ %r. Пропускается." + +#: ext/autosummary/__init__.py:239 +#, python-format +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." +msgstr "" + +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "Озаглавленное autosummary требует опцию :toctree:. пропускается." + +#: ext/autosummary/__init__.py:329 +#, python-format +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "autosummary: ошибка импорта %s.\nВозможные подсказки:\n%s" + +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" +msgstr "ошибка импорта объекта %s" + +#: ext/autosummary/__init__.py:652 +#, python-format +msgid "" +"Summarised items should not include the current module. Replace %r with %r." +msgstr "" + +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" +msgstr "autosummary_generate: файл не найден: %s" + +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." +msgstr "autosummary генерирует внутри файлы .rst . Но ваш source_suffix не содержит .rst. Пропускается." + +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "Неправильный идентификатор проекта intersphinx `%r` d intersphinx_mapping. Идентификаторы проектов должны быть непустыми строками." + +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "Неправильное значение `%r` в intersphinx_mapping[%r]. Ожидается кортеж или список из двух элементов." + +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "Неправильное значение `%r` в intersphinx_mapping[%r]. Значения должны быть парами (целевой URI, расположение инвентаря)." + +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "Некорректное значение целевого URL `%r` в intersphinx_mapping[%r][0]. Целевые URI должны быть уникальными не пустыми строками." + +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "Неправильный целевой URI `%r` в intersphinx_mapping[%r][0]. Целевые URI должны быть уникальными (другой экземпляр в intersphinx_mapping[%r])." -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_load.py:122 #, python-format -msgid "Failed to remove %s: %s" -msgstr "Ошибка удаления %s: %s" - -#: ext/apidoc/_cli.py:28 msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "путь к модулю в документе" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "Некорректная настройка `intersphinx_mapping` (1 ошибка)." -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "стиль fnmatch для шаблонов файлов и/или каталогов для исключения из генерации" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "Некорректная конфигурация `intersphinx_mapping` (%s ошибок)." -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "каталог для размещения всего вывода" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "После нормализации была добьавлена некорректная запись intersphinx_mapping." -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "максимальная глубина субмодулей для отображения в оглавлении (по умолчанию: 4)" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "загрузка инвентаря intersphinx '%s' из %s ..." -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "перезаписать существующие файлы" +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "следовать по символическим ссылкам. Эффективно сочетается с collective.recipe.omelette." +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "запуск сценария без создания файлов" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "инвентарь intersphinx перемещён: %s -> %s" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "разместить документацию каждого модуля на его собственной странице" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" +msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "включая модули \"_private\"" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "(в %s)" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "имя файла с оглавлением (по умолчанию: modules)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "инвентарь '%s': найден повтор для %s:%s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "не создавать файл с оглавлением" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "инвентарь '%s': найдено несколько совпадений для %s:%s" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "не создавать заголовки для модулей/пакета пакетов (например, если docstrings уже содержат их)" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "инвентарь для внешних перекрёстных ссылок не найден: %r" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "разместить документацию модуля перед документацией подмодуля" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "неправильный суффикс перекрёстной ссылки: %r" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "домен для внешней перекрёстной ссылки не найден: %r" -#: ext/apidoc/_cli.py:160 -msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "расширение файла (по умолчанию: rst)" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "ошибка при форматировании сигнатуры для %s: %s" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "генерация полного проекта с помощью sphinx-quickstart" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "добавить module_path в sys.path, используется совместно с --full" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "Ошибка получения сигнатуры функции для %s: %s" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "название проекта (по умолчанию: название корневого модуля)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "Ошибка обновления сигнатуры для %r: параметр не найден: %s" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "автор(ы) проекта, используется совместно с --full" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "Ошибка разбора type_comment для %r: %s" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "версия проекта, используется совместно с --full" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "Некорректные __slots__ найдены в %s. Пропускается." -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "релиз проекта, используется совместно с --full, по умолчанию --doc-version" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "ошибка форматирования аргументов для %s: %s" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "опции расширения" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "Ошибка получения сигнатуры конструктора для %s: %s" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" -msgstr "" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "Ошибка получения сигнатуры метода для %s: %s" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "%s is not a directory." -msgstr "%s не каталог." +msgid "Failed to parse a default argument value for %r: %s" +msgstr "Ошибка разбора значения по умолчанию для аргумента %r: %s" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" -msgstr "" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "пропущен атрибут упомянутый в опции :members:: модуль %s, атрибут %s" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +msgid "missing attribute %s in object %s" +msgstr "не указан атрибут %s в объекте %s" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "" +msgid "alias of TypeVar(%s)" +msgstr "псевдоним для TypeVar(%s)" -#: ext/apidoc/_extension.py:147 +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "ошибка чтения файла сборки info (неизвестная версия)" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "сбой при чтении файла info для сломанной сборки (пропущено значение настройки)" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "ошибка чтения сломанной сборки файла info (отсутствует запись tags)" + +#: builders/html/__init__.py:114 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "Страницы HTML находятся в %(outdir)s." -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:337 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" -msgstr "" +msgid "Failed to read build info file: %r" +msgstr "Ошибка чтения при сборке файла info: %r" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "несоответствие build_info, копирование .buildinfo в .buildinfo.bak" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "сборка [html]: " + +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" -msgstr "" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "шаблон %s был изменён с момента предыдущей сборки, все документы будут пересобраны" + +#: builders/html/__init__.py:496 +msgid "index" +msgstr "указатель" + +#: builders/html/__init__.py:549 +#, python-format +msgid "Logo of %s" +msgstr "Логотип %s" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "вперёд" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "назад" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "генерация индексов" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "запись дополнительных страниц" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +msgid "cannot copy image file '%s': %s" +msgstr "не удалось скопировать файл изображения '%s': %s" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" -msgstr "" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "копирование загружаемых файлов..." -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "не удалось скопировать загружаемый файл %r: %s" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgstr "Ошибка копирования файла в каталог 'static' темы: %s: %r" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:871 #, python-format -msgid "Would create file %s." -msgstr "Нужно создать файл %s." +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "Ошибка копирования файла в html_static_file: %s: %r" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s v%s)" -msgstr "(в %s v%s)" +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "копирование файлов статики" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:923 #, python-format -msgid "(in %s)" -msgstr "(в %s)" +msgid "cannot copy static file %r" +msgstr "не удалось копировать файл статики %r" -#: ext/intersphinx/_resolve.py:108 -#, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "инвентарь '%s': найден повтор для %s:%s" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "копирование дополнительных файлов" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:938 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "инвентарь '%s': найдено несколько совпадений для %s:%s" +msgid "cannot copy extra file %r" +msgstr "не удалось скопировать дополнительный файл %r" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:944 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "инвентарь для внешних перекрёстных ссылок не найден: %r" +msgid "Failed to write build info file: %r" +msgstr "Ошибка записи при сборке файла info: %r" -#: ext/intersphinx/_resolve.py:392 -#, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "неправильный суффикс перекрёстной ссылки: %r" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:1038 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "домен для внешней перекрёстной ссылки не найден: %r" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "страница %s соответствует двум шаблонам в html_sidebars: %r и %r" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1204 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "Неправильный идентификатор проекта intersphinx `%r` d intersphinx_mapping. Идентификаторы проектов должны быть непустыми строками." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" +msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "Неправильное значение `%r` в intersphinx_mapping[%r]. Ожидается кортеж или список из двух элементов." +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "Ошибка при рендере страницы %s.\nПричина: %r" + +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "выгрузка объекта инвентаря" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1266 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "Неправильное значение `%r` в intersphinx_mapping[%r]. Значения должны быть парами (целевой URI, расположение инвентаря)." +msgid "dumping search index in %s" +msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "Некорректное значение целевого URL `%r` в intersphinx_mapping[%r][0]. Целевые URI должны быть уникальными не пустыми строками." +msgid "invalid js_file: %r, ignored" +msgstr "некорректный js_file: %r, пропускается" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Зарегистрировано несколько math_renderers. Однако, ни один math_renderer не выбран." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "Неправильный целевой URI `%r` в intersphinx_mapping[%r][0]. Целевые URI должны быть уникальными (другой экземпляр в intersphinx_mapping[%r])." +msgid "Unknown math_renderer %r is given." +msgstr "Передан неизвестный math_renderer %r ." -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "элемент html_extra_path %r размещён внутри целевого каталога" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "Некорректная настройка `intersphinx_mapping` (1 ошибка)." +#: builders/html/__init__.py:1370 +#, python-format +msgid "html_extra_path entry %r does not exist" +msgstr "элемент html_extra_path %r не существует" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1385 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "Некорректная конфигурация `intersphinx_mapping` (%s ошибок)." +msgid "html_static_path entry %r is placed inside outdir" +msgstr "элемент html_static_path %r размещён внутри целевого каталога" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "После нормализации была добьавлена некорректная запись intersphinx_mapping." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" +msgstr "элемент html_static_path %r не существует" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "загрузка инвентаря intersphinx '%s' из %s ..." +msgid "logo file %r does not exist" +msgstr "файл логотипа %r не существует" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "Файл favicon %r не существует" + +#: builders/html/__init__.py:1425 +#, python-format msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." +msgstr "Значения в 'html_sidebars' должны быть списком строк. По крайней мере один шаблон имеет строковое значение: %s. Замените на `html_sidebars = %r`." -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "не удалось получить доступ ни к одному из инвентарей по следующим причинам:" +#: builders/html/__init__.py:1438 +msgid "" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "HTML 4 больше не поддерживается Sphinx. (строка \"html4_writer=True\" обнаружена в настройках)" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "инвентарь intersphinx перемещён: %s -> %s" +msgid "%s %s documentation" +msgstr "документация %s %s" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "некорректное значение для опции member-order: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r не имеет настройки \"theme\"" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "некорректное значение для опции for class-doc-from: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r не имеет настройки \"%s\"" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "неправильная сигнатура для auto%s (%r)" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "Ошибка получения названия документа!" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "ошибка форматирования аргументов для %s: %s" +msgid "Failed to get a docname for source %r!" +msgstr "Сбой получения названия документа для источника %r!" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "" +msgid "No footnote was found for given reference node %r" +msgstr "Не найдена сноска для указанного узла %r" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Файлы LaTeX находятся в %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nЗапустите 'make' в этом каталоге для выполнения с помощью (pdf)latex\n(используйте `make latexpdf' здесь, чтобы сделать это автоматически)." -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" -msgstr "" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "не найдено значение настройки \"latex_documents\"; документы не будут записаны" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "ошибка при форматировании сигнатуры для %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "значение настройки \"latex_documents\" ссылается на неизвестный документ %s" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "\"::\" в названии автомодуля не имеет смысла" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "копирование файлов поддержки TeX" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "копирование дополнительных файлов" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Неизвестный ключ конфигурации: latex_elements[%r], пропускается." -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "пропущен атрибут упомянутый в опции :members:: модуль %s, атрибут %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "Неизвестная опция темы: latex_theme_options[%r], пропускается." -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "Ошибка получения сигнатуры функции для %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "Ошибка получения сигнатуры конструктора для %s: %s" +msgid "image file not readable: %s" +msgstr "нечитаемое изображение: %s" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" -msgstr "Базовые классы: %s" +msgid "image file %s not readable: %s" +msgstr "файл изображения %s не читается: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" -msgstr "не указан атрибут %s в объекте %s" +msgid "download file not readable: %s" +msgstr "загружаемый файл не читается: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" -msgstr "псевдоним для %s" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "обнаружены циклические ссылки в оглавлении, пропускается: %s <- %s" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "псевдоним для TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "оглавление содержит ссылку на документ %r, у которого нет заголовка: ссылка не будет сгенерирована" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "Ошибка получения сигнатуры метода для %s: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "toctree содержит ссылку на не включенный документ %r" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "Некорректные __slots__ найдены в %s. Пропускается." +msgid "toctree contains reference to non-existing document %r" +msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "Ошибка разбора значения по умолчанию для аргумента %r: %s" +msgid "see %s" +msgstr "см. %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "Ошибка обновления сигнатуры для %r: параметр не найден: %s" +msgid "see also %s" +msgstr "также см. %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "Ошибка разбора type_comment для %r: %s" +msgid "unknown index entry type %r" +msgstr "неизвестная запись типа индекса %r" diff --git a/sphinx/locale/si/LC_MESSAGES/sphinx.mo b/sphinx/locale/si/LC_MESSAGES/sphinx.mo index fa7d11bfbaf..07b38c471ba 100644 Binary files a/sphinx/locale/si/LC_MESSAGES/sphinx.mo and b/sphinx/locale/si/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/si/LC_MESSAGES/sphinx.po b/sphinx/locale/si/LC_MESSAGES/sphinx.po index 565d88027d7..6aef2ccb7d9 100644 --- a/sphinx/locale/si/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/si/LC_MESSAGES/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: callkalpa , 2013\n" "Language-Team: Sinhala (http://app.transifex.com/sphinx-doc/sphinx-1/language/si/)\n" @@ -19,6 +19,127 @@ msgstr "" "Language: si\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -33,127 +154,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +322,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,468 +537,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" +msgstr "දෝෂය" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "හැඟවීම" + +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:235 +msgid "Note" +msgstr "සටහන" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "මෙයද බලන්න" + +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: project.py:72 +#: locale/__init__.py:238 +msgid "Warning" +msgstr "අනතුරු ඇඟවීම" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "" + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[source]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[docs]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "error writing file %s: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:436 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/doctest.py:297 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/doctest.py:457 -#, python-format -msgid "no code/output in %s block at %s:%s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:594 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." msgstr "" -#: ext/imgmath.py:344 +#: builders/_epub_base.py:802 #, python-format -msgid "display latex %r: %s" +msgid "writing %s file..." msgstr "" -#: ext/imgmath.py:380 +#: builders/text.py:27 #, python-format -msgid "inline latex %r: %s" +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -739,9 +1175,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -776,6 +1213,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "කිරීමට තිබෙන" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -863,949 +1328,995 @@ msgstr "[graph: %s]" msgid "[graph]" msgstr "[graph]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "කිරීමට තිබෙන" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:47 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "කේත ලේඛක:" - -#: directives/other.py:209 -msgid "Author: " -msgstr "ලේඛක:" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[source]" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[docs]" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "ක්‍රියාව" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "දත්ත" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "" +msgid "Changed in version %s" +msgstr "%s වෙළුමේ වෙනස් කල" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "" - -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: util/docutils.py:309 +#: cmd/quickstart.py:671 #, python-format -msgid "unknown directive name: %s" +msgid "enable %s extension" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/rst.py:73 +#: cmd/quickstart.py:810 #, python-format -msgid "default role %s not found" +msgid "Invalid template variable: %s" msgstr "" -#: util/inventory.py:147 +#: directives/other.py:119 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/inventory.py:166 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/other.py:169 #, python-format -msgid "[image: %s]" -msgstr "[image: %s]" +msgid "duplicated entry found in toctree: %s" +msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[image]" +#: directives/other.py:203 +msgid "Section author: " +msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:205 +msgid "Module author: " +msgstr "" + +#: directives/other.py:207 +msgid "Code author: " +msgstr "කේත ලේඛක:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "ලේඛක:" + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" msgstr "" -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/texinfo.py:1303 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "unimplemented node type: %r" msgstr "" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[image: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[image]" + #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" msgstr "" @@ -1832,6 +2343,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1848,794 +2364,478 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "" + +#: writers/latex.py:1228 #, python-format -msgid "%s (global variable or constant)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1615 #, python-format -msgid "%s (%s attribute)" +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "ක්‍රියාව" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "දත්ත" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "%s වෙළුමේ වෙනස් කල" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "" - -#: domains/rst.py:234 -msgid "directive" -msgstr "" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:236 -msgid "role" -msgstr "" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "" - -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "දෝෂය" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "හැඟවීම" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "සටහන" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "මෙයද බලන්න" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "අනතුරු ඇඟවීම" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "" - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "" - -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "" - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "" - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "" - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "" - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "" - -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" -msgstr "" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "" - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "" - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "" - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "" - -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "" - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:670 +#: util/i18n.py:146 #, python-format -msgid "enable %s extension" +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:792 +#: util/nodes.py:462 +#, python-format msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:809 +#: util/nodes.py:523 #, python-format -msgid "Invalid template variable: %s" +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "සංකේත" -#: cmd/build.py:114 -msgid "general options" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "නිකුත් කිරීම" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:157 +#: transforms/post_transforms/__init__.py:88 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "ගමන් කිරීම" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "මෙම ලේඛණ ගැන" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "සොයන්න" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:357 +#: themes/basic/layout.html:201 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "පෙර මාතෘකාව" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "පෙර පරිච්ඡේදය" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "ඊළඟ මාතෘකාව" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "ඊළඟ පරිච්ඡේදය" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "සොයන්න" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "යන්න" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "මෙම පිටුව" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "මූලය පෙන්වන්න" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "අන්තර්ගතය" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "ඉක්මන් සෙවුම" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "%(docstitle)s සොයන්න" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "යන්න" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2682,7 +2882,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2690,23 +2890,15 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "මෙම පිටුව" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "ඉක්මන් සෙවුම" +#: themes/basic/opensearch.xml:4 +#, python-format +msgid "Search %(docstitle)s" +msgstr "%(docstitle)s සොයන්න" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2716,57 +2908,6 @@ msgstr "" msgid "can be huge" msgstr "විශාල විය හැක" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "පෙර මාතෘකාව" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "පෙර පරිච්ඡේදය" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "ඊළඟ මාතෘකාව" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "ඊළඟ පරිච්ඡේදය" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "ගමන් කිරීම" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "මෙම ලේඛණ ගැන" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2783,21 +2924,21 @@ msgstr "" msgid "search" msgstr "සොයන්න" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "අන්තර්ගතය" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "සෙවුම් ප්‍රතිඵල" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2805,27 +2946,31 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "සොයමින්..." -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "සෙවුම සූදානම් කරමින්...." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" +msgid "Changes in Version %(version)s — %(docstitle)s" +msgstr "" + +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" msgstr "" #: themes/basic/changes/versionchanges.html:17 @@ -2849,119 +2994,126 @@ msgstr "වෙනත් වෙනස්කම්" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "පරාමිතීන්" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "විචල්‍ය" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "පරාමිතීන්" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "විචල්‍ය" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2973,746 +3125,526 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "සාමාජික" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "වර්ගය" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 -#, python-format -msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "විචල්‍යය" - -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "මැක්‍රෝ" - -#: domains/c/__init__.py:753 -msgid "struct" -msgstr "" - -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "" - -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "%s බලන්න" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "%s ද බලන්න" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "සංකේත" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: transforms/post_transforms/__init__.py:88 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 +#, python-format msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/c/__init__.py:211 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "%s (C %s)" msgstr "" -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "විචල්‍යය" + +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "මැක්‍රෝ" + +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "%r reference target not found: %s" +msgid "environment variable; %s" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:116 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "%s; configuration value" msgstr "" -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:239 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: builders/html/__init__.py:348 +#: domains/std/__init__.py:319 #, python-format -msgid "Failed to read build info file: %r" +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "ඊළඟ" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "පෙර" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1124 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1153 #, python-format -msgid "cannot copy static file %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:949 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy extra file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:955 +#: domains/std/__init__.py:1456 #, python-format -msgid "Failed to write build info file: %r" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1224 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "" + +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" + +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "%s %s ලේඛණය" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "නිකුත් කිරීම" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3720,7 +3652,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3735,481 +3667,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:123 #, python-format -msgid "%s is not a directory." +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" -msgstr "(%s හි%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "ඊළඟ" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "පෙර" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "%s %s ලේඛණය" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "%s බලන්න" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "%s ද බලන්න" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/sk/LC_MESSAGES/sphinx.mo b/sphinx/locale/sk/LC_MESSAGES/sphinx.mo index 09411c2b877..5ea13ec5e7f 100644 Binary files a/sphinx/locale/sk/LC_MESSAGES/sphinx.mo and b/sphinx/locale/sk/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/sk/LC_MESSAGES/sphinx.po b/sphinx/locale/sk/LC_MESSAGES/sphinx.po index 8acd93e5f96..4beab5e58c9 100644 --- a/sphinx/locale/sk/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/sk/LC_MESSAGES/sphinx.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Slavko , 2013-2019,2021\n" "Language-Team: Slovak (http://app.transifex.com/sphinx-doc/sphinx-1/language/sk/)\n" @@ -21,6 +21,127 @@ msgstr "" "Language: sk\n" "Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n == 1 ? 0 : n % 1 == 0 && n >= 2 && n <= 4 ? 1 : n % 1 != 0 ? 2: 3);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "nastavenie %s.%s nenájdené v žiadnom z nastavení témy" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "zadaná nepodporovaná voľba témy %r" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "súbor %r v ceste témy nie je platný súbor ZIP alebo neobsahuje tému" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -35,127 +156,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Tento projekt vyžaduje rozšírenie %s s verziou minimálne %s, a teda ho nemožno zostaviť s načítanou verziou (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Neznáme meno lexera Pygments %r" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Udalosť %r už existuje" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Neznáme meno udalosti %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "Obsluha %r udalosti %r vyvolala výnimku" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Nemožno nájsť zdrojový priečinok (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Výstupný adresár (%s) nie je adresár" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Zdrojový a cieľový priečinok nemôžu byť rovnaké" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Spúšťanie Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Tento projekt vyžaduje aspoň Sphinx v%s a preto s touto verziou nemôže byť zostavený." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "vytváranie výstupnej zložky" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "pri nastavovaní rozšírenia %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' definovaný v conf.py nie je funkciou. Prosím, upravte jeho definíciu tak, aby to bola funkcia. Je to potrebné, aby sa conf.py mohol správať ako rozšírenie Sphinx." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "načítanie prekladov [%s]…" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "hotovo" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "nedostupné pre zabudované správy" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "načítanie uloženého prostredia " -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "zlyhalo: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Nebol zvolený builder, bude použitý predvolený: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "trieda uzla %r už je registrovaná, jej metódy (visitors) budú prepísané" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -163,12 +311,12 @@ msgid "" "explicit" msgstr "rozšírenie %s nedeklaruje, či je bezpečné pri paralelnom čítaní, predpokladá sa, že nie - prosím, požiadajte autora aby to skontroloval a explicitne to nastavil" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "rozšírenie %s nie je bezpečné pre paralelné zostavenie" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -176,82 +324,214 @@ msgid "" "explicit" msgstr "rozšírenie %s nedeklaruje, či je bezpečné pri paralelnom čítaní, predpokladáme, že nie je – prosím, požiadajte autora aby to skontroloval a explicitne to nastavil" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "rozšírenie %s nie je bezpečné pre paralelné zostavenie" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "sériové spracovanie %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "konfiguračný priečinok neobsahuje súbor conf.py (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Trieda builder %s nemá atribút „name”" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Builder %r už existuje (v module %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Builder s menom %s nie je registrovaný ani dostupný cez vstupný bod" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Builder s menom %s nie je registrovaný" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "doména %s už je zaregistrovaná" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "doména %s ešte nie je zaregistrovaná" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "Direktíva %r už je registrovaná v doméne %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "Rola %r už je registrovaná v doméne %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "Index %r už je registrovaný v doméne %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr " object_type %r už je registrovaný" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "crossref_type %r už je registrovaný" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r už je registrovaný" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser pre %r už je registrovaný" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Analyzátor pre %s nie je registrovaný" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "Translator pre %r už existuje" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r už je registrovaný" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "rozšírenie %r bolo zlúčené so Sphinx od verzie %s; toto rozšírenie je ignorované." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Pôvodná výnimka:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Nemožno importovať rozšírenie %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "rozšírenie %r nemá funkciu setup(); je to naozaj modul rozšírenia Sphinx?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "Rozšírenie %s použité týmto projektom vyžaduje aspoň Sphinx v%s; takže ho nemožno zostaviť s touto verziou." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "rozšírenie %r vrátilo so svojej funkcie setup() nepodporovaný objekt; musí vrátiť None alebo slovník metadát" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "konfiguračný priečinok neobsahuje súbor conf.py (%s)" + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "nemožno prepísať slovník nastavenia %r, ignorované (použite %r na nastavenie jednotlivých prvkov)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "neplatný počet %r pre konfiguračnú hodnotu %r, ignorované" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "nemožno prepísať konfiguračné nastavenie %r s nepodporovaným typom, ignorované" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "neznáma konfiguračná hodnota %r v prepísaní, ignorované" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Konfiguračná hodnota %r už existuje" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Vo svojom konfiguračnom súbore máte chybu: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Konfiguračný súbor (alebo jeden z modulov, ktoré importuje) volal sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -259,469 +539,625 @@ msgid "" "%s" msgstr "V konfiguračnom súbore je programová chyba:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Sekcia %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Obr. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabuľka %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Výpis %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Konfiguračná hodnota `{name}` má byť jedno z {candidates}, ale je zadané `{current}`." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Konfiguračná hodnota `{name}' má typ `{current.__name__}'; očakávané {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Konfiguračná hodnota `{name}' má typ `{current.__name__}', predvolene `{default.__name__}'." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r nenájdená, ignorované." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Neznáme meno lexera Pygments %r" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "nová konfigurácia" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "zmenená konfigurácia" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "nastavenie %s.%s nenájdené v žiadnom z nastavení témy" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "zmenené rozšírenie" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "zadaná nepodporovaná voľba témy %r" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "prostredie zostavenia nie je aktuálne" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "súbor %r v ceste témy nie je platný súbor ZIP alebo neobsahuje tému" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "zdrojový adresár zmenený" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" -msgstr "" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Toto prostredie nie je kompatibilné zo zvoleným zostavovačom, prosím, zvoľte iný adresár doctree." -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" -msgstr "" +msgid "Failed to scan documents in %s: %r" +msgstr "Zlyhalo skenovanie dokumentov v %s: %r" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +msgid "Domain %r is not registered" +msgstr "Doména %r nie je zaregistrovaná" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "dokument nie je zahrnutý v žiadnom strome obsahu" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "nájdený na seba odkazujúci strom obsahu. Ignorované." -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Výstraha" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Udalosť %r už existuje" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Upozornenie" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Neznáme meno udalosti %s" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Nebezpečné" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "Obsluha %r udalosti %r vyvolala výnimku" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Chyba" -#: project.py:72 +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Rada" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Dôležité" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Poznámka" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Viď aj" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tip" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Varovanie" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Súbory Texinfo sú v %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nSpustite v tomto adresári 'make' na ich spustenie pomocou makeinfo\n(použite tu 'make info' aby to bolo spustené automaticky)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "nebola nájdená konfiguračná voľba „texinfo_documents”; dokumenty nebudú zapísané" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Trieda builder %s nemá atribút „name”" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "konfiguračná voľba „texinfo_documents” odkazuje na neznámy dokument %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Builder %r už existuje (v module %s)" +msgid "processing %s" +msgstr "spracovanie %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Builder s menom %s nie je registrovaný ani dostupný cez vstupný bod" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "zapisovanie" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Builder s menom %s nie je registrovaný" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "riešenie odkazov…" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "doména %s už je zaregistrovaná" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "(v" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "doména %s ešte nie je zaregistrovaná" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "kopírovanie obrázkov…" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "Direktíva %r už je registrovaná v doméne %s" +msgid "cannot copy image file %r: %s" +msgstr "nemožno kopírovať súbor obrázka %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "Rola %r už je registrovaná v doméne %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "kopírovanie podporných súborov Texinfo" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "Index %r už je registrovaný v doméne %s" +msgid "error writing file Makefile: %s" +msgstr "chyba zápisu súboru Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr " object_type %r už je registrovaný" +msgid "The manual pages are in %(outdir)s." +msgstr "Manuálové stránky sú v %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "crossref_type %r už je registrovaný" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "nebola nájdená konfiguračná voľba „man_pages”; manuálové stránky nebudú zapísané" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r už je registrovaný" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "konfiguračná voľba „man_pages” odkazuje na neznámy dokument %s" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser pre %r už je registrovaný" +msgid "The HTML page is in %(outdir)s." +msgstr "Stránky HTML sú v %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "Analyzátor pre %s nie je registrovaný" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "zostavovanie spoločného dokumentu" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "Translator pre %r už existuje" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "zapisovanie dodatočných súborov" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "Zostavovač dummy negeneruje žiadne súbory." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r už je registrovaný" +msgid "The message catalogs are in %(outdir)s." +msgstr "Katalógy správ sú v %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "" +msgid "building [%s]: " +msgstr "zostavovanie [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "rozšírenie %r bolo zlúčené so Sphinx od verzie %s; toto rozšírenie je ignorované." +msgid "targets for %d template files" +msgstr "" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Pôvodná výnimka:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "čítanie šablón… " -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "Nemožno importovať rozšírenie %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "zapisovanie katalógov správ…" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "rozšírenie %r nemá funkciu setup(); je to naozaj modul rozšírenia Sphinx?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Hľadajte akékoľvek chyby v predošlom výstupe alebo v %(outdir)s/output.txt" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "Rozšírenie %s použité týmto projektom vyžaduje aspoň Sphinx v%s; takže ho nemožno zostaviť s touto verziou." +msgid "broken link: %s (%s)" +msgstr "poškodený odkaz: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "rozšírenie %r vrátilo so svojej funkcie setup() nepodporovaný objekt; musí vrátiť None alebo slovník metadát" +msgid "Anchor '%s' not found" +msgstr "Kotva „%s” nenájdená" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" -msgstr "" +msgid "The ePub file is in %(outdir)s." +msgstr "Súbory ePub sú v %(outdir)s." + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "zapisovanie súboru nav.xhtml..." + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "konfiguračná hodnota „epub_language” (alebo „language”) nesmie byť prázdna pri EPUB3" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "konfiguračná hodnota „epub_uid” má byť XML NAME pre EPUB3" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "konfiguračná hodnota „epub_title” (alebo „html_title”) nesmie byť prázdna pri EPUB3" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "konfiguračná hodnota „epub_author” nesmie byť prázdna pri EPUB3" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "konfiguračná hodnota „epub_contributor” nesmie byť prázdna pri EPUB3" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "konfiguračná hodnota „epub_description” nesmie byť prázdna pri EPUB3" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "konfiguračná hodnota „epub_publisher” nesmie byť prázdna pri EPUB3" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "konfiguračná hodnota „epub_copyright” (alebo „copyright”) nesmie byť prázdna pri EPUB3" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "konfiguračná hodnota „epub_identifier” nesmie byť prázdna pri EPUB3" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "konfiguračná hodnota „version” nesmie byť prázdna pri EPUB3" -#: roles.py:251 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +msgid "invalid css_file: %r, ignored" +msgstr "neplatný css_file: %r, ignorovaný" -#: roles.py:274 +#: builders/xml.py:29 #, python-format -msgid "invalid CWE number %s" -msgstr "" +msgid "The XML files are in %(outdir)s." +msgstr "Súbory XML sú v %(outdir)s." -#: roles.py:294 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +msgid "error writing file %s: %s" +msgstr "chyba zápisu súboru %s: %s" -#: roles.py:317 +#: builders/xml.py:103 #, python-format -msgid "invalid PEP number %s" -msgstr "" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Súbory pseudo-XML sú v %(outdir)s." -#: roles.py:355 +#: builders/_epub_base.py:223 #, python-format -msgid "invalid RFC number %s" +msgid "duplicated ToC entry found: %s" +msgstr "nájdená duplicitná položka Obsahu: %s" + +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" +msgstr "nemožno čítať súbor obrázku %r: jeho kopírovanie namiesto toho" + +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" +msgstr "nemožno zapísať súbor obrázka %r: %s" + +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow nenájdené – kopírovanie súborov obrázkov" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "zapisovanie súboru mimetype…" + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "zapisovanie súboru META-INF/container.xml…" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "zapisovanie súboru content.opf..." + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "neznámy typ MIME pre %s, ignorovaný" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[zdroj]" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "zapisovanie súboru toc.ncx..." -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "zvýrazňovanie syntaxe kódu modulu... " +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "zapisovanie súboru %s…" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[dokumenty]" +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "Textové súbory sú v %(outdir)s." -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Kód modulu" +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "vhodný obrázok pre zostavovač %s nenájdený: %s (%s)" -#: ext/viewcode.py:353 +#: builders/__init__.py:237 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        Zdrojový kód %s

        " +msgid "a suitable image for %s builder not found: %s" +msgstr "vhodný obrázok pre zostavovač %s nenájdený: %s" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Prehľad: kód modulu" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "zostavenie [mo]: " -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Všetky moduly, pre ktoré je dostupný kód

        " +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "zápis výstupu…" -#: ext/extlinks.py:82 +#: builders/__init__.py:280 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "" +msgid "all of %d po files" +msgstr "všetky z %d súborov po" -#: ext/autosectionlabel.py:52 +#: builders/__init__.py:302 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "" +msgid "targets for %d po files that are specified" +msgstr "ciele pre %d po súborov, ktoré boli zadané" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/__init__.py:314 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "duplicitná menovka %s, ďalší výskyt v %s" +msgid "targets for %d po files that are out of date" +msgstr "ciele pre %d po súborov, ktoré sú zastarané" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "všetky zdrojové súbory" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/duration.py:90 +#: builders/__init__.py:342 +#, python-format msgid "" -"====================== slowest reading durations =======================" +"file %r given on command line is not under the source directory, ignoring" +msgstr "súbor %r zadaný v príkazovom riadku nie je v zdrojovom adresári, ignorujem" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:118 +#: builders/__init__.py:366 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "chýbajúce „+” alebo „-” vo voľbe „%s”." +msgid "%d source files given on command line" +msgstr "%d zdrojové súbory zadané v príkazovom riadku" -#: ext/doctest.py:124 +#: builders/__init__.py:382 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' nie je platná voľba." +msgid "targets for %d source files that are out of date" +msgstr "ciele pre %d zdrojových súborov, ktoré sú zastarané" -#: ext/doctest.py:139 +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "hľadanie zastaraných súborov…" + +#: builders/__init__.py:415 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "„%s” nie je platná voľba pyversion" +msgid "%d found" +msgstr "%d nájdené" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "neplatný typ TestCode" +#: builders/__init__.py:417 +msgid "none found" +msgstr "nenájdené" -#: ext/doctest.py:297 +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "ukladanie prostredia" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "kontrolovanie konzistencie" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "žiadne ciele nie sú zastarané." + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "aktualizácia prostredia:" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "%s pridané, %s zmenené, %s odstránené" + +#: builders/__init__.py:536 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:545 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:556 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:563 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "Nemožno spustiť príkaz LaTeX %r (potrebný na zobrazenie math), skontrolujte nastavenia imgmath_latex" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "čítanie zdrojov…" -#: ext/imgmath.py:181 +#: builders/__init__.py:725 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +msgid "docnames to write: %s" +msgstr "mená dokumentov na zapísanie: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "príprava dokumentov" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 #, python-format -msgid "display latex %r: %s" -msgstr "zobrazený latex %r: %s" +msgid "The overview file is in %(outdir)s." +msgstr "Súbor prehľadu je v %(outdir)s." -#: ext/imgmath.py:380 +#: builders/changes.py:65 #, python-format -msgid "inline latex %r: %s" -msgstr "vnorený latex %r: %s" +msgid "no changes in version %s." +msgstr "žiadne zmeny vo verzii %s." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "zapisovanie súboru prehľadu…" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Zabudované funkcie" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Úroveň modulu" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "kopírovanie zdrojových súborov…" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "nemožno čítať %r na vytvorenie položky záznamu zmien" #: ext/coverage.py:48 #, python-format @@ -741,9 +1177,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -778,16 +1215,44 @@ msgstr "nedokumentovaná trieda Python: %s :: %s" msgid "undocumented python method: %s :: %s :: %s" msgstr "nedokumentovaná metóda Python: %s :: %s :: %s" -#: ext/imgconverter.py:44 +#: ext/extlinks.py:82 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: ext/imgconverter.py:56 ext/imgconverter.py:90 -#, python-format +#: ext/todo.py:61 +msgid "Todo" +msgstr "ToDo" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "Nájdená položka TODO: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<> je umiestnená v %s, riadok %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "pôvodná položka" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format msgid "" "convert exited with error:\n" "[stderr]\n" @@ -865,948 +1330,994 @@ msgstr "[graf: %s]" msgid "[graph]" msgstr "[graf]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "ToDo" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" -msgstr "Nájdená položka TODO: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "Nemožno spustiť príkaz LaTeX %r (potrebný na zobrazenie math), skontrolujte nastavenia imgmath_latex" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<> je umiestnená v %s, riadok %d.)" +msgid "display latex %r: %s" +msgstr "zobrazený latex %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "pôvodná položka" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "vnorený latex %r: %s" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" -msgstr "Neplatný popis: %s" +msgid "missing '+' or '-' in '%s' option." +msgstr "chýbajúce „+” alebo „-” vo voľbe „%s”." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "špecifikácia čísla riadku je mimo rozsahu (1-%d): %r" +msgid "'%s' is not a valid option." +msgstr "'%s' nie je platná voľba." -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Nemožno použiť obe voľby „%s” a „%s”" +msgid "'%s' is not a valid pyversion option" +msgstr "„%s” nie je platná voľba pyversion" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "neplatný typ TestCode" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 -#, python-format -msgid "Object named %r not found in include file %r" -msgstr "Objekt s menom %r nebol nájdený vo vloženom súbore %r" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "Nemožno použiť „lineno-match” s rozdelenou množinou „lines”" - -#: directives/code.py:314 +#: ext/doctest.py:451 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Riadok %r: žiadne riadky z vloženého súboru %r" - -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "voľba \":file:\" direktívy csv-table teraz rozpoznáva absolútnu cestu ako relatívnu k zdrojovému adresáru. Prosím, aktualizujte svoj dokument." +msgid "no code/output in %s block at %s:%s" +msgstr "" -#: directives/other.py:119 +#: ext/doctest.py:568 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/autosectionlabel.py:52 #, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "strom obsahu obsahuje odkaz na vylúčený dokument %r" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "" -#: directives/other.py:156 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "strom obsahu obsahuje odkaz na neexistujúci dokument %r" +msgid "duplicate label %s, other instance in %s" +msgstr "duplicitná menovka %s, ďalší výskyt v %s" -#: directives/other.py:169 +#: ext/duration.py:47 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autor sekcie:" - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autor modulu:" - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autor kódu:" - -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor:" - -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." -msgstr "Súbor prehľadu je v %(outdir)s." +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" -#: builders/changes.py:56 +#: ext/duration.py:139 #, python-format -msgid "no changes in version %s." -msgstr "žiadne zmeny vo verzii %s." - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "zapisovanie súboru prehľadu…" +msgid "%.3fs %s" +msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Zabudované funkcie" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[zdroj]" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Úroveň modulu" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "zvýrazňovanie syntaxe kódu modulu... " -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "kopírovanie zdrojových súborov…" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[dokumenty]" -#: builders/changes.py:133 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "nemožno čítať %r na vytvorenie položky záznamu zmien" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Kód modulu" -#: builders/manpage.py:37 +#: ext/viewcode.py:359 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Manuálové stránky sú v %(outdir)s." +msgid "

        Source code for %s

        " +msgstr "

        Zdrojový kód %s

        " -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "nebola nájdená konfiguračná voľba „man_pages”; manuálové stránky nebudú zapísané" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Prehľad: kód modulu" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "zapisovanie" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Všetky moduly, pre ktoré je dostupný kód

        " -#: builders/manpage.py:71 +#: domains/citation.py:75 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "konfiguračná voľba „man_pages” odkazuje na neznámy dokument %s" +msgid "duplicate citation %s, other instance in %s" +msgstr "duplicitná citácia %s, ďalší výskyt v %s" -#: builders/__init__.py:224 +#: domains/citation.py:92 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "vhodný obrázok pre zostavovač %s nenájdený: %s (%s)" +msgid "Citation [%s] is not referenced." +msgstr "Citácia [%s] nie je odkazovaná." -#: builders/__init__.py:232 +#: domains/math.py:73 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "vhodný obrázok pre zostavovač %s nenájdený: %s" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "zostavenie [mo]: " - -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "zápis výstupu…" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "duplicitná menovka vzorca %s, ďalší výskyt v %s" -#: builders/__init__.py:275 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "all of %d po files" -msgstr "všetky z %d súborov po" +msgid "Invalid math_eqref_format: %r" +msgstr "neplatný math_eqref_format: %r" -#: builders/__init__.py:297 +#: domains/javascript.py:183 #, python-format -msgid "targets for %d po files that are specified" -msgstr "ciele pre %d po súborov, ktoré boli zadané" +msgid "%s() (built-in function)" +msgstr "%s() (zabudovaná funkcia)" -#: builders/__init__.py:309 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "ciele pre %d po súborov, ktoré sú zastarané" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "všetky zdrojové súbory" +msgid "%s() (%s method)" +msgstr "%s() (metóda %s)" -#: builders/__init__.py:330 +#: domains/javascript.py:186 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +msgid "%s() (class)" +msgstr "%s() (trieda)" -#: builders/__init__.py:337 +#: domains/javascript.py:188 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "súbor %r zadaný v príkazovom riadku nie je v zdrojovom adresári, ignorujem" +msgid "%s (global variable or constant)" +msgstr "%s (globálna premenná alebo konštanta)" -#: builders/__init__.py:348 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (atribút %s)" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "%d zdrojové súbory zadané v príkazovom riadku" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumenty" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "ciele pre %d zdrojových súborov, ktoré sú zastarané" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Vyvoláva" -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " -msgstr "zostavovanie [%s]: " +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Vracia" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "hľadanie zastaraných súborov…" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Návratový typ" -#: builders/__init__.py:410 +#: domains/javascript.py:374 #, python-format -msgid "%d found" -msgstr "%d nájdené" +msgid "%s (module)" +msgstr "%s (modul)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "nenájdené" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funkcia" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "ukladanie prostredia" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metóda" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "kontrolovanie konzistencie" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "trieda" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "žiadne ciele nie sú zastarané." +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "dáta" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "aktualizácia prostredia:" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribút" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s pridané, %s zmenené, %s odstránené" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" -#: builders/__init__.py:531 +#: domains/javascript.py:458 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "" +msgid "duplicate %s description of %s, other %s in %s" +msgstr "duplicitný %s popis %s, ďalší výskyt%s v %s" -#: builders/__init__.py:540 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "%s (directive)" +msgstr "%s (direktíva)" -#: builders/__init__.py:551 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "" +msgid ":%s: (directive option)" +msgstr "%s (voľba direktívy)" -#: builders/__init__.py:558 +#: domains/rst.py:224 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s (role)" +msgstr "%s (rola)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "direktíva" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "čítanie zdrojov…" +#: domains/rst.py:236 +msgid "role" +msgstr "rola" -#: builders/__init__.py:713 +#: domains/rst.py:262 #, python-format -msgid "docnames to write: %s" -msgstr "mená dokumentov na zapísanie: %s" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "duplicitný popis %s %s, ďalší výskyt v %s" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "príprava dokumentov" - -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "Zmenené vo verzii %s" -#: builders/__init__.py:883 +#: domains/changeset.py:34 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "nedekódovateľné zdrojové znaky, nahradené „?”: %r" +msgid "Deprecated since version %s" +msgstr "Zastarané od verzie %s" -#: builders/epub3.py:84 +#: domains/changeset.py:35 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "Súbory ePub sú v %(outdir)s." +msgid "Removed in version %s" +msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "zapisovanie súboru nav.xhtml..." +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "konfiguračná hodnota „epub_language” (alebo „language”) nesmie byť prázdna pri EPUB3" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "počet úloh musí byť kladné číslo" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "konfiguračná hodnota „epub_uid” má byť XML NAME pre EPUB3" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "konfiguračná hodnota „epub_title” (alebo „html_title”) nesmie byť prázdna pri EPUB3" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nGeneruje dokumentáciu zo zdrojových súborov.\n\nsphinx-build generuje dokumentáciu zo súborov v SOURCEDIR a umiestni ju\nv OUTPUTDIR. Konfiguračné voľby hľadá v 'conf.py' v SOURCEDIR.\nNa generovanie súborov šablón, vrátane 'conf.py' možno použiť nástroj\n'sphinx-quickstart'\n\nsphinx-build dokáže vytvoriť dokumentáciu v rôznych formátoch. Formát je\nzvolený zadaním mena zostavovača v príkazovom riadku; predvolene\nHTML. Zostavovače môžu vykonávať aj iné úlohy, ktoré súvisia so spracovaním\ndokuemntácie.\n\nPredvolene je zostavené všetko, čo bolo zmenené. Výstup len zvolených súborov\nmôže byť zostavený zadaním jednotlivých mien súborov.\n" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "konfiguračná hodnota „epub_author” nesmie byť prázdna pri EPUB3" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "cesta k zdrojovým súborom dokumentácie" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "konfiguračná hodnota „epub_contributor” nesmie byť prázdna pri EPUB3" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "cesta k výstupnej zložke" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "konfiguračná hodnota „epub_description” nesmie byť prázdna pri EPUB3" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "konfiguračná hodnota „epub_publisher” nesmie byť prázdna pri EPUB3" +#: cmd/build.py:114 +msgid "general options" +msgstr "všeobecné voľby" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "konfiguračná hodnota „epub_copyright” (alebo „copyright”) nesmie byť prázdna pri EPUB3" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "konfiguračná hodnota „epub_identifier” nesmie byť prázdna pri EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "konfiguračná hodnota „version” nesmie byť prázdna pri EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "zapísať všetky súbory (predvolene: zapísať len nové a zmenené súbory)" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "neplatný css_file: %r, ignorovaný" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "nepoužívať uložené prostredie, vždy čítať všetky súbory" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Súbory XML sú v %(outdir)s." +#: cmd/build.py:150 +msgid "path options" +msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "chyba zápisu súboru %s: %s" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Súbory pseudo-XML sú v %(outdir)s." +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Súbory Texinfo sú v %(outdir)s." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nSpustite v tomto adresári 'make' na ich spustenie pomocou makeinfo\n(použite tu 'make info' aby to bolo spustené automaticky)." +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "prepíše nastavenie konfiguračného súboru" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "nebola nájdená konfiguračná voľba „texinfo_documents”; dokumenty nebudú zapísané" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "pošle hodnotu do šablón HTML" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "konfiguračná voľba „texinfo_documents” odkazuje na neznámy dokument %s" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "spracovanie %s" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "riešenie odkazov…" +#: cmd/build.py:212 +msgid "console output options" +msgstr "voľby výstupu konzoly" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr "(v" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "zvýšiť rozvláčnosť (možno opakovať)" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "kopírovanie obrázkov…" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "žiadny výstup, len upozornenia na stderr" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "nemožno kopírovať súbor obrázka %r: %s" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "vôbec žiadny výstup, ani upozornenia" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "kopírovanie podporných súborov Texinfo" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "generovať farebný výstup (predvolene: automaticky detegovať)" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "chyba zápisu súboru Makefile: %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "negenerovať farebný výstup (predvolene: automaticky detegovať)" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "nájdená duplicitná položka Obsahu: %s" +#: cmd/build.py:252 +msgid "warning control options" +msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "nemožno čítať súbor obrázku %r: jeho kopírovanie namiesto toho" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "zapísať varovania (a chyby) do zadaného súboru" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "nemožno zapísať súbor obrázka %r: %s" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "prepnúť upozornenia na chyby" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Pillow nenájdené – kopírovanie súborov obrázkov" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "pri výnimke zobraziť úplné chybové hlásenie" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "zapisovanie súboru mimetype…" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "pri výnimke spustiť Pdb" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "zapisovanie súboru META-INF/container.xml…" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "zapisovanie súboru content.opf..." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "nemožno kombinovať voľbu -a a mená súborov" -#: builders/_epub_base.py:591 +#: cmd/build.py:357 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "neznámy typ MIME pre %s, ignorovaný" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "zapisovanie súboru toc.ncx..." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "argument voľby -D musí byť v tvare meno=hodnota" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "zapisovanie súboru %s…" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "argument voľby -A musí byť v tvare meno=hodnota" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "Zostavovač dummy negeneruje žiadne súbory." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "automaticky vložiť dokumentačné reťazce z modulov" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Katalógy správ sú v %(outdir)s." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "automaticky testovať kúsky kódu v blokoch dokumentačných reťazcov" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "prepojenie medzi dokumentáciou Sphinx rôznych modulov" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "čítanie šablón… " +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "písať položky „todo”, ktoré môžu byť zobrazené alebo skryté pri zostavení" -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "zapisovanie katalógov správ…" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "Stránky HTML sú v %(outdir)s." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "zahrnúť math, spracované ako obrázky PNG alebo SVG" -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "zostavovanie spoločného dokumentu" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "zahrnúť math, spracované prehliadačom pomocou MathJax" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "zapisovanie dodatočných súborov" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "podmienečné zahrnutie obsahu na základe konfiguračných volieb" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Hľadajte akékoľvek chyby v predošlom výstupe alebo v %(outdir)s/output.txt" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "zahrnúť odkazy na zdrojový kód dokumentovaných objektov Python" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "poškodený odkaz: %s (%s)" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "vytvoriť súbor .nojekyll na publikovanie dokumentu na GitHub" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "Kotva „%s” nenájdená" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Prosím, zadajte platnú cestu." -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Prosím, zadajte nejaký text." -#: builders/text.py:29 +#: cmd/quickstart.py:134 #, python-format -msgid "The text files are in %(outdir)s." -msgstr "Textové súbory sú v %(outdir)s." +msgid "Please enter one of %s." +msgstr "Prosím, zadajte jedno z 1%s." -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Prosím, zadajte buď 'y' alebo 'n'." -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Prosím, zadajte príponu súboru, napr. '.rst' alebo '.txt'." -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Vitajte v nástroji Sphinx %s quickstart." -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:235 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 +#: cmd/quickstart.py:242 #, python-format -msgid "%b %d, %Y" -msgstr "%d. %b %Y" +msgid "Selected root path: %s" +msgstr "Zvolená cesta koreňa: %s" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Zadajte cestu koreňa tejto dokumentácie." -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Cesta koreňa dokumentácie" -#: transforms/__init__.py:253 -#, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Chyba: nájdený existujúci conf.py v zadanej ceste koreňa." -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "Poznámka pod čiarou [%s] nie je odkazovaná." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart neprepíše existujúce projekty Sphinx." -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Prosím, zadajte novú cestu koreňa (alebo len Enter na skončenie)" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "Poznámka pod čiarou [#] nie je odkazovaná." +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Sú dve možnosti umiestnenia adresára zostavenia s výstupom Sphinx.\nMôžete použiť buď adresár „_build” v koreni alebo môžete mať oddelené\nadresáre „source” a „build” v ceste koreňa." -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Oddeliť zdrojový a výstupný adresár (y/n)" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "V koreňovom adresári budú vytvorená dva ďalšie adresáre; \"_templates\"\npre vlastné šablóny HTML a \"_static\" pre vlastné CSS a iné statické súbory\nMôžete zadať inú predponu (napr. „.”), ktorá nahradí podčiarkovník." -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Predpona mena adresárov templates a static" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "Meno projektu bude na viacerých miestach zostavenej dokumentácie." -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Názov projektu" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Meno(á) autora(ov)" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:309 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx má predstavu o \"version\" a \"release\" softvéru. Každá\nverzia môže mať viacero vydaní. Napríklad, pre Python je verzia\nniečo ako 2.5 alebo 3.0, zatiaľčo vydanie je niečo ako 2.5.1\nalebo 3.0a1. Ak nepotrebuje dvojitú štruktúru, jednoducho nastavte\noboje na rovnakú hodnotu." -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Verzia projektu" -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" - -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" - -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" - -#: _cli/__init__.py:231 -msgid "" -msgstr "" - -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Vydanie projektu" -#: environment/__init__.py:86 -msgid "new config" -msgstr "nová konfigurácia" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "Ak má byť dokumentácia písaná v inom ako Anglickom jazyku,\nmôžete tu zvoliť jazyk pomocou jeho kódu. Sphinx bude potom\nprekladať text, ktorý generuje, do tohoto jazyka.\n\nZoznam podporovaných jazykov nájdete na\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: environment/__init__.py:87 -msgid "config changed" -msgstr "zmenená konfigurácia" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Jazyk projektu" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "zmenené rozšírenie" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "Prípona mena zdrojových súborov. Zvyčajne to je buď „.txt”\nalebo „.rst”. Len súbory s touto príponou sú považované za dokumenty." -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "prostredie zostavenia nie je aktuálne" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Prípona zdrojových súborov" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "zdrojový adresár zmenený" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "Jeden dokument je špeciálny v tom, že je považovaný za vrcholový uzol\n„stromu obsahu”, čiže je to koreň hierarchickej štruktúry dokumentov.\nBežne to je „index”, ale ak je Váš „index” vlastnou šablónou, môžete\npoužiť aj iné meno súboru." -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Meno hlavného dokumentu (bez prípony)" -#: environment/__init__.py:330 +#: cmd/quickstart.py:368 #, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Chyba: nájdený existujúci hlavný súbor %s v zadanej ceste koreňa." -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart neprepíše existujúci súbor." -#: environment/__init__.py:379 +#: cmd/quickstart.py:378 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "Toto prostredie nie je kompatibilné zo zvoleným zostavovačom, prosím, zvoľte iný adresár doctree." +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Prosím, zadajte nové meno súboru alebo premenujte existujúci súbor a stlačte Enter" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "Zlyhalo skenovanie dokumentov v %s: %r" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Informuje, ktoré z nasledujúcich rozšírení Sphinx majú byť zapnuté:" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "Doména %r nie je zaregistrovaná" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Pozor: imgmath a mathjax nemožno zapnúť naraz. výber imgmath bol zrušený." -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "dokument nie je zahrnutý v žiadnom strome obsahu" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Súbory Makefile a príkazový súbor Windows môže byť pre Vás vygenerovaný\ntakže stačí spustiť napr. len `make html' namiesto priameho spúšťania sphinx-build." -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "nájdený na seba odkazujúci strom obsahu. Ignorované." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Vytvoriť Makefile? (y/n)" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Vytvoriť príkazový súbor Windows? (y/n) " -#: util/i18n.py:100 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "reading error: %s, %s" -msgstr "chyba čítania: %s, %s" +msgid "Creating file %s." +msgstr "Vytváranie súboru %s." -#: util/i18n.py:113 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "writing error: %s, %s" -msgstr "chyba zápisu: %s: %s" +msgid "File %s already exists, skipping." +msgstr "Súbor %s už existuje, preskočené." -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Dokončené: Počiatočná štruktúra adresára bola vytvorená." -#: util/i18n.py:236 +#: cmd/quickstart.py:520 #, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Teraz môže vyplniť svoj hlavný súbor %s a vytvoriť ostatné zdrojové súbory\ndokumentácie. " -#: util/i18n.py:245 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Neplatný formát dátumu. Použije jednoduché úvodzovky, ak ho chcete priamo vo výstupe: %s" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Na zostavenie dokumentácie použite Makefile, napr.:\n make builder" -#: util/docfields.py:103 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Na zostavenie dokumentácie použite príkaz sphinx-build, napr.:\n sphinx-build -b builder %s %s" -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:538 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "kde „builder” je jeden z podporovaných formátov, napr. html, latex alebo linkcheck." -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "strom obsahu obsahuje neexistujúci súbor %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nGenereuje požadované súbory projektu Sphinx.\n\nsphinx-quickstart je interaktívny nástroj, ktorý kladie niekoľko otázok o Vašom\nprojekte a potom generuje kompletný adresár dokumentácie a vzorový\nMakefile, na použitie so sphinx-build.\n" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "tichý režim" -#: util/display.py:82 -msgid "skipped" -msgstr "preskočené" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "koreň projektu" -#: util/display.py:87 -msgid "failed" -msgstr "zlyhalo" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Voľby štruktúry" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "ak je zadané, oddeliť zdrojový a výstupný adresár" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "ak je zadané, vytvoriť výstupný adresár v zdrojovom" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "náhrada za bodku v _templates apod." -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" -msgstr "neznámy typ uzla: %r" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Základné voľby projektu" -#: util/fileutil.py:76 -#, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "názov projektu" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "mená autorov" -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "predvolená rola %s nenájdená" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "verzia projektu" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "vydanie projektu" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "jazyk dokumentácie" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Poznámky pod čiarou" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "prípona zdrojových súborov" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[obrázok: %s]" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "meno hlavného dokumentu" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[obrázok]" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "použiť epub" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Index" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Voľby rozšírenia" -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" +msgstr "zapnúť rozšírenie %s" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "zapnúť konkrétne rozšírenia" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Vytvorenie Makefile a Batchfile" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "vytvoriť makefile" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "nevytvoriť makefile" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "vytvoriť batchfile" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "nevytvoriť batchfile" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "použiť režim make pre Makefile/make.bat" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Šablóny projektu" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "adresár šablóny pre súbory šablóny" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "definovať premennú šablóny" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "bolo zadané „quiet”, ale nebol zadaný „project” alebo „author”." + +#: cmd/quickstart.py:786 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Chyba: zadaná cesta nie je adresár alebo súbory sphinx už existujú." -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "titulok nie je vo vnútri figure." +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart generuje len do prázdneho adresára. Prosím, zadajte novú cestu koreňa." -#: writers/texinfo.py:1303 +#: cmd/quickstart.py:810 #, python-format -msgid "unimplemented node type: %r" -msgstr "neimplementovaný typ uzla: %r" +msgid "Invalid template variable: %s" +msgstr "Neplatná premenná šablóny: %s" -#: writers/latex.py:361 +#: directives/other.py:119 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "no Babel option known for language %r" -msgstr "žiadna známa voľba Babel pre jazyk %r" +msgid "toctree contains reference to excluded document %r" +msgstr "strom obsahu obsahuje odkaz na vylúčený dokument %r" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "príliš veľké :maxdepth:, ignorované." +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "strom obsahu obsahuje odkaz na neexistujúci dokument %r" -#: writers/latex.py:591 +#: directives/other.py:169 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "názov dokumentu nie je jeden uzol Text" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autor sekcie:" -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autor modulu:" + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autor kódu:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor:" + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:1183 +#: directives/patches.py:70 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "sú zadané obe, tabularcolumns aj voľba :widths:. :widths: je ignorované." +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "voľba \":file:\" direktívy csv-table teraz rozpoznáva absolútnu cestu ako relatívnu k zdrojovému adresáru. Prosím, aktualizujte svoj dokument." + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "" + +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" +msgstr "Neplatný popis: %s" -#: writers/latex.py:1580 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "dimension unit %s is invalid. Ignored." +msgid "line number spec is out of range(1-%d): %r" +msgstr "špecifikácia čísla riadku je mimo rozsahu (1-%d): %r" + +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Nemožno použiť obe voľby „%s” a „%s”" + +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:1939 +#: directives/code.py:235 #, python-format -msgid "unknown index entry type %s found" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: directives/code.py:276 #, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "neplatný math_eqref_format: %r" +msgid "Object named %r not found in include file %r" +msgstr "Objekt s menom %r nebol nájdený vo vloženom súbore %r" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "Nemožno použiť „lineno-match” s rozdelenou množinou „lines”" + +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Riadok %r: žiadne riadky z vloženého súboru %r" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d. %b %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Index" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Poznámky pod čiarou" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "titulok nie je vo vnútri figure." + +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "neimplementovaný typ uzla: %r" + +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[obrázok: %s]" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[obrázok]" #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" @@ -1834,6 +2345,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1850,795 +2366,479 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "Nemožno získať veľkosť obrázku. voľba :scale: je ignorovaná." -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "duplicitná menovka vzorca %s, ďalší výskyt v %s" +msgid "no Babel option known for language %r" +msgstr "žiadna známa voľba Babel pre jazyk %r" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (zabudovaná funkcia)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "príliš veľké :maxdepth:, ignorované." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (metóda %s)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (trieda)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "názov dokumentu nie je jeden uzol Text" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (globálna premenná alebo konštanta)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "sú zadané obe, tabularcolumns aj voľba :widths:. :widths: je ignorované." -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (atribút %s)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumenty" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Vyvoláva" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" +msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Vracia" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Návratový typ" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funkcia" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metóda" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "trieda" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "dáta" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atribút" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modul" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "duplicitný %s popis %s, ďalší výskyt%s v %s" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Zmenené vo verzii %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Zastarané od verzie %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktíva)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "%s (voľba direktívy)" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (rola)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "direktíva" - -#: domains/rst.py:235 -msgid "directive-option" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "rola" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "duplicitný popis %s %s, ďalší výskyt v %s" - -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "duplicitná citácia %s, ďalší výskyt v %s" - -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "Citácia [%s] nie je odkazovaná." - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Výstraha" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Upozornenie" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Nebezpečné" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Chyba" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Rada" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Dôležité" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Poznámka" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Viď aj" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tip" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Varovanie" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "automaticky vložiť dokumentačné reťazce z modulov" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "automaticky testovať kúsky kódu v blokoch dokumentačných reťazcov" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "prepojenie medzi dokumentáciou Sphinx rôznych modulov" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "písať položky „todo”, ktoré môžu byť zobrazené alebo skryté pri zostavení" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "zahrnúť math, spracované ako obrázky PNG alebo SVG" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "zahrnúť math, spracované prehliadačom pomocou MathJax" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "podmienečné zahrnutie obsahu na základe konfiguračných volieb" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "zahrnúť odkazy na zdrojový kód dokumentovaných objektov Python" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "vytvoriť súbor .nojekyll na publikovanie dokumentu na GitHub" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Prosím, zadajte platnú cestu." - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Prosím, zadajte nejaký text." - -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "Prosím, zadajte jedno z 1%s." - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Prosím, zadajte buď 'y' alebo 'n'." - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Prosím, zadajte príponu súboru, napr. '.rst' alebo '.txt'." - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Vitajte v nástroji Sphinx %s quickstart." - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" -msgstr "Zvolená cesta koreňa: %s" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "Zadajte cestu koreňa tejto dokumentácie." - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Cesta koreňa dokumentácie" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Chyba: nájdený existujúci conf.py v zadanej ceste koreňa." - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart neprepíše existujúce projekty Sphinx." - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Prosím, zadajte novú cestu koreňa (alebo len Enter na skončenie)" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Sú dve možnosti umiestnenia adresára zostavenia s výstupom Sphinx.\nMôžete použiť buď adresár „_build” v koreni alebo môžete mať oddelené\nadresáre „source” a „build” v ceste koreňa." +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Oddeliť zdrojový a výstupný adresár (y/n)" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "V koreňovom adresári budú vytvorená dva ďalšie adresáre; \"_templates\"\npre vlastné šablóny HTML a \"_static\" pre vlastné CSS a iné statické súbory\nMôžete zadať inú predponu (napr. „.”), ktorá nahradí podčiarkovník." +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Predpona mena adresárov templates a static" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: cmd/quickstart.py:297 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" -"The project name will occur in several places in the built documentation." -msgstr "Meno projektu bude na viacerých miestach zostavenej dokumentácie." - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Názov projektu" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Meno(á) autora(ov)" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:308 +#: transforms/i18n.py:275 +#, python-brace-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "Sphinx má predstavu o \"version\" a \"release\" softvéru. Každá\nverzia môže mať viacero vydaní. Napríklad, pre Python je verzia\nniečo ako 2.5 alebo 3.0, zatiaľčo vydanie je niečo ako 2.5.1\nalebo 3.0a1. Ak nepotrebuje dvojitú štruktúru, jednoducho nastavte\noboje na rovnakú hodnotu." - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Verzia projektu" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Vydanie projektu" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "" -#: cmd/quickstart.py:323 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "Ak má byť dokumentácia písaná v inom ako Anglickom jazyku,\nmôžete tu zvoliť jazyk pomocou jeho kódu. Sphinx bude potom\nprekladať text, ktorý generuje, do tohoto jazyka.\n\nZoznam podporovaných jazykov nájdete na\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Jazyk projektu" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:339 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "Prípona mena zdrojových súborov. Zvyčajne to je buď „.txt”\nalebo „.rst”. Len súbory s touto príponou sú považované za dokumenty." - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Prípona zdrojových súborov" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "Jeden dokument je špeciálny v tom, že je považovaný za vrcholový uzol\n„stromu obsahu”, čiže je to koreň hierarchickej štruktúry dokumentov.\nBežne to je „index”, ale ak je Váš „index” vlastnou šablónou, môžete\npoužiť aj iné meno súboru." +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Meno hlavného dokumentu (bez prípony)" +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" -#: cmd/quickstart.py:367 +#: transforms/__init__.py:258 #, python-format msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Chyba: nájdený existujúci hlavný súbor %s v zadanej ceste koreňa." - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart neprepíše existujúci súbor." - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Prosím, zadajte nové meno súboru alebo premenujte existujúci súbor a stlačte Enter" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Informuje, ktoré z nasledujúcich rozšírení Sphinx majú byť zapnuté:" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Pozor: imgmath a mathjax nemožno zapnúť naraz. výber imgmath bol zrušený." +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Súbory Makefile a príkazový súbor Windows môže byť pre Vás vygenerovaný\ntakže stačí spustiť napr. len `make html' namiesto priameho spúšťania sphinx-build." +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "Poznámka pod čiarou [%s] nie je odkazovaná." -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Vytvoriť Makefile? (y/n)" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Vytvoriť príkazový súbor Windows? (y/n) " +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "Poznámka pod čiarou [#] nie je odkazovaná." -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: util/inventory.py:147 #, python-format -msgid "Creating file %s." -msgstr "Vytváranie súboru %s." +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: util/inventory.py:166 #, python-format -msgid "File %s already exists, skipping." -msgstr "Súbor %s už existuje, preskočené." +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Dokončené: Počiatočná štruktúra adresára bola vytvorená." +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "chyba čítania: %s, %s" -#: cmd/quickstart.py:519 +#: util/i18n.py:113 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "Teraz môže vyplniť svoj hlavný súbor %s a vytvoriť ostatné zdrojové súbory\ndokumentácie. " +msgid "writing error: %s, %s" +msgstr "chyba zápisu: %s: %s" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Na zostavenie dokumentácie použite Makefile, napr.:\n make builder" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" -#: cmd/quickstart.py:530 +#: util/i18n.py:244 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Na zostavenie dokumentácie použite príkaz sphinx-build, napr.:\n sphinx-build -b builder %s %s" +msgid "Invalid Babel locale: %r." +msgstr "" -#: cmd/quickstart.py:537 +#: util/i18n.py:253 +#, python-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "kde „builder” je jeden z podporovaných formátov, napr. html, latex alebo linkcheck." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Neplatný formát dátumu. Použije jednoduché úvodzovky, ak ho chcete priamo vo výstupe: %s" -#: cmd/quickstart.py:572 +#: util/osutil.py:131 +#, python-format msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nGenereuje požadované súbory projektu Sphinx.\n\nsphinx-quickstart je interaktívny nástroj, ktorý kladie niekoľko otázok o Vašom\nprojekte a potom generuje kompletný adresár dokumentácie a vzorový\nMakefile, na použitie so sphinx-build.\n" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "tichý režim" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "koreň projektu" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Voľby štruktúry" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "ak je zadané, oddeliť zdrojový a výstupný adresár" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "ak je zadané, vytvoriť výstupný adresár v zdrojovom" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "náhrada za bodku v _templates apod." - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Základné voľby projektu" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "názov projektu" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "mená autorov" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "verzia projektu" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "vydanie projektu" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "jazyk dokumentácie" +#: util/display.py:82 +msgid "skipped" +msgstr "preskočené" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "prípona zdrojových súborov" +#: util/display.py:87 +msgid "failed" +msgstr "zlyhalo" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "meno hlavného dokumentu" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "použiť epub" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Voľby rozšírenia" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "neznámy typ uzla: %r" -#: cmd/quickstart.py:670 +#: util/fileutil.py:76 #, python-format -msgid "enable %s extension" -msgstr "zapnúť rozšírenie %s" +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "zapnúť konkrétne rozšírenia" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" +msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Vytvorenie Makefile a Batchfile" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "vytvoriť makefile" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "predvolená rola %s nenájdená" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "nevytvoriť makefile" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "vytvoriť batchfile" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "strom obsahu obsahuje neexistujúci súbor %r" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "nevytvoriť batchfile" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "použiť režim make pre Makefile/make.bat" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "pokračovanie z predošlej strany" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Šablóny projektu" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "pokračuje na ďalšej strane" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "adresár šablóny pre súbory šablóny" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "definovať premennú šablóny" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Symboly" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "bolo zadané „quiet”, ale nebol zadaný „project” alebo „author”." +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Čísla" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Chyba: zadaná cesta nie je adresár alebo súbory sphinx už existujú." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "strana" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart generuje len do prázdneho adresára. Prosím, zadajte novú cestu koreňa." +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Vydanie" -#: cmd/quickstart.py:809 +#: transforms/post_transforms/images.py:79 #, python-format -msgid "Invalid template variable: %s" -msgstr "Neplatná premenná šablóny: %s" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "počet úloh musí byť kladné číslo" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\nGeneruje dokumentáciu zo zdrojových súborov.\n\nsphinx-build generuje dokumentáciu zo súborov v SOURCEDIR a umiestni ju\nv OUTPUTDIR. Konfiguračné voľby hľadá v 'conf.py' v SOURCEDIR.\nNa generovanie súborov šablón, vrátane 'conf.py' možno použiť nástroj\n'sphinx-quickstart'\n\nsphinx-build dokáže vytvoriť dokumentáciu v rôznych formátoch. Formát je\nzvolený zadaním mena zostavovača v príkazovom riadku; predvolene\nHTML. Zostavovače môžu vykonávať aj iné úlohy, ktoré súvisia so spracovaním\ndokuemntácie.\n\nPredvolene je zostavené všetko, čo bolo zmenené. Výstup len zvolených súborov\nmôže byť zostavený zadaním jednotlivých mien súborov.\n" +msgid "Could not fetch remote image: %s [%s]" +msgstr "Nemožno získať vzdialený obrázok: %s [%s]" -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "cesta k zdrojovým súborom dokumentácie" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "Nemožno získať vzdialený obrázok: %s [%d]" -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "cesta k výstupnej zložke" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Neznámy formát obrázku: %s..." -#: cmd/build.py:109 +#: transforms/post_transforms/__init__.py:88 msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:114 -msgid "general options" -msgstr "všeobecné voľby" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "viac ako jeden cieľ krížového odkazu %r: môže byť %s" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "zapísať všetky súbory (predvolene: zapísať len nové a zmenené súbory)" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r cieľ odkazu nenájdený: %s" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "nepoužívať uložené prostredie, vždy čítať všetky súbory" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "Prerušené!" -#: cmd/build.py:150 -msgid "path options" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "prepíše nastavenie konfiguračného súboru" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "pošle hodnotu do šablón HTML" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" -msgstr "voľby výstupu konzoly" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Prosím, nahláste to, i keď to bola chyba používateľa, aby mohla byť nabudúce poskytnutá lepšia chybová správa." -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "zvýšiť rozvláčnosť (možno opakovať)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Zbaliť bočný panel" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "žiadny výstup, len upozornenia na stderr" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigácia" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "vôbec žiadny výstup, ani upozornenia" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Hľadať v %(docstitle)s" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "generovať farebný výstup (predvolene: automaticky detegovať)" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "O dokumentácii" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "negenerovať farebný výstup (predvolene: automaticky detegovať)" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Hľadať" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Autorské právo" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "zapísať varovania (a chyby) do zadaného súboru" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Naposledy aktualizované %(last_updated)s." -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "prepnúť upozornenia na chyby" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Vytvorené pomocou Sphinx %(sphinx_version)s." -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "pri výnimke zobraziť úplné chybové hlásenie" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Predošlá téma" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "pri výnimke spustiť Pdb" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "predošlá kapitola" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Ďalšia téma" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "nemožno kombinovať voľbu -a a mená súborov" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "ďalšia kapitola" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "Index – %(key)s" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "argument voľby -D musí byť v tvare meno=hodnota" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "argument voľby -A musí byť v tvare meno=hodnota" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Celý index na jednej strane" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Zbaliť bočný panel" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Táto stránka" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Obsah" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "Zobraziť zdroj" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Hľadať" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Rýchle hľadanie" #: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 #: themes/basic/searchfield.html:12 msgid "Go" msgstr "OK" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "Zobraziť zdroj" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Obsah" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Hľadať v %(docstitle)s" - #: themes/basic/defindex.html:4 msgid "Overview" msgstr "Prehľad" @@ -2684,7 +2884,7 @@ msgstr "Celkový index modulov" msgid "quick access to all modules" msgstr "rýchly prístup ku všetkým modulom" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Všeobecný index" @@ -2692,23 +2892,15 @@ msgstr "Všeobecný index" msgid "all functions, classes, terms" msgstr "všetky funkcie, triedy, termíny" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Táto stránka" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Obsah" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Celý index na jednej strane" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Rýchle hľadanie" +msgid "Search %(docstitle)s" +msgstr "Hľadať v %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2718,57 +2910,6 @@ msgstr "Indexové stránky po písmenách" msgid "can be huge" msgstr "môže byť rozsiahle" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Predošlá téma" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "predošlá kapitola" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Ďalšia téma" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "ďalšia kapitola" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigácia" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Hľadať v %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "O dokumentácii" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Autorské právo" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Naposledy aktualizované %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Vytvorené pomocou Sphinx %(sphinx_version)s." - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2785,21 +2926,21 @@ msgstr "Hľadanie viacerých slov vracia len zhody, ktoré obsahujú\n všetk msgid "search" msgstr "hľadať" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Skryť výsledky hľadania" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Obsah" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Výsledky hľadania" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Vášmu hľadaniu nezodpovedá žiadny dokument. Prosím, skontrolujte, že všetky zadané slová sú správne napísané a že ste zvolili vhodné kategórie." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2809,22 +2950,21 @@ msgstr[1] "" msgstr[2] "" msgstr[3] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Hľadanie" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Príprava hľadania..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", v " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Skryť výsledky hľadania" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2832,6 +2972,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Zmeny vo verzii %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2853,120 +2998,127 @@ msgstr "Ostatné zmeny" msgid "Expand sidebar" msgstr "Rozbaliť bočný panel" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametre" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Premenné" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Vyzdvihuje" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (v module %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (v module %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (zabudovaná premenná)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (zabudovaná trieda)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (trieda v %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (metóda triedy %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (statická metóda %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (vlastnosť %s)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Index modulov Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "moduly" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Zastarané" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "výnimka" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "metóda triedy" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statická metóda" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "vlastnosť" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "nájdený viac ako jeden cieľ krížového odkazu %r: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (zastarané)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametre" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Premenné" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Vyzdvihuje" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "Duplicitná deklarácia C++, definovaná aj v %s:%s.\nDeklarácia je '.. cpp:%s:: %s'." #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2977,92 +3129,85 @@ msgstr "Parametre šablóny" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "Duplicitná deklarácia C++, definovaná aj v %s:%s.\nDeklarácia je '.. cpp:%s:: %s'." - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "člen" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "typ" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "koncept" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerátor" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "parameter funkcie" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "parameter šablóny" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Duplicitná deklarácia C, definovaná aj v %s:%s.\nDeklarácia je '.. c:%s:: %s'." -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "premenná" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "makro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "premenná prostredia; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3157,514 +3302,422 @@ msgstr "" msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "zistený cirkulárny odkaz stromu obsahu, ignorované: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "strom obsahu obsahuje odkaz na dokument %r, ktorý nemá názov, odkaz nebude generovaný" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "viď %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "viď aj %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "neznámy typ položky indexu %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Symboly" - -#: environment/collectors/asset.py:98 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "image file not readable: %s" -msgstr "súbor obrázku nemožno čítať: %s" +msgid "invalid value set (missing closing brace): %s" +msgstr "neplatná hodnota množiny (chýba koncová zátvorka): %s" -#: environment/collectors/asset.py:126 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "image file %s not readable: %s" -msgstr " Súbor obrázku %s nemožno čítať: %s" +msgid "invalid value set (missing opening brace): %s" +msgstr "neplatná hodnota množiny (chýba začiatočná zátvorka): %s" -#: environment/collectors/asset.py:163 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "download file not readable: %s" -msgstr "súbor na stiahnutie nemožno čítať: %s" +msgid "malformed string literal (missing closing quote): %s" +msgstr "neplatná textová konštanta (chýba koncová úvodzovka): %s" -#: environment/collectors/toctree.py:259 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s už je priradené číslo sekcie (vnorený číslovaný strom obsahu?)" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "Prerušené!" +msgid "malformed string literal (missing opening quote): %s" +msgstr "neplatná textová konštanta (chýba začiatočná úvodzovka): %s" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Príklad" -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Príklady" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Argumenty kľúčových slov" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Poznámky" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Ostatné parametre" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Prosím, nahláste to, i keď to bola chyba používateľa, aby mohla byť nabudúce poskytnutá lepšia chybová správa." +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Varovania" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "viac ako jeden cieľ krížového odkazu %r: môže byť %s" - -#: transforms/post_transforms/__init__.py:299 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "A mocked object is detected: %r" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "%r reference target not found: %s" -msgstr "%r cieľ odkazu nenájdený: %s" +msgid "alias of %s" +msgstr "alias pre %s" -#: transforms/post_transforms/images.py:79 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "Nemožno získať vzdialený obrázok: %s [%s]" +msgid "Bases: %s" +msgstr "Základ: %s" -#: transforms/post_transforms/images.py:96 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "Nemožno získať vzdialený obrázok: %s [%d]" +msgid "invalid value for member-order option: %s" +msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "Unknown image format: %s..." -msgstr "Neznámy formát obrázku: %s..." +msgid "invalid value for class-doc-from option: %s" +msgstr "" -#: builders/html/__init__.py:113 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "Stránky HTML sú v %(outdir)s." +msgid "invalid signature for auto%s (%r)" +msgstr "" -#: builders/html/__init__.py:348 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "Failed to read build info file: %r" -msgstr "Čítanie súboru zostavenia info zlyhalo: %r" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:383 +#: ext/autodoc/_names.py:93 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "index" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "„::” v automodule nedáva zmysel" -#: builders/html/__init__.py:560 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "Logo of %s" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "ďalší" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "predošlý" +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "generovanie indexov" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "zapisovanie dodatočných stránok" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "cesta k dokumentovanému modulu" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "kopírovanie súborov na stiahnutie…" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "adresár umiestnenia výstupu" -#: builders/html/__init__.py:818 -#, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "nemožno kopírovať súbor na stiahnutie %r: %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "maximálna hĺbka submodulov, ktorá má byť zobrazená v obsahu (predvolene: 4)" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "prepísať existujúce súbory" -#: builders/html/__init__.py:882 -#, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "Kopírovanie súboru v html_static_file zlyhalo: %s: %r" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "nasledovať symbolické odkazy. Vhodné v kombinácii s collective.recipe.omelette." -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "kopírovanie statických súborov" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "spustí skript bez vytvorenia súborov" -#: builders/html/__init__.py:934 -#, python-format -msgid "cannot copy static file %r" -msgstr "nemožno kopírovať statický súbor %r" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "umiestniť dokumentáciu každého modulu vo vlastnej stránke" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "kopírovanie extra súborov" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "zahrnúť ”_súkromné” moduly" -#: builders/html/__init__.py:949 -#, python-format -msgid "cannot copy extra file %r" -msgstr "nemožno kopírovať extra súbor %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "meno súboru obsahu (predvolene: modules)" -#: builders/html/__init__.py:955 -#, python-format -msgid "Failed to write build info file: %r" -msgstr "Zápis súboru zostavenia info zlyhal: %r" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "nevytvárať súbor obsahu" -#: builders/html/__init__.py:1005 +#: ext/apidoc/_cli.py:135 msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "index hľadania nemožno načítať, ale nebudú zostavované všetky dokumenty, takže index nebude kompletný." +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "stránka %s vyhovuje dvom vzorom v html_sidebars: %r a %r" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "vložiť dokumentáciu modulu pred dokumentáciou submodulu" -#: builders/html/__init__.py:1216 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "pri spracovaní stránky %s nastala chyba Unicode. Prosím, zaistite, že všetky konfiguračné hodnoty, ktoré obsahujú nieASCII hodnotu sú reťazce Unicode." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "interpretovať cesty modulov v zmysle implicitnej špecifikácie menných priestorov PEP-0420" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "Nastala chyba pri spracovaní stránky %s.\nPríčina: %r" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" + +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "prípona súboru (predvolene: rst)" + +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" + +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "generovať úplný projekt pomocou sphinx-quickstart" + +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "pripojiť module_path do sys.path, použité pri --full" + +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "meno projektu (predvolene: meno koreňového modulu)" + +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "autor(i) projektu, použité pri --full" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "generovanie inventára objektov…" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "verzia projektu, použité pri --full" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "generovanie indexu hľadania v %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "vydanie projektu, použité pri --full, predvolene --doc-version" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "neplatné js_file: %r, ignorované" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "voľby rozšírenia" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "Zaregistrovaných je viac math_renderer, ale žiadny nie je zvolený." +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1346 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "Unknown math_renderer %r is given." -msgstr "Zdaný neznámy math_renderer %r." +msgid "enable %s extension, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1360 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "položka html_extra_path %r je umiestnené vo vnútri výstupného adresára" +msgid "%s is not a directory." +msgstr "%s nie je adresár." -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "položka „html_extra_path entry” %r neexistuje" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "" -#: builders/html/__init__.py:1380 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "položka html_static_path %r je umiestnené vo vnútri výstupného adresára" +msgid "apidoc_modules item %i must be a dict" +msgstr "" -#: builders/html/__init__.py:1385 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "html_static_path entry %r does not exist" -msgstr "položka „html_static_path” %r neexistuje" +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "logo file %r does not exist" -msgstr "súbor loga %r neexistuje" +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "" -#: builders/html/__init__.py:1407 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "favicon file %r does not exist" -msgstr "súbor favicon %r neexistuje" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/apidoc/_extension.py:140 +#, python-format +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "%s %s documentation" -msgstr "Dokumentácia %s %s" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Súbory LaTeX sú v %(outdir)s." - -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nSpustite v tomto adresári 'make' na ich spustenie pomocou (pdf)latex\n(použite tu 'make latexpdf' aby to bolo spustené automaticky)." - -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "nebola nájdená konfiguračná voľba „latex_documents”; dokmenty nebudú zapísané" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "konfiguračná voľba „latex_documents” odkazuje na neznámy dokument %s" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Vydanie" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "kopírovanie podporných súborov Tex" - -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "kopírovanie dodatočných súborov" +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "Neznámy konfiguračný kľúč: latex_elements[%r], ignorovaný." +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "Neznáma voľba témy: latex_theme_options[%r], ignorovaná." - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/autosummary/generate.py:630 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/autosummary/generate.py:634 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r nemá nastavenia „theme”" +msgid "[autosummary] writing to %s" +msgstr "" -#: builders/latex/theming.py:91 +#: ext/autosummary/generate.py:679 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "téma %r nemá nastavenie „1%s”" - -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "pokračovanie z predošlej strany" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "pokračuje na ďalšej strane" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Čísla" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "strana" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Argumenty kľúčových slov" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "adresár umiestnenia výstupu" -#: ext/napoleon/docstring.py:176 +#: ext/autosummary/generate.py:915 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "neplatná hodnota množiny (chýba koncová zátvorka): %s" +msgid "default suffix for files (default: %(default)s)" +msgstr "predvolená prípona súboru (predvolene: %(default)s)" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:923 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "neplatná hodnota množiny (chýba začiatočná zátvorka): %s" +msgid "custom template directory (default: %(default)s)" +msgstr "vlastný adresár šablón (predvolene: %(default)s)" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:931 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "neplatná textová konštanta (chýba koncová úvodzovka): %s" +msgid "document imported members (default: %(default)s)" +msgstr "dokumentovať importovaných členov (predvolene: %(default)s)" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:940 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "neplatná textová konštanta (chýba začiatočná úvodzovka): %s" - -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Príklad" - -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Príklady" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Poznámky" - -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Ostatné parametre" - -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "" - -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "" - -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Varovania" - -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "Autosummary s popiskom vyžaduje voľbu :toctree: , ignorované." -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3672,548 +3725,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "zlyhalo spracovanie mena %s" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "zlyhal import objektu %s" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: súbor nenájdený: %s" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" + +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" + +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" + +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "" + +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "" + +#: ext/intersphinx/_load.py:122 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:588 -#, python-format -msgid "[autosummary] generating autosummary for: %s" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "[autosummary] writing to %s" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" + +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:324 msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "nastali problémy s niektorými inventármi, ale boli nájdené funkčné alternatívy:" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:332 +#, python-format +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "adresár umiestnenia výstupu" - -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "predvolená prípona súboru (predvolene: %(default)s)" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "inventár intersphinx bol presunutý: %s -> %s" -#: ext/autosummary/generate.py:882 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "vlastný adresár šablón (predvolene: %(default)s)" +msgid "(in %s %s)" +msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "dokumentovať importovaných členov (predvolene: %(default)s)" +msgid "(in %s)" +msgstr "(v %s)" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:387 #, python-format -msgid "Failed to remove %s: %s" +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "cesta k dokumentovanému modulu" - -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "adresár umiestnenia výstupu" - -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "maximálna hĺbka submodulov, ktorá má byť zobrazená v obsahu (predvolene: 4)" - -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "prepísať existujúce súbory" - -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "nasledovať symbolické odkazy. Vhodné v kombinácii s collective.recipe.omelette." - -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "spustí skript bez vytvorenia súborov" - -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "umiestniť dokumentáciu každého modulu vo vlastnej stránke" - -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "zahrnúť ”_súkromné” moduly" - -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "meno súboru obsahu (predvolene: modules)" - -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "nevytvárať súbor obsahu" - -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "vložiť dokumentáciu modulu pred dokumentáciou submodulu" - -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "interpretovať cesty modulov v zmysle implicitnej špecifikácie menných priestorov PEP-0420" - -#: ext/apidoc/_cli.py:160 -msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "prípona súboru (predvolene: rst)" - -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "generovať úplný projekt pomocou sphinx-quickstart" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "pripojiť module_path do sys.path, použité pri --full" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "meno projektu (predvolene: meno koreňového modulu)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "autor(i) projektu, použité pri --full" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "verzia projektu, použité pri --full" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "Neplatné __slots__ nájdené v %s. Ignorované." -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "vydanie projektu, použité pri --full, predvolene --doc-version" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "chyba formátovania argumentov %s: %s" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "voľby rozšírenia" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "%s is not a directory." -msgstr "%s nie je adresár." +msgid "Failed to parse a default argument value for %r: %s" +msgstr "Zlyhalo spracovanie predvolenej hodnoty argumentu %r: %s" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" -msgstr "" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ má byť zoznam reťazcov, nie %r (v module %s) -- ignorované __all__" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" -msgstr "" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "chýbajúci atribút spomenutý vo voľbe :members: : modul %s, atribút %s" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +msgid "missing attribute %s in object %s" +msgstr "chýba atribút %s objektu %s" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "alias of TypeVar(%s)" +msgstr "alias pre TypeVar(%s)" + +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_extension.py:157 -#, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:114 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "Stránky HTML sú v %(outdir)s." -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:337 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to read build info file: %r" +msgstr "Čítanie súboru zostavenia info zlyhalo: %r" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "index" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:549 #, python-format -msgid "Would create file %s." +msgid "Logo of %s" msgstr "" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s v%s)" -msgstr "(v %s v%s)" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "ďalší" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" -msgstr "(v %s)" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "predošlý" -#: ext/intersphinx/_resolve.py:108 -#, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "generovanie indexov" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "zapisovanie dodatočných stránok" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "kopírovanie súborov na stiahnutie…" + +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "nemožno kopírovať súbor na stiahnutie %r: %s" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "Kopírovanie súboru v html_static_file zlyhalo: %s: %r" + +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "kopírovanie statických súborov" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "" +msgid "cannot copy static file %r" +msgstr "nemožno kopírovať statický súbor %r" + +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "kopírovanie extra súborov" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "cannot copy extra file %r" +msgstr "nemožno kopírovať extra súbor %r" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "Zápis súboru zostavenia info zlyhal: %r" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "index hľadania nemožno načítať, ale nebudú zostavované všetky dokumenty, takže index nebude kompletný." -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "stránka %s vyhovuje dvom vzorom v html_sidebars: %r a %r" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "pri spracovaní stránky %s nastala chyba Unicode. Prosím, zaistite, že všetky konfiguračné hodnoty, ktoré obsahujú nieASCII hodnotu sú reťazce Unicode." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "Nastala chyba pri spracovaní stránky %s.\nPríčina: %r" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "generovanie inventára objektov…" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +msgid "dumping search index in %s" +msgstr "generovanie indexu hľadania v %s" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "" +msgid "invalid js_file: %r, ignored" +msgstr "neplatné js_file: %r, ignorované" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "nastali problémy s niektorými inventármi, ale boli nájdené funkčné alternatívy:" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Zaregistrovaných je viac math_renderer, ale žiadny nie je zvolený." -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "nemožno získať žiadne inventáre kvôli týmto problémom:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." +msgstr "Zdaný neznámy math_renderer %r." -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1365 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "inventár intersphinx bol presunutý: %s -> %s" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "položka html_extra_path %r je umiestnené vo vnútri výstupného adresára" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1370 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "položka „html_extra_path entry” %r neexistuje" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "položka html_static_path %r je umiestnené vo vnútri výstupného adresára" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "" +msgid "html_static_path entry %r does not exist" +msgstr "položka „html_static_path” %r neexistuje" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "chyba formátovania argumentov %s: %s" +msgid "logo file %r does not exist" +msgstr "súbor loga %r neexistuje" + +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "súbor favicon %r neexistuje" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" -msgstr "" +msgid "%s %s documentation" +msgstr "Dokumentácia %s %s" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:87 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r nemá nastavenia „theme”" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "„::” v automodule nedáva zmysel" +#: builders/latex/theming.py:90 +#, python-format +msgid "%r doesn't have \"%s\" setting" +msgstr "téma %r nemá nastavenie „1%s”" + +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ má byť zoznam reťazcov, nie %r (v module %s) -- ignorované __all__" +msgid "No footnote was found for given reference node %r" +msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Súbory LaTeX sú v %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "chýbajúci atribút spomenutý vo voľbe :members: : modul %s, atribút %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nSpustite v tomto adresári 'make' na ich spustenie pomocou (pdf)latex\n(použite tu 'make latexpdf' aby to bolo spustené automaticky)." + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "nebola nájdená konfiguračná voľba „latex_documents”; dokmenty nebudú zapísané" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "konfiguračná voľba „latex_documents” odkazuje na neznámy dokument %s" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "kopírovanie podporných súborov Tex" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "kopírovanie dodatočných súborov" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Neznámy konfiguračný kľúč: latex_elements[%r], ignorovaný." -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" -msgstr "Základ: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "Neznáma voľba témy: latex_theme_options[%r], ignorovaná." -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/toctree.py:259 #, python-format -msgid "missing attribute %s in object %s" -msgstr "chýba atribút %s objektu %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s už je priradené číslo sekcie (vnorený číslovaný strom obsahu?)" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:98 #, python-format -msgid "alias of %s" -msgstr "alias pre %s" +msgid "image file not readable: %s" +msgstr "súbor obrázku nemožno čítať: %s" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "alias pre TypeVar(%s)" +msgid "image file %s not readable: %s" +msgstr " Súbor obrázku %s nemožno čítať: %s" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "" +msgid "download file not readable: %s" +msgstr "súbor na stiahnutie nemožno čítať: %s" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "Neplatné __slots__ nájdené v %s. Ignorované." +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "zistený cirkulárny odkaz stromu obsahu, ignorované: %s <- %s" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "Zlyhalo spracovanie predvolenej hodnoty argumentu %r: %s" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "strom obsahu obsahuje odkaz na dokument %r, ktorý nemá názov, odkaz nebude generovaný" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" + +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "viď %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "viď aj %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "neznámy typ položky indexu %r" diff --git a/sphinx/locale/sl/LC_MESSAGES/sphinx.mo b/sphinx/locale/sl/LC_MESSAGES/sphinx.mo index eff8e4c8e0b..aa91f949677 100644 Binary files a/sphinx/locale/sl/LC_MESSAGES/sphinx.mo and b/sphinx/locale/sl/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/sl/LC_MESSAGES/sphinx.po b/sphinx/locale/sl/LC_MESSAGES/sphinx.po index 212e0eb4621..61a68fa5b26 100644 --- a/sphinx/locale/sl/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/sl/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Slovenian (http://app.transifex.com/sphinx-doc/sphinx-1/language/sl/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: sl\n" "Plural-Forms: nplurals=4; plural=(n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,468 +536,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Pozor" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Previdno" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Nevarno" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Napaka" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Nasvet" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Pomembno" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Opomba" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Poglej Tudi" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Nasvet" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Opozorilo" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (v " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "error writing file %s: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:436 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/doctest.py:297 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/doctest.py:457 -#, python-format -msgid "no code/output in %s block at %s:%s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:594 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:342 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:536 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:545 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:556 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Vgrajeni deli" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Nivo modula" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -738,9 +1174,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,949 +1327,995 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Todo" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:47 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Avtor sekcije: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Avtor modula: " - -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " -msgstr "Avtor: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Vgrajeni deli" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "Nivo modula" - -#: builders/changes.py:124 -msgid "copying source files..." +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:133 +#: domains/citation.py:75 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/citation.py:92 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" - -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" - -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/manpage.py:71 +#: domains/math.py:73 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/__init__.py:224 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:183 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +msgid "%s() (built-in function)" +msgstr "%s() (vgrajene funkcije)" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s metoda)" -#: builders/__init__.py:275 +#: domains/javascript.py:186 #, python-format -msgid "all of %d po files" -msgstr "" +msgid "%s() (class)" +msgstr "%s() (razred)" -#: builders/__init__.py:297 +#: domains/javascript.py:188 #, python-format -msgid "targets for %d po files that are specified" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s atribut)" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Vrne" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Vrne tip" -#: builders/__init__.py:361 +#: domains/javascript.py:374 #, python-format -msgid "%d source files given on command line" +msgid "%s (module)" +msgstr "%s (modul)" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funkcija" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "razred" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribut" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" + +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "" +msgid "Changed in version %s" +msgstr "Spremenjeno v verziji %s" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "Deprecated since version %s" +msgstr "Zastarelo od verzije %s" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "" - -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (v " - -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b, %Y" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:298 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:350 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" + +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: util/nodes.py:706 +#: cmd/quickstart.py:671 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "enable %s extension" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/rst.py:73 +#: cmd/quickstart.py:810 #, python-format -msgid "default role %s not found" +msgid "Invalid template variable: %s" msgstr "" -#: util/inventory.py:147 +#: directives/other.py:119 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/inventory.py:166 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Opombe" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/other.py:169 #, python-format -msgid "[image: %s]" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[slika]" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Avtor sekcije: " -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Abecedni seznam" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Avtor modula: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "" + +#: directives/other.py:209 +msgid "Author: " +msgstr "Avtor: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" + +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" +msgstr "" + +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:216 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:231 #, python-format -msgid "no Babel option known for language %r" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:276 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "Object named %r not found in include file %r" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: writers/latex.py:1183 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d %b, %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Abecedni seznam" + +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Opombe" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" msgstr "" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[slika]" + #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" msgstr "" @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,795 +2363,479 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (vgrajene funkcije)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metoda)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (razred)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:616 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s atribut)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Vrne" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Vrne tip" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funkcija" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "razred" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atribut" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modul" - -#: domains/javascript.py:454 +#: writers/latex.py:1228 #, python-format -msgid "duplicate %s description of %s, other %s in %s" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/changeset.py:26 +#: writers/latex.py:1615 #, python-format -msgid "Added in version %s" +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Spremenjeno v verziji %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Zastarelo od verzije %s" - -#: domains/changeset.py:29 +#: writers/latex.py:1950 #, python-format -msgid "Removed in version %s" +msgid "unknown index entry type %s found" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Pozor" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Previdno" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Nevarno" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Napaka" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Nasvet" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Pomembno" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Opomba" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Poglej Tudi" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Nasvet" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Opozorilo" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:133 +#: util/i18n.py:100 #, python-format -msgid "Please enter one of %s." +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:229 +#: util/i18n.py:244 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:234 +#: util/i18n.py:253 +#, python-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:241 +#: util/osutil.py:131 #, python-format -msgid "Selected root path: %s" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:286 +#: util/fileutil.py:76 +#, python-format msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:297 +#: util/docfields.py:103 +#, python-format msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:308 +#: util/nodes.py:462 +#, python-format msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "nadaljevanje iz prejšnje strani" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Izdaja" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:406 +#: transforms/post_transforms/__init__.py:88 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "Creating file %s." +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: transforms/post_transforms/__init__.py:291 #, python-format -msgid "File %s already exists, skipping." +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:572 +#: _cli/util/errors.py:207 msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigacija" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Išči med %(docstitle)s" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "O dokumentih" -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Išči" -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Vse pravice pridržane" -#: cmd/quickstart.py:637 -msgid "version of project" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Zadnjič posodobljeno %(last_updated)s." -#: cmd/quickstart.py:651 -msgid "document language" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Prejšnja tema" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "prejšnje poglavje" -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Naslednja tema" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "naslednje poglavje" -#: cmd/quickstart.py:670 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "enable %s extension" +msgid "Index – %(key)s" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Poln indeks na eni strani" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Trenutna stran" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "Prikaži izvorno kodo" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "" - -#: cmd/quickstart.py:809 -#, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "" - -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "" - -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "" - -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" - -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "" - -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" - -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Išči" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Hitro iskanje" #: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 #: themes/basic/searchfield.html:12 msgid "Go" msgstr "Potrdi" -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "Prikaži izvorno kodo" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Išči %(docstitle)s" - #: themes/basic/defindex.html:4 msgid "Overview" msgstr "Pregled" @@ -2660,111 +2860,52 @@ msgstr "Kazalo in seznami:" msgid "Complete Table of Contents" msgstr "Popoln Seznam Vsebine" -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "prikazi vse sekcije in podsekcije" - -#: domains/std/__init__.py:773 domains/std/__init__.py:786 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "Iskalnik" - -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "išči po dokumentaciji" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "Splošen seznam modulov" - -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "hiter dostop do vseh modulov" - -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Splošni abecedni seznam" - -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "vse funkcije, razredi, izrazi" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Trenutna stran" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Poln indeks na eni strani" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Hitro iskanje" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Indeksiraj strani po črki" - -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "lahko je veliko" - -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Prejšnja tema" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "prejšnje poglavje" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "prikazi vse sekcije in podsekcije" -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Naslednja tema" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "Iskalnik" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "naslednje poglavje" +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "išči po dokumentaciji" -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigacija" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "Splošen seznam modulov" -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Išči med %(docstitle)s" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "hiter dostop do vseh modulov" -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "O dokumentih" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Splošni abecedni seznam" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Vse pravice pridržane" +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "vse funkcije, razredi, izrazi" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/layout.html:201 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Zadnjič posodobljeno %(last_updated)s." +msgid "Search %(docstitle)s" +msgstr "Išči %(docstitle)s" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Indeksiraj strani po črki" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "lahko je veliko" #: themes/basic/search.html:20 msgid "" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "išči" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Skrij resultate iskanja" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Rezultati Iskanja" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2806,22 +2947,21 @@ msgstr[1] "" msgstr[2] "" msgstr[3] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Skrij resultate iskanja" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2829,6 +2969,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2850,121 +2995,128 @@ msgstr "Ostale spremembe" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametri" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Sproži izjemo" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (v modulu %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (v modulu %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (vgrajene spremenljivke)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (vgrajen razred)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (razred v %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statična metoda)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "Moduli" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Zastarelo" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "izjema" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "statična metoda" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (zastarelo)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametri" - -#: domains/python/_object.py:206 -msgid "Variables" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Sproži izjemo" - #: domains/cpp/__init__.py:159 msgid "Template Parameters" msgstr "" @@ -2974,92 +3126,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "član" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "tip" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "okoljska spremenljivka; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3088,580 +3233,488 @@ msgid "glossary seems to be misformatted, check indentation" msgstr "" #: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "okoljska spremenljivka" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Seznam modulov" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "okoljska spremenljivka" + +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Seznam modulov" + +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1138 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1153 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1157 #, python-format -msgid "%r reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1453 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "abecedni seznam" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "naprej" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "nazaj" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Izdaja" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "nadaljevanje iz prejšnje strani" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3669,548 +3722,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "abecedni seznam" + +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "naprej" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "nazaj" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/sphinx.pot b/sphinx/locale/sphinx.pot index 82e9de89441..e8e5825e9d9 100644 --- a/sphinx/locale/sphinx.pot +++ b/sphinx/locale/sphinx.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Sphinx 8.2.0\n" +"Project-Id-Version: Sphinx 9.0.4\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 18:26+0000\n" +"POT-Creation-Date: 2025-12-04 06:45+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -17,6 +17,127 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes" +" are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -31,127 +152,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with" " this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as " "errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -159,12 +307,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -172,83 +320,215 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it" +" should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called " "sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,475 +536,638 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a " "list of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but " "`{current}` is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep " "pre-2.0 behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes" -" are: %s" +"This environment is incompatible with the selected builder, please choose" +" another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it" -" should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "" +"conf value \"epub_language\" (or \"language\") should not be empty for " +"EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "" +"conf value \"epub_title\" (or \"html_title\") should not be empty for " +"EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "" +"conf value \"epub_copyright\" (or \"copyright\")should not be empty for " +"EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the " -"imgmath_%s setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a " +"different location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from" +" conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not " +"included in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document " +"must be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format msgid "module %s could not be imported: %s" msgstr "" @@ -736,9 +1179,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -773,6 +1217,33 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,950 +1333,1003 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the " +"imgmath_%s setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "inline latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:216 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:231 +#: ext/doctest.py:297 #, python-format -msgid "Include file '%s' not found or reading it failed" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:451 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:568 #, python-format -msgid "Object named %r not found in include file %r" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/code.py:314 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path" -" as a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 -#, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "" - -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "" - -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a " -"different location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from" -" conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not " -"included in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document " -"must be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and " +"places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template " +"files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults " +"to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for " +"selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is" +" specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 +#: cmd/build.py:131 msgid "" -"conf value \"epub_language\" (or \"language\") should not be empty for " -"EPUB3" +"run in parallel with N processes, when possible. 'auto' uses the number " +"of CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "" -"conf value \"epub_title\" (or \"html_title\") should not be empty for " -"EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: " +"OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "" -"conf value \"epub_copyright\" (or \"copyright\")should not be empty for " -"EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/texinfo.py:230 +#: cmd/build.py:357 #, python-format -msgid "error writing file Makefile: %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:134 +#, python-format +msgid "Please enter one of %s." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:242 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent references in translated message. original: {0}, translated:" -" {1}" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you " +"separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:287 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"Inside the root directory, two more directories will be created; " +"\"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and " +"other static\n" +"files. You can enter another prefix (such as \".\") to replace the " +"underscore." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:298 +msgid "The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: transforms/__init__.py:253 -#, python-format -msgid "4 column based index found. It might be a bug of extensions you use: %r" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-" +"language." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:368 +#, python-format msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +"Error: the master file %s has already been found in the selected root " +"path." msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:378 +msgid "Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has" +" been deselected." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that " +"you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other " +"documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about " +"your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose" -" another doctree directory." +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to " -"output it directly: %s" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role " -"is not in the domain." +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' " -"instead." +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/nodes.py:706 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "enable %s extension" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: util/osutil.py:131 -#, python-format +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"\"quiet\" is specified, but any of \"project\" or \"author\" is not " +"specified." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:786 +msgid "Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a " +"new root path." msgstr "" -#: util/docutils.py:789 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown node type: %r" +msgid "Invalid template variable: %s" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:119 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination " -"path has existing data)." +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:156 #, python-format -msgid "default role %s not found" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/inventory.py:147 +#: directives/other.py:169 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 -msgid "encountered title node not in section, topic, table, admonition or sidebar" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path" +" as a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:87 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "Invalid caption: %s" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "no Babel option known for language %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:231 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:276 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Object named %r not found in include file %r" msgstr "" -#: writers/latex.py:1183 -msgid "both tabularcolumns and :widths: option are given. :widths: is ignored." +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/latex.py:1580 +#: directives/code.py:314 #, python-format -msgid "dimension unit %s is invalid. Ignored." +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: writers/latex.py:1939 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format -msgid "unknown index entry type %s found" +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "encountered title node not in section, topic, table, admonition or sidebar" +msgstr "" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/texinfo.py:1303 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "unimplemented node type: %r" +msgstr "" + +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1834,6 +2358,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1850,806 +2379,476 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this " +"table can not be rendered as a tabulary; the given colspec will be " +"ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated:" +" {1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to " +"output it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination " +"path has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role " +"is not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: " +"%s' instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you " -"separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a" +" bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; " -"\"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and " -"other static\n" -"files. You can enter another prefix (such as \".\") to replace the " -"underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-" -"language." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root " -"path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py" +" with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has" -" been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that " -"you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other " -"documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about " -"your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "" -"\"quiet\" is specified, but any of \"project\" or \"author\" is not " -"specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a " -"new root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and " -"places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template " -"files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults " -"to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for " -"selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is" -" specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number " -"of CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: " -"OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2697,7 +2896,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2705,22 +2904,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2731,57 +2922,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2798,42 +2938,41 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words " "are spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "Search finished, found ${resultCount} pages matching the search query." msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2842,6 +2981,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2863,119 +3007,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: " "for one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2987,92 +3138,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\"," @@ -3109,572 +3253,484 @@ msgid "grammar token" msgstr "" #: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no " -"link will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py" -" with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a" -" bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 ext/autodoc/_names.py:53 +#: ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the" -" index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all" -" config values that contain non-ASCII content are Unicode strings." +msgid "Would create file %s." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:28 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"\n" +"Look recursively in for Python modules and packages and " +"create\n" +"one reST file with automodule directives per package in the " +".\n" +"\n" +"The s can be file and/or directory patterns that will be" +"\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:50 +msgid "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:135 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern" -" has a string value: %s. Change to `html_sidebars = %r`." +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected " -"in configuration options)" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following " +"exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It " +"generates\n" +"the reStructuredText files from the autosummary directives contained in " +"the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3682,555 +3738,587 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with " "%r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does " "not contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following " -"exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. " +"Project identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element " +"tuple or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target " +"URI, inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It " -"generates\n" -"the reStructuredText files from the autosummary directives contained in " -"the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had " +"working alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and " -"create\n" -"one reST file with automodule directives per package in the " -".\n" -"\n" -"The s can be file and/or directory patterns that will be" -"\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in" +" object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following " +"exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the" +" index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all" +" config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses " +"the 'style' field in HTML templates, which was was deprecated in Sphinx " +"5.1 and removed in Sphinx 7.0. The theme must be updated to use the " +"'styles' field instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. " -"Project identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element " -"tuple or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target " -"URI, inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern" +" has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had " -"working alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected " +"in configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following " -"exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no " +"link will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/sq/LC_MESSAGES/sphinx.mo b/sphinx/locale/sq/LC_MESSAGES/sphinx.mo index 6a395cc6af0..5c1e09b0f73 100644 Binary files a/sphinx/locale/sq/LC_MESSAGES/sphinx.mo and b/sphinx/locale/sq/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/sq/LC_MESSAGES/sphinx.po b/sphinx/locale/sq/LC_MESSAGES/sphinx.po index 2f7e4ec4311..4a3a548f863 100644 --- a/sphinx/locale/sq/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/sq/LC_MESSAGES/sphinx.po @@ -4,11 +4,12 @@ # # Translators: # Besnik Bleta , 2021-2025 +# Rafael Fontenelle , 2025 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 18:26+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Besnik Bleta , 2021-2025\n" "Language-Team: Albanian (http://app.transifex.com/sphinx-doc/sphinx-1/language/sq/)\n" @@ -19,6 +20,127 @@ msgstr "" "Language: sq\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "Cenueshmëri dhe Ekspozime të Rëndomta; CVE %s" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "numër CVE %s i pavlefshëm" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "Common Weakness Enumeration; CWE %s" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "numër CWE i pavlefshëm %s" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "numër PEP i pavlefshëm %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "numër RFC i pavlefshëm %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "Nuk mbulohen seksione formësimi teme të tjerë nga [theme] dhe [options] (u provua të merre një vlerë nga %r)." + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "rregullimi %s.%s nuk haset në asnjë prej formësimeve temash ku u kërkua" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "është dhënë mundësi teme %r e pambuluar" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "kartela %r te shteg teme s’është kartelë zip e vlefshme ose nuk përmban temë" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "s’u gjet temë e emërtuar %r (mungon theme.toml?)" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "Tema %r ka trashëgimi rrethore" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "Tema %r trashëgon nga %r, e cila s’është temë e ngarkuar. Temat e ngarkuara janë: %s" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "Tema %r ka shumë paraardhës" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "s’u gjet kartelë formësimi teme në %r" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "tema %r s’ka tabelën “theme”" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "Tabela “[theme]” e temës %r s’është tabelë" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "Tema %r duhet të përcaktojë rregullimin “theme.inherit”" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "Tablea “[options]” e temës %r s’është tabelë" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "Rregullimi “theme.pygments_style” duhet të jetë një tabelë. Ndihmëz: “%s”" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "për dokumentin “%s” u gjetën disa kartela: %s\nPërdorni %r për montimin." + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "U shpërfill dokument i palexueshëm %r." + #: extension.py:58 #, python-format msgid "" @@ -33,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Ky projekt lyp zgjerimin %s të paktën nën versionin %s dhe prandaj s’mund të montohet me versionin e ngarkuar (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "O nome do analisador léxico de Pygments %r não é conhecido" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "A sintaxe literal_block %r foi \"%s\" e resultou em um erro no token: %r. Tentando novamente em modo relaxado." + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Vlerë formësimi %r e pranishme tashmë" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Emër i panjohur akti: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "Trajtuesi %r për aktin %r u përgjigj me një përjashtim" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "S’gjendet dot drejtori burim (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Drejtoria e përfundimeve (%s) s’është drejtori" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Drejtoria burim dhe drejtoria vendmbërritje s’mund të jenë identike" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Po xhirohet Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Ky projekt lyp të paktën Sphinx v%s, ndaj s’mund të montohet me këtë version." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "po krijohet drejtori përfundimesh" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "teksa ujdiset zgjerimi %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' siç është përcaktuar aktualisht te conf.py s’është funksion Python që mund të thirret. Ju lutemi, ndryshojeni përcaktimin e tij që ta bëni një funksion që mund të thirret. Kjo është e nevojshme që conf.py të sillet si një zgjerim Sphinx." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "po ngarkohen përkthime [%s]… " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "u bë" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "s’është i passhëm për mesazhe të brendshëm" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" -msgstr "" +msgstr "carregando ambiente serializado com pickle" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "dështoi: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "S’u përzgjodh montues, po përdoret parazgjedhja: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "montimi përfundoi me probleme." -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "montimi doli me sukses." -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "montimi përfundoi me probleme, 1 sinjalizim (me sinjalizimet të trajtuara si gabime)." -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "montimi përfundoi me probleme, 1 sinjalizim." -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "montimi doli me sukses, 1 sinjalizim." -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "montimi përfundoi me probleme, %s sinjalizime (me sinjalizimet e trajtuara si gabime)." -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "montimi përfundoi me probleme, %s sinjalizime." -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "montimi doli me sukses, %s sinjalizime." -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "klasa %r e nyjeve është e regjistruar tashmë, vizitorët e saj do të anashkalohen" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "direktiva %r është tashmë e regjistruar dhe s’do të anashkalohet" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "roli %r është tashmë i regjistruar dhe s’do të anashkalohet" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +310,12 @@ msgid "" "explicit" msgstr "zgjerimi %s nuk deklaron nëse është i parrezik për lexim paralel, po merret se s’është - ju lutemi, kërkojini autorin të zgjerimit ta kontrollojë dhe ta bëjë këtë shprehimisht" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "zgjerimi %s s’është i sigurt për lexim paralel" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +323,214 @@ msgid "" "explicit" msgstr "zgjerimi %s nuk deklaron nëse është i parrezik për shkrim paralel, po merret se s’është - ju lutemi, kërkojini autorin të zgjerimit ta kontrollojë dhe ta bëjë këtë shprehimisht" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "zgjerimi %s s’është i sigurt për shkrim paralel" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" -msgstr "" +msgstr "fazer %s serial" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "drejtoria e formësimeve nuk përmban një kartelë conf.py (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Klasa %s e montuesit nuk ka atribut \"name\"" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Montuesi %r ekziston tashmë (te moduli %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Emër %s montuesi jo i regjistruar ose i passhëm përmes pike hyrjeje" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Emër montuesi %s jo i regjistruar" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "përkatësi %s e regjistruar tashmë" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "përkatësi %s ende e paregjistruar" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "Direktiva %r është e regjistruar tashmë te përkatësia %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "Roli %r është i regjistruar tashmë te përkatësia %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "Treguesi %r është i regjistruar tashmë te përkatësia %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "object_type %r është i regjistruar tashmë" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "crossref_type %r është i regjistruar tashmë" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r është i regjistruar tashmë" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser për %r është i regjistruar tashmë" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Përtypës burimesh për %s jo i regjistruar" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "Përkthyesi për %r ekziston tashmë" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "kwargs për add_node() duhet të jetë një çift funksioni (visit, depart): %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r tashmë i regjistruar" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "vizatuesi i formulave matematikore %s është i regjistruar tashmë" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "U gjet vlerë e pavlefshme formësimi: 'language = Asnjë'. Përditësojeni formësimin tuaj me një kod të vlefshëm gjuhe. Përkohësisht po përdoret 'en' (anglisht)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "zgjerimi %r qe shkrirë me Sphinx-in që me versionin %s; ky zgjerim është shpërfillur." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Përjashtimi origjinal:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "S’u importua dot zgjerimi %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "zgjerimi %r s’ka funksion setup(); a është vërtet një modul zgjerimi Sphinx-i?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "Zgjerimi %s i përdorur nga ky projekt lyp të paktën Sphinx v%s; prandaj s’mund të montohet me këtë version." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "zgjerimi %r u përgjigj me një objekt të pambuluar prej funksionit të vet setup(); duhet të përgjigjet me Asnjë ose një fjalorth tejtëdhënash" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "`None` s’është lloj i vlefshëm kartele për %r." + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "drejtoria e formësimeve nuk përmban një kartelë conf.py (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "“%s” duhet të jetë “0” ose “1”, u mora “%s”" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "s’mund të anashkalohet rregullim formësimi fjalorthi %r, po shpërfillet (për të ujdisur elemente individuale, përdorni %r)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "numër %r i pavlefshëm për vlerë formësimi %r, po shpërfillet" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "s’mund të anashkalohet rregullim formësimi %r me një lloj të pambuluar, po shpërfillet" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "vlerë e panjohur formësimi %r te anashkalimi, po shpërfillet" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "S’ka vlerë të tillë formësimi: %r" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Vlerë formësimi %r e pranishme tashmë" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" -msgstr "" +msgstr "não é possível armazenar em cache o valor de configuração não serializável com pickle: %r (porque ele contém um objeto de função, classe ou módulo)" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "U gjet vlerë e pavlefshme formësimi: 'language = Asnjë'. Përditësojeni formësimin tuaj me një kod të vlefshëm gjuhe. Përkohësisht po përdoret 'en' (anglisht)." + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Ka një gabim sintakse te kartela juaj e formësimit: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Kartela e formësimit (ose një nga modulet që ajo importon) thirri sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,537 +538,722 @@ msgid "" "%s" msgstr "Ka një gabim të programueshëm te kartela juaj e formësimit:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "S’u arrit të shndërrohej %r në një grup të ngrirë" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "Po shndërrohet `source_suffix = %r` në `source_suffix = %r`." -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "Për vlerën e formësimit `source_suffix' pritet fjalor, varg, ose një listë vargjesh. Në vend të tyre u mor `%r' (lloji %s)." -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Ndarja %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Figura %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tabela %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" -msgstr "" +msgstr "Listando %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Vlera e formësimit `{name}` duhet të jetë një nga {candidates}, por është dhënë `{current}`." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Vlera e formësimit `{name}' është e llojit `{current.__name__}'; pritej {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Vlera e formësimit `{name}' është e llojit `{current.__name__}', si parazgjedhje merr `{default.__name__}'." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "s’u gjet primary_domain %r, po shpërfillet." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "Sphinx-i tanimë përdor “index” si dokumentin kryesor, si parazgjedhje. Që të mbahet sjellja e para-2.0, vini “master_doc = 'contents'”." -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "" - -#: highlighting.py:209 -#, python-format +#: config.py:892 msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "Mbulimi për kodim burimesh tjetër nga UTF-8 është nxjerrë nga përdorimi dhe do të hiqet me Sphinx 10. Ju lutemi, nëse kjo shkakton ndonjë problem, komentoni te https://github.com/sphinx-doc/sphinx/issues/13665." -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "Nuk mbulohen seksione formësimi teme të tjerë nga [theme] dhe [options] (u provua të merre një vlerë nga %r)." +#: environment/__init__.py:89 +msgid "new config" +msgstr "formësim i ri" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "rregullimi %s.%s nuk haset në asnjë prej formësimeve temash ku u kërkua" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "formësimi ndryshoi" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "është dhënë mundësi teme %r e pambuluar" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "zgjerimet u ndryshuan" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "kartela %r te shteg teme s’është kartelë zip e vlefshme ose nuk përmban temë" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "version jo i tanishëm i mjedisit të montimit" + +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "drejtoria burim ka ndryshuar" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "s’u gjet temë e emërtuar %r (mungon theme.toml?)" +msgid "The configuration has changed (1 option: %r)" +msgstr "Formësimi është ndryshuar (1 mundësi: %r)" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" -msgstr "Tema %r ka trashëgimi rrethore" +msgid "The configuration has changed (%d options: %s)" +msgstr "Formësimi është ndryshuar (%d mundësi: %s)" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "Formësimi është ndryshuar (%d mundësi: %s, …)" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "Tema %r trashëgon nga %r, e cila s’është temë e ngarkuar. Temat e ngarkuara janë: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Ky mjedis është i papërputhshëm me montuesin e përzgjedhur, ju lutemi, zgjidhni një tjetër drejtori doctree." -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "Tema %r ka shumë paraardhës" +msgid "Failed to scan documents in %s: %r" +msgstr "S’u arrit të skanohen dokumente te %s: %r" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" -msgstr "s’u gjet kartelë formësimi teme në %r" +msgid "Domain %r is not registered" +msgstr "Përkatësia %r s’është e regjistruar" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "tema %r s’ka tabelën “theme”" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "dokumenti s’është i përfshirë në ndonjë toctree" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "Tabela “[theme]” e temës %r s’është tabelë" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "U gjet “toctree” që i referohet vetes. U shpërfill." -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "Tema %r duhet të përcaktojë rregullimin “theme.inherit”" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgstr "o documento é referenciado em várias árvores de tópicos: %s, selecionando: %s <- %s" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "Tablea “[options]” e temës %r s’është tabelë" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Vëmendje" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "Rregullimi “theme.pygments_style” duhet të jetë një tabelë. Ndihmëz: “%s”" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Kujdes" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Vlerë formësimi %r e pranishme tashmë" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Rrezik" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Emër i panjohur akti: %s" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Gabim" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "Trajtuesi %r për aktin %r u përgjigj me një përjashtim" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Ndihmëz" -#: project.py:72 +#: locale/__init__.py:234 +msgid "Important" +msgstr "E rëndësishme" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Shënim" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Shihni edhe" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Ndihmëz" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Sinjalizim" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Kartelat Texinfo gjenden në %(outdir)s." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "për dokumentin “%s” u gjetën disa kartela: %s\nPërdorni %r për montimin." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nXhironi 'make' te ajo drejtori, që të xhirohen këto përmes makeinfo-s\n(përdorni këtu 'make info' që kjo të kryhet automatikisht)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "U shpërfill dokument i palexueshëm %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "s’u gjet vlerë formësimi \"texinfo_documents\"; s’do të shkruhet ndonjë dokument" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Klasa %s e montuesit nuk ka atribut \"name\"" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "vlera e formësimit \"texinfo_documents\" i referohet një dokumenti të panjohur %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Montuesi %r ekziston tashmë (te moduli %s)" +msgid "processing %s" +msgstr "po përpunohet %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Emër %s montuesi jo i regjistruar ose i passhëm përmes pike hyrjeje" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "po shkruhet" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Emër montuesi %s jo i regjistruar" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "po shquhen referencat…" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "përkatësi %s e regjistruar tashmë" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (në " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "përkatësi %s ende e paregjistruar" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "po kopjohen figura… " -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "Direktiva %r është e regjistruar tashmë te përkatësia %s" +msgid "cannot copy image file %r: %s" +msgstr "s’kopjohet dot kartelë figure %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "Roli %r është i regjistruar tashmë te përkatësia %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "po kopjohen kartela mbulimi Texinfo" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "Treguesi %r është i regjistruar tashmë te përkatësia %s" +msgid "error writing file Makefile: %s" +msgstr "gabim në shkrim kartele Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "object_type %r është i regjistruar tashmë" +msgid "The manual pages are in %(outdir)s." +msgstr "Faqet e doracakut gjenden në %(outdir)s." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "crossref_type %r është i regjistruar tashmë" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "s’u gjet vlerë formësimi \"man_pages\"; s’do të shkruhet ndonjë faqe doracaku" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r është i regjistruar tashmë" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "vlera e formësimit \"man_pages\" i referohet një dokumenti të panjohur %s" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "source_parser për %r është i regjistruar tashmë" +msgid "The HTML page is in %(outdir)s." +msgstr "Faqja HTML gjenden në %(outdir)s." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "Përtypës burimesh për %s jo i regjistruar" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "po montohet dokument njësh" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "Përkthyesi për %r ekziston tashmë" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "po shkruhen kartela shtesë" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "kwargs për add_node() duhet të jetë një çift funksioni (visit, depart): %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "Montuesi provë nuk prodhon kartela." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r tashmë i regjistruar" +msgid "The message catalogs are in %(outdir)s." +msgstr "Katalogët e mesazheve gjenden te %(outdir)s." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "vizatuesi i formulave matematikore %s është i regjistruar tashmë" +msgid "building [%s]: " +msgstr "po montohet [%s]: " -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "zgjerimi %r qe shkrirë me Sphinx-in që me versionin %s; ky zgjerim është shpërfillur." +msgid "targets for %d template files" +msgstr "objektiva për kartela gjedhe %d" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Përjashtimi origjinal:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "po lexohen gjedhe… " -#: registry.py:545 +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "po shkruhen katalogë mesazhesh… " + +#: builders/linkcheck.py:87 #, python-format -msgid "Could not import extension %s" -msgstr "S’u importua dot zgjerimi %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Shihni për çfarëdo gabimesh te përfundimi më sipër ose te %(outdir)s/output.txt" -#: registry.py:552 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "zgjerimi %r s’ka funksion setup(); a është vërtet një modul zgjerimi Sphinx-i?" +msgid "broken link: %s (%s)" +msgstr "lidhje e dëmtuar: %s (%s)" -#: registry.py:565 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "Zgjerimi %s i përdorur nga ky projekt lyp të paktën Sphinx v%s; prandaj s’mund të montohet me këtë version." +msgid "Anchor '%s' not found" +msgstr "S’u gjet spirancë '%s'" -#: registry.py:577 +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "linkcheck_allowed_redirects. Pritej një fjalor." + +#: builders/linkcheck.py:799 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "zgjerimi %r u përgjigj me një objekt të pambuluar prej funksionit të vet setup(); duhet të përgjigjet me Asnjë ose një fjalorth tejtëdhënash" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "S’u arrit të përpilohet shprehje e rregullt te linkcheck_allowed_redirects: %r %s" -#: registry.py:612 +#: builders/epub3.py:83 #, python-format -msgid "`None` is not a valid filetype for %r." -msgstr "`None` s’është lloj i vlefshëm kartele për %r." +msgid "The ePub file is in %(outdir)s." +msgstr "Kartela ePub gjendet te %(outdir)s." + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "po shkruhet kartelë nav.xhtml…" + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "vlera e formësimit \"epub_language\" (ose \"language\") s’duhet të jetë e zbrazët për EPUB3" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "vlera e formësimit \"epub_uid\" duhet të jetë XML NAME për EPUB3" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "vlera e formësimit \"epub_title\" (ose \"html_title\") s’duhet të jetë e zbrazët për EPUB3" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "vlera e formësimit \"epub_author\" s’duhet të jetë e zbrazët për EPUB3" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "vlera e formësimit \"epub_contributor\" s’duhet të jetë e zbrazët për EPUB3" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "vlera e formësimit \"epub_description\" s’duhet të jetë e zbrazët për EPUB3" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "vlera e formësimit \"epub_publisher\" s’duhet të jetë e zbrazët për EPUB3" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "vlera e formësimit \"epub_copyright\" (ose \"copyright\") s’duhet të jetë e zbrazët për EPUB3" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "vlera e formësimit \"epub_identifier\" s’duhet të jetë e zbrazët për EPUB3" -#: roles.py:206 +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "vlera e formësimit \"version\" s’duhet të jetë e zbrazët për EPUB3" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "Cenueshmëri dhe Ekspozime të Rëndomta; CVE %s" +msgid "invalid css_file: %r, ignored" +msgstr "css_file e pavlefshme: %r, u shpërfill" -#: roles.py:229 +#: builders/xml.py:29 #, python-format -msgid "invalid CVE number %s" -msgstr "numër CVE %s i pavlefshëm" +msgid "The XML files are in %(outdir)s." +msgstr "Kartelat XML gjenden në %(outdir)s." -#: roles.py:251 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +msgid "error writing file %s: %s" +msgstr "gabim në shkrim kartele %s: %s" -#: roles.py:274 +#: builders/xml.py:103 #, python-format -msgid "invalid CWE number %s" -msgstr "numër CWE i pavlefshëm %s" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Kartelat pseudo-XML gjenden në %(outdir)s." -#: roles.py:294 +#: builders/_epub_base.py:223 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +msgid "duplicated ToC entry found: %s" +msgstr "u gjet zë TeL i përsëdytur: %s" -#: roles.py:317 +#: builders/_epub_base.py:436 #, python-format -msgid "invalid PEP number %s" -msgstr "numër PEP i pavlefshëm %s" +msgid "cannot read image file %r: copying it instead" +msgstr "s’lexohet dot kartelë figure %r: në vend të tij, po kopjohet" -#: roles.py:355 +#: builders/_epub_base.py:467 #, python-format -msgid "invalid RFC number %s" -msgstr "numër RFC i pavlefshëm %s" +msgid "cannot write image file %r: %s" +msgstr "s’shkruhet dot kartelë figure %r: %s" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[burim]" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "S’u gjet Pillow - po kopjohen kartela figurë" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "po theksohet kod moduli… " +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "po shkruhet kartelë llojesh MIME…" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[dokumente]" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "po shkruhet kartelë META-INF/container.xml…" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Kod moduli" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "po shkruhet kartelë content.opf…" -#: ext/viewcode.py:353 +#: builders/_epub_base.py:594 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        Kod burim për %s

        " - -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Përmbledhje: kod moduli" +msgid "unknown mimetype for %s, ignoring" +msgstr "lloj MIME i panjohur për %s, po shpërfillet" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Krejt modulet për të cilët ka kod të gatshëm

        " +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "nyja ka nivel të pavlefshëm" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "po shkruhet kartelë toc.ncx…" -#: ext/autosectionlabel.py:52 +#: builders/_epub_base.py:802 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "pjesa “%s” etiketohet si “%s”" +msgid "writing %s file..." +msgstr "po shkruhet kartelë %s…" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/text.py:27 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "etiketë %s e përsëdytur, tjetër instancë te %s" - -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "Lidhje për te ky ekuacion" - -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "=================== kohëzgjatjet më të ngadalta të leximit ===================" +msgid "The text files are in %(outdir)s." +msgstr "Kartelat tekst gjenden në %(outdir)s." -#: ext/doctest.py:118 +#: builders/__init__.py:229 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "mungon '+' ose '-' te mundësia '%s'." +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "s’u gjet figurë e përshtatshme për montuesin %s: %s (%s)" -#: ext/doctest.py:124 +#: builders/__init__.py:237 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' s’është mundësi e vlefshme." +msgid "a suitable image for %s builder not found: %s" +msgstr "s’u gjet figurë e përshtatshme për montuesin %s: %s" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' s’është mundësi pyversion e vlefshme" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "po montohet [mo]: " -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "lloj TestCode i pavlefshëm" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "po shkruhet përfundim… " -#: ext/doctest.py:297 +#: builders/__init__.py:280 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "Testimi i doctests-eve te burimet përfundoi, shihni te përfundimet në %(outdir)s/output.txt." +msgid "all of %d po files" +msgstr "krejt kartelat po %d" -#: ext/doctest.py:457 +#: builders/__init__.py:302 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "s’ka kod/dhënie te blloku %s në %s:%s" +msgid "targets for %d po files that are specified" +msgstr "objektiva për kartela po %d që janë specifikuar" -#: ext/doctest.py:568 +#: builders/__init__.py:314 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "po shpërfillet kod “doctest” i pavlefshëm: %r" +msgid "targets for %d po files that are out of date" +msgstr "objektiva për kartela po %d që janë të papërditësuara" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "krejt kartelat burim" -#: ext/imgmath.py:162 +#: builders/__init__.py:335 #, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "Urdhri LaTeX %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_late" +msgid "file %r given on command line does not exist, " +msgstr "kartela %r, dhënë te rreshti i urdhrave, nuk ekziston, " -#: ext/imgmath.py:181 +#: builders/__init__.py:342 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "Urdhri %s %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_%s" +"file %r given on command line is not under the source directory, ignoring" +msgstr "kartela %r e dhënë te rresht urdhrash s’gjendet te drejtori burim, po shpërfillet" -#: ext/imgmath.py:344 +#: builders/__init__.py:353 #, python-format -msgid "display latex %r: %s" -msgstr "shfaq latex %r: %s" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "kartela %r, dhënë te rreshti i urdhrave, s’është dokument i vlefshëm, po shpërfillet" -#: ext/imgmath.py:380 +#: builders/__init__.py:366 #, python-format -msgid "inline latex %r: %s" -msgstr "latex brendazi %r: %s" +msgid "%d source files given on command line" +msgstr "kartela burim %d dhënë te rresht urdhrash" -#: ext/coverage.py:48 +#: builders/__init__.py:382 #, python-format -msgid "invalid regex %r in %s" -msgstr "shprehje e rregullt e pavlefshme %r te %s" +msgid "targets for %d source files that are out of date" +msgstr "objektiva për kartela burim %d që janë të papërditësuara" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" -msgstr "moduli %s s’u importua dot: %s" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "po shihet për kartela të sapovjetruara… " -#: ext/coverage.py:148 +#: builders/__init__.py:415 #, python-format -msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" -msgstr "modulet vijues janë të dokumentuar, por s’qenë specifikuar në coverage_modules: %s" +msgid "%d found" +msgstr "U gjet %d" -#: ext/coverage.py:158 -msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" -msgstr "modulet vijues janë specifikuar te coverage_modules, por s’qenë dokumentuar" +#: builders/__init__.py:417 +msgid "none found" +msgstr "s’u gjet gjë" -#: ext/coverage.py:172 -#, python-brace-format, python-format -msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." -msgstr "Testimi i mbulimit te burimet përfundoi, shihni te përfundimet në %(outdir)s{sep}python.txt." +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" -#: ext/coverage.py:187 -#, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "shprehje e rregullt %r e pavlefshme te coverage_c_regexes" +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "po kontrollohet njëtrajtshmëria" -#: ext/coverage.py:260 -#, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "API C e padokumentuar: %s [%s] te kartela %s" +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "s’ka objektiva të vjetruar." -#: ext/coverage.py:452 -#, python-format -msgid "undocumented python function: %s :: %s" -msgstr "funksion python i padokumentuar: %s :: %s" +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "po përditësohet mjedisi: " -#: ext/coverage.py:473 +#: builders/__init__.py:499 #, python-format -msgid "undocumented python class: %s :: %s" -msgstr "klasë python e padokumentuar: %s :: %s" +msgid "%s added, %s changed, %s removed" +msgstr "%s të shtuar, %s të ndryshuar, %s të hequr" -#: ext/coverage.py:492 +#: builders/__init__.py:536 #, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "metodë python e padokumentuar: %s :: %s :: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "Sphinx-i s’është në gjendje të ngarkojë dokumentin kryesor (%s), ngaqë ka përkim me një rregullsi të brendshme përjashtimi %r. Ju lutemi, shpjereni dokumentin tuaj kryesor te një vendndodhje tjetër." -#: ext/imgconverter.py:44 +#: builders/__init__.py:545 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "S’arrihet të xhirohet urdhri %r. për shndërrim figure. Si parazgjedhje, 'sphinx.ext.imgconverter' lyp ImageMagick. Sigurohuni se është i instaluar, ose për mundësinë 'image_converter' caktoni një urdhër vetjak shndërrimi .\n\nTraceback: %s" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "Sphinx-i s’është në gjendje të ngarkojë dokumentin kryesor (%s), ngaqë ka përkim me një rregullsi përjashtimi të treguar në conf.py, %r. Ju lutemi, hiqeni rregullsinë nga conf.py." -#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#: builders/__init__.py:556 #, python-format msgid "" -"convert exited with error:\n" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "Sphinx-i s’është në gjendje të ngarkojë dokumentin kryesor (%s), ngaqë s’përfshihet në include_patterns = %r e përshtatur. Siguroni që një rregullsi te include_patterns të ketë përkim me dokumentin kryesor." + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "Sphinx-i s’është në gjendje të ngarkojë dokumentin kryesor (%s). Dokumenti kryesor duhet të gjendet brenda drejtorisë burim, ose një nëndrejtorie të saj." + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "po lexohen burime… " + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "emra dokumentesh për shkrim: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "po përgatiten dokumente" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "po kopjohen elementë" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "Kartela përmbledhje gjendet te %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "s’ka ndryshime në version %s." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "po shkruhet kartelë përmbledhje…" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Të brendshme" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Shkallë moduli" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "po kopjohen kartela burim…" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "s’u lexua dot %r për krijim regjistrimi ndryshimesh" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "shprehje e rregullt e pavlefshme %r te %s" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "moduli %s s’u importua dot: %s" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "modulet vijues janë të dokumentuar, por s’qenë specifikuar në coverage_modules: %s" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "modulet vijuese qenë specifikuar te coverage_modules, por s’qenë dokumentuar: %s" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "Testimi i mbulimit te burimet përfundoi, shihni te përfundimet në %(outdir)s{sep}python.txt." + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "shprehje e rregullt %r e pavlefshme te coverage_c_regexes" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "API C e padokumentuar: %s [%s] te kartela %s" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "funksion python i padokumentuar: %s :: %s" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "klasë python e padokumentuar: %s :: %s" + +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "metodë python e padokumentuar: %s :: %s :: %s" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Për T’u Bërë" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "U gjet zë Për T’u Bërë: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<> gjendet te %s, rreshti %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "zëri origjinal" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "S’arrihet të xhirohet urdhri %r. për shndërrim figure. Si parazgjedhje, 'sphinx.ext.imgconverter' lyp ImageMagick. Sigurohuni se është i instaluar, ose për mundësinë 'image_converter' caktoni një urdhër vetjak shndërrimi .\n\nTraceback: %s" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" @@ -863,879 +1329,960 @@ msgstr "[grafik: %s]" msgid "[graph]" msgstr "[grafik]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Për T’u Bërë" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "Urdhri LaTeX %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_late" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" -msgstr "U gjet zë Për T’u Bërë: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "Urdhri %s %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_%s" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "shfaq latex %r: %s" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<> gjendet te %s, rreshti %d.)" +msgid "inline latex %r: %s" +msgstr "latex brendazi %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "zëri origjinal" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "Lidhje për te ky ekuacion" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "mungon '+' ose '-' te mundësia '%s'." -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" -msgstr "Titull i pavlefshëm: %s" +msgid "'%s' is not a valid option." +msgstr "'%s' s’është mundësi e vlefshme." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "numri i specifikuar për rreshtin është jashtë intervali (1-%d): %r" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' s’është mundësi pyversion e vlefshme" -#: directives/code.py:216 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "lloj TestCode i pavlefshëm" + +#: ext/doctest.py:297 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "S’mund të përdoren në të njëjtën kohë të dyja mundësitë \"%s\" \"%s\"" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Testimi i doctests-eve te burimet përfundoi, shihni te përfundimet në %(outdir)s/output.txt." -#: directives/code.py:231 +#: ext/doctest.py:451 #, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "S’u gjet kartelë include '%s', ose dështoi leximi" +msgid "no code/output in %s block at %s:%s" +msgstr "s’ka kod/dhënie te blloku %s në %s:%s" -#: directives/code.py:235 +#: ext/doctest.py:568 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "Kodimi %r i përdorur për leximin e kartelës included '%s' duket të jetë gabim, provoni dhënien e një mundësie :encoding:" +msgid "ignoring invalid doctest code: %r" +msgstr "po shpërfillet kod “doctest” i pavlefshëm: %r" -#: directives/code.py:276 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "Objekti i emërtuar %r s’u gjet te kartelë include %r" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "pjesa “%s” etiketohet si “%s”" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "etiketë %s e përsëdytur, tjetër instancë te %s" -#: directives/code.py:314 +#: ext/duration.py:47 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Specifikim kartele %r: s’u morën rreshta prej kartelës include %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "Kohëzgjatja e leximit %.3fs tejkaloi kufi kohëzgjatjesh %.3fs" -#: directives/patches.py:71 +#: ext/duration.py:117 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "Mundësia \":file:\" për direktivë csv-table tani njeh një shteg absolut si shteg relativ prej drejtorisë burim. Ju lutemi, përditësoni dokumentin tuaj." +"====================== total reading duration ==========================" +msgstr "==================== kohëzgjatje leximi gjithsej =======================" -#: directives/other.py:119 +#: ext/duration.py:124 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "për rregullsinë globale toctree %r s’u gjet përkim në ndonjë dokument" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "Kohë leximi gjithsej %d file%s: %dm %.3fs" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "toctree përmban referencë ndaj dokumenti %r të përjashtuar" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "=================== kohëzgjatjet më të ngadalta të leximit ===================" -#: directives/other.py:156 +#: ext/duration.py:139 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "toctree përmban referencë ndaj dokumenti %r që s’ekziston" +msgid "%.3fs %s" +msgstr "%.3fs %s" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "zë i përsëdytur, gjetur te toctree: %s" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[burim]" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Autor ndarjeje: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "po theksohet kod moduli… " -#: directives/other.py:205 -msgid "Module author: " -msgstr "Autor moduli: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[dokumente]" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Autor kodi: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Kod moduli" -#: directives/other.py:209 -msgid "Author: " -msgstr "Autor: " +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Kod burim për %s

        " -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Përmbledhje: kod moduli" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "… lënda e hlist-ës s’është listë" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Krejt modulet për të cilët ka kod të gatshëm

        " -#: builders/changes.py:29 +#: domains/citation.py:75 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "Kartela përmbledhje gjendet te %(outdir)s." +msgid "duplicate citation %s, other instance in %s" +msgstr "citim i përsëdytur %s, tjetër instancë te %s" -#: builders/changes.py:56 +#: domains/citation.py:92 #, python-format -msgid "no changes in version %s." -msgstr "s’ka ndryshime në version %s." - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "po shkruhet kartelë përmbledhje…" - -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Të brendshme" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "Shkallë moduli" - -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "po kopjohen kartela burim…" +msgid "Citation [%s] is not referenced." +msgstr "Përmendja [%s] s’është në referencë." -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" -msgstr "s’u lexua dot %r për krijim regjistrimi ndryshimesh" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "etiketë e përsëdytur ekuacioni %s, instancë tjetër te %s" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Faqet e doracakut gjenden në %(outdir)s." +msgid "Invalid math_eqref_format: %r" +msgstr "math_eqref_format i pavlefshëm: %r" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "s’u gjet vlerë formësimi \"man_pages\"; s’do të shkruhet ndonjë faqe doracaku" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (funksion i brendshëm)" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "po shkruhet" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (metodë %s)" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "vlera e formësimit \"man_pages\" i referohet një dokumenti të panjohur %s" +msgid "%s() (class)" +msgstr "%s() (klasë)" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "s’u gjet figurë e përshtatshme për montuesin %s: %s (%s)" +msgid "%s (global variable or constant)" +msgstr "%s ( ndryshore globale ose konstante)" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "s’u gjet figurë e përshtatshme për montuesin %s: %s" +msgid "%s (%s attribute)" +msgstr "%s (atribut %s)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "po montohet [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argumente" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "po shkruhet përfundim… " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Lança" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" -msgstr "krejt kartelat po %d" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Kthime" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" -msgstr "objektiva për kartela po %d që janë specifikuar" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Lloj kthimi" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "objektiva për kartela po %d që janë të papërditësuara" +msgid "%s (module)" +msgstr "%s (modul)" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "krejt kartelat burim" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funksion" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " -msgstr "kartela %r, dhënë te rreshti i urdhrave, nuk ekziston, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metodë" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "kartela %r e dhënë te rresht urdhrash s’gjendet te drejtori burim, po shpërfillet" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klasë" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "kartela %r, dhënë te rreshti i urdhrave, s’është dokument i vlefshëm, po shpërfillet" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "të dhëna" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "kartela burim %d dhënë te rresht urdhrash" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "atribut" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "objektiva për kartela burim %d që janë të papërditësuara" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " -msgstr "po montohet [%s]: " - -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "po shihet për kartela të sapovjetruara… " +msgid "duplicate %s description of %s, other %s in %s" +msgstr "përshkrim %s i përsëdytur i %s, tjetër %s në %s" -#: builders/__init__.py:410 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "%d found" -msgstr "U gjet %d" +msgid "%s (directive)" +msgstr "%s (direktivë)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "s’u gjet gjë" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr ":%s: (mundësi direktive)" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (rol)" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "po kontrollohet njëtrajtshmëria" +#: domains/rst.py:234 +msgid "directive" +msgstr "direktivë" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "s’ka objektiva të vjetruar." +#: domains/rst.py:235 +msgid "directive-option" +msgstr "diretiva-opção" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "po përditësohet mjedisi: " +#: domains/rst.py:236 +msgid "role" +msgstr "rol" -#: builders/__init__.py:494 +#: domains/rst.py:262 #, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s të shtuar, %s të ndryshuar, %s të hequr" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "përshkrim i përsëdytur %s %s, instancë tjetër te %s" -#: builders/__init__.py:531 +#: domains/changeset.py:32 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "Sphinx-i s’është në gjendje të ngarkojë dokumentin kryesor (%s), ngaqë ka përkim me një rregullsi të brendshme përjashtimi %r. Ju lutemi, shpjereni dokumentin tuaj kryesor te një vendndodhje tjetër." +msgid "Added in version %s" +msgstr "Shtuar në versionin %s" -#: builders/__init__.py:540 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "Sphinx-i s’është në gjendje të ngarkojë dokumentin kryesor (%s), ngaqë ka përkim me një rregullsi përjashtimi të treguar në conf.py, %r. Ju lutemi, hiqeni rregullsinë nga conf.py." +msgid "Changed in version %s" +msgstr "Ndryshuar në versionin %s" -#: builders/__init__.py:551 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "Sphinx-i s’është në gjendje të ngarkojë dokumentin kryesor (%s), ngaqë s’përfshihet në include_patterns = %r e përshtatur. Siguroni që një rregullsi te include_patterns të ketë përkim me dokumentin kryesor." +msgid "Deprecated since version %s" +msgstr "Nxjerrë nga përdorimi që me versionin %s" -#: builders/__init__.py:558 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "Sphinx-i s’është në gjendje të ngarkojë dokumentin kryesor (%s). Dokumenti kryesor duhet të gjendet brenda drejtorisë burim, ose një nëndrejtorie të saj." - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "po lexohen burime… " +msgid "Removed in version %s" +msgstr "Hequr në versionin %s" -#: builders/__init__.py:713 +#: domains/__init__.py:322 #, python-format -msgid "docnames to write: %s" -msgstr "emra dokumentesh për shkrim: %s" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "numri i aktit duhet të jetë një numër pozitiv" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "po përgatiten dokumente" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "Për më tepër hollësi, vizitoni ." -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "po kopjohen elementë" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nProdhoni dokumentim nga kartela burim.\n\nsphinx-build prodhon dokumentim prej kartelash te SOURCEDIR dhe e vendos\nte OUTPUTDIR. Kërkon për 'conf.py' te SOURCEDIR për rregullime formësimi.\nMjeti 'sphinx-quickstart' mund të përdoret për të prodhuar kartela gjedhe,\npërfshi 'conf.py'\n\nsphinx-build mund të krijojë dokumentim në formate të ndryshëm. Një format\npërzgjidhet duke specifikuar te rreshti i urdhrave emrin e montuesit; HTML-ja,\nsi parazgjedhje. Montuesit mund të kryejnë gjithashtu veprime të tjera të lidhura\nme përpunim dokumentimi.\n\nSi parazgjedhje, gjithçka që është e papërditësuar, montohet. Nëse doni\nmontim vetëm për kartela të përzgjedhura, kjo mund të bëhet duke\nspecifikuar emra kartelash individuale.\n" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "shenja burimi të padeshifrueshme, po zëvendësohen me \"?\": %r" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "shteg për te kartela burimi dokumentimi" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "Kartela ePub gjendet te %(outdir)s." +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "shteg për te drejtori përfundimesh" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "po shkruhet kartelë nav.xhtml…" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "(opsionale) një listë kartelash të caktuara për t’u rimontuar. E shpërfillur, nëse është dhënë --write-all" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "vlera e formësimit \"epub_language\" (ose \"language\") s’duhet të jetë e zbrazët për EPUB3" +#: cmd/build.py:114 +msgid "general options" +msgstr "mundësi të përgjithshme" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "vlera e formësimit \"epub_uid\" duhet të jetë XML NAME për EPUB3" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "montues për t’u përdorur (parazgjedhje: 'html')" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "vlera e formësimit \"epub_title\" (ose \"html_title\") s’duhet të jetë e zbrazët për EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "executa em paralelo com N processos, quando possível. 'auto' usa o número de núcleos da CPU" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "vlera e formësimit \"epub_author\" s’duhet të jetë e zbrazët për EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "shkruaj krejt kartelat (parazgjedhje: shkruaj vetëm kartela të reja dhe ato të ndryshuara)" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "vlera e formësimit \"epub_contributor\" s’duhet të jetë e zbrazët për EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "mos përdor një mjedis të ruajtur, lexo përherë krejt kartelat" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "vlera e formësimit \"epub_description\" s’duhet të jetë e zbrazët për EPUB3" +#: cmd/build.py:150 +msgid "path options" +msgstr "mundësi shtegu" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "vlera e formësimit \"epub_publisher\" s’duhet të jetë e zbrazët për EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "drejtori për kartela doctree dhe mjedisi (parazgjedhje: OUTPUT_DIR/.doctrees)" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "vlera e formësimit \"epub_copyright\" (ose \"copyright\") s’duhet të jetë e zbrazët për EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "drejtori për kartelën e formësimit (conf.py) (parazgjedhje: SOURCE_DIR)" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "vlera e formësimit \"epub_identifier\" s’duhet të jetë e zbrazët për EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "mos përdor kartelë formësimi, përdor vetëm rregullime nga mundësitë -D" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "vlera e formësimit \"version\" s’duhet të jetë e zbrazët për EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "anashkalo një rregullim te kartelë formësimi" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "css_file e pavlefshme: %r, u shpërfill" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "jep një vlerë te gjedhe HTML" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "Kartelat XML gjenden në %(outdir)s." +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "përcaktoni etiketë: përfshi blloqe “only” me TAG" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "gabim në shkrim kartele %s: %s" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "modo nitpicky: avisa sobre todas as referências ausentes" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Kartelat pseudo-XML gjenden në %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" +msgstr "mundësi për ç’prodhon konsola" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Kartelat Texinfo gjenden në %(outdir)s." +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "aumenta a verbosidade (pode ser repetido)" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nXhironi 'make' te ajo drejtori, që të xhirohen këto përmes makeinfo-s\n(përdorni këtu 'make info' që kjo të kryhet automatikisht)." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "pa output në stdout, thjesht sinjalizime në stderr" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "s’u gjet vlerë formësimi \"texinfo_documents\"; s’do të shkruhet ndonjë dokument" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "pa output fare, madje as sinjalizime" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "vlera e formësimit \"texinfo_documents\" i referohet një dokumenti të panjohur %s" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "emite saída colorida (padrão: detecção automática)" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "po përpunohet %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "não emite saída colorida (padrão: detecção automática)" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "po shquhen referencat…" +#: cmd/build.py:252 +msgid "warning control options" +msgstr "mundësi kontrolli sinjalizimesh" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (në " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "shkruaj sinjalizime (dhe gabime) te kartela e dhënë" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "po kopjohen figura… " +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "shndërroji sinjalizimet në gabime" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "s’kopjohet dot kartelë figure %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "mostra traceback completo na exceção" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "po kopjohen kartela mbulimi Texinfo" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "xhiro Pdb, në rast përjashtimesh" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "gabim në shkrim kartele Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "levanta uma exceção para avisos" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "u gjet zë TeL i përsëdytur: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "s’mund të ndërthuret një mundësi -a dhe emra kartelash" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "s’lexohet dot kartelë figure %r: në vend të tij, po kopjohet" +msgid "cannot open warning file '%s': %s" +msgstr "s’hapet dot kartelë sinjalizim “%s”: %s" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "s’shkruhet dot kartelë figure %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "argumenti i mundësisë -D duhet të jetë në formën emër=vlerë" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "S’u gjet Pillow - po kopjohen kartela figurë" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "argumenti i mundësisë -A duhet të jetë në formën emër=vlerë" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "po shkruhet kartelë llojesh MIME…" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "fut automatikisht docstrings prej modulesh" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "po shkruhet kartelë META-INF/container.xml…" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "testo automatikisht copëza kodi te blloqe doctest" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "po shkruhet kartelë content.opf…" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "lidhje mes dokumentimi Sphinx projektesh të ndryshëm" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "lloj MIME i panjohur për %s, po shpërfillet" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "shkruaj zëra \"todo\" që mund të shfaqen ose fshihen te montimi" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "nyja ka nivel të pavlefshëm" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "kontrolle për mbulim dokumentimi" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "po shkruhet kartelë toc.ncx…" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "përfshi formula matematikore, të vizatuara si figura PNG ose SVG" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "po shkruhet kartelë %s…" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "përfshi formula matematikore, të vizatuara te shfletuesi nga MathJax" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "Montuesi provë nuk prodhon kartela." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "përfshirje e kushtëzuar lënde, bazuar në vlera formësimi" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "Katalogët e mesazheve gjenden te %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "përfshi lidhje te kodi burim i objekteve Python të dokumentuara" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "objektiva për kartela gjedhe %d" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "krijo kartelë .nojekyll për të botuar dokumentin në faqe GitHub" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "po lexohen gjedhe… " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Ju lutemi, jepni një emër shtegu të vlefshëm." -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "po shkruhen katalogë mesazhesh… " +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Ju lutemi, jepni ca tekst." -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "Faqja HTML gjenden në %(outdir)s." +msgid "Please enter one of %s." +msgstr "Ju lutemi, jepni një nga %s." -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "po montohet dokument njësh" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Ju lutemi, jepni 'y' ose 'n'." -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "po shkruhen kartela shtesë" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Ju lutemi, jepni një prapashtesë kartele, për shembull, '.rst' ose '.txt'." -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Shihni për çfarëdo gabimesh te përfundimi më sipër ose te %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Mirë se vini te mjeti për fillim të shpejtë me Sphinx %s." + +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Ju lutemi, jepni vlera për rregullimet vijuese (thjesht shtypni tastin\nEnter që të pranohet një vlerë parazgjedhje, nëse është një e tillë\nbrenda kllapave)." -#: builders/linkcheck.py:149 +#: cmd/quickstart.py:242 #, python-format -msgid "broken link: %s (%s)" -msgstr "lidhje e dëmtuar: %s (%s)" - -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "S’u gjet spirancë '%s'" +msgid "Selected root path: %s" +msgstr "Shteg rrënjë i përzgjedhur: %s" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "S’u arrit të përpilohet shprehje e rregullt te linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Jepni shtegun rrënjë për te dokumenti." -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Kartelat tekst gjenden në %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Shteg rrënje për te dokumenti" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "referenca pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Gabim: te shtegu rrënjë i përzgjedhur u gjet një conf.py ekzistues." -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "referenca pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart s’do të mbishkruajë projekte ekzistuese Sphinx." -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "referenca citimi pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Ju lutemi, jepni një shteg të ri rrënjë (ose thjesht shtypni tastin Enter, që të dilet)" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "referenca citimi pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d %b, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "s’u njehsua dot ecuri përkthimi!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Keni dy mundësi për vendosjen e drejtorisë së montimeve për çka prodhon Sphinx-i.\nPërdorni një drejtori \"_build\" brenda shtegut rrënjë, ose i ndani\ndrejtoritë \"burim\" dhe \"montim\" brenda shtegut rrënjë." -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "pa elementë të përkthyer!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Nda veçmas drejtoritë burim dhe montim (y/n)" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "U gjet tregues me bazë 4 shtylla. Mund të jetë një e metë e zgjerimeve që përdorni: %r" - -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "Poshtëshënimi [%s] s’është në referencë." - -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "Poshtëshënimi [*] është pa referencë." +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "Brenda drejtorisë rrënjë do të krijohen dy drejtori të tjera; \"_templates\" për\ngjedhe vetjake HTML, dhe \"_static\" për fletëstile vetjakë dhe kartela të tjera statike.\nMund të krijoni një tjetër parashtesë (bie fjala, \".\") në vend të nënvijës." -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "Poshtëshënimi [#] s’është në referencë." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Parashtesë emrash për drejtori gjedhesh dhe statikesh" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "Përdorimi:" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "Emri i projektit do të shfaqet në disa vende te dokumentimi i montuar." -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "{0} [MUNDËSI] []" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Emër projekti" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "Prodhuesi i dokumentimit Sphinx" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Emër(a) autori(ësh)" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "Urdhra:" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx-i përdor nocionet e “versionit” dhe “hedhjes në qarkullim” për\nsoftware-in. Çdo version mund të ketë hedhje të shumta në qarkullim.\nBie fjala, për Python-in versionet ngjajnë me 2.5 ose 3.0, teksa hedhja\nnë qarkullim ngjan me 2.5.1 ose 3.0a1. Nëse kjo strukturë duale s’ju\nhyn në punë, thjesht vëruni të dyjave të njëjtën vlerë." -#: _cli/__init__.py:98 -msgid "Options" -msgstr "Mundësi" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Version projekti" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "Për më tepër informacion, vizitoni https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Hedhje në qarkullim e projektit" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "{0}: gabim: {1}\nPër informacion, xhironi '{0} --help'" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "Administroni dokumentimin me Sphinx." +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "Nëse dokumentet janë shkruan në gjuhë tjetër nga anglishtja,\nmund të përzgjidhni një gjuhë këtu, përmes kodit të asaj gjuhe. Sphinx-i mandej\ndo të përkthejë në atë gjuhë tekstin që prodhon.\n\nPër një listë kodesh të mbuluar, shihni\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "Shfaq versionin dhe dil." +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Gjuhë projekti" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "Shfaq këtë mesazh dhe dil." +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "Prapashtesa e emrave të kartelave për kartela burim. Zakonisht, kjo\nështë ose \".txt\", ose \".rst\". Vetëm kartelat me këtë prapashtesë\nmerren si dokumente." -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "Regjistrim" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Prapashtesë kartele burim" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "Një dokument është i veçantë, për faktin se konsiderohet si nyja e epërme\ne \"pemës së lëndës\", domethënë, është rrënja e strukturës hierarkike\ntë dokumenteve. Zakonisht, ky është \"index\", por nëse dokumenti juaj \"index\"\nështë një gjedhe vetjake, si të tillë mund të caktoni një tjetër emër kartele." -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "Vetëm gabime dhe sinjalizime shtypjeje" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Emër i dokumentit tuaj kryesor (pa prapashtesë)" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "Pa dhënë gjë" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Gabim: kartela master %s është gjetur tashmë një herë në shtegun rrënjë të përzgjedhur." -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart s’do të mbishkruajë kartelën ekzistuese." -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "Shihni 'sphinx --help'.\n" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Ju lutemi, jepni një emër të ri kartele, ose riemërtojeni kartelën ekzistuese dhe shtypni tastin Enter" -#: environment/__init__.py:86 -msgid "new config" -msgstr "formësim i ri" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Përcaktoni se cilët nga zgjerimet vijuese Sphinx duhen aktivizuar:" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "formësimi ndryshoi" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Shënim: imgmath dhe mathjax s’mund të aktivizohen në të njëjtën kohë. U hoqë përzgjedhja e imgmath-it." -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "zgjerimet u ndryshuan" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Për ju mund të prodhohen një kartelë makefile dhe një urdhrash Windows, që\nkështu t’ju duhet vetëm të xhironi, për shembull, `make html', në vend se\ntë thirret drejtpërsëdrejti sphinx-build." -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "version jo i tanishëm i mjedisit të montimit" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Të krijohet Makefile? (y/n)" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "drejtoria burim ka ndryshuar" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Të krijohet kartelë urdhrash Windows? (y/n)" -#: environment/__init__.py:325 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "Formësimi është ndryshuar (1 mundësi: %r)" +msgid "Creating file %s." +msgstr "Po krijohet kartela %s." -#: environment/__init__.py:330 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "Formësimi është ndryshuar (%d mundësi: %s)" +msgid "File %s already exists, skipping." +msgstr "Ka tashmë një kartelë %s, po anashkalohet." -#: environment/__init__.py:336 +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Përfundoi: U krijua një strukturë fillestare drejtorish." + +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "Formësimi është ndryshuar (%d mundësi: %s, …)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Tani duhet të populloni kartelën tuaj master file %s dhe të krijoni kartela të tjera\nburim të dokumentimit. " -#: environment/__init__.py:379 +#: cmd/quickstart.py:527 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "Ky mjedis është i papërputhshëm me montuesin e përzgjedhur, ju lutemi, zgjidhni një tjetër drejtori doctree." +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Përdorni Makefile-in që të montohen dokumentet, kështu:\n make builder" -#: environment/__init__.py:493 +#: cmd/quickstart.py:531 #, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "S’u arrit të skanohen dokumente te %s: %r" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Përodrni urdhrin sphinx-build që të montohen dokumentet, kështu:\n sphinx-build -b montues %s %s" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "Përkatësia %r s’është e regjistruar" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "ku montues është një nga montuesin e mbuluar, p.sh., html, latex ose linkcheck." -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "dokumenti s’është i përfshirë në ndonjë toctree" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nProdho kartelat e domosdoshme për një projekt Sphinx.\n\nsphinx-quickstart është një mjet ndërveprues që bën disa pyetje rreth projektit\ntuaj dhe mandej prodhon një drejtori të plotë dokumentimi dhe një shembull\nMakefile për t’u përdorur me sphinx-build.\n" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "U gjet “toctree” që i referohet vetes. U shpërfill." +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "mënyra pa zhurmë" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "rrënjë e projektit" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "gabim leximi: %s, %s" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Mundësi strukture" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "gabim shkrimi: %s, %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "nëse është kërkuar, nda veçmas drejtoritë burim dhe montim" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "locale_dir %s s’ekziston" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "në u përcaktoftë, krijo drejtori montimi nën drejtorinë burim" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "Vendore Babel e pavlefshme: %r." +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "zëvendësim për pikën te _templates, etj." -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "Format i pavlefshëm datash. Quote the string by single quote Nëse doni të jepet drejtpërsëdrejti, përdorni për vargun thonjëza njëshe: %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Mundësi bazë të projektit" -#: util/docfields.py:103 +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "emër projekti" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "emra autorësh" + +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "version i projektit" + +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "hedhje në qarkullim e projektit" + +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "gjuhë dokumenti" + +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "prapashtesë kartele burim" + +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "emër dokumenti bazë" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "përdor epub" + +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Mundësi zgjerimi" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "aktivizo zgjerimin %s" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "aktivizo zgjerime arbitrare" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Krijim makefile-i dhe batchfile-i" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "krijo makefile" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "mos krijo makefile" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "krijo batchfile" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "mos krijo batchfile" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "përdor make-mode për Makefile/make.bat" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Gjedhe projekti" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "drejtori gjedhesh për kartela gjedhe" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "përkufizoni një ndryshore gjedheje" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "\"quiet\" është specifikuar, por s’është specifikuar ndonjë \"projekt\" ose \"autor\"." + +#: cmd/quickstart.py:786 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "Problem në përkatësinë %s: fusha supozohet të përdorë rol '%s', por ai rol s’gjendet te përkatësia." +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Gabim:shtegu i dhënë s’është drejtori, ose kartelat sphinx ekzistojnë tashmë." -#: util/nodes.py:423 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "%r është nxjerrë nga funksionimi për zëra treguesi (nga zëri %r). Në vend të tij përdorni “pair: %s”." +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart prodhon vetëm te një drejtori e zbrazët. Ju lutemi, specifikoni një shteg rrënjë të ri." -#: util/nodes.py:490 +#: cmd/quickstart.py:810 #, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "“toctree” përmban referencë për te një kartelë joekzistuese %r" +msgid "Invalid template variable: %s" +msgstr "Ndryshore e pavlefshme gjedheje: %s" -#: util/nodes.py:706 +#: directives/other.py:119 #, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "përjashtim teksa vlerësohej vetëm shprehje direktive: %s" - -#: util/display.py:82 -msgid "skipped" -msgstr "e anashkaluar" - -#: util/display.py:87 -msgid "failed" -msgstr "e dështuar" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "për rregullsinë globale toctree %r s’u gjet përkim në ndonjë dokument" -#: util/osutil.py:131 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "U ndërpre kopjim i provuar prej %s në %s (shtegu vendmbërritje përmban të dhëna ekzistuese)." +msgid "toctree contains reference to excluded document %r" +msgstr "toctree përmban referencë ndaj dokumenti %r të përjashtuar" -#: util/docutils.py:309 +#: directives/other.py:156 #, python-format -msgid "unknown directive name: %s" -msgstr "emër i panjohur direktive: %s" +msgid "toctree contains reference to nonexisting document %r" +msgstr "toctree përmban referencë ndaj dokumenti %r që s’ekziston" -#: util/docutils.py:345 +#: directives/other.py:169 #, python-format -msgid "unknown role name: %s" -msgstr "emër i panjohur roli: %s" +msgid "duplicated entry found in toctree: %s" +msgstr "zë i përsëdytur, gjetur te toctree: %s" + +#: directives/other.py:203 +msgid "Section author: " +msgstr "Autor ndarjeje: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Autor moduli: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Autor kodi: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Autor: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" -#: util/docutils.py:789 +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "… lënda e hlist-ës s’është listë" + +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "Mundësia \":file:\" për direktivë csv-table tani njeh një shteg absolut si shteg relativ prej drejtorisë burim. Ju lutemi, përditësoni dokumentin tuaj." + +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "não-espaço em branco removido por dedent" + +#: directives/code.py:87 #, python-format -msgid "unknown node type: %r" -msgstr "lloj i panjohur nyjeje: %r" +msgid "Invalid caption: %s" +msgstr "Titull i pavlefshëm: %s" -#: util/fileutil.py:76 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "U ndërpre kopjim i provuar prej gjedheje të rikrijuar %s në %s (shtegu vendmbërritje përmban të dhëna ekzistuese)." +msgid "line number spec is out of range(1-%d): %r" +msgstr "numri i specifikuar për rreshtin është jashtë intervali (1-%d): %r" -#: util/fileutil.py:89 +#: directives/code.py:216 #, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "S’mund të përdoren në të njëjtën kohë të dyja mundësitë \"%s\" \"%s\"" -#: util/rst.py:73 +#: directives/code.py:231 #, python-format -msgid "default role %s not found" -msgstr "s’u gjet rol parazgjedhje %s" +msgid "Include file '%s' not found or reading it failed" +msgstr "S’u gjet kartelë include '%s', ose dështoi leximi" -#: util/inventory.py:147 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "depoja <%s> përmban përkufizime të përsëdytura të %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "Kodimi %r i përdorur për leximin e kartelës included '%s' duket të jetë gabim, provoni dhënien e një mundësie :encoding:" -#: util/inventory.py:166 +#: directives/code.py:276 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "inventar <%s> përmban përkufizime të shumta për %s" +msgid "Object named %r not found in include file %r" +msgstr "Objekti i emërtuar %r s’u gjet te kartelë include %r" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Poshtëshënime" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "Não é possível usar \"lineno-match\" com um conjunto disjunto de \"lines\"" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" -msgstr "[figurë: %s]" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Specifikim kartele %r: s’u morën rreshta prej kartelës include %r" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[figurë]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d %b, %Y" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1744,11 +2291,15 @@ msgstr "[figurë]" msgid "Index" msgstr "Tregues" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "u has nyje titulli jo në ndarje, temë, tabelë, paralajmërim ose anështyllë" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Poshtëshënime" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "titull jo brenda një figure." @@ -1758,67 +2309,28 @@ msgstr "titull jo brenda një figure." msgid "unimplemented node type: %r" msgstr "lloj nyjeje i pasendërtuar: %r" -#: writers/latex.py:361 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "toplevel_sectioning %r i panjohur për klasën %r" +msgid "[image: %s]" +msgstr "[figurë: %s]" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "s’ka mundësi Babel të njohur për gjuhën %r" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[figurë]" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr ":maxdepth: shumë i madh, u shpërfill." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "Lidhje për te ky përkufizim" -#: writers/latex.py:591 +#: writers/html5.py:431 #, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "s’u gjet gjedhe %s; në vend të kësaj, po bëhet ngarkim prej të dikurshmes %s" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "titulli i dokumentit s’është nyje njëshe Teksti" +msgid "numfig_format is not defined for %s" +msgstr "numfig_format s’është i përcaktuar për %s" -#: writers/html5.py:572 writers/latex.py:1106 +#: writers/html5.py:441 #, python-format -msgid "unsupported rubric heading level: %s" -msgstr "shkallë e pambuluar për krye rubrike: %s" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "janë dhënë që të dyja mundësitë, “tabularcolumns” dhe “:widths:”. shpërfillet :widths:." - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "njësia e përmasave %s është e pavlefshme. U shpërfill." - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "u gjet lloj i panjohur %s zërash treguesi" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "math_eqref_format i pavlefshëm: %r" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "Lidhje për te ky përkufizim" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "numfig_format s’është i përcaktuar për %s" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "Çfarëdo ID-sh jo të përshoqëruara për nyjën %s" +msgid "Any IDs not assigned for %s node" +msgstr "Çfarëdo ID-sh jo të përshoqëruara për nyjën %s" #: writers/html5.py:496 msgid "Link to this term" @@ -1832,6 +2344,11 @@ msgstr "Lidhje për te kjo krye" msgid "Link to this table" msgstr "Lidhje për te kjo tabelë" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "shkallë e pambuluar për krye rubrike: %s" + #: writers/html5.py:636 msgid "Link to this code" msgstr "Lidhje për te ky kod" @@ -1848,794 +2365,478 @@ msgstr "Lidhje për te kjo “toctree”" msgid "Could not obtain image size. :scale: option is ignored." msgstr "S’u mor dot madhësi figure. Mundësia :scale: u shpërfill." -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "toplevel_sectioning %r i panjohur për klasën %r" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "etiketë e përsëdytur ekuacioni %s, instancë tjetër te %s" +msgid "no Babel option known for language %r" +msgstr "s’ka mundësi Babel të njohur për gjuhën %r" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (funksion i brendshëm)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":maxdepth: shumë i madh, u shpërfill." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (metodë %s)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "s’u gjet gjedhe %s; në vend të kësaj, po bëhet ngarkim prej të dikurshmes %s" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "titulli i dokumentit s’është nyje njëshe Teksti" + +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "janë dhënë që të dyja mundësitë, “tabularcolumns” dhe “:widths:”. shpërfillet :widths:." -#: domains/javascript.py:185 +#: writers/latex.py:1228 #, python-format -msgid "%s() (class)" -msgstr "%s() (klasë)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "Foi fornecido colspec %s, que parece usar sintaxe tabular. Mas esta tabela não pode ser renderizada como uma tabela; o colspec fornecido será ignorado." -#: domains/javascript.py:187 +#: writers/latex.py:1615 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s ( ndryshore globale ose konstante)" +msgid "dimension unit %s is invalid. Ignored." +msgstr "njësia e përmasave %s është e pavlefshme. U shpërfill." -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1950 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (atribut %s)" +msgid "unknown index entry type %s found" +msgstr "u gjet lloj i panjohur %s zërash treguesi" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argumente" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "Përdorimi:" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "{0} [MUNDËSI] []" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Kthime" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "Prodhuesi i dokumentimit Sphinx" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Lloj kthimi" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "Urdhra:" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "Mundësi" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funksion" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "Për më tepër informacion, vizitoni https://www.sphinx-doc.org/en/master/man/." -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metodë" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "{0}: gabim: {1}\nPër informacion, xhironi '{0} --help'" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klasë" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "Administroni dokumentimin me Sphinx." -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "të dhëna" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "Shfaq versionin dhe dil." -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "atribut" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "Shfaq këtë mesazh dhe dil." -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modul" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "Regjistrim" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "përshkrim %s i përsëdytur i %s, tjetër %s në %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "Aumentar a verbosidade (pode ser repetido)" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "Shtuar në versionin %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "Vetëm gabime dhe sinjalizime shtypjeje" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Ndryshuar në versionin %s" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "Pa dhënë gjë" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Nxjerrë nga përdorimi që me versionin %s" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "Hequr në versionin %s" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "Shihni 'sphinx --help'.\n" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktivë)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "referenca pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (mundësi direktive)" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "referenca pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (rol)" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "referenca citimi pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}" -#: domains/rst.py:234 -msgid "directive" -msgstr "direktivë" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "referenca citimi pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}" -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "s’u njehsua dot ecuri përkthimi!" -#: domains/rst.py:236 -msgid "role" -msgstr "rol" +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "pa elementë të përkthyer!" -#: domains/rst.py:262 +#: transforms/__init__.py:258 #, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "përshkrim i përsëdytur %s %s, instancë tjetër te %s" +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "U gjet tregues me bazë 4 shtylla. Mund të jetë një e metë e zgjerimeve që përdorni: %r" -#: domains/citation.py:75 +#: transforms/__init__.py:299 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "citim i përsëdytur %s, tjetër instancë te %s" +msgid "Footnote [%s] is not referenced." +msgstr "Poshtëshënimi [%s] s’është në referencë." -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." -msgstr "Përmendja [%s] s’është në referencë." +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "Poshtëshënimi [*] është pa referencë." -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Vëmendje" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "Poshtëshënimi [#] s’është në referencë." -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Kujdes" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "depoja <%s> përmban përkufizime të përsëdytura të %s" -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Rrezik" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "inventar <%s> përmban përkufizime të shumta për %s" -#: locale/__init__.py:231 -msgid "Error" -msgstr "Gabim" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "gabim leximi: %s, %s" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Ndihmëz" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "gabim shkrimi: %s, %s" -#: locale/__init__.py:233 -msgid "Important" -msgstr "E rëndësishme" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Shënim" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Shihni edhe" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Ndihmëz" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Sinjalizim" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "fut automatikisht docstrings prej modulesh" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "testo automatikisht copëza kodi te blloqe doctest" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "lidhje mes dokumentimi Sphinx projektesh të ndryshëm" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "shkruaj zëra \"todo\" që mund të shfaqen ose fshihen te montimi" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "kontrolle për mbulim dokumentimi" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "përfshi formula matematikore, të vizatuara si figura PNG ose SVG" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "përfshi formula matematikore, të vizatuara te shfletuesi nga MathJax" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "përfshirje e kushtëzuar lënde, bazuar në vlera formësimi" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "përfshi lidhje te kodi burim i objekteve Python të dokumentuara" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "krijo kartelë .nojekyll për të botuar dokumentin në faqe GitHub" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Ju lutemi, jepni një emër shtegu të vlefshëm." - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Ju lutemi, jepni ca tekst." - -#: cmd/quickstart.py:133 +#: util/i18n.py:146 #, python-format -msgid "Please enter one of %s." -msgstr "Ju lutemi, jepni një nga %s." - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Ju lutemi, jepni 'y' ose 'n'." - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Ju lutemi, jepni një prapashtesë kartele, për shembull, '.rst' ose '.txt'." +msgid "locale_dir %s does not exist" +msgstr "locale_dir %s s’ekziston" -#: cmd/quickstart.py:229 +#: util/i18n.py:244 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Mirë se vini te mjeti për fillim të shpejtë me Sphinx %s." - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Ju lutemi, jepni vlera për rregullimet vijuese (thjesht shtypni tastin\nEnter që të pranohet një vlerë parazgjedhje, nëse është një e tillë\nbrenda kllapave)." +msgid "Invalid Babel locale: %r." +msgstr "Vendore Babel e pavlefshme: %r." -#: cmd/quickstart.py:241 +#: util/i18n.py:253 #, python-format -msgid "Selected root path: %s" -msgstr "Shteg rrënjë i përzgjedhur: %s" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "Jepni shtegun rrënjë për te dokumenti." - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Shteg rrënje për te dokumenti" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Gabim: te shtegu rrënjë i përzgjedhur u gjet një conf.py ekzistues." - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart s’do të mbishkruajë projekte ekzistuese Sphinx." - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Ju lutemi, jepni një shteg të ri rrënjë (ose thjesht shtypni tastin Enter, që të dilet)" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Keni dy mundësi për vendosjen e drejtorisë së montimeve për çka prodhon Sphinx-i.\nPërdorni një drejtori \"_build\" brenda shtegut rrënjë, ose i ndani\ndrejtoritë \"burim\" dhe \"montim\" brenda shtegut rrënjë." - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Nda veçmas drejtoritë burim dhe montim (y/n)" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "Brenda drejtorisë rrënjë do të krijohen dy drejtori të tjera; \"_templates\" për\ngjedhe vetjake HTML, dhe \"_static\" për fletëstile vetjakë dhe kartela të tjera statike.\nMund të krijoni një tjetër parashtesë (bie fjala, \".\") në vend të nënvijës." - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Parashtesë emrash për drejtori gjedhesh dhe statikesh" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "Emri i projektit do të shfaqet në disa vende te dokumentimi i montuar." - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Emër projekti" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Emër(a) autori(ësh)" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "Sphinx-i përdor nocionet e “versionit” dhe “hedhjes në qarkullim” për\nsoftware-in. Çdo version mund të ketë hedhje të shumta në qarkullim.\nBie fjala, për Python-in versionet ngjajnë me 2.5 ose 3.0, teksa hedhja\nnë qarkullim ngjan me 2.5.1 ose 3.0a1. Nëse kjo strukturë duale s’ju\nhyn në punë, thjesht vëruni të dyjave të njëjtën vlerë." - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Version projekti" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Hedhje në qarkullim e projektit" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "Nëse dokumentet janë shkruan në gjuhë tjetër nga anglishtja,\nmund të përzgjidhni një gjuhë këtu, përmes kodit të asaj gjuhe. Sphinx-i mandej\ndo të përkthejë në atë gjuhë tekstin që prodhon.\n\nPër një listë kodesh të mbuluar, shihni\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Gjuhë projekti" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "Prapashtesa e emrave të kartelave për kartela burim. Zakonisht, kjo\nështë ose \".txt\", ose \".rst\". Vetëm kartelat me këtë prapashtesë\nmerren si dokumente." - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Prapashtesë kartele burim" - -#: cmd/quickstart.py:349 msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "Një dokument është i veçantë, për faktin se konsiderohet si nyja e epërme\ne \"pemës së lëndës\", domethënë, është rrënja e strukturës hierarkike\ntë dokumenteve. Zakonisht, ky është \"index\", por nëse dokumenti juaj \"index\"\nështë një gjedhe vetjake, si të tillë mund të caktoni një tjetër emër kartele." - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Emër i dokumentit tuaj kryesor (pa prapashtesë)" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Format i pavlefshëm datash. Quote the string by single quote Nëse doni të jepet drejtpërsëdrejti, përdorni për vargun thonjëza njëshe: %s" -#: cmd/quickstart.py:367 +#: util/osutil.py:131 #, python-format msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Gabim: kartela master %s është gjetur tashmë një herë në shtegun rrënjë të përzgjedhur." - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart s’do të mbishkruajë kartelën ekzistuese." - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Ju lutemi, jepni një emër të ri kartele, ose riemërtojeni kartelën ekzistuese dhe shtypni tastin Enter" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Përcaktoni se cilët nga zgjerimet vijuese Sphinx duhen aktivizuar:" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Shënim: imgmath dhe mathjax s’mund të aktivizohen në të njëjtën kohë. U hoqë përzgjedhja e imgmath-it." - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Për ju mund të prodhohen një kartelë makefile dhe një urdhrash Windows, që\nkështu t’ju duhet vetëm të xhironi, për shembull, `make html', në vend se\ntë thirret drejtpërsëdrejti sphinx-build." +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "U ndërpre kopjim i provuar prej %s në %s (shtegu vendmbërritje përmban të dhëna ekzistuese)." -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Të krijohet Makefile? (y/n)" +#: util/display.py:82 +msgid "skipped" +msgstr "e anashkaluar" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Të krijohet kartelë urdhrash Windows? (y/n)" +#: util/display.py:87 +msgid "failed" +msgstr "e dështuar" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: util/docutils.py:325 #, python-format -msgid "Creating file %s." -msgstr "Po krijohet kartela %s." +msgid "unknown directive name: %s" +msgstr "emër i panjohur direktive: %s" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: util/docutils.py:361 #, python-format -msgid "File %s already exists, skipping." -msgstr "Ka tashmë një kartelë %s, po anashkalohet." - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Përfundoi: U krijua një strukturë fillestare drejtorish." +msgid "unknown role name: %s" +msgstr "emër i panjohur roli: %s" -#: cmd/quickstart.py:519 +#: util/docutils.py:805 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "Tani duhet të populloni kartelën tuaj master file %s dhe të krijoni kartela të tjera\nburim të dokumentimit. " - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Përdorni Makefile-in që të montohen dokumentet, kështu:\n make builder" +msgid "unknown node type: %r" +msgstr "lloj i panjohur nyjeje: %r" -#: cmd/quickstart.py:530 +#: util/fileutil.py:76 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Përodrni urdhrin sphinx-build që të montohen dokumentet, kështu:\n sphinx-build -b montues %s %s" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "ku montues është një nga montuesin e mbuluar, p.sh., html, latex ose linkcheck." - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nProdho kartelat e domosdoshme për një projekt Sphinx.\n\nsphinx-quickstart është një mjet ndërveprues që bën disa pyetje rreth projektit\ntuaj dhe mandej prodhon një drejtori të plotë dokumentimi dhe një shembull\nMakefile për t’u përdorur me sphinx-build.\n" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "Për më tepër hollësi, vizitoni ." - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "mënyra pa zhurmë" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "rrënjë e projektit" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Mundësi strukture" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "nëse është kërkuar, nda veçmas drejtoritë burim dhe montim" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "në u përcaktoftë, krijo drejtori montimi nën drejtorinë burim" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "zëvendësim për pikën te _templates, etj." - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Mundësi bazë të projektit" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "emër projekti" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "emra autorësh" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "version i projektit" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "hedhje në qarkullim e projektit" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "gjuhë dokumenti" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "prapashtesë kartele burim" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "emër dokumenti bazë" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "përdor epub" - -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Mundësi zgjerimi" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "U ndërpre kopjim i provuar prej gjedheje të rikrijuar %s në %s (shtegu vendmbërritje përmban të dhëna ekzistuese)." -#: cmd/quickstart.py:670 +#: util/fileutil.py:89 #, python-format -msgid "enable %s extension" -msgstr "aktivizo zgjerimin %s" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "aktivizo zgjerime arbitrare" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Krijim makefile-i dhe batchfile-i" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "krijo makefile" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "mos krijo makefile" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "krijo batchfile" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "mos krijo batchfile" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "përdor make-mode për Makefile/make.bat" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Gjedhe projekti" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "drejtori gjedhesh për kartela gjedhe" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "përkufizoni një ndryshore gjedheje" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "\"quiet\" është specifikuar, por s’është specifikuar ndonjë \"projekt\" ose \"autor\"." - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Gabim:shtegu i dhënë s’është drejtori, ose kartelat sphinx ekzistojnë tashmë." - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart prodhon vetëm te një drejtori e zbrazët. Ju lutemi, specifikoni një shteg rrënjë të ri." +msgid "Writing evaluated template result to %s" +msgstr "Po shkruhet përfundimi i hamendësuar i gjedhes te %s" -#: cmd/quickstart.py:809 +#: util/docfields.py:103 #, python-format -msgid "Invalid template variable: %s" -msgstr "Ndryshore e pavlefshme gjedheje: %s" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "numri i aktit duhet të jetë një numër pozitiv" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\nProdhoni dokumentim nga kartela burim.\n\nsphinx-build prodhon dokumentim prej kartelash te SOURCEDIR dhe e vendos\nte OUTPUTDIR. Kërkon për 'conf.py' te SOURCEDIR për rregullime formësimi.\nMjeti 'sphinx-quickstart' mund të përdoret për të prodhuar kartela gjedhe,\npërfshi 'conf.py'\n\nsphinx-build mund të krijojë dokumentim në formate të ndryshëm. Një format\npërzgjidhet duke specifikuar te rreshti i urdhrave emrin e montuesit; HTML-ja,\nsi parazgjedhje. Montuesit mund të kryejnë gjithashtu veprime të tjera të lidhura\nme përpunim dokumentimi.\n\nSi parazgjedhje, gjithçka që është e papërditësuar, montohet. Nëse doni\nmontim vetëm për kartela të përzgjedhura, kjo mund të bëhet duke\nspecifikuar emra kartelash individuale.\n" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "shteg për te kartela burimi dokumentimi" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "shteg për te drejtori përfundimesh" - -#: cmd/build.py:109 msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "(opsionale) një listë kartelash të caktuara për t’u rimontuar. E shpërfillur, nëse është dhënë --write-all" - -#: cmd/build.py:114 -msgid "general options" -msgstr "mundësi të përgjithshme" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "Problem në përkatësinë %s: fusha supozohet të përdorë rol '%s', por ai rol s’gjendet te përkatësia." -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "montues për t’u përdorur (parazgjedhje: 'html')" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "s’u gjet rol parazgjedhje %s" -#: cmd/build.py:131 +#: util/nodes.py:462 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "%r s’mbulohet më për zëra treguesi (nga zë %r). Në vend të tyre, përdorni 'pair: %s'." -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "shkruaj krejt kartelat (parazgjedhje: shkruaj vetëm kartela të reja dhe ato të ndryshuara)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "“toctree” përmban referencë për te një kartelë joekzistuese %r" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "mos përdor një mjedis të ruajtur, lexo përherë krejt kartelat" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "përjashtim teksa vlerësohej vetëm shprehje direktive: %s" -#: cmd/build.py:150 -msgid "path options" -msgstr "mundësi shtegu" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "vazhduar nga faqja e mëparshme" -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "drejtori për kartela doctree dhe mjedisi (parazgjedhje: OUTPUT_DIR/.doctrees)" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "vazhdon në faqen pasuese" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "drejtori për kartelën e formësimit (conf.py) (parazgjedhje: SOURCE_DIR)" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "Joalfabetike" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "mos përdor kartelë formësimi, përdor vetëm rregullime nga mundësitë -D" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Simbole" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "anashkalo një rregullim te kartelë formësimi" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Numra" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "jep një vlerë te gjedhe HTML" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "faqe" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "përcaktoni etiketë: përfshi blloqe “only” me TAG" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Hedhje Në Qarkullim" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "S’u soll dot figurë e largët: %s [%s]" -#: cmd/build.py:212 -msgid "console output options" -msgstr "mundësi për ç’prodhon konsola" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "S’u pru dot figurë e largët: %s [%d]" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Format i panjohur figure: %s…" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "pa output në stdout, thjesht sinjalizime në stderr" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "S’u përcaktua dot tekst rrugëdalje për ndër-referencë. Mund të jetë një e metë e programit." -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "pa output fare, madje as sinjalizime" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "u gjet më shumë se një objektiv për ndërreferencën 'any' %r: mund të ishte %s" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "s’u gjet objektiv reference %s:%s: %s" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "s’u gjet objektiv reference %r: %s" -#: cmd/build.py:252 -msgid "warning control options" -msgstr "mundësi kontrolli sinjalizimesh" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "U ndërpre!" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "shkruaj sinjalizime (dhe gabime) te kartela e dhënë" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "Gabim markup-i reStructuredText!" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "shndërroji sinjalizimet në gabime" +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "Gabim kodimi!" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "xhiro Pdb, në rast përjashtimesh" - -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "Kjo mund të ndodhë me kartela burim shumë të mëdha ose të futura thellë brenda njëra-tjetrës. Mund të rrisni me kujdes kufirin parazgjedhje për ripërsëritje Python prej 1000, te conf.py, me p.sh.:" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "s’mund të ndërthuret një mundësi -a dhe emra kartelash" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "Po niset diagnostikuesi:" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" -msgstr "s’hapet dot kartelë sinjalizim “%s”: %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "Traceback-u i plotë u ruajt te:" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "argumenti i mundësisë -D duhet të jetë në formën emër=vlerë" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "Për t’ua njoftuar këtë gabim zhvilluesve, ju lutemi, hapni një çështje te . Faleminderit!" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "argumenti i mundësisë -A duhet të jetë në formën emër=vlerë" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Ju lutemi, njoftojeni nëse qe një gabim përdoruesi, që kështu herës tjetër të mund të furnizohet një mesazh më i mirë gabimi." #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Tkurre anështyllën" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Tryeza e Lëndës" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Lëvizje" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Kërkoni brenda %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Mbi këto dokumente" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Kērko" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Shko" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Të drejta kopjimi" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Përditësuar së fundi më %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Krijuar duke përdorur Sphinx %(sphinx_version)s." + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Subjekti i mëparshëm" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "kapitulli i mëparshëm" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Subjekti pasues" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "kapitulli pasues" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "Tregues – %(key)s" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Tregues i plotë në një faqe" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Kjo Faqe" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Shfaq Burimin" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Lëndë" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Kërkim i shpejtë" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Kërkoni te %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Shko" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2682,7 +2883,7 @@ msgstr "Tregues Global Modulesh" msgid "quick access to all modules" msgstr "hyrje e shpejtë te krejt modulet" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Tregues i Përgjithshëm" @@ -2690,23 +2891,15 @@ msgstr "Tregues i Përgjithshëm" msgid "all functions, classes, terms" msgstr "krejt funksionet, klasat, termat" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Kjo Faqe" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Tryeza e Lëndës" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "Tregues – %(key)s" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Tregues i plotë në një faqe" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Kërkim i shpejtë" +msgid "Search %(docstitle)s" +msgstr "Kërkoni te %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2716,57 +2909,6 @@ msgstr "Faqe treguesi sipas shkronjash" msgid "can be huge" msgstr "mund të jetë i stërmadh" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Subjekti i mëparshëm" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "kapitulli i mëparshëm" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Subjekti pasues" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "kapitulli pasues" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Lëvizje" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Kërkoni brenda %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Mbi këto dokumente" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Të drejta kopjimi" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "© %(copyright_prefix)s %(copyright)s." - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Përditësuar së fundi më %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "Krijuar duke përdorur Sphinx %(sphinx_version)s." - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2783,21 +2925,21 @@ msgstr "Kërkimi për disa fjalë njëherësh shfaq vetëm përputhje që\n p msgid "search" msgstr "kërko" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Fshih Përputhje Kërkimi" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Lëndë" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Përfundime Kërkimi" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Kërkimi juaj s’gjeti përputhje me ndonjë dokument. Ju lutemi, sigurohuni se janë shkruar saktë krejt fjalët dhe se keni përzgjedhur aq kategori sa duhen." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2805,22 +2947,21 @@ msgid_plural "" msgstr[0] "Kërkimi përfundoi, u gjet një faqe me përkime për termat e kërkimit." msgstr[1] "Kërkimi përfundoi, u gjetën ${resultCount} faqe me përkime për termat e kërkimit." -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Kërkim" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Po përgatitet kërkim..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", në " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Fshih Përputhje Kërkimi" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2828,6 +2969,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Ndryshe në Versionin %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2849,120 +2995,127 @@ msgstr "Ndryshime të tjera" msgid "Expand sidebar" msgstr "Zgjeroje anështyllën" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametra" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Ndryshore" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (te moduli %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (te moduli %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (ndryshore e brendshme)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (klasë e brendshme)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (klasë te %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (metodë klase %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (metodë statike %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (veti %s)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Tregues Modulesh Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "module" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Nxjerrë nga përdorimi" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "përjashtim" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "metodë klase" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "metodë statike" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "veti" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "përshkrim i përsëdytur objekti %s, hasje tjetër te %s, për njërin prej tyre përdorni :no-index:" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "për ndërreferencën %r u gjet më shumë se një objektiv: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (nxjerrë nga përdorimi)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametra" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Ndryshore" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "Deklarim C++ i përsëdytur, përkufizuar edhe te %s:%s.\nDeklarimi është '.. cpp:%s:: %s'." #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2973,92 +3126,85 @@ msgstr "Parametra Gjedhesh" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "Deklarim C++ i përsëdytur, përkufizuar edhe te %s:%s.\nDeklarimi është '.. cpp:%s:: %s'." - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "bashkim" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "anëtar" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "lloj" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "koncept" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "parametër funksioni" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "parametër gjedheje" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Deklarim C i përsëdytur, përkufizuar edhe te %s:%s.\nDeklarimi është '.. c:%s:: %s'." -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "ndryshore" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "makro" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "ndryshore mjedisi; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "%s; vlerë formësimi" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "Lloj" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "Parazgjedhje" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3153,514 +3299,422 @@ msgstr "etiketë e papërkufizuar: %r" msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "S’u arrit të krijohet ndërreferencë. S’u gjet një titull, ose një përshkrim: %r" -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "u pikasën referenca rrethore toctree-je, po shpërfllen: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "toctree përmban referencë ndaj dokumenti %r që s’ka titull: s’do të prodhohet ndonjë lidhje" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "toctree përmban referencë dokumenti të papërfshirë %r" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "shihni %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "shihni edhe %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "lloj i panjohur zëri treguesi: %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Simbole" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "kartelë figure jo e lexueshme: %s" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "kartelë figure %s jo e lexueshme: %s" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "kartelë shkarkimi jo e lexueshme: %s" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "U ndërpre!" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "Gabim markup-i reStructuredText!" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "Gabim kodimi!" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "Po niset diagnostikuesi:" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "Traceback-u i plotë u ruajt te:" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "Për t’ua njoftuar këtë gabim zhvilluesve, ju lutemi, hapni një çështje te . Faleminderit!" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Ju lutemi, njoftojeni nëse qe një gabim përdoruesi, që kështu herës tjetër të mund të furnizohet një mesazh më i mirë gabimi." - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "S’u përcaktua dot tekst rrugëdalje për ndër-referencë. Mund të jetë një e metë e programit." - -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "u gjet më shumë se një objektiv për ndërreferencën 'any' %r: mund të ishte %s" - -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "s’u gjet objektiv reference %s:%s: %s" - -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "s’u gjet objektiv reference %r: %s" - -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "S’u soll dot figurë e largët: %s [%s]" - -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "S’u pru dot figurë e largët: %s [%d]" +msgid "invalid value set (missing closing brace): %s" +msgstr "u caktua vlerë e pavlefshme (mungon kllapë mbyllëse): %s" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." -msgstr "Format i panjohur figure: %s…" +msgid "invalid value set (missing opening brace): %s" +msgstr "u caktua vlerë e pavlefshme (mungon kllapë hapëse): %s" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "Faqet HTML gjenden në %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" +msgstr "shprehje vargu e keqformuar (mungon thonjëz mbyllëse): %s" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" -msgstr "S’u arrit të lexohet kartelë të dhënash montimi: %r" +msgid "malformed string literal (missing opening quote): %s" +msgstr "shprehje vargu e keqformuar (mungon thonjëz hapëse): %s" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "mospërputhje build_info-sh, po kopjohet .buildinfo te .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Shembull" -#: builders/html/__init__.py:366 -msgid "building [html]: " -msgstr "po prodhohet [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Shembuj" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "gjedhja %s është ndryshuar që prej montimit të mëparshëm, do të riprodhohen krejt dokumentet" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Argumente Fjalëkyçi" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "tregues" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Shënime" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "Stemë e %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Parametra të Tjerë" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "pasuesi" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "i mëparshmi" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Referenca" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "po prodhohen tregues" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Sinjalizime" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "po shkruhen faqe shtesë" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "s’kopjohet dot kartelë figurë '%s': %s" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "po kopjohen kartela të shkarkueshme… " +msgid "A mocked object is detected: %r" +msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "s’kopjohet dot kartelë e shkarkueshme %r: %s" +msgid "alias of %s" +msgstr "alias për %s" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "S’u arrit të kopjohet një kartelë te drejtoria 'static' e temës: %s: %r" +msgid "Bases: %s" +msgstr "Baza: %s" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "S’u arrit të kopjohet një kartelë te html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" +msgstr "vlerë e pavlefshme mundësie për member-order: %s" -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "po kopjohen kartela statike" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" +msgstr "vlerë e pavlefshme për mundësinë class-doc-from: %s" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" -msgstr "s’kopjohet dot kartelë statike %r" +msgid "invalid signature for auto%s (%r)" +msgstr "nënshkrim i pavlefshëm për auto%s (%r)" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "po kopjohen kartela ekstra" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "s’dihet cili modul të importohet për vetëdokumentim të %r (provoni të vendosni te dokumenti një direktivë \"module\" ose \"currentmodule\", ose të jepni shprehimisht një emër moduli)" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" -msgstr "s’kopjohet dot kartelë ekstra %r" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" -msgstr "S’u arrit të shkruhet kartelë të dhënash montimi: %r" +msgid "return annotation given for automodule: '%s'" +msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "treguesi i kërkimi s’u ngarkua dot, por jo krejt dokumentet do të montohen: treguesi do të jetë i paplotë." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "\"::\" në emër automoduli nuk ka kuptim" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "faqja %s ka përputhje me dy rregullsi te html_sidebars: %r dhe %r" +msgid "Failed to remove %s: %s" +msgstr "S’u arrit të hiqet %s: %s" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "Do të krijonte kartelë %s." + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "ndodhi një gabim Unikod, kur vizatohej faqja %s. Ju lutemi, siguroni që krejt vlerat e formësimit që përmbajnë lëndë jo-ASCII të jenë vargje Unikod." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nShih në mënyrë rekursive te për module dhe\npaketa Python dhe krijo një kartelë reST me direktiva\nautomodulesh për paketë te .\n\ns mund të jetë shprehje kartelash dhe/ose\ndrejtorish që mund të përjashtohen nga prodhimi.\n\nShënim: Si parazgjedhje, ky programth s’do të anashkalojë\nkartela të krijuara tashmë." -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "shteg për te modul për te dokumenti" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "Ndodhi një gabim gjatë vizatimit të faqes %s.\nArsye: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "kartelë fnmatch-style dhe/ose rregullsi drejtorish për t’u përjashtuar prej prodhimit" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "drejtori ku të vendosen krejt përfundimet" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "po shkruhet lënda e treguesit të kërkimeve në %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "thellësi maksimum nënmodulesh për shfaqje te TEL (parazgjedhje: 4)" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "js_file e pavlefshme: %r, u shpërfill" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "mbishkruaj kartela ekzistuese" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "Janë të regjistruar plot math_renderers. Por s’u përzgjodh math_renderer." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "ndiq lidhje simbolike. E fuqishme, kur ndërthuret me collective.recipe.omelette." -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "U dha math_renderer %r i panjohur." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "xhiroje programthin pa krijuar kartela" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "zëri %r i html_extra_path entry është vendosur jashtë outdir-it" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "vendose dokumentim për çdo modul në faqe më vete" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "zëri html_extra_path %r s’ekziston" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "përfshi modulet \"_private\"" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "zëri %r i html_extra_path entry është vendosur brenda outdir-it" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "emër kartele për tryezën e lëndës (parazgjedhje: modules)" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" -msgstr "zëri html_static_path %r s’ekziston" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "mos krijo një kartelë tryeze lënde" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "kartela stemë %r s’ekziston" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "mos krijo krye për paketat modul/paketë (për shembull, kur ato i përmban tashmë docstrings)" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" -msgstr "kartela favikonë %r s’ekziston" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "vendose dokumentimin e modulit përpara dokumentimit të nënmodulit" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." -msgstr "Vlerat në 'html_sidebars' duhet të jetë një listë vargjesh. Të paktën një rregullsi ka një vlerë varg: %s. Ndryshojeni në `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "interpreto shtigje modulesh sipas specifikimeve impicite PEP-0420 për emërhapësira" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "HTML 4 s’mbulohet më nga Sphinx-i. (U pikas “html4_writer=True” te mundësi formësimi)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "Listë mundësish, ndarë me presje, për t’ia kaluar direktivës “automodule” (ose përdorni SPHINX_APIDOC_OPTIONS)." -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" -msgstr "Dokumentim i %s %s" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "prapashtesë kartele (parazgjedhje: rst)" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" -msgstr "s’u arrit të lexohet kartelë e dëmtuar hollësish montimi (version i panjohur)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "Hiq te drejtoria përfundim kartela ekzistuese që s’qenë prodhuar" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" -msgstr "s’u arrit të lexohet kartelë e dëmtuar hollësish montimi (mungon zë formësimi)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "prodho me sphinx-quickstart një projekt të plotë" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" -msgstr "s’u arrit të lexohet kartelë e dëmtuar hollësish montimi (mungon zë etiketash)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "shto module_path pas sys.path, e përdorur kur është dhënë --full" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "Kartelat LaTeX gjenden në %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "emër projekti (parazgjedhje: emër moduli rrënjë)" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nXhironi 'make' te ajo drejtori që të xhirohen këto përmes (pdf)latex\n(që të bëhet kjo automatikisht, përdorni `make latexpdf' këtu)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "autor(ë) projekti, e përdorur kur është dhënë --full" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "s’u gjet vlerë formësimi \"texinfo_documents\"; s’do të shkruhet ndonjë dokument" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "version projekti, e përdorur kur është dhënë --full" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "vlera e formësimit \"texinfo_documents\" i referohet një dokumenti të panjohur %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "hedhje në qarkullim e projektit, e përdorur kur është dhënë --full, si parazgjedhje merr --doc-version" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Hedhje Në Qarkullim" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "mundësi zgjatimi" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "po kopjohen kartela mbulimi TeX" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "aktivizo zgjerime arbitrare, të përdorur kur është dhënë --full" -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "po kopjohen kartela shtesë" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" +msgstr "aktivizo zgjerimin %s, i përdorur kur është dhënë --full" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "Kyç i panjohur formësimi: latex_elements[%r], u shpërfill." +msgid "%s is not a directory." +msgstr "%s s’është drejtori." + +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "Po xhirohet apidoc" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "Mundësi e panjohur teme: latex_theme_options[%r], u shpërfill." +msgid "apidoc_modules item %i must be a dict" +msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" -msgstr "S’u arrit të merrej një “docname”!" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "Objekti apidoc_modules %i duhet të ketë një fushë 'path'" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" -msgstr "S’u arrit të merret “docname” për burimin %r!" +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "Objekti apidoc_modules te 'path' %i duhet të jetë një varg" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" -msgstr "S’u gjet poshtëshënim për nyjë reference të dhënë %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "Objekti apidoc_modules %i 'path' s’është një dosje ekzistuese: %s" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r s’ka rregullimin \"theme\"" +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "Objekti apidoc_modules %i duhet të ketë një fushë 'destination'" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r s’ka rregullimin \"%s\"" +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "Objekti apidoc_modules %i 'destination' duhet të jetë një varg" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "vazhduar nga faqja e mëparshme" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "Objekti apidoc_modules %i 'destination' duhet të jetë një shteg relativ" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "vazhdon në faqen pasuese" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "Objekti apidoc_modules %i s’mund të krijojë drejtorinë vendmbërritje: %s" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "Joalfabetike" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "Objekti apidoc_modules %i '%s' duhet të jetë një vlerë e plotë" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Numra" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "Objekti apidoc_modules %i '%s' duhet të jetë një vlerë buleane" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "faqe" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "Objekti apidoc_modules %i ka fusha të papritura: %s" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "Argumente Fjalëkyçi" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "Objekti apidoc_modules %i '%s' duhet të jetë një sekuencë" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "u caktua vlerë e pavlefshme (mungon kllapë mbyllëse): %s" +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "Objekti apidoc_modules %i '%s' duhet të përmbajë vargje" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "u caktua vlerë e pavlefshme (mungon kllapë hapëse): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "vetëpërmbledhje: s’u arrit të përcaktohet %r për t’u dokumentuar, u shfaq përjashtimi vijues:\n%s" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "shprehje vargu e keqformuar (mungon thonjëz mbyllëse): %s" +msgid "[autosummary] generating autosummary for: %s" +msgstr "[vetëpërmbledhje] prodhim vetëpërmbledhje për: %s" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "shprehje vargu e keqformuar (mungon thonjëz hapëse): %s" +msgid "[autosummary] writing to %s" +msgstr "[vetëpërmbledhje] po shkruhet te %s" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Shembull" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "[autosummary] s’u arrit të importohej %s.\nNdihmëza të mundshme:\n%s" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Shembuj" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nProdhoni ReStructuredText duke përdorur direktiva vetëpërmbledhje.\n\nsphinx-autogen është një ndërfaqe pamore për sphinx.ext.autosummary.generate. Prodhon\nkartela reStructuredText nga direktiva vetëpërmbledhjeje që përmbahen te\nkartelat e dhëna.\n\nFormati i direktivës vetëpërmbledhje dokumentohet te\nmoduli Python ``sphinx.ext.autosummary`` dhe mund të lexohet duke përdorur::\n\n pydoc sphinx.ext.autosummary\n" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Shënime" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "kartela burim për të cilat të krijohen kartela rST" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Parametra të Tjerë" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "drejtori ku të vendosen krejt përfundimet" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "prapashtesë parazgjedhje për kartela (parazgjedhje: %(default)s)" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Referenca" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "drejtori gjedhesh vetjake (parazgjedhje: %(default)s)" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Sinjalizime" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "pjesë të importuara të dokumentit (parazgjedhje: %(default)s)" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "dokumentoni saktësisht pjesët te moduli __all__ attribute. (parazgjedhje: %(default)s)" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "referenca vetëpërmbledhjeje përjashtuan dokumentin %r. U shpërfill." -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "vetëpërmbledhje: s’u gjet kartelë stub %r. Kontrolloni rregullimin tuaj autosummary_generate." -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3668,548 +3722,585 @@ msgid "" "%s" msgstr "përmbledhje e automatizuar: s’u arrit të importohej %s.\nNdihmëza të mundshme:\n%s" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "s’u arrit të përtypej emri %s" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "s’u arrit të importohej objekti %s" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: s’u gjet kartelë: %s" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "veçoria e përmbledhjes së automatizuar prodhon kartela .rst së brendshmi. Por source_suffix juaj nuk përmban .rst. U anashkalua." -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "vetëpërmbledhje: s’u arrit të përcaktohet %r për t’u dokumentuar, u shfaq përjashtimi vijues:\n%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "Identifikues i pavlefshëm projekti intersphinx `%r` te intersphinx_mapping. Identifikuesit e projektit duhet të jenë vargje jo të zbrazët." -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[vetëpërmbledhje] prodhim vetëpërmbledhje për: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "Vlerë e pavlefshme `%r` në intersphinx_mapping[%r]. Pritej një dyshe elementësh, ose një listë." -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[vetëpërmbledhje] po shkruhet te %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "Vlerë e pavlefshme `%r` te intersphinx_mapping[%r]. Vlerat duhet të jenë një dyshe (URI e synuar, vendndodhje depoje)." -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "[autosummary] s’u arrit të importohej %s.\nNdihmëza të mundshme:\n%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "Vlerë e pavlefshme URI objektivi `%r` te intersphinx_mapping[%r][0]. URI-t objektiv duhet të jenë vargje unikë jo të zbrazët." -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\nProdhoni ReStructuredText duke përdorur direktiva vetëpërmbledhje.\n\nsphinx-autogen është një ndërfaqe pamore për sphinx.ext.autosummary.generate. Prodhon\nkartela reStructuredText nga direktiva vetëpërmbledhjeje që përmbahen te\nkartelat e dhëna.\n\nFormati i direktivës vetëpërmbledhje dokumentohet te\nmoduli Python ``sphinx.ext.autosummary`` dhe mund të lexohet duke përdorur::\n\n pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "Vlerë e pavlefshme URI objektivi `%r` te intersphinx_mapping[%r][0]. URI-t objektiv duhet të jenë vargje unikë jo të zbrazët (tjetër instancë në intersphinx_mapping[%r]. " -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "kartela burim për të cilat të krijohen kartela rST" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "Vlerë e pavlefshme vendndodhjeje inventari `%r` te intersphinx_mapping[%r][1]. Vendndodhjet e inventarëve duhet të jepen si vargje jo të zbrazët, ose si “None”." -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "drejtori ku të vendosen krejt përfundimet" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "Formësim i pavlefshëm për `intersphinx_mapping` (1 gabim)." + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "Formësim i pavlefshëm për `intersphinx_mapping` (%s gabime)." + +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "Pas normalizimit u shtua një zë i pavlefshëm për intersphinx_mapping." + +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "po ngarkohet depo intersphinx '%s' që prej %s …" + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "u hasën disa probleme me disa nga inventare, por kishin alternativa funksionale:" + +#: ext/intersphinx/_load.py:332 +#, python-format +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "prapashtesë parazgjedhje për kartela (parazgjedhje: %(default)s)" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "inventari intersphinx është lëvizur: %s -> %s" -#: ext/autosummary/generate.py:882 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "drejtori gjedhesh vetjake (parazgjedhje: %(default)s)" +msgid "(in %s %s)" +msgstr "(në %s %s)" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "pjesë të importuara të dokumentit (parazgjedhje: %(default)s)" +msgid "(in %s)" +msgstr "(te %s)" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_resolve.py:112 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "dokumentoni saktësisht pjesët te moduli __all__ attribute. (parazgjedhje: %(default)s)" +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "depo '%s': u gjetën përsëdytje për %s:%s" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" -msgstr "Hiq te drejtoria përfundim kartela ekzistuese që s’qenë prodhuar" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "inventar '%s': u gjetën përputhje të shumta për %s:%s" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:387 #, python-format -msgid "Failed to remove %s: %s" -msgstr "S’u arrit të hiqet %s: %s" +msgid "inventory for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nShih në mënyrë rekursive te për module dhe\npaketa Python dhe krijo një kartelë reST me direktiva\nautomodulesh për paketë te .\n\ns mund të jetë shprehje kartelash dhe/ose\ndrejtorish që mund të përjashtohen nga prodhimi.\n\nShënim: Si parazgjedhje, ky programth s’do të anashkalojë\nkartela të krijuara tashmë." +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "parashtesë e pavlefshme ndër-reference të jashtme: %r" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "shteg për te modul për te dokumenti" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "s’u gjet përkatësi për ndër-referencë të jashtme: %r" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "kartelë fnmatch-style dhe/ose rregullsi drejtorish për t’u përjashtuar prej prodhimit" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "s’u gjet objektiv reference të jashtme %s:%s: %s" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "drejtori ku të vendosen krejt përfundimet" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "gabim gjatë formatimi nënshkrimesh për %s: %s" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "thellësi maksimum nënmodulesh për shfaqje te TEL (parazgjedhje: 4)" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "Po shpërfillet __all__ i pavlefshëm në modulin %s: %r" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "mbishkruaj kartela ekzistuese" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "S’u arrit të merret një nënshkrim funksioni për %s: %s" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "ndiq lidhje simbolike. E fuqishme, kur ndërthuret me collective.recipe.omelette." +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "S’u arrit të përditësohet nënshkrim për %r: s’u gjet parametër: %s" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "xhiroje programthin pa krijuar kartela" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "S’u arrit të përtypet type_comment për %r: %s" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "vendose dokumentim për çdo modul në faqe më vete" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "U gjet __slots__ i pavlefshëm në %s. U shpërfill." -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "përfshi modulet \"_private\"" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "gabim gjatë formatimi argumentesh për %s: %s" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "emër kartele për tryezën e lëndës (parazgjedhje: modules)" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "S’u arrit të merrej nënshkrim konstruktori për %s: %s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "mos krijo një kartelë tryeze lënde" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "S’u arrit të merre një nënshkrim metode për %s: %s" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "mos krijo krye për paketat modul/paketë (për shembull, kur ato i përmban tashmë docstrings)" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "S’u arrit të merret nënshkrim për %s: %s" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "vendose dokumentimin e modulit përpara dokumentimit të nënmodulit" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "S’u arrit të përtypej një vlerë parazgjedhje argumenti për %r: %s" -#: ext/apidoc/_cli.py:152 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "interpreto shtigje modulesh sipas specifikimeve impicite PEP-0420 për emërhapësira" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" +msgstr "atributi %s shfaqet te :members:, por mungon, ngaqë s’u gjend te objekti %r" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." -msgstr "Listë mundësish, ndarë me presje, për t’ia kaluar direktivës “automodule” (ose përdorni SPHINX_APIDOC_OPTIONS)." - -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "prapashtesë kartele (parazgjedhje: rst)" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "autodoc: s’u arrit të përcaktohet %s.%s (%r) për t’u dokumentuar, u shfaq përjashtimi vijues:\n%s" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "prodho me sphinx-quickstart një projekt të plotë" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "shto module_path pas sys.path, e përdorur kur është dhënë --full" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ should duhet të jetë një listë vargjesh, jo %r (në module %s) -- ignoring __all__" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "emër projekti (parazgjedhje: emër moduli rrënjë)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "u përmend atribut që mungon në :members: mundësi: modul %s, atributi %s" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "autor(ë) projekti, e përdorur kur është dhënë --full" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "atribut %s që mungon te objekt %s" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "version projekti, e përdorur kur është dhënë --full" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "alias për TypeVar(%s)" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "hedhje në qarkullim e projektit, e përdorur kur është dhënë --full, si parazgjedhje merr --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "s’u arrit të lexohet kartelë e dëmtuar hollësish montimi (version i panjohur)" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "mundësi zgjatimi" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "s’u arrit të lexohet kartelë e dëmtuar hollësish montimi (mungon zë formësimi)" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" -msgstr "aktivizo zgjerime arbitrare, të përdorur kur është dhënë --full" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "s’u arrit të lexohet kartelë e dëmtuar hollësish montimi (mungon zë etiketash)" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" -msgstr "aktivizo zgjerimin %s, i përdorur kur është dhënë --full" +msgid "The HTML pages are in %(outdir)s." +msgstr "Faqet HTML gjenden në %(outdir)s." -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." -msgstr "%s s’është drejtori." - -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" -msgstr "" +msgid "Failed to read build info file: %r" +msgstr "S’u arrit të lexohet kartelë të dhënash montimi: %r" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" -msgstr "" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "mospërputhje build_info-sh, po kopjohet .buildinfo te .buildinfo.bak" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" -msgstr "" +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "po prodhohet [html]: " -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" -msgstr "Objekti apidoc_modules te 'path' %i duhet të jetë një varg" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "gjedhja %s është ndryshuar që prej montimit të mëparshëm, do të riprodhohen krejt dokumentet" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" -msgstr "Objekti apidoc_modules %i 'path' s’është një dosje ekzistuese: %s" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "tregues" -#: ext/apidoc/_extension.py:133 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +msgid "Logo of %s" +msgstr "Stemë e %s" -#: ext/apidoc/_extension.py:140 -#, python-format -msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "Objekti apidoc_modules %i 'destination' duhet të jetë një varg" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "pasuesi" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "Objekti apidoc_modules %i 'destination' duhet të jetë një shteg relativ" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "i mëparshmi" -#: ext/apidoc/_extension.py:157 -#, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" -msgstr "Objekti apidoc_modules %i s’mund të krijojë drejtorinë vendmbërritje: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "po prodhohen tregues" -#: ext/apidoc/_extension.py:178 -#, python-format -msgid "apidoc_modules item %i '%s' must be an int" -msgstr "Objekti apidoc_modules %i '%s' duhet të jetë një vlerë e plotë" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "po shkruhen faqe shtesë" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "Objekti apidoc_modules %i '%s' duhet të jetë një vlerë buleane" +msgid "cannot copy image file '%s': %s" +msgstr "s’kopjohet dot kartelë figurë '%s': %s" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" -msgstr "" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "po kopjohen kartela të shkarkueshme… " -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" -msgstr "Objekti apidoc_modules %i '%s' duhet të jetë një sekuencë" +msgid "cannot copy downloadable file %r: %s" +msgstr "s’kopjohet dot kartelë e shkarkueshme %r: %s" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "Objekti apidoc_modules %i '%s' duhet të përmbajë vargje" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgstr "S’u arrit të kopjohet një kartelë te drejtoria 'static' e temës: %s: %r" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:871 #, python-format -msgid "Would create file %s." -msgstr "Do të krijonte kartelë %s." +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "S’u arrit të kopjohet një kartelë te html_static_file: %s: %r" -#: ext/intersphinx/_resolve.py:49 -#, python-format -msgid "(in %s v%s)" -msgstr "(te %s v%s)" +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "po kopjohen kartela statike" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:923 #, python-format -msgid "(in %s)" -msgstr "(te %s)" +msgid "cannot copy static file %r" +msgstr "s’kopjohet dot kartelë statike %r" -#: ext/intersphinx/_resolve.py:108 -#, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "depo '%s': u gjetën përsëdytje për %s:%s" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "po kopjohen kartela ekstra" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:938 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "inventar '%s': u gjetën përputhje të shumta për %s:%s" +msgid "cannot copy extra file %r" +msgstr "s’kopjohet dot kartelë ekstra %r" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:944 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +msgid "Failed to write build info file: %r" +msgstr "S’u arrit të shkruhet kartelë të dhënash montimi: %r" -#: ext/intersphinx/_resolve.py:392 -#, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "parashtesë e pavlefshme ndër-reference të jashtme: %r" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "treguesi i kërkimi s’u ngarkua dot, por jo krejt dokumentet do të montohen: treguesi do të jetë i paplotë." -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:1038 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "s’u gjet përkatësi për ndër-referencë të jashtme: %r" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "faqja %s ka përputhje me dy rregullsi te html_sidebars: %r dhe %r" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1204 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "s’u gjet objektiv reference të jashtme %s:%s: %s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "ndodhi një gabim Unikod, kur vizatohej faqja %s. Ju lutemi, siguroni që krejt vlerat e formësimit që përmbajnë lëndë jo-ASCII të jenë vargje Unikod." -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "Identifikues i pavlefshëm projekti intersphinx `%r` te intersphinx_mapping. Identifikuesit e projektit duhet të jenë vargje jo të zbrazët." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" +msgstr "Tema '%s' s’e mbulon këtë version të Sphinx-it, ngaqë përdor fushën 'style' në gjedhe HTML, çka u nxor nga përdorimi me Sphinx 5.1 dhe u hoq me Sphinx 7.0. Në vend të kësaj, tema duhet përditësuar që të përdorë fushën 'styles'. Shihni https://www.sphinx-doc.org/en/master/development/html_themes/templating.html#styles" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "Vlerë e pavlefshme `%r` në intersphinx_mapping[%r]. Pritej një dyshe elementësh, ose një listë." +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "Ndodhi një gabim gjatë vizatimit të faqes %s.\nArsye: %r" + +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1266 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "Vlerë e pavlefshme `%r` te intersphinx_mapping[%r]. Vlerat duhet të jenë një dyshe (URI e synuar, vendndodhje depoje)." +msgid "dumping search index in %s" +msgstr "po shkruhet lënda e treguesit të kërkimeve në %s" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "Vlerë e pavlefshme URI objektivi `%r` te intersphinx_mapping[%r][0]. URI-t objektiv duhet të jenë vargje unikë jo të zbrazët." +msgid "invalid js_file: %r, ignored" +msgstr "js_file e pavlefshme: %r, u shpërfill" + +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Janë të regjistruar plot math_renderers. Por s’u përzgjodh math_renderer." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "Vlerë e pavlefshme URI objektivi `%r` te intersphinx_mapping[%r][0]. URI-t objektiv duhet të jenë vargje unikë jo të zbrazët (tjetër instancë në intersphinx_mapping[%r]. " +msgid "Unknown math_renderer %r is given." +msgstr "U dha math_renderer %r i panjohur." -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "Vlerë e pavlefshme vendndodhjeje inventari `%r` te intersphinx_mapping[%r][1]. Vendndodhjet e inventarëve duhet të jepen si vargje jo të zbrazët, ose si “None”." +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "zëri %r i html_extra_path entry është vendosur jashtë outdir-it" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "Formësim i pavlefshëm për `intersphinx_mapping` (1 gabim)." +#: builders/html/__init__.py:1370 +#, python-format +msgid "html_extra_path entry %r does not exist" +msgstr "zëri html_extra_path %r s’ekziston" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1385 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "Formësim i pavlefshëm për `intersphinx_mapping` (%s gabime)." +msgid "html_static_path entry %r is placed inside outdir" +msgstr "zëri %r i html_extra_path entry është vendosur brenda outdir-it" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "Pas normalizimit u shtua një zë i pavlefshëm për intersphinx_mapping." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" +msgstr "zëri html_static_path %r s’ekziston" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "po ngarkohet depo intersphinx '%s' që prej %s …" +msgid "logo file %r does not exist" +msgstr "kartela stemë %r s’ekziston" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "kartela favikonë %r s’ekziston" + +#: builders/html/__init__.py:1425 +#, python-format msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "u hasën disa probleme me disa nga inventare, por kishin alternativa funksionale:" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." +msgstr "Vlerat në 'html_sidebars' duhet të jetë një listë vargjesh. Të paktën një rregullsi ka një vlerë varg: %s. Ndryshojeni në `html_sidebars = %r`." -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "s’u arrit të kapej ndonjë inventar me problemet vijuese:" +#: builders/html/__init__.py:1438 +msgid "" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "HTML 4 s’mbulohet më nga Sphinx-i. (U pikas “html4_writer=True” te mundësi formësimi)" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "inventari intersphinx është lëvizur: %s -> %s" +msgid "%s %s documentation" +msgstr "Dokumentim i %s %s" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "vlerë e pavlefshme mundësie për member-order: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r s’ka rregullimin \"theme\"" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "vlerë e pavlefshme për mundësinë class-doc-from: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r s’ka rregullimin \"%s\"" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "nënshkrim i pavlefshëm për auto%s (%r)" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "S’u arrit të merrej një “docname”!" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "gabim gjatë formatimi argumentesh për %s: %s" +msgid "Failed to get a docname for source %r!" +msgstr "S’u arrit të merret “docname” për burimin %r!" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "autodoc: s’u arrit të përcaktohet %s.%s (%r) për t’u dokumentuar, u shfaq përjashtimi vijues:\n%s" +msgid "No footnote was found for given reference node %r" +msgstr "S’u gjet poshtëshënim për nyjë reference të dhënë %r" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "Kartelat LaTeX gjenden në %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "s’dihet cili modul të importohet për vetëdokumentim të %r (provoni të vendosni te dokumenti një direktivë \"module\" ose \"currentmodule\", ose të jepni shprehimisht një emër moduli)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nXhironi 'make' te ajo drejtori që të xhirohen këto përmes (pdf)latex\n(që të bëhet kjo automatikisht, përdorni `make latexpdf' këtu)." -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" -msgstr "" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "s’u gjet vlerë formësimi \"texinfo_documents\"; s’do të shkruhet ndonjë dokument" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "gabim gjatë formatimi nënshkrimesh për %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "vlera e formësimit \"texinfo_documents\" i referohet një dokumenti të panjohur %s" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "\"::\" në emër automoduli nuk ka kuptim" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "po kopjohen kartela mbulimi TeX" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "po kopjohen kartela shtesë" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ should duhet të jetë një listë vargjesh, jo %r (në module %s) -- ignoring __all__" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Kyç i panjohur formësimi: latex_elements[%r], u shpërfill." -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "u përmend atribut që mungon në :members: mundësi: modul %s, atributi %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "Mundësi e panjohur teme: latex_theme_options[%r], u shpërfill." -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "S’u arrit të merret një nënshkrim funksioni për %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "S’u arrit të merrej nënshkrim konstruktori për %s: %s" +msgid "image file not readable: %s" +msgstr "kartelë figure jo e lexueshme: %s" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" -msgstr "Baza: %s" +msgid "image file %s not readable: %s" +msgstr "kartelë figure %s jo e lexueshme: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" -msgstr "atribut %s që mungon te objekt %s" +msgid "download file not readable: %s" +msgstr "kartelë shkarkimi jo e lexueshme: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" -msgstr "alias për %s" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "u pikasën referenca rrethore toctree-je, po shpërfllen: %s <- %s" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "alias për TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "toctree përmban referencë ndaj dokumenti %r që s’ka titull: s’do të prodhohet ndonjë lidhje" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "S’u arrit të merre një nënshkrim metode për %s: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "toctree përmban referencë dokumenti të papërfshirë %r" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "U gjet __slots__ i pavlefshëm në %s. U shpërfill." +msgid "toctree contains reference to non-existing document %r" +msgstr "toctree përmban referencë ndaj dokumenti %r që s’ekziston" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "S’u arrit të përtypej një vlerë parazgjedhje argumenti për %r: %s" +msgid "see %s" +msgstr "shihni %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "S’u arrit të përditësohet nënshkrim për %r: s’u gjet parametër: %s" +msgid "see also %s" +msgstr "shihni edhe %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "S’u arrit të përtypet type_comment për %r: %s" +msgid "unknown index entry type %r" +msgstr "lloj i panjohur zëri treguesi: %r" diff --git a/sphinx/locale/sr/LC_MESSAGES/sphinx.mo b/sphinx/locale/sr/LC_MESSAGES/sphinx.mo index 7d42c15ae64..4c5e0597607 100644 Binary files a/sphinx/locale/sr/LC_MESSAGES/sphinx.mo and b/sphinx/locale/sr/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/sr/LC_MESSAGES/sphinx.po b/sphinx/locale/sr/LC_MESSAGES/sphinx.po index f226b7a33d5..714562a38de 100644 --- a/sphinx/locale/sr/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/sr/LC_MESSAGES/sphinx.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Vladimir Milovanović , 2020\n" "Language-Team: Serbian (http://app.transifex.com/sphinx-doc/sphinx-1/language/sr/)\n" @@ -20,6 +20,127 @@ msgstr "" "Language: sr\n" "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -34,127 +155,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Догађај %r већ постоји" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Непознат догађај: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Нема изворног директоријума (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Изворни и одредишни директоријум не могу бити једнаки" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Покрећем Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Овај пројекат захтева верзију Sphinx v%s или већу, не може се изградити инсталираном верзијом." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "учитавање превода [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "готово" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "Неуспешно: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -162,12 +310,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -175,82 +323,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "Конфигурациони директоријум не садржи conf.py датотеку (%s)." +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "Преводилац за %r већ постоји" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "Конфигурациони директоријум не садржи conf.py датотеку (%s)." + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -258,468 +538,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Одељак %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Сл. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Табела %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Списак %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Пажња" + +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Догађај %r већ постоји" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Грешка" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Непознат догађај: %s" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Путоказ" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "" +#: locale/__init__.py:234 +msgid "Important" +msgstr "Важно" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:235 +msgid "Note" +msgstr "Белешка" + +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: project.py:87 +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Савет" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Упозорење" + +#: builders/texinfo.py:41 #, python-format -msgid "Ignored unreadable document %r." +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:187 +#: builders/texinfo.py:85 #, python-format -msgid "Builder name %s not registered or available through entry point" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:197 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder name %s not registered" +msgid "processing %s" msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:235 +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (у " + +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "пребацивање слика... " + +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "Преводилац за %r већ постоји" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[изворни код]" - -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[документација]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Код модула" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Изворни код %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Преглед: код модула" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "error writing file %s: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:436 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "" + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "све изворне датотеке" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"file %r given on command line is not under the source directory, ignoring" msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "ажурирање окружења: " + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "припремање докумената" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "пребацивање изворних датотека..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -740,9 +1176,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -777,6 +1214,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "План" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -864,879 +1329,960 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "План" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:47 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" + +#: ext/duration.py:139 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Аутор одељка: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[изворни код]" -#: directives/other.py:205 -msgid "Module author: " -msgstr "Аутор модула: " +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Аутор кода: " +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[документација]" -#: directives/other.py:209 -msgid "Author: " -msgstr "Аутор: " +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Код модула" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        Изворни код %s

        " -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Преглед: код модула" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:29 +#: domains/citation.py:75 #, python-format -msgid "The overview file is in %(outdir)s." +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:56 +#: domains/citation.py:92 #, python-format -msgid "no changes in version %s." +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/changes.py:72 -msgid "Module level" -msgstr "" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (уграђена функција)" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "пребацивање изворних датотека..." +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s метода)" -#: builders/changes.py:133 +#: domains/javascript.py:186 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "%s() (class)" +msgstr "%s() (класа)" -#: builders/manpage.py:37 +#: domains/javascript.py:188 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (глобална променљива или константа)" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" +msgstr "%s (атрибут %s)" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Аргументи" -#: builders/manpage.py:71 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:224 -#, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Резултат" + +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Тип резултата" -#: builders/__init__.py:232 +#: domains/javascript.py:374 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (module)" +msgstr "%s (модул)" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "функција" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "метода" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "класа" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "атрибут" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "модул" + +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:275 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "all of %d po files" +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:297 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "targets for %d po files that are specified" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:309 +#: domains/rst.py:224 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (role)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "све изворне датотеке" +#: domains/rst.py:234 +msgid "directive" +msgstr "директива" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:348 +#: domains/rst.py:262 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:361 +#: domains/changeset.py:32 #, python-format -msgid "%d source files given on command line" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:377 +#: domains/changeset.py:33 #, python-format -msgid "targets for %d source files that are out of date" -msgstr "" +msgid "Changed in version %s" +msgstr "Измењено у верзији %s" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/changeset.py:34 #, python-format -msgid "building [%s]: " -msgstr "" +msgid "Deprecated since version %s" +msgstr "Застарело почевши од верзије %s" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:410 +#: domains/__init__.py:322 #, python-format -msgid "%d found" -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:412 -msgid "none found" +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "ажурирање окружења: " - -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:109 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:558 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "припремање докумената" - -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "" - -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/texinfo.py:89 +#: cmd/build.py:357 #, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (у " +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "пребацивање слика... " +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:134 #, python-format -msgid "unknown mimetype for %s, ignoring" +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:794 +#: cmd/quickstart.py:230 #, python-format -msgid "writing %s file..." +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/gettext.py:244 +#: cmd/quickstart.py:242 #, python-format -msgid "The message catalogs are in %(outdir)s." +msgid "Selected root path: %s" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Име пројекта" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Име(на) аутора" -#: transforms/i18n.py:272 -#, python-brace-format +#: cmd/quickstart.py:309 msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Верзија пројекта" + +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Издање пројекта" + +#: cmd/quickstart.py:324 msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Језик пројекта" + +#: cmd/quickstart.py:340 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Суфикс изворне датотеке" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format -msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:531 +#, python-format +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "име пројекта" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "имена аутора" + +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "верзија пројекта" + +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "издање пројекта" + +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "језик пројекта" + +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "суфикс изворне датотеке" + +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "користи epub" + +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:671 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "enable %s extension" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/i18n.py:245 -#, python-format +#: cmd/quickstart.py:793 msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docfields.py:103 +#: cmd/quickstart.py:810 #, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +msgid "Invalid template variable: %s" msgstr "" -#: util/nodes.py:423 +#: directives/other.py:119 #, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/nodes.py:490 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "toctree contains ref to nonexisting file %r" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/nodes.py:706 +#: directives/other.py:156 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: directives/other.py:169 +#, python-format +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/display.py:87 -msgid "failed" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Аутор одељка: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Аутор модула: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Аутор кода: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Аутор: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: util/docutils.py:789 +#: directives/code.py:87 #, python-format -msgid "unknown node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: util/fileutil.py:76 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: util/fileutil.py:89 +#: directives/code.py:216 #, python-format -msgid "Writing evaluated template result to %s" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: util/rst.py:73 +#: directives/code.py:231 #, python-format -msgid "default role %s not found" +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/inventory.py:147 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: util/inventory.py:166 +#: directives/code.py:276 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "Object named %r not found in include file %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" -msgstr "[слика: %s]" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[слика]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1745,11 +2291,15 @@ msgstr "[слика]" msgid "Index" msgstr "Индекс" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "" @@ -1759,78 +2309,44 @@ msgstr "" msgid "unimplemented node type: %r" msgstr "" -#: writers/latex.py:361 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" +msgid "[image: %s]" +msgstr "[слика: %s]" -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[слика]" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: writers/latex.py:591 +#: writers/html5.py:431 #, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" +msgid "numfig_format is not defined for %s" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: writers/html5.py:441 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Any IDs not assigned for %s node" msgstr "" -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" +msgid "unsupported rubric heading level: %s" msgstr "" #: writers/html5.py:636 @@ -1849,794 +2365,478 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" - -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (уграђена функција)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s метода)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (класа)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (глобална променљива или константа)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (атрибут %s)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Аргументи" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Резултат" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Тип резултата" - -#: domains/javascript.py:370 +#: writers/latex.py:386 #, python-format -msgid "%s (module)" -msgstr "%s (модул)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "функција" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "метода" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "класа" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "атрибут" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "модул" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" - -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" - -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Измењено у верзији %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Застарело почевши од верзије %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" - -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" -msgstr "" - -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "" - -#: domains/rst.py:234 -msgid "directive" -msgstr "директива" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" - -#: domains/rst.py:236 -msgid "role" -msgstr "" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" - -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/citation.py:92 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "" - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Пажња" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Грешка" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Путоказ" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Важно" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Белешка" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Савет" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Упозорење" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:133 +#: writers/latex.py:616 #, python-format -msgid "Please enter one of %s." -msgstr "" - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "" - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:234 +#: writers/latex.py:1198 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:241 +#: writers/latex.py:1228 #, python-format -msgid "Selected root path: %s" -msgstr "" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "" - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Име пројекта" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Име(на) аутора" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Верзија пројекта" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Издање пројекта" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Језик пројекта" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Суфикс изворне датотеке" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:377 +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:526 +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:530 -#, python-format +#: transforms/i18n.py:275 +#, python-brace-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:537 +#: transforms/i18n.py:325 +#, python-brace-format msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:572 +#: transforms/i18n.py:347 +#, python-brace-format msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "име пројекта" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "имена аутора" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "верзија пројекта" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "издање пројекта" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "језик пројекта" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "суфикс изворне датотеке" - -#: cmd/quickstart.py:657 -msgid "master document name" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "користи epub" - -#: cmd/quickstart.py:663 -msgid "Extension options" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:670 +#: util/i18n.py:146 #, python-format -msgid "enable %s extension" +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:792 +#: util/nodes.py:462 +#, python-format msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:809 +#: util/nodes.py:523 #, python-format -msgid "Invalid template variable: %s" +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "настављено са претходне стране" -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "наставак на следећој страни" -#: cmd/build.py:103 -msgid "path to output directory" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Симболи" -#: cmd/build.py:114 -msgid "general options" -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Бројеви" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "страна" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Издање" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:157 +#: transforms/post_transforms/__init__.py:88 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Навигација" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Претрага" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/build.py:357 +#: themes/basic/layout.html:201 #, python-format -msgid "cannot open warning file '%s': %s" +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Претходни одељак" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "претходна глава" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "Садржај" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Следећи одељак" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Претрага" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "наредна глава" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Тражи" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Ова страница" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Изворни код" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Садржај" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Брза претрага" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Тражи" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2683,7 +2883,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2691,24 +2891,16 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Ова страница" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Садржај" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" +msgid "Search %(docstitle)s" msgstr "" -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Брза претрага" - #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" msgstr "" @@ -2717,57 +2909,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Претходни одељак" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "претходна глава" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Следећи одељак" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "наредна глава" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Навигација" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2784,21 +2925,21 @@ msgstr "" msgid "search" msgstr "тражи" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Садржај" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Резултати претраге" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2807,22 +2948,21 @@ msgstr[0] "" msgstr[1] "" msgstr[2] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Претражује се" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Припрема претраге..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", у " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2830,6 +2970,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Измене у верзији %(version)s — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2851,119 +2996,126 @@ msgstr "Друге измене" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 -msgid "Keyword-only parameters separator (PEP 3102)" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Параметри" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Променљиве" + +#: domains/python/_object.py:214 +msgid "Raises" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (у модулу %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (у модулу %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (уграђена променљива)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (уграђена класа)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (класа у %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (метода класе %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (статичка метода %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "модули" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Застарело" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "изузетак" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "метода класе" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "статичка метода" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Параметри" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Променљиве" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2975,746 +3127,526 @@ msgstr "" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "тип" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "променљива" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "променљива окружења; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "документ" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "погледајте %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "такође погледајте %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Симболи" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" - -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "" - -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" -msgstr "" - -#: transforms/post_transforms/__init__.py:305 -#, python-format -msgid "%r reference target not found: %s" -msgstr "" - -#: transforms/post_transforms/images.py:79 -#, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "" - -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:239 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: builders/html/__init__.py:348 +#: domains/std/__init__.py:319 #, python-format -msgid "Failed to read build info file: %r" +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "индекс" - -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "напред" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "назад" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:735 +msgid "document" +msgstr "документ" + +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1124 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1153 #, python-format -msgid "cannot copy static file %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:949 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy extra file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:955 +#: domains/std/__init__.py:1456 #, python-format -msgid "Failed to write build info file: %r" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:178 +#, python-format +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1224 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Пример" + +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Примери" + +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Белешке" + +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Упозорења" + +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:1360 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:93 #, python-format -msgid "%s %s documentation" -msgstr "документација %s %s" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "LaTeX датотеке су у %(outdir)s." +msgid "Would create file %s." +msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\nПокрените 'make' у том директоријуму да бисте их пропустили кроз (pdf)latex\n(или употребите `make latexpdf' овде да се то одради аутоматски)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Издање" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "настављено са претходне стране" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "наставак на следећој страни" +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "" + +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" + +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "суфикс датотеке (подразумевани: rst)" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Бројеви" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "страна" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:197 -#, python-format -msgid "malformed string literal (missing opening quote): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Пример" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Примери" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" +msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Белешке" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." +msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Упозорења" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3722,7 +3654,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3737,481 +3669,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "суфикс датотеке (подразумевани: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "(у %s)" + +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "%s is not a directory." +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:256 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" -msgstr "(у %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" -msgstr "(у %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "индекс" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "напред" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "назад" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "документација %s %s" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "LaTeX датотеке су у %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nПокрените 'make' у том директоријуму да бисте их пропустили кроз (pdf)latex\n(или употребите `make latexpdf' овде да се то одради аутоматски)." + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "погледајте %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "такође погледајте %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo b/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo index 842bb4b5de2..140dee7ea99 100644 Binary files a/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo and b/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo b/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo index b85fd378588..585d7246ff4 100644 Binary files a/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo and b/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/sv/LC_MESSAGES/sphinx.js b/sphinx/locale/sv/LC_MESSAGES/sphinx.js index 3458df2d4c9..8a0a2820272 100644 --- a/sphinx/locale/sv/LC_MESSAGES/sphinx.js +++ b/sphinx/locale/sv/LC_MESSAGES/sphinx.js @@ -1,63 +1,63 @@ Documentation.addTranslations({ "locale": "sv", "messages": { - "%(filename)s — %(docstitle)s": "", - "© %(copyright_prefix)s %(copyright)s.": "", - ", in ": "", + "%(filename)s — %(docstitle)s": "%(filename)s - %(docstitle)s", + "© %(copyright_prefix)s %(copyright)s.": "\u00a9 %(copyright_prefix)s %(copyright)s.", + ", in ": ", i ", "About these documents": "Om dessa dokument", - "Automatically generated list of changes in version %(version)s": "Automatiskt genererad lista \u00f6ver f\u00f6r\u00e4ndringar i version %(version)s", - "C API changes": "F\u00f6r\u00e4ndringar i C-API", - "Changes in Version %(version)s — %(docstitle)s": "", - "Collapse sidebar": "D\u00f6lj sidolist", - "Complete Table of Contents": "Komplett Inneh\u00e5llsf\u00f6rteckning", + "Automatically generated list of changes in version %(version)s": "Automatiskt genererad lista \u00f6ver \u00e4ndringar i version %(version)s", + "C API changes": "C API-\u00e4ndringar", + "Changes in Version %(version)s — %(docstitle)s": "\u00c4ndringar i version %(version)s - %(docstitle)s", + "Collapse sidebar": "D\u00f6lja sidof\u00e4ltet", + "Complete Table of Contents": "Fullst\u00e4ndig inneh\u00e5llsf\u00f6rteckning", "Contents": "Inneh\u00e5ll", - "Copyright": "Copyright", - "Created using Sphinx %(sphinx_version)s.": "", - "Expand sidebar": "Expandera sidolist", - "Full index on one page": "Hela inneh\u00e5llsf\u00f6rteckningen p\u00e5 en sida", - "General Index": "Huvudindex", - "Global Module Index": "Global Modulindex", - "Go": "G\u00e5", - "Hide Search Matches": "D\u00f6lj S\u00f6kresultat", + "Copyright": "Upphovsr\u00e4tt", + "Created using Sphinx %(sphinx_version)s.": "Skapad med hj\u00e4lp av Sphinx %(sphinx_version)s.", + "Expand sidebar": "Visa sidof\u00e4ltet", + "Full index on one page": "Fullst\u00e4ndigt index p\u00e5 en sida", + "General Index": "Allm\u00e4nt index", + "Global Module Index": "Globalt modulindex", + "Go": "Start", + "Hide Search Matches": "D\u00f6lj s\u00f6ktr\u00e4ffar", "Index": "Index", - "Index – %(key)s": "", - "Index pages by letter": "Inneh\u00e5llsf\u00f6rteckning per inledande bokstav", - "Indices and tables:": "Index och tabeller", - "Last updated on %(last_updated)s.": "Senast uppdaterad %(last_updated)s.", - "Library changes": "F\u00f6r\u00e4ndringar i bibliotek", - "Navigation": "Navigation", - "Next topic": "N\u00e4sta titel", - "Other changes": "\u00d6vriga f\u00f6r\u00e4ndringar", + "Index – %(key)s": "Index - %(key)s", + "Index pages by letter": "Indexsidor per bokstav", + "Indices and tables:": "Index och tabeller:", + "Last updated on %(last_updated)s.": "Senast uppdaterad den %(last_updated)s.", + "Library changes": "F\u00f6r\u00e4ndringar i biblioteket", + "Navigation": "Navigering", + "Next topic": "N\u00e4sta \u00e4mne", + "Other changes": "\u00d6vriga \u00e4ndringar", "Overview": "\u00d6versikt", - "Please activate JavaScript to enable the search\n functionality.": "Var god aktivera JavaScript f\u00f6r s\u00f6kfunktionalitet.", - "Preparing search...": "", - "Previous topic": "F\u00f6reg\u00e5ende titel", + "Please activate JavaScript to enable the search\n functionality.": "Aktivera JavaScript f\u00f6r att aktivera s\u00f6k-\n funktionalitet.", + "Preparing search...": "F\u00f6rbereder s\u00f6kning...", + "Previous topic": "F\u00f6reg\u00e5ende \u00e4mne", "Quick search": "Snabbs\u00f6k", "Search": "S\u00f6k", "Search Page": "S\u00f6ksida", "Search Results": "S\u00f6kresultat", "Search finished, found one page matching the search query.": [ - "", - "" + "S\u00f6kningen \u00e4r klar, hittade en sida som matchar s\u00f6kfr\u00e5gan.", + "S\u00f6kningen \u00e4r klar, hittade ${resultCount} sidor som matchar s\u00f6kfr\u00e5gan." ], - "Search within %(docstitle)s": "S\u00f6k bland %(docstitle)s", - "Searching": "", - "Searching for multiple words only shows matches that contain\n all words.": "", - "Show Source": "Visa k\u00e4llfil", - "Table of Contents": "", - "This Page": "Denna Sida", - "Welcome! This is": "", - "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", - "all functions, classes, terms": "alla funktioner, klasser, villkor", - "can be huge": "kan bli stort", - "last updated": "", - "lists all sections and subsections": "lista \u00f6ver alla paragrafer och underparagrafer", - "next chapter": "N\u00e4sta kapitel", - "previous chapter": "F\u00f6reg\u00e5ende kapitel", - "quick access to all modules": "genv\u00e4g till alla moduler", + "Search within %(docstitle)s": "S\u00f6k inom %(docstitle)s", + "Searching": "S\u00f6ker", + "Searching for multiple words only shows matches that contain\n all words.": "Vid s\u00f6kning efter flera ord visas endast matchningar som inneh\u00e5ller\n alla ord.", + "Show Source": "Visa k\u00e4lla", + "Table of Contents": "Inneh\u00e5ll", + "This Page": "Den h\u00e4r sidan", + "Welcome! This is": "V\u00e4lkomna! Det h\u00e4r \u00e4r", + "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Din s\u00f6kning matchade inte n\u00e5gra dokument. Kontrollera att alla ord \u00e4r r\u00e4ttstavade och att du har valt tillr\u00e4ckligt m\u00e5nga kategorier.", + "all functions, classes, terms": "alla funktioner, klasser, termer", + "can be huge": "kan vara enorma", + "last updated": "senast uppdaterad", + "lists all sections and subsections": "listar alla avsnitt och underavsnitt", + "next chapter": "n\u00e4sta kapitel", + "previous chapter": "f\u00f6reg\u00e5ende kapitel", + "quick access to all modules": "snabb \u00e5tkomst till alla moduler", "search": "s\u00f6k", - "search this documentation": "s\u00f6k i det h\u00e4r dokumentet", - "the documentation for": "" + "search this documentation": "s\u00f6k i denna dokumentation", + "the documentation for": "dokumentationen f\u00f6r" }, "plural_expr": "(n != 1)" }); \ No newline at end of file diff --git a/sphinx/locale/sv/LC_MESSAGES/sphinx.mo b/sphinx/locale/sv/LC_MESSAGES/sphinx.mo index b525fd60a3e..10d15210d8f 100644 Binary files a/sphinx/locale/sv/LC_MESSAGES/sphinx.mo and b/sphinx/locale/sv/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/sv/LC_MESSAGES/sphinx.po b/sphinx/locale/sv/LC_MESSAGES/sphinx.po index 1a87ce5e00d..7f798e178ec 100644 --- a/sphinx/locale/sv/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/sv/LC_MESSAGES/sphinx.po @@ -3,13 +3,14 @@ # This file is distributed under the same license as the Sphinx project. # # Translators: +# Daniel Nylander , 2025 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-04 06:45+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" -"Last-Translator: FULL NAME \n" +"Last-Translator: Daniel Nylander , 2025\n" "Language-Team: Swedish (http://app.transifex.com/sphinx-doc/sphinx-1/language/sv/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -18,762 +19,1227 @@ msgstr "" "Language: sv\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "Gemensamma sårbarheter och exponeringar; CVE %s" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "ogiltigt CVE-nummer %s" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "Gemensam svaghetsuppräkning; CWE %s" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "ogiltigt CWE-nummer %s" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Förslag till förbättringar av Python; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "ogiltigt PEP-nummer %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "ogiltigt RFC-nummer %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "Andra temakonfigurationsavsnitt än [theme] och [options] stöds inte (försökte få ett värde från %r)." + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "inställningen %s.%s förekommer inte i någon av de sökta temakonfigurationerna" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "temaalternativ som inte stöds %r ges" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "fil %r på temasökvägen är inte en giltig zip-fil eller innehåller inget tema" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "inget tema med namnet %r hittades (saknas theme.toml?)" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "Temat %r har cirkulär nedärvning" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "Temat %r ärver från %r, som inte är ett inläst tema. Inlästa teman är: %s" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "Temat %r har för många förfäder" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "ingen temakonfigurationsfil hittades i %r" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "tema %r har inte tabellen \"tema\"" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "Tabellen %r tema \"[tema]\" är inte en tabell" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "Temat %r måste definiera inställningen \"theme.inherit\"" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "Tabellen \"[alternativ]\" för temat %r är inte en tabell" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "Inställningen \"theme.pygments_style\" måste vara en tabell. Tips: \"%s\"" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "flera filer hittades för dokumentet \"%s\": %s\nAnvänd %r för att bygga." + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "Ignorerade oläsligt dokument %r." + #: extension.py:58 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." -msgstr "" +msgstr "Tillägget %s krävs av needs_extensions-inställningarna, men det är inte inläst." #: extension.py:79 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." -msgstr "" +msgstr "Detta projekt behöver tillägget %s åtminstone i version %s och kan därför inte byggas med den inlästa versionen (%s)." + +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Pygments lexernamn %r är inte känt" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "Lexing av literal_block %r som \"%s\" resulterade i ett fel vid token: %r. Försöker igen i avslappnat läge." + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Händelse %r redan närvarande" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Okänt händelsenamn: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "Handläggare %r för händelse %r gjorde ett undantag" -#: application.py:212 +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" -msgstr "" +msgstr "Det går inte att hitta källkatalogen (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" -msgstr "" +msgstr "Utdatakatalogen (%s) är inte en katalog" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" -msgstr "" +msgstr "Källkatalogen och destinationskatalogen kan inte vara identiska" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" -msgstr "" +msgstr "Kör Sphinx v%s" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." -msgstr "" +msgstr "Det här projektet kräver minst Sphinx v%s och kan därför inte byggas med den här versionen." -#: application.py:297 +#: application.py:305 msgid "making output directory" -msgstr "" +msgstr "skapa utdatakatalog" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" -msgstr "" +msgstr "medan inställning av tillägget %s:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." -msgstr "" +msgstr "'setup' som den för närvarande definieras i conf.py är inte en Python callable. Ändra dess definition så att den blir en anropsbar funktion. Detta behövs för att conf.py ska fungera som ett Sphinx-tillägg." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " -msgstr "" +msgstr "läser in översättningar [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" -msgstr "" +msgstr "klar" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" -msgstr "" +msgstr "inte tillgänglig för inbyggda meddelanden" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" -msgstr "" +msgstr "läser in pickled-miljö" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" -msgstr "" +msgstr "misslyckades: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" -msgstr "" +msgstr "Ingen byggare vald, standard används: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." -msgstr "" +msgstr "bygget färdigställdes med problem." -#: application.py:441 +#: application.py:457 msgid "build succeeded." -msgstr "" +msgstr "bygget lyckades." -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." -msgstr "" +msgstr "bygget avslutades med problem, 1 varning (med varningar som behandlas som fel)." -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." -msgstr "" +msgstr "bygget färdigt med problem, 1 varning." -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." -msgstr "" +msgstr "bygget lyckades, 1 varning." -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." -msgstr "" +msgstr "bygget avslutades med problem, %s varningar (med varningar som behandlas som fel)." -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." -msgstr "" +msgstr "bygget slutfördes med problem, %s varningar." -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." -msgstr "" +msgstr "bygget lyckades, %s varningar." -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" -msgstr "" +msgstr "nodklass %r är redan registrerad, dess besökare kommer att åsidosättas" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" -msgstr "" +msgstr "direktiv %r är redan registrerat och kommer inte att åsidosättas" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" -msgstr "" +msgstr "roll %r är redan registrerad och kommer inte att åsidosättas" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" -msgstr "" +msgstr "tillägget %s deklarerar inte om det är säkert för parallell läsning, förutsatt att det inte är det - be tilläggets författare att kontrollera och göra det explicit" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" -msgstr "" +msgstr "%s\\-tillägget är inte säkert för parallell läsning" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" -msgstr "" +msgstr "tillägget %s deklarerar inte om det är säkert för parallellskrivning, förutsatt att det inte är det - be tilläggets författare att kontrollera och göra det explicit" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" -msgstr "" +msgstr "%s\\-tillägget är inte säkert för parallellskrivning" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" -msgstr "" +msgstr "gör serie %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Byggarklassen %s har inget \"name\"-attribut" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Byggare %r finns redan (i modul %s)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Byggarens namn %s inte registrerat eller tillgängligt via ingångspunkten" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Byggarens namn %s inte registrerat" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "domän %s redan registrerad" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "domän %s ännu inte registrerad" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "Direktivet %r är redan registrerat på domänen %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "Rollen %r är redan registrerad på domänen %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "Indexet %r är redan registrerat på domänen %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "Objekttypen %r är redan registrerad" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "Crossref_type %r är redan registrerad" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r är redan registrerat" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "source_parser för %r är redan registrerad" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "Source parser för %s inte registrerad" -#: config.py:366 +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "Översättare för %r finns redan" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "kwargs för add_node() måste vara en (visit, depart) funktionstupel: %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r redan registrerad" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "math renderer %s är redan registrerad" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "" +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "tillägget %r var redan sammanslaget med Sphinx sedan version %s; detta tillägg ignoreras." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Ursprungligt undantag:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "Det gick inte att importera tillägget %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "tillägget %r har ingen setup()-funktion; är det verkligen en Sphinx-modul?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "Tillägget %s som används av detta projekt kräver minst Sphinx v%s; det kan därför inte byggas med denna version." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "tillägget %r returnerade ett objekt som inte stöds från sin setup()-funktion; den bör returnera None eller en metadatadictionary" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "`None` är inte en giltig filtyp för %r." + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "config-katalogen innehåller inte någon conf.py-fil (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" -msgstr "" +msgstr "'%s' måste vara '0' eller '1', fick '%s'" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" -msgstr "" +msgstr "kan inte åsidosätta konfigurationsinställningen för ordboken %r, ignorerar (använd %r för att ställa in enskilda element)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" -msgstr "" +msgstr "ogiltigt nummer %r för konfigurationsvärde %r, ignoreras" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" -msgstr "" +msgstr "kan inte åsidosätta konfigurationsinställningen %r med en typ som inte stöds, ignorerar" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" -msgstr "" +msgstr "okänt konfigurationsvärde %r i åsidosättande, ignoreras" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" -msgstr "" +msgstr "Inget sådant konfigurationsvärde: %r" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" -msgstr "" +msgstr "Konfigureringsvärde %r finns redan" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" -msgstr "" +msgstr "kan inte cachelagra ett konfigurationsvärde som inte kan plockas ut: %r (eftersom det innehåller ett funktions-, klass- eller modulobjekt)" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "Ogiltigt konfigurationsvärde hittades: 'language = None'. Uppdatera din konfiguration till en giltig språkkod. Återgår till 'en' (engelska)." + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" -msgstr "" +msgstr "Det finns ett syntaxfel i din konfigurationsfil: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" -msgstr "" +msgstr "Konfigurationsfilen (eller en av de moduler som den importerar) kallade sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" -msgstr "" +msgstr "Det finns ett programmerbart fel i din konfigurationsfil:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" -msgstr "" +msgstr "Misslyckades med att konvertera %r till en frozenset" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." -msgstr "" +msgstr "Konvertering av `source_suffix = %r` till `source_suffix = %r`." -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." -msgstr "" +msgstr "Konfigurationsvärdet `source_suffix' förväntar sig en ordbok, en sträng eller en lista med strängar. Fick `%r' istället (typ %s)." -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" -msgstr "" +msgstr "Sektion %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" -msgstr "" +msgstr "Fig. %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" -msgstr "" +msgstr "Tabell %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" -msgstr "" +msgstr "Listning %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." -msgstr "" +msgstr "Konfigurationsvärdet `{name}` måste vara ett av {candidates}, men `{current}` är givet." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." -msgstr "" +msgstr "Konfigurationsvärdet `{name}' har typen `{current.__name__}'; förväntat {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." -msgstr "" +msgstr "Konfigurationsvärdet `{name}' har typen `{current.__name__}', standard är `{default.__name__}'." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." -msgstr "" +msgstr "primary_domain %r hittades inte, ignoreras." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." -msgstr "" +msgstr "Sphinx använder nu \"index\" som huvuddokument som standard. För att behålla beteendet före 2.0, ställ in \"master_doc = 'contents'\"." -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "" - -#: highlighting.py:209 -#, python-format +#: config.py:892 msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "Stöd för andra källkodningar än UTF-8 är föråldrat och kommer att tas bort i Sphinx 10. Kommentera gärna på https://github.com/sphinx-doc/sphinx/issues/13665 om detta orsakar problem." -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "ny konfiguration" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "konfiguration ändrad" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "tillägg ändrade" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "byggmiljöversionen är inte aktuell" -#: theming.py:228 +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "källkatalogen har ändrats" + +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "" +msgid "The configuration has changed (1 option: %r)" +msgstr "Konfigurationen har ändrats (1 alternativ: %r)" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" -msgstr "" +msgid "The configuration has changed (%d options: %s)" +msgstr "Konfigurationen har ändrats (%d alternativ: %s)" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "Konfigurationen har ändrats (%d alternativ: %s, ...)" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Denna miljö är inte kompatibel med den valda byggaren, välj en annan doctree-katalog." -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "" +msgid "Failed to scan documents in %s: %r" +msgstr "Misslyckades med att skanna dokument i %s: %r" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" -msgstr "" +msgid "Domain %r is not registered" +msgstr "Domän %r är inte registrerad" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "dokumentet ingår inte i någon toctree" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "självrefererande toctree hittades. Ignoreras." -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgstr "dokumentet refereras till i flera toctrees: %s, urval: %s <- %s" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Observera" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Försiktighet" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Fara" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Fel" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Ledtråd" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +#: locale/__init__.py:234 +msgid "Important" +msgstr "Viktigt" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: locale/__init__.py:235 +msgid "Note" +msgstr "Anteckning" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "" +#: locale/__init__.py:236 +msgid "See also" +msgstr "Se även" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "" +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tips" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "" +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Varning" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" -msgstr "" +msgid "The Texinfo files are in %(outdir)s." +msgstr "Texinfo-filerna finns i %(outdir)s." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nKör 'make' i den katalogen för att köra dessa genom makeinfo\n(använd 'make info' här för att göra det automatiskt)." -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "inget konfigurationsvärde för \"texinfo_documents\" hittades; inga dokument kommer att skrivas" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "\"texinfo_documents\" konfigurationsvärde refererar till okänt dokument %s" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" -msgstr "" +msgid "processing %s" +msgstr "bearbetning %s" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" -msgstr "" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "skriver" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" -msgstr "" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "slår upp referenser..." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (i " -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" -msgstr "" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "kopierar bilder... " -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" -msgstr "" +msgid "cannot copy image file %r: %s" +msgstr "kan inte kopiera bildfilen %r: %s" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "kopierar Texinfo-stödfiler" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" -msgstr "" +msgid "error writing file Makefile: %s" +msgstr "fel vid skrivning av filen Makefile: %s" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "" +msgid "The manual pages are in %(outdir)s." +msgstr "Manualsidorna finns i %(outdir)s." -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" -msgstr "" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "inget konfigurationsvärde för \"man_pages\" hittades; inga manussidor kommer att skrivas" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" -msgstr "" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "\"man_pages\" konfigurationsvärde refererar till okänt dokument %s" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "" +msgid "The HTML page is in %(outdir)s." +msgstr "HTML-sidan finns i %(outdir)s." -#: registry.py:543 -msgid "Original exception:\n" -msgstr "" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "sammanställning av enstaka dokument" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr "" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "skriva ytterligare filer" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "Dummybyggaren genererar inga filer." -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "" +msgid "The message catalogs are in %(outdir)s." +msgstr "Meddelandekatalogerna finns i %(outdir)s." -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "" +msgid "building [%s]: " +msgstr "bygger [%s]: " -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." -msgstr "" +msgid "targets for %d template files" +msgstr "mål för %d mallfiler" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "läser mallar... " -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" -msgstr "" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "skriver meddelandekataloger... " -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Leta efter eventuella fel i ovanstående utdata eller i %(outdir)s/output.txt" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" -msgstr "" +msgid "broken link: %s (%s)" +msgstr "trasig länk: %s (%s)" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" +msgstr "Ankaret '%s' hittades inte" -#: roles.py:317 +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "linkcheck_allowed_redirects. Förväntade sig en ordbok." + +#: builders/linkcheck.py:799 #, python-format -msgid "invalid PEP number %s" -msgstr "" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "Misslyckades med att kompilera regex i linkcheck_allowed_redirects: %r %s" -#: roles.py:355 +#: builders/epub3.py:83 #, python-format -msgid "invalid RFC number %s" -msgstr "" +msgid "The ePub file is in %(outdir)s." +msgstr "EPub-filen finns i %(outdir)s." -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[source]" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "skriva nav.xhtml-filen..." -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "conf-värdet \"epub_language\" (eller \"language\") ska inte vara tomt för EPUB3" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[docs]" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "conf-värdet \"epub_uid\" ska vara XML NAME för EPUB3" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Modulkällkod" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "conf-värdet \"epub_title\" (eller \"html_title\") ska inte vara tomt för EPUB3" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " -msgstr "

        Källkod för %s

        " +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "conf-värdet \"epub_author\" ska inte vara tomt för EPUB3" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Översikt: modulkällkod" +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "conf-värdet \"epub_contributor\" ska inte vara tomt för EPUB3" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Alla moduler där källkod finns

        " +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "conf-värdet \"epub_description\" ska inte vara tomt för EPUB3" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "conf-värdet \"epub_publisher\" ska inte vara tomt för EPUB3" -#: ext/autosectionlabel.py:52 +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "conf-värdet \"epub_copyright\" (eller \"copyright\") ska inte vara tomt för EPUB3" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "conf-värdet \"epub_identifier\" ska inte vara tomt för EPUB3" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "conf-värdet \"version\" ska inte vara tomt för EPUB3" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "" +msgid "invalid css_file: %r, ignored" +msgstr "ogiltig css_fil: %r, ignorerad" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/xml.py:29 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "" +msgid "The XML files are in %(outdir)s." +msgstr "XML-filerna finns i %(outdir)s." -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "" +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 +#, python-format +msgid "error writing file %s: %s" +msgstr "fel vid skrivning av fil %s: %s" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Pseudo-XML-filerna finns i %(outdir)s." -#: ext/doctest.py:118 +#: builders/_epub_base.py:223 #, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "" +msgid "duplicated ToC entry found: %s" +msgstr "duplicerad ToC-post hittades: %s" -#: ext/doctest.py:124 +#: builders/_epub_base.py:436 #, python-format -msgid "'%s' is not a valid option." -msgstr "" +msgid "cannot read image file %r: copying it instead" +msgstr "kan inte läsa bildfilen %r: kopiera den istället" -#: ext/doctest.py:139 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "" +msgid "cannot write image file %r: %s" +msgstr "kan inte skriva bildfil %r: %s" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Pillow hittades inte - kopiering av bildfiler" -#: ext/doctest.py:297 +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "skriva mimetype-fil ..." + +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "skriver filen META-INF/container.xml..." + +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "skriva innehåll.opf-fil..." + +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "okänd mimetype för %s, ignorerar" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "noden har en ogiltig nivå" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "skriver filen toc.ncx..." + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "skriver %s fil ..." + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "Textfilerna finns i %(outdir)s." + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "en lämplig bild för %s byggare hittades inte: %s (%s)" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "en lämplig bild för %s byggare hittades inte: %s" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "bygger [mo]: " + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "skriver utdata... " + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "alla %d po-filer" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "mål för %d po-filer som anges" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "mål för %d po-filer som är föråldrade" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "alla källfiler" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "filen %r som anges på kommandoraden finns inte, " + +#: builders/__init__.py:342 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "filen %r som anges på kommandoraden finns inte i källkatalogen, ignoreras" -#: ext/doctest.py:457 +#: builders/__init__.py:353 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "fil %r som anges på kommandoraden är inte ett giltigt dokument, ignoreras" -#: ext/doctest.py:568 +#: builders/__init__.py:366 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "" +msgid "%d source files given on command line" +msgstr "%d källfiler anges på kommandoraden" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "mål för %d källfiler som är föråldrade" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "letar efter nu föråldrade filer... " + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "%d hittades" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "ingen hittades" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "miljö för betning" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "kontroll av konsistens" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "inga mål är inaktuella." + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "uppdaterar miljön: " + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "%s tillagd, %s ändrad, %s borttagen" -#: ext/imgmath.py:162 +#: builders/__init__.py:536 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "Sphinx kan inte läsa in huvuddokumentet (%s) eftersom det matchar ett inbyggt uteslutningsmönster %r. Flytta ditt masterdokument till en annan plats." -#: ext/imgmath.py:181 +#: builders/__init__.py:545 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "Sphinx kan inte läsa in huvuddokumentet (%s) eftersom det matchar ett uteslutningsmönster som anges i conf.py, %r. Ta bort detta mönster från conf.py." -#: ext/imgmath.py:344 +#: builders/__init__.py:556 #, python-format -msgid "display latex %r: %s" -msgstr "" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "Sphinx kan inte läsa in huvuddokumentet (%s) eftersom det inte ingår i det anpassade include_patterns = %r. Se till att ett mönster i include_patterns matchar huvuddokumentet." -#: ext/imgmath.py:380 +#: builders/__init__.py:563 #, python-format -msgid "inline latex %r: %s" -msgstr "" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "Sphinx kan inte läsa in huvuddokumentet (%s). Masterdokumentet måste finnas i källkatalogen eller en underkatalog till den." + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "läser källor... " + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "docnames att skriva: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "inga dokumentnamn att skriva!" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "förbereda dokument" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "kopiering av tillgångar" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "Översiktsfilen finns i %(outdir)s." + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "inga ändringar i version %s." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "skriva sammanfattande fil ..." + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Inbyggnader" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Modulnivå" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "kopierar källfiler ..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "kunde inte läsa %r för skapande av changelog" #: ext/coverage.py:48 #, python-format msgid "invalid regex %r in %s" -msgstr "" +msgstr "ogiltig regex %r i %s" #: ext/coverage.py:140 ext/coverage.py:301 #, python-format msgid "module %s could not be imported: %s" -msgstr "" +msgstr "modul %s kunde inte importeras: %s" #: ext/coverage.py:148 #, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" -msgstr "" +msgstr "följande moduler är dokumenterade men specificerades inte i coverage_modules: %s" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" -msgstr "" +"documented: %s" +msgstr "följande moduler anges i coverage_modules men dokumenterades inte: %s" #: ext/coverage.py:172 #, python-brace-format, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)s{sep}python.txt." -msgstr "" +msgstr "Testningen av täckningen i källorna är klar, titta på resultaten i %(outdir)s{sep}python.txt." #: ext/coverage.py:187 #, python-format msgid "invalid regex %r in coverage_c_regexes" -msgstr "" +msgstr "ogiltig regex %r i täckning_c_regexes" #: ext/coverage.py:260 #, python-format msgid "undocumented c api: %s [%s] in file %s" -msgstr "" +msgstr "odokumenterad c api: %s [%s] i fil %s" #: ext/coverage.py:452 #, python-format msgid "undocumented python function: %s :: %s" -msgstr "" +msgstr "odokumenterad python-funktion: %s :: %s" #: ext/coverage.py:473 #, python-format msgid "undocumented python class: %s :: %s" -msgstr "" +msgstr "odokumenterad pythonklass: %s :: %s" #: ext/coverage.py:492 #, python-format msgid "undocumented python method: %s :: %s :: %s" -msgstr "" +msgstr "odokumenterad python-metod: %s :: %s :: %s" + +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "hårdkodad länk %r kan ersättas av en extlänk (försök använda %r istället)" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Att göra" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "TODO-post hittades: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<> finns i %s, rad %d.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "ursprunglig post" #: ext/imgconverter.py:44 #, python-format @@ -781,7 +1247,7 @@ msgid "" "Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" "\n" "Traceback: %s" -msgstr "" +msgstr "Det går inte att köra kommandot för bildkonvertering %r. 'sphinx.ext.imgconverter' kräver ImageMagick som standard. Se till att det är installerat, eller sätt alternativet 'image_converter' till ett anpassat konverteringskommando.\n\nBakåtspårning: %s" #: ext/imgconverter.py:56 ext/imgconverter.py:90 #, python-format @@ -791,37 +1257,37 @@ msgid "" "%r\n" "[stdout]\n" "%r" -msgstr "" +msgstr "convert avslutades med fel:\n[stderr]\n%r\n[stdout]\n%r" #: ext/imgconverter.py:83 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "" +msgstr "convert-kommandot %r kan inte köras, kontrollera inställningen för image_converter" #: ext/graphviz.py:138 msgid "Graphviz directive cannot have both content and a filename argument" -msgstr "" +msgstr "Graphviz-direktivet kan inte ha både innehåll och ett filnamnsargument" #: ext/graphviz.py:153 #, python-format msgid "External Graphviz file %r not found or reading it failed" -msgstr "" +msgstr "Externa Graphviz-filen %r hittades inte eller så gick inte läsningen av den" #: ext/graphviz.py:164 msgid "Ignoring \"graphviz\" directive without content." -msgstr "" +msgstr "Ignorerar \"graphviz\"-direktivet utan innehåll." #: ext/graphviz.py:287 #, python-format msgid "graphviz_dot executable path must be set! %r" -msgstr "" +msgstr "graphviz_dot körbar sökväg måste ställas in! %r" #: ext/graphviz.py:328 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" -msgstr "" +msgstr "dot-kommandot %r kan inte köras (behövs för graphviz-utdata), kontrollera inställningen graphviz_dot" #: ext/graphviz.py:339 #, python-format @@ -831,7 +1297,7 @@ msgid "" "%r\n" "[stdout]\n" "%r" -msgstr "" +msgstr "dot avslutades med fel:\n[stderr]\n%r\n[stdout]\n%r" #: ext/graphviz.py:344 #, python-format @@ -841,900 +1307,981 @@ msgid "" "%r\n" "[stdout]\n" "%r" -msgstr "" +msgstr "dot producerade inte någon utdatafil:\n[stderr]\n%r\n[stdout]\n%r" #: ext/graphviz.py:367 #, python-format msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" -msgstr "" +msgstr "graphviz_output_format måste vara antingen 'png' eller 'svg', men är %r" #: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 #, python-format msgid "dot code %r: %s" -msgstr "" +msgstr "punktkod %r: %s" #: ext/graphviz.py:493 ext/graphviz.py:501 #, python-format msgid "[graph: %s]" -msgstr "" +msgstr "[graph: %s]" #: ext/graphviz.py:495 ext/graphviz.py:503 msgid "[graph]" -msgstr "" - -#: ext/todo.py:61 -msgid "Todo" -msgstr "Att göra" +msgstr "[graph]" -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" -msgstr "" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "LaTeX-kommandot %r kan inte köras (behövs för visning av matematik), kontrollera inställningen imgmath_latex" -#: ext/todo.py:152 -msgid "<>" -msgstr "" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s-kommandot %r kan inte köras (behövs för visning av matematik), kontrollera inställningen imgmath_%s" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "" +msgid "display latex %r: %s" +msgstr "visa latex %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "ursprungsvärde" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "inline latex %r: %s" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "Länk till denna ekvation" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" -msgstr "" +msgid "missing '+' or '-' in '%s' option." +msgstr "\"+\" eller \"-\" saknas i alternativet \"%s\"." -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "" +msgid "'%s' is not a valid option." +msgstr "'%s' är inte ett giltigt alternativ." -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' är inte ett giltigt pyversion-alternativ" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "ogiltig TestCode-typ" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "Testningen av doctests i källorna är klar, titta på resultaten i %(outdir)s/output.txt." -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "" +msgid "no code/output in %s block at %s:%s" +msgstr "ingen kod/utmatning i %s block vid %s:%s" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "" +msgid "ignoring invalid doctest code: %r" +msgstr "ignorerar ogiltig doctest-kod: %r" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "avsnitt \"%s\" blir märkt som \"%s\"" -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "" +msgid "duplicate label %s, other instance in %s" +msgstr "duplicerad etikett %s, annan instans i %s" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Sektionsförfattare" - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Modulförfattare" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "====================== långsammaste lästiderna =======================" -#: directives/other.py:207 -msgid "Code author: " -msgstr "Källkodsförfattare" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" +msgstr "%.3fs %s" -#: directives/other.py:209 -msgid "Author: " -msgstr "Upphovsman:" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[source]" -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr "" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "markerar modulkod... " -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr "" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[docs]" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." -msgstr "" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Modulkod" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." -msgstr "" +msgid "

        Source code for %s

        " +msgstr "

        Källkod för %s

        " -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Översikt: modulkod" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Inbyggda" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Alla moduler för vilka kod finns tillgänglig

        " -#: builders/changes.py:72 -msgid "Module level" -msgstr "Modulnivå" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" +msgstr "duplicerad citering %s, annan instans i %s" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "" +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." +msgstr "Citation [%s] är inte refererad." -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" -msgstr "" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "duplicerad etikett av ekvation %s, annan instans i %s" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" +msgid "Invalid math_eqref_format: %r" +msgstr "Ogiltigt math_eqref_format: %r" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (inbyggd funktion)" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s metod)" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "" +msgid "%s() (class)" +msgstr "%s() (klass)" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (global variabel eller konstant)" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s attribut)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Argument" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Kastar" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Returer" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Typ av retur" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "" +msgid "%s (module)" +msgstr "%s (modul)" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "funktion" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "metod" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "klass" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "data" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "attribut" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modul" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " -msgstr "" - -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "" +msgid "duplicate %s description of %s, other %s in %s" +msgstr "duplicera %s beskrivning av %s, annan %s i %s" -#: builders/__init__.py:410 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "%d found" -msgstr "" +msgid "%s (directive)" +msgstr "%s (direktiv)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "" +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr ":%s: (direktivalternativ)" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s (roll)" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "" +#: domains/rst.py:234 +msgid "directive" +msgstr "direktiv" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "" +#: domains/rst.py:235 +msgid "directive-option" +msgstr "direktiv-alternativ" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "" +#: domains/rst.py:236 +msgid "role" +msgstr "roll" -#: builders/__init__.py:494 +#: domains/rst.py:262 #, python-format -msgid "%s added, %s changed, %s removed" -msgstr "" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "duplicerad beskrivning av %s %s, annan instans i %s" -#: builders/__init__.py:531 +#: domains/changeset.py:32 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "" +msgid "Added in version %s" +msgstr "Tillagd i version %s" -#: builders/__init__.py:540 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "Changed in version %s" +msgstr "Ändrad i version %s" -#: builders/__init__.py:551 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "" +msgid "Deprecated since version %s" +msgstr "Föråldrad sedan version %s" -#: builders/__init__.py:558 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" - -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "" +msgid "Removed in version %s" +msgstr "Borttagen i version %s" -#: builders/__init__.py:713 +#: domains/__init__.py:322 #, python-format -msgid "docnames to write: %s" -msgstr "" +msgid "%s %s" +msgstr "%s %s" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "jobbnumret ska vara ett positivt tal" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "För mer information, besök ." -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\nGenerera dokumentation från källfiler.\n\nsphinx-build genererar dokumentation från filerna i SOURCEDIR och placerar den i\ni OUTPUTDIR. Den letar efter \"conf.py\" i SOURCEDIR för konfigurationsinställningarna\ninställningar. Verktyget 'sphinx-quickstart' kan användas för att generera mallfiler,\ninklusive 'conf.py'\n\nsphinx-build kan skapa dokumentation i olika format. Ett format väljs\nväljs genom att ange byggarens namn på kommandoraden; standardinställningen är\nHTML. Byggare kan också utföra andra uppgifter som är relaterade till dokumentations\nbearbetning.\n\nSom standard byggs allt som är föråldrat. Utdata endast för utvalda\nfiler kan byggas genom att ange enskilda filnamn.\n" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "sökväg till dokumentationens källfiler" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "sökväg till utdatakatalog" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "(valfritt) en lista med specifika filer som ska byggas om. Ignoreras om --write-all anges" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:114 +msgid "general options" +msgstr "allmänna alternativ" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "byggare att använda (standard: 'html')" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "körs parallellt med N processer, när så är möjligt. \"auto\" använder antalet CPU-kärnor" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "skriva alla filer (standard: endast nya och ändrade filer skrivs)" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "använd inte en sparad miljö, läs alltid alla filer" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:150 +msgid "path options" +msgstr "alternativ för sökväg" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "katalog för doctree- och miljöfiler (standard: OUTPUT_DIR/.doctrees)" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "katalog för konfigurationsfilen (conf.py) (standard: SOURCE_DIR)" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "använd ingen konfigurationsfil, använd bara inställningar från -D-alternativ" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "åsidosätta en inställning i konfigurationsfilen" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "skicka ett värde till HTML-mallar" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "definiera tagg: inkludera \"endast\" block med TAG" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "nitpicky mode: varna för alla saknade referenser" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "" +#: cmd/build.py:212 +msgid "console output options" +msgstr "alternativ för konsolutmatning" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "öka ordrikedomen (kan upprepas)" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "ingen utdata på stdout, bara varningar på stderr" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "ingen utdata alls, inte ens varningar" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "avge färgad utdata (standard: automatisk detektering)" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "avger inte färgade utdata (standard: automatisk detektering)" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "" +#: cmd/build.py:252 +msgid "warning control options" +msgstr "alternativ för varningskontroll" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr "(i " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "skriva varningar (och fel) till en given fil" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "omvandla varningar till fel" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "visa fullständig spårning av undantag" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "kör Pdb på undantag" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "" +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "skapa ett undantag vid varningar" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "kan inte kombinera alternativet -a och filnamn" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "" +msgid "cannot open warning file '%s': %s" +msgstr "kan inte öppna varningsfilen '%s': %s" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "-D alternativargumentet måste vara i formen name=value" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "-Ett option-argument måste vara i formen name=value" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "automatiskt infoga docstrings från moduler" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "automatiskt testa kodsnuttar i doctest-block" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "länk mellan Sphinx-dokumentation av olika projekt" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "skriva \"att göra\"-poster som kan visas eller döljas på byggplatsen" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "kontroll av dokumentationens täckning" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "inkludera matematik, återgiven som PNG- eller SVG-bilder" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "innehåller matematik, som återges i webbläsaren med MathJax" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "villkorlig inkludering av innehåll baserat på konfigurationsvärden" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "inkludera länkar till källkoden för dokumenterade Python-objekt" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "skapa .nojekyll-fil för att publicera dokumentet på GitHub-sidor" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Ange ett giltigt sökvägsnamn." -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Skriv in någon text." -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "" +msgid "Please enter one of %s." +msgstr "Ange ett av %s." -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Ange antingen 'y' eller 'n'." -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Ange ett filsuffix, t.ex. \".rst\" eller \".txt\"." -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "" +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Välkommen till Sphinx %s snabbstartverktyg." -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Ange värden för följande inställningar (tryck bara på Enter för att acceptera\nacceptera ett standardvärde, om ett sådant anges inom parentes)." -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" -msgstr "" +msgid "Selected root path: %s" +msgstr "Vald rotsökväg: %s" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Ange rotsökvägen för dokumentationen." -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Rotsökväg för dokumentationen" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Fel: en befintlig conf.py har hittats i den valda rotsökvägen." -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart kommer inte att skriva över befintliga Sphinx-projekt." -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Ange en ny rotsökväg (eller bara Enter för att avsluta)" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Du har två alternativ för att placera byggkatalogen för Sphinx-utdata.\nAntingen använder du en katalog \"_build\" i rotsökvägen, eller så separerar du\n\"source\" och \"build\" kataloger inom rotsökvägen." -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Separata käll- och byggkataloger (y/n)" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "" - -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" - -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "Inuti rotkatalogen kommer ytterligare två kataloger att skapas; \"_templates\"\nför egna HTML-mallar och \"_static\" för egna stilmallar och andra statiska\nfiler. Du kan ange ett annat prefix (t.ex. \".\") för att ersätta understrecket." -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Namnprefix för mallar och statisk dir" -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "Projektnamnet kommer att förekomma på flera ställen i den byggda dokumentationen." -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Projektnamn" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Författarens namn(en)" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "Sphinx har begreppet \"version\" och \"release\" för programvaran\nprogramvaran. Varje version kan ha flera utgåvor. Till exempel för\nPython är versionen något i stil med 2.5 eller 3.0, medan releasen är\nnågot i stil med 2.5.1 eller 3.0a1. Om du inte behöver den här dubbla strukturen,\nsätt bara båda till samma värde." -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Projektversion" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Projektrelease" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" - -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "Om dokumenten ska skrivas på ett annat språk än engelska,\nkan du här välja ett språk med hjälp av dess språkkod. Sphinx kommer då att\növersätta text som den genererar till det språket.\n\nFör en lista över koder som stöds, se\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Projektspråk" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "Filnamnssuffixet för källfiler. Vanligtvis är detta antingen \".txt\"\neller \".rst\". Endast filer med detta suffix betraktas som dokument." -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Suffix för källfil" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "Ett dokument är speciellt på så sätt att det betraktas som den översta noden i\n\"innehållsträdet\", det vill säga det är roten till den hierarkiska strukturen\nav dokumenten. Normalt är detta \"index\", men om ditt \"index\"-dokument\ndokument är en anpassad mall kan du också ange ett annat filnamn." -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Namnet på ditt huvuddokument (utan suffix)" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Fel: Masterfilen %s har redan hittats på den valda rotsökvägen." -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart kommer inte att skriva över den befintliga filen." -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Ange ett nytt filnamn eller byt namn på en befintlig fil och tryck på Enter" -#: environment/__init__.py:86 -msgid "new config" -msgstr "" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Ange vilka av följande Sphinx-tillägg som ska aktiveras:" -#: environment/__init__.py:87 -msgid "config changed" -msgstr "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Obs: imgmath och mathjax kan inte aktiveras samtidigt. imgmath har valts bort." -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "En Makefile och en Windows-kommandofil kan genereras åt dig så att du bara behöver\nbara behöver köra t.ex. `make html' istället för att anropa sphinx-build\ndirekt." -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Skapa Makefile? (ja/nej)" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Skapa Windows-kommandofil? (ja/nej)" -#: environment/__init__.py:325 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +msgid "Creating file %s." +msgstr "Skapar fil %s." -#: environment/__init__.py:330 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" +msgid "File %s already exists, skipping." +msgstr "Fil %s finns redan, hoppar över." -#: environment/__init__.py:336 +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Färdigställt: En första katalogstruktur har skapats." + +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Du ska nu fylla på din masterfil %s och skapa andra källfiler för\ndokumentationen. " -#: environment/__init__.py:379 +#: cmd/quickstart.py:527 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Använd Makefile för att bygga dokumenten, så här:\n make byggare" -#: environment/__init__.py:493 +#: cmd/quickstart.py:531 #, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Använd kommandot sphinx-build för att bygga dokumenten, så här:\n sphinx-build -b byggare %s %s" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "där \"builder\" är en av de byggare som stöds, t.ex. html, latex eller linkcheck." -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nGenerera nödvändiga filer för ett Sphinx-projekt.\n\nsphinx-quickstart är ett interaktivt verktyg som ställer några frågor om ditt\nprojekt och sedan genererar en komplett dokumentationskatalog och ett exempel\nMakefile som kan användas med sphinx-build.\n" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "tyst läge" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "projektrot" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Strukturalternativ" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "om angivet, separata käll- och byggkataloger" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "om det anges, skapa byggkatalog under källkatalog" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "ersättning för punkt i _templates etc." -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Projektets grundläggande alternativ" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "projektets namn" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "författarnamn" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "version av projektet" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "frisläppande av projekt" -#: util/display.py:82 -msgid "skipped" -msgstr "" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "dokumentspråk" -#: util/display.py:87 -msgid "failed" -msgstr "" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "suffix för källfil" -#: util/osutil.py:131 +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "masterdokumentets namn" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "använda epub" + +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Alternativ för tillägg" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "aktivera tillägget %s" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "aktivera godtyckliga tillägg" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Skapande av Makefile och Batchfile" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "skapa makefile" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "skapa inte makefile" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "skapa batchfil" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "skapa inte batchfil" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "använda make-mode för Makefile/make.bat" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Templating av projekt" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "mallkatalog för mallfiler" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "definiera en mallvariabel" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "\"quiet\" är specificerat, men något av \"project\" eller \"author\" är inte specificerat." + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Fel: angiven sökväg är inte en katalog, eller så finns det redan sphinx-filer." + +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart genererar bara till en tom katalog. Ange en ny rotsökväg." -#: util/docutils.py:309 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown directive name: %s" -msgstr "" +msgid "Invalid template variable: %s" +msgstr "Ogiltig mallvariabel: %s" -#: util/docutils.py:345 +#: directives/other.py:119 #, python-format -msgid "unknown role name: %s" -msgstr "" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "toctree glob mönster %r matchade inga dokument" -#: util/docutils.py:789 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "unknown node type: %r" -msgstr "" +msgid "toctree contains reference to excluded document %r" +msgstr "toctree innehåller referens till exkluderat dokument %r" -#: util/fileutil.py:76 +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" +msgstr "toctree innehåller referens till icke-existerande dokument %r" + +#: directives/other.py:169 #, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "duplicerad post hittades i toctree: %s" + +#: directives/other.py:203 +msgid "Section author: " +msgstr "Kapitelförfattare: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Modulförfattare: " + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Källkodsförfattare: " + +#: directives/other.py:209 +msgid "Author: " +msgstr "Upphovsperson: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "... acks innehåll är inte en lista" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "... hlist-innehåll är inte en lista" + +#: directives/patches.py:70 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "alternativet \":file:\" för direktivet csv-table känner nu igen en absolut sökväg som en relativ sökväg från källkatalogen. Uppdatera ditt dokument." -#: util/fileutil.py:89 +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "icke-blanksteg strippat av dedent" + +#: directives/code.py:87 #, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +msgid "Invalid caption: %s" +msgstr "Ogiltig bildtext: %s" -#: util/rst.py:73 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "default role %s not found" -msgstr "" +msgid "line number spec is out of range(1-%d): %r" +msgstr "radnummer spec är utanför intervallet (1-%d): %r" -#: util/inventory.py:147 +#: directives/code.py:216 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Kan inte använda både alternativen \"%s\" och \"%s\"" -#: util/inventory.py:166 +#: directives/code.py:231 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" +msgid "Include file '%s' not found or reading it failed" +msgstr "Include-filen '%s' hittades inte eller läsningen av den misslyckades" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Fotnoter" +#: directives/code.py:235 +#, python-format +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "Kodning %r som används för att läsa den inkluderade filen '%s' verkar vara fel, försök att ange ett :encoding: alternativ" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:276 #, python-format -msgid "[image: %s]" -msgstr "" +msgid "Object named %r not found in include file %r" +msgstr "Objekt med namnet %r hittades inte i include-filen %r" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[image]" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "Det går inte att använda \"lineno-match\" med en disjunkt uppsättning \"linjer\"" + +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Radspecifikation %r: inga rader hämtade från include-filen %r" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1743,2035 +2290,1142 @@ msgstr "[image]" msgid "Index" msgstr "Index" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" +msgstr "påträffad titelnod inte i avsnitt, ämne, tabell, uppmaning eller sidofält" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Fotnoter" #: writers/texinfo.py:1217 msgid "caption not inside a figure." -msgstr "" +msgstr "bildtext inte inuti en figur." #: writers/texinfo.py:1303 #, python-format msgid "unimplemented node type: %r" -msgstr "" - -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" +msgstr "oimplementerad nodtyp: %r" -#: writers/latex.py:1939 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "unknown index entry type %s found" -msgstr "" +msgid "[image: %s]" +msgstr "[image: %s]" -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[image]" #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" -msgstr "" +msgstr "Länk till denna definition" #: writers/html5.py:431 #, python-format msgid "numfig_format is not defined for %s" -msgstr "" +msgstr "numfig_format är inte definierat för %s" #: writers/html5.py:441 #, python-format msgid "Any IDs not assigned for %s node" -msgstr "" +msgstr "Alla ID som inte tilldelats för %s-noden" #: writers/html5.py:496 msgid "Link to this term" -msgstr "" +msgstr "Länk till denna termin" #: writers/html5.py:548 writers/html5.py:553 msgid "Link to this heading" -msgstr "" +msgstr "Länk till denna rubrik" #: writers/html5.py:558 msgid "Link to this table" -msgstr "" +msgstr "Länk till detta bord" + +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "rubricering utan stöd rubriknivå: %s" #: writers/html5.py:636 msgid "Link to this code" -msgstr "" +msgstr "Länk till denna kod" #: writers/html5.py:638 msgid "Link to this image" -msgstr "" +msgstr "Länk till denna bild" #: writers/html5.py:640 msgid "Link to this toctree" -msgstr "" +msgstr "Länk till detta toctree" #: writers/html5.py:766 msgid "Could not obtain image size. :scale: option is ignored." -msgstr "" +msgstr "Det gick inte att få fram bildstorleken. :scale: alternativet ignoreras." -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "okänd %r toplevel_sectioning för klass %r" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "" +msgid "no Babel option known for language %r" +msgstr "inget Babel-alternativ känt för språk %r" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (inbyggd funktion)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "för stor :maxdepth:, ignoreras." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s metod)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "mallen %s hittades inte; läser in från legacy %s istället" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "dokumenttiteln är inte en enda textnod" + +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "både tabularcolumns och alternativet :widths: anges. :widths: ignoreras." -#: domains/javascript.py:185 +#: writers/latex.py:1228 #, python-format -msgid "%s() (class)" -msgstr "%s() (klass)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "colspec %s gavs som verkar använda tabulär syntax. Men denna tabell kan inte återges som en tabulary; den angivna colspec kommer att ignoreras." -#: domains/javascript.py:187 +#: writers/latex.py:1615 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s (global variabel eller konstant)" +msgid "dimension unit %s is invalid. Ignored." +msgstr "dimensionsenheten %s är ogiltig. Ignoreras." -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1950 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s attribut)" +msgid "unknown index entry type %s found" +msgstr "okänd indexposttyp %s hittades" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Argument" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "Användning:" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Kastar" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "{0} [ALTERNATIV] []" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Returnerar" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr " Sphinx dokumentationsgenerator." -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Returtyp" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "Kommandon:" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (modul)" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "Alternativ" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "funktion" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "För mer information, besök https://www.sphinx-doc.org/en/master/man/." -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "metod" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "{0}: fel: {1}\nKör '{0} --help' för information" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "klass" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr " Hantera dokumentation med Sphinx." -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "data" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "Visa versionen och avsluta." -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "attribut" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "Visa detta meddelande och avsluta." -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modul" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "Loggning" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "Öka ordrikedomen (kan upprepas)" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" -msgstr "" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "Skriv bara ut fel och varningar." -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Förändrat i version %s" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "Ingen utmatning alls" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Ersatt sedan version %s" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" -msgstr "" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "Se \"sphinx --help\".\n" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (direktiv)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "inkonsekventa fotnotreferenser i översatt meddelande. original: {0}, översatt: {1}" -#: domains/rst.py:191 domains/rst.py:202 +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "inkonsekventa referenser i översatt meddelande. original: {0}, översatt: {1}" + +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "inkonsekventa källhänvisningar i översatt meddelande. original: {0}, översatt: {1}" + +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "inkonsekventa termreferenser i översatt meddelande. original: {0}, översatt: {1}" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "kunde inte beräkna översättningens framsteg!" + +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "inga översatta element!" + +#: transforms/__init__.py:258 #, python-format -msgid ":%s: (directive option)" -msgstr "" +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "4 kolumnbaserade index hittades. Det kan vara en bugg i de tillägg du använder: %r" -#: domains/rst.py:224 +#: transforms/__init__.py:299 #, python-format -msgid "%s (role)" -msgstr "%s (roll)" +msgid "Footnote [%s] is not referenced." +msgstr "Fotnot [%s] är inte refererad." -#: domains/rst.py:234 -msgid "directive" -msgstr "direktiv" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "Fotnot [*] är inte refererad." -#: domains/rst.py:235 -msgid "directive-option" -msgstr "" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "Fotnot [#] är inte refererad." -#: domains/rst.py:236 -msgid "role" -msgstr "roll" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "inventering <%s> innehåller duplicerade definitioner av %s" -#: domains/rst.py:262 +#: util/inventory.py:166 #, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "" +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "inventering <%s> innehåller flera definitioner för %s" -#: domains/citation.py:75 +#: util/i18n.py:100 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "" +msgid "reading error: %s, %s" +msgstr "läsfel: %s, %s" -#: domains/citation.py:92 +#: util/i18n.py:113 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "" +msgid "writing error: %s, %s" +msgstr "skrivfel: %s, %s" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Uppmärksamma" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "locale_dir %s finns inte" -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Varning" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "Ogiltig Babel-lokal: %r." -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Risk" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "Ogiltigt datumformat. Citera strängen med enkla citattecken om du vill skriva ut den direkt: %s" -#: locale/__init__.py:231 -msgid "Error" -msgstr "Fel" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "Avbrutet kopieringsförsök från %s till %s (målbanan har befintliga data)." -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Råd" +#: util/display.py:82 +msgid "skipped" +msgstr "hoppades över" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Viktigt" +#: util/display.py:87 +msgid "failed" +msgstr "misslyckades" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Observera" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "okänt direktivnamn: %s" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Se även" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "okänt rollnamn: %s" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tips" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "okänd nodtyp: %r" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Varning" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "Försök till kopiering från renderad mall %s till %s avbröts (destinationssökvägen har befintliga data)." -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" +msgstr "Skriva utvärderat mallresultat till %s" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "Problem i %s-domänen: fältet ska använda rollen '%s', men den rollen finns inte i domänen." -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "standardroll %s hittades inte" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "toctree innehåller ref till icke-existerande fil %r" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "undantag vid utvärdering av endast direktivuttryck: %s" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "fortsättning från föregående sida" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "fortsätter på nästa sida" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "Icke alfabetisk" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Symboler" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Nummer" -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "sida" -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Släpp" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "Kunde inte hämta fjärrbild: %s [%s]" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "Kunde inte hämta fjärrbild: %s [%d]" -#: cmd/quickstart.py:229 +#: transforms/post_transforms/images.py:143 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "" +msgid "Unknown image format: %s..." +msgstr "Okänt bildformat: %s..." -#: cmd/quickstart.py:234 +#: transforms/post_transforms/__init__.py:88 msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "Det gick inte att fastställa fallback-texten för korsreferensen. Kan vara en bugg." -#: cmd/quickstart.py:241 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "Selected root path: %s" -msgstr "" +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "mer än ett mål hittades för 'any' korsreferens %r: kan vara %s" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s referensmål hittades inte: %s" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r referensmål hittades inte: %s" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "Avbruten!" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "" - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "" - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "" - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "" - -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "" - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "" - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "" - -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." -msgstr "" - -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "" - -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "" - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "" - -#: cmd/quickstart.py:530 -#, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "" - -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "" - -#: cmd/quickstart.py:809 -#, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "" - -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "" - -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "" - -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" - -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "" - -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "Dölj sidolist" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" - -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "Sök" - -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Gå" - -#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 -msgid "Show Source" -msgstr "Visa källfil" - -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Innehåll" - -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Sök %(docstitle)s" - -#: themes/basic/defindex.html:4 -msgid "Overview" -msgstr "Översikt" - -#: themes/basic/defindex.html:8 -msgid "Welcome! This is" -msgstr "" - -#: themes/basic/defindex.html:9 -msgid "the documentation for" -msgstr "" - -#: themes/basic/defindex.html:10 -msgid "last updated" -msgstr "" - -#: themes/basic/defindex.html:13 -msgid "Indices and tables:" -msgstr "Index och tabeller" - -#: themes/basic/defindex.html:16 -msgid "Complete Table of Contents" -msgstr "Komplett Innehållsförteckning" - -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "lista över alla paragrafer och underparagrafer" - -#: domains/std/__init__.py:773 domains/std/__init__.py:786 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "Söksida" - -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "sök i det här dokumentet" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "Global Modulindex" - -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "genväg till alla moduler" - -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Huvudindex" - -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "alla funktioner, klasser, villkor" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Denna Sida" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Hela innehållsförteckningen på en sida" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Snabbsök" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Innehållsförteckning per inledande bokstav" - -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "kan bli stort" - -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Föregående titel" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "Föregående kapitel" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Nästa titel" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "Nästa kapitel" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Navigation" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Sök bland %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Om dessa dokument" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Copyright" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Senast uppdaterad %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - -#: themes/basic/search.html:20 -msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." -msgstr "Var god aktivera JavaScript för sökfunktionalitet." - -#: themes/basic/search.html:28 -msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." -msgstr "" - -#: themes/basic/search.html:35 -msgid "search" -msgstr "sök" - -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Dölj Sökresultat" - -#: themes/basic/static/searchtools.js:117 -msgid "Search Results" -msgstr "Sökresultat" - -#: themes/basic/static/searchtools.js:119 -msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." -msgstr "" - -#: themes/basic/static/searchtools.js:123 -#, python-brace-format -msgid "Search finished, found one page matching the search query." -msgid_plural "" -"Search finished, found ${resultCount} pages matching the search query." -msgstr[0] "" -msgstr[1] "" - -#: themes/basic/static/searchtools.js:253 -msgid "Searching" -msgstr "" - -#: themes/basic/static/searchtools.js:270 -msgid "Preparing search..." -msgstr "" - -#: themes/basic/static/searchtools.js:474 -msgid ", in " -msgstr "" - -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" - -#: themes/basic/changes/frameset.html:5 -#: themes/basic/changes/versionchanges.html:12 -#, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "" - -#: themes/basic/changes/versionchanges.html:17 -#, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "Automatiskt genererad lista över förändringar i version %(version)s" - -#: themes/basic/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "Förändringar i bibliotek" - -#: themes/basic/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "Förändringar i C-API" - -#: themes/basic/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "Övriga förändringar" - -#: themes/classic/static/sidebar.js.jinja:42 -msgid "Expand sidebar" -msgstr "Expandera sidolist" - -#: domains/python/_annotations.py:529 -msgid "Positional-only parameter separator (PEP 570)" -msgstr "" - -#: domains/python/_annotations.py:540 -msgid "Keyword-only parameters separator (PEP 3102)" -msgstr "" - -#: domains/python/__init__.py:113 domains/python/__init__.py:278 -#, python-format -msgid "%s() (in module %s)" -msgstr "%s() (i modul %s)" - -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 -#, python-format -msgid "%s (in module %s)" -msgstr "%s (i modul %s)" - -#: domains/python/__init__.py:182 -#, python-format -msgid "%s (built-in variable)" -msgstr "%s (inbyggd variabel)" - -#: domains/python/__init__.py:217 -#, python-format -msgid "%s (built-in class)" -msgstr "%s (inbyggd klass)" - -#: domains/python/__init__.py:218 -#, python-format -msgid "%s (class in %s)" -msgstr "%s (klass i %s)" - -#: domains/python/__init__.py:283 -#, python-format -msgid "%s() (%s class method)" -msgstr "%s() (%s klassmetod)" - -#: domains/python/__init__.py:285 -#, python-format -msgid "%s() (%s static method)" -msgstr "%s() (%s statisk metod)" - -#: domains/python/__init__.py:438 -#, python-format -msgid "%s (%s property)" -msgstr "" - -#: domains/python/__init__.py:478 -#, python-format -msgid "%s (type alias in %s)" -msgstr "" - -#: domains/python/__init__.py:638 -msgid "Python Module Index" -msgstr "Python Modulindex" - -#: domains/python/__init__.py:639 -msgid "modules" -msgstr "moduler" - -#: domains/python/__init__.py:717 -msgid "Deprecated" -msgstr "Ersatt" - -#: domains/python/__init__.py:743 -msgid "exception" -msgstr "undantag" - -#: domains/python/__init__.py:745 -msgid "class method" -msgstr "klassmetod" - -#: domains/python/__init__.py:746 -msgid "static method" -msgstr "statisk metod" - -#: domains/python/__init__.py:748 -msgid "property" -msgstr "" - -#: domains/python/__init__.py:749 -msgid "type alias" -msgstr "" - -#: domains/python/__init__.py:818 -#, python-format -msgid "" -"duplicate object description of %s, other instance in %s, use :no-index: for" -" one of them" -msgstr "" - -#: domains/python/__init__.py:978 -#, python-format -msgid "more than one target found for cross-reference %r: %s" -msgstr "" - -#: domains/python/__init__.py:1052 -msgid " (deprecated)" -msgstr "" - -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametrar" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Variabler" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Väcker" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "reStructuredText markeringsfel!" -#: domains/cpp/__init__.py:159 -msgid "Template Parameters" -msgstr "" +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "Kodningsfel!" -#: domains/cpp/__init__.py:302 -#, python-format -msgid "%s (C++ %s)" -msgstr "" +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "Rekursionsfel!" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "Detta kan hända med mycket stora eller djupt nästlade källfiler. Du kan försiktigt öka Pythons standardgräns för rekursion på 1 000 i conf.py med t.ex:" -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 -msgid "Return values" -msgstr "" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "Startar felsökningsverktyget:" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 -msgid "union" -msgstr "" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "Den fullständiga spårningen har sparats i:" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 -msgid "member" -msgstr "medlem" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "För att rapportera detta fel till utvecklarna, öppna ett ärende på . Tack så mycket!" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 -msgid "type" -msgstr "typ" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Rapportera även detta om det var ett användarfel, så att ett bättre felmeddelande kan tillhandahållas nästa gång." -#: domains/cpp/__init__.py:944 -msgid "concept" -msgstr "" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "Dölja sidofältet" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 -msgid "enum" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Navigering" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 -msgid "enumerator" -msgstr "" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Sök inom %(docstitle)s" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 -msgid "function parameter" -msgstr "" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Om dessa dokument" -#: domains/cpp/__init__.py:952 -msgid "template parameter" -msgstr "" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "Sök" -#: domains/c/__init__.py:211 +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Upphovsrätt" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "%s (C %s)" -msgstr "" +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Senast uppdaterad den %(last_updated)s." + +#: themes/basic/layout.html:204 #, python-format msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." -msgstr "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "Skapad med hjälp av Sphinx %(sphinx_version)s." -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "variabel" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Föregående ämne" -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "makro" +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "föregående kapitel" -#: domains/c/__init__.py:753 -msgid "struct" -msgstr "" +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Nästa ämne" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "miljövariabel; %s" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "nästa kapitel" -#: domains/std/__init__.py:119 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" +msgid "Index – %(key)s" +msgstr "Index - %(key)s" -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Fullständigt index på en sida" -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Den här sidan" -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "Visa källa" -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Snabbsök" -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Start" -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" +#: themes/basic/defindex.html:4 +msgid "Overview" +msgstr "Översikt" -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" +msgstr "Välkomna! Det här är" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "ordlista" +#: themes/basic/defindex.html:9 +msgid "the documentation for" +msgstr "dokumentationen för" -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "grammatisk token" +#: themes/basic/defindex.html:10 +msgid "last updated" +msgstr "senast uppdaterad" -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "referensetikett" +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" +msgstr "Index och tabeller:" -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "miljövariabel" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "Fullständig innehållsförteckning" -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "programväxel" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "listar alla avsnitt och underavsnitt" -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "Söksida" -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Modulindex" +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "sök i denna dokumentation" -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "Globalt modulindex" -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "snabb åtkomst till alla moduler" -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Allmänt index" -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "alla funktioner, klasser, termer" -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "Innehåll" -#: domains/std/__init__.py:1157 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "invalid numfig_format: %s" -msgstr "" +msgid "Search %(docstitle)s" +msgstr "Sök %(docstitle)s" -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Indexsidor per bokstav" -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "kan vara enorma" -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" +#: themes/basic/search.html:20 +msgid "" +"Please activate JavaScript to enable the search\n" +" functionality." +msgstr "Aktivera JavaScript för att aktivera sök-\n funktionalitet." -#: environment/adapters/toctree.py:349 -#, python-format +#: themes/basic/search.html:28 msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" +"Searching for multiple words only shows matches that contain\n" +" all words." +msgstr "Vid sökning efter flera ord visas endast matchningar som innehåller\n alla ord." -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" +#: themes/basic/search.html:35 +msgid "search" +msgstr "sök" + +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Innehåll" + +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "Sökresultat" -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." +msgstr "Din sökning matchade inte några dokument. Kontrollera att alla ord är rättstavade och att du har valt tillräckligt många kategorier." -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "se %s" +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "Sökningen är klar, hittade en sida som matchar sökfrågan." +msgstr[1] "Sökningen är klar, hittade ${resultCount} sidor som matchar sökfrågan." -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "se även %s" +#: themes/basic/static/searchtools.js:276 +msgid "Searching" +msgstr "Söker" -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "Förbereder sökning..." -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" +#: themes/basic/static/searchtools.js:526 +msgid ", in " +msgstr ", i " -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Dölj sökträffar" -#: environment/collectors/asset.py:126 +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 #, python-format -msgid "image file %s not readable: %s" -msgstr "" +msgid "Changes in Version %(version)s — %(docstitle)s" +msgstr "Ändringar i version %(version)s - %(docstitle)s" -#: environment/collectors/asset.py:163 +#: themes/basic/changes/rstsource.html:5 #, python-format -msgid "download file not readable: %s" -msgstr "" +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s - %(docstitle)s" -#: environment/collectors/toctree.py:259 +#: themes/basic/changes/versionchanges.html:17 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" +msgid "Automatically generated list of changes in version %(version)s" +msgstr "Automatiskt genererad lista över ändringar i version %(version)s" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" +msgstr "Förändringar i biblioteket" -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" +msgstr "C API-ändringar" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" +msgstr "Övriga ändringar" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" +msgstr "Visa sidofältet" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" +msgstr "Parameteravskiljare för enbart positionering (PEP 570)" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "Separator för parametrar som endast innehåller nyckelord (PEP 3102)" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametrar" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Variabler" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "" +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Höjer" -#: transforms/post_transforms/__init__.py:237 +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "" +msgid "%s() (in module %s)" +msgstr "%s() (i modul %s)" -#: transforms/post_transforms/__init__.py:299 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "" +msgid "%s (in module %s)" +msgstr "%s (i modul %s)" -#: transforms/post_transforms/__init__.py:305 +#: domains/python/__init__.py:174 #, python-format -msgid "%r reference target not found: %s" -msgstr "" +msgid "%s (built-in variable)" +msgstr "%s (inbyggd variabel)" -#: transforms/post_transforms/images.py:79 +#: domains/python/__init__.py:209 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "" +msgid "%s (built-in class)" +msgstr "%s (inbyggd klass)" -#: transforms/post_transforms/images.py:96 +#: domains/python/__init__.py:210 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "" +msgid "%s (class in %s)" +msgstr "%s (klass i %s)" -#: transforms/post_transforms/images.py:143 +#: domains/python/__init__.py:275 #, python-format -msgid "Unknown image format: %s..." -msgstr "" +msgid "%s() (%s class method)" +msgstr "%s() (%s klassmetod)" -#: builders/html/__init__.py:113 +#: domains/python/__init__.py:277 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "" +msgid "%s() (%s static method)" +msgstr "%s() (%s statisk metod)" -#: builders/html/__init__.py:348 +#: domains/python/__init__.py:430 #, python-format -msgid "Failed to read build info file: %r" -msgstr "" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "" - -#: builders/html/__init__.py:366 -msgid "building [html]: " -msgstr "" +msgid "%s (%s property)" +msgstr "%s (%s fastighet)" -#: builders/html/__init__.py:383 +#: domains/python/__init__.py:470 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" -msgstr "" +msgid "%s (type alias in %s)" +msgstr "%s (typ alias i %s)" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "index" +#: domains/python/__init__.py:624 +msgid "Python Module Index" +msgstr "Index för Python-moduler" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" -msgstr "" +#: domains/python/__init__.py:625 +msgid "modules" +msgstr "moduler" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "nästa" +#: domains/python/__init__.py:703 +msgid "Deprecated" +msgstr "Föråldrat" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "föregående" +#: domains/python/__init__.py:729 +msgid "exception" +msgstr "undantag" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "" +#: domains/python/__init__.py:731 +msgid "class method" +msgstr "klassmetod" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "" +#: domains/python/__init__.py:732 +msgid "static method" +msgstr "statisk metod" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" +#: domains/python/__init__.py:734 +msgid "property" +msgstr "fastighet" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "" +#: domains/python/__init__.py:735 +msgid "type alias" +msgstr "typ alias" -#: builders/html/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "" +msgid "" +"duplicate object description of %s, other instance in %s, use :no-index: for" +" one of them" +msgstr "duplicerad objektbeskrivning av %s, annan instans i %s, använd :no-index: för en av dem" -#: builders/html/__init__.py:864 +#: domains/python/__init__.py:974 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "" +msgid "more than one target found for cross-reference %r: %s" +msgstr "mer än ett mål hittades för korsreferens %r: %s" + +#: domains/python/__init__.py:1048 +msgid " (deprecated)" +msgstr " (föråldrad)" -#: builders/html/__init__.py:882 +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "" +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "Duplicerad C++-deklaration, även definierad i %s:%s.\nDeklarationen är '.. cpp:%s:: %s'." -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "" +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" +msgstr "Parametrar för mall" -#: builders/html/__init__.py:934 +#: domains/cpp/__init__.py:302 #, python-format -msgid "cannot copy static file %r" -msgstr "" +msgid "%s (C++ %s)" +msgstr "%s (C++ %s)" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "" +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 +msgid "Return values" +msgstr "Returvärden" -#: builders/html/__init__.py:949 -#, python-format -msgid "cannot copy extra file %r" -msgstr "" +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "forbund" -#: builders/html/__init__.py:955 -#, python-format -msgid "Failed to write build info file: %r" -msgstr "" +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" +msgstr "medlem" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "" +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "typ" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "" +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "koncept" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "" +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 +msgid "enum" +msgstr "enum" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "" +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 +msgid "enumerator" +msgstr "uppräknare" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "" +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 +msgid "function parameter" +msgstr "funktion parameter" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "" +#: domains/cpp/__init__.py:954 +msgid "template parameter" +msgstr "parameter för mall" -#: builders/html/__init__.py:1308 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format -msgid "invalid js_file: %r, ignored" -msgstr "" - -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "" +msgid "" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." +msgstr "Duplikat C-deklaration, även definierad vid %s:%s.\nDeklarationen är '.. c:%s:: %s'." -#: builders/html/__init__.py:1346 +#: domains/c/__init__.py:211 #, python-format -msgid "Unknown math_renderer %r is given." -msgstr "" +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "variabel" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "" +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "makro" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "" +#: domains/c/__init__.py:781 +msgid "struct" +msgstr "struktur" -#: builders/html/__init__.py:1380 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "" +msgid "environment variable; %s" +msgstr "miljövariabel; %s" -#: builders/html/__init__.py:1385 +#: domains/std/__init__.py:116 #, python-format -msgid "html_static_path entry %r does not exist" -msgstr "" +msgid "%s; configuration value" +msgstr "%s; konfigurationsvärde" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "" +#: domains/std/__init__.py:172 +msgid "Type" +msgstr "Typ" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" -msgstr "" +#: domains/std/__init__.py:182 +msgid "Default" +msgstr "Standard" -#: builders/html/__init__.py:1420 +#: domains/std/__init__.py:239 #, python-format msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." -msgstr "" - -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" +msgstr "Felaktig alternativbeskrivning %r, ska se ut som \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" eller \"+opt args\"" -#: builders/html/__init__.py:1449 +#: domains/std/__init__.py:319 #, python-format -msgid "%s %s documentation" -msgstr "" +msgid "%s command line option" +msgstr "%s alternativ för kommandoraden" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" -msgstr "" +#: domains/std/__init__.py:321 +msgid "command line option" +msgstr "kommandoradsalternativ" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" -msgstr "" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" +msgstr "ordlistetermen måste föregås av en tom rad" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" -msgstr "" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" +msgstr "termer i ordlistan får inte separeras av tomma rader" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "ordlistan verkar vara felformaterad, kontrollera indragning" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "ordlista term" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "grammatisk token" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "referensetikett" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Utgåva" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "miljövariabel" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "programalternativ" -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "" +#: domains/std/__init__.py:735 +msgid "document" +msgstr "dokument" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Modulindex" -#: builders/latex/__init__.py:544 +#: domains/std/__init__.py:857 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" +msgid "duplicate %s description of %s, other instance in %s" +msgstr "duplicera %s beskrivning av %s, annan instans i %s" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" -msgstr "" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "numfig är avaktiverad. :numref: ignoreras." -#: builders/latex/transforms.py:121 +#: domains/std/__init__.py:1124 #, python-format -msgid "Failed to get a docname for source %r!" -msgstr "" +msgid "Failed to create a cross reference. Any number is not assigned: %s" +msgstr "Misslyckades med att skapa en korsreferens. Något nummer har inte tilldelats: %s" -#: builders/latex/transforms.py:487 +#: domains/std/__init__.py:1138 #, python-format -msgid "No footnote was found for given reference node %r" -msgstr "" +msgid "the link has no caption: %s" +msgstr "länken har ingen bildtext: %s" -#: builders/latex/theming.py:88 +#: domains/std/__init__.py:1153 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "" +msgid "invalid numfig_format: %s (%r)" +msgstr "ogiltigt numfig_format: %s (%r)" -#: builders/latex/theming.py:91 +#: domains/std/__init__.py:1157 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "" - -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "fortsättning från föregående sida" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "" - -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "" +msgid "invalid numfig_format: %s" +msgstr "ogiltigt numfig_format: %s" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "" +#: domains/std/__init__.py:1453 +#, python-format +msgid "undefined label: %r" +msgstr "odefinierad etikett: %r" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "Misslyckades med att skapa en korsreferens. En titel eller bildtext hittades inte: %r" -#: ext/napoleon/docstring.py:176 +#: ext/napoleon/docstring.py:178 #, python-format msgid "invalid value set (missing closing brace): %s" -msgstr "" +msgstr "ogiltig värdeuppsättning (slutklammer saknas): %s" -#: ext/napoleon/docstring.py:183 +#: ext/napoleon/docstring.py:185 #, python-format msgid "invalid value set (missing opening brace): %s" -msgstr "" +msgstr "ogiltig värdeuppsättning (saknar öppningsparentes): %s" -#: ext/napoleon/docstring.py:190 +#: ext/napoleon/docstring.py:192 #, python-format msgid "malformed string literal (missing closing quote): %s" -msgstr "" +msgstr "missbildad sträng (saknar avslutande citattecken): %s" -#: ext/napoleon/docstring.py:197 +#: ext/napoleon/docstring.py:199 #, python-format msgid "malformed string literal (missing opening quote): %s" -msgstr "" +msgstr "missbildad sträng (saknar inledande citat): %s" -#: ext/napoleon/docstring.py:895 +#: ext/napoleon/docstring.py:902 msgid "Example" -msgstr "" +msgstr "Exempel" -#: ext/napoleon/docstring.py:896 +#: ext/napoleon/docstring.py:903 msgid "Examples" -msgstr "" +msgstr "Exempel" + +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "Argument för nyckelord" -#: ext/napoleon/docstring.py:956 +#: ext/napoleon/docstring.py:962 msgid "Notes" -msgstr "" +msgstr "Anteckningar" -#: ext/napoleon/docstring.py:965 +#: ext/napoleon/docstring.py:971 msgid "Other Parameters" -msgstr "" +msgstr "Övriga parametrar" -#: ext/napoleon/docstring.py:1001 +#: ext/napoleon/docstring.py:1007 msgid "Receives" -msgstr "" +msgstr "Mottagare" -#: ext/napoleon/docstring.py:1005 +#: ext/napoleon/docstring.py:1011 msgid "References" -msgstr "" +msgstr "Referenser" -#: ext/napoleon/docstring.py:1037 +#: ext/napoleon/docstring.py:1043 msgid "Warns" -msgstr "" +msgstr "Varningar" -#: ext/napoleon/docstring.py:1041 +#: ext/napoleon/docstring.py:1047 msgid "Yields" -msgstr "" - -#: ext/autosummary/__init__.py:284 -#, python-format -msgid "autosummary references excluded document %r. Ignored." -msgstr "" - -#: ext/autosummary/__init__.py:288 -#, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." -msgstr "" - -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." -msgstr "" - -#: ext/autosummary/__init__.py:384 -#, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "" - -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" +msgstr "Yields" -#: ext/autosummary/__init__.py:412 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "failed to import object %s" -msgstr "" +msgid "A mocked object is detected: %r" +msgstr "Ett mockat objekt har upptäckts: %r" -#: ext/autosummary/__init__.py:730 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." -msgstr "" +msgid "alias of %s" +msgstr "alias för %s" -#: ext/autosummary/__init__.py:927 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "autosummary_generate: file not found: %s" -msgstr "" - -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." -msgstr "" +msgid "Bases: %s" +msgstr "Baser: %s" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "" +msgid "invalid value for member-order option: %s" +msgstr "ogiltigt värde för medlemsorderalternativ: %s" -#: ext/autosummary/generate.py:588 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "" +msgid "invalid value for class-doc-from option: %s" +msgstr "ogiltigt värde för alternativet class-doc-from: %s" -#: ext/autosummary/generate.py:592 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "[autosummary] writing to %s" -msgstr "" +msgid "invalid signature for auto%s (%r)" +msgstr "ogiltig signatur för auto%s (%r)" -#: ext/autosummary/generate.py:637 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "" - -#: ext/autosummary/generate.py:836 -msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "" - -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "" - -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "" - -#: ext/autosummary/generate.py:874 -#, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "" - -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "vet inte vilken modul som ska importeras för autodokumentation %r (försök placera ett \"module\"- eller \"currentmodule\"-direktiv i dokumentet, eller ange ett explicit modulnamn)" -#: ext/autosummary/generate.py:890 +#: ext/autodoc/_names.py:89 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "" +msgid "signature arguments given for automodule: '%s'" +msgstr "signaturargument angivna för automodule: '%s'" -#: ext/autosummary/generate.py:899 +#: ext/autodoc/_names.py:93 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "" +msgid "return annotation given for automodule: '%s'" +msgstr "returnera annotation som ges för automodulen: '%s'" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" -msgstr "" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "\"::\" i automodulens namn är inte meningsfullt" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format msgid "Failed to remove %s: %s" -msgstr "" +msgstr "Misslyckades med att ta bort %s: %s" + +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "Skulle skapa fil %s." #: ext/apidoc/_cli.py:28 msgid "" @@ -3783,432 +3437,869 @@ msgid "" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." -msgstr "" +msgstr "\nLeta rekursivt i efter Python-moduler och -paket och skapa\nen reST-fil med automoduldirektiv per paket i .\n\ns kan vara fil- och/eller katalogmönster som kommer att\nuteslutas från generering.\n\nObs: Som standard kommer detta skript inte att skriva över redan skapade filer." #: ext/apidoc/_cli.py:45 msgid "path to module to document" -msgstr "" +msgstr "sökväg till modul till dokument" #: ext/apidoc/_cli.py:50 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "" +msgstr "fil- och/eller katalogmönster av typen fnmatch som ska uteslutas från generering" #: ext/apidoc/_cli.py:60 msgid "directory to place all output" -msgstr "" +msgstr "katalog för att placera alla utdata" #: ext/apidoc/_cli.py:75 msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "" +msgstr "maximalt antal undermoduler som ska visas i innehållsförteckningen (standard: 4)" #: ext/apidoc/_cli.py:82 msgid "overwrite existing files" -msgstr "" +msgstr "skriva över befintliga filer" #: ext/apidoc/_cli.py:91 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." -msgstr "" +msgstr "följa symboliska länkar. Kraftfull i kombination med collective.recipe.omelette." #: ext/apidoc/_cli.py:99 msgid "run the script without creating files" -msgstr "" +msgstr "köra skriptet utan att skapa filer" #: ext/apidoc/_cli.py:106 msgid "put documentation for each module on its own page" -msgstr "" +msgstr "lägga dokumentation för varje modul på en egen sida" #: ext/apidoc/_cli.py:113 msgid "include \"_private\" modules" -msgstr "" +msgstr "inkludera \"_private\" moduler" #: ext/apidoc/_cli.py:120 msgid "filename of table of contents (default: modules)" -msgstr "" +msgstr "filnamn för innehållsförteckningen (standard: modules)" #: ext/apidoc/_cli.py:127 msgid "don't create a table of contents file" -msgstr "" +msgstr "skapa inte en innehållsförteckningsfil" #: ext/apidoc/_cli.py:135 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" -msgstr "" +msgstr "skapa inte rubriker för modul-/paketpaket (t.ex. när dokumentationen redan innehåller dem)" #: ext/apidoc/_cli.py:145 msgid "put module documentation before submodule documentation" -msgstr "" +msgstr "sätta moduldokumentation före undermodulsdokumentation" #: ext/apidoc/_cli.py:152 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" -msgstr "" +msgstr "tolka modulvägar enligt PEP-0420 specifikation för implicita namnrymder" #: ext/apidoc/_cli.py:160 msgid "" "Comma-separated list of options to pass to automodule directive (or use " "SPHINX_APIDOC_OPTIONS)." -msgstr "" +msgstr "Kommaseparerad lista över alternativ som ska skickas till automoduldirektivet (eller använd SPHINX_APIDOC_OPTIONS)." #: ext/apidoc/_cli.py:170 msgid "file suffix (default: rst)" -msgstr "" +msgstr "filsuffix (standard: rst)" + +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "Ta bort befintliga filer i utdatakatalogen som inte har genererats" #: ext/apidoc/_cli.py:186 msgid "generate a full project with sphinx-quickstart" -msgstr "" +msgstr "skapa ett fullständigt projekt med sphinx-quickstart" #: ext/apidoc/_cli.py:193 msgid "append module_path to sys.path, used when --full is given" -msgstr "" +msgstr "lägg till module_path till sys.path, används när --full anges" #: ext/apidoc/_cli.py:200 msgid "project name (default: root module name)" -msgstr "" +msgstr "projektnamn (standard: namn på rotmodul)" #: ext/apidoc/_cli.py:207 msgid "project author(s), used when --full is given" -msgstr "" +msgstr "projektförfattare, används när --full är angiven" #: ext/apidoc/_cli.py:214 msgid "project version, used when --full is given" -msgstr "" +msgstr "projektversion, används när --full anges" #: ext/apidoc/_cli.py:222 msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "" +msgstr "projektversion, används när --full anges, standard är --doc-version" #: ext/apidoc/_cli.py:226 msgid "extension options" -msgstr "" +msgstr "tilläggssalternativ" #: ext/apidoc/_cli.py:232 msgid "enable arbitrary extensions, used when --full is given" -msgstr "" +msgstr "aktivera godtyckliga tillägg, används när --full anges" #: ext/apidoc/_cli.py:240 #, python-format msgid "enable %s extension, used when --full is given" -msgstr "" +msgstr "aktivera tillägget %s, används när --full anges" #: ext/apidoc/_cli.py:291 #, python-format msgid "%s is not a directory." -msgstr "" +msgstr "%s är inte en katalog." #: ext/apidoc/_extension.py:50 msgid "Running apidoc" -msgstr "" +msgstr "Körning av apidoc" #: ext/apidoc/_extension.py:102 #, python-format msgid "apidoc_modules item %i must be a dict" -msgstr "" +msgstr "apidoc_modules objekt %i måste vara en dict" #: ext/apidoc/_extension.py:110 #, python-format msgid "apidoc_modules item %i must have a 'path' key" -msgstr "" +msgstr "apidoc_modules objekt %i måste ha en \"path\"-nyckel" #: ext/apidoc/_extension.py:115 #, python-format msgid "apidoc_modules item %i 'path' must be a string" -msgstr "" +msgstr "apidoc_modules item %i \"path\" måste vara en sträng" #: ext/apidoc/_extension.py:121 #, python-format msgid "apidoc_modules item %i 'path' is not an existing folder: %s" -msgstr "" +msgstr "apidoc_modules item %i 'path' är inte en befintlig mapp: %s" #: ext/apidoc/_extension.py:133 #, python-format msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +msgstr "apidoc_modules objekt %i måste ha en \"destination\"-nyckel" #: ext/apidoc/_extension.py:140 #, python-format msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "" +msgstr "apidoc_modules item %i \"destination\" måste vara en sträng" #: ext/apidoc/_extension.py:147 #, python-format msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "apidoc_modules item %i 'destination' ska vara en relativ sökväg" + +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "apidoc_modules objekt %i kan inte skapa destinationskatalog: %s" + +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "apidoc_modules item %i '%s' måste vara ett int" + +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "apidoc_modules item %i '%s' måste vara en boolean" + +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "apidoc_modules objekt %i har oväntade nycklar: %s" + +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "apidoc_modules item %i '%s' måste vara en sekvens" + +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "apidoc_modules item %i '%s' måste innehålla strängar" + +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 +#, python-format +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "autosummary: kunde inte fastställa att %r var dokumenterad, följande undantag uppstod:\n%s" + +#: ext/autosummary/generate.py:630 +#, python-format +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] genererar autosummary för: %s" + +#: ext/autosummary/generate.py:634 +#, python-format +msgid "[autosummary] writing to %s" +msgstr "[autosummary] skriver till %s" + +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "[autosummary] misslyckades med att importera %s.\nMöjliga ledtrådar:\n%s" + +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\nGenerera ReStructuredText med hjälp av autosummary-direktiv.\n\nsphinx-autogen är en frontend till sphinx.ext.autosummary.generate. Den genererar\nreStructuredText-filerna från de autosummary-direktiv som finns i de\ngivna indatafilerna.\n\nFormatet för autosummary-direktivet finns dokumenterat i\n``sphinx.ext.autosummary`` Python-modulen och kan läsas med hjälp av::\n\n pydoc sphinx.ext.autosummary\n" + +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "källfiler för att generera rST-filer för" + +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "katalog för att placera alla utdata i" + +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "standardsuffix för filer (standard: %(default)s)" + +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "katalog för anpassad mall (standard: %(default)s)" + +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "dokumentets importerade medlemmar (standard: %(default)s)" + +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "dokumenterar exakt de medlemmar som finns i modulens __all__-attribut. (standard: %(default)s)" + +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." +msgstr "autosummary refererar till uteslutet dokument %r. Ignoreras." + +#: ext/autosummary/__init__.py:239 +#, python-format +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." +msgstr "autosummary: stub-fil hittades inte %r. Kontrollera din inställning för autosummary_generate." + +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "En textad automatisk sammanfattning kräver :toctree: alternativ. ignoreras." + +#: ext/autosummary/__init__.py:329 +#, python-format +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "autosummary: misslyckades med att importera %s.\nMöjliga ledtrådar:\n%s" + +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" +msgstr "misslyckades med att importera objekt %s" + +#: ext/autosummary/__init__.py:652 +#, python-format +msgid "" +"Summarised items should not include the current module. Replace %r with %r." +msgstr "Sammanfattade objekt ska inte omfatta den aktuella modulen. Ersätt %r med %r." + +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" +msgstr "autosummary_generate: filen hittades inte: %s" + +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." +msgstr "autosummary genererar .rst-filer internt. Men din source_suffix innehåller inte .rst. Hoppa över." + +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "Ogiltig intersphinx-projektidentifierare `%r` i intersphinx_mapping. Projektidentifierare måste vara icke-tomma strängar." + +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "Ogiltigt värde `%r` i intersphinx_mapping[%r]. Förväntade en tupel eller lista med två element." + +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "Ogiltigt värde `%r` i intersphinx_mapping[%r]. Värdena måste vara ett par (mål-URI, inventeringsplatser)." + +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "Ogiltigt mål-URI-värde `%r` i intersphinx_mapping[%r][0]. Mål-URI:er måste vara unika, icke-tomma strängar." + +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "Ogiltigt mål-URI-värde `%r` i intersphinx_mapping[%r][0]. Mål-URI:er måste vara unika (annan instans i intersphinx_mapping[%r])." + +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "Ogiltigt värde för inventeringsplats `%r` i intersphinx_mapping[%r][1]. Inventeringsplatser måste vara icke-tomma strängar eller None." + +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "Ogiltig konfiguration för `intersphinx_mapping` (1 fel)." + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "Ogiltig konfiguration för `intersphinx_mapping` (%s fel)." + +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "En ogiltig intersphinx_mapping-post lades till efter normaliseringen." + +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "läser in intersphinx-inventariet '%s' från %s ..." + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "stötte på vissa problem med några av inventarierna, men de hade fungerande alternativ:" + +#: ext/intersphinx/_load.py:332 +#, python-format +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "intersphinx lager har flyttats: %s -> %s" + +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" +msgstr "(i %s %s)" + +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "(i %s)" + +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "inventering '%s': dubbla matchningar hittades för %s:%s" + +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "inventering '%s': flera träffar hittades för %s:%s" + +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "inventering för extern korsreferens hittades inte: %r" + +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "ogiltigt externt korsreferenssuffix: %r" + +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "domän för extern korsreferens hittades inte: %r" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "extern %s:%s referensmål hittades inte: %s" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "fel vid formatering av signatur för %s: %s" + +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "Ignorerar ogiltig __all__ i modul %s: %r" + +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "Misslyckades med att få en funktionssignatur för %s: %s" + +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "Misslyckades med att uppdatera signaturen för %r: parametern hittades inte: %s" + +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "Misslyckades med att analysera type_comment för %r: %s" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "Ogiltiga __slots__ hittades på %s. Ignoreras." + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "fel vid formatering av argument för %s: %s" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "Misslyckades med att få en konstruktörsignatur för %s: %s" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "Misslyckades med att få en metodsignatur för %s: %s" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "Misslyckades med att få en signatur för %s: %s" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "Misslyckades med att tolka ett standardargumentvärde för %r: %s" + +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" +msgstr "attributet %s listas i :members: men saknas eftersom det inte hittades i objektet %r" + +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" -msgstr "" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "autodoc: kunde inte fastställa att %s.%s (%r) skulle dokumenteras, följande undantag uppstod:\n%s" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" -msgstr "" +msgid "missing attribute %s in object %s" +msgstr "saknar attributet %s i objektet %s" -#: ext/apidoc/_extension.py:256 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "" +msgid "alias of TypeVar(%s)" +msgstr "alias av TypeVar(%s)" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "kunde inte läsa broken build info file (okänd version)" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "kunde inte läsa trasig bygginfo-fil (saknade konfigurationspost)" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "kunde inte läsa broken build info-filen (saknar taggar)" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "HTML-sidorna finns i %(outdir)s." -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" -msgstr "" +msgid "Failed to read build info file: %r" +msgstr "Misslyckades med att läsa bygginfo-filen: %r" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "build_info-missmatchning, kopiering av .buildinfo till .buildinfo.bak" + +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "bygger [html]: " -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" -msgstr "" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "mall %s har ändrats sedan föregående version, alla dokument kommer att byggas om" + +#: builders/html/__init__.py:496 +msgid "index" +msgstr "index" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "" +msgid "Logo of %s" +msgstr "Logotyp för %s" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "nästa" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "föregående" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "genererar index" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "skriver ytterligare sidor" + +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "" +msgid "cannot copy image file '%s': %s" +msgstr "kan inte kopiera bildfilen '%s': %s" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "kopierar hämtningsbara filer... " -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "kan inte kopiera hämtningsbara filen %r: %s" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgstr "Misslyckades med att kopiera en fil i temats \"static\"-katalog: %s: %r" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "Misslyckades med att kopiera en fil i html_static_file: %s: %r" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "kopiering av statiska filer" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "" +msgid "cannot copy static file %r" +msgstr "kan inte kopiera statisk fil %r" + +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "kopierar extrafiler" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "cannot copy extra file %r" +msgstr "kan inte kopiera extrafil %r" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "Misslyckades med att skriva bygginfo-fil: %r" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "sökindex kunde inte läsas in, men alla dokument kommer inte att byggas: indexet kommer att vara ofullständigt." -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "sidan %s matchar två mönster i html_sidebars: %r och %r" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "ett Unicode-fel uppstod vid rendering av sidan %s. Kontrollera att alla konfigurationsvärden som innehåller icke-ASCII-innehåll är Unicode-strängar." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" +msgstr "Temat '%s' stöder inte den här versionen av Sphinx, eftersom det använder fältet 'style' i HTML-mallar, vilket inte längre används i Sphinx 5.1 och togs bort i Sphinx 7.0. Temat måste uppdateras för att använda fältet \"styles\" istället. Se https://www.sphinx-doc.org/en/master/development/html_themes/templating.html#styles" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "Ett fel inträffade vid rendering av sidan %s.\nAnledning: %r" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "dumpning av objektinventering" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +msgid "dumping search index in %s" +msgstr "dumpning av sökindex i %s" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "" +msgid "invalid js_file: %r, ignored" +msgstr "ogiltig js_file: %r, ignorerad" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Många math_renderers är registrerade. Men ingen math_renderer är vald." -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." +msgstr "Okänd math_renderer %r har angetts." -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1365 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "html_extra_path post %r är placerad inuti outdir" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1370 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "html_extra_path post %r finns inte" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "html_static_path post %r är placerad inuti outdir" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "" +msgid "html_static_path entry %r does not exist" +msgstr "html_static_path-post %r finns inte" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "" +msgid "logo file %r does not exist" +msgstr "logotypfilen %r finns inte" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1412 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "" +msgid "favicon file %r does not exist" +msgstr "filen favicon %r finns inte" -#: ext/autodoc/__init__.py:1021 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." +msgstr "Värdena i \"html_sidebars\" måste vara en lista med strängar. Åtminstone ett mönster har ett strängvärde: %s. Ändra till `html_sidebars = %r`." + +#: builders/html/__init__.py:1438 +msgid "" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "HTML 4 stöds inte längre av Sphinx. (\"html4_writer=True\" upptäcktes i konfigurationsalternativen)" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" -msgstr "" +msgid "%s %s documentation" +msgstr "%s %s dokumentation" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:87 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r har inte inställningen \"theme\"" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "" +#: builders/latex/theming.py:90 +#, python-format +msgid "%r doesn't have \"%s\" setting" +msgstr "%r har inte inställningen \"%s\"" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "Misslyckades med att hämta ett docname!" + +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "" +msgid "Failed to get a docname for source %r!" +msgstr "Misslyckades med att få ett dokumentnamn för källa %r!" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "" +msgid "No footnote was found for given reference node %r" +msgstr "Ingen fotnot hittades för angiven referensnod %r" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "LaTeX-filerna finns i %(outdir)s." + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\nKör 'make' i den katalogen för att köra dessa genom (pdf)latex\n(använd `make latexpdf' här för att göra det automatiskt)." + +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "inget konfigurationsvärde för \"latex_documents\" hittades; inga dokument kommer att skrivas" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "\"latex_documents\" konfigurationsvärde refererar till okänt dokument %s" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "kopiering av TeX-stödfiler" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "kopiering av ytterligare filer" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Okänd konfigurationsnyckel: latex_elements[%r], ignorerad." -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" -msgstr "" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "Okänt temaalternativ: latex_theme_options[%r], ignoreras." -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/toctree.py:259 #, python-format -msgid "missing attribute %s in object %s" -msgstr "" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s är redan tilldelad sektionsnummer (nästlad numrerad toctree?)" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:98 #, python-format -msgid "alias of %s" -msgstr "" +msgid "image file not readable: %s" +msgstr "bildfilen är inte läsbar: %s" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "" +msgid "image file %s not readable: %s" +msgstr "bildfil %s inte läsbar: %s" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "" +msgid "download file not readable: %s" +msgstr "hämtningsfil inte läsbar: %s" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "cirkulära toctree-referenser upptäckta, ignorerar: %s <- %s" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "toctree innehåller referens till dokument %r som inte har en titel: ingen länk kommer att genereras" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "" +msgid "toctree contains reference to non-included document %r" +msgstr "toctree innehåller hänvisning till icke-inkluderat dokument %r" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "" +msgid "toctree contains reference to non-existing document %r" +msgstr "toctree innehåller referens till icke-existerande dokument %r" + +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "se %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "se även %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "okänd typ av indexpost %r" diff --git a/sphinx/locale/te/LC_MESSAGES/sphinx.mo b/sphinx/locale/te/LC_MESSAGES/sphinx.mo index 9303f93aab7..8adca96fbbd 100644 Binary files a/sphinx/locale/te/LC_MESSAGES/sphinx.mo and b/sphinx/locale/te/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/te/LC_MESSAGES/sphinx.po b/sphinx/locale/te/LC_MESSAGES/sphinx.po index f237b92e9f6..58f3ed30fd2 100644 --- a/sphinx/locale/te/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/te/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Telugu (http://app.transifex.com/sphinx-doc/sphinx-1/language/te/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: te\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2804,21 +2945,20 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2827,6 +2967,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2848,119 +2993,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2972,92 +3124,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3085,581 +3230,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3667,548 +3720,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/tr/LC_MESSAGES/sphinx.mo b/sphinx/locale/tr/LC_MESSAGES/sphinx.mo index 13f46620e52..69e832bc096 100644 Binary files a/sphinx/locale/tr/LC_MESSAGES/sphinx.mo and b/sphinx/locale/tr/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/tr/LC_MESSAGES/sphinx.po b/sphinx/locale/tr/LC_MESSAGES/sphinx.po index 967c7d358d0..3f78dedf897 100644 --- a/sphinx/locale/tr/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/tr/LC_MESSAGES/sphinx.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: BouRock, 2020\n" "Language-Team: Turkish (http://app.transifex.com/sphinx-doc/sphinx-1/language/tr/)\n" @@ -22,6 +22,127 @@ msgstr "" "Language: tr\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Geliştirme Önerileri; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "%s.%s ayarı, aranan tema yapılandırmalarının hiçbirinde meydana gelmiyor" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "desteklenmeyen tema seçeneği %r verildi" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "tema yolundaki %r dosyası geçerli bir zip dosyası değil ya da hiç tema içermiyor" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -36,127 +157,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "Bu projenin %s uzantısına ve en az %s sürümüne ihtiyacı vardır ve bu nedenle yüklenen sürümle oluşturulamaz (%s)." -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Pygments lexer adı %r bilinmiyor" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "Olay %r zaten mevcut" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "Bilinmeyen olay adı: %s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "Kaynak dizin bulunamıyor (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "Kaynak dizin ve hedef dizin aynı olamaz" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx s%s çalışıyor" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Bu proje en az Sphinx s%s gerektirir ve bu nedenle bu sürüm ile oluşturulamaz." -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "çıktı dizini yapılıyor" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "%s uzantısı ayarlanırken:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "Şu anda conf.py dosyasında tanımlanan 'kurulum' çağrılabilir bir Python değil. Lütfen tanımını çağrılabilir bir işlev yapmak için değiştirin. Bunun, Sphinx uzantısı gibi davranması için conf.py dosyasına ihtiyacı vardır." -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "çeviriler yükleniyor [%s]... " -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "bitti" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "yerleşik iletiler için kullanılamaz" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "derin temizlenen ortam yükleniyor" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "başarısız olan: %s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "Seçilen oluşturucu yok, varsayılan kullanılıyor: html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "düğüm sınıfı %r zaten kayıtlı, ziyaretçileri geçersiz kılınacaktır" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -164,12 +312,12 @@ msgid "" "explicit" msgstr "%s uzantısı paralel okuma için güvenli olup olmadığını bildirmez, olmadığını varsayarak - lütfen uzantıyı hazırlayandan gözden geçirmesini ve açık hale getirmesini isteyin" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "%s uzantısı paralel okuma için güvenli değil" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -177,82 +325,214 @@ msgid "" "explicit" msgstr "%s uzantısı paralel yazma için güvenli olup olmadığını bildirmez, olmadığını varsayarak - lütfen uzantıyı hazırlayandan gözden geçirmesini ve açık hale getirmesini isteyin" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "%s uzantısı paralel yazma için güvenli değil" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "%s seri nosu yapılıyor" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "config dizini bir conf.py dosyası içermiyor (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Oluşturucu sınıfı %s \"ad\" özniteliğine sahip değil" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Oluşturucu %r zaten mevcut (%s modülünde)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Oluşturucu adı %s kayıtlı veya giriş noktası aracılığıyla kullanılabilir değil" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Oluşturucu adı %s kayıtlı değil" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "etki alanı %s zaten kayıtlı" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "etki alanı %s henüz kayıtlı değil" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "%r yönergesi zaten %s etki alanına kayıtlı" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "%r rolü zaten %s etki alanına kayıtlı" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "%r dizini zaten %s etki alanına kayıtlı" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "%r object_type zaten kayıtlı" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "%r crossref_type zaten kayıtlı" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r zaten kayıtlı" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "%r için source_parser zaten kayıtlı" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "%s için kaynak ayrıştırıcı kayıtlı değil" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "%r için çevirmen zaten mevcut" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "add_node() için kwargs bir (visit, depart) tanımlama grubu işlevi olmak zorundadır: %r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r zaten kayıtlı" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "%r uzantısı zaten %s sürümünden bu yana Sphinx ile birleştirildi; bu uzantı yoksayıldı." + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "Özgün özel durumu:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr " %s uzantısı içe aktarılamadı" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "%r uzantısı setup() işlevine sahip değil; bu gerçekten bir Sphinx uzantısı modülü mü?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "Bu proje tarafından kullanılan %s uzantısının en az Sphinx s%s sürümüne ihtiyacı var; bu nedenle bu sürümle oluşturulamaz." + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "%r uzantısı, setup() işlevinden desteklenmeyen bir nesne döndürdü; Hiçbir şey veya üstveri sözlüğü döndürmeli" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." msgstr "" -#: config.py:394 +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "config dizini bir conf.py dosyası içermiyor (%s)" + +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "sözlük yapılandırma ayarı %r geçersiz kılınamaz, yoksayılıyor (tek tek öğeleri ayarlamak için %r kullanın)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "geçersiz sayı %r; yapılandırma değeri %r için; yoksayılıyor" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "desteklenmeyen tür ile yapılandırma ayarı %r geçersiz kılınamaz, yoksayılıyor" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "geçersiz kılmada bilinmeyen yapılandırma değeri %r, yoksayılıyor" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "Yapılandırma değeri %r zaten mevcut" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Yapılandırma dosyanızda bir sözdizimi hatası var: %s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Yapılandırma dosyası (veya içe aktarılan modüllerden biri) sys.exit() olarak adlandırılır" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -260,469 +540,625 @@ msgid "" "%s" msgstr "Yapılandırma dosyanızda programlanabilir bir hata var:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "Bölüm %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "Şekil %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "Tablo %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "Listeleme %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "`{name}` yapılandırma değeri, {candidates} geğerlrinden biri olmak zorundadır, ancak `{current}` değeridir." -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "`{name}' yapılandırma değeri `{current.__name__}' türüne sahip; beklenen {permitted}." -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "`{name}' yapılandırma değeri `{current.__name__}' türüne sahip, vassayılanları `{default.__name__}'." -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r bulunamadı, yoksayıldı." -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Pygments lexer adı %r bilinmiyor" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "" +#: environment/__init__.py:89 +msgid "new config" +msgstr "yeni yapılandırma" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." -msgstr "" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "yapılandırma değişti" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "%s.%s ayarı, aranan tema yapılandırmalarının hiçbirinde meydana gelmiyor" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "uzantılar değişti" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "desteklenmeyen tema seçeneği %r verildi" +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "yapım ortamı sürümü şu anki değil" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "tema yolundaki %r dosyası geçerli bir zip dosyası değil ya da hiç tema içermiyor" +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "kaynak dizin değişti" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" -msgstr "" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "Bu ortam seçilen oluşturucuyla uyumsuzdur, lütfen başka bir belge ağacı dizini seçin." -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" -msgstr "" +msgid "Failed to scan documents in %s: %r" +msgstr "%s içinde belgeleri tarama başarısız oldu: %r" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +msgid "Domain %r is not registered" +msgstr "Etki alanı %r kayıtlı değil" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "belge herhangi bir toctree içine dahil değil" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "kendinden kaynaklı toctree bulundu. Yoksayıldı." -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Dikkat" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "Olay %r zaten mevcut" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Uyarı" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "Bilinmeyen olay adı: %s" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Tehlike" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "" +#: locale/__init__.py:232 +msgid "Error" +msgstr "Hata" -#: project.py:72 +#: locale/__init__.py:233 +msgid "Hint" +msgstr "İpucu" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Önemli" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Not" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Ayrıca bakınız" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Tüyo" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Uyarı" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Texinfo dosyaları %(outdir)s içinde." + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\nMakeinfo aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın\n(bunu otomatik olarak yapmak için burada 'make info' komutunu kullanın)." -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "hiçbir \"texinfo_documents\" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Oluşturucu sınıfı %s \"ad\" özniteliğine sahip değil" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "\"texinfo_documents\" yapılandırma değeri bilinmeyen %s belgesine başvurur" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Oluşturucu %r zaten mevcut (%s modülünde)" +msgid "processing %s" +msgstr "%s işleniyor" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Oluşturucu adı %s kayıtlı veya giriş noktası aracılığıyla kullanılabilir değil" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "yazılıyor" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Oluşturucu adı %s kayıtlı değil" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "başvurular çözümleniyor..." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "etki alanı %s zaten kayıtlı" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (şurada: " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "etki alanı %s henüz kayıtlı değil" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "resimler kopyalanıyor..." -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "%r yönergesi zaten %s etki alanına kayıtlı" +msgid "cannot copy image file %r: %s" +msgstr "resim dosyası %r kopyalanamıyor: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "%r rolü zaten %s etki alanına kayıtlı" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "Texinfo destek dosyaları kopyalanıyor..." -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "%r dizini zaten %s etki alanına kayıtlı" +msgid "error writing file Makefile: %s" +msgstr "Makefile dosyası yazılırken hata oldu: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "%r object_type zaten kayıtlı" +msgid "The manual pages are in %(outdir)s." +msgstr "Rehber sayfaları %(outdir)s içinde." -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "%r crossref_type zaten kayıtlı" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "hiçbir \"man_pages\" yapılandırma değeri bulunamadı; hiçbir rehber sayfası yazılmayacaktır" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r zaten kayıtlı" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "\"man_pages\" yapılandırma değeri bilinmeyen %s belgesine başvurur" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "%r için source_parser zaten kayıtlı" +msgid "The HTML page is in %(outdir)s." +msgstr "HTML sayfası %(outdir)s içinde." -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "%s için kaynak ayrıştırıcı kayıtlı değil" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "tek bir belgede toplanıyor" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "%r için çevirmen zaten mevcut" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "ilave dosyalar yazılıyor" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "add_node() için kwargs bir (visit, depart) tanımlama grubu işlevi olmak zorundadır: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "Taklit oluşturucu hiçbir dosya oluşturmaz." -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r zaten kayıtlı" +msgid "The message catalogs are in %(outdir)s." +msgstr "İleti katalogları %(outdir)s içinde." -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "" +msgid "building [%s]: " +msgstr "[%s] oluşturuluyor:" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "%r uzantısı zaten %s sürümünden bu yana Sphinx ile birleştirildi; bu uzantı yoksayıldı." +msgid "targets for %d template files" +msgstr "%d şablon dosyası için hedefler" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "Özgün özel durumu:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "şablonlar okunuyor..." -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" -msgstr " %s uzantısı içe aktarılamadı" +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "ileti katalogları yazılıyor..." -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "%r uzantısı setup() işlevine sahip değil; bu gerçekten bir Sphinx uzantısı modülü mü?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "Yukarıdaki çıktıda veya %(outdir)s/output.txt içinde herhangi bir hata arayın" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "Bu proje tarafından kullanılan %s uzantısının en az Sphinx s%s sürümüne ihtiyacı var; bu nedenle bu sürümle oluşturulamaz." +msgid "broken link: %s (%s)" +msgstr "bozuk bağlantı: %s (%s)" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "%r uzantısı, setup() işlevinden desteklenmeyen bir nesne döndürdü; Hiçbir şey veya üstveri sözlüğü döndürmeli" +msgid "Anchor '%s' not found" +msgstr "Bağlayıcı '%s' bulunamadı" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." +msgstr "ePub dosyası %(outdir)s içinde." + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:251 +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "yapılandırma değeri \"epub_language\" (veya \"language\"), EPUB3 için boş olmamalıdır" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "yapılandırma değeri \"epub_uid\", EPUB3 için XML NAME olmalıdır" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "yapılandırma değeri \"epub_title\" (veya \"html_title\"), EPUB3 için boş olmamalıdır" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "yapılandırma değeri \"epub_author\", EPUB3 için boş olmamalıdır" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "yapılandırma değeri \"epub_contributor\", EPUB3 için boş olmamalıdır" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "yapılandırma değeri \"epub_description\", EPUB3 için boş olmamalıdır" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "yapılandırma değeri \"epub_publisher\", EPUB3 için boş olmamalıdır" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "yapılandırma değeri \"epub_copyright\" (veya \"copyright\"), EPUB3 için boş olmamalıdır" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "yapılandırma değeri \"epub_identifier\", EPUB3 için boş olmamalıdır" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "yapılandırma değeri \"version\", EPUB3 için boş olmamalıdır" + +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +msgid "invalid css_file: %r, ignored" +msgstr "geçersiz css_file: %r, yoksayıldı" -#: roles.py:274 +#: builders/xml.py:29 #, python-format -msgid "invalid CWE number %s" -msgstr "" +msgid "The XML files are in %(outdir)s." +msgstr "XML dosyaları %(outdir)s içinde." -#: roles.py:294 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Geliştirme Önerileri; PEP %s" +msgid "error writing file %s: %s" +msgstr "%s dosyası yazılırken hata oldu: %s" -#: roles.py:317 +#: builders/xml.py:103 #, python-format -msgid "invalid PEP number %s" -msgstr "" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "Pseudo-XML dosyaları %(outdir)s içinde." -#: roles.py:355 +#: builders/_epub_base.py:223 #, python-format -msgid "invalid RFC number %s" +msgid "duplicated ToC entry found: %s" +msgstr "kopyalanmış ToC girişi bulundu: %s" + +#: builders/_epub_base.py:436 +#, python-format +msgid "cannot read image file %r: copying it instead" +msgstr "resim dosyası %r okunamıyor: bunun yerine kopyalanıyor" + +#: builders/_epub_base.py:467 +#, python-format +msgid "cannot write image file %r: %s" +msgstr "resim dosyası %r yazılamıyor: %s" + +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "Yastık bulunamadı - resim dosyaları kopyalanıyor" + +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[kaynak]" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[belgeler]" +#: builders/_epub_base.py:594 +#, python-format +msgid "unknown mimetype for %s, ignoring" +msgstr "%s için bilinmeyen mime türü, yoksayılıyor" -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "Modül kodu" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" -#: ext/viewcode.py:353 +#: builders/_epub_base.py:802 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        %s öğesinin kaynak kodu

        " +msgid "writing %s file..." +msgstr "%s dosyası yazılıyor..." -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "Genel bakış: modül kodu" +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "Metin dosyaları %(outdir)s içinde." -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        Kodları mevcut bütün modüller

        " +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "%s oluşturucu için uygun bir resim bulunamadı: %s (%s)" -#: ext/extlinks.py:82 +#: builders/__init__.py:237 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "" +msgid "a suitable image for %s builder not found: %s" +msgstr "%s oluşturucu için uygun bir resim bulunamadı: %s" -#: ext/autosectionlabel.py:52 +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "[mo] oluşturuluyor: " + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "çıktı yazılıyor..." + +#: builders/__init__.py:280 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "" +msgid "all of %d po files" +msgstr "%d po dosyasının tümü" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/__init__.py:302 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "%s kopya etiketi, %s içindeki diğer örnek" +msgid "targets for %d po files that are specified" +msgstr "belirtilen %d po dosyası için hedefler" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "güncel olmayan %d po dosyası için hedefler" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "tüm kaynak dosyaları" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/duration.py:90 +#: builders/__init__.py:342 +#, python-format msgid "" -"====================== slowest reading durations =======================" -msgstr "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "komut satırında verilen %r dosyası kaynak dizinin altında değil, yoksayılıyor" -#: ext/doctest.py:118 +#: builders/__init__.py:353 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "file %r given on command line is not a valid document, ignoring" msgstr "" -#: ext/doctest.py:124 +#: builders/__init__.py:366 #, python-format -msgid "'%s' is not a valid option." -msgstr "" +msgid "%d source files given on command line" +msgstr "komut satırında verilen %d kaynak dosyası" -#: ext/doctest.py:139 +#: builders/__init__.py:382 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "" +msgid "targets for %d source files that are out of date" +msgstr "güncel olmayan %d kaynak dosyası için hedefler" -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "şimdi güncel olmayan dosyalar aranıyor..." -#: ext/doctest.py:297 +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "%d tane bulundu" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "hiç bulunamadı" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "ortam derin temizleniyor" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "tutarlılık denetleniyor" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "hiçbir hedef güncel değil." + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "güncellenen ortam:" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "%s eklendi, %s değiştirildi, %s kaldırıldı" + +#: builders/__init__.py:536 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/doctest.py:457 +#: builders/__init__.py:545 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/doctest.py:568 +#: builders/__init__.py:556 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:563 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "LaTeX komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_latex ayarını gözden geçirin" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "kaynaklar okunuyor..." -#: ext/imgmath.py:181 +#: builders/__init__.py:725 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%s komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_%s ayarını gözden geçirin" +msgid "docnames to write: %s" +msgstr "yazmak için belge adları: %s" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "belgeler hazırlanıyor" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" -#: ext/imgmath.py:344 +#: builders/changes.py:29 #, python-format -msgid "display latex %r: %s" -msgstr "görüntü latex %r: %s" +msgid "The overview file is in %(outdir)s." +msgstr "Genel bakış dosyası %(outdir)s içinde." -#: ext/imgmath.py:380 +#: builders/changes.py:65 #, python-format -msgid "inline latex %r: %s" -msgstr "satır içi latex %r: %s" +msgid "no changes in version %s." +msgstr "%s sürümünde değişiklik yok." + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "özet dosyası yazılıyor..." + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Yerleşikler" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Modül seviyesi" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "kaynak dosyalar kopyalanıyor..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "değişiklikler günlüğü oluşturma için %r okunamadı" #: ext/coverage.py:48 #, python-format @@ -742,9 +1178,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -779,18 +1216,46 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" -#: ext/imgconverter.py:44 +#: ext/extlinks.py:82 #, python-format msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" msgstr "" -#: ext/imgconverter.py:56 ext/imgconverter.py:90 -#, python-format -msgid "" -"convert exited with error:\n" +#: ext/todo.py:61 +msgid "Todo" +msgstr "Yapılacaklar" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<>, %s içinde, %d. satırda bulunur.)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "özgün giriş" + +#: ext/imgconverter.py:44 +#, python-format +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "" + +#: ext/imgconverter.py:56 ext/imgconverter.py:90 +#, python-format +msgid "" +"convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" @@ -866,1779 +1331,1514 @@ msgstr "[grafik: %s]" msgid "[graph]" msgstr "[grafik]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Yapılacaklar" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" -msgstr "" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "LaTeX komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_latex ayarını gözden geçirin" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_%s ayarını gözden geçirin" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<>, %s içinde, %d. satırda bulunur.)" +msgid "display latex %r: %s" +msgstr "görüntü latex %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "özgün giriş" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "satır içi latex %r: %s" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" -msgstr "Geçersiz resim yazısı: %s" +msgid "missing '+' or '-' in '%s' option." +msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "satır numarası özellikleri aralık dışında (1-%d): %r" +msgid "'%s' is not a valid option." +msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "Hem \"%s\" hem de \"%s\" seçeneği kullanılamıyor" +msgid "'%s' is not a valid pyversion option" +msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 -#, python-format -msgid "Object named %r not found in include file %r" -msgstr "%r adlı nesne, dahil edilen %r dosyasında bulunamadı" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "Ayrık bir \"satır\" kümesiyle \"lineno-match\" kullanılamıyor" - -#: directives/code.py:314 +#: ext/doctest.py:451 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Satır özelliği %r: dahil edilen %r dosyasından çekilen hiç satır yok" - -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/other.py:119 +#: ext/doctest.py:568 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/autosectionlabel.py:52 #, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "toctree, hariç tutulan %r belgesine başvuru içeriyor" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "" -#: directives/other.py:156 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "toctree, varolmayan %r belgesine başvuru içeriyor" +msgid "duplicate label %s, other instance in %s" +msgstr "%s kopya etiketi, %s içindeki diğer örnek" -#: directives/other.py:169 +#: ext/duration.py:47 #, python-format -msgid "duplicated entry found in toctree: %s" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Bölümü hazırlayan: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Modülü hazırlayan: " - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Kodu hazırlayan: " - -#: directives/other.py:209 -msgid "Author: " -msgstr "Hazırlayan: " - -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." -msgstr "Genel bakış dosyası %(outdir)s içinde." +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "" -#: builders/changes.py:56 +#: ext/duration.py:139 #, python-format -msgid "no changes in version %s." -msgstr "%s sürümünde değişiklik yok." - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "özet dosyası yazılıyor..." +msgid "%.3fs %s" +msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Yerleşikler" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[kaynak]" -#: builders/changes.py:72 -msgid "Module level" -msgstr "Modül seviyesi" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "kaynak dosyalar kopyalanıyor..." +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[belgeler]" -#: builders/changes.py:133 -#, python-format -msgid "could not read %r for changelog creation" -msgstr "değişiklikler günlüğü oluşturma için %r okunamadı" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "Modül kodu" -#: builders/manpage.py:37 +#: ext/viewcode.py:359 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "Rehber sayfaları %(outdir)s içinde." +msgid "

        Source code for %s

        " +msgstr "

        %s öğesinin kaynak kodu

        " -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "hiçbir \"man_pages\" yapılandırma değeri bulunamadı; hiçbir rehber sayfası yazılmayacaktır" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "Genel bakış: modül kodu" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "yazılıyor" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        Kodları mevcut bütün modüller

        " -#: builders/manpage.py:71 +#: domains/citation.py:75 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "\"man_pages\" yapılandırma değeri bilinmeyen %s belgesine başvurur" +msgid "duplicate citation %s, other instance in %s" +msgstr "%s kopya alıntısı, %s içindeki diğer örnek" -#: builders/__init__.py:224 +#: domains/citation.py:92 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "%s oluşturucu için uygun bir resim bulunamadı: %s (%s)" +msgid "Citation [%s] is not referenced." +msgstr "Alıntı [%s] kaynak gösterilmedi." -#: builders/__init__.py:232 +#: domains/math.py:73 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "%s oluşturucu için uygun bir resim bulunamadı: %s" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "[mo] oluşturuluyor: " - -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "çıktı yazılıyor..." +msgid "duplicate label of equation %s, other instance in %s" +msgstr "%s denkleminin kopya etiketi, %s içindeki diğer örnek" -#: builders/__init__.py:275 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "all of %d po files" -msgstr "%d po dosyasının tümü" +msgid "Invalid math_eqref_format: %r" +msgstr "Geçersiz math_eqref_format: %r" -#: builders/__init__.py:297 +#: domains/javascript.py:183 #, python-format -msgid "targets for %d po files that are specified" -msgstr "belirtilen %d po dosyası için hedefler" +msgid "%s() (built-in function)" +msgstr "%s() (yerleşik işlev)" -#: builders/__init__.py:309 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "güncel olmayan %d po dosyası için hedefler" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "tüm kaynak dosyaları" +msgid "%s() (%s method)" +msgstr "%s() (%s yöntemi)" -#: builders/__init__.py:330 +#: domains/javascript.py:186 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "" +msgid "%s() (class)" +msgstr "%s() (sınıf)" -#: builders/__init__.py:337 +#: domains/javascript.py:188 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "komut satırında verilen %r dosyası kaynak dizinin altında değil, yoksayılıyor" +msgid "%s (global variable or constant)" +msgstr "%s (genel değişken veya sabit)" -#: builders/__init__.py:348 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s özniteliği)" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "komut satırında verilen %d kaynak dosyası" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Bağımsız Değişkenler" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "güncel olmayan %d kaynak dosyası için hedefler" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Şunu verir: " -#: builders/__init__.py:395 builders/gettext.py:265 -#, python-format -msgid "building [%s]: " -msgstr "[%s] oluşturuluyor:" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Dönüşler" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "şimdi güncel olmayan dosyalar aranıyor..." +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Dönüş türü" -#: builders/__init__.py:410 +#: domains/javascript.py:374 #, python-format -msgid "%d found" -msgstr "%d tane bulundu" +msgid "%s (module)" +msgstr "%s (modül)" -#: builders/__init__.py:412 -msgid "none found" -msgstr "hiç bulunamadı" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "işlevi" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "ortam derin temizleniyor" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "yöntemi" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "tutarlılık denetleniyor" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "sınıfı" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "hiçbir hedef güncel değil." +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "verisi" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "güncellenen ortam:" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "özniteliği" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s eklendi, %s değiştirildi, %s kaldırıldı" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "modülü" -#: builders/__init__.py:531 +#: domains/javascript.py:458 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "" +msgid "duplicate %s description of %s, other %s in %s" +msgstr "kopya %s açıklamasına ait %s, diğer %s, %s içinde" -#: builders/__init__.py:540 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "%s (directive)" +msgstr "%s (yönerge)" -#: builders/__init__.py:551 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "" +msgid ":%s: (directive option)" +msgstr ":%s: (yönerge seçeneği)" -#: builders/__init__.py:558 +#: domains/rst.py:224 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" +msgid "%s (role)" +msgstr "%s (rol)" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "kaynaklar okunuyor..." +#: domains/rst.py:234 +msgid "directive" +msgstr "yönergesi" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" -msgstr "yazmak için belge adları: %s" +#: domains/rst.py:235 +msgid "directive-option" +msgstr "yönerge seçeneği" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" +#: domains/rst.py:236 +msgid "role" +msgstr "rolü" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "belgeler hazırlanıyor" +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "%s %s kopya açıklaması, %s içindeki diğer örnek" -#: builders/__init__.py:731 -msgid "copying assets" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:883 +#: domains/changeset.py:33 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "" +msgid "Changed in version %s" +msgstr "%s sürümünde değişti" -#: builders/epub3.py:84 +#: domains/changeset.py:34 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "ePub dosyası %(outdir)s içinde." +msgid "Deprecated since version %s" +msgstr "%s sürümünden beri kullanım dışı" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "yapılandırma değeri \"epub_language\" (veya \"language\"), EPUB3 için boş olmamalıdır" - -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "yapılandırma değeri \"epub_uid\", EPUB3 için XML NAME olmalıdır" - -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "yapılandırma değeri \"epub_title\" (veya \"html_title\"), EPUB3 için boş olmamalıdır" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "yapılandırma değeri \"epub_author\", EPUB3 için boş olmamalıdır" +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "iş numarası pozitif bir sayı olmalıdır" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "yapılandırma değeri \"epub_contributor\", EPUB3 için boş olmamalıdır" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "yapılandırma değeri \"epub_description\", EPUB3 için boş olmamalıdır" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "yapılandırma değeri \"epub_publisher\", EPUB3 için boş olmamalıdır" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "belgelendirme kaynak dosyaları için yol" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "yapılandırma değeri \"epub_copyright\" (veya \"copyright\"), EPUB3 için boş olmamalıdır" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "çıktı dizini için yol" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "yapılandırma değeri \"epub_identifier\", EPUB3 için boş olmamalıdır" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "yapılandırma değeri \"version\", EPUB3 için boş olmamalıdır" +#: cmd/build.py:114 +msgid "general options" +msgstr "genel seçenekler" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "geçersiz css_file: %r, yoksayıldı" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "XML dosyaları %(outdir)s içinde." +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "%s dosyası yazılırken hata oldu: %s" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "tüm dosyaları yaz (varsayılan: sadece yeni ve değiştirilmiş dosyaları yaz)" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "Pseudo-XML dosyaları %(outdir)s içinde." +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "kaydedilmiş bir ortam kullanma, her zaman tüm dosyaları oku" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Texinfo dosyaları %(outdir)s içinde." +#: cmd/build.py:150 +msgid "path options" +msgstr "" -#: builders/texinfo.py:48 +#: cmd/build.py:157 msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\nMakeinfo aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın\n(bunu otomatik olarak yapmak için burada 'make info' komutunu kullanın)." +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "hiçbir \"texinfo_documents\" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "\"texinfo_documents\" yapılandırma değeri bilinmeyen %s belgesine başvurur" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "%s işleniyor" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "yapılandırma dosyasındaki bir ayarı geçersiz kıl" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "başvurular çözümleniyor..." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "HTML şablonlarına bir değer geçir" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (şurada: " +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "etiketi tanımla: \"sadece\" TAG'li blokları dahil et" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "resimler kopyalanıyor..." +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "resim dosyası %r kopyalanamıyor: %s" +#: cmd/build.py:212 +msgid "console output options" +msgstr "konsol çıktısı seçenekleri" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "Texinfo destek dosyaları kopyalanıyor..." +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "ayrıntı seviyesini artır (tekrarlanabilir)" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "Makefile dosyası yazılırken hata oldu: %s" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "stdout üzerinde çıktı yok, stderr üzerinde sadece uyarılar" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "kopyalanmış ToC girişi bulundu: %s" - -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "resim dosyası %r okunamıyor: bunun yerine kopyalanıyor" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "hiç çıktı yok, hatta uyarılarda bile" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "resim dosyası %r yazılamıyor: %s" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "renkli çıktı yayımı yap (varsayılan: otomatik algıla)" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "Yastık bulunamadı - resim dosyaları kopyalanıyor" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "renkli çıktı yayımı yapma (varsayılan: otomatik algıla)" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "verilen dosyaya uyarıları (ve hataları) yaz" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "uyarıları hatalara dönüştür" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "%s için bilinmeyen mime türü, yoksayılıyor" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "özel durumda tam geri izleme göster" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" -msgstr "" +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "özel durumda Pdb çalıştır" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "%s dosyası yazılıyor..." - -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "Taklit oluşturucu hiçbir dosya oluşturmaz." - -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "İleti katalogları %(outdir)s içinde." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "-a seçeneği ve dosya adları birleştirilemiyor" -#: builders/gettext.py:266 +#: cmd/build.py:357 #, python-format -msgid "targets for %d template files" -msgstr "%d şablon dosyası için hedefler" +msgid "cannot open warning file '%s': %s" +msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "şablonlar okunuyor..." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "-D seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır" -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "ileti katalogları yazılıyor..." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "-A seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "HTML sayfası %(outdir)s içinde." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "modüllerden otomatik olarak docstrings ekle" -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "tek bir belgede toplanıyor" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "doctest bloklarında kod parçacıklarını otomatik olarak dene" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "ilave dosyalar yazılıyor" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "farklı projelerin Sphinx begelendirmeleri arasında bağlantıla" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "Yukarıdaki çıktıda veya %(outdir)s/output.txt içinde herhangi bir hata arayın" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "oluşturmada gösterilebilen veya gizlenebilen \"yapılacaklar\" girişlerini yaz" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "bozuk bağlantı: %s (%s)" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "belgelendirme kapsamı için denetlemeler" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "Bağlayıcı '%s' bulunamadı" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "PNG veya SVG resimleri olarak işleneni, matematiği dahil et" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "MathJax ile tarayıcıda işleneni, matematiği dahil et" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." -msgstr "Metin dosyaları %(outdir)s içinde." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "yapılandırma değerlerine dayalı içeriğin koşullu olarak eklenmesi" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "belgelenmiş Python nesnelerinin kaynak koduna bağlantıları dahil et" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "belgeyi GitHub sayfalarında yayımlamak için .nojekyll dosyası oluştur" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "Lütfen geçerli bir yol adı girin." -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "Lütfen biraz metin girin." -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 +#: cmd/quickstart.py:134 #, python-format -msgid "%b %d, %Y" -msgstr "%d %b %Y" +msgid "Please enter one of %s." +msgstr "Lütfen %s seçeneklerinden birini girin." -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "Lütfen ya 'y' ya da 'n' girin." -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "Lütfen bir dosya soneki girin, örn. '.rst' veya '.txt'." -#: transforms/__init__.py:253 +#: cmd/quickstart.py:230 #, python-format +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "Sphinx %s hızlı başlangıç yardımcı uygulamasına hoş geldiniz." + +#: cmd/quickstart.py:235 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "Lütfen aşağıdaki ayarlar için değerleri girin (parantez içinde verilirse\nvarsayılan değeri kabul etmek için yalnızca Enter tuşuna basın)." -#: transforms/__init__.py:294 +#: cmd/quickstart.py:242 #, python-format -msgid "Footnote [%s] is not referenced." -msgstr "" - -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" +msgid "Selected root path: %s" +msgstr "Seçilen kök dizin yolu: %s" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "Belgelendirme için kök dizin yolunu girin." -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "Belgelendirme için kök dizin yolu" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "Hata: seçilen kök dizin yolunda varolan bir conf.py bulundu." -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sfenks-quickstart varolan Sphinx projelerinin üzerine yazmayacak." -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "Lütfen yeni bir kök dizin yolu girin (ya da çıkmak için yalnızca Enter'a basın)" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "" +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "Sphinx çıktısının oluşturma dizinini yerleştirmek için iki seçeneğiniz var.\nYa, kök dizin yolu içinde bir \"_build\" dizini kullanın, ya da kök dizin yolu\niçinde \"source\" ve \"build\" dizinlerini ayırın." -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "Source ve build dizinlerini ayır (y/n)" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:287 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "Kök dizinin içinde, iki dizin daha oluşturulacaktır; özel HTML şablonları için \"_templates\"\nve özel stil sayfaları ve diğer sabit dosyalar için \"_static\".\nAlt çizgi yerine başka bir önek (\".\" gibi) girebilirsiniz." -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "Templates ve static dizinleri için ad öneki" -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "Proje adı, oluşturulan belgelendirmedeki çeşitli yerlerde oluşacak." -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "Proje adı" -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "Hazırlayan ad(ları)ı" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "Proje sürümü" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "Proje yayımı" -#: environment/__init__.py:86 -msgid "new config" -msgstr "yeni yapılandırma" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "Eğer belgeler İngilizce dışında bir dilde yazıldıysa, bunun dil koduna\ngöre burada bir dil seçebilirsiniz. Sphinx daha sonra, ürettiği metni o\ndile çevirecektir.\n\nDesteklenen kodların listesi için\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language adresine bakın." -#: environment/__init__.py:87 -msgid "config changed" -msgstr "yapılandırma değişti" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "Proje dili" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "uzantılar değişti" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "yapım ortamı sürümü şu anki değil" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "Kaynak dosya soneki" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "kaynak dizin değişti" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "Bir belge, \"içindekiler ağacı\"nın üst düğümü olarak kabul edilmesi, yani\nbelgelerin hiyerarşik yapısının kökü olması açısından özeldir.\nNormalde bu \"dizin\"dir, ancak \"dizin\" belgeniz özel bir şablonsa,\nbunu başka bir dosya adına da ayarlayabilirsiniz." -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "Asıl belgenizin adı (sonek olmadan)" -#: environment/__init__.py:330 +#: cmd/quickstart.py:368 #, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "Hata: %s asıl dosyası zaten seçilen kök dizin yolunda bulundu." -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sfenks-quickstart varolan dosyanın üzerine yazmayacak." -#: environment/__init__.py:379 +#: cmd/quickstart.py:378 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "Bu ortam seçilen oluşturucuyla uyumsuzdur, lütfen başka bir belge ağacı dizini seçin." - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "%s içinde belgeleri tarama başarısız oldu: %r" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "Lütfen yeni bir dosya adı girin ya da varolan dosyayı yeniden adlandırın ve Enter tuşuna basın" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "Etki alanı %r kayıtlı değil" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "Aşağıdaki Sphinx uzantılarından hangisinin etkinleştirilmesi gerektiğini gösterir:" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "belge herhangi bir toctree içine dahil değil" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "Not: imgmath ve mathjax aynı anda etkinleştirilemez. imgmath seçimi kaldırıldı." -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "kendinden kaynaklı toctree bulundu. Yoksayıldı." +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "Makefile ve Windows komut dosyası sizin için oluşturulabilir,\nböylece doğrudan örn. sphinx-build çağırmak yerine sadece\n`make html' komutu çalıştırılmak zorundadır." -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "Makefile oluşturulsun mu? (y/n)" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "okuma hatası: %s, %s" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "Windows komut satırı oluşturulsun mu? (y/n)" -#: util/i18n.py:113 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "writing error: %s, %s" -msgstr "yazma hatası: %s, %s" +msgid "Creating file %s." +msgstr "%s dosyası oluşturuluyor." -#: util/i18n.py:146 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "locale_dir %s does not exist" -msgstr "" +msgid "File %s already exists, skipping." +msgstr "%s dosyası zaten var, atlanıyor." -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "Tamamlandı: İlk dizin yapısı oluşturuldu." -#: util/i18n.py:245 +#: cmd/quickstart.py:520 #, python-format msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "Artık %s asıl dosyanızı doldurmalı ve diğer belgelendirme kaynak dosyalarını\noluşturmalısınız." -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "Belgeleri oluşturmak için Makefile'ı kullanın, aşağıdaki gibi:\n make builder" -#: util/nodes.py:423 +#: cmd/quickstart.py:531 #, python-format msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" - -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "Belgeleri oluşturmak için sphinx-build komutunu kullanın, aşağıdaki gibi:\n sphinx-build -b builder %s %s" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "\"builder\" burada desteklenen oluşturuculardan biridir, örn. html, latex veya linkcheck." -#: util/display.py:82 -msgid "skipped" -msgstr "atlandı" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\nBir Sphinx projesi için gerekli dosyaları oluşturun.\n\nsphinx-quickstart, projeniz hakkında bazı sorular soran ve ardından tam bir\nbelgelendirme dizini ve örnek oluşturan etkileşimli bir araçtır\nMakefile, sphinx-build ile kullanılır.\n" -#: util/display.py:87 -msgid "failed" -msgstr "başarısız oldu" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "sessiz kipi" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "proje kök dizini" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "Yapı seçenekleri" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "eğer belirtildiyse, kaynak ve oluşturma dizinlerini ayırın" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/fileutil.py:76 -#, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "_templates vb. içinde nokta için değiştirme" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "Proje temel seçenekleri" -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "varsayılan rol %s bulunamadı" +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "proje adı" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "hazırlayan adları" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "projenin sürümü" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "Dipnotlar" +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "projenin yayımı" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "[resim: %s]" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "belge dili" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[resim]" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "kaynak dosya soneki" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Dizin" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "asıl belge adı" -#: writers/latex.py:743 writers/texinfo.py:646 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "epub kullan" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "Uzantı seçenekleri" -#: writers/texinfo.py:1303 +#: cmd/quickstart.py:671 #, python-format -msgid "unimplemented node type: %r" -msgstr "" - -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "%r dili için bilinen hiç Babel seçeneği yok" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "Geçersiz math_eqref_format: %r" +msgid "enable %s extension" +msgstr "%s uzantısını etkinleştir" -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "rasgele uzantıları etkinleştir" -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Makefile ve Batchfile oluşturma" -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "makefile oluştur" -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "makefile oluşturma" -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "batchfile oluştur" -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "batchfile oluşturma" -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "Makefile/make.bat için make-mode kullan" -#: writers/html5.py:638 -msgid "Link to this image" -msgstr "" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "Proje şablonlama" -#: writers/html5.py:640 -msgid "Link to this toctree" -msgstr "" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "şablon dosyaları için şablon dizini" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "" +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "bir şablon değişkeni tanımla" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "\"sessiz\" belirtilmiş, ancak herhangi bir \"proje\" veya \"hazırlayan\" belirtilmemiş." -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "%s denkleminin kopya etiketi, %s içindeki diğer örnek" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "Hata: belirtilen yol bir dizin değil ya da sphinx dosyaları zaten var." -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (yerleşik işlev)" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sfenks-quickstart sadece boş bir dizin içine oluşturur. Lütfen yeni bir kök dizin yolu belirtin." -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: cmd/quickstart.py:810 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s yöntemi)" +msgid "Invalid template variable: %s" +msgstr "Geçersiz şablon değişkeni: %s" -#: domains/javascript.py:185 +#: directives/other.py:119 #, python-format -msgid "%s() (class)" -msgstr "%s() (sınıf)" +msgid "toctree glob pattern %r didn't match any documents" +msgstr "" -#: domains/javascript.py:187 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s (genel değişken veya sabit)" +msgid "toctree contains reference to excluded document %r" +msgstr "toctree, hariç tutulan %r belgesine başvuru içeriyor" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: directives/other.py:156 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s özniteliği)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Bağımsız Değişkenler" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Şunu verir: " - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Dönüşler" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Dönüş türü" +msgid "toctree contains reference to nonexisting document %r" +msgstr "toctree, varolmayan %r belgesine başvuru içeriyor" -#: domains/javascript.py:370 +#: directives/other.py:169 #, python-format -msgid "%s (module)" -msgstr "%s (modül)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "işlevi" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "yöntemi" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "sınıfı" +msgid "duplicated entry found in toctree: %s" +msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "verisi" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Bölümü hazırlayan: " -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "özniteliği" +#: directives/other.py:205 +msgid "Module author: " +msgstr "Modülü hazırlayan: " -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "modülü" +#: directives/other.py:207 +msgid "Code author: " +msgstr "Kodu hazırlayan: " -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "kopya %s açıklamasına ait %s, diğer %s, %s içinde" +#: directives/other.py:209 +msgid "Author: " +msgstr "Hazırlayan: " -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "%s sürümünde değişti" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "%s sürümünden beri kullanım dışı" +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (yönerge)" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "" -#: domains/rst.py:191 domains/rst.py:202 +#: directives/code.py:87 #, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (yönerge seçeneği)" +msgid "Invalid caption: %s" +msgstr "Geçersiz resim yazısı: %s" -#: domains/rst.py:224 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "%s (role)" -msgstr "%s (rol)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "yönergesi" - -#: domains/rst.py:235 -msgid "directive-option" -msgstr "yönerge seçeneği" - -#: domains/rst.py:236 -msgid "role" -msgstr "rolü" +msgid "line number spec is out of range(1-%d): %r" +msgstr "satır numarası özellikleri aralık dışında (1-%d): %r" -#: domains/rst.py:262 +#: directives/code.py:216 #, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "%s %s kopya açıklaması, %s içindeki diğer örnek" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "Hem \"%s\" hem de \"%s\" seçeneği kullanılamıyor" -#: domains/citation.py:75 +#: directives/code.py:231 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "%s kopya alıntısı, %s içindeki diğer örnek" +msgid "Include file '%s' not found or reading it failed" +msgstr "" -#: domains/citation.py:92 +#: directives/code.py:235 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "Alıntı [%s] kaynak gösterilmedi." - -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Dikkat" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Uyarı" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Tehlike" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Hata" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "İpucu" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "Önemli" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "Not" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "Ayrıca bakınız" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Tüyo" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Uyarı" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "modüllerden otomatik olarak docstrings ekle" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "doctest bloklarında kod parçacıklarını otomatik olarak dene" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "farklı projelerin Sphinx begelendirmeleri arasında bağlantıla" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "oluşturmada gösterilebilen veya gizlenebilen \"yapılacaklar\" girişlerini yaz" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "belgelendirme kapsamı için denetlemeler" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "PNG veya SVG resimleri olarak işleneni, matematiği dahil et" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "MathJax ile tarayıcıda işleneni, matematiği dahil et" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "yapılandırma değerlerine dayalı içeriğin koşullu olarak eklenmesi" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "belgelenmiş Python nesnelerinin kaynak koduna bağlantıları dahil et" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "belgeyi GitHub sayfalarında yayımlamak için .nojekyll dosyası oluştur" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "Lütfen geçerli bir yol adı girin." - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "Lütfen biraz metin girin." +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "" -#: cmd/quickstart.py:133 +#: directives/code.py:276 #, python-format -msgid "Please enter one of %s." -msgstr "Lütfen %s seçeneklerinden birini girin." - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "Lütfen ya 'y' ya da 'n' girin." +msgid "Object named %r not found in include file %r" +msgstr "%r adlı nesne, dahil edilen %r dosyasında bulunamadı" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "Lütfen bir dosya soneki girin, örn. '.rst' veya '.txt'." +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "Ayrık bir \"satır\" kümesiyle \"lineno-match\" kullanılamıyor" -#: cmd/quickstart.py:229 +#: directives/code.py:314 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "Sphinx %s hızlı başlangıç yardımcı uygulamasına hoş geldiniz." - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "Lütfen aşağıdaki ayarlar için değerleri girin (parantez içinde verilirse\nvarsayılan değeri kabul etmek için yalnızca Enter tuşuna basın)." +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Satır özelliği %r: dahil edilen %r dosyasından çekilen hiç satır yok" -#: cmd/quickstart.py:241 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format -msgid "Selected root path: %s" -msgstr "Seçilen kök dizin yolu: %s" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "Belgelendirme için kök dizin yolunu girin." - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "Belgelendirme için kök dizin yolu" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "Hata: seçilen kök dizin yolunda varolan bir conf.py bulundu." - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sfenks-quickstart varolan Sphinx projelerinin üzerine yazmayacak." - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "Lütfen yeni bir kök dizin yolu girin (ya da çıkmak için yalnızca Enter'a basın)" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "Sphinx çıktısının oluşturma dizinini yerleştirmek için iki seçeneğiniz var.\nYa, kök dizin yolu içinde bir \"_build\" dizini kullanın, ya da kök dizin yolu\niçinde \"source\" ve \"build\" dizinlerini ayırın." - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "Source ve build dizinlerini ayır (y/n)" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "Kök dizinin içinde, iki dizin daha oluşturulacaktır; özel HTML şablonları için \"_templates\"\nve özel stil sayfaları ve diğer sabit dosyalar için \"_static\".\nAlt çizgi yerine başka bir önek (\".\" gibi) girebilirsiniz." +msgid "%b %d, %Y" +msgstr "%d %b %Y" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "Templates ve static dizinleri için ad öneki" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Dizin" -#: cmd/quickstart.py:297 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"The project name will occur in several places in the built documentation." -msgstr "Proje adı, oluşturulan belgelendirmedeki çeşitli yerlerde oluşacak." - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "Proje adı" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "Hazırlayan ad(ları)ı" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "Dipnotlar" -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "Proje sürümü" +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" +msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "Proje yayımı" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[resim: %s]" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "Eğer belgeler İngilizce dışında bir dilde yazıldıysa, bunun dil koduna\ngöre burada bir dil seçebilirsiniz. Sphinx daha sonra, ürettiği metni o\ndile çevirecektir.\n\nDesteklenen kodların listesi için\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language adresine bakın." +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[resim]" -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "Proje dili" +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "Kaynak dosya soneki" +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" +msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "Bir belge, \"içindekiler ağacı\"nın üst düğümü olarak kabul edilmesi, yani\nbelgelerin hiyerarşik yapısının kökü olması açısından özeldir.\nNormalde bu \"dizin\"dir, ancak \"dizin\" belgeniz özel bir şablonsa,\nbunu başka bir dosya adına da ayarlayabilirsiniz." +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "Asıl belgenizin adı (sonek olmadan)" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "" + +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "" -#: cmd/quickstart.py:367 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "Hata: %s asıl dosyası zaten seçilen kök dizin yolunda bulundu." +msgid "unsupported rubric heading level: %s" +msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sfenks-quickstart varolan dosyanın üzerine yazmayacak." +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "Lütfen yeni bir dosya adı girin ya da varolan dosyayı yeniden adlandırın ve Enter tuşuna basın" +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "Aşağıdaki Sphinx uzantılarından hangisinin etkinleştirilmesi gerektiğini gösterir:" +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "Not: imgmath ve mathjax aynı anda etkinleştirilemez. imgmath seçimi kaldırıldı." +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "Makefile ve Windows komut dosyası sizin için oluşturulabilir,\nböylece doğrudan örn. sphinx-build çağırmak yerine sadece\n`make html' komutu çalıştırılmak zorundadır." +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "Makefile oluşturulsun mu? (y/n)" +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" +msgstr "%r dili için bilinen hiç Babel seçeneği yok" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "Windows komut satırı oluşturulsun mu? (y/n)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:616 #, python-format -msgid "Creating file %s." -msgstr "%s dosyası oluşturuluyor." +msgid "template %s not found; loading from legacy %s instead" +msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "%s dosyası zaten var, atlanıyor." +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "Tamamlandı: İlk dizin yapısı oluşturuldu." +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "" -#: cmd/quickstart.py:519 +#: writers/latex.py:1228 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "Artık %s asıl dosyanızı doldurmalı ve diğer belgelendirme kaynak dosyalarını\noluşturmalısınız." +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "Belgeleri oluşturmak için Makefile'ı kullanın, aşağıdaki gibi:\n make builder" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." +msgstr "" -#: cmd/quickstart.py:530 +#: writers/latex.py:1950 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "Belgeleri oluşturmak için sphinx-build komutunu kullanın, aşağıdaki gibi:\n sphinx-build -b builder %s %s" +msgid "unknown index entry type %s found" +msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "\"builder\" burada desteklenen oluşturuculardan biridir, örn. html, latex veya linkcheck." +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\nBir Sphinx projesi için gerekli dosyaları oluşturun.\n\nsphinx-quickstart, projeniz hakkında bazı sorular soran ve ardından tam bir\nbelgelendirme dizini ve örnek oluşturan etkileşimli bir araçtır\nMakefile, sphinx-build ile kullanılır.\n" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "sessiz kipi" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "proje kök dizini" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "Yapı seçenekleri" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "eğer belirtildiyse, kaynak ve oluşturma dizinlerini ayırın" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "_templates vb. içinde nokta için değiştirme" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "Proje temel seçenekleri" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "proje adı" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "hazırlayan adları" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "projenin sürümü" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "projenin yayımı" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "belge dili" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "kaynak dosya soneki" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "asıl belge adı" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "epub kullan" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "Uzantı seçenekleri" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" -msgstr "%s uzantısını etkinleştir" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "rasgele uzantıları etkinleştir" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Makefile ve Batchfile oluşturma" +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "makefile oluştur" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "makefile oluşturma" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "batchfile oluştur" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "batchfile oluşturma" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "Makefile/make.bat için make-mode kullan" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "Proje şablonlama" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "şablon dosyaları için şablon dizini" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" +msgstr "okuma hatası: %s, %s" -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "bir şablon değişkeni tanımla" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" +msgstr "yazma hatası: %s, %s" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "\"sessiz\" belirtilmiş, ancak herhangi bir \"proje\" veya \"hazırlayan\" belirtilmemiş." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" +msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "Hata: belirtilen yol bir dizin değil ya da sphinx dosyaları zaten var." +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." +msgstr "" -#: cmd/quickstart.py:792 +#: util/i18n.py:253 +#, python-format msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sfenks-quickstart sadece boş bir dizin içine oluşturur. Lütfen yeni bir kök dizin yolu belirtin." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "" -#: cmd/quickstart.py:809 +#: util/osutil.py:131 #, python-format -msgid "Invalid template variable: %s" -msgstr "Geçersiz şablon değişkeni: %s" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "iş numarası pozitif bir sayı olmalıdır" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "belgelendirme kaynak dosyaları için yol" +#: util/display.py:82 +msgid "skipped" +msgstr "atlandı" -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "çıktı dizini için yol" +#: util/display.py:87 +msgid "failed" +msgstr "başarısız oldu" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:114 -msgid "general options" -msgstr "genel seçenekler" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:131 +#: util/fileutil.py:76 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "tüm dosyaları yaz (varsayılan: sadece yeni ve değiştirilmiş dosyaları yaz)" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "kaydedilmiş bir ortam kullanma, her zaman tüm dosyaları oku" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" +msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:157 +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" +msgstr "varsayılan rol %s bulunamadı" + +#: util/nodes.py:462 +#, python-format msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "yapılandırma dosyasındaki bir ayarı geçersiz kıl" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "önceki sayfadan devam" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "HTML şablonlarına bir değer geçir" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "sonraki sayfaya devam" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "etiketi tanımla: \"sadece\" TAG'li blokları dahil et" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "Alfabetik olmayan" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Semboller" -#: cmd/build.py:212 -msgid "console output options" -msgstr "konsol çıktısı seçenekleri" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "Numaralar" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "ayrıntı seviyesini artır (tekrarlanabilir)" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "sayfa" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "stdout üzerinde çıktı yok, stderr üzerinde sadece uyarılar" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Yayım" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "hiç çıktı yok, hatta uyarılarda bile" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "renkli çıktı yayımı yap (varsayılan: otomatik algıla)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "renkli çıktı yayımı yapma (varsayılan: otomatik algıla)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "Bilinmeyen resim biçimi: %s..." -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "verilen dosyaya uyarıları (ve hataları) yaz" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "uyarıları hatalara dönüştür" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "özel durumda tam geri izleme göster" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "" + +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "Yarıda kesildi!" + +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "özel durumda Pdb çalıştır" +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "-a seçeneği ve dosya adları birleştirilemiyor" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "-D seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "-A seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "" + +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "Bir dahaki sefere daha iyi bir hata iletisi sağlanabilmesi için lütfen bunu bir kullanıcı hatasıysa da bildirin." #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "Yan çubuğu daralt" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "İçindekiler" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Gezinti" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "%(docstitle)s içinde ara" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Bu belgeler hakkında" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Ara" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Git" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Telif hakkı" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Son güncelleme: %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Önceki konu" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "önceki bölüm" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Sonraki konu" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "sonraki bölüm" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Tek sayfada tam dizin" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Bu Sayfa" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Kaynağı Göster" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "İçindekiler" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Hızlı Arama" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "%(docstitle)s ara" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Git" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2685,7 +2885,7 @@ msgstr "Genel Modül Dizini" msgid "quick access to all modules" msgstr "tüm modüllere hızlı erişim" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Genel Dizin" @@ -2693,23 +2893,15 @@ msgstr "Genel Dizin" msgid "all functions, classes, terms" msgstr "tüm işlevler, sınıflar, terimler" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Bu Sayfa" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "İçindekiler" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Tek sayfada tam dizin" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Hızlı Arama" +msgid "Search %(docstitle)s" +msgstr "%(docstitle)s ara" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2719,57 +2911,6 @@ msgstr "Harfe göre dizin sayfaları" msgid "can be huge" msgstr "çok büyük olabilir" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Önceki konu" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "önceki bölüm" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Sonraki konu" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "sonraki bölüm" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Gezinti" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "%(docstitle)s içinde ara" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Bu belgeler hakkında" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Telif hakkı" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Son güncelleme: %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2786,21 +2927,21 @@ msgstr "" msgid "search" msgstr "ara" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Arama Eşleşmelerini Gizle" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "İçindekiler" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Arama Sonuçları" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Arama sonucunda herhangi bir belge bulunamadı. Bütün kelimeleri doğru yazdığınızdan ve gerekli bütün kategorileri seçtiğinizden emin olun." -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2808,22 +2949,21 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "Aranıyor" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "Aramaya hazırlanıyor..." -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ", şunun içinde:" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Arama Eşleşmelerini Gizle" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2831,6 +2971,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Sürüm %(version)s — %(docstitle)s içindeki Değişiklikler" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2852,216 +2997,216 @@ msgstr "Diğer değişiklikler" msgid "Expand sidebar" msgstr "Yan çubuğu genişlet" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Parametreler" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Değişkenler" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Harekete geçirir" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s modülü içinde)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (%s modülü içinde)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (yerleşik değişken)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (yerleşik sınıf)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (%s içindeki sınıf)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s sınıf yöntemi)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s sabit yöntemi)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python Modül Dizini" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "modülleri" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Kullanım dışı" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "özel durum" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "sınıf yöntemi" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "sabit yöntemi" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "çapraz referans %r için birden fazla hedef bulundu: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (kullanım dışı)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Parametreler" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Değişkenler" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Harekete geçirir" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" msgstr "Şablon Parametreleri" #: domains/cpp/__init__.py:302 -#, python-format -msgid "%s (C++ %s)" -msgstr "%s (C++ %s)" - -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" +#, python-format +msgid "%s (C++ %s)" +msgstr "%s (C++ %s)" -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "birliği" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "üyesi" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "türü" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "kavramı" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "numaralandırıcı" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "değişkeni" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "makrosu" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "ortam değişkeni; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3156,1063 +3301,1008 @@ msgstr "" msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "dairesel toctree kaynakları algılandı, yoksayılan: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "toctree, başlığı olmayan %r belgesine başvuru içeriyor: hiç bağlantı oluşturulmayacaktır" - -#: environment/adapters/toctree.py:364 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "toctree contains reference to non-included document %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: environment/adapters/toctree.py:367 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "toctree contains reference to non-existing document %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "bakınız %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "ayrıca bakınız %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "bilinmeyen dizin girişi türü %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Semboller" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "resim dosyası okunabilir değil: %s" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "%s resim dosyası okunabilir değil: %s" - -#: environment/collectors/asset.py:163 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "download file not readable: %s" -msgstr "indirme dosyası okunabilir değil: %s" +msgid "malformed string literal (missing closing quote): %s" +msgstr "" -#: environment/collectors/toctree.py:259 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s zaten atanmış bölüm numaralarıdır (iç içe numaralı toctree mi?)" +msgid "malformed string literal (missing opening quote): %s" +msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "Yarıda kesildi!" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "Örnek" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Örnekler" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "Notlar" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "Diğer Parametreler" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "Kaynaklar" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "Uyarılar" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "Bir dahaki sefere daha iyi bir hata iletisi sağlanabilmesi için lütfen bunu bir kullanıcı hatasıysa da bildirin." +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "Getiriler" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "alias of %s" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "Bases: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "%r reference target not found: %s" +msgid "invalid value for member-order option: %s" msgstr "" -#: transforms/post_transforms/images.py:79 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "Unknown image format: %s..." -msgstr "Bilinmeyen resim biçimi: %s..." +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "" -#: builders/html/__init__.py:113 +#: ext/autodoc/_names.py:89 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "HTML sayfaları %(outdir)s içinde." +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/__init__.py:348 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to read build info file: %r" -msgstr "oluşturma bilgisi dosyasını okuma başarısız: %r" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:383 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "dizin" - -#: builders/html/__init__.py:560 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "Logo of %s" -msgstr "" - -#: builders/html/__init__.py:589 -msgid "next" -msgstr "sonraki" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "önceki" +msgid "Would create file %s." +msgstr "%s dosyası oluşturur." -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "dizinler oluşturuluyor" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\nPython modülleri ve paketleri için içine art arda bakın ve içindeki\npaket başına otomodül talimatlarını içeren bir reST dosyası oluşturun.\n\n'ler, nesilden hariç tutulacak olan dosya ve/veya dizin şekilleri olabilir.\n\nNot: Varsayılan olarak bu betik zaten oluşturulmuş dosyaların üzerine yazmayacak." -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "ilave sayfalar yazılıyor" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "belge için modüle giden yol" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "nesilden hariç tutmak için fnmatch-style dosyası ve/veya dizin şekilleri" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "indirilebilir dosyalar kopyalanıyor..." +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "tüm çıktıların yerleştirileceği dizin" -#: builders/html/__init__.py:818 -#, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "indirilebilir dosya %r kopyalanamıyor: %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "TOC'da gösterilecek alt modüllerin en fazla derinliği (varsayılan: 4)" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "varolan dosyaların üzerine yaz" -#: builders/html/__init__.py:882 -#, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "sembolik bağlantıları takip edin. Collective.recipe.omelette ile birleştirildiğinde güçlü." -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "dosyaları oluşturmadan betiği çalıştır" -#: builders/html/__init__.py:934 -#, python-format -msgid "cannot copy static file %r" -msgstr "sabit dosya %r kopyalanamıyor" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "her modül için belgelendirmeyi kendi sayfasına koy" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "fazladan dosyalar kopyalanıyor" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "\"_private\" modülleri dahil" -#: builders/html/__init__.py:949 -#, python-format -msgid "cannot copy extra file %r" -msgstr "fazladan dosya %r kopyalanamıyor..." +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "içindekiler dosyası adı (varsayılan: modüller)" -#: builders/html/__init__.py:955 -#, python-format -msgid "Failed to write build info file: %r" -msgstr "oluşturma bilgisi dosyasını yazma başarısız: %r" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "içindekiler tablosu oluşturma" -#: builders/html/__init__.py:1005 +#: ext/apidoc/_cli.py:135 msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "arama dizini yüklenemedi, ancak tüm belgeler oluşturulmayacaktır: dizin tamamlanmamış olacaktır." +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "modül/paket paketleri için başlıklar oluşturma (örn. docstrings zaten bunları içerdiğinde)" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "sayfa %s html_sidebars içinde iki şekille eşleşiyor: %r ve %r" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "modül belgelerini alt modül belgelerinin önüne koyun" -#: builders/html/__init__.py:1216 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "%s sayfasını işlerken bir Evrensel kod hatası meydana geldi. Lütfen ASCII olmayan içerik içeren tüm yapılandırma değerlerinin Evrensel kod dizgiler olduğundan emin olun." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "modül yollarını PEP-0420 kapalı ad alanları özelliklerine göre yorumla" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "%s sayfasını işlerken bir hata oldu.\nSebep: %r" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "nesne envanteri dökümleniyor" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "dosya soneki (varsayılan: rst)" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "%s içinde arama dizini dökümleniyor" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "geçersiz js_file: %r, yoksayıldı" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "sphinx-quickstart ile tam bir proje oluştur" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "Birçok math_renderers kayıtlı. Ama hiç math_renderer seçilmedi." +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "--full yazıldığında, append module_path to sys.path, kullanılır" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "Bilinmeyen math_renderer %r verildi." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "proje adı (varsayılan: kök modül adı)" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "html_extra_path girişi %r, çıktı dizini içine yerleştirildi" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "--full yazıldığında, proje hazırlayan(lar)ı kullanılır" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "html_extra_path girişi %r mevcut değil" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "--full yazıldığında, proje sürümü kullanılır" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "html_static_path girişi %r, çıktı dizini içine yerleştirildi" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "--full yazıldığında, varsayılanı to --doc-version, proje yayımı kullanılır" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" -msgstr "html_static_path girişi %r mevcut değil" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "uzantı seçenekleri" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "logo dosyası %r mevcut değil" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1407 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "favicon file %r does not exist" -msgstr "favicon dosyası %r mevcut değil" +msgid "enable %s extension, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." -msgstr "" +msgid "%s is not a directory." +msgstr "%s bir dizin değil." -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "%s %s documentation" -msgstr "%s %s belgelendirmesi" - -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "LaTeX dosyaları %(outdir)s içinde." - -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\n(pdf)latex aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın\n(bunu otomatik olarak yapmak için burada 'make latexpdf' komutunu kullanın)." - -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "hiçbir \"latex_documents\" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "\"latex_documents\" yapılandırma değeri bilinmeyen %s belgesine başvurur" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Yayım" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "TeX destek dosyaları kopyalanıyor" - -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "ilave dosyalar kopyalanıyor" +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "Bilinmeyen yapılandırma anahtarı: latex_elements[%r], yoksayıldı." +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r, \"theme\" ayarına sahip değil" +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r, \"%s\" ayarına sahip değil" - -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "önceki sayfadan devam" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "sonraki sayfaya devam" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "Alfabetik olmayan" - -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "Numaralar" - -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "sayfa" - -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "Örnek" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Örnekler" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "Notlar" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "Diğer Parametreler" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "Kaynaklar" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "Uyarılar" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "Getiriler" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "" - -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" +"Possible hints:\n" +"%s" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 -#, python-format +#: ext/intersphinx/_load.py:324 msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "" - -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_load.py:332 #, python-format -msgid "Failed to remove %s: %s" -msgstr "" - -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\nPython modülleri ve paketleri için içine art arda bakın ve içindeki\npaket başına otomodül talimatlarını içeren bir reST dosyası oluşturun.\n\n'ler, nesilden hariç tutulacak olan dosya ve/veya dizin şekilleri olabilir.\n\nNot: Varsayılan olarak bu betik zaten oluşturulmuş dosyaların üzerine yazmayacak." - -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "belge için modüle giden yol" - -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "nesilden hariç tutmak için fnmatch-style dosyası ve/veya dizin şekilleri" - -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "tüm çıktıların yerleştirileceği dizin" - -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "TOC'da gösterilecek alt modüllerin en fazla derinliği (varsayılan: 4)" - -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "varolan dosyaların üzerine yaz" - -#: ext/apidoc/_cli.py:91 msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "sembolik bağlantıları takip edin. Collective.recipe.omelette ile birleştirildiğinde güçlü." - -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "dosyaları oluşturmadan betiği çalıştır" - -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "her modül için belgelendirmeyi kendi sayfasına koy" - -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "\"_private\" modülleri dahil" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "içindekiler dosyası adı (varsayılan: modüller)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "intersphinx envanteri taşındı: %s -> %s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "içindekiler tablosu oluşturma" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" +msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "modül/paket paketleri için başlıklar oluşturma (örn. docstrings zaten bunları içerdiğinde)" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "(%s içinde)" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "modül belgelerini alt modül belgelerinin önüne koyun" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "modül yollarını PEP-0420 kapalı ad alanları özelliklerine göre yorumla" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "" -#: ext/apidoc/_cli.py:160 -msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "dosya soneki (varsayılan: rst)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "sphinx-quickstart ile tam bir proje oluştur" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "--full yazıldığında, append module_path to sys.path, kullanılır" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "proje adı (varsayılan: kök modül adı)" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "--full yazıldığında, proje hazırlayan(lar)ı kullanılır" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "--full yazıldığında, proje sürümü kullanılır" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "--full yazıldığında, varsayılanı to --doc-version, proje yayımı kullanılır" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "uzantı seçenekleri" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "%s is not a directory." -msgstr "%s bir dizin değil." +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "alias of TypeVar(%s)" +msgstr "" + +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:114 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "HTML sayfaları %(outdir)s içinde." -#: ext/apidoc/_extension.py:210 +#: builders/html/__init__.py:337 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "Failed to read build info file: %r" +msgstr "oluşturma bilgisi dosyasını okuma başarısız: %r" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:247 -#, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_generate.py:69 -#, python-format -msgid "Would create file %s." -msgstr "%s dosyası oluşturur." +#: builders/html/__init__.py:496 +msgid "index" +msgstr "dizin" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:549 #, python-format -msgid "(in %s v%s)" -msgstr "(%s v%s içinde)" +msgid "Logo of %s" +msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" -msgstr "(%s içinde)" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "sonraki" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "önceki" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "dizinler oluşturuluyor" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "ilave sayfalar yazılıyor" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "indirilebilir dosyalar kopyalanıyor..." + +#: builders/html/__init__.py:807 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "indirilebilir dosya %r kopyalanamıyor: %s" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:853 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:871 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "" +msgid "cannot copy static file %r" +msgstr "sabit dosya %r kopyalanamıyor" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "fazladan dosyalar kopyalanıyor" + +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +msgid "cannot copy extra file %r" +msgstr "fazladan dosya %r kopyalanamıyor..." -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "oluşturma bilgisi dosyasını yazma başarısız: %r" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "arama dizini yüklenemedi, ancak tüm belgeler oluşturulmayacaktır: dizin tamamlanmamış olacaktır." -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "sayfa %s html_sidebars içinde iki şekille eşleşiyor: %r ve %r" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "%s sayfasını işlerken bir Evrensel kod hatası meydana geldi. Lütfen ASCII olmayan içerik içeren tüm yapılandırma değerlerinin Evrensel kod dizgiler olduğundan emin olun." -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "%s sayfasını işlerken bir hata oldu.\nSebep: %r" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "nesne envanteri dökümleniyor" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" - -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +msgid "dumping search index in %s" +msgstr "%s içinde arama dizini dökümleniyor" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1313 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." -msgstr "" +msgid "invalid js_file: %r, ignored" +msgstr "geçersiz js_file: %r, yoksayıldı" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "Birçok math_renderers kayıtlı. Ama hiç math_renderer seçilmedi." -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "aşağıdaki sorunlardan dolayı envanterlerden herhangi birine ulaşılamadı:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." +msgstr "Bilinmeyen math_renderer %r verildi." -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1365 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "intersphinx envanteri taşındı: %s -> %s" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "html_extra_path girişi %r, çıktı dizini içine yerleştirildi" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1370 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "html_extra_path girişi %r mevcut değil" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "html_static_path girişi %r, çıktı dizini içine yerleştirildi" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "" +msgid "html_static_path entry %r does not exist" +msgstr "html_static_path girişi %r mevcut değil" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "" +msgid "logo file %r does not exist" +msgstr "logo dosyası %r mevcut değil" + +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "favicon dosyası %r mevcut değil" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" -msgstr "" +msgid "%s %s documentation" +msgstr "%s %s belgelendirmesi" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:87 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r, \"theme\" ayarına sahip değil" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/theming.py:90 +#, python-format +msgid "%r doesn't have \"%s\" setting" +msgstr "%r, \"%s\" ayarına sahip değil" + +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "LaTeX dosyaları %(outdir)s içinde." + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\n(pdf)latex aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın\n(bunu otomatik olarak yapmak için burada 'make latexpdf' komutunu kullanın)." -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "hiçbir \"latex_documents\" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "\"latex_documents\" yapılandırma değeri bilinmeyen %s belgesine başvurur" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "TeX destek dosyaları kopyalanıyor" + +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "ilave dosyalar kopyalanıyor" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "Bilinmeyen yapılandırma anahtarı: latex_elements[%r], yoksayıldı." -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/toctree.py:259 #, python-format -msgid "missing attribute %s in object %s" -msgstr "" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s zaten atanmış bölüm numaralarıdır (iç içe numaralı toctree mi?)" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:98 #, python-format -msgid "alias of %s" -msgstr "" +msgid "image file not readable: %s" +msgstr "resim dosyası okunabilir değil: %s" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "" +msgid "image file %s not readable: %s" +msgstr "%s resim dosyası okunabilir değil: %s" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/collectors/asset.py:165 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "" +msgid "download file not readable: %s" +msgstr "indirme dosyası okunabilir değil: %s" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "dairesel toctree kaynakları algılandı, yoksayılan: %s <- %s" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "toctree, başlığı olmayan %r belgesine başvuru içeriyor: hiç bağlantı oluşturulmayacaktır" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" + +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "bakınız %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "ayrıca bakınız %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" +msgstr "bilinmeyen dizin girişi türü %r" diff --git a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo index 3a1a4a6d610..23c7775b279 100644 Binary files a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo and b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po index 0b66c812a91..f827356fdba 100644 --- a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Petro Sasnyk , 2009\n" "Language-Team: Ukrainian (Ukraine) (http://app.transifex.com/sphinx-doc/sphinx-1/language/uk_UA/)\n" @@ -19,6 +19,127 @@ msgstr "" "Language: uk_UA\n" "Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n % 10 == 1 && n % 100 != 11 ? 0 : n % 1 == 0 && n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14) ? 1 : n % 1 == 0 && (n % 10 ==0 || (n % 10 >=5 && n % 10 <=9) || (n % 100 >=11 && n % 100 <=14 )) ? 2: 3);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -33,127 +154,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +322,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,468 +537,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Увага" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Застереження" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Небезпека" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Помилка" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Підказка" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Важливо" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Примітка" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Дивись також" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Порада" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Попередження" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (в " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "error writing file %s: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:436 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/doctest.py:297 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/doctest.py:457 -#, python-format -msgid "no code/output in %s block at %s:%s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:594 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:342 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:536 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:545 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:556 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Вбудовані елементи" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Рівень модуля" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -739,9 +1175,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -776,6 +1213,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Доробити" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -863,947 +1328,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Доробити" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:47 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:124 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Автор секції: " - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Автор модуля: " - -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " -msgstr "Автор: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Вбудовані елементи" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "Рівень модуля" - -#: builders/changes.py:124 -msgid "copying source files..." +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:133 +#: domains/citation.py:75 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/citation.py:92 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" - -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" - -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/manpage.py:71 +#: domains/math.py:73 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/__init__.py:224 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:183 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +msgid "%s() (built-in function)" +msgstr "%s() (вбудована функція)" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s метод)" -#: builders/__init__.py:275 +#: domains/javascript.py:186 #, python-format -msgid "all of %d po files" -msgstr "" +msgid "%s() (class)" +msgstr "%s() (клас)" -#: builders/__init__.py:297 +#: domains/javascript.py:188 #, python-format -msgid "targets for %d po files that are specified" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (%s атрибут)" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Повертає" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Тип повернення" -#: builders/__init__.py:361 +#: domains/javascript.py:374 #, python-format -msgid "%d source files given on command line" +msgid "%s (module)" +msgstr "%s (модуль)" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "функція" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "клас" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "атрибут" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "модуль" + +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "" +msgid "Changed in version %s" +msgstr "Змінено в версії %s" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid "Deprecated since version %s" +msgstr "Застаріло починаючи з версії %s" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "" - -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (в " - -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%b %d, %Y" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:298 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:350 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:520 +#, python-format +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:379 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" + +#: cmd/quickstart.py:664 +msgid "Extension options" msgstr "" -#: util/nodes.py:706 +#: cmd/quickstart.py:671 #, python-format -msgid "exception while evaluating only directive expression: %s" +msgid "enable %s extension" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" msgstr "" -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: util/fileutil.py:76 -#, python-format +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/rst.py:73 +#: cmd/quickstart.py:810 #, python-format -msgid "default role %s not found" +msgid "Invalid template variable: %s" msgstr "" -#: util/inventory.py:147 +#: directives/other.py:119 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/inventory.py:166 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "toctree contains reference to excluded document %r" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: writers/manpage.py:289 writers/text.py:945 +#: directives/other.py:169 #, python-format -msgid "[image: %s]" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:203 +msgid "Section author: " +msgstr "Автор секції: " + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Автор модуля: " + +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" -msgstr "Індекс" +#: directives/other.py:209 +msgid "Author: " +msgstr "Автор: " + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr "" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" msgstr "" -#: writers/latex.py:1183 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%b %d, %Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "Індекс" + +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1832,6 +2343,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1848,794 +2364,478 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr "" + +#: writers/latex.py:616 #, python-format -msgid "%s() (built-in function)" -msgstr "%s() (вбудована функція)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s метод)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (клас)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s атрибут)" - -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Повертає" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Тип повернення" - -#: domains/javascript.py:370 +#: writers/latex.py:1228 #, python-format -msgid "%s (module)" -msgstr "%s (модуль)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "функція" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "клас" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "атрибут" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "модуль" - -#: domains/javascript.py:454 +#: writers/latex.py:1615 #, python-format -msgid "duplicate %s description of %s, other %s in %s" +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/changeset.py:26 +#: writers/latex.py:1950 #, python-format -msgid "Added in version %s" +msgid "unknown index entry type %s found" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Змінено в версії %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Застаріло починаючи з версії %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/rst.py:236 -msgid "role" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Увага" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Застереження" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Небезпека" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "Помилка" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Підказка" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Важливо" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Примітка" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Дивись також" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Порада" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Попередження" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:133 +#: util/i18n.py:100 #, python-format -msgid "Please enter one of %s." +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:229 +#: util/i18n.py:244 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:234 +#: util/i18n.py:253 +#, python-format msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:241 +#: util/osutil.py:131 #, python-format -msgid "Selected root path: %s" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "" - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "" - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "" - -#: cmd/quickstart.py:367 +#: util/fileutil.py:76 #, python-format msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "" - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "" - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "" - -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: util/fileutil.py:89 #, python-format -msgid "File %s already exists, skipping." -msgstr "" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:519 +#: util/docfields.py:103 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "" - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:530 +#: util/rst.py:73 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:670 +#: util/nodes.py:462 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "" - -#: cmd/quickstart.py:809 +#: util/nodes.py:523 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "Реліз" -#: cmd/build.py:212 -msgid "console output options" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Навігація" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Шукати в %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Про ці документи" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Пошук" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Вперед" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Авторські права" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Востаннє оновлено %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Попередній розділ" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "Попередній розділ" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Наступна тема" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "наступний розділ" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Повний індекс на одній сторінці" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "Ця сторінка" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Відобразити вихідний текст" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "Швидкий пошук" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Пошук %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Вперед" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2661,111 +2861,52 @@ msgstr "Індекси та таблиці:" msgid "Complete Table of Contents" msgstr "Повний Зміст" -#: themes/basic/defindex.html:17 -msgid "lists all sections and subsections" -msgstr "перелічити всі секції та підсекції" - -#: domains/std/__init__.py:773 domains/std/__init__.py:786 -#: themes/basic/defindex.html:18 -msgid "Search Page" -msgstr "Сторінка пошуку" - -#: themes/basic/defindex.html:19 -msgid "search this documentation" -msgstr "шукати цю документацію" - -#: themes/basic/defindex.html:21 -msgid "Global Module Index" -msgstr "Загальний індекс модулів" - -#: themes/basic/defindex.html:22 -msgid "quick access to all modules" -msgstr "швидкий доступ до всіх модулів" - -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 -msgid "General Index" -msgstr "Загальний індекс" - -#: themes/basic/defindex.html:24 -msgid "all functions, classes, terms" -msgstr "всі функції, класи, терміни" - -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "Ця сторінка" - -#: themes/basic/genindex-single.html:26 -#, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Повний індекс на одній сторінці" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "Швидкий пошук" - -#: themes/basic/genindex-split.html:8 -msgid "Index pages by letter" -msgstr "Індексні сторінки по символам" - -#: themes/basic/genindex-split.html:17 -msgid "can be huge" -msgstr "може бути величезним" - -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Попередній розділ" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "Попередній розділ" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "перелічити всі секції та підсекції" -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Наступна тема" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "Сторінка пошуку" -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "наступний розділ" +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "шукати цю документацію" -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Навігація" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "Загальний індекс модулів" -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Шукати в %(docstitle)s" +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "швидкий доступ до всіх модулів" -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Про ці документи" +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "Загальний індекс" -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Авторські права" +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "всі функції, класи, терміни" -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/layout.html:201 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Востаннє оновлено %(last_updated)s." +msgid "Search %(docstitle)s" +msgstr "Пошук %(docstitle)s" -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "Індексні сторінки по символам" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "може бути величезним" #: themes/basic/search.html:20 msgid "" @@ -2783,21 +2924,21 @@ msgstr "" msgid "search" msgstr "пошук" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "Приховати співпадіння пошуку" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "Результати пошуку" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2807,22 +2948,21 @@ msgstr[1] "" msgstr[2] "" msgstr[3] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "Приховати співпадіння пошуку" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2830,6 +2970,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2851,121 +2996,128 @@ msgstr "Інші зміни" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Параметри" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Викликає" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (в модулі %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (в модулі %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (вбудована змінна)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (вбудований клас)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (клас в %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s статичний метод)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "модулі" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Застарілий" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "виняткова ситуація" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "статичний метод" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr " (застарілий)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Параметри" - -#: domains/python/_object.py:206 -msgid "Variables" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Викликає" - #: domains/cpp/__init__.py:159 msgid "Template Parameters" msgstr "" @@ -2975,92 +3127,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "член" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "тип" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "макрос" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "змінна оточення; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3089,580 +3234,488 @@ msgid "glossary seems to be misformatted, check indentation" msgstr "" #: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "змінна оточення" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "Індекс модулів" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "змінна оточення" + +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "Індекс модулів" + +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1138 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1153 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1157 #, python-format -msgid "%r reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1453 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:199 +#, python-format +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "індекс" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "наступний" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "попередній" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 +#, python-format +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "Реліз" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3670,548 +3723,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "індекс" + +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "наступний" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "попередній" + +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/ur/LC_MESSAGES/sphinx.mo b/sphinx/locale/ur/LC_MESSAGES/sphinx.mo index ea84f2268c9..b0744382455 100644 Binary files a/sphinx/locale/ur/LC_MESSAGES/sphinx.mo and b/sphinx/locale/ur/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/ur/LC_MESSAGES/sphinx.po b/sphinx/locale/ur/LC_MESSAGES/sphinx.po index c389950421f..10793aaf5e2 100644 --- a/sphinx/locale/ur/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/ur/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Urdu (http://app.transifex.com/sphinx-doc/sphinx-1/language/ur/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: ur\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,21 +2923,21 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" @@ -2804,21 +2945,20 @@ msgid_plural "" msgstr[0] "" msgstr[1] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2827,6 +2967,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2848,119 +2993,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2972,92 +3124,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3085,581 +3230,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3667,548 +3720,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/vi/LC_MESSAGES/sphinx.mo b/sphinx/locale/vi/LC_MESSAGES/sphinx.mo index ab9182df44d..6e40d5f6d96 100644 Binary files a/sphinx/locale/vi/LC_MESSAGES/sphinx.mo and b/sphinx/locale/vi/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/vi/LC_MESSAGES/sphinx.po b/sphinx/locale/vi/LC_MESSAGES/sphinx.po index 9fc4f9321ab..22ae9985e9d 100644 --- a/sphinx/locale/vi/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/vi/LC_MESSAGES/sphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: Hoat Le Van , 2014\n" "Language-Team: Vietnamese (http://app.transifex.com/sphinx-doc/sphinx-1/language/vi/)\n" @@ -19,6 +19,127 @@ msgstr "" "Language: vi\n" "Plural-Forms: nplurals=1; plural=0;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Các đề nghị nâng cao Python; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -33,127 +154,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -161,12 +309,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -174,82 +322,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -257,468 +537,624 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format -msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +msgid "The configuration has changed (%d options: %s, ...)" msgstr "" -#: theming.py:282 -#, python-format -msgid "The %r theme has too many ancestors" +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:310 +#: environment/__init__.py:518 #, python-format -msgid "no theme configuration file found in %r" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:335 theming.py:388 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "theme %r doesn't have the \"theme\" table" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:343 theming.py:391 -#, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:347 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme \"[options]\" table is not a table" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "Chú ý" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "Cảnh báo" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "Nguy hiểm" + +#: locale/__init__.py:232 +msgid "Error" +msgstr "Lỗi" + +#: locale/__init__.py:233 +msgid "Hint" +msgstr "Gợi ý" + +#: locale/__init__.py:234 +msgid "Important" +msgstr "Quan trọng" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "Ghi chú" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "Xem thêm" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "Mẹo" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "Cảnh báo" -#: events.py:416 +#: builders/texinfo.py:41 #, python-format -msgid "Handler %r for event %r threw an exception" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: project.py:72 -#, python-format +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" +msgid "processing %s" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr "(trong" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" +msgid "building [%s]: " msgstr "" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "targets for %d template files" msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: registry.py:552 +#: builders/linkcheck.py:87 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: registry.py:565 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "broken link: %s (%s)" msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "Anchor '%s' not found" msgstr "" -#: registry.py:612 -#, python-format -msgid "`None` is not a valid filetype for %r." +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:206 +#: builders/linkcheck.py:799 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: roles.py:229 +#: builders/epub3.py:83 #, python-format -msgid "invalid CVE number %s" +msgid "The ePub file is in %(outdir)s." msgstr "" -#: roles.py:251 -#, python-format -msgid "Common Weakness Enumeration; CWE %s" +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: roles.py:274 -#, python-format -msgid "invalid CWE number %s" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: roles.py:294 -#, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Các đề nghị nâng cao Python; PEP %s" - -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: roles.py:355 -#, python-format -msgid "invalid RFC number %s" +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/autosectionlabel.py:52 +#: builders/xml.py:29 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +msgid "The XML files are in %(outdir)s." msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "duplicate label %s, other instance in %s" +msgid "error writing file %s: %s" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/_epub_base.py:223 +#, python-format +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:118 +#: builders/_epub_base.py:436 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:124 +#: builders/_epub_base.py:467 #, python-format -msgid "'%s' is not a valid option." +msgid "cannot write image file %r: %s" msgstr "" -#: ext/doctest.py:139 -#, python-format -msgid "'%s' is not a valid pyversion option" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/doctest.py:297 -#, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/doctest.py:457 -#, python-format -msgid "no code/output in %s block at %s:%s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:594 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "unknown mimetype for %s, ignoring" +msgstr "" + +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" + +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " msgstr "" -#: ext/imgmath.py:162 +#: builders/__init__.py:342 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" msgstr "" -#: ext/imgmath.py:181 +#: builders/__init__.py:536 #, python-format msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/imgmath.py:344 +#: builders/__init__.py:545 #, python-format -msgid "display latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/imgmath.py:380 +#: builders/__init__.py:556 #, python-format -msgid "inline latex %r: %s" +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "Dựng sẵn" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "Mức mô-đun" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" msgstr "" #: ext/coverage.py:48 @@ -739,9 +1175,10 @@ msgid "" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -776,6 +1213,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -863,1779 +1328,1514 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" +#: ext/imgmath.py:148 +#, python-format +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:94 +#: ext/imgmath.py:167 #, python-format -msgid "TODO entry found: %s" +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:362 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "inline latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:124 #, python-format -msgid "Invalid caption: %s" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:139 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "" + +#: ext/doctest.py:297 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:231 +#: ext/doctest.py:451 #, python-format -msgid "Include file '%s' not found or reading it failed" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:568 #, python-format -msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:276 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Object named %r not found in include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/code.py:314 +#: ext/duration.py:47 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/patches.py:71 +#: ext/duration.py:117 msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:119 +#: ext/duration.py:124 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 -#, python-format -msgid "toctree contains reference to excluded document %r" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:156 +#: ext/duration.py:139 #, python-format -msgid "toctree contains reference to nonexisting document %r" +msgid "%.3fs %s" msgstr "" -#: directives/other.py:169 -#, python-format -msgid "duplicated entry found in toctree: %s" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "Tác giả mục:" - -#: directives/other.py:205 -msgid "Module author: " -msgstr "Tác giả mô-đun:" - -#: directives/other.py:207 -msgid "Code author: " -msgstr "Tác giả mã lệnh:" - -#: directives/other.py:209 -msgid "Author: " -msgstr "Tác giả:" - -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" -msgstr "Dựng sẵn" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "Mức mô-đun" - -#: builders/changes.py:124 -msgid "copying source files..." +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:133 +#: domains/citation.py:75 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/citation.py:92 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "" - -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "" - -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/manpage.py:71 +#: domains/math.py:73 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/__init__.py:224 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:183 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "" +msgid "%s() (built-in function)" +msgstr "%s() (hàm dựng sẵn)" -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (phương thức %s)" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "" +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s() (lớp)" -#: builders/__init__.py:275 +#: domains/javascript.py:188 #, python-format -msgid "all of %d po files" -msgstr "" +msgid "%s (global variable or constant)" +msgstr "%s (biến toàn cục hoặc hằng số)" -#: builders/__init__.py:297 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "targets for %d po files that are specified" -msgstr "" +msgid "%s (%s attribute)" +msgstr "%s (thuộc tính %s)" + +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "Đối số" + +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "Ném" -#: builders/__init__.py:309 +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "Trả về" + +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "Kiểu trả về" + +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "" +msgid "%s (module)" +msgstr "%s (mô-đun)" -#: builders/__init__.py:319 -msgid "all source files" -msgstr "" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "hàm" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "phương thức" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "lớp" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "dữ liệu" -#: builders/__init__.py:330 +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "thuộc tính" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "mô-đun" + +#: domains/javascript.py:458 #, python-format -msgid "file %r given on command line does not exist, " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:337 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "" +msgid "%s (directive)" +msgstr "%s (chỉ thị)" -#: builders/__init__.py:348 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:361 +#: domains/rst.py:224 #, python-format -msgid "%d source files given on command line" +msgid "%s (role)" +msgstr "%s (vai trò)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "chỉ thị" + +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:377 +#: domains/rst.py:236 +msgid "role" +msgstr "vai trò" + +#: domains/rst.py:262 #, python-format -msgid "targets for %d source files that are out of date" +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/changeset.py:32 #, python-format -msgid "building [%s]: " +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "Thay đổi trong phiên bản %s" -#: builders/__init__.py:410 +#: domains/changeset.py:34 #, python-format -msgid "%d found" -msgstr "" +msgid "Deprecated since version %s" +msgstr "Sắp loại bỏ từ phiên bản %s" -#: builders/__init__.py:412 -msgid "none found" +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" + +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:494 -#, python-format -msgid "%s added, %s changed, %s removed" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:531 -#, python-format +#: cmd/build.py:109 msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/__init__.py:540 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/__init__.py:551 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/__init__.py:558 -#, python-format +#: cmd/build.py:131 msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" + +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/texinfo.py:45 +#: cmd/build.py:357 #, python-format -msgid "The Texinfo files are in %(outdir)s." +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr "(trong" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:134 +#, python-format +msgid "Please enter one of %s." msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/_epub_base.py:591 +#: cmd/quickstart.py:230 #, python-format -msgid "unknown mimetype for %s, ignoring" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:242 +#, python-format +msgid "Selected root path: %s" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:274 +msgid "" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format +#: cmd/quickstart.py:324 msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%d/%m/%Y" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "" -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: transforms/__init__.py:253 +#: cmd/quickstart.py:368 #, python-format msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "" + +#: cmd/quickstart.py:520 +#, python-format msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "" - -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "" - -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "" - -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "" - -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "" - -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "" - -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "" - -#: _cli/__init__.py:231 -msgid "" -msgstr "" - -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "" - -#: environment/__init__.py:86 -msgid "new config" -msgstr "" - -#: environment/__init__.py:87 -msgid "config changed" -msgstr "" - -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "" - -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "" - -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "" - -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" - -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" - -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" - -#: environment/__init__.py:379 +#: cmd/quickstart.py:527 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "" - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "" - -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "" - -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "" - -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "" - -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" - -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "" - -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" -msgstr "" - -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" -msgstr "" - -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" - -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "" - -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "" - -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "" - -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "" - -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "" - -#: util/display.py:82 -msgid "skipped" -msgstr "" - -#: util/display.py:87 -msgid "failed" -msgstr "" - -#: util/osutil.py:131 -#, python-format -msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" - -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" -msgstr "" - -#: util/docutils.py:345 -#, python-format -msgid "unknown role name: %s" -msgstr "" - -#: util/docutils.py:789 -#, python-format -msgid "unknown node type: %r" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: util/fileutil.py:76 +#: cmd/quickstart.py:531 #, python-format msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" - -#: util/fileutil.py:89 -#, python-format -msgid "Writing evaluated template result to %s" -msgstr "" - -#: util/rst.py:73 -#, python-format -msgid "default role %s not found" -msgstr "" - -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" -msgstr "" - -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" -msgstr "" - -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "" - -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" -msgstr "" - -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "" - -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: cmd/quickstart.py:538 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "" - -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." -msgstr "" - -#: writers/texinfo.py:1303 -#, python-format -msgid "unimplemented node type: %r" -msgstr "" - -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr "" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: writers/latex.py:1183 +#: cmd/quickstart.py:573 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "" - -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "" - -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "" - -#: writers/html5.py:96 writers/html5.py:105 -msgid "Link to this definition" -msgstr "" - -#: writers/html5.py:431 -#, python-format -msgid "numfig_format is not defined for %s" -msgstr "" - -#: writers/html5.py:441 -#, python-format -msgid "Any IDs not assigned for %s node" -msgstr "" - -#: writers/html5.py:496 -msgid "Link to this term" -msgstr "" - -#: writers/html5.py:548 writers/html5.py:553 -msgid "Link to this heading" -msgstr "" - -#: writers/html5.py:558 -msgid "Link to this table" -msgstr "" - -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "" - -#: writers/html5.py:638 -msgid "Link to this image" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: writers/html5.py:640 -msgid "Link to this toctree" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: writers/html5.py:766 -msgid "Could not obtain image size. :scale: option is ignored." +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: domains/__init__.py:322 -#, python-format -msgid "%s %s" -msgstr "%s %s" - -#: domains/math.py:73 -#, python-format -msgid "duplicate label of equation %s, other instance in %s" +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (hàm dựng sẵn)" - -#: domains/javascript.py:183 domains/python/__init__.py:287 -#, python-format -msgid "%s() (%s method)" -msgstr "%s() (phương thức %s)" - -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" -msgstr "%s() (lớp)" - -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s (biến toàn cục hoặc hằng số)" - -#: domains/javascript.py:189 domains/python/__init__.py:378 -#, python-format -msgid "%s (%s attribute)" -msgstr "%s (thuộc tính %s)" - -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "Đối số" - -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "Ném" - -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "Trả về" - -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "Kiểu trả về" - -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (mô-đun)" - -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "hàm" - -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "phương thức" - -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "lớp" - -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "dữ liệu" - -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "thuộc tính" - -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "mô-đun" - -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" -msgstr "Thay đổi trong phiên bản %s" - -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" -msgstr "Sắp loại bỏ từ phiên bản %s" - -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" -msgstr "%s (chỉ thị)" - -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" -msgstr "%s (vai trò)" - -#: domains/rst.py:234 -msgid "directive" -msgstr "chỉ thị" - -#: domains/rst.py:235 -msgid "directive-option" +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "vai trò" - -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: domains/citation.py:92 -#, python-format -msgid "Citation [%s] is not referenced." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "Chú ý" - -#: locale/__init__.py:229 -msgid "Caution" -msgstr "Cảnh báo" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "Nguy hiểm" +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "" -#: locale/__init__.py:231 -msgid "Error" -msgstr "Lỗi" +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "" -#: locale/__init__.py:232 -msgid "Hint" -msgstr "Gợi ý" +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "" -#: locale/__init__.py:233 -msgid "Important" -msgstr "Quan trọng" +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "" -#: locale/__init__.py:234 -msgid "Note" -msgstr "Ghi chú" +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" -#: locale/__init__.py:235 -msgid "See also" -msgstr "Xem thêm" +#: cmd/quickstart.py:671 +#, python-format +msgid "enable %s extension" +msgstr "" -#: locale/__init__.py:236 -msgid "Tip" -msgstr "Mẹo" +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" -#: locale/__init__.py:237 -msgid "Warning" -msgstr "Cảnh báo" +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: cmd/quickstart.py:687 +msgid "create makefile" msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: cmd/quickstart.py:693 +msgid "do not create makefile" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: cmd/quickstart.py:700 +msgid "create batchfile" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: cmd/quickstart.py:706 +msgid "do not create batchfile" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: cmd/quickstart.py:731 +msgid "define a template variable" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: cmd/quickstart.py:786 +msgid "" +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: cmd/quickstart.py:810 +#, python-format +msgid "Invalid template variable: %s" msgstr "" -#: cmd/quickstart.py:133 +#: directives/other.py:119 #, python-format -msgid "Please enter one of %s." +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: directives/other.py:153 environment/adapters/toctree.py:372 +#, python-format +msgid "toctree contains reference to excluded document %r" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: directives/other.py:156 +#, python-format +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: cmd/quickstart.py:229 +#: directives/other.py:169 #, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +msgid "duplicated entry found in toctree: %s" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: directives/other.py:203 +msgid "Section author: " +msgstr "Tác giả mục:" + +#: directives/other.py:205 +msgid "Module author: " +msgstr "Tác giả mô-đun:" + +#: directives/other.py:207 +msgid "Code author: " +msgstr "Tác giả mã lệnh:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "Tác giả:" + +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: directives/patches.py:70 +msgid "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: directives/code.py:87 +#, python-format +msgid "Invalid caption: %s" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#, python-format +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: directives/code.py:216 +#, python-format +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "" + +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: cmd/quickstart.py:273 +#: directives/code.py:235 +#, python-format msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" +#: directives/code.py:314 +#, python-format +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%d/%m/%Y" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: cmd/quickstart.py:297 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"The project name will occur in several places in the built documentation." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: cmd/quickstart.py:300 -msgid "Project name" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" msgstr "" -#: cmd/quickstart.py:302 -msgid "Author name(s)" +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." +#: writers/texinfo.py:1303 +#, python-format +msgid "unimplemented node type: %r" msgstr "" -#: cmd/quickstart.py:315 -msgid "Project version" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" msgstr "" -#: cmd/quickstart.py:317 -msgid "Project release" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" msgstr "" -#: cmd/quickstart.py:331 -msgid "Project language" +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: writers/html5.py:441 +#, python-format +msgid "Any IDs not assigned for %s node" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: writers/html5.py:496 +msgid "Link to this term" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: writers/html5.py:558 +msgid "Link to this table" msgstr "" -#: cmd/quickstart.py:367 +#: writers/html5.py:572 writers/latex.py:1127 #, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." +msgid "unsupported rubric heading level: %s" msgstr "" -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +#: writers/html5.py:636 +msgid "Link to this code" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: writers/html5.py:638 +msgid "Link to this image" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: writers/html5.py:640 +msgid "Link to this toctree" msgstr "" -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." +#: writers/latex.py:386 +#, python-format +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +#: builders/latex/__init__.py:221 writers/latex.py:436 +#, python-format +msgid "no Babel option known for language %r" msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 +#: writers/latex.py:616 #, python-format -msgid "Creating file %s." +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: cmd/quickstart.py:519 +#: writers/latex.py:1228 #, python-format msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: cmd/quickstart.py:530 +#: writers/latex.py:1950 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" +msgid "unknown index entry type %s found" msgstr "" -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: cmd/quickstart.py:591 -msgid "quiet mode" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: cmd/quickstart.py:601 -msgid "project root" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: cmd/quickstart.py:604 -msgid "Structure options" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: cmd/quickstart.py:625 -msgid "Project basic options" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: cmd/quickstart.py:627 -msgid "project name" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: cmd/quickstart.py:630 -msgid "author names" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: cmd/quickstart.py:637 -msgid "version of project" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: cmd/quickstart.py:644 -msgid "release of project" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: cmd/quickstart.py:651 -msgid "document language" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: cmd/quickstart.py:654 -msgid "source file suffix" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: cmd/quickstart.py:657 -msgid "master document name" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:660 -msgid "use epub" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: cmd/quickstart.py:663 -msgid "Extension options" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:670 -#, python-format -msgid "enable %s extension" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: cmd/quickstart.py:686 -msgid "create makefile" +#: transforms/__init__.py:258 +#, python-format +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: cmd/quickstart.py:692 -msgid "do not create makefile" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: cmd/quickstart.py:699 -msgid "create batchfile" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: cmd/quickstart.py:705 -msgid "do not create batchfile" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: cmd/quickstart.py:730 -msgid "define a template variable" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: cmd/quickstart.py:792 +#: util/i18n.py:253 +#, python-format msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:809 +#: util/osutil.py:131 #, python-format -msgid "Invalid template variable: %s" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/build.py:64 -msgid "job number should be a positive number" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/build.py:100 -msgid "path to documentation source files" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/build.py:103 -msgid "path to output directory" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/build.py:114 -msgid "general options" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/build.py:131 +#: util/docfields.py:103 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/build.py:150 -msgid "path options" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/build.py:184 -msgid "override a setting in configuration file" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "Biểu tượng" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/build.py:212 -msgid "console output options" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" +#: transforms/post_transforms/__init__.py:88 +msgid "" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/build.py:252 -msgid "warning control options" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/build.py:265 -msgid "turn warnings into errors" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/build.py:357 -#, python-format -msgid "cannot open warning file '%s': %s" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" #: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 msgid "Collapse sidebar" msgstr "" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "Điều hướng" + +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "Tìm kiếm trong %(docstitle)s" + +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "Về các tài liệu này" #: themes/agogo/layout.html:34 themes/basic/layout.html:130 #: themes/basic/search.html:3 themes/basic/search.html:15 msgid "Search" msgstr "Tìm Kiếm" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "Thực hiện" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "Bản quyền" + +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "" + +#: themes/basic/layout.html:201 +#, python-format +msgid "Last updated on %(last_updated)s." +msgstr "Cập nhật mới nhất vào %(last_updated)s." + +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "Chủ đề trước" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "chương trước " + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "Chủ đề tiếp" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "chương tiếp" + +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" + +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "Toàn bộ chỉ mục trên một trang" + +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "Hiển thị mã nguồn" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "Nội dung" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "Tìm %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "Thực hiện" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2682,7 +2882,7 @@ msgstr "Chỉ Mục Mô-đun Toàn Cục" msgid "quick access to all modules" msgstr "truy cập nhanh tất cả các mô-đun" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "Chỉ mục chung" @@ -2690,23 +2890,15 @@ msgstr "Chỉ mục chung" msgid "all functions, classes, terms" msgstr "tất cả các hàm, lớp, thuật ngữ" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "Toàn bộ chỉ mục trên một trang" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "" +msgid "Search %(docstitle)s" +msgstr "Tìm %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2716,57 +2908,6 @@ msgstr "Các trang chỉ mục theo chữ cái" msgid "can be huge" msgstr "có thể rất nhiều" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "Chủ đề trước" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "chương trước " - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "Chủ đề tiếp" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "chương tiếp" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "Điều hướng" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "Tìm kiếm trong %(docstitle)s" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "Về các tài liệu này" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "Bản quyền" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "Cập nhật mới nhất vào %(last_updated)s." - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2783,42 +2924,41 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "Nội dung" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" "Search finished, found ${resultCount} pages matching the search query." msgstr[0] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2827,6 +2967,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2848,120 +2993,127 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 -msgid "Positional-only parameter separator (PEP 570)" -msgstr "" +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" +msgstr "" + +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "" + +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "Tham số" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "Các biến" -#: domains/python/_annotations.py:540 -msgid "Keyword-only parameters separator (PEP 3102)" -msgstr "" +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "Đưa ra" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (trong mô-đun %s)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (trong mô-đun %s)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (biến dựng sẵn)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (lớp dựng sẵn)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (lớp trong %s)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (phương thức lớp %s)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (phương thức tĩnh %s)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Chỉ Mục Mô-đun Python" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "các mô-đun" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "Sắp loại bỏ" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "ngoại lệ" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "phương thức lớp" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "phương thức tĩnh" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "(sắp loại bỏ)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "Tham số" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "Các biến" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "Đưa ra" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2972,746 +3124,526 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "thuộc tính" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "kiểu" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:750 -msgid "variable" -msgstr "biến" - -#: domains/c/__init__.py:752 -msgid "macro" -msgstr "macro" - -#: domains/c/__init__.py:753 -msgid "struct" -msgstr "" - -#: domains/std/__init__.py:91 domains/std/__init__.py:111 -#, python-format -msgid "environment variable; %s" -msgstr "các biến môi trường; %s" - -#: domains/std/__init__.py:119 -#, python-format -msgid "%s; configuration value" -msgstr "" - -#: domains/std/__init__.py:175 -msgid "Type" -msgstr "" - -#: domains/std/__init__.py:185 -msgid "Default" -msgstr "" - -#: domains/std/__init__.py:242 -#, python-format -msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "" - -#: domains/std/__init__.py:319 -#, python-format -msgid "%s command line option" -msgstr "" - -#: domains/std/__init__.py:321 -msgid "command line option" -msgstr "" - -#: domains/std/__init__.py:461 -msgid "glossary term must be preceded by empty line" -msgstr "" - -#: domains/std/__init__.py:474 -msgid "glossary terms must not be separated by empty lines" -msgstr "" - -#: domains/std/__init__.py:486 domains/std/__init__.py:504 -msgid "glossary seems to be misformatted, check indentation" -msgstr "" - -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "chú giải thuật ngữ" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "xem %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "nên xem %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "Biểu tượng" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" - -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" - -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" - -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" - -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" - -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "" - -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "" - -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "" - -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +"Declaration is '.. c:%s:: %s'." msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/c/__init__.py:211 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "%s (C %s)" msgstr "" -#: transforms/post_transforms/__init__.py:299 -#, python-format -msgid "%s:%s reference target not found: %s" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "biến" + +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "macro" + +#: domains/c/__init__.py:781 +msgid "struct" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format -msgid "%r reference target not found: %s" -msgstr "" +msgid "environment variable; %s" +msgstr "các biến môi trường; %s" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:116 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "%s; configuration value" msgstr "" -#: transforms/post_transforms/images.py:96 -#, python-format -msgid "Could not fetch remote image: %s [%d]" +#: domains/std/__init__.py:172 +msgid "Type" msgstr "" -#: transforms/post_transforms/images.py:143 -#, python-format -msgid "Unknown image format: %s..." +#: domains/std/__init__.py:182 +msgid "Default" msgstr "" -#: builders/html/__init__.py:113 +#: domains/std/__init__.py:239 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" -#: builders/html/__init__.py:348 +#: domains/std/__init__.py:319 #, python-format -msgid "Failed to read build info file: %r" +msgid "%s command line option" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: domains/std/__init__.py:321 +msgid "command line option" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "chỉ mục" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "chú giải thuật ngữ" + +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "xem tiếp" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "xem lại" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: domains/std/__init__.py:735 +msgid "document" +msgstr "" + +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: builders/html/__init__.py:794 +#: domains/std/__init__.py:857 #, python-format -msgid "cannot copy image file '%s': %s" +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: builders/html/__init__.py:818 +#: domains/std/__init__.py:1124 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: builders/html/__init__.py:864 +#: domains/std/__init__.py:1138 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "the link has no caption: %s" msgstr "" -#: builders/html/__init__.py:882 +#: domains/std/__init__.py:1153 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: domains/std/__init__.py:1157 +#, python-format +msgid "invalid numfig_format: %s" msgstr "" -#: builders/html/__init__.py:934 +#: domains/std/__init__.py:1453 #, python-format -msgid "cannot copy static file %r" +msgid "undefined label: %r" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: domains/std/__init__.py:1456 +#, python-format +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: builders/html/__init__.py:949 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "cannot copy extra file %r" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: builders/html/__init__.py:955 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Failed to write build info file: %r" +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/napoleon/docstring.py:192 +#, python-format +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:1216 -#, python-format -msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:1224 -#, python-format -msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "Các ví dụ" + +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:1365 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "html_extra_path entry %r does not exist" +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:1380 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "html_static_path entry %r is placed inside outdir" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:1385 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "html_static_path entry %r does not exist" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "logo file %r does not exist" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:1407 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "favicon file %r does not exist" +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:1420 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:1449 +#: ext/autodoc/_names.py:89 #, python-format -msgid "%s %s documentation" -msgstr "Tài liệu %s %s" +msgid "signature arguments given for automodule: '%s'" +msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/autodoc/_names.py:93 +#, python-format +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 +#, python-format +msgid "Failed to remove %s: %s" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_generate.py:69 #, python-format -msgid "The LaTeX files are in %(outdir)s." +msgid "Would create file %s." msgstr "" -#: builders/latex/__init__.py:121 +#: ext/apidoc/_cli.py:28 msgid "" "\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/latex/__init__.py:536 -#, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/latex/__init__.py:544 -#, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/latex/transforms.py:121 -#, python-format -msgid "Failed to get a docname for source %r!" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/latex/transforms.py:487 -#, python-format -msgid "No footnote was found for given reference node %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "" + +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "" + +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/latex/theming.py:88 -#, python-format -msgid "%r doesn't have \"theme\" setting" +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/latex/theming.py:91 -#, python-format -msgid "%r doesn't have \"%s\" setting" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:176 -#, python-format -msgid "invalid value set (missing closing brace): %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" -#: ext/napoleon/docstring.py:183 -#, python-format -msgid "invalid value set (missing opening brace): %s" +#: ext/apidoc/_cli.py:226 +msgid "extension options" msgstr "" -#: ext/napoleon/docstring.py:190 -#, python-format -msgid "malformed string literal (missing closing quote): %s" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "" - -#: ext/napoleon/docstring.py:895 -msgid "Example" +msgid "enable %s extension, used when --full is given" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "Các ví dụ" - -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/apidoc/_extension.py:115 +#, python-format +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/apidoc/_extension.py:121 +#, python-format +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "autosummary references excluded document %r. Ignored." +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: ext/autosummary/__init__.py:309 -msgid "A captioned autosummary requires :toctree: option. ignored." +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: ext/autosummary/__init__.py:404 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "failed to parse name %s" +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: ext/autosummary/__init__.py:412 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to import object %s" +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "" -"Summarised items should not include the current module. Replace %r with %r." +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/autosummary/__init__.py:937 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3719,7 +3651,7 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3734,481 +3666,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/autosummary/generate.py:858 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "" -#: ext/autosummary/generate.py:866 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/autosummary/generate.py:915 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/autosummary/generate.py:923 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/autosummary/generate.py:931 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/autosummary/generate.py:940 #, python-format msgid "" "document exactly the members in module __all__ attribute. (default: " "%(default)s)" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/autosummary/__init__.py:239 #, python-format -msgid "Failed to remove %s: %s" +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." msgstr "" -#: ext/apidoc/_cli.py:28 +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "" + +#: ext/autosummary/__init__.py:329 +#, python-format msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" msgstr "" -#: ext/apidoc/_cli.py:50 +#: ext/autosummary/__init__.py:652 +#, python-format msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +"Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:91 +#: ext/intersphinx/_load.py:72 +#, python-format msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/apidoc/_cli.py:152 +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/intersphinx/_load.py:332 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "" + +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:240 +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 #, python-format -msgid "enable %s extension, used when --full is given" +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:291 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "%s is not a directory." +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:102 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Invalid __slots__ found on %s. Ignored." msgstr "" -#: ext/apidoc/_extension.py:110 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "error while formatting arguments for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:115 +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 #, python-format -msgid "apidoc_modules item %i 'path' must be a string" +msgid "Failed to get a constructor signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:121 +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Failed to get a method signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:133 +#: ext/autodoc/_dynamic/_signatures.py:500 #, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +msgid "Failed to get a signature for %s: %s" msgstr "" -#: ext/apidoc/_extension.py:140 +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_extension.py:147 +#: ext/autodoc/_dynamic/_member_finder.py:420 #, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +msgid "" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_extension.py:157 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: ext/autodoc/_legacy_class_based/_documenters.py:964 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_extension.py:192 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_extension.py:210 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_extension.py:247 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_extension.py:256 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" + +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" + +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "" + +#: builders/html/__init__.py:114 #, python-format -msgid "Would create file %s." +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:337 #, python-format -msgid "(in %s v%s)" +msgid "Failed to read build info file: %r" +msgstr "" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "" + +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:372 #, python-format -msgid "(in %s)" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:496 +msgid "index" +msgstr "chỉ mục" + +#: builders/html/__init__.py:549 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "Logo of %s" +msgstr "" + +#: builders/html/__init__.py:578 +msgid "next" +msgstr "xem tiếp" + +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "xem lại" + +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:783 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "cannot copy image file '%s': %s" +msgstr "" + +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:807 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:853 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:871 #, python-format -msgid "domain for external cross-reference not found: %r" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "" + +#: builders/html/__init__.py:923 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "cannot copy static file %r" +msgstr "" + +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:938 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:944 #, python-format +msgid "Failed to write build info file: %r" +msgstr "" + +#: builders/html/__init__.py:994 msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1038 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1204 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1217 #, python-format msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1225 #, python-format msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1266 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1313 +#, python-format +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:261 -#, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:287 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1365 +#, python-format +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1370 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/html/__init__.py:1385 #, python-format -msgid "invalid value for member-order option: %s" +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/autodoc/__init__.py:158 +#: builders/html/__init__.py:1390 #, python-format -msgid "invalid value for class-doc-from option: %s" +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "logo file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/html/__init__.py:1412 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "favicon file %r does not exist" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/autodoc/__init__.py:1080 +#: builders/html/__init__.py:1454 #, python-format -msgid "A mocked object is detected: %r" +msgid "%s %s documentation" +msgstr "Tài liệu %s %s" + +#: builders/latex/theming.py:87 +#, python-format +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/theming.py:90 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:1185 +#: builders/latex/transforms.py:121 #, python-format -msgid "signature arguments or return annotation given for automodule %s" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "" + +#: builders/latex/__init__.py:118 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "" + +#: builders/latex/__init__.py:167 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "" + +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "" + +#: builders/latex/__init__.py:529 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1966 +#: builders/latex/__init__.py:537 #, python-format -msgid "Bases: %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "" + +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:98 #, python-format -msgid "missing attribute %s in object %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/collectors/asset.py:126 #, python-format -msgid "alias of %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/collectors/asset.py:165 #, python-format -msgid "alias of TypeVar(%s)" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:335 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:360 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "see %s" +msgstr "xem %s" + +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "nên xem %s" + +#: environment/adapters/indexentries.py:140 +#, python-format +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/yue/LC_MESSAGES/sphinx.mo b/sphinx/locale/yue/LC_MESSAGES/sphinx.mo index 04b8543699f..ffcc4786362 100644 Binary files a/sphinx/locale/yue/LC_MESSAGES/sphinx.mo and b/sphinx/locale/yue/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/yue/LC_MESSAGES/sphinx.po b/sphinx/locale/yue/LC_MESSAGES/sphinx.po index 31fe701fb30..5061fd4d0db 100644 --- a/sphinx/locale/yue/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/yue/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Cantonese (http://app.transifex.com/sphinx-doc/sphinx-1/language/yue/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: yue\n" "Plural-Forms: nplurals=1; plural=0;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,42 +2923,41 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" "Search finished, found ${resultCount} pages matching the search query." msgstr[0] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2826,6 +2966,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2847,119 +2992,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2971,92 +3123,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3084,581 +3229,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3666,548 +3719,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js index 59f9b0f55f4..7b14a791860 100644 --- a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js +++ b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js @@ -20,7 +20,7 @@ Documentation.addTranslations({ "Go": "\u63d0\u4ea4", "Hide Search Matches": "\u9690\u85cf\u641c\u7d22\u7ed3\u679c", "Index": "\u7d22\u5f15", - "Index – %(key)s": "\u7d22\u5f15 – %(key)s", + "Index – %(key)s": "\u7d22\u5f15 – %(key)s", "Index pages by letter": "\u5b57\u6bcd\u7d22\u5f15", "Indices and tables:": "\u7d22\u5f15\u548c\u8868\u683c\uff1a", "Last updated on %(last_updated)s.": "\u6700\u540e\u66f4\u65b0\u4e8e %(last_updated)s.", @@ -36,7 +36,9 @@ Documentation.addTranslations({ "Search": "\u641c\u7d22", "Search Page": "\u641c\u7d22\u9875\u9762", "Search Results": "\u641c\u7d22\u7ed3\u679c", - "Search finished, found ${resultCount} page(s) matching the search query.": "\u641c\u7d22\u5b8c\u6210\uff0c\u5339\u914d\u5230 ${resultCount} \u9875\u3002", + "Search finished, found one page matching the search query.": [ + "\u641c\u7d22\u5b8c\u6210\uff0c\u5339\u914d\u641c\u7d22\u6761\u4ef6\u7684\u6709 ${resultCount} \u4e2a\u9875\u9762\u3002" + ], "Search within %(docstitle)s": "\u5728 %(docstitle)s \u4e2d\u641c\u7d22", "Searching": "\u6b63\u5728\u641c\u7d22\u4e2d", "Searching for multiple words only shows matches that contain\n all words.": "\u5f53\u641c\u7d22\u591a\u4e2a\u5173\u952e\u8bcd\u65f6\uff0c\u53ea\u4f1a\u663e\u793a\u540c\u65f6\u5305\u542b\u6240\u6709\u5173\u952e\u8bcd\u7684\u5185\u5bb9\u3002", diff --git a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo index 4fd8ec7d497..96446144ffb 100644 Binary files a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo and b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po index af0e5c248e4..9ab91c60262 100644 --- a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po @@ -1,10 +1,14 @@ # Translations template for Sphinx. -# Copyright (C) 2024 ORGANIZATION +# Copyright (C) 2025 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Adam Turner, 2023 # Yinian Chin , 2015,2017-2018 +# Alpha Du , 2025 +# Dormouse Young , 2024 +# Freesand Leo , 2024 +# gerhardt.gao , 2025 # Hsiaoming Yang , 2018 # Izabel Wang , 2020 # Izabel Wang , 2020 @@ -18,1558 +22,1915 @@ # Ryekee Zhong , 2013 # Komiya Takeshi , 2019,2021-2022 # Tower Joo, 2009 +# Tyson Tan , 2025 # wendi cao <651645601@qq.com>, 2020 -# Yinian Chin , 2013,2018,2020,2022-2023 +# Yinian Chin , 2013,2018,2020,2022-2024 # Yinian Chin , 2013 +# you sunshine, 2024 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-04-14 23:27+0000\n" +"POT-Creation-Date: 2025-12-04 06:45+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" -"Last-Translator: Adam Turner, 2023\n" +"Last-Translator: gerhardt.gao , 2025\n" "Language-Team: Chinese (China) (http://app.transifex.com/sphinx-doc/sphinx-1/language/zh_CN/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.14.0\n" +"Generated-By: Babel 2.17.0\n" "Language: zh_CN\n" "Plural-Forms: nplurals=1; plural=0;\n" -#: sphinx/application.py:157 +#: roles.py:205 #, python-format -msgid "Cannot find source directory (%s)" -msgstr "无法找到源文件目录(%s)" +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "通用漏洞及暴露;CVE %s" -#: sphinx/application.py:161 +#: roles.py:228 #, python-format -msgid "Output directory (%s) is not a directory" -msgstr "输出目录(%s)不是一个目录" +msgid "invalid CVE number %s" +msgstr "无效的 CVE 编号 %s" -#: sphinx/application.py:165 -msgid "Source directory and destination directory cannot be identical" -msgstr "源文件目录和目标目录不能是同一目录" +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "常见漏洞枚举;CWE %s" -#: sphinx/application.py:197 +#: roles.py:273 #, python-format -msgid "Running Sphinx v%s" -msgstr "正在运行 Sphinx v%s" +msgid "invalid CWE number %s" +msgstr "无效的 CWE 编号 %s" -#: sphinx/application.py:219 +#: roles.py:293 #, python-format -msgid "" -"This project needs at least Sphinx v%s and therefore cannot be built with " -"this version." -msgstr "该项目需要 Sphinx v%s 及以上版本,当前使用版本不能构建此文档。" +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python 增强建议;PEP %s" -#: sphinx/application.py:235 -msgid "making output directory" -msgstr "正在创建输出目录" +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "无效的 PEP 编号%s" -#: sphinx/application.py:240 sphinx/registry.py:450 +#: roles.py:354 #, python-format -msgid "while setting up extension %s:" -msgstr "在设置扩展名 %s 时:" +msgid "invalid RFC number %s" +msgstr "无效的 RFC 编号 %s" -#: sphinx/application.py:246 +#: theming.py:117 +#, python-format msgid "" -"'setup' as currently defined in conf.py isn't a Python callable. Please " -"modify its definition to make it a callable function. This is needed for " -"conf.py to behave as a Sphinx extension." -msgstr "当前 conf.py 中定义的 'setup' 不是一个 Python 的可调用对象。请修改其定义为一个可调用的函数。当 conf.py 作为 Sphinx 扩展时,必须依此配置。" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "主题配置不支持 [theme] 和 [options] 以外的部分 (尝试从 %r 获取值)。" -#: sphinx/application.py:277 +#: theming.py:122 #, python-format -msgid "loading translations [%s]... " -msgstr "正在加载翻译 [%s]…" - -#: sphinx/application.py:294 sphinx/util/display.py:85 -msgid "done" -msgstr "完成" - -#: sphinx/application.py:296 -msgid "not available for built-in messages" -msgstr "没有找到内置信息的译文" - -#: sphinx/application.py:310 -msgid "loading pickled environment" -msgstr "正在加载 Pickle 序列化的环境" +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "所有已找到的主题配置均未包含配置项 %s.%s" -#: sphinx/application.py:318 +#: theming.py:137 #, python-format -msgid "failed: %s" -msgstr "失败:%s" +msgid "unsupported theme option %r given" +msgstr "不支持的主题选项 %r" -#: sphinx/application.py:332 -msgid "No builder selected, using default: html" -msgstr "未选择构建器,默认使用:html" +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "主题路径对应的文件 %r 是一个无效的或不包含主题的 zip 文件" -#: sphinx/application.py:365 -msgid "succeeded" -msgstr "成功" +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "找不到名称为 %r 的主题 (是否缺少 theme.toml 文件?)" -#: sphinx/application.py:366 -msgid "finished with problems" -msgstr "完成但存在问题" +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "%r 主題有循环继承" -#: sphinx/application.py:370 +#: theming.py:286 #, python-format -msgid "build %s, %s warning (with warnings treated as errors)." -msgstr "构建%s,%s 条警告(将警告视为错误)。" +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "%r 主题继承了未加载的主题 %r。已加载的主题有:%s" -#: sphinx/application.py:372 +#: theming.py:292 #, python-format -msgid "build %s, %s warnings (with warnings treated as errors)." -msgstr "构建%s,%s 条警告(将警告视为错误)。" +msgid "The %r theme has too many ancestors" +msgstr "%r 主题有太多祖先主题。" -#: sphinx/application.py:375 +#: theming.py:320 #, python-format -msgid "build %s, %s warning." -msgstr "构建%s, %s 条警告。" +msgid "no theme configuration file found in %r" +msgstr "在 %r 中找不到主题配置文件" -#: sphinx/application.py:377 +#: theming.py:345 theming.py:398 #, python-format -msgid "build %s, %s warnings." -msgstr "构建%s,%s 条警告。" +msgid "theme %r doesn't have the \"theme\" table" +msgstr "主题 %r 內沒有 \"theme\" 表格" -#: sphinx/application.py:381 +#: theming.py:349 #, python-format -msgid "build %s." -msgstr "构建%s。" +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "%r 主题的 \"[theme]\" 表格不是一个表格" -#: sphinx/application.py:610 +#: theming.py:353 theming.py:401 #, python-format -msgid "node class %r is already registered, its visitors will be overridden" -msgstr "节点类 %r 已经注册过了,其访问者将被覆盖" +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "%r 主题必须定义 \"theme.inherit\" 配置项" -#: sphinx/application.py:689 +#: theming.py:357 #, python-format -msgid "directive %r is already registered, it will be overridden" -msgstr "指令 %r 已经注册过了,将被覆盖" +msgid "The %r theme \"[options]\" table is not a table" +msgstr "%r 主题的 \"[options]\" 表格不是一个表格" -#: sphinx/application.py:711 sphinx/application.py:733 +#: theming.py:376 #, python-format -msgid "role %r is already registered, it will be overridden" -msgstr "角色 %r 已经注册过了,将被覆盖" +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "\"theme.pygments_style\" 配置项必须是一个表格。提示:\"%s\"" -#: sphinx/application.py:1282 +#: project.py:72 #, python-format msgid "" -"the %s extension does not declare if it is safe for parallel reading, " -"assuming it isn't - please ask the extension author to check and make it " -"explicit" -msgstr "扩展 %s 没有声明是否并行读取安全,默认假定为否—请联系扩展作者检查是否支持该特性并显式声明" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "发现多个文件对应文档“%s”:%s\n将采用 %r 用于构建。" -#: sphinx/application.py:1286 +#: project.py:87 #, python-format -msgid "the %s extension is not safe for parallel reading" -msgstr "扩展 %s 不是并行读取安全的" +msgid "Ignored unreadable document %r." +msgstr "已忽略无法读取的文档 %r。" -#: sphinx/application.py:1289 +#: extension.py:58 #, python-format msgid "" -"the %s extension does not declare if it is safe for parallel writing, " -"assuming it isn't - please ask the extension author to check and make it " -"explicit" -msgstr "%s 扩展没有声明是否并行写入安全,默认假定为否—请联系扩展作者检查是否支持该特性并显式声明" +"The %s extension is required by needs_extensions settings, but it is not " +"loaded." +msgstr "未能加载 needs_extensions 配置项指定的 %s 扩展。" -#: sphinx/application.py:1293 +#: extension.py:79 #, python-format -msgid "the %s extension is not safe for parallel writing" -msgstr "扩展 %s 不是并行写入安全的" +msgid "" +"This project needs the extension %s at least in version %s and therefore " +"cannot be built with the loaded version (%s)." +msgstr "该项目要求扩展 %s 至少是 %s 版本,当前加载版本(%s)无法构建文档。" -#: sphinx/application.py:1301 sphinx/application.py:1305 +#: highlighting.py:170 #, python-format -msgid "doing serial %s" -msgstr "执行串行 %s" +msgid "Pygments lexer name %r is not known" +msgstr "未知的 Pygments 词法分析器 %r" -#: sphinx/config.py:309 +#: highlighting.py:209 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "配置目录中缺少 conf.py 文件(%s)" - -#: sphinx/config.py:318 msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "发现无效的配置值:“language = None”。请修改为有效的语言代码。回退至“en”(英语)。" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "在词法分析字面块 %r 为“%s”时,在词 %r 处遇到错误。正在以宽松模式重试。" -#: sphinx/config.py:341 +#: events.py:92 #, python-format -msgid "" -"cannot override dictionary config setting %r, ignoring (use %r to set " -"individual elements)" -msgstr "不能覆盖字典配置项 %r,已忽略 (请用 %r 方式逐一修改字典成员)" +msgid "Event %r already present" +msgstr "事件 %r 已存在" -#: sphinx/config.py:350 +#: events.py:386 #, python-format -msgid "invalid number %r for config value %r, ignoring" -msgstr "%r 不是有效整数,配置项 %r 的值只能是整数,已忽略" +msgid "Unknown event name: %s" +msgstr "未知的事件名称:%s" -#: sphinx/config.py:355 +#: events.py:451 #, python-format -msgid "cannot override config setting %r with unsupported type, ignoring" -msgstr "无法用不支持的类型覆盖配置项 %r,已忽略" +msgid "Handler %r for event %r threw an exception" +msgstr "事件处理函数 %r 在处理事件 %r 时抛出了异常" -#: sphinx/config.py:378 +#: application.py:218 #, python-format -msgid "unknown config value %r in override, ignoring" -msgstr "配置覆盖中包含未知的配置项 %r,已忽略" +msgid "Cannot find source directory (%s)" +msgstr "无法找到源文件目录(%s)" -#: sphinx/config.py:418 +#: application.py:223 #, python-format -msgid "No such config value: %r" -msgstr "" +msgid "Output directory (%s) is not a directory" +msgstr "输出目录(%s)不是一个目录" -#: sphinx/config.py:440 -#, python-format -msgid "Config value %r already present" -msgstr "配置项 %r 已存在" +#: application.py:228 +msgid "Source directory and destination directory cannot be identical" +msgstr "源文件目录和目标目录不能是同一目录" -#: sphinx/config.py:473 +#: application.py:258 #, python-format -msgid "cannot cache unpickable configuration value: %r" -msgstr "" +msgid "Running Sphinx v%s" +msgstr "正在运行 Sphinx v%s" -#: sphinx/config.py:509 +#: application.py:286 #, python-format -msgid "There is a syntax error in your configuration file: %s\n" -msgstr "配置文件中存在语法错误:%s\n" - -#: sphinx/config.py:512 msgid "" -"The configuration file (or one of the modules it imports) called sys.exit()" -msgstr "配置文件(或配置文件导入的模块)调用了 sys.exit()" +"This project needs at least Sphinx v%s and therefore cannot be built with " +"this version." +msgstr "该项目需要 Sphinx v%s 及以上版本,当前使用版本不能构建此文档。" -#: sphinx/config.py:519 -#, python-format -msgid "" -"There is a programmable error in your configuration file:\n" -"\n" -"%s" -msgstr "配置文件中有程序上的错误:\n\n%s" +#: application.py:305 +msgid "making output directory" +msgstr "正在创建输出目录" -#: sphinx/config.py:540 +#: application.py:310 registry.py:540 #, python-format -msgid "Failed to convert %r to a set or tuple" -msgstr "" +msgid "while setting up extension %s:" +msgstr "在设置扩展名 %s 时:" -#: sphinx/config.py:565 -#, python-format +#: application.py:317 msgid "" -"The config value `source_suffix' expects a string, list of strings, or " -"dictionary. But `%r' is given." -msgstr "配置项“source_suffix”的值应为字符串、字符串列表或字典。但给定的值是“%r”。" +"'setup' as currently defined in conf.py isn't a Python callable. Please " +"modify its definition to make it a callable function. This is needed for " +"conf.py to behave as a Sphinx extension." +msgstr "当前 conf.py 中定义的 'setup' 不是一个 Python 的可调用对象。请修改其定义为一个可调用的函数。当 conf.py 作为 Sphinx 扩展时,必须依此配置。" -#: sphinx/config.py:585 +#: application.py:360 #, python-format -msgid "Section %s" -msgstr "节 %s" +msgid "loading translations [%s]... " +msgstr "正在加载翻译 [%s]…" -#: sphinx/config.py:586 -#, python-format -msgid "Fig. %s" -msgstr "图 %s" +#: application.py:384 util/display.py:89 +msgid "done" +msgstr "完成" -#: sphinx/config.py:587 -#, python-format -msgid "Table %s" -msgstr "表 %s" +#: application.py:386 +msgid "not available for built-in messages" +msgstr "没有找到内置信息的译文" -#: sphinx/config.py:588 +#: application.py:400 +msgid "loading pickled environment" +msgstr "正在加载 Pickle 序列化的环境" + +#: application.py:408 #, python-format -msgid "Listing %s" -msgstr "列表 %s" +msgid "failed: %s" +msgstr "失败:%s" -#: sphinx/config.py:663 -msgid "" -"The config value `{name}` has to be a one of {candidates}, but `{current}` " -"is given." -msgstr "配置项“{name}”的值只能在“{candidates}”中选取,而当前给定的值是“{current}”。" +#: application.py:423 +msgid "No builder selected, using default: html" +msgstr "未选择构建器,默认使用:html" -#: sphinx/config.py:687 -msgid "" -"The config value `{name}' has type `{current.__name__}'; expected " -"{permitted}." -msgstr "配置项“{name}”的值被配置成“{current.__name__}”类型,应为{permitted}。" +#: application.py:455 +msgid "build finished with problems." +msgstr "构建完成但存在问题。" + +#: application.py:457 +msgid "build succeeded." +msgstr "构建成功。" -#: sphinx/config.py:700 +#: application.py:462 msgid "" -"The config value `{name}' has type `{current.__name__}', defaults to " -"`{default.__name__}'." -msgstr "配置项“{name}”的值被配置成“{current.__name__}”类型,默认为“{default.__name__}”。" +"build finished with problems, 1 warning (with warnings treated as errors)." +msgstr "构建完成但存在问题,1 条警告(将警告视为错误)。" -#: sphinx/config.py:711 -#, python-format -msgid "primary_domain %r not found, ignored." -msgstr "primary_domain %r 不存在,已忽略。" +#: application.py:466 +msgid "build finished with problems, 1 warning." +msgstr "构建完成但存在问题,1 条警告。" -#: sphinx/config.py:723 +#: application.py:468 +msgid "build succeeded, 1 warning." +msgstr "构建成功,1 条警告。" + +#: application.py:474 +#, python-format msgid "" -"Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " -"\"root_doc = 'contents'\" to your conf.py." -msgstr "自 v2.0 起,Sphinx 采用“index”作为 root_doc 的默认值。请在你的 conf.py 中添加“root_doc = 'contents'”。" +"build finished with problems, %s warnings (with warnings treated as errors)." +msgstr "构建完成但存在问题,%s 条警告(将警告视为错误)。" -#: sphinx/events.py:64 +#: application.py:478 #, python-format -msgid "Event %r already present" -msgstr "事件 %r 已存在" +msgid "build finished with problems, %s warnings." +msgstr "构建完成但存在问题,%s 条警告。" -#: sphinx/events.py:70 +#: application.py:480 #, python-format -msgid "Unknown event name: %s" -msgstr "未知的事件名称:%s" +msgid "build succeeded, %s warnings." +msgstr "构建成功,%s 条警告。" -#: sphinx/events.py:109 +#: application.py:1020 #, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "事件处理函数 %r 在处理事件 %r 时抛出了异常" +msgid "node class %r is already registered, its visitors will be overridden" +msgstr "节点类 %r 已经注册过了,其访问者将被覆盖" -#: sphinx/extension.py:55 +#: application.py:1113 #, python-format -msgid "" -"The %s extension is required by needs_extensions settings, but it is not " -"loaded." -msgstr "未能加载 needs_extensions 配置项指定的 %s 扩展。" +msgid "directive %r is already registered and will not be overridden" +msgstr "指令 %r 已经注册,不会被覆盖" + +#: application.py:1139 application.py:1167 +#, python-format +msgid "role %r is already registered and will not be overridden" +msgstr "角色 %r 已经注册,不会被覆盖" -#: sphinx/extension.py:76 +#: application.py:1766 #, python-format msgid "" -"This project needs the extension %s at least in version %s and therefore " -"cannot be built with the loaded version (%s)." -msgstr "该项目要求扩展 %s 至少是 %s 版本,当前加载版本(%s)无法构建文档。" +"the %s extension does not declare if it is safe for parallel reading, " +"assuming it isn't - please ask the extension author to check and make it " +"explicit" +msgstr "扩展 %s 没有声明是否并行读取安全,默认假定为否—请联系扩展作者检查是否支持该特性并显式声明" -#: sphinx/highlighting.py:155 +#: application.py:1771 #, python-format -msgid "Pygments lexer name %r is not known" -msgstr "未知的 Pygments 词法分析器 %r" +msgid "the %s extension is not safe for parallel reading" +msgstr "扩展 %s 不是并行读取安全的" -#: sphinx/highlighting.py:189 +#: application.py:1775 #, python-format msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "" +"the %s extension does not declare if it is safe for parallel writing, " +"assuming it isn't - please ask the extension author to check and make it " +"explicit" +msgstr "%s 扩展没有声明是否并行写入安全,默认假定为否—请联系扩展作者检查是否支持该特性并显式声明" -#: sphinx/project.py:66 +#: application.py:1780 #, python-format -msgid "" -"multiple files found for the document \"%s\": %r\n" -"Use %r for the build." -msgstr "发现多个文件对应文档“%s”:%r\n将采用 %r 用于构建。" +msgid "the %s extension is not safe for parallel writing" +msgstr "扩展 %s 不是并行写入安全的" -#: sphinx/project.py:81 +#: application.py:1788 application.py:1792 #, python-format -msgid "Ignored unreadable document %r." -msgstr "" +msgid "doing serial %s" +msgstr "执行串行 %s" -#: sphinx/registry.py:142 +#: registry.py:162 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "构建器 %s 未包含“name”属性" -#: sphinx/registry.py:144 +#: registry.py:166 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "构建器 %r 已存在(见模块 %s)" -#: sphinx/registry.py:157 +#: registry.py:182 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "构建器 %s 未注册或在入口点不可用" -#: sphinx/registry.py:164 +#: registry.py:192 #, python-format msgid "Builder name %s not registered" msgstr "构建器 %s 未注册" -#: sphinx/registry.py:171 +#: registry.py:199 #, python-format msgid "domain %s already registered" msgstr "域 %s 已经注册过了" -#: sphinx/registry.py:194 sphinx/registry.py:207 sphinx/registry.py:218 +#: registry.py:223 registry.py:244 registry.py:257 #, python-format msgid "domain %s not yet registered" msgstr "域 %s 未注册" -#: sphinx/registry.py:198 +#: registry.py:230 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "指令 %r 已经在域 %s 上注册过了" -#: sphinx/registry.py:210 +#: registry.py:248 #, python-format msgid "The %r role is already registered to domain %s" msgstr "角色 %r 已经在域 %s 上注册过了" -#: sphinx/registry.py:221 +#: registry.py:261 #, python-format msgid "The %r index is already registered to domain %s" msgstr "索引 %r 已经在域 %s 上注册过了" -#: sphinx/registry.py:252 +#: registry.py:308 #, python-format msgid "The %r object_type is already registered" msgstr "对象类型 %r 已经注册过了" -#: sphinx/registry.py:278 +#: registry.py:339 #, python-format msgid "The %r crossref_type is already registered" msgstr "交叉引用类型 %r 已经注册过了" -#: sphinx/registry.py:285 +#: registry.py:348 #, python-format msgid "source_suffix %r is already registered" msgstr "源文件扩展名 %r 已经注册过了" -#: sphinx/registry.py:294 +#: registry.py:358 #, python-format msgid "source_parser for %r is already registered" msgstr "%r 的源文件解析器已经注册过了" -#: sphinx/registry.py:302 +#: registry.py:367 #, python-format msgid "Source parser for %s not registered" msgstr "未注册 %s 的源代码语法分析器" -#: sphinx/registry.py:318 +#: registry.py:388 #, python-format msgid "Translator for %r already exists" msgstr "翻译器已存在 %r" -#: sphinx/registry.py:334 +#: registry.py:405 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "add_node() 的关键字参数必须是 (visit, depart) 形式的函数元组:%r=%r" -#: sphinx/registry.py:417 +#: registry.py:498 #, python-format msgid "enumerable_node %r already registered" msgstr "可枚举节点 %r 已经注册过了" -#: sphinx/registry.py:429 +#: registry.py:514 #, python-format msgid "math renderer %s is already registered" msgstr "公式渲染器 %s 已经注册过了" -#: sphinx/registry.py:444 +#: registry.py:531 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "扩展 %r 自 Sphinx %s 版本起合并至 Sphinx;因此,该扩展被忽略。" -#: sphinx/registry.py:455 +#: registry.py:545 msgid "Original exception:\n" msgstr "原始异常:\n" -#: sphinx/registry.py:456 +#: registry.py:547 #, python-format msgid "Could not import extension %s" msgstr "无法导入扩展 %s" -#: sphinx/registry.py:461 +#: registry.py:554 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "扩展 %r 缺少 setup() 函数;它确实是一个 Sphinx 扩展模块吗?" -#: sphinx/registry.py:470 +#: registry.py:567 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "该项目所用扩展 %s 需要 Sphinx %s 或以上版本;当前版本无法构建文档。" -#: sphinx/registry.py:478 +#: registry.py:579 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "扩展 %r 在其 setup() 函数中返回了一个不支持的对象;该函数应返回 None 或一个元数据字典" -#: sphinx/roles.py:201 +#: registry.py:605 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python 增强建议;PEP %s" +msgid "`None` is not a valid filetype for %r." +msgstr "`None` 不是有效的 %r 文件类型。" -#: sphinx/roles.py:222 +#: config.py:351 #, python-format -msgid "invalid PEP number %s" -msgstr "无效的 PEP 编号%s" +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "配置目录中缺少 conf.py 文件(%s)" -#: sphinx/roles.py:257 +#: config.py:374 #, python-format -msgid "invalid RFC number %s" -msgstr "无效的 RFC 编号 %s" +msgid "'%s' must be '0' or '1', got '%s'" +msgstr "'%s' 必须为 '0' 或 '1' ,但得到 '%s'" -#: sphinx/theming.py:125 +#: config.py:379 #, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "所有已找到的主题配置均未包含配置项 %s.%s" +msgid "" +"cannot override dictionary config setting %r, ignoring (use %r to set " +"individual elements)" +msgstr "不能覆盖字典配置项 %r,已忽略 (请用 %r 方式逐一修改字典成员)" -#: sphinx/theming.py:140 +#: config.py:391 #, python-format -msgid "unsupported theme option %r given" -msgstr "不支持的主题选项 %r" +msgid "invalid number %r for config value %r, ignoring" +msgstr "%r 不是有效整数,配置项 %r 的值只能是整数,已忽略" -#: sphinx/theming.py:206 +#: config.py:399 #, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "主题路径对应的文件 %r 是一个无效的或不包含主题的 zip 文件" +msgid "cannot override config setting %r with unsupported type, ignoring" +msgstr "无法用不支持的类型覆盖配置项 %r,已忽略" -#: sphinx/theming.py:226 +#: config.py:422 #, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "" +msgid "unknown config value %r in override, ignoring" +msgstr "配置覆盖中包含未知的配置项 %r,已忽略" -#: sphinx/theming.py:259 +#: config.py:476 #, python-format -msgid "The %r theme has circular inheritance" -msgstr "" +msgid "No such config value: %r" +msgstr "没有这个配置值: %r" + +#: config.py:504 +#, python-format +msgid "Config value %r already present" +msgstr "配置项 %r 已存在" -#: sphinx/theming.py:262 +#: config.py:541 #, python-format msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "" +"cannot cache unpickleable configuration value: %r (because it contains a " +"function, class, or module object)" +msgstr "无法缓存不可 pickle 的配置值: %r (因为它包含函数,类或模块对象)" + +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "发现无效的配置值:“language = None”。请修改为有效的语言代码。回退至“en”(英语)。" -#: sphinx/theming.py:269 +#: config.py:599 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "" +msgid "There is a syntax error in your configuration file: %s\n" +msgstr "配置文件中存在语法错误:%s\n" + +#: config.py:603 +msgid "" +"The configuration file (or one of the modules it imports) called sys.exit()" +msgstr "配置文件(或配置文件导入的模块)调用了 sys.exit()" -#: sphinx/theming.py:295 +#: config.py:611 #, python-format -msgid "no theme configuration file found in %r" -msgstr "" +msgid "" +"There is a programmable error in your configuration file:\n" +"\n" +"%s" +msgstr "配置文件中有程序上的错误:\n\n%s" -#: sphinx/theming.py:323 sphinx/theming.py:374 +#: config.py:633 #, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "" +msgid "Failed to convert %r to a frozenset" +msgstr "无法将 %r 转换为 frozenset" -#: sphinx/theming.py:327 +#: config.py:651 config.py:659 #, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "" +msgid "Converting `source_suffix = %r` to `source_suffix = %r`." +msgstr "正在转换 `source_suffix = %r` 为 `source_suffix = %r` 。" -#: sphinx/theming.py:331 sphinx/theming.py:377 +#: config.py:665 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "" +msgid "" +"The config value `source_suffix' expects a dictionary, a string, or a list " +"of strings. Got `%r' instead (type %s)." +msgstr "配置项“source_suffix”的值应为字典、字符串或字符串列表。但给定的值是“%r”(类型是 %s)。" -#: sphinx/theming.py:335 +#: config.py:686 #, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "" +msgid "Section %s" +msgstr "节 %s" -#: sphinx/theming.py:353 +#: config.py:687 #, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "" +msgid "Fig. %s" +msgstr "图 %s" -#: sphinx/builders/__init__.py:183 +#: config.py:688 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "没有找到适合 %s 构建器的图像:%s(%s)" +msgid "Table %s" +msgstr "表 %s" -#: sphinx/builders/__init__.py:187 +#: config.py:689 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "没有找到适合 %s 构建器的图像:%s" +msgid "Listing %s" +msgstr "列表 %s" -#: sphinx/builders/__init__.py:207 -msgid "building [mo]: " -msgstr "正在构建 [mo]: " +#: config.py:798 +#, python-brace-format +msgid "" +"The config value `{name}` has to be a one of {candidates}, but `{current}` " +"is given." +msgstr "配置项“{name}”的值只能在“{candidates}”中选取,而当前给定的值是“{current}”。" -#: sphinx/builders/__init__.py:208 sphinx/builders/__init__.py:574 -#: sphinx/builders/__init__.py:601 -msgid "writing output... " -msgstr "正在写入输出……" +#: config.py:829 +#, python-brace-format +msgid "" +"The config value `{name}' has type `{current.__name__}'; expected " +"{permitted}." +msgstr "配置项“{name}”的值被配置成“{current.__name__}”类型,应为{permitted}。" -#: sphinx/builders/__init__.py:217 -#, python-format -msgid "all of %d po files" -msgstr "所有的 %d po 文件" +#: config.py:846 +#, python-brace-format +msgid "" +"The config value `{name}' has type `{current.__name__}', defaults to " +"`{default.__name__}'." +msgstr "配置项“{name}”的值被配置成“{current.__name__}”类型,默认为“{default.__name__}”。" -#: sphinx/builders/__init__.py:235 +#: config.py:858 #, python-format -msgid "targets for %d po files that are specified" -msgstr "指定了 %d 个 po 文件的目标文件" +msgid "primary_domain %r not found, ignored." +msgstr "primary_domain %r 不存在,已忽略。" -#: sphinx/builders/__init__.py:243 -#, python-format -msgid "targets for %d po files that are out of date" -msgstr "%d 个 po 文件的目标文件已过期" +#: config.py:878 +msgid "" +"Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" +" behaviour, set \"master_doc = 'contents'\"." +msgstr "Sphinx 现在默认使用“index”作为主文档。为了保留 2.0 之前的行为,请设置“ master_doc = 'contents' ”。" -#: sphinx/builders/__init__.py:252 -msgid "all source files" -msgstr "所有源文件" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." +msgstr "对非 UTF-8 编码的源代码支持已废弃,并将在 Sphinx 10 中被移除。如果这对您的使用造成问题,请在 https://github.com/sphinx-doc/sphinx/issues/13665 留言。" -#: sphinx/builders/__init__.py:262 -#, python-format -msgid "file %r given on command line does not exist, " -msgstr "命令行给定的文件 %r 不存在" +#: environment/__init__.py:89 +msgid "new config" +msgstr "新配置" + +#: environment/__init__.py:90 +msgid "config changed" +msgstr "配置发生了变化" + +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "扩展发生了变化" + +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "构建环境版本与当前环境不符" + +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "源文件目录发生了变化" -#: sphinx/builders/__init__.py:267 +#: environment/__init__.py:350 #, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "源文件目录中不存在命令行给定的文件 %r,将被忽略" +msgid "The configuration has changed (1 option: %r)" +msgstr "配置已改变 (1 个选项: %r)" -#: sphinx/builders/__init__.py:273 +#: environment/__init__.py:355 #, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "命令行给定的文件 %r 不是有效文档,将被忽略" +msgid "The configuration has changed (%d options: %s)" +msgstr "配置已改变 (%d 个选项: %s)" -#: sphinx/builders/__init__.py:282 +#: environment/__init__.py:361 #, python-format -msgid "%d source files given on command line" -msgstr "命令行给定了 %d 个源文件" +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "配置已改变 (%d 个选项: %s, ...)" + +#: environment/__init__.py:404 +msgid "" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "本环境与选择的构建器不兼容,请选择其他的文档树目录。" -#: sphinx/builders/__init__.py:294 +#: environment/__init__.py:518 #, python-format -msgid "targets for %d source files that are out of date" -msgstr "%d 个源文件的目标文件已过期" +msgid "Failed to scan documents in %s: %r" +msgstr "无法在 %s 中扫描文档:%r" -#: sphinx/builders/__init__.py:309 sphinx/builders/gettext.py:243 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "building [%s]: " -msgstr "正在构建 [%s]: " +msgid "Domain %r is not registered" +msgstr "未注册的域 %r" -#: sphinx/builders/__init__.py:316 -msgid "looking for now-outdated files... " -msgstr "正在查找当前已过期的文件……" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "文档没有加入到任何目录树中" -#: sphinx/builders/__init__.py:320 +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "目录树存在自引用,已忽略。" + +#: environment/__init__.py:952 #, python-format -msgid "%d found" -msgstr "找到 %d 个已过期文件" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgstr "文档在多个 toctree 中被引用: %s, 选择: %s <- %s" -#: sphinx/builders/__init__.py:322 -msgid "none found" -msgstr "没有找到已过期文件" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "注意" -#: sphinx/builders/__init__.py:327 -msgid "pickling environment" -msgstr "正在 Pickle 序列化环境" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "小心" -#: sphinx/builders/__init__.py:333 -msgid "checking consistency" -msgstr "正在校验一致性" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "危险" -#: sphinx/builders/__init__.py:337 -msgid "no targets are out of date." -msgstr "没有过期的目标文件。" +#: locale/__init__.py:232 +msgid "Error" +msgstr "错误" -#: sphinx/builders/__init__.py:376 -msgid "updating environment: " -msgstr "正在更新环境:" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "提示" -#: sphinx/builders/__init__.py:397 -#, python-format -msgid "%s added, %s changed, %s removed" -msgstr "有 %s 个新增文件,有 %s 个文件已被修改,有 %s 个文件已被移除" +#: locale/__init__.py:234 +msgid "Important" +msgstr "重要" -#: sphinx/builders/__init__.py:435 sphinx/builders/__init__.py:447 -msgid "reading sources... " -msgstr "正在读取源文件……" +#: locale/__init__.py:235 +msgid "Note" +msgstr "备注" -#: sphinx/builders/__init__.py:549 -#, python-format -msgid "docnames to write: %s" -msgstr "待写入文档名称:%s" +#: locale/__init__.py:236 +msgid "See also" +msgstr "参见" -#: sphinx/builders/__init__.py:558 sphinx/builders/singlehtml.py:157 -msgid "preparing documents" -msgstr "正在准备写入文档" +#: locale/__init__.py:237 +msgid "Tip" +msgstr "小技巧" -#: sphinx/builders/__init__.py:561 -msgid "copying assets" -msgstr "正在复制资产文件" +#: locale/__init__.py:238 +msgid "Warning" +msgstr "警告" -#: sphinx/builders/_epub_base.py:215 +#: builders/texinfo.py:41 #, python-format -msgid "duplicated ToC entry found: %s" -msgstr "发现重复的目录条目:%s" +msgid "The Texinfo files are in %(outdir)s." +msgstr "Texinfo 文件保存在 %(outdir)s 目录。" -#: sphinx/builders/_epub_base.py:404 sphinx/builders/html/__init__.py:758 -#: sphinx/builders/latex/__init__.py:432 sphinx/builders/texinfo.py:187 -msgid "copying images... " -msgstr "正在复制图像文件……" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\n在该目录下运行“make”命令以通过 makeinfo 处理这些 Texinfo 文件\n(在此处用“make info”即可自动执行上述操作)。" -#: sphinx/builders/_epub_base.py:411 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "无法读取图像文件 %r:改为直接复制" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "未找到“texinfo_documents”配置项,不会写入文档" -#: sphinx/builders/_epub_base.py:417 sphinx/builders/html/__init__.py:766 -#: sphinx/builders/latex/__init__.py:440 sphinx/builders/texinfo.py:197 +#: builders/texinfo.py:85 #, python-format -msgid "cannot copy image file %r: %s" -msgstr "无法复制图像文件 %r:%s" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "配置项“texinfo_documents”引用了文档 %s 不存在" -#: sphinx/builders/_epub_base.py:434 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "cannot write image file %r: %s" -msgstr "无法写入图像文件 %r:%s" +msgid "processing %s" +msgstr "正在处理 %s" -#: sphinx/builders/_epub_base.py:444 -msgid "Pillow not found - copying image files" -msgstr "未找到 Pillow - 正在复制图像文件" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "正在写入" -#: sphinx/builders/_epub_base.py:470 -msgid "writing mimetype file..." -msgstr "正在写入 mimetype 文件……" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "正在解析引用……" -#: sphinx/builders/_epub_base.py:475 -msgid "writing META-INF/container.xml file..." -msgstr "正在写入 META-INF/container.xml 文件……" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (在 " -#: sphinx/builders/_epub_base.py:508 -msgid "writing content.opf file..." -msgstr "正在写入 content.opf 文件……" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "正在复制图像文件……" -#: sphinx/builders/_epub_base.py:539 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "%s 的 MIME 类型未知,已忽略" +msgid "cannot copy image file %r: %s" +msgstr "无法复制图像文件 %r:%s" -#: sphinx/builders/_epub_base.py:686 -msgid "writing toc.ncx file..." -msgstr "正在写入 toc.ncx 文件……" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "正在复制 Texinfo 支持文件" -#: sphinx/builders/_epub_base.py:711 +#: builders/texinfo.py:218 #, python-format -msgid "writing %s file..." -msgstr "正在写入 %s 文件……" +msgid "error writing file Makefile: %s" +msgstr "写入 Makefile 文件时出错:%s" -#: sphinx/builders/changes.py:32 +#: builders/manpage.py:37 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "概览文件保存在 %(outdir)s 目录 。" +msgid "The manual pages are in %(outdir)s." +msgstr "手册页保存在 %(outdir)s 目录。" + +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "未找到“man_pages”配置项,不会写入手册页" -#: sphinx/builders/changes.py:59 +#: builders/manpage.py:64 #, python-format -msgid "no changes in version %s." -msgstr "%s 版本中没有做出修改。" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "配置项“man_pages”引用的文档 %s 不存在" -#: sphinx/builders/changes.py:61 -msgid "writing summary file..." -msgstr "正在写入摘要文件……" +#: builders/singlehtml.py:35 +#, python-format +msgid "The HTML page is in %(outdir)s." +msgstr "HTML 页面保存在 %(outdir)s 目录。" -#: sphinx/builders/changes.py:76 -msgid "Builtins" -msgstr "内置模块" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "正在装配成单页面文档" -#: sphinx/builders/changes.py:78 -msgid "Module level" -msgstr "模块级" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "正在写入附加文件" -#: sphinx/builders/changes.py:123 -msgid "copying source files..." -msgstr "正在复制源文件……" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "伪构建器不生成文件。" -#: sphinx/builders/changes.py:130 +#: builders/gettext.py:243 #, python-format -msgid "could not read %r for changelog creation" -msgstr "无法读取用于创建变更记录的 %r" +msgid "The message catalogs are in %(outdir)s." +msgstr "消息目录保存在 %(outdir)s 目录。" -#: sphinx/builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "伪构建器不生成文件。" +#: builders/__init__.py:400 builders/gettext.py:264 +#, python-format +msgid "building [%s]: " +msgstr "正在构建 [%s]: " + +#: builders/gettext.py:265 +#, python-format +msgid "targets for %d template files" +msgstr "%d 个模板文件的目标文件" + +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "正在读取模板……" + +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "正在写入消息目录... " + +#: builders/linkcheck.py:87 +#, python-format +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "请在上述输出或 %(outdir)s/output.txt 中查找错误" + +#: builders/linkcheck.py:159 +#, python-format +msgid "broken link: %s (%s)" +msgstr "损坏的链接:%s(%s)" + +#: builders/linkcheck.py:561 +#, python-format +msgid "Anchor '%s' not found" +msgstr "未找到锚点“%s”" + +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "linkcheck_allowed_redirects. 需要一个 dict" + +#: builders/linkcheck.py:799 +#, python-format +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "无法编译 linkcheck_allowed_redirects 配置项中的正则表达式:%r %s" -#: sphinx/builders/epub3.py:81 +#: builders/epub3.py:83 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "ePub 文件保存在 %(outdir)s。" -#: sphinx/builders/epub3.py:185 +#: builders/epub3.py:188 msgid "writing nav.xhtml file..." msgstr "正在写入 nav.xhtml 文件……" -#: sphinx/builders/epub3.py:211 +#: builders/epub3.py:224 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "对于 EPUB3 格式,配置项“epub_language”(或“language”)的值不能为空" -#: sphinx/builders/epub3.py:215 +#: builders/epub3.py:230 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "对于 EPUB3 格式,配置项“epub_uid”的值应为 XML 名称格式的字符串" -#: sphinx/builders/epub3.py:218 +#: builders/epub3.py:235 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "对于 EPUB3 格式,配置项“epub_title”(或“html_title”)的值不能为空" -#: sphinx/builders/epub3.py:222 +#: builders/epub3.py:241 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式,配置项“epub_author”的值不能为空" -#: sphinx/builders/epub3.py:225 +#: builders/epub3.py:245 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式,配置项“epub_contributor”的值不能为空" -#: sphinx/builders/epub3.py:228 +#: builders/epub3.py:250 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式,配置项“epub_description”的值不能为空" -#: sphinx/builders/epub3.py:231 +#: builders/epub3.py:254 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式,配置项“epub_publisher”的值不能为空" -#: sphinx/builders/epub3.py:234 +#: builders/epub3.py:259 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "对于 EPUB3 格式,配置项“epub_copyright”(或“copyright”)不能为空" -#: sphinx/builders/epub3.py:238 +#: builders/epub3.py:265 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式,配置项“epub_identifier”的值不能为空" -#: sphinx/builders/epub3.py:241 +#: builders/epub3.py:268 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式,配置项“version”的值不能为空" -#: sphinx/builders/epub3.py:255 sphinx/builders/html/__init__.py:1187 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format msgid "invalid css_file: %r, ignored" msgstr "无效的 css_file:%r,已忽略" -#: sphinx/builders/gettext.py:222 +#: builders/xml.py:29 #, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "消息目录保存在 %(outdir)s 目录。" +msgid "The XML files are in %(outdir)s." +msgstr "XML 文件保存在 %(outdir)s 目录。" -#: sphinx/builders/gettext.py:244 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "targets for %d template files" -msgstr "%d 个模板文件的目标文件" - -#: sphinx/builders/gettext.py:248 -msgid "reading templates... " -msgstr "正在读取模板……" - -#: sphinx/builders/gettext.py:282 -msgid "writing message catalogs... " -msgstr "正在写入消息目录... " +msgid "error writing file %s: %s" +msgstr "写入文件 %s 时发生错误:%s" -#: sphinx/builders/linkcheck.py:59 +#: builders/xml.py:103 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "请在上述输出或 %(outdir)s/output.txt 中查找错误" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "伪 XML 文件保存在 %(outdir)s。" -#: sphinx/builders/linkcheck.py:137 +#: builders/_epub_base.py:223 #, python-format -msgid "broken link: %s (%s)" -msgstr "损坏的链接:%s(%s)" +msgid "duplicated ToC entry found: %s" +msgstr "发现重复的目录条目:%s" -#: sphinx/builders/linkcheck.py:660 +#: builders/_epub_base.py:436 #, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "无法编译 linkcheck_allowed_redirects 配置项中的正则表达式:%r %s" +msgid "cannot read image file %r: copying it instead" +msgstr "无法读取图像文件 %r:改为直接复制" -#: sphinx/builders/manpage.py:37 +#: builders/_epub_base.py:467 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "手册页保存在 %(outdir)s 目录。" +msgid "cannot write image file %r: %s" +msgstr "无法写入图像文件 %r:%s" -#: sphinx/builders/manpage.py:44 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "未找到“man_pages”配置项,不会写入手册页" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "未找到 Pillow - 正在复制图像文件" -#: sphinx/builders/latex/__init__.py:314 sphinx/builders/manpage.py:53 -#: sphinx/builders/singlehtml.py:165 sphinx/builders/texinfo.py:112 -msgid "writing" -msgstr "正在写入" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "正在写入 mimetype 文件……" -#: sphinx/builders/manpage.py:68 -#, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "配置项“man_pages”引用的文档 %s 不存在" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "正在写入 META-INF/container.xml 文件……" -#: sphinx/builders/singlehtml.py:34 +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "正在写入 content.opf 文件……" + +#: builders/_epub_base.py:594 #, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "HTML 页面保存在 %(outdir)s 目录。" +msgid "unknown mimetype for %s, ignoring" +msgstr "%s 的 MIME 类型未知,已忽略" -#: sphinx/builders/singlehtml.py:160 -msgid "assembling single document" -msgstr "正在装配成单页面文档" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "节点具有无效的级别" -#: sphinx/builders/singlehtml.py:178 -msgid "writing additional files" -msgstr "正在写入附加文件" +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "正在写入 toc.ncx 文件……" -#: sphinx/builders/texinfo.py:48 +#: builders/_epub_base.py:802 #, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Texinfo 文件保存在 %(outdir)s 目录。" - -#: sphinx/builders/texinfo.py:50 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\n在该目录下运行“make”命令以通过 makeinfo 处理这些 Texinfo 文件\n(在此处用“make info”即可自动执行上述操作)。" - -#: sphinx/builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "未找到“texinfo_documents”配置项,不会写入文档" +msgid "writing %s file..." +msgstr "正在写入 %s 文件……" -#: sphinx/builders/texinfo.py:85 +#: builders/text.py:27 #, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "配置项“texinfo_documents”引用了文档 %s 不存在" +msgid "The text files are in %(outdir)s." +msgstr "文本文件保存在 %(outdir)s 目录。" -#: sphinx/builders/latex/__init__.py:296 sphinx/builders/texinfo.py:108 +#: builders/__init__.py:229 #, python-format -msgid "processing %s" -msgstr "正在处理 %s" +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "没有找到适合 %s 构建器的图像:%s(%s)" -#: sphinx/builders/latex/__init__.py:369 sphinx/builders/texinfo.py:161 -msgid "resolving references..." -msgstr "正在解析引用……" +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "没有找到适合 %s 构建器的图像:%s" -#: sphinx/builders/latex/__init__.py:380 sphinx/builders/texinfo.py:171 -msgid " (in " -msgstr " (在 " +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "正在构建 [mo]: " -#: sphinx/builders/texinfo.py:202 -msgid "copying Texinfo support files" -msgstr "正在复制 Texinfo 支持文件" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "正在写入输出……" -#: sphinx/builders/texinfo.py:206 +#: builders/__init__.py:280 #, python-format -msgid "error writing file Makefile: %s" -msgstr "写入 Makefile 文件时出错:%s" +msgid "all of %d po files" +msgstr "所有的 %d po 文件" -#: sphinx/builders/text.py:30 +#: builders/__init__.py:302 #, python-format -msgid "The text files are in %(outdir)s." -msgstr "文本文件保存在 %(outdir)s 目录。" +msgid "targets for %d po files that are specified" +msgstr "指定了 %d 个 po 文件的目标文件" -#: sphinx/builders/html/__init__.py:1138 sphinx/builders/text.py:77 -#: sphinx/builders/xml.py:96 +#: builders/__init__.py:314 #, python-format -msgid "error writing file %s: %s" -msgstr "写入文件 %s 时发生错误:%s" +msgid "targets for %d po files that are out of date" +msgstr "%d 个 po 文件的目标文件已过期" -#: sphinx/builders/xml.py:36 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "XML 文件保存在 %(outdir)s 目录。" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "所有源文件" -#: sphinx/builders/xml.py:109 +#: builders/__init__.py:335 #, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "伪 XML 文件保存在 %(outdir)s。" +msgid "file %r given on command line does not exist, " +msgstr "命令行给定的文件 %r 不存在" -#: sphinx/builders/html/__init__.py:130 +#: builders/__init__.py:342 #, python-format -msgid "build info file is broken: %r" -msgstr "构建信息文件损坏:%r" +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "源文件目录中不存在命令行给定的文件 %r,将被忽略" -#: sphinx/builders/html/__init__.py:168 +#: builders/__init__.py:353 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "HTML 页面保存在 %(outdir)s 目录。" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "命令行给定的文件 %r 不是有效文档,将被忽略" -#: sphinx/builders/html/__init__.py:394 +#: builders/__init__.py:366 #, python-format -msgid "Failed to read build info file: %r" -msgstr "读取构建信息文件失败:%r" +msgid "%d source files given on command line" +msgstr "命令行给定了 %d 个源文件" -#: sphinx/builders/html/__init__.py:487 sphinx/builders/latex/__init__.py:189 -#: sphinx/transforms/__init__.py:119 sphinx/writers/manpage.py:101 -#: sphinx/writers/texinfo.py:227 +#: builders/__init__.py:382 #, python-format -msgid "%b %d, %Y" -msgstr "%Y 年 %m 月 %d 日" - -#: sphinx/builders/html/__init__.py:506 sphinx/themes/basic/defindex.html:30 -msgid "General Index" -msgstr "总索引" - -#: sphinx/builders/html/__init__.py:506 -msgid "index" -msgstr "索引" - -#: sphinx/builders/html/__init__.py:579 -msgid "next" -msgstr "下一页" - -#: sphinx/builders/html/__init__.py:588 -msgid "previous" -msgstr "上一页" - -#: sphinx/builders/html/__init__.py:684 -msgid "generating indices" -msgstr "正在生成索引" - -#: sphinx/builders/html/__init__.py:699 -msgid "writing additional pages" -msgstr "正在写入附加页面" +msgid "targets for %d source files that are out of date" +msgstr "%d 个源文件的目标文件已过期" -#: sphinx/builders/html/__init__.py:776 -msgid "copying downloadable files... " -msgstr "正在复制可下载文件……" +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "正在查找当前已过期的文件……" -#: sphinx/builders/html/__init__.py:784 +#: builders/__init__.py:415 #, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "无法复制可下载文件 %r:%s" +msgid "%d found" +msgstr "找到 %d 个已过期文件" -#: sphinx/builders/html/__init__.py:817 sphinx/builders/html/__init__.py:829 -#, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "无法复制 html_static_file 中的文件:%s: %r" +#: builders/__init__.py:417 +msgid "none found" +msgstr "没有找到已过期文件" -#: sphinx/builders/html/__init__.py:850 -msgid "copying static files" -msgstr "正在复制静态文件" +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "正在 Pickle 序列化环境" -#: sphinx/builders/html/__init__.py:866 -#, python-format -msgid "cannot copy static file %r" -msgstr "无法复制静态文件 %r" +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "正在校验一致性" -#: sphinx/builders/html/__init__.py:871 -msgid "copying extra files" -msgstr "正在复制额外文件" +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "没有过期的目标文件。" -#: sphinx/builders/html/__init__.py:877 -#, python-format -msgid "cannot copy extra file %r" -msgstr "无法复制额外文件 %r" +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "正在更新环境:" -#: sphinx/builders/html/__init__.py:884 +#: builders/__init__.py:499 #, python-format -msgid "Failed to write build info file: %r" -msgstr "写入构建信息文件失败:%r" +msgid "%s added, %s changed, %s removed" +msgstr "有 %s 个新增文件,有 %s 个文件已被修改,有 %s 个文件已被移除" -#: sphinx/builders/html/__init__.py:933 +#: builders/__init__.py:536 +#, python-format msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "无法加载搜索索引,不会构建所有文档:索引将不完整。" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "Sphinx 无法加载主文档(%s),原因是其与内置的排除模式 %r 相匹配。请把主文档移动到其他位置。" -#: sphinx/builders/html/__init__.py:978 +#: builders/__init__.py:545 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "页面 %s 同时符合两条 html_sidebars 规则:%r 和 %r" +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "Sphinx 无法加载主文档(%s),原因是其与 conf.py 指定的排除模式 %r 相匹配。请从 conf.py 中移除该排除模式。" -#: sphinx/builders/html/__init__.py:1121 +#: builders/__init__.py:556 #, python-format msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "在渲染页面 %s 时发生了 Unicode 错误。请确保所有包含非 ASCII 字符的配置项均为 Unicode 字符串。" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "Sphinx 无法加载主文档(%s),原因是其没有与自定义的 include_patterns = %r 匹配。请确保 include_patterns 中的规则能匹配到主文档。" -#: sphinx/builders/html/__init__.py:1126 +#: builders/__init__.py:563 #, python-format msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "渲染页面 %s 时发生了错误。\n原因:%r" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "Sphinx 无法加载主文档(%s)。主文档必须位于源文件目录及其子目录下。" -#: sphinx/builders/html/__init__.py:1154 -msgid "dumping object inventory" -msgstr "正在导出对象清单" +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "正在读取源文件……" -#: sphinx/builders/html/__init__.py:1162 +#: builders/__init__.py:725 #, python-format -msgid "dumping search index in %s" -msgstr "正在导出 %s 的搜索索引" +msgid "docnames to write: %s" +msgstr "待写入文档名称:%s" -#: sphinx/builders/html/__init__.py:1210 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "无效的 js_file:%r,已忽略" +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "没有可写的文档名称!" -#: sphinx/builders/html/__init__.py:1238 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "注册了多个 math_renderer,但没有选择 math_renderer。" +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "正在准备写入文档" -#: sphinx/builders/html/__init__.py:1241 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "给定的 math_renderer %r 不存在。" +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "正在复制资产文件" -#: sphinx/builders/html/__init__.py:1249 +#: builders/changes.py:29 #, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "html_extra_path 入口 %r 不存在" +msgid "The overview file is in %(outdir)s." +msgstr "概览文件保存在 %(outdir)s 目录 。" -#: sphinx/builders/html/__init__.py:1253 +#: builders/changes.py:65 #, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "html_extra_path 入口 %r 被置于输出目录内" +msgid "no changes in version %s." +msgstr "%s 版本中没有做出修改。" -#: sphinx/builders/html/__init__.py:1262 -#, python-format -msgid "html_static_path entry %r does not exist" -msgstr "html_static_path 入口 %r 不存在" +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "正在写入摘要文件……" -#: sphinx/builders/html/__init__.py:1266 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "html_static_path 入口 %r 置于输出目录内" +#: builders/changes.py:79 +msgid "Builtins" +msgstr "内置模块" -#: sphinx/builders/html/__init__.py:1275 sphinx/builders/latex/__init__.py:444 -#, python-format -msgid "logo file %r does not exist" -msgstr "logo 文件 %r 不存在" +#: builders/changes.py:81 +msgid "Module level" +msgstr "模块级" -#: sphinx/builders/html/__init__.py:1284 +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "正在复制源文件……" + +#: builders/changes.py:146 #, python-format -msgid "favicon file %r does not exist" -msgstr "favicon 文件 %r 不存在" +msgid "could not read %r for changelog creation" +msgstr "无法读取用于创建变更记录的 %r" -#: sphinx/builders/html/__init__.py:1291 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "Sphinx 不再支持 HTML 4。(在配置项中检测到了“html4_writer=True”)" +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "无效的正则表达式 %r 出现在 %s" -#: sphinx/builders/html/__init__.py:1306 +#: ext/coverage.py:140 ext/coverage.py:301 #, python-format -msgid "%s %s documentation" -msgstr "%s %s 文档" +msgid "module %s could not be imported: %s" +msgstr "无法导入模块 %s:%s" -#: sphinx/builders/latex/__init__.py:115 +#: ext/coverage.py:148 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "LaTex 文件保存在 %(outdir)s 目录。" +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "下列模块有对应文档但未在 coverage_modules 中列出:%s" -#: sphinx/builders/latex/__init__.py:117 +#: ext/coverage.py:158 +#, python-format msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\n在该目录下运行“make”以通过 (pdf)latex 处理这些 LaTex 文件\n(在此处用“make latexpdf”即可自动执行上述操作)。" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "以下模块在 coverage_modules 中有指定,但未被记录:%s" -#: sphinx/builders/latex/__init__.py:152 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "未找到“latex_documents”配置项,不会写入文档" +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "源文件中的覆盖率测试已完成,请查看 %(outdir)s{sep}python.txt 中的结果。" -#: sphinx/builders/latex/__init__.py:160 +#: ext/coverage.py:187 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "配置项“latex_documents”引用的文档 %s 不存在" +msgid "invalid regex %r in coverage_c_regexes" +msgstr "coverage_c_regexes 中有无效的正则表达式 %r" -#: sphinx/builders/latex/__init__.py:196 sphinx/domains/std/__init__.py:559 -#: sphinx/domains/std/__init__.py:571 sphinx/templates/latex/latex.tex_t:106 -#: sphinx/themes/basic/genindex-single.html:30 -#: sphinx/themes/basic/genindex-single.html:55 -#: sphinx/themes/basic/genindex-split.html:11 -#: sphinx/themes/basic/genindex-split.html:14 -#: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 -#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:138 -#: sphinx/writers/texinfo.py:497 -msgid "Index" -msgstr "索引" +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "缺少文档的 C API:%s [%s] 在 %s 文件中" -#: sphinx/builders/latex/__init__.py:199 sphinx/templates/latex/latex.tex_t:91 -msgid "Release" -msgstr "发行版本" +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "缺少文档的 Python 函数: %s :: %s" -#: sphinx/builders/latex/__init__.py:213 sphinx/writers/latex.py:370 +#: ext/coverage.py:473 #, python-format -msgid "no Babel option known for language %r" -msgstr "没有语种 %r 的 Babel 选项" +msgid "undocumented python class: %s :: %s" +msgstr "缺少文档的 Python 类:%s :: %s" -#: sphinx/builders/latex/__init__.py:394 -msgid "copying TeX support files" -msgstr "正在复制 TeX 支持文件" +#: ext/coverage.py:492 +#, python-format +msgid "undocumented python method: %s :: %s :: %s" +msgstr "缺少文档的 Python 方法:%s :: %s :: %s" -#: sphinx/builders/latex/__init__.py:410 -msgid "copying TeX support files..." -msgstr "正在复制 TeX 支持文件……" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "可以用 extlink 替换硬编码链接 %r(请尝试改用 %r)" -#: sphinx/builders/latex/__init__.py:423 -msgid "copying additional files" -msgstr "正在复制附加文件" +#: ext/todo.py:61 +msgid "Todo" +msgstr "待处理" -#: sphinx/builders/latex/__init__.py:466 +#: ext/todo.py:94 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "未知配置项:latex_elements[%r],已忽略。" +msgid "TODO entry found: %s" +msgstr "发现待处理条目:%s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" -#: sphinx/builders/latex/__init__.py:474 +#: ext/todo.py:154 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "未知主题选项:latex_theme_options[%r],已忽略。" +msgid "(The <> is located in %s, line %d.)" +msgstr "(<> 见 %s,第 %d 行。)" -#: sphinx/builders/latex/theming.py:87 +#: ext/todo.py:166 +msgid "original entry" +msgstr "原始条目" + +#: ext/imgconverter.py:44 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r 中缺少“theme”配置项" +msgid "" +"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" +"\n" +"Traceback: %s" +msgstr "无法运行图像转换命令 %r。“sphinx.ext.imgconverter”默认依赖于 ImageMagick。请确保已安装了它,或者可以自定义“image_converter”选项,设置一个其他的转换命令。\n\n回溯信息:%s" -#: sphinx/builders/latex/theming.py:90 +#: ext/imgconverter.py:56 ext/imgconverter.py:90 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r 中缺少“%s”配置项" +msgid "" +"convert exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "格式转换发生错误并退出:\n[stderr]\n%r\n[stdout]\n%r" -#: sphinx/builders/latex/transforms.py:120 -msgid "Failed to get a docname!" -msgstr "无法获取文档名称!" +#: ext/imgconverter.py:83 +#, python-format +msgid "convert command %r cannot be run, check the image_converter setting" +msgstr "无法运行格式转换命令 %r,请检查 image_converter 的设置" -#: sphinx/builders/latex/transforms.py:121 -msgid "Failed to get a docname for source {source!r}!" -msgstr "无法获取文档源码 {source!r} 的文档名称!" +#: ext/graphviz.py:138 +msgid "Graphviz directive cannot have both content and a filename argument" +msgstr "不能同时指定 Graphviz 指令的内容和文件名参数" -#: sphinx/builders/latex/transforms.py:482 +#: ext/graphviz.py:153 #, python-format -msgid "No footnote was found for given reference node %r" -msgstr "给定的引用节点 %r 没有对应的脚注" +msgid "External Graphviz file %r not found or reading it failed" +msgstr "外部 Graphviz 文件 %r 不存在或读取失败" -#: sphinx/cmd/build.py:46 -msgid "Exception occurred while building, starting debugger:" -msgstr "构建时抛出异常,正在启动调试器:" +#: ext/graphviz.py:164 +msgid "Ignoring \"graphviz\" directive without content." +msgstr "已忽略无内容的“graphviz”指令。" -#: sphinx/cmd/build.py:61 -msgid "Interrupted!" -msgstr "已中断!" +#: ext/graphviz.py:287 +#, python-format +msgid "graphviz_dot executable path must be set! %r" +msgstr "必须设置 graphviz_dot 可执行程序的路径!%r" -#: sphinx/cmd/build.py:63 -msgid "reST markup error:" -msgstr "reST 标记错误:" +#: ext/graphviz.py:328 +#, python-format +msgid "" +"dot command %r cannot be run (needed for graphviz output), check the " +"graphviz_dot setting" +msgstr "无法运行 dot 命令 %r(为输出 graphviz 所必需),请检查 graphviz_dot 的设置" -#: sphinx/cmd/build.py:69 -msgid "Encoding error:" -msgstr "编码错误:" +#: ext/graphviz.py:339 +#, python-format +msgid "" +"dot exited with error:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "dot 发生错误并退出:\n[stderr]\n%r\n[stdout]\n%r" -#: sphinx/cmd/build.py:72 sphinx/cmd/build.py:87 +#: ext/graphviz.py:344 #, python-format msgid "" -"The full traceback has been saved in %s, if you want to report the issue to " -"the developers." -msgstr "如果你想向开发者报告问题,可以查阅已经保存在 %s 的完整 Traceback 信息 。" +"dot did not produce an output file:\n" +"[stderr]\n" +"%r\n" +"[stdout]\n" +"%r" +msgstr "dot 未生成输出文件:\n[stderr]\n%r\n[stdout]\n%r" -#: sphinx/cmd/build.py:76 -msgid "Recursion error:" -msgstr "递归错误:" +#: ext/graphviz.py:367 +#, python-format +msgid "graphviz_output_format must be either 'png' or 'svg', but is %r" +msgstr "graphviz_output_format 必须是 'png' 或 'svg',但为 %r" -#: sphinx/cmd/build.py:79 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1000 in conf.py " -"with e.g.:" -msgstr "Python 中默认递归层数上限为 1000,可以像这样在 conf.py 中增大这一上限,请谨慎修改:" +#: ext/graphviz.py:373 ext/graphviz.py:436 ext/graphviz.py:480 +#, python-format +msgid "dot code %r: %s" +msgstr "dot 代码 %r: %s" -#: sphinx/cmd/build.py:84 -msgid "Exception occurred:" -msgstr "抛出异常:" +#: ext/graphviz.py:493 ext/graphviz.py:501 +#, python-format +msgid "[graph: %s]" +msgstr "[图表:%s]" -#: sphinx/cmd/build.py:90 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "即便抛出的错误时是用户导致的,也请向我们投递报告,以便将来可以提示更友好、更详细的错误信息。" +#: ext/graphviz.py:495 ext/graphviz.py:503 +msgid "[graph]" +msgstr "[图表]" -#: sphinx/cmd/build.py:93 +#: ext/imgmath.py:148 +#, python-format msgid "" -"A bug report can be filed in the tracker at . Thanks!" -msgstr "Bug 报告可以在 Bug 追踪系统 处投递。谢谢!" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "无法运行 LaTeX 命令 %r (显示数学公式所必需),请检查 imgmath_latex 的设置" -#: sphinx/cmd/build.py:109 -msgid "job number should be a positive number" -msgstr "并发任务数应为正值" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "无法运行 %s 命令 %r (显示数学公式所必需),请检查 imgmath_%s 的设置" -#: sphinx/cmd/build.py:117 sphinx/cmd/quickstart.py:474 -#: sphinx/ext/apidoc.py:317 sphinx/ext/autosummary/generate.py:689 -msgid "For more information, visit ." -msgstr "想要了解更多信息,请访问 。" +#: ext/imgmath.py:326 +#, python-format +msgid "display latex %r: %s" +msgstr "显示 LaTeX %r:%s" -#: sphinx/cmd/build.py:118 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\n从源文件生成文档。\n\nsphinx-build 从 SOURCEDIR 中的文件生成文档,并保存在 OUTPUTDIR。\n它从 SOURCEDIR 的“conf.py”中读取配置。“sphinx-quickstart”工具可以生\n成包括“conf.py”在内的模板文件。\n\nsphinx-build 可以生成多种格式的文档。在命令行中指定构建器名称即可\n选择文档格式,默认是 HTML。构建器也可以执行文档处理相关的其他\n任务。\n\n默认只会重新构建过期内容。如果指定了文件名,那么只会产生这些文件\n的输出。\n" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "内联 LaTeX %r:%s" -#: sphinx/cmd/build.py:139 -msgid "path to documentation source files" -msgstr "文档源文件的路径" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "链接到此公式" -#: sphinx/cmd/build.py:141 -msgid "path to output directory" -msgstr "输出目录的路径" +#: ext/doctest.py:118 +#, python-format +msgid "missing '+' or '-' in '%s' option." +msgstr "“%s”选项中缺少“+”或“-”。" -#: sphinx/cmd/build.py:143 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" +#: ext/doctest.py:124 +#, python-format +msgid "'%s' is not a valid option." +msgstr "无效的选项“%s”。" -#: sphinx/cmd/build.py:146 -msgid "general options" -msgstr "通用选项" +#: ext/doctest.py:139 +#, python-format +msgid "'%s' is not a valid pyversion option" +msgstr "无效的 pyversion 选项“%s”" -#: sphinx/cmd/build.py:149 -msgid "builder to use (default: 'html')" -msgstr "" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "无效的 TestCode 类型" -#: sphinx/cmd/build.py:152 +#: ext/doctest.py:297 +#, python-format msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "已完成源文件的文档测试,结果保存在 %(outdir)s/output.txt 中,请查阅。" -#: sphinx/cmd/build.py:155 -msgid "write all files (default: only write new and changed files)" -msgstr "写入所有文件(默认:只写入新文件和修改过的文件)" +#: ext/doctest.py:451 +#, python-format +msgid "no code/output in %s block at %s:%s" +msgstr "块 %s 没有代码或没有输出,该块出现在 %s:%s" -#: sphinx/cmd/build.py:158 -msgid "don't use a saved environment, always read all files" -msgstr "不使用已保存的环境,始终读取全部文件" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" +msgstr "已忽略无效的文档代码:%r" -#: sphinx/cmd/build.py:161 -msgid "path options" -msgstr "" +#: ext/autosectionlabel.py:52 +#, python-format +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "为“%s”一节增加标签“%s”" + +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 +#, python-format +msgid "duplicate label %s, other instance in %s" +msgstr "重复的标签 %s,另一标签出现在 %s" + +#: ext/duration.py:47 +#, python-format +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "读取时长 %.3f 超过了时长限制 %.3f 秒" -#: sphinx/cmd/build.py:163 +#: ext/duration.py:117 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" +"====================== total reading duration ==========================" +msgstr "====================== 总读取时长 ==========================" -#: sphinx/cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" +#: ext/duration.py:124 +#, python-format +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "读取 %d 文件%s 的总时长:%d 分 %.3f 秒" -#: sphinx/cmd/build.py:171 -msgid "use no configuration file, only use settings from -D options" -msgstr "" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "====================== 最长读取耗时 =======================" -#: sphinx/cmd/build.py:174 -msgid "override a setting in configuration file" -msgstr "覆盖配置文件中的配置项" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" +msgstr "%.3f 秒 %s" -#: sphinx/cmd/build.py:177 +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[源代码]" + +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "正在高亮模块代码……" + +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[文档]" + +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "模块代码" + +#: ext/viewcode.py:359 +#, python-format +msgid "

        Source code for %s

        " +msgstr "

        %s 源代码

        " + +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "概览:模块代码" + +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        代码可用的所有模块

        " + +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" +msgstr "重复的引文 %s,另一引文出现在 %s" + +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." +msgstr "引文 [%s] 没有被引用过。" + +#: domains/math.py:73 +#, python-format +msgid "duplicate label of equation %s, other instance in %s" +msgstr "重复的公式标签 %s,另一公式出现在 %s" + +#: domains/math.py:130 writers/latex.py:2500 +#, python-format +msgid "Invalid math_eqref_format: %r" +msgstr "无效的 math_eqref_format:%r" + +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" +msgstr "%s() (内置函数)" + +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" +msgstr "%s() (%s 方法)" + +#: domains/javascript.py:186 +#, python-format +msgid "%s() (class)" +msgstr "%s()(类)" + +#: domains/javascript.py:188 +#, python-format +msgid "%s (global variable or constant)" +msgstr "%s(全局变量或常量)" + +#: domains/javascript.py:190 domains/python/__init__.py:370 +#, python-format +msgid "%s (%s attribute)" +msgstr "%s(%s 属性)" + +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "参数" + +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "抛出" + +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "返回" + +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "返回类型" + +#: domains/javascript.py:374 +#, python-format +msgid "%s (module)" +msgstr "%s(模块)" + +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "函数" + +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "方法" + +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "类" + +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "数据" + +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "属性" + +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "模块" + +#: domains/javascript.py:458 +#, python-format +msgid "duplicate %s description of %s, other %s in %s" +msgstr "重复的 %s描述 %s,其他的 %s 描述出现在 %s" + +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" +msgstr "%s(指令)" + +#: domains/rst.py:191 domains/rst.py:202 +#, python-format +msgid ":%s: (directive option)" +msgstr ":%s:(指令选项)" + +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" +msgstr "%s(角色)" + +#: domains/rst.py:234 +msgid "directive" +msgstr "指令" + +#: domains/rst.py:235 +msgid "directive-option" +msgstr "指令-选项" + +#: domains/rst.py:236 +msgid "role" +msgstr "角色" + +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" +msgstr "重复的 %s %s 描述,另一描述出现在 %s" + +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" +msgstr "在 %s 版本加入" + +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "在 %s 版本发生变更" + +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "自 %s 版本弃用" + +#: domains/changeset.py:35 +#, python-format +msgid "Removed in version %s" +msgstr "在版本 %s 移除" + +#: domains/__init__.py:322 +#, python-format +msgid "%s %s" +msgstr "%s %s" + +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "并发任务数应为正值" + +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "想要了解更多信息,请访问 。" + +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\n从源文件生成文档。\n\nsphinx-build 从 SOURCEDIR 中的文件生成文档,并保存在 OUTPUTDIR。\n它从 SOURCEDIR 的“conf.py”中读取配置。“sphinx-quickstart”工具可以生\n成包括“conf.py”在内的模板文件。\n\nsphinx-build 可以生成多种格式的文档。在命令行中指定构建器名称即可\n选择文档格式,默认是 HTML。构建器也可以执行文档处理相关的其他\n任务。\n\n默认只会重新构建过期内容。如果指定了文件名,那么只会产生这些文件\n的输出。\n" + +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "文档源文件的路径" + +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "输出目录的路径" + +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "(可选)要重新构建的文件列表。如果指定了 --write-all 参数则忽略此项。" + +#: cmd/build.py:114 +msgid "general options" +msgstr "通用选项" + +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "要使用的构建器(默认:“html”)" + +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "在可能的情况下以 N 个进程并行运行。值为“auto”时为 CPU 核心数量。" + +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "写入所有文件(默认:只写入新文件和修改过的文件)" + +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "不使用已保存的环境,始终读取全部文件" + +#: cmd/build.py:150 +msgid "path options" +msgstr "路径选项" + +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "文档树和环境文件的目录(默认:OUTPUT_DIR/.doctrees)" + +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "配置文件(conf.py)的目录(默认:SOURCE_DIR)" + +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "不使用配置文件,仅使用 -D 选项指定的配置" + +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "覆盖配置文件中的配置项" + +#: cmd/build.py:193 msgid "pass a value into HTML templates" msgstr "向 HTML 模板传值" -#: sphinx/cmd/build.py:180 +#: cmd/build.py:202 msgid "define tag: include \"only\" blocks with TAG" msgstr "定义标签,把涉及标签 TAG 的“only”块纳入到构建中" -#: sphinx/cmd/build.py:182 -msgid "nit-picky mode: warn about all missing references" -msgstr "" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "挑刺模式:在引用了不存在的内容时发出警告" -#: sphinx/cmd/build.py:184 +#: cmd/build.py:212 msgid "console output options" msgstr "控制台输出选项" -#: sphinx/cmd/build.py:187 +#: cmd/build.py:219 msgid "increase verbosity (can be repeated)" msgstr "输出更详细的日志(甚至可能重复)" -#: sphinx/cmd/build.py:189 sphinx/ext/apidoc.py:340 +#: cmd/build.py:226 ext/apidoc/_cli.py:66 msgid "no output on stdout, just warnings on stderr" msgstr "不输出到 stdout,只在 stderr 上输出警告" -#: sphinx/cmd/build.py:191 +#: cmd/build.py:233 msgid "no output at all, not even warnings" msgstr "无任何输出,甚至不会输出警告" -#: sphinx/cmd/build.py:194 +#: cmd/build.py:241 msgid "do emit colored output (default: auto-detect)" msgstr "着色输出(默认:自动检测)" -#: sphinx/cmd/build.py:197 +#: cmd/build.py:249 msgid "do not emit colored output (default: auto-detect)" msgstr "不着色输出(默认:自动检测)" -#: sphinx/cmd/build.py:199 +#: cmd/build.py:252 msgid "warning control options" -msgstr "" +msgstr "警告控制选项" -#: sphinx/cmd/build.py:201 +#: cmd/build.py:258 msgid "write warnings (and errors) to given file" msgstr "把警告(以及错误)信息写入给定的文件" -#: sphinx/cmd/build.py:203 +#: cmd/build.py:265 msgid "turn warnings into errors" msgstr "把警告视为错误" -#: sphinx/cmd/build.py:205 -msgid "with --fail-on-warning, keep going when getting warnings" -msgstr "" - -#: sphinx/cmd/build.py:207 +#: cmd/build.py:273 msgid "show full traceback on exception" msgstr "发生异常时显示完整回溯信息" -#: sphinx/cmd/build.py:209 +#: cmd/build.py:276 msgid "run Pdb on exception" msgstr "发生异常时运行 Pdb" -#: sphinx/cmd/build.py:244 +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "在发出警告时抛出异常" + +#: cmd/build.py:325 msgid "cannot combine -a option and filenames" msgstr "-a 选项和文件名不能同时使用" -#: sphinx/cmd/build.py:276 +#: cmd/build.py:357 #, python-format -msgid "cannot open warning file %r: %s" -msgstr "无法打开用于保存警告信息的文件 %r:%s" +msgid "cannot open warning file '%s': %s" +msgstr "无法打开警告文件 '%s': %s" -#: sphinx/cmd/build.py:296 +#: cmd/build.py:376 msgid "-D option argument must be in the form name=value" msgstr "-D 选项的参数必须是 name=value 形式" -#: sphinx/cmd/build.py:303 +#: cmd/build.py:383 msgid "-A option argument must be in the form name=value" msgstr "-A 选项的参数必须是 name=value 形式" -#: sphinx/cmd/quickstart.py:42 +#: cmd/quickstart.py:52 msgid "automatically insert docstrings from modules" msgstr "自动插入模块中的文档字符串" -#: sphinx/cmd/quickstart.py:43 +#: cmd/quickstart.py:53 msgid "automatically test code snippets in doctest blocks" msgstr "自动运行 doctest 块中的测试代码片段" -#: sphinx/cmd/quickstart.py:44 +#: cmd/quickstart.py:54 msgid "link between Sphinx documentation of different projects" msgstr "链接不同项目的 Sphinx 文档" -#: sphinx/cmd/quickstart.py:45 +#: cmd/quickstart.py:55 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "编写在构建时可以选择显示、隐藏的“todo”条目" -#: sphinx/cmd/quickstart.py:46 +#: cmd/quickstart.py:56 msgid "checks for documentation coverage" msgstr "检查文档覆盖率" -#: sphinx/cmd/quickstart.py:47 +#: cmd/quickstart.py:57 msgid "include math, rendered as PNG or SVG images" msgstr "支持数学公式,渲染成 PNG 或 SVG 图像" -#: sphinx/cmd/quickstart.py:48 +#: cmd/quickstart.py:58 msgid "include math, rendered in the browser by MathJax" msgstr "支持数学公式,用 MathJax 在浏览器中渲染" -#: sphinx/cmd/quickstart.py:49 +#: cmd/quickstart.py:59 msgid "conditional inclusion of content based on config values" msgstr "基于配置值控制构建中包含哪些文档内容" -#: sphinx/cmd/quickstart.py:50 +#: cmd/quickstart.py:60 msgid "include links to the source code of documented Python objects" msgstr "支持链接到文档涉及的 Python 对象源码" -#: sphinx/cmd/quickstart.py:51 +#: cmd/quickstart.py:61 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "创建 .nojekyll 文件,用于在 GitHub Pages 服务发布文档" -#: sphinx/cmd/quickstart.py:93 +#: cmd/quickstart.py:111 msgid "Please enter a valid path name." msgstr "请输入有效的路径名。" -#: sphinx/cmd/quickstart.py:109 +#: cmd/quickstart.py:127 msgid "Please enter some text." msgstr "请输入文本。" -#: sphinx/cmd/quickstart.py:116 +#: cmd/quickstart.py:134 #, python-format msgid "Please enter one of %s." msgstr "请输入 %s 之一。" -#: sphinx/cmd/quickstart.py:123 +#: cmd/quickstart.py:142 msgid "Please enter either 'y' or 'n'." msgstr "请输入“y”或“n”。" -#: sphinx/cmd/quickstart.py:129 +#: cmd/quickstart.py:148 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "请输入文件后缀,例如:“.rst”或者“.txt”。" -#: sphinx/cmd/quickstart.py:208 +#: cmd/quickstart.py:230 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "欢迎使用 Sphinx %s 快速配置工具。" -#: sphinx/cmd/quickstart.py:210 +#: cmd/quickstart.py:235 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "请输入接下来各项设定的值(如果方括号中指定了默认值,直接\n按回车即可使用默认值)。" -#: sphinx/cmd/quickstart.py:215 +#: cmd/quickstart.py:242 #, python-format msgid "Selected root path: %s" msgstr "已选择根路径:%s" -#: sphinx/cmd/quickstart.py:218 +#: cmd/quickstart.py:245 msgid "Enter the root path for documentation." msgstr "输入文档的根路径。" -#: sphinx/cmd/quickstart.py:219 +#: cmd/quickstart.py:246 msgid "Root path for the documentation" msgstr "文档的根路径" -#: sphinx/cmd/quickstart.py:224 +#: cmd/quickstart.py:255 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "错误:选择的根路径中已存在 conf.py 文件。" -#: sphinx/cmd/quickstart.py:226 +#: cmd/quickstart.py:260 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart 不会覆盖已有的 Sphinx 项目。" -#: sphinx/cmd/quickstart.py:228 +#: cmd/quickstart.py:263 msgid "Please enter a new root path (or just Enter to exit)" msgstr "请输入新的根路径(或按回车退出)" -#: sphinx/cmd/quickstart.py:235 +#: cmd/quickstart.py:274 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "有两种方式来设置用于放置 Sphinx 输出的构建目录:\n一是在根路径下创建“_build”目录,二是在根路径下创建“source”\n和“build”两个独立的目录。" -#: sphinx/cmd/quickstart.py:238 +#: cmd/quickstart.py:280 msgid "Separate source and build directories (y/n)" msgstr "独立的源文件和构建目录(y/n)" -#: sphinx/cmd/quickstart.py:242 +#: cmd/quickstart.py:287 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "这个选项将在根目录中创建两个新目录:\n“_templates”用于放置自定义 HTML 模板文件,“_static”用于自定义样\n式表及其他静态文件。您可以输入其他的前缀(比如“.”)代替下划线。" -#: sphinx/cmd/quickstart.py:245 +#: cmd/quickstart.py:292 msgid "Name prefix for templates and static dir" msgstr "模板目录和静态目录的名称前缀" -#: sphinx/cmd/quickstart.py:249 +#: cmd/quickstart.py:298 msgid "" "The project name will occur in several places in the built documentation." msgstr "项目名称将会出现在文档的许多地方。" -#: sphinx/cmd/quickstart.py:250 +#: cmd/quickstart.py:301 msgid "Project name" msgstr "项目名称" -#: sphinx/cmd/quickstart.py:252 +#: cmd/quickstart.py:303 msgid "Author name(s)" msgstr "作者名称" -#: sphinx/cmd/quickstart.py:256 +#: cmd/quickstart.py:309 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" @@ -1578,15 +1939,15 @@ msgid "" "just set both to the same value." msgstr "在 Sphinx 中,会区分“版本”和“发行版本”两个概念。同一版本可以\n有多个发行版本。例如,Python 版本可以是 2.5 或 3.0,而发行版\n本则是 2.5.1 或 3.0a1。如果你不需要这样的双重版本结构,请把这\n两个选项设置为相同值。" -#: sphinx/cmd/quickstart.py:261 +#: cmd/quickstart.py:316 msgid "Project version" msgstr "项目版本" -#: sphinx/cmd/quickstart.py:263 +#: cmd/quickstart.py:318 msgid "Project release" msgstr "项目发行版本" -#: sphinx/cmd/quickstart.py:267 +#: cmd/quickstart.py:324 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" @@ -1596,21 +1957,21 @@ msgid "" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "如果用英语以外的语言编写文档,\n你可以在此按语言代码选择语种。\nSphinx 会把内置文本翻译成相应语言的版本。\n\n支持的语言代码列表见:\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language。" -#: sphinx/cmd/quickstart.py:275 +#: cmd/quickstart.py:332 msgid "Project language" msgstr "项目语种" -#: sphinx/cmd/quickstart.py:281 +#: cmd/quickstart.py:340 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "源文件的文件名后缀。一般是“.txt”或“.rst”。只有此后缀的文件才会\n被视为文档的源文件。" -#: sphinx/cmd/quickstart.py:283 +#: cmd/quickstart.py:344 msgid "Source file suffix" msgstr "源文件后缀" -#: sphinx/cmd/quickstart.py:287 +#: cmd/quickstart.py:350 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" @@ -1618,91 +1979,91 @@ msgid "" "document is a custom template, you can also set this to another filename." msgstr "有一种特殊的文档被视作“目录树”的树顶节点,即文档层级结构的\n根。通常情况下,这个文档是“index”,但是如果你的“index”文档\n使用了自定义模板,你也可以使用其它文件名。" -#: sphinx/cmd/quickstart.py:291 +#: cmd/quickstart.py:357 msgid "Name of your master document (without suffix)" msgstr "主文档文件名(不含后缀)" -#: sphinx/cmd/quickstart.py:296 +#: cmd/quickstart.py:368 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "错误:选择的根目录下已存在主文档文件 %s。" -#: sphinx/cmd/quickstart.py:298 +#: cmd/quickstart.py:374 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart 不会覆盖已有的文件。" -#: sphinx/cmd/quickstart.py:300 +#: cmd/quickstart.py:378 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "请输入新文件名,若要重命名现有文件请按回车" -#: sphinx/cmd/quickstart.py:304 +#: cmd/quickstart.py:386 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "指出下列 Sphinx 扩展中,需要启用的有哪些:" -#: sphinx/cmd/quickstart.py:312 +#: cmd/quickstart.py:397 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "注意:imgmath 和 mathjax 不能同时启用。已取消选择 imgmath。" -#: sphinx/cmd/quickstart.py:318 +#: cmd/quickstart.py:407 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "生成 Makefile 和 Windows 批处理文件,可以直接像“make html”这样\n运行,而不需要直接调用 sphinx-build。" -#: sphinx/cmd/quickstart.py:321 +#: cmd/quickstart.py:412 msgid "Create Makefile? (y/n)" msgstr "是否创建 Makefile?(y/n)" -#: sphinx/cmd/quickstart.py:324 +#: cmd/quickstart.py:416 msgid "Create Windows command file? (y/n)" msgstr "是否创建 Windows 批处理文件?(y/n)" -#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:93 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format msgid "Creating file %s." msgstr "正在创建文件 %s。" -#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:90 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format msgid "File %s already exists, skipping." msgstr "文件 %s 已存在,已跳过。" -#: sphinx/cmd/quickstart.py:418 +#: cmd/quickstart.py:516 msgid "Finished: An initial directory structure has been created." msgstr "完成:已创建初始目录结构。" -#: sphinx/cmd/quickstart.py:420 +#: cmd/quickstart.py:520 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "你现在可以填写主文档文件 %s 然后创建其他文档源文件了。 " -#: sphinx/cmd/quickstart.py:423 +#: cmd/quickstart.py:527 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "像这样用 Makefile 构建文档:\n  make builder" -#: sphinx/cmd/quickstart.py:426 +#: cmd/quickstart.py:531 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "像这样用 sphinx-build 命令构建文档:\n  sphinx-build -b builder %s %s" -#: sphinx/cmd/quickstart.py:428 +#: cmd/quickstart.py:538 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "此处的“builder”代指支持的构建器名称,比如 html、latex 或 linkcheck。" -#: sphinx/cmd/quickstart.py:464 +#: cmd/quickstart.py:573 msgid "" "\n" "Generate required files for a Sphinx project.\n" @@ -1712,1243 +2073,1350 @@ msgid "" "Makefile to be used with sphinx-build.\n" msgstr "\n生成 Sphinx 项目的必需文件。\n\nsphinx-quickstart 是一个交互式工具,询问一些关于项目的问题,生成\n完整的文档目录和用于 sphinx-build 的示例 Makefile。\n" -#: sphinx/cmd/quickstart.py:479 +#: cmd/quickstart.py:592 msgid "quiet mode" msgstr "静默模式" -#: sphinx/cmd/quickstart.py:484 +#: cmd/quickstart.py:602 msgid "project root" msgstr "项目根目录" -#: sphinx/cmd/quickstart.py:486 +#: cmd/quickstart.py:605 msgid "Structure options" msgstr "目录结构选项" -#: sphinx/cmd/quickstart.py:488 +#: cmd/quickstart.py:611 msgid "if specified, separate source and build dirs" msgstr "如果指定了此选项,将分别建立源文件目录和构建目录" -#: sphinx/cmd/quickstart.py:490 +#: cmd/quickstart.py:617 msgid "if specified, create build dir under source dir" msgstr "如果指定了此选项,在源文件目录下创建构建目录" -#: sphinx/cmd/quickstart.py:492 +#: cmd/quickstart.py:623 msgid "replacement for dot in _templates etc." msgstr "用句点替代“ _templates”等文件夹名称中的下划线。" -#: sphinx/cmd/quickstart.py:494 +#: cmd/quickstart.py:626 msgid "Project basic options" msgstr "项目基本参数" -#: sphinx/cmd/quickstart.py:496 +#: cmd/quickstart.py:628 msgid "project name" msgstr "项目名称" -#: sphinx/cmd/quickstart.py:498 +#: cmd/quickstart.py:631 msgid "author names" msgstr "作者名称" -#: sphinx/cmd/quickstart.py:500 +#: cmd/quickstart.py:638 msgid "version of project" msgstr "项目版本" -#: sphinx/cmd/quickstart.py:502 +#: cmd/quickstart.py:645 msgid "release of project" msgstr "项目发行版本" -#: sphinx/cmd/quickstart.py:504 +#: cmd/quickstart.py:652 msgid "document language" msgstr "项目语种" -#: sphinx/cmd/quickstart.py:506 +#: cmd/quickstart.py:655 msgid "source file suffix" msgstr "源文件后缀" -#: sphinx/cmd/quickstart.py:508 +#: cmd/quickstart.py:658 msgid "master document name" msgstr "主文档名" -#: sphinx/cmd/quickstart.py:510 +#: cmd/quickstart.py:661 msgid "use epub" msgstr "启用 ePub 支持" -#: sphinx/cmd/quickstart.py:512 +#: cmd/quickstart.py:664 msgid "Extension options" msgstr "扩展程序选项" -#: sphinx/cmd/quickstart.py:516 sphinx/ext/apidoc.py:400 +#: cmd/quickstart.py:671 #, python-format msgid "enable %s extension" msgstr "启用 %s 扩展" -#: sphinx/cmd/quickstart.py:518 sphinx/ext/apidoc.py:396 +#: cmd/quickstart.py:678 msgid "enable arbitrary extensions" msgstr "启用多个扩展" -#: sphinx/cmd/quickstart.py:520 +#: cmd/quickstart.py:681 msgid "Makefile and Batchfile creation" msgstr "创建 Makefile 和批处理文件" -#: sphinx/cmd/quickstart.py:522 +#: cmd/quickstart.py:687 msgid "create makefile" msgstr "创建 Makefile" -#: sphinx/cmd/quickstart.py:524 +#: cmd/quickstart.py:693 msgid "do not create makefile" msgstr "不创建 Makefile" -#: sphinx/cmd/quickstart.py:526 +#: cmd/quickstart.py:700 msgid "create batchfile" msgstr "创建批处理文件" -#: sphinx/cmd/quickstart.py:529 +#: cmd/quickstart.py:706 msgid "do not create batchfile" msgstr "不创建批处理文件" -#: sphinx/cmd/quickstart.py:532 +#: cmd/quickstart.py:715 msgid "use make-mode for Makefile/make.bat" msgstr "Makefile/make.bat 采用 Sphinx 的 make 模式" -#: sphinx/cmd/quickstart.py:535 -msgid "do not use make-mode for Makefile/make.bat" -msgstr "Makefile/make.bat 不采用 Sphinx 的 make 模式" - -#: sphinx/cmd/quickstart.py:537 sphinx/ext/apidoc.py:402 +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 msgid "Project templating" msgstr "项目模板" -#: sphinx/cmd/quickstart.py:540 sphinx/ext/apidoc.py:405 +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 msgid "template directory for template files" msgstr "放置模板文件的模板目录" -#: sphinx/cmd/quickstart.py:543 +#: cmd/quickstart.py:731 msgid "define a template variable" msgstr "定义一个模板变量" -#: sphinx/cmd/quickstart.py:576 +#: cmd/quickstart.py:767 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "指定了“quiet”,但是没有指定“project”和“author”。" -#: sphinx/cmd/quickstart.py:590 +#: cmd/quickstart.py:786 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "错误:指定的路径不是一个目录,或是 Sphinx 文件已存在。" -#: sphinx/cmd/quickstart.py:592 +#: cmd/quickstart.py:793 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sphinx-quickstart 只会在空目录中生成文件。请指定一个新的根路径。" -#: sphinx/cmd/quickstart.py:607 +#: cmd/quickstart.py:810 #, python-format msgid "Invalid template variable: %s" msgstr "无效模板变量:%s" -#: sphinx/directives/code.py:61 -msgid "non-whitespace stripped by dedent" -msgstr "取消缩进操作清除了空白字符" - -#: sphinx/directives/code.py:82 -#, python-format -msgid "Invalid caption: %s" -msgstr "无效的标题:%s" - -#: sphinx/directives/code.py:127 sphinx/directives/code.py:277 -#: sphinx/directives/code.py:453 -#, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "指定的行号超出范围(1-%d):%r" - -#: sphinx/directives/code.py:206 -#, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "“%s”和“%s”选项不可联用" - -#: sphinx/directives/code.py:220 -#, python-format -msgid "Include file %r not found or reading it failed" -msgstr "要包含的文件 %r 不存在或读取失败" - -#: sphinx/directives/code.py:223 -#, python-format -msgid "" -"Encoding %r used for reading included file %r seems to be wrong, try giving " -"an :encoding: option" -msgstr "用于读取包含文件 %r 的编码 %r 不正确,请重新给定 encoding: 选项" - -#: sphinx/directives/code.py:260 -#, python-format -msgid "Object named %r not found in include file %r" -msgstr "对象 %r 未出现在包含文件 %r 中" - -#: sphinx/directives/code.py:286 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "不能在不连续的“lines”上使用“lineno-match”选项" - -#: sphinx/directives/code.py:291 -#, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "指定的行 %r:未能从包含文件 %r 中拉取指定的行" - -#: sphinx/directives/other.py:120 +#: directives/other.py:119 #, python-format msgid "toctree glob pattern %r didn't match any documents" msgstr "目录树 glob 规则 %r 未能匹配到文档" -#: sphinx/directives/other.py:146 sphinx/environment/adapters/toctree.py:324 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "目录树中引用了已排除的文档 %r" -#: sphinx/directives/other.py:149 sphinx/environment/adapters/toctree.py:328 +#: directives/other.py:156 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "目录树中引用的文档 %r 不存在" -#: sphinx/directives/other.py:160 +#: directives/other.py:169 #, python-format msgid "duplicated entry found in toctree: %s" msgstr "目录树中存在重复的条目:%s" -#: sphinx/directives/other.py:193 +#: directives/other.py:203 msgid "Section author: " msgstr "节作者: " -#: sphinx/directives/other.py:195 +#: directives/other.py:205 msgid "Module author: " msgstr "模块作者: " -#: sphinx/directives/other.py:197 +#: directives/other.py:207 msgid "Code author: " msgstr "代码作者: " -#: sphinx/directives/other.py:199 +#: directives/other.py:209 msgid "Author: " msgstr "作者: " -#: sphinx/directives/other.py:275 +#: directives/other.py:269 msgid ".. acks content is not a list" msgstr ".. acks 的内容不是列表" -#: sphinx/directives/other.py:301 +#: directives/other.py:292 msgid ".. hlist content is not a list" msgstr ".. hlist 的内容不是列表" -#: sphinx/directives/patches.py:66 +#: directives/patches.py:70 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "csv-table 指令的“:file”选项现在会将绝对路径视为源文件目录的相对路径。请更新你的文档内容。" -#: sphinx/domains/__init__.py:397 -#, python-format -msgid "%s %s" -msgstr "%s %s" +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "取消缩进操作清除了空白字符" -#: sphinx/domains/changeset.py:23 +#: directives/code.py:87 #, python-format -msgid "Added in version %s" -msgstr "" +msgid "Invalid caption: %s" +msgstr "无效的标题:%s" -#: sphinx/domains/changeset.py:24 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "Changed in version %s" -msgstr "在 %s 版本发生变更" +msgid "line number spec is out of range(1-%d): %r" +msgstr "指定的行号超出范围(1-%d):%r" -#: sphinx/domains/changeset.py:25 +#: directives/code.py:216 #, python-format -msgid "Deprecated since version %s" -msgstr "自 %s 版本弃用" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "“%s”和“%s”选项不可联用" -#: sphinx/domains/changeset.py:26 +#: directives/code.py:231 #, python-format -msgid "Removed in version %s" -msgstr "" +msgid "Include file '%s' not found or reading it failed" +msgstr "包括文件 '%s' 未找到或读取失败" -#: sphinx/domains/citation.py:71 +#: directives/code.py:235 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "重复的引文 %s,另一引文出现在 %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" +msgstr "用编码格式 %r 读取包含的文件 '%s' 可能不正确,请尝试给定 :encoding: 选项" -#: sphinx/domains/citation.py:82 +#: directives/code.py:276 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "引文 [%s] 没有被引用过。" +msgid "Object named %r not found in include file %r" +msgstr "对象 %r 未出现在包含文件 %r 中" -#: sphinx/domains/javascript.py:165 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (内置函数)" +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "不能在不连续的“lines”上使用“lineno-match”选项" -#: sphinx/domains/javascript.py:166 sphinx/domains/python/__init__.py:240 +#: directives/code.py:314 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s 方法)" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "指定的行 %r:未能从包含文件 %r 中拉取指定的行" -#: sphinx/domains/javascript.py:168 +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 #, python-format -msgid "%s() (class)" -msgstr "%s()(类)" +msgid "%b %d, %Y" +msgstr "%Y 年 %m 月 %d 日" -#: sphinx/domains/javascript.py:170 -#, python-format -msgid "%s (global variable or constant)" -msgstr "%s(全局变量或常量)" +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" +msgstr "索引" + +#: writers/latex.py:768 writers/texinfo.py:646 +msgid "" +"encountered title node not in section, topic, table, admonition or sidebar" +msgstr "在节、话题、表格、警示或边栏以外的位置发现标题节点" + +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "脚注" -#: sphinx/domains/javascript.py:172 sphinx/domains/python/__init__.py:325 +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." +msgstr "在图示之外发现了图题。" + +#: writers/texinfo.py:1303 #, python-format -msgid "%s (%s attribute)" -msgstr "%s(%s 属性)" +msgid "unimplemented node type: %r" +msgstr "未实现的节点类型:%r" -#: sphinx/domains/javascript.py:255 -msgid "Arguments" -msgstr "参数" +#: writers/manpage.py:288 writers/text.py:971 +#, python-format +msgid "[image: %s]" +msgstr "[图片: %s]" -#: sphinx/domains/cpp/__init__.py:350 sphinx/domains/javascript.py:258 -msgid "Throws" -msgstr "抛出" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[图片]" -#: sphinx/domains/c/__init__.py:251 sphinx/domains/cpp/__init__.py:361 -#: sphinx/domains/javascript.py:261 sphinx/domains/python/_object.py:175 -msgid "Returns" -msgstr "返回" +#: writers/html5.py:96 writers/html5.py:105 +msgid "Link to this definition" +msgstr "链接到此定义。" -#: sphinx/domains/c/__init__.py:253 sphinx/domains/javascript.py:263 -#: sphinx/domains/python/_object.py:177 -msgid "Return type" -msgstr "返回类型" +#: writers/html5.py:431 +#, python-format +msgid "numfig_format is not defined for %s" +msgstr "未定义 %s 的 numfig_format" -#: sphinx/domains/javascript.py:331 +#: writers/html5.py:441 #, python-format -msgid "%s (module)" -msgstr "%s(模块)" +msgid "Any IDs not assigned for %s node" +msgstr "没有给 %s 节点分配 ID" -#: sphinx/domains/c/__init__.py:622 sphinx/domains/cpp/__init__.py:764 -#: sphinx/domains/javascript.py:368 sphinx/domains/python/__init__.py:574 -msgid "function" -msgstr "函数" +#: writers/html5.py:496 +msgid "Link to this term" +msgstr "链接到此术语。" -#: sphinx/domains/javascript.py:369 sphinx/domains/python/__init__.py:578 -msgid "method" -msgstr "方法" +#: writers/html5.py:548 writers/html5.py:553 +msgid "Link to this heading" +msgstr "链接到此标题。" -#: sphinx/domains/cpp/__init__.py:762 sphinx/domains/javascript.py:370 -#: sphinx/domains/python/__init__.py:576 -msgid "class" -msgstr "类" +#: writers/html5.py:558 +msgid "Link to this table" +msgstr "链接到此表格。" -#: sphinx/domains/javascript.py:371 sphinx/domains/python/__init__.py:575 -msgid "data" -msgstr "数据" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "不支持的红字标题等级:%s" -#: sphinx/domains/javascript.py:372 sphinx/domains/python/__init__.py:581 -msgid "attribute" -msgstr "属性" +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "链接到此段代码" -#: sphinx/domains/javascript.py:373 sphinx/domains/python/__init__.py:583 -msgid "module" -msgstr "模块" +#: writers/html5.py:638 +msgid "Link to this image" +msgstr "链接到此图片" + +#: writers/html5.py:640 +msgid "Link to this toctree" +msgstr "链接到此目录树" -#: sphinx/domains/javascript.py:404 +#: writers/html5.py:766 +msgid "Could not obtain image size. :scale: option is ignored." +msgstr "无法获取图像尺寸,已忽略 :scale: 选项。" + +#: writers/latex.py:386 #, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "重复的 %s描述 %s,其他的 %s 描述出现在 %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "未知的 %r toplevel_sectioning 被用于 %r 类" -#: sphinx/domains/math.py:63 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "重复的公式标签 %s,另一公式出现在 %s" +msgid "no Babel option known for language %r" +msgstr "没有语种 %r 的 Babel 选项" + +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":mathdepth: 值过大,已忽略。" -#: sphinx/domains/math.py:118 sphinx/writers/latex.py:2252 +#: writers/latex.py:616 #, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "无效的 math_eqref_format:%r" +msgid "template %s not found; loading from legacy %s instead" +msgstr "没有找到 %s 模板;使用传统模板 %s 代替" -#: sphinx/domains/rst.py:127 sphinx/domains/rst.py:184 +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "文档标题不是一个单纯文本节点" + +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "同时指定了 tabularcolumns 和 :widths: 选项,已忽略 :widths:。" + +#: writers/latex.py:1228 #, python-format -msgid "%s (directive)" -msgstr "%s(指令)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "已给出的 colspec %s 似乎使用了 tabulary 语法。但此表格无法以 tabulary 格式呈现;给出的 colspec 将被忽略。" -#: sphinx/domains/rst.py:185 sphinx/domains/rst.py:189 +#: writers/latex.py:1615 #, python-format -msgid ":%s: (directive option)" -msgstr ":%s:(指令选项)" +msgid "dimension unit %s is invalid. Ignored." +msgstr "无效的量纲单位 %s,已忽略。" -#: sphinx/domains/rst.py:213 +#: writers/latex.py:1950 #, python-format -msgid "%s (role)" -msgstr "%s(角色)" +msgid "unknown index entry type %s found" +msgstr "发现未知的索引条目类型 %s" -#: sphinx/domains/rst.py:223 -msgid "directive" -msgstr "指令" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "使用方法:" -#: sphinx/domains/rst.py:224 -msgid "directive-option" -msgstr "指令-选项" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "{0} [OPTIONS] []" -#: sphinx/domains/rst.py:225 -msgid "role" -msgstr "角色" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "Sphinx 文档生成器。" -#: sphinx/domains/rst.py:247 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "重复的 %s %s 描述,另一描述出现在 %s" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "命令:" -#: sphinx/domains/c/__init__.py:146 -#, python-format -msgid "%s (C %s)" -msgstr "%s(C %s)" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "选项" -#: sphinx/domains/c/__init__.py:207 sphinx/domains/c/_symbol.py:552 -#, python-format +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "更多信息请参阅 https://www.sphinx-doc.org/en/master/man/ 。" + +#: _cli/__init__.py:171 +#, python-brace-format msgid "" -"Duplicate C declaration, also defined at %s:%s.\n" -"Declaration is '.. c:%s:: %s'." -msgstr "重复的 C 声明,已经在 %s:%s 处声明。\n声明为“.. c:%s:: %s”。" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "{0}: 错误: {1}\n运行“{0} --help”获取帮助信息" -#: sphinx/domains/c/__init__.py:245 sphinx/domains/cpp/__init__.py:344 -#: sphinx/domains/python/_object.py:163 sphinx/ext/napoleon/docstring.py:762 -msgid "Parameters" -msgstr "参数" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr " 用 Sphinx 管理文档。" -#: sphinx/domains/c/__init__.py:248 sphinx/domains/cpp/__init__.py:357 -msgid "Return values" -msgstr "返回值" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "显示版本并退出。" -#: sphinx/domains/c/__init__.py:620 sphinx/domains/cpp/__init__.py:765 -msgid "member" -msgstr "成员" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "显示此信息并退出。" -#: sphinx/domains/c/__init__.py:621 -msgid "variable" -msgstr "变量" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "日志" -#: sphinx/domains/c/__init__.py:623 -msgid "macro" -msgstr "宏" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "增加日志详细级别(可以重复叠加)" -#: sphinx/domains/c/__init__.py:624 -msgid "struct" -msgstr "结构体" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "只打印错误和警告。" -#: sphinx/domains/c/__init__.py:625 sphinx/domains/cpp/__init__.py:763 -msgid "union" -msgstr "联合体" +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "完全没有输出" -#: sphinx/domains/c/__init__.py:626 sphinx/domains/cpp/__init__.py:768 -msgid "enum" -msgstr "枚举" +#: _cli/__init__.py:231 +msgid "" +msgstr "" -#: sphinx/domains/c/__init__.py:627 sphinx/domains/cpp/__init__.py:769 -msgid "enumerator" -msgstr "枚举成员" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "参见 'sphinx --help' 。\n" -#: sphinx/domains/c/__init__.py:628 sphinx/domains/cpp/__init__.py:766 -msgid "type" -msgstr "类型" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "译文中的脚注引用与原文不一致。原文中为:{0},翻文中为:{1}" -#: sphinx/domains/c/__init__.py:630 sphinx/domains/cpp/__init__.py:771 -msgid "function parameter" -msgstr "函数参数" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "译文中的引用与原文不一致。原文中为:{0},译文中为:{1}" -#: sphinx/domains/cpp/__init__.py:63 -msgid "Template Parameters" -msgstr "模板参数" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "译文中的引文引用与原文不一致。原文中为:{0},译文中为:{1}" -#: sphinx/domains/cpp/__init__.py:185 -#, python-format -msgid "%s (C++ %s)" -msgstr "%s(C++ %s)" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "译文中的术语引用与原文不一致。原文中为:{0},译文中为:{1}" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "无法计算转译进度!" -#: sphinx/domains/cpp/__init__.py:268 sphinx/domains/cpp/_symbol.py:790 +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "尚无已转译的元素!" + +#: transforms/__init__.py:258 #, python-format msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "重复的 C++ 声明,已经在 %s:%s 处声明。\n声明为“.. cpp:%s:: %s”。" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "索引页使用了 4 列布局,可能是你所用的扩展出现了 Bug:%r" -#: sphinx/domains/cpp/__init__.py:767 -msgid "concept" -msgstr "概念" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." +msgstr "脚注 [%s] 没有被引用过。" -#: sphinx/domains/cpp/__init__.py:772 -msgid "template parameter" -msgstr "模板参数" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "脚注 [*] 没有被引用过。" + +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "脚注 [#] 没有被引用过。" -#: sphinx/domains/python/__init__.py:94 sphinx/domains/python/__init__.py:231 +#: util/inventory.py:147 #, python-format -msgid "%s() (in module %s)" -msgstr "%s()(在 %s 模块中)" +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "清单 <%s> 中包含重复的 %s 定义" -#: sphinx/domains/python/__init__.py:154 sphinx/domains/python/__init__.py:321 -#: sphinx/domains/python/__init__.py:372 +#: util/inventory.py:166 #, python-format -msgid "%s (in module %s)" -msgstr "%s()(在 %s 模块中)" +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "清单 <%s> 中包含多个 %s 的定义" -#: sphinx/domains/python/__init__.py:156 +#: util/i18n.py:100 #, python-format -msgid "%s (built-in variable)" -msgstr "%s(内置变量)" +msgid "reading error: %s, %s" +msgstr "读取时发生错误:%s,%s" -#: sphinx/domains/python/__init__.py:181 +#: util/i18n.py:113 #, python-format -msgid "%s (built-in class)" -msgstr "%s(内置类)" +msgid "writing error: %s, %s" +msgstr "写入时发生错误:%s,%s" -#: sphinx/domains/python/__init__.py:182 +#: util/i18n.py:146 #, python-format -msgid "%s (class in %s)" -msgstr "%s(%s 中的类)" +msgid "locale_dir %s does not exist" +msgstr "locale_dir %s 不存在" -#: sphinx/domains/python/__init__.py:236 +#: util/i18n.py:244 #, python-format -msgid "%s() (%s class method)" -msgstr "%s()(%s 类方法)" +msgid "Invalid Babel locale: %r." +msgstr "无效的 Babel locale:%r" -#: sphinx/domains/python/__init__.py:238 +#: util/i18n.py:253 #, python-format -msgid "%s() (%s static method)" -msgstr "%s()(%s 静态方法)" +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "无效的日期格式。如果你想直接输出日期字符串,请用单引号包裹该字符串:%s" -#: sphinx/domains/python/__init__.py:376 +#: util/osutil.py:131 #, python-format -msgid "%s (%s property)" -msgstr "%s(%s 属性)" +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "中止了把 %s 复制至 %s 的尝试(目的路径非空)。" -#: sphinx/domains/python/__init__.py:502 -msgid "Python Module Index" -msgstr "Python 模块索引" +#: util/display.py:82 +msgid "skipped" +msgstr "已跳过" -#: sphinx/domains/python/__init__.py:503 -msgid "modules" -msgstr "模块" +#: util/display.py:87 +msgid "failed" +msgstr "失败" -#: sphinx/domains/python/__init__.py:552 -msgid "Deprecated" -msgstr "已弃用" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" +msgstr "未知的指令名称:%s" -#: sphinx/domains/python/__init__.py:577 -msgid "exception" -msgstr "异常" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" +msgstr "未知的角色名称:%s" -#: sphinx/domains/python/__init__.py:579 -msgid "class method" -msgstr "类方法" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" +msgstr "未知节点类型:%r" -#: sphinx/domains/python/__init__.py:580 -msgid "static method" -msgstr "静态方法" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "中止了把已渲染模板 %s 复制至 %s 的尝试(目的路径非空)。" -#: sphinx/domains/python/__init__.py:582 -msgid "property" -msgstr "托管属性" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" +msgstr "正在把已求值的模板结果写入 %s" -#: sphinx/domains/python/__init__.py:640 +#: util/docfields.py:103 #, python-format msgid "" -"duplicate object description of %s, other instance in %s, use :no-index: for" -" one of them" -msgstr "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "%s 域中的问题:字段应采用“%s”角色,但域中并不包含该角色。" -#: sphinx/domains/python/__init__.py:760 +#: util/rst.py:73 #, python-format -msgid "more than one target found for cross-reference %r: %s" -msgstr "交叉引用 %r 找到了多个目标:%s" +msgid "default role %s not found" +msgstr "未找到默认角色 %s" -#: sphinx/domains/python/__init__.py:821 -msgid " (deprecated)" -msgstr "(已弃用)" +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "%r 不再支持索引条目 (来自条目 %r)请改用 pair: %s。" -#: sphinx/domains/python/_object.py:168 -msgid "Variables" -msgstr "变量" +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" +msgstr "目录树引用的文件 %r 不存在" -#: sphinx/domains/python/_object.py:172 -msgid "Raises" -msgstr "抛出" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "only 指令的表达式求值时抛出异常:%s" + +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "接上页" + +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "续下页" + +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "非字母" + +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "符号" + +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "数字" -#: sphinx/domains/std/__init__.py:80 sphinx/domains/std/__init__.py:97 +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "页" + +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "发行版本" + +#: transforms/post_transforms/images.py:79 #, python-format -msgid "environment variable; %s" -msgstr "环境变量; %s" +msgid "Could not fetch remote image: %s [%s]" +msgstr "无法拉取远程图像:%s [%s]" + +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "无法拉取远程图像:%s [%d]" -#: sphinx/domains/std/__init__.py:157 +#: transforms/post_transforms/images.py:143 #, python-format +msgid "Unknown image format: %s..." +msgstr "未知的图像格式:%s……" + +#: transforms/post_transforms/__init__.py:88 msgid "" -"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" -"--opt args\", \"/opt args\" or \"+opt args\"" -msgstr "畸形的选项描述 %r,应是“opt”、“-opt args”、“--opt args”、“/opt args”或“+opt args”形式" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "无法确定交叉引用的回退文本。可能是 Bug。" -#: sphinx/domains/std/__init__.py:228 +#: transforms/post_transforms/__init__.py:233 #, python-format -msgid "%s command line option" -msgstr "%s命令行选项" +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "“any”交叉引用 %r 的目标不唯一:可能是 %s" -#: sphinx/domains/std/__init__.py:230 -msgid "command line option" -msgstr "命令行选项" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "未找到 %s:%s 的引用目标: %s" -#: sphinx/domains/std/__init__.py:348 -msgid "glossary term must be preceded by empty line" -msgstr "术语词汇前必须有空行" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "未找到 %r 的引用目标:%s" -#: sphinx/domains/std/__init__.py:356 -msgid "glossary terms must not be separated by empty lines" -msgstr "术语词汇不能用空行分隔" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "已中断!" -#: sphinx/domains/std/__init__.py:362 sphinx/domains/std/__init__.py:375 -msgid "glossary seems to be misformatted, check indentation" -msgstr "术语词汇格式不正确,请检查缩进" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "reStructuredText 错误!" -#: sphinx/domains/std/__init__.py:518 -msgid "glossary term" -msgstr "术语词汇" +#: _cli/util/errors.py:200 +msgid "Encoding error!" +msgstr "编码错误!" -#: sphinx/domains/std/__init__.py:519 -msgid "grammar token" -msgstr "语法记号" +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "递归错误!" -#: sphinx/domains/std/__init__.py:520 -msgid "reference label" -msgstr "引用标签" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "源文件非常大或嵌套很深时可能会发生这种情况。您可以谨慎地在 conf.py 中增加默认的 Python 递归限制 1,000,例如:" -#: sphinx/domains/std/__init__.py:522 -msgid "environment variable" -msgstr "环境变量" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "启动调试器:" -#: sphinx/domains/std/__init__.py:523 -msgid "program option" -msgstr "程序选项" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "完整回溯已保存至:" -#: sphinx/domains/std/__init__.py:524 -msgid "document" -msgstr "文档" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "若要向开发者报告此错误,请访问 提交问题。谢谢!" -#: sphinx/domains/std/__init__.py:560 sphinx/domains/std/__init__.py:572 -msgid "Module Index" -msgstr "模块索引" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "即便抛出的错误时是用户导致的,也请向我们投递报告,以便将来可以提示更友好、更详细的错误信息。" -#: sphinx/domains/std/__init__.py:561 sphinx/domains/std/__init__.py:573 -#: sphinx/themes/basic/defindex.html:25 -msgid "Search Page" -msgstr "搜索页面" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "折叠边栏" -#: sphinx/domains/std/__init__.py:616 sphinx/domains/std/__init__.py:722 -#: sphinx/ext/autosectionlabel.py:53 -#, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "重复的标签 %s,另一标签出现在 %s" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "导航" -#: sphinx/domains/std/__init__.py:635 +#: themes/basic/layout.html:115 #, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "重复的 %s 描述 %s,另一描述出现在 %s" +msgid "Search within %(docstitle)s" +msgstr "在 %(docstitle)s 中搜索" -#: sphinx/domains/std/__init__.py:841 -msgid "numfig is disabled. :numref: is ignored." -msgstr "numfig 已禁用,忽略 :numref:。" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "关于此文档" -#: sphinx/domains/std/__init__.py:849 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "无法创建交叉引用。未指定题图数字:%s" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "搜索" -#: sphinx/domains/std/__init__.py:861 -#, python-format -msgid "the link has no caption: %s" -msgstr "链接没有标题:%s" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "版权所有" -#: sphinx/domains/std/__init__.py:875 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "无效的 numfig_format:%s(%r)" +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." -#: sphinx/domains/std/__init__.py:878 +#: themes/basic/layout.html:201 #, python-format -msgid "invalid numfig_format: %s" -msgstr "无效的 numfig_format:%s" +msgid "Last updated on %(last_updated)s." +msgstr "最后更新于 %(last_updated)s." -#: sphinx/domains/std/__init__.py:1109 +#: themes/basic/layout.html:204 #, python-format -msgid "undefined label: %r" -msgstr "标签未定义:%r" +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "由 Sphinx %(sphinx_version)s创建。" + +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "上一主题" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "上一章" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "下一主题" + +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "下一章" -#: sphinx/domains/std/__init__.py:1111 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "无法创建交叉引用,缺少标题或图题:%r" +msgid "Index – %(key)s" +msgstr "索引 – %(key)s" -#: sphinx/environment/__init__.py:71 -msgid "new config" -msgstr "新配置" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "单页全索引" -#: sphinx/environment/__init__.py:72 -msgid "config changed" -msgstr "配置发生了变化" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "本页" -#: sphinx/environment/__init__.py:73 -msgid "extensions changed" -msgstr "扩展发生了变化" +#: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 +msgid "Show Source" +msgstr "显示源代码" -#: sphinx/environment/__init__.py:279 -msgid "build environment version not current" -msgstr "构建环境版本与当前环境不符" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "快速搜索" -#: sphinx/environment/__init__.py:281 -msgid "source directory has changed" -msgstr "源文件目录发生了变化" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "提交" -#: sphinx/environment/__init__.py:360 -msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "本环境与选择的构建器不兼容,请选择其他的文档树目录。" +#: themes/basic/defindex.html:4 +msgid "Overview" +msgstr "概述" -#: sphinx/environment/__init__.py:459 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "无法在 %s 中扫描文档:%r" +#: themes/basic/defindex.html:8 +msgid "Welcome! This is" +msgstr "欢迎!" -#: sphinx/environment/__init__.py:596 -#, python-format -msgid "Domain %r is not registered" -msgstr "未注册的域 %r" +#: themes/basic/defindex.html:9 +msgid "the documentation for" +msgstr "本文档属于" -#: sphinx/environment/__init__.py:730 -msgid "document isn't included in any toctree" -msgstr "文档没有加入到任何目录树中" +#: themes/basic/defindex.html:10 +msgid "last updated" +msgstr "最后更新于" -#: sphinx/environment/__init__.py:766 -msgid "self referenced toctree found. Ignored." -msgstr "目录树存在自引用,已忽略。" +#: themes/basic/defindex.html:13 +msgid "Indices and tables:" +msgstr "索引和表格:" -#: sphinx/environment/adapters/indexentries.py:69 -#, python-format -msgid "see %s" -msgstr "见 %s" +#: themes/basic/defindex.html:16 +msgid "Complete Table of Contents" +msgstr "完整目录" -#: sphinx/environment/adapters/indexentries.py:73 -#, python-format -msgid "see also %s" -msgstr "另请参见 %s" +#: themes/basic/defindex.html:17 +msgid "lists all sections and subsections" +msgstr "列出所有的章节和部分" -#: sphinx/environment/adapters/indexentries.py:76 -#, python-format -msgid "unknown index entry type %r" -msgstr "未知的索引条目类型 %r" +#: domains/std/__init__.py:773 domains/std/__init__.py:786 +#: themes/basic/defindex.html:18 +msgid "Search Page" +msgstr "搜索页面" -#: sphinx/environment/adapters/indexentries.py:187 -#: sphinx/templates/latex/sphinxmessages.sty_t:11 -msgid "Symbols" -msgstr "符号" +#: themes/basic/defindex.html:19 +msgid "search this documentation" +msgstr "搜索文档" -#: sphinx/environment/adapters/toctree.py:297 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "在文档树中检测到循环引用,已忽略:%s <- %s" +#: themes/basic/defindex.html:21 +msgid "Global Module Index" +msgstr "全局模块索引" + +#: themes/basic/defindex.html:22 +msgid "quick access to all modules" +msgstr "快速查看所有的模块" -#: sphinx/environment/adapters/toctree.py:317 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 +msgid "General Index" +msgstr "总索引" + +#: themes/basic/defindex.html:24 +msgid "all functions, classes, terms" +msgstr "所有函数、类、术语词汇" + +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "目录" + +#: themes/basic/opensearch.xml:4 #, python-format +msgid "Search %(docstitle)s" +msgstr "搜索 %(docstitle)s" + +#: themes/basic/genindex-split.html:8 +msgid "Index pages by letter" +msgstr "字母索引" + +#: themes/basic/genindex-split.html:17 +msgid "can be huge" +msgstr "可能会大" + +#: themes/basic/search.html:20 msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "目录树引用的文档 %r 缺少标题:不会生成链接" +"Please activate JavaScript to enable the search\n" +" functionality." +msgstr "请激活 JavaScript 以开启搜索功能。" -#: sphinx/environment/adapters/toctree.py:326 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "目录树引用了未包含的文档 %r" +#: themes/basic/search.html:28 +msgid "" +"Searching for multiple words only shows matches that contain\n" +" all words." +msgstr "当搜索多个关键词时,只会显示同时包含所有关键词的内容。" -#: sphinx/environment/collectors/asset.py:89 -#, python-format -msgid "image file not readable: %s" -msgstr "无法读取图像文件:%s" +#: themes/basic/search.html:35 +msgid "search" +msgstr "搜索" -#: sphinx/environment/collectors/asset.py:108 -#, python-format -msgid "image file %s not readable: %s" -msgstr "无法读取图像文件 %s:%s" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "目录" + +#: themes/basic/static/searchtools.js:132 +msgid "Search Results" +msgstr "搜索结果" + +#: themes/basic/static/searchtools.js:134 +msgid "" +"Your search did not match any documents. Please make sure that all words are" +" spelled correctly and that you've selected enough categories." +msgstr "您的搜索没有匹配到文档。请确保关键词拼写正确,并且选择了合适的分类。" + +#: themes/basic/static/searchtools.js:138 +#, python-brace-format +msgid "Search finished, found one page matching the search query." +msgid_plural "" +"Search finished, found ${resultCount} pages matching the search query." +msgstr[0] "搜索完成,匹配搜索条件的有 ${resultCount} 个页面。" + +#: themes/basic/static/searchtools.js:276 +msgid "Searching" +msgstr "正在搜索中" + +#: themes/basic/static/searchtools.js:293 +msgid "Preparing search..." +msgstr "正在准备搜索……" + +#: themes/basic/static/searchtools.js:526 +msgid ", in " +msgstr ",在 " -#: sphinx/environment/collectors/asset.py:134 +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "隐藏搜索结果" + +#: themes/basic/changes/frameset.html:5 +#: themes/basic/changes/versionchanges.html:12 #, python-format -msgid "download file not readable: %s" -msgstr "无法读取下载文件:%s" +msgid "Changes in Version %(version)s — %(docstitle)s" +msgstr "于版本 %(version)s— %(docstitle)s 变更" -#: sphinx/environment/collectors/toctree.py:225 +#: themes/basic/changes/rstsource.html:5 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "已经给 %s 分配了章节编号(嵌套的带编号文档树?)" +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" -#: sphinx/ext/apidoc.py:86 +#: themes/basic/changes/versionchanges.html:17 #, python-format -msgid "Would create file %s." -msgstr "将会创建文件 %s。" +msgid "Automatically generated list of changes in version %(version)s" +msgstr "自动生成的 %(version)s 版本变更列表" -#: sphinx/ext/apidoc.py:318 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\n在 中递归查找 Python 模块和包,然后在 中为每个使用了\nautomodule 指令的包创建一个 reST 文件。\n\n 可以排除生成符合规则的文件/目录的文档。\n\n提示:本脚本默认不会覆盖已有文件。" +#: themes/basic/changes/versionchanges.html:18 +msgid "Library changes" +msgstr "库的变更" -#: sphinx/ext/apidoc.py:331 -msgid "path to module to document" -msgstr "指定模块的路径,用于生成该模块的文档" +#: themes/basic/changes/versionchanges.html:23 +msgid "C API changes" +msgstr "C API 的变更" -#: sphinx/ext/apidoc.py:333 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "以 fnmatch 风格的文件/目录规则,不生成与该规则匹配的文档" +#: themes/basic/changes/versionchanges.html:25 +msgid "Other changes" +msgstr "其他变更" -#: sphinx/ext/apidoc.py:338 -msgid "directory to place all output" -msgstr "存放输出内容的目录" +#: themes/classic/static/sidebar.js.jinja:42 +msgid "Expand sidebar" +msgstr "展开边栏" -#: sphinx/ext/apidoc.py:343 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "在目录树中展示子模块的最大深度(默认:4)" +#: domains/python/_annotations.py:522 +msgid "Positional-only parameter separator (PEP 570)" +msgstr "仅位置参数分隔符 (PEP 570)" -#: sphinx/ext/apidoc.py:346 -msgid "overwrite existing files" -msgstr "覆盖已有文件" +#: domains/python/_annotations.py:533 +msgid "Keyword-only parameters separator (PEP 3102)" +msgstr "仅关键字参数分隔符 (PEP 3102)" -#: sphinx/ext/apidoc.py:349 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "遵循符号链接。配合 collective.recipe.omelette 使用尤其奏效。" +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "参数" -#: sphinx/ext/apidoc.py:352 -msgid "run the script without creating files" -msgstr "运行脚本,但不创建文件" +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "变量" -#: sphinx/ext/apidoc.py:355 -msgid "put documentation for each module on its own page" -msgstr "给模块创建各自的文档页" +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "抛出" -#: sphinx/ext/apidoc.py:358 -msgid "include \"_private\" modules" -msgstr "包含“_private”模块" +#: domains/python/__init__.py:105 domains/python/__init__.py:270 +#, python-format +msgid "%s() (in module %s)" +msgstr "%s()(在 %s 模块中)" -#: sphinx/ext/apidoc.py:360 -msgid "filename of table of contents (default: modules)" -msgstr "目录的文件名(默认:modules)" +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 +#, python-format +msgid "%s (in module %s)" +msgstr "%s()(在 %s 模块中)" -#: sphinx/ext/apidoc.py:362 -msgid "don't create a table of contents file" -msgstr "不创建目录文件" +#: domains/python/__init__.py:174 +#, python-format +msgid "%s (built-in variable)" +msgstr "%s(内置变量)" -#: sphinx/ext/apidoc.py:365 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "不创建模块/包的标题(比如当 docstring 中已经有标题时,可以使用这个选项)" +#: domains/python/__init__.py:209 +#, python-format +msgid "%s (built-in class)" +msgstr "%s(内置类)" -#: sphinx/ext/apidoc.py:370 -msgid "put module documentation before submodule documentation" -msgstr "把模块文档放置在子模块文档之前" +#: domains/python/__init__.py:210 +#, python-format +msgid "%s (class in %s)" +msgstr "%s(%s 中的类)" -#: sphinx/ext/apidoc.py:374 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "根据 PEP-0420 隐式命名空间规范解释模块路径" +#: domains/python/__init__.py:275 +#, python-format +msgid "%s() (%s class method)" +msgstr "%s()(%s 类方法)" -#: sphinx/ext/apidoc.py:378 -msgid "file suffix (default: rst)" -msgstr "文件后缀(默认:rst)" +#: domains/python/__init__.py:277 +#, python-format +msgid "%s() (%s static method)" +msgstr "%s()(%s 静态方法)" -#: sphinx/ext/apidoc.py:380 -msgid "generate a full project with sphinx-quickstart" -msgstr "用 sphinx-quickstart 生成完整项目" +#: domains/python/__init__.py:430 +#, python-format +msgid "%s (%s property)" +msgstr "%s(%s 属性)" -#: sphinx/ext/apidoc.py:383 -msgid "append module_path to sys.path, used when --full is given" -msgstr "当指定了 --full 选项,把 module_path 附加到 sys.path" +#: domains/python/__init__.py:470 +#, python-format +msgid "%s (type alias in %s)" +msgstr "%s (%s 中的类型别名)" -#: sphinx/ext/apidoc.py:385 -msgid "project name (default: root module name)" -msgstr "项目名称(默认:根模块名)" +#: domains/python/__init__.py:624 +msgid "Python Module Index" +msgstr "Python 模块索引" -#: sphinx/ext/apidoc.py:387 -msgid "project author(s), used when --full is given" -msgstr "项目作者,指定了 --full 选项时使用" +#: domains/python/__init__.py:625 +msgid "modules" +msgstr "模块" -#: sphinx/ext/apidoc.py:389 -msgid "project version, used when --full is given" -msgstr "项目版本,指定了 --full 选项时使用" +#: domains/python/__init__.py:703 +msgid "Deprecated" +msgstr "已弃用" -#: sphinx/ext/apidoc.py:391 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "项目发行版本,指定了 --full 选项时使用,默认为 --doc-version 的值" +#: domains/python/__init__.py:729 +msgid "exception" +msgstr "异常" -#: sphinx/ext/apidoc.py:394 -msgid "extension options" -msgstr "扩展选项" +#: domains/python/__init__.py:731 +msgid "class method" +msgstr "类方法" -#: sphinx/ext/apidoc.py:427 -#, python-format -msgid "%s is not a directory." -msgstr "%s 不是一个目录。" +#: domains/python/__init__.py:732 +msgid "static method" +msgstr "静态方法" + +#: domains/python/__init__.py:734 +msgid "property" +msgstr "托管属性" -#: sphinx/ext/autosectionlabel.py:49 +#: domains/python/__init__.py:735 +msgid "type alias" +msgstr "类型别名" + +#: domains/python/__init__.py:804 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "为“%s”一节增加标签“%s”" +msgid "" +"duplicate object description of %s, other instance in %s, use :no-index: for" +" one of them" +msgstr "重复的对象描述 %s,另一处为 %s,请在其中一处使用 :no-index:。" -#: sphinx/ext/coverage.py:46 +#: domains/python/__init__.py:974 #, python-format -msgid "invalid regex %r in %s" -msgstr "无效的正则表达式 %r 出现在 %s" +msgid "more than one target found for cross-reference %r: %s" +msgstr "交叉引用 %r 找到了多个目标:%s" + +#: domains/python/__init__.py:1048 +msgid " (deprecated)" +msgstr "(已弃用)" -#: sphinx/ext/coverage.py:75 +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 #, python-format msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)spython.txt." -msgstr "已完成源文件的覆盖率测试,结果保存在 %(outdir)s/python.txt 中,请查阅。" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "重复的 C++ 声明,已经在 %s:%s 处声明。\n声明为“.. cpp:%s:: %s”。" -#: sphinx/ext/coverage.py:89 -#, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "coverage_c_regexes 中有无效的正则表达式 %r" +#: domains/cpp/__init__.py:159 +msgid "Template Parameters" +msgstr "模板参数" -#: sphinx/ext/coverage.py:157 +#: domains/cpp/__init__.py:302 #, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "缺少文档的 C API:%s [%s] 在 %s 文件中" +msgid "%s (C++ %s)" +msgstr "%s(C++ %s)" -#: sphinx/ext/coverage.py:189 -#, python-format -msgid "module %s could not be imported: %s" -msgstr "无法导入模块 %s:%s" +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 +msgid "Return values" +msgstr "返回值" -#: sphinx/ext/coverage.py:340 -#, python-format -msgid "undocumented python function: %s :: %s" -msgstr "缺少文档的 Python 函数: %s :: %s" +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 +msgid "union" +msgstr "联合体" -#: sphinx/ext/coverage.py:356 -#, python-format -msgid "undocumented python class: %s :: %s" -msgstr "缺少文档的 Python 类:%s :: %s" +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 +msgid "member" +msgstr "成员" -#: sphinx/ext/coverage.py:369 -#, python-format -msgid "undocumented python method: %s :: %s :: %s" -msgstr "缺少文档的 Python 方法:%s :: %s :: %s" +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 +msgid "type" +msgstr "类型" -#: sphinx/ext/doctest.py:115 -#, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "“%s”选项中缺少“+”或“-”。" +#: domains/cpp/__init__.py:946 +msgid "concept" +msgstr "概念" -#: sphinx/ext/doctest.py:120 -#, python-format -msgid "'%s' is not a valid option." -msgstr "无效的选项“%s”。" +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 +msgid "enum" +msgstr "枚举" -#: sphinx/ext/doctest.py:134 -#, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "无效的 pyversion 选项“%s”" +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 +msgid "enumerator" +msgstr "枚举成员" -#: sphinx/ext/doctest.py:220 -msgid "invalid TestCode type" -msgstr "无效的 TestCode 类型" +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 +msgid "function parameter" +msgstr "函数参数" + +#: domains/cpp/__init__.py:954 +msgid "template parameter" +msgstr "模板参数" -#: sphinx/ext/doctest.py:281 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "已完成源文件的文档测试,结果保存在 %(outdir)s/output.txt 中,请查阅。" +"Duplicate C declaration, also defined at %s:%s.\n" +"Declaration is '.. c:%s:: %s'." +msgstr "重复的 C 声明,已经在 %s:%s 处声明。\n声明为“.. c:%s:: %s”。" -#: sphinx/ext/doctest.py:438 +#: domains/c/__init__.py:211 #, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "块 %s 没有代码或没有输出,该块出现在 %s:%s" +msgid "%s (C %s)" +msgstr "%s(C %s)" -#: sphinx/ext/doctest.py:526 -#, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "已忽略无效的文档代码:%r" +#: domains/c/__init__.py:778 +msgid "variable" +msgstr "变量" -#: sphinx/ext/duration.py:77 -msgid "" -"====================== slowest reading durations =======================" -msgstr "====================== 最长读取耗时 =======================" +#: domains/c/__init__.py:780 +msgid "macro" +msgstr "宏" -#: sphinx/ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "可以用 extlink 替换硬编码链接 %r(请尝试改用 %r)" +#: domains/c/__init__.py:781 +msgid "struct" +msgstr "结构体" -#: sphinx/ext/graphviz.py:135 -msgid "Graphviz directive cannot have both content and a filename argument" -msgstr "不能同时指定 Graphviz 指令的内容和文件名参数" +#: domains/std/__init__.py:88 domains/std/__init__.py:108 +#, python-format +msgid "environment variable; %s" +msgstr "环境变量; %s" -#: sphinx/ext/graphviz.py:145 +#: domains/std/__init__.py:116 #, python-format -msgid "External Graphviz file %r not found or reading it failed" -msgstr "外部 Graphviz 文件 %r 不存在或读取失败" +msgid "%s; configuration value" +msgstr "%s; 配置值" -#: sphinx/ext/graphviz.py:152 -msgid "Ignoring \"graphviz\" directive without content." -msgstr "已忽略无内容的“graphviz”指令。" +#: domains/std/__init__.py:172 +msgid "Type" +msgstr "类型" -#: sphinx/ext/graphviz.py:268 -#, python-format -msgid "graphviz_dot executable path must be set! %r" -msgstr "" +#: domains/std/__init__.py:182 +msgid "Default" +msgstr "默认" -#: sphinx/ext/graphviz.py:303 +#: domains/std/__init__.py:239 #, python-format msgid "" -"dot command %r cannot be run (needed for graphviz output), check the " -"graphviz_dot setting" -msgstr "无法运行 dot 命令 %r(为输出 graphviz 所必需),请检查 graphviz_dot 的设置" +"Malformed option description %r, should look like \"opt\", \"-opt args\", \"" +"--opt args\", \"/opt args\" or \"+opt args\"" +msgstr "畸形的选项描述 %r,应是“opt”、“-opt args”、“--opt args”、“/opt args”或“+opt args”形式" -#: sphinx/ext/graphviz.py:310 +#: domains/std/__init__.py:319 #, python-format -msgid "" -"dot exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "dot 发生错误并退出:\n[stderr]\n%r\n[stdout]\n%r" +msgid "%s command line option" +msgstr "%s命令行选项" -#: sphinx/ext/graphviz.py:313 -#, python-format -msgid "" -"dot did not produce an output file:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "dot 未生成输出文件:\n[stderr]\n%r\n[stdout]\n%r" +#: domains/std/__init__.py:321 +msgid "command line option" +msgstr "命令行选项" -#: sphinx/ext/graphviz.py:329 -#, python-format -msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" -msgstr "graphviz_output_format 的值只能是“png”或“svg”,但现在给定的是 %r" +#: domains/std/__init__.py:461 +msgid "glossary term must be preceded by empty line" +msgstr "术语词汇前必须有空行" -#: sphinx/ext/graphviz.py:333 sphinx/ext/graphviz.py:386 -#: sphinx/ext/graphviz.py:423 -#, python-format -msgid "dot code %r: %s" -msgstr "dot 代码 %r: %s" +#: domains/std/__init__.py:474 +msgid "glossary terms must not be separated by empty lines" +msgstr "术语词汇不能用空行分隔" -#: sphinx/ext/graphviz.py:436 sphinx/ext/graphviz.py:444 -#, python-format -msgid "[graph: %s]" -msgstr "[图表:%s]" +#: domains/std/__init__.py:486 domains/std/__init__.py:504 +msgid "glossary seems to be misformatted, check indentation" +msgstr "术语词汇格式不正确,请检查缩进" -#: sphinx/ext/graphviz.py:438 sphinx/ext/graphviz.py:446 -msgid "[graph]" -msgstr "[图表]" +#: domains/std/__init__.py:729 +msgid "glossary term" +msgstr "术语词汇" -#: sphinx/ext/imgconverter.py:39 -#, python-format -msgid "" -"Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n" -"\n" -"Traceback: %s" -msgstr "无法运行图像转换命令 %r。“sphinx.ext.imgconverter”默认依赖于 ImageMagick。请确保已安装了它,或者可以自定义“image_converter”选项,设置一个其他的转换命令。\n\n回溯信息:%s" +#: domains/std/__init__.py:730 +msgid "grammar token" +msgstr "语法记号" -#: sphinx/ext/imgconverter.py:48 sphinx/ext/imgconverter.py:72 -#, python-format -msgid "" -"convert exited with error:\n" -"[stderr]\n" -"%r\n" -"[stdout]\n" -"%r" -msgstr "格式转换发生错误并退出:\n[stderr]\n%r\n[stdout]\n%r" +#: domains/std/__init__.py:731 +msgid "reference label" +msgstr "引用标签" -#: sphinx/ext/imgconverter.py:67 -#, python-format -msgid "convert command %r cannot be run, check the image_converter setting" -msgstr "无法运行格式转换命令 %r,请检查 image_converter 的设置" +#: domains/std/__init__.py:733 +msgid "environment variable" +msgstr "环境变量" -#: sphinx/ext/imgmath.py:158 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "无法运行 LaTeX 命令 %r (显示数学公式所必需),请检查 imgmath_latex 的设置" +#: domains/std/__init__.py:734 +msgid "program option" +msgstr "程序选项" -#: sphinx/ext/imgmath.py:173 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "无法运行 %s 命令 %r (显示数学公式所必需),请检查 imgmath_%s 的设置" +#: domains/std/__init__.py:735 +msgid "document" +msgstr "文档" -#: sphinx/ext/imgmath.py:327 -#, python-format -msgid "display latex %r: %s" -msgstr "显示 LaTeX %r:%s" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" +msgstr "模块索引" -#: sphinx/ext/imgmath.py:361 +#: domains/std/__init__.py:857 #, python-format -msgid "inline latex %r: %s" -msgstr "内联 LaTeX %r:%s" +msgid "duplicate %s description of %s, other instance in %s" +msgstr "重复的 %s 描述 %s,另一描述出现在 %s" -#: sphinx/ext/imgmath.py:368 sphinx/ext/mathjax.py:53 -msgid "Link to this equation" -msgstr "" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." +msgstr "numfig 已禁用,忽略 :numref:。" -#: sphinx/ext/intersphinx.py:195 +#: domains/std/__init__.py:1124 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "intersphinx 清单被移动过:%s -> %s" +msgid "Failed to create a cross reference. Any number is not assigned: %s" +msgstr "无法创建交叉引用。未指定题图数字:%s" -#: sphinx/ext/intersphinx.py:230 +#: domains/std/__init__.py:1138 #, python-format -msgid "loading intersphinx inventory from %s..." -msgstr "正在从 %s 加载 intersphinx 清单……" - -#: sphinx/ext/intersphinx.py:244 -msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "在读取这些清单时遇到了一些问题,但已找到可用替代:" - -#: sphinx/ext/intersphinx.py:250 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "无法访问任何清单,问题如下:" +msgid "the link has no caption: %s" +msgstr "链接没有标题:%s" -#: sphinx/ext/intersphinx.py:303 +#: domains/std/__init__.py:1153 #, python-format -msgid "(in %s v%s)" -msgstr "(在 %s v%s)" +msgid "invalid numfig_format: %s (%r)" +msgstr "无效的 numfig_format:%s(%r)" -#: sphinx/ext/intersphinx.py:305 +#: domains/std/__init__.py:1157 #, python-format -msgid "(in %s)" -msgstr "(在 %s)" +msgid "invalid numfig_format: %s" +msgstr "无效的 numfig_format:%s" -#: sphinx/ext/intersphinx.py:538 +#: domains/std/__init__.py:1453 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "" +msgid "undefined label: %r" +msgstr "标签未定义:%r" -#: sphinx/ext/intersphinx.py:546 +#: domains/std/__init__.py:1456 #, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "" +msgid "Failed to create a cross reference. A title or caption not found: %r" +msgstr "无法创建交叉引用,缺少标题或图题:%r" -#: sphinx/ext/intersphinx.py:557 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "" +msgid "invalid value set (missing closing brace): %s" +msgstr "无效的值集合(缺少右括号):%s" -#: sphinx/ext/intersphinx.py:750 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "未找到外部 %s:%s 引用目标:%s" +msgid "invalid value set (missing opening brace): %s" +msgstr "无效的值集合(缺少左括号):%s" -#: sphinx/ext/intersphinx.py:775 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "intersphinx identifier %r is not string. Ignored" -msgstr "intersphinx 标识符 %r 不是字符串,已忽略" +msgid "malformed string literal (missing closing quote): %s" +msgstr "异常的字符串字面量(缺少右引号):%s" -#: sphinx/ext/intersphinx.py:797 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read intersphinx_mapping[%s], ignored: %r" -msgstr "无法读取 intersphinx_mapping[%s],已忽略:%r" +msgid "malformed string literal (missing opening quote): %s" +msgstr "异常的字符串字面量(缺少左引号):%s" -#: sphinx/ext/linkcode.py:69 sphinx/ext/viewcode.py:199 -msgid "[source]" -msgstr "[源代码]" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "示例" -#: sphinx/ext/todo.py:69 -msgid "Todo" -msgstr "待处理" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "示例" -#: sphinx/ext/todo.py:102 -#, python-format -msgid "TODO entry found: %s" -msgstr "发现待处理条目:%s" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "关键字参数" -#: sphinx/ext/todo.py:161 -msgid "<>" -msgstr "<>" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "备注" -#: sphinx/ext/todo.py:163 -#, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<> 见 %s,第 %d 行。)" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "其他参数" -#: sphinx/ext/todo.py:173 -msgid "original entry" -msgstr "原始条目" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "接受" -#: sphinx/ext/viewcode.py:256 -msgid "highlighting module code... " -msgstr "正在高亮模块代码……" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "引用" -#: sphinx/ext/viewcode.py:284 -msgid "[docs]" -msgstr "[文档]" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "警告" -#: sphinx/ext/viewcode.py:304 -msgid "Module code" -msgstr "模块代码" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "生成器" -#: sphinx/ext/viewcode.py:310 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        %s 源代码

        " +msgid "A mocked object is detected: %r" +msgstr "检测到仿制的对象:%r" -#: sphinx/ext/viewcode.py:336 -msgid "Overview: module code" -msgstr "概览:模块代码" +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 +#, python-format +msgid "alias of %s" +msgstr "%s 的别名" -#: sphinx/ext/viewcode.py:337 -msgid "

        All modules for which code is available

        " -msgstr "

        代码可用的所有模块

        " +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 +#, python-format +msgid "Bases: %s" +msgstr "基类:%s" -#: sphinx/ext/autodoc/__init__.py:135 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format msgid "invalid value for member-order option: %s" msgstr "无效的 member-order 选项值:%s" -#: sphinx/ext/autodoc/__init__.py:143 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "无效的 class-doc-from 选项值:%s" -#: sphinx/ext/autodoc/__init__.py:399 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "无效的 auto%s 签名(%r)" -#: sphinx/ext/autodoc/__init__.py:515 -#, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "在格式化 %s 的参数时报错:%s" - -#: sphinx/ext/autodoc/__init__.py:798 -#, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "autodoc:无法确定是否生成 %s.%s (%r) 的文档,抛出了下列异常:\n%s" - -#: sphinx/ext/autodoc/__init__.py:893 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " @@ -2956,159 +3424,249 @@ msgid "" "explicit module name)" msgstr "无法判断导入哪个模块以自动生成文档 %r(尝试在文档中使用“module”或“currentmodule”指令,或者显式给定模块名)" -#: sphinx/ext/autodoc/__init__.py:937 +#: ext/autodoc/_names.py:89 #, python-format -msgid "A mocked object is detected: %r" -msgstr "检测到仿制的对象:%r" +msgid "signature arguments given for automodule: '%s'" +msgstr "为 automodule 给出的签名参数:%s" -#: sphinx/ext/autodoc/__init__.py:956 +#: ext/autodoc/_names.py:93 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "在格式化 %s 的签名时发生错误:%s" +msgid "return annotation given for automodule: '%s'" +msgstr "返回为 automodule 给出的批注:%s" -#: sphinx/ext/autodoc/__init__.py:1019 +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 msgid "\"::\" in automodule name doesn't make sense" msgstr "automodule 名中的“::”无意义" -#: sphinx/ext/autodoc/__init__.py:1026 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "automodule %s 给定了函数签名参数或返回类型标注" +msgid "Failed to remove %s: %s" +msgstr "删除 %s 失败: %s" -#: sphinx/ext/autodoc/__init__.py:1039 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "将会创建文件 %s。" + +#: ext/apidoc/_cli.py:28 msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ 应是一个字符串列表,而不是 %r (出现在模块 %s 中) -- 已忽略__all__" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\n在 中递归查找 Python 模块和包,然后在 中为每个使用了\nautomodule 指令的包创建一个 reST 文件。\n\n 可以排除生成符合规则的文件/目录的文档。\n\n提示:本脚本默认不会覆盖已有文件。" -#: sphinx/ext/autodoc/__init__.py:1105 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "指定模块的路径,用于生成该模块的文档" + +#: ext/apidoc/_cli.py:50 msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr ":members: 选项中涉及的属性不存在:模块 %s,属性%s" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "以 fnmatch 风格的文件/目录规则,不生成与该规则匹配的文档" -#: sphinx/ext/autodoc/__init__.py:1327 sphinx/ext/autodoc/__init__.py:1404 -#: sphinx/ext/autodoc/__init__.py:2824 -#, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "无法获取函数 %s 的签名:%s" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "存放输出内容的目录" -#: sphinx/ext/autodoc/__init__.py:1618 -#, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "无法获取构造函数 %s 的签名:%s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "在目录树中展示子模块的最大深度(默认:4)" -#: sphinx/ext/autodoc/__init__.py:1745 -#, python-format -msgid "Bases: %s" -msgstr "基类:%s" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "覆盖已有文件" -#: sphinx/ext/autodoc/__init__.py:1759 -#, python-format -msgid "missing attribute %s in object %s" -msgstr "指定了 %s 属性,但对象 %s 缺少该属性" +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "遵循符号链接。配合 collective.recipe.omelette 使用尤其奏效。" + +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "运行脚本,但不创建文件" + +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "给模块创建各自的文档页" + +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "包含“_private”模块" + +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "目录的文件名(默认:modules)" + +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "不创建目录文件" + +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "不创建模块/包的标题(比如当 docstring 中已经有标题时,可以使用这个选项)" + +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "把模块文档放置在子模块文档之前" + +#: ext/apidoc/_cli.py:152 +msgid "" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "根据 PEP-0420 隐式命名空间规范解释模块路径" + +#: ext/apidoc/_cli.py:160 +msgid "" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "传递给 automodule 指令的选项的逗号分隔列表(或使用 SPHINX_APIDOC_OPTIONS)。" + +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "文件后缀(默认:rst)" + +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "删除此次未生成,但存在于输出目录中的文件" + +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "用 sphinx-quickstart 生成完整项目" + +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "当指定了 --full 选项,把 module_path 附加到 sys.path" + +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "项目名称(默认:根模块名)" + +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "项目作者,指定了 --full 选项时使用" + +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "项目版本,指定了 --full 选项时使用" + +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "项目发行版本,指定了 --full 选项时使用,默认为 --doc-version 的值" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "扩展选项" -#: sphinx/ext/autodoc/__init__.py:1858 sphinx/ext/autodoc/__init__.py:1895 -#: sphinx/ext/autodoc/__init__.py:1990 +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "启用任意扩展,在给出 --full 时使用" + +#: ext/apidoc/_cli.py:240 #, python-format -msgid "alias of %s" -msgstr "%s 的别名" +msgid "enable %s extension, used when --full is given" +msgstr "启用 %s 扩展,在给出 --full 时使用" -#: sphinx/ext/autodoc/__init__.py:1878 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "TypeVar(%s) 的别名" +msgid "%s is not a directory." +msgstr "%s 不是一个目录。" + +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" +msgstr "运行 apidoc" -#: sphinx/ext/autodoc/__init__.py:2216 sphinx/ext/autodoc/__init__.py:2316 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "无法获取方法 %s 的签名:%s" +msgid "apidoc_modules item %i must be a dict" +msgstr "apidoc_modules 项目 %i 必须是一个 dict" -#: sphinx/ext/autodoc/__init__.py:2447 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "%s 上有无效的 __slots__,已忽略。" +msgid "apidoc_modules item %i must have a 'path' key" +msgstr "apidoc_modules 项目 %i 必须有一个“path”键" -#: sphinx/ext/autodoc/preserve_defaults.py:190 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "无法解析 %r 的默认参数值:%s" +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "apidoc_modules 项目 %i 'path' 必须是一个字符串" -#: sphinx/ext/autodoc/type_comment.py:132 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "无法更新 %r 的签名:未找到参数:%s" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "apidoc_modules 项目 %i 'path' 不是一个存在的文件夹:%s" -#: sphinx/ext/autodoc/type_comment.py:135 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "无法解析 %r 的类型注释:%s" +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "apidoc_modules 项目 %i 必须有一个“destination”键" -#: sphinx/ext/autosummary/__init__.py:251 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "autosummary references excluded document %r. Ignored." -msgstr "自动摘要引用了排除的文档 %r,已忽略。" +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "apidoc_modules 项目 %i 'destination' 必须是一个字符串" -#: sphinx/ext/autosummary/__init__.py:253 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "" -"autosummary: stub file not found %r. Check your autosummary_generate " -"setting." -msgstr "自动摘要:无法找到存根文件 %r。请检查你的 autosummary_generate 设置。" +msgid "apidoc_modules item %i 'destination' should be a relative path" +msgstr "apidoc_modules 项目 %i 'destination' 应该是相对路径" -#: sphinx/ext/autosummary/__init__.py:272 -msgid "A captioned autosummary requires :toctree: option. ignored." -msgstr "在自动摘要中指定标题时也需要指定 :toctree: 选项,已忽略。" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "apidoc_modules 项目 %i 无法创建目标目录:%s" -#: sphinx/ext/autosummary/__init__.py:325 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "" -"autosummary: failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "自动摘要:无法导入 %s。\n可能原因:\n%s" +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "apidoc_modules 项目 %i '%s' 必须是一个 int" -#: sphinx/ext/autosummary/__init__.py:339 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "failed to parse name %s" -msgstr "无法解析名称 %s" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "apidoc_modules 项目 %i '%s' 必须是一个 boolean" -#: sphinx/ext/autosummary/__init__.py:344 +#: ext/apidoc/_extension.py:210 #, python-format -msgid "failed to import object %s" -msgstr "无法导入对象 %s" +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "apidoc_modules 项目 %i包含意外的键:%s" -#: sphinx/ext/autosummary/__init__.py:802 +#: ext/apidoc/_extension.py:248 #, python-format -msgid "autosummary_generate: file not found: %s" -msgstr "autosummary_generate 配置项:文件 %s 不存在" +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "apidoc_modules 项目 %i '%s' 必须是一个 sequence" -#: sphinx/ext/autosummary/__init__.py:810 -msgid "" -"autosummary generates .rst files internally. But your source_suffix does not" -" contain .rst. Skipped." -msgstr "" +#: ext/apidoc/_extension.py:257 +#, python-format +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "apidoc_modules 项目 %i '%s' 必须包含字符串" -#: sphinx/ext/autosummary/generate.py:200 -#: sphinx/ext/autosummary/generate.py:358 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "自动摘要:无法判断是否生成 %r 的文档。抛出了下列异常:\n%s" -#: sphinx/ext/autosummary/generate.py:470 +#: ext/autosummary/generate.py:630 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[自动摘要] 正在生成自动摘要:%s" -#: sphinx/ext/autosummary/generate.py:474 +#: ext/autosummary/generate.py:634 #, python-format msgid "[autosummary] writing to %s" msgstr "[自动摘要] 正在写入 %s" -#: sphinx/ext/autosummary/generate.py:517 +#: ext/autosummary/generate.py:679 #, python-format msgid "" "[autosummary] failed to import %s.\n" @@ -3116,7 +3674,7 @@ msgid "" "%s" msgstr "[自动摘要]无法导入 %s。\n可能原因:\n%s" -#: sphinx/ext/autosummary/generate.py:690 +#: ext/autosummary/generate.py:877 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" @@ -3131,639 +3689,639 @@ msgid "" " pydoc sphinx.ext.autosummary\n" msgstr "\n用 autosummary 指令生成 ReStructuredText\n\nsphinx-autogen 是 sphinx.ext.autosummary.generate 的前端,它根据\n给定输入文件中的 autosummary 指令生成 reStructuredText 文件。\n\nautosummary 指令的格式见 Python 模块 ``sphinx.ext.autosummary`` 的\n文档。可以这样调出文档以供阅读::\n\n pydoc sphinx.ext.autosummary\n" -#: sphinx/ext/autosummary/generate.py:707 +#: ext/autosummary/generate.py:899 msgid "source files to generate rST files for" msgstr "用于生成 rst 文件的源文件" -#: sphinx/ext/autosummary/generate.py:711 +#: ext/autosummary/generate.py:907 msgid "directory to place all output in" msgstr "存放输出内容的目录" -#: sphinx/ext/autosummary/generate.py:714 -#, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "默认的文件名后缀(默认:%(default)s)" - -#: sphinx/ext/autosummary/generate.py:718 -#, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "自定义模板目录(默认:%(default)s)" - -#: sphinx/ext/autosummary/generate.py:722 -#, python-format -msgid "document imported members (default: %(default)s)" -msgstr "文档导入的成员(默认:%(default)s)" - -#: sphinx/ext/autosummary/generate.py:726 -#, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "仅生成模块中 __all__ 属性成员的文档。(默认值:%(default)s)" - -#: sphinx/ext/napoleon/__init__.py:341 sphinx/ext/napoleon/docstring.py:728 -msgid "Keyword Arguments" -msgstr "关键字参数" - -#: sphinx/ext/napoleon/docstring.py:682 -msgid "Example" -msgstr "示例" - -#: sphinx/ext/napoleon/docstring.py:683 -msgid "Examples" -msgstr "示例" - -#: sphinx/ext/napoleon/docstring.py:744 -msgid "Notes" -msgstr "备注" - -#: sphinx/ext/napoleon/docstring.py:753 -msgid "Other Parameters" -msgstr "其他参数" - -#: sphinx/ext/napoleon/docstring.py:789 -msgid "Receives" -msgstr "接受" - -#: sphinx/ext/napoleon/docstring.py:793 -msgid "References" -msgstr "引用" - -#: sphinx/ext/napoleon/docstring.py:825 -msgid "Warns" -msgstr "警告" - -#: sphinx/ext/napoleon/docstring.py:829 -msgid "Yields" -msgstr "生成器" - -#: sphinx/ext/napoleon/docstring.py:987 -#, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "无效的值集合(缺少右括号):%s" - -#: sphinx/ext/napoleon/docstring.py:994 -#, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "无效的值集合(缺少左括号):%s" - -#: sphinx/ext/napoleon/docstring.py:1001 -#, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "异常的字符串字面量(缺少右引号):%s" - -#: sphinx/ext/napoleon/docstring.py:1008 -#, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "异常的字符串字面量(缺少左引号):%s" - -#: sphinx/locale/__init__.py:228 -msgid "Attention" -msgstr "注意" - -#: sphinx/locale/__init__.py:229 -msgid "Caution" -msgstr "小心" - -#: sphinx/locale/__init__.py:230 -msgid "Danger" -msgstr "危险" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "默认的文件名后缀(默认:%(default)s)" -#: sphinx/locale/__init__.py:231 -msgid "Error" -msgstr "错误" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "自定义模板目录(默认:%(default)s)" -#: sphinx/locale/__init__.py:232 -msgid "Hint" -msgstr "提示" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "文档导入的成员(默认:%(default)s)" -#: sphinx/locale/__init__.py:233 -msgid "Important" -msgstr "重要" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "仅生成模块中 __all__ 属性成员的文档。(默认值:%(default)s)" -#: sphinx/locale/__init__.py:234 -msgid "Note" -msgstr "备注" +#: ext/autosummary/__init__.py:235 +#, python-format +msgid "autosummary references excluded document %r. Ignored." +msgstr "自动摘要引用了排除的文档 %r,已忽略。" -#: sphinx/locale/__init__.py:235 -msgid "See also" -msgstr "参见" +#: ext/autosummary/__init__.py:239 +#, python-format +msgid "" +"autosummary: stub file not found %r. Check your autosummary_generate " +"setting." +msgstr "自动摘要:无法找到存根文件 %r。请检查你的 autosummary_generate 设置。" -#: sphinx/locale/__init__.py:236 -msgid "Tip" -msgstr "小技巧" +#: ext/autosummary/__init__.py:260 +msgid "A captioned autosummary requires :toctree: option. ignored." +msgstr "在自动摘要中指定标题时也需要指定 :toctree: 选项,已忽略。" -#: sphinx/locale/__init__.py:237 -msgid "Warning" -msgstr "警告" +#: ext/autosummary/__init__.py:329 +#, python-format +msgid "" +"autosummary: failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "自动摘要:无法导入 %s。\n可能原因:\n%s" -#: sphinx/templates/latex/longtable.tex_t:52 -#: sphinx/templates/latex/sphinxmessages.sty_t:8 -msgid "continued from previous page" -msgstr "接上页" +#: ext/autosummary/__init__.py:358 +#, python-format +msgid "failed to import object %s" +msgstr "无法导入对象 %s" -#: sphinx/templates/latex/longtable.tex_t:63 -#: sphinx/templates/latex/sphinxmessages.sty_t:9 -msgid "continues on next page" -msgstr "续下页" +#: ext/autosummary/__init__.py:652 +#, python-format +msgid "" +"Summarised items should not include the current module. Replace %r with %r." +msgstr "摘要项不应该包含当前模块。请把 %r 替换为 %r。" -#: sphinx/templates/latex/sphinxmessages.sty_t:10 -msgid "Non-alphabetical" -msgstr "非字母" +#: ext/autosummary/__init__.py:850 +#, python-format +msgid "autosummary_generate: file not found: %s" +msgstr "autosummary_generate 配置项:文件 %s 不存在" -#: sphinx/templates/latex/sphinxmessages.sty_t:12 -msgid "Numbers" -msgstr "数字" +#: ext/autosummary/__init__.py:860 +msgid "" +"autosummary generates .rst files internally. But your source_suffix does not" +" contain .rst. Skipped." +msgstr "自动摘要功能内部会生成 .rst 文件。但你的 source_suffix 配置中不包含 .rst。已跳过。" -#: sphinx/templates/latex/sphinxmessages.sty_t:13 -msgid "page" -msgstr "页" +#: ext/intersphinx/_load.py:61 +#, python-format +msgid "" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "intersphinx_mapping 中存在无效的 Sphinx 互联项目标识“%r”。项目标识必须是非空字符串。" -#: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 -#: sphinx/themes/basic/localtoc.html:12 sphinx/themes/scrolls/layout.html:41 -msgid "Table of Contents" -msgstr "目录" +#: ext/intersphinx/_load.py:72 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "无效值“%r”出现在 intersphinx_mapping[%r]。应为两元素元组或列表。" -#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:141 -#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:23 -msgid "Search" -msgstr "搜索" +#: ext/intersphinx/_load.py:83 +#, python-format +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "无效值“%r”出现在 intersphinx_mapping[%r]。此处的值必须是 (目标 URI, 清单位置) 对。" -#: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 -#: sphinx/themes/basic/searchfield.html:18 -msgid "Go" -msgstr "提交" +#: ext/intersphinx/_load.py:94 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "无效的目标 URI 值“%r”出现在 intersphinx_mapping[%r][0]。目标 URI 必须是唯一的非空字符串。" -#: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 -msgid "Show Source" -msgstr "显示源代码" +#: ext/intersphinx/_load.py:103 +#, python-format +msgid "" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "无效的目标 URI 值“%r”出现在 intersphinx_mapping[%r][0]。目标 URI 必须唯一(在 intersphinx_mapping[%r] 发现了相同 URI 值)。" -#: sphinx/themes/basic/defindex.html:11 -msgid "Overview" -msgstr "概述" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "无效的清单位置值“%r”出现在 intersphinx_mapping[%r][1]。清单位置必须是非空字符串或 None。" -#: sphinx/themes/basic/defindex.html:15 -msgid "Welcome! This is" -msgstr "欢迎!" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "无效的“intersphinx_mapping”配置(1 个错误)。" -#: sphinx/themes/basic/defindex.html:16 -msgid "the documentation for" -msgstr "本文档属于" +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "无效的“intersphinx_mapping”配置(%s 个错误)。" -#: sphinx/themes/basic/defindex.html:17 -msgid "last updated" -msgstr "最后更新于" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "在规范化后添加了一个无效的 intersphinx_mapping 条目。" -#: sphinx/themes/basic/defindex.html:20 -msgid "Indices and tables:" -msgstr "索引和表格:" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "正在加载 Sphinx 互联清单“%s”,来自 %s……" -#: sphinx/themes/basic/defindex.html:23 -msgid "Complete Table of Contents" -msgstr "完整目录" +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "在读取这些清单时遇到了一些问题,但已找到可用替代:" -#: sphinx/themes/basic/defindex.html:24 -msgid "lists all sections and subsections" -msgstr "列出所有的章节和部分" +#: ext/intersphinx/_load.py:332 +#, python-format +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "访问任意清单失败,问题如下:\n%s" -#: sphinx/themes/basic/defindex.html:26 -msgid "search this documentation" -msgstr "搜索文档" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "Sphinx 互联清单已移动:%s -> %s" -#: sphinx/themes/basic/defindex.html:28 -msgid "Global Module Index" -msgstr "全局模块索引" +#: ext/intersphinx/_resolve.py:53 +#, python-format +msgid "(in %s %s)" +msgstr "(位于 %s %s)" -#: sphinx/themes/basic/defindex.html:29 -msgid "quick access to all modules" -msgstr "快速查看所有的模块" +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" +msgstr "(在 %s)" -#: sphinx/themes/basic/defindex.html:31 -msgid "all functions, classes, terms" -msgstr "所有函数、类、术语词汇" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" +msgstr "清单“%s”:发现了重复匹配 %s:%s" -#: sphinx/themes/basic/genindex-single.html:33 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Index – %(key)s" -msgstr "索引 – %(key)s" +msgid "inventory '%s': multiple matches found for %s:%s" +msgstr "清单“%s”:发现了多个匹配 %s:%s" -#: sphinx/themes/basic/genindex-single.html:61 -#: sphinx/themes/basic/genindex-split.html:24 -#: sphinx/themes/basic/genindex-split.html:38 -#: sphinx/themes/basic/genindex.html:73 -msgid "Full index on one page" -msgstr "单页全索引" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "未找到外部交叉引用的清单:%r" -#: sphinx/themes/basic/genindex-split.html:16 -msgid "Index pages by letter" -msgstr "字母索引" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "无效的外部交叉引用后缀:%r" -#: sphinx/themes/basic/genindex-split.html:25 -msgid "can be huge" -msgstr "可能会大" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "未找到外部交叉引用的域:%r" -#: sphinx/themes/basic/layout.html:26 -msgid "Navigation" -msgstr "导航" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "未找到外部 %s:%s 引用目标:%s" -#: sphinx/themes/basic/layout.html:126 +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 #, python-format -msgid "Search within %(docstitle)s" -msgstr "在 %(docstitle)s 中搜索" +msgid "error while formatting signature for %s: %s" +msgstr "在格式化 %s 的签名时发生错误:%s" -#: sphinx/themes/basic/layout.html:135 -msgid "About these documents" -msgstr "关于此文档" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "忽略 invalid __all__ in 模块 %s:%r" -#: sphinx/themes/basic/layout.html:144 sphinx/themes/basic/layout.html:188 -#: sphinx/themes/basic/layout.html:190 -msgid "Copyright" -msgstr "版权所有" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "无法获取函数 %s 的签名:%s" -#: sphinx/themes/basic/layout.html:194 sphinx/themes/basic/layout.html:200 +#: ext/autodoc/_dynamic/_type_comments.py:120 #, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "© %(copyright_prefix)s %(copyright)s." +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "无法更新 %r 的签名:未找到参数:%s" -#: sphinx/themes/basic/layout.html:212 +#: ext/autodoc/_dynamic/_type_comments.py:123 #, python-format -msgid "Last updated on %(last_updated)s." -msgstr "最后更新于 %(last_updated)s." +msgid "Failed to parse type_comment for %r: %s" +msgstr "无法解析 %r 的类型注释:%s" -#: sphinx/themes/basic/layout.html:215 +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 #, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "由 Sphinx %(sphinx_version)s创建。" +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "%s 上有无效的 __slots__,已忽略。" -#: sphinx/themes/basic/opensearch.xml:4 +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 #, python-format -msgid "Search %(docstitle)s" -msgstr "搜索 %(docstitle)s" +msgid "error while formatting arguments for %s: %s" +msgstr "在格式化 %s 的参数时报错:%s" -#: sphinx/themes/basic/relations.html:12 -msgid "Previous topic" -msgstr "上一主题" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "无法获取构造函数 %s 的签名:%s" -#: sphinx/themes/basic/relations.html:14 -msgid "previous chapter" -msgstr "上一章" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "无法获取方法 %s 的签名:%s" -#: sphinx/themes/basic/relations.html:19 -msgid "Next topic" -msgstr "下一主题" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "获取 %s 的签名失败:%s" -#: sphinx/themes/basic/relations.html:21 -msgid "next chapter" -msgstr "下一章" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "无法解析 %r 的默认参数值:%s" -#: sphinx/themes/basic/search.html:28 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Please activate JavaScript to enable the search\n" -" functionality." -msgstr "请激活 JavaScript 以开启搜索功能。" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" +msgstr "属性 %s 已在 :members: 中列出但缺失,它无法在对象 %r 中找到。" -#: sphinx/themes/basic/search.html:36 +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format msgid "" -"Searching for multiple words only shows matches that contain\n" -" all words." -msgstr "当搜索多个关键词时,只会显示同时包含所有关键词的内容。" - -#: sphinx/themes/basic/search.html:43 -msgid "search" -msgstr "搜索" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "autodoc:无法确定是否生成 %s.%s (%r) 的文档,抛出了下列异常:\n%s" -#: sphinx/themes/basic/searchbox.html:12 -msgid "Quick search" -msgstr "快速搜索" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "automodule %s 给定了函数签名参数或返回类型标注" -#: sphinx/themes/basic/sourcelink.html:12 -msgid "This Page" -msgstr "本页" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ 应是一个字符串列表,而不是 %r (出现在模块 %s 中) -- 已忽略__all__" -#: sphinx/themes/basic/changes/frameset.html:5 -#: sphinx/themes/basic/changes/versionchanges.html:12 +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 #, python-format -msgid "Changes in Version %(version)s — %(docstitle)s" -msgstr "于版本 %(version)s— %(docstitle)s 变更" +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr ":members: 选项中涉及的属性不存在:模块 %s,属性%s" -#: sphinx/themes/basic/changes/rstsource.html:5 +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 #, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +msgid "missing attribute %s in object %s" +msgstr "指定了 %s 属性,但对象 %s 缺少该属性" -#: sphinx/themes/basic/changes/versionchanges.html:17 +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 #, python-format -msgid "Automatically generated list of changes in version %(version)s" -msgstr "自动生成的 %(version)s 版本变更列表" +msgid "alias of TypeVar(%s)" +msgstr "TypeVar(%s) 的别名" -#: sphinx/themes/basic/changes/versionchanges.html:18 -msgid "Library changes" -msgstr "库的变更" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "无法读取损坏的构建信息文件(未知版本)" -#: sphinx/themes/basic/changes/versionchanges.html:23 -msgid "C API changes" -msgstr "C API 的变更" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "无法读取损坏的构建信息文件(缺少 config 条目)" -#: sphinx/themes/basic/changes/versionchanges.html:25 -msgid "Other changes" -msgstr "其他变更" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" +msgstr "无法读取损坏的构建信息文件(缺少 tags 条目)" -#: sphinx/themes/basic/static/searchtools.js:112 -msgid "Search Results" -msgstr "搜索结果" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." +msgstr "HTML 页面保存在 %(outdir)s 目录。" -#: sphinx/themes/basic/static/searchtools.js:114 -msgid "" -"Your search did not match any documents. Please make sure that all words are" -" spelled correctly and that you've selected enough categories." -msgstr "您的搜索没有匹配到文档。请确保关键词拼写正确,并且选择了合适的分类。" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" +msgstr "读取构建信息文件失败:%r" + +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +msgstr "build_info 不匹配,正在把 .buildinfo 复制为 .buildinfo.bak" -#: sphinx/themes/basic/static/searchtools.js:118 +#: builders/html/__init__.py:355 +msgid "building [html]: " +msgstr "正在构建 [html]:" + +#: builders/html/__init__.py:372 +#, python-format msgid "" -"Search finished, found ${resultCount} page(s) matching the search query." -msgstr "搜索完成,匹配到 ${resultCount} 页。" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" +msgstr "自上次构建后模板 %s 发生了变动,将重新构建所有文档。" -#: sphinx/themes/basic/static/searchtools.js:246 -msgid "Searching" -msgstr "正在搜索中" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "索引" -#: sphinx/themes/basic/static/searchtools.js:262 -msgid "Preparing search..." -msgstr "正在准备搜索……" +#: builders/html/__init__.py:549 +#, python-format +msgid "Logo of %s" +msgstr "%s 的 Logo" -#: sphinx/themes/basic/static/searchtools.js:463 -msgid ", in " -msgstr ",在 " +#: builders/html/__init__.py:578 +msgid "next" +msgstr "下一页" -#: sphinx/themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "隐藏搜索结果" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "上一页" -#: sphinx/themes/classic/layout.html:20 -#: sphinx/themes/classic/static/sidebar.js_t:57 -msgid "Collapse sidebar" -msgstr "折叠边栏" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "正在生成索引" -#: sphinx/themes/classic/static/sidebar.js_t:48 -msgid "Expand sidebar" -msgstr "展开边栏" +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "正在写入附加页面" -#: sphinx/themes/haiku/layout.html:24 -msgid "Contents" -msgstr "目录" +#: builders/html/__init__.py:783 +#, python-format +msgid "cannot copy image file '%s': %s" +msgstr "无法复制图像文件“%s”:%s" -#: sphinx/transforms/__init__.py:128 -msgid "could not calculate translation progress!" -msgstr "" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "正在复制可下载文件……" -#: sphinx/transforms/__init__.py:133 -msgid "no translated elements!" -msgstr "" +#: builders/html/__init__.py:807 +#, python-format +msgid "cannot copy downloadable file %r: %s" +msgstr "无法复制可下载文件 %r:%s" -#: sphinx/transforms/__init__.py:250 +#: builders/html/__init__.py:853 #, python-format -msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "索引页使用了 4 列布局,可能是你所用的扩展出现了 Bug:%r" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgstr "向主题的“static”目录复制文件失败:%s: %r" -#: sphinx/transforms/__init__.py:291 +#: builders/html/__init__.py:871 #, python-format -msgid "Footnote [%s] is not referenced." -msgstr "脚注 [%s] 没有被引用过。" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "无法复制 html_static_file 中的文件:%s: %r" -#: sphinx/transforms/__init__.py:297 -msgid "Footnote [#] is not referenced." -msgstr "脚注 [#] 没有被引用过。" +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "正在复制静态文件" -#: sphinx/transforms/i18n.py:205 sphinx/transforms/i18n.py:270 -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "译文中的脚注引用与原文不一致。原文中为:{0},翻文中为:{1}" +#: builders/html/__init__.py:923 +#, python-format +msgid "cannot copy static file %r" +msgstr "无法复制静态文件 %r" -#: sphinx/transforms/i18n.py:245 -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "译文中的引用与原文不一致。原文中为:{0},译文中为:{1}" +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "正在复制额外文件" -#: sphinx/transforms/i18n.py:285 -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "译文中的引文引用与原文不一致。原文中为:{0},译文中为:{1}" +#: builders/html/__init__.py:938 +#, python-format +msgid "cannot copy extra file %r" +msgstr "无法复制额外文件 %r" -#: sphinx/transforms/i18n.py:302 -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "译文中的术语引用与原文不一致。原文中为:{0},译文中为:{1}" +#: builders/html/__init__.py:944 +#, python-format +msgid "Failed to write build info file: %r" +msgstr "写入构建信息文件失败:%r" -#: sphinx/transforms/post_transforms/__init__.py:116 +#: builders/html/__init__.py:994 msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "无法确定交叉引用的回退文本。可能是 Bug。" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "无法加载搜索索引,不会构建所有文档:索引将不完整。" -#: sphinx/transforms/post_transforms/__init__.py:158 +#: builders/html/__init__.py:1038 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "“any”交叉引用 %r 的目标不唯一:可能是 %s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "页面 %s 同时符合两条 html_sidebars 规则:%r 和 %r" -#: sphinx/transforms/post_transforms/__init__.py:209 +#: builders/html/__init__.py:1204 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "未找到 %s:%s 的引用目标: %s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "在渲染页面 %s 时发生了 Unicode 错误。请确保所有包含非 ASCII 字符的配置项均为 Unicode 字符串。" -#: sphinx/transforms/post_transforms/__init__.py:212 +#: builders/html/__init__.py:1217 #, python-format -msgid "%r reference target not found: %s" -msgstr "未找到 %r 的引用目标:%s" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" +msgstr "'%s' 主题不支持此版本的 Sphinx,因为它使用了 HTML 模板中的“style”字段,而该字段在 Sphinx 5.1 中已弃用,并在 Sphinx 7.0 中被移除。必须更新主题才能使用“styles”字段。请参阅 https://www.sphinx-doc.org/en/master/development/html_themes/templating.html#styles" -#: sphinx/transforms/post_transforms/images.py:89 +#: builders/html/__init__.py:1225 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "无法拉取远程图像:%s [%d]" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "渲染页面 %s 时发生了错误。\n原因:%r" -#: sphinx/transforms/post_transforms/images.py:117 -#, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "无法拉取远程图像:%s [%s]" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "正在导出对象清单" -#: sphinx/transforms/post_transforms/images.py:135 +#: builders/html/__init__.py:1266 #, python-format -msgid "Unknown image format: %s..." -msgstr "未知的图像格式:%s……" +msgid "dumping search index in %s" +msgstr "正在导出 %s 的搜索索引" -#: sphinx/util/__init__.py:168 +#: builders/html/__init__.py:1313 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "源码中存在编码无法识别的字符,已经替换为“?”:%r" +msgid "invalid js_file: %r, ignored" +msgstr "无效的 js_file:%r,已忽略" -#: sphinx/util/display.py:78 -msgid "skipped" -msgstr "已跳过" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "注册了多个 math_renderer,但没有选择 math_renderer。" -#: sphinx/util/display.py:83 -msgid "failed" -msgstr "失败" +#: builders/html/__init__.py:1351 +#, python-format +msgid "Unknown math_renderer %r is given." +msgstr "给定的 math_renderer %r 不存在。" -#: sphinx/util/docfields.py:87 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "%s 域中的问题:字段应采用“%s”角色,但域中并不包含该角色。" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "html_extra_path 入口 %r 被置于输出目录内" -#: sphinx/util/docutils.py:295 +#: builders/html/__init__.py:1370 #, python-format -msgid "unknown directive or role name: %s:%s" -msgstr "未知的指令或角色名称:%s:%s" +msgid "html_extra_path entry %r does not exist" +msgstr "html_extra_path 入口 %r 不存在" -#: sphinx/util/docutils.py:591 +#: builders/html/__init__.py:1385 #, python-format -msgid "unknown node type: %r" -msgstr "未知节点类型:%r" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "html_static_path 入口 %r 置于输出目录内" -#: sphinx/util/i18n.py:94 +#: builders/html/__init__.py:1390 #, python-format -msgid "reading error: %s, %s" -msgstr "读取时发生错误:%s,%s" +msgid "html_static_path entry %r does not exist" +msgstr "html_static_path 入口 %r 不存在" -#: sphinx/util/i18n.py:101 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "writing error: %s, %s" -msgstr "写入时发生错误:%s,%s" +msgid "logo file %r does not exist" +msgstr "logo 文件 %r 不存在" -#: sphinx/util/i18n.py:125 +#: builders/html/__init__.py:1412 #, python-format -msgid "locale_dir %s does not exist" -msgstr "" +msgid "favicon file %r does not exist" +msgstr "favicon 文件 %r 不存在" -#: sphinx/util/i18n.py:215 +#: builders/html/__init__.py:1425 #, python-format msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "无效的日期格式。如果你想直接输出日期字符串,请用单引号包裹该字符串:%s" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." +msgstr "“html_sidebars”的值必须是字符串列表。至少一个模式的值为字符串:%s。请修改为“html_sidebars = %r”。" -#: sphinx/util/nodes.py:386 -#, python-format +#: builders/html/__init__.py:1438 msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "%r 不再适用于索引款目(源自 %r 款目)。请使用“pair: %s”作为替代。" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "Sphinx 不再支持 HTML 4。(在配置项中检测到了“html4_writer=True”)" -#: sphinx/util/nodes.py:439 +#: builders/html/__init__.py:1454 #, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "目录树引用的文件 %r 不存在" +msgid "%s %s documentation" +msgstr "%s %s 文档" -#: sphinx/util/nodes.py:637 +#: builders/latex/theming.py:87 #, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "only 指令的表达式求值时抛出异常:%s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r 中缺少“theme”配置项" -#: sphinx/util/rst.py:71 +#: builders/latex/theming.py:90 #, python-format -msgid "default role %s not found" -msgstr "未找到默认角色 %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r 中缺少“%s”配置项" -#: sphinx/writers/html5.py:100 sphinx/writers/html5.py:109 -msgid "Link to this definition" -msgstr "" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "无法获取文档名称!" -#: sphinx/writers/html5.py:397 +#: builders/latex/transforms.py:121 #, python-format -msgid "numfig_format is not defined for %s" -msgstr "未定义 %s 的 numfig_format" +msgid "Failed to get a docname for source %r!" +msgstr "无法获取文档源码 %r 的文档名称!" -#: sphinx/writers/html5.py:407 +#: builders/latex/transforms.py:487 #, python-format -msgid "Any IDs not assigned for %s node" -msgstr "没有给 %s 节点分配 ID" +msgid "No footnote was found for given reference node %r" +msgstr "给定的引用节点 %r 没有对应的脚注" -#: sphinx/writers/html5.py:462 -msgid "Link to this term" -msgstr "" +#: builders/latex/__init__.py:115 +#, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "LaTex 文件保存在 %(outdir)s 目录。" -#: sphinx/writers/html5.py:496 sphinx/writers/html5.py:501 -msgid "Link to this heading" -msgstr "" +#: builders/latex/__init__.py:118 +msgid "" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\n在该目录下运行“make”以通过 (pdf)latex 处理这些 LaTex 文件\n(在此处用“make latexpdf”即可自动执行上述操作)。" -#: sphinx/writers/html5.py:505 -msgid "Link to this table" -msgstr "" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "未找到“latex_documents”配置项,不会写入文档" -#: sphinx/writers/html5.py:548 -msgid "Link to this code" -msgstr "" +#: builders/latex/__init__.py:167 +#, python-format +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "配置项“latex_documents”引用的文档 %s 不存在" -#: sphinx/writers/html5.py:550 -msgid "Link to this image" -msgstr "" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "正在复制 TeX 支持文件" -#: sphinx/writers/html5.py:552 -msgid "Link to this toctree" -msgstr "" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "正在复制附加文件" -#: sphinx/writers/html5.py:688 -msgid "Could not obtain image size. :scale: option is ignored." -msgstr "无法获取图像尺寸,已忽略 :scale: 选项。" +#: builders/latex/__init__.py:529 +#, python-format +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "未知配置项:latex_elements[%r],已忽略。" -#: sphinx/writers/latex.py:335 +#: builders/latex/__init__.py:537 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "未知的 %r toplevel_sectioning 被用于 %r 类" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "未知主题选项:latex_theme_options[%r],已忽略。" -#: sphinx/writers/latex.py:386 -msgid "too large :maxdepth:, ignored." -msgstr ":mathdepth: 值过大,已忽略。" +#: environment/collectors/toctree.py:259 +#, python-format +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "已经给 %s 分配了章节编号(嵌套的带编号文档树?)" -#: sphinx/writers/latex.py:625 -msgid "document title is not a single Text node" -msgstr "文档标题不是一个单纯文本节点" +#: environment/collectors/asset.py:98 +#, python-format +msgid "image file not readable: %s" +msgstr "无法读取图像文件:%s" -#: sphinx/writers/latex.py:656 sphinx/writers/texinfo.py:626 -msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" -msgstr "在节、话题、表格、警示或边栏以外的位置发现标题节点" +#: environment/collectors/asset.py:126 +#, python-format +msgid "image file %s not readable: %s" +msgstr "无法读取图像文件 %s:%s" -#: sphinx/writers/latex.py:959 sphinx/writers/manpage.py:259 -#: sphinx/writers/texinfo.py:641 -msgid "Footnotes" -msgstr "脚注" +#: environment/collectors/asset.py:165 +#, python-format +msgid "download file not readable: %s" +msgstr "无法读取下载文件:%s" -#: sphinx/writers/latex.py:1028 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "同时指定了 tabularcolumns 和 :widths: 选项,已忽略 :widths:。" +#: environment/adapters/toctree.py:335 +#, python-format +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "在文档树中检测到循环引用,已忽略:%s <- %s" -#: sphinx/writers/latex.py:1388 +#: environment/adapters/toctree.py:360 #, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "无效的量纲单位 %s,已忽略。" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "目录树引用的文档 %r 缺少标题:不会生成链接" -#: sphinx/writers/latex.py:1722 +#: environment/adapters/toctree.py:375 #, python-format -msgid "unknown index entry type %s found" -msgstr "发现未知的索引条目类型 %s" +msgid "toctree contains reference to non-included document %r" +msgstr "目录树引用了未包含的文档 %r" -#: sphinx/writers/manpage.py:305 sphinx/writers/text.py:907 +#: environment/adapters/toctree.py:378 #, python-format -msgid "[image: %s]" -msgstr "[图片: %s]" +msgid "toctree contains reference to non-existing document %r" +msgstr "目录树包含对不存在的文档 %r 的引用" -#: sphinx/writers/manpage.py:306 sphinx/writers/text.py:908 -msgid "[image]" -msgstr "[图片]" +#: environment/adapters/indexentries.py:122 +#, python-format +msgid "see %s" +msgstr "见 %s" -#: sphinx/writers/texinfo.py:1197 -msgid "caption not inside a figure." -msgstr "在图示之外发现了图题。" +#: environment/adapters/indexentries.py:132 +#, python-format +msgid "see also %s" +msgstr "另请参见 %s" -#: sphinx/writers/texinfo.py:1284 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "unimplemented node type: %r" -msgstr "未实现的节点类型:%r" +msgid "unknown index entry type %r" +msgstr "未知的索引条目类型 %r" diff --git a/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo b/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo index 967b0531ea9..796b47a010c 100644 Binary files a/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo and b/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po index 839f15917e7..74413b55119 100644 --- a/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese (Hong Kong) (http://app.transifex.com/sphinx-doc/sphinx-1/language/zh_HK/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: zh_HK\n" "Plural-Forms: nplurals=1; plural=0;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,42 +2923,41 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" "Search finished, found ${resultCount} pages matching the search query." msgstr[0] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2826,6 +2966,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2847,119 +2992,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2971,92 +3123,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3084,581 +3229,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3666,548 +3719,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo index a36852c1705..ebd115ebae2 100644 Binary files a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo and b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po index 466b7b91422..ebd88a0c1e9 100644 --- a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" "Last-Translator: FULL NAME \n" "Language-Team: Chinese (Taiwan) (Big5) (http://app.transifex.com/sphinx-doc/sphinx-1/language/zh_TW.Big5/)\n" @@ -18,6 +18,127 @@ msgstr "" "Language: zh_TW.Big5\n" "Plural-Forms: nplurals=1; plural=0;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "" + #: extension.py:58 #, python-format msgid "" @@ -32,127 +153,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "" -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -160,12 +308,12 @@ msgid "" "explicit" msgstr "" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -173,82 +321,214 @@ msgid "" "explicit" msgstr "" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" -#: config.py:366 +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "" + +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -256,491 +536,648 @@ msgid "" "%s" msgstr "" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" +#: config.py:892 +msgid "" +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." +#: environment/__init__.py:89 +msgid "new config" msgstr "" -#: theming.py:115 -#, python-format -msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +#: environment/__init__.py:90 +msgid "config changed" msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" +#: environment/__init__.py:91 +msgid "extensions changed" msgstr "" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" +#: environment/__init__.py:261 +msgid "build environment version not current" msgstr "" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" +#: environment/__init__.py:263 +msgid "source directory has changed" msgstr "" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" +msgid "The configuration has changed (1 option: %r)" msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" +msgid "The configuration has changed (%d options: %s)" msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." msgstr "" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" +msgid "Failed to scan documents in %s: %r" msgstr "" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" +msgid "Domain %r is not registered" msgstr "" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" msgstr "" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." msgstr "" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" +#: locale/__init__.py:229 +msgid "Attention" msgstr "" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +#: locale/__init__.py:230 +msgid "Caution" msgstr "" -#: events.py:77 -#, python-format -msgid "Event %r already present" +#: locale/__init__.py:231 +msgid "Danger" msgstr "" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" +#: locale/__init__.py:232 +msgid "Error" msgstr "" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" +#: locale/__init__.py:233 +msgid "Hint" msgstr "" -#: project.py:72 -#, python-format -msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." +#: locale/__init__.py:234 +msgid "Important" msgstr "" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." +#: locale/__init__.py:235 +msgid "Note" msgstr "" -#: registry.py:167 -#, python-format -msgid "Builder class %s has no \"name\" attribute" +#: locale/__init__.py:236 +msgid "See also" msgstr "" -#: registry.py:171 -#, python-format -msgid "Builder %r already exists (in module %s)" +#: locale/__init__.py:237 +msgid "Tip" msgstr "" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" +#: locale/__init__.py:238 +msgid "Warning" msgstr "" -#: registry.py:197 +#: builders/texinfo.py:41 #, python-format -msgid "Builder name %s not registered" +msgid "The Texinfo files are in %(outdir)s." msgstr "" -#: registry.py:204 -#, python-format -msgid "domain %s already registered" +#: builders/texinfo.py:44 +msgid "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." msgstr "" -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" -#: registry.py:235 +#: builders/texinfo.py:85 #, python-format -msgid "The %r directive is already registered to domain %s" +msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" -#: registry.py:253 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "The %r role is already registered to domain %s" +msgid "processing %s" msgstr "" -#: registry.py:266 -#, python-format -msgid "The %r index is already registered to domain %s" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" msgstr "" -#: registry.py:313 -#, python-format -msgid "The %r object_type is already registered" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." msgstr "" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " msgstr "" -#: registry.py:353 -#, python-format -msgid "source_suffix %r is already registered" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " msgstr "" -#: registry.py:363 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "source_parser for %r is already registered" +msgid "cannot copy image file %r: %s" msgstr "" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" msgstr "" -#: registry.py:390 +#: builders/texinfo.py:218 #, python-format -msgid "Translator for %r already exists" +msgid "error writing file Makefile: %s" msgstr "" -#: registry.py:407 +#: builders/manpage.py:37 #, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgid "The manual pages are in %(outdir)s." msgstr "" -#: registry.py:496 -#, python-format -msgid "enumerable_node %r already registered" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" -#: registry.py:512 +#: builders/manpage.py:64 #, python-format -msgid "math renderer %s is already registered" +msgid "\"man_pages\" config value references unknown document %s" msgstr "" -#: registry.py:529 +#: builders/singlehtml.py:35 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." +msgid "The HTML page is in %(outdir)s." msgstr "" -#: registry.py:543 -msgid "Original exception:\n" +#: builders/singlehtml.py:171 +msgid "assembling single document" msgstr "" -#: registry.py:545 -#, python-format -msgid "Could not import extension %s" +#: builders/singlehtml.py:189 +msgid "writing additional files" msgstr "" -#: registry.py:552 -#, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." msgstr "" -#: registry.py:565 +#: builders/gettext.py:243 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." +msgid "The message catalogs are in %(outdir)s." msgstr "" -#: registry.py:577 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" +msgid "building [%s]: " msgstr "" -#: registry.py:612 +#: builders/gettext.py:265 #, python-format -msgid "`None` is not a valid filetype for %r." +msgid "targets for %d template files" msgstr "" -#: roles.py:206 -#, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" +#: builders/gettext.py:271 +msgid "reading templates... " msgstr "" -#: roles.py:229 -#, python-format -msgid "invalid CVE number %s" +#: builders/gettext.py:310 +msgid "writing message catalogs... " msgstr "" -#: roles.py:251 +#: builders/linkcheck.py:87 #, python-format -msgid "Common Weakness Enumeration; CWE %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" -#: roles.py:274 +#: builders/linkcheck.py:159 #, python-format -msgid "invalid CWE number %s" +msgid "broken link: %s (%s)" msgstr "" -#: roles.py:294 +#: builders/linkcheck.py:561 #, python-format -msgid "Python Enhancement Proposals; PEP %s" +msgid "Anchor '%s' not found" msgstr "" -#: roles.py:317 -#, python-format -msgid "invalid PEP number %s" +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." msgstr "" -#: roles.py:355 +#: builders/linkcheck.py:799 #, python-format -msgid "invalid RFC number %s" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" +#: builders/epub3.py:83 +#, python-format +msgid "The ePub file is in %(outdir)s." msgstr "" -#: ext/viewcode.py:289 -msgid "highlighting module code... " +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." msgstr "" -#: ext/viewcode.py:320 -msgid "[docs]" +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:346 -msgid "Module code" +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" -#: ext/viewcode.py:353 -#, python-format -msgid "

        Source code for %s

        " +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:380 -msgid "Overview: module code" +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" -#: ext/extlinks.py:82 -#, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" -#: ext/autosectionlabel.py:52 -#, python-format -msgid "section \"%s\" gets labeled as \"%s\"" +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 -#, python-format -msgid "duplicate label %s, other instance in %s" +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" -#: ext/doctest.py:118 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "missing '+' or '-' in '%s' option." +msgid "invalid css_file: %r, ignored" msgstr "" -#: ext/doctest.py:124 +#: builders/xml.py:29 #, python-format -msgid "'%s' is not a valid option." +msgid "The XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:139 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "'%s' is not a valid pyversion option" +msgid "error writing file %s: %s" msgstr "" -#: ext/doctest.py:226 -msgid "invalid TestCode type" +#: builders/xml.py:103 +#, python-format +msgid "The pseudo-XML files are in %(outdir)s." msgstr "" -#: ext/doctest.py:297 +#: builders/_epub_base.py:223 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." +msgid "duplicated ToC entry found: %s" msgstr "" -#: ext/doctest.py:457 +#: builders/_epub_base.py:436 #, python-format -msgid "no code/output in %s block at %s:%s" +msgid "cannot read image file %r: copying it instead" msgstr "" -#: ext/doctest.py:568 +#: builders/_epub_base.py:467 #, python-format -msgid "ignoring invalid doctest code: %r" +msgid "cannot write image file %r: %s" msgstr "" -#: ext/imgmath.py:162 -#, python-format -msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" msgstr "" -#: ext/imgmath.py:181 -#, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." msgstr "" -#: ext/imgmath.py:344 -#, python-format -msgid "display latex %r: %s" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." msgstr "" -#: ext/imgmath.py:380 -#, python-format -msgid "inline latex %r: %s" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." msgstr "" -#: ext/coverage.py:48 +#: builders/_epub_base.py:594 #, python-format -msgid "invalid regex %r in %s" +msgid "unknown mimetype for %s, ignoring" msgstr "" -#: ext/coverage.py:140 ext/coverage.py:301 -#, python-format -msgid "module %s could not be imported: %s" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" msgstr "" -#: ext/coverage.py:148 -#, python-format +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "" + +#: builders/_epub_base.py:802 +#, python-format +msgid "writing %s file..." +msgstr "" + +#: builders/text.py:27 +#, python-format +msgid "The text files are in %(outdir)s." +msgstr "" + +#: builders/__init__.py:229 +#, python-format +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "" + +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "" + +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "" + +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "" + +#: builders/__init__.py:280 +#, python-format +msgid "all of %d po files" +msgstr "" + +#: builders/__init__.py:302 +#, python-format +msgid "targets for %d po files that are specified" +msgstr "" + +#: builders/__init__.py:314 +#, python-format +msgid "targets for %d po files that are out of date" +msgstr "" + +#: builders/__init__.py:324 +msgid "all source files" +msgstr "" + +#: builders/__init__.py:335 +#, python-format +msgid "file %r given on command line does not exist, " +msgstr "" + +#: builders/__init__.py:342 +#, python-format +msgid "" +"file %r given on command line is not under the source directory, ignoring" +msgstr "" + +#: builders/__init__.py:353 +#, python-format +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "" + +#: builders/__init__.py:366 +#, python-format +msgid "%d source files given on command line" +msgstr "" + +#: builders/__init__.py:382 +#, python-format +msgid "targets for %d source files that are out of date" +msgstr "" + +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "" + +#: builders/__init__.py:415 +#, python-format +msgid "%d found" +msgstr "" + +#: builders/__init__.py:417 +msgid "none found" +msgstr "" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "" + +#: builders/__init__.py:499 +#, python-format +msgid "%s added, %s changed, %s removed" +msgstr "" + +#: builders/__init__.py:536 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." +msgstr "" + +#: builders/__init__.py:545 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." +msgstr "" + +#: builders/__init__.py:556 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." +msgstr "" + +#: builders/__init__.py:563 +#, python-format +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" + +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "" + +#: builders/__init__.py:725 +#, python-format +msgid "docnames to write: %s" +msgstr "" + +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "" + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "" + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "" + +#: ext/coverage.py:148 +#, python-format msgid "" "the following modules are documented but were not specified in " "coverage_modules: %s" msgstr "" #: ext/coverage.py:158 +#, python-format msgid "" "the following modules are specified in coverage_modules but were not " -"documented" +"documented: %s" msgstr "" #: ext/coverage.py:172 @@ -775,6 +1212,34 @@ msgstr "" msgid "undocumented python method: %s :: %s :: %s" msgstr "" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "" + +#: ext/todo.py:152 +msgid "<>" +msgstr "" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -862,947 +1327,993 @@ msgstr "" msgid "[graph]" msgstr "" -#: ext/todo.py:61 -msgid "Todo" -msgstr "" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" msgstr "" -#: ext/todo.py:152 -msgid "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" msgstr "" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" +msgid "display latex %r: %s" msgstr "" -#: ext/todo.py:166 -msgid "original entry" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" msgstr "" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" msgstr "" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" +msgid "missing '+' or '-' in '%s' option." msgstr "" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" +msgid "'%s' is not a valid option." msgstr "" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" +msgid "'%s' is not a valid pyversion option" msgstr "" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" +#: ext/doctest.py:226 +msgid "invalid TestCode type" msgstr "" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." msgstr "" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" +msgid "no code/output in %s block at %s:%s" msgstr "" -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +#: ext/doctest.py:568 +#, python-format +msgid "ignoring invalid doctest code: %r" msgstr "" -#: directives/code.py:314 +#: ext/autosectionlabel.py:52 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" +msgid "section \"%s\" gets labeled as \"%s\"" msgstr "" -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "" - -#: directives/other.py:119 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree glob pattern %r didn't match any documents" +msgid "duplicate label %s, other instance in %s" msgstr "" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to excluded document %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" msgstr "" -#: directives/other.py:156 -#, python-format -msgid "toctree contains reference to nonexisting document %r" +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" msgstr "" -#: directives/other.py:169 +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "" - -#: directives/other.py:203 -msgid "Section author: " +msgid "Total time reading %d file%s: %dm %.3fs" msgstr "" -#: directives/other.py:205 -msgid "Module author: " +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" msgstr "" -#: directives/other.py:207 -msgid "Code author: " +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" msgstr "" -#: directives/other.py:209 -msgid "Author: " +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" msgstr "" -#: directives/other.py:269 -msgid ".. acks content is not a list" +#: ext/viewcode.py:295 +msgid "highlighting module code... " msgstr "" -#: directives/other.py:292 -msgid ".. hlist content is not a list" +#: ext/viewcode.py:326 +msgid "[docs]" msgstr "" -#: builders/changes.py:29 -#, python-format -msgid "The overview file is in %(outdir)s." +#: ext/viewcode.py:352 +msgid "Module code" msgstr "" -#: builders/changes.py:56 +#: ext/viewcode.py:359 #, python-format -msgid "no changes in version %s." +msgid "

        Source code for %s

        " msgstr "" -#: builders/changes.py:58 -msgid "writing summary file..." +#: ext/viewcode.py:386 +msgid "Overview: module code" msgstr "" -#: builders/changes.py:70 -msgid "Builtins" +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " msgstr "" -#: builders/changes.py:72 -msgid "Module level" +#: domains/citation.py:75 +#, python-format +msgid "duplicate citation %s, other instance in %s" msgstr "" -#: builders/changes.py:124 -msgid "copying source files..." +#: domains/citation.py:92 +#, python-format +msgid "Citation [%s] is not referenced." msgstr "" -#: builders/changes.py:133 +#: domains/math.py:73 #, python-format -msgid "could not read %r for changelog creation" +msgid "duplicate label of equation %s, other instance in %s" msgstr "" -#: builders/manpage.py:37 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "The manual pages are in %(outdir)s." +msgid "Invalid math_eqref_format: %r" msgstr "" -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" +#: domains/javascript.py:183 +#, python-format +msgid "%s() (built-in function)" msgstr "" -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" +#: domains/javascript.py:184 domains/python/__init__.py:279 +#, python-format +msgid "%s() (%s method)" msgstr "" -#: builders/manpage.py:71 +#: domains/javascript.py:186 #, python-format -msgid "\"man_pages\" config value references unknown document %s" +msgid "%s() (class)" msgstr "" -#: builders/__init__.py:224 +#: domains/javascript.py:188 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" +msgid "%s (global variable or constant)" msgstr "" -#: builders/__init__.py:232 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "a suitable image for %s builder not found: %s" +msgid "%s (%s attribute)" msgstr "" -#: builders/__init__.py:255 -msgid "building [mo]: " +#: domains/javascript.py:274 +msgid "Arguments" msgstr "" -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" msgstr "" -#: builders/__init__.py:275 -#, python-format -msgid "all of %d po files" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" msgstr "" -#: builders/__init__.py:297 -#, python-format -msgid "targets for %d po files that are specified" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" msgstr "" -#: builders/__init__.py:309 +#: domains/javascript.py:374 #, python-format -msgid "targets for %d po files that are out of date" +msgid "%s (module)" msgstr "" -#: builders/__init__.py:319 -msgid "all source files" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" msgstr "" -#: builders/__init__.py:330 -#, python-format -msgid "file %r given on command line does not exist, " +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" msgstr "" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" msgstr "" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" msgstr "" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" msgstr "" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" msgstr "" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:458 #, python-format -msgid "building [%s]: " +msgid "duplicate %s description of %s, other %s in %s" msgstr "" -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " +#: domains/rst.py:131 domains/rst.py:190 +#, python-format +msgid "%s (directive)" msgstr "" -#: builders/__init__.py:410 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "%d found" +msgid ":%s: (directive option)" msgstr "" -#: builders/__init__.py:412 -msgid "none found" +#: domains/rst.py:224 +#, python-format +msgid "%s (role)" msgstr "" -#: builders/__init__.py:419 -msgid "pickling environment" +#: domains/rst.py:234 +msgid "directive" msgstr "" -#: builders/__init__.py:426 -msgid "checking consistency" +#: domains/rst.py:235 +msgid "directive-option" msgstr "" -#: builders/__init__.py:430 -msgid "no targets are out of date." +#: domains/rst.py:236 +msgid "role" msgstr "" -#: builders/__init__.py:469 -msgid "updating environment: " +#: domains/rst.py:262 +#, python-format +msgid "duplicate description of %s %s, other instance in %s" msgstr "" -#: builders/__init__.py:494 +#: domains/changeset.py:32 #, python-format -msgid "%s added, %s changed, %s removed" +msgid "Added in version %s" msgstr "" -#: builders/__init__.py:531 +#: domains/changeset.py:33 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." +msgid "Changed in version %s" msgstr "" -#: builders/__init__.py:540 +#: domains/changeset.py:34 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." +msgid "Deprecated since version %s" msgstr "" -#: builders/__init__.py:551 +#: domains/changeset.py:35 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." +msgid "Removed in version %s" msgstr "" -#: builders/__init__.py:558 +#: domains/__init__.py:322 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." +msgid "%s %s" msgstr "" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " +#: cmd/build.py:64 +msgid "job number should be a positive number" msgstr "" -#: builders/__init__.py:713 -#, python-format -msgid "docnames to write: %s" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." msgstr "" -#: builders/__init__.py:715 -msgid "no docnames to write!" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" msgstr "" -#: builders/__init__.py:728 -msgid "preparing documents" +#: cmd/build.py:100 +msgid "path to documentation source files" msgstr "" -#: builders/__init__.py:731 -msgid "copying assets" +#: cmd/build.py:103 +msgid "path to output directory" msgstr "" -#: builders/__init__.py:883 -#, python-format -msgid "undecodable source characters, replacing with \"?\": %r" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" msgstr "" -#: builders/epub3.py:84 -#, python-format -msgid "The ePub file is in %(outdir)s." +#: cmd/build.py:114 +msgid "general options" msgstr "" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" msgstr "" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" msgstr "" -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" msgstr "" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" msgstr "" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" +#: cmd/build.py:150 +msgid "path options" msgstr "" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" msgstr "" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" msgstr "" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" msgstr "" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +#: cmd/build.py:184 +msgid "override a setting in configuration file" msgstr "" -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" msgstr "" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" msgstr "" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" msgstr "" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." +#: cmd/build.py:212 +msgid "console output options" msgstr "" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" msgstr "" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" msgstr "" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." +#: cmd/build.py:233 +msgid "no output at all, not even warnings" msgstr "" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" msgstr "" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "" - -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "" - -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." +#: cmd/build.py:252 +msgid "warning control options" msgstr "" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" msgstr "" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " +#: cmd/build.py:265 +msgid "turn warnings into errors" msgstr "" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" +#: cmd/build.py:273 +msgid "show full traceback on exception" msgstr "" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" +#: cmd/build.py:276 +msgid "run Pdb on exception" msgstr "" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" +#: cmd/build.py:282 +msgid "raise an exception on warnings" msgstr "" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" msgstr "" -#: builders/_epub_base.py:433 +#: cmd/build.py:357 #, python-format -msgid "cannot read image file %r: copying it instead" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" msgstr "" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" msgstr "" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" msgstr "" -#: builders/_epub_base.py:591 -#, python-format -msgid "unknown mimetype for %s, ignoring" +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" msgstr "" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" msgstr "" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" msgstr "" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" msgstr "" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" -#: builders/gettext.py:271 -msgid "reading templates... " +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." msgstr "" -#: builders/gettext.py:307 -msgid "writing message catalogs... " +#: cmd/quickstart.py:127 +msgid "Please enter some text." msgstr "" -#: builders/singlehtml.py:35 +#: cmd/quickstart.py:134 #, python-format -msgid "The HTML page is in %(outdir)s." +msgid "Please enter one of %s." msgstr "" -#: builders/singlehtml.py:171 -msgid "assembling single document" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." msgstr "" -#: builders/singlehtml.py:189 -msgid "writing additional files" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" -#: builders/linkcheck.py:77 +#: cmd/quickstart.py:230 #, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" +#: cmd/quickstart.py:235 +msgid "" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." msgstr "" -#: builders/linkcheck.py:548 +#: cmd/quickstart.py:242 #, python-format -msgid "Anchor '%s' not found" +msgid "Selected root path: %s" msgstr "" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." msgstr "" -#: builders/text.py:29 -#, python-format -msgid "The text files are in %(outdir)s." +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" msgstr "" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" msgstr "" -#: transforms/i18n.py:344 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." msgstr "" -#: transforms/__init__.py:144 -msgid "no translated elements!" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" msgstr "" -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:287 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" -#: transforms/__init__.py:294 -#, python-format -msgid "Footnote [%s] is not referenced." +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" msgstr "" -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." msgstr "" -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." +#: cmd/quickstart.py:301 +msgid "Project name" msgstr "" -#: _cli/__init__.py:73 -msgid "Usage:" +#: cmd/quickstart.py:303 +msgid "Author name(s)" msgstr "" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." msgstr "" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." +#: cmd/quickstart.py:316 +msgid "Project version" msgstr "" -#: _cli/__init__.py:87 -msgid "Commands:" +#: cmd/quickstart.py:318 +msgid "Project release" msgstr "" -#: _cli/__init__.py:98 -msgid "Options" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +#: cmd/quickstart.py:332 +msgid "Project language" msgstr "" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:340 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." msgstr "" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." +#: cmd/quickstart.py:344 +msgid "Source file suffix" msgstr "" -#: _cli/__init__.py:191 -msgid "Show the version and exit." +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." msgstr "" -#: _cli/__init__.py:199 -msgid "Show this message and exit." +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" msgstr "" -#: _cli/__init__.py:203 -msgid "Logging" +#: cmd/quickstart.py:368 +#, python-format +msgid "" +"Error: the master file %s has already been found in the selected root path." msgstr "" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." +#: cmd/quickstart.py:378 +msgid "" +"Please enter a new file name, or rename the existing file and press Enter" msgstr "" -#: _cli/__init__.py:225 -msgid "No output at all" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" -#: _cli/__init__.py:231 -msgid "" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." msgstr "" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." msgstr "" -#: environment/__init__.py:86 -msgid "new config" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" msgstr "" -#: environment/__init__.py:87 -msgid "config changed" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" msgstr "" -#: environment/__init__.py:88 -msgid "extensions changed" +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 +#, python-format +msgid "Creating file %s." msgstr "" -#: environment/__init__.py:253 -msgid "build environment version not current" +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 +#, python-format +msgid "File %s already exists, skipping." msgstr "" -#: environment/__init__.py:255 -msgid "source directory has changed" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." msgstr "" -#: environment/__init__.py:325 +#: cmd/quickstart.py:520 #, python-format -msgid "The configuration has changed (1 option: %r)" +msgid "" +"You should now populate your master file %s and create other documentation\n" +"source files. " msgstr "" -#: environment/__init__.py:330 -#, python-format -msgid "The configuration has changed (%d options: %s)" +#: cmd/quickstart.py:527 +msgid "" +"Use the Makefile to build the docs, like so:\n" +" make builder" msgstr "" -#: environment/__init__.py:336 +#: cmd/quickstart.py:531 #, python-format -msgid "The configuration has changed (%d options: %s, ...)" +msgid "" +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" msgstr "" -#: environment/__init__.py:379 +#: cmd/quickstart.py:538 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." msgstr "" -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" msgstr "" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" +#: cmd/quickstart.py:592 +msgid "quiet mode" msgstr "" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" +#: cmd/quickstart.py:602 +msgid "project root" msgstr "" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." +#: cmd/quickstart.py:605 +msgid "Structure options" msgstr "" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" msgstr "" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" msgstr "" -#: util/i18n.py:113 -#, python-format -msgid "writing error: %s, %s" +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." msgstr "" -#: util/i18n.py:146 -#, python-format -msgid "locale_dir %s does not exist" +#: cmd/quickstart.py:626 +msgid "Project basic options" msgstr "" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." +#: cmd/quickstart.py:628 +msgid "project name" msgstr "" -#: util/i18n.py:245 -#, python-format -msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" +#: cmd/quickstart.py:631 +msgid "author names" msgstr "" -#: util/docfields.py:103 -#, python-format -msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." +#: cmd/quickstart.py:638 +msgid "version of project" msgstr "" -#: util/nodes.py:423 -#, python-format -msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." +#: cmd/quickstart.py:645 +msgid "release of project" msgstr "" -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" +#: cmd/quickstart.py:652 +msgid "document language" msgstr "" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" +#: cmd/quickstart.py:655 +msgid "source file suffix" msgstr "" -#: util/display.py:82 -msgid "skipped" +#: cmd/quickstart.py:658 +msgid "master document name" msgstr "" -#: util/display.py:87 -msgid "failed" +#: cmd/quickstart.py:661 +msgid "use epub" msgstr "" -#: util/osutil.py:131 +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." +"Error: specified path is not a directory, or sphinx files already exist." msgstr "" -#: util/docutils.py:309 -#, python-format -msgid "unknown directive name: %s" +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." msgstr "" -#: util/docutils.py:345 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown role name: %s" +msgid "Invalid template variable: %s" msgstr "" -#: util/docutils.py:789 +#: directives/other.py:119 #, python-format -msgid "unknown node type: %r" +msgid "toctree glob pattern %r didn't match any documents" msgstr "" -#: util/fileutil.py:76 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." +msgid "toctree contains reference to excluded document %r" msgstr "" -#: util/fileutil.py:89 +#: directives/other.py:156 #, python-format -msgid "Writing evaluated template result to %s" +msgid "toctree contains reference to nonexisting document %r" msgstr "" -#: util/rst.py:73 +#: directives/other.py:169 #, python-format -msgid "default role %s not found" +msgid "duplicated entry found in toctree: %s" msgstr "" -#: util/inventory.py:147 -#, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +#: directives/other.py:203 +msgid "Section author: " msgstr "" -#: util/inventory.py:166 -#, python-format -msgid "inventory <%s> contains multiple definitions for %s" +#: directives/other.py:205 +msgid "Module author: " msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" +#: directives/other.py:207 +msgid "Code author: " msgstr "" -#: writers/manpage.py:289 writers/text.py:945 -#, python-format -msgid "[image: %s]" +#: directives/other.py:209 +msgid "Author: " msgstr "" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" +#: directives/other.py:269 +msgid ".. acks content is not a list" msgstr "" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 -#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 -#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 -#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 -#: themes/basic/genindex.html:59 themes/basic/layout.html:127 -#: writers/texinfo.py:514 -msgid "Index" +#: directives/other.py:292 +msgid ".. hlist content is not a list" msgstr "" -#: writers/latex.py:743 writers/texinfo.py:646 +#: directives/patches.py:70 msgid "" -"encountered title node not in section, topic, table, admonition or sidebar" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." msgstr "" -#: writers/texinfo.py:1217 -msgid "caption not inside a figure." +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" msgstr "" -#: writers/texinfo.py:1303 +#: directives/code.py:87 #, python-format -msgid "unimplemented node type: %r" +msgid "Invalid caption: %s" msgstr "" -#: writers/latex.py:361 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "unknown %r toplevel_sectioning for class %r" +msgid "line number spec is out of range(1-%d): %r" msgstr "" -#: builders/latex/__init__.py:224 writers/latex.py:411 +#: directives/code.py:216 #, python-format -msgid "no Babel option known for language %r" +msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: writers/latex.py:591 +#: directives/code.py:235 #, python-format -msgid "template %s not found; loading from legacy %s instead" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:707 -msgid "document title is not a single Text node" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" -#: writers/html5.py:572 writers/latex.py:1106 +#: directives/code.py:314 #, python-format -msgid "unsupported rubric heading level: %s" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "" + +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "" + +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 +#: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 +#: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 +#: themes/basic/genindex.html:3 themes/basic/genindex.html:26 +#: themes/basic/genindex.html:59 themes/basic/layout.html:127 +#: writers/texinfo.py:514 +msgid "Index" msgstr "" -#: writers/latex.py:1183 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." +"encountered title node not in section, topic, table, admonition or sidebar" msgstr "" -#: writers/latex.py:1580 -#, python-format -msgid "dimension unit %s is invalid. Ignored." +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "" + +#: writers/texinfo.py:1217 +msgid "caption not inside a figure." msgstr "" -#: writers/latex.py:1939 +#: writers/texinfo.py:1303 #, python-format -msgid "unknown index entry type %s found" +msgid "unimplemented node type: %r" msgstr "" -#: domains/math.py:128 writers/latex.py:2495 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "Invalid math_eqref_format: %r" +msgid "[image: %s]" +msgstr "" + +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" msgstr "" #: writers/html5.py:96 writers/html5.py:105 @@ -1831,6 +2342,11 @@ msgstr "" msgid "Link to this table" msgstr "" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + #: writers/html5.py:636 msgid "Link to this code" msgstr "" @@ -1847,793 +2363,477 @@ msgstr "" msgid "Could not obtain image size. :scale: option is ignored." msgstr "" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" msgstr "" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" +msgid "no Babel option known for language %r" msgstr "" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." msgstr "" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" +msgid "template %s not found; loading from legacy %s instead" msgstr "" -#: domains/javascript.py:185 -#, python-format -msgid "%s() (class)" +#: writers/latex.py:732 +msgid "document title is not a single Text node" msgstr "" -#: domains/javascript.py:187 -#, python-format -msgid "%s (global variable or constant)" +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1228 #, python-format -msgid "%s (%s attribute)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." msgstr "" -#: domains/javascript.py:273 -msgid "Arguments" +#: writers/latex.py:1615 +#, python-format +msgid "dimension unit %s is invalid. Ignored." msgstr "" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" +#: writers/latex.py:1950 +#, python-format +msgid "unknown index entry type %s found" msgstr "" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" +#: _cli/__init__.py:73 +msgid "Usage:" msgstr "" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" msgstr "" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." msgstr "" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" +#: _cli/__init__.py:87 +msgid "Commands:" msgstr "" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" +#: _cli/__init__.py:98 +msgid "Options" msgstr "" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." msgstr "" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" msgstr "" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." msgstr "" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" +#: _cli/__init__.py:191 +msgid "Show the version and exit." msgstr "" -#: domains/javascript.py:454 -#, python-format -msgid "duplicate %s description of %s, other %s in %s" +#: _cli/__init__.py:199 +msgid "Show this message and exit." msgstr "" -#: domains/changeset.py:26 -#, python-format -msgid "Added in version %s" +#: _cli/__init__.py:203 +msgid "Logging" msgstr "" -#: domains/changeset.py:27 -#, python-format -msgid "Changed in version %s" +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" msgstr "" -#: domains/changeset.py:28 -#, python-format -msgid "Deprecated since version %s" +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." msgstr "" -#: domains/changeset.py:29 -#, python-format -msgid "Removed in version %s" +#: _cli/__init__.py:225 +msgid "No output at all" msgstr "" -#: domains/rst.py:131 domains/rst.py:190 -#, python-format -msgid "%s (directive)" +#: _cli/__init__.py:231 +msgid "" msgstr "" -#: domains/rst.py:191 domains/rst.py:202 -#, python-format -msgid ":%s: (directive option)" +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" msgstr "" -#: domains/rst.py:224 -#, python-format -msgid "%s (role)" +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:234 -msgid "directive" +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" msgstr "" -#: domains/rst.py:235 -msgid "directive-option" +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:236 -msgid "role" +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" msgstr "" -#: domains/rst.py:262 -#, python-format -msgid "duplicate description of %s %s, other instance in %s" +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" msgstr "" -#: domains/citation.py:75 -#, python-format -msgid "duplicate citation %s, other instance in %s" +#: transforms/__init__.py:149 +msgid "no translated elements!" msgstr "" -#: domains/citation.py:92 +#: transforms/__init__.py:258 #, python-format -msgid "Citation [%s] is not referenced." +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" msgstr "" -#: locale/__init__.py:228 -msgid "Attention" +#: transforms/__init__.py:299 +#, python-format +msgid "Footnote [%s] is not referenced." msgstr "" -#: locale/__init__.py:229 -msgid "Caution" +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." msgstr "" -#: locale/__init__.py:230 -msgid "Danger" +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." msgstr "" -#: locale/__init__.py:231 -msgid "Error" +#: util/inventory.py:147 +#, python-format +msgid "inventory <%s> contains duplicate definitions of %s" msgstr "" -#: locale/__init__.py:232 -msgid "Hint" +#: util/inventory.py:166 +#, python-format +msgid "inventory <%s> contains multiple definitions for %s" msgstr "" -#: locale/__init__.py:233 -msgid "Important" +#: util/i18n.py:100 +#, python-format +msgid "reading error: %s, %s" msgstr "" -#: locale/__init__.py:234 -msgid "Note" +#: util/i18n.py:113 +#, python-format +msgid "writing error: %s, %s" msgstr "" -#: locale/__init__.py:235 -msgid "See also" +#: util/i18n.py:146 +#, python-format +msgid "locale_dir %s does not exist" msgstr "" -#: locale/__init__.py:236 -msgid "Tip" +#: util/i18n.py:244 +#, python-format +msgid "Invalid Babel locale: %r." msgstr "" -#: locale/__init__.py:237 -msgid "Warning" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" msgstr "" -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." msgstr "" -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" +#: util/display.py:82 +msgid "skipped" msgstr "" -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" +#: util/display.py:87 +msgid "failed" msgstr "" -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" +#: util/docutils.py:325 +#, python-format +msgid "unknown directive name: %s" msgstr "" -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" +#: util/docutils.py:361 +#, python-format +msgid "unknown role name: %s" msgstr "" -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" +#: util/docutils.py:805 +#, python-format +msgid "unknown node type: %r" msgstr "" -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." msgstr "" -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" +#: util/fileutil.py:89 +#, python-format +msgid "Writing evaluated template result to %s" msgstr "" -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" +#: util/docfields.py:103 +#, python-format +msgid "" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." msgstr "" -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" +#: util/rst.py:73 +#, python-format +msgid "default role %s not found" msgstr "" -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." +#: util/nodes.py:462 +#, python-format +msgid "" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." msgstr "" -#: cmd/quickstart.py:126 -msgid "Please enter some text." +#: util/nodes.py:523 +#, python-format +msgid "toctree contains ref to nonexisting file %r" msgstr "" -#: cmd/quickstart.py:133 +#: util/nodes.py:739 #, python-format -msgid "Please enter one of %s." +msgid "exception while evaluating only directive expression: %s" msgstr "" -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" msgstr "" -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" msgstr "" -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" msgstr "" -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" msgstr "" -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" msgstr "" -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" msgstr "" -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" msgstr "" -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" msgstr "" -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" msgstr "" -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." msgstr "" -#: cmd/quickstart.py:273 +#: transforms/post_transforms/__init__.py:88 msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." msgstr "" -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" msgstr "" -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "" - -#: cmd/quickstart.py:331 -msgid "Project language" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" msgstr "" -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." +#: _cli/util/errors.py:190 +msgid "Interrupted!" msgstr "" -#: cmd/quickstart.py:343 -msgid "Source file suffix" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" msgstr "" -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" +#: _cli/util/errors.py:203 +msgid "Recursion error!" msgstr "" -#: cmd/quickstart.py:367 -#, python-format +#: _cli/util/errors.py:207 msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" msgstr "" -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" msgstr "" -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" msgstr "" -#: cmd/quickstart.py:396 +#: _cli/util/errors.py:240 msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." +"To report this error to the developers, please open an issue at " +". Thanks!" msgstr "" -#: cmd/quickstart.py:406 +#: _cli/util/errors.py:246 msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." msgstr "" -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" msgstr "" -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." +#: themes/basic/layout.html:18 +msgid "Navigation" msgstr "" -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 +#: themes/basic/layout.html:115 #, python-format -msgid "File %s already exists, skipping." +msgid "Search within %(docstitle)s" msgstr "" -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." +#: themes/basic/layout.html:124 +msgid "About these documents" msgstr "" -#: cmd/quickstart.py:519 -#, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" msgstr "" -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" msgstr "" -#: cmd/quickstart.py:530 +#: themes/basic/layout.html:183 themes/basic/layout.html:189 #, python-format -msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "" - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "" - -#: cmd/quickstart.py:663 -msgid "Extension options" +msgid "© %(copyright_prefix)s %(copyright)s." msgstr "" -#: cmd/quickstart.py:670 +#: themes/basic/layout.html:201 #, python-format -msgid "enable %s extension" -msgstr "" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "" - -#: cmd/quickstart.py:792 -msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." +msgid "Last updated on %(last_updated)s." msgstr "" -#: cmd/quickstart.py:809 +#: themes/basic/layout.html:204 #, python-format -msgid "Invalid template variable: %s" -msgstr "" - -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "" - -#: cmd/build.py:74 msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "" - -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "" - -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "" - -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "" - -#: cmd/build.py:114 -msgid "general options" -msgstr "" - -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "" - -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "" - -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "" - -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "" - -#: cmd/build.py:150 -msgid "path options" -msgstr "" - -#: cmd/build.py:157 -msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "" - -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "" - -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "" - -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "" - -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "" - -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "" - -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" -msgstr "" - -#: cmd/build.py:212 -msgid "console output options" -msgstr "" - -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "" - -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "" - -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "" - -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "" - -#: cmd/build.py:252 -msgid "warning control options" -msgstr "" - -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "" - -#: cmd/build.py:265 -msgid "turn warnings into errors" +"Created using Sphinx " +"%(sphinx_version)s." msgstr "" -#: cmd/build.py:273 -msgid "show full traceback on exception" +#: themes/basic/relations.html:4 +msgid "Previous topic" msgstr "" -#: cmd/build.py:276 -msgid "run Pdb on exception" +#: themes/basic/relations.html:6 +msgid "previous chapter" msgstr "" -#: cmd/build.py:282 -msgid "raise an exception on warnings" +#: themes/basic/relations.html:11 +msgid "Next topic" msgstr "" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" +#: themes/basic/relations.html:13 +msgid "next chapter" msgstr "" -#: cmd/build.py:357 +#: themes/basic/genindex-single.html:26 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" - -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "" - -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "" - -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "" - -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" +msgid "Index – %(key)s" msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" msgstr "" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" +#: themes/basic/sourcelink.html:4 +msgid "This Page" msgstr "" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "" -#: themes/haiku/layout.html:16 -msgid "Contents" +#: themes/basic/searchbox.html:4 +msgid "Quick search" msgstr "" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" msgstr "" #: themes/basic/defindex.html:4 @@ -2681,7 +2881,7 @@ msgstr "" msgid "quick access to all modules" msgstr "" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "" @@ -2689,22 +2889,14 @@ msgstr "" msgid "all functions, classes, terms" msgstr "" -#: themes/basic/sourcelink.html:4 -msgid "This Page" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" msgstr "" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" +msgid "Search %(docstitle)s" msgstr "" #: themes/basic/genindex-split.html:8 @@ -2715,57 +2907,6 @@ msgstr "" msgid "can be huge" msgstr "" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "" - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2782,42 +2923,41 @@ msgstr "" msgid "search" msgstr "" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" +#: themes/haiku/layout.html:16 +msgid "Contents" msgstr "" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" "Search finished, found ${resultCount} pages matching the search query." msgstr[0] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr "" -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" msgstr "" #: themes/basic/changes/frameset.html:5 @@ -2826,6 +2966,11 @@ msgstr "" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2847,119 +2992,126 @@ msgstr "" msgid "Expand sidebar" msgstr "" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "" - -#: domains/python/_object.py:214 -msgid "Raises" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." msgstr "" #: domains/cpp/__init__.py:159 @@ -2971,92 +3123,85 @@ msgstr "" msgid "%s (C++ %s)" msgstr "" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3084,581 +3229,489 @@ msgstr "" msgid "glossary seems to be misformatted, check indentation" msgstr "" -#: domains/std/__init__.py:729 -msgid "glossary term" -msgstr "" - -#: domains/std/__init__.py:730 -msgid "grammar token" -msgstr "" - -#: domains/std/__init__.py:731 -msgid "reference label" -msgstr "" - -#: domains/std/__init__.py:733 -msgid "environment variable" -msgstr "" - -#: domains/std/__init__.py:734 -msgid "program option" -msgstr "" - -#: domains/std/__init__.py:735 -msgid "document" -msgstr "" - -#: domains/std/__init__.py:772 domains/std/__init__.py:785 -msgid "Module Index" -msgstr "" - -#: domains/std/__init__.py:857 -#, python-format -msgid "duplicate %s description of %s, other instance in %s" -msgstr "" - -#: domains/std/__init__.py:1113 -msgid "numfig is disabled. :numref: is ignored." -msgstr "" - -#: domains/std/__init__.py:1124 -#, python-format -msgid "Failed to create a cross reference. Any number is not assigned: %s" -msgstr "" - -#: domains/std/__init__.py:1138 -#, python-format -msgid "the link has no caption: %s" -msgstr "" - -#: domains/std/__init__.py:1153 -#, python-format -msgid "invalid numfig_format: %s (%r)" -msgstr "" - -#: domains/std/__init__.py:1157 -#, python-format -msgid "invalid numfig_format: %s" -msgstr "" - -#: domains/std/__init__.py:1453 -#, python-format -msgid "undefined label: %r" -msgstr "" - -#: domains/std/__init__.py:1456 -#, python-format -msgid "Failed to create a cross reference. A title or caption not found: %r" -msgstr "" - -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "" - -#: environment/adapters/toctree.py:367 -#, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:126 -#, python-format -msgid "image file %s not readable: %s" -msgstr "" - -#: environment/collectors/asset.py:163 -#, python-format -msgid "download file not readable: %s" -msgstr "" - -#: environment/collectors/toctree.py:259 -#, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" +#: domains/std/__init__.py:729 +msgid "glossary term" msgstr "" -#: _cli/util/errors.py:190 -msgid "Interrupted!" +#: domains/std/__init__.py:730 +msgid "grammar token" msgstr "" -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" +#: domains/std/__init__.py:731 +msgid "reference label" msgstr "" -#: _cli/util/errors.py:200 -msgid "Encoding error!" +#: domains/std/__init__.py:733 +msgid "environment variable" msgstr "" -#: _cli/util/errors.py:203 -msgid "Recursion error!" +#: domains/std/__init__.py:734 +msgid "program option" msgstr "" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" +#: domains/std/__init__.py:735 +msgid "document" msgstr "" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" +#: domains/std/__init__.py:772 domains/std/__init__.py:785 +msgid "Module Index" msgstr "" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" +#: domains/std/__init__.py:857 +#, python-format +msgid "duplicate %s description of %s, other instance in %s" msgstr "" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" +#: domains/std/__init__.py:1113 +msgid "numfig is disabled. :numref: is ignored." msgstr "" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." +#: domains/std/__init__.py:1124 +#, python-format +msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." +#: domains/std/__init__.py:1138 +#, python-format +msgid "the link has no caption: %s" msgstr "" -#: transforms/post_transforms/__init__.py:237 +#: domains/std/__init__.py:1153 #, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgid "invalid numfig_format: %s (%r)" msgstr "" -#: transforms/post_transforms/__init__.py:299 +#: domains/std/__init__.py:1157 #, python-format -msgid "%s:%s reference target not found: %s" +msgid "invalid numfig_format: %s" msgstr "" -#: transforms/post_transforms/__init__.py:305 +#: domains/std/__init__.py:1453 #, python-format -msgid "%r reference target not found: %s" +msgid "undefined label: %r" msgstr "" -#: transforms/post_transforms/images.py:79 +#: domains/std/__init__.py:1456 #, python-format -msgid "Could not fetch remote image: %s [%s]" +msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "" -#: transforms/post_transforms/images.py:96 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "Could not fetch remote image: %s [%d]" +msgid "invalid value set (missing closing brace): %s" msgstr "" -#: transforms/post_transforms/images.py:143 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "Unknown image format: %s..." +msgid "invalid value set (missing opening brace): %s" msgstr "" -#: builders/html/__init__.py:113 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "The HTML pages are in %(outdir)s." +msgid "malformed string literal (missing closing quote): %s" msgstr "" -#: builders/html/__init__.py:348 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "Failed to read build info file: %r" +msgid "malformed string literal (missing opening quote): %s" msgstr "" -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" +#: ext/napoleon/docstring.py:902 +msgid "Example" msgstr "" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/napoleon/docstring.py:903 +msgid "Examples" msgstr "" -#: builders/html/__init__.py:383 -#, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" +#: ext/napoleon/docstring.py:962 +msgid "Notes" msgstr "" -#: builders/html/__init__.py:560 -#, python-format -msgid "Logo of %s" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" msgstr "" -#: builders/html/__init__.py:598 -msgid "previous" +#: ext/napoleon/docstring.py:1011 +msgid "References" msgstr "" -#: builders/html/__init__.py:696 -msgid "generating indices" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" msgstr "" -#: builders/html/__init__.py:711 -msgid "writing additional pages" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" msgstr "" -#: builders/html/__init__.py:794 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" - -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " +msgid "A mocked object is detected: %r" msgstr "" -#: builders/html/__init__.py:818 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "cannot copy downloadable file %r: %s" +msgid "alias of %s" msgstr "" -#: builders/html/__init__.py:864 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" +msgid "Bases: %s" msgstr "" -#: builders/html/__init__.py:882 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" +msgid "invalid value for member-order option: %s" msgstr "" -#: builders/html/__init__.py:917 -msgid "copying static files" +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 +#, python-format +msgid "invalid value for class-doc-from option: %s" msgstr "" -#: builders/html/__init__.py:934 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "cannot copy static file %r" +msgid "invalid signature for auto%s (%r)" msgstr "" -#: builders/html/__init__.py:939 -msgid "copying extra files" +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 +#, python-format +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" msgstr "" -#: builders/html/__init__.py:949 +#: ext/autodoc/_names.py:89 #, python-format -msgid "cannot copy extra file %r" +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:955 +#: ext/autodoc/_names.py:93 #, python-format -msgid "Failed to write build info file: %r" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:1005 -msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" msgstr "" -#: builders/html/__init__.py:1052 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:1216 +#: ext/apidoc/_generate.py:69 #, python-format +msgid "Would create file %s." +msgstr "" + +#: ext/apidoc/_cli.py:28 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." msgstr "" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "" + +#: ext/apidoc/_cli.py:50 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" +"fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." msgstr "" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" msgstr "" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" msgstr "" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" msgstr "" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" msgstr "" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" msgstr "" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" +#: ext/apidoc/_cli.py:135 +msgid "" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" msgstr "" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" msgstr "" -#: builders/html/__init__.py:1420 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" msgstr "" -#: builders/html/__init__.py:1433 +#: ext/apidoc/_cli.py:160 msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." msgstr "" -#: builders/html/__init__.py:1449 -#, python-format -msgid "%s %s documentation" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" msgstr "" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" msgstr "" -#: builders/latex/__init__.py:118 -#, python-format -msgid "The LaTeX files are in %(outdir)s." +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" msgstr "" -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" msgstr "" -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" msgstr "" -#: builders/latex/__init__.py:170 -#, python-format -msgid "\"latex_documents\" config value references unknown document %s" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "" + +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "" + +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" msgstr "" -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" +#: ext/apidoc/_cli.py:240 +#, python-format +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" +#: ext/apidoc/_cli.py:291 +#, python-format +msgid "%s is not a directory." msgstr "" -#: builders/latex/__init__.py:465 -msgid "copying additional files" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:102 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:110 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'path' must be a string" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "No footnote was found for given reference node %r" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "%r doesn't have \"theme\" setting" +msgid "apidoc_modules item %i must have a 'destination' key" msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "%r doesn't have \"%s\" setting" +msgid "apidoc_modules item %i 'destination' must be a string" msgstr "" -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" +#: ext/apidoc/_extension.py:147 +#, python-format +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" +#: ext/apidoc/_extension.py:157 +#, python-format +msgid "apidoc_modules item %i cannot create destination directory: %s" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" +#: ext/apidoc/_extension.py:178 +#, python-format +msgid "apidoc_modules item %i '%s' must be an int" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" +#: ext/apidoc/_extension.py:192 +#, python-format +msgid "apidoc_modules item %i '%s' must be a boolean" msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" +msgid "apidoc_modules item %i '%s' must contain strings" msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" +msgid "[autosummary] generating autosummary for: %s" msgstr "" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" +msgid "[autosummary] writing to %s" msgstr "" -#: ext/napoleon/docstring.py:895 -msgid "Example" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" msgstr "" -#: ext/napoleon/docstring.py:896 -msgid "Examples" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" msgstr "" -#: ext/napoleon/docstring.py:956 -msgid "Notes" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" msgstr "" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" msgstr "" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1005 -msgid "References" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" msgstr "" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" msgstr "" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3666,548 +3719,585 @@ msgid "" "%s" msgstr "" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." msgstr "" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:135 #, python-format -msgid "default suffix for files (default: %(default)s)" +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." msgstr "" -#: ext/autosummary/generate.py:882 -#, python-format -msgid "custom template directory (default: %(default)s)" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." msgstr "" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_load.py:297 #, python-format -msgid "document imported members (default: %(default)s)" +msgid "loading intersphinx inventory '%s' from %s ..." msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "" + +#: ext/intersphinx/_load.py:332 #, python-format msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" +"failed to reach any of the inventories with the following issues:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_load.py:411 +#, python-format +msgid "intersphinx inventory has moved: %s -> %s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "Failed to remove %s: %s" +msgid "(in %s %s)" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." +#: ext/intersphinx/_resolve.py:55 +#, python-format +msgid "(in %s)" msgstr "" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" +#: ext/intersphinx/_resolve.py:122 +#, python-format +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" msgstr "" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" msgstr "" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" msgstr "" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" msgstr "" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" + +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" msgstr "" -#: ext/apidoc/_cli.py:135 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" msgstr "" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" msgstr "" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" msgstr "" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" msgstr "" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" msgstr "" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" +#: builders/html/__init__.py:114 +#, python-format +msgid "The HTML pages are in %(outdir)s." msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" +#: builders/html/__init__.py:337 +#, python-format +msgid "Failed to read build info file: %r" msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_cli.py:240 -#, python-format -msgid "enable %s extension, used when --full is given" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:372 #, python-format -msgid "%s is not a directory." +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:496 +msgid "index" msgstr "" -#: ext/apidoc/_extension.py:102 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i must be a dict" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:110 -#, python-format -msgid "apidoc_modules item %i must have a 'path' key" +#: builders/html/__init__.py:578 +msgid "next" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" +#: builders/html/__init__.py:587 +msgid "previous" msgstr "" -#: ext/apidoc/_extension.py:121 -#, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +#: builders/html/__init__.py:685 +msgid "generating indices" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" +#: builders/html/__init__.py:700 +msgid "writing additional pages" msgstr "" -#: ext/apidoc/_extension.py:140 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i 'destination' must be a string" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " msgstr "" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy downloadable file %r: %s" msgstr "" -#: ext/apidoc/_extension.py:178 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i '%s' must be an int" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" +msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:210 -#, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +#: builders/html/__init__.py:906 +msgid "copying static files" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" +msgid "cannot copy static file %r" msgstr "" -#: ext/apidoc/_extension.py:256 -#, python-format -msgid "apidoc_modules item %i '%s' must contain strings" +#: builders/html/__init__.py:928 +msgid "copying extra files" msgstr "" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." +msgid "cannot copy extra file %r" msgstr "" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" +msgid "Failed to write build info file: %r" msgstr "" -#: ext/intersphinx/_resolve.py:51 -#, python-format -msgid "(in %s)" +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." msgstr "" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1038 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" +msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory for external cross-reference not found: %r" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:392 +#: builders/html/__init__.py:1225 #, python-format -msgid "invalid external cross-reference suffix: %r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" msgstr "" -#: ext/intersphinx/_resolve.py:403 -#, python-format -msgid "domain for external cross-reference not found: %r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" msgstr "" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1266 #, python-format -msgid "external %s:%s reference target not found: %s" +msgid "dumping search index in %s" msgstr "" -#: ext/intersphinx/_load.py:60 +#: builders/html/__init__.py:1313 #, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." +msgid "invalid js_file: %r, ignored" msgstr "" -#: ext/intersphinx/_load.py:71 -#, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." +msgid "Unknown math_renderer %r is given." msgstr "" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." +msgid "html_extra_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." +msgid "html_extra_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." +msgid "html_static_path entry %r is placed inside outdir" msgstr "" -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." +#: builders/html/__init__.py:1390 +#, python-format +msgid "html_static_path entry %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgid "logo file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" msgstr "" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" msgstr "" -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" +#: builders/html/__init__.py:1454 +#, python-format +msgid "%s %s documentation" msgstr "" -#: ext/intersphinx/_load.py:361 +#: builders/latex/theming.py:87 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" +msgid "%r doesn't have \"theme\" setting" msgstr "" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for member-order option: %s" +msgid "%r doesn't have \"%s\" setting" msgstr "" -#: ext/autodoc/__init__.py:158 -#, python-format -msgid "invalid value for class-doc-from option: %s" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" msgstr "" -#: ext/autodoc/__init__.py:460 +#: builders/latex/transforms.py:121 #, python-format -msgid "invalid signature for auto%s (%r)" +msgid "Failed to get a docname for source %r!" msgstr "" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:487 #, python-format -msgid "error while formatting arguments for %s: %s" +msgid "No footnote was found for given reference node %r" msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/__init__.py:115 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" +msgid "The LaTeX files are in %(outdir)s." msgstr "" -#: ext/autodoc/__init__.py:1021 -#, python-format +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." msgstr "" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" +msgid "\"latex_documents\" config value references unknown document %s" msgstr "" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" msgstr "" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" msgstr "" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" +msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" +msgid "image file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" +msgid "image file %s not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" +msgid "download file not readable: %s" msgstr "" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" +msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" msgstr "" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" +msgid "toctree contains reference to non-included document %r" msgstr "" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." +msgid "toctree contains reference to non-existing document %r" msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" +msgid "see %s" msgstr "" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" +msgid "see also %s" msgstr "" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" +msgid "unknown index entry type %r" msgstr "" diff --git a/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo b/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo index 7ec2653d748..dbc534fcfc4 100644 Binary files a/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo and b/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo differ diff --git a/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po index dc9c8eb600c..7e3fad59e35 100644 --- a/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po +++ b/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po @@ -11,13 +11,14 @@ # Liang-Bo Wang , 2016 # Liang-Bo Wang , 2016-2017 # Steven Hsu , 2021-2024 +# Tony Ng, 2025 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2025-02-18 00:33+0000\n" +"POT-Creation-Date: 2025-12-01 16:14+0000\n" "PO-Revision-Date: 2013-04-02 08:44+0000\n" -"Last-Translator: Steven Hsu , 2021-2024\n" +"Last-Translator: Tony Ng, 2025\n" "Language-Team: Chinese (Taiwan) (http://app.transifex.com/sphinx-doc/sphinx-1/language/zh_TW/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -26,6 +27,127 @@ msgstr "" "Language: zh_TW\n" "Plural-Forms: nplurals=1; plural=0;\n" +#: roles.py:205 +#, python-format +msgid "Common Vulnerabilities and Exposures; CVE %s" +msgstr "" + +#: roles.py:228 +#, python-format +msgid "invalid CVE number %s" +msgstr "" + +#: roles.py:250 +#, python-format +msgid "Common Weakness Enumeration; CWE %s" +msgstr "" + +#: roles.py:273 +#, python-format +msgid "invalid CWE number %s" +msgstr "" + +#: roles.py:293 +#, python-format +msgid "Python Enhancement Proposals; PEP %s" +msgstr "Python Enhancement Proposals; PEP %s" + +#: roles.py:316 +#, python-format +msgid "invalid PEP number %s" +msgstr "無效的 PEP 號碼 %s" + +#: roles.py:354 +#, python-format +msgid "invalid RFC number %s" +msgstr "無效的 RFC 號碼 %s" + +#: theming.py:117 +#, python-format +msgid "" +"Theme configuration sections other than [theme] and [options] are not " +"supported (tried to get a value from %r)." +msgstr "" + +#: theming.py:122 +#, python-format +msgid "setting %s.%s occurs in none of the searched theme configs" +msgstr "設定 %s。%s 不在已被搜尋的主題組態中出現" + +#: theming.py:137 +#, python-format +msgid "unsupported theme option %r given" +msgstr "未支援的主題選項 %r 被給予" + +#: theming.py:218 +#, python-format +msgid "file %r on theme path is not a valid zipfile or contains no theme" +msgstr "主題路徑中的檔案 %r 不是有效的 zipfile 或未包含主題" + +#: theming.py:238 +#, python-format +msgid "no theme named %r found (missing theme.toml?)" +msgstr "找不到名稱為 %r 的主題(遺失 theme.toml?)" + +#: theming.py:278 +#, python-format +msgid "The %r theme has circular inheritance" +msgstr "%r 主題有循環繼承" + +#: theming.py:286 +#, python-format +msgid "" +"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " +"are: %s" +msgstr "%r 主題是從 %r 繼承的,而它不是一個已載入的主題。已載入的主題是:%s" + +#: theming.py:292 +#, python-format +msgid "The %r theme has too many ancestors" +msgstr "%r 主題有太多上代 (ancestor)" + +#: theming.py:320 +#, python-format +msgid "no theme configuration file found in %r" +msgstr "在 %r 中找不到主題的組態檔" + +#: theming.py:345 theming.py:398 +#, python-format +msgid "theme %r doesn't have the \"theme\" table" +msgstr "主題 %r 內沒有 \"theme\" 表格" + +#: theming.py:349 +#, python-format +msgid "The %r theme \"[theme]\" table is not a table" +msgstr "%r 主題的 \"[theme]\" 表格不是一個表格" + +#: theming.py:353 theming.py:401 +#, python-format +msgid "The %r theme must define the \"theme.inherit\" setting" +msgstr "%r 主題必須定義 \"theme.inherit\" 的設定" + +#: theming.py:357 +#, python-format +msgid "The %r theme \"[options]\" table is not a table" +msgstr "%r 主題的 \"[options]\" 表格不是一個表格" + +#: theming.py:376 +#, python-format +msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" +msgstr "\"theme.pygments_style\" 設定必須是一個表格。提示:\"%s\"" + +#: project.py:72 +#, python-format +msgid "" +"multiple files found for the document \"%s\": %s\n" +"Use %r for the build." +msgstr "" + +#: project.py:87 +#, python-format +msgid "Ignored unreadable document %r." +msgstr "已略過無法讀取的文件 %r 。" + #: extension.py:58 #, python-format msgid "" @@ -40,127 +162,154 @@ msgid "" "cannot be built with the loaded version (%s)." msgstr "這個專案需要擴充套件 %s 的最低版本是 %s,所以無法以載入的版本 (%s) 被建立。" -#: application.py:212 +#: highlighting.py:170 +#, python-format +msgid "Pygments lexer name %r is not known" +msgstr "Pygments lexer 名稱 %r 不是已知的" + +#: highlighting.py:209 +#, python-format +msgid "" +"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " +"Retrying in relaxed mode." +msgstr "將 literal_block %r lex 為 \"%s\" 時,在 token %r 造成錯誤。正在以 relaxed 模式重試中。" + +#: events.py:92 +#, python-format +msgid "Event %r already present" +msgstr "事件 %r 已經存在" + +#: events.py:386 +#, python-format +msgid "Unknown event name: %s" +msgstr "未知的事件名稱:%s" + +#: events.py:451 +#, python-format +msgid "Handler %r for event %r threw an exception" +msgstr "對於事件 %r 的 handler %r 拋出了一個例外" + +#: application.py:218 #, python-format msgid "Cannot find source directory (%s)" msgstr "找不到來源資料夾 (%s)" -#: application.py:217 +#: application.py:223 #, python-format msgid "Output directory (%s) is not a directory" msgstr "輸出資料夾 (%s) 不是一個資料夾" -#: application.py:222 +#: application.py:228 msgid "Source directory and destination directory cannot be identical" msgstr "來源資料夾與目的資料夾不能為相同" -#: application.py:252 +#: application.py:258 #, python-format msgid "Running Sphinx v%s" msgstr "正在執行 Sphinx v%s 版本" -#: application.py:278 +#: application.py:286 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "本專案需要 Sphinx v%s 版或以上,故無法以現版本編譯。" -#: application.py:297 +#: application.py:305 msgid "making output directory" msgstr "正在建立輸出目錄" -#: application.py:302 registry.py:538 +#: application.py:310 registry.py:540 #, python-format msgid "while setting up extension %s:" msgstr "正在設置擴充套件 %s 時:" -#: application.py:309 +#: application.py:317 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "目前在 conf.py 裡定義的 'setup' 並非一個 Python 的可呼叫物件。請將其定義修改為一個可呼叫的函式。若要使 conf.py 以 Sphinx 擴充套件的方式運作,這個修改是必須的。" -#: application.py:346 +#: application.py:360 #, python-format msgid "loading translations [%s]... " msgstr "正在載入翻譯 [%s]..." -#: application.py:370 util/display.py:89 +#: application.py:384 util/display.py:89 msgid "done" msgstr "完成" -#: application.py:372 +#: application.py:386 msgid "not available for built-in messages" msgstr "不是有效的內建訊息" -#: application.py:386 +#: application.py:400 msgid "loading pickled environment" msgstr "正在載入已 pickle 的環境" -#: application.py:394 +#: application.py:408 #, python-format msgid "failed: %s" msgstr "失敗:%s" -#: application.py:407 +#: application.py:423 msgid "No builder selected, using default: html" msgstr "沒有指定 builder,使用預設:html" -#: application.py:439 +#: application.py:455 msgid "build finished with problems." msgstr "" -#: application.py:441 +#: application.py:457 msgid "build succeeded." msgstr "" -#: application.py:446 +#: application.py:462 msgid "" "build finished with problems, 1 warning (with warnings treated as errors)." msgstr "" -#: application.py:450 +#: application.py:466 msgid "build finished with problems, 1 warning." msgstr "" -#: application.py:452 +#: application.py:468 msgid "build succeeded, 1 warning." msgstr "" -#: application.py:458 +#: application.py:474 #, python-format msgid "" "build finished with problems, %s warnings (with warnings treated as errors)." msgstr "" -#: application.py:462 +#: application.py:478 #, python-format msgid "build finished with problems, %s warnings." msgstr "" -#: application.py:464 +#: application.py:480 #, python-format msgid "build succeeded, %s warnings." msgstr "" -#: application.py:1026 +#: application.py:1020 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "node class %r 已經被註冊,它的訪客將會被覆寫" -#: application.py:1119 +#: application.py:1113 #, python-format msgid "directive %r is already registered and will not be overridden" msgstr "" -#: application.py:1145 application.py:1173 +#: application.py:1139 application.py:1167 #, python-format msgid "role %r is already registered and will not be overridden" msgstr "" -#: application.py:1770 +#: application.py:1766 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " @@ -168,12 +317,12 @@ msgid "" "explicit" msgstr "%s 擴充套件並未宣告平行讀取是否安全,假設為否 - 請尋求擴充套件作者以檢查並明確表示" -#: application.py:1775 +#: application.py:1771 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "%s 擴充套件對於平行讀取是不安全的" -#: application.py:1779 +#: application.py:1775 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " @@ -181,82 +330,214 @@ msgid "" "explicit" msgstr "%s 擴充套件並未宣告平行寫入是否安全,假設為否 - 請尋求擴充套件作者以檢查並明確表示" -#: application.py:1784 +#: application.py:1780 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "%s 擴充套件對於平行寫入是不安全的" -#: application.py:1792 application.py:1796 +#: application.py:1788 application.py:1792 #, python-format msgid "doing serial %s" msgstr "執行串列 %s" -#: config.py:355 +#: registry.py:162 #, python-format -msgid "config directory doesn't contain a conf.py file (%s)" -msgstr "config 資料夾沒有包含 conf.py 檔案 (%s)" +msgid "Builder class %s has no \"name\" attribute" +msgstr "Builder class %s 沒有 \"name\" 屬性" + +#: registry.py:166 +#, python-format +msgid "Builder %r already exists (in module %s)" +msgstr "Builder %r 已存在(於 %s 模組)" + +#: registry.py:182 +#, python-format +msgid "Builder name %s not registered or available through entry point" +msgstr "Builder 名稱 %s 未註冊或無法從 entry point 取得" + +#: registry.py:192 +#, python-format +msgid "Builder name %s not registered" +msgstr "Builder 名稱 %s 未註冊" + +#: registry.py:199 +#, python-format +msgid "domain %s already registered" +msgstr "domain %s 已註冊" + +#: registry.py:223 registry.py:244 registry.py:257 +#, python-format +msgid "domain %s not yet registered" +msgstr "domain %s 尚未被註冊" + +#: registry.py:230 +#, python-format +msgid "The %r directive is already registered to domain %s" +msgstr "%r 指令已註冊給 domain %s" + +#: registry.py:248 +#, python-format +msgid "The %r role is already registered to domain %s" +msgstr "%r 角色已註冊給 domain %s" + +#: registry.py:261 +#, python-format +msgid "The %r index is already registered to domain %s" +msgstr "%r 索引已註冊給 domain %s" + +#: registry.py:308 +#, python-format +msgid "The %r object_type is already registered" +msgstr "%r object_type 已註冊" + +#: registry.py:339 +#, python-format +msgid "The %r crossref_type is already registered" +msgstr "%r crossref_type 已註冊" + +#: registry.py:348 +#, python-format +msgid "source_suffix %r is already registered" +msgstr "source_suffix %r 已註冊" + +#: registry.py:358 +#, python-format +msgid "source_parser for %r is already registered" +msgstr "對於 %r 的 source_parser 已註冊" + +#: registry.py:367 +#, python-format +msgid "Source parser for %s not registered" +msgstr "對於 %s 的源碼剖析器未註冊" + +#: registry.py:388 +#, python-format +msgid "Translator for %r already exists" +msgstr "對於 %r 的翻譯器已經存在" + +#: registry.py:405 +#, python-format +msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" +msgstr "對於 add_node() 的 kwargs 必須是一個 (visit, depart) 函式值組:%r=%r" + +#: registry.py:498 +#, python-format +msgid "enumerable_node %r already registered" +msgstr "enumerable_node %r 已註冊" + +#: registry.py:514 +#, python-format +msgid "math renderer %s is already registered" +msgstr "數學描繪器 %s 已註冊" -#: config.py:366 +#: registry.py:531 +#, python-format msgid "" -"Invalid configuration value found: 'language = None'. Update your " -"configuration to a valid language code. Falling back to 'en' (English)." -msgstr "找到無效的組態值: 'language = None' 。請以一個有效的語言碼更新您的配置。跳回 'en' (英語)。" +"the extension %r was already merged with Sphinx since version %s; this " +"extension is ignored." +msgstr "擴充套件 %r 已被併入 %s 版以上的 Sphinx:此擴充套件已略過。" + +#: registry.py:545 +msgid "Original exception:\n" +msgstr "原始的例外:\n" + +#: registry.py:547 +#, python-format +msgid "Could not import extension %s" +msgstr "無法引入擴充套件 %s" + +#: registry.py:554 +#, python-format +msgid "" +"extension %r has no setup() function; is it really a Sphinx extension " +"module?" +msgstr "擴充套件 %r 沒有 setup() 函式;它真的是 Sphinx 擴充套件模組嗎?" + +#: registry.py:567 +#, python-format +msgid "" +"The %s extension used by this project needs at least Sphinx v%s; it " +"therefore cannot be built with this version." +msgstr "此專案使用的 %s 擴充套件需要 Sphinx v%s 以上的版本;所以它無法以此版本被建立。" + +#: registry.py:579 +#, python-format +msgid "" +"extension %r returned an unsupported object from its setup() function; it " +"should return None or a metadata dictionary" +msgstr "擴充套件 %r 從它的 setup() 函式回傳一個未支援物件;它應該回傳 None 或一個元數據資料夾" + +#: registry.py:605 +#, python-format +msgid "`None` is not a valid filetype for %r." +msgstr "" + +#: config.py:351 +#, python-format +msgid "config directory doesn't contain a conf.py file (%s)" +msgstr "config 資料夾沒有包含 conf.py 檔案 (%s)" -#: config.py:394 +#: config.py:374 #, python-format msgid "'%s' must be '0' or '1', got '%s'" msgstr "" -#: config.py:399 +#: config.py:379 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "無法覆寫資料夾組態設定 %r,忽略中(使用 %r 來設定個別元素)" -#: config.py:411 +#: config.py:391 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "無效的數字 %r 於組態值 %r,忽略中" -#: config.py:419 +#: config.py:399 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "無法以未支援的型別覆寫組態設定 %r,忽略中" -#: config.py:442 +#: config.py:422 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "覆寫未知的組態值 %r,忽略中" -#: config.py:496 +#: config.py:476 #, python-format msgid "No such config value: %r" msgstr "缺少此組態值:%r" -#: config.py:524 +#: config.py:504 #, python-format msgid "Config value %r already present" msgstr "組態值 %r 已經存在" -#: config.py:561 +#: config.py:541 #, python-format msgid "" "cannot cache unpickleable configuration value: %r (because it contains a " "function, class, or module object)" msgstr "" -#: config.py:603 +#: config.py:577 +msgid "" +"Invalid configuration value found: 'language = None'. Update your " +"configuration to a valid language code. Falling back to 'en' (English)." +msgstr "找到無效的組態值: 'language = None' 。請以一個有效的語言碼更新您的配置。跳回 'en' (英語)。" + +#: config.py:599 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "在您的組態檔中有一個語法錯誤:%s\n" -#: config.py:607 +#: config.py:603 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "組態檔(或它 import 的其中一個模組)呼叫了 sys.exit()" -#: config.py:615 +#: config.py:611 #, python-format msgid "" "There is a programmable error in your configuration file:\n" @@ -264,525 +545,710 @@ msgid "" "%s" msgstr "在您的組態檔中有一個程式化錯誤:\n\n%s" -#: config.py:637 +#: config.py:633 #, python-format msgid "Failed to convert %r to a frozenset" msgstr "" -#: config.py:655 config.py:663 +#: config.py:651 config.py:659 #, python-format msgid "Converting `source_suffix = %r` to `source_suffix = %r`." msgstr "" -#: config.py:669 +#: config.py:665 #, python-format msgid "" "The config value `source_suffix' expects a dictionary, a string, or a list " "of strings. Got `%r' instead (type %s)." msgstr "" -#: config.py:690 +#: config.py:686 #, python-format msgid "Section %s" msgstr "章節 %s" -#: config.py:691 +#: config.py:687 #, python-format msgid "Fig. %s" msgstr "圖 %s" -#: config.py:692 +#: config.py:688 #, python-format msgid "Table %s" msgstr "表格 %s" -#: config.py:693 +#: config.py:689 #, python-format msgid "Listing %s" msgstr "列表 %s" -#: config.py:802 +#: config.py:798 #, python-brace-format msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "組態值 `{name}` 必須是 {candidates} 的其中之一,但 `{current}` 被給予。" -#: config.py:833 +#: config.py:829 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "組態值 `{name}' 有 `{current.__name__}' 型別;預期 {permitted} 。" -#: config.py:850 +#: config.py:846 #, python-brace-format msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "組態值 `{name}' 有 `{current.__name__}' 型別;預設為 `{default.__name__}' 。" -#: config.py:862 +#: config.py:858 #, python-format msgid "primary_domain %r not found, ignored." msgstr "找不到 primary_domain %r,已略過。" -#: config.py:882 +#: config.py:878 msgid "" "Sphinx now uses \"index\" as the master document by default. To keep pre-2.0" " behaviour, set \"master_doc = 'contents'\"." msgstr "" -#: highlighting.py:170 -#, python-format -msgid "Pygments lexer name %r is not known" -msgstr "Pygments lexer 名稱 %r 不是已知的" - -#: highlighting.py:209 -#, python-format -msgid "" -"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. " -"Retrying in relaxed mode." -msgstr "將 literal_block %r lex 為 \"%s\" 時,在 token %r 造成錯誤。正在以 relaxed 模式重試中。" - -#: theming.py:115 -#, python-format +#: config.py:892 msgid "" -"Theme configuration sections other than [theme] and [options] are not " -"supported (tried to get a value from %r)." +"Support for source encodings other than UTF-8 is deprecated and will be " +"removed in Sphinx 10. Please comment at https://github.com/sphinx-" +"doc/sphinx/issues/13665 if this causes a problem." msgstr "" -#: theming.py:120 -#, python-format -msgid "setting %s.%s occurs in none of the searched theme configs" -msgstr "設定 %s。%s 不在已被搜尋的主題組態中出現" +#: environment/__init__.py:89 +msgid "new config" +msgstr "新的組態" -#: theming.py:135 -#, python-format -msgid "unsupported theme option %r given" -msgstr "未支援的主題選項 %r 被給予" +#: environment/__init__.py:90 +msgid "config changed" +msgstr "組態已變更" -#: theming.py:208 -#, python-format -msgid "file %r on theme path is not a valid zipfile or contains no theme" -msgstr "主題路徑中的檔案 %r 不是有效的 zipfile 或未包含主題" +#: environment/__init__.py:91 +msgid "extensions changed" +msgstr "擴充套件已變更" + +#: environment/__init__.py:261 +msgid "build environment version not current" +msgstr "建立環境的版本不是目前的" + +#: environment/__init__.py:263 +msgid "source directory has changed" +msgstr "來源資料夾已變更" -#: theming.py:228 +#: environment/__init__.py:350 #, python-format -msgid "no theme named %r found (missing theme.toml?)" -msgstr "找不到名稱為 %r 的主題(遺失 theme.toml?)" +msgid "The configuration has changed (1 option: %r)" +msgstr "" -#: theming.py:268 +#: environment/__init__.py:355 #, python-format -msgid "The %r theme has circular inheritance" -msgstr "%r 主題有循環繼承" +msgid "The configuration has changed (%d options: %s)" +msgstr "" -#: theming.py:276 +#: environment/__init__.py:361 #, python-format +msgid "The configuration has changed (%d options: %s, ...)" +msgstr "" + +#: environment/__init__.py:404 msgid "" -"The %r theme inherits from %r, which is not a loaded theme. Loaded themes " -"are: %s" -msgstr "%r 主題是從 %r 繼承的,而它不是一個已載入的主題。已載入的主題是:%s" +"This environment is incompatible with the selected builder, please choose " +"another doctree directory." +msgstr "這個環境與所選的 builder 不相容,請選擇另一個 doctree 資料夾。" -#: theming.py:282 +#: environment/__init__.py:518 #, python-format -msgid "The %r theme has too many ancestors" -msgstr "%r 主題有太多上代 (ancestor)" +msgid "Failed to scan documents in %s: %r" +msgstr "無法掃描 %s 中的文件: %r" -#: theming.py:310 +#: environment/__init__.py:645 ext/intersphinx/_resolve.py:238 #, python-format -msgid "no theme configuration file found in %r" -msgstr "在 %r 中找不到主題的組態檔" +msgid "Domain %r is not registered" +msgstr "Domain %r 未被註冊" -#: theming.py:335 theming.py:388 -#, python-format -msgid "theme %r doesn't have the \"theme\" table" -msgstr "主題 %r 內沒有 \"theme\" 表格" +#: environment/__init__.py:811 +msgid "document isn't included in any toctree" +msgstr "文件未被包含於任何 toctree" -#: theming.py:339 -#, python-format -msgid "The %r theme \"[theme]\" table is not a table" -msgstr "%r 主題的 \"[theme]\" 表格不是一個表格" +#: environment/__init__.py:922 +msgid "self referenced toctree found. Ignored." +msgstr "找到自我參照的 toctree。已略過。" -#: theming.py:343 theming.py:391 +#: environment/__init__.py:952 #, python-format -msgid "The %r theme must define the \"theme.inherit\" setting" -msgstr "%r 主題必須定義 \"theme.inherit\" 的設定" +msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" +msgstr "" -#: theming.py:347 -#, python-format -msgid "The %r theme \"[options]\" table is not a table" -msgstr "%r 主題的 \"[options]\" 表格不是一個表格" +#: locale/__init__.py:229 +msgid "Attention" +msgstr "注意" -#: theming.py:366 -#, python-format -msgid "The \"theme.pygments_style\" setting must be a table. Hint: \"%s\"" -msgstr "\"theme.pygments_style\" 設定必須是一個表格。提示:\"%s\"" +#: locale/__init__.py:230 +msgid "Caution" +msgstr "警示" -#: events.py:77 -#, python-format -msgid "Event %r already present" -msgstr "事件 %r 已經存在" +#: locale/__init__.py:231 +msgid "Danger" +msgstr "危險" -#: events.py:370 -#, python-format -msgid "Unknown event name: %s" -msgstr "未知的事件名稱:%s" +#: locale/__init__.py:232 +msgid "Error" +msgstr "錯誤" -#: events.py:416 -#, python-format -msgid "Handler %r for event %r threw an exception" -msgstr "對於事件 %r 的 handler %r 拋出了一個例外" +#: locale/__init__.py:233 +msgid "Hint" +msgstr "提示" -#: project.py:72 +#: locale/__init__.py:234 +msgid "Important" +msgstr "重要" + +#: locale/__init__.py:235 +msgid "Note" +msgstr "備註" + +#: locale/__init__.py:236 +msgid "See also" +msgstr "請參閱" + +#: locale/__init__.py:237 +msgid "Tip" +msgstr "小訣竅" + +#: locale/__init__.py:238 +msgid "Warning" +msgstr "警告" + +#: builders/texinfo.py:41 #, python-format +msgid "The Texinfo files are in %(outdir)s." +msgstr "Texinfo 檔案在 %(outdir)s 。" + +#: builders/texinfo.py:44 msgid "" -"multiple files found for the document \"%s\": %s\n" -"Use %r for the build." -msgstr "" +"\n" +"Run 'make' in that directory to run these through makeinfo\n" +"(use 'make info' here to do that automatically)." +msgstr "\n在該目錄中執行 'make' 以透過 makeinfo 執行這些\n(在此使用 'make info' 以自動執行)" -#: project.py:87 -#, python-format -msgid "Ignored unreadable document %r." -msgstr "已略過無法讀取的文件 %r 。" +#: builders/texinfo.py:73 +msgid "no \"texinfo_documents\" config value found; no documents will be written" +msgstr "未找到 \"texinfo_documents\" 組態值;不會編寫任何文件" -#: registry.py:167 +#: builders/texinfo.py:85 #, python-format -msgid "Builder class %s has no \"name\" attribute" -msgstr "Builder class %s 沒有 \"name\" 屬性" +msgid "\"texinfo_documents\" config value references unknown document %s" +msgstr "\"texinfo_documents\" 組態值引用未知的文件 %s" -#: registry.py:171 +#: builders/latex/__init__.py:310 builders/texinfo.py:105 #, python-format -msgid "Builder %r already exists (in module %s)" -msgstr "Builder %r 已存在(於 %s 模組)" +msgid "processing %s" +msgstr "正在處理 %s" -#: registry.py:187 -#, python-format -msgid "Builder name %s not registered or available through entry point" -msgstr "Builder 名稱 %s 未註冊或無法從 entry point 取得" +#: builders/latex/__init__.py:332 builders/manpage.py:54 +#: builders/singlehtml.py:176 builders/texinfo.py:111 +msgid "writing" +msgstr "編寫中" -#: registry.py:197 -#, python-format -msgid "Builder name %s not registered" -msgstr "Builder 名稱 %s 未註冊" +#: builders/latex/__init__.py:398 builders/texinfo.py:160 +msgid "resolving references..." +msgstr "正在解析參照..." -#: registry.py:204 -#, python-format -msgid "domain %s already registered" -msgstr "domain %s 已註冊" +#: builders/latex/__init__.py:409 builders/texinfo.py:170 +msgid " (in " +msgstr " (於 " -#: registry.py:228 registry.py:249 registry.py:262 -#, python-format -msgid "domain %s not yet registered" -msgstr "domain %s 尚未被註冊" +#: builders/_epub_base.py:425 builders/html/__init__.py:768 +#: builders/latex/__init__.py:474 builders/texinfo.py:186 +msgid "copying images... " +msgstr "正在複製圖片..." -#: registry.py:235 +#: builders/_epub_base.py:447 builders/latex/__init__.py:489 +#: builders/texinfo.py:203 #, python-format -msgid "The %r directive is already registered to domain %s" -msgstr "%r 指令已註冊給 domain %s" +msgid "cannot copy image file %r: %s" +msgstr "無法複製圖片檔 %r: %s" -#: registry.py:253 -#, python-format -msgid "The %r role is already registered to domain %s" -msgstr "%r 角色已註冊給 domain %s" +#: builders/texinfo.py:210 +msgid "copying Texinfo support files" +msgstr "正在複製 Texinfo 支援檔案" -#: registry.py:266 +#: builders/texinfo.py:218 #, python-format -msgid "The %r index is already registered to domain %s" -msgstr "%r 索引已註冊給 domain %s" +msgid "error writing file Makefile: %s" +msgstr "錯誤寫入檔案 Makefile: %s" -#: registry.py:313 +#: builders/manpage.py:37 #, python-format -msgid "The %r object_type is already registered" -msgstr "%r object_type 已註冊" +msgid "The manual pages are in %(outdir)s." +msgstr "手冊頁面在 %(outdir)s" -#: registry.py:344 -#, python-format -msgid "The %r crossref_type is already registered" -msgstr "%r crossref_type 已註冊" +#: builders/manpage.py:45 +msgid "no \"man_pages\" config value found; no manual pages will be written" +msgstr "未找到 \"man_pages\" 組態值:不會編寫任何手冊頁面" -#: registry.py:353 +#: builders/manpage.py:64 #, python-format -msgid "source_suffix %r is already registered" -msgstr "source_suffix %r 已註冊" +msgid "\"man_pages\" config value references unknown document %s" +msgstr "\"man_pages\" 組態值引用未知的文件 %s" -#: registry.py:363 +#: builders/singlehtml.py:35 #, python-format -msgid "source_parser for %r is already registered" -msgstr "對於 %r 的 source_parser 已註冊" +msgid "The HTML page is in %(outdir)s." +msgstr "HTML 頁面在 %(outdir)s 。" -#: registry.py:372 -#, python-format -msgid "Source parser for %s not registered" -msgstr "對於 %s 的源碼剖析器未註冊" +#: builders/singlehtml.py:171 +msgid "assembling single document" +msgstr "正在組合單一文件" -#: registry.py:390 -#, python-format -msgid "Translator for %r already exists" -msgstr "對於 %r 的翻譯器已經存在" +#: builders/singlehtml.py:189 +msgid "writing additional files" +msgstr "正在寫入附加檔案" -#: registry.py:407 -#, python-format -msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" -msgstr "對於 add_node() 的 kwargs 必須是一個 (visit, depart) 函式值組:%r=%r" +#: builders/dummy.py:19 +msgid "The dummy builder generates no files." +msgstr "虛擬建立器未產生任何檔案。" -#: registry.py:496 +#: builders/gettext.py:243 #, python-format -msgid "enumerable_node %r already registered" -msgstr "enumerable_node %r 已註冊" +msgid "The message catalogs are in %(outdir)s." +msgstr "訊息目錄是在 %(outdir)s" -#: registry.py:512 +#: builders/__init__.py:400 builders/gettext.py:264 #, python-format -msgid "math renderer %s is already registered" -msgstr "數學描繪器 %s 已註冊" +msgid "building [%s]: " +msgstr "正在建立 [%s]:" -#: registry.py:529 +#: builders/gettext.py:265 #, python-format -msgid "" -"the extension %r was already merged with Sphinx since version %s; this " -"extension is ignored." -msgstr "擴充套件 %r 已被併入 %s 版以上的 Sphinx:此擴充套件已略過。" +msgid "targets for %d template files" +msgstr "模板檔 %d 的目標" -#: registry.py:543 -msgid "Original exception:\n" -msgstr "原始的例外:\n" +#: builders/gettext.py:271 +msgid "reading templates... " +msgstr "正在讀取模板..." -#: registry.py:545 +#: builders/gettext.py:310 +msgid "writing message catalogs... " +msgstr "正在寫入訊息目錄..." + +#: builders/linkcheck.py:87 #, python-format -msgid "Could not import extension %s" -msgstr "無法引入擴充套件 %s" +msgid "Look for any errors in the above output or in %(outdir)s/output.txt" +msgstr "尋找以上輸出或 %(outdir)s/output.txt 中的任何錯誤" -#: registry.py:552 +#: builders/linkcheck.py:159 #, python-format -msgid "" -"extension %r has no setup() function; is it really a Sphinx extension " -"module?" -msgstr "擴充套件 %r 沒有 setup() 函式;它真的是 Sphinx 擴充套件模組嗎?" +msgid "broken link: %s (%s)" +msgstr "錯誤連結: %s (%s)" -#: registry.py:565 +#: builders/linkcheck.py:561 #, python-format -msgid "" -"The %s extension used by this project needs at least Sphinx v%s; it " -"therefore cannot be built with this version." -msgstr "此專案使用的 %s 擴充套件需要 Sphinx v%s 以上的版本;所以它無法以此版本被建立。" +msgid "Anchor '%s' not found" +msgstr "未找到錨 '%s'" + +#: builders/linkcheck.py:789 +msgid "linkcheck_allowed_redirects. Expected a dictionary." +msgstr "" -#: registry.py:577 +#: builders/linkcheck.py:799 #, python-format -msgid "" -"extension %r returned an unsupported object from its setup() function; it " -"should return None or a metadata dictionary" -msgstr "擴充套件 %r 從它的 setup() 函式回傳一個未支援物件;它應該回傳 None 或一個元數據資料夾" +msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" +msgstr "在 linkcheck_allowed_redirects 編譯 regex 失敗: %r %s" -#: registry.py:612 +#: builders/epub3.py:83 #, python-format -msgid "`None` is not a valid filetype for %r." -msgstr "" +msgid "The ePub file is in %(outdir)s." +msgstr "ePub 檔案是在 %(outdir)s 。" + +#: builders/epub3.py:188 +msgid "writing nav.xhtml file..." +msgstr "正在寫入 nav.xhtml 檔案..." + +#: builders/epub3.py:224 +msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" +msgstr "conf 值 \"epub_language\" (或 \"language\") 在 EPUB3 不應該為空" + +#: builders/epub3.py:230 +msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" +msgstr "conf 值 \"epub_uid\" 在 EPUB3 應該是 XML NAME" + +#: builders/epub3.py:235 +msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" +msgstr "conf 值 \"epub_title\" (或 \"html_title\") 在 EPUB3 不應該為空" + +#: builders/epub3.py:241 +msgid "conf value \"epub_author\" should not be empty for EPUB3" +msgstr "conf 值 \"epub_author\" 在 EPUB3 不應該為空" + +#: builders/epub3.py:245 +msgid "conf value \"epub_contributor\" should not be empty for EPUB3" +msgstr "conf 值 \"epub_contributor\" 在 EPUB3 不應該為空" + +#: builders/epub3.py:250 +msgid "conf value \"epub_description\" should not be empty for EPUB3" +msgstr "conf 值 \"epub_description\" 在 EPUB3 不應該為空" + +#: builders/epub3.py:254 +msgid "conf value \"epub_publisher\" should not be empty for EPUB3" +msgstr "conf 值 \"epub_publisher\" 在 EPUB3 不應該為空" + +#: builders/epub3.py:259 +msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" +msgstr "conf 值 \"epub_copyright\" (或 \"copyright\") 在 EPUB3 不應該為空" + +#: builders/epub3.py:265 +msgid "conf value \"epub_identifier\" should not be empty for EPUB3" +msgstr "conf 值 \"epub_identifier\" 在 EPUB3 不應該為空" + +#: builders/epub3.py:268 +msgid "conf value \"version\" should not be empty for EPUB3" +msgstr "conf 值 \"version\" 在 EPUB3 不應該為空" -#: roles.py:206 +#: builders/epub3.py:282 builders/html/__init__.py:1296 #, python-format -msgid "Common Vulnerabilities and Exposures; CVE %s" -msgstr "" +msgid "invalid css_file: %r, ignored" +msgstr "無效的 css_file: %r, 已略過" -#: roles.py:229 +#: builders/xml.py:29 #, python-format -msgid "invalid CVE number %s" -msgstr "" +msgid "The XML files are in %(outdir)s." +msgstr "XML 檔案在 %(outdir)s 。" -#: roles.py:251 +#: builders/html/__init__.py:1242 builders/text.py:71 builders/xml.py:81 #, python-format -msgid "Common Weakness Enumeration; CWE %s" -msgstr "" +msgid "error writing file %s: %s" +msgstr "錯誤寫入檔案 %s: %s" -#: roles.py:274 +#: builders/xml.py:103 #, python-format -msgid "invalid CWE number %s" -msgstr "" +msgid "The pseudo-XML files are in %(outdir)s." +msgstr "pseudo-XML 檔案在 %(outdir)s 。" -#: roles.py:294 +#: builders/_epub_base.py:223 #, python-format -msgid "Python Enhancement Proposals; PEP %s" -msgstr "Python Enhancement Proposals; PEP %s" +msgid "duplicated ToC entry found: %s" +msgstr "找到了重複的 ToC 項目: %s" -#: roles.py:317 +#: builders/_epub_base.py:436 #, python-format -msgid "invalid PEP number %s" -msgstr "無效的 PEP 號碼 %s" +msgid "cannot read image file %r: copying it instead" +msgstr "無法讀取圖片檔 %r: 正在複製它做為替代" -#: roles.py:355 +#: builders/_epub_base.py:467 #, python-format -msgid "invalid RFC number %s" -msgstr "無效的 RFC 號碼 %s" +msgid "cannot write image file %r: %s" +msgstr "無法寫入圖片檔 %r: %s" -#: ext/linkcode.py:86 ext/viewcode.py:226 -msgid "[source]" -msgstr "[原始碼]" +#: builders/_epub_base.py:479 +msgid "Pillow not found - copying image files" +msgstr "未找到 Pillow - 正在複製圖片檔" -#: ext/viewcode.py:289 -msgid "highlighting module code... " -msgstr "正在 highlight 模組程式碼..." +#: builders/_epub_base.py:514 +msgid "writing mimetype file..." +msgstr "正在寫入 mimetype 檔案..." -#: ext/viewcode.py:320 -msgid "[docs]" -msgstr "[文件]" +#: builders/_epub_base.py:523 +msgid "writing META-INF/container.xml file..." +msgstr "正在寫入 META-INF/container.xml 檔案..." -#: ext/viewcode.py:346 -msgid "Module code" -msgstr "模組原始碼" +#: builders/_epub_base.py:561 +msgid "writing content.opf file..." +msgstr "正在寫入 content.opf 檔案..." -#: ext/viewcode.py:353 +#: builders/_epub_base.py:594 #, python-format -msgid "

        Source code for %s

        " -msgstr "

        %s 的原始碼

        " +msgid "unknown mimetype for %s, ignoring" +msgstr "對於 %s 未知的 mimetype,忽略中" -#: ext/viewcode.py:380 -msgid "Overview: module code" -msgstr "概要:模組原始碼" +#: builders/_epub_base.py:749 +msgid "node has an invalid level" +msgstr "" -#: ext/viewcode.py:381 -msgid "

        All modules for which code is available

        " -msgstr "

        所有可得程式碼的模組

        " +#: builders/_epub_base.py:769 +msgid "writing toc.ncx file..." +msgstr "正在寫入 toc.ncx 檔案..." -#: ext/extlinks.py:82 +#: builders/_epub_base.py:802 #, python-format -msgid "" -"hardcoded link %r could be replaced by an extlink (try using %r instead)" -msgstr "hardcoded link %r 可以被一個 extlink 所取代(試試改用 %r)" +msgid "writing %s file..." +msgstr "正在寫入 %s 檔案..." -#: ext/autosectionlabel.py:52 +#: builders/text.py:27 #, python-format -msgid "section \"%s\" gets labeled as \"%s\"" -msgstr "段落 \"%s\" 取得標籤 \"%s\"" +msgid "The text files are in %(outdir)s." +msgstr "文字檔案在 %(outdir)s 。" -#: domains/std/__init__.py:833 domains/std/__init__.py:960 -#: ext/autosectionlabel.py:61 +#: builders/__init__.py:229 #, python-format -msgid "duplicate label %s, other instance in %s" -msgstr "重複的標籤 %s,亦出現於 %s" +msgid "a suitable image for %s builder not found: %s (%s)" +msgstr "未找到對於 %s builder 適用的圖片:%s (%s)" -#: ext/imgmath.py:387 ext/mathjax.py:60 -msgid "Link to this equation" -msgstr "連結到這個方程式" +#: builders/__init__.py:237 +#, python-format +msgid "a suitable image for %s builder not found: %s" +msgstr "未找到對於 %s builder 適用的圖片:%s" -#: ext/duration.py:90 -msgid "" -"====================== slowest reading durations =======================" -msgstr "====================== 最慢的讀取歷時 =======================" +#: builders/__init__.py:260 +msgid "building [mo]: " +msgstr "建立 [mo]:" -#: ext/doctest.py:118 -#, python-format -msgid "missing '+' or '-' in '%s' option." -msgstr "在 '%s' 選項中遺漏 '+' 或 '-'。" +#: builders/__init__.py:263 builders/__init__.py:771 builders/__init__.py:795 +msgid "writing output... " +msgstr "編寫輸出..." -#: ext/doctest.py:124 +#: builders/__init__.py:280 #, python-format -msgid "'%s' is not a valid option." -msgstr "'%s' 不是有效的選項" +msgid "all of %d po files" +msgstr "所有的 %d po 檔" -#: ext/doctest.py:139 +#: builders/__init__.py:302 #, python-format -msgid "'%s' is not a valid pyversion option" -msgstr "'%s' 不是有效的 pyversion 選項" - -#: ext/doctest.py:226 -msgid "invalid TestCode type" -msgstr "無效的 TestCode 型別" +msgid "targets for %d po files that are specified" +msgstr "對於指定的 po 檔 %d 的目標" -#: ext/doctest.py:297 +#: builders/__init__.py:314 #, python-format -msgid "" -"Testing of doctests in the sources finished, look at the results in " -"%(outdir)s/output.txt." -msgstr "來源的 doctests 測試已結束,在 %(outdir)s/output.txt 中查看結果。" +msgid "targets for %d po files that are out of date" +msgstr "對於已過期 po 檔 %d 的目標" -#: ext/doctest.py:457 -#, python-format -msgid "no code/output in %s block at %s:%s" -msgstr "在 %s 區塊中的 %s:%s 沒有程式碼/輸出" +#: builders/__init__.py:324 +msgid "all source files" +msgstr "所有原始檔案" -#: ext/doctest.py:568 +#: builders/__init__.py:335 #, python-format -msgid "ignoring invalid doctest code: %r" -msgstr "正在忽略無效的 doctest 碼: %r" +msgid "file %r given on command line does not exist, " +msgstr "在命令列給的檔案 %r 不存在," -#: ext/imgmath.py:162 +#: builders/__init__.py:342 #, python-format msgid "" -"LaTeX command %r cannot be run (needed for math display), check the " -"imgmath_latex setting" -msgstr "LaTeX 命令 %r 無法被執行(數學顯示所需要),請檢查 imgmath_latex 設定" +"file %r given on command line is not under the source directory, ignoring" +msgstr "在命令列給的檔案 %r 不在來源資料夾下,忽略中" -#: ext/imgmath.py:181 +#: builders/__init__.py:353 #, python-format -msgid "" -"%s command %r cannot be run (needed for math display), check the imgmath_%s " -"setting" -msgstr "%s 命令 %r 無法被執行(數學顯示所需要),請檢查 imgmath_%s 設定" +msgid "file %r given on command line is not a valid document, ignoring" +msgstr "在命令列給的檔案 %r 不是有效的文件,忽略中" -#: ext/imgmath.py:344 +#: builders/__init__.py:366 #, python-format -msgid "display latex %r: %s" -msgstr "顯示 latex %r: %s" +msgid "%d source files given on command line" +msgstr "在命令列給了 %d 個原始檔案" -#: ext/imgmath.py:380 +#: builders/__init__.py:382 #, python-format -msgid "inline latex %r: %s" -msgstr "行內 latex %r: %s" +msgid "targets for %d source files that are out of date" +msgstr "%d 個過時原始檔案的目標" -#: ext/coverage.py:48 +#: builders/__init__.py:411 +msgid "looking for now-outdated files... " +msgstr "正在尋找目前已過期的檔案..." + +#: builders/__init__.py:415 #, python-format -msgid "invalid regex %r in %s" -msgstr "無效的 regex %r 在 %s" +msgid "%d found" +msgstr "已找到 %d" -#: ext/coverage.py:140 ext/coverage.py:301 +#: builders/__init__.py:417 +msgid "none found" +msgstr "找不到任何結果" + +#: builders/__init__.py:424 +msgid "pickling environment" +msgstr "正在 pickle 環境" + +#: builders/__init__.py:431 +msgid "checking consistency" +msgstr "正在檢查一致性" + +#: builders/__init__.py:435 +msgid "no targets are out of date." +msgstr "沒有過時的目標。" + +#: builders/__init__.py:474 +msgid "updating environment: " +msgstr "正在更新環境:" + +#: builders/__init__.py:499 #, python-format -msgid "module %s could not be imported: %s" -msgstr "模組 %s 無法被 import: %s" +msgid "%s added, %s changed, %s removed" +msgstr "%s 已新增, %s 已變更, %s 已移除" -#: ext/coverage.py:148 +#: builders/__init__.py:536 #, python-format msgid "" -"the following modules are documented but were not specified in " -"coverage_modules: %s" +"Sphinx is unable to load the master document (%s) because it matches a " +"built-in exclude pattern %r. Please move your master document to a different" +" location." msgstr "" -#: ext/coverage.py:158 +#: builders/__init__.py:545 +#, python-format msgid "" -"the following modules are specified in coverage_modules but were not " -"documented" +"Sphinx is unable to load the master document (%s) because it matches an " +"exclude pattern specified in conf.py, %r. Please remove this pattern from " +"conf.py." msgstr "" -#: ext/coverage.py:172 -#, python-brace-format, python-format +#: builders/__init__.py:556 +#, python-format msgid "" -"Testing of coverage in the sources finished, look at the results in " -"%(outdir)s{sep}python.txt." +"Sphinx is unable to load the master document (%s) because it is not included" +" in the custom include_patterns = %r. Ensure that a pattern in " +"include_patterns matches the master document." msgstr "" -#: ext/coverage.py:187 +#: builders/__init__.py:563 #, python-format -msgid "invalid regex %r in coverage_c_regexes" -msgstr "無效的 regex %r 在 coverage_c_regexes" +msgid "" +"Sphinx is unable to load the master document (%s). The master document must " +"be within the source directory or a subdirectory of it." +msgstr "" -#: ext/coverage.py:260 -#, python-format -msgid "undocumented c api: %s [%s] in file %s" -msgstr "未文件化的 c api: %s [%s] 在檔案 %s 中" +#: builders/__init__.py:581 builders/__init__.py:598 +msgid "reading sources... " +msgstr "正在讀取來源..." -#: ext/coverage.py:452 +#: builders/__init__.py:725 #, python-format -msgid "undocumented python function: %s :: %s" -msgstr "未文件化的 python 函式: %s :: %s" +msgid "docnames to write: %s" +msgstr "待寫入的 docname: %s" -#: ext/coverage.py:473 -#, python-format -msgid "undocumented python class: %s :: %s" -msgstr "未文件化的 python class: %s :: %s" +#: builders/__init__.py:727 +msgid "no docnames to write!" +msgstr "" + +#: builders/__init__.py:740 +msgid "preparing documents" +msgstr "正在準備文件" + +#: builders/__init__.py:743 +msgid "copying assets" +msgstr "正在複製資產 (asset)" + +#: builders/changes.py:29 +#, python-format +msgid "The overview file is in %(outdir)s." +msgstr "概觀檔案是在 %(outdir)s 。" + +#: builders/changes.py:65 +#, python-format +msgid "no changes in version %s." +msgstr "在 %s 版中無變更" + +#: builders/changes.py:67 +msgid "writing summary file..." +msgstr "正在寫入摘要檔案..." + +#: builders/changes.py:79 +msgid "Builtins" +msgstr "內建" + +#: builders/changes.py:81 +msgid "Module level" +msgstr "模組層次" + +#: builders/changes.py:137 +msgid "copying source files..." +msgstr "正在複製原始檔案..." + +#: builders/changes.py:146 +#, python-format +msgid "could not read %r for changelog creation" +msgstr "在變更日誌建立時無法讀取 %r" + +#: ext/coverage.py:48 +#, python-format +msgid "invalid regex %r in %s" +msgstr "無效的 regex %r 在 %s" + +#: ext/coverage.py:140 ext/coverage.py:301 +#, python-format +msgid "module %s could not be imported: %s" +msgstr "模組 %s 無法被 import: %s" + +#: ext/coverage.py:148 +#, python-format +msgid "" +"the following modules are documented but were not specified in " +"coverage_modules: %s" +msgstr "" + +#: ext/coverage.py:158 +#, python-format +msgid "" +"the following modules are specified in coverage_modules but were not " +"documented: %s" +msgstr "" + +#: ext/coverage.py:172 +#, python-brace-format, python-format +msgid "" +"Testing of coverage in the sources finished, look at the results in " +"%(outdir)s{sep}python.txt." +msgstr "" + +#: ext/coverage.py:187 +#, python-format +msgid "invalid regex %r in coverage_c_regexes" +msgstr "無效的 regex %r 在 coverage_c_regexes" + +#: ext/coverage.py:260 +#, python-format +msgid "undocumented c api: %s [%s] in file %s" +msgstr "未文件化的 c api: %s [%s] 在檔案 %s 中" + +#: ext/coverage.py:452 +#, python-format +msgid "undocumented python function: %s :: %s" +msgstr "未文件化的 python 函式: %s :: %s" + +#: ext/coverage.py:473 +#, python-format +msgid "undocumented python class: %s :: %s" +msgstr "未文件化的 python class: %s :: %s" #: ext/coverage.py:492 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "未文件化的 python method: %s :: %s :: %s" +#: ext/extlinks.py:82 +#, python-format +msgid "" +"hardcoded link %r could be replaced by an extlink (try using %r instead)" +msgstr "hardcoded link %r 可以被一個 extlink 所取代(試試改用 %r)" + +#: ext/todo.py:61 +msgid "Todo" +msgstr "Todo" + +#: ext/todo.py:94 +#, python-format +msgid "TODO entry found: %s" +msgstr "找到 TODO 項目: %s" + +#: ext/todo.py:152 +msgid "<>" +msgstr "<>" + +#: ext/todo.py:154 +#, python-format +msgid "(The <> is located in %s, line %d.)" +msgstr "(<> 見 %s ,第 %d 行)" + +#: ext/todo.py:166 +msgid "original entry" +msgstr "原始記錄" + #: ext/imgconverter.py:44 #, python-format msgid "" @@ -870,879 +1336,960 @@ msgstr "[圖:%s]" msgid "[graph]" msgstr "[圖]" -#: ext/todo.py:61 -msgid "Todo" -msgstr "Todo" - -#: ext/todo.py:94 +#: ext/imgmath.py:148 #, python-format -msgid "TODO entry found: %s" -msgstr "找到 TODO 項目: %s" +msgid "" +"LaTeX command %r cannot be run (needed for math display), check the " +"imgmath_latex setting" +msgstr "LaTeX 命令 %r 無法被執行(數學顯示所需要),請檢查 imgmath_latex 設定" -#: ext/todo.py:152 -msgid "<>" -msgstr "<>" +#: ext/imgmath.py:167 +#, python-format +msgid "" +"%s command %r cannot be run (needed for math display), check the imgmath_%s " +"setting" +msgstr "%s 命令 %r 無法被執行(數學顯示所需要),請檢查 imgmath_%s 設定" -#: ext/todo.py:154 +#: ext/imgmath.py:326 #, python-format -msgid "(The <> is located in %s, line %d.)" -msgstr "(<> 見 %s ,第 %d 行)" +msgid "display latex %r: %s" +msgstr "顯示 latex %r: %s" -#: ext/todo.py:166 -msgid "original entry" -msgstr "原始記錄" +#: ext/imgmath.py:362 +#, python-format +msgid "inline latex %r: %s" +msgstr "行內 latex %r: %s" -#: directives/code.py:66 -msgid "non-whitespace stripped by dedent" -msgstr "非空白字元被凸排去除" +#: ext/imgmath.py:369 ext/mathjax.py:60 +msgid "Link to this equation" +msgstr "連結到這個方程式" -#: directives/code.py:87 +#: ext/doctest.py:118 #, python-format -msgid "Invalid caption: %s" -msgstr "無效標題:%s" +msgid "missing '+' or '-' in '%s' option." +msgstr "在 '%s' 選項中遺漏 '+' 或 '-'。" -#: directives/code.py:131 directives/code.py:297 directives/code.py:483 +#: ext/doctest.py:124 #, python-format -msgid "line number spec is out of range(1-%d): %r" -msgstr "列號規格超出範圍 (1-%d): %r" +msgid "'%s' is not a valid option." +msgstr "'%s' 不是有效的選項" -#: directives/code.py:216 +#: ext/doctest.py:139 #, python-format -msgid "Cannot use both \"%s\" and \"%s\" options" -msgstr "不能使用 \"%s\" 及 \"%s\" 兩個選項" +msgid "'%s' is not a valid pyversion option" +msgstr "'%s' 不是有效的 pyversion 選項" -#: directives/code.py:231 -#, python-format -msgid "Include file '%s' not found or reading it failed" -msgstr "" +#: ext/doctest.py:226 +msgid "invalid TestCode type" +msgstr "無效的 TestCode 型別" -#: directives/code.py:235 +#: ext/doctest.py:297 #, python-format msgid "" -"Encoding %r used for reading included file '%s' seems to be wrong, try " -"giving an :encoding: option" -msgstr "" +"Testing of doctests in the sources finished, look at the results in " +"%(outdir)s/output.txt." +msgstr "來源的 doctests 測試已結束,在 %(outdir)s/output.txt 中查看結果。" -#: directives/code.py:276 +#: ext/doctest.py:451 #, python-format -msgid "Object named %r not found in include file %r" -msgstr "名為 %r 的物件在 include 檔案 %r 中未找到" - -#: directives/code.py:309 -msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" -msgstr "無法以一個 \"lines\" 的互斥集使用 \"lineno-match\" " +msgid "no code/output in %s block at %s:%s" +msgstr "在 %s 區塊中的 %s:%s 沒有程式碼/輸出" -#: directives/code.py:314 +#: ext/doctest.py:568 #, python-format -msgid "Line spec %r: no lines pulled from include file %r" -msgstr "Line spec %r: 從 include 檔案 %r 沒有提取任何一行" - -#: directives/patches.py:71 -msgid "" -"\":file:\" option for csv-table directive now recognizes an absolute path as" -" a relative path from source directory. Please update your document." -msgstr "對 csv-table 指令的 \":file:\" 選項現在會將絕對路徑辨識為基於來源資料夾的相對路徑。請更新您的文件。" +msgid "ignoring invalid doctest code: %r" +msgstr "正在忽略無效的 doctest 碼: %r" -#: directives/other.py:119 +#: ext/autosectionlabel.py:52 #, python-format -msgid "toctree glob pattern %r didn't match any documents" -msgstr "toctree glob 型樣 %r 未匹配任何文件" +msgid "section \"%s\" gets labeled as \"%s\"" +msgstr "段落 \"%s\" 取得標籤 \"%s\"" -#: directives/other.py:153 environment/adapters/toctree.py:361 +#: domains/std/__init__.py:833 domains/std/__init__.py:960 +#: ext/autosectionlabel.py:61 #, python-format -msgid "toctree contains reference to excluded document %r" -msgstr "toctree 包含了指向已排除文件的參照 %r" +msgid "duplicate label %s, other instance in %s" +msgstr "重複的標籤 %s,亦出現於 %s" -#: directives/other.py:156 +#: ext/duration.py:47 #, python-format -msgid "toctree contains reference to nonexisting document %r" -msgstr "toctree 包含了指向不存在文件的參照 %r" +msgid "Reading duration %.3fs exceeded the duration limit %.3fs" +msgstr "" -#: directives/other.py:169 +#: ext/duration.py:117 +msgid "" +"====================== total reading duration ==========================" +msgstr "" + +#: ext/duration.py:124 #, python-format -msgid "duplicated entry found in toctree: %s" -msgstr "在 toctree 中找到重複的項目: %s" +msgid "Total time reading %d file%s: %dm %.3fs" +msgstr "" -#: directives/other.py:203 -msgid "Section author: " -msgstr "章節作者:" +#: ext/duration.py:136 +msgid "" +"====================== slowest reading durations =======================" +msgstr "====================== 最慢的讀取歷時 =======================" -#: directives/other.py:205 -msgid "Module author: " -msgstr "模組作者:" +#: ext/duration.py:139 +#, python-format +msgid "%.3fs %s" +msgstr "" -#: directives/other.py:207 -msgid "Code author: " -msgstr "程式作者:" +#: ext/linkcode.py:86 ext/viewcode.py:232 +msgid "[source]" +msgstr "[原始碼]" -#: directives/other.py:209 -msgid "Author: " -msgstr "作者:" +#: ext/viewcode.py:295 +msgid "highlighting module code... " +msgstr "正在 highlight 模組程式碼..." -#: directives/other.py:269 -msgid ".. acks content is not a list" -msgstr ".. acks 的內容不是一個列表" +#: ext/viewcode.py:326 +msgid "[docs]" +msgstr "[文件]" -#: directives/other.py:292 -msgid ".. hlist content is not a list" -msgstr ".. hlist 的內容不是一個列表" +#: ext/viewcode.py:352 +msgid "Module code" +msgstr "模組原始碼" -#: builders/changes.py:29 +#: ext/viewcode.py:359 #, python-format -msgid "The overview file is in %(outdir)s." -msgstr "概觀檔案是在 %(outdir)s 。" +msgid "

        Source code for %s

        " +msgstr "

        %s 的原始碼

        " -#: builders/changes.py:56 -#, python-format -msgid "no changes in version %s." -msgstr "在 %s 版中無變更" - -#: builders/changes.py:58 -msgid "writing summary file..." -msgstr "正在寫入摘要檔案..." - -#: builders/changes.py:70 -msgid "Builtins" -msgstr "內建" - -#: builders/changes.py:72 -msgid "Module level" -msgstr "模組層次" +#: ext/viewcode.py:386 +msgid "Overview: module code" +msgstr "概要:模組原始碼" -#: builders/changes.py:124 -msgid "copying source files..." -msgstr "正在複製原始檔案..." +#: ext/viewcode.py:387 +msgid "

        All modules for which code is available

        " +msgstr "

        所有可得程式碼的模組

        " -#: builders/changes.py:133 +#: domains/citation.py:75 #, python-format -msgid "could not read %r for changelog creation" -msgstr "在變更日誌建立時無法讀取 %r" +msgid "duplicate citation %s, other instance in %s" +msgstr "重複的引用 %s,亦出現於 %s" -#: builders/manpage.py:37 +#: domains/citation.py:92 #, python-format -msgid "The manual pages are in %(outdir)s." -msgstr "手冊頁面在 %(outdir)s" - -#: builders/manpage.py:45 -msgid "no \"man_pages\" config value found; no manual pages will be written" -msgstr "未找到 \"man_pages\" 組態值:不會編寫任何手冊頁面" - -#: builders/latex/__init__.py:347 builders/manpage.py:54 -#: builders/singlehtml.py:176 builders/texinfo.py:119 -msgid "writing" -msgstr "編寫中" +msgid "Citation [%s] is not referenced." +msgstr "引用 [%s] 未被參照。" -#: builders/manpage.py:71 +#: domains/math.py:73 #, python-format -msgid "\"man_pages\" config value references unknown document %s" -msgstr "\"man_pages\" 組態值引用未知的文件 %s" +msgid "duplicate label of equation %s, other instance in %s" +msgstr "重複公式標籤 %s,亦出現於 %s" -#: builders/__init__.py:224 +#: domains/math.py:130 writers/latex.py:2500 #, python-format -msgid "a suitable image for %s builder not found: %s (%s)" -msgstr "未找到對於 %s builder 適用的圖片:%s (%s)" +msgid "Invalid math_eqref_format: %r" +msgstr "無效的 math_eqref_format: %r" -#: builders/__init__.py:232 +#: domains/javascript.py:183 #, python-format -msgid "a suitable image for %s builder not found: %s" -msgstr "未找到對於 %s builder 適用的圖片:%s" - -#: builders/__init__.py:255 -msgid "building [mo]: " -msgstr "建立 [mo]:" - -#: builders/__init__.py:258 builders/__init__.py:759 builders/__init__.py:791 -msgid "writing output... " -msgstr "編寫輸出..." +msgid "%s() (built-in function)" +msgstr "%s() (內建函式)" -#: builders/__init__.py:275 +#: domains/javascript.py:184 domains/python/__init__.py:279 #, python-format -msgid "all of %d po files" -msgstr "所有的 %d po 檔" +msgid "%s() (%s method)" +msgstr "%s() (%s 的方法)" -#: builders/__init__.py:297 +#: domains/javascript.py:186 #, python-format -msgid "targets for %d po files that are specified" -msgstr "對於指定的 po 檔 %d 的目標" +msgid "%s() (class)" +msgstr "%s() (類別)" -#: builders/__init__.py:309 +#: domains/javascript.py:188 #, python-format -msgid "targets for %d po files that are out of date" -msgstr "對於已過期 po 檔 %d 的目標" - -#: builders/__init__.py:319 -msgid "all source files" -msgstr "所有原始檔案" +msgid "%s (global variable or constant)" +msgstr "%s (全域變數或常數)" -#: builders/__init__.py:330 +#: domains/javascript.py:190 domains/python/__init__.py:370 #, python-format -msgid "file %r given on command line does not exist, " -msgstr "在命令列給的檔案 %r 不存在," +msgid "%s (%s attribute)" +msgstr "%s (%s 的屬性)" -#: builders/__init__.py:337 -#, python-format -msgid "" -"file %r given on command line is not under the source directory, ignoring" -msgstr "在命令列給的檔案 %r 不在來源資料夾下,忽略中" +#: domains/javascript.py:274 +msgid "Arguments" +msgstr "引數" -#: builders/__init__.py:348 -#, python-format -msgid "file %r given on command line is not a valid document, ignoring" -msgstr "在命令列給的檔案 %r 不是有效的文件,忽略中" +#: domains/cpp/__init__.py:491 domains/javascript.py:281 +msgid "Throws" +msgstr "拋出" -#: builders/__init__.py:361 -#, python-format -msgid "%d source files given on command line" -msgstr "在命令列給了 %d 個原始檔案" +#: domains/c/__init__.py:367 domains/cpp/__init__.py:504 +#: domains/javascript.py:288 domains/python/_object.py:221 +msgid "Returns" +msgstr "回傳" -#: builders/__init__.py:377 -#, python-format -msgid "targets for %d source files that are out of date" -msgstr "%d 個過時原始檔案的目標" +#: domains/c/__init__.py:373 domains/javascript.py:294 +#: domains/python/_object.py:227 +msgid "Return type" +msgstr "回傳型別" -#: builders/__init__.py:395 builders/gettext.py:265 +#: domains/javascript.py:374 #, python-format -msgid "building [%s]: " -msgstr "正在建立 [%s]:" - -#: builders/__init__.py:406 -msgid "looking for now-outdated files... " -msgstr "正在尋找目前已過期的檔案..." +msgid "%s (module)" +msgstr "%s (模組)" -#: builders/__init__.py:410 -#, python-format -msgid "%d found" -msgstr "已找到 %d" +#: domains/c/__init__.py:779 domains/cpp/__init__.py:943 +#: domains/javascript.py:419 domains/python/__init__.py:726 +msgid "function" +msgstr "函式" -#: builders/__init__.py:412 -msgid "none found" -msgstr "找不到任何結果" +#: domains/javascript.py:420 domains/python/__init__.py:730 +msgid "method" +msgstr "方法" -#: builders/__init__.py:419 -msgid "pickling environment" -msgstr "正在 pickle 環境" +#: domains/cpp/__init__.py:941 domains/javascript.py:421 +#: domains/python/__init__.py:728 +msgid "class" +msgstr "類別" -#: builders/__init__.py:426 -msgid "checking consistency" -msgstr "正在檢查一致性" +#: domains/javascript.py:422 domains/python/__init__.py:727 +msgid "data" +msgstr "資料" -#: builders/__init__.py:430 -msgid "no targets are out of date." -msgstr "沒有過時的目標。" +#: domains/javascript.py:423 domains/python/__init__.py:733 +msgid "attribute" +msgstr "屬性" -#: builders/__init__.py:469 -msgid "updating environment: " -msgstr "正在更新環境:" +#: domains/javascript.py:424 domains/python/__init__.py:736 +msgid "module" +msgstr "模組" -#: builders/__init__.py:494 +#: domains/javascript.py:458 #, python-format -msgid "%s added, %s changed, %s removed" -msgstr "%s 已新增, %s 已變更, %s 已移除" +msgid "duplicate %s description of %s, other %s in %s" +msgstr "%s 的重複 %s 敘述,其他的 %s 在 %s" -#: builders/__init__.py:531 +#: domains/rst.py:131 domains/rst.py:190 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches a " -"built-in exclude pattern %r. Please move your master document to a different" -" location." -msgstr "" +msgid "%s (directive)" +msgstr "%s (指令)" -#: builders/__init__.py:540 +#: domains/rst.py:191 domains/rst.py:202 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it matches an " -"exclude pattern specified in conf.py, %r. Please remove this pattern from " -"conf.py." -msgstr "" +msgid ":%s: (directive option)" +msgstr ":%s: (指令選項)" -#: builders/__init__.py:551 +#: domains/rst.py:224 #, python-format -msgid "" -"Sphinx is unable to load the master document (%s) because it is not included" -" in the custom include_patterns = %r. Ensure that a pattern in " -"include_patterns matches the master document." -msgstr "" +msgid "%s (role)" +msgstr "%s (角色)" -#: builders/__init__.py:558 -#, python-format -msgid "" -"Sphinx is unable to load the master document (%s). The master document must " -"be within the source directory or a subdirectory of it." -msgstr "" +#: domains/rst.py:234 +msgid "directive" +msgstr "指令" -#: builders/__init__.py:576 builders/__init__.py:592 -msgid "reading sources... " -msgstr "正在讀取來源..." +#: domains/rst.py:235 +msgid "directive-option" +msgstr "指令選項" + +#: domains/rst.py:236 +msgid "role" +msgstr "角色" -#: builders/__init__.py:713 +#: domains/rst.py:262 #, python-format -msgid "docnames to write: %s" -msgstr "待寫入的 docname: %s" +msgid "duplicate description of %s %s, other instance in %s" +msgstr "%s %s 的重複敘述,其他的實例在 %s" -#: builders/__init__.py:715 -msgid "no docnames to write!" -msgstr "" +#: domains/changeset.py:32 +#, python-format +msgid "Added in version %s" +msgstr "在 %s 版被加入" -#: builders/__init__.py:728 -msgid "preparing documents" -msgstr "正在準備文件" +#: domains/changeset.py:33 +#, python-format +msgid "Changed in version %s" +msgstr "在 %s 版的變更" -#: builders/__init__.py:731 -msgid "copying assets" -msgstr "正在複製資產 (asset)" +#: domains/changeset.py:34 +#, python-format +msgid "Deprecated since version %s" +msgstr "在 %s 版之後被棄用" -#: builders/__init__.py:883 +#: domains/changeset.py:35 #, python-format -msgid "undecodable source characters, replacing with \"?\": %r" -msgstr "無法解碼的原始字元,以 \"?\" 取代: %r" +msgid "Removed in version %s" +msgstr "在 %s 版被移除" -#: builders/epub3.py:84 +#: domains/__init__.py:322 #, python-format -msgid "The ePub file is in %(outdir)s." -msgstr "ePub 檔案是在 %(outdir)s 。" +msgid "%s %s" +msgstr "%s %s" -#: builders/epub3.py:189 -msgid "writing nav.xhtml file..." -msgstr "正在寫入 nav.xhtml 檔案..." +#: cmd/build.py:64 +msgid "job number should be a positive number" +msgstr "工件編號應該是一個正數" -#: builders/epub3.py:221 -msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" -msgstr "conf 值 \"epub_language\" (或 \"language\") 在 EPUB3 不應該為空" +#: cmd/build.py:73 cmd/quickstart.py:582 ext/apidoc/_cli.py:27 +#: ext/autosummary/generate.py:876 +msgid "For more information, visit ." +msgstr "需要更多資訊,請拜訪 ." -#: builders/epub3.py:227 -msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" -msgstr "conf 值 \"epub_uid\" 在 EPUB3 應該是 XML NAME" +#: cmd/build.py:74 +msgid "" +"\n" +"Generate documentation from source files.\n" +"\n" +"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" +"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" +"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" +"including 'conf.py'\n" +"\n" +"sphinx-build can create documentation in different formats. A format is\n" +"selected by specifying the builder name on the command line; it defaults to\n" +"HTML. Builders can also perform other tasks related to documentation\n" +"processing.\n" +"\n" +"By default, everything that is outdated is built. Output only for selected\n" +"files can be built by specifying individual filenames.\n" +msgstr "\n從原始檔案產生說明文件。\n\nsphinx-build 會從 SOURCEDIR 中的檔案來產生說明文件,並\n將它置放於 OUTPUTDIR。它會在 SOURCEDIR 中尋找 'conf.py' \n內的組態設定。'sphinx-quickstart' 工具可以用來產生模板檔案,\n包括 'conf.py'\n\nsphinx-build 能以不同的格式建立說明文件。在命令列指定建立\n器的名稱來選擇一種格式;其預設值為 HTML。建立器也能執行\n與處理說明文件有關的其他任務。\n\n在預設情況,所有舊的文件都已經被建立。指定個別的檔名,\n可以在建立時僅限於輸出所選的檔案。\n" -#: builders/epub3.py:232 -msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" -msgstr "conf 值 \"epub_title\" (或 \"html_title\") 在 EPUB3 不應該為空" +#: cmd/build.py:100 +msgid "path to documentation source files" +msgstr "到說明文件原始檔案的路徑" -#: builders/epub3.py:238 -msgid "conf value \"epub_author\" should not be empty for EPUB3" -msgstr "conf 值 \"epub_author\" 在 EPUB3 不應該為空" +#: cmd/build.py:103 +msgid "path to output directory" +msgstr "到輸出資料夾的路徑" -#: builders/epub3.py:242 -msgid "conf value \"epub_contributor\" should not be empty for EPUB3" -msgstr "conf 值 \"epub_contributor\" 在 EPUB3 不應該為空" +#: cmd/build.py:109 +msgid "" +"(optional) a list of specific files to rebuild. Ignored if --write-all is " +"specified" +msgstr "(選用)一份要重建的特定檔案清單。如果已指定 --write-all,則會被忽略。" -#: builders/epub3.py:247 -msgid "conf value \"epub_description\" should not be empty for EPUB3" -msgstr "conf 值 \"epub_description\" 在 EPUB3 不應該為空" +#: cmd/build.py:114 +msgid "general options" +msgstr "一般選項" -#: builders/epub3.py:251 -msgid "conf value \"epub_publisher\" should not be empty for EPUB3" -msgstr "conf 值 \"epub_publisher\" 在 EPUB3 不應該為空" +#: cmd/build.py:121 +msgid "builder to use (default: 'html')" +msgstr "要使用的建立器(預設值:'html')" -#: builders/epub3.py:256 -msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" -msgstr "conf 值 \"epub_copyright\" (或 \"copyright\") 在 EPUB3 不應該為空" - -#: builders/epub3.py:262 -msgid "conf value \"epub_identifier\" should not be empty for EPUB3" -msgstr "conf 值 \"epub_identifier\" 在 EPUB3 不應該為空" +#: cmd/build.py:131 +msgid "" +"run in parallel with N processes, when possible. 'auto' uses the number of " +"CPU cores" +msgstr "如果可以的話,N 個程序會平行執行。'auto' 會使用 CPU 核心的數量" -#: builders/epub3.py:265 -msgid "conf value \"version\" should not be empty for EPUB3" -msgstr "conf 值 \"version\" 在 EPUB3 不應該為空" +#: cmd/build.py:140 +msgid "write all files (default: only write new and changed files)" +msgstr "寫入所有檔案(預設:只寫入新增及已變更檔案)" -#: builders/epub3.py:279 builders/html/__init__.py:1291 -#, python-format -msgid "invalid css_file: %r, ignored" -msgstr "無效的 css_file: %r, 已略過" +#: cmd/build.py:147 +msgid "don't use a saved environment, always read all files" +msgstr "不要使用已儲存的環境,永遠要讀取全部的檔案" -#: builders/xml.py:31 -#, python-format -msgid "The XML files are in %(outdir)s." -msgstr "XML 檔案在 %(outdir)s 。" +#: cmd/build.py:150 +msgid "path options" +msgstr "路徑選項" -#: builders/html/__init__.py:1241 builders/text.py:76 builders/xml.py:90 -#, python-format -msgid "error writing file %s: %s" -msgstr "錯誤寫入檔案 %s: %s" +#: cmd/build.py:157 +msgid "" +"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" +msgstr "包含 doctree 及環境檔案的資料夾(預設值:OUTPUT_DIR/.doctrees)" -#: builders/xml.py:101 -#, python-format -msgid "The pseudo-XML files are in %(outdir)s." -msgstr "pseudo-XML 檔案在 %(outdir)s 。" +#: cmd/build.py:166 +msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" +msgstr "包含組態檔 (conf.py) 的資料夾(預設值:SOURCE_DIR)" -#: builders/texinfo.py:45 -#, python-format -msgid "The Texinfo files are in %(outdir)s." -msgstr "Texinfo 檔案在 %(outdir)s 。" +#: cmd/build.py:175 +msgid "use no configuration file, only use settings from -D options" +msgstr "不使用組態檔,只使用 -D 選項中的設定" -#: builders/texinfo.py:48 -msgid "" -"\n" -"Run 'make' in that directory to run these through makeinfo\n" -"(use 'make info' here to do that automatically)." -msgstr "\n在該目錄中執行 'make' 以透過 makeinfo 執行這些\n(在此使用 'make info' 以自動執行)" +#: cmd/build.py:184 +msgid "override a setting in configuration file" +msgstr "在組態檔案中置換一項設定" -#: builders/texinfo.py:77 -msgid "no \"texinfo_documents\" config value found; no documents will be written" -msgstr "未找到 \"texinfo_documents\" 組態值;不會編寫任何文件" +#: cmd/build.py:193 +msgid "pass a value into HTML templates" +msgstr "傳遞一個值進入 HTML 模板" -#: builders/texinfo.py:89 -#, python-format -msgid "\"texinfo_documents\" config value references unknown document %s" -msgstr "\"texinfo_documents\" 組態值引用未知的文件 %s" +#: cmd/build.py:202 +msgid "define tag: include \"only\" blocks with TAG" +msgstr "定義 tag:「只」包含有 TAG 的區塊" -#: builders/latex/__init__.py:325 builders/texinfo.py:113 -#, python-format -msgid "processing %s" -msgstr "正在處理 %s" +#: cmd/build.py:209 +msgid "nitpicky mode: warn about all missing references" +msgstr "" -#: builders/latex/__init__.py:405 builders/texinfo.py:172 -msgid "resolving references..." -msgstr "正在解析參照..." +#: cmd/build.py:212 +msgid "console output options" +msgstr "控制台輸出選項" -#: builders/latex/__init__.py:416 builders/texinfo.py:182 -msgid " (in " -msgstr " (於 " +#: cmd/build.py:219 +msgid "increase verbosity (can be repeated)" +msgstr "增加贅言(可以被重複)" -#: builders/_epub_base.py:422 builders/html/__init__.py:779 -#: builders/latex/__init__.py:481 builders/texinfo.py:198 -msgid "copying images... " -msgstr "正在複製圖片..." +#: cmd/build.py:226 ext/apidoc/_cli.py:66 +msgid "no output on stdout, just warnings on stderr" +msgstr "在 stdout 無輸出,只有在 stderr 的警告" -#: builders/_epub_base.py:444 builders/latex/__init__.py:496 -#: builders/texinfo.py:215 -#, python-format -msgid "cannot copy image file %r: %s" -msgstr "無法複製圖片檔 %r: %s" +#: cmd/build.py:233 +msgid "no output at all, not even warnings" +msgstr "完全沒有輸出,也沒有警告" -#: builders/texinfo.py:222 -msgid "copying Texinfo support files" -msgstr "正在複製 Texinfo 支援檔案" +#: cmd/build.py:241 +msgid "do emit colored output (default: auto-detect)" +msgstr "執行 emit 彩色輸出(預設值:auto-detect)" -#: builders/texinfo.py:230 -#, python-format -msgid "error writing file Makefile: %s" -msgstr "錯誤寫入檔案 Makefile: %s" +#: cmd/build.py:249 +msgid "do not emit colored output (default: auto-detect)" +msgstr "不執行 emit 彩色輸出(預設值:auto-detect)" -#: builders/_epub_base.py:223 -#, python-format -msgid "duplicated ToC entry found: %s" -msgstr "找到了重複的 ToC 項目: %s" +#: cmd/build.py:252 +msgid "warning control options" +msgstr "控制警告的選項" -#: builders/_epub_base.py:433 -#, python-format -msgid "cannot read image file %r: copying it instead" -msgstr "無法讀取圖片檔 %r: 正在複製它做為替代" +#: cmd/build.py:258 +msgid "write warnings (and errors) to given file" +msgstr "寫入警告(及錯誤)至給定的檔案" -#: builders/_epub_base.py:464 -#, python-format -msgid "cannot write image file %r: %s" -msgstr "無法寫入圖片檔 %r: %s" +#: cmd/build.py:265 +msgid "turn warnings into errors" +msgstr "將警告轉為錯誤" -#: builders/_epub_base.py:476 -msgid "Pillow not found - copying image files" -msgstr "未找到 Pillow - 正在複製圖片檔" +#: cmd/build.py:273 +msgid "show full traceback on exception" +msgstr "在例外中顯示完整的回溯" -#: builders/_epub_base.py:511 -msgid "writing mimetype file..." -msgstr "正在寫入 mimetype 檔案..." +#: cmd/build.py:276 +msgid "run Pdb on exception" +msgstr "在例外中執行 Pdb" -#: builders/_epub_base.py:520 -msgid "writing META-INF/container.xml file..." -msgstr "正在寫入 META-INF/container.xml 檔案..." +#: cmd/build.py:282 +msgid "raise an exception on warnings" +msgstr "" -#: builders/_epub_base.py:558 -msgid "writing content.opf file..." -msgstr "正在寫入 content.opf 檔案..." +#: cmd/build.py:325 +msgid "cannot combine -a option and filenames" +msgstr "無法合併 -a 選項及檔名" -#: builders/_epub_base.py:591 +#: cmd/build.py:357 #, python-format -msgid "unknown mimetype for %s, ignoring" -msgstr "對於 %s 未知的 mimetype,忽略中" - -#: builders/_epub_base.py:745 -msgid "node has an invalid level" +msgid "cannot open warning file '%s': %s" msgstr "" -#: builders/_epub_base.py:765 -msgid "writing toc.ncx file..." -msgstr "正在寫入 toc.ncx 檔案..." +#: cmd/build.py:376 +msgid "-D option argument must be in the form name=value" +msgstr "-D 選項引數必須是 name=value 的形式" -#: builders/_epub_base.py:794 -#, python-format -msgid "writing %s file..." -msgstr "正在寫入 %s 檔案..." +#: cmd/build.py:383 +msgid "-A option argument must be in the form name=value" +msgstr "-A 選項引數必須是 name=value 的形式" -#: builders/dummy.py:19 -msgid "The dummy builder generates no files." -msgstr "虛擬建立器未產生任何檔案。" +#: cmd/quickstart.py:52 +msgid "automatically insert docstrings from modules" +msgstr "從模組自動插入說明字串" -#: builders/gettext.py:244 -#, python-format -msgid "The message catalogs are in %(outdir)s." -msgstr "訊息目錄是在 %(outdir)s" +#: cmd/quickstart.py:53 +msgid "automatically test code snippets in doctest blocks" +msgstr "在 doctest 區塊自動測試程式碼片段" -#: builders/gettext.py:266 -#, python-format -msgid "targets for %d template files" -msgstr "模板檔 %d 的目標" +#: cmd/quickstart.py:54 +msgid "link between Sphinx documentation of different projects" +msgstr "在不同專案的 Sphinx 說明文件中鏈接" -#: builders/gettext.py:271 -msgid "reading templates... " -msgstr "正在讀取模板..." +#: cmd/quickstart.py:55 +msgid "write \"todo\" entries that can be shown or hidden on build" +msgstr "寫入 \"todo\" 項目,它們可以在組建時被顯示或隱藏" -#: builders/gettext.py:307 -msgid "writing message catalogs... " -msgstr "正在寫入訊息目錄..." +#: cmd/quickstart.py:56 +msgid "checks for documentation coverage" +msgstr "核對說明文件的涵蓋範圍" -#: builders/singlehtml.py:35 -#, python-format -msgid "The HTML page is in %(outdir)s." -msgstr "HTML 頁面在 %(outdir)s 。" +#: cmd/quickstart.py:57 +msgid "include math, rendered as PNG or SVG images" +msgstr "包含 math,以 PNG 或 SVG 影像被呈現" -#: builders/singlehtml.py:171 -msgid "assembling single document" -msgstr "正在組合單一文件" +#: cmd/quickstart.py:58 +msgid "include math, rendered in the browser by MathJax" +msgstr "包含 math,被 MathJax 在瀏覽器中呈現" -#: builders/singlehtml.py:189 -msgid "writing additional files" -msgstr "正在寫入附加檔案" +#: cmd/quickstart.py:59 +msgid "conditional inclusion of content based on config values" +msgstr "根據組態值有條件地包含內容" -#: builders/linkcheck.py:77 -#, python-format -msgid "Look for any errors in the above output or in %(outdir)s/output.txt" -msgstr "尋找以上輸出或 %(outdir)s/output.txt 中的任何錯誤" +#: cmd/quickstart.py:60 +msgid "include links to the source code of documented Python objects" +msgstr "包含鏈接至已有說明文件的 Python 物件原始碼" -#: builders/linkcheck.py:149 -#, python-format -msgid "broken link: %s (%s)" -msgstr "錯誤連結: %s (%s)" +#: cmd/quickstart.py:61 +msgid "create .nojekyll file to publish the document on GitHub pages" +msgstr "建立 .nojekyll 檔案以在 GitHub 頁面發布文件" -#: builders/linkcheck.py:548 -#, python-format -msgid "Anchor '%s' not found" -msgstr "未找到錨 '%s'" +#: cmd/quickstart.py:111 +msgid "Please enter a valid path name." +msgstr "請輸入有效的路徑名稱。" -#: builders/linkcheck.py:758 -#, python-format -msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" -msgstr "在 linkcheck_allowed_redirects 編譯 regex 失敗: %r %s" +#: cmd/quickstart.py:127 +msgid "Please enter some text." +msgstr "請輸入一些文字。" -#: builders/text.py:29 +#: cmd/quickstart.py:134 #, python-format -msgid "The text files are in %(outdir)s." -msgstr "文字檔案在 %(outdir)s 。" +msgid "Please enter one of %s." +msgstr "請輸入一種 %s 。" -#: transforms/i18n.py:227 transforms/i18n.py:302 -#, python-brace-format -msgid "" -"inconsistent footnote references in translated message. original: {0}, " -"translated: {1}" -msgstr "被翻譯訊息中有不一致的註腳參照。原文: {0},譯文: {1}" +#: cmd/quickstart.py:142 +msgid "Please enter either 'y' or 'n'." +msgstr "請輸入 'y' 或 'n'。" -#: transforms/i18n.py:272 -#, python-brace-format -msgid "" -"inconsistent references in translated message. original: {0}, translated: " -"{1}" -msgstr "被翻譯訊息中有不一致的參照。原文: {0},譯文: {1}" +#: cmd/quickstart.py:148 +msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." +msgstr "請輸入檔案後綴,例如 '.rst' 或 '.txt'。" -#: transforms/i18n.py:322 -#, python-brace-format -msgid "" -"inconsistent citation references in translated message. original: {0}, " -"translated: {1}" -msgstr "被翻譯訊息中有不一致的參照。原文: {0},譯文: {1}" +#: cmd/quickstart.py:230 +#, python-format +msgid "Welcome to the Sphinx %s quickstart utility." +msgstr "歡迎進入 Sphinx %s 快速入門公用程式。" -#: transforms/i18n.py:344 -#, python-brace-format -msgid "" -"inconsistent term references in translated message. original: {0}, " -"translated: {1}" -msgstr "被翻譯訊息中有不一致的術語參照。原文: {0},譯文: {1}" - -#: builders/html/__init__.py:486 builders/latex/__init__.py:199 -#: transforms/__init__.py:129 writers/manpage.py:98 writers/texinfo.py:220 -#, python-format -msgid "%b %d, %Y" -msgstr "%Y 年 %m 月 %d 日" - -#: transforms/__init__.py:139 -msgid "could not calculate translation progress!" -msgstr "無法計算翻譯進度!" - -#: transforms/__init__.py:144 -msgid "no translated elements!" -msgstr "沒有已翻譯的元素!" - -#: transforms/__init__.py:253 -#, python-format +#: cmd/quickstart.py:235 msgid "" -"4 column based index found. It might be a bug of extensions you use: %r" -msgstr "找到基於 4 欄位的索引。它可能是您使用的擴充套件的一個錯誤: %r" +"Please enter values for the following settings (just press Enter to\n" +"accept a default value, if one is given in brackets)." +msgstr "請輸入以下設定值(如果括號中有給定預設值,請直接\n按下 Enter 以接受它)。" -#: transforms/__init__.py:294 +#: cmd/quickstart.py:242 #, python-format -msgid "Footnote [%s] is not referenced." -msgstr "註腳 [%s] 未被參照。" - -#: transforms/__init__.py:303 -msgid "Footnote [*] is not referenced." -msgstr "" - -#: transforms/__init__.py:314 -msgid "Footnote [#] is not referenced." -msgstr "註腳 [#] 未被參照。" - -#: _cli/__init__.py:73 -msgid "Usage:" -msgstr "使用:" +msgid "Selected root path: %s" +msgstr "被選的根路徑: %s" -#: _cli/__init__.py:75 -#, python-brace-format -msgid "{0} [OPTIONS] []" -msgstr "{0} [OPTIONS] []" +#: cmd/quickstart.py:245 +msgid "Enter the root path for documentation." +msgstr "輸入說明文件的根路徑。" -#: _cli/__init__.py:78 -msgid " The Sphinx documentation generator." -msgstr "Sphinx 說明文件產生器。" +#: cmd/quickstart.py:246 +msgid "Root path for the documentation" +msgstr "說明文件的根路徑" -#: _cli/__init__.py:87 -msgid "Commands:" -msgstr "指令:" +#: cmd/quickstart.py:255 +msgid "Error: an existing conf.py has been found in the selected root path." +msgstr "錯誤:在被選的根路徑找到一個已存在的 conf.py。" -#: _cli/__init__.py:98 -msgid "Options" -msgstr "選項" +#: cmd/quickstart.py:260 +msgid "sphinx-quickstart will not overwrite existing Sphinx projects." +msgstr "sphinx-quickstart 不會重寫已存在的 Sphinx 專案。" -#: _cli/__init__.py:113 _cli/__init__.py:181 -msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." -msgstr "如需更多資訊,請參閱 https://www.sphinx-doc.org/en/master/man/。" +#: cmd/quickstart.py:263 +msgid "Please enter a new root path (or just Enter to exit)" +msgstr "請輸入一個新的根路徑(或直接按 Enter 離開)" -#: _cli/__init__.py:171 -#, python-brace-format +#: cmd/quickstart.py:274 msgid "" -"{0}: error: {1}\n" -"Run '{0} --help' for information" -msgstr "{0}: 錯誤: {1}\n執行 '{0} --help' 取得更多資訊" +"You have two options for placing the build directory for Sphinx output.\n" +"Either, you use a directory \"_build\" within the root path, or you separate\n" +"\"source\" and \"build\" directories within the root path." +msgstr "您有兩個選擇來為 Sphinx 的輸出放置建立資料夾。\n其一,您可以在根路徑中使用資料夾 \"_build\",或者,\n您可以在根路徑中分離 \"source\" 和 \"build\" 資料夾。" -#: _cli/__init__.py:179 -msgid " Manage documentation with Sphinx." -msgstr "以 Sphinx 管理說明文件。" +#: cmd/quickstart.py:280 +msgid "Separate source and build directories (y/n)" +msgstr "分離來源並建立資料夾 (y/n)" -#: _cli/__init__.py:191 -msgid "Show the version and exit." -msgstr "顯示版本並離開。" +#: cmd/quickstart.py:287 +msgid "" +"Inside the root directory, two more directories will be created; \"_templates\"\n" +"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" +"files. You can enter another prefix (such as \".\") to replace the underscore." +msgstr "在根資料夾內部,另外兩個資料夾會被建立;\"_templates\" \n放置自訂的 HTML 模板,而 \"_static\" 放置自訂的表單及其他\n靜態檔案。您可以輸入另一個前綴(像是 \".\")來取代底線。" -#: _cli/__init__.py:199 -msgid "Show this message and exit." -msgstr "顯示此訊息並離開。" +#: cmd/quickstart.py:292 +msgid "Name prefix for templates and static dir" +msgstr "用於模板及靜態資料夾的名稱前綴" -#: _cli/__init__.py:203 -msgid "Logging" -msgstr "登錄" +#: cmd/quickstart.py:298 +msgid "" +"The project name will occur in several places in the built documentation." +msgstr "專案名稱會在已建立的說明文件中的多個位置出現。" -#: _cli/__init__.py:210 -msgid "Increase verbosity (can be repeated)" -msgstr "增加詳細內容(可以重複)" +#: cmd/quickstart.py:301 +msgid "Project name" +msgstr "專案名稱" -#: _cli/__init__.py:218 -msgid "Only print errors and warnings." -msgstr "只印出錯誤及警告。" +#: cmd/quickstart.py:303 +msgid "Author name(s)" +msgstr "作者姓名" -#: _cli/__init__.py:225 -msgid "No output at all" -msgstr "完全沒有輸出" +#: cmd/quickstart.py:309 +msgid "" +"Sphinx has the notion of a \"version\" and a \"release\" for the\n" +"software. Each version can have multiple releases. For example, for\n" +"Python the version is something like 2.5 or 3.0, while the release is\n" +"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" +"just set both to the same value." +msgstr "在 Sphinx 中,軟體具有「版本」和「發布版本」的概念。每個\n版本可以有多個發布版本。舉例來說,Python 的版本會像是 2.5 \n或 3.0,而發布版本則像是 2.5.1 或 3.0a1。如果您不需要這個雙\n重的結構,請直接將兩者設為相同的值。" -#: _cli/__init__.py:231 -msgid "" -msgstr "" +#: cmd/quickstart.py:316 +msgid "Project version" +msgstr "專案版本" -#: _cli/__init__.py:263 -msgid "See 'sphinx --help'.\n" -msgstr "請參閱 'sphinx --help'。\n" +#: cmd/quickstart.py:318 +msgid "Project release" +msgstr "專案發布版本" -#: environment/__init__.py:86 -msgid "new config" -msgstr "新的組態" +#: cmd/quickstart.py:324 +msgid "" +"If the documents are to be written in a language other than English,\n" +"you can select a language here by its language code. Sphinx will then\n" +"translate text that it generates into that language.\n" +"\n" +"For a list of supported codes, see\n" +"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." +msgstr "如果文件是被英語以外的語言被編寫,您可以根據它的語言碼\n在此選擇一個語言。Sphinx 會將它產生的文本翻譯為該語言。\n\n要了解可支援的語言碼列表,請參閱\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -#: environment/__init__.py:87 -msgid "config changed" -msgstr "組態已變更" +#: cmd/quickstart.py:332 +msgid "Project language" +msgstr "專案語言" -#: environment/__init__.py:88 -msgid "extensions changed" -msgstr "擴充套件已變更" +#: cmd/quickstart.py:340 +msgid "" +"The file name suffix for source files. Commonly, this is either \".txt\"\n" +"or \".rst\". Only files with this suffix are considered documents." +msgstr "用於原始檔的檔案名稱後綴。通常,這會是 \".txt\" 或 \".rst\"。\n只有具有此後綴的檔案才會被認為是文件。" -#: environment/__init__.py:253 -msgid "build environment version not current" -msgstr "建立環境的版本不是目前的" +#: cmd/quickstart.py:344 +msgid "Source file suffix" +msgstr "原始檔案後綴" -#: environment/__init__.py:255 -msgid "source directory has changed" -msgstr "來源資料夾已變更" +#: cmd/quickstart.py:350 +msgid "" +"One document is special in that it is considered the top node of the\n" +"\"contents tree\", that is, it is the root of the hierarchical structure\n" +"of the documents. Normally, this is \"index\", but if your \"index\"\n" +"document is a custom template, you can also set this to another filename." +msgstr "一份文件的特別之處在於它會被視為 \"contents tree\" 中的頂端\n節點,也就是說,它是文件階層結構中的根。通常,這會是 \n\"index\",但如果您的 \"index\" 文件是一個自訂的模板,您也可以\n將它設定為另一個檔名。" -#: environment/__init__.py:325 -#, python-format -msgid "The configuration has changed (1 option: %r)" -msgstr "" +#: cmd/quickstart.py:357 +msgid "Name of your master document (without suffix)" +msgstr "您的主要文件名稱(不含後綴)" -#: environment/__init__.py:330 +#: cmd/quickstart.py:368 #, python-format -msgid "The configuration has changed (%d options: %s)" -msgstr "" +msgid "" +"Error: the master file %s has already been found in the selected root path." +msgstr "錯誤:在被選的根路徑中已經找到主檔 %s 。" -#: environment/__init__.py:336 -#, python-format -msgid "The configuration has changed (%d options: %s, ...)" -msgstr "" +#: cmd/quickstart.py:374 +msgid "sphinx-quickstart will not overwrite the existing file." +msgstr "sphinx-quickstart 不會重寫已存在的檔案。" -#: environment/__init__.py:379 +#: cmd/quickstart.py:378 msgid "" -"This environment is incompatible with the selected builder, please choose " -"another doctree directory." -msgstr "這個環境與所選的 builder 不相容,請選擇另一個 doctree 資料夾。" - -#: environment/__init__.py:493 -#, python-format -msgid "Failed to scan documents in %s: %r" -msgstr "無法掃描 %s 中的文件: %r" +"Please enter a new file name, or rename the existing file and press Enter" +msgstr "請輸入一個新的檔案名稱,或將已存在的檔案重新命名並按下 Enter" -#: environment/__init__.py:658 ext/intersphinx/_resolve.py:234 -#, python-format -msgid "Domain %r is not registered" -msgstr "Domain %r 未被註冊" +#: cmd/quickstart.py:386 +msgid "Indicate which of the following Sphinx extensions should be enabled:" +msgstr "指示以下哪一個 Sphinx 擴充應該被啟用:" -#: environment/__init__.py:813 -msgid "document isn't included in any toctree" -msgstr "文件未被包含於任何 toctree" +#: cmd/quickstart.py:397 +msgid "" +"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " +"been deselected." +msgstr "註解:imgmath 和 mathjax 無法同時被啟用。imgmath 已被取消選擇。" -#: environment/__init__.py:859 -msgid "self referenced toctree found. Ignored." -msgstr "找到自我參照的 toctree。已略過。" +#: cmd/quickstart.py:407 +msgid "" +"A Makefile and a Windows command file can be generated for you so that you\n" +"only have to run e.g. `make html' instead of invoking sphinx-build\n" +"directly." +msgstr "會為您產生一個 Makefile 和一個 Windows 命令檔,所以\n您只需要執行像是 `make html' 而不必直接調用 \nsphinx-build。" -#: environment/__init__.py:889 -#, python-format -msgid "document is referenced in multiple toctrees: %s, selecting: %s <- %s" -msgstr "" +#: cmd/quickstart.py:412 +msgid "Create Makefile? (y/n)" +msgstr "是否建立 Makefile? (y/n)" -#: util/i18n.py:100 -#, python-format -msgid "reading error: %s, %s" -msgstr "讀取錯誤: %s, %s" +#: cmd/quickstart.py:416 +msgid "Create Windows command file? (y/n)" +msgstr "是否建立 Windows 命令檔?(y/n)" -#: util/i18n.py:113 +#: cmd/quickstart.py:468 ext/apidoc/_generate.py:76 #, python-format -msgid "writing error: %s, %s" -msgstr "寫入錯誤: %s, %s" +msgid "Creating file %s." +msgstr "正在建立檔案 %s 。" -#: util/i18n.py:146 +#: cmd/quickstart.py:473 ext/apidoc/_generate.py:73 #, python-format -msgid "locale_dir %s does not exist" -msgstr "locale_dir %s 不存在" +msgid "File %s already exists, skipping." +msgstr "檔案 %s 已存在,正在跳過。" -#: util/i18n.py:236 -#, python-format -msgid "Invalid Babel locale: %r." -msgstr "" +#: cmd/quickstart.py:516 +msgid "Finished: An initial directory structure has been created." +msgstr "已結束:一個初始資料夾結構已被建立。" -#: util/i18n.py:245 +#: cmd/quickstart.py:520 #, python-format msgid "" -"Invalid date format. Quote the string by single quote if you want to output " -"it directly: %s" -msgstr "無效的日期格式。如果您要直接將它輸出,則以單引號引用該字串: %s" +"You should now populate your master file %s and create other documentation\n" +"source files. " +msgstr "您現在應該在您的主檔 %s 輸入資料並建立其他說明文件\n原始檔。" -#: util/docfields.py:103 -#, python-format +#: cmd/quickstart.py:527 msgid "" -"Problem in %s domain: field is supposed to use role '%s', but that role is " -"not in the domain." -msgstr "在 %s domain 中的問題:欄位應該要用角色 '%s' ,但是那個角色並不在該 domain。" +"Use the Makefile to build the docs, like so:\n" +" make builder" +msgstr "使用 Makefile 來建立文件,像這樣:\n make builder" -#: util/nodes.py:423 +#: cmd/quickstart.py:531 #, python-format msgid "" -"%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead." -msgstr "%r 已棄用於索引項目(從項目 %r)。請改用 'pair: %s'。" - -#: util/nodes.py:490 -#, python-format -msgid "toctree contains ref to nonexisting file %r" -msgstr "toctree 包含了不存在的檔案 %r 的參照 " +"Use the sphinx-build command to build the docs, like so:\n" +" sphinx-build -b builder %s %s" +msgstr "使用 sphinx-build 命令來建立文件,像這樣:\n sphinx-build -b builder %s %s" -#: util/nodes.py:706 -#, python-format -msgid "exception while evaluating only directive expression: %s" -msgstr "在評估只有指令的運算式時發生例外: %s" +#: cmd/quickstart.py:538 +msgid "" +"where \"builder\" is one of the supported builders, e.g. html, latex or " +"linkcheck." +msgstr "在這裡 \"builder\" 是一種被支援的建立器,例如 html,latex 或 linkcheck。" -#: util/display.py:82 -msgid "skipped" -msgstr "已省略" +#: cmd/quickstart.py:573 +msgid "" +"\n" +"Generate required files for a Sphinx project.\n" +"\n" +"sphinx-quickstart is an interactive tool that asks some questions about your\n" +"project and then generates a complete documentation directory and sample\n" +"Makefile to be used with sphinx-build.\n" +msgstr "\n為 Sphinx 專案產生需要的檔案。\n\nsphinx-quickstart 是一個互動式工具,它會問一些關於您專案\n的問題,然後產生完整的說明文件資料夾以及用於 sphinx-build \n的 Makefile 樣本。\n" -#: util/display.py:87 -msgid "failed" -msgstr "失敗" +#: cmd/quickstart.py:592 +msgid "quiet mode" +msgstr "安靜模式" -#: util/osutil.py:131 +#: cmd/quickstart.py:602 +msgid "project root" +msgstr "專案根" + +#: cmd/quickstart.py:605 +msgid "Structure options" +msgstr "結構選項" + +#: cmd/quickstart.py:611 +msgid "if specified, separate source and build dirs" +msgstr "如果有指定,會分離來源資料夾和 build 資料夾" + +#: cmd/quickstart.py:617 +msgid "if specified, create build dir under source dir" +msgstr "如果有指定,會在來源資料夾下建立 build 資料夾" + +#: cmd/quickstart.py:623 +msgid "replacement for dot in _templates etc." +msgstr "在 _templates 等處進行句號的取代" + +#: cmd/quickstart.py:626 +msgid "Project basic options" +msgstr "專案基本選項" + +#: cmd/quickstart.py:628 +msgid "project name" +msgstr "專案名稱" + +#: cmd/quickstart.py:631 +msgid "author names" +msgstr "作者名" + +#: cmd/quickstart.py:638 +msgid "version of project" +msgstr "專案版本" + +#: cmd/quickstart.py:645 +msgid "release of project" +msgstr "專案發布" + +#: cmd/quickstart.py:652 +msgid "document language" +msgstr "文件語言" + +#: cmd/quickstart.py:655 +msgid "source file suffix" +msgstr "源始檔後綴" + +#: cmd/quickstart.py:658 +msgid "master document name" +msgstr "主文件名稱" + +#: cmd/quickstart.py:661 +msgid "use epub" +msgstr "使用 epub" + +#: cmd/quickstart.py:664 +msgid "Extension options" +msgstr "擴充套件選項" + +#: cmd/quickstart.py:671 #, python-format +msgid "enable %s extension" +msgstr "啟用 %s 擴充套件" + +#: cmd/quickstart.py:678 +msgid "enable arbitrary extensions" +msgstr "啟用任意的擴充套件" + +#: cmd/quickstart.py:681 +msgid "Makefile and Batchfile creation" +msgstr "Makefile 及 Batchfile 的建立" + +#: cmd/quickstart.py:687 +msgid "create makefile" +msgstr "建立 makefile" + +#: cmd/quickstart.py:693 +msgid "do not create makefile" +msgstr "不要建立 makefile" + +#: cmd/quickstart.py:700 +msgid "create batchfile" +msgstr "建立 batchfile" + +#: cmd/quickstart.py:706 +msgid "do not create batchfile" +msgstr "不要建立 batchfile" + +#: cmd/quickstart.py:715 +msgid "use make-mode for Makefile/make.bat" +msgstr "使用 make 模式於 Makefile/make.bat" + +#: cmd/quickstart.py:718 ext/apidoc/_cli.py:243 +msgid "Project templating" +msgstr "專案模板化中" + +#: cmd/quickstart.py:724 ext/apidoc/_cli.py:249 +msgid "template directory for template files" +msgstr "用於模板檔案的模板資料夾" + +#: cmd/quickstart.py:731 +msgid "define a template variable" +msgstr "定義一個模板變數" + +#: cmd/quickstart.py:767 +msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." +msgstr "\"quiet\" 被指定,但 \"project\" 或 \"author\" 的任一項未被指定。" + +#: cmd/quickstart.py:786 msgid "" -"Aborted attempted copy from %s to %s (the destination path has existing " -"data)." -msgstr "" +"Error: specified path is not a directory, or sphinx files already exist." +msgstr "錯誤:指定的路徑不是資料夾,或是 sphinx 檔案已經存在。" + +#: cmd/quickstart.py:793 +msgid "" +"sphinx-quickstart only generate into a empty directory. Please specify a new" +" root path." +msgstr "sphinx-quickstart 只能產生於空白資料夾中。請指定一個新的根路徑。" -#: util/docutils.py:309 +#: cmd/quickstart.py:810 #, python-format -msgid "unknown directive name: %s" -msgstr "" +msgid "Invalid template variable: %s" +msgstr "無效的模板變數: %s" + +#: directives/other.py:119 +#, python-format +msgid "toctree glob pattern %r didn't match any documents" +msgstr "toctree glob 型樣 %r 未匹配任何文件" -#: util/docutils.py:345 +#: directives/other.py:153 environment/adapters/toctree.py:372 #, python-format -msgid "unknown role name: %s" -msgstr "" +msgid "toctree contains reference to excluded document %r" +msgstr "toctree 包含了指向已排除文件的參照 %r" -#: util/docutils.py:789 +#: directives/other.py:156 #, python-format -msgid "unknown node type: %r" -msgstr "未知的節點型別: %r" +msgid "toctree contains reference to nonexisting document %r" +msgstr "toctree 包含了指向不存在文件的參照 %r" -#: util/fileutil.py:76 +#: directives/other.py:169 #, python-format +msgid "duplicated entry found in toctree: %s" +msgstr "在 toctree 中找到重複的項目: %s" + +#: directives/other.py:203 +msgid "Section author: " +msgstr "章節作者:" + +#: directives/other.py:205 +msgid "Module author: " +msgstr "模組作者:" + +#: directives/other.py:207 +msgid "Code author: " +msgstr "程式作者:" + +#: directives/other.py:209 +msgid "Author: " +msgstr "作者:" + +#: directives/other.py:269 +msgid ".. acks content is not a list" +msgstr ".. acks 的內容不是一個列表" + +#: directives/other.py:292 +msgid ".. hlist content is not a list" +msgstr ".. hlist 的內容不是一個列表" + +#: directives/patches.py:70 msgid "" -"Aborted attempted copy from rendered template %s to %s (the destination path" -" has existing data)." -msgstr "" +"\":file:\" option for csv-table directive now recognizes an absolute path as" +" a relative path from source directory. Please update your document." +msgstr "對 csv-table 指令的 \":file:\" 選項現在會將絕對路徑辨識為基於來源資料夾的相對路徑。請更新您的文件。" -#: util/fileutil.py:89 +#: directives/code.py:66 +msgid "non-whitespace stripped by dedent" +msgstr "非空白字元被凸排去除" + +#: directives/code.py:87 #, python-format -msgid "Writing evaluated template result to %s" -msgstr "" +msgid "Invalid caption: %s" +msgstr "無效標題:%s" -#: util/rst.py:73 +#: directives/code.py:131 directives/code.py:297 directives/code.py:483 #, python-format -msgid "default role %s not found" -msgstr "預設角色 %s 未找到" +msgid "line number spec is out of range(1-%d): %r" +msgstr "列號規格超出範圍 (1-%d): %r" -#: util/inventory.py:147 +#: directives/code.py:216 #, python-format -msgid "inventory <%s> contains duplicate definitions of %s" +msgid "Cannot use both \"%s\" and \"%s\" options" +msgstr "不能使用 \"%s\" 及 \"%s\" 兩個選項" + +#: directives/code.py:231 +#, python-format +msgid "Include file '%s' not found or reading it failed" msgstr "" -#: util/inventory.py:166 +#: directives/code.py:235 #, python-format -msgid "inventory <%s> contains multiple definitions for %s" +msgid "" +"Encoding %r used for reading included file '%s' seems to be wrong, try " +"giving an :encoding: option" msgstr "" -#: writers/latex.py:1097 writers/manpage.py:259 writers/texinfo.py:663 -msgid "Footnotes" -msgstr "註腳" +#: directives/code.py:276 +#, python-format +msgid "Object named %r not found in include file %r" +msgstr "名為 %r 的物件在 include 檔案 %r 中未找到" + +#: directives/code.py:309 +msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" +msgstr "無法以一個 \"lines\" 的互斥集使用 \"lineno-match\" " -#: writers/manpage.py:289 writers/text.py:945 +#: directives/code.py:314 #, python-format -msgid "[image: %s]" -msgstr "[圖片:%s]" +msgid "Line spec %r: no lines pulled from include file %r" +msgstr "Line spec %r: 從 include 檔案 %r 沒有提取任何一行" -#: writers/manpage.py:290 writers/text.py:946 -msgid "[image]" -msgstr "[圖片]" +#: builders/html/__init__.py:475 builders/latex/__init__.py:196 +#: transforms/__init__.py:134 writers/manpage.py:97 writers/texinfo.py:220 +#, python-format +msgid "%b %d, %Y" +msgstr "%Y 年 %m 月 %d 日" -#: builders/latex/__init__.py:206 domains/std/__init__.py:771 -#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:106 +#: builders/latex/__init__.py:203 domains/std/__init__.py:771 +#: domains/std/__init__.py:784 templates/latex/latex.tex.jinja:107 #: themes/basic/genindex-single.html:22 themes/basic/genindex-single.html:48 #: themes/basic/genindex-split.html:3 themes/basic/genindex-split.html:6 #: themes/basic/genindex.html:3 themes/basic/genindex.html:26 @@ -1751,11 +2298,15 @@ msgstr "[圖片]" msgid "Index" msgstr "索引" -#: writers/latex.py:743 writers/texinfo.py:646 +#: writers/latex.py:768 writers/texinfo.py:646 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "遇到的標題節點不是在段落、主題、表格、警告或側邊欄" +#: writers/latex.py:1118 writers/manpage.py:258 writers/texinfo.py:663 +msgid "Footnotes" +msgstr "註腳" + #: writers/texinfo.py:1217 msgid "caption not inside a figure." msgstr "標題不在圖之內。" @@ -1765,53 +2316,14 @@ msgstr "標題不在圖之內。" msgid "unimplemented node type: %r" msgstr "未實作的節點型別: %r" -#: writers/latex.py:361 -#, python-format -msgid "unknown %r toplevel_sectioning for class %r" -msgstr "未知的 %r toplevel_sectioning 對於 class %r" - -#: builders/latex/__init__.py:224 writers/latex.py:411 -#, python-format -msgid "no Babel option known for language %r" -msgstr "沒有語言 %r 已知的 Babel 選項" - -#: writers/latex.py:429 -msgid "too large :maxdepth:, ignored." -msgstr ":maxdepth: 太大,已略過。" - -#: writers/latex.py:591 -#, python-format -msgid "template %s not found; loading from legacy %s instead" -msgstr "" - -#: writers/latex.py:707 -msgid "document title is not a single Text node" -msgstr "文件標題不是單一的 Text 節點" - -#: writers/html5.py:572 writers/latex.py:1106 -#, python-format -msgid "unsupported rubric heading level: %s" -msgstr "" - -#: writers/latex.py:1183 -msgid "" -"both tabularcolumns and :widths: option are given. :widths: is ignored." -msgstr "同時被給予 tabularcolumns 及 :widths: 選項。 :widths: 已略過。" - -#: writers/latex.py:1580 +#: writers/manpage.py:288 writers/text.py:971 #, python-format -msgid "dimension unit %s is invalid. Ignored." -msgstr "維度單位 %s 是無效的。已略過。" - -#: writers/latex.py:1939 -#, python-format -msgid "unknown index entry type %s found" -msgstr "找到了未知的索引條目型別 %s" +msgid "[image: %s]" +msgstr "[圖片:%s]" -#: domains/math.py:128 writers/latex.py:2495 -#, python-format -msgid "Invalid math_eqref_format: %r" -msgstr "無效的 math_eqref_format: %r" +#: writers/manpage.py:289 writers/text.py:972 +msgid "[image]" +msgstr "[圖片]" #: writers/html5.py:96 writers/html5.py:105 msgid "Link to this definition" @@ -1839,9 +2351,14 @@ msgstr "連結到這個標頭" msgid "Link to this table" msgstr "連結到這個表格" -#: writers/html5.py:636 -msgid "Link to this code" -msgstr "連結到這個程式碼" +#: writers/html5.py:572 writers/latex.py:1127 +#, python-format +msgid "unsupported rubric heading level: %s" +msgstr "" + +#: writers/html5.py:636 +msgid "Link to this code" +msgstr "連結到這個程式碼" #: writers/html5.py:638 msgid "Link to this image" @@ -1855,794 +2372,478 @@ msgstr "連結到這個 toctree" msgid "Could not obtain image size. :scale: option is ignored." msgstr "無法取得圖片大小。 :scale: 選項已略過。" -#: domains/__init__.py:322 +#: writers/latex.py:386 #, python-format -msgid "%s %s" -msgstr "%s %s" +msgid "unknown %r toplevel_sectioning for class %r" +msgstr "未知的 %r toplevel_sectioning 對於 class %r" -#: domains/math.py:73 +#: builders/latex/__init__.py:221 writers/latex.py:436 #, python-format -msgid "duplicate label of equation %s, other instance in %s" -msgstr "重複公式標籤 %s,亦出現於 %s" +msgid "no Babel option known for language %r" +msgstr "沒有語言 %r 已知的 Babel 選項" -#: domains/javascript.py:182 -#, python-format -msgid "%s() (built-in function)" -msgstr "%s() (內建函式)" +#: writers/latex.py:454 +msgid "too large :maxdepth:, ignored." +msgstr ":maxdepth: 太大,已略過。" -#: domains/javascript.py:183 domains/python/__init__.py:287 +#: writers/latex.py:616 #, python-format -msgid "%s() (%s method)" -msgstr "%s() (%s 的方法)" +msgid "template %s not found; loading from legacy %s instead" +msgstr "" + +#: writers/latex.py:732 +msgid "document title is not a single Text node" +msgstr "文件標題不是單一的 Text 節點" + +#: writers/latex.py:1198 +msgid "" +"both tabularcolumns and :widths: option are given. :widths: is ignored." +msgstr "同時被給予 tabularcolumns 及 :widths: 選項。 :widths: 已略過。" -#: domains/javascript.py:185 +#: writers/latex.py:1228 #, python-format -msgid "%s() (class)" -msgstr "%s() (類別)" +msgid "" +"colspec %s was given which appears to use tabulary syntax. But this table " +"can not be rendered as a tabulary; the given colspec will be ignored." +msgstr "" -#: domains/javascript.py:187 +#: writers/latex.py:1615 #, python-format -msgid "%s (global variable or constant)" -msgstr "%s (全域變數或常數)" +msgid "dimension unit %s is invalid. Ignored." +msgstr "維度單位 %s 是無效的。已略過。" -#: domains/javascript.py:189 domains/python/__init__.py:378 +#: writers/latex.py:1950 #, python-format -msgid "%s (%s attribute)" -msgstr "%s (%s 的屬性)" +msgid "unknown index entry type %s found" +msgstr "找到了未知的索引條目型別 %s" -#: domains/javascript.py:273 -msgid "Arguments" -msgstr "引數" +#: _cli/__init__.py:73 +msgid "Usage:" +msgstr "使用:" -#: domains/cpp/__init__.py:489 domains/javascript.py:280 -msgid "Throws" -msgstr "拋出" +#: _cli/__init__.py:75 +#, python-brace-format +msgid "{0} [OPTIONS] []" +msgstr "{0} [OPTIONS] []" -#: domains/c/__init__.py:339 domains/cpp/__init__.py:502 -#: domains/javascript.py:287 domains/python/_object.py:221 -msgid "Returns" -msgstr "回傳" +#: _cli/__init__.py:78 +msgid " The Sphinx documentation generator." +msgstr "Sphinx 說明文件產生器。" -#: domains/c/__init__.py:345 domains/javascript.py:293 -#: domains/python/_object.py:227 -msgid "Return type" -msgstr "回傳型別" +#: _cli/__init__.py:87 +msgid "Commands:" +msgstr "指令:" -#: domains/javascript.py:370 -#, python-format -msgid "%s (module)" -msgstr "%s (模組)" +#: _cli/__init__.py:98 +msgid "Options" +msgstr "選項" -#: domains/c/__init__.py:751 domains/cpp/__init__.py:941 -#: domains/javascript.py:415 domains/python/__init__.py:740 -msgid "function" -msgstr "函式" +#: _cli/__init__.py:113 _cli/__init__.py:181 +msgid "For more information, visit https://www.sphinx-doc.org/en/master/man/." +msgstr "如需更多資訊,請參閱 https://www.sphinx-doc.org/en/master/man/。" -#: domains/javascript.py:416 domains/python/__init__.py:744 -msgid "method" -msgstr "方法" +#: _cli/__init__.py:171 +#, python-brace-format +msgid "" +"{0}: error: {1}\n" +"Run '{0} --help' for information" +msgstr "{0}: 錯誤: {1}\n執行 '{0} --help' 取得更多資訊" -#: domains/cpp/__init__.py:939 domains/javascript.py:417 -#: domains/python/__init__.py:742 -msgid "class" -msgstr "類別" +#: _cli/__init__.py:179 +msgid " Manage documentation with Sphinx." +msgstr "以 Sphinx 管理說明文件。" -#: domains/javascript.py:418 domains/python/__init__.py:741 -msgid "data" -msgstr "資料" +#: _cli/__init__.py:191 +msgid "Show the version and exit." +msgstr "顯示版本並離開。" -#: domains/javascript.py:419 domains/python/__init__.py:747 -msgid "attribute" -msgstr "屬性" +#: _cli/__init__.py:199 +msgid "Show this message and exit." +msgstr "顯示此訊息並離開。" -#: domains/javascript.py:420 domains/python/__init__.py:750 -msgid "module" -msgstr "模組" +#: _cli/__init__.py:203 +msgid "Logging" +msgstr "登錄" + +#: _cli/__init__.py:210 +msgid "Increase verbosity (can be repeated)" +msgstr "增加詳細內容(可以重複)" + +#: _cli/__init__.py:218 +msgid "Only print errors and warnings." +msgstr "只印出錯誤及警告。" + +#: _cli/__init__.py:225 +msgid "No output at all" +msgstr "完全沒有輸出" + +#: _cli/__init__.py:231 +msgid "" +msgstr "" + +#: _cli/__init__.py:263 +msgid "See 'sphinx --help'.\n" +msgstr "請參閱 'sphinx --help'。\n" + +#: transforms/i18n.py:230 transforms/i18n.py:305 +#, python-brace-format +msgid "" +"inconsistent footnote references in translated message. original: {0}, " +"translated: {1}" +msgstr "被翻譯訊息中有不一致的註腳參照。原文: {0},譯文: {1}" + +#: transforms/i18n.py:275 +#, python-brace-format +msgid "" +"inconsistent references in translated message. original: {0}, translated: " +"{1}" +msgstr "被翻譯訊息中有不一致的參照。原文: {0},譯文: {1}" + +#: transforms/i18n.py:325 +#, python-brace-format +msgid "" +"inconsistent citation references in translated message. original: {0}, " +"translated: {1}" +msgstr "被翻譯訊息中有不一致的參照。原文: {0},譯文: {1}" -#: domains/javascript.py:454 +#: transforms/i18n.py:347 +#, python-brace-format +msgid "" +"inconsistent term references in translated message. original: {0}, " +"translated: {1}" +msgstr "被翻譯訊息中有不一致的術語參照。原文: {0},譯文: {1}" + +#: transforms/__init__.py:144 +msgid "could not calculate translation progress!" +msgstr "無法計算翻譯進度!" + +#: transforms/__init__.py:149 +msgid "no translated elements!" +msgstr "沒有已翻譯的元素!" + +#: transforms/__init__.py:258 #, python-format -msgid "duplicate %s description of %s, other %s in %s" -msgstr "%s 的重複 %s 敘述,其他的 %s 在 %s" +msgid "" +"4 column based index found. It might be a bug of extensions you use: %r" +msgstr "找到基於 4 欄位的索引。它可能是您使用的擴充套件的一個錯誤: %r" -#: domains/changeset.py:26 +#: transforms/__init__.py:299 #, python-format -msgid "Added in version %s" -msgstr "在 %s 版被加入" +msgid "Footnote [%s] is not referenced." +msgstr "註腳 [%s] 未被參照。" + +#: transforms/__init__.py:308 +msgid "Footnote [*] is not referenced." +msgstr "" + +#: transforms/__init__.py:319 +msgid "Footnote [#] is not referenced." +msgstr "註腳 [#] 未被參照。" -#: domains/changeset.py:27 +#: util/inventory.py:147 #, python-format -msgid "Changed in version %s" -msgstr "在 %s 版的變更" +msgid "inventory <%s> contains duplicate definitions of %s" +msgstr "" -#: domains/changeset.py:28 +#: util/inventory.py:166 #, python-format -msgid "Deprecated since version %s" -msgstr "在 %s 版之後被棄用" +msgid "inventory <%s> contains multiple definitions for %s" +msgstr "" -#: domains/changeset.py:29 +#: util/i18n.py:100 #, python-format -msgid "Removed in version %s" -msgstr "在 %s 版被移除" +msgid "reading error: %s, %s" +msgstr "讀取錯誤: %s, %s" -#: domains/rst.py:131 domains/rst.py:190 +#: util/i18n.py:113 #, python-format -msgid "%s (directive)" -msgstr "%s (指令)" +msgid "writing error: %s, %s" +msgstr "寫入錯誤: %s, %s" -#: domains/rst.py:191 domains/rst.py:202 +#: util/i18n.py:146 #, python-format -msgid ":%s: (directive option)" -msgstr ":%s: (指令選項)" +msgid "locale_dir %s does not exist" +msgstr "locale_dir %s 不存在" -#: domains/rst.py:224 +#: util/i18n.py:244 #, python-format -msgid "%s (role)" -msgstr "%s (角色)" +msgid "Invalid Babel locale: %r." +msgstr "" -#: domains/rst.py:234 -msgid "directive" -msgstr "指令" +#: util/i18n.py:253 +#, python-format +msgid "" +"Invalid date format. Quote the string by single quote if you want to output " +"it directly: %s" +msgstr "無效的日期格式。如果您要直接將它輸出,則以單引號引用該字串: %s" -#: domains/rst.py:235 -msgid "directive-option" -msgstr "指令選項" +#: util/osutil.py:131 +#, python-format +msgid "" +"Aborted attempted copy from %s to %s (the destination path has existing " +"data)." +msgstr "" -#: domains/rst.py:236 -msgid "role" -msgstr "角色" +#: util/display.py:82 +msgid "skipped" +msgstr "已省略" -#: domains/rst.py:262 +#: util/display.py:87 +msgid "failed" +msgstr "失敗" + +#: util/docutils.py:325 #, python-format -msgid "duplicate description of %s %s, other instance in %s" -msgstr "%s %s 的重複敘述,其他的實例在 %s" +msgid "unknown directive name: %s" +msgstr "" -#: domains/citation.py:75 +#: util/docutils.py:361 #, python-format -msgid "duplicate citation %s, other instance in %s" -msgstr "重複的引用 %s,亦出現於 %s" +msgid "unknown role name: %s" +msgstr "" -#: domains/citation.py:92 +#: util/docutils.py:805 #, python-format -msgid "Citation [%s] is not referenced." -msgstr "引用 [%s] 未被參照。" +msgid "unknown node type: %r" +msgstr "未知的節點型別: %r" -#: locale/__init__.py:228 -msgid "Attention" -msgstr "注意" +#: util/fileutil.py:76 +#, python-format +msgid "" +"Aborted attempted copy from rendered template %s to %s (the destination path" +" has existing data)." +msgstr "" -#: locale/__init__.py:229 -msgid "Caution" -msgstr "警示" - -#: locale/__init__.py:230 -msgid "Danger" -msgstr "危險" - -#: locale/__init__.py:231 -msgid "Error" -msgstr "錯誤" - -#: locale/__init__.py:232 -msgid "Hint" -msgstr "提示" - -#: locale/__init__.py:233 -msgid "Important" -msgstr "重要" - -#: locale/__init__.py:234 -msgid "Note" -msgstr "備註" - -#: locale/__init__.py:235 -msgid "See also" -msgstr "也參考" - -#: locale/__init__.py:236 -msgid "Tip" -msgstr "小訣竅" - -#: locale/__init__.py:237 -msgid "Warning" -msgstr "警告" - -#: cmd/quickstart.py:52 -msgid "automatically insert docstrings from modules" -msgstr "從模組自動插入說明字串" - -#: cmd/quickstart.py:53 -msgid "automatically test code snippets in doctest blocks" -msgstr "在 doctest 區塊自動測試程式碼片段" - -#: cmd/quickstart.py:54 -msgid "link between Sphinx documentation of different projects" -msgstr "在不同專案的 Sphinx 說明文件中鏈接" - -#: cmd/quickstart.py:55 -msgid "write \"todo\" entries that can be shown or hidden on build" -msgstr "寫入 \"todo\" 項目,它們可以在組建時被顯示或隱藏" - -#: cmd/quickstart.py:56 -msgid "checks for documentation coverage" -msgstr "核對說明文件的涵蓋範圍" - -#: cmd/quickstart.py:57 -msgid "include math, rendered as PNG or SVG images" -msgstr "包含 math,以 PNG 或 SVG 影像被呈現" - -#: cmd/quickstart.py:58 -msgid "include math, rendered in the browser by MathJax" -msgstr "包含 math,被 MathJax 在瀏覽器中呈現" - -#: cmd/quickstart.py:59 -msgid "conditional inclusion of content based on config values" -msgstr "根據組態值有條件地包含內容" - -#: cmd/quickstart.py:60 -msgid "include links to the source code of documented Python objects" -msgstr "包含鏈接至已有說明文件的 Python 物件原始碼" - -#: cmd/quickstart.py:61 -msgid "create .nojekyll file to publish the document on GitHub pages" -msgstr "建立 .nojekyll 檔案以在 GitHub 頁面發布文件" - -#: cmd/quickstart.py:110 -msgid "Please enter a valid path name." -msgstr "請輸入有效的路徑名稱。" - -#: cmd/quickstart.py:126 -msgid "Please enter some text." -msgstr "請輸入一些文字。" - -#: cmd/quickstart.py:133 -#, python-format -msgid "Please enter one of %s." -msgstr "請輸入一種 %s 。" - -#: cmd/quickstart.py:141 -msgid "Please enter either 'y' or 'n'." -msgstr "請輸入 'y' 或 'n'。" - -#: cmd/quickstart.py:147 -msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." -msgstr "請輸入檔案後綴,例如 '.rst' 或 '.txt'。" - -#: cmd/quickstart.py:229 -#, python-format -msgid "Welcome to the Sphinx %s quickstart utility." -msgstr "歡迎進入 Sphinx %s 快速入門公用程式。" - -#: cmd/quickstart.py:234 -msgid "" -"Please enter values for the following settings (just press Enter to\n" -"accept a default value, if one is given in brackets)." -msgstr "請輸入以下設定值(如果括號中有給定預設值,請直接\n按下 Enter 以接受它)。" - -#: cmd/quickstart.py:241 -#, python-format -msgid "Selected root path: %s" -msgstr "被選的根路徑: %s" - -#: cmd/quickstart.py:244 -msgid "Enter the root path for documentation." -msgstr "輸入說明文件的根路徑。" - -#: cmd/quickstart.py:245 -msgid "Root path for the documentation" -msgstr "說明文件的根路徑" - -#: cmd/quickstart.py:254 -msgid "Error: an existing conf.py has been found in the selected root path." -msgstr "錯誤:在被選的根路徑找到一個已存在的 conf.py。" - -#: cmd/quickstart.py:259 -msgid "sphinx-quickstart will not overwrite existing Sphinx projects." -msgstr "sphinx-quickstart 不會重寫已存在的 Sphinx 專案。" - -#: cmd/quickstart.py:262 -msgid "Please enter a new root path (or just Enter to exit)" -msgstr "請輸入一個新的根路徑(或直接按 Enter 離開)" - -#: cmd/quickstart.py:273 -msgid "" -"You have two options for placing the build directory for Sphinx output.\n" -"Either, you use a directory \"_build\" within the root path, or you separate\n" -"\"source\" and \"build\" directories within the root path." -msgstr "您有兩個選擇來為 Sphinx 的輸出放置建立資料夾。\n其一,您可以在根路徑中使用資料夾 \"_build\",或者,\n您可以在根路徑中分離 \"source\" 和 \"build\" 資料夾。" - -#: cmd/quickstart.py:279 -msgid "Separate source and build directories (y/n)" -msgstr "分離來源並建立資料夾 (y/n)" - -#: cmd/quickstart.py:286 -msgid "" -"Inside the root directory, two more directories will be created; \"_templates\"\n" -"for custom HTML templates and \"_static\" for custom stylesheets and other static\n" -"files. You can enter another prefix (such as \".\") to replace the underscore." -msgstr "在根資料夾內部,另外兩個資料夾會被建立;\"_templates\" \n放置自訂的 HTML 模板,而 \"_static\" 放置自訂的表單及其他\n靜態檔案。您可以輸入另一個前綴(像是 \".\")來取代底線。" - -#: cmd/quickstart.py:291 -msgid "Name prefix for templates and static dir" -msgstr "用於模板及靜態資料夾的名稱前綴" - -#: cmd/quickstart.py:297 -msgid "" -"The project name will occur in several places in the built documentation." -msgstr "專案名稱會在已建立的說明文件中的多個位置出現。" - -#: cmd/quickstart.py:300 -msgid "Project name" -msgstr "專案名稱" - -#: cmd/quickstart.py:302 -msgid "Author name(s)" -msgstr "作者姓名" - -#: cmd/quickstart.py:308 -msgid "" -"Sphinx has the notion of a \"version\" and a \"release\" for the\n" -"software. Each version can have multiple releases. For example, for\n" -"Python the version is something like 2.5 or 3.0, while the release is\n" -"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" -"just set both to the same value." -msgstr "在 Sphinx 中,軟體具有「版本」和「發布版本」的概念。每個\n版本可以有多個發布版本。舉例來說,Python 的版本會像是 2.5 \n或 3.0,而發布版本則像是 2.5.1 或 3.0a1。如果您不需要這個雙\n重的結構,請直接將兩者設為相同的值。" - -#: cmd/quickstart.py:315 -msgid "Project version" -msgstr "專案版本" - -#: cmd/quickstart.py:317 -msgid "Project release" -msgstr "專案發布版本" - -#: cmd/quickstart.py:323 -msgid "" -"If the documents are to be written in a language other than English,\n" -"you can select a language here by its language code. Sphinx will then\n" -"translate text that it generates into that language.\n" -"\n" -"For a list of supported codes, see\n" -"https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." -msgstr "如果文件是被英語以外的語言被編寫,您可以根據它的語言碼\n在此選擇一個語言。Sphinx 會將它產生的文本翻譯為該語言。\n\n要了解可支援的語言碼列表,請參閱\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." - -#: cmd/quickstart.py:331 -msgid "Project language" -msgstr "專案語言" - -#: cmd/quickstart.py:339 -msgid "" -"The file name suffix for source files. Commonly, this is either \".txt\"\n" -"or \".rst\". Only files with this suffix are considered documents." -msgstr "用於原始檔的檔案名稱後綴。通常,這會是 \".txt\" 或 \".rst\"。\n只有具有此後綴的檔案才會被認為是文件。" - -#: cmd/quickstart.py:343 -msgid "Source file suffix" -msgstr "原始檔案後綴" - -#: cmd/quickstart.py:349 -msgid "" -"One document is special in that it is considered the top node of the\n" -"\"contents tree\", that is, it is the root of the hierarchical structure\n" -"of the documents. Normally, this is \"index\", but if your \"index\"\n" -"document is a custom template, you can also set this to another filename." -msgstr "一份文件的特別之處在於它會被視為 \"contents tree\" 中的頂端\n節點,也就是說,它是文件階層結構中的根。通常,這會是 \n\"index\",但如果您的 \"index\" 文件是一個自訂的模板,您也可以\n將它設定為另一個檔名。" - -#: cmd/quickstart.py:356 -msgid "Name of your master document (without suffix)" -msgstr "您的主要文件名稱(不含後綴)" - -#: cmd/quickstart.py:367 -#, python-format -msgid "" -"Error: the master file %s has already been found in the selected root path." -msgstr "錯誤:在被選的根路徑中已經找到主檔 %s 。" - -#: cmd/quickstart.py:373 -msgid "sphinx-quickstart will not overwrite the existing file." -msgstr "sphinx-quickstart 不會重寫已存在的檔案。" - -#: cmd/quickstart.py:377 -msgid "" -"Please enter a new file name, or rename the existing file and press Enter" -msgstr "請輸入一個新的檔案名稱,或將已存在的檔案重新命名並按下 Enter" - -#: cmd/quickstart.py:385 -msgid "Indicate which of the following Sphinx extensions should be enabled:" -msgstr "指示以下哪一個 Sphinx 擴充應該被啟用:" - -#: cmd/quickstart.py:396 -msgid "" -"Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " -"been deselected." -msgstr "註解:imgmath 和 mathjax 無法同時被啟用。imgmath 已被取消選擇。" - -#: cmd/quickstart.py:406 -msgid "" -"A Makefile and a Windows command file can be generated for you so that you\n" -"only have to run e.g. `make html' instead of invoking sphinx-build\n" -"directly." -msgstr "會為您產生一個 Makefile 和一個 Windows 命令檔,所以\n您只需要執行像是 `make html' 而不必直接調用 \nsphinx-build。" - -#: cmd/quickstart.py:411 -msgid "Create Makefile? (y/n)" -msgstr "是否建立 Makefile? (y/n)" - -#: cmd/quickstart.py:415 -msgid "Create Windows command file? (y/n)" -msgstr "是否建立 Windows 命令檔?(y/n)" - -#: cmd/quickstart.py:467 ext/apidoc/_generate.py:76 -#, python-format -msgid "Creating file %s." -msgstr "正在建立檔案 %s 。" - -#: cmd/quickstart.py:472 ext/apidoc/_generate.py:73 -#, python-format -msgid "File %s already exists, skipping." -msgstr "檔案 %s 已存在,正在跳過。" - -#: cmd/quickstart.py:515 -msgid "Finished: An initial directory structure has been created." -msgstr "已結束:一個初始資料夾結構已被建立。" - -#: cmd/quickstart.py:519 +#: util/fileutil.py:89 #, python-format -msgid "" -"You should now populate your master file %s and create other documentation\n" -"source files. " -msgstr "您現在應該在您的主檔 %s 輸入資料並建立其他說明文件\n原始檔。" - -#: cmd/quickstart.py:526 -msgid "" -"Use the Makefile to build the docs, like so:\n" -" make builder" -msgstr "使用 Makefile 來建立文件,像這樣:\n make builder" +msgid "Writing evaluated template result to %s" +msgstr "" -#: cmd/quickstart.py:530 +#: util/docfields.py:103 #, python-format msgid "" -"Use the sphinx-build command to build the docs, like so:\n" -" sphinx-build -b builder %s %s" -msgstr "使用 sphinx-build 命令來建立文件,像這樣:\n sphinx-build -b builder %s %s" - -#: cmd/quickstart.py:537 -msgid "" -"where \"builder\" is one of the supported builders, e.g. html, latex or " -"linkcheck." -msgstr "在這裡 \"builder\" 是一種被支援的建立器,例如 html,latex 或 linkcheck。" - -#: cmd/quickstart.py:572 -msgid "" -"\n" -"Generate required files for a Sphinx project.\n" -"\n" -"sphinx-quickstart is an interactive tool that asks some questions about your\n" -"project and then generates a complete documentation directory and sample\n" -"Makefile to be used with sphinx-build.\n" -msgstr "\n為 Sphinx 專案產生需要的檔案。\n\nsphinx-quickstart 是一個互動式工具,它會問一些關於您專案\n的問題,然後產生完整的說明文件資料夾以及用於 sphinx-build \n的 Makefile 樣本。\n" - -#: cmd/build.py:73 cmd/quickstart.py:581 ext/apidoc/_cli.py:27 -#: ext/autosummary/generate.py:835 -msgid "For more information, visit ." -msgstr "需要更多資訊,請拜訪 ." - -#: cmd/quickstart.py:591 -msgid "quiet mode" -msgstr "安靜模式" - -#: cmd/quickstart.py:601 -msgid "project root" -msgstr "專案根" - -#: cmd/quickstart.py:604 -msgid "Structure options" -msgstr "結構選項" - -#: cmd/quickstart.py:610 -msgid "if specified, separate source and build dirs" -msgstr "如果有指定,會分離來源資料夾和 build 資料夾" - -#: cmd/quickstart.py:616 -msgid "if specified, create build dir under source dir" -msgstr "如果有指定,會在來源資料夾下建立 build 資料夾" - -#: cmd/quickstart.py:622 -msgid "replacement for dot in _templates etc." -msgstr "在 _templates 等處進行句號的取代" - -#: cmd/quickstart.py:625 -msgid "Project basic options" -msgstr "專案基本選項" - -#: cmd/quickstart.py:627 -msgid "project name" -msgstr "專案名稱" - -#: cmd/quickstart.py:630 -msgid "author names" -msgstr "作者名" - -#: cmd/quickstart.py:637 -msgid "version of project" -msgstr "專案版本" - -#: cmd/quickstart.py:644 -msgid "release of project" -msgstr "專案發布" - -#: cmd/quickstart.py:651 -msgid "document language" -msgstr "文件語言" - -#: cmd/quickstart.py:654 -msgid "source file suffix" -msgstr "源始檔後綴" - -#: cmd/quickstart.py:657 -msgid "master document name" -msgstr "主文件名稱" - -#: cmd/quickstart.py:660 -msgid "use epub" -msgstr "使用 epub" - -#: cmd/quickstart.py:663 -msgid "Extension options" -msgstr "擴充套件選項" +"Problem in %s domain: field is supposed to use role '%s', but that role is " +"not in the domain." +msgstr "在 %s domain 中的問題:欄位應該要用角色 '%s' ,但是那個角色並不在該 domain。" -#: cmd/quickstart.py:670 +#: util/rst.py:73 #, python-format -msgid "enable %s extension" -msgstr "啟用 %s 擴充套件" - -#: cmd/quickstart.py:677 -msgid "enable arbitrary extensions" -msgstr "啟用任意的擴充套件" - -#: cmd/quickstart.py:680 -msgid "Makefile and Batchfile creation" -msgstr "Makefile 及 Batchfile 的建立" - -#: cmd/quickstart.py:686 -msgid "create makefile" -msgstr "建立 makefile" - -#: cmd/quickstart.py:692 -msgid "do not create makefile" -msgstr "不要建立 makefile" - -#: cmd/quickstart.py:699 -msgid "create batchfile" -msgstr "建立 batchfile" - -#: cmd/quickstart.py:705 -msgid "do not create batchfile" -msgstr "不要建立 batchfile" - -#: cmd/quickstart.py:714 -msgid "use make-mode for Makefile/make.bat" -msgstr "使用 make 模式於 Makefile/make.bat" - -#: cmd/quickstart.py:717 ext/apidoc/_cli.py:243 -msgid "Project templating" -msgstr "專案模板化中" - -#: cmd/quickstart.py:723 ext/apidoc/_cli.py:249 -msgid "template directory for template files" -msgstr "用於模板檔案的模板資料夾" - -#: cmd/quickstart.py:730 -msgid "define a template variable" -msgstr "定義一個模板變數" - -#: cmd/quickstart.py:766 -msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." -msgstr "\"quiet\" 被指定,但 \"project\" 或 \"author\" 的任一項未被指定。" - -#: cmd/quickstart.py:785 -msgid "" -"Error: specified path is not a directory, or sphinx files already exist." -msgstr "錯誤:指定的路徑不是資料夾,或是 sphinx 檔案已經存在。" +msgid "default role %s not found" +msgstr "預設角色 %s 未找到" -#: cmd/quickstart.py:792 +#: util/nodes.py:462 +#, python-format msgid "" -"sphinx-quickstart only generate into a empty directory. Please specify a new" -" root path." -msgstr "sphinx-quickstart 只能產生於空白資料夾中。請指定一個新的根路徑。" +"%r is no longer supported for index entries (from entry %r). Use 'pair: %s' " +"instead." +msgstr "" -#: cmd/quickstart.py:809 +#: util/nodes.py:523 #, python-format -msgid "Invalid template variable: %s" -msgstr "無效的模板變數: %s" +msgid "toctree contains ref to nonexisting file %r" +msgstr "toctree 包含了不存在的檔案 %r 的參照 " -#: cmd/build.py:64 -msgid "job number should be a positive number" -msgstr "工件編號應該是一個正數" +#: util/nodes.py:739 +#, python-format +msgid "exception while evaluating only directive expression: %s" +msgstr "在評估只有指令的運算式時發生例外: %s" -#: cmd/build.py:74 -msgid "" -"\n" -"Generate documentation from source files.\n" -"\n" -"sphinx-build generates documentation from the files in SOURCEDIR and places it\n" -"in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" -"settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" -"including 'conf.py'\n" -"\n" -"sphinx-build can create documentation in different formats. A format is\n" -"selected by specifying the builder name on the command line; it defaults to\n" -"HTML. Builders can also perform other tasks related to documentation\n" -"processing.\n" -"\n" -"By default, everything that is outdated is built. Output only for selected\n" -"files can be built by specifying individual filenames.\n" -msgstr "\n從原始檔案產生說明文件。\n\nsphinx-build 會從 SOURCEDIR 中的檔案來產生說明文件,並\n將它置放於 OUTPUTDIR。它會在 SOURCEDIR 中尋找 'conf.py' \n內的組態設定。'sphinx-quickstart' 工具可以用來產生模板檔案,\n包括 'conf.py'\n\nsphinx-build 能以不同的格式建立說明文件。在命令列指定建立\n器的名稱來選擇一種格式;其預設值為 HTML。建立器也能執行\n與處理說明文件有關的其他任務。\n\n在預設情況,所有舊的文件都已經被建立。指定個別的檔名,\n可以在建立時僅限於輸出所選的檔案。\n" +#: templates/latex/longtable.tex.jinja:52 +#: templates/latex/sphinxmessages.sty.jinja:8 +msgid "continued from previous page" +msgstr "繼續上一頁" -#: cmd/build.py:100 -msgid "path to documentation source files" -msgstr "到說明文件原始檔案的路徑" +#: templates/latex/longtable.tex.jinja:63 +#: templates/latex/sphinxmessages.sty.jinja:9 +msgid "continues on next page" +msgstr "繼續下一頁" -#: cmd/build.py:103 -msgid "path to output directory" -msgstr "到輸出資料夾的路徑" +#: templates/latex/sphinxmessages.sty.jinja:10 +msgid "Non-alphabetical" +msgstr "非依字母順序" -#: cmd/build.py:109 -msgid "" -"(optional) a list of specific files to rebuild. Ignored if --write-all is " -"specified" -msgstr "(選用)一份要重建的特定檔案清單。如果已指定 --write-all,則會被忽略。" +#: environment/adapters/indexentries.py:267 +#: templates/latex/sphinxmessages.sty.jinja:11 +msgid "Symbols" +msgstr "符號" -#: cmd/build.py:114 -msgid "general options" -msgstr "一般選項" +#: templates/latex/sphinxmessages.sty.jinja:12 +msgid "Numbers" +msgstr "數字" -#: cmd/build.py:121 -msgid "builder to use (default: 'html')" -msgstr "要使用的建立器(預設值:'html')" +#: templates/latex/sphinxmessages.sty.jinja:13 +msgid "page" +msgstr "頁" -#: cmd/build.py:131 -msgid "" -"run in parallel with N processes, when possible. 'auto' uses the number of " -"CPU cores" -msgstr "如果可以的話,N 個程序會平行執行。'auto' 會使用 CPU 核心的數量" +#: builders/latex/__init__.py:206 templates/latex/latex.tex.jinja:92 +msgid "Release" +msgstr "發佈" -#: cmd/build.py:140 -msgid "write all files (default: only write new and changed files)" -msgstr "寫入所有檔案(預設:只寫入新增及已變更檔案)" +#: transforms/post_transforms/images.py:79 +#, python-format +msgid "Could not fetch remote image: %s [%s]" +msgstr "無法提取遠端圖片: %s [%s]" -#: cmd/build.py:147 -msgid "don't use a saved environment, always read all files" -msgstr "不要使用已儲存的環境,永遠要讀取全部的檔案" +#: transforms/post_transforms/images.py:96 +#, python-format +msgid "Could not fetch remote image: %s [%d]" +msgstr "無法提取遠端圖片: %s [%d]" -#: cmd/build.py:150 -msgid "path options" -msgstr "路徑選項" +#: transforms/post_transforms/images.py:143 +#, python-format +msgid "Unknown image format: %s..." +msgstr "未知的圖片格式: %s..." -#: cmd/build.py:157 +#: transforms/post_transforms/__init__.py:88 msgid "" -"directory for doctree and environment files (default: OUTPUT_DIR/.doctrees)" -msgstr "包含 doctree 及環境檔案的資料夾(預設值:OUTPUT_DIR/.doctrees)" +"Could not determine the fallback text for the cross-reference. Might be a " +"bug." +msgstr "無法為交互參照決定備用文字。可能是個錯誤。" -#: cmd/build.py:166 -msgid "directory for the configuration file (conf.py) (default: SOURCE_DIR)" -msgstr "包含組態檔 (conf.py) 的資料夾(預設值:SOURCE_DIR)" +#: transforms/post_transforms/__init__.py:233 +#, python-format +msgid "more than one target found for 'any' cross-reference %r: could be %s" +msgstr "為「任一個」交互參照 %r 找到多於一個目標:可能是 %s" -#: cmd/build.py:175 -msgid "use no configuration file, only use settings from -D options" -msgstr "不使用組態檔,只使用 -D 選項中的設定" +#: transforms/post_transforms/__init__.py:291 +#, python-format +msgid "%s:%s reference target not found: %s" +msgstr "%s:%s 參照目標未找到: %s" -#: cmd/build.py:184 -msgid "override a setting in configuration file" -msgstr "在組態檔案中置換一項設定" +#: transforms/post_transforms/__init__.py:297 +#, python-format +msgid "%r reference target not found: %s" +msgstr "%r 參照目標未找到: %s" -#: cmd/build.py:193 -msgid "pass a value into HTML templates" -msgstr "傳遞一個值進入 HTML 模板" +#: _cli/util/errors.py:190 +msgid "Interrupted!" +msgstr "已中斷!" -#: cmd/build.py:202 -msgid "define tag: include \"only\" blocks with TAG" -msgstr "定義 tag:「只」包含有 TAG 的區塊" +#: _cli/util/errors.py:194 +msgid "reStructuredText markup error!" +msgstr "" -#: cmd/build.py:209 -msgid "nitpicky mode: warn about all missing references" +#: _cli/util/errors.py:200 +msgid "Encoding error!" msgstr "" -#: cmd/build.py:212 -msgid "console output options" -msgstr "控制台輸出選項" +#: _cli/util/errors.py:203 +msgid "Recursion error!" +msgstr "" -#: cmd/build.py:219 -msgid "increase verbosity (can be repeated)" -msgstr "增加贅言(可以被重複)" +#: _cli/util/errors.py:207 +msgid "" +"This can happen with very large or deeply nested source files. You can " +"carefully increase the default Python recursion limit of 1,000 in conf.py " +"with e.g.:" +msgstr "" -#: cmd/build.py:226 ext/apidoc/_cli.py:66 -msgid "no output on stdout, just warnings on stderr" -msgstr "在 stdout 無輸出,只有在 stderr 的警告" +#: _cli/util/errors.py:227 +msgid "Starting debugger:" +msgstr "" -#: cmd/build.py:233 -msgid "no output at all, not even warnings" -msgstr "完全沒有輸出,也沒有警告" +#: _cli/util/errors.py:235 +msgid "The full traceback has been saved in:" +msgstr "完整的回溯已儲存於:" -#: cmd/build.py:241 -msgid "do emit colored output (default: auto-detect)" -msgstr "執行 emit 彩色輸出(預設值:auto-detect)" +#: _cli/util/errors.py:240 +msgid "" +"To report this error to the developers, please open an issue at " +". Thanks!" +msgstr "要向開發者回報此錯誤,請在 開啟一個 issue。謝謝!" -#: cmd/build.py:249 -msgid "do not emit colored output (default: auto-detect)" -msgstr "不執行 emit 彩色輸出(預設值:auto-detect)" +#: _cli/util/errors.py:246 +msgid "" +"Please also report this if it was a user error, so that a better error " +"message can be provided next time." +msgstr "如果這是一個使用者錯誤,請一併回報,如此下次才能提供較佳的錯誤訊息。" -#: cmd/build.py:252 -msgid "warning control options" -msgstr "控制警告的選項" +#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 +msgid "Collapse sidebar" +msgstr "收合側邊欄" -#: cmd/build.py:258 -msgid "write warnings (and errors) to given file" -msgstr "寫入警告(及錯誤)至給定的檔案" +#: themes/basic/layout.html:18 +msgid "Navigation" +msgstr "瀏覽" -#: cmd/build.py:265 -msgid "turn warnings into errors" -msgstr "將警告轉為錯誤" +#: themes/basic/layout.html:115 +#, python-format +msgid "Search within %(docstitle)s" +msgstr "在 %(docstitle)s 中搜尋" -#: cmd/build.py:273 -msgid "show full traceback on exception" -msgstr "在例外中顯示完整的回溯" +#: themes/basic/layout.html:124 +msgid "About these documents" +msgstr "關於這些文件" -#: cmd/build.py:276 -msgid "run Pdb on exception" -msgstr "在例外中執行 Pdb" +#: themes/agogo/layout.html:34 themes/basic/layout.html:130 +#: themes/basic/search.html:3 themes/basic/search.html:15 +msgid "Search" +msgstr "搜尋" -#: cmd/build.py:282 -msgid "raise an exception on warnings" -msgstr "" +#: themes/basic/layout.html:133 themes/basic/layout.html:177 +#: themes/basic/layout.html:179 +msgid "Copyright" +msgstr "版權所有" -#: cmd/build.py:325 -msgid "cannot combine -a option and filenames" -msgstr "無法合併 -a 選項及檔名" +#: themes/basic/layout.html:183 themes/basic/layout.html:189 +#, python-format +msgid "© %(copyright_prefix)s %(copyright)s." +msgstr "© %(copyright_prefix)s %(copyright)s." -#: cmd/build.py:357 +#: themes/basic/layout.html:201 #, python-format -msgid "cannot open warning file '%s': %s" -msgstr "" +msgid "Last updated on %(last_updated)s." +msgstr "最後更新於 %(last_updated)s。" -#: cmd/build.py:376 -msgid "-D option argument must be in the form name=value" -msgstr "-D 選項引數必須是 name=value 的形式" +#: themes/basic/layout.html:204 +#, python-format +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "使用 Sphinx %(sphinx_version)s 建立。" -#: cmd/build.py:383 -msgid "-A option argument must be in the form name=value" -msgstr "-A 選項引數必須是 name=value 的形式" +#: themes/basic/relations.html:4 +msgid "Previous topic" +msgstr "上個主題" + +#: themes/basic/relations.html:6 +msgid "previous chapter" +msgstr "上一章" + +#: themes/basic/relations.html:11 +msgid "Next topic" +msgstr "下個主題" -#: themes/classic/layout.html:12 themes/classic/static/sidebar.js.jinja:51 -msgid "Collapse sidebar" -msgstr "收合側邊欄" +#: themes/basic/relations.html:13 +msgid "next chapter" +msgstr "下一章" -#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 -#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 -msgid "Table of Contents" -msgstr "目錄" +#: themes/basic/genindex-single.html:26 +#, python-format +msgid "Index – %(key)s" +msgstr "" -#: themes/agogo/layout.html:34 themes/basic/layout.html:130 -#: themes/basic/search.html:3 themes/basic/search.html:15 -msgid "Search" -msgstr "搜尋" +#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 +#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 +msgid "Full index on one page" +msgstr "單頁完整索引" -#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 -#: themes/basic/searchfield.html:12 -msgid "Go" -msgstr "前往" +#: themes/basic/sourcelink.html:4 +msgid "This Page" +msgstr "本頁" #: themes/agogo/layout.html:81 themes/basic/sourcelink.html:7 msgid "Show Source" msgstr "顯示原始碼" -#: themes/haiku/layout.html:16 -msgid "Contents" -msgstr "內容" +#: themes/basic/searchbox.html:4 +msgid "Quick search" +msgstr "快速搜尋" -#: themes/basic/opensearch.xml:4 -#, python-format -msgid "Search %(docstitle)s" -msgstr "搜尋 %(docstitle)s" +#: themes/agogo/layout.html:37 themes/basic/searchbox.html:8 +#: themes/basic/searchfield.html:12 +msgid "Go" +msgstr "前往" #: themes/basic/defindex.html:4 msgid "Overview" @@ -2689,7 +2890,7 @@ msgstr "全域模組索引" msgid "quick access to all modules" msgstr "迅速找到所有模組" -#: builders/html/__init__.py:507 themes/basic/defindex.html:23 +#: builders/html/__init__.py:496 themes/basic/defindex.html:23 msgid "General Index" msgstr "總索引" @@ -2697,23 +2898,15 @@ msgstr "總索引" msgid "all functions, classes, terms" msgstr "所有函式、類別、術語" -#: themes/basic/sourcelink.html:4 -msgid "This Page" -msgstr "本頁" +#: themes/agogo/layout.html:29 themes/basic/globaltoc.html:2 +#: themes/basic/localtoc.html:4 themes/scrolls/layout.html:32 +msgid "Table of Contents" +msgstr "目錄" -#: themes/basic/genindex-single.html:26 +#: themes/basic/opensearch.xml:4 #, python-format -msgid "Index – %(key)s" -msgstr "" - -#: themes/basic/genindex-single.html:54 themes/basic/genindex-split.html:16 -#: themes/basic/genindex-split.html:30 themes/basic/genindex.html:65 -msgid "Full index on one page" -msgstr "單頁完整索引" - -#: themes/basic/searchbox.html:4 -msgid "Quick search" -msgstr "快速搜尋" +msgid "Search %(docstitle)s" +msgstr "搜尋 %(docstitle)s" #: themes/basic/genindex-split.html:8 msgid "Index pages by letter" @@ -2723,57 +2916,6 @@ msgstr "按字母索引頁面" msgid "can be huge" msgstr "可能會很大" -#: themes/basic/relations.html:4 -msgid "Previous topic" -msgstr "上個主題" - -#: themes/basic/relations.html:6 -msgid "previous chapter" -msgstr "上一章" - -#: themes/basic/relations.html:11 -msgid "Next topic" -msgstr "下個主題" - -#: themes/basic/relations.html:13 -msgid "next chapter" -msgstr "下一章" - -#: themes/basic/layout.html:18 -msgid "Navigation" -msgstr "瀏覽" - -#: themes/basic/layout.html:115 -#, python-format -msgid "Search within %(docstitle)s" -msgstr "在 %(docstitle)s 中搜尋" - -#: themes/basic/layout.html:124 -msgid "About these documents" -msgstr "關於這些文件" - -#: themes/basic/layout.html:133 themes/basic/layout.html:177 -#: themes/basic/layout.html:179 -msgid "Copyright" -msgstr "版權所有" - -#: themes/basic/layout.html:183 themes/basic/layout.html:189 -#, python-format -msgid "© %(copyright_prefix)s %(copyright)s." -msgstr "© %(copyright_prefix)s %(copyright)s." - -#: themes/basic/layout.html:201 -#, python-format -msgid "Last updated on %(last_updated)s." -msgstr "最後更新於 %(last_updated)s。" - -#: themes/basic/layout.html:204 -#, python-format -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "使用 Sphinx %(sphinx_version)s 建立。" - #: themes/basic/search.html:20 msgid "" "Please activate JavaScript to enable the search\n" @@ -2790,43 +2932,42 @@ msgstr "搜尋多個關鍵字時,只會顯示包含所有關鍵字的結果。 msgid "search" msgstr "搜尋" -#: themes/basic/static/sphinx_highlight.js:112 -msgid "Hide Search Matches" -msgstr "隱藏符合搜尋" +#: themes/haiku/layout.html:16 +msgid "Contents" +msgstr "內容" -#: themes/basic/static/searchtools.js:117 +#: themes/basic/static/searchtools.js:132 msgid "Search Results" msgstr "搜尋結果" -#: themes/basic/static/searchtools.js:119 +#: themes/basic/static/searchtools.js:134 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "您的搜尋找不到任何滿足條件的文件。請確定是否所有的搜尋詞都正確地拼寫且您已選擇足夠的分類。" -#: themes/basic/static/searchtools.js:123 +#: themes/basic/static/searchtools.js:138 #, python-brace-format msgid "Search finished, found one page matching the search query." msgid_plural "" "Search finished, found ${resultCount} pages matching the search query." msgstr[0] "" -#: themes/basic/static/searchtools.js:253 +#: themes/basic/static/searchtools.js:276 msgid "Searching" msgstr "搜尋中" -#: themes/basic/static/searchtools.js:270 +#: themes/basic/static/searchtools.js:293 msgid "Preparing search..." msgstr "準備搜尋中…" -#: themes/basic/static/searchtools.js:474 +#: themes/basic/static/searchtools.js:526 msgid ", in " msgstr ",於 " -#: themes/basic/changes/rstsource.html:5 -#, python-format -msgid "%(filename)s — %(docstitle)s" -msgstr "%(filename)s — %(docstitle)s" +#: themes/basic/static/sphinx_highlight.js:112 +msgid "Hide Search Matches" +msgstr "隱藏符合搜尋" #: themes/basic/changes/frameset.html:5 #: themes/basic/changes/versionchanges.html:12 @@ -2834,6 +2975,11 @@ msgstr "%(filename)s — %(docstitle)s" msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "於 %(version)s 版中的所有變更 — %(docstitle)s" +#: themes/basic/changes/rstsource.html:5 +#, python-format +msgid "%(filename)s — %(docstitle)s" +msgstr "%(filename)s — %(docstitle)s" + #: themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" @@ -2855,120 +3001,127 @@ msgstr "其他變更" msgid "Expand sidebar" msgstr "展開側邊欄" -#: domains/python/_annotations.py:529 +#: domains/python/_annotations.py:522 msgid "Positional-only parameter separator (PEP 570)" msgstr "" -#: domains/python/_annotations.py:540 +#: domains/python/_annotations.py:533 msgid "Keyword-only parameters separator (PEP 3102)" msgstr "" -#: domains/python/__init__.py:113 domains/python/__init__.py:278 +#: domains/c/__init__.py:354 domains/cpp/__init__.py:485 +#: domains/python/_object.py:190 ext/napoleon/docstring.py:980 +msgid "Parameters" +msgstr "參數" + +#: domains/python/_object.py:206 +msgid "Variables" +msgstr "變數" + +#: domains/python/_object.py:214 +msgid "Raises" +msgstr "引發" + +#: domains/python/__init__.py:105 domains/python/__init__.py:270 #, python-format msgid "%s() (in module %s)" msgstr "%s() (於 %s 模組中)" -#: domains/python/__init__.py:180 domains/python/__init__.py:374 -#: domains/python/__init__.py:434 domains/python/__init__.py:474 +#: domains/python/__init__.py:172 domains/python/__init__.py:366 +#: domains/python/__init__.py:426 domains/python/__init__.py:466 #, python-format msgid "%s (in module %s)" msgstr "%s (於 %s 模組中)" -#: domains/python/__init__.py:182 +#: domains/python/__init__.py:174 #, python-format msgid "%s (built-in variable)" msgstr "%s (內建變數)" -#: domains/python/__init__.py:217 +#: domains/python/__init__.py:209 #, python-format msgid "%s (built-in class)" msgstr "%s (內建類別)" -#: domains/python/__init__.py:218 +#: domains/python/__init__.py:210 #, python-format msgid "%s (class in %s)" msgstr "%s (%s 中的類別)" -#: domains/python/__init__.py:283 +#: domains/python/__init__.py:275 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s 的類別方法)" -#: domains/python/__init__.py:285 +#: domains/python/__init__.py:277 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s 的靜態方法)" -#: domains/python/__init__.py:438 +#: domains/python/__init__.py:430 #, python-format msgid "%s (%s property)" msgstr "%s (%s 的特性)" -#: domains/python/__init__.py:478 +#: domains/python/__init__.py:470 #, python-format msgid "%s (type alias in %s)" msgstr "" -#: domains/python/__init__.py:638 +#: domains/python/__init__.py:624 msgid "Python Module Index" msgstr "Python 模組索引" -#: domains/python/__init__.py:639 +#: domains/python/__init__.py:625 msgid "modules" msgstr "模組" -#: domains/python/__init__.py:717 +#: domains/python/__init__.py:703 msgid "Deprecated" msgstr "已棄用" -#: domains/python/__init__.py:743 +#: domains/python/__init__.py:729 msgid "exception" msgstr "例外" -#: domains/python/__init__.py:745 +#: domains/python/__init__.py:731 msgid "class method" msgstr "類別方法" -#: domains/python/__init__.py:746 +#: domains/python/__init__.py:732 msgid "static method" msgstr "靜態方法" -#: domains/python/__init__.py:748 +#: domains/python/__init__.py:734 msgid "property" msgstr "特性" -#: domains/python/__init__.py:749 +#: domains/python/__init__.py:735 msgid "type alias" msgstr "" -#: domains/python/__init__.py:818 +#: domains/python/__init__.py:804 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :no-index: for" " one of them" msgstr "重複的 %s 的物件描述,在 %s 有其他實例,請在它們其中之一使用 :no-index:" -#: domains/python/__init__.py:978 +#: domains/python/__init__.py:974 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "為交互參照 %r 找到多於一個目標: %s" -#: domains/python/__init__.py:1052 +#: domains/python/__init__.py:1048 msgid " (deprecated)" msgstr "(已棄用)" -#: domains/c/__init__.py:326 domains/cpp/__init__.py:483 -#: domains/python/_object.py:190 ext/napoleon/docstring.py:974 -msgid "Parameters" -msgstr "參數" - -#: domains/python/_object.py:206 -msgid "Variables" -msgstr "變數" - -#: domains/python/_object.py:214 -msgid "Raises" -msgstr "引發" +#: domains/cpp/__init__.py:394 domains/cpp/_symbol.py:946 +#, python-format +msgid "" +"Duplicate C++ declaration, also defined at %s:%s.\n" +"Declaration is '.. cpp:%s:: %s'." +msgstr "重複的 C++ 宣告,亦被定義於 %s:%s。\n宣告是 '.. cpp:%s:: %s'。" #: domains/cpp/__init__.py:159 msgid "Template Parameters" @@ -2979,92 +3132,85 @@ msgstr "模板參數" msgid "%s (C++ %s)" msgstr "%s (C++ %s)" -#: domains/cpp/__init__.py:392 domains/cpp/_symbol.py:942 -#, python-format -msgid "" -"Duplicate C++ declaration, also defined at %s:%s.\n" -"Declaration is '.. cpp:%s:: %s'." -msgstr "重複的 C++ 宣告,亦被定義於 %s:%s。\n宣告是 '.. cpp:%s:: %s'。" - -#: domains/c/__init__.py:333 domains/cpp/__init__.py:496 +#: domains/c/__init__.py:361 domains/cpp/__init__.py:498 msgid "Return values" msgstr "回傳值" -#: domains/c/__init__.py:754 domains/cpp/__init__.py:940 +#: domains/c/__init__.py:782 domains/cpp/__init__.py:942 msgid "union" msgstr "union" -#: domains/c/__init__.py:749 domains/cpp/__init__.py:942 +#: domains/c/__init__.py:777 domains/cpp/__init__.py:944 msgid "member" msgstr "成員函數" -#: domains/c/__init__.py:757 domains/cpp/__init__.py:943 +#: domains/c/__init__.py:785 domains/cpp/__init__.py:945 msgid "type" msgstr "型別" -#: domains/cpp/__init__.py:944 +#: domains/cpp/__init__.py:946 msgid "concept" msgstr "概念" -#: domains/c/__init__.py:755 domains/cpp/__init__.py:945 +#: domains/c/__init__.py:783 domains/cpp/__init__.py:947 msgid "enum" msgstr "enum" -#: domains/c/__init__.py:756 domains/cpp/__init__.py:946 +#: domains/c/__init__.py:784 domains/cpp/__init__.py:948 msgid "enumerator" msgstr "enumerator" -#: domains/c/__init__.py:760 domains/cpp/__init__.py:949 +#: domains/c/__init__.py:788 domains/cpp/__init__.py:951 msgid "function parameter" msgstr "函式參數" -#: domains/cpp/__init__.py:952 +#: domains/cpp/__init__.py:954 msgid "template parameter" msgstr "模板參數" -#: domains/c/__init__.py:211 -#, python-format -msgid "%s (C %s)" -msgstr "%s (C %s)" - -#: domains/c/__init__.py:277 domains/c/_symbol.py:557 +#: domains/c/__init__.py:279 domains/c/_symbol.py:569 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "重複的 C 宣告,亦被定義於 %s:%s。\n宣告是 '.. c:%s:: %s'。" -#: domains/c/__init__.py:750 +#: domains/c/__init__.py:211 +#, python-format +msgid "%s (C %s)" +msgstr "%s (C %s)" + +#: domains/c/__init__.py:778 msgid "variable" msgstr "變數" -#: domains/c/__init__.py:752 +#: domains/c/__init__.py:780 msgid "macro" msgstr "巨集" -#: domains/c/__init__.py:753 +#: domains/c/__init__.py:781 msgid "struct" msgstr "結構" -#: domains/std/__init__.py:91 domains/std/__init__.py:111 +#: domains/std/__init__.py:88 domains/std/__init__.py:108 #, python-format msgid "environment variable; %s" msgstr "環境變數; %s" -#: domains/std/__init__.py:119 +#: domains/std/__init__.py:116 #, python-format msgid "%s; configuration value" msgstr "" -#: domains/std/__init__.py:175 +#: domains/std/__init__.py:172 msgid "Type" msgstr "" -#: domains/std/__init__.py:185 +#: domains/std/__init__.py:182 msgid "Default" msgstr "" -#: domains/std/__init__.py:242 +#: domains/std/__init__.py:239 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" @@ -3159,514 +3305,422 @@ msgstr "未定義的標籤: %r" msgid "Failed to create a cross reference. A title or caption not found: %r" msgstr "無法建立一個交互參照。未找到標題或說明: %r" -#: environment/adapters/toctree.py:324 -#, python-format -msgid "circular toctree references detected, ignoring: %s <- %s" -msgstr "偵測到循環的 toctree 參照,忽略中: %s <- %s" - -#: environment/adapters/toctree.py:349 -#, python-format -msgid "" -"toctree contains reference to document %r that doesn't have a title: no link" -" will be generated" -msgstr "toctree 包含了到文件 %r 的參照,該文件沒有標題:不會產生任何鏈接" - -#: environment/adapters/toctree.py:364 -#, python-format -msgid "toctree contains reference to non-included document %r" -msgstr "toctree 包含了 non-included 文件 %r 的參照" - -#: environment/adapters/toctree.py:367 +#: ext/napoleon/docstring.py:178 #, python-format -msgid "toctree contains reference to non-existing document %r" -msgstr "" - -#: environment/adapters/indexentries.py:123 -#, python-format -msgid "see %s" -msgstr "參考 %s" - -#: environment/adapters/indexentries.py:133 -#, python-format -msgid "see also %s" -msgstr "也參考 %s" - -#: environment/adapters/indexentries.py:141 -#, python-format -msgid "unknown index entry type %r" -msgstr "未知的索引項目型別 %r" - -#: environment/adapters/indexentries.py:268 -#: templates/latex/sphinxmessages.sty.jinja:11 -msgid "Symbols" -msgstr "符號" - -#: environment/collectors/asset.py:98 -#, python-format -msgid "image file not readable: %s" -msgstr "影像檔案無法讀取: %s" +msgid "invalid value set (missing closing brace): %s" +msgstr "無效的值集合(缺少右括號): %s" -#: environment/collectors/asset.py:126 +#: ext/napoleon/docstring.py:185 #, python-format -msgid "image file %s not readable: %s" -msgstr "影像檔案 %s 無法讀取: %s" +msgid "invalid value set (missing opening brace): %s" +msgstr "無效的值集合(缺少左括號): %s" -#: environment/collectors/asset.py:163 +#: ext/napoleon/docstring.py:192 #, python-format -msgid "download file not readable: %s" -msgstr "下載檔案無法讀取: %s" +msgid "malformed string literal (missing closing quote): %s" +msgstr "異常的字串文本(缺少右括號): %s" -#: environment/collectors/toctree.py:259 +#: ext/napoleon/docstring.py:199 #, python-format -msgid "%s is already assigned section numbers (nested numbered toctree?)" -msgstr "%s 已經被指定段落編號(巢狀編號的 toctree?)" - -#: _cli/util/errors.py:190 -msgid "Interrupted!" -msgstr "已中斷!" - -#: _cli/util/errors.py:194 -msgid "reStructuredText markup error!" -msgstr "" +msgid "malformed string literal (missing opening quote): %s" +msgstr "異常的字串文本(缺少左括號): %s" -#: _cli/util/errors.py:200 -msgid "Encoding error!" -msgstr "" +#: ext/napoleon/docstring.py:902 +msgid "Example" +msgstr "範例" -#: _cli/util/errors.py:203 -msgid "Recursion error!" -msgstr "" +#: ext/napoleon/docstring.py:903 +msgid "Examples" +msgstr "範例" -#: _cli/util/errors.py:207 -msgid "" -"This can happen with very large or deeply nested source files. You can " -"carefully increase the default Python recursion limit of 1,000 in conf.py " -"with e.g.:" -msgstr "" +#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:947 +msgid "Keyword Arguments" +msgstr "關鍵字引數" -#: _cli/util/errors.py:227 -msgid "Starting debugger:" -msgstr "" +#: ext/napoleon/docstring.py:962 +msgid "Notes" +msgstr "備註" -#: _cli/util/errors.py:235 -msgid "The full traceback has been saved in:" -msgstr "完整的回溯已儲存於:" +#: ext/napoleon/docstring.py:971 +msgid "Other Parameters" +msgstr "其他參數" -#: _cli/util/errors.py:240 -msgid "" -"To report this error to the developers, please open an issue at " -". Thanks!" -msgstr "要向開發者回報此錯誤,請在 開啟一個 issue。謝謝!" +#: ext/napoleon/docstring.py:1007 +msgid "Receives" +msgstr "接收" -#: _cli/util/errors.py:246 -msgid "" -"Please also report this if it was a user error, so that a better error " -"message can be provided next time." -msgstr "如果這是一個使用者錯誤,請一併回報,如此下次才能提供較佳的錯誤訊息。" +#: ext/napoleon/docstring.py:1011 +msgid "References" +msgstr "參照" -#: transforms/post_transforms/__init__.py:88 -msgid "" -"Could not determine the fallback text for the cross-reference. Might be a " -"bug." -msgstr "無法為交互參照決定備用文字。可能是個錯誤。" +#: ext/napoleon/docstring.py:1043 +msgid "Warns" +msgstr "警告" -#: transforms/post_transforms/__init__.py:237 -#, python-format -msgid "more than one target found for 'any' cross-reference %r: could be %s" -msgstr "為「任一個」交互參照 %r 找到多於一個目標:可能是 %s" +#: ext/napoleon/docstring.py:1047 +msgid "Yields" +msgstr "產出" -#: transforms/post_transforms/__init__.py:299 +#: ext/autodoc/_generate.py:151 +#: ext/autodoc/_legacy_class_based/_documenters.py:859 #, python-format -msgid "%s:%s reference target not found: %s" -msgstr "%s:%s 參照目標未找到: %s" +msgid "A mocked object is detected: %r" +msgstr "一個 mocked 物件被偵測到: %r" -#: transforms/post_transforms/__init__.py:305 +#: ext/autodoc/_generate.py:334 ext/autodoc/_generate.py:348 +#: ext/autodoc/_generate.py:370 ext/autodoc/_generate.py:386 +#: ext/autodoc/_legacy_class_based/_documenters.py:1860 +#: ext/autodoc/_legacy_class_based/_documenters.py:1889 +#: ext/autodoc/_legacy_class_based/_documenters.py:1983 #, python-format -msgid "%r reference target not found: %s" -msgstr "%r 參照目標未找到: %s" +msgid "alias of %s" +msgstr "%s 的別名" -#: transforms/post_transforms/images.py:79 +#: ext/autodoc/_legacy_class_based/_documenters.py:1745 +#: ext/autodoc/_renderer.py:88 #, python-format -msgid "Could not fetch remote image: %s [%s]" -msgstr "無法提取遠端圖片: %s [%s]" +msgid "Bases: %s" +msgstr "基礎類別:%s" -#: transforms/post_transforms/images.py:96 +#: ext/autodoc/_directive_options.py:226 +#: ext/autodoc/_legacy_class_based/_directive_options.py:47 #, python-format -msgid "Could not fetch remote image: %s [%d]" -msgstr "無法提取遠端圖片: %s [%d]" +msgid "invalid value for member-order option: %s" +msgstr "對於 member-order 選項無效的值: %s" -#: transforms/post_transforms/images.py:143 +#: ext/autodoc/_directive_options.py:233 +#: ext/autodoc/_legacy_class_based/_directive_options.py:55 #, python-format -msgid "Unknown image format: %s..." -msgstr "未知的圖片格式: %s..." +msgid "invalid value for class-doc-from option: %s" +msgstr "對於 class-doc-from 選項無效的值: %s" -#: builders/html/__init__.py:113 +#: ext/autodoc/_legacy_class_based/_documenters.py:239 +#: ext/autodoc/_names.py:45 #, python-format -msgid "The HTML pages are in %(outdir)s." -msgstr "HTML 頁面在 %(outdir)s 。" +msgid "invalid signature for auto%s (%r)" +msgstr "無效的簽章給 auto%s (%r)" -#: builders/html/__init__.py:348 +#: ext/autodoc/_legacy_class_based/_documenters.py:800 +#: ext/autodoc/_names.py:53 ext/autodoc/_names.py:101 #, python-format -msgid "Failed to read build info file: %r" -msgstr "讀取 build info 檔失敗: %r" - -#: builders/html/__init__.py:364 -msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" -msgstr "" +msgid "" +"don't know which module to import for autodocumenting %r (try placing a " +"\"module\" or \"currentmodule\" directive in the document, or giving an " +"explicit module name)" +msgstr "不清楚要 import 哪個模組來 autodocument %r (試試看在文件中加入 \"module\" 或 \"currentmodule\" 指令,或是給予一個明確的模組名稱)" -#: builders/html/__init__.py:366 -msgid "building [html]: " +#: ext/autodoc/_names.py:89 +#, python-format +msgid "signature arguments given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:383 +#: ext/autodoc/_names.py:93 #, python-format -msgid "" -"template %s has been changed since the previous build, all docs will be " -"rebuilt" +msgid "return annotation given for automodule: '%s'" msgstr "" -#: builders/html/__init__.py:507 -msgid "index" -msgstr "索引" +#: ext/autodoc/_legacy_class_based/_documenters.py:956 +#: ext/autodoc/_names.py:134 +msgid "\"::\" in automodule name doesn't make sense" +msgstr "\"::\" 在 automodule 的名稱中並不合理" -#: builders/html/__init__.py:560 +#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:984 #, python-format -msgid "Logo of %s" +msgid "Failed to remove %s: %s" msgstr "" -#: builders/html/__init__.py:589 -msgid "next" -msgstr "下一頁" - -#: builders/html/__init__.py:598 -msgid "previous" -msgstr "上一頁" +#: ext/apidoc/_generate.py:69 +#, python-format +msgid "Would create file %s." +msgstr "將會建立檔案 %s 。" -#: builders/html/__init__.py:696 -msgid "generating indices" -msgstr "正在產生索引" +#: ext/apidoc/_cli.py:28 +msgid "" +"\n" +"Look recursively in for Python modules and packages and create\n" +"one reST file with automodule directives per package in the .\n" +"\n" +"The s can be file and/or directory patterns that will be\n" +"excluded from generation.\n" +"\n" +"Note: By default this script will not overwrite already created files." +msgstr "\n在 中遞迴查找 Python 模組及套件,並在 中\n為每個套件建立一個帶有 automodule 指令的 reST 檔。\n\n 可以是檔案及/或資料夾型樣,它們將在生成時被\n移除。\n\n備註:在預設情況,此腳本不會重寫已經被建立的檔案。" -#: builders/html/__init__.py:711 -msgid "writing additional pages" -msgstr "正在編寫附加頁面" +#: ext/apidoc/_cli.py:45 +msgid "path to module to document" +msgstr "要生成文件的模組路徑" -#: builders/html/__init__.py:794 -#, python-format -msgid "cannot copy image file '%s': %s" -msgstr "" +#: ext/apidoc/_cli.py:50 +msgid "" +"fnmatch-style file and/or directory patterns to exclude from generation" +msgstr "fnmatch 風格的檔案及/或資料夾模式,將在生成時移除。" -#: builders/html/__init__.py:806 -msgid "copying downloadable files... " -msgstr "正在複製可下載的檔案..." +#: ext/apidoc/_cli.py:60 +msgid "directory to place all output" +msgstr "要放置所有輸出的資料夾" -#: builders/html/__init__.py:818 -#, python-format -msgid "cannot copy downloadable file %r: %s" -msgstr "無法複製可下載的檔案 %r: %s" +#: ext/apidoc/_cli.py:75 +msgid "maximum depth of submodules to show in the TOC (default: 4)" +msgstr "能顯示 TOC 的子模組最大深度(預設值:4)" -#: builders/html/__init__.py:864 -#, python-format -msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" -msgstr "" +#: ext/apidoc/_cli.py:82 +msgid "overwrite existing files" +msgstr "重寫已存在的檔案" -#: builders/html/__init__.py:882 -#, python-format -msgid "Failed to copy a file in html_static_file: %s: %r" -msgstr "在 html_static_file 中複製一個檔案失敗: %s: %r " +#: ext/apidoc/_cli.py:91 +msgid "" +"follow symbolic links. Powerful when combined with " +"collective.recipe.omelette." +msgstr "跟隨符號鏈接。與 collective.recipe.omelette 結合時很有用。" -#: builders/html/__init__.py:917 -msgid "copying static files" -msgstr "正在複製靜態檔案" +#: ext/apidoc/_cli.py:99 +msgid "run the script without creating files" +msgstr "執行腳本而不建立檔案" -#: builders/html/__init__.py:934 -#, python-format -msgid "cannot copy static file %r" -msgstr "無法複製靜態檔案 %r" +#: ext/apidoc/_cli.py:106 +msgid "put documentation for each module on its own page" +msgstr "為每個模組在它自己的頁面置放說明文件" -#: builders/html/__init__.py:939 -msgid "copying extra files" -msgstr "正在複製額外檔案" +#: ext/apidoc/_cli.py:113 +msgid "include \"_private\" modules" +msgstr "包含 \"_private\" 模組" -#: builders/html/__init__.py:949 -#, python-format -msgid "cannot copy extra file %r" -msgstr "無法複製額外檔案 %r" +#: ext/apidoc/_cli.py:120 +msgid "filename of table of contents (default: modules)" +msgstr "目錄的檔名(預設值:模組)" -#: builders/html/__init__.py:955 -#, python-format -msgid "Failed to write build info file: %r" -msgstr "寫入 build info 檔失敗: %r" +#: ext/apidoc/_cli.py:127 +msgid "don't create a table of contents file" +msgstr "不要建立目錄檔案" -#: builders/html/__init__.py:1005 +#: ext/apidoc/_cli.py:135 msgid "" -"search index couldn't be loaded, but not all documents will be built: the " -"index will be incomplete." -msgstr "搜尋索引無法被載入,但不是所有的文件都會被建置:索引將會是不完全的。" +"don't create headings for the module/package packages (e.g. when the " +"docstrings already contain them)" +msgstr "不要為模組/套件建立標頭(例如:當說明字串已經包含它們時)" -#: builders/html/__init__.py:1052 -#, python-format -msgid "page %s matches two patterns in html_sidebars: %r and %r" -msgstr "頁面 %s 在 html_sidebars 中符合兩個型樣: %r 和 %r" +#: ext/apidoc/_cli.py:145 +msgid "put module documentation before submodule documentation" +msgstr "在子模組說明文件之前置放模組說明文件" -#: builders/html/__init__.py:1216 -#, python-format +#: ext/apidoc/_cli.py:152 msgid "" -"a Unicode error occurred when rendering the page %s. Please make sure all " -"config values that contain non-ASCII content are Unicode strings." -msgstr "在呈現頁面 %s 時發生了一個 Unicode 錯誤。請確認所有包含 non-ASCII 內容的組態值都是 Unicode 字串。" +"interpret module paths according to PEP-0420 implicit namespaces " +"specification" +msgstr "根據 PEP-0420 隱式命名空間規範來解譯模組路徑" -#: builders/html/__init__.py:1224 -#, python-format +#: ext/apidoc/_cli.py:160 msgid "" -"An error happened in rendering the page %s.\n" -"Reason: %r" -msgstr "在呈現頁面 %s 時發生了一個錯誤。\n原因: %r" - -#: builders/html/__init__.py:1257 -msgid "dumping object inventory" -msgstr "正在傾印物件庫存" +"Comma-separated list of options to pass to automodule directive (or use " +"SPHINX_APIDOC_OPTIONS)." +msgstr "" -#: builders/html/__init__.py:1265 -#, python-format -msgid "dumping search index in %s" -msgstr "正在傾印搜尋索引於 %s" +#: ext/apidoc/_cli.py:170 +msgid "file suffix (default: rst)" +msgstr "檔案後綴(預設值:rst)" -#: builders/html/__init__.py:1308 -#, python-format -msgid "invalid js_file: %r, ignored" -msgstr "無效的 js_file: %r, 已略過" +#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:950 +msgid "Remove existing files in the output directory that were not generated" +msgstr "" -#: builders/html/__init__.py:1342 -msgid "Many math_renderers are registered. But no math_renderer is selected." -msgstr "多個 math_renderer 已被註冊。但是沒有 math_renderer 被選擇。" +#: ext/apidoc/_cli.py:186 +msgid "generate a full project with sphinx-quickstart" +msgstr "以 sphinx-quickstart 生成一個完全的專案" -#: builders/html/__init__.py:1346 -#, python-format -msgid "Unknown math_renderer %r is given." -msgstr "未知的 math_renderer %r 被給予。" +#: ext/apidoc/_cli.py:193 +msgid "append module_path to sys.path, used when --full is given" +msgstr "附加 module_path 到 sys.path,在給予 --full 時使用" -#: builders/html/__init__.py:1360 -#, python-format -msgid "html_extra_path entry %r is placed inside outdir" -msgstr "html_extra_path 項目 %r 被放入 outdir" +#: ext/apidoc/_cli.py:200 +msgid "project name (default: root module name)" +msgstr "專案名稱(預設值:根模組名稱)" -#: builders/html/__init__.py:1365 -#, python-format -msgid "html_extra_path entry %r does not exist" -msgstr "html_extra_path 項目 %r 不存在" +#: ext/apidoc/_cli.py:207 +msgid "project author(s), used when --full is given" +msgstr "專案作者(們),在給予 --full 時使用" -#: builders/html/__init__.py:1380 -#, python-format -msgid "html_static_path entry %r is placed inside outdir" -msgstr "html_static_path 項目 %r 被放入 outdir" +#: ext/apidoc/_cli.py:214 +msgid "project version, used when --full is given" +msgstr "專案版本,在給予 --full 時使用" -#: builders/html/__init__.py:1385 -#, python-format -msgid "html_static_path entry %r does not exist" -msgstr "html_static_path 項目 %r 不存在" +#: ext/apidoc/_cli.py:222 +msgid "project release, used when --full is given, defaults to --doc-version" +msgstr "專案發布,在給予 --full 時使用,預設為 --doc-version" -#: builders/html/__init__.py:1396 builders/latex/__init__.py:504 -#, python-format -msgid "logo file %r does not exist" -msgstr "標誌檔案 %r 不存在" +#: ext/apidoc/_cli.py:226 +msgid "extension options" +msgstr "擴充套件選項" -#: builders/html/__init__.py:1407 -#, python-format -msgid "favicon file %r does not exist" -msgstr "favicon 檔案 %r 不存在" +#: ext/apidoc/_cli.py:232 +msgid "enable arbitrary extensions, used when --full is given" +msgstr "" -#: builders/html/__init__.py:1420 +#: ext/apidoc/_cli.py:240 #, python-format -msgid "" -"Values in 'html_sidebars' must be a list of strings. At least one pattern " -"has a string value: %s. Change to `html_sidebars = %r`." +msgid "enable %s extension, used when --full is given" msgstr "" -#: builders/html/__init__.py:1433 -msgid "" -"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " -"configuration options)" -msgstr "HTML 4 已不再被 Sphinx 所支援。(在組態選項中偵測到 \"html4_writer=True\")" - -#: builders/html/__init__.py:1449 +#: ext/apidoc/_cli.py:291 #, python-format -msgid "%s %s documentation" -msgstr "%s %s 說明文件" +msgid "%s is not a directory." +msgstr "%s 不是資料夾" -#: builders/html/_build_info.py:32 -msgid "failed to read broken build info file (unknown version)" +#: ext/apidoc/_extension.py:50 +msgid "Running apidoc" msgstr "" -#: builders/html/_build_info.py:36 -msgid "failed to read broken build info file (missing config entry)" +#: ext/apidoc/_extension.py:102 +#, python-format +msgid "apidoc_modules item %i must be a dict" msgstr "" -#: builders/html/_build_info.py:39 -msgid "failed to read broken build info file (missing tags entry)" +#: ext/apidoc/_extension.py:110 +#, python-format +msgid "apidoc_modules item %i must have a 'path' key" msgstr "" -#: builders/latex/__init__.py:118 +#: ext/apidoc/_extension.py:115 #, python-format -msgid "The LaTeX files are in %(outdir)s." -msgstr "LaTeX 檔案在 %(outdir)s 。" - -#: builders/latex/__init__.py:121 -msgid "" -"\n" -"Run 'make' in that directory to run these through (pdf)latex\n" -"(use `make latexpdf' here to do that automatically)." -msgstr "\n在該目錄中執行 'make' 以透過 (pdf)latex 執行這些\n(在此使用 'make latexpdf' 以自動執行)" - -#: builders/latex/__init__.py:159 -msgid "no \"latex_documents\" config value found; no documents will be written" -msgstr "未找到 \"latex_documents\" 組態值;不會編寫任何文件" +msgid "apidoc_modules item %i 'path' must be a string" +msgstr "" -#: builders/latex/__init__.py:170 +#: ext/apidoc/_extension.py:121 #, python-format -msgid "\"latex_documents\" config value references unknown document %s" -msgstr "\"latex_documents\" 組態值引用未知的文件 %s" - -#: builders/latex/__init__.py:209 templates/latex/latex.tex.jinja:91 -msgid "Release" -msgstr "發佈" - -#: builders/latex/__init__.py:428 -msgid "copying TeX support files" -msgstr "正在複製 TeX 支援檔案" - -#: builders/latex/__init__.py:465 -msgid "copying additional files" -msgstr "正在複製附加檔案" +msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgstr "" -#: builders/latex/__init__.py:536 +#: ext/apidoc/_extension.py:133 #, python-format -msgid "Unknown configure key: latex_elements[%r], ignored." -msgstr "未知的配置鍵: latex_elements[%r],已略過。" +msgid "apidoc_modules item %i must have a 'destination' key" +msgstr "" -#: builders/latex/__init__.py:544 +#: ext/apidoc/_extension.py:140 #, python-format -msgid "Unknown theme option: latex_theme_options[%r], ignored." -msgstr "未知的主題選項: latex_theme_options[%r],,已略過。" - -#: builders/latex/transforms.py:120 -msgid "Failed to get a docname!" -msgstr "無法取得 docname!" +msgid "apidoc_modules item %i 'destination' must be a string" +msgstr "" -#: builders/latex/transforms.py:121 +#: ext/apidoc/_extension.py:147 #, python-format -msgid "Failed to get a docname for source %r!" +msgid "apidoc_modules item %i 'destination' should be a relative path" msgstr "" -#: builders/latex/transforms.py:487 +#: ext/apidoc/_extension.py:157 #, python-format -msgid "No footnote was found for given reference node %r" -msgstr "給定的參考節點 %r 找不到註腳" +msgid "apidoc_modules item %i cannot create destination directory: %s" +msgstr "" -#: builders/latex/theming.py:88 +#: ext/apidoc/_extension.py:178 #, python-format -msgid "%r doesn't have \"theme\" setting" -msgstr "%r 沒有「主題」設定" +msgid "apidoc_modules item %i '%s' must be an int" +msgstr "" -#: builders/latex/theming.py:91 +#: ext/apidoc/_extension.py:192 #, python-format -msgid "%r doesn't have \"%s\" setting" -msgstr "%r 沒有 \"%s\" 設定" - -#: templates/latex/longtable.tex.jinja:52 -#: templates/latex/sphinxmessages.sty.jinja:8 -msgid "continued from previous page" -msgstr "繼續上一頁" - -#: templates/latex/longtable.tex.jinja:63 -#: templates/latex/sphinxmessages.sty.jinja:9 -msgid "continues on next page" -msgstr "繼續下一頁" - -#: templates/latex/sphinxmessages.sty.jinja:10 -msgid "Non-alphabetical" -msgstr "非依字母順序" - -#: templates/latex/sphinxmessages.sty.jinja:12 -msgid "Numbers" -msgstr "數字" +msgid "apidoc_modules item %i '%s' must be a boolean" +msgstr "" -#: templates/latex/sphinxmessages.sty.jinja:13 -msgid "page" -msgstr "頁" +#: ext/apidoc/_extension.py:210 +#, python-format +msgid "apidoc_modules item %i has unexpected keys: %s" +msgstr "" -#: ext/napoleon/__init__.py:356 ext/napoleon/docstring.py:940 -msgid "Keyword Arguments" -msgstr "關鍵字引數" +#: ext/apidoc/_extension.py:248 +#, python-format +msgid "apidoc_modules item %i '%s' must be a sequence" +msgstr "" -#: ext/napoleon/docstring.py:176 +#: ext/apidoc/_extension.py:257 #, python-format -msgid "invalid value set (missing closing brace): %s" -msgstr "無效的值集合(缺少右括號): %s" +msgid "apidoc_modules item %i '%s' must contain strings" +msgstr "" -#: ext/napoleon/docstring.py:183 +#: ext/autosummary/generate.py:212 ext/autosummary/generate.py:425 #, python-format -msgid "invalid value set (missing opening brace): %s" -msgstr "無效的值集合(缺少左括號): %s" +msgid "" +"autosummary: failed to determine %r to be documented, the following exception was raised:\n" +"%s" +msgstr "autosummary: 無法決定 %r 被記錄,以下例外被引發:\n%s" -#: ext/napoleon/docstring.py:190 +#: ext/autosummary/generate.py:630 #, python-format -msgid "malformed string literal (missing closing quote): %s" -msgstr "異常的字串文本(缺少右括號): %s" +msgid "[autosummary] generating autosummary for: %s" +msgstr "[autosummary] 正在產生 autosummary 給: %s" -#: ext/napoleon/docstring.py:197 +#: ext/autosummary/generate.py:634 #, python-format -msgid "malformed string literal (missing opening quote): %s" -msgstr "異常的字串文本(缺少左括號): %s" +msgid "[autosummary] writing to %s" +msgstr "[autosummary] 正在寫入 %s" -#: ext/napoleon/docstring.py:895 -msgid "Example" -msgstr "範例" +#: ext/autosummary/generate.py:679 +#, python-format +msgid "" +"[autosummary] failed to import %s.\n" +"Possible hints:\n" +"%s" +msgstr "[autosummary] import %s 失敗。\n可能的提示:\n%s" -#: ext/napoleon/docstring.py:896 -msgid "Examples" -msgstr "範例" +#: ext/autosummary/generate.py:877 +msgid "" +"\n" +"Generate ReStructuredText using autosummary directives.\n" +"\n" +"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" +"the reStructuredText files from the autosummary directives contained in the\n" +"given input files.\n" +"\n" +"The format of the autosummary directive is documented in the\n" +"``sphinx.ext.autosummary`` Python module and can be read using::\n" +"\n" +" pydoc sphinx.ext.autosummary\n" +msgstr "\n使用 autosummary 指令產生 ReStructuredText。\n\nsphinx-autogen 是 sphinx.ext.autosummary.generate 的一個前端。它會從給定的\n輸入檔案中所包含的 autosummary 指令,產生 reStructuredText 檔案。\n\nautosummary 指令的格式被記錄在 ``sphinx.ext.autosummary`` Python 模組中,\n它可以使用此方法來讀取::\n\npydoc sphinx.ext.autosummary\n" -#: ext/napoleon/docstring.py:956 -msgid "Notes" -msgstr "備註" +#: ext/autosummary/generate.py:899 +msgid "source files to generate rST files for" +msgstr "原始檔案以產生 rST 檔案給" -#: ext/napoleon/docstring.py:965 -msgid "Other Parameters" -msgstr "其他參數" +#: ext/autosummary/generate.py:907 +msgid "directory to place all output in" +msgstr "資料夾來放置所有輸出在" -#: ext/napoleon/docstring.py:1001 -msgid "Receives" -msgstr "接收" +#: ext/autosummary/generate.py:915 +#, python-format +msgid "default suffix for files (default: %(default)s)" +msgstr "檔案的預設後綴(預設: %(default)s )" -#: ext/napoleon/docstring.py:1005 -msgid "References" -msgstr "參照" +#: ext/autosummary/generate.py:923 +#, python-format +msgid "custom template directory (default: %(default)s)" +msgstr "自訂模板資料夾(預設: %(default)s )" -#: ext/napoleon/docstring.py:1037 -msgid "Warns" -msgstr "警告" +#: ext/autosummary/generate.py:931 +#, python-format +msgid "document imported members (default: %(default)s)" +msgstr "文件引入成員(預設: %(default)s )" -#: ext/napoleon/docstring.py:1041 -msgid "Yields" -msgstr "產出" +#: ext/autosummary/generate.py:940 +#, python-format +msgid "" +"document exactly the members in module __all__ attribute. (default: " +"%(default)s)" +msgstr "文件確實是在模組 __all__ 屬性中的成員。(預設值: %(default)s)" -#: ext/autosummary/__init__.py:284 +#: ext/autosummary/__init__.py:235 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "autosummary 參照已排除文件 %r 。已略過。" -#: ext/autosummary/__init__.py:288 +#: ext/autosummary/__init__.py:239 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: 未找到 stub 檔 %r 。請檢查您的 autosummary_generate 設定。" -#: ext/autosummary/__init__.py:309 +#: ext/autosummary/__init__.py:260 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "一個有標題的 autosummary 需要 :toctree: 選項。已略過。 " -#: ext/autosummary/__init__.py:384 +#: ext/autosummary/__init__.py:329 #, python-format msgid "" "autosummary: failed to import %s.\n" @@ -3674,548 +3728,585 @@ msgid "" "%s" msgstr "autosummary: import %s 失敗。\n可能的提示:\n%s" -#: ext/autosummary/__init__.py:404 -#, python-format -msgid "failed to parse name %s" -msgstr "剖析名稱 %s 失敗" - -#: ext/autosummary/__init__.py:412 +#: ext/autosummary/__init__.py:358 #, python-format msgid "failed to import object %s" msgstr "import 物件 %s 失敗" -#: ext/autosummary/__init__.py:730 +#: ext/autosummary/__init__.py:652 #, python-format msgid "" "Summarised items should not include the current module. Replace %r with %r." msgstr "" -#: ext/autosummary/__init__.py:927 +#: ext/autosummary/__init__.py:850 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: 檔案未找到: %s" -#: ext/autosummary/__init__.py:937 +#: ext/autosummary/__init__.py:860 msgid "" "autosummary generates .rst files internally. But your source_suffix does not" " contain .rst. Skipped." msgstr "autosummary 會在內部產生 .rst 檔。但是您的 source_suffix 並未包含 .rst。已跳過。" -#: ext/autosummary/generate.py:232 ext/autosummary/generate.py:450 +#: ext/intersphinx/_load.py:61 #, python-format msgid "" -"autosummary: failed to determine %r to be documented, the following exception was raised:\n" -"%s" -msgstr "autosummary: 無法決定 %r 被記錄,以下例外被引發:\n%s" +"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " +"identifiers must be non-empty strings." +msgstr "" -#: ext/autosummary/generate.py:588 +#: ext/intersphinx/_load.py:72 #, python-format -msgid "[autosummary] generating autosummary for: %s" -msgstr "[autosummary] 正在產生 autosummary 給: %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " +"or list." +msgstr "" -#: ext/autosummary/generate.py:592 +#: ext/intersphinx/_load.py:83 #, python-format -msgid "[autosummary] writing to %s" -msgstr "[autosummary] 正在寫入 %s" +msgid "" +"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," +" inventory locations) pair." +msgstr "" -#: ext/autosummary/generate.py:637 +#: ext/intersphinx/_load.py:94 #, python-format msgid "" -"[autosummary] failed to import %s.\n" -"Possible hints:\n" -"%s" -msgstr "[autosummary] import %s 失敗。\n可能的提示:\n%s" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique non-empty strings." +msgstr "" -#: ext/autosummary/generate.py:836 +#: ext/intersphinx/_load.py:103 +#, python-format msgid "" -"\n" -"Generate ReStructuredText using autosummary directives.\n" -"\n" -"sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" -"the reStructuredText files from the autosummary directives contained in the\n" -"given input files.\n" -"\n" -"The format of the autosummary directive is documented in the\n" -"``sphinx.ext.autosummary`` Python module and can be read using::\n" -"\n" -" pydoc sphinx.ext.autosummary\n" -msgstr "\n使用 autosummary 指令產生 ReStructuredText。\n\nsphinx-autogen 是 sphinx.ext.autosummary.generate 的一個前端。它會從給定的\n輸入檔案中所包含的 autosummary 指令,產生 reStructuredText 檔案。\n\nautosummary 指令的格式被記錄在 ``sphinx.ext.autosummary`` Python 模組中,\n它可以使用此方法來讀取::\n\npydoc sphinx.ext.autosummary\n" +"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " +"must be unique (other instance in intersphinx_mapping[%r])." +msgstr "" + +#: ext/intersphinx/_load.py:122 +#, python-format +msgid "" +"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " +"Inventory locations must be non-empty strings or None." +msgstr "" + +#: ext/intersphinx/_load.py:132 +msgid "Invalid `intersphinx_mapping` configuration (1 error)." +msgstr "" + +#: ext/intersphinx/_load.py:135 +#, python-format +msgid "Invalid `intersphinx_mapping` configuration (%s errors)." +msgstr "" -#: ext/autosummary/generate.py:858 -msgid "source files to generate rST files for" -msgstr "原始檔案以產生 rST 檔案給" +#: ext/intersphinx/_load.py:158 +msgid "An invalid intersphinx_mapping entry was added after normalisation." +msgstr "" -#: ext/autosummary/generate.py:866 -msgid "directory to place all output in" -msgstr "資料夾來放置所有輸出在" +#: ext/intersphinx/_load.py:297 +#, python-format +msgid "loading intersphinx inventory '%s' from %s ..." +msgstr "" + +#: ext/intersphinx/_load.py:324 +msgid "" +"encountered some issues with some of the inventories, but they had working " +"alternatives:" +msgstr "從一些庫存中遇到一些問題,但他們已在進行替代方案:" -#: ext/autosummary/generate.py:874 +#: ext/intersphinx/_load.py:332 #, python-format -msgid "default suffix for files (default: %(default)s)" -msgstr "檔案的預設後綴(預設: %(default)s )" +msgid "" +"failed to reach any of the inventories with the following issues:\n" +"%s" +msgstr "" -#: ext/autosummary/generate.py:882 +#: ext/intersphinx/_load.py:411 #, python-format -msgid "custom template directory (default: %(default)s)" -msgstr "自訂模板資料夾(預設: %(default)s )" +msgid "intersphinx inventory has moved: %s -> %s" +msgstr "intersphinx 庫存已移動: %s -> %s" -#: ext/autosummary/generate.py:890 +#: ext/intersphinx/_resolve.py:53 #, python-format -msgid "document imported members (default: %(default)s)" -msgstr "文件引入成員(預設: %(default)s )" +msgid "(in %s %s)" +msgstr "" -#: ext/autosummary/generate.py:899 +#: ext/intersphinx/_resolve.py:55 #, python-format -msgid "" -"document exactly the members in module __all__ attribute. (default: " -"%(default)s)" -msgstr "文件確實是在模組 __all__ 屬性中的成員。(預設值: %(default)s)" +msgid "(in %s)" +msgstr "(於 %s)" -#: ext/apidoc/_cli.py:178 ext/autosummary/generate.py:909 -msgid "Remove existing files in the output directory that were not generated" +#: ext/intersphinx/_resolve.py:112 +#, python-format +msgid "inventory '%s': duplicate matches found for %s:%s" msgstr "" -#: ext/apidoc/_shared.py:29 ext/autosummary/generate.py:944 +#: ext/intersphinx/_resolve.py:122 #, python-format -msgid "Failed to remove %s: %s" +msgid "inventory '%s': multiple matches found for %s:%s" msgstr "" -#: ext/apidoc/_cli.py:28 -msgid "" -"\n" -"Look recursively in for Python modules and packages and create\n" -"one reST file with automodule directives per package in the .\n" -"\n" -"The s can be file and/or directory patterns that will be\n" -"excluded from generation.\n" -"\n" -"Note: By default this script will not overwrite already created files." -msgstr "\n在 中遞迴查找 Python 模組及套件,並在 中\n為每個套件建立一個帶有 automodule 指令的 reST 檔。\n\n 可以是檔案及/或資料夾型樣,它們將在生成時被\n移除。\n\n備註:在預設情況,此腳本不會重寫已經被建立的檔案。" +#: ext/intersphinx/_resolve.py:387 +#, python-format +msgid "inventory for external cross-reference not found: %r" +msgstr "找不到外部交互參照的庫存:%r" -#: ext/apidoc/_cli.py:45 -msgid "path to module to document" -msgstr "要生成文件的模組路徑" +#: ext/intersphinx/_resolve.py:396 +#, python-format +msgid "invalid external cross-reference suffix: %r" +msgstr "無效的外部交互參照後綴:%r" -#: ext/apidoc/_cli.py:50 -msgid "" -"fnmatch-style file and/or directory patterns to exclude from generation" -msgstr "fnmatch 風格的檔案及/或資料夾模式,將在生成時移除。" +#: ext/intersphinx/_resolve.py:407 +#, python-format +msgid "domain for external cross-reference not found: %r" +msgstr "找不到外部交互參照的領域:%r" -#: ext/apidoc/_cli.py:60 -msgid "directory to place all output" -msgstr "要放置所有輸出的資料夾" +#: ext/intersphinx/_resolve.py:561 +#, python-format +msgid "external %s:%s reference target not found: %s" +msgstr "未找到外部的 %s:%s 參照目標: %s" -#: ext/apidoc/_cli.py:75 -msgid "maximum depth of submodules to show in the TOC (default: 4)" -msgstr "能顯示 TOC 的子模組最大深度(預設值:4)" +#: ext/autodoc/_dynamic/_loader.py:144 +#: ext/autodoc/_legacy_class_based/_documenters.py:882 +#, python-format +msgid "error while formatting signature for %s: %s" +msgstr "正在為 %s 格式化簽名時發生錯誤: %s" -#: ext/apidoc/_cli.py:82 -msgid "overwrite existing files" -msgstr "重寫已存在的檔案" +#: ext/autodoc/_dynamic/_loader.py:193 +#, python-format +msgid "Ignoring invalid __all__ in module %s: %r" +msgstr "" -#: ext/apidoc/_cli.py:91 -msgid "" -"follow symbolic links. Powerful when combined with " -"collective.recipe.omelette." -msgstr "跟隨符號鏈接。與 collective.recipe.omelette 結合時很有用。" +#: ext/autodoc/_dynamic/_loader.py:332 ext/autodoc/_dynamic/_signatures.py:496 +#: ext/autodoc/_dynamic/_signatures.py:612 +#: ext/autodoc/_legacy_class_based/_documenters.py:1284 +#: ext/autodoc/_legacy_class_based/_documenters.py:1372 +#: ext/autodoc/_legacy_class_based/_documenters.py:2906 +#, python-format +msgid "Failed to get a function signature for %s: %s" +msgstr "無法取得一個函式簽名給 %s: %s" -#: ext/apidoc/_cli.py:99 -msgid "run the script without creating files" -msgstr "執行腳本而不建立檔案" +#: ext/autodoc/_dynamic/_type_comments.py:120 +#, python-format +msgid "Failed to update signature for %r: parameter not found: %s" +msgstr "無法為 %r 更新簽名:未找到參數: %s" -#: ext/apidoc/_cli.py:106 -msgid "put documentation for each module on its own page" -msgstr "為每個模組在它自己的頁面置放說明文件" +#: ext/autodoc/_dynamic/_type_comments.py:123 +#, python-format +msgid "Failed to parse type_comment for %r: %s" +msgstr "無法為 %r 剖析 type_comment: %s" -#: ext/apidoc/_cli.py:113 -msgid "include \"_private\" modules" -msgstr "包含 \"_private\" 模組" +#: ext/autodoc/_dynamic/_docstrings.py:268 +#: ext/autodoc/_legacy_class_based/_documenters.py:2499 +#, python-format +msgid "Invalid __slots__ found on %s. Ignored." +msgstr "在 %s 找到無效的 __slots__。已略過。" -#: ext/apidoc/_cli.py:120 -msgid "filename of table of contents (default: modules)" -msgstr "目錄的檔名(預設值:模組)" +#: ext/autodoc/_dynamic/_signatures.py:102 +#: ext/autodoc/_legacy_class_based/_documenters.py:358 +#, python-format +msgid "error while formatting arguments for %s: %s" +msgstr "在為 %s 格式化引數時有錯誤: %s" -#: ext/apidoc/_cli.py:127 -msgid "don't create a table of contents file" -msgstr "不要建立目錄檔案" +#: ext/autodoc/_dynamic/_signatures.py:494 +#: ext/autodoc/_legacy_class_based/_documenters.py:1607 +#, python-format +msgid "Failed to get a constructor signature for %s: %s" +msgstr "無法取得一個 constructor 簽名給 %s: %s" -#: ext/apidoc/_cli.py:135 -msgid "" -"don't create headings for the module/package packages (e.g. when the " -"docstrings already contain them)" -msgstr "不要為模組/套件建立標頭(例如:當說明字串已經包含它們時)" +#: ext/autodoc/_dynamic/_signatures.py:498 +#: ext/autodoc/_legacy_class_based/_documenters.py:2235 +#: ext/autodoc/_legacy_class_based/_documenters.py:2355 +#, python-format +msgid "Failed to get a method signature for %s: %s" +msgstr "無法取得一個 method 簽名給 %s: %s" -#: ext/apidoc/_cli.py:145 -msgid "put module documentation before submodule documentation" -msgstr "在子模組說明文件之前置放模組說明文件" +#: ext/autodoc/_dynamic/_signatures.py:500 +#, python-format +msgid "Failed to get a signature for %s: %s" +msgstr "" -#: ext/apidoc/_cli.py:152 -msgid "" -"interpret module paths according to PEP-0420 implicit namespaces " -"specification" -msgstr "根據 PEP-0420 隱式命名空間規範來解譯模組路徑" +#: ext/autodoc/_dynamic/_preserve_defaults.py:156 +#, python-format +msgid "Failed to parse a default argument value for %r: %s" +msgstr "無法為 %r 剖析一個預設引數: %s" -#: ext/apidoc/_cli.py:160 +#: ext/autodoc/_dynamic/_member_finder.py:420 +#, python-format msgid "" -"Comma-separated list of options to pass to automodule directive (or use " -"SPHINX_APIDOC_OPTIONS)." +"attribute %s is listed in :members: but is missing as it was not found in " +"object %r" msgstr "" -#: ext/apidoc/_cli.py:170 -msgid "file suffix (default: rst)" -msgstr "檔案後綴(預設值:rst)" +#: ext/autodoc/_dynamic/_member_finder.py:473 +#: ext/autodoc/_legacy_class_based/_documenters.py:677 +#, python-format +msgid "" +"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" +"%s" +msgstr "autodoc: 決定 %s.%s (%r) 被文件化失敗,引發以下的例外:\n%s" -#: ext/apidoc/_cli.py:186 -msgid "generate a full project with sphinx-quickstart" -msgstr "以 sphinx-quickstart 生成一個完全的專案" +#: ext/autodoc/_legacy_class_based/_documenters.py:964 +#, python-format +msgid "signature arguments or return annotation given for automodule %s" +msgstr "簽名引數或回傳註釋給予 automodule %s" -#: ext/apidoc/_cli.py:193 -msgid "append module_path to sys.path, used when --full is given" -msgstr "附加 module_path 到 sys.path,在給予 --full 時使用" +#: ext/autodoc/_legacy_class_based/_documenters.py:980 +#, python-format +msgid "" +"__all__ should be a list of strings, not %r (in module %s) -- ignoring " +"__all__" +msgstr "__all__ 應該是一個字串的列表,不是 %r (在 %s 模組中)-- 正在忽略 __all__" -#: ext/apidoc/_cli.py:200 -msgid "project name (default: root module name)" -msgstr "專案名稱(預設值:根模組名稱)" +#: ext/autodoc/_legacy_class_based/_documenters.py:1057 +#, python-format +msgid "" +"missing attribute mentioned in :members: option: module %s, attribute %s" +msgstr "缺少 :members: 選項中所述的屬性:模組 %s ,屬性 %s" -#: ext/apidoc/_cli.py:207 -msgid "project author(s), used when --full is given" -msgstr "專案作者(們),在給予 --full 時使用" +#: ext/autodoc/_legacy_class_based/_documenters.py:1764 +#, python-format +msgid "missing attribute %s in object %s" +msgstr "遺漏屬性 %s 在物件 %s" -#: ext/apidoc/_cli.py:214 -msgid "project version, used when --full is given" -msgstr "專案版本,在給予 --full 時使用" +#: ext/autodoc/_legacy_class_based/_documenters.py:1876 +#, python-format +msgid "alias of TypeVar(%s)" +msgstr "TypeVar(%s) 的別名" -#: ext/apidoc/_cli.py:222 -msgid "project release, used when --full is given, defaults to --doc-version" -msgstr "專案發布,在給予 --full 時使用,預設為 --doc-version" +#: builders/html/_build_info.py:32 +msgid "failed to read broken build info file (unknown version)" +msgstr "" -#: ext/apidoc/_cli.py:226 -msgid "extension options" -msgstr "擴充套件選項" +#: builders/html/_build_info.py:36 +msgid "failed to read broken build info file (missing config entry)" +msgstr "" -#: ext/apidoc/_cli.py:232 -msgid "enable arbitrary extensions, used when --full is given" +#: builders/html/_build_info.py:39 +msgid "failed to read broken build info file (missing tags entry)" msgstr "" -#: ext/apidoc/_cli.py:240 +#: builders/html/__init__.py:114 #, python-format -msgid "enable %s extension, used when --full is given" -msgstr "" +msgid "The HTML pages are in %(outdir)s." +msgstr "HTML 頁面在 %(outdir)s 。" -#: ext/apidoc/_cli.py:291 +#: builders/html/__init__.py:337 #, python-format -msgid "%s is not a directory." -msgstr "%s 不是資料夾" +msgid "Failed to read build info file: %r" +msgstr "讀取 build info 檔失敗: %r" -#: ext/apidoc/_extension.py:50 -msgid "Running apidoc" +#: builders/html/__init__.py:353 +msgid "build_info mismatch, copying .buildinfo to .buildinfo.bak" msgstr "" -#: ext/apidoc/_extension.py:102 -#, python-format -msgid "apidoc_modules item %i must be a dict" +#: builders/html/__init__.py:355 +msgid "building [html]: " msgstr "" -#: ext/apidoc/_extension.py:110 +#: builders/html/__init__.py:372 #, python-format -msgid "apidoc_modules item %i must have a 'path' key" +msgid "" +"template %s has been changed since the previous build, all docs will be " +"rebuilt" msgstr "" -#: ext/apidoc/_extension.py:115 -#, python-format -msgid "apidoc_modules item %i 'path' must be a string" -msgstr "" +#: builders/html/__init__.py:496 +msgid "index" +msgstr "索引" -#: ext/apidoc/_extension.py:121 +#: builders/html/__init__.py:549 #, python-format -msgid "apidoc_modules item %i 'path' is not an existing folder: %s" +msgid "Logo of %s" msgstr "" -#: ext/apidoc/_extension.py:133 -#, python-format -msgid "apidoc_modules item %i must have a 'destination' key" -msgstr "" +#: builders/html/__init__.py:578 +msgid "next" +msgstr "下一頁" -#: ext/apidoc/_extension.py:140 -#, python-format -msgid "apidoc_modules item %i 'destination' must be a string" -msgstr "" +#: builders/html/__init__.py:587 +msgid "previous" +msgstr "上一頁" -#: ext/apidoc/_extension.py:147 -#, python-format -msgid "apidoc_modules item %i 'destination' should be a relative path" -msgstr "" +#: builders/html/__init__.py:685 +msgid "generating indices" +msgstr "正在產生索引" + +#: builders/html/__init__.py:700 +msgid "writing additional pages" +msgstr "正在編寫附加頁面" -#: ext/apidoc/_extension.py:157 +#: builders/html/__init__.py:783 #, python-format -msgid "apidoc_modules item %i cannot create destination directory: %s" +msgid "cannot copy image file '%s': %s" msgstr "" -#: ext/apidoc/_extension.py:178 -#, python-format -msgid "apidoc_modules item %i '%s' must be an int" -msgstr "" +#: builders/html/__init__.py:795 +msgid "copying downloadable files... " +msgstr "正在複製可下載的檔案..." -#: ext/apidoc/_extension.py:192 +#: builders/html/__init__.py:807 #, python-format -msgid "apidoc_modules item %i '%s' must be a boolean" -msgstr "" +msgid "cannot copy downloadable file %r: %s" +msgstr "無法複製可下載的檔案 %r: %s" -#: ext/apidoc/_extension.py:210 +#: builders/html/__init__.py:853 #, python-format -msgid "apidoc_modules item %i has unexpected keys: %s" +msgid "Failed to copy a file in the theme's 'static' directory: %s: %r" msgstr "" -#: ext/apidoc/_extension.py:247 +#: builders/html/__init__.py:871 #, python-format -msgid "apidoc_modules item %i '%s' must be a sequence" -msgstr "" +msgid "Failed to copy a file in html_static_file: %s: %r" +msgstr "在 html_static_file 中複製一個檔案失敗: %s: %r " + +#: builders/html/__init__.py:906 +msgid "copying static files" +msgstr "正在複製靜態檔案" -#: ext/apidoc/_extension.py:256 +#: builders/html/__init__.py:923 #, python-format -msgid "apidoc_modules item %i '%s' must contain strings" -msgstr "" +msgid "cannot copy static file %r" +msgstr "無法複製靜態檔案 %r" -#: ext/apidoc/_generate.py:69 +#: builders/html/__init__.py:928 +msgid "copying extra files" +msgstr "正在複製額外檔案" + +#: builders/html/__init__.py:938 #, python-format -msgid "Would create file %s." -msgstr "將會建立檔案 %s 。" +msgid "cannot copy extra file %r" +msgstr "無法複製額外檔案 %r" -#: ext/intersphinx/_resolve.py:49 +#: builders/html/__init__.py:944 #, python-format -msgid "(in %s v%s)" -msgstr "(於 %s v%s)" +msgid "Failed to write build info file: %r" +msgstr "寫入 build info 檔失敗: %r" + +#: builders/html/__init__.py:994 +msgid "" +"search index couldn't be loaded, but not all documents will be built: the " +"index will be incomplete." +msgstr "搜尋索引無法被載入,但不是所有的文件都會被建置:索引將會是不完全的。" -#: ext/intersphinx/_resolve.py:51 +#: builders/html/__init__.py:1038 #, python-format -msgid "(in %s)" -msgstr "(於 %s)" +msgid "page %s matches two patterns in html_sidebars: %r and %r" +msgstr "頁面 %s 在 html_sidebars 中符合兩個型樣: %r 和 %r" -#: ext/intersphinx/_resolve.py:108 +#: builders/html/__init__.py:1204 #, python-format -msgid "inventory '%s': duplicate matches found for %s:%s" -msgstr "" +msgid "" +"a Unicode error occurred when rendering the page %s. Please make sure all " +"config values that contain non-ASCII content are Unicode strings." +msgstr "在呈現頁面 %s 時發生了一個 Unicode 錯誤。請確認所有包含 non-ASCII 內容的組態值都是 Unicode 字串。" -#: ext/intersphinx/_resolve.py:118 +#: builders/html/__init__.py:1217 #, python-format -msgid "inventory '%s': multiple matches found for %s:%s" +msgid "" +"The '%s' theme does not support this version of Sphinx, because it uses the " +"'style' field in HTML templates, which was was deprecated in Sphinx 5.1 and" +" removed in Sphinx 7.0. The theme must be updated to use the 'styles' field " +"instead. See https://www.sphinx-" +"doc.org/en/master/development/html_themes/templating.html#styles" msgstr "" -#: ext/intersphinx/_resolve.py:383 +#: builders/html/__init__.py:1225 #, python-format -msgid "inventory for external cross-reference not found: %r" -msgstr "找不到外部交互參照的庫存:%r" +msgid "" +"An error happened in rendering the page %s.\n" +"Reason: %r" +msgstr "在呈現頁面 %s 時發生了一個錯誤。\n原因: %r" -#: ext/intersphinx/_resolve.py:392 -#, python-format -msgid "invalid external cross-reference suffix: %r" -msgstr "無效的外部交互參照後綴:%r" +#: builders/html/__init__.py:1258 +msgid "dumping object inventory" +msgstr "正在傾印物件庫存" -#: ext/intersphinx/_resolve.py:403 +#: builders/html/__init__.py:1266 #, python-format -msgid "domain for external cross-reference not found: %r" -msgstr "找不到外部交互參照的領域:%r" +msgid "dumping search index in %s" +msgstr "正在傾印搜尋索引於 %s" -#: ext/intersphinx/_resolve.py:619 +#: builders/html/__init__.py:1313 #, python-format -msgid "external %s:%s reference target not found: %s" -msgstr "未找到外部的 %s:%s 參照目標: %s" +msgid "invalid js_file: %r, ignored" +msgstr "無效的 js_file: %r, 已略過" -#: ext/intersphinx/_load.py:60 -#, python-format -msgid "" -"Invalid intersphinx project identifier `%r` in intersphinx_mapping. Project " -"identifiers must be non-empty strings." -msgstr "" +#: builders/html/__init__.py:1347 +msgid "Many math_renderers are registered. But no math_renderer is selected." +msgstr "多個 math_renderer 已被註冊。但是沒有 math_renderer 被選擇。" -#: ext/intersphinx/_load.py:71 +#: builders/html/__init__.py:1351 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple " -"or list." -msgstr "" +msgid "Unknown math_renderer %r is given." +msgstr "未知的 math_renderer %r 被給予。" -#: ext/intersphinx/_load.py:82 +#: builders/html/__init__.py:1365 #, python-format -msgid "" -"Invalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI," -" inventory locations) pair." -msgstr "" +msgid "html_extra_path entry %r is placed inside outdir" +msgstr "html_extra_path 項目 %r 被放入 outdir" -#: ext/intersphinx/_load.py:93 +#: builders/html/__init__.py:1370 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique non-empty strings." -msgstr "" +msgid "html_extra_path entry %r does not exist" +msgstr "html_extra_path 項目 %r 不存在" -#: ext/intersphinx/_load.py:102 +#: builders/html/__init__.py:1385 #, python-format -msgid "" -"Invalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs " -"must be unique (other instance in intersphinx_mapping[%r])." -msgstr "" +msgid "html_static_path entry %r is placed inside outdir" +msgstr "html_static_path 項目 %r 被放入 outdir" -#: ext/intersphinx/_load.py:121 +#: builders/html/__init__.py:1390 #, python-format -msgid "" -"Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. " -"Inventory locations must be non-empty strings or None." -msgstr "" - -#: ext/intersphinx/_load.py:131 -msgid "Invalid `intersphinx_mapping` configuration (1 error)." -msgstr "" +msgid "html_static_path entry %r does not exist" +msgstr "html_static_path 項目 %r 不存在" -#: ext/intersphinx/_load.py:134 +#: builders/html/__init__.py:1401 builders/latex/__init__.py:497 #, python-format -msgid "Invalid `intersphinx_mapping` configuration (%s errors)." -msgstr "" +msgid "logo file %r does not exist" +msgstr "標誌檔案 %r 不存在" -#: ext/intersphinx/_load.py:157 -msgid "An invalid intersphinx_mapping entry was added after normalisation." -msgstr "" +#: builders/html/__init__.py:1412 +#, python-format +msgid "favicon file %r does not exist" +msgstr "favicon 檔案 %r 不存在" -#: ext/intersphinx/_load.py:261 +#: builders/html/__init__.py:1425 #, python-format -msgid "loading intersphinx inventory '%s' from %s ..." +msgid "" +"Values in 'html_sidebars' must be a list of strings. At least one pattern " +"has a string value: %s. Change to `html_sidebars = %r`." msgstr "" -#: ext/intersphinx/_load.py:287 +#: builders/html/__init__.py:1438 msgid "" -"encountered some issues with some of the inventories, but they had working " -"alternatives:" -msgstr "從一些庫存中遇到一些問題,但他們已在進行替代方案:" - -#: ext/intersphinx/_load.py:297 -msgid "failed to reach any of the inventories with the following issues:" -msgstr "無法到達任何的庫存,遇到以下問題:" +"HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in " +"configuration options)" +msgstr "HTML 4 已不再被 Sphinx 所支援。(在組態選項中偵測到 \"html4_writer=True\")" -#: ext/intersphinx/_load.py:361 +#: builders/html/__init__.py:1454 #, python-format -msgid "intersphinx inventory has moved: %s -> %s" -msgstr "intersphinx 庫存已移動: %s -> %s" +msgid "%s %s documentation" +msgstr "%s %s 說明文件" -#: ext/autodoc/__init__.py:150 +#: builders/latex/theming.py:87 #, python-format -msgid "invalid value for member-order option: %s" -msgstr "對於 member-order 選項無效的值: %s" +msgid "%r doesn't have \"theme\" setting" +msgstr "%r 沒有「主題」設定" -#: ext/autodoc/__init__.py:158 +#: builders/latex/theming.py:90 #, python-format -msgid "invalid value for class-doc-from option: %s" -msgstr "對於 class-doc-from 選項無效的值: %s" +msgid "%r doesn't have \"%s\" setting" +msgstr "%r 沒有 \"%s\" 設定" -#: ext/autodoc/__init__.py:460 -#, python-format -msgid "invalid signature for auto%s (%r)" -msgstr "無效的簽章給 auto%s (%r)" +#: builders/latex/transforms.py:120 +msgid "Failed to get a docname!" +msgstr "無法取得 docname!" -#: ext/autodoc/__init__.py:579 +#: builders/latex/transforms.py:121 #, python-format -msgid "error while formatting arguments for %s: %s" -msgstr "在為 %s 格式化引數時有錯誤: %s" +msgid "Failed to get a docname for source %r!" +msgstr "" -#: ext/autodoc/__init__.py:898 +#: builders/latex/transforms.py:487 #, python-format -msgid "" -"autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n" -"%s" -msgstr "autodoc: 決定 %s.%s (%r) 被文件化失敗,引發以下的例外:\n%s" +msgid "No footnote was found for given reference node %r" +msgstr "給定的參考節點 %r 找不到註腳" -#: ext/autodoc/__init__.py:1021 +#: builders/latex/__init__.py:115 #, python-format +msgid "The LaTeX files are in %(outdir)s." +msgstr "LaTeX 檔案在 %(outdir)s 。" + +#: builders/latex/__init__.py:118 msgid "" -"don't know which module to import for autodocumenting %r (try placing a " -"\"module\" or \"currentmodule\" directive in the document, or giving an " -"explicit module name)" -msgstr "不清楚要 import 哪個模組來 autodocument %r (試試看在文件中加入 \"module\" 或 \"currentmodule\" 指令,或是給予一個明確的模組名稱)" +"\n" +"Run 'make' in that directory to run these through (pdf)latex\n" +"(use `make latexpdf' here to do that automatically)." +msgstr "\n在該目錄中執行 'make' 以透過 (pdf)latex 執行這些\n(在此使用 'make latexpdf' 以自動執行)" -#: ext/autodoc/__init__.py:1080 -#, python-format -msgid "A mocked object is detected: %r" -msgstr "一個 mocked 物件被偵測到: %r" +#: builders/latex/__init__.py:156 +msgid "no \"latex_documents\" config value found; no documents will be written" +msgstr "未找到 \"latex_documents\" 組態值;不會編寫任何文件" -#: ext/autodoc/__init__.py:1103 +#: builders/latex/__init__.py:167 #, python-format -msgid "error while formatting signature for %s: %s" -msgstr "正在為 %s 格式化簽名時發生錯誤: %s" +msgid "\"latex_documents\" config value references unknown document %s" +msgstr "\"latex_documents\" 組態值引用未知的文件 %s" -#: ext/autodoc/__init__.py:1177 -msgid "\"::\" in automodule name doesn't make sense" -msgstr "\"::\" 在 automodule 的名稱中並不合理" +#: builders/latex/__init__.py:421 +msgid "copying TeX support files" +msgstr "正在複製 TeX 支援檔案" -#: ext/autodoc/__init__.py:1185 -#, python-format -msgid "signature arguments or return annotation given for automodule %s" -msgstr "簽名引數或回傳註釋給予 automodule %s" +#: builders/latex/__init__.py:458 +msgid "copying additional files" +msgstr "正在複製附加檔案" -#: ext/autodoc/__init__.py:1201 +#: builders/latex/__init__.py:529 #, python-format -msgid "" -"__all__ should be a list of strings, not %r (in module %s) -- ignoring " -"__all__" -msgstr "__all__ 應該是一個字串的列表,不是 %r (在 %s 模組中)-- 正在忽略 __all__" +msgid "Unknown configure key: latex_elements[%r], ignored." +msgstr "未知的配置鍵: latex_elements[%r],已略過。" -#: ext/autodoc/__init__.py:1278 +#: builders/latex/__init__.py:537 #, python-format -msgid "" -"missing attribute mentioned in :members: option: module %s, attribute %s" -msgstr "缺少 :members: 選項中所述的屬性:模組 %s ,屬性 %s" +msgid "Unknown theme option: latex_theme_options[%r], ignored." +msgstr "未知的主題選項: latex_theme_options[%r],,已略過。" -#: ext/autodoc/__init__.py:1505 ext/autodoc/__init__.py:1593 -#: ext/autodoc/__init__.py:3127 +#: environment/collectors/toctree.py:259 #, python-format -msgid "Failed to get a function signature for %s: %s" -msgstr "無法取得一個函式簽名給 %s: %s" +msgid "%s is already assigned section numbers (nested numbered toctree?)" +msgstr "%s 已經被指定段落編號(巢狀編號的 toctree?)" -#: ext/autodoc/__init__.py:1828 +#: environment/collectors/asset.py:98 #, python-format -msgid "Failed to get a constructor signature for %s: %s" -msgstr "無法取得一個 constructor 簽名給 %s: %s" +msgid "image file not readable: %s" +msgstr "影像檔案無法讀取: %s" -#: ext/autodoc/__init__.py:1966 +#: environment/collectors/asset.py:126 #, python-format -msgid "Bases: %s" -msgstr "基礎類別:%s" +msgid "image file %s not readable: %s" +msgstr "影像檔案 %s 無法讀取: %s" -#: ext/autodoc/__init__.py:1985 +#: environment/collectors/asset.py:165 #, python-format -msgid "missing attribute %s in object %s" -msgstr "遺漏屬性 %s 在物件 %s" +msgid "download file not readable: %s" +msgstr "下載檔案無法讀取: %s" -#: ext/autodoc/__init__.py:2081 ext/autodoc/__init__.py:2110 -#: ext/autodoc/__init__.py:2204 +#: environment/adapters/toctree.py:335 #, python-format -msgid "alias of %s" -msgstr "%s 的別名" +msgid "circular toctree references detected, ignoring: %s <- %s" +msgstr "偵測到循環的 toctree 參照,忽略中: %s <- %s" -#: ext/autodoc/__init__.py:2097 +#: environment/adapters/toctree.py:360 #, python-format -msgid "alias of TypeVar(%s)" -msgstr "TypeVar(%s) 的別名" +msgid "" +"toctree contains reference to document %r that doesn't have a title: no link" +" will be generated" +msgstr "toctree 包含了到文件 %r 的參照,該文件沒有標題:不會產生任何鏈接" -#: ext/autodoc/__init__.py:2456 ext/autodoc/__init__.py:2576 +#: environment/adapters/toctree.py:375 #, python-format -msgid "Failed to get a method signature for %s: %s" -msgstr "無法取得一個 method 簽名給 %s: %s" +msgid "toctree contains reference to non-included document %r" +msgstr "toctree 包含了 non-included 文件 %r 的參照" -#: ext/autodoc/__init__.py:2720 +#: environment/adapters/toctree.py:378 #, python-format -msgid "Invalid __slots__ found on %s. Ignored." -msgstr "在 %s 找到無效的 __slots__。已略過。" +msgid "toctree contains reference to non-existing document %r" +msgstr "" -#: ext/autodoc/preserve_defaults.py:195 +#: environment/adapters/indexentries.py:122 #, python-format -msgid "Failed to parse a default argument value for %r: %s" -msgstr "無法為 %r 剖析一個預設引數: %s" +msgid "see %s" +msgstr "參考 %s" -#: ext/autodoc/type_comment.py:151 +#: environment/adapters/indexentries.py:132 #, python-format -msgid "Failed to update signature for %r: parameter not found: %s" -msgstr "無法為 %r 更新簽名:未找到參數: %s" +msgid "see also %s" +msgstr "請參閱 %s" -#: ext/autodoc/type_comment.py:154 +#: environment/adapters/indexentries.py:140 #, python-format -msgid "Failed to parse type_comment for %r: %s" -msgstr "無法為 %r 剖析 type_comment: %s" +msgid "unknown index entry type %r" +msgstr "未知的索引項目型別 %r" diff --git a/sphinx/parsers.py b/sphinx/parsers.py index 70ff3eaae62..5731ccd6f66 100644 --- a/sphinx/parsers.py +++ b/sphinx/parsers.py @@ -10,7 +10,8 @@ from docutils.statemachine import StringList from docutils.transforms.universal import SmartQuotes -from sphinx.util.rst import append_epilog, prepend_prolog +from sphinx.deprecation import _deprecation_warning +from sphinx.util.rst import _append_epilogue, _prepend_prologue if TYPE_CHECKING: from docutils import nodes @@ -23,30 +24,42 @@ class Parser(docutils.parsers.Parser): - """A base class of source parsers. + """A base class for source parsers. - The additional parsers should inherit this class - instead of ``docutils.parsers.Parser``. - Compared with ``docutils.parsers.Parser``, - this class improves accessibility to Sphinx APIs. - - The subclasses can access sphinx core runtime objects (app, config and env). + Additional parsers should inherit from this class instead of + ``docutils.parsers.Parser``. + This class provides access to core Sphinx objects; *config* and *env*. """ - #: The config object - config: Config - - #: The environment object - env: BuildEnvironment + _config: Config + _env: BuildEnvironment + + @property + def config(self) -> Config: + """The config object.""" + cls_module = self.__class__.__module__ + cls_name = self.__class__.__qualname__ + _deprecation_warning(cls_module, f'{cls_name}.config', remove=(10, 0)) + return self._config + + @property + def env(self) -> BuildEnvironment: + """The environment object.""" + cls_module = self.__class__.__module__ + cls_name = self.__class__.__qualname__ + _deprecation_warning(cls_module, f'{cls_name}.env', remove=(10, 0)) + return self._env def set_application(self, app: Sphinx) -> None: """set_application will be called from Sphinx to set app and other instance variables :param sphinx.application.Sphinx app: Sphinx application object """ - self._app = app - self.config = app.config - self.env = app.env + cls_module = self.__class__.__module__ + cls_name = self.__class__.__qualname__ + _deprecation_warning(cls_module, f'{cls_name}.set_application', remove=(10, 0)) + self._config = app.config + self._env = app.env class RSTParser(docutils.parsers.rst.Parser, Parser): @@ -57,7 +70,7 @@ def get_transforms(self) -> list[type[Transform]]: refs: sphinx.io.SphinxStandaloneReader """ - transforms = super().get_transforms() + transforms = super(RSTParser, RSTParser()).get_transforms() transforms.remove(SmartQuotes) return transforms @@ -87,9 +100,9 @@ def parse(self, inputstring: str | StringList, document: nodes.document) -> None self.finish_parse() def decorate(self, content: StringList) -> None: - """Preprocess reST content before parsing.""" - prepend_prolog(content, self.config.rst_prolog) - append_epilog(content, self.config.rst_epilog) + """Preprocess reStructuredText content before parsing.""" + _prepend_prologue(content, self._config.rst_prolog) + _append_epilogue(content, self._config.rst_epilog) def setup(app: Sphinx) -> ExtensionMetadata: diff --git a/sphinx/pycode/ast.py b/sphinx/pycode/ast.py index b1521595b49..7f7850f3616 100644 --- a/sphinx/pycode/ast.py +++ b/sphinx/pycode/ast.py @@ -134,7 +134,7 @@ def visit_Call(self, node: ast.Call) -> str: def visit_Constant(self, node: ast.Constant) -> str: if node.value is Ellipsis: return '...' - elif isinstance(node.value, int | float | complex): + elif isinstance(node.value, (int, float, complex)): if self.code: return ast.get_source_segment(self.code, node) or repr(node.value) else: @@ -202,5 +202,8 @@ def visit_Tuple(self, node: ast.Tuple) -> str: else: return '(' + ', '.join(self.visit(e) for e in node.elts) + ')' + def visit_Starred(self, node: ast.Starred) -> str: + return f'*{self.visit(node.value)}' + def generic_visit(self, node: ast.AST) -> NoReturn: raise NotImplementedError('Unable to parse %s object' % type(node).__name__) diff --git a/sphinx/pycode/parser.py b/sphinx/pycode/parser.py index 34d30200f75..a325dd79667 100644 --- a/sphinx/pycode/parser.py +++ b/sphinx/pycode/parser.py @@ -20,6 +20,9 @@ from inspect import Signature from typing import Any +AssignmentLike = ast.Assign | ast.AnnAssign | ast.TypeAlias +AssignmentLikeType = (ast.Assign, ast.AnnAssign, ast.TypeAlias) + comment_re = re.compile('^\\s*#: ?(.*)\r?\n?$') indent_re = re.compile('^\\s*$') emptyline_re = re.compile('^\\s*(#.*)?$') @@ -29,12 +32,14 @@ def filter_whitespace(code: str) -> str: return code.replace('\f', ' ') # replace FF (form feed) with whitespace -def get_assign_targets(node: ast.AST) -> list[ast.expr]: - """Get list of targets from Assign and AnnAssign node.""" +def get_assign_targets(node: AssignmentLike) -> list[ast.expr]: + """Get list of targets from AssignmentLike node.""" if isinstance(node, ast.Assign): return node.targets + elif isinstance(node, ast.AnnAssign): + return [node.target] else: - return [node.target] # type: ignore[attr-defined] + return [node.name] # ast.TypeAlias def get_lvar_names(node: ast.AST, self: ast.arg | None = None) -> list[str]: @@ -119,7 +124,7 @@ def __eq__(self, other: object) -> bool: return self.kind == other elif isinstance(other, str): return self.value == other - elif isinstance(other, list | tuple): + elif isinstance(other, (list, tuple)): return [self.kind, self.value] == list(other) elif other is None: return False @@ -247,9 +252,9 @@ def __init__(self, buffers: list[str], encoding: str) -> None: self.deforders: dict[str, int] = {} self.finals: list[str] = [] self.overloads: dict[str, list[Signature]] = {} - self.typing: str | None = None - self.typing_final: str | None = None - self.typing_overload: str | None = None + self.typing_mods: set[str] = set() + self.typing_final_names: set[str] = set() + self.typing_overload_names: set[str] = set() super().__init__() def get_qualname_for(self, name: str) -> list[str] | None: @@ -257,7 +262,7 @@ def get_qualname_for(self, name: str) -> list[str] | None: if self.current_function: if self.current_classes and self.context[-1] == '__init__': # store variable comments inside __init__ method of classes - return self.context[:-1] + [name] + return [*self.context[:-1], name] else: return None else: @@ -295,11 +300,8 @@ def add_variable_annotation(self, name: str, annotation: ast.AST) -> None: self.annotations[basename, name] = ast_unparse(annotation) def is_final(self, decorators: list[ast.expr]) -> bool: - final = [] - if self.typing: - final.append('%s.final' % self.typing) - if self.typing_final: - final.append(self.typing_final) + final = {f'{modname}.final' for modname in self.typing_mods} + final |= self.typing_final_names for decorator in decorators: try: @@ -311,11 +313,8 @@ def is_final(self, decorators: list[ast.expr]) -> bool: return False def is_overload(self, decorators: list[ast.expr]) -> bool: - overload = [] - if self.typing: - overload.append('%s.overload' % self.typing) - if self.typing_overload: - overload.append(self.typing_overload) + overload = {f'{modname}.overload' for modname in self.typing_mods} + overload |= self.typing_overload_names for decorator in decorators: try: @@ -338,34 +337,7 @@ def get_line(self, lineno: int) -> str: """Returns specified line.""" return self.buffers[lineno - 1] - def visit(self, node: ast.AST) -> None: - """Updates self.previous to the given node.""" - super().visit(node) - self.previous = node - - def visit_Import(self, node: ast.Import) -> None: - """Handles Import node and record the order of definitions.""" - for name in node.names: - self.add_entry(name.asname or name.name) - - if name.name == 'typing': - self.typing = name.asname or name.name - elif name.name == 'typing.final': - self.typing_final = name.asname or name.name - elif name.name == 'typing.overload': - self.typing_overload = name.asname or name.name - - def visit_ImportFrom(self, node: ast.ImportFrom) -> None: - """Handles Import node and record the order of definitions.""" - for name in node.names: - self.add_entry(name.asname or name.name) - - if node.module == 'typing' and name.name == 'final': - self.typing_final = name.asname or name.name - elif node.module == 'typing' and name.name == 'overload': - self.typing_overload = name.asname or name.name - - def visit_Assign(self, node: ast.Assign) -> None: + def _handle_assignment(self, node: ast.Assign | ast.AnnAssign) -> None: """Handles Assign node and pick up a variable comment.""" try: targets = get_assign_targets(node) @@ -385,11 +357,19 @@ def visit_Assign(self, node: ast.Assign) -> None: elif hasattr(node, 'type_comment') and node.type_comment: for varname in varnames: self.add_variable_annotation(varname, node.type_comment) # type: ignore[arg-type] + self._collect_doc_comment(node, varnames, current_line) + def _collect_doc_comment( + self, + node: AssignmentLike, + varnames: list[str], + current_line: str, + ) -> None: # check comments after assignment - parser = AfterCommentParser( - [current_line[node.col_offset :]] + self.buffers[node.lineno :] - ) + parser = AfterCommentParser([ + current_line[node.col_offset :], + *self.buffers[node.lineno :], + ]) parser.parse() if parser.comment and comment_re.match(parser.comment): for varname in varnames: @@ -420,14 +400,47 @@ def visit_Assign(self, node: ast.Assign) -> None: for varname in varnames: self.add_entry(varname) + def visit(self, node: ast.AST) -> None: + """Updates self.previous to the given node.""" + super().visit(node) + self.previous = node + + def visit_Import(self, node: ast.Import) -> None: + """Handles Import node and record the order of definitions.""" + for name in node.names: + self.add_entry(name.asname or name.name) + + if name.name in {'typing', 'typing_extensions'}: + self.typing_mods.add(name.asname or name.name) + elif name.name in {'typing.final', 'typing_extensions.final'}: + self.typing_final_names.add(name.asname or name.name) + elif name.name in {'typing.overload', 'typing_extensions.overload'}: + self.typing_overload_names.add(name.asname or name.name) + + def visit_ImportFrom(self, node: ast.ImportFrom) -> None: + """Handles Import node and record the order of definitions.""" + for name in node.names: + self.add_entry(name.asname or name.name) + + if node.module not in {'typing', 'typing_extensions'}: + continue + if name.name == 'final': + self.typing_final_names.add(name.asname or name.name) + elif name.name == 'overload': + self.typing_overload_names.add(name.asname or name.name) + + def visit_Assign(self, node: ast.Assign) -> None: + """Handles Assign node and pick up a variable comment.""" + self._handle_assignment(node) + def visit_AnnAssign(self, node: ast.AnnAssign) -> None: """Handles AnnAssign node and pick up a variable comment.""" - self.visit_Assign(node) # type: ignore[arg-type] + self._handle_assignment(node) def visit_Expr(self, node: ast.Expr) -> None: """Handles Expr node and pick up a comment if string.""" if ( - isinstance(self.previous, ast.Assign | ast.AnnAssign) + isinstance(self.previous, AssignmentLikeType) and isinstance(node.value, ast.Constant) and isinstance(node.value.value, str) ): @@ -488,6 +501,15 @@ def visit_AsyncFunctionDef(self, node: ast.AsyncFunctionDef) -> None: """Handles AsyncFunctionDef node and set context.""" self.visit_FunctionDef(node) # type: ignore[arg-type] + def visit_TypeAlias(self, node: ast.TypeAlias) -> None: + """Handles TypeAlias node and picks up a variable comment. + + .. note:: TypeAlias node refers to `type Foo = Bar` (PEP 695) assignment, + NOT `Foo: TypeAlias = Bar` (PEP 613). + """ + current_line = self.get_line(node.lineno) + self._collect_doc_comment(node, [node.name.id], current_line) + class DefinitionFinder(TokenProcessor): """Python source code parser to detect location of functions, diff --git a/sphinx/registry.py b/sphinx/registry.py index ce52a03b323..df0f7dc32dc 100644 --- a/sphinx/registry.py +++ b/sphinx/registry.py @@ -12,7 +12,6 @@ from sphinx.domains.std import GenericObject, Target from sphinx.errors import ExtensionError, SphinxError, VersionRequirementError from sphinx.extension import Extension -from sphinx.io import create_publisher from sphinx.locale import __ from sphinx.parsers import Parser as SphinxParser from sphinx.roles import XRefRole @@ -23,10 +22,9 @@ if TYPE_CHECKING: import os from collections.abc import Callable, Iterator, Mapping, Sequence - from typing import Any, TypeAlias + from typing import Any from docutils import nodes - from docutils.core import Publisher from docutils.nodes import Element, Node, TextElement from docutils.parsers import Parser from docutils.parsers.rst import Directive @@ -38,7 +36,7 @@ from sphinx.config import Config from sphinx.domains import Domain, Index from sphinx.environment import BuildEnvironment - from sphinx.ext.autodoc import Documenter + from sphinx.ext.autodoc._legacy_class_based._documenters import Documenter from sphinx.util.docfields import Field from sphinx.util.typing import ( ExtensionMetadata, @@ -51,15 +49,13 @@ # visit/depart function # the parameters should be (SphinxTranslator, Element) # or any subtype of either, but mypy rejects this. - _NodeHandler: TypeAlias = Callable[[Any, Any], None] - _NodeHandlerPair: TypeAlias = tuple[_NodeHandler, _NodeHandler | None] + type _NodeHandler = Callable[[Any, Any], None] + type _NodeHandlerPair = tuple[_NodeHandler, _NodeHandler | None] - _MathsRenderer: TypeAlias = Callable[[HTML5Translator, nodes.math], None] - _MathsBlockRenderer: TypeAlias = Callable[[HTML5Translator, nodes.math_block], None] - _MathsInlineRenderers: TypeAlias = tuple[_MathsRenderer, _MathsRenderer | None] - _MathsBlockRenderers: TypeAlias = tuple[ - _MathsBlockRenderer, _MathsBlockRenderer | None - ] + type _MathsRenderer = Callable[[HTML5Translator, nodes.math], None] + type _MathsBlockRenderer = Callable[[HTML5Translator, nodes.math_block], None] + type _MathsInlineRenderers = tuple[_MathsRenderer, _MathsRenderer | None] + type _MathsBlockRenderers = tuple[_MathsBlockRenderer, _MathsBlockRenderer | None] logger = logging.getLogger(__name__) @@ -153,9 +149,6 @@ def __init__(self) -> None: #: additional transforms; list of transforms self.transforms: list[type[Transform]] = [] - # private cache of Docutils Publishers (file type -> publisher object) - self.publishers: dict[str, Publisher] = {} - @property def autodoc_attrgettrs(self) -> dict[type, Callable[[Any, str, Any], Any]]: return self.autodoc_attrgetters @@ -375,11 +368,14 @@ def get_source_parser(self, filetype: str) -> type[Parser]: def get_source_parsers(self) -> dict[str, type[Parser]]: return self.source_parsers - def create_source_parser(self, app: Sphinx, filename: str) -> Parser: + def create_source_parser( + self, filename: str, *, config: Config, env: BuildEnvironment + ) -> Parser: parser_class = self.get_source_parser(filename) parser = parser_class() if isinstance(parser, SphinxParser): - parser.set_application(app) + parser._config = config + parser._env = env return parser def add_translator( @@ -410,7 +406,9 @@ def add_translation_handlers( % (builder_name, handlers), ) from exc - def get_translator_class(self, builder: Builder) -> type[nodes.NodeVisitor]: + def get_translator_class( + self, builder: type[Builder] | Builder + ) -> type[nodes.NodeVisitor]: try: return self.translators[builder.name] except KeyError: @@ -420,7 +418,9 @@ def get_translator_class(self, builder: Builder) -> type[nodes.NodeVisitor]: msg = f'translator not found for {builder.name}' raise AttributeError(msg) from err - def create_translator(self, builder: Builder, *args: Any) -> nodes.NodeVisitor: + def create_translator( + self, builder: type[Builder] | Builder, *args: Any + ) -> nodes.NodeVisitor: translator_class = self.get_translator_class(builder) translator = translator_class(*args) @@ -589,15 +589,6 @@ def get_envversion(self, app: Sphinx) -> Mapping[str, int]: return _get_env_version(app.extensions) - def get_publisher(self, app: Sphinx, filetype: str) -> Publisher: - try: - return self.publishers[filetype] - except KeyError: - pass - publisher = create_publisher(app, filetype) - self.publishers[filetype] = publisher - return publisher - def merge_source_suffix(app: Sphinx, config: Config) -> None: """Merge any user-specified source_suffix with any added by extensions.""" diff --git a/sphinx/roles.py b/sphinx/roles.py index 98843de5a95..fdb997314fe 100644 --- a/sphinx/roles.py +++ b/sphinx/roles.py @@ -6,14 +6,13 @@ from typing import TYPE_CHECKING import docutils.parsers.rst.directives -import docutils.parsers.rst.roles import docutils.parsers.rst.states from docutils import nodes, utils from sphinx import addnodes from sphinx.locale import _, __ from sphinx.util import ws_re -from sphinx.util.docutils import ReferenceRole, SphinxRole +from sphinx.util.docutils import ReferenceRole, SphinxRole, _normalize_options if TYPE_CHECKING: from collections.abc import Sequence @@ -103,7 +102,7 @@ def run(self) -> tuple[list[Node], list[system_message]]: self.refdomain, self.reftype = '', self.name self.classes = ['xref', self.reftype] else: - self.refdomain, self.reftype = self.name.split(':', 1) + self.refdomain, _, self.reftype = self.name.partition(':') self.classes = ['xref', self.refdomain, f'{self.refdomain}-{self.reftype}'] if self.disabled: @@ -115,7 +114,7 @@ def create_non_xref_node(self) -> tuple[list[Node], list[system_message]]: text = utils.unescape(self.text[1:]) if self.fix_parens: self.has_explicit_title = False # treat as implicit - text, target = self.update_title_and_target(text, '') + text, _target = self.update_title_and_target(text, '') node = self.innernodeclass(self.rawtext, text, classes=self.classes) return self.result_nodes(self.inliner.document, self.env, node, is_ref=False) @@ -130,7 +129,7 @@ def create_xref_node(self) -> tuple[list[Node], list[system_message]]: # create the reference node options = { - 'refdoc': self.env.docname, + 'refdoc': self.env.current_document.docname, 'refdomain': self.refdomain, 'reftype': self.reftype, 'refexplicit': self.has_explicit_title, @@ -234,9 +233,9 @@ def run(self) -> tuple[list[Node], list[system_message]]: return [index, target, reference], [] def build_uri(self) -> str: - ret = self.target.split('#', 1) - if len(ret) == 2: - return f'{CVE._BASE_URL}{ret[0]}#{ret[1]}' + ret = self.target.partition('#') + if ret[1]: + return f'{CVE._BASE_URL}{ret[0]}#{ret[2]}' return f'{CVE._BASE_URL}{ret[0]}' @@ -279,9 +278,9 @@ def run(self) -> tuple[list[Node], list[system_message]]: return [index, target, reference], [] def build_uri(self) -> str: - ret = self.target.split('#', 1) - if len(ret) == 2: - return f'{CWE._BASE_URL}{int(ret[0])}.html#{ret[1]}' + ret = self.target.partition('#') + if ret[1]: + return f'{CWE._BASE_URL}{int(ret[0])}.html#{ret[2]}' return f'{CWE._BASE_URL}{int(ret[0])}.html' @@ -323,9 +322,9 @@ def run(self) -> tuple[list[Node], list[system_message]]: def build_uri(self) -> str: base_url = self.inliner.document.settings.pep_base_url - ret = self.target.split('#', 1) - if len(ret) == 2: - return base_url + 'pep-%04d/#%s' % (int(ret[0]), ret[1]) + ret = self.target.partition('#') + if ret[1]: + return base_url + 'pep-%04d/#%s' % (int(ret[0]), ret[2]) else: return base_url + 'pep-%04d/' % int(ret[0]) @@ -361,9 +360,9 @@ def run(self) -> tuple[list[Node], list[system_message]]: def build_uri(self) -> str: base_url = self.inliner.document.settings.rfc_base_url - ret = self.target.split('#', 1) - if len(ret) == 2: - return base_url + self.inliner.rfc_url % int(ret[0]) + '#' + ret[1] + ret = self.target.partition('#') + if ret[1]: + return base_url + self.inliner.rfc_url % int(ret[0]) + '#' + ret[2] else: return base_url + self.inliner.rfc_url % int(ret[0]) @@ -584,10 +583,7 @@ def code_role( options: dict[str, Any] | None = None, content: Sequence[str] = (), ) -> tuple[list[Node], list[system_message]]: - if options is None: - options = {} - options = options.copy() - docutils.parsers.rst.roles.set_classes(options) + options = _normalize_options(options) language = options.get('language', '') classes = ['code'] if language: diff --git a/sphinx/search/__init__.py b/sphinx/search/__init__.py index cd0aa0bbd8f..956d9bf41fa 100644 --- a/sphinx/search/__init__.py +++ b/sphinx/search/__init__.py @@ -20,22 +20,19 @@ from sphinx.util.index_entries import split_index_msg if TYPE_CHECKING: - from collections.abc import Callable, Iterable - from typing import Any, Protocol, TypeVar + from collections.abc import Callable, Iterable, Set + from typing import Any, Protocol from docutils.nodes import Node from sphinx.environment import BuildEnvironment - _T_co = TypeVar('_T_co', covariant=True) - _T_contra = TypeVar('_T_contra', contravariant=True) + class _ReadableStream[T](Protocol): + def read(self, n: int = ..., /) -> T: ... + def readline(self, n: int = ..., /) -> T: ... - class _ReadableStream(Protocol[_T_co]): - def read(self, n: int = ..., /) -> _T_co: ... - def readline(self, n: int = ..., /) -> _T_co: ... - - class _WritableStream(Protocol[_T_contra]): - def write(self, s: _T_contra, /) -> object: ... + class _WritableStream[T](Protocol): + def write(self, s: T, /) -> object: ... _NON_MINIFIED_JS_PATH = package_dir.joinpath('search', 'non-minified-js') @@ -74,28 +71,25 @@ class SearchLanguage: lang: str = '' language_name: str = '' - stopwords: set[str] = set() + stopwords: Set[str] = frozenset() js_splitter_code: str = '' js_stemmer_rawcode: str = '' js_stemmer_code = """ /** * Dummy stemmer for languages without stemming rules. */ -var Stemmer = function() { - this.stemWord = function(w) { +var Stemmer = function () { + this.stemWord = function (w) { return w; - } -} + }; +}; """ _word_re = re.compile(r'\w+') def __init__(self, options: dict[str, str]) -> None: - self.options = options - self.init(options) - - def init(self, options: dict[str, str]) -> None: """Initialize the class with the options the user has given.""" + self.options = options def split(self, input: str) -> list[str]: """This method splits a sentence into words. Default splitter splits input @@ -120,10 +114,7 @@ def word_filter(self, word: str) -> bool: """Return true if the target word should be registered in the search index. This method is called after stemming. """ - return len(word) == 0 or not ( - ((len(word) < 3) and (12353 < ord(word[0]) < 12436)) - or (ord(word[0]) < 256 and (word in self.stopwords)) - ) + return not word.isdigit() and word not in self.stopwords # SearchEnglish imported after SearchLanguage is defined due to circular import @@ -131,9 +122,11 @@ def word_filter(self, word: str) -> bool: def parse_stop_word(source: str) -> set[str]: - """Parse snowball style word list like this: + """Collect the stopwords from a snowball style word list: - * https://snowball.tartarus.org/algorithms/finnish/stop.txt + .. code:: text + + list of space separated stop words | optional comment """ result: set[str] = set() for line in source.splitlines(): @@ -304,7 +297,7 @@ def __init__( # fallback; try again with language-code if lang_class is None and '_' in lang: - lang_class = languages.get(lang.split('_')[0]) + lang_class = languages.get(lang.partition('_')[0]) if lang_class is None: self.lang: SearchLanguage = SearchEnglish(options) @@ -584,17 +577,17 @@ def get_js_stemmer_rawcode(self) -> str | None: def get_js_stemmer_code(self) -> str: """Returns JS code that will be inserted into language_data.js.""" - if self.lang.js_stemmer_rawcode: - base_js_path = _NON_MINIFIED_JS_PATH / 'base-stemmer.js' - language_js_path = _NON_MINIFIED_JS_PATH / self.lang.js_stemmer_rawcode - base_js = base_js_path.read_text(encoding='utf-8') - language_js = language_js_path.read_text(encoding='utf-8') - return ( - f'{base_js}\n{language_js}\nStemmer = {self.lang.language_name}Stemmer;' - ) - else: + if not self.lang.js_stemmer_rawcode: return self.lang.js_stemmer_code + base_js_path = _MINIFIED_JS_PATH / 'base-stemmer.js' + language_js_path = _MINIFIED_JS_PATH / self.lang.js_stemmer_rawcode + return '\n'.join(( + base_js_path.read_text(encoding='utf-8'), + language_js_path.read_text(encoding='utf-8'), + f'window.Stemmer = {self.lang.language_name}Stemmer;', + )) + def _feed_visit_nodes( node: nodes.Node, diff --git a/sphinx/search/_stopwords/__init__.py b/sphinx/search/_stopwords/__init__.py new file mode 100644 index 00000000000..e69de29bb2d diff --git a/sphinx/search/_stopwords/da.py b/sphinx/search/_stopwords/da.py new file mode 100644 index 00000000000..4991deb861e --- /dev/null +++ b/sphinx/search/_stopwords/da.py @@ -0,0 +1,101 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/danish/stop.txt + +from __future__ import annotations + +DANISH_STOPWORDS = frozenset({ + 'ad', + 'af', + 'alle', + 'alt', + 'anden', + 'at', + 'blev', + 'blive', + 'bliver', + 'da', + 'de', + 'dem', + 'den', + 'denne', + 'der', + 'deres', + 'det', + 'dette', + 'dig', + 'din', + 'disse', + 'dog', + 'du', + 'efter', + 'eller', + 'en', + 'end', + 'er', + 'et', + 'for', + 'fra', + 'ham', + 'han', + 'hans', + 'har', + 'havde', + 'have', + 'hende', + 'hendes', + 'her', + 'hos', + 'hun', + 'hvad', + 'hvis', + 'hvor', + 'i', + 'ikke', + 'ind', + 'jeg', + 'jer', + 'jo', + 'kunne', + 'man', + 'mange', + 'med', + 'meget', + 'men', + 'mig', + 'min', + 'mine', + 'mit', + 'mod', + 'ned', + 'noget', + 'nogle', + 'nu', + 'når', + 'og', + 'også', + 'om', + 'op', + 'os', + 'over', + 'på', + 'selv', + 'sig', + 'sin', + 'sine', + 'sit', + 'skal', + 'skulle', + 'som', + 'sådan', + 'thi', + 'til', + 'ud', + 'under', + 'var', + 'vi', + 'vil', + 'ville', + 'vor', + 'være', + 'været', +}) diff --git a/sphinx/search/_stopwords/da.txt b/sphinx/search/_stopwords/da.txt new file mode 100644 index 00000000000..9761414a1c6 --- /dev/null +++ b/sphinx/search/_stopwords/da.txt @@ -0,0 +1,102 @@ + + | A Danish stop word list. Comments begin with vertical bar. Each stop + | word is at the start of a line. + + | This is a ranked list (commonest to rarest) of stopwords derived from + | a large text sample. + + +og | and +i | in +jeg | I +det | that (dem. pronoun)/it (pers. pronoun) +at | that (in front of a sentence)/to (with infinitive) +en | a/an +den | it (pers. pronoun)/that (dem. pronoun) +til | to/at/for/until/against/by/of/into, more +er | present tense of "to be" +som | who, as +på | on/upon/in/on/at/to/after/of/with/for, on +de | they +med | with/by/in, along +han | he +af | of/by/from/off/for/in/with/on, off +for | at/for/to/from/by/of/ago, in front/before, because +ikke | not +der | who/which, there/those +var | past tense of "to be" +mig | me/myself +sig | oneself/himself/herself/itself/themselves +men | but +et | a/an/one, one (number), someone/somebody/one +har | present tense of "to have" +om | round/about/for/in/a, about/around/down, if +vi | we +min | my +havde | past tense of "to have" +ham | him +hun | she +nu | now +over | over/above/across/by/beyond/past/on/about, over/past +da | then, when/as/since +fra | from/off/since, off, since +du | you +ud | out +sin | his/her/its/one's +dem | them +os | us/ourselves +op | up +man | you/one +hans | his +hvor | where +eller | or +hvad | what +skal | must/shall etc. +selv | myself/youself/herself/ourselves etc., even +her | here +alle | all/everyone/everybody etc. +vil | will (verb) +blev | past tense of "to stay/to remain/to get/to become" +kunne | could +ind | in +når | when +være | present tense of "to be" +dog | however/yet/after all +noget | something +ville | would +jo | you know/you see (adv), yes +deres | their/theirs +efter | after/behind/according to/for/by/from, later/afterwards +ned | down +skulle | should +denne | this +end | than +dette | this +mit | my/mine +også | also +under | under/beneath/below/during, below/underneath +have | have +dig | you +anden | other +hende | her +mine | my +alt | everything +meget | much/very, plenty of +sit | his, her, its, one's +sine | his, her, its, one's +vor | our +mod | against +disse | these +hvis | if +din | your/yours +nogle | some +hos | by/at +blive | be/become +mange | many +ad | by/through +bliver | present tense of "to be/to become" +hendes | her/hers +været | be +thi | for (conj) +jer | you +sådan | such, like this/like that diff --git a/sphinx/search/_stopwords/de.py b/sphinx/search/_stopwords/de.py new file mode 100644 index 00000000000..d728493d307 --- /dev/null +++ b/sphinx/search/_stopwords/de.py @@ -0,0 +1,238 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/german/stop.txt + +from __future__ import annotations + +GERMAN_STOPWORDS = frozenset({ + 'aber', + 'alle', + 'allem', + 'allen', + 'aller', + 'alles', + 'als', + 'also', + 'am', + 'an', + 'ander', + 'andere', + 'anderem', + 'anderen', + 'anderer', + 'anderes', + 'anderm', + 'andern', + 'anderr', + 'anders', + 'auch', + 'auf', + 'aus', + 'bei', + 'bin', + 'bis', + 'bist', + 'da', + 'damit', + 'dann', + 'das', + 'daß', + 'dasselbe', + 'dazu', + 'dein', + 'deine', + 'deinem', + 'deinen', + 'deiner', + 'deines', + 'dem', + 'demselben', + 'den', + 'denn', + 'denselben', + 'der', + 'derer', + 'derselbe', + 'derselben', + 'des', + 'desselben', + 'dessen', + 'dich', + 'die', + 'dies', + 'diese', + 'dieselbe', + 'dieselben', + 'diesem', + 'diesen', + 'dieser', + 'dieses', + 'dir', + 'doch', + 'dort', + 'du', + 'durch', + 'ein', + 'eine', + 'einem', + 'einen', + 'einer', + 'eines', + 'einig', + 'einige', + 'einigem', + 'einigen', + 'einiger', + 'einiges', + 'einmal', + 'er', + 'es', + 'etwas', + 'euch', + 'euer', + 'eure', + 'eurem', + 'euren', + 'eurer', + 'eures', + 'für', + 'gegen', + 'gewesen', + 'hab', + 'habe', + 'haben', + 'hat', + 'hatte', + 'hatten', + 'hier', + 'hin', + 'hinter', + 'ich', + 'ihm', + 'ihn', + 'ihnen', + 'ihr', + 'ihre', + 'ihrem', + 'ihren', + 'ihrer', + 'ihres', + 'im', + 'in', + 'indem', + 'ins', + 'ist', + 'jede', + 'jedem', + 'jeden', + 'jeder', + 'jedes', + 'jene', + 'jenem', + 'jenen', + 'jener', + 'jenes', + 'jetzt', + 'kann', + 'kein', + 'keine', + 'keinem', + 'keinen', + 'keiner', + 'keines', + 'können', + 'könnte', + 'machen', + 'man', + 'manche', + 'manchem', + 'manchen', + 'mancher', + 'manches', + 'mein', + 'meine', + 'meinem', + 'meinen', + 'meiner', + 'meines', + 'mich', + 'mir', + 'mit', + 'muss', + 'musste', + 'nach', + 'nicht', + 'nichts', + 'noch', + 'nun', + 'nur', + 'ob', + 'oder', + 'ohne', + 'sehr', + 'sein', + 'seine', + 'seinem', + 'seinen', + 'seiner', + 'seines', + 'selbst', + 'sich', + 'sie', + 'sind', + 'so', + 'solche', + 'solchem', + 'solchen', + 'solcher', + 'solches', + 'soll', + 'sollte', + 'sondern', + 'sonst', + 'um', + 'und', + 'uns', + 'unse', + 'unsem', + 'unsen', + 'unser', + 'unses', + 'unter', + 'viel', + 'vom', + 'von', + 'vor', + 'war', + 'waren', + 'warst', + 'was', + 'weg', + 'weil', + 'weiter', + 'welche', + 'welchem', + 'welchen', + 'welcher', + 'welches', + 'wenn', + 'werde', + 'werden', + 'wie', + 'wieder', + 'will', + 'wir', + 'wird', + 'wirst', + 'wo', + 'wollen', + 'wollte', + 'während', + 'würde', + 'würden', + 'zu', + 'zum', + 'zur', + 'zwar', + 'zwischen', + 'über', +}) diff --git a/sphinx/search/_stopwords/de.txt b/sphinx/search/_stopwords/de.txt new file mode 100644 index 00000000000..c8935ae61c7 --- /dev/null +++ b/sphinx/search/_stopwords/de.txt @@ -0,0 +1,285 @@ + + | A German stop word list. Comments begin with vertical bar. Each stop + | word is at the start of a line. + + | The number of forms in this list is reduced significantly by passing it + | through the German stemmer. + + +aber | but + +alle | all +allem +allen +aller +alles + +als | than, as +also | so +am | an + dem +an | at + +ander | other +andere +anderem +anderen +anderer +anderes +anderm +andern +anderr +anders + +auch | also +auf | on +aus | out of +bei | by +bin | am +bis | until +bist | art +da | there +damit | with it +dann | then + +der | the +den +des +dem +die +das + +daß | that + +derselbe | the same +derselben +denselben +desselben +demselben +dieselbe +dieselben +dasselbe + +dazu | to that + +dein | thy +deine +deinem +deinen +deiner +deines + +denn | because + +derer | of those +dessen | of him + +dich | thee +dir | to thee +du | thou + +dies | this +diese +diesem +diesen +dieser +dieses + + +doch | (several meanings) +dort | (over) there + + +durch | through + +ein | a +eine +einem +einen +einer +eines + +einig | some +einige +einigem +einigen +einiger +einiges + +einmal | once + +er | he +ihn | him +ihm | to him + +es | it +etwas | something + +euer | your +eure +eurem +euren +eurer +eures + +für | for +gegen | towards +gewesen | p.p. of sein +hab | have +habe | have +haben | have +hat | has +hatte | had +hatten | had +hier | here +hin | there +hinter | behind + +ich | I +mich | me +mir | to me + + +ihr | you, to her +ihre +ihrem +ihren +ihrer +ihres +euch | to you + +im | in + dem +in | in +indem | while +ins | in + das +ist | is + +jede | each, every +jedem +jeden +jeder +jedes + +jene | that +jenem +jenen +jener +jenes + +jetzt | now +kann | can + +kein | no +keine +keinem +keinen +keiner +keines + +können | can +könnte | could +machen | do +man | one + +manche | some, many a +manchem +manchen +mancher +manches + +mein | my +meine +meinem +meinen +meiner +meines + +mit | with +muss | must +musste | had to +nach | to(wards) +nicht | not +nichts | nothing +noch | still, yet +nun | now +nur | only +ob | whether +oder | or +ohne | without +sehr | very + +sein | his +seine +seinem +seinen +seiner +seines + +selbst | self +sich | herself + +sie | they, she +ihnen | to them + +sind | are +so | so + +solche | such +solchem +solchen +solcher +solches + +soll | shall +sollte | should +sondern | but +sonst | else +über | over +um | about, around +und | and + +uns | us +unse +unsem +unsen +unser +unses + +unter | under +viel | much +vom | von + dem +von | from +vor | before +während | while +war | was +waren | were +warst | wast +was | what +weg | away, off +weil | because +weiter | further + +welche | which +welchem +welchen +welcher +welches + +wenn | when +werde | will +werden | will +wie | how +wieder | again +will | want +wir | we +wird | will +wirst | willst +wo | where +wollen | want +wollte | wanted +würde | would +würden | would +zu | to +zum | zu + dem +zur | zu + der +zwar | indeed +zwischen | between diff --git a/sphinx/search/_stopwords/en.py b/sphinx/search/_stopwords/en.py new file mode 100644 index 00000000000..06fa94cb2c5 --- /dev/null +++ b/sphinx/search/_stopwords/en.py @@ -0,0 +1,181 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/english/stop.txt + +from __future__ import annotations + +ENGLISH_STOPWORDS = frozenset({ + 'a', + 'about', + 'above', + 'after', + 'again', + 'against', + 'all', + 'am', + 'an', + 'and', + 'any', + 'are', + "aren't", + 'as', + 'at', + 'be', + 'because', + 'been', + 'before', + 'being', + 'below', + 'between', + 'both', + 'but', + 'by', + "can't", + 'cannot', + 'could', + "couldn't", + 'did', + "didn't", + 'do', + 'does', + "doesn't", + 'doing', + "don't", + 'down', + 'during', + 'each', + 'few', + 'for', + 'from', + 'further', + 'had', + "hadn't", + 'has', + "hasn't", + 'have', + "haven't", + 'having', + 'he', + "he'd", + "he'll", + "he's", + 'her', + 'here', + "here's", + 'hers', + 'herself', + 'him', + 'himself', + 'his', + 'how', + "how's", + 'i', + "i'd", + "i'll", + "i'm", + "i've", + 'if', + 'in', + 'into', + 'is', + "isn't", + 'it', + "it's", + 'its', + 'itself', + "let's", + 'me', + 'more', + 'most', + "mustn't", + 'my', + 'myself', + 'no', + 'nor', + 'not', + 'of', + 'off', + 'on', + 'once', + 'only', + 'or', + 'other', + 'ought', + 'our', + 'ours', + 'ourselves', + 'out', + 'over', + 'own', + 'same', + "shan't", + 'she', + "she'd", + "she'll", + "she's", + 'should', + "shouldn't", + 'so', + 'some', + 'such', + 'than', + 'that', + "that's", + 'the', + 'their', + 'theirs', + 'them', + 'themselves', + 'then', + 'there', + "there's", + 'these', + 'they', + "they'd", + "they'll", + "they're", + "they've", + 'this', + 'those', + 'through', + 'to', + 'too', + 'under', + 'until', + 'up', + 'very', + 'was', + "wasn't", + 'we', + "we'd", + "we'll", + "we're", + "we've", + 'were', + "weren't", + 'what', + "what's", + 'when', + "when's", + 'where', + "where's", + 'which', + 'while', + 'who', + "who's", + 'whom', + 'why', + "why's", + 'with', + "won't", + 'would', + "wouldn't", + 'you', + "you'd", + "you'll", + "you're", + "you've", + 'your', + 'yours', + 'yourself', + 'yourselves', +}) diff --git a/sphinx/search/_stopwords/en.txt b/sphinx/search/_stopwords/en.txt new file mode 100644 index 00000000000..5442976d354 --- /dev/null +++ b/sphinx/search/_stopwords/en.txt @@ -0,0 +1,311 @@ + + | An English stop word list. Comments begin with vertical bar. Each stop + | word is at the start of a line. + + | Many of the forms below are quite rare (e.g. "yourselves") but included for + | completeness. + + | PRONOUNS FORMS + | 1st person sing + +i | subject, always in upper case of course + +me | object +my | possessive adjective + | the possessive pronoun `mine' is best suppressed, because of the + | sense of coal-mine etc. +myself | reflexive + | 1st person plural +we | subject + +| us | object + | care is required here because US = United States. It is usually + | safe to remove it if it is in lower case. +our | possessive adjective +ours | possessive pronoun +ourselves | reflexive + | second person (archaic `thou' forms not included) +you | subject and object +your | possessive adjective +yours | possessive pronoun +yourself | reflexive (singular) +yourselves | reflexive (plural) + | third person singular +he | subject +him | object +his | possessive adjective and pronoun +himself | reflexive + +she | subject +her | object and possessive adjective +hers | possessive pronoun +herself | reflexive + +it | subject and object +its | possessive adjective +itself | reflexive + | third person plural +they | subject +them | object +their | possessive adjective +theirs | possessive pronoun +themselves | reflexive + | other forms (demonstratives, interrogatives) +what +which +who +whom +this +that +these +those + + | VERB FORMS (using F.R. Palmer's nomenclature) + | BE +am | 1st person, present +is | -s form (3rd person, present) +are | present +was | 1st person, past +were | past +be | infinitive +been | past participle +being | -ing form + | HAVE +have | simple +has | -s form +had | past +having | -ing form + | DO +do | simple +does | -s form +did | past +doing | -ing form + + | The forms below are, I believe, best omitted, because of the significant + | homonym forms: + + | He made a WILL + | old tin CAN + | merry month of MAY + | a smell of MUST + | fight the good fight with all thy MIGHT + + | would, could, should, ought might however be included + + | | AUXILIARIES + | | WILL + |will + +would + + | | SHALL + |shall + +should + + | | CAN + |can + +could + + | | MAY + |may + |might + | | MUST + |must + | | OUGHT + +ought + + | COMPOUND FORMS, increasingly encountered nowadays in 'formal' writing + | pronoun + verb + +i'm +you're +he's +she's +it's +we're +they're +i've +you've +we've +they've +i'd +you'd +he'd +she'd +we'd +they'd +i'll +you'll +he'll +she'll +we'll +they'll + + | verb + negation + +isn't +aren't +wasn't +weren't +hasn't +haven't +hadn't +doesn't +don't +didn't + + | auxiliary + negation + +won't +wouldn't +shan't +shouldn't +can't +cannot +couldn't +mustn't + + | miscellaneous forms + +let's +that's +who's +what's +here's +there's +when's +where's +why's +how's + + | rarer forms + + | daren't needn't + + | doubtful forms + + | oughtn't mightn't + + | ARTICLES +a +an +the + + | THE REST (Overlap among prepositions, conjunctions, adverbs etc is so + | high, that classification is pointless.) +and +but +if +or +because +as +until +while + +of +at +by +for +with +about +against +between +into +through +during +before +after +above +below +to +from +up +down +in +out +on +off +over +under + +again +further +then +once + +here +there +when +where +why +how + +all +any +both +each +few +more +most +other +some +such + +no +nor +not +only +own +same +so +than +too +very + + | Just for the record, the following words are among the commonest in English + + | one + | every + | least + | less + | many + | now + | ever + | never + | say + | says + | said + | also + | get + | go + | goes + | just + | made + | make + | put + | see + | seen + | whether + | like + | well + | back + | even + | still + | way + | take + | since + | another + | however + | two + | three + | four + | five + | first + | second + | new + | old + | high + | long diff --git a/sphinx/search/_stopwords/es.py b/sphinx/search/_stopwords/es.py new file mode 100644 index 00000000000..4ec63cf8998 --- /dev/null +++ b/sphinx/search/_stopwords/es.py @@ -0,0 +1,315 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/spanish/stop.txt + +from __future__ import annotations + +SPANISH_STOPWORDS = frozenset({ + 'a', + 'al', + 'algo', + 'algunas', + 'algunos', + 'ante', + 'antes', + 'como', + 'con', + 'contra', + 'cual', + 'cuando', + 'de', + 'del', + 'desde', + 'donde', + 'durante', + 'e', + 'el', + 'ella', + 'ellas', + 'ellos', + 'en', + 'entre', + 'era', + 'erais', + 'eran', + 'eras', + 'eres', + 'es', + 'esa', + 'esas', + 'ese', + 'eso', + 'esos', + 'esta', + 'estaba', + 'estabais', + 'estaban', + 'estabas', + 'estad', + 'estada', + 'estadas', + 'estado', + 'estados', + 'estamos', + 'estando', + 'estar', + 'estaremos', + 'estará', + 'estarán', + 'estarás', + 'estaré', + 'estaréis', + 'estaría', + 'estaríais', + 'estaríamos', + 'estarían', + 'estarías', + 'estas', + 'este', + 'estemos', + 'esto', + 'estos', + 'estoy', + 'estuve', + 'estuviera', + 'estuvierais', + 'estuvieran', + 'estuvieras', + 'estuvieron', + 'estuviese', + 'estuvieseis', + 'estuviesen', + 'estuvieses', + 'estuvimos', + 'estuviste', + 'estuvisteis', + 'estuviéramos', + 'estuviésemos', + 'estuvo', + 'está', + 'estábamos', + 'estáis', + 'están', + 'estás', + 'esté', + 'estéis', + 'estén', + 'estés', + 'fue', + 'fuera', + 'fuerais', + 'fueran', + 'fueras', + 'fueron', + 'fuese', + 'fueseis', + 'fuesen', + 'fueses', + 'fui', + 'fuimos', + 'fuiste', + 'fuisteis', + 'fuéramos', + 'fuésemos', + 'ha', + 'habida', + 'habidas', + 'habido', + 'habidos', + 'habiendo', + 'habremos', + 'habrá', + 'habrán', + 'habrás', + 'habré', + 'habréis', + 'habría', + 'habríais', + 'habríamos', + 'habrían', + 'habrías', + 'habéis', + 'había', + 'habíais', + 'habíamos', + 'habían', + 'habías', + 'han', + 'has', + 'hasta', + 'hay', + 'haya', + 'hayamos', + 'hayan', + 'hayas', + 'hayáis', + 'he', + 'hemos', + 'hube', + 'hubiera', + 'hubierais', + 'hubieran', + 'hubieras', + 'hubieron', + 'hubiese', + 'hubieseis', + 'hubiesen', + 'hubieses', + 'hubimos', + 'hubiste', + 'hubisteis', + 'hubiéramos', + 'hubiésemos', + 'hubo', + 'la', + 'las', + 'le', + 'les', + 'lo', + 'los', + 'me', + 'mi', + 'mis', + 'mucho', + 'muchos', + 'muy', + 'más', + 'mí', + 'mía', + 'mías', + 'mío', + 'míos', + 'nada', + 'ni', + 'no', + 'nos', + 'nosotras', + 'nosotros', + 'nuestra', + 'nuestras', + 'nuestro', + 'nuestros', + 'o', + 'os', + 'otra', + 'otras', + 'otro', + 'otros', + 'para', + 'pero', + 'poco', + 'por', + 'porque', + 'que', + 'quien', + 'quienes', + 'qué', + 'se', + 'sea', + 'seamos', + 'sean', + 'seas', + 'seremos', + 'será', + 'serán', + 'serás', + 'seré', + 'seréis', + 'sería', + 'seríais', + 'seríamos', + 'serían', + 'serías', + 'seáis', + 'sido', + 'siendo', + 'sin', + 'sobre', + 'sois', + 'somos', + 'son', + 'soy', + 'su', + 'sus', + 'suya', + 'suyas', + 'suyo', + 'suyos', + 'sí', + 'también', + 'tanto', + 'te', + 'tendremos', + 'tendrá', + 'tendrán', + 'tendrás', + 'tendré', + 'tendréis', + 'tendría', + 'tendríais', + 'tendríamos', + 'tendrían', + 'tendrías', + 'tened', + 'tenemos', + 'tenga', + 'tengamos', + 'tengan', + 'tengas', + 'tengo', + 'tengáis', + 'tenida', + 'tenidas', + 'tenido', + 'tenidos', + 'teniendo', + 'tenéis', + 'tenía', + 'teníais', + 'teníamos', + 'tenían', + 'tenías', + 'ti', + 'tiene', + 'tienen', + 'tienes', + 'todo', + 'todos', + 'tu', + 'tus', + 'tuve', + 'tuviera', + 'tuvierais', + 'tuvieran', + 'tuvieras', + 'tuvieron', + 'tuviese', + 'tuvieseis', + 'tuviesen', + 'tuvieses', + 'tuvimos', + 'tuviste', + 'tuvisteis', + 'tuviéramos', + 'tuviésemos', + 'tuvo', + 'tuya', + 'tuyas', + 'tuyo', + 'tuyos', + 'tú', + 'un', + 'una', + 'uno', + 'unos', + 'vosotras', + 'vosotros', + 'vuestra', + 'vuestras', + 'vuestro', + 'vuestros', + 'y', + 'ya', + 'yo', + 'él', + 'éramos', +}) diff --git a/sphinx/search/_stopwords/es.txt b/sphinx/search/_stopwords/es.txt new file mode 100644 index 00000000000..416c84d225a --- /dev/null +++ b/sphinx/search/_stopwords/es.txt @@ -0,0 +1,347 @@ + + | A Spanish stop word list. Comments begin with vertical bar. Each stop + | word is at the start of a line. + + + | The following is a ranked list (commonest to rarest) of stopwords + | deriving from a large sample of text. + + | Extra words have been added at the end. + +de | from, of +la | the, her +que | who, that +el | the +en | in +y | and +a | to +los | the, them +del | de + el +se | himself, from him etc +las | the, them +por | for, by, etc +un | a +para | for +con | with +no | no +una | a +su | his, her +al | a + el + | es from SER +lo | him +como | how +más | more +pero | pero +sus | su plural +le | to him, her +ya | already +o | or + | fue from SER +este | this + | ha from HABER +sí | himself etc +porque | because +esta | this + | son from SER +entre | between + | está from ESTAR +cuando | when +muy | very +sin | without +sobre | on + | ser from SER + | tiene from TENER +también | also +me | me +hasta | until +hay | there is/are +donde | where + | han from HABER +quien | whom, that + | están from ESTAR + | estado from ESTAR +desde | from +todo | all +nos | us +durante | during + | estados from ESTAR +todos | all +uno | a +les | to them +ni | nor +contra | against +otros | other + | fueron from SER +ese | that +eso | that + | había from HABER +ante | before +ellos | they +e | and (variant of y) +esto | this +mí | me +antes | before +algunos | some +qué | what? +unos | a +yo | I +otro | other +otras | other +otra | other +él | he +tanto | so much, many +esa | that +estos | these +mucho | much, many +quienes | who +nada | nothing +muchos | many +cual | who + | sea from SER +poco | few +ella | she +estar | to be + | haber from HABER +estas | these + | estaba from ESTAR + | estamos from ESTAR +algunas | some +algo | something +nosotros | we + + | other forms + +mi | me +mis | mi plural +tú | thou +te | thee +ti | thee +tu | thy +tus | tu plural +ellas | they +nosotras | we +vosotros | you +vosotras | you +os | you +mío | mine +mía | +míos | +mías | +tuyo | thine +tuya | +tuyos | +tuyas | +suyo | his, hers, theirs +suya | +suyos | +suyas | +nuestro | ours +nuestra | +nuestros | +nuestras | +vuestro | yours +vuestra | +vuestros | +vuestras | +esos | those +esas | those + + | forms of estar, to be (not including the infinitive): +estoy +estás +está +estamos +estáis +están +esté +estés +estemos +estéis +estén +estaré +estarás +estará +estaremos +estaréis +estarán +estaría +estarías +estaríamos +estaríais +estarían +estaba +estabas +estábamos +estabais +estaban +estuve +estuviste +estuvo +estuvimos +estuvisteis +estuvieron +estuviera +estuvieras +estuviéramos +estuvierais +estuvieran +estuviese +estuvieses +estuviésemos +estuvieseis +estuviesen +estando +estado +estada +estados +estadas +estad + + | forms of haber, to have (not including the infinitive): +he +has +ha +hemos +habéis +han +haya +hayas +hayamos +hayáis +hayan +habré +habrás +habrá +habremos +habréis +habrán +habría +habrías +habríamos +habríais +habrían +había +habías +habíamos +habíais +habían +hube +hubiste +hubo +hubimos +hubisteis +hubieron +hubiera +hubieras +hubiéramos +hubierais +hubieran +hubiese +hubieses +hubiésemos +hubieseis +hubiesen +habiendo +habido +habida +habidos +habidas + + | forms of ser, to be (not including the infinitive): +soy +eres +es +somos +sois +son +sea +seas +seamos +seáis +sean +seré +serás +será +seremos +seréis +serán +sería +serías +seríamos +seríais +serían +era +eras +éramos +erais +eran +fui +fuiste +fue +fuimos +fuisteis +fueron +fuera +fueras +fuéramos +fuerais +fueran +fuese +fueses +fuésemos +fueseis +fuesen +siendo +sido + | sed also means 'thirst' + + | forms of tener, to have (not including the infinitive): +tengo +tienes +tiene +tenemos +tenéis +tienen +tenga +tengas +tengamos +tengáis +tengan +tendré +tendrás +tendrá +tendremos +tendréis +tendrán +tendría +tendrías +tendríamos +tendríais +tendrían +tenía +tenías +teníamos +teníais +tenían +tuve +tuviste +tuvo +tuvimos +tuvisteis +tuvieron +tuviera +tuvieras +tuviéramos +tuvierais +tuvieran +tuviese +tuvieses +tuviésemos +tuvieseis +tuviesen +teniendo +tenido +tenida +tenidos +tenidas +tened diff --git a/sphinx/search/_stopwords/fi.py b/sphinx/search/_stopwords/fi.py new file mode 100644 index 00000000000..af681337d4b --- /dev/null +++ b/sphinx/search/_stopwords/fi.py @@ -0,0 +1,236 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/finnish/stop.txt + +from __future__ import annotations + +FINNISH_STOPWORDS = frozenset({ + 'ei', + 'eivät', + 'emme', + 'en', + 'et', + 'ette', + 'että', + 'he', + 'heidän', + 'heidät', + 'heihin', + 'heille', + 'heillä', + 'heiltä', + 'heissä', + 'heistä', + 'heitä', + 'hän', + 'häneen', + 'hänelle', + 'hänellä', + 'häneltä', + 'hänen', + 'hänessä', + 'hänestä', + 'hänet', + 'häntä', + 'itse', + 'ja', + 'johon', + 'joiden', + 'joihin', + 'joiksi', + 'joilla', + 'joille', + 'joilta', + 'joina', + 'joissa', + 'joista', + 'joita', + 'joka', + 'joksi', + 'jolla', + 'jolle', + 'jolta', + 'jona', + 'jonka', + 'jos', + 'jossa', + 'josta', + 'jota', + 'jotka', + 'kanssa', + 'keiden', + 'keihin', + 'keiksi', + 'keille', + 'keillä', + 'keiltä', + 'keinä', + 'keissä', + 'keistä', + 'keitä', + 'keneen', + 'keneksi', + 'kenelle', + 'kenellä', + 'keneltä', + 'kenen', + 'kenenä', + 'kenessä', + 'kenestä', + 'kenet', + 'ketkä', + 'ketä', + 'koska', + 'kuin', + 'kuka', + 'kun', + 'me', + 'meidän', + 'meidät', + 'meihin', + 'meille', + 'meillä', + 'meiltä', + 'meissä', + 'meistä', + 'meitä', + 'mihin', + 'miksi', + 'mikä', + 'mille', + 'millä', + 'miltä', + 'minkä', + 'minua', + 'minulla', + 'minulle', + 'minulta', + 'minun', + 'minussa', + 'minusta', + 'minut', + 'minuun', + 'minä', + 'missä', + 'mistä', + 'mitkä', + 'mitä', + 'mukaan', + 'mutta', + 'ne', + 'niiden', + 'niihin', + 'niiksi', + 'niille', + 'niillä', + 'niiltä', + 'niin', + 'niinä', + 'niissä', + 'niistä', + 'niitä', + 'noiden', + 'noihin', + 'noiksi', + 'noilla', + 'noille', + 'noilta', + 'noin', + 'noina', + 'noissa', + 'noista', + 'noita', + 'nuo', + 'nyt', + 'näiden', + 'näihin', + 'näiksi', + 'näille', + 'näillä', + 'näiltä', + 'näinä', + 'näissä', + 'näistä', + 'näitä', + 'nämä', + 'ole', + 'olemme', + 'olen', + 'olet', + 'olette', + 'oli', + 'olimme', + 'olin', + 'olisi', + 'olisimme', + 'olisin', + 'olisit', + 'olisitte', + 'olisivat', + 'olit', + 'olitte', + 'olivat', + 'olla', + 'olleet', + 'ollut', + 'on', + 'ovat', + 'poikki', + 'se', + 'sekä', + 'sen', + 'siihen', + 'siinä', + 'siitä', + 'siksi', + 'sille', + 'sillä', + 'siltä', + 'sinua', + 'sinulla', + 'sinulle', + 'sinulta', + 'sinun', + 'sinussa', + 'sinusta', + 'sinut', + 'sinuun', + 'sinä', + 'sitä', + 'tai', + 'te', + 'teidän', + 'teidät', + 'teihin', + 'teille', + 'teillä', + 'teiltä', + 'teissä', + 'teistä', + 'teitä', + 'tuo', + 'tuohon', + 'tuoksi', + 'tuolla', + 'tuolle', + 'tuolta', + 'tuon', + 'tuona', + 'tuossa', + 'tuosta', + 'tuota', + 'tähän', + 'täksi', + 'tälle', + 'tällä', + 'tältä', + 'tämä', + 'tämän', + 'tänä', + 'tässä', + 'tästä', + 'tätä', + 'vaan', + 'vai', + 'vaikka', + 'yli', +}) diff --git a/sphinx/search/_stopwords/fi.txt b/sphinx/search/_stopwords/fi.txt new file mode 100644 index 00000000000..b4347ffd74e --- /dev/null +++ b/sphinx/search/_stopwords/fi.txt @@ -0,0 +1,88 @@ + +| forms of BE + +olla +olen +olet +on +olemme +olette +ovat +ole | negative form + +oli +olisi +olisit +olisin +olisimme +olisitte +olisivat +olit +olin +olimme +olitte +olivat +ollut +olleet + +en | negation +et +ei +emme +ette +eivät + +|Nom Gen Acc Part Iness Elat Illat Adess Ablat Allat Ess Trans +minä minun minut minua minussa minusta minuun minulla minulta minulle | I +sinä sinun sinut sinua sinussa sinusta sinuun sinulla sinulta sinulle | you +hän hänen hänet häntä hänessä hänestä häneen hänellä häneltä hänelle | he she +me meidän meidät meitä meissä meistä meihin meillä meiltä meille | we +te teidän teidät teitä teissä teistä teihin teillä teiltä teille | you +he heidän heidät heitä heissä heistä heihin heillä heiltä heille | they + +tämä tämän tätä tässä tästä tähän tällä tältä tälle tänä täksi | this +tuo tuon tuota tuossa tuosta tuohon tuolla tuolta tuolle tuona tuoksi | that +se sen sitä siinä siitä siihen sillä siltä sille sinä siksi | it +nämä näiden näitä näissä näistä näihin näillä näiltä näille näinä näiksi | these +nuo noiden noita noissa noista noihin noilla noilta noille noina noiksi | those +ne niiden niitä niissä niistä niihin niillä niiltä niille niinä niiksi | they + +kuka kenen kenet ketä kenessä kenestä keneen kenellä keneltä kenelle kenenä keneksi| who +ketkä keiden ketkä keitä keissä keistä keihin keillä keiltä keille keinä keiksi | (pl) +mikä minkä minkä mitä missä mistä mihin millä miltä mille minä miksi | which what +mitkä | (pl) + +joka jonka jota jossa josta johon jolla jolta jolle jona joksi | who which +jotka joiden joita joissa joista joihin joilla joilta joille joina joiksi | (pl) + +| conjunctions + +että | that +ja | and +jos | if +koska | because +kuin | than +mutta | but +niin | so +sekä | and +sillä | for +tai | or +vaan | but +vai | or +vaikka | although + + +| prepositions + +kanssa | with +mukaan | according to +noin | about +poikki | across +yli | over, across + +| other + +kun | when +niin | so +nyt | now +itse | self diff --git a/sphinx/search/_stopwords/fr.py b/sphinx/search/_stopwords/fr.py new file mode 100644 index 00000000000..1a1edc46916 --- /dev/null +++ b/sphinx/search/_stopwords/fr.py @@ -0,0 +1,171 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/french/stop.txt + +from __future__ import annotations + +FRENCH_STOPWORDS = frozenset({ + 'ai', + 'aie', + 'aient', + 'aies', + 'ait', + 'as', + 'au', + 'aura', + 'aurai', + 'auraient', + 'aurais', + 'aurait', + 'auras', + 'aurez', + 'auriez', + 'aurions', + 'aurons', + 'auront', + 'aux', + 'avaient', + 'avais', + 'avait', + 'avec', + 'avez', + 'aviez', + 'avions', + 'avons', + 'ayant', + 'ayez', + 'ayons', + 'c', + 'ce', + 'ceci', + 'cela', + 'celà', + 'ces', + 'cet', + 'cette', + 'd', + 'dans', + 'de', + 'des', + 'du', + 'elle', + 'en', + 'es', + 'est', + 'et', + 'eu', + 'eue', + 'eues', + 'eurent', + 'eus', + 'eusse', + 'eussent', + 'eusses', + 'eussiez', + 'eussions', + 'eut', + 'eux', + 'eûmes', + 'eût', + 'eûtes', + 'furent', + 'fus', + 'fusse', + 'fussent', + 'fusses', + 'fussiez', + 'fussions', + 'fut', + 'fûmes', + 'fût', + 'fûtes', + 'ici', + 'il', + 'ils', + 'j', + 'je', + 'l', + 'la', + 'le', + 'les', + 'leur', + 'leurs', + 'lui', + 'm', + 'ma', + 'mais', + 'me', + 'mes', + 'moi', + 'mon', + 'même', + 'n', + 'ne', + 'nos', + 'notre', + 'nous', + 'on', + 'ont', + 'ou', + 'par', + 'pas', + 'pour', + 'qu', + 'que', + 'quel', + 'quelle', + 'quelles', + 'quels', + 'qui', + 's', + 'sa', + 'sans', + 'se', + 'sera', + 'serai', + 'seraient', + 'serais', + 'serait', + 'seras', + 'serez', + 'seriez', + 'serions', + 'serons', + 'seront', + 'ses', + 'soi', + 'soient', + 'sois', + 'soit', + 'sommes', + 'son', + 'sont', + 'soyez', + 'soyons', + 'suis', + 'sur', + 't', + 'ta', + 'te', + 'tes', + 'toi', + 'ton', + 'tu', + 'un', + 'une', + 'vos', + 'votre', + 'vous', + 'y', + 'à', + 'étaient', + 'étais', + 'était', + 'étant', + 'étiez', + 'étions', + 'été', + 'étée', + 'étées', + 'étés', + 'êtes', +}) diff --git a/sphinx/search/_stopwords/fr.txt b/sphinx/search/_stopwords/fr.txt new file mode 100644 index 00000000000..8591079bf6e --- /dev/null +++ b/sphinx/search/_stopwords/fr.txt @@ -0,0 +1,177 @@ + + | A French stop word list. Comments begin with vertical bar. Each stop + | word is at the start of a line. + +au | a + le +aux | a + les +avec | with +ce | this +ces | these +dans | with +de | of +des | de + les +du | de + le +elle | she +en | `of them' etc +et | and +eux | them +il | he +je | I +la | the +le | the +leur | their +lui | him +ma | my (fem) +mais | but +me | me +même | same; as in moi-même (myself) etc +mes | me (pl) +moi | me +mon | my (masc) +ne | not +nos | our (pl) +notre | our +nous | we +on | one +ou | where +par | by +pas | not +pour | for +qu | que before vowel +que | that +qui | who +sa | his, her (fem) +se | oneself +ses | his (pl) +son | his, her (masc) +sur | on +ta | thy (fem) +te | thee +tes | thy (pl) +toi | thee +ton | thy (masc) +tu | thou +un | a +une | a +vos | your (pl) +votre | your +vous | you + + | single letter forms + +c | c' +d | d' +j | j' +l | l' +à | to, at +m | m' +n | n' +s | s' +t | t' +y | there + + | forms of être (not including the infinitive): +été +étée +étées +étés +étant +suis +es +est +sommes +êtes +sont +serai +seras +sera +serons +serez +seront +serais +serait +serions +seriez +seraient +étais +était +étions +étiez +étaient +fus +fut +fûmes +fûtes +furent +sois +soit +soyons +soyez +soient +fusse +fusses +fût +fussions +fussiez +fussent + + | forms of avoir (not including the infinitive): +ayant +eu +eue +eues +eus +ai +as +avons +avez +ont +aurai +auras +aura +aurons +aurez +auront +aurais +aurait +aurions +auriez +auraient +avais +avait +avions +aviez +avaient +eut +eûmes +eûtes +eurent +aie +aies +ait +ayons +ayez +aient +eusse +eusses +eût +eussions +eussiez +eussent + + | Later additions (from Jean-Christophe Deschamps) +ceci | this +cela | that (added 11 Apr 2012. Omission reported by Adrien Grand) +celà | that (incorrect, though common) +cet | this +cette | this +ici | here +ils | they +les | the (pl) +leurs | their (pl) +quel | which +quels | which +quelle | which +quelles | which +sans | without +soi | oneself diff --git a/sphinx/search/_stopwords/hu.py b/sphinx/search/_stopwords/hu.py new file mode 100644 index 00000000000..122fd8b7b47 --- /dev/null +++ b/sphinx/search/_stopwords/hu.py @@ -0,0 +1,205 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/hungarian/stop.txt + +from __future__ import annotations + +HUNGARIAN_STOPWORDS = frozenset({ + 'a', + 'abban', + 'ahhoz', + 'ahogy', + 'ahol', + 'aki', + 'akik', + 'akkor', + 'alatt', + 'amely', + 'amelyek', + 'amelyekben', + 'amelyeket', + 'amelyet', + 'amelynek', + 'ami', + 'amikor', + 'amit', + 'amolyan', + 'amíg', + 'annak', + 'arra', + 'arról', + 'az', + 'azok', + 'azon', + 'azonban', + 'azt', + 'aztán', + 'azután', + 'azzal', + 'azért', + 'be', + 'belül', + 'benne', + 'bár', + 'cikk', + 'cikkek', + 'cikkeket', + 'csak', + 'de', + 'e', + 'ebben', + 'eddig', + 'egy', + 'egyes', + 'egyetlen', + 'egyik', + 'egyre', + 'egyéb', + 'egész', + 'ehhez', + 'ekkor', + 'el', + 'ellen', + 'elsõ', + 'elég', + 'elõ', + 'elõször', + 'elõtt', + 'emilyen', + 'ennek', + 'erre', + 'ez', + 'ezek', + 'ezen', + 'ezt', + 'ezzel', + 'ezért', + 'fel', + 'felé', + 'hanem', + 'hiszen', + 'hogy', + 'hogyan', + 'igen', + 'ill', + 'ill.', + 'illetve', + 'ilyen', + 'ilyenkor', + 'ismét', + 'ison', + 'itt', + 'jobban', + 'jó', + 'jól', + 'kell', + 'kellett', + 'keressünk', + 'keresztül', + 'ki', + 'kívül', + 'között', + 'közül', + 'legalább', + 'legyen', + 'lehet', + 'lehetett', + 'lenne', + 'lenni', + 'lesz', + 'lett', + 'maga', + 'magát', + 'majd', + 'meg', + 'mellett', + 'mely', + 'melyek', + 'mert', + 'mi', + 'mikor', + 'milyen', + 'minden', + 'mindenki', + 'mindent', + 'mindig', + 'mint', + 'mintha', + 'mit', + 'mivel', + 'miért', + 'most', + 'már', + 'más', + 'másik', + 'még', + 'míg', + 'nagy', + 'nagyobb', + 'nagyon', + 'ne', + 'nekem', + 'neki', + 'nem', + 'nincs', + 'néha', + 'néhány', + 'nélkül', + 'olyan', + 'ott', + 'pedig', + 'persze', + 'rá', + 's', + 'saját', + 'sem', + 'semmi', + 'sok', + 'sokat', + 'sokkal', + 'szemben', + 'szerint', + 'szinte', + 'számára', + 'talán', + 'tehát', + 'teljes', + 'tovább', + 'továbbá', + 'több', + 'ugyanis', + 'utolsó', + 'után', + 'utána', + 'vagy', + 'vagyis', + 'vagyok', + 'valaki', + 'valami', + 'valamint', + 'való', + 'van', + 'vannak', + 'vele', + 'vissza', + 'viszont', + 'volna', + 'volt', + 'voltak', + 'voltam', + 'voltunk', + 'által', + 'általában', + 'át', + 'én', + 'éppen', + 'és', + 'így', + 'õ', + 'õk', + 'õket', + 'össze', + 'úgy', + 'új', + 'újabb', + 'újra', +}) diff --git a/sphinx/search/_stopwords/hu.txt b/sphinx/search/_stopwords/hu.txt new file mode 100644 index 00000000000..cdae504fd96 --- /dev/null +++ b/sphinx/search/_stopwords/hu.txt @@ -0,0 +1,203 @@ + +| Hungarian stop word list +| prepared by Anna Tordai + +a +ahogy +ahol +aki +akik +akkor +alatt +által +általában +amely +amelyek +amelyekben +amelyeket +amelyet +amelynek +ami +amit +amolyan +amíg +amikor +át +abban +ahhoz +annak +arra +arról +az +azok +azon +azt +azzal +azért +aztán +azután +azonban +bár +be +belül +benne +cikk +cikkek +cikkeket +csak +de +e +eddig +egész +egy +egyes +egyetlen +egyéb +egyik +egyre +ekkor +el +elég +ellen +elõ +elõször +elõtt +elsõ +én +éppen +ebben +ehhez +emilyen +ennek +erre +ez +ezt +ezek +ezen +ezzel +ezért +és +fel +felé +hanem +hiszen +hogy +hogyan +igen +így +illetve +ill. +ill +ilyen +ilyenkor +ison +ismét +itt +jó +jól +jobban +kell +kellett +keresztül +keressünk +ki +kívül +között +közül +legalább +lehet +lehetett +legyen +lenne +lenni +lesz +lett +maga +magát +majd +majd +már +más +másik +meg +még +mellett +mert +mely +melyek +mi +mit +míg +miért +milyen +mikor +minden +mindent +mindenki +mindig +mint +mintha +mivel +most +nagy +nagyobb +nagyon +ne +néha +nekem +neki +nem +néhány +nélkül +nincs +olyan +ott +össze +õ +õk +õket +pedig +persze +rá +s +saját +sem +semmi +sok +sokat +sokkal +számára +szemben +szerint +szinte +talán +tehát +teljes +tovább +továbbá +több +úgy +ugyanis +új +újabb +újra +után +utána +utolsó +vagy +vagyis +valaki +valami +valamint +való +vagyok +van +vannak +volt +voltam +voltak +voltunk +vissza +vele +viszont +volna diff --git a/sphinx/search/_stopwords/it.py b/sphinx/search/_stopwords/it.py new file mode 100644 index 00000000000..ac411f580b2 --- /dev/null +++ b/sphinx/search/_stopwords/it.py @@ -0,0 +1,286 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/italian/stop.txt + +from __future__ import annotations + +ITALIAN_STOPWORDS = frozenset({ + 'a', + 'abbia', + 'abbiamo', + 'abbiano', + 'abbiate', + 'ad', + 'agl', + 'agli', + 'ai', + 'al', + 'all', + 'alla', + 'alle', + 'allo', + 'anche', + 'avemmo', + 'avendo', + 'avesse', + 'avessero', + 'avessi', + 'avessimo', + 'aveste', + 'avesti', + 'avete', + 'aveva', + 'avevamo', + 'avevano', + 'avevate', + 'avevi', + 'avevo', + 'avrai', + 'avranno', + 'avrebbe', + 'avrebbero', + 'avrei', + 'avremmo', + 'avremo', + 'avreste', + 'avresti', + 'avrete', + 'avrà', + 'avrò', + 'avuta', + 'avute', + 'avuti', + 'avuto', + 'c', + 'che', + 'chi', + 'ci', + 'coi', + 'col', + 'come', + 'con', + 'contro', + 'cui', + 'da', + 'dagl', + 'dagli', + 'dai', + 'dal', + 'dall', + 'dalla', + 'dalle', + 'dallo', + 'degl', + 'degli', + 'dei', + 'del', + 'dell', + 'della', + 'delle', + 'dello', + 'di', + 'dov', + 'dove', + 'e', + 'ebbe', + 'ebbero', + 'ebbi', + 'ed', + 'era', + 'erano', + 'eravamo', + 'eravate', + 'eri', + 'ero', + 'essendo', + 'faccia', + 'facciamo', + 'facciano', + 'facciate', + 'faccio', + 'facemmo', + 'facendo', + 'facesse', + 'facessero', + 'facessi', + 'facessimo', + 'faceste', + 'facesti', + 'faceva', + 'facevamo', + 'facevano', + 'facevate', + 'facevi', + 'facevo', + 'fai', + 'fanno', + 'farai', + 'faranno', + 'farebbe', + 'farebbero', + 'farei', + 'faremmo', + 'faremo', + 'fareste', + 'faresti', + 'farete', + 'farà', + 'farò', + 'fece', + 'fecero', + 'feci', + 'fosse', + 'fossero', + 'fossi', + 'fossimo', + 'foste', + 'fosti', + 'fu', + 'fui', + 'fummo', + 'furono', + 'gli', + 'ha', + 'hai', + 'hanno', + 'ho', + 'i', + 'il', + 'in', + 'io', + 'l', + 'la', + 'le', + 'lei', + 'li', + 'lo', + 'loro', + 'lui', + 'ma', + 'mi', + 'mia', + 'mie', + 'miei', + 'mio', + 'ne', + 'negl', + 'negli', + 'nei', + 'nel', + 'nell', + 'nella', + 'nelle', + 'nello', + 'noi', + 'non', + 'nostra', + 'nostre', + 'nostri', + 'nostro', + 'o', + 'per', + 'perché', + 'più', + 'quale', + 'quanta', + 'quante', + 'quanti', + 'quanto', + 'quella', + 'quelle', + 'quelli', + 'quello', + 'questa', + 'queste', + 'questi', + 'questo', + 'sarai', + 'saranno', + 'sarebbe', + 'sarebbero', + 'sarei', + 'saremmo', + 'saremo', + 'sareste', + 'saresti', + 'sarete', + 'sarà', + 'sarò', + 'se', + 'sei', + 'si', + 'sia', + 'siamo', + 'siano', + 'siate', + 'siete', + 'sono', + 'sta', + 'stai', + 'stando', + 'stanno', + 'starai', + 'staranno', + 'starebbe', + 'starebbero', + 'starei', + 'staremmo', + 'staremo', + 'stareste', + 'staresti', + 'starete', + 'starà', + 'starò', + 'stava', + 'stavamo', + 'stavano', + 'stavate', + 'stavi', + 'stavo', + 'stemmo', + 'stesse', + 'stessero', + 'stessi', + 'stessimo', + 'steste', + 'stesti', + 'stette', + 'stettero', + 'stetti', + 'stia', + 'stiamo', + 'stiano', + 'stiate', + 'sto', + 'su', + 'sua', + 'sue', + 'sugl', + 'sugli', + 'sui', + 'sul', + 'sull', + 'sulla', + 'sulle', + 'sullo', + 'suo', + 'suoi', + 'ti', + 'tra', + 'tu', + 'tua', + 'tue', + 'tuo', + 'tuoi', + 'tutti', + 'tutto', + 'un', + 'una', + 'uno', + 'vi', + 'voi', + 'vostra', + 'vostre', + 'vostri', + 'vostro', + 'è', +}) diff --git a/sphinx/search/_stopwords/it.txt b/sphinx/search/_stopwords/it.txt new file mode 100644 index 00000000000..a20bb9528a5 --- /dev/null +++ b/sphinx/search/_stopwords/it.txt @@ -0,0 +1,295 @@ + + | An Italian stop word list. Comments begin with vertical bar. Each stop + | word is at the start of a line. + +ad | a (to) before vowel +al | a + il +allo | a + lo +ai | a + i +agli | a + gli +all | a + l' +agl | a + gl' +alla | a + la +alle | a + le +con | with +col | con + il +coi | con + i (forms collo, cogli etc are now very rare) +da | from +dal | da + il +dallo | da + lo +dai | da + i +dagli | da + gli +dall | da + l' +dagl | da + gll' +dalla | da + la +dalle | da + le +di | of +del | di + il +dello | di + lo +dei | di + i +degli | di + gli +dell | di + l' +degl | di + gl' +della | di + la +delle | di + le +in | in +nel | in + el +nello | in + lo +nei | in + i +negli | in + gli +nell | in + l' +negl | in + gl' +nella | in + la +nelle | in + le +su | on +sul | su + il +sullo | su + lo +sui | su + i +sugli | su + gli +sull | su + l' +sugl | su + gl' +sulla | su + la +sulle | su + le +per | through, by +tra | among +contro | against +io | I +tu | thou +lui | he +lei | she +noi | we +voi | you +loro | they +mio | my +mia | +miei | +mie | +tuo | +tua | +tuoi | thy +tue | +suo | +sua | +suoi | his, her +sue | +nostro | our +nostra | +nostri | +nostre | +vostro | your +vostra | +vostri | +vostre | +mi | me +ti | thee +ci | us, there +vi | you, there +lo | him, the +la | her, the +li | them +le | them, the +gli | to him, the +ne | from there etc +il | the +un | a +uno | a +una | a +ma | but +ed | and +se | if +perché | why, because +anche | also +come | how +dov | where (as dov') +dove | where +che | who, that +chi | who +cui | whom +non | not +più | more +quale | who, that +quanto | how much +quanti | +quanta | +quante | +quello | that +quelli | +quella | +quelle | +questo | this +questi | +questa | +queste | +si | yes +tutto | all +tutti | all + + | single letter forms: + +a | at +c | as c' for ce or ci +e | and +i | the +l | as l' +o | or + + | forms of avere, to have (not including the infinitive): + +ho +hai +ha +abbiamo +avete +hanno +abbia +abbiate +abbiano +avrò +avrai +avrà +avremo +avrete +avranno +avrei +avresti +avrebbe +avremmo +avreste +avrebbero +avevo +avevi +aveva +avevamo +avevate +avevano +ebbi +avesti +ebbe +avemmo +aveste +ebbero +avessi +avesse +avessimo +avessero +avendo +avuto +avuta +avuti +avute + + | forms of essere, to be (not including the infinitive): +sono +sei +è +siamo +siete +sia +siate +siano +sarò +sarai +sarà +saremo +sarete +saranno +sarei +saresti +sarebbe +saremmo +sareste +sarebbero +ero +eri +era +eravamo +eravate +erano +fui +fosti +fu +fummo +foste +furono +fossi +fosse +fossimo +fossero +essendo + + | forms of fare, to do (not including the infinitive, fa, fat-): +faccio +fai +facciamo +fanno +faccia +facciate +facciano +farò +farai +farà +faremo +farete +faranno +farei +faresti +farebbe +faremmo +fareste +farebbero +facevo +facevi +faceva +facevamo +facevate +facevano +feci +facesti +fece +facemmo +faceste +fecero +facessi +facesse +facessimo +facessero +facendo + + | forms of stare, to be (not including the infinitive): +sto +stai +sta +stiamo +stanno +stia +stiate +stiano +starò +starai +starà +staremo +starete +staranno +starei +staresti +starebbe +staremmo +stareste +starebbero +stavo +stavi +stava +stavamo +stavate +stavano +stetti +stesti +stette +stemmo +steste +stettero +stessi +stesse +stessimo +stessero +stando diff --git a/sphinx/search/_stopwords/nl.py b/sphinx/search/_stopwords/nl.py new file mode 100644 index 00000000000..c4e21dde6c1 --- /dev/null +++ b/sphinx/search/_stopwords/nl.py @@ -0,0 +1,108 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/dutch/stop.txt + +from __future__ import annotations + +DUTCH_STOPWORDS = frozenset({ + 'aan', + 'al', + 'alles', + 'als', + 'altijd', + 'andere', + 'ben', + 'bij', + 'daar', + 'dan', + 'dat', + 'de', + 'der', + 'deze', + 'die', + 'dit', + 'doch', + 'doen', + 'door', + 'dus', + 'een', + 'eens', + 'en', + 'er', + 'ge', + 'geen', + 'geweest', + 'haar', + 'had', + 'heb', + 'hebben', + 'heeft', + 'hem', + 'het', + 'hier', + 'hij', + 'hoe', + 'hun', + 'iemand', + 'iets', + 'ik', + 'in', + 'is', + 'ja', + 'je', + 'kan', + 'kon', + 'kunnen', + 'maar', + 'me', + 'meer', + 'men', + 'met', + 'mij', + 'mijn', + 'moet', + 'na', + 'naar', + 'niet', + 'niets', + 'nog', + 'nu', + 'of', + 'om', + 'omdat', + 'onder', + 'ons', + 'ook', + 'op', + 'over', + 'reeds', + 'te', + 'tegen', + 'toch', + 'toen', + 'tot', + 'u', + 'uit', + 'uw', + 'van', + 'veel', + 'voor', + 'want', + 'waren', + 'was', + 'wat', + 'werd', + 'wezen', + 'wie', + 'wil', + 'worden', + 'wordt', + 'zal', + 'ze', + 'zelf', + 'zich', + 'zij', + 'zijn', + 'zo', + 'zonder', + 'zou', +}) diff --git a/sphinx/search/_stopwords/nl.txt b/sphinx/search/_stopwords/nl.txt new file mode 100644 index 00000000000..edf99730a2c --- /dev/null +++ b/sphinx/search/_stopwords/nl.txt @@ -0,0 +1,112 @@ + + + | A Dutch stop word list. Comments begin with vertical bar. Each stop + | word is at the start of a line. + + | This is a ranked list (commonest to rarest) of stopwords derived from + | a large sample of Dutch text. + + | Dutch stop words frequently exhibit homonym clashes. These are indicated + | clearly below. + +de | the +en | and +van | of, from +ik | I, the ego +te | (1) chez, at etc, (2) to, (3) too +dat | that, which +die | that, those, who, which +in | in, inside +een | a, an, one +hij | he +het | the, it +niet | not, nothing, naught +zijn | (1) to be, being, (2) his, one's, its +is | is +was | (1) was, past tense of all persons sing. of 'zijn' (to be) (2) wax, (3) the washing, (4) rise of river +op | on, upon, at, in, up, used up +aan | on, upon, to (as dative) +met | with, by +als | like, such as, when +voor | (1) before, in front of, (2) furrow +had | had, past tense all persons sing. of 'hebben' (have) +er | there +maar | but, only +om | round, about, for etc +hem | him +dan | then +zou | should/would, past tense all persons sing. of 'zullen' +of | or, whether, if +wat | what, something, anything +mijn | possessive and noun 'mine' +men | people, 'one' +dit | this +zo | so, thus, in this way +door | through by +over | over, across +ze | she, her, they, them +zich | oneself +bij | (1) a bee, (2) by, near, at +ook | also, too +tot | till, until +je | you +mij | me +uit | out of, from +der | Old Dutch form of 'van der' still found in surnames +daar | (1) there, (2) because +haar | (1) her, their, them, (2) hair +naar | (1) unpleasant, unwell etc, (2) towards, (3) as +heb | present first person sing. of 'to have' +hoe | how, why +heeft | present third person sing. of 'to have' +hebben | 'to have' and various parts thereof +deze | this +u | you +want | (1) for, (2) mitten, (3) rigging +nog | yet, still +zal | 'shall', first and third person sing. of verb 'zullen' (will) +me | me +zij | she, they +nu | now +ge | 'thou', still used in Belgium and south Netherlands +geen | none +omdat | because +iets | something, somewhat +worden | to become, grow, get +toch | yet, still +al | all, every, each +waren | (1) 'were' (2) to wander, (3) wares, (3) +veel | much, many +meer | (1) more, (2) lake +doen | to do, to make +toen | then, when +moet | noun 'spot/mote' and present form of 'to must' +ben | (1) am, (2) 'are' in interrogative second person singular of 'to be' +zonder | without +kan | noun 'can' and present form of 'to be able' +hun | their, them +dus | so, consequently +alles | all, everything, anything +onder | under, beneath +ja | yes, of course +eens | once, one day +hier | here +wie | who +werd | imperfect third person sing. of 'become' +altijd | always +doch | yet, but etc +wordt | present third person sing. of 'become' +wezen | (1) to be, (2) 'been' as in 'been fishing', (3) orphans +kunnen | to be able +ons | us/our +zelf | self +tegen | against, towards, at +na | after, near +reeds | already +wil | (1) present tense of 'want', (2) 'will', noun, (3) fender +kon | could; past tense of 'to be able' +niets | nothing +uw | your +iemand | somebody +geweest | been; past participle of 'be' +andere | other diff --git a/sphinx/search/_stopwords/no.py b/sphinx/search/_stopwords/no.py new file mode 100644 index 00000000000..4d35e2dde89 --- /dev/null +++ b/sphinx/search/_stopwords/no.py @@ -0,0 +1,179 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/norwegian/stop.txt + +from __future__ import annotations + +NORWEGIAN_STOPWORDS = frozenset({ + 'alle', + 'at', + 'av', + 'bare', + 'begge', + 'ble', + 'blei', + 'bli', + 'blir', + 'blitt', + 'både', + 'båe', + 'da', + 'de', + 'deg', + 'dei', + 'deim', + 'deira', + 'deires', + 'dem', + 'den', + 'denne', + 'der', + 'dere', + 'deres', + 'det', + 'dette', + 'di', + 'din', + 'disse', + 'ditt', + 'du', + 'dykk', + 'dykkar', + 'då', + 'eg', + 'ein', + 'eit', + 'eitt', + 'eller', + 'elles', + 'en', + 'enn', + 'er', + 'et', + 'ett', + 'etter', + 'for', + 'fordi', + 'fra', + 'før', + 'ha', + 'hadde', + 'han', + 'hans', + 'har', + 'hennar', + 'henne', + 'hennes', + 'her', + 'hjå', + 'ho', + 'hoe', + 'honom', + 'hoss', + 'hossen', + 'hun', + 'hva', + 'hvem', + 'hver', + 'hvilke', + 'hvilken', + 'hvis', + 'hvor', + 'hvordan', + 'hvorfor', + 'i', + 'ikke', + 'ikkje', + 'ingen', + 'ingi', + 'inkje', + 'inn', + 'inni', + 'ja', + 'jeg', + 'kan', + 'kom', + 'korleis', + 'korso', + 'kun', + 'kunne', + 'kva', + 'kvar', + 'kvarhelst', + 'kven', + 'kvi', + 'kvifor', + 'man', + 'mange', + 'me', + 'med', + 'medan', + 'meg', + 'meget', + 'mellom', + 'men', + 'mi', + 'min', + 'mine', + 'mitt', + 'mot', + 'mykje', + 'ned', + 'no', + 'noe', + 'noen', + 'noka', + 'noko', + 'nokon', + 'nokor', + 'nokre', + 'nå', + 'når', + 'og', + 'også', + 'om', + 'opp', + 'oss', + 'over', + 'på', + 'samme', + 'seg', + 'selv', + 'si', + 'sia', + 'sidan', + 'siden', + 'sin', + 'sine', + 'sitt', + 'sjøl', + 'skal', + 'skulle', + 'slik', + 'so', + 'som', + 'somme', + 'somt', + 'så', + 'sånn', + 'til', + 'um', + 'upp', + 'ut', + 'uten', + 'var', + 'vart', + 'varte', + 'ved', + 'vere', + 'verte', + 'vi', + 'vil', + 'ville', + 'vore', + 'vors', + 'vort', + 'vår', + 'være', + 'vært', + 'å', +}) diff --git a/sphinx/search/_stopwords/no.txt b/sphinx/search/_stopwords/no.txt new file mode 100644 index 00000000000..c1739309ac8 --- /dev/null +++ b/sphinx/search/_stopwords/no.txt @@ -0,0 +1,185 @@ + + | A Norwegian stop word list. Comments begin with vertical bar. Each stop + | word is at the start of a line. + + | This stop word list is for the dominant bokmål dialect. Words unique + | to nynorsk are marked *. + + | Revised by Jan Bruusgaard , Jan 2005 + +og | and +i | in +jeg | I +det | it/this/that +at | to (w. inf.) +en | a/an +et | a/an +den | it/this/that +til | to +er | is/am/are +som | who/that +på | on +de | they / you(formal) +med | with +han | he +av | of +ikke | not +ikkje | not * +der | there +så | so +var | was/were +meg | me +seg | you +men | but +ett | one +har | have +om | about +vi | we +min | my +mitt | my +ha | have +hadde | had +hun | she +nå | now +over | over +da | when/as +ved | by/know +fra | from +du | you +ut | out +sin | your +dem | them +oss | us +opp | up +man | you/one +kan | can +hans | his +hvor | where +eller | or +hva | what +skal | shall/must +selv | self (reflective) +sjøl | self (reflective) +her | here +alle | all +vil | will +bli | become +ble | became +blei | became * +blitt | have become +kunne | could +inn | in +når | when +være | be +kom | come +noen | some +noe | some +ville | would +dere | you +som | who/which/that +deres | their/theirs +kun | only/just +ja | yes +etter | after +ned | down +skulle | should +denne | this +for | for/because +deg | you +si | hers/his +sine | hers/his +sitt | hers/his +mot | against +å | to +meget | much +hvorfor | why +dette | this +disse | these/those +uten | without +hvordan | how +ingen | none +din | your +ditt | your +blir | become +samme | same +hvilken | which +hvilke | which (plural) +sånn | such a +inni | inside/within +mellom | between +vår | our +hver | each +hvem | who +vors | us/ours +hvis | whose +både | both +bare | only/just +enn | than +fordi | as/because +før | before +mange | many +også | also +slik | just +vært | been +være | to be +båe | both * +begge | both +siden | since +dykk | your * +dykkar | yours * +dei | they * +deira | them * +deires | theirs * +deim | them * +di | your (fem.) * +då | as/when * +eg | I * +ein | a/an * +eit | a/an * +eitt | a/an * +elles | or * +honom | he * +hjå | at * +ho | she * +hoe | she * +henne | her +hennar | her/hers +hennes | hers +hoss | how * +hossen | how * +ikkje | not * +ingi | noone * +inkje | noone * +korleis | how * +korso | how * +kva | what/which * +kvar | where * +kvarhelst | where * +kven | who/whom * +kvi | why * +kvifor | why * +me | we * +medan | while * +mi | my * +mine | my * +mykje | much * +no | now * +nokon | some (masc./neut.) * +noka | some (fem.) * +nokor | some * +noko | some * +nokre | some * +si | his/hers * +sia | since * +sidan | since * +so | so * +somt | some * +somme | some * +um | about* +upp | up * +vere | be * +vore | was * +verte | become * +vort | become * +varte | became * +vart | became * diff --git a/sphinx/search/_stopwords/pt.py b/sphinx/search/_stopwords/pt.py new file mode 100644 index 00000000000..9adef01661b --- /dev/null +++ b/sphinx/search/_stopwords/pt.py @@ -0,0 +1,210 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/portuguese/stop.txt + +from __future__ import annotations + +PORTUGUESE_STOPWORDS = frozenset({ + 'a', + 'ao', + 'aos', + 'aquela', + 'aquelas', + 'aquele', + 'aqueles', + 'aquilo', + 'as', + 'até', + 'com', + 'como', + 'da', + 'das', + 'de', + 'dela', + 'delas', + 'dele', + 'deles', + 'depois', + 'do', + 'dos', + 'e', + 'ela', + 'elas', + 'ele', + 'eles', + 'em', + 'entre', + 'era', + 'eram', + 'essa', + 'essas', + 'esse', + 'esses', + 'esta', + 'estamos', + 'estas', + 'estava', + 'estavam', + 'este', + 'esteja', + 'estejam', + 'estejamos', + 'estes', + 'esteve', + 'estive', + 'estivemos', + 'estiver', + 'estivera', + 'estiveram', + 'estiverem', + 'estivermos', + 'estivesse', + 'estivessem', + 'estivéramos', + 'estivéssemos', + 'estou', + 'está', + 'estávamos', + 'estão', + 'eu', + 'foi', + 'fomos', + 'for', + 'fora', + 'foram', + 'forem', + 'formos', + 'fosse', + 'fossem', + 'fui', + 'fôramos', + 'fôssemos', + 'haja', + 'hajam', + 'hajamos', + 'havemos', + 'hei', + 'houve', + 'houvemos', + 'houver', + 'houvera', + 'houveram', + 'houverei', + 'houverem', + 'houveremos', + 'houveria', + 'houveriam', + 'houvermos', + 'houverá', + 'houverão', + 'houveríamos', + 'houvesse', + 'houvessem', + 'houvéramos', + 'houvéssemos', + 'há', + 'hão', + 'isso', + 'isto', + 'já', + 'lhe', + 'lhes', + 'mais', + 'mas', + 'me', + 'mesmo', + 'meu', + 'meus', + 'minha', + 'minhas', + 'muito', + 'na', + 'nas', + 'nem', + 'no', + 'nos', + 'nossa', + 'nossas', + 'nosso', + 'nossos', + 'num', + 'numa', + 'não', + 'nós', + 'o', + 'os', + 'ou', + 'para', + 'pela', + 'pelas', + 'pelo', + 'pelos', + 'por', + 'qual', + 'quando', + 'que', + 'quem', + 'se', + 'seja', + 'sejam', + 'sejamos', + 'sem', + 'serei', + 'seremos', + 'seria', + 'seriam', + 'será', + 'serão', + 'seríamos', + 'seu', + 'seus', + 'somos', + 'sou', + 'sua', + 'suas', + 'são', + 'só', + 'também', + 'te', + 'tem', + 'temos', + 'tenha', + 'tenham', + 'tenhamos', + 'tenho', + 'terei', + 'teremos', + 'teria', + 'teriam', + 'terá', + 'terão', + 'teríamos', + 'teu', + 'teus', + 'teve', + 'tinha', + 'tinham', + 'tive', + 'tivemos', + 'tiver', + 'tivera', + 'tiveram', + 'tiverem', + 'tivermos', + 'tivesse', + 'tivessem', + 'tivéramos', + 'tivéssemos', + 'tu', + 'tua', + 'tuas', + 'tém', + 'tínhamos', + 'um', + 'uma', + 'você', + 'vocês', + 'vos', + 'à', + 'às', + 'éramos', +}) diff --git a/sphinx/search/_stopwords/pt.txt b/sphinx/search/_stopwords/pt.txt new file mode 100644 index 00000000000..9c3c9ac76d7 --- /dev/null +++ b/sphinx/search/_stopwords/pt.txt @@ -0,0 +1,245 @@ + + | A Portuguese stop word list. Comments begin with vertical bar. Each stop + | word is at the start of a line. + + + | The following is a ranked list (commonest to rarest) of stopwords + | deriving from a large sample of text. + + | Extra words have been added at the end. + +de | of, from +a | the; to, at; her +o | the; him +que | who, that +e | and +do | de + o +da | de + a +em | in +um | a +para | for + | é from SER +com | with +não | not, no +uma | a +os | the; them +no | em + o +se | himself etc +na | em + a +por | for +mais | more +as | the; them +dos | de + os +como | as, like +mas | but + | foi from SER +ao | a + o +ele | he +das | de + as + | tem from TER +à | a + a +seu | his +sua | her +ou | or + | ser from SER +quando | when +muito | much + | há from HAV +nos | em + os; us +já | already, now + | está from EST +eu | I +também | also +só | only, just +pelo | per + o +pela | per + a +até | up to +isso | that +ela | he +entre | between + | era from SER +depois | after +sem | without +mesmo | same +aos | a + os + | ter from TER +seus | his +quem | whom +nas | em + as +me | me +esse | that +eles | they + | estão from EST +você | you + | tinha from TER + | foram from SER +essa | that +num | em + um +nem | nor +suas | her +meu | my +às | a + as +minha | my + | têm from TER +numa | em + uma +pelos | per + os +elas | they + | havia from HAV + | seja from SER +qual | which + | será from SER +nós | we + | tenho from TER +lhe | to him, her +deles | of them +essas | those +esses | those +pelas | per + as +este | this + | fosse from SER +dele | of him + + | other words. There are many contractions such as naquele = em+aquele, + | mo = me+o, but they are rare. + | Indefinite article plural forms are also rare. + +tu | thou +te | thee +vocês | you (plural) +vos | you +lhes | to them +meus | my +minhas +teu | thy +tua +teus +tuas +nosso | our +nossa +nossos +nossas + +dela | of her +delas | of them + +esta | this +estes | these +estas | these +aquele | that +aquela | that +aqueles | those +aquelas | those +isto | this +aquilo | that + + | forms of estar, to be (not including the infinitive): +estou +está +estamos +estão +estive +esteve +estivemos +estiveram +estava +estávamos +estavam +estivera +estivéramos +esteja +estejamos +estejam +estivesse +estivéssemos +estivessem +estiver +estivermos +estiverem + + | forms of haver, to have (not including the infinitive): +hei +há +havemos +hão +houve +houvemos +houveram +houvera +houvéramos +haja +hajamos +hajam +houvesse +houvéssemos +houvessem +houver +houvermos +houverem +houverei +houverá +houveremos +houverão +houveria +houveríamos +houveriam + + | forms of ser, to be (not including the infinitive): +sou +somos +são +era +éramos +eram +fui +foi +fomos +foram +fora +fôramos +seja +sejamos +sejam +fosse +fôssemos +fossem +for +formos +forem +serei +será +seremos +serão +seria +seríamos +seriam + + | forms of ter, to have (not including the infinitive): +tenho +tem +temos +tém +tinha +tínhamos +tinham +tive +teve +tivemos +tiveram +tivera +tivéramos +tenha +tenhamos +tenham +tivesse +tivéssemos +tivessem +tiver +tivermos +tiverem +terei +terá +teremos +terão +teria +teríamos +teriam diff --git a/sphinx/search/_stopwords/ru.py b/sphinx/search/_stopwords/ru.py new file mode 100644 index 00000000000..2610b3b9b9a --- /dev/null +++ b/sphinx/search/_stopwords/ru.py @@ -0,0 +1,166 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/russian/stop.txt + +from __future__ import annotations + +RUSSIAN_STOPWORDS = frozenset({ + 'а', + 'без', + 'более', + 'больше', + 'будет', + 'будто', + 'бы', + 'был', + 'была', + 'были', + 'было', + 'быть', + 'в', + 'вам', + 'вас', + 'вдруг', + 'ведь', + 'во', + 'вот', + 'впрочем', + 'все', + 'всегда', + 'всего', + 'всех', + 'всю', + 'вы', + 'где', + 'говорил', + 'да', + 'даже', + 'два', + 'для', + 'до', + 'другой', + 'его', + 'ее', + 'ей', + 'ему', + 'если', + 'есть', + 'еще', + 'ж', + 'же', + 'жизнь', + 'за', + 'зачем', + 'здесь', + 'и', + 'из', + 'или', + 'им', + 'иногда', + 'их', + 'к', + 'кажется', + 'как', + 'какая', + 'какой', + 'когда', + 'конечно', + 'кто', + 'куда', + 'ли', + 'лучше', + 'между', + 'меня', + 'мне', + 'много', + 'может', + 'можно', + 'мой', + 'моя', + 'мы', + 'на', + 'над', + 'надо', + 'наконец', + 'нас', + 'не', + 'него', + 'нее', + 'ней', + 'нельзя', + 'нет', + 'ни', + 'нибудь', + 'никогда', + 'ним', + 'них', + 'ничего', + 'но', + 'ну', + 'о', + 'об', + 'один', + 'он', + 'она', + 'они', + 'опять', + 'от', + 'перед', + 'по', + 'под', + 'после', + 'потом', + 'потому', + 'почти', + 'при', + 'про', + 'раз', + 'разве', + 'с', + 'сам', + 'свою', + 'себе', + 'себя', + 'сегодня', + 'сейчас', + 'сказал', + 'сказала', + 'сказать', + 'со', + 'совсем', + 'так', + 'такой', + 'там', + 'тебя', + 'тем', + 'теперь', + 'то', + 'тогда', + 'того', + 'тоже', + 'только', + 'том', + 'тот', + 'три', + 'тут', + 'ты', + 'у', + 'уж', + 'уже', + 'хорошо', + 'хоть', + 'чего', + 'человек', + 'чем', + 'через', + 'что', + 'чтоб', + 'чтобы', + 'чуть', + 'эти', + 'этого', + 'этой', + 'этом', + 'этот', + 'эту', + 'я', +}) diff --git a/sphinx/search/_stopwords/ru.txt b/sphinx/search/_stopwords/ru.txt new file mode 100644 index 00000000000..96abb77073e --- /dev/null +++ b/sphinx/search/_stopwords/ru.txt @@ -0,0 +1,235 @@ + + + | a russian stop word list. comments begin with vertical bar. each stop + | word is at the start of a line. + + | this is a ranked list (commonest to rarest) of stopwords derived from + | a large text sample. + + | letter `ё' is translated to `е'. + +и | and +в | in/into +во | alternative form +не | not +что | what/that +он | he +на | on/onto +я | i +с | from +со | alternative form +как | how +а | milder form of `no' (but) +то | conjunction and form of `that' +все | all +она | she +так | so, thus +его | him +но | but +да | yes/and +ты | thou +к | towards, by +у | around, chez +же | intensifier particle +вы | you +за | beyond, behind +бы | conditional/subj. particle +по | up to, along +только | only +ее | her +мне | to me +было | it was +вот | here is/are, particle +от | away from +меня | me +еще | still, yet, more +нет | no, there isnt/arent +о | about +из | out of +ему | to him +теперь | now +когда | when +даже | even +ну | so, well +вдруг | suddenly +ли | interrogative particle +если | if +уже | already, but homonym of `narrower' +или | or +ни | neither +быть | to be +был | he was +него | prepositional form of его +до | up to +вас | you accusative +нибудь | indef. suffix preceded by hyphen +опять | again +уж | already, but homonym of `adder' +вам | to you +сказал | he said +ведь | particle `after all' +там | there +потом | then +себя | oneself +ничего | nothing +ей | to her +может | usually with `быть' as `maybe' +они | they +тут | here +где | where +есть | there is/are +надо | got to, must +ней | prepositional form of ей +для | for +мы | we +тебя | thee +их | them, their +чем | than +была | she was +сам | self +чтоб | in order to +без | without +будто | as if +человек | man, person, one +чего | genitive form of `what' +раз | once +тоже | also +себе | to oneself +под | beneath +жизнь | life +будет | will be +ж | short form of intensifer particle `же' +тогда | then +кто | who +этот | this +говорил | was saying +того | genitive form of `that' +потому | for that reason +этого | genitive form of `this' +какой | which +совсем | altogether +ним | prepositional form of `его', `они' +здесь | here +этом | prepositional form of `этот' +один | one +почти | almost +мой | my +тем | instrumental/dative plural of `тот', `то' +чтобы | full form of `in order that' +нее | her (acc.) +кажется | it seems +сейчас | now +были | they were +куда | where to +зачем | why +сказать | to say +всех | all (acc., gen. preposn. plural) +никогда | never +сегодня | today +можно | possible, one can +при | by +наконец | finally +два | two +об | alternative form of `о', about +другой | another +хоть | even +после | after +над | above +больше | more +тот | that one (masc.) +через | across, in +эти | these +нас | us +про | about +всего | in all, only, of all +них | prepositional form of `они' (they) +какая | which, feminine +много | lots +разве | interrogative particle +сказала | she said +три | three +эту | this, acc. fem. sing. +моя | my, feminine +впрочем | moreover, besides +хорошо | good +свою | ones own, acc. fem. sing. +этой | oblique form of `эта', fem. `this' +перед | in front of +иногда | sometimes +лучше | better +чуть | a little +том | preposn. form of `that one' +нельзя | one must not +такой | such a one +им | to them +более | more +всегда | always +конечно | of course +всю | acc. fem. sing of `all' +между | between + + + | b: some paradigms + | + | personal pronouns + | + | я меня мне мной [мною] + | ты тебя тебе тобой [тобою] + | он его ему им [него, нему, ним] + | она ее эи ею [нее, нэи, нею] + | оно его ему им [него, нему, ним] + | + | мы нас нам нами + | вы вас вам вами + | они их им ими [них, ним, ними] + | + | себя себе собой [собою] + | + | demonstrative pronouns: этот (this), тот (that) + | + | этот эта это эти + | этого эты это эти + | этого этой этого этих + | этому этой этому этим + | этим этой этим [этою] этими + | этом этой этом этих + | + | тот та то те + | того ту то те + | того той того тех + | тому той тому тем + | тем той тем [тою] теми + | том той том тех + | + | determinative pronouns + | + | (a) весь (all) + | + | весь вся все все + | всего всю все все + | всего всей всего всех + | всему всей всему всем + | всем всей всем [всею] всеми + | всем всей всем всех + | + | (b) сам (himself etc) + | + | сам сама само сами + | самого саму само самих + | самого самой самого самих + | самому самой самому самим + | самим самой самим [самою] самими + | самом самой самом самих + | + | stems of verbs `to be', `to have', `to do' and modal + | + | быть бы буд быв есть суть + | име + | дел + | мог мож мочь + | уме + | хоч хот + | долж + | можн + | нужн + | нельзя diff --git a/sphinx/search/_stopwords/sv.py b/sphinx/search/_stopwords/sv.py new file mode 100644 index 00000000000..d9be39c35ca --- /dev/null +++ b/sphinx/search/_stopwords/sv.py @@ -0,0 +1,121 @@ +# automatically generated by utils/generate-snowball.py +# from https://github.com/snowballstem/snowball-website/raw/efb4ae4d65769fb1652acbe608c0c817e746c730/algorithms/swedish/stop.txt + +from __future__ import annotations + +SWEDISH_STOPWORDS = frozenset({ + 'alla', + 'allt', + 'att', + 'av', + 'blev', + 'bli', + 'blir', + 'blivit', + 'de', + 'dem', + 'den', + 'denna', + 'deras', + 'dess', + 'dessa', + 'det', + 'detta', + 'dig', + 'din', + 'dina', + 'ditt', + 'du', + 'där', + 'då', + 'efter', + 'ej', + 'eller', + 'en', + 'er', + 'era', + 'ert', + 'ett', + 'från', + 'för', + 'ha', + 'hade', + 'han', + 'hans', + 'har', + 'henne', + 'hennes', + 'hon', + 'honom', + 'hur', + 'här', + 'i', + 'icke', + 'ingen', + 'inom', + 'inte', + 'jag', + 'ju', + 'kan', + 'kunde', + 'man', + 'med', + 'mellan', + 'men', + 'mig', + 'min', + 'mina', + 'mitt', + 'mot', + 'mycket', + 'ni', + 'nu', + 'när', + 'någon', + 'något', + 'några', + 'och', + 'om', + 'oss', + 'på', + 'samma', + 'sedan', + 'sig', + 'sin', + 'sina', + 'sitta', + 'själv', + 'skulle', + 'som', + 'så', + 'sådan', + 'sådana', + 'sådant', + 'till', + 'under', + 'upp', + 'ut', + 'utan', + 'vad', + 'var', + 'vara', + 'varför', + 'varit', + 'varje', + 'vars', + 'vart', + 'vem', + 'vi', + 'vid', + 'vilka', + 'vilkas', + 'vilken', + 'vilket', + 'vår', + 'våra', + 'vårt', + 'än', + 'är', + 'åt', + 'över', +}) diff --git a/sphinx/search/_stopwords/sv.txt b/sphinx/search/_stopwords/sv.txt new file mode 100644 index 00000000000..2fb53892a42 --- /dev/null +++ b/sphinx/search/_stopwords/sv.txt @@ -0,0 +1,124 @@ + + | A Swedish stop word list. Comments begin with vertical bar. Each stop + | word is at the start of a line. + + | This is a ranked list (commonest to rarest) of stopwords derived from + | a large text sample. + + | Swedish stop words occasionally exhibit homonym clashes. For example + | så = so, but also seed. These are indicated clearly below. + +och | and +det | it, this/that +att | to (with infinitive) +i | in, at +en | a +jag | I +hon | she +som | who, that +han | he +på | on +den | it, this/that +med | with +var | where, each +sig | him(self) etc +för | for +så | so (also: seed) +till | to +är | is +men | but +ett | a +om | if; around, about +hade | had +de | they, these/those +av | of +icke | not, no +mig | me +du | you +henne | her +då | then, when +sin | his +nu | now +har | have +inte | inte någon = no one +hans | his +honom | him +skulle | 'sake' +hennes | her +där | there +min | my +man | one (pronoun) +ej | nor +vid | at, by, on (also: vast) +kunde | could +något | some etc +från | from, off +ut | out +när | when +efter | after, behind +upp | up +vi | we +dem | them +vara | be +vad | what +över | over +än | than +dig | you +kan | can +sina | his +här | here +ha | have +mot | towards +alla | all +under | under (also: wonder) +någon | some etc +eller | or (else) +allt | all +mycket | much +sedan | since +ju | why +denna | this/that +själv | myself, yourself etc +detta | this/that +åt | to +utan | without +varit | was +hur | how +ingen | no +mitt | my +ni | you +bli | to be, become +blev | from bli +oss | us +din | thy +dessa | these/those +några | some etc +deras | their +blir | from bli +mina | my +samma | (the) same +vilken | who, that +er | you, your +sådan | such a +vår | our +blivit | from bli +dess | its +inom | within +mellan | between +sådant | such a +varför | why +varje | each +vilka | who, that +ditt | thy +vem | who +vilket | who, that +sitta | his +sådana | such a +vart | each +dina | thy +vars | whose +vårt | our +våra | our +ert | your +era | your +vilkas | whose diff --git a/sphinx/search/da.py b/sphinx/search/da.py index a56114bb6ba..e632a97fb78 100644 --- a/sphinx/search/da.py +++ b/sphinx/search/da.py @@ -1,117 +1,21 @@ -"""Danish search language: includes the JS Danish stemmer.""" +"""Danish search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -danish_stopwords = parse_stop_word(""" -| source: https://snowball.tartarus.org/algorithms/danish/stop.txt -og | and -i | in -jeg | I -det | that (dem. pronoun)/it (pers. pronoun) -at | that (in front of a sentence)/to (with infinitive) -en | a/an -den | it (pers. pronoun)/that (dem. pronoun) -til | to/at/for/until/against/by/of/into, more -er | present tense of "to be" -som | who, as -på | on/upon/in/on/at/to/after/of/with/for, on -de | they -med | with/by/in, along -han | he -af | of/by/from/off/for/in/with/on, off -for | at/for/to/from/by/of/ago, in front/before, because -ikke | not -der | who/which, there/those -var | past tense of "to be" -mig | me/myself -sig | oneself/himself/herself/itself/themselves -men | but -et | a/an/one, one (number), someone/somebody/one -har | present tense of "to have" -om | round/about/for/in/a, about/around/down, if -vi | we -min | my -havde | past tense of "to have" -ham | him -hun | she -nu | now -over | over/above/across/by/beyond/past/on/about, over/past -da | then, when/as/since -fra | from/off/since, off, since -du | you -ud | out -sin | his/her/its/one's -dem | them -os | us/ourselves -op | up -man | you/one -hans | his -hvor | where -eller | or -hvad | what -skal | must/shall etc. -selv | myself/yourself/herself/ourselves etc., even -her | here -alle | all/everyone/everybody etc. -vil | will (verb) -blev | past tense of "to stay/to remain/to get/to become" -kunne | could -ind | in -når | when -være | present tense of "to be" -dog | however/yet/after all -noget | something -ville | would -jo | you know/you see (adv), yes -deres | their/theirs -efter | after/behind/according to/for/by/from, later/afterwards -ned | down -skulle | should -denne | this -end | than -dette | this -mit | my/mine -også | also -under | under/beneath/below/during, below/underneath -have | have -dig | you -anden | other -hende | her -mine | my -alt | everything -meget | much/very, plenty of -sit | his, her, its, one's -sine | his, her, its, one's -vor | our -mod | against -disse | these -hvis | if -din | your/yours -nogle | some -hos | by/at -blive | be/become -mange | many -ad | by/through -bliver | present tense of "to be/to become" -hendes | her/hers -været | be -thi | for (conj) -jer | you -sådan | such, like this/like that -""") +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.da import DANISH_STOPWORDS class SearchDanish(SearchLanguage): lang = 'da' language_name = 'Danish' js_stemmer_rawcode = 'danish-stemmer.js' - stopwords = danish_stopwords + stopwords = DANISH_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('danish') def stem(self, word: str) -> str: diff --git a/sphinx/search/de.py b/sphinx/search/de.py index 37aa9ec8890..278d78fb487 100644 --- a/sphinx/search/de.py +++ b/sphinx/search/de.py @@ -1,300 +1,21 @@ -"""German search language: includes the JS German stemmer.""" +"""German search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -german_stopwords = parse_stop_word(""" -|source: https://snowball.tartarus.org/algorithms/german/stop.txt -aber | but - -alle | all -allem -allen -aller -alles - -als | than, as -also | so -am | an + dem -an | at - -ander | other -andere -anderem -anderen -anderer -anderes -anderm -andern -anderr -anders - -auch | also -auf | on -aus | out of -bei | by -bin | am -bis | until -bist | art -da | there -damit | with it -dann | then - -der | the -den -des -dem -die -das - -daß | that - -derselbe | the same -derselben -denselben -desselben -demselben -dieselbe -dieselben -dasselbe - -dazu | to that - -dein | thy -deine -deinem -deinen -deiner -deines - -denn | because - -derer | of those -dessen | of him - -dich | thee -dir | to thee -du | thou - -dies | this -diese -diesem -diesen -dieser -dieses - - -doch | (several meanings) -dort | (over) there - - -durch | through - -ein | a -eine -einem -einen -einer -eines - -einig | some -einige -einigem -einigen -einiger -einiges - -einmal | once - -er | he -ihn | him -ihm | to him - -es | it -etwas | something - -euer | your -eure -eurem -euren -eurer -eures - -für | for -gegen | towards -gewesen | p.p. of sein -hab | have -habe | have -haben | have -hat | has -hatte | had -hatten | had -hier | here -hin | there -hinter | behind - -ich | I -mich | me -mir | to me - - -ihr | you, to her -ihre -ihrem -ihren -ihrer -ihres -euch | to you - -im | in + dem -in | in -indem | while -ins | in + das -ist | is - -jede | each, every -jedem -jeden -jeder -jedes - -jene | that -jenem -jenen -jener -jenes - -jetzt | now -kann | can - -kein | no -keine -keinem -keinen -keiner -keines - -können | can -könnte | could -machen | do -man | one - -manche | some, many a -manchem -manchen -mancher -manches - -mein | my -meine -meinem -meinen -meiner -meines - -mit | with -muss | must -musste | had to -nach | to(wards) -nicht | not -nichts | nothing -noch | still, yet -nun | now -nur | only -ob | whether -oder | or -ohne | without -sehr | very - -sein | his -seine -seinem -seinen -seiner -seines - -selbst | self -sich | herself - -sie | they, she -ihnen | to them - -sind | are -so | so - -solche | such -solchem -solchen -solcher -solches - -soll | shall -sollte | should -sondern | but -sonst | else -über | over -um | about, around -und | and - -uns | us -unse -unsem -unsen -unser -unses - -unter | under -viel | much -vom | von + dem -von | from -vor | before -während | while -war | was -waren | were -warst | wast -was | what -weg | away, off -weil | because -weiter | further - -welche | which -welchem -welchen -welcher -welches - -wenn | when -werde | will -werden | will -wie | how -wieder | again -will | want -wir | we -wird | will -wirst | willst -wo | where -wollen | want -wollte | wanted -würde | would -würden | would -zu | to -zum | zu + dem -zur | zu + der -zwar | indeed -zwischen | between -""") +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.de import GERMAN_STOPWORDS class SearchGerman(SearchLanguage): lang = 'de' language_name = 'German' js_stemmer_rawcode = 'german-stemmer.js' - stopwords = german_stopwords + stopwords = GERMAN_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('german') def stem(self, word: str) -> str: diff --git a/sphinx/search/en.py b/sphinx/search/en.py index 5173dc03fc0..273a25a0272 100644 --- a/sphinx/search/en.py +++ b/sphinx/search/en.py @@ -1,218 +1,22 @@ -"""English search language: includes the JS porter stemmer.""" +"""English search language.""" from __future__ import annotations import snowballstemmer from sphinx.search import SearchLanguage - -english_stopwords = { - 'a', 'and', 'are', 'as', 'at', - 'be', 'but', 'by', - 'for', - 'if', 'in', 'into', 'is', 'it', - 'near', 'no', 'not', - 'of', 'on', 'or', - 'such', - 'that', 'the', 'their', 'then', 'there', 'these', 'they', 'this', 'to', - 'was', 'will', 'with', -} # fmt: skip - -js_porter_stemmer = """ -/** - * Porter Stemmer - */ -var Stemmer = function() { - - var step2list = { - ational: 'ate', - tional: 'tion', - enci: 'ence', - anci: 'ance', - izer: 'ize', - bli: 'ble', - alli: 'al', - entli: 'ent', - eli: 'e', - ousli: 'ous', - ization: 'ize', - ation: 'ate', - ator: 'ate', - alism: 'al', - iveness: 'ive', - fulness: 'ful', - ousness: 'ous', - aliti: 'al', - iviti: 'ive', - biliti: 'ble', - logi: 'log' - }; - - var step3list = { - icate: 'ic', - ative: '', - alize: 'al', - iciti: 'ic', - ical: 'ic', - ful: '', - ness: '' - }; - - var c = "[^aeiou]"; // consonant - var v = "[aeiouy]"; // vowel - var C = c + "[^aeiouy]*"; // consonant sequence - var V = v + "[aeiou]*"; // vowel sequence - - var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 - var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 - var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 - var s_v = "^(" + C + ")?" + v; // vowel in stem - - this.stemWord = function (w) { - var stem; - var suffix; - var firstch; - var origword = w; - - if (w.length < 3) - return w; - - var re; - var re2; - var re3; - var re4; - - firstch = w.substr(0,1); - if (firstch == "y") - w = firstch.toUpperCase() + w.substr(1); - - // Step 1a - re = /^(.+?)(ss|i)es$/; - re2 = /^(.+?)([^s])s$/; - - if (re.test(w)) - w = w.replace(re,"$1$2"); - else if (re2.test(w)) - w = w.replace(re2,"$1$2"); - - // Step 1b - re = /^(.+?)eed$/; - re2 = /^(.+?)(ed|ing)$/; - if (re.test(w)) { - var fp = re.exec(w); - re = new RegExp(mgr0); - if (re.test(fp[1])) { - re = /.$/; - w = w.replace(re,""); - } - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1]; - re2 = new RegExp(s_v); - if (re2.test(stem)) { - w = stem; - re2 = /(at|bl|iz)$/; - re3 = new RegExp("([^aeiouylsz])\\\\1$"); - re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re2.test(w)) - w = w + "e"; - else if (re3.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - else if (re4.test(w)) - w = w + "e"; - } - } - - // Step 1c - re = /^(.+?)y$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(s_v); - if (re.test(stem)) - w = stem + "i"; - } - - // Step 2 - re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|\ -ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step2list[suffix]; - } - - // Step 3 - re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step3list[suffix]; - } - - // Step 4 - re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|\ -iti|ous|ive|ize)$/; - re2 = /^(.+?)(s|t)(ion)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - if (re.test(stem)) - w = stem; - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1] + fp[2]; - re2 = new RegExp(mgr1); - if (re2.test(stem)) - w = stem; - } - - // Step 5 - re = /^(.+?)e$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - re2 = new RegExp(meq1); - re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) - w = stem; - } - re = /ll$/; - re2 = new RegExp(mgr1); - if (re.test(w) && re2.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - - // and turn initial Y back to y - if (firstch == "y") - w = firstch.toLowerCase() + w.substr(1); - return w; - } -} -""" +from sphinx.search._stopwords.en import ENGLISH_STOPWORDS class SearchEnglish(SearchLanguage): lang = 'en' language_name = 'English' - js_stemmer_code = js_porter_stemmer - stopwords = english_stopwords + js_stemmer_rawcode = 'english-stemmer.js' + stopwords = ENGLISH_STOPWORDS - def init(self, options: dict[str, str]) -> None: - self.stemmer = snowballstemmer.stemmer('porter') + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) + self.stemmer = snowballstemmer.stemmer('english') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) diff --git a/sphinx/search/es.py b/sphinx/search/es.py index 5739c88172a..c1b08ab1bad 100644 --- a/sphinx/search/es.py +++ b/sphinx/search/es.py @@ -1,360 +1,21 @@ -"""Spanish search language: includes the JS Spanish stemmer.""" +"""Spanish search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -spanish_stopwords = parse_stop_word(""" -|source: https://snowball.tartarus.org/algorithms/spanish/stop.txt -de | from, of -la | the, her -que | who, that -el | the -en | in -y | and -a | to -los | the, them -del | de + el -se | himself, from him etc -las | the, them -por | for, by, etc -un | a -para | for -con | with -no | no -una | a -su | his, her -al | a + el - | es from SER -lo | him -como | how -más | more -pero | pero -sus | su plural -le | to him, her -ya | already -o | or - | fue from SER -este | this - | ha from HABER -sí | himself etc -porque | because -esta | this - | son from SER -entre | between - | está from ESTAR -cuando | when -muy | very -sin | without -sobre | on - | ser from SER - | tiene from TENER -también | also -me | me -hasta | until -hay | there is/are -donde | where - | han from HABER -quien | whom, that - | están from ESTAR - | estado from ESTAR -desde | from -todo | all -nos | us -durante | during - | estados from ESTAR -todos | all -uno | a -les | to them -ni | nor -contra | against -otros | other - | fueron from SER -ese | that -eso | that - | había from HABER -ante | before -ellos | they -e | and (variant of y) -esto | this -mí | me -antes | before -algunos | some -qué | what? -unos | a -yo | I -otro | other -otras | other -otra | other -él | he -tanto | so much, many -esa | that -estos | these -mucho | much, many -quienes | who -nada | nothing -muchos | many -cual | who - | sea from SER -poco | few -ella | she -estar | to be - | haber from HABER -estas | these - | estaba from ESTAR - | estamos from ESTAR -algunas | some -algo | something -nosotros | we - - | other forms - -mi | me -mis | mi plural -tú | thou -te | thee -ti | thee -tu | thy -tus | tu plural -ellas | they -nosotras | we -vosotros | you -vosotras | you -os | you -mío | mine -mía | -míos | -mías | -tuyo | thine -tuya | -tuyos | -tuyas | -suyo | his, hers, theirs -suya | -suyos | -suyas | -nuestro | ours -nuestra | -nuestros | -nuestras | -vuestro | yours -vuestra | -vuestros | -vuestras | -esos | those -esas | those - - | forms of estar, to be (not including the infinitive): -estoy -estás -está -estamos -estáis -están -esté -estés -estemos -estéis -estén -estaré -estarás -estará -estaremos -estaréis -estarán -estaría -estarías -estaríamos -estaríais -estarían -estaba -estabas -estábamos -estabais -estaban -estuve -estuviste -estuvo -estuvimos -estuvisteis -estuvieron -estuviera -estuvieras -estuviéramos -estuvierais -estuvieran -estuviese -estuvieses -estuviésemos -estuvieseis -estuviesen -estando -estado -estada -estados -estadas -estad - - | forms of haber, to have (not including the infinitive): -he -has -ha -hemos -habéis -han -haya -hayas -hayamos -hayáis -hayan -habré -habrás -habrá -habremos -habréis -habrán -habría -habrías -habríamos -habríais -habrían -había -habías -habíamos -habíais -habían -hube -hubiste -hubo -hubimos -hubisteis -hubieron -hubiera -hubieras -hubiéramos -hubierais -hubieran -hubiese -hubieses -hubiésemos -hubieseis -hubiesen -habiendo -habido -habida -habidos -habidas - - | forms of ser, to be (not including the infinitive): -soy -eres -es -somos -sois -son -sea -seas -seamos -seáis -sean -seré -serás -será -seremos -seréis -serán -sería -serías -seríamos -seríais -serían -era -eras -éramos -erais -eran -fui -fuiste -fue -fuimos -fuisteis -fueron -fuera -fueras -fuéramos -fuerais -fueran -fuese -fueses -fuésemos -fueseis -fuesen -siendo -sido - | sed also means 'thirst' - - | forms of tener, to have (not including the infinitive): -tengo -tienes -tiene -tenemos -tenéis -tienen -tenga -tengas -tengamos -tengáis -tengan -tendré -tendrás -tendrá -tendremos -tendréis -tendrán -tendría -tendrías -tendríamos -tendríais -tendrían -tenía -tenías -teníamos -teníais -tenían -tuve -tuviste -tuvo -tuvimos -tuvisteis -tuvieron -tuviera -tuvieras -tuviéramos -tuvierais -tuvieran -tuviese -tuvieses -tuviésemos -tuvieseis -tuviesen -teniendo -tenido -tenida -tenidos -tenidas -tened -""") +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.es import SPANISH_STOPWORDS class SearchSpanish(SearchLanguage): lang = 'es' language_name = 'Spanish' js_stemmer_rawcode = 'spanish-stemmer.js' - stopwords = spanish_stopwords + stopwords = SPANISH_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('spanish') def stem(self, word: str) -> str: diff --git a/sphinx/search/fi.py b/sphinx/search/fi.py index 24ef7502300..01c7e0ba126 100644 --- a/sphinx/search/fi.py +++ b/sphinx/search/fi.py @@ -1,110 +1,21 @@ -"""Finnish search language: includes the JS Finnish stemmer.""" +"""Finnish search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -finnish_stopwords = parse_stop_word(""" -| source: https://snowball.tartarus.org/algorithms/finnish/stop.txt -| forms of BE - -olla -olen -olet -on -olemme -olette -ovat -ole | negative form - -oli -olisi -olisit -olisin -olisimme -olisitte -olisivat -olit -olin -olimme -olitte -olivat -ollut -olleet - -en | negation -et -ei -emme -ette -eivät - -|Nom Gen Acc Part Iness Elat Illat Adess Ablat Allat Ess Trans -minä minun minut minua minussa minusta minuun minulla minulta minulle | I -sinä sinun sinut sinua sinussa sinusta sinuun sinulla sinulta sinulle | you -hän hänen hänet häntä hänessä hänestä häneen hänellä häneltä hänelle | he she -me meidän meidät meitä meissä meistä meihin meillä meiltä meille | we -te teidän teidät teitä teissä teistä teihin teillä teiltä teille | you -he heidän heidät heitä heissä heistä heihin heillä heiltä heille | they - -tämä tämän tätä tässä tästä tähän tällä tältä tälle tänä täksi | this -tuo tuon tuota tuossa tuosta tuohon tuolla tuolta tuolle tuona tuoksi | that -se sen sitä siinä siitä siihen sillä siltä sille sinä siksi | it -nämä näiden näitä näissä näistä näihin näillä näiltä näille näinä näiksi | these -nuo noiden noita noissa noista noihin noilla noilta noille noina noiksi | those -ne niiden niitä niissä niistä niihin niillä niiltä niille niinä niiksi | they - -kuka kenen kenet ketä kenessä kenestä keneen kenellä keneltä kenelle kenenä keneksi| who -ketkä keiden ketkä keitä keissä keistä keihin keillä keiltä keille keinä keiksi | (pl) -mikä minkä minkä mitä missä mistä mihin millä miltä mille minä miksi | which what -mitkä | (pl) - -joka jonka jota jossa josta johon jolla jolta jolle jona joksi | who which -jotka joiden joita joissa joista joihin joilla joilta joille joina joiksi | (pl) - -| conjunctions - -että | that -ja | and -jos | if -koska | because -kuin | than -mutta | but -niin | so -sekä | and -sillä | for -tai | or -vaan | but -vai | or -vaikka | although - - -| prepositions - -kanssa | with -mukaan | according to -noin | about -poikki | across -yli | over, across - -| other - -kun | when -niin | so -nyt | now -itse | self -""") # NoQA: E501 +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.fi import FINNISH_STOPWORDS class SearchFinnish(SearchLanguage): lang = 'fi' language_name = 'Finnish' js_stemmer_rawcode = 'finnish-stemmer.js' - stopwords = finnish_stopwords + stopwords = FINNISH_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('finnish') def stem(self, word: str) -> str: diff --git a/sphinx/search/fr.py b/sphinx/search/fr.py index 7662737d6e3..e79976dfea1 100644 --- a/sphinx/search/fr.py +++ b/sphinx/search/fr.py @@ -1,196 +1,21 @@ -"""French search language: includes the JS French stemmer.""" +"""French search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -french_stopwords = parse_stop_word(""" -| source: https://snowball.tartarus.org/algorithms/french/stop.txt -au | a + le -aux | a + les -avec | with -ce | this -ces | these -dans | with -de | of -des | de + les -du | de + le -elle | she -en | `of them' etc -et | and -eux | them -il | he -je | I -la | the -le | the -leur | their -lui | him -ma | my (fem) -mais | but -me | me -même | same; as in moi-même (myself) etc -mes | me (pl) -moi | me -mon | my (masc) -ne | not -nos | our (pl) -notre | our -nous | we -on | one -ou | where -par | by -pas | not -pour | for -qu | que before vowel -que | that -qui | who -sa | his, her (fem) -se | oneself -ses | his (pl) -son | his, her (masc) -sur | on -ta | thy (fem) -te | thee -tes | thy (pl) -toi | thee -ton | thy (masc) -tu | thou -un | a -une | a -vos | your (pl) -votre | your -vous | you - - | single letter forms - -c | c' -d | d' -j | j' -l | l' -à | to, at -m | m' -n | n' -s | s' -t | t' -y | there - - | forms of être (not including the infinitive): -été -étée -étées -étés -étant -suis -es -est -sommes -êtes -sont -serai -seras -sera -serons -serez -seront -serais -serait -serions -seriez -seraient -étais -était -étions -étiez -étaient -fus -fut -fûmes -fûtes -furent -sois -soit -soyons -soyez -soient -fusse -fusses -fût -fussions -fussiez -fussent - - | forms of avoir (not including the infinitive): -ayant -eu -eue -eues -eus -ai -as -avons -avez -ont -aurai -auras -aura -aurons -aurez -auront -aurais -aurait -aurions -auriez -auraient -avais -avait -avions -aviez -avaient -eut -eûmes -eûtes -eurent -aie -aies -ait -ayons -ayez -aient -eusse -eusses -eût -eussions -eussiez -eussent - - | Later additions (from Jean-Christophe Deschamps) -ceci | this -cela | that (added 11 Apr 2012. Omission reported by Adrien Grand) -celà | that (incorrect, though common) -cet | this -cette | this -ici | here -ils | they -les | the (pl) -leurs | their (pl) -quel | which -quels | which -quelle | which -quelles | which -sans | without -soi | oneself -""") +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.fr import FRENCH_STOPWORDS class SearchFrench(SearchLanguage): lang = 'fr' language_name = 'French' js_stemmer_rawcode = 'french-stemmer.js' - stopwords = french_stopwords + stopwords = FRENCH_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('french') def stem(self, word: str) -> str: diff --git a/sphinx/search/hu.py b/sphinx/search/hu.py index 5c35b16fc65..254ad488d78 100644 --- a/sphinx/search/hu.py +++ b/sphinx/search/hu.py @@ -1,223 +1,21 @@ -"""Hungarian search language: includes the JS Hungarian stemmer.""" +"""Hungarian search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -hungarian_stopwords = parse_stop_word(""" -| source: https://snowball.tartarus.org/algorithms/hungarian/stop.txt -| prepared by Anna Tordai -a -ahogy -ahol -aki -akik -akkor -alatt -által -általában -amely -amelyek -amelyekben -amelyeket -amelyet -amelynek -ami -amit -amolyan -amíg -amikor -át -abban -ahhoz -annak -arra -arról -az -azok -azon -azt -azzal -azért -aztán -azután -azonban -bár -be -belül -benne -cikk -cikkek -cikkeket -csak -de -e -eddig -egész -egy -egyes -egyetlen -egyéb -egyik -egyre -ekkor -el -elég -ellen -elő -először -előtt -első -én -éppen -ebben -ehhez -emilyen -ennek -erre -ez -ezt -ezek -ezen -ezzel -ezért -és -fel -felé -hanem -hiszen -hogy -hogyan -igen -így -illetve -ill. -ill -ilyen -ilyenkor -ison -ismét -itt -jó -jól -jobban -kell -kellett -keresztül -keressünk -ki -kívül -között -közül -legalább -lehet -lehetett -legyen -lenne -lenni -lesz -lett -maga -magát -majd -majd -már -más -másik -meg -még -mellett -mert -mely -melyek -mi -mit -míg -miért -milyen -mikor -minden -mindent -mindenki -mindig -mint -mintha -mivel -most -nagy -nagyobb -nagyon -ne -néha -nekem -neki -nem -néhány -nélkül -nincs -olyan -ott -össze -ő -ők -őket -pedig -persze -rá -s -saját -sem -semmi -sok -sokat -sokkal -számára -szemben -szerint -szinte -talán -tehát -teljes -tovább -továbbá -több -úgy -ugyanis -új -újabb -újra -után -utána -utolsó -vagy -vagyis -valaki -valami -valamint -való -vagyok -van -vannak -volt -voltam -voltak -voltunk -vissza -vele -viszont -volna -""") +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.hu import HUNGARIAN_STOPWORDS class SearchHungarian(SearchLanguage): lang = 'hu' language_name = 'Hungarian' js_stemmer_rawcode = 'hungarian-stemmer.js' - stopwords = hungarian_stopwords + stopwords = HUNGARIAN_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('hungarian') def stem(self, word: str) -> str: diff --git a/sphinx/search/it.py b/sphinx/search/it.py index 60a5cf57720..d8a583f9d85 100644 --- a/sphinx/search/it.py +++ b/sphinx/search/it.py @@ -1,313 +1,21 @@ -"""Italian search language: includes the JS Italian stemmer.""" +"""Italian search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -italian_stopwords = parse_stop_word(""" -| source: https://snowball.tartarus.org/algorithms/italian/stop.txt -ad | a (to) before vowel -al | a + il -allo | a + lo -ai | a + i -agli | a + gli -all | a + l' -agl | a + gl' -alla | a + la -alle | a + le -con | with -col | con + il -coi | con + i (forms collo, cogli etc are now very rare) -da | from -dal | da + il -dallo | da + lo -dai | da + i -dagli | da + gli -dall | da + l' -dagl | da + gll' -dalla | da + la -dalle | da + le -di | of -del | di + il -dello | di + lo -dei | di + i -degli | di + gli -dell | di + l' -degl | di + gl' -della | di + la -delle | di + le -in | in -nel | in + el -nello | in + lo -nei | in + i -negli | in + gli -nell | in + l' -negl | in + gl' -nella | in + la -nelle | in + le -su | on -sul | su + il -sullo | su + lo -sui | su + i -sugli | su + gli -sull | su + l' -sugl | su + gl' -sulla | su + la -sulle | su + le -per | through, by -tra | among -contro | against -io | I -tu | thou -lui | he -lei | she -noi | we -voi | you -loro | they -mio | my -mia | -miei | -mie | -tuo | -tua | -tuoi | thy -tue | -suo | -sua | -suoi | his, her -sue | -nostro | our -nostra | -nostri | -nostre | -vostro | your -vostra | -vostri | -vostre | -mi | me -ti | thee -ci | us, there -vi | you, there -lo | him, the -la | her, the -li | them -le | them, the -gli | to him, the -ne | from there etc -il | the -un | a -uno | a -una | a -ma | but -ed | and -se | if -perché | why, because -anche | also -come | how -dov | where (as dov') -dove | where -che | who, that -chi | who -cui | whom -non | not -più | more -quale | who, that -quanto | how much -quanti | -quanta | -quante | -quello | that -quelli | -quella | -quelle | -questo | this -questi | -questa | -queste | -si | yes -tutto | all -tutti | all - - | single letter forms: - -a | at -c | as c' for ce or ci -e | and -i | the -l | as l' -o | or - - | forms of avere, to have (not including the infinitive): - -ho -hai -ha -abbiamo -avete -hanno -abbia -abbiate -abbiano -avrò -avrai -avrà -avremo -avrete -avranno -avrei -avresti -avrebbe -avremmo -avreste -avrebbero -avevo -avevi -aveva -avevamo -avevate -avevano -ebbi -avesti -ebbe -avemmo -aveste -ebbero -avessi -avesse -avessimo -avessero -avendo -avuto -avuta -avuti -avute - - | forms of essere, to be (not including the infinitive): -sono -sei -è -siamo -siete -sia -siate -siano -sarò -sarai -sarà -saremo -sarete -saranno -sarei -saresti -sarebbe -saremmo -sareste -sarebbero -ero -eri -era -eravamo -eravate -erano -fui -fosti -fu -fummo -foste -furono -fossi -fosse -fossimo -fossero -essendo - - | forms of fare, to do (not including the infinitive, fa, fat-): -faccio -fai -facciamo -fanno -faccia -facciate -facciano -farò -farai -farà -faremo -farete -faranno -farei -faresti -farebbe -faremmo -fareste -farebbero -facevo -facevi -faceva -facevamo -facevate -facevano -feci -facesti -fece -facemmo -faceste -fecero -facessi -facesse -facessimo -facessero -facendo - - | forms of stare, to be (not including the infinitive): -sto -stai -sta -stiamo -stanno -stia -stiate -stiano -starò -starai -starà -staremo -starete -staranno -starei -staresti -starebbe -staremmo -stareste -starebbero -stavo -stavi -stava -stavamo -stavate -stavano -stetti -stesti -stette -stemmo -steste -stettero -stessi -stesse -stessimo -stessero -""") +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.it import ITALIAN_STOPWORDS class SearchItalian(SearchLanguage): lang = 'it' language_name = 'Italian' js_stemmer_rawcode = 'italian-stemmer.js' - stopwords = italian_stopwords + stopwords = ITALIAN_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('italian') def stem(self, word: str) -> str: diff --git a/sphinx/search/ja.py b/sphinx/search/ja.py index f855fe4a67d..7045a314459 100644 --- a/sphinx/search/ja.py +++ b/sphinx/search/ja.py @@ -523,7 +523,8 @@ class SearchJapanese(SearchLanguage): lang = 'ja' language_name = 'Japanese' - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) dotted_path = options.get('type') if dotted_path is None: self.splitter = DefaultSplitter(options) diff --git a/sphinx/search/minified-js/README.rst b/sphinx/search/minified-js/README.rst new file mode 100644 index 00000000000..e14b36aef3b --- /dev/null +++ b/sphinx/search/minified-js/README.rst @@ -0,0 +1,7 @@ +Regenerate minified files with:: + + npm install -g uglify-js + for f in $(ls sphinx/search/non-minified-js/); \ + do echo $f && \ + npx uglifyjs sphinx/search/non-minified-js/$f --compress --mangle --output sphinx/search/minified-js/$f; \ + done diff --git a/sphinx/search/minified-js/arabic-stemmer.js b/sphinx/search/minified-js/arabic-stemmer.js new file mode 100644 index 00000000000..c8e178a75b4 --- /dev/null +++ b/sphinx/search/minified-js/arabic-stemmer.js @@ -0,0 +1 @@ +var ArabicStemmer=function(){var o=new BaseStemmer,l=[["ـ",-1,1],["ً",-1,1],["ٌ",-1,1],["ٍ",-1,1],["َ",-1,1],["ُ",-1,1],["ِ",-1,1],["ّ",-1,1],["ْ",-1,1],["٠",-1,2],["١",-1,3],["٢",-1,4],["٣",-1,5],["٤",-1,6],["٥",-1,7],["٦",-1,8],["٧",-1,9],["٨",-1,10],["٩",-1,11],["ﺀ",-1,12],["ﺁ",-1,16],["ﺂ",-1,16],["ﺃ",-1,13],["ﺄ",-1,13],["ﺅ",-1,17],["ﺆ",-1,17],["ﺇ",-1,14],["ﺈ",-1,14],["ﺉ",-1,15],["ﺊ",-1,15],["ﺋ",-1,15],["ﺌ",-1,15],["ﺍ",-1,18],["ﺎ",-1,18],["ﺏ",-1,19],["ﺐ",-1,19],["ﺑ",-1,19],["ﺒ",-1,19],["ﺓ",-1,20],["ﺔ",-1,20],["ﺕ",-1,21],["ﺖ",-1,21],["ﺗ",-1,21],["ﺘ",-1,21],["ﺙ",-1,22],["ﺚ",-1,22],["ﺛ",-1,22],["ﺜ",-1,22],["ﺝ",-1,23],["ﺞ",-1,23],["ﺟ",-1,23],["ﺠ",-1,23],["ﺡ",-1,24],["ﺢ",-1,24],["ﺣ",-1,24],["ﺤ",-1,24],["ﺥ",-1,25],["ﺦ",-1,25],["ﺧ",-1,25],["ﺨ",-1,25],["ﺩ",-1,26],["ﺪ",-1,26],["ﺫ",-1,27],["ﺬ",-1,27],["ﺭ",-1,28],["ﺮ",-1,28],["ﺯ",-1,29],["ﺰ",-1,29],["ﺱ",-1,30],["ﺲ",-1,30],["ﺳ",-1,30],["ﺴ",-1,30],["ﺵ",-1,31],["ﺶ",-1,31],["ﺷ",-1,31],["ﺸ",-1,31],["ﺹ",-1,32],["ﺺ",-1,32],["ﺻ",-1,32],["ﺼ",-1,32],["ﺽ",-1,33],["ﺾ",-1,33],["ﺿ",-1,33],["ﻀ",-1,33],["ﻁ",-1,34],["ﻂ",-1,34],["ﻃ",-1,34],["ﻄ",-1,34],["ﻅ",-1,35],["ﻆ",-1,35],["ﻇ",-1,35],["ﻈ",-1,35],["ﻉ",-1,36],["ﻊ",-1,36],["ﻋ",-1,36],["ﻌ",-1,36],["ﻍ",-1,37],["ﻎ",-1,37],["ﻏ",-1,37],["ﻐ",-1,37],["ﻑ",-1,38],["ﻒ",-1,38],["ﻓ",-1,38],["ﻔ",-1,38],["ﻕ",-1,39],["ﻖ",-1,39],["ﻗ",-1,39],["ﻘ",-1,39],["ﻙ",-1,40],["ﻚ",-1,40],["ﻛ",-1,40],["ﻜ",-1,40],["ﻝ",-1,41],["ﻞ",-1,41],["ﻟ",-1,41],["ﻠ",-1,41],["ﻡ",-1,42],["ﻢ",-1,42],["ﻣ",-1,42],["ﻤ",-1,42],["ﻥ",-1,43],["ﻦ",-1,43],["ﻧ",-1,43],["ﻨ",-1,43],["ﻩ",-1,44],["ﻪ",-1,44],["ﻫ",-1,44],["ﻬ",-1,44],["ﻭ",-1,45],["ﻮ",-1,45],["ﻯ",-1,46],["ﻰ",-1,46],["ﻱ",-1,47],["ﻲ",-1,47],["ﻳ",-1,47],["ﻴ",-1,47],["ﻵ",-1,51],["ﻶ",-1,51],["ﻷ",-1,49],["ﻸ",-1,49],["ﻹ",-1,50],["ﻺ",-1,50],["ﻻ",-1,48],["ﻼ",-1,48]],b=[["آ",-1,1],["أ",-1,1],["ؤ",-1,1],["إ",-1,1],["ئ",-1,1]],m=[["آ",-1,1],["أ",-1,1],["ؤ",-1,2],["إ",-1,1],["ئ",-1,3]],_=[["ال",-1,2],["بال",-1,1],["كال",-1,1],["لل",-1,2]],k=[["أآ",-1,2],["أأ",-1,1],["أؤ",-1,1],["أإ",-1,4],["أا",-1,3]],g=[["ف",-1,1],["و",-1,1]],d=[["ال",-1,2],["بال",-1,1],["كال",-1,1],["لل",-1,2]],h=[["ب",-1,1],["با",0,-1],["بب",0,2],["كك",-1,3]],v=[["سأ",-1,4],["ست",-1,2],["سن",-1,3],["سي",-1,1]],w=[["تست",-1,1],["نست",-1,1],["يست",-1,1]],C=[["كما",-1,3],["هما",-1,3],["نا",-1,2],["ها",-1,2],["ك",-1,1],["كم",-1,2],["هم",-1,2],["هن",-1,2],["ه",-1,1],["ي",-1,1]],S=[["ن",-1,1]],r=[["ا",-1,1],["و",-1,1],["ي",-1,1]],e=[["ات",-1,1]],i=[["ت",-1,1]],q=[["ة",-1,1]],A=[["ي",-1,1]],B=[["كما",-1,3],["هما",-1,3],["نا",-1,2],["ها",-1,2],["ك",-1,1],["كم",-1,2],["هم",-1,2],["كن",-1,2],["هن",-1,2],["ه",-1,1],["كمو",-1,3],["ني",-1,2]],c=[["ا",-1,1],["تا",0,2],["تما",0,4],["نا",0,2],["ت",-1,1],["ن",-1,1],["ان",5,3],["تن",5,2],["ون",5,3],["ين",5,3],["ي",-1,1]],W=[["وا",-1,1],["تم",-1,1]],j=[["و",-1,1],["تمو",0,2]],p=[["ى",-1,1]],x=!1,y=!1,z=!1;function D(){return o.ket=o.cursor,0!=o.find_among_b(r)&&(o.bra=o.cursor,!(o.current.length<=4||!o.slice_del()))}function E(){return o.ket=o.cursor,0!=o.find_among_b(e)&&(o.bra=o.cursor,!(o.current.length<5||!o.slice_del()))}function F(){return o.ket=o.cursor,0!=o.find_among_b(i)&&(o.bra=o.cursor,!(o.current.length<4||!o.slice_del()))}function G(){var r;if(o.ket=o.cursor,0!=(r=o.find_among_b(c))){switch(o.bra=o.cursor,r){case 1:if(o.current.length<4)return;if(o.slice_del())break;return;case 2:if(o.current.length<5)return;if(o.slice_del())break;return;case 3:if(o.current.length<=5)return;if(o.slice_del())break;return;case 4:if(o.current.length<6)return;if(o.slice_del())break;return}return 1}}this.stem=function(){x=!(y=z=!0);var r=o.cursor,r=((()=>{var r;if(o.bra=o.cursor,0!=(r=o.find_among(_)))switch(o.ket=o.cursor,r){case 1:if(o.current.length<=4)return;x=!(y=!(z=!0));break;case 2:if(o.current.length<=3)return;x=!(y=!(z=!0))}})(),o.cursor=r,(()=>{for(var r,e=o.cursor;;){var i=o.cursor;r:{var c=o.cursor;if(o.bra=o.cursor,0!=(r=o.find_among(l)))switch(o.ket=o.cursor,r){case 1:if(o.slice_del())break;return;case 2:if(o.slice_from("0"))break;return;case 3:if(o.slice_from("1"))break;return;case 4:if(o.slice_from("2"))break;return;case 5:if(o.slice_from("3"))break;return;case 6:if(o.slice_from("4"))break;return;case 7:if(o.slice_from("5"))break;return;case 8:if(o.slice_from("6"))break;return;case 9:if(o.slice_from("7"))break;return;case 10:if(o.slice_from("8"))break;return;case 11:if(o.slice_from("9"))break;return;case 12:if(o.slice_from("ء"))break;return;case 13:if(o.slice_from("أ"))break;return;case 14:if(o.slice_from("إ"))break;return;case 15:if(o.slice_from("ئ"))break;return;case 16:if(o.slice_from("آ"))break;return;case 17:if(o.slice_from("ؤ"))break;return;case 18:if(o.slice_from("ا"))break;return;case 19:if(o.slice_from("ب"))break;return;case 20:if(o.slice_from("ة"))break;return;case 21:if(o.slice_from("ت"))break;return;case 22:if(o.slice_from("ث"))break;return;case 23:if(o.slice_from("ج"))break;return;case 24:if(o.slice_from("ح"))break;return;case 25:if(o.slice_from("خ"))break;return;case 26:if(o.slice_from("د"))break;return;case 27:if(o.slice_from("ذ"))break;return;case 28:if(o.slice_from("ر"))break;return;case 29:if(o.slice_from("ز"))break;return;case 30:if(o.slice_from("س"))break;return;case 31:if(o.slice_from("ش"))break;return;case 32:if(o.slice_from("ص"))break;return;case 33:if(o.slice_from("ض"))break;return;case 34:if(o.slice_from("ط"))break;return;case 35:if(o.slice_from("ظ"))break;return;case 36:if(o.slice_from("ع"))break;return;case 37:if(o.slice_from("غ"))break;return;case 38:if(o.slice_from("ف"))break;return;case 39:if(o.slice_from("ق"))break;return;case 40:if(o.slice_from("ك"))break;return;case 41:if(o.slice_from("ل"))break;return;case 42:if(o.slice_from("م"))break;return;case 43:if(o.slice_from("ن"))break;return;case 44:if(o.slice_from("ه"))break;return;case 45:if(o.slice_from("و"))break;return;case 46:if(o.slice_from("ى"))break;return;case 47:if(o.slice_from("ي"))break;return;case 48:if(o.slice_from("لا"))break;return;case 49:if(o.slice_from("لأ"))break;return;case 50:if(o.slice_from("لإ"))break;return;case 51:if(o.slice_from("لآ"))break;return}else{if(o.cursor=c,o.cursor>=o.limit)break r;o.cursor++}continue}o.cursor=i;break}o.cursor=e})(),o.limit_backward=o.cursor,o.cursor=o.limit,o.limit-o.cursor);r:e:{var e=o.limit-o.cursor;i:if(y){c:{var i=o.limit-o.cursor;s:{for(var c=1;;){var s=o.limit-o.cursor;if(!(()=>{var r;if(o.ket=o.cursor,0!=(r=o.find_among_b(B))){switch(o.bra=o.cursor,r){case 1:if(o.current.length<4)return;if(o.slice_del())break;return;case 2:if(o.current.length<5)return;if(o.slice_del())break;return;case 3:if(o.current.length<6)return;if(o.slice_del())break;return}return 1}})()){o.cursor=o.limit-s;break}c--}if(!(0{var r;if(o.ket=o.cursor,0!=(r=o.find_among_b(j))){switch(o.bra=o.cursor,r){case 1:if(o.current.length<4)return;if(o.slice_del())break;return;case 2:if(o.current.length<6)return;if(o.slice_del())break;return}return 1}})())){if(o.cursor=o.limit-t,o.cursor<=o.limit_backward)break s;o.cursor--}break c}}if(o.cursor=o.limit-i,(o.ket=o.cursor,0==o.find_among_b(W)||(o.bra=o.cursor,o.current.length<5)||!o.slice_del())&&(o.cursor=o.limit-i,!G()))break i}break e}if(o.cursor=o.limit-e,z){var u=o.limit-o.cursor;i:c:{var a=o.limit-o.cursor;if(o.ket=o.cursor,0==o.find_among_b(q)||(o.bra=o.cursor,o.current.length<4)||!o.slice_del()){o.cursor=o.limit-a;s:if(!x&&(()=>{var r;if(o.ket=o.cursor,0!=(r=o.find_among_b(C))){switch(o.bra=o.cursor,r){case 1:if(o.current.length<4)return;if(o.slice_del())break;return;case 2:if(o.current.length<5)return;if(o.slice_del())break;return;case 3:if(o.current.length<6)return;if(o.slice_del())break;return}return 1}})()){var n=o.limit-o.cursor;if(!D()&&(o.cursor=o.limit-n,!E())&&(o.cursor=o.limit-n,!F())){if(o.cursor=o.limit-n,o.cursor<=o.limit_backward)break s;o.cursor--}break c}if(o.cursor=o.limit-a,o.ket=o.cursor,!(0==o.find_among_b(S)||(o.bra=o.cursor,o.current.length<=5))&&o.slice_del()){n=o.limit-o.cursor;if(D()||(o.cursor=o.limit-n,E())||(o.cursor=o.limit-n,F()))break c}if(o.cursor=o.limit-a,(x||!D())&&(o.cursor=o.limit-a,!E())){o.cursor=o.limit-u;break i}}}if(o.ket=o.cursor,!(0==o.find_among_b(A)||(o.bra=o.cursor,o.current.length<3))&&o.slice_del())break e}if(o.cursor=o.limit-e,o.ket=o.cursor,0==o.find_among_b(p)||(o.bra=o.cursor,!o.slice_from("ي")))break r}o.cursor=o.limit-r,o.cursor=o.limit_backward;r=o.cursor;r:{var f=o.cursor,f=((()=>{var r;if(o.bra=o.cursor,0!=(r=o.find_among(k))){switch(o.ket=o.cursor,r){case 1:if(o.current.length<=3)return;if(o.slice_from("أ"))break;return;case 2:if(o.current.length<=3)return;if(o.slice_from("آ"))break;return;case 3:if(o.current.length<=3)return;if(o.slice_from("ا"))break;return;case 4:if(o.current.length<=3)return;if(o.slice_from("إ"))break;return}return 1}})()||(o.cursor=f),o.cursor),f=((()=>{var r;return o.bra=o.cursor,0==o.find_among(g)||(o.ket=o.cursor,o.current.length<=3)||(r=o.cursor,o.eq_s("ا"))?void 0:(o.cursor=r,!!o.slice_del())})()||(o.cursor=f),o.cursor);if(!(()=>{var r;if(o.bra=o.cursor,0!=(r=o.find_among(d))){switch(o.ket=o.cursor,r){case 1:if(o.current.length<=5)return;if(o.slice_del())break;return;case 2:if(o.current.length<=4)return;if(o.slice_del())break;return}return 1}})()&&(o.cursor=f,!z||!(()=>{var r;if(o.bra=o.cursor,0!=(r=o.find_among(h))){switch(o.ket=o.cursor,r){case 1:if(o.current.length<=3)return;if(o.slice_del())break;return;case 2:if(o.current.length<=3)return;if(o.slice_from("ب"))break;return;case 3:if(o.current.length<=3)return;if(o.slice_from("ك"))break;return}return 1}})())){if(o.cursor=f,!y)break r;f=o.cursor;if((()=>{var r;if(o.bra=o.cursor,0!=(r=o.find_among(v))){switch(o.ket=o.cursor,r){case 1:if(o.current.length<=4)return;if(o.slice_from("ي"))break;return;case 2:if(o.current.length<=4)return;if(o.slice_from("ت"))break;return;case 3:if(o.current.length<=4)return;if(o.slice_from("ن"))break;return;case 4:if(o.current.length<=4)return;if(o.slice_from("أ"))break;return}return 1}})()||(o.cursor=f),o.bra=o.cursor,0==o.find_among(w)||(o.ket=o.cursor,o.current.length<=4)||(z=!(y=!0),!o.slice_from("است")))break r}}return o.cursor=r,(()=>{var r,e=o.cursor;if(o.limit_backward=o.cursor,o.cursor=o.limit,o.ket=o.cursor,0!=o.find_among_b(b)){if(o.bra=o.cursor,!o.slice_from("ء"))return;o.cursor=o.limit_backward}for(o.cursor=e,e=o.cursor;;){var i=o.cursor;r:{var c=o.cursor;if(o.bra=o.cursor,0!=(r=o.find_among(m)))switch(o.ket=o.cursor,r){case 1:if(o.slice_from("ا"))break;return;case 2:if(o.slice_from("و"))break;return;case 3:if(o.slice_from("ي"))break;return}else{if(o.cursor=c,o.cursor>=o.limit)break r;o.cursor++}continue}o.cursor=i;break}o.cursor=e})(),!0},this.stemWord=function(r){return o.setCurrent(r),this.stem(),o.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/armenian-stemmer.js b/sphinx/search/minified-js/armenian-stemmer.js new file mode 100644 index 00000000000..6b5c33afba2 --- /dev/null +++ b/sphinx/search/minified-js/armenian-stemmer.js @@ -0,0 +1 @@ +var ArmenianStemmer=function(){var o=new BaseStemmer,u=[["րորդ",-1,1],["երորդ",0,1],["ալի",-1,1],["ակի",-1,1],["որակ",-1,1],["եղ",-1,1],["ական",-1,1],["արան",-1,1],["են",-1,1],["եկեն",8,1],["երեն",8,1],["որէն",-1,1],["ին",-1,1],["գին",12,1],["ովին",12,1],["լայն",-1,1],["վուն",-1,1],["պես",-1,1],["իվ",-1,1],["ատ",-1,1],["ավետ",-1,1],["կոտ",-1,1],["բար",-1,1]],c=[["ա",-1,1],["ացա",0,1],["եցա",0,1],["վե",-1,1],["ացրի",-1,1],["ացի",-1,1],["եցի",-1,1],["վեցի",6,1],["ալ",-1,1],["ըալ",8,1],["անալ",8,1],["ենալ",8,1],["ացնալ",8,1],["ել",-1,1],["ըել",13,1],["նել",13,1],["ցնել",15,1],["եցնել",16,1],["չել",13,1],["վել",13,1],["ացվել",19,1],["եցվել",19,1],["տել",13,1],["ատել",22,1],["ոտել",22,1],["կոտել",24,1],["ված",-1,1],["ում",-1,1],["վում",27,1],["ան",-1,1],["ցան",29,1],["ացան",30,1],["ացրին",-1,1],["ացին",-1,1],["եցին",-1,1],["վեցին",34,1],["ալիս",-1,1],["ելիս",-1,1],["ավ",-1,1],["ացավ",38,1],["եցավ",38,1],["ալով",-1,1],["ելով",-1,1],["ար",-1,1],["ացար",43,1],["եցար",43,1],["ացրիր",-1,1],["ացիր",-1,1],["եցիր",-1,1],["վեցիր",48,1],["աց",-1,1],["եց",-1,1],["ացրեց",51,1],["ալուց",-1,1],["ելուց",-1,1],["ալու",-1,1],["ելու",-1,1],["աք",-1,1],["ցաք",57,1],["ացաք",58,1],["ացրիք",-1,1],["ացիք",-1,1],["եցիք",-1,1],["վեցիք",62,1],["անք",-1,1],["ցանք",64,1],["ացանք",65,1],["ացրինք",-1,1],["ացինք",-1,1],["եցինք",-1,1],["վեցինք",69,1]],s=[["որդ",-1,1],["ույթ",-1,1],["ուհի",-1,1],["ցի",-1,1],["իլ",-1,1],["ակ",-1,1],["յակ",5,1],["անակ",5,1],["իկ",-1,1],["ուկ",-1,1],["ան",-1,1],["պան",10,1],["ստան",10,1],["արան",10,1],["եղէն",-1,1],["յուն",-1,1],["ություն",15,1],["ածո",-1,1],["իչ",-1,1],["ուս",-1,1],["ուստ",-1,1],["գար",-1,1],["վոր",-1,1],["ավոր",22,1],["ոց",-1,1],["անօց",-1,1],["ու",-1,1],["ք",-1,1],["չեք",27,1],["իք",27,1],["ալիք",29,1],["անիք",29,1],["վածք",27,1],["ույք",27,1],["ենք",27,1],["ոնք",27,1],["ունք",27,1],["մունք",36,1],["իչք",27,1],["արք",27,1]],r=[["սա",-1,1],["վա",-1,1],["ամբ",-1,1],["դ",-1,1],["անդ",3,1],["ությանդ",4,1],["վանդ",4,1],["ոջդ",3,1],["երդ",3,1],["ներդ",8,1],["ուդ",3,1],["ը",-1,1],["անը",11,1],["ությանը",12,1],["վանը",12,1],["ոջը",11,1],["երը",11,1],["ները",16,1],["ի",-1,1],["վի",18,1],["երի",18,1],["ների",20,1],["անում",-1,1],["երում",-1,1],["ներում",23,1],["ն",-1,1],["ան",25,1],["ության",26,1],["վան",26,1],["ին",25,1],["երին",29,1],["ներին",30,1],["ությանն",25,1],["երն",25,1],["ներն",33,1],["ուն",25,1],["ոջ",-1,1],["ությանս",-1,1],["վանս",-1,1],["ոջս",-1,1],["ով",-1,1],["անով",40,1],["վով",40,1],["երով",40,1],["ներով",43,1],["եր",-1,1],["ներ",45,1],["ց",-1,1],["ից",47,1],["վանից",48,1],["ոջից",48,1],["վից",48,1],["երից",48,1],["ներից",52,1],["ցից",48,1],["ոց",47,1],["ուց",47,1]],t=[209,4,128,0,18],n=0,e=0;function m(){o.ket=o.cursor,0!=o.find_among_b(r)&&(o.bra=o.cursor,n<=o.cursor)&&o.slice_del()}this.stem=function(){var r,i;return e=o.limit,n=o.limit,r=o.cursor,o.go_out_grouping(t,1377,1413)&&(o.cursor++,e=o.cursor,o.go_in_grouping(t,1377,1413))&&(o.cursor++,o.go_out_grouping(t,1377,1413))&&(o.cursor++,o.go_in_grouping(t,1377,1413))&&(o.cursor++,n=o.cursor),o.cursor=r,o.limit_backward=o.cursor,o.cursor=o.limit,!(o.cursor=this.limit)return false;var s=this.current.charCodeAt(this.cursor);if(s>i||s>>3]&1<<(s&7))==0)return false;this.cursor++;return true};this.in_grouping_b=function(r,t,i){if(this.cursor<=this.limit_backward)return false;var s=this.current.charCodeAt(this.cursor-1);if(s>i||s>>3]&1<<(s&7))==0)return false;this.cursor--;return true};this.out_grouping=function(r,t,i){if(this.cursor>=this.limit)return false;var s=this.current.charCodeAt(this.cursor);if(s>i||s>>3]&1<<(s&7))==0){this.cursor++;return true}return false};this.out_grouping_b=function(r,t,i){if(this.cursor<=this.limit_backward)return false;var s=this.current.charCodeAt(this.cursor-1);if(s>i||s>>3]&1<<(s&7))==0){this.cursor--;return true}return false};this.eq_s=function(r){if(this.limit-this.cursor>>1);var a=0;var f=h0)break;if(i==t)break;if(n)break;n=true}}do{var l=r[t];if(h>=l[0].length){this.cursor=s+l[0].length;if(l.length<4)return l[2];var v=l[3](this);this.cursor=s+l[0].length;if(v)return l[2]}t=l[1]}while(t>=0);return 0};this.find_among_b=function(r){var t=0;var i=r.length;var s=this.cursor;var e=this.limit_backward;var h=0;var u=0;var n=false;while(true){var c=t+(i-t>>1);var a=0;var f=h=0;o--){if(s-f==e){a=-1;break}a=this.current.charCodeAt(s-1-f)-l[0].charCodeAt(o);if(a!=0)break;f++}if(a<0){i=c;u=f}else{t=c;h=f}if(i-t<=1){if(t>0)break;if(i==t)break;if(n)break;n=true}}do{var l=r[t];if(h>=l[0].length){this.cursor=s-l[0].length;if(l.length<4)return l[2];var v=l[3](this);this.cursor=s-l[0].length;if(v)return l[2]}t=l[1]}while(t>=0);return 0};this.replace_s=function(r,t,i){var s=i.length-(t-r);this.current=this.current.slice(0,r)+i+this.current.slice(t);this.limit+=s;if(this.cursor>=t)this.cursor+=s;else if(this.cursor>r)this.cursor=r;return s};this.slice_check=function(){if(this.bra<0||this.bra>this.ket||this.ket>this.limit||this.limit>this.current.length){return false}return true};this.slice_from=function(r){var t=false;if(this.slice_check()){this.replace_s(this.bra,this.ket,r);t=true}return t};this.slice_del=function(){return this.slice_from("")};this.insert=function(r,t,i){var s=this.replace_s(r,t,i);if(r<=this.bra)this.bra+=s;if(r<=this.ket)this.ket+=s};this.slice_to=function(){var r="";if(this.slice_check()){r=this.current.slice(this.bra,this.ket)}return r};this.assign_to=function(){return this.current.slice(0,this.limit)}}; \ No newline at end of file +BaseStemmer=function(){this.current="",this.cursor=0,this.limit=0,this.limit_backward=0,this.bra=0,this.ket=0,this.setCurrent=function(t){this.current=t,this.cursor=0,this.limit=this.current.length,this.limit_backward=0,this.bra=this.cursor,this.ket=this.limit},this.getCurrent=function(){return this.current},this.copy_from=function(t){this.current=t.current,this.cursor=t.cursor,this.limit=t.limit,this.limit_backward=t.limit_backward,this.bra=t.bra,this.ket=t.ket},this.in_grouping=function(t,r,i){return!(this.cursor>=this.limit||i<(i=this.current.charCodeAt(this.cursor))||i>>3]&1<<(7&i))||(this.cursor++,0))},this.go_in_grouping=function(t,r,i){for(;this.cursor>>3]&1<<(7&s)))return!0;this.cursor++}return!1},this.in_grouping_b=function(t,r,i){return!(this.cursor<=this.limit_backward||i<(i=this.current.charCodeAt(this.cursor-1))||i>>3]&1<<(7&i))||(this.cursor--,0))},this.go_in_grouping_b=function(t,r,i){for(;this.cursor>this.limit_backward;){var s=this.current.charCodeAt(this.cursor-1);if(i>>3]&1<<(7&s)))return!0;this.cursor--}return!1},this.out_grouping=function(t,r,i){return!(this.cursor>=this.limit)&&(i<(i=this.current.charCodeAt(this.cursor))||i>>3]&1<<(7&i)))&&(this.cursor++,!0)},this.go_out_grouping=function(t,r,i){for(;this.cursor>>3]&1<<(7&s)))return!0;this.cursor++}return!1},this.out_grouping_b=function(t,r,i){return!(this.cursor<=this.limit_backward)&&(i<(i=this.current.charCodeAt(this.cursor-1))||i>>3]&1<<(7&i)))&&(this.cursor--,!0)},this.go_out_grouping_b=function(t,r,i){for(;this.cursor>this.limit_backward;){var s=this.current.charCodeAt(this.cursor-1);if(s<=i&&r<=s&&0!=(t[(s-=r)>>>3]&1<<(7&s)))return!0;this.cursor--}return!1},this.eq_s=function(t){return!(this.limit-this.cursor>>1),o=0,a=e=(l=t[r])[0].length){if(this.cursor=s+l[0].length,l.length<4)return l[2];var g=l[3](this);if(this.cursor=s+l[0].length,g)return l[2]}}while(0<=(r=l[1]));return 0},this.find_among_b=function(t){for(var r=0,i=t.length,s=this.cursor,h=this.limit_backward,e=0,n=0,c=!1;;){for(var u,o=r+(i-r>>1),a=0,l=e=(u=t[r])[0].length){if(this.cursor=s-u[0].length,u.length<4)return u[2];var g=u[3](this);if(this.cursor=s-u[0].length,g)return u[2]}}while(0<=(r=u[1]));return 0},this.replace_s=function(t,r,i){var s=i.length-(r-t);return this.current=this.current.slice(0,t)+i+this.current.slice(r),this.limit+=s,this.cursor>=r?this.cursor+=s:this.cursor>t&&(this.cursor=t),s},this.slice_check=function(){return!(this.bra<0||this.bra>this.ket||this.ket>this.limit||this.limit>this.current.length)},this.slice_from=function(t){var r=!1;return this.slice_check()&&(this.replace_s(this.bra,this.ket,t),r=!0),r},this.slice_del=function(){return this.slice_from("")},this.insert=function(t,r,i){r=this.replace_s(t,r,i);t<=this.bra&&(this.bra+=r),t<=this.ket&&(this.ket+=r)},this.slice_to=function(){var t="";return t=this.slice_check()?this.current.slice(this.bra,this.ket):t},this.assign_to=function(){return this.current.slice(0,this.limit)}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/basque-stemmer.js b/sphinx/search/minified-js/basque-stemmer.js new file mode 100644 index 00000000000..3e1c4337a69 --- /dev/null +++ b/sphinx/search/minified-js/basque-stemmer.js @@ -0,0 +1 @@ +var BasqueStemmer=function(){var o=new BaseStemmer,u=[["idea",-1,1],["bidea",0,1],["kidea",0,1],["pidea",0,1],["kundea",-1,1],["galea",-1,1],["tailea",-1,1],["tzailea",-1,1],["gunea",-1,1],["kunea",-1,1],["tzaga",-1,1],["gaia",-1,1],["aldia",-1,1],["taldia",12,1],["karia",-1,1],["garria",-1,2],["karria",-1,1],["ka",-1,1],["tzaka",17,1],["la",-1,1],["mena",-1,1],["pena",-1,1],["kina",-1,1],["ezina",-1,1],["tezina",23,1],["kuna",-1,1],["tuna",-1,1],["kizuna",-1,1],["era",-1,1],["bera",28,1],["arabera",29,-1],["kera",28,1],["pera",28,1],["orra",-1,1],["korra",33,1],["dura",-1,1],["gura",-1,1],["kura",-1,1],["tura",-1,1],["eta",-1,1],["keta",39,1],["gailua",-1,1],["eza",-1,1],["erreza",42,1],["tza",-1,2],["gaitza",44,1],["kaitza",44,1],["kuntza",44,1],["ide",-1,1],["bide",48,1],["kide",48,1],["pide",48,1],["kunde",-1,1],["tzake",-1,1],["tzeke",-1,1],["le",-1,1],["gale",55,1],["taile",55,1],["tzaile",55,1],["gune",-1,1],["kune",-1,1],["tze",-1,1],["atze",61,1],["gai",-1,1],["aldi",-1,1],["taldi",64,1],["ki",-1,1],["ari",-1,1],["kari",67,1],["lari",67,1],["tari",67,1],["etari",70,1],["garri",-1,2],["karri",-1,1],["arazi",-1,1],["tarazi",74,1],["an",-1,1],["ean",76,1],["rean",77,1],["kan",76,1],["etan",76,1],["atseden",-1,-1],["men",-1,1],["pen",-1,1],["kin",-1,1],["rekin",84,1],["ezin",-1,1],["tezin",86,1],["tun",-1,1],["kizun",-1,1],["go",-1,1],["ago",90,1],["tio",-1,1],["dako",-1,1],["or",-1,1],["kor",94,1],["tzat",-1,1],["du",-1,1],["gailu",-1,1],["tu",-1,1],["atu",99,1],["aldatu",100,1],["tatu",100,1],["baditu",99,-1],["ez",-1,1],["errez",104,1],["tzez",104,1],["gaitz",-1,1],["kaitz",-1,1]],r=[["ada",-1,1],["kada",0,1],["anda",-1,1],["denda",-1,1],["gabea",-1,1],["kabea",-1,1],["aldea",-1,1],["kaldea",6,1],["taldea",6,1],["ordea",-1,1],["zalea",-1,1],["tzalea",10,1],["gilea",-1,1],["emea",-1,1],["kumea",-1,1],["nea",-1,1],["enea",15,1],["zionea",15,1],["unea",15,1],["gunea",18,1],["pea",-1,1],["aurrea",-1,1],["tea",-1,1],["kotea",22,1],["artea",22,1],["ostea",22,1],["etxea",-1,1],["ga",-1,1],["anga",27,1],["gaia",-1,1],["aldia",-1,1],["taldia",30,1],["handia",-1,1],["mendia",-1,1],["geia",-1,1],["egia",-1,1],["degia",35,1],["tegia",35,1],["nahia",-1,1],["ohia",-1,1],["kia",-1,1],["tokia",40,1],["oia",-1,1],["koia",42,1],["aria",-1,1],["karia",44,1],["laria",44,1],["taria",44,1],["eria",-1,1],["keria",48,1],["teria",48,1],["garria",-1,2],["larria",-1,1],["kirria",-1,1],["duria",-1,1],["asia",-1,1],["tia",-1,1],["ezia",-1,1],["bizia",-1,1],["ontzia",-1,1],["ka",-1,1],["joka",60,3],["aurka",60,-1],["ska",60,1],["xka",60,1],["zka",60,1],["gibela",-1,1],["gela",-1,1],["kaila",-1,1],["skila",-1,1],["tila",-1,1],["ola",-1,1],["na",-1,1],["kana",72,1],["ena",72,1],["garrena",74,1],["gerrena",74,1],["urrena",74,1],["zaina",72,1],["tzaina",78,1],["kina",72,1],["mina",72,1],["garna",72,1],["una",72,1],["duna",83,1],["asuna",83,1],["tasuna",85,1],["ondoa",-1,1],["kondoa",87,1],["ngoa",-1,1],["zioa",-1,1],["koa",-1,1],["takoa",91,1],["zkoa",91,1],["noa",-1,1],["zinoa",94,1],["aroa",-1,1],["taroa",96,1],["zaroa",96,1],["eroa",-1,1],["oroa",-1,1],["osoa",-1,1],["toa",-1,1],["ttoa",102,1],["ztoa",102,1],["txoa",-1,1],["tzoa",-1,1],["ñoa",-1,1],["ra",-1,1],["ara",108,1],["dara",109,1],["liara",109,1],["tiara",109,1],["tara",109,1],["etara",113,1],["tzara",109,1],["bera",108,1],["kera",108,1],["pera",108,1],["ora",108,2],["tzarra",108,1],["korra",108,1],["tra",108,1],["sa",-1,1],["osa",123,1],["ta",-1,1],["eta",125,1],["keta",126,1],["sta",125,1],["dua",-1,1],["mendua",129,1],["ordua",129,1],["lekua",-1,1],["burua",-1,1],["durua",-1,1],["tsua",-1,1],["tua",-1,1],["mentua",136,1],["estua",136,1],["txua",-1,1],["zua",-1,1],["tzua",140,1],["za",-1,1],["eza",142,1],["eroza",142,1],["tza",142,2],["koitza",145,1],["antza",145,1],["gintza",145,1],["kintza",145,1],["kuntza",145,1],["gabe",-1,1],["kabe",-1,1],["kide",-1,1],["alde",-1,1],["kalde",154,1],["talde",154,1],["orde",-1,1],["ge",-1,1],["zale",-1,1],["tzale",159,1],["gile",-1,1],["eme",-1,1],["kume",-1,1],["ne",-1,1],["zione",164,1],["une",164,1],["gune",166,1],["pe",-1,1],["aurre",-1,1],["te",-1,1],["kote",170,1],["arte",170,1],["oste",170,1],["etxe",-1,1],["gai",-1,1],["di",-1,1],["aldi",176,1],["taldi",177,1],["geldi",176,-1],["handi",176,1],["mendi",176,1],["gei",-1,1],["egi",-1,1],["degi",183,1],["tegi",183,1],["nahi",-1,1],["ohi",-1,1],["ki",-1,1],["toki",188,1],["oi",-1,1],["goi",190,1],["koi",190,1],["ari",-1,1],["kari",193,1],["lari",193,1],["tari",193,1],["garri",-1,2],["larri",-1,1],["kirri",-1,1],["duri",-1,1],["asi",-1,1],["ti",-1,1],["ontzi",-1,1],["ñi",-1,1],["ak",-1,1],["ek",-1,1],["tarik",-1,1],["gibel",-1,1],["ail",-1,1],["kail",209,1],["kan",-1,1],["tan",-1,1],["etan",212,1],["en",-1,4],["ren",214,2],["garren",215,1],["gerren",215,1],["urren",215,1],["ten",214,4],["tzen",214,4],["zain",-1,1],["tzain",221,1],["kin",-1,1],["min",-1,1],["dun",-1,1],["asun",-1,1],["tasun",226,1],["aizun",-1,1],["ondo",-1,1],["kondo",229,1],["go",-1,1],["ngo",231,1],["zio",-1,1],["ko",-1,1],["trako",234,5],["tako",234,1],["etako",236,1],["eko",234,1],["tariko",234,1],["sko",234,1],["tuko",234,1],["minutuko",241,6],["zko",234,1],["no",-1,1],["zino",244,1],["ro",-1,1],["aro",246,1],["igaro",247,-1],["taro",247,1],["zaro",247,1],["ero",246,1],["giro",246,1],["oro",246,1],["oso",-1,1],["to",-1,1],["tto",255,1],["zto",255,1],["txo",-1,1],["tzo",-1,1],["gintzo",259,1],["ño",-1,1],["zp",-1,1],["ar",-1,1],["dar",263,1],["behar",263,1],["zehar",263,-1],["liar",263,1],["tiar",263,1],["tar",263,1],["tzar",263,1],["or",-1,2],["kor",271,1],["os",-1,1],["ket",-1,1],["du",-1,1],["mendu",275,1],["ordu",275,1],["leku",-1,1],["buru",-1,2],["duru",-1,1],["tsu",-1,1],["tu",-1,1],["tatu",282,4],["mentu",282,1],["estu",282,1],["txu",-1,1],["zu",-1,1],["tzu",287,1],["gintzu",288,1],["z",-1,1],["ez",290,1],["eroz",290,1],["tz",290,1],["koitz",293,1]],n=[["zlea",-1,2],["keria",-1,1],["la",-1,1],["era",-1,1],["dade",-1,1],["tade",-1,1],["date",-1,1],["tate",-1,1],["gi",-1,1],["ki",-1,1],["ik",-1,1],["lanik",10,1],["rik",10,1],["larik",12,1],["ztik",10,1],["go",-1,1],["ro",-1,1],["ero",16,1],["to",-1,1]],k=[17,65,16],g=0,s=0,z=0;function l(){return z<=o.cursor}function d(){return g<=o.cursor}function c(){var a;if(o.ket=o.cursor,0!=(a=o.find_among_b(r))){switch(o.bra=o.cursor,a){case 1:if(!l())return;if(o.slice_del())break;return;case 2:if(!d())return;if(o.slice_del())break;return;case 3:if(o.slice_from("jok"))break;return;case 4:if(!(s<=o.cursor))return;if(o.slice_del())break;return;case 5:if(o.slice_from("tra"))break;return;case 6:if(o.slice_from("minutu"))break;return}return 1}}this.stem=function(){z=o.limit,s=o.limit,g=o.limit;var a=o.cursor;a:{r:{var r=o.cursor;i:if(o.in_grouping(k,97,117)){var i=o.cursor;if(!o.out_grouping(k,97,117)||!o.go_out_grouping(k,97,117)){if(o.cursor=i,!o.in_grouping(k,97,117))break i;if(!o.go_in_grouping(k,97,117))break i}o.cursor++;break r}if(o.cursor=r,!o.out_grouping(k,97,117))break a;i=o.cursor;if(o.out_grouping(k,97,117)&&o.go_out_grouping(k,97,117));else{if(o.cursor=i,!o.in_grouping(k,97,117))break a;if(o.cursor>=o.limit)break a}o.cursor++}z=o.cursor}for(o.cursor=a,a=o.cursor,o.go_out_grouping(k,97,117)&&(o.cursor++,o.go_in_grouping(k,97,117))&&(o.cursor++,s=o.cursor,o.go_out_grouping(k,97,117))&&(o.cursor++,o.go_in_grouping(k,97,117))&&(o.cursor++,g=o.cursor),o.cursor=a,o.limit_backward=o.cursor,o.cursor=o.limit;;){var e=o.limit-o.cursor;if(!(()=>{var a;if(o.ket=o.cursor,0!=(a=o.find_among_b(u))){switch(o.bra=o.cursor,a){case 1:if(!l())return;if(o.slice_del())break;return;case 2:if(!d())return;if(o.slice_del())break;return}return 1}})()){o.cursor=o.limit-e;break}}for(;;){var t=o.limit-o.cursor;if(!c()){o.cursor=o.limit-t;break}}a=o.limit-o.cursor;return(()=>{var a;if(o.ket=o.cursor,0!=(a=o.find_among_b(n)))switch(o.bra=o.cursor,a){case 1:if(!l())return;if(o.slice_del())break;return;case 2:if(o.slice_from("z"))break}})(),o.cursor=o.limit-a,o.cursor=o.limit_backward,!0},this.stemWord=function(a){return o.setCurrent(a),this.stem(),o.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/catalan-stemmer.js b/sphinx/search/minified-js/catalan-stemmer.js new file mode 100644 index 00000000000..75788216aa1 --- /dev/null +++ b/sphinx/search/minified-js/catalan-stemmer.js @@ -0,0 +1 @@ +var CatalanStemmer=function(){var e=new BaseStemmer,r=[["",-1,7],["·",0,6],["à",0,1],["á",0,1],["è",0,2],["é",0,2],["ì",0,3],["í",0,3],["ï",0,3],["ò",0,4],["ó",0,4],["ú",0,5],["ü",0,5]],a=[["la",-1,1],["-la",0,1],["sela",0,1],["le",-1,1],["me",-1,1],["-me",4,1],["se",-1,1],["-te",-1,1],["hi",-1,1],["'hi",8,1],["li",-1,1],["-li",10,1],["'l",-1,1],["'m",-1,1],["-m",-1,1],["'n",-1,1],["-n",-1,1],["ho",-1,1],["'ho",17,1],["lo",-1,1],["selo",19,1],["'s",-1,1],["las",-1,1],["selas",22,1],["les",-1,1],["-les",24,1],["'ls",-1,1],["-ls",-1,1],["'ns",-1,1],["-ns",-1,1],["ens",-1,1],["los",-1,1],["selos",31,1],["nos",-1,1],["-nos",33,1],["vos",-1,1],["us",-1,1],["-us",36,1],["'t",-1,1]],t=[["ica",-1,4],["lógica",0,3],["enca",-1,1],["ada",-1,2],["ancia",-1,1],["encia",-1,1],["ència",-1,1],["ícia",-1,1],["logia",-1,3],["inia",-1,1],["íinia",9,1],["eria",-1,1],["ària",-1,1],["atòria",-1,1],["alla",-1,1],["ella",-1,1],["ívola",-1,1],["ima",-1,1],["íssima",17,1],["quíssima",18,5],["ana",-1,1],["ina",-1,1],["era",-1,1],["sfera",22,1],["ora",-1,1],["dora",24,1],["adora",25,1],["adura",-1,1],["esa",-1,1],["osa",-1,1],["assa",-1,1],["essa",-1,1],["issa",-1,1],["eta",-1,1],["ita",-1,1],["ota",-1,1],["ista",-1,1],["ialista",36,1],["ionista",36,1],["iva",-1,1],["ativa",39,1],["nça",-1,1],["logía",-1,3],["ic",-1,4],["ístic",43,1],["enc",-1,1],["esc",-1,1],["ud",-1,1],["atge",-1,1],["ble",-1,1],["able",49,1],["ible",49,1],["isme",-1,1],["ialisme",52,1],["ionisme",52,1],["ivisme",52,1],["aire",-1,1],["icte",-1,1],["iste",-1,1],["ici",-1,1],["íci",-1,1],["logi",-1,3],["ari",-1,1],["tori",-1,1],["al",-1,1],["il",-1,1],["all",-1,1],["ell",-1,1],["ívol",-1,1],["isam",-1,1],["issem",-1,1],["ìssem",-1,1],["íssem",-1,1],["íssim",-1,1],["quíssim",73,5],["amen",-1,1],["ìssin",-1,1],["ar",-1,1],["ificar",77,1],["egar",77,1],["ejar",77,1],["itar",77,1],["itzar",77,1],["fer",-1,1],["or",-1,1],["dor",84,1],["dur",-1,1],["doras",-1,1],["ics",-1,4],["lógics",88,3],["uds",-1,1],["nces",-1,1],["ades",-1,2],["ancies",-1,1],["encies",-1,1],["ències",-1,1],["ícies",-1,1],["logies",-1,3],["inies",-1,1],["ínies",-1,1],["eries",-1,1],["àries",-1,1],["atòries",-1,1],["bles",-1,1],["ables",103,1],["ibles",103,1],["imes",-1,1],["íssimes",106,1],["quíssimes",107,5],["formes",-1,1],["ismes",-1,1],["ialismes",110,1],["ines",-1,1],["eres",-1,1],["ores",-1,1],["dores",114,1],["idores",115,1],["dures",-1,1],["eses",-1,1],["oses",-1,1],["asses",-1,1],["ictes",-1,1],["ites",-1,1],["otes",-1,1],["istes",-1,1],["ialistes",124,1],["ionistes",124,1],["iques",-1,4],["lógiques",127,3],["ives",-1,1],["atives",129,1],["logíes",-1,3],["allengües",-1,1],["icis",-1,1],["ícis",-1,1],["logis",-1,3],["aris",-1,1],["toris",-1,1],["ls",-1,1],["als",138,1],["ells",138,1],["ims",-1,1],["íssims",141,1],["quíssims",142,5],["ions",-1,1],["cions",144,1],["acions",145,2],["esos",-1,1],["osos",-1,1],["assos",-1,1],["issos",-1,1],["ers",-1,1],["ors",-1,1],["dors",152,1],["adors",153,1],["idors",153,1],["ats",-1,1],["itats",156,1],["bilitats",157,1],["ivitats",157,1],["ativitats",159,1],["ïtats",156,1],["ets",-1,1],["ants",-1,1],["ents",-1,1],["ments",164,1],["aments",165,1],["ots",-1,1],["uts",-1,1],["ius",-1,1],["trius",169,1],["atius",169,1],["ès",-1,1],["és",-1,1],["ís",-1,1],["dís",174,1],["ós",-1,1],["itat",-1,1],["bilitat",177,1],["ivitat",177,1],["ativitat",179,1],["ïtat",-1,1],["et",-1,1],["ant",-1,1],["ent",-1,1],["ient",184,1],["ment",184,1],["ament",186,1],["isament",187,1],["ot",-1,1],["isseu",-1,1],["ìsseu",-1,1],["ísseu",-1,1],["triu",-1,1],["íssiu",-1,1],["atiu",-1,1],["ó",-1,1],["ió",196,1],["ció",197,1],["ació",198,1]],n=[["aba",-1,1],["esca",-1,1],["isca",-1,1],["ïsca",-1,1],["ada",-1,1],["ida",-1,1],["uda",-1,1],["ïda",-1,1],["ia",-1,1],["aria",8,1],["iria",8,1],["ara",-1,1],["iera",-1,1],["ira",-1,1],["adora",-1,1],["ïra",-1,1],["ava",-1,1],["ixa",-1,1],["itza",-1,1],["ía",-1,1],["aría",19,1],["ería",19,1],["iría",19,1],["ïa",-1,1],["isc",-1,1],["ïsc",-1,1],["ad",-1,1],["ed",-1,1],["id",-1,1],["ie",-1,1],["re",-1,1],["dre",30,1],["ase",-1,1],["iese",-1,1],["aste",-1,1],["iste",-1,1],["ii",-1,1],["ini",-1,1],["esqui",-1,1],["eixi",-1,1],["itzi",-1,1],["am",-1,1],["em",-1,1],["arem",42,1],["irem",42,1],["àrem",42,1],["írem",42,1],["àssem",42,1],["éssem",42,1],["iguem",42,1],["ïguem",42,1],["avem",42,1],["àvem",42,1],["ávem",42,1],["irìem",42,1],["íem",42,1],["aríem",55,1],["iríem",55,1],["assim",-1,1],["essim",-1,1],["issim",-1,1],["àssim",-1,1],["èssim",-1,1],["éssim",-1,1],["íssim",-1,1],["ïm",-1,1],["an",-1,1],["aban",66,1],["arian",66,1],["aran",66,1],["ieran",66,1],["iran",66,1],["ían",66,1],["arían",72,1],["erían",72,1],["irían",72,1],["en",-1,1],["ien",76,1],["arien",77,1],["irien",77,1],["aren",76,1],["eren",76,1],["iren",76,1],["àren",76,1],["ïren",76,1],["asen",76,1],["iesen",76,1],["assen",76,1],["essen",76,1],["issen",76,1],["éssen",76,1],["ïssen",76,1],["esquen",76,1],["isquen",76,1],["ïsquen",76,1],["aven",76,1],["ixen",76,1],["eixen",96,1],["ïxen",76,1],["ïen",76,1],["in",-1,1],["inin",100,1],["sin",100,1],["isin",102,1],["assin",102,1],["essin",102,1],["issin",102,1],["ïssin",102,1],["esquin",100,1],["eixin",100,1],["aron",-1,1],["ieron",-1,1],["arán",-1,1],["erán",-1,1],["irán",-1,1],["iïn",-1,1],["ado",-1,1],["ido",-1,1],["ando",-1,2],["iendo",-1,1],["io",-1,1],["ixo",-1,1],["eixo",121,1],["ïxo",-1,1],["itzo",-1,1],["ar",-1,1],["tzar",125,1],["er",-1,1],["eixer",127,1],["ir",-1,1],["ador",-1,1],["as",-1,1],["abas",131,1],["adas",131,1],["idas",131,1],["aras",131,1],["ieras",131,1],["ías",131,1],["arías",137,1],["erías",137,1],["irías",137,1],["ids",-1,1],["es",-1,1],["ades",142,1],["ides",142,1],["udes",142,1],["ïdes",142,1],["atges",142,1],["ies",142,1],["aries",148,1],["iries",148,1],["ares",142,1],["ires",142,1],["adores",142,1],["ïres",142,1],["ases",142,1],["ieses",142,1],["asses",142,1],["esses",142,1],["isses",142,1],["ïsses",142,1],["ques",142,1],["esques",161,1],["ïsques",161,1],["aves",142,1],["ixes",142,1],["eixes",165,1],["ïxes",142,1],["ïes",142,1],["abais",-1,1],["arais",-1,1],["ierais",-1,1],["íais",-1,1],["aríais",172,1],["eríais",172,1],["iríais",172,1],["aseis",-1,1],["ieseis",-1,1],["asteis",-1,1],["isteis",-1,1],["inis",-1,1],["sis",-1,1],["isis",181,1],["assis",181,1],["essis",181,1],["issis",181,1],["ïssis",181,1],["esquis",-1,1],["eixis",-1,1],["itzis",-1,1],["áis",-1,1],["aréis",-1,1],["eréis",-1,1],["iréis",-1,1],["ams",-1,1],["ados",-1,1],["idos",-1,1],["amos",-1,1],["ábamos",197,1],["áramos",197,1],["iéramos",197,1],["íamos",197,1],["aríamos",201,1],["eríamos",201,1],["iríamos",201,1],["aremos",-1,1],["eremos",-1,1],["iremos",-1,1],["ásemos",-1,1],["iésemos",-1,1],["imos",-1,1],["adors",-1,1],["ass",-1,1],["erass",212,1],["ess",-1,1],["ats",-1,1],["its",-1,1],["ents",-1,1],["às",-1,1],["aràs",218,1],["iràs",218,1],["arás",-1,1],["erás",-1,1],["irás",-1,1],["és",-1,1],["arés",224,1],["ís",-1,1],["iïs",-1,1],["at",-1,1],["it",-1,1],["ant",-1,1],["ent",-1,1],["int",-1,1],["ut",-1,1],["ït",-1,1],["au",-1,1],["erau",235,1],["ieu",-1,1],["ineu",-1,1],["areu",-1,1],["ireu",-1,1],["àreu",-1,1],["íreu",-1,1],["asseu",-1,1],["esseu",-1,1],["eresseu",244,1],["àsseu",-1,1],["ésseu",-1,1],["igueu",-1,1],["ïgueu",-1,1],["àveu",-1,1],["áveu",-1,1],["itzeu",-1,1],["ìeu",-1,1],["irìeu",253,1],["íeu",-1,1],["aríeu",255,1],["iríeu",255,1],["assiu",-1,1],["issiu",-1,1],["àssiu",-1,1],["èssiu",-1,1],["éssiu",-1,1],["íssiu",-1,1],["ïu",-1,1],["ix",-1,1],["eix",265,1],["ïx",-1,1],["itz",-1,1],["ià",-1,1],["arà",-1,1],["irà",-1,1],["itzà",-1,1],["ará",-1,1],["erá",-1,1],["irá",-1,1],["irè",-1,1],["aré",-1,1],["eré",-1,1],["iré",-1,1],["í",-1,1],["iï",-1,1],["ió",-1,1]],o=[["a",-1,1],["e",-1,1],["i",-1,1],["ïn",-1,1],["o",-1,1],["ir",-1,1],["s",-1,1],["is",6,1],["os",6,1],["ïs",6,1],["it",-1,1],["eu",-1,1],["iu",-1,1],["iqu",-1,2],["itz",-1,1],["à",-1,1],["á",-1,1],["é",-1,1],["ì",-1,1],["í",-1,1],["ï",-1,1],["ó",-1,1]],u=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,128,129,81,6,10],c=0,m=0;function l(){return m<=e.cursor}function d(){return c<=e.cursor}this.stem=function(){m=e.limit,c=e.limit,s=e.cursor,e.go_out_grouping(u,97,252)&&(e.cursor++,e.go_in_grouping(u,97,252))&&(e.cursor++,m=e.cursor,e.go_out_grouping(u,97,252))&&(e.cursor++,e.go_in_grouping(u,97,252))&&(e.cursor++,c=e.cursor),e.cursor=s,e.limit_backward=e.cursor,e.cursor=e.limit;var s=e.limit-e.cursor,s=(e.ket=e.cursor,0!=e.find_among_b(a)&&(e.bra=e.cursor,l())&&e.slice_del(),e.cursor=e.limit-s,e.limit-e.cursor),i=e.limit-e.cursor,i=((()=>{var s;if(e.ket=e.cursor,0!=(s=e.find_among_b(t))){switch(e.bra=e.cursor,s){case 1:if(!l())return;if(e.slice_del())break;return;case 2:if(!d())return;if(e.slice_del())break;return;case 3:if(!d())return;if(e.slice_from("log"))break;return;case 4:if(!d())return;if(e.slice_from("ic"))break;return;case 5:if(!l())return;if(e.slice_from("c"))break;return}return 1}})()||(e.cursor=e.limit-i,(()=>{var s;if(e.ket=e.cursor,0!=(s=e.find_among_b(n))){switch(e.bra=e.cursor,s){case 1:if(!l())return;if(e.slice_del())break;return;case 2:if(!d())return;if(e.slice_del())break;return}}})()),e.cursor=e.limit-s,e.limit-e.cursor),s=((()=>{var s;if(e.ket=e.cursor,0!=(s=e.find_among_b(o)))switch(e.bra=e.cursor,s){case 1:if(!l())return;if(e.slice_del())break;return;case 2:if(!l())return;if(e.slice_from("ic"))break}})(),e.cursor=e.limit-i,e.cursor=e.limit_backward,e.cursor);return(()=>{for(var s;;){var i=e.cursor;s:{switch(e.bra=e.cursor,s=e.find_among(r),e.ket=e.cursor,s){case 1:if(e.slice_from("a"))break;return;case 2:if(e.slice_from("e"))break;return;case 3:if(e.slice_from("i"))break;return;case 4:if(e.slice_from("o"))break;return;case 5:if(e.slice_from("u"))break;return;case 6:if(e.slice_from("."))break;return;case 7:if(e.cursor>=e.limit)break s;e.cursor++}continue}e.cursor=i;break}})(),e.cursor=s,!0},this.stemWord=function(s){return e.setCurrent(s),this.stem(),e.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/danish-stemmer.js b/sphinx/search/minified-js/danish-stemmer.js index f3fc600033c..7a577f3eb26 100644 --- a/sphinx/search/minified-js/danish-stemmer.js +++ b/sphinx/search/minified-js/danish-stemmer.js @@ -1 +1 @@ -DanishStemmer=function(){var r=new BaseStemmer;var e=[["hed",-1,1],["ethed",0,1],["ered",-1,1],["e",-1,1],["erede",3,1],["ende",3,1],["erende",5,1],["ene",3,1],["erne",3,1],["ere",3,1],["en",-1,1],["heden",10,1],["eren",10,1],["er",-1,1],["heder",13,1],["erer",13,1],["s",-1,2],["heds",16,1],["es",16,1],["endes",18,1],["erendes",19,1],["enes",18,1],["ernes",18,1],["eres",18,1],["ens",16,1],["hedens",24,1],["erens",24,1],["ers",16,1],["ets",16,1],["erets",28,1],["et",-1,1],["eret",30,1]];var i=[["gd",-1,-1],["dt",-1,-1],["gt",-1,-1],["kt",-1,-1]];var s=[["ig",-1,1],["lig",0,1],["elig",1,1],["els",-1,1],["løst",-1,2]];var t=[119,223,119,1];var a=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128];var u=[239,254,42,3,0,0,0,0,0,0,0,0,0,0,0,0,16];var c=0;var l=0;var n="";function o(){l=r.limit;var e=r.cursor;{var i=r.cursor+3;if(i>r.limit){return false}r.cursor=i}c=r.cursor;r.cursor=e;r:while(true){var s=r.cursor;e:{if(!r.in_grouping(a,97,248)){break e}r.cursor=s;break r}r.cursor=s;if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(a,97,248)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}l=r.cursor;r:{if(!(ls.limit||(s.cursor=i,l=s.cursor,s.cursor=e,s.go_out_grouping(o,97,248)&&(s.cursor++,s.go_in_grouping(o,97,248))&&(s.cursor++,m=s.cursor,l<=m||(m=l))),s.cursor=r,s.limit_backward=s.cursor,s.cursor=s.limit,s.limit-s.cursor),e=((()=>{var r;if(!(s.cursor{var r,i=s.limit-s.cursor;if(s.ket=s.cursor,(!s.eq_s_b("st")||(s.bra=s.cursor,!s.eq_s_b("ig"))||s.slice_del())&&(s.cursor=s.limit-i,!(s.cursor=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}r.cursor=u;var a=r.cursor;r:{r.bra=r.cursor;if(!r.eq_s("y")){r.cursor=a;break r}r.ket=r.cursor;if(!r.slice_from("Y")){return false}}while(true){var t=r.cursor;r:{e:while(true){var o=r.cursor;i:{if(!r.in_grouping(c,97,232)){break i}r.bra=r.cursor;u:{var f=r.cursor;s:{if(!r.eq_s("i")){break s}r.ket=r.cursor;if(!r.in_grouping(c,97,232)){break s}if(!r.slice_from("I")){return false}break u}r.cursor=f;if(!r.eq_s("y")){break i}r.ket=r.cursor;if(!r.slice_from("Y")){return false}}r.cursor=o;break e}r.cursor=o;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=t;break}return true}function _(){n=r.limit;l=r.limit;r:while(true){e:{if(!r.in_grouping(c,97,232)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(c,97,232)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}n=r.cursor;r:{if(!(n<3)){break r}n=3}r:while(true){e:{if(!r.in_grouping(c,97,232)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(c,97,232)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}l=r.cursor;return true}function m(){var e;while(true){var u=r.cursor;r:{r.bra=r.cursor;e=r.find_among(i);if(e==0){break r}r.ket=r.cursor;switch(e){case 1:if(!r.slice_from("y")){return false}break;case 2:if(!r.slice_from("i")){return false}break;case 3:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=u;break}return true}function v(){if(!(n<=r.cursor)){return false}return true}function g(){if(!(l<=r.cursor)){return false}return true}function d(){var e=r.limit-r.cursor;if(r.find_among_b(u)==0){return false}r.cursor=r.limit-e;r.ket=r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;r.bra=r.cursor;if(!r.slice_del()){return false}return true}function h(){b=false;r.ket=r.cursor;if(!r.eq_s_b("e")){return false}r.bra=r.cursor;if(!v()){return false}var e=r.limit-r.cursor;if(!r.out_grouping_b(c,97,232)){return false}r.cursor=r.limit-e;if(!r.slice_del()){return false}b=true;if(!d()){return false}return true}function w(){if(!v()){return false}var e=r.limit-r.cursor;if(!r.out_grouping_b(c,97,232)){return false}r.cursor=r.limit-e;{var i=r.limit-r.cursor;r:{if(!r.eq_s_b("gem")){break r}return false}r.cursor=r.limit-i}if(!r.slice_del()){return false}if(!d()){return false}return true}function p(){var e;var i=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(s);if(e==0){break r}r.bra=r.cursor;switch(e){case 1:if(!v()){break r}if(!r.slice_from("heid")){return false}break;case 2:if(!w()){break r}break;case 3:if(!v()){break r}if(!r.out_grouping_b(f,97,232)){break r}if(!r.slice_del()){return false}break}}r.cursor=r.limit-i;var u=r.limit-r.cursor;h();r.cursor=r.limit-u;var l=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("heid")){break r}r.bra=r.cursor;if(!g()){break r}{var n=r.limit-r.cursor;e:{if(!r.eq_s_b("c")){break e}break r}r.cursor=r.limit-n}if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("en")){break r}r.bra=r.cursor;if(!w()){break r}}r.cursor=r.limit-l;var k=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(a);if(e==0){break r}r.bra=r.cursor;switch(e){case 1:if(!g()){break r}if(!r.slice_del()){return false}e:{var _=r.limit-r.cursor;i:{r.ket=r.cursor;if(!r.eq_s_b("ig")){break i}r.bra=r.cursor;if(!g()){break i}{var m=r.limit-r.cursor;u:{if(!r.eq_s_b("e")){break u}break i}r.cursor=r.limit-m}if(!r.slice_del()){return false}break e}r.cursor=r.limit-_;if(!d()){break r}}break;case 2:if(!g()){break r}{var p=r.limit-r.cursor;e:{if(!r.eq_s_b("e")){break e}break r}r.cursor=r.limit-p}if(!r.slice_del()){return false}break;case 3:if(!g()){break r}if(!r.slice_del()){return false}if(!h()){break r}break;case 4:if(!g()){break r}if(!r.slice_del()){return false}break;case 5:if(!g()){break r}if(!b){break r}if(!r.slice_del()){return false}break}}r.cursor=r.limit-k;var q=r.limit-r.cursor;r:{if(!r.out_grouping_b(o,73,232)){break r}var y=r.limit-r.cursor;if(r.find_among_b(t)==0){break r}if(!r.out_grouping_b(c,97,232)){break r}r.cursor=r.limit-y;r.ket=r.cursor;if(r.cursor<=r.limit_backward){break r}r.cursor--;r.bra=r.cursor;if(!r.slice_del()){return false}}r.cursor=r.limit-q;return true}this.stem=function(){var e=r.cursor;k();r.cursor=e;var i=r.cursor;_();r.cursor=i;r.limit_backward=r.cursor;r.cursor=r.limit;p();r.cursor=r.limit_backward;var u=r.cursor;m();r.cursor=u;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}}; \ No newline at end of file +var DutchStemmer=function(){var o=new BaseStemmer,a=[["a",-1,1],["e",-1,2],["o",-1,1],["u",-1,1],["à",-1,1],["á",-1,1],["â",-1,1],["ä",-1,1],["è",-1,2],["é",-1,2],["ê",-1,2],["eë",-1,3],["ië",-1,4],["ò",-1,1],["ó",-1,1],["ô",-1,1],["ö",-1,1],["ù",-1,1],["ú",-1,1],["û",-1,1],["ü",-1,1]],t=[["nde",-1,8],["en",-1,7],["s",-1,2],["'s",2,1],["es",2,4],["ies",4,3],["aus",2,6],["és",2,5]],e=[["de",-1,5],["ge",-1,2],["ische",-1,4],["je",-1,1],["lijke",-1,3],["le",-1,9],["ene",-1,10],["re",-1,8],["se",-1,7],["te",-1,6],["ieve",-1,11]],s=[["heid",-1,3],["fie",-1,7],["gie",-1,8],["atie",-1,1],["isme",-1,5],["ing",-1,5],["arij",-1,6],["erij",-1,5],["sel",-1,3],["rder",-1,4],["ster",-1,3],["iteit",-1,2],["dst",-1,10],["tst",-1,9]],c=[["end",-1,9],["atief",-1,2],["erig",-1,9],["achtig",-1,3],["ioneel",-1,1],["baar",-1,3],["laar",-1,5],["naar",-1,4],["raar",-1,6],["eriger",-1,9],["achtiger",-1,3],["lijker",-1,8],["tant",-1,7],["erigst",-1,9],["achtigst",-1,3],["lijkst",-1,8]],u=[["ig",-1,1],["iger",-1,1],["igst",-1,1]],f=[["ft",-1,2],["kt",-1,1],["pt",-1,3]],n=[["bb",-1,1],["cc",-1,2],["dd",-1,3],["ff",-1,4],["gg",-1,5],["hh",-1,6],["jj",-1,7],["kk",-1,8],["ll",-1,9],["mm",-1,10],["nn",-1,11],["pp",-1,12],["qq",-1,13],["rr",-1,14],["ss",-1,15],["tt",-1,16],["v",-1,4],["vv",16,17],["ww",-1,18],["xx",-1,19],["z",-1,15],["zz",20,20]],l=[["d",-1,1],["t",-1,2]],_=[["",-1,-1],["eft",0,1],["vaa",0,1],["val",0,1],["vali",3,-1],["vare",0,1]],m=[["ë",-1,1],["ï",-1,2]],b=[["ë",-1,1],["ï",-1,2]],k=[1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,120],d=[1,65,16,0,0,0,0,0,0,0,0,0,0,0,0,128,11,120,46,15],g=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,128,139,127,46,15],v=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,128,139,127,46,15],q=[17,65,208,1,0,0,0,0,0,0,0,0,0,0,0,128,139,127,46,15],w=!1,h=!1,p=0,j=0,z="";function x(){return j<=o.cursor}function C(){return p<=o.cursor}function S(){var r=o.limit-o.cursor,i=o.limit-o.cursor;return(o.in_grouping_b(v,97,252)||(o.cursor=o.limit-i,o.eq_s_b("ij")))&&(o.cursor=o.limit-r,1)}function B(){var r=o.limit-o.cursor,i=o.limit-o.cursor;return!o.eq_s_b("ij")&&(o.cursor=o.limit-i,o.out_grouping_b(v,97,252))&&(o.cursor=o.limit-r,1)}function D(){var r,i=o.limit-o.cursor;r:if(o.out_grouping_b(q,97,252)&&(o.ket=o.cursor,0!=(r=o.find_among_b(a))))switch(o.bra=o.cursor,r){case 1:var e=o.limit-o.cursor,s=o.limit-o.cursor;if(o.out_grouping_b(g,97,252)||(o.cursor=o.limit-s,!(o.cursor>o.limit_backward))){if(o.cursor=o.limit-e,""==(z=o.slice_to()))return;s=o.cursor;o.insert(o.cursor,o.cursor,z),o.cursor=s}break;case 2:var c=o.limit-o.cursor,e=o.limit-o.cursor;if(o.out_grouping_b(g,97,252)||(o.cursor=o.limit-e,!(o.cursor>o.limit_backward))){var u=o.limit-o.cursor;i:{var t=o.limit-o.cursor;if(!o.in_grouping_b(d,97,252)){if(o.cursor=o.limit-t,!o.in_grouping_b(k,101,235))break i;if(o.cursor>o.limit_backward)break i}break r}o.cursor=o.limit-u;t=o.limit-o.cursor;if(o.cursor<=o.limit_backward||(o.cursor--,!o.in_grouping_b(d,97,252))||!o.out_grouping_b(g,97,252)){if(o.cursor=o.limit-t,o.cursor=o.limit-c,""==(z=o.slice_to()))return;t=o.cursor;o.insert(o.cursor,o.cursor,z),o.cursor=t}}break;case 3:if(o.slice_from("eëe"))break;return;case 4:if(o.slice_from("iee"))break;return}o.cursor=o.limit-i}function W(){var r;if(o.ket=o.cursor,0!=(r=o.find_among_b(e))){switch(o.bra=o.cursor,r){case 1:r:{var i=o.limit-o.cursor;if(o.eq_s_b("'t")){if(o.bra=o.cursor,o.slice_del())break r;return}if(o.cursor=o.limit-i,o.eq_s_b("et")&&(o.bra=o.cursor,x())&&B()){if(o.slice_del())break r;return}if(o.cursor=o.limit-i,o.eq_s_b("rnt")){if(o.bra=o.cursor,o.slice_from("rn"))break r;return}if(o.cursor=o.limit-i,o.eq_s_b("t")&&(o.bra=o.cursor,x())&&(()=>{var r,i=o.limit-o.cursor;return!(o.cursor<=o.limit_backward)&&(o.cursor--,r=o.limit-o.cursor,o.in_grouping_b(v,97,252)||(o.cursor=o.limit-r,o.eq_s_b("ij")))?(o.cursor=o.limit-i,1):void 0})()){if(o.slice_del())break r;return}if(o.cursor=o.limit-i,o.eq_s_b("ink")){if(o.bra=o.cursor,o.slice_from("ing"))break r;return}if(o.cursor=o.limit-i,o.eq_s_b("mp")){if(o.bra=o.cursor,o.slice_from("m"))break r;return}if(o.cursor=o.limit-i,o.eq_s_b("'")&&(o.bra=o.cursor,x())){if(o.slice_del())break r;return}if(o.cursor=o.limit-i,o.bra=o.cursor,!x())return;if(!B())return;if(!o.slice_del())return}break;case 2:if(!x())return;if(o.slice_from("g"))break;return;case 3:if(!x())return;if(o.slice_from("lijk"))break;return;case 4:if(!x())return;if(o.slice_from("isch"))break;return;case 5:if(!x())return;if(!B())return;if(o.slice_del())break;return;case 6:if(!x())return;if(o.slice_from("t"))break;return;case 7:if(!x())return;if(o.slice_from("s"))break;return;case 8:if(!x())return;if(o.slice_from("r"))break;return;case 9:if(!x())return;if(!o.slice_del())return;o.insert(o.cursor,o.cursor,"l"),D();break;case 10:if(!x())return;if(!B())return;if(!o.slice_del())return;o.insert(o.cursor,o.cursor,"en"),D();break;case 11:if(!x())return;if(!B())return;if(o.slice_from("ief"))break;return}return 1}}function y(){var r;if(o.ket=o.cursor,0!=(r=o.find_among_b(l))&&(o.bra=o.cursor,x())&&B()){switch(r){case 1:var i=o.limit-o.cursor;if(o.eq_s_b("n")&&x())return;o.cursor=o.limit-i;r:{var e=o.limit-o.cursor;if(o.eq_s_b("in")&&!(o.cursor>o.limit_backward)){if(o.slice_from("n"))break r;return}if(o.cursor=o.limit-e,!o.slice_del())return}break;case 2:i=o.limit-o.cursor;if(o.eq_s_b("h")&&x())return;o.cursor=o.limit-i;i=o.limit-o.cursor;if(o.eq_s_b("en")&&!(o.cursor>o.limit_backward))return;if(o.cursor=o.limit-i,o.slice_del())break;return}return 1}}function A(){j=o.limit,p=o.limit;for(var r=o.cursor;o.out_grouping(v,97,252););for(var i=1;;){var e=o.cursor,s=o.cursor;if(!o.eq_s("ij")&&(o.cursor=s,!o.in_grouping(v,97,252))){o.cursor=e;break}i--}if(!(0{var r;if(o.ket=o.cursor,0!=(r=o.find_among_b(t))){switch(o.bra=o.cursor,r){case 1:if(o.slice_del())break;return;case 2:if(!x())return;var i=o.limit-o.cursor;if(o.eq_s_b("t")&&x())return;if(o.cursor=o.limit-i,!B())return;if(o.slice_del())break;return;case 3:if(!x())return;if(o.slice_from("ie"))break;return;case 4:r:{var e=o.limit-o.cursor,s=o.limit-o.cursor;if(o.eq_s_b("ar")&&x()&&B()){if(o.cursor=o.limit-s,!o.slice_del())return;D()}else{o.cursor=o.limit-e;s=o.limit-o.cursor;if(o.eq_s_b("er")&&x()&&B()){if(o.cursor=o.limit-s,o.slice_del())break r;return}if(o.cursor=o.limit-e,!x())return;if(!B())return;if(!o.slice_from("e"))return}}break;case 5:if(!x())return;if(o.slice_from("é"))break;return;case 6:if(!x())return;if(!S())return;if(o.slice_from("au"))break;return;case 7:r:{var c=o.limit-o.cursor;if(o.eq_s_b("hed")&&x()){if(o.bra=o.cursor,o.slice_from("heid"))break r;return}if(o.cursor=o.limit-c,o.eq_s_b("nd")){if(o.slice_del())break r;return}if(o.cursor=o.limit-c,o.eq_s_b("d")&&x()&&B()){if(o.bra=o.cursor,o.slice_del())break r;return}o.cursor=o.limit-c;var u=o.limit-o.cursor;if((o.eq_s_b("i")||(o.cursor=o.limit-u,o.eq_s_b("j")))&&S()){if(o.slice_del())break r;return}if(o.cursor=o.limit-c,!x())return;if(!B())return;if(!o.slice_del())return;D()}break;case 8:if(o.slice_from("nd"))break;return}return 1}})()&&(h=!0),o.cursor=o.limit-r,o.limit-o.cursor),r=(W()&&(h=!0),o.cursor=o.limit-r,o.limit-o.cursor),r=((()=>{var r;if(o.ket=o.cursor,0!=(r=o.find_among_b(s))){switch(o.bra=o.cursor,r){case 1:if(!x())return;if(o.slice_from("eer"))break;return;case 2:if(!x())return;if(!o.slice_del())return;D();break;case 3:if(!x())return;if(o.slice_del())break;return;case 4:if(o.slice_from("r"))break;return;case 5:r:{var i=o.limit-o.cursor;if(o.eq_s_b("ild")){if(o.slice_from("er"))break r;return}if(o.cursor=o.limit-i,!x())return;if(!o.slice_del())return;D()}break;case 6:if(!x())return;if(!B())return;if(o.slice_from("aar"))break;return;case 7:if(!C())return;if(!o.slice_del())return;o.insert(o.cursor,o.cursor,"f"),D();break;case 8:if(!C())return;if(!o.slice_del())return;o.insert(o.cursor,o.cursor,"g"),D();break;case 9:if(!x())return;if(!B())return;if(o.slice_from("t"))break;return;case 10:if(!x())return;if(!B())return;if(o.slice_from("d"))break;return}return 1}})()&&(h=!0),o.cursor=o.limit-r,o.limit-o.cursor),r=((()=>{r:{var r=o.limit-o.cursor;i:if(o.ket=o.cursor,0!=(i=o.find_among_b(c))){switch(o.bra=o.cursor,i){case 1:if(!x())break i;if(o.slice_from("ie"))break;return;case 2:if(!x())break i;if(o.slice_from("eer"))break;return;case 3:if(!x())break i;if(o.slice_del())break;return;case 4:if(!x())break i;if(!S())break i;if(o.slice_from("n"))break;return;case 5:if(!x())break i;if(!S())break i;if(o.slice_from("l"))break;return;case 6:if(!x())break i;if(!S())break i;if(o.slice_from("r"))break;return;case 7:if(!x())break i;if(o.slice_from("teer"))break;return;case 8:if(!x())break i;if(o.slice_from("lijk"))break;return;case 9:if(!x())break i;if(!B())break i;if(!o.slice_del())return;D()}break r}if(o.cursor=o.limit-r,o.ket=o.cursor,0==o.find_among_b(u))return;if(o.bra=o.cursor,!x())return;var i=o.limit-o.cursor;if(o.eq_s_b("inn")&&!(o.cursor>o.limit_backward))return;if(o.cursor=o.limit-i,!B())return;if(!o.slice_del())return;D()}return 1})()&&(h=!0),o.cursor=o.limit-r,o.cursor=o.limit_backward,w=!1,o.cursor),i=o.cursor,i=((()=>{if(o.bra=o.cursor,o.eq_s("ge")){o.ket=o.cursor;var r=o.cursor,i=o.cursor+3;if(!(i>o.limit)){o.cursor=i,o.cursor=r;for(var i=o.cursor;;){var e=o.cursor,s=o.cursor;if(o.eq_s("ij")||(o.cursor=s,o.in_grouping(v,97,252)))break;if(o.cursor=e,o.cursor>=o.limit)return;o.cursor++}for(;;){var c=o.cursor,u=o.cursor;if(!o.eq_s("ij")&&(o.cursor=u,!o.in_grouping(v,97,252))){o.cursor=c;break}}if(o.cursor{if(!(o.cursor>=o.limit)){for(o.cursor++;;){if(o.bra=o.cursor,o.eq_s("ge")){o.ket=o.cursor;break}if(o.cursor>=o.limit)return;o.cursor++}var r=o.cursor,i=o.cursor+3;if(!(i>o.limit)){o.cursor=i,o.cursor=r;for(var i=o.cursor;;){var e=o.cursor,s=o.cursor;if(o.eq_s("ij")||(o.cursor=s,o.in_grouping(v,97,252)))break;if(o.cursor=e,o.cursor>=o.limit)return;o.cursor++}for(;;){var c=o.cursor,u=o.cursor;if(!o.eq_s("ij")&&(o.cursor=u,!o.in_grouping(v,97,252))){o.cursor=c;break}}if(o.cursor{var r;if(o.ket=o.cursor,0!=(r=o.find_among_b(f))){switch(o.bra=o.cursor,r){case 1:if(o.slice_from("k"))break;return;case 2:if(o.slice_from("f"))break;return;case 3:if(o.slice_from("p"))break;return}return 1}})()&&(h=!0),o.cursor=o.limit-r,o.limit-o.cursor);return h&&(()=>{var r;if(o.ket=o.cursor,0!=(r=o.find_among_b(n))){switch(o.bra=o.cursor,r){case 1:if(o.slice_from("b"))break;return;case 2:if(o.slice_from("c"))break;return;case 3:if(o.slice_from("d"))break;return;case 4:if(o.slice_from("f"))break;return;case 5:if(o.slice_from("g"))break;return;case 6:if(o.slice_from("h"))break;return;case 7:if(o.slice_from("j"))break;return;case 8:if(o.slice_from("k"))break;return;case 9:if(o.slice_from("l"))break;return;case 10:if(o.slice_from("m"))break;return;case 11:var i=o.limit-o.cursor;if(o.eq_s_b("i")&&!(o.cursor>o.limit_backward))return;if(o.cursor=o.limit-i,o.slice_from("n"))break;return;case 12:if(o.slice_from("p"))break;return;case 13:if(o.slice_from("q"))break;return;case 14:if(o.slice_from("r"))break;return;case 15:if(o.slice_from("s"))break;return;case 16:if(o.slice_from("t"))break;return;case 17:if(o.slice_from("v"))break;return;case 18:if(o.slice_from("w"))break;return;case 19:if(o.slice_from("x"))break;return;case 20:if(o.slice_from("z"))break;return}}})(),o.cursor=o.limit-i,o.cursor=o.limit_backward,!0},this.stemWord=function(r){return o.setCurrent(r),this.stem(),o.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/dutch_porter-stemmer.js b/sphinx/search/minified-js/dutch_porter-stemmer.js new file mode 100644 index 00000000000..32f195914c2 --- /dev/null +++ b/sphinx/search/minified-js/dutch_porter-stemmer.js @@ -0,0 +1 @@ +var DutchPorterStemmer=function(){var t=new BaseStemmer,a=[["",-1,6],["á",0,1],["ä",0,1],["é",0,2],["ë",0,2],["í",0,3],["ï",0,3],["ó",0,4],["ö",0,4],["ú",0,5],["ü",0,5]],s=[["",-1,3],["I",0,2],["Y",0,1]],i=[["dd",-1,-1],["kk",-1,-1],["tt",-1,-1]],c=[["ene",-1,2],["se",-1,3],["en",-1,2],["heden",2,1],["s",-1,3]],n=[["end",-1,1],["ig",-1,2],["ing",-1,1],["lijk",-1,3],["baar",-1,4],["bar",-1,5]],_=[["aa",-1,-1],["ee",-1,-1],["oo",-1,-1],["uu",-1,-1]],l=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],f=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],b=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],u=0,o=0,m=0,k=!1;function g(){return m<=t.cursor}function d(){return o<=t.cursor}function v(){var r=t.limit-t.cursor;return 0!=t.find_among_b(i)&&(t.cursor=t.limit-r,t.ket=t.cursor,!(t.cursor<=t.limit_backward||(t.cursor--,t.bra=t.cursor,!t.slice_del())))}function h(){var r;if((k=!1,t.ket=t.cursor,t.eq_s_b("e"))&&(t.bra=t.cursor,g()))return r=t.limit-t.cursor,t.out_grouping_b(l,97,232)?(t.cursor=t.limit-r,t.slice_del()&&(k=!0,!!v())):void 0}function p(){if(g()){var r=t.limit-t.cursor;if(t.out_grouping_b(l,97,232))return t.cursor=t.limit-r,r=t.limit-t.cursor,t.eq_s_b("gem")?void 0:(t.cursor=t.limit-r,t.slice_del()&&!!v())}}this.stem=function(){var r,i=t.cursor,i=((()=>{for(var r,i=t.cursor;;){var e=t.cursor;r:{switch(t.bra=t.cursor,r=t.find_among(a),t.ket=t.cursor,r){case 1:if(t.slice_from("a"))break;return;case 2:if(t.slice_from("e"))break;return;case 3:if(t.slice_from("i"))break;return;case 4:if(t.slice_from("o"))break;return;case 5:if(t.slice_from("u"))break;return;case 6:if(t.cursor>=t.limit)break r;t.cursor++}continue}t.cursor=e;break}if(t.cursor=i,i=t.cursor,t.bra=t.cursor,t.eq_s("y")){if(t.ket=t.cursor,!t.slice_from("Y"))return}else t.cursor=i;for(;;){var s=t.cursor;if(!t.go_out_grouping(l,97,232)){t.cursor=s;break}t.cursor++;var u=t.cursor;r:{t.bra=t.cursor;var o=t.cursor;if(t.eq_s("i")){t.ket=t.cursor;var c=t.cursor;if(t.in_grouping(l,97,232)&&!t.slice_from("I"))return;t.cursor=c}else{if(t.cursor=o,!t.eq_s("y")){t.cursor=u;break r}if(t.ket=t.cursor,!t.slice_from("Y"))return}}}})(),t.cursor=i,t.cursor),e=(m=t.limit,o=t.limit,r=t.cursor,(e=t.cursor+3)>t.limit||(t.cursor=e,u=t.cursor,t.cursor=r,t.go_out_grouping(l,97,232)&&(t.cursor++,t.go_in_grouping(l,97,232))&&(t.cursor++,m=t.cursor,u<=m||(m=u),t.go_out_grouping(l,97,232))&&(t.cursor++,t.go_in_grouping(l,97,232))&&(t.cursor++,o=t.cursor)),t.cursor=i,t.limit_backward=t.cursor,t.cursor=t.limit,(()=>{var r,i=t.limit-t.cursor;r:if(t.ket=t.cursor,0!=(r=t.find_among_b(c)))switch(t.bra=t.cursor,r){case 1:if(!g())break r;if(t.slice_from("heid"))break;return;case 2:p();break;case 3:if(!g())break r;if(!t.out_grouping_b(b,97,232))break r;if(t.slice_del())break;return}if(t.cursor=t.limit-i,i=t.limit-t.cursor,h(),t.cursor=t.limit-i,i=t.limit-t.cursor,t.ket=t.cursor,t.eq_s_b("heid")&&(t.bra=t.cursor,d())){var e=t.limit-t.cursor;if(!t.eq_s_b("c")){if(t.cursor=t.limit-e,!t.slice_del())return;t.ket=t.cursor,t.eq_s_b("en")&&(t.bra=t.cursor,p())}}t.cursor=t.limit-i,e=t.limit-t.cursor;r:if(t.ket=t.cursor,0!=(r=t.find_among_b(n)))switch(t.bra=t.cursor,r){case 1:if(d()){if(!t.slice_del())return;i:{var s=t.limit-t.cursor;if(t.ket=t.cursor,t.eq_s_b("ig")&&(t.bra=t.cursor,d())){var u=t.limit-t.cursor;if(!t.eq_s_b("e")){if(t.cursor=t.limit-u,t.slice_del())break i;return}}if(t.cursor=t.limit-s,!v())break r}}break;case 2:if(!d())break r;var o=t.limit-t.cursor;if(t.eq_s_b("e"))break r;if(t.cursor=t.limit-o,t.slice_del())break;return;case 3:if(d()){if(!t.slice_del())return;h()}break;case 4:if(!d())break r;if(t.slice_del())break;return;case 5:if(!d())break r;if(!k)break r;if(t.slice_del())break;return}if(t.cursor=t.limit-e,i=t.limit-t.cursor,t.out_grouping_b(f,73,232)){e=t.limit-t.cursor;if(0!=t.find_among_b(_)&&t.out_grouping_b(l,97,232)&&(t.cursor=t.limit-e,t.ket=t.cursor,!(t.cursor<=t.limit_backward||(t.cursor--,t.bra=t.cursor,t.slice_del()))))return}t.cursor=t.limit-i})(),t.cursor=t.limit_backward,t.cursor);return(()=>{for(var r;;){var i=t.cursor;r:{switch(t.bra=t.cursor,r=t.find_among(s),t.ket=t.cursor,r){case 1:if(t.slice_from("y"))break;return;case 2:if(t.slice_from("i"))break;return;case 3:if(t.cursor>=t.limit)break r;t.cursor++}continue}t.cursor=i;break}})(),t.cursor=e,!0},this.stemWord=function(r){return t.setCurrent(r),this.stem(),t.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/english-stemmer.js b/sphinx/search/minified-js/english-stemmer.js new file mode 100644 index 00000000000..e005f991e6a --- /dev/null +++ b/sphinx/search/minified-js/english-stemmer.js @@ -0,0 +1 @@ +var EnglishStemmer=function(){var a=new BaseStemmer,c=[["arsen",-1,-1],["commun",-1,-1],["emerg",-1,-1],["gener",-1,-1],["later",-1,-1],["organ",-1,-1],["past",-1,-1],["univers",-1,-1]],o=[["'",-1,1],["'s'",0,1],["'s",-1,1]],u=[["ied",-1,2],["s",-1,3],["ies",1,2],["sses",1,1],["ss",1,-1],["us",1,-1]],t=[["succ",-1,1],["proc",-1,1],["exc",-1,1]],l=[["even",-1,2],["cann",-1,2],["inn",-1,2],["earr",-1,2],["herr",-1,2],["out",-1,2],["y",-1,1]],n=[["",-1,-1],["ed",0,2],["eed",1,1],["ing",0,3],["edly",0,2],["eedly",4,1],["ingly",0,2]],f=[["",-1,3],["bb",0,2],["dd",0,2],["ff",0,2],["gg",0,2],["bl",0,1],["mm",0,2],["nn",0,2],["pp",0,2],["rr",0,2],["at",0,1],["tt",0,2],["iz",0,1]],_=[["anci",-1,3],["enci",-1,2],["ogi",-1,14],["li",-1,16],["bli",3,12],["abli",4,4],["alli",3,8],["fulli",3,9],["lessli",3,15],["ousli",3,10],["entli",3,5],["aliti",-1,8],["biliti",-1,12],["iviti",-1,11],["tional",-1,1],["ational",14,7],["alism",-1,8],["ation",-1,7],["ization",17,6],["izer",-1,6],["ator",-1,7],["iveness",-1,11],["fulness",-1,9],["ousness",-1,10],["ogist",-1,13]],m=[["icate",-1,4],["ative",-1,6],["alize",-1,3],["iciti",-1,4],["ical",-1,4],["tional",-1,1],["ational",5,2],["ful",-1,5],["ness",-1,5]],b=[["ic",-1,1],["ance",-1,1],["ence",-1,1],["able",-1,1],["ible",-1,1],["ate",-1,1],["ive",-1,1],["ize",-1,1],["iti",-1,1],["al",-1,1],["ism",-1,1],["ion",-1,2],["er",-1,1],["ous",-1,1],["ant",-1,1],["ent",-1,1],["ment",15,1],["ement",16,1]],k=[["e",-1,1],["l",-1,2]],g=[["andes",-1,-1],["atlas",-1,-1],["bias",-1,-1],["cosmos",-1,-1],["early",-1,5],["gently",-1,3],["howe",-1,-1],["idly",-1,2],["news",-1,-1],["only",-1,6],["singly",-1,7],["skies",-1,1],["sky",-1,-1],["ugly",-1,4]],d=[17,64],v=[17,65,16,1],i=[1,17,65,208,1],w=[55,141,2],p=!1,y=0,h=0;function q(){var r=a.limit-a.cursor;return!!(a.out_grouping_b(i,89,121)&&a.in_grouping_b(v,97,121)&&a.out_grouping_b(v,97,121)||(a.cursor=a.limit-r,a.out_grouping_b(v,97,121)&&a.in_grouping_b(v,97,121)&&!(a.cursor>a.limit_backward))||(a.cursor=a.limit-r,a.eq_s_b("past")))}function z(){return h<=a.cursor}function Y(){return y<=a.cursor}this.stem=function(){var r=a.cursor;if(!(()=>{var r;if(a.bra=a.cursor,0!=(r=a.find_among(g))&&(a.ket=a.cursor,!(a.cursora.limit)a.cursor=i;else{a.cursor=e,a.cursor=r,(()=>{p=!1;var r=a.cursor;if(a.bra=a.cursor,!a.eq_s("'")||(a.ket=a.cursor,a.slice_del())){a.cursor=r;r=a.cursor;if(a.bra=a.cursor,a.eq_s("y")){if(a.ket=a.cursor,!a.slice_from("Y"))return;p=!0}a.cursor=r;for(r=a.cursor;;){var i=a.cursor;r:{for(;;){var e=a.cursor;if(a.in_grouping(v,97,121)&&(a.bra=a.cursor,a.eq_s("y"))){a.ket=a.cursor,a.cursor=e;break}if(a.cursor=e,a.cursor>=a.limit)break r;a.cursor++}if(!a.slice_from("Y"))return;p=!0;continue}a.cursor=i;break}a.cursor=r}})(),h=a.limit,y=a.limit;i=a.cursor;r:{var s=a.cursor;if(0==a.find_among(c)){if(a.cursor=s,!a.go_out_grouping(v,97,121))break r;if(a.cursor++,!a.go_in_grouping(v,97,121))break r;a.cursor++}h=a.cursor,a.go_out_grouping(v,97,121)&&(a.cursor++,a.go_in_grouping(v,97,121))&&(a.cursor++,y=a.cursor)}a.cursor=i,a.limit_backward=a.cursor,a.cursor=a.limit;var e=a.limit-a.cursor,r=((()=>{var r=a.limit-a.cursor;if(a.ket=a.cursor,0==a.find_among_b(o))a.cursor=a.limit-r;else if(a.bra=a.cursor,!a.slice_del())return;if(a.ket=a.cursor,0!=(r=a.find_among_b(u)))switch(a.bra=a.cursor,r){case 1:if(a.slice_from("ss"))break;return;case 2:r:{var i=a.limit-a.cursor,e=a.cursor-2;if(!(e{a.ket=a.cursor,o=a.find_among_b(n),a.bra=a.cursor;r:{var r=a.limit-a.cursor;i:{switch(o){case 1:var i=a.limit-a.cursor;e:{var e=a.limit-a.cursor;if(0==a.find_among_b(t)||a.cursor>a.limit_backward){if(a.cursor=a.limit-e,!z())break e;if(!a.slice_from("ee"))return}}a.cursor=a.limit-i;break;case 2:break i;case 3:if(0==(o=a.find_among_b(l)))break i;switch(o){case 1:var s=a.limit-a.cursor;if(!a.out_grouping_b(v,97,121))break i;if(a.cursor>a.limit_backward)break i;if(a.cursor=a.limit-s,a.bra=a.cursor,a.slice_from("ie"))break;return;case 2:if(a.cursor>a.limit_backward)break i}}break r}a.cursor=a.limit-r;var c=a.limit-a.cursor;if(!a.go_out_grouping_b(v,97,121))return;if(a.cursor--,a.cursor=a.limit-c,!a.slice_del())return;a.ket=a.cursor,a.bra=a.cursor;var o,c=a.limit-a.cursor;switch(o=a.find_among_b(f)){case 1:return a.slice_from("e");case 2:var u=a.limit-a.cursor;if(a.in_grouping_b(d,97,111)&&!(a.cursor>a.limit_backward))return;a.cursor=a.limit-u;break;case 3:return a.cursor!=h||(u=a.limit-a.cursor,q()&&(a.cursor=a.limit-u,a.slice_from("e")))}if(a.cursor=a.limit-c,a.ket=a.cursor,a.cursor<=a.limit_backward)return;if(a.cursor--,a.bra=a.cursor,!a.slice_del())return}})(),a.cursor=a.limit-r,a.limit-a.cursor),r=(a.ket=a.cursor,e=a.limit-a.cursor,(a.eq_s_b("y")||(a.cursor=a.limit-e,a.eq_s_b("Y")))&&(a.bra=a.cursor,a.out_grouping_b(v,97,121))&&a.cursor>a.limit_backward&&a.slice_from("i"),a.cursor=a.limit-i,a.limit-a.cursor),e=((()=>{var r;if(a.ket=a.cursor,0!=(r=a.find_among_b(_))&&(a.bra=a.cursor,z()))switch(r){case 1:if(a.slice_from("tion"))break;return;case 2:if(a.slice_from("ence"))break;return;case 3:if(a.slice_from("ance"))break;return;case 4:if(a.slice_from("able"))break;return;case 5:if(a.slice_from("ent"))break;return;case 6:if(a.slice_from("ize"))break;return;case 7:if(a.slice_from("ate"))break;return;case 8:if(a.slice_from("al"))break;return;case 9:if(a.slice_from("ful"))break;return;case 10:if(a.slice_from("ous"))break;return;case 11:if(a.slice_from("ive"))break;return;case 12:if(a.slice_from("ble"))break;return;case 13:if(a.slice_from("og"))break;return;case 14:if(!a.eq_s_b("l"))return;if(a.slice_from("og"))break;return;case 15:if(a.slice_from("less"))break;return;case 16:if(!a.in_grouping_b(w,99,116))return;if(a.slice_del())break}})(),a.cursor=a.limit-r,a.limit-a.cursor),i=((()=>{var r;if(a.ket=a.cursor,0!=(r=a.find_among_b(m))&&(a.bra=a.cursor,z()))switch(r){case 1:if(a.slice_from("tion"))break;return;case 2:if(a.slice_from("ate"))break;return;case 3:if(a.slice_from("al"))break;return;case 4:if(a.slice_from("ic"))break;return;case 5:if(a.slice_del())break;return;case 6:if(!Y())return;if(a.slice_del())break}})(),a.cursor=a.limit-e,a.limit-a.cursor),r=((()=>{var r;if(a.ket=a.cursor,0!=(r=a.find_among_b(b))&&(a.bra=a.cursor,Y()))switch(r){case 1:if(a.slice_del())break;return;case 2:var i=a.limit-a.cursor;if(!a.eq_s_b("s")&&(a.cursor=a.limit-i,!a.eq_s_b("t")))return;if(a.slice_del())break}})(),a.cursor=a.limit-i,a.limit-a.cursor),e=((()=>{var r;if(a.ket=a.cursor,0!=(r=a.find_among_b(k)))switch(a.bra=a.cursor,r){case 1:if(!Y()){if(!z())return;var i=a.limit-a.cursor;if(q())return;a.cursor=a.limit-i}if(a.slice_del())break;return;case 2:if(!Y())return;if(!a.eq_s_b("l"))return;if(a.slice_del())break}})(),a.cursor=a.limit-r,a.cursor=a.limit_backward,a.cursor);(()=>{if(p)for(;;){var r=a.cursor;r:{for(;;){var i=a.cursor;if(a.bra=a.cursor,a.eq_s("Y")){a.ket=a.cursor,a.cursor=i;break}if(a.cursor=i,a.cursor>=a.limit)break r;a.cursor++}if(a.slice_from("y"))continue;return}a.cursor=r;break}})(),a.cursor=e}}return!0},this.stemWord=function(r){return a.setCurrent(r),this.stem(),a.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/esperanto-stemmer.js b/sphinx/search/minified-js/esperanto-stemmer.js new file mode 100644 index 00000000000..44353e6a150 --- /dev/null +++ b/sphinx/search/minified-js/esperanto-stemmer.js @@ -0,0 +1 @@ +var EsperantoStemmer=function(){var o=new BaseStemmer,s=[["",-1,14],["-",0,13],["cx",0,1],["gx",0,2],["hx",0,3],["jx",0,4],["q",0,12],["sx",0,5],["ux",0,6],["w",0,12],["x",0,12],["y",0,12],["á",0,7],["é",0,8],["í",0,9],["ó",0,10],["ú",0,11]],i=[["as",-1,-1],["i",-1,-1],["is",1,-1],["os",-1,-1],["u",-1,-1],["us",4,-1]],u=[["ci",-1,-1],["gi",-1,-1],["hi",-1,-1],["li",-1,-1],["ili",3,-1],["ŝli",3,-1],["mi",-1,-1],["ni",-1,-1],["oni",7,-1],["ri",-1,-1],["si",-1,-1],["vi",-1,-1],["ivi",11,-1],["ĝi",-1,-1],["ŝi",-1,-1],["iŝi",14,-1],["malŝi",14,-1]],e=[["amb",-1,-1],["bald",-1,-1],["malbald",1,-1],["morg",-1,-1],["postmorg",3,-1],["adi",-1,-1],["hodi",-1,-1],["ank",-1,-1],["ĉirk",-1,-1],["tutĉirk",8,-1],["presk",-1,-1],["almen",-1,-1],["apen",-1,-1],["hier",-1,-1],["antaŭhier",13,-1],["malgr",-1,-1],["ankor",-1,-1],["kontr",-1,-1],["anstat",-1,-1],["kvaz",-1,-1]],c=[["aliu",-1,-1],["unu",-1,-1]],a=[["aha",-1,-1],["haha",0,-1],["haleluja",-1,-1],["hola",-1,-1],["hosana",-1,-1],["maltra",-1,-1],["hura",-1,-1],["ĥaĥa",-1,-1],["ekde",-1,-1],["elde",-1,-1],["disde",-1,-1],["ehe",-1,-1],["maltre",-1,-1],["dirlididi",-1,-1],["malpli",-1,-1],["malĉi",-1,-1],["malkaj",-1,-1],["amen",-1,-1],["tamen",17,-1],["oho",-1,-1],["maltro",-1,-1],["minus",-1,-1],["uhu",-1,-1],["muu",-1,-1]],t=[["tri",-1,-1],["du",-1,-1],["unu",-1,-1]],m=[["dek",-1,-1],["cent",-1,-1]],l=[["k",-1,-1],["kelk",0,-1],["nen",-1,-1],["t",-1,-1],["mult",3,-1],["samt",3,-1],["ĉ",-1,-1]],n=[["a",-1,-1],["e",-1,-1],["i",-1,-1],["j",-1,-1,r],["aj",3,-1],["oj",3,-1],["n",-1,-1,r],["an",6,-1],["en",6,-1],["jn",6,-1,r],["ajn",9,-1],["ojn",9,-1],["on",6,-1],["o",-1,-1],["as",-1,-1],["is",-1,-1],["os",-1,-1],["us",-1,-1],["u",-1,-1]],_=[17,65,16],b=[1,64,16],f=[255,3],k=!1;function r(){var r=o.limit-o.cursor;return!(!o.eq_s_b("-")&&(o.cursor=o.limit-r,!o.in_grouping_b(f,48,57)))}this.stem=function(){var r=o.cursor;if(!(()=>{var r;for(k=!1;;){var i=o.cursor;r:{switch(o.bra=o.cursor,r=o.find_among(s),o.ket=o.cursor,r){case 1:if(o.slice_from("ĉ"))break;return;case 2:if(o.slice_from("ĝ"))break;return;case 3:if(o.slice_from("ĥ"))break;return;case 4:if(o.slice_from("ĵ"))break;return;case 5:if(o.slice_from("ŝ"))break;return;case 6:if(o.slice_from("ŭ"))break;return;case 7:if(!o.slice_from("a"))return;k=!0;break;case 8:if(!o.slice_from("e"))return;k=!0;break;case 9:if(!o.slice_from("i"))return;k=!0;break;case 10:if(!o.slice_from("o"))return;k=!0;break;case 11:if(!o.slice_from("u"))return;k=!0;break;case 12:k=!0;break;case 13:k=!1;break;case 14:if(o.cursor>=o.limit)break r;o.cursor++}continue}o.cursor=i;break}return!k})())return!1;o.cursor=r;r=o.cursor,o.bra=o.cursor,o.eq_s("'")&&(o.ket=o.cursor,!o.eq_s("st")||0==o.find_among(i)||o.cursor{o.ket=o.cursor;var r=o.limit-o.cursor;return o.eq_s_b("n")||(o.cursor=o.limit-r),o.bra=o.cursor,0==o.find_among_b(u)||(r=o.limit-o.cursor,o.cursor>o.limit_backward&&(o.cursor=o.limit-r,!o.eq_s_b("-")))?void 0:!!o.slice_del()})())return!1;o.cursor=o.limit-r;r=o.limit-o.cursor,(()=>{if(o.ket=o.cursor,o.eq_s_b("'")){o.bra=o.cursor;r:{var r=o.limit-o.cursor;if(o.eq_s_b("l")&&!(o.cursor>o.limit_backward)){if(o.slice_from("a"))break r;return}if(o.cursor=o.limit-r,o.eq_s_b("un")&&!(o.cursor>o.limit_backward)){if(o.slice_from("u"))break r;return}if(o.cursor=o.limit-r,0!=o.find_among_b(e)){var i=o.limit-o.cursor;if(!(o.cursor>o.limit_backward)||(o.cursor=o.limit-i,o.eq_s_b("-"))){if(o.slice_from("aŭ"))break r;return}}if(o.cursor=o.limit-r,!o.slice_from("o"))return}}})(),o.cursor=o.limit-r,r=o.limit-o.cursor;if((()=>{o.ket=o.cursor,o.bra=o.cursor;var r=o.limit-o.cursor,i=o.limit-o.cursor,s=o.limit-o.cursor;if(o.eq_s_b("n")||(o.cursor=o.limit-s),o.bra=o.cursor,!o.eq_s_b("e")){o.cursor=o.limit-i;var s=o.limit-o.cursor,i=(o.eq_s_b("n")||(o.cursor=o.limit-s),o.limit-o.cursor);if(o.eq_s_b("j")||(o.cursor=o.limit-i),o.bra=o.cursor,!o.in_grouping_b(b,97,117))return}return!o.eq_s_b("i")||(s=o.limit-o.cursor,0==o.find_among_b(l)&&(o.cursor=o.limit-s),i=o.limit-o.cursor,o.cursor>o.limit_backward&&(o.cursor=o.limit-i,!o.eq_s_b("-")))?void 0:(o.cursor=o.limit-r,!!o.slice_del())})())return!1;o.cursor=o.limit-r;r=o.limit-o.cursor;if((()=>{var r;return 0==o.find_among_b(a)||(r=o.limit-o.cursor,o.cursor>o.limit_backward&&(o.cursor=o.limit-r,!o.eq_s_b("-")))?void 0:1})())return!1;o.cursor=o.limit-r;r=o.limit-o.cursor;if(0!=o.find_among_b(t)&&0!=o.find_among_b(m))return!1;o.cursor=o.limit-r;r=o.limit-o.cursor;if((()=>{o.ket=o.cursor;var r=o.limit-o.cursor,r=(o.eq_s_b("n")||(o.cursor=o.limit-r),o.limit-o.cursor);return o.eq_s_b("j")||(o.cursor=o.limit-r),o.bra=o.cursor,0==o.find_among_b(c)||(r=o.limit-o.cursor,o.cursor>o.limit_backward&&(o.cursor=o.limit-r,!o.eq_s_b("-")))?void 0:!!o.slice_del()})())return!1;o.cursor=o.limit-r;r=o.limit-o.cursor;return!!(()=>{r:{var r=o.limit-o.cursor;i:{for(var i=2;0{var r;return o.ket=o.cursor,0!=o.find_among_b(n)&&(r=o.limit-o.cursor,o.eq_s_b("-")||(o.cursor=o.limit-r),o.bra=o.cursor,o.slice_del())?1:void 0})())&&(o.cursor=o.limit_backward,!0)},this.stemWord=function(r){return o.setCurrent(r),this.stem(),o.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/estonian-stemmer.js b/sphinx/search/minified-js/estonian-stemmer.js new file mode 100644 index 00000000000..d27e90fcd3b --- /dev/null +++ b/sphinx/search/minified-js/estonian-stemmer.js @@ -0,0 +1 @@ +var EstonianStemmer=function(){var t=new BaseStemmer,a=[["gi",-1,1],["ki",-1,2]],r=[["da",-1,3],["mata",-1,1],["b",-1,3],["ksid",-1,1],["nuksid",3,1],["me",-1,3],["sime",5,1],["ksime",6,1],["nuksime",7,1],["akse",-1,2],["dakse",9,1],["takse",9,1],["site",-1,1],["ksite",12,1],["nuksite",13,1],["n",-1,3],["sin",15,1],["ksin",16,1],["nuksin",17,1],["daks",-1,1],["taks",-1,1]],i=[["aa",-1,-1],["ee",-1,-1],["ii",-1,-1],["oo",-1,-1],["uu",-1,-1],["ää",-1,-1],["õõ",-1,-1],["öö",-1,-1],["üü",-1,-1]],s=[["i",-1,1]],o=[["lane",-1,1],["line",-1,3],["mine",-1,2],["lasse",-1,1],["lisse",-1,3],["misse",-1,2],["lasi",-1,1],["lisi",-1,3],["misi",-1,2],["last",-1,1],["list",-1,3],["mist",-1,2]],k=[["ga",-1,1],["ta",-1,1],["le",-1,1],["sse",-1,1],["l",-1,1],["s",-1,1],["ks",5,1],["t",-1,2],["lt",7,1],["st",7,1]],m=[["",-1,2],["las",0,1],["lis",0,1],["mis",0,1],["t",0,-1]],l=[["d",-1,4],["sid",0,2],["de",-1,4],["ikkude",2,1],["ike",-1,1],["ikke",-1,1],["te",-1,3]],c=[["va",-1,-1],["du",-1,-1],["nu",-1,-1],["tu",-1,-1]],n=[["kk",-1,1],["pp",-1,2],["tt",-1,3]],u=[["ma",-1,2],["mai",-1,1],["m",-1,1]],d=[["joob",-1,1],["jood",-1,1],["joodakse",1,1],["jooma",-1,1],["joomata",3,1],["joome",-1,1],["joon",-1,1],["joote",-1,1],["joovad",-1,1],["juua",-1,1],["juuakse",9,1],["jäi",-1,12],["jäid",11,12],["jäime",11,12],["jäin",11,12],["jäite",11,12],["jääb",-1,12],["jääd",-1,12],["jääda",17,12],["jäädakse",18,12],["jäädi",17,12],["jääks",-1,12],["jääksid",21,12],["jääksime",21,12],["jääksin",21,12],["jääksite",21,12],["jääma",-1,12],["jäämata",26,12],["jääme",-1,12],["jään",-1,12],["jääte",-1,12],["jäävad",-1,12],["jõi",-1,1],["jõid",32,1],["jõime",32,1],["jõin",32,1],["jõite",32,1],["keeb",-1,4],["keed",-1,4],["keedakse",38,4],["keeks",-1,4],["keeksid",40,4],["keeksime",40,4],["keeksin",40,4],["keeksite",40,4],["keema",-1,4],["keemata",45,4],["keeme",-1,4],["keen",-1,4],["kees",-1,4],["keeta",-1,4],["keete",-1,4],["keevad",-1,4],["käia",-1,8],["käiakse",53,8],["käib",-1,8],["käid",-1,8],["käidi",56,8],["käiks",-1,8],["käiksid",58,8],["käiksime",58,8],["käiksin",58,8],["käiksite",58,8],["käima",-1,8],["käimata",63,8],["käime",-1,8],["käin",-1,8],["käis",-1,8],["käite",-1,8],["käivad",-1,8],["laob",-1,16],["laod",-1,16],["laoks",-1,16],["laoksid",72,16],["laoksime",72,16],["laoksin",72,16],["laoksite",72,16],["laome",-1,16],["laon",-1,16],["laote",-1,16],["laovad",-1,16],["loeb",-1,14],["loed",-1,14],["loeks",-1,14],["loeksid",83,14],["loeksime",83,14],["loeksin",83,14],["loeksite",83,14],["loeme",-1,14],["loen",-1,14],["loete",-1,14],["loevad",-1,14],["loob",-1,7],["lood",-1,7],["loodi",93,7],["looks",-1,7],["looksid",95,7],["looksime",95,7],["looksin",95,7],["looksite",95,7],["looma",-1,7],["loomata",100,7],["loome",-1,7],["loon",-1,7],["loote",-1,7],["loovad",-1,7],["luua",-1,7],["luuakse",106,7],["lõi",-1,6],["lõid",108,6],["lõime",108,6],["lõin",108,6],["lõite",108,6],["lööb",-1,5],["lööd",-1,5],["löödakse",114,5],["löödi",114,5],["lööks",-1,5],["lööksid",117,5],["lööksime",117,5],["lööksin",117,5],["lööksite",117,5],["lööma",-1,5],["löömata",122,5],["lööme",-1,5],["löön",-1,5],["lööte",-1,5],["löövad",-1,5],["lüüa",-1,5],["lüüakse",128,5],["müüa",-1,13],["müüakse",130,13],["müüb",-1,13],["müüd",-1,13],["müüdi",133,13],["müüks",-1,13],["müüksid",135,13],["müüksime",135,13],["müüksin",135,13],["müüksite",135,13],["müüma",-1,13],["müümata",140,13],["müüme",-1,13],["müün",-1,13],["müüs",-1,13],["müüte",-1,13],["müüvad",-1,13],["näeb",-1,18],["näed",-1,18],["näeks",-1,18],["näeksid",149,18],["näeksime",149,18],["näeksin",149,18],["näeksite",149,18],["näeme",-1,18],["näen",-1,18],["näete",-1,18],["näevad",-1,18],["nägema",-1,18],["nägemata",158,18],["näha",-1,18],["nähakse",160,18],["nähti",-1,18],["põeb",-1,15],["põed",-1,15],["põeks",-1,15],["põeksid",165,15],["põeksime",165,15],["põeksin",165,15],["põeksite",165,15],["põeme",-1,15],["põen",-1,15],["põete",-1,15],["põevad",-1,15],["saab",-1,2],["saad",-1,2],["saada",175,2],["saadakse",176,2],["saadi",175,2],["saaks",-1,2],["saaksid",179,2],["saaksime",179,2],["saaksin",179,2],["saaksite",179,2],["saama",-1,2],["saamata",184,2],["saame",-1,2],["saan",-1,2],["saate",-1,2],["saavad",-1,2],["sai",-1,2],["said",190,2],["saime",190,2],["sain",190,2],["saite",190,2],["sõi",-1,9],["sõid",195,9],["sõime",195,9],["sõin",195,9],["sõite",195,9],["sööb",-1,9],["sööd",-1,9],["söödakse",201,9],["söödi",201,9],["sööks",-1,9],["sööksid",204,9],["sööksime",204,9],["sööksin",204,9],["sööksite",204,9],["sööma",-1,9],["söömata",209,9],["sööme",-1,9],["söön",-1,9],["sööte",-1,9],["söövad",-1,9],["süüa",-1,9],["süüakse",215,9],["teeb",-1,17],["teed",-1,17],["teeks",-1,17],["teeksid",219,17],["teeksime",219,17],["teeksin",219,17],["teeksite",219,17],["teeme",-1,17],["teen",-1,17],["teete",-1,17],["teevad",-1,17],["tegema",-1,17],["tegemata",228,17],["teha",-1,17],["tehakse",230,17],["tehti",-1,17],["toob",-1,10],["tood",-1,10],["toodi",234,10],["tooks",-1,10],["tooksid",236,10],["tooksime",236,10],["tooksin",236,10],["tooksite",236,10],["tooma",-1,10],["toomata",241,10],["toome",-1,10],["toon",-1,10],["toote",-1,10],["toovad",-1,10],["tuua",-1,10],["tuuakse",247,10],["tõi",-1,10],["tõid",249,10],["tõime",249,10],["tõin",249,10],["tõite",249,10],["viia",-1,3],["viiakse",254,3],["viib",-1,3],["viid",-1,3],["viidi",257,3],["viiks",-1,3],["viiksid",259,3],["viiksime",259,3],["viiksin",259,3],["viiksite",259,3],["viima",-1,3],["viimata",264,3],["viime",-1,3],["viin",-1,3],["viisime",-1,3],["viisin",-1,3],["viisite",-1,3],["viite",-1,3],["viivad",-1,3],["võib",-1,11],["võid",-1,11],["võida",274,11],["võidakse",275,11],["võidi",274,11],["võiks",-1,11],["võiksid",278,11],["võiksime",278,11],["võiksin",278,11],["võiksite",278,11],["võima",-1,11],["võimata",283,11],["võime",-1,11],["võin",-1,11],["võis",-1,11],["võite",-1,11],["võivad",-1,11]],b=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,48,8],_=[17,65,16],f=[117,66,6,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,128,0,0,0,16],v=[21,123,243,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,48,8],w=0;function g(){return 0!=t.find_among_b(i)}function j(){var i=t.limit-t.cursor,i=((()=>{var i;if(!(t.cursor{var i;if(!(t.cursor{var i;if(!(t.cursor{var i;if(!(t.cursor{var i;if(t.bra=t.cursor,0!=(i=t.find_among(d))&&(t.ket=t.cursor,!(t.cursor{var i;if(!(t.cursor{var i;if(!(t.cursor{var i;if(t.in_grouping_b(b,97,252)&&!(w>t.cursor)&&(t.ket=t.cursor,0!=(i=t.find_among_b(n))))switch(t.bra=t.cursor,i){case 1:if(t.slice_from("k"))break;return;case 2:if(t.slice_from("p"))break;return;case 3:if(t.slice_from("t"))break}})(),t.cursor=t.limit-e,t.cursor=t.limit_backward,!0},this.stemWord=function(i){return t.setCurrent(i),this.stem(),t.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/finnish-stemmer.js b/sphinx/search/minified-js/finnish-stemmer.js index f6301fdfa56..160fb267a05 100644 --- a/sphinx/search/minified-js/finnish-stemmer.js +++ b/sphinx/search/minified-js/finnish-stemmer.js @@ -1 +1 @@ -FinnishStemmer=function(){var r=new BaseStemmer;var i=[["pa",-1,1],["sti",-1,2],["kaan",-1,1],["han",-1,1],["kin",-1,1],["hän",-1,1],["kään",-1,1],["ko",-1,1],["pä",-1,1],["kö",-1,1]];var e=[["lla",-1,-1],["na",-1,-1],["ssa",-1,-1],["ta",-1,-1],["lta",3,-1],["sta",3,-1]];var a=[["llä",-1,-1],["nä",-1,-1],["ssä",-1,-1],["tä",-1,-1],["ltä",3,-1],["stä",3,-1]];var s=[["lle",-1,-1],["ine",-1,-1]];var t=[["nsa",-1,3],["mme",-1,3],["nne",-1,3],["ni",-1,2],["si",-1,1],["an",-1,4],["en",-1,6],["än",-1,5],["nsä",-1,3]];var u=[["aa",-1,-1],["ee",-1,-1],["ii",-1,-1],["oo",-1,-1],["uu",-1,-1],["ää",-1,-1],["öö",-1,-1]];var l=[["a",-1,8],["lla",0,-1],["na",0,-1],["ssa",0,-1],["ta",0,-1],["lta",4,-1],["sta",4,-1],["tta",4,2],["lle",-1,-1],["ine",-1,-1],["ksi",-1,-1],["n",-1,7],["han",11,1],["den",11,-1,S],["seen",11,-1,C],["hen",11,2],["tten",11,-1,S],["hin",11,3],["siin",11,-1,S],["hon",11,4],["hän",11,5],["hön",11,6],["ä",-1,8],["llä",22,-1],["nä",22,-1],["ssä",22,-1],["tä",22,-1],["ltä",26,-1],["stä",26,-1],["ttä",26,2]];var c=[["eja",-1,-1],["mma",-1,1],["imma",1,-1],["mpa",-1,1],["impa",3,-1],["mmi",-1,1],["immi",5,-1],["mpi",-1,1],["impi",7,-1],["ejä",-1,-1],["mmä",-1,1],["immä",10,-1],["mpä",-1,1],["impä",12,-1]];var n=[["i",-1,-1],["j",-1,-1]];var f=[["mma",-1,1],["imma",0,-1]];var o=[17,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8];var b=[119,223,119,1];var _=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32];var m=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32];var k=[17,97,24,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32];var d=false;var v="";var w=0;var g=0;function p(){g=r.limit;w=r.limit;r:while(true){var i=r.cursor;i:{if(!r.in_grouping(_,97,246)){break i}r.cursor=i;break r}r.cursor=i;if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){i:{if(!r.out_grouping(_,97,246)){break i}break r}if(r.cursor>=r.limit){return false}r.cursor++}g=r.cursor;r:while(true){var e=r.cursor;i:{if(!r.in_grouping(_,97,246)){break i}r.cursor=e;break r}r.cursor=e;if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){i:{if(!r.out_grouping(_,97,246)){break i}break r}if(r.cursor>=r.limit){return false}r.cursor++}w=r.cursor;return true}function h(){if(!(w<=r.cursor)){return false}return true}function q(){var e;if(r.cursor{var r;if(!(c.cursor{var r;if(!(c.cursor{var r;if(!(c.cursor{var r;if(!(c.cursor{if(!(c.cursor=r.limit){break r}r.cursor++}continue}r.cursor=e;break}return true}function v(){m=r.limit;k=r.limit;b=r.limit;var i=r.cursor;r:{e:{var s=r.cursor;i:{if(!r.in_grouping(o,97,251)){break i}if(!r.in_grouping(o,97,251)){break i}if(r.cursor>=r.limit){break i}r.cursor++;break e}r.cursor=s;i:{if(r.find_among(e)==0){break i}break e}r.cursor=s;if(r.cursor>=r.limit){break r}r.cursor++;i:while(true){s:{if(!r.in_grouping(o,97,251)){break s}break i}if(r.cursor>=r.limit){break r}r.cursor++}}m=r.cursor}r.cursor=i;var a=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(o,97,251)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(o,97,251)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}k=r.cursor;e:while(true){i:{if(!r.in_grouping(o,97,251)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(o,97,251)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}b=r.cursor}r.cursor=a;return true}function d(){var e;while(true){var s=r.cursor;r:{r.bra=r.cursor;e=r.find_among(i);if(e==0){break r}r.ket=r.cursor;switch(e){case 1:if(!r.slice_from("i")){return false}break;case 2:if(!r.slice_from("u")){return false}break;case 3:if(!r.slice_from("y")){return false}break;case 4:if(!r.slice_from("ë")){return false}break;case 5:if(!r.slice_from("ï")){return false}break;case 6:if(!r.slice_del()){return false}break;case 7:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}return true}function g(){if(!(m<=r.cursor)){return false}return true}function w(){if(!(k<=r.cursor)){return false}return true}function q(){if(!(b<=r.cursor)){return false}return true}function h(){var e;r.ket=r.cursor;e=r.find_among_b(u);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!q()){return false}if(!r.slice_del()){return false}break;case 2:if(!q()){return false}if(!r.slice_del()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("ic")){r.cursor=r.limit-i;break r}r.bra=r.cursor;e:{var t=r.limit-r.cursor;i:{if(!q()){break i}if(!r.slice_del()){return false}break e}r.cursor=r.limit-t;if(!r.slice_from("iqU")){return false}}}break;case 3:if(!q()){return false}if(!r.slice_from("log")){return false}break;case 4:if(!q()){return false}if(!r.slice_from("u")){return false}break;case 5:if(!q()){return false}if(!r.slice_from("ent")){return false}break;case 6:if(!g()){return false}if(!r.slice_del()){return false}var c=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(s);if(e==0){r.cursor=r.limit-c;break r}r.bra=r.cursor;switch(e){case 1:if(!q()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-c;break r}r.bra=r.cursor;if(!q()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}break;case 2:e:{var f=r.limit-r.cursor;i:{if(!q()){break i}if(!r.slice_del()){return false}break e}r.cursor=r.limit-f;if(!w()){r.cursor=r.limit-c;break r}if(!r.slice_from("eux")){return false}}break;case 3:if(!q()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}break;case 4:if(!g()){r.cursor=r.limit-c;break r}if(!r.slice_from("i")){return false}break}}break;case 7:if(!q()){return false}if(!r.slice_del()){return false}var l=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(a);if(e==0){r.cursor=r.limit-l;break r}r.bra=r.cursor;switch(e){case 1:e:{var n=r.limit-r.cursor;i:{if(!q()){break i}if(!r.slice_del()){return false}break e}r.cursor=r.limit-n;if(!r.slice_from("abl")){return false}}break;case 2:e:{var b=r.limit-r.cursor;i:{if(!q()){break i}if(!r.slice_del()){return false}break e}r.cursor=r.limit-b;if(!r.slice_from("iqU")){return false}}break;case 3:if(!q()){r.cursor=r.limit-l;break r}if(!r.slice_del()){return false}break}}break;case 8:if(!q()){return false}if(!r.slice_del()){return false}var k=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-k;break r}r.bra=r.cursor;if(!q()){r.cursor=r.limit-k;break r}if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("ic")){r.cursor=r.limit-k;break r}r.bra=r.cursor;e:{var m=r.limit-r.cursor;i:{if(!q()){break i}if(!r.slice_del()){return false}break e}r.cursor=r.limit-m;if(!r.slice_from("iqU")){return false}}}break;case 9:if(!r.slice_from("eau")){return false}break;case 10:if(!w()){return false}if(!r.slice_from("al")){return false}break;case 11:r:{var _=r.limit-r.cursor;e:{if(!q()){break e}if(!r.slice_del()){return false}break r}r.cursor=r.limit-_;if(!w()){return false}if(!r.slice_from("eux")){return false}}break;case 12:if(!w()){return false}if(!r.out_grouping_b(o,97,251)){return false}if(!r.slice_del()){return false}break;case 13:if(!g()){return false}if(!r.slice_from("ant")){return false}return false;case 14:if(!g()){return false}if(!r.slice_from("ent")){return false}return false;case 15:var v=r.limit-r.cursor;if(!r.in_grouping_b(o,97,251)){return false}if(!g()){return false}r.cursor=r.limit-v;if(!r.slice_del()){return false}return false}return true}function p(){if(r.cursor0){return false}}r.ket=r.cursor;r:{var i=r.limit-r.cursor;e:{if(!r.eq_s_b("é")){break e}break r}r.cursor=r.limit-i;if(!r.eq_s_b("è")){return false}}r.bra=r.cursor;if(!r.slice_from("e")){return false}return true}this.stem=function(){var e=r.cursor;_();r.cursor=e;v();r.limit_backward=r.cursor;r.cursor=r.limit;var i=r.limit-r.cursor;r:{e:{var s=r.limit-r.cursor;i:{var a=r.limit-r.cursor;s:{var u=r.limit-r.cursor;a:{if(!h()){break a}break s}r.cursor=r.limit-u;a:{if(!p()){break a}break s}r.cursor=r.limit-u;if(!z()){break i}}r.cursor=r.limit-a;var t=r.limit-r.cursor;s:{r.ket=r.cursor;a:{var c=r.limit-r.cursor;u:{if(!r.eq_s_b("Y")){break u}r.bra=r.cursor;if(!r.slice_from("i")){return false}break a}r.cursor=r.limit-c;if(!r.eq_s_b("ç")){r.cursor=r.limit-t;break s}r.bra=r.cursor;if(!r.slice_from("c")){return false}}}break e}r.cursor=r.limit-s;if(!I()){break r}}}r.cursor=r.limit-i;var f=r.limit-r.cursor;U();r.cursor=r.limit-f;var l=r.limit-r.cursor;H();r.cursor=r.limit-l;r.cursor=r.limit_backward;var o=r.cursor;d();r.cursor=o;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}}; \ No newline at end of file +var FrenchStemmer=function(){var n=new BaseStemmer,f=[["col",-1,-1],["ni",-1,1],["par",-1,-1],["tap",-1,-1]],_=[["",-1,7],["H",0,6],["He",1,4],["Hi",1,5],["I",0,1],["U",0,2],["Y",0,3]],m=[["iqU",-1,3],["abl",-1,3],["Ièr",-1,4],["ièr",-1,4],["eus",-1,2],["iv",-1,1]],b=[["ic",-1,2],["abil",-1,1],["iv",-1,3]],k=[["iqUe",-1,1],["atrice",-1,2],["ance",-1,1],["ence",-1,5],["logie",-1,3],["able",-1,1],["isme",-1,1],["euse",-1,12],["iste",-1,1],["ive",-1,8],["if",-1,8],["usion",-1,4],["ation",-1,2],["ution",-1,4],["ateur",-1,2],["iqUes",-1,1],["atrices",-1,2],["ances",-1,1],["ences",-1,5],["logies",-1,3],["ables",-1,1],["ismes",-1,1],["euses",-1,12],["istes",-1,1],["ives",-1,8],["ifs",-1,8],["usions",-1,4],["ations",-1,2],["utions",-1,4],["ateurs",-1,2],["ments",-1,16],["ements",30,6],["issements",31,13],["ités",-1,7],["ment",-1,16],["ement",34,6],["issement",35,13],["amment",34,14],["emment",34,15],["aux",-1,10],["eaux",39,9],["eux",-1,1],["oux",-1,11],["ité",-1,7]],d=[["ira",-1,1],["ie",-1,1],["isse",-1,1],["issante",-1,1],["i",-1,1],["irai",4,1],["ir",-1,1],["iras",-1,1],["ies",-1,1],["îmes",-1,1],["isses",-1,1],["issantes",-1,1],["îtes",-1,1],["is",-1,1],["irais",13,1],["issais",13,1],["irions",-1,1],["issions",-1,1],["irons",-1,1],["issons",-1,1],["issants",-1,1],["it",-1,1],["irait",21,1],["issait",21,1],["issant",-1,1],["iraIent",-1,1],["issaIent",-1,1],["irent",-1,1],["issent",-1,1],["iront",-1,1],["ît",-1,1],["iriez",-1,1],["issiez",-1,1],["irez",-1,1],["issez",-1,1]],g=[["al",-1,1],["épl",-1,-1],["auv",-1,-1]],v=[["a",-1,3],["era",0,2],["aise",-1,4],["asse",-1,3],["ante",-1,3],["ée",-1,2],["ai",-1,3],["erai",6,2],["er",-1,2],["as",-1,3],["eras",9,2],["âmes",-1,3],["aises",-1,4],["asses",-1,3],["antes",-1,3],["âtes",-1,3],["ées",-1,2],["ais",-1,4],["eais",17,2],["erais",17,2],["ions",-1,1],["erions",20,2],["assions",20,3],["erons",-1,2],["ants",-1,3],["és",-1,2],["ait",-1,3],["erait",26,2],["ant",-1,3],["aIent",-1,3],["eraIent",29,2],["èrent",-1,2],["assent",-1,3],["eront",-1,2],["ât",-1,3],["ez",-1,2],["iez",35,2],["eriez",36,2],["assiez",36,3],["erez",35,2],["é",-1,2]],q=[["e",-1,3],["Ière",0,2],["ière",0,2],["ion",-1,1],["Ier",-1,2],["ier",-1,2]],w=[["ell",-1,-1],["eill",-1,-1],["enn",-1,-1],["onn",-1,-1],["ett",-1,-1]],p=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,128,130,103,8,5],h=[65,85],z=[131,14,3],I=[1,65,20,0,0,0,0,0,0,0,0,0,0,0,0,0,128],U=0,H=0,x=0;function Y(){return x<=n.cursor}function y(){return H<=n.cursor}function C(){return U<=n.cursor}this.stem=function(){var r=n.cursor,i=(n.bra=n.cursor,i=n.cursor,(n.in_grouping(z,99,116)||(n.cursor=i,n.eq_s("qu")))&&n.eq_s("'")&&(n.ket=n.cursor,n.cursor{for(;;){var r=n.cursor;r:{for(;;){var i=n.cursor;i:{e:{var e=n.cursor;s:if(n.in_grouping(p,97,251)){n.bra=n.cursor;c:{var s=n.cursor;if(n.eq_s("u")&&(n.ket=n.cursor,n.in_grouping(p,97,251))){if(n.slice_from("U"))break c;return}if(n.cursor=s,n.eq_s("i")&&(n.ket=n.cursor,n.in_grouping(p,97,251))){if(n.slice_from("I"))break c;return}if(n.cursor=s,!n.eq_s("y"))break s;if(n.ket=n.cursor,!n.slice_from("Y"))return}break e}if(n.cursor=e,n.bra=n.cursor,n.eq_s("ë")){if(n.ket=n.cursor,n.slice_from("He"))break e;return}if(n.cursor=e,n.bra=n.cursor,n.eq_s("ï")){if(n.ket=n.cursor,n.slice_from("Hi"))break e;return}if(n.cursor=e,n.bra=n.cursor,n.eq_s("y")&&(n.ket=n.cursor,n.in_grouping(p,97,251))){if(n.slice_from("Y"))break e;return}if(n.cursor=e,!n.eq_s("q"))break i;if(n.bra=n.cursor,!n.eq_s("u"))break i;if(n.ket=n.cursor,!n.slice_from("U"))return}n.cursor=i;break}if(n.cursor=i,n.cursor>=n.limit)break r;n.cursor++}continue}n.cursor=r;break}})(),n.cursor=i,x=n.limit,H=n.limit,U=n.limit;var e,r=n.cursor;r:{i:{var s=n.cursor;if(!n.in_grouping(p,97,251)||!n.in_grouping(p,97,251)||n.cursor>=n.limit){n.cursor=s;e:if(0!=(e=n.find_among(f))){switch(e){case 1:if(n.in_grouping(p,97,251))break;break e}break i}if(n.cursor=s,n.cursor>=n.limit)break r;if(n.cursor++,!n.go_out_grouping(p,97,251))break r}n.cursor++}x=n.cursor}n.cursor=r,r=n.cursor,n.go_out_grouping(p,97,251)&&(n.cursor++,n.go_in_grouping(p,97,251))&&(n.cursor++,H=n.cursor,n.go_out_grouping(p,97,251))&&(n.cursor++,n.go_in_grouping(p,97,251))&&(n.cursor++,U=n.cursor),n.cursor=r,n.limit_backward=n.cursor,n.cursor=n.limit;i=n.limit-n.cursor;r:{var c=n.limit-n.cursor,u=n.limit-n.cursor,t=n.limit-n.cursor;if((()=>{var r;if(n.ket=n.cursor,0!=(r=n.find_among_b(k))){switch(n.bra=n.cursor,r){case 1:if(!C())return;if(n.slice_del())break;return;case 2:if(!C())return;if(!n.slice_del())return;var i=n.limit-n.cursor;if(n.ket=n.cursor,n.eq_s_b("ic")){n.bra=n.cursor;i:{var e=n.limit-n.cursor;if(C()){if(n.slice_del())break i;return}if(n.cursor=n.limit-e,!n.slice_from("iqU"))return}}else n.cursor=n.limit-i;break;case 3:if(!C())return;if(n.slice_from("log"))break;return;case 4:if(!C())return;if(n.slice_from("u"))break;return;case 5:if(!C())return;if(n.slice_from("ent"))break;return;case 6:if(!Y())return;if(!n.slice_del())return;var s=n.limit-n.cursor;i:if(n.ket=n.cursor,0==(r=n.find_among_b(m)))n.cursor=n.limit-s;else switch(n.bra=n.cursor,r){case 1:if(!C()){n.cursor=n.limit-s;break i}if(!n.slice_del())return;if(n.ket=n.cursor,!n.eq_s_b("at")){n.cursor=n.limit-s;break i}if(n.bra=n.cursor,!C()){n.cursor=n.limit-s;break i}if(n.slice_del())break;return;case 2:e:{var c=n.limit-n.cursor;if(C()){if(n.slice_del())break e;return}if(n.cursor=n.limit-c,!y()){n.cursor=n.limit-s;break i}if(!n.slice_from("eux"))return}break;case 3:if(!C()){n.cursor=n.limit-s;break i}if(n.slice_del())break;return;case 4:if(!Y()){n.cursor=n.limit-s;break i}if(n.slice_from("i"))break;return}break;case 7:if(!C())return;if(!n.slice_del())return;var u=n.limit-n.cursor;i:if(n.ket=n.cursor,0==(r=n.find_among_b(b)))n.cursor=n.limit-u;else switch(n.bra=n.cursor,r){case 1:e:{var t=n.limit-n.cursor;if(C()){if(n.slice_del())break e;return}if(n.cursor=n.limit-t,!n.slice_from("abl"))return}break;case 2:e:{var o=n.limit-n.cursor;if(C()){if(n.slice_del())break e;return}if(n.cursor=n.limit-o,!n.slice_from("iqU"))return}break;case 3:if(!C()){n.cursor=n.limit-u;break i}if(n.slice_del())break;return}break;case 8:if(!C())return;if(!n.slice_del())return;i=n.limit-n.cursor;if(n.ket=n.cursor,n.eq_s_b("at"))if(n.bra=n.cursor,C()){if(!n.slice_del())return;if(n.ket=n.cursor,n.eq_s_b("ic")){n.bra=n.cursor;i:{var a=n.limit-n.cursor;if(C()){if(n.slice_del())break i;return}if(n.cursor=n.limit-a,!n.slice_from("iqU"))return}}else n.cursor=n.limit-i}else n.cursor=n.limit-i;else n.cursor=n.limit-i;break;case 9:if(n.slice_from("eau"))break;return;case 10:if(!y())return;if(n.slice_from("al"))break;return;case 11:if(!n.in_grouping_b(h,98,112))return;if(n.slice_from("ou"))break;return;case 12:i:{var l=n.limit-n.cursor;if(C()){if(n.slice_del())break i;return}if(n.cursor=n.limit-l,!y())return;if(!n.slice_from("eux"))return}break;case 13:if(!y())return;if(!n.out_grouping_b(p,97,251))return;if(n.slice_del())break;return;case 14:return Y()?void n.slice_from("ant"):void 0;case 15:return Y()?void n.slice_from("ent"):void 0;case 16:i=n.limit-n.cursor;return n.in_grouping_b(p,97,251)?Y()&&(n.cursor=n.limit-i,void n.slice_del()):void 0}return 1}})()||(n.cursor=n.limit-t,(()=>{if(!(n.cursor{var r;if(!(n.cursorn.limit_backward)break i}return}if(n.cursor=n.limit-e,n.slice_del())break;return}return 1}n.limit_backward=i}})())){n.cursor=n.limit-u;var o=n.limit-n.cursor;i:{n.ket=n.cursor;e:{var a=n.limit-n.cursor;if(n.eq_s_b("Y")){if(n.bra=n.cursor,n.slice_from("i"))break e;return!1}if(n.cursor=n.limit-a,!n.eq_s_b("ç")){n.cursor=n.limit-o;break i}if(n.bra=n.cursor,!n.slice_from("c"))return!1}}}else if(n.cursor=n.limit-c,!(()=>{var r=n.limit-n.cursor;if(n.ket=n.cursor,n.eq_s_b("s")){n.bra=n.cursor;var i=n.limit-n.cursor,e=n.limit-n.cursor;if(n.eq_s_b("Hi")||(n.cursor=n.limit-e,n.out_grouping_b(I,97,232))){if(n.cursor=n.limit-i,!n.slice_del())return}else n.cursor=n.limit-r}else n.cursor=n.limit-r;if(!(n.cursor{for(var r;;){var i=n.cursor;r:{switch(n.bra=n.cursor,r=n.find_among(_),n.ket=n.cursor,r){case 1:if(n.slice_from("i"))break;return;case 2:if(n.slice_from("u"))break;return;case 3:if(n.slice_from("y"))break;return;case 4:if(n.slice_from("ë"))break;return;case 5:if(n.slice_from("ï"))break;return;case 6:if(n.slice_del())break;return;case 7:if(n.cursor>=n.limit)break r;n.cursor++}continue}n.cursor=i;break}})(),n.cursor=r,!0},this.stemWord=function(r){return n.setCurrent(r),this.stem(),n.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/german-stemmer.js b/sphinx/search/minified-js/german-stemmer.js index e2a335d15e0..da15f9e8f71 100644 --- a/sphinx/search/minified-js/german-stemmer.js +++ b/sphinx/search/minified-js/german-stemmer.js @@ -1 +1 @@ -GermanStemmer=function(){var r=new BaseStemmer;var e=[["",-1,5],["U",0,2],["Y",0,1],["ä",0,3],["ö",0,4],["ü",0,2]];var i=[["e",-1,2],["em",-1,1],["en",-1,2],["ern",-1,1],["er",-1,1],["s",-1,3],["es",5,2]];var s=[["en",-1,1],["er",-1,1],["st",-1,2],["est",2,1]];var u=[["ig",-1,1],["lich",-1,1]];var a=[["end",-1,1],["ig",-1,2],["ung",-1,1],["lich",-1,3],["isch",-1,2],["ik",-1,2],["heit",-1,3],["keit",-1,4]];var c=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32,8];var t=[117,30,5];var o=[117,30,4];var f=0;var l=0;var n=0;function b(){var e=r.cursor;while(true){var i=r.cursor;r:{e:{var s=r.cursor;i:{r.bra=r.cursor;if(!r.eq_s("ß")){break i}r.ket=r.cursor;if(!r.slice_from("ss")){return false}break e}r.cursor=s;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=i;break}r.cursor=e;while(true){var u=r.cursor;r:{e:while(true){var a=r.cursor;i:{if(!r.in_grouping(c,97,252)){break i}r.bra=r.cursor;s:{var t=r.cursor;u:{if(!r.eq_s("u")){break u}r.ket=r.cursor;if(!r.in_grouping(c,97,252)){break u}if(!r.slice_from("U")){return false}break s}r.cursor=t;if(!r.eq_s("y")){break i}r.ket=r.cursor;if(!r.in_grouping(c,97,252)){break i}if(!r.slice_from("Y")){return false}}r.cursor=a;break e}r.cursor=a;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=u;break}return true}function k(){n=r.limit;l=r.limit;var e=r.cursor;{var i=r.cursor+3;if(i>r.limit){return false}r.cursor=i}f=r.cursor;r.cursor=e;r:while(true){e:{if(!r.in_grouping(c,97,252)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(c,97,252)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}n=r.cursor;r:{if(!(n=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(c,97,252)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}l=r.cursor;return true}function m(){var i;while(true){var s=r.cursor;r:{r.bra=r.cursor;i=r.find_among(e);if(i==0){break r}r.ket=r.cursor;switch(i){case 1:if(!r.slice_from("y")){return false}break;case 2:if(!r.slice_from("u")){return false}break;case 3:if(!r.slice_from("a")){return false}break;case 4:if(!r.slice_from("o")){return false}break;case 5:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}return true}function _(){if(!(n<=r.cursor)){return false}return true}function v(){if(!(l<=r.cursor)){return false}return true}function g(){var e;var c=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(i);if(e==0){break r}r.bra=r.cursor;if(!_()){break r}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}var f=r.limit-r.cursor;e:{r.ket=r.cursor;if(!r.eq_s_b("s")){r.cursor=r.limit-f;break e}r.bra=r.cursor;if(!r.eq_s_b("nis")){r.cursor=r.limit-f;break e}if(!r.slice_del()){return false}}break;case 3:if(!r.in_grouping_b(t,98,116)){break r}if(!r.slice_del()){return false}break}}r.cursor=r.limit-c;var l=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(s);if(e==0){break r}r.bra=r.cursor;if(!_()){break r}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.in_grouping_b(o,98,116)){break r}{var n=r.cursor-3;if(n{for(var r,i=n.cursor;;){var e=n.cursor;r:{for(;;){var s=n.cursor;i:if(n.in_grouping(t,97,252)){n.bra=n.cursor;e:{var c=n.cursor;if(n.eq_s("u")&&(n.ket=n.cursor,n.in_grouping(t,97,252))){if(n.slice_from("U"))break e;return}if(n.cursor=c,!n.eq_s("y"))break i;if(n.ket=n.cursor,!n.in_grouping(t,97,252))break i;if(!n.slice_from("Y"))return}n.cursor=s;break}if(n.cursor=s,n.cursor>=n.limit)break r;n.cursor++}continue}n.cursor=e;break}for(n.cursor=i;;){var u=n.cursor;r:{switch(n.bra=n.cursor,r=n.find_among(o),n.ket=n.cursor,r){case 1:if(n.slice_from("ss"))break;return;case 2:if(n.slice_from("ä"))break;return;case 3:if(n.slice_from("ö"))break;return;case 4:if(n.slice_from("ü"))break;return;case 5:if(n.cursor>=n.limit)break r;n.cursor++}continue}n.cursor=u;break}})(),n.cursor=i,n.cursor),e=(a=n.limit,u=n.limit,r=n.cursor,(e=n.cursor+3)>n.limit||(n.cursor=e,c=n.cursor,n.cursor=r,n.go_out_grouping(t,97,252)&&(n.cursor++,n.go_in_grouping(t,97,252))&&(n.cursor++,a=n.cursor,c<=a||(a=c),n.go_out_grouping(t,97,252))&&(n.cursor++,n.go_in_grouping(t,97,252))&&(n.cursor++,u=n.cursor)),n.cursor=i,n.limit_backward=n.cursor,n.cursor=n.limit,(()=>{var r,i=n.limit-n.cursor;r:if(n.ket=n.cursor,0!=(r=n.find_among_b(l))&&(n.bra=n.cursor,v()))switch(r){case 1:var e=n.limit-n.cursor;if(n.eq_s_b("syst"))break r;if(n.cursor=n.limit-e,n.slice_del())break;return;case 2:if(n.slice_del())break;return;case 3:if(!n.slice_del())return;e=n.limit-n.cursor;if(n.ket=n.cursor,n.eq_s_b("s"))if(n.bra=n.cursor,n.eq_s_b("nis")){if(!n.slice_del())return}else n.cursor=n.limit-e;else n.cursor=n.limit-e;break;case 4:if(!n.in_grouping_b(g,98,116))break r;if(n.slice_del())break;return;case 5:if(n.slice_from("l"))break;return}n.cursor=n.limit-i,i=n.limit-n.cursor;r:if(n.ket=n.cursor,0!=(r=n.find_among_b(_))&&(n.bra=n.cursor,v()))switch(r){case 1:if(n.slice_del())break;return;case 2:if(!n.in_grouping_b(d,98,116))break r;var s=n.cursor-3;if(s{for(var r;;){var i=n.cursor;r:{switch(n.bra=n.cursor,r=n.find_among(s),n.ket=n.cursor,r){case 1:if(n.slice_from("y"))break;return;case 2:if(n.slice_from("u"))break;return;case 3:if(n.slice_from("a"))break;return;case 4:if(n.slice_from("o"))break;return;case 5:if(n.cursor>=n.limit)break r;n.cursor++}continue}n.cursor=i;break}})(),n.cursor=e,!0},this.stemWord=function(r){return n.setCurrent(r),this.stem(),n.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/greek-stemmer.js b/sphinx/search/minified-js/greek-stemmer.js new file mode 100644 index 00000000000..d02a30bf1fe --- /dev/null +++ b/sphinx/search/minified-js/greek-stemmer.js @@ -0,0 +1 @@ +var GreekStemmer=function(){var s=new BaseStemmer,e=[["",-1,25],["Ά",0,1],["Έ",0,5],["Ή",0,7],["Ί",0,9],["Ό",0,15],["Ύ",0,20],["Ώ",0,24],["ΐ",0,7],["Α",0,1],["Β",0,2],["Γ",0,3],["Δ",0,4],["Ε",0,5],["Ζ",0,6],["Η",0,7],["Θ",0,8],["Ι",0,9],["Κ",0,10],["Λ",0,11],["Μ",0,12],["Ν",0,13],["Ξ",0,14],["Ο",0,15],["Π",0,16],["Ρ",0,17],["Σ",0,18],["Τ",0,19],["Υ",0,20],["Φ",0,21],["Χ",0,22],["Ψ",0,23],["Ω",0,24],["Ϊ",0,9],["Ϋ",0,20],["ά",0,1],["έ",0,5],["ή",0,7],["ί",0,9],["ΰ",0,20],["ς",0,18],["ϊ",0,7],["ϋ",0,20],["ό",0,15],["ύ",0,20],["ώ",0,24]],o=[["σκαγια",-1,2],["φαγια",-1,1],["ολογια",-1,3],["σογια",-1,4],["τατογια",-1,5],["κρεατα",-1,6],["περατα",-1,7],["τερατα",-1,8],["γεγονοτα",-1,11],["καθεστωτα",-1,10],["φωτα",-1,9],["περατη",-1,7],["σκαγιων",-1,2],["φαγιων",-1,1],["ολογιων",-1,3],["σογιων",-1,4],["τατογιων",-1,5],["κρεατων",-1,6],["περατων",-1,7],["τερατων",-1,8],["γεγονοτων",-1,11],["καθεστωτων",-1,10],["φωτων",-1,9],["κρεασ",-1,6],["περασ",-1,7],["τερασ",-1,8],["γεγονοσ",-1,11],["κρεατοσ",-1,6],["περατοσ",-1,7],["τερατοσ",-1,8],["γεγονοτοσ",-1,11],["καθεστωτοσ",-1,10],["φωτοσ",-1,9],["καθεστωσ",-1,10],["φωσ",-1,9],["σκαγιου",-1,2],["φαγιου",-1,1],["ολογιου",-1,3],["σογιου",-1,4],["τατογιου",-1,5]],u=[["πα",-1,1],["ξαναπα",0,1],["επα",0,1],["περιπα",0,1],["αναμπα",0,1],["εμπα",0,1],["β",-1,2],["δανε",-1,1],["βαθυρι",-1,2],["βαρκ",-1,2],["μαρκ",-1,2],["λ",-1,2],["μ",-1,2],["κορν",-1,2],["αθρο",-1,1],["συναθρο",14,1],["π",-1,2],["ιμπ",16,2],["ρ",-1,2],["μαρ",18,2],["αμπαρ",18,2],["γκρ",18,2],["βολβορ",18,2],["γλυκορ",18,2],["πιπερορ",18,2],["πρ",18,2],["μπρ",25,2],["αρρ",18,2],["γλυκυρ",18,2],["πολυρ",18,2],["λου",-1,2]],a=[["ιζα",-1,1],["ιζε",-1,1],["ιζαμε",-1,1],["ιζουμε",-1,1],["ιζανε",-1,1],["ιζουνε",-1,1],["ιζατε",-1,1],["ιζετε",-1,1],["ιζει",-1,1],["ιζαν",-1,1],["ιζουν",-1,1],["ιζεσ",-1,1],["ιζεισ",-1,1],["ιζω",-1,1]],t=[["βι",-1,1],["λι",-1,1],["αλ",-1,1],["εν",-1,1],["σ",-1,1],["χ",-1,1],["υψ",-1,1],["ζω",-1,1]],_=[["ωθηκα",-1,1],["ωθηκε",-1,1],["ωθηκαμε",-1,1],["ωθηκανε",-1,1],["ωθηκατε",-1,1],["ωθηκαν",-1,1],["ωθηκεσ",-1,1]],l=[["ξαναπα",-1,1],["επα",-1,1],["περιπα",-1,1],["αναμπα",-1,1],["εμπα",-1,1],["χαρτοπα",-1,1],["εξαρχα",-1,1],["γε",-1,2],["γκε",-1,2],["κλε",-1,1],["εκλε",9,1],["απεκλε",10,1],["αποκλε",9,1],["εσωκλε",9,1],["δανε",-1,1],["πε",-1,1],["επε",15,1],["μετεπε",16,1],["εσε",-1,1],["γκ",-1,2],["μ",-1,2],["πουκαμ",20,2],["κομ",20,2],["αν",-1,2],["ολο",-1,2],["αθρο",-1,1],["συναθρο",25,1],["π",-1,2],["λαρ",-1,2],["δημοκρατ",-1,2],["αφ",-1,2],["γιγαντοαφ",30,2]],m=[["ισα",-1,1],["ισαμε",-1,1],["ισανε",-1,1],["ισε",-1,1],["ισατε",-1,1],["ισαν",-1,1],["ισεσ",-1,1]],f=[["ξαναπα",-1,1],["επα",-1,1],["περιπα",-1,1],["αναμπα",-1,1],["εμπα",-1,1],["χαρτοπα",-1,1],["εξαρχα",-1,1],["κλε",-1,1],["εκλε",7,1],["απεκλε",8,1],["αποκλε",7,1],["εσωκλε",7,1],["δανε",-1,1],["πε",-1,1],["επε",13,1],["μετεπε",14,1],["εσε",-1,1],["αθρο",-1,1],["συναθρο",17,1]],b=[["ισουμε",-1,1],["ισουνε",-1,1],["ισετε",-1,1],["ισει",-1,1],["ισουν",-1,1],["ισεισ",-1,1],["ισω",-1,1]],n=[["ατα",-1,2],["φα",-1,2],["ηφα",1,2],["μεγ",-1,2],["λυγ",-1,2],["ηδ",-1,2],["κλε",-1,1],["εσωκλε",6,1],["πλε",-1,1],["δανε",-1,1],["σε",-1,1],["ασε",10,1],["καθ",-1,2],["εχθ",-1,2],["κακ",-1,2],["μακ",-1,2],["σκ",-1,2],["φιλ",-1,2],["κυλ",-1,2],["μ",-1,2],["γεμ",19,2],["αχν",-1,2],["συναθρο",-1,1],["π",-1,2],["απ",23,2],["εμπ",23,2],["ευπ",23,2],["αρ",-1,2],["αορ",-1,2],["γυρ",-1,2],["χρ",-1,2],["χωρ",-1,2],["κτ",-1,2],["ακτ",32,2],["χτ",-1,2],["αχτ",34,2],["ταχ",-1,2],["σχ",-1,2],["ασχ",37,2],["υψ",-1,2]],k=[["ιστα",-1,1],["ιστε",-1,1],["ιστη",-1,1],["ιστοι",-1,1],["ιστων",-1,1],["ιστο",-1,1],["ιστεσ",-1,1],["ιστησ",-1,1],["ιστοσ",-1,1],["ιστουσ",-1,1],["ιστου",-1,1]],d=[["εγκλε",-1,1],["αποκλε",-1,1],["δανε",-1,2],["αντιδανε",2,2],["σε",-1,1],["μετασε",4,1],["μικροσε",4,1]],g=[["ατομικ",-1,2],["εθνικ",-1,4],["τοπικ",-1,7],["εκλεκτικ",-1,5],["σκεπτικ",-1,6],["γνωστικ",-1,3],["αγνωστικ",5,1],["αλεξανδριν",-1,8],["θεατριν",-1,10],["βυζαντιν",-1,9]],w=[["ισμοι",-1,1],["ισμων",-1,1],["ισμο",-1,1],["ισμοσ",-1,1],["ισμουσ",-1,1],["ισμου",-1,1]],v=[["σ",-1,1],["χ",-1,1]],h=[["ουδακια",-1,1],["αρακια",-1,1],["ουδακι",-1,1],["αρακι",-1,1]],q=[["β",-1,2],["βαμβ",0,1],["σλοβ",0,1],["τσεχοσλοβ",2,1],["καρδ",-1,2],["ζ",-1,2],["τζ",5,1],["κ",-1,1],["καπακ",7,1],["σοκ",7,1],["σκ",7,1],["βαλ",-1,2],["μαλ",-1,1],["γλ",-1,2],["τριπολ",-1,2],["πλ",-1,1],["λουλ",-1,1],["φυλ",-1,1],["καιμ",-1,1],["κλιμ",-1,1],["φαρμ",-1,1],["γιαν",-1,2],["σπαν",-1,1],["ηγουμεν",-1,2],["κον",-1,1],["μακρυν",-1,2],["π",-1,2],["κατραπ",26,1],["ρ",-1,1],["βρ",28,1],["λαβρ",29,1],["αμβρ",29,1],["μερ",28,1],["πατερ",28,2],["ανθρ",28,1],["κορ",28,1],["σ",-1,1],["ναγκασ",36,1],["τοσ",36,2],["μουστ",-1,1],["ρυ",-1,1],["φ",-1,1],["σφ",41,1],["αλισφ",42,1],["νυφ",41,2],["χ",-1,1]],p=[["ακια",-1,1],["αρακια",0,1],["ιτσα",-1,1],["ακι",-1,1],["αρακι",3,1],["ιτσων",-1,1],["ιτσασ",-1,1],["ιτσεσ",-1,1]],C=[["ψαλ",-1,1],["αιφν",-1,1],["ολο",-1,1],["ιρ",-1,1]],S=[["ε",-1,1],["παιχν",-1,1]],B=[["ιδια",-1,1],["ιδιων",-1,1],["ιδιο",-1,1]],G=[["ιβ",-1,1],["δ",-1,1],["φραγκ",-1,1],["λυκ",-1,1],["οβελ",-1,1],["μην",-1,1],["ρ",-1,1]],W=[["ισκε",-1,1],["ισκο",-1,1],["ισκοσ",-1,1],["ισκου",-1,1]],j=[["αδων",-1,1],["αδεσ",-1,1]],x=[["γιαγι",-1,-1],["θει",-1,-1],["οκ",-1,-1],["μαμ",-1,-1],["μαν",-1,-1],["μπαμπ",-1,-1],["πεθερ",-1,-1],["πατερ",-1,-1],["κυρ",-1,-1],["νταντ",-1,-1]],y=[["εδων",-1,1],["εδεσ",-1,1]],z=[["μιλ",-1,1],["δαπ",-1,1],["γηπ",-1,1],["ιπ",-1,1],["εμπ",-1,1],["οπ",-1,1],["κρασπ",-1,1],["υπ",-1,1]],A=[["ουδων",-1,1],["ουδεσ",-1,1]],D=[["τραγ",-1,1],["φε",-1,1],["καλιακ",-1,1],["αρκ",-1,1],["σκ",-1,1],["πεταλ",-1,1],["βελ",-1,1],["λουλ",-1,1],["φλ",-1,1],["χν",-1,1],["πλεξ",-1,1],["σπ",-1,1],["φρ",-1,1],["σ",-1,1],["λιχ",-1,1]],E=[["εων",-1,1],["εωσ",-1,1]],F=[["δ",-1,1],["ιδ",0,1],["θ",-1,1],["γαλ",-1,1],["ελ",-1,1],["ν",-1,1],["π",-1,1],["παρ",-1,1]],K=[["ια",-1,1],["ιων",-1,1],["ιου",-1,1]],L=[["ικα",-1,1],["ικων",-1,1],["ικο",-1,1],["ικου",-1,1]],M=[["αδ",-1,1],["συναδ",0,1],["καταδ",0,1],["αντιδ",-1,1],["ενδ",-1,1],["φυλοδ",-1,1],["υποδ",-1,1],["πρωτοδ",-1,1],["εξωδ",-1,1],["ηθ",-1,1],["ανηθ",9,1],["ξικ",-1,1],["αλ",-1,1],["αμμοχαλ",12,1],["συνομηλ",-1,1],["μπολ",-1,1],["μουλ",-1,1],["τσαμ",-1,1],["βρωμ",-1,1],["αμαν",-1,1],["μπαν",-1,1],["καλλιν",-1,1],["ποστελν",-1,1],["φιλον",-1,1],["καλπ",-1,1],["γερ",-1,1],["χασ",-1,1],["μποσ",-1,1],["πλιατσ",-1,1],["πετσ",-1,1],["πιτσ",-1,1],["φυσ",-1,1],["μπαγιατ",-1,1],["νιτ",-1,1],["πικαντ",-1,1],["σερτ",-1,1]],N=[["αγαμε",-1,1],["ηκαμε",-1,1],["ηθηκαμε",1,1],["ησαμε",-1,1],["ουσαμε",-1,1]],O=[["βουβ",-1,1],["ξεθ",-1,1],["πεθ",-1,1],["αποθ",-1,1],["αποκ",-1,1],["ουλ",-1,1],["αναπ",-1,1],["πικρ",-1,1],["ποτ",-1,1],["αποστ",-1,1],["χ",-1,1],["σιχ",10,1]],P=[["τρ",-1,1],["τσ",-1,1]],Q=[["αγανε",-1,1],["ηκανε",-1,1],["ηθηκανε",1,1],["ησανε",-1,1],["ουσανε",-1,1],["οντανε",-1,1],["ιοντανε",5,1],["ουντανε",-1,1],["ιουντανε",7,1],["οτανε",-1,1],["ιοτανε",9,1]],R=[["ταβ",-1,1],["νταβ",0,1],["ψηλοταβ",0,1],["λιβ",-1,1],["κλιβ",3,1],["ξηροκλιβ",4,1],["γ",-1,1],["αγ",6,1],["τραγ",7,1],["τσαγ",7,1],["αθιγγ",6,1],["τσιγγ",6,1],["ατσιγγ",11,1],["στεγ",6,1],["απηγ",6,1],["σιγ",6,1],["ανοργ",6,1],["ενοργ",6,1],["καλπουζ",-1,1],["θ",-1,1],["μωαμεθ",19,1],["πιθ",19,1],["απιθ",21,1],["δεκ",-1,1],["πελεκ",-1,1],["ικ",-1,1],["ανικ",25,1],["βουλκ",-1,1],["βασκ",-1,1],["βραχυκ",-1,1],["γαλ",-1,1],["καταγαλ",30,1],["ολογαλ",30,1],["βαθυγαλ",30,1],["μελ",-1,1],["καστελ",-1,1],["πορτολ",-1,1],["πλ",-1,1],["διπλ",37,1],["λαοπλ",37,1],["ψυχοπλ",37,1],["ουλ",-1,1],["μ",-1,1],["ολιγοδαμ",42,1],["μουσουλμ",42,1],["δραδουμ",42,1],["βραχμ",42,1],["ν",-1,1],["αμερικαν",47,1],["π",-1,1],["αδαπ",49,1],["χαμηλοδαπ",49,1],["πολυδαπ",49,1],["κοπ",49,1],["υποκοπ",53,1],["τσοπ",49,1],["σπ",49,1],["ερ",-1,1],["γερ",57,1],["βετερ",57,1],["λουθηρ",-1,1],["κορμορ",-1,1],["περιτρ",-1,1],["ουρ",-1,1],["σ",-1,1],["βασ",64,1],["πολισ",64,1],["σαρακατσ",64,1],["θυσ",64,1],["διατ",-1,1],["πλατ",-1,1],["τσαρλατ",-1,1],["τετ",-1,1],["πουριτ",-1,1],["σουλτ",-1,1],["μαιντ",-1,1],["ζωντ",-1,1],["καστ",-1,1],["φ",-1,1],["διαφ",78,1],["στεφ",78,1],["φωτοστεφ",80,1],["περηφ",78,1],["υπερηφ",82,1],["κοιλαρφ",78,1],["πενταρφ",78,1],["ορφ",78,1],["χ",-1,1],["αμηχ",87,1],["βιομηχ",87,1],["μεγλοβιομηχ",89,1],["καπνοβιομηχ",89,1],["μικροβιομηχ",89,1],["πολυμηχ",87,1],["λιχ",87,1]],T=[["ησετε",-1,1]],U=[["ενδ",-1,1],["συνδ",-1,1],["οδ",-1,1],["διαθ",-1,1],["καθ",-1,1],["ραθ",-1,1],["ταθ",-1,1],["τιθ",-1,1],["εκθ",-1,1],["ενθ",-1,1],["συνθ",-1,1],["ροθ",-1,1],["υπερθ",-1,1],["σθ",-1,1],["ευθ",-1,1],["αρκ",-1,1],["ωφελ",-1,1],["βολ",-1,1],["αιν",-1,1],["πον",-1,1],["ρον",-1,1],["συν",-1,1],["βαρ",-1,1],["βρ",-1,1],["αιρ",-1,1],["φορ",-1,1],["ευρ",-1,1],["πυρ",-1,1],["χωρ",-1,1],["νετ",-1,1],["σχ",-1,1]],V=[["παγ",-1,1],["δ",-1,1],["αδ",1,1],["θ",-1,1],["αθ",3,1],["τοκ",-1,1],["σκ",-1,1],["παρακαλ",-1,1],["σκελ",-1,1],["απλ",-1,1],["εμ",-1,1],["αν",-1,1],["βεν",-1,1],["βαρον",-1,1],["κοπ",-1,1],["σερπ",-1,1],["αβαρ",-1,1],["εναρ",-1,1],["αβρ",-1,1],["μπορ",-1,1],["θαρρ",-1,1],["ντρ",-1,1],["υ",-1,1],["νιφ",-1,1],["συρφ",-1,1]],X=[["οντασ",-1,1],["ωντασ",-1,1]],Y=[["ομαστε",-1,1],["ιομαστε",0,1]],Z=[["π",-1,1],["απ",0,1],["ακαταπ",1,1],["συμπ",0,1],["ασυμπ",3,1],["αμεταμφ",-1,1]],$=[["ζ",-1,1],["αλ",-1,1],["παρακαλ",1,1],["εκτελ",-1,1],["μ",-1,1],["ξ",-1,1],["προ",-1,1],["αρ",-1,1],["νισ",-1,1]],r1=[["ηθηκα",-1,1],["ηθηκε",-1,1],["ηθηκεσ",-1,1]],i1=[["πιθ",-1,1],["οθ",-1,1],["ναρθ",-1,1],["σκουλ",-1,1],["σκωλ",-1,1],["σφ",-1,1]],c1=[["θ",-1,1],["διαθ",0,1],["παρακαταθ",0,1],["συνθ",0,1],["προσθ",0,1]],s1=[["ηκα",-1,1],["ηκε",-1,1],["ηκεσ",-1,1]],e1=[["φαγ",-1,1],["ληγ",-1,1],["φρυδ",-1,1],["μαντιλ",-1,1],["μαλλ",-1,1],["ομ",-1,1],["βλεπ",-1,1],["ποδαρ",-1,1],["κυματ",-1,1],["πρωτ",-1,1],["λαχ",-1,1],["πανταχ",-1,1]],o1=[["τσα",-1,1],["χαδ",-1,1],["μεδ",-1,1],["λαμπιδ",-1,1],["δε",-1,1],["πλε",-1,1],["μεσαζ",-1,1],["δεσποζ",-1,1],["αιθ",-1,1],["φαρμακ",-1,1],["αγκ",-1,1],["ανηκ",-1,1],["λ",-1,1],["μ",-1,1],["αμ",13,1],["βρομ",13,1],["υποτειν",-1,1],["εκλιπ",-1,1],["ρ",-1,1],["ενδιαφερ",18,1],["αναρρ",18,1],["πατ",-1,1],["καθαρευ",-1,1],["δευτερευ",-1,1],["λεχ",-1,1]],u1=[["ουσα",-1,1],["ουσε",-1,1],["ουσεσ",-1,1]],a1=[["πελ",-1,1],["λλ",-1,1],["σμην",-1,1],["ρπ",-1,1],["πρ",-1,1],["φρ",-1,1],["χορτ",-1,1],["οφ",-1,1],["ψοφ",7,-1],["σφ",-1,1],["λοχ",-1,1],["ναυλοχ",10,-1]],t1=[["αμαλλι",-1,1],["λ",-1,1],["αμαλ",1,1],["μ",-1,1],["ουλαμ",3,1],["εν",-1,1],["δερβεν",5,1],["π",-1,1],["αειπ",7,1],["αρτιπ",7,1],["συμπ",7,1],["νεοπ",7,1],["κροκαλοπ",7,1],["ολοπ",7,1],["προσωποπ",7,1],["σιδηροπ",7,1],["δροσοπ",7,1],["ασπ",7,1],["ανυπ",7,1],["ρ",-1,1],["ασπαρ",19,1],["χαρ",19,1],["αχαρ",21,1],["απερ",19,1],["τρ",19,1],["ουρ",19,1],["τ",-1,1],["διατ",26,1],["επιτ",26,1],["συντ",26,1],["ομοτ",26,1],["νομοτ",30,1],["αποτ",26,1],["υποτ",26,1],["αβαστ",26,1],["αιμοστ",26,1],["προστ",26,1],["ανυστ",26,1],["ναυ",-1,1],["αφ",-1,1],["ξεφ",-1,1],["αδηφ",-1,1],["παμφ",-1,1],["πολυφ",-1,1]],_1=[["αγα",-1,1],["αγε",-1,1],["αγεσ",-1,1]],l1=[["ησα",-1,1],["ησε",-1,1],["ησου",-1,1]],m1=[["ν",-1,1],["δωδεκαν",0,1],["επταν",0,1],["μεγαλον",0,1],["ερημον",0,1],["χερσον",0,1]],f1=[["ηστε",-1,1]],b1=[["σβ",-1,1],["ασβ",0,1],["απλ",-1,1],["αειμν",-1,1],["χρ",-1,1],["αχρ",4,1],["κοινοχρ",4,1],["δυσχρ",4,1],["ευχρ",4,1],["παλιμψ",-1,1]],n1=[["ουνε",-1,1],["ηθουνε",0,1],["ησουνε",0,1]],k1=[["σπι",-1,1],["ν",-1,1],["εξων",1,1],["ρ",-1,1],["στραβομουτσ",-1,1],["κακομουτσ",-1,1]],d1=[["ουμε",-1,1],["ηθουμε",0,1],["ησουμε",0,1]],g1=[["αζ",-1,1],["ωριοπλ",-1,1],["ασουσ",-1,1],["παρασουσ",2,1],["αλλοσουσ",-1,1],["φ",-1,1],["χ",-1,1]],w1=[["ματα",-1,1],["ματων",-1,1],["ματοσ",-1,1]],v1=[["α",-1,1],["ιουμα",0,1],["ομουνα",0,1],["ιομουνα",2,1],["οσουνα",0,1],["ιοσουνα",4,1],["ε",-1,1],["αγατε",6,1],["ηκατε",6,1],["ηθηκατε",8,1],["ησατε",6,1],["ουσατε",6,1],["ειτε",6,1],["ηθειτε",12,1],["ιεμαστε",6,1],["ουμαστε",6,1],["ιουμαστε",15,1],["ιεσαστε",6,1],["οσαστε",6,1],["ιοσαστε",18,1],["η",-1,1],["ι",-1,1],["αμαι",21,1],["ιεμαι",21,1],["ομαι",21,1],["ουμαι",21,1],["ασαι",21,1],["εσαι",21,1],["ιεσαι",27,1],["αται",21,1],["εται",21,1],["ιεται",30,1],["ονται",21,1],["ουνται",21,1],["ιουνται",33,1],["ει",21,1],["αει",35,1],["ηθει",35,1],["ησει",35,1],["οι",21,1],["αν",-1,1],["αγαν",40,1],["ηκαν",40,1],["ηθηκαν",42,1],["ησαν",40,1],["ουσαν",40,1],["οντουσαν",45,1],["ιοντουσαν",46,1],["ονταν",40,1],["ιονταν",48,1],["ουνταν",40,1],["ιουνταν",50,1],["οταν",40,1],["ιοταν",52,1],["ομασταν",40,1],["ιομασταν",54,1],["οσασταν",40,1],["ιοσασταν",56,1],["ουν",-1,1],["ηθουν",58,1],["ομουν",58,1],["ιομουν",60,1],["ησουν",58,1],["οσουν",58,1],["ιοσουν",63,1],["ων",-1,1],["ηδων",65,1],["ο",-1,1],["ασ",-1,1],["εσ",-1,1],["ηδεσ",69,1],["ησεσ",69,1],["ησ",-1,1],["εισ",-1,1],["ηθεισ",73,1],["οσ",-1,1],["υσ",-1,1],["ουσ",76,1],["υ",-1,1],["ου",78,1],["ω",-1,1],["αω",80,1],["ηθω",80,1],["ησω",80,1]],h1=[["οτερ",-1,1],["εστερ",-1,1],["υτερ",-1,1],["ωτερ",-1,1],["οτατ",-1,1],["εστατ",-1,1],["υτατ",-1,1],["ωτατ",-1,1]],H=[81,65,16,1],I=[81,65,0,1],J=!1;this.stem=function(){s.limit_backward=s.cursor,s.cursor=s.limit;var r=s.limit-s.cursor;if((()=>{for(var r;;){var i=s.limit-s.cursor;r:{switch(s.ket=s.cursor,r=s.find_among_b(e),s.bra=s.cursor,r){case 1:if(s.slice_from("α"))break;return;case 2:if(s.slice_from("β"))break;return;case 3:if(s.slice_from("γ"))break;return;case 4:if(s.slice_from("δ"))break;return;case 5:if(s.slice_from("ε"))break;return;case 6:if(s.slice_from("ζ"))break;return;case 7:if(s.slice_from("η"))break;return;case 8:if(s.slice_from("θ"))break;return;case 9:if(s.slice_from("ι"))break;return;case 10:if(s.slice_from("κ"))break;return;case 11:if(s.slice_from("λ"))break;return;case 12:if(s.slice_from("μ"))break;return;case 13:if(s.slice_from("ν"))break;return;case 14:if(s.slice_from("ξ"))break;return;case 15:if(s.slice_from("ο"))break;return;case 16:if(s.slice_from("π"))break;return;case 17:if(s.slice_from("ρ"))break;return;case 18:if(s.slice_from("σ"))break;return;case 19:if(s.slice_from("τ"))break;return;case 20:if(s.slice_from("υ"))break;return;case 21:if(s.slice_from("φ"))break;return;case 22:if(s.slice_from("χ"))break;return;case 23:if(s.slice_from("ψ"))break;return;case 24:if(s.slice_from("ω"))break;return;case 25:if(s.cursor<=s.limit_backward)break r;s.cursor--}continue}s.cursor=s.limit-i;break}})(),s.cursor=s.limit-r,!(3<=s.current.length))return!1;J=!0;var r=s.limit-s.cursor,r=((()=>{var r;if(s.ket=s.cursor,0!=(r=s.find_among_b(o))){switch(s.bra=s.cursor,r){case 1:if(s.slice_from("φα"))break;return;case 2:if(s.slice_from("σκα"))break;return;case 3:if(s.slice_from("ολο"))break;return;case 4:if(s.slice_from("σο"))break;return;case 5:if(s.slice_from("τατο"))break;return;case 6:if(s.slice_from("κρε"))break;return;case 7:if(s.slice_from("περ"))break;return;case 8:if(s.slice_from("τερ"))break;return;case 9:if(s.slice_from("φω"))break;return;case 10:if(s.slice_from("καθεστ"))break;return;case 11:if(s.slice_from("γεγον"))break;return}J=!1}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r;if(s.ket=s.cursor,0!=s.find_among_b(a)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0!=(r=s.find_among_b(u)))&&!(s.cursor>s.limit_backward))switch(r){case 1:if(s.slice_from("ι"))break;return;case 2:if(s.slice_from("ιζ"))break}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(_)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(t)||s.cursor>s.limit_backward||s.slice_from("ων")),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r;r:{var i=s.limit-s.cursor;if(s.ket=s.cursor,s.eq_s_b("ισα")&&(s.bra=s.cursor,!(s.cursor>s.limit_backward))){if(s.slice_from("ισ"))break r;return}s.cursor=s.limit-i,s.ket=s.cursor}if(0!=s.find_among_b(m)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0!=(r=s.find_among_b(l)))&&!(s.cursor>s.limit_backward))switch(r){case 1:if(s.slice_from("ι"))break;return;case 2:if(s.slice_from("ισ"))break}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(b)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(f)||s.cursor>s.limit_backward||s.slice_from("ι")),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r;if(s.ket=s.cursor,0!=s.find_among_b(k)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0!=(r=s.find_among_b(n)))&&!(s.cursor>s.limit_backward))switch(r){case 1:if(s.slice_from("ι"))break;return;case 2:if(s.slice_from("ιστ"))break}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r;if(s.ket=s.cursor,0!=s.find_among_b(w)&&(s.bra=s.cursor,s.slice_del())){J=!1;var i=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,0==(r=s.find_among_b(d))||s.cursor>s.limit_backward){if(s.cursor=s.limit-i,s.ket=s.cursor,0==(r=s.find_among_b(g)))return;switch(s.bra=s.cursor,r){case 1:if(s.slice_from("αγνωστ"))break;return;case 2:if(s.slice_from("ατομ"))break;return;case 3:if(s.slice_from("γνωστ"))break;return;case 4:if(s.slice_from("εθν"))break;return;case 5:if(s.slice_from("εκλεκτ"))break;return;case 6:if(s.slice_from("σκεπτ"))break;return;case 7:if(s.slice_from("τοπ"))break;return;case 8:if(s.slice_from("αλεξανδρ"))break;return;case 9:if(s.slice_from("βυζαντ"))break;return;case 10:if(s.slice_from("θεατρ"))break}}else switch(r){case 1:if(s.slice_from("ισμ"))break;return;case 2:if(s.slice_from("ι"))break}}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(h)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(v)||s.cursor>s.limit_backward||s.slice_from("αρακ")),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r;if(s.ket=s.cursor,0!=s.find_among_b(p)&&(s.bra=s.cursor,s.slice_del())){J=!1;var i=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,0==(r=s.find_among_b(q))||s.cursor>s.limit_backward){if(s.cursor=s.limit-i,s.ket=s.cursor,s.bra=s.cursor,!s.eq_s_b("κορ"))return;if(!s.slice_from("ιτσ"));}else switch(r){case 1:if(s.slice_from("ακ"))break;return;case 2:if(s.slice_from("ιτσ"))break}}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{if(s.ket=s.cursor,0!=s.find_among_b(B)&&(s.bra=s.cursor,s.slice_del())){J=!1;r:{var r=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,0!=s.find_among_b(C)&&!(s.cursor>s.limit_backward)){if(s.slice_from("ιδ"))break r;return}if(s.cursor=s.limit-r,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(S))return;if(!s.slice_from("ιδ"))return}}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(W)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(G)||s.cursor>s.limit_backward||s.slice_from("ισκ")),s.cursor=s.limit-r,s.limit-s.cursor),i=(s.ket=s.cursor,0!=s.find_among_b(j)&&(s.bra=s.cursor,s.slice_del())&&(i=s.limit-s.cursor,0==s.find_among_b(x))&&(s.cursor=s.limit-i,i=s.cursor,s.insert(s.cursor,s.cursor,"αδ"),s.cursor=i),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(y)&&(s.bra=s.cursor,s.slice_del())&&(s.ket=s.cursor,s.bra=s.cursor,0!=s.find_among_b(z))&&s.slice_from("εδ"),s.cursor=s.limit-i,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(A)&&(s.bra=s.cursor,s.slice_del())&&(s.ket=s.cursor,s.bra=s.cursor,0!=s.find_among_b(D))&&s.slice_from("ουδ"),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(E)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(F)||s.cursor>s.limit_backward||s.slice_from("ε")),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(K)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,s.in_grouping_b(H,945,969))&&s.slice_from("ι"),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{if(s.ket=s.cursor,0!=s.find_among_b(L)&&(s.bra=s.cursor,s.slice_del())){J=!1;r:{var r=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,s.in_grouping_b(H,945,969)){if(s.slice_from("ικ"))break r;return}s.cursor=s.limit-r,s.ket=s.cursor}s.bra=s.cursor,0==s.find_among_b(M)||s.cursor>s.limit_backward||s.slice_from("ικ")}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r=s.limit-s.cursor;if(s.ket=s.cursor,!s.eq_s_b("αγαμε")||(s.bra=s.cursor,s.cursor>s.limit_backward||s.slice_from("αγαμ"))){s.cursor=s.limit-r;r=s.limit-s.cursor;if(s.ket=s.cursor,0!=s.find_among_b(N)){if(s.bra=s.cursor,!s.slice_del())return;J=!1}s.cursor=s.limit-r,s.ket=s.cursor,s.eq_s_b("αμε")&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(O)||s.cursor>s.limit_backward||s.slice_from("αμ"))}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r=s.limit-s.cursor;if(s.ket=s.cursor,0!=s.find_among_b(Q)){if(s.bra=s.cursor,!s.slice_del())return;if(J=!1,s.ket=s.cursor,s.bra=s.cursor,0!=s.find_among_b(P)&&!(s.cursor>s.limit_backward||s.slice_from("αγαν")))return}if(s.cursor=s.limit-r,s.ket=s.cursor,s.eq_s_b("ανε")&&(s.bra=s.cursor,s.slice_del())){J=!1;r:{var i=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,s.in_grouping_b(I,945,969)){if(s.slice_from("αν"))break r;return}s.cursor=s.limit-i,s.ket=s.cursor}s.bra=s.cursor,0==s.find_among_b(R)||s.cursor>s.limit_backward||s.slice_from("αν")}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r=s.limit-s.cursor;if(s.ket=s.cursor,0!=s.find_among_b(T)){if(s.bra=s.cursor,!s.slice_del())return;J=!1}if(s.cursor=s.limit-r,s.ket=s.cursor,s.eq_s_b("ετε")&&(s.bra=s.cursor,s.slice_del())){J=!1;r:{var i=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,s.in_grouping_b(I,945,969)){if(s.slice_from("ετ"))break r;return}if(s.cursor=s.limit-i,s.ket=s.cursor,s.bra=s.cursor,0!=s.find_among_b(U)){if(s.slice_from("ετ"))break r;return}s.cursor=s.limit-i,s.ket=s.cursor}s.bra=s.cursor,0==s.find_among_b(V)||s.cursor>s.limit_backward||s.slice_from("ετ")}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{if(s.ket=s.cursor,0!=s.find_among_b(X)&&(s.bra=s.cursor,s.slice_del())){J=!1;r:{var r=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,s.eq_s_b("αρχ")&&!(s.cursor>s.limit_backward)){if(s.slice_from("οντ"))break r;return}if(s.cursor=s.limit-r,s.ket=s.cursor,s.bra=s.cursor,!s.eq_s_b("κρε"))return;if(!s.slice_from("ωντ"))return}}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(Y)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,!s.eq_s_b("ον")||s.cursor>s.limit_backward||s.slice_from("ομαστ")),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r=s.limit-s.cursor;if(s.ket=s.cursor,s.eq_s_b("ιεστε")){if(s.bra=s.cursor,!s.slice_del())return;if(J=!1,s.ket=s.cursor,s.bra=s.cursor,0!=s.find_among_b(Z)&&!(s.cursor>s.limit_backward||s.slice_from("ιεστ")))return}s.cursor=s.limit-r,s.ket=s.cursor,s.eq_s_b("εστε")&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b($)||s.cursor>s.limit_backward||s.slice_from("ιεστ"))})(),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r=s.limit-s.cursor;if(s.ket=s.cursor,0!=s.find_among_b(r1)){if(s.bra=s.cursor,!s.slice_del())return;J=!1}if(s.cursor=s.limit-r,s.ket=s.cursor,0!=s.find_among_b(s1)&&(s.bra=s.cursor,s.slice_del())){J=!1;r:{var i=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,0!=s.find_among_b(i1)){if(s.slice_from("ηκ"))break r;return}if(s.cursor=s.limit-i,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(c1))return;if(s.cursor>s.limit_backward)return;if(!s.slice_from("ηκ"))return}}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{if(s.ket=s.cursor,0!=s.find_among_b(u1)&&(s.bra=s.cursor,s.slice_del())){J=!1;r:{var r=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,0!=s.find_among_b(e1)){if(s.slice_from("ουσ"))break r;return}if(s.cursor=s.limit-r,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(o1))return;if(s.cursor>s.limit_backward)return;if(!s.slice_from("ουσ"))return}}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(l1)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(m1)||s.cursor>s.limit_backward||s.slice_from("ησ")),s.cursor=s.limit-r,s.limit-s.cursor),r=((()=>{var r;if(s.ket=s.cursor,0!=s.find_among_b(_1)&&(s.bra=s.cursor,s.slice_del())){J=!1;r:{var i=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,s.eq_s_b("κολλ")){if(s.slice_from("αγ"))break r;return}s.cursor=s.limit-i;i=s.limit-s.cursor;if(s.ket=s.cursor,s.bra=s.cursor,0!=(r=s.find_among_b(a1)))switch(r){case 1:if(s.slice_from("αγ"))break;return}else{if(s.cursor=s.limit-i,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(t1))return;if(s.cursor>s.limit_backward)return;if(!s.slice_from("αγ"))return}}}})(),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(f1)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(b1)||s.cursor>s.limit_backward||s.slice_from("ηστ")),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(n1)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(k1)||s.cursor>s.limit_backward||s.slice_from("ουν")),s.cursor=s.limit-r,s.limit-s.cursor),r=(s.ket=s.cursor,0!=s.find_among_b(d1)&&(s.bra=s.cursor,s.slice_del())&&(J=!1,s.ket=s.cursor,s.bra=s.cursor,0==s.find_among_b(g1)||s.cursor>s.limit_backward||s.slice_from("ουμ")),s.cursor=s.limit-r,s.limit-s.cursor),c=(c=s.limit-s.cursor,s.ket=s.cursor,0!=s.find_among_b(w1)&&(s.bra=s.cursor,!s.slice_from("μα"))||(s.cursor=s.limit-c,J&&(s.ket=s.cursor,0!=s.find_among_b(v1))&&(s.bra=s.cursor,s.slice_del())),s.cursor=s.limit-r,s.limit-s.cursor);return s.ket=s.cursor,0!=s.find_among_b(h1)&&(s.bra=s.cursor,s.slice_del()),s.cursor=s.limit-c,s.cursor=s.limit_backward,!0},this.stemWord=function(r){return s.setCurrent(r),this.stem(),s.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/hindi-stemmer.js b/sphinx/search/minified-js/hindi-stemmer.js new file mode 100644 index 00000000000..850b0430cdd --- /dev/null +++ b/sphinx/search/minified-js/hindi-stemmer.js @@ -0,0 +1 @@ +var HindiStemmer=function(){var t=new BaseStemmer,r=[["आँ",-1,-1],["ाँ",-1,-1],["इयाँ",1,-1],["आइयाँ",2,-1],["ाइयाँ",2,-1],["ियाँ",1,-1],["आं",-1,-1],["उआं",6,-1],["ुआं",6,-1],["ईं",-1,-1],["आईं",9,-1],["ाईं",9,-1],["एं",-1,-1],["आएं",12,-1],["उएं",12,-1],["ाएं",12,-1],["ताएं",15,-1,e],["अताएं",16,-1],["नाएं",15,-1,e],["अनाएं",18,-1],["ुएं",12,-1],["ओं",-1,-1],["आओं",21,-1],["उओं",21,-1],["ाओं",21,-1],["ताओं",24,-1,e],["अताओं",25,-1],["नाओं",24,-1,e],["अनाओं",27,-1],["ुओं",21,-1],["ां",-1,-1],["इयां",30,-1],["आइयां",31,-1],["ाइयां",31,-1],["ियां",30,-1],["ीं",-1,-1],["तीं",35,-1,e],["अतीं",36,-1],["आतीं",36,-1],["ातीं",36,-1],["ें",-1,-1],["ों",-1,-1],["इयों",41,-1],["आइयों",42,-1],["ाइयों",42,-1],["ियों",41,-1],["अ",-1,-1],["आ",-1,-1],["इ",-1,-1],["ई",-1,-1],["आई",49,-1],["ाई",49,-1],["उ",-1,-1],["ऊ",-1,-1],["ए",-1,-1],["आए",54,-1],["इए",54,-1],["आइए",56,-1],["ाइए",56,-1],["ाए",54,-1],["िए",54,-1],["ओ",-1,-1],["आओ",61,-1],["ाओ",61,-1],["कर",-1,-1,e],["अकर",64,-1],["आकर",64,-1],["ाकर",64,-1],["ा",-1,-1],["ऊंगा",68,-1],["आऊंगा",69,-1],["ाऊंगा",69,-1],["ूंगा",68,-1],["एगा",68,-1],["आएगा",73,-1],["ाएगा",73,-1],["ेगा",68,-1],["ता",68,-1,e],["अता",77,-1],["आता",77,-1],["ाता",77,-1],["ना",68,-1,e],["अना",81,-1],["आना",81,-1],["ाना",81,-1],["आया",68,-1],["ाया",68,-1],["ि",-1,-1],["ी",-1,-1],["ऊंगी",88,-1],["आऊंगी",89,-1],["ाऊंगी",89,-1],["एंगी",88,-1],["आएंगी",92,-1],["ाएंगी",92,-1],["ूंगी",88,-1],["ेंगी",88,-1],["एगी",88,-1],["आएगी",97,-1],["ाएगी",97,-1],["ओगी",88,-1],["आओगी",100,-1],["ाओगी",100,-1],["ेगी",88,-1],["ोगी",88,-1],["ती",88,-1,e],["अती",105,-1],["आती",105,-1],["ाती",105,-1],["नी",88,-1,e],["अनी",109,-1],["ु",-1,-1],["ू",-1,-1],["े",-1,-1],["एंगे",113,-1],["आएंगे",114,-1],["ाएंगे",114,-1],["ेंगे",113,-1],["ओगे",113,-1],["आओगे",118,-1],["ाओगे",118,-1],["ोगे",113,-1],["ते",113,-1,e],["अते",122,-1],["आते",122,-1],["ाते",122,-1],["ने",113,-1,e],["अने",126,-1],["आने",126,-1],["ाने",126,-1],["ो",-1,-1],["्",-1,-1]],i=[255,255,255,255,159,0,0,0,248,7];function e(){return!!t.in_grouping_b(i,2325,2399)}this.stem=function(){return!(t.cursor>=t.limit||(t.cursor++,t.limit_backward=t.cursor,t.cursor=t.limit,t.ket=t.cursor,0==t.find_among_b(r))||(t.bra=t.cursor,!t.slice_del())||(t.cursor=t.limit_backward,0))},this.stemWord=function(r){return t.setCurrent(r),this.stem(),t.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/hungarian-stemmer.js b/sphinx/search/minified-js/hungarian-stemmer.js index e1fca971f79..a7f3926cacf 100644 --- a/sphinx/search/minified-js/hungarian-stemmer.js +++ b/sphinx/search/minified-js/hungarian-stemmer.js @@ -1 +1 @@ -HungarianStemmer=function(){var r=new BaseStemmer;var e=[["cs",-1,-1],["dzs",-1,-1],["gy",-1,-1],["ly",-1,-1],["ny",-1,-1],["sz",-1,-1],["ty",-1,-1],["zs",-1,-1]];var i=[["á",-1,1],["é",-1,2]];var a=[["bb",-1,-1],["cc",-1,-1],["dd",-1,-1],["ff",-1,-1],["gg",-1,-1],["jj",-1,-1],["kk",-1,-1],["ll",-1,-1],["mm",-1,-1],["nn",-1,-1],["pp",-1,-1],["rr",-1,-1],["ccs",-1,-1],["ss",-1,-1],["zzs",-1,-1],["tt",-1,-1],["vv",-1,-1],["ggy",-1,-1],["lly",-1,-1],["nny",-1,-1],["tty",-1,-1],["ssz",-1,-1],["zz",-1,-1]];var t=[["al",-1,1],["el",-1,1]];var s=[["ba",-1,-1],["ra",-1,-1],["be",-1,-1],["re",-1,-1],["ig",-1,-1],["nak",-1,-1],["nek",-1,-1],["val",-1,-1],["vel",-1,-1],["ul",-1,-1],["nál",-1,-1],["nél",-1,-1],["ból",-1,-1],["ról",-1,-1],["tól",-1,-1],["ül",-1,-1],["ből",-1,-1],["ről",-1,-1],["től",-1,-1],["n",-1,-1],["an",19,-1],["ban",20,-1],["en",19,-1],["ben",22,-1],["képpen",22,-1],["on",19,-1],["ön",19,-1],["képp",-1,-1],["kor",-1,-1],["t",-1,-1],["at",29,-1],["et",29,-1],["ként",29,-1],["anként",32,-1],["enként",32,-1],["onként",32,-1],["ot",29,-1],["ért",29,-1],["öt",29,-1],["hez",-1,-1],["hoz",-1,-1],["höz",-1,-1],["vá",-1,-1],["vé",-1,-1]];var u=[["án",-1,2],["én",-1,1],["ánként",-1,2]];var n=[["stul",-1,1],["astul",0,1],["ástul",0,2],["stül",-1,1],["estül",3,1],["éstül",3,3]];var f=[["á",-1,1],["é",-1,1]];var c=[["k",-1,3],["ak",0,3],["ek",0,3],["ok",0,3],["ák",0,1],["ék",0,2],["ök",0,3]];var l=[["éi",-1,1],["áéi",0,3],["ééi",0,2],["é",-1,1],["ké",3,1],["aké",4,1],["eké",4,1],["oké",4,1],["áké",4,3],["éké",4,2],["öké",4,1],["éé",3,2]];var o=[["a",-1,1],["ja",0,1],["d",-1,1],["ad",2,1],["ed",2,1],["od",2,1],["ád",2,2],["éd",2,3],["öd",2,1],["e",-1,1],["je",9,1],["nk",-1,1],["unk",11,1],["ánk",11,2],["énk",11,3],["ünk",11,1],["uk",-1,1],["juk",16,1],["ájuk",17,2],["ük",-1,1],["jük",19,1],["éjük",20,3],["m",-1,1],["am",22,1],["em",22,1],["om",22,1],["ám",22,2],["ém",22,3],["o",-1,1],["á",-1,2],["é",-1,3]];var k=[["id",-1,1],["aid",0,1],["jaid",1,1],["eid",0,1],["jeid",3,1],["áid",0,2],["éid",0,3],["i",-1,1],["ai",7,1],["jai",8,1],["ei",7,1],["jei",10,1],["ái",7,2],["éi",7,3],["itek",-1,1],["eitek",14,1],["jeitek",15,1],["éitek",14,3],["ik",-1,1],["aik",18,1],["jaik",19,1],["eik",18,1],["jeik",21,1],["áik",18,2],["éik",18,3],["ink",-1,1],["aink",25,1],["jaink",26,1],["eink",25,1],["jeink",28,1],["áink",25,2],["éink",25,3],["aitok",-1,1],["jaitok",32,1],["áitok",-1,2],["im",-1,1],["aim",35,1],["jaim",36,1],["eim",35,1],["jeim",38,1],["áim",35,2],["éim",35,3]];var m=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,36,10,0,0,0,0,0,0,0,0,0,0,1,0,0,0,1];var b=0;function _(){b=r.limit;r:{var i=r.cursor;e:{if(!r.in_grouping(m,97,369)){break e}i:while(true){var a=r.cursor;a:{if(!r.out_grouping(m,97,369)){break a}r.cursor=a;break i}r.cursor=a;if(r.cursor>=r.limit){break e}r.cursor++}i:{var t=r.cursor;a:{if(r.find_among(e)==0){break a}break i}r.cursor=t;if(r.cursor>=r.limit){break e}r.cursor++}b=r.cursor;break r}r.cursor=i;if(!r.out_grouping(m,97,369)){return false}e:while(true){i:{if(!r.in_grouping(m,97,369)){break i}break e}if(r.cursor>=r.limit){return false}r.cursor++}b=r.cursor}return true}function d(){if(!(b<=r.cursor)){return false}return true}function v(){var e;r.ket=r.cursor;e=r.find_among_b(i);if(e==0){return false}r.bra=r.cursor;if(!d()){return false}switch(e){case 1:if(!r.slice_from("a")){return false}break;case 2:if(!r.slice_from("e")){return false}break}return true}function g(){var e=r.limit-r.cursor;if(r.find_among_b(a)==0){return false}r.cursor=r.limit-e;return true}function j(){if(r.cursor<=r.limit_backward){return false}r.cursor--;r.ket=r.cursor;{var e=r.cursor-1;if(e{_=e.limit;var r=e.cursor;if(e.in_grouping(f,97,369)){var i=e.cursor;e.go_in_grouping(f,97,369)&&(e.cursor++,_=e.cursor),e.cursor=i}else{if(e.cursor=r,!e.go_out_grouping(f,97,369))return;e.cursor++,_=e.cursor}})(),e.cursor=r,e.limit_backward=e.cursor,e.cursor=e.limit,e.limit-e.cursor),r=(e.ket=e.cursor,0!=e.find_among_b(c)&&(e.bra=e.cursor,b())&&d()&&e.slice_del()&&g(),e.cursor=e.limit-r,e.limit-e.cursor),r=(j(),e.cursor=e.limit-r,e.limit-e.cursor),r=((()=>{var r;if(e.ket=e.cursor,0!=(r=e.find_among_b(t))&&(e.bra=e.cursor,b()))switch(r){case 1:if(e.slice_from("e"))break;return;case 2:if(e.slice_from("a"))break}})(),e.cursor=e.limit-r,e.limit-e.cursor),r=((()=>{var r;if(e.ket=e.cursor,0!=(r=e.find_among_b(o))&&(e.bra=e.cursor,b()))switch(r){case 1:if(e.slice_del())break;return;case 2:if(e.slice_from("a"))break;return;case 3:if(e.slice_from("e"))break}})(),e.cursor=e.limit-r,e.limit-e.cursor),r=(e.ket=e.cursor,0!=e.find_among_b(n)&&(e.bra=e.cursor,b())&&d()&&e.slice_del()&&g(),e.cursor=e.limit-r,e.limit-e.cursor),r=((()=>{var r;if(e.ket=e.cursor,0!=(r=e.find_among_b(k))&&(e.bra=e.cursor,b()))switch(r){case 1:if(e.slice_del())break;return;case 2:if(e.slice_from("e"))break;return;case 3:if(e.slice_from("a"))break}})(),e.cursor=e.limit-r,e.limit-e.cursor),r=((()=>{var r;if(e.ket=e.cursor,0!=(r=e.find_among_b(l))&&(e.bra=e.cursor,b()))switch(r){case 1:if(e.slice_del())break;return;case 2:if(e.slice_from("a"))break;return;case 3:if(e.slice_from("e"))break}})(),e.cursor=e.limit-r,e.limit-e.cursor),r=((()=>{var r;if(e.ket=e.cursor,0!=(r=e.find_among_b(m))&&(e.bra=e.cursor,b()))switch(r){case 1:if(e.slice_del())break;return;case 2:if(e.slice_from("a"))break;return;case 3:if(e.slice_from("e"))break}})(),e.cursor=e.limit-r,e.limit-e.cursor);return(()=>{var r;if(e.ket=e.cursor,0!=(r=e.find_among_b(u))&&(e.bra=e.cursor,b()))switch(r){case 1:if(e.slice_from("a"))break;return;case 2:if(e.slice_from("e"))break;return;case 3:if(e.slice_del())break}})(),e.cursor=e.limit-r,e.cursor=e.limit_backward,!0},this.stemWord=function(r){return e.setCurrent(r),this.stem(),e.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/indonesian-stemmer.js b/sphinx/search/minified-js/indonesian-stemmer.js new file mode 100644 index 00000000000..89339d9783d --- /dev/null +++ b/sphinx/search/minified-js/indonesian-stemmer.js @@ -0,0 +1 @@ +var IndonesianStemmer=function(){var s=new BaseStemmer,c=[["kah",-1,1],["lah",-1,1],["pun",-1,1]],o=[["nya",-1,1],["ku",-1,1],["mu",-1,1]],r=[["i",-1,1,function(){if(2{var r;if(s.bra=s.cursor,0!=(r=s.find_among(n))){switch(s.ket=s.cursor,r){case 1:if(!s.slice_del())return;a=1,--l;break;case 2:if(!s.slice_del())return;a=3,--l;break;case 3:if(a=1,!s.slice_from("s"))return;--l;break;case 4:if(a=3,!s.slice_from("s"))return;--l;break;case 5:a=1,--l;r:{var e=s.cursor,i=s.cursor;if(s.in_grouping(t,97,117)){if(s.cursor=i,s.slice_from("p"))break r;return}if(s.cursor=e,!s.slice_del())return}break;case 6:a=3,--l;r:{var u=s.cursor,c=s.cursor;if(s.in_grouping(t,97,117)){if(s.cursor=c,s.slice_from("p"))break r;return}if(s.cursor=u,!s.slice_del())return}}return 1}})()?(u=s.cursor,i=s.cursor,l<=2||(s.limit_backward=s.cursor,s.cursor=s.limit,f()&&(s.cursor=s.limit_backward,s.cursor=i,l<=2||m())),s.cursor=u,s.cursor=e):(s.cursor=r,i=s.cursor,m(),s.cursor=i,u=s.cursor,l<=2||(s.limit_backward=s.cursor,s.cursor=s.limit,f()&&(s.cursor=s.limit_backward)),s.cursor=u),0))},this.stemWord=function(r){return s.setCurrent(r),this.stem(),s.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/irish-stemmer.js b/sphinx/search/minified-js/irish-stemmer.js new file mode 100644 index 00000000000..c90c92292cc --- /dev/null +++ b/sphinx/search/minified-js/irish-stemmer.js @@ -0,0 +1 @@ +var IrishStemmer=function(){var i=new BaseStemmer,e=[["b'",-1,1],["bh",-1,4],["bhf",1,2],["bp",-1,8],["ch",-1,5],["d'",-1,1],["d'fh",5,2],["dh",-1,6],["dt",-1,9],["fh",-1,2],["gc",-1,5],["gh",-1,7],["h-",-1,1],["m'",-1,1],["mb",-1,4],["mh",-1,10],["n-",-1,1],["nd",-1,6],["ng",-1,7],["ph",-1,8],["sh",-1,3],["t-",-1,1],["th",-1,9],["ts",-1,3]],a=[["íochta",-1,1],["aíochta",0,1],["ire",-1,2],["aire",2,2],["abh",-1,1],["eabh",4,1],["ibh",-1,1],["aibh",6,1],["amh",-1,1],["eamh",8,1],["imh",-1,1],["aimh",10,1],["íocht",-1,1],["aíocht",12,1],["irí",-1,2],["airí",14,2]],c=[["óideacha",-1,6],["patacha",-1,5],["achta",-1,1],["arcachta",2,2],["eachta",2,1],["grafaíochta",-1,4],["paite",-1,5],["ach",-1,1],["each",7,1],["óideach",8,6],["gineach",8,3],["patach",7,5],["grafaíoch",-1,4],["pataigh",-1,5],["óidigh",-1,6],["achtúil",-1,1],["eachtúil",15,1],["gineas",-1,3],["ginis",-1,3],["acht",-1,1],["arcacht",19,2],["eacht",19,1],["grafaíocht",-1,4],["arcachtaí",-1,2],["grafaíochtaí",-1,4]],t=[["imid",-1,1],["aimid",0,1],["ímid",-1,1],["aímid",2,1],["adh",-1,2],["eadh",4,2],["faidh",-1,1],["fidh",-1,1],["áil",-1,2],["ain",-1,2],["tear",-1,2],["tar",-1,2]],s=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,4,2],o=0,u=0,f=0;function n(){return u<=i.cursor}function h(){return o<=i.cursor}function m(){var r;if(i.ket=i.cursor,0!=(r=i.find_among_b(t)))switch(i.bra=i.cursor,r){case 1:if(!(f<=i.cursor))return;if(i.slice_del())break;return;case 2:if(!n())return;if(i.slice_del())break;return}}this.stem=function(){var r=i.cursor,r=((()=>{var r;if(i.bra=i.cursor,0!=(r=i.find_among(e)))switch(i.ket=i.cursor,r){case 1:if(i.slice_del())break;return;case 2:if(i.slice_from("f"))break;return;case 3:if(i.slice_from("s"))break;return;case 4:if(i.slice_from("b"))break;return;case 5:if(i.slice_from("c"))break;return;case 6:if(i.slice_from("d"))break;return;case 7:if(i.slice_from("g"))break;return;case 8:if(i.slice_from("p"))break;return;case 9:if(i.slice_from("t"))break;return;case 10:if(i.slice_from("m"))break}})(),i.cursor=r,f=i.limit,u=i.limit,o=i.limit,r=i.cursor,i.go_out_grouping(s,97,250)&&(i.cursor++,f=i.cursor,i.go_in_grouping(s,97,250))&&(i.cursor++,u=i.cursor,i.go_out_grouping(s,97,250))&&(i.cursor++,i.go_in_grouping(s,97,250))&&(i.cursor++,o=i.cursor),i.cursor=r,i.limit_backward=i.cursor,i.cursor=i.limit,i.limit-i.cursor),r=((()=>{var r;if(i.ket=i.cursor,0!=(r=i.find_among_b(a)))switch(i.bra=i.cursor,r){case 1:if(!n())return;if(i.slice_del())break;return;case 2:if(!h())return;if(i.slice_del())break}})(),i.cursor=i.limit-r,i.limit-i.cursor),r=((()=>{var r;if(i.ket=i.cursor,0!=(r=i.find_among_b(c)))switch(i.bra=i.cursor,r){case 1:if(!h())return;if(i.slice_del())break;return;case 2:if(i.slice_from("arc"))break;return;case 3:if(i.slice_from("gin"))break;return;case 4:if(i.slice_from("graf"))break;return;case 5:if(i.slice_from("paite"))break;return;case 6:if(i.slice_from("óid"))break}})(),i.cursor=i.limit-r,i.limit-i.cursor);return m(),i.cursor=i.limit-r,i.cursor=i.limit_backward,!0},this.stemWord=function(r){return i.setCurrent(r),this.stem(),i.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/italian-stemmer.js b/sphinx/search/minified-js/italian-stemmer.js index a3a5c4265e4..ac46b1d415e 100644 --- a/sphinx/search/minified-js/italian-stemmer.js +++ b/sphinx/search/minified-js/italian-stemmer.js @@ -1 +1 @@ -ItalianStemmer=function(){var r=new BaseStemmer;var e=[["",-1,7],["qu",0,6],["á",0,1],["é",0,2],["í",0,3],["ó",0,4],["ú",0,5]];var i=[["",-1,3],["I",0,1],["U",0,2]];var a=[["la",-1,-1],["cela",0,-1],["gliela",0,-1],["mela",0,-1],["tela",0,-1],["vela",0,-1],["le",-1,-1],["cele",6,-1],["gliele",6,-1],["mele",6,-1],["tele",6,-1],["vele",6,-1],["ne",-1,-1],["cene",12,-1],["gliene",12,-1],["mene",12,-1],["sene",12,-1],["tene",12,-1],["vene",12,-1],["ci",-1,-1],["li",-1,-1],["celi",20,-1],["glieli",20,-1],["meli",20,-1],["teli",20,-1],["veli",20,-1],["gli",20,-1],["mi",-1,-1],["si",-1,-1],["ti",-1,-1],["vi",-1,-1],["lo",-1,-1],["celo",31,-1],["glielo",31,-1],["melo",31,-1],["telo",31,-1],["velo",31,-1]];var s=[["ando",-1,1],["endo",-1,1],["ar",-1,2],["er",-1,2],["ir",-1,2]];var o=[["ic",-1,-1],["abil",-1,-1],["os",-1,-1],["iv",-1,1]];var u=[["ic",-1,1],["abil",-1,1],["iv",-1,1]];var t=[["ica",-1,1],["logia",-1,3],["osa",-1,1],["ista",-1,1],["iva",-1,9],["anza",-1,1],["enza",-1,5],["ice",-1,1],["atrice",7,1],["iche",-1,1],["logie",-1,3],["abile",-1,1],["ibile",-1,1],["usione",-1,4],["azione",-1,2],["uzione",-1,4],["atore",-1,2],["ose",-1,1],["ante",-1,1],["mente",-1,1],["amente",19,7],["iste",-1,1],["ive",-1,9],["anze",-1,1],["enze",-1,5],["ici",-1,1],["atrici",25,1],["ichi",-1,1],["abili",-1,1],["ibili",-1,1],["ismi",-1,1],["usioni",-1,4],["azioni",-1,2],["uzioni",-1,4],["atori",-1,2],["osi",-1,1],["anti",-1,1],["amenti",-1,6],["imenti",-1,6],["isti",-1,1],["ivi",-1,9],["ico",-1,1],["ismo",-1,1],["oso",-1,1],["amento",-1,6],["imento",-1,6],["ivo",-1,9],["ità",-1,8],["istà",-1,1],["istè",-1,1],["istì",-1,1]];var c=[["isca",-1,1],["enda",-1,1],["ata",-1,1],["ita",-1,1],["uta",-1,1],["ava",-1,1],["eva",-1,1],["iva",-1,1],["erebbe",-1,1],["irebbe",-1,1],["isce",-1,1],["ende",-1,1],["are",-1,1],["ere",-1,1],["ire",-1,1],["asse",-1,1],["ate",-1,1],["avate",16,1],["evate",16,1],["ivate",16,1],["ete",-1,1],["erete",20,1],["irete",20,1],["ite",-1,1],["ereste",-1,1],["ireste",-1,1],["ute",-1,1],["erai",-1,1],["irai",-1,1],["isci",-1,1],["endi",-1,1],["erei",-1,1],["irei",-1,1],["assi",-1,1],["ati",-1,1],["iti",-1,1],["eresti",-1,1],["iresti",-1,1],["uti",-1,1],["avi",-1,1],["evi",-1,1],["ivi",-1,1],["isco",-1,1],["ando",-1,1],["endo",-1,1],["Yamo",-1,1],["iamo",-1,1],["avamo",-1,1],["evamo",-1,1],["ivamo",-1,1],["eremo",-1,1],["iremo",-1,1],["assimo",-1,1],["ammo",-1,1],["emmo",-1,1],["eremmo",54,1],["iremmo",54,1],["immo",-1,1],["ano",-1,1],["iscano",58,1],["avano",58,1],["evano",58,1],["ivano",58,1],["eranno",-1,1],["iranno",-1,1],["ono",-1,1],["iscono",65,1],["arono",65,1],["erono",65,1],["irono",65,1],["erebbero",-1,1],["irebbero",-1,1],["assero",-1,1],["essero",-1,1],["issero",-1,1],["ato",-1,1],["ito",-1,1],["uto",-1,1],["avo",-1,1],["evo",-1,1],["ivo",-1,1],["ar",-1,1],["ir",-1,1],["erà",-1,1],["irà",-1,1],["erò",-1,1],["irò",-1,1]];var l=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2,1];var n=[17,65,0,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2];var f=[17];var b=0;var m=0;var k=0;function _(){var i;var a=r.cursor;while(true){var s=r.cursor;r:{r.bra=r.cursor;i=r.find_among(e);if(i==0){break r}r.ket=r.cursor;switch(i){case 1:if(!r.slice_from("à")){return false}break;case 2:if(!r.slice_from("è")){return false}break;case 3:if(!r.slice_from("ì")){return false}break;case 4:if(!r.slice_from("ò")){return false}break;case 5:if(!r.slice_from("ù")){return false}break;case 6:if(!r.slice_from("qU")){return false}break;case 7:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}r.cursor=a;while(true){var o=r.cursor;r:{e:while(true){var u=r.cursor;i:{if(!r.in_grouping(l,97,249)){break i}r.bra=r.cursor;a:{var t=r.cursor;s:{if(!r.eq_s("u")){break s}r.ket=r.cursor;if(!r.in_grouping(l,97,249)){break s}if(!r.slice_from("U")){return false}break a}r.cursor=t;if(!r.eq_s("i")){break i}r.ket=r.cursor;if(!r.in_grouping(l,97,249)){break i}if(!r.slice_from("I")){return false}}r.cursor=u;break e}r.cursor=u;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=o;break}return true}function v(){k=r.limit;m=r.limit;b=r.limit;var e=r.cursor;r:{e:{var i=r.cursor;i:{if(!r.in_grouping(l,97,249)){break i}a:{var a=r.cursor;s:{if(!r.out_grouping(l,97,249)){break s}o:while(true){u:{if(!r.in_grouping(l,97,249)){break u}break o}if(r.cursor>=r.limit){break s}r.cursor++}break a}r.cursor=a;if(!r.in_grouping(l,97,249)){break i}s:while(true){o:{if(!r.out_grouping(l,97,249)){break o}break s}if(r.cursor>=r.limit){break i}r.cursor++}}break e}r.cursor=i;if(!r.out_grouping(l,97,249)){break r}i:{var s=r.cursor;a:{if(!r.out_grouping(l,97,249)){break a}s:while(true){o:{if(!r.in_grouping(l,97,249)){break o}break s}if(r.cursor>=r.limit){break a}r.cursor++}break i}r.cursor=s;if(!r.in_grouping(l,97,249)){break r}if(r.cursor>=r.limit){break r}r.cursor++}}k=r.cursor}r.cursor=e;var o=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(l,97,249)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(l,97,249)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}m=r.cursor;e:while(true){i:{if(!r.in_grouping(l,97,249)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(l,97,249)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}b=r.cursor}r.cursor=o;return true}function g(){var e;while(true){var a=r.cursor;r:{r.bra=r.cursor;e=r.find_among(i);if(e==0){break r}r.ket=r.cursor;switch(e){case 1:if(!r.slice_from("i")){return false}break;case 2:if(!r.slice_from("u")){return false}break;case 3:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=a;break}return true}function d(){if(!(k<=r.cursor)){return false}return true}function w(){if(!(m<=r.cursor)){return false}return true}function h(){if(!(b<=r.cursor)){return false}return true}function p(){var e;r.ket=r.cursor;if(r.find_among_b(a)==0){return false}r.bra=r.cursor;e=r.find_among_b(s);if(e==0){return false}if(!d()){return false}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("e")){return false}break}return true}function q(){var e;r.ket=r.cursor;e=r.find_among_b(t);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!h()){return false}if(!r.slice_del()){return false}break;case 2:if(!h()){return false}if(!r.slice_del()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("ic")){r.cursor=r.limit-i;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-i;break r}if(!r.slice_del()){return false}}break;case 3:if(!h()){return false}if(!r.slice_from("log")){return false}break;case 4:if(!h()){return false}if(!r.slice_from("u")){return false}break;case 5:if(!h()){return false}if(!r.slice_from("ente")){return false}break;case 6:if(!d()){return false}if(!r.slice_del()){return false}break;case 7:if(!w()){return false}if(!r.slice_del()){return false}var a=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(o);if(e==0){r.cursor=r.limit-a;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-a;break r}if(!r.slice_del()){return false}switch(e){case 1:r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-a;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-a;break r}if(!r.slice_del()){return false}break}}break;case 8:if(!h()){return false}if(!r.slice_del()){return false}var s=r.limit-r.cursor;r:{r.ket=r.cursor;if(r.find_among_b(u)==0){r.cursor=r.limit-s;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-s;break r}if(!r.slice_del()){return false}}break;case 9:if(!h()){return false}if(!r.slice_del()){return false}var c=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-c;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("ic")){r.cursor=r.limit-c;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}}break}return true}function z(){if(r.cursor{for(var r,i=u.cursor;;){var e=u.cursor;r:{switch(u.bra=u.cursor,r=u.find_among(a),u.ket=u.cursor,r){case 1:if(u.slice_from("à"))break;return;case 2:if(u.slice_from("è"))break;return;case 3:if(u.slice_from("ì"))break;return;case 4:if(u.slice_from("ò"))break;return;case 5:if(u.slice_from("ù"))break;return;case 6:if(u.slice_from("qU"))break;return;case 7:if(u.cursor>=u.limit)break r;u.cursor++}continue}u.cursor=e;break}for(u.cursor=i;;){var o=u.cursor;r:{for(;;){var s=u.cursor;i:if(u.in_grouping(m,97,249)){u.bra=u.cursor;e:{var c=u.cursor;if(u.eq_s("u")&&(u.ket=u.cursor,u.in_grouping(m,97,249))){if(u.slice_from("U"))break e;return}if(u.cursor=c,!u.eq_s("i"))break i;if(u.ket=u.cursor,!u.in_grouping(m,97,249))break i;if(!u.slice_from("I"))return}u.cursor=s;break}if(u.cursor=s,u.cursor>=u.limit)break r;u.cursor++}continue}u.cursor=o;break}})(),u.cursor=r,v=u.limit,k=u.limit,g=u.limit,u.cursor);r:{i:{var i=u.cursor;e:if(u.in_grouping(m,97,249)){var e=u.cursor;if(!u.out_grouping(m,97,249)||!u.go_out_grouping(m,97,249)){if(u.cursor=e,!u.in_grouping(m,97,249))break e;if(!u.go_in_grouping(m,97,249))break e}u.cursor++;break i}if(u.cursor=i,!u.eq_s("divan")){if(u.cursor=i,!u.out_grouping(m,97,249))break r;e=u.cursor;if(!u.out_grouping(m,97,249)||!u.go_out_grouping(m,97,249)){if(u.cursor=e,!u.in_grouping(m,97,249))break r;if(u.cursor>=u.limit)break r}u.cursor++}}v=u.cursor}u.cursor=r,r=u.cursor,u.go_out_grouping(m,97,249)&&(u.cursor++,u.go_in_grouping(m,97,249))&&(u.cursor++,k=u.cursor,u.go_out_grouping(m,97,249))&&(u.cursor++,u.go_in_grouping(m,97,249))&&(u.cursor++,g=u.cursor),u.cursor=r,u.limit_backward=u.cursor,u.cursor=u.limit;var r=u.limit-u.cursor,r=((()=>{var r;if(u.ket=u.cursor,0!=u.find_among_b(c)&&(u.bra=u.cursor,0!=(r=u.find_among_b(t)))&&d())switch(r){case 1:if(u.slice_del())break;return;case 2:if(u.slice_from("e"))break}})(),u.cursor=u.limit-r,u.limit-u.cursor),o=u.limit-u.cursor,o=(w()||(u.cursor=u.limit-o,(()=>{if(!(u.cursor{var r=u.limit-u.cursor;if(u.ket=u.cursor,u.in_grouping_b(_,97,242))if(u.bra=u.cursor,d()){if(!u.slice_del())return;if(u.ket=u.cursor,u.eq_s_b("i"))if(u.bra=u.cursor,d()){if(!u.slice_del())return}else u.cursor=u.limit-r;else u.cursor=u.limit-r}else u.cursor=u.limit-r;else u.cursor=u.limit-r;if(r=u.limit-u.cursor,u.ket=u.cursor,u.eq_s_b("h"))if(u.bra=u.cursor,u.in_grouping_b(b,99,103))if(d()){if(!u.slice_del());}else u.cursor=u.limit-r;else u.cursor=u.limit-r;else u.cursor=u.limit-r})(),u.cursor=u.limit-o,u.cursor=u.limit_backward,u.cursor);return(()=>{for(var r;;){var i=u.cursor;r:{switch(u.bra=u.cursor,r=u.find_among(s),u.ket=u.cursor,r){case 1:if(u.slice_from("i"))break;return;case 2:if(u.slice_from("u"))break;return;case 3:if(u.cursor>=u.limit)break r;u.cursor++}continue}u.cursor=i;break}})(),u.cursor=r,!0},this.stemWord=function(r){return u.setCurrent(r),this.stem(),u.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/lithuanian-stemmer.js b/sphinx/search/minified-js/lithuanian-stemmer.js new file mode 100644 index 00000000000..6d48ddac94c --- /dev/null +++ b/sphinx/search/minified-js/lithuanian-stemmer.js @@ -0,0 +1 @@ +var LithuanianStemmer=function(){var e=new BaseStemmer,t=[["a",-1,-1],["ia",0,-1],["eria",1,-1],["osna",0,-1],["iosna",3,-1],["uosna",3,-1],["iuosna",5,-1],["ysna",0,-1],["ėsna",0,-1],["e",-1,-1],["ie",9,-1],["enie",10,-1],["erie",10,-1],["oje",9,-1],["ioje",13,-1],["uje",9,-1],["iuje",15,-1],["yje",9,-1],["enyje",17,-1],["eryje",17,-1],["ėje",9,-1],["ame",9,-1],["iame",21,-1],["sime",9,-1],["ome",9,-1],["ėme",9,-1],["tumėme",25,-1],["ose",9,-1],["iose",27,-1],["uose",27,-1],["iuose",29,-1],["yse",9,-1],["enyse",31,-1],["eryse",31,-1],["ėse",9,-1],["ate",9,-1],["iate",35,-1],["ite",9,-1],["kite",37,-1],["site",37,-1],["ote",9,-1],["tute",9,-1],["ėte",9,-1],["tumėte",42,-1],["i",-1,-1],["ai",44,-1],["iai",45,-1],["eriai",46,-1],["ei",44,-1],["tumei",48,-1],["ki",44,-1],["imi",44,-1],["erimi",51,-1],["umi",44,-1],["iumi",53,-1],["si",44,-1],["asi",55,-1],["iasi",56,-1],["esi",55,-1],["iesi",58,-1],["siesi",59,-1],["isi",55,-1],["aisi",61,-1],["eisi",61,-1],["tumeisi",63,-1],["uisi",61,-1],["osi",55,-1],["ėjosi",66,-1],["uosi",66,-1],["iuosi",68,-1],["siuosi",69,-1],["usi",55,-1],["ausi",71,-1],["čiausi",72,-1],["ąsi",55,-1],["ėsi",55,-1],["ųsi",55,-1],["tųsi",76,-1],["ti",44,-1],["enti",78,-1],["inti",78,-1],["oti",78,-1],["ioti",81,-1],["uoti",81,-1],["iuoti",83,-1],["auti",78,-1],["iauti",85,-1],["yti",78,-1],["ėti",78,-1],["telėti",88,-1],["inėti",88,-1],["terėti",88,-1],["ui",44,-1],["iui",92,-1],["eniui",93,-1],["oj",-1,-1],["ėj",-1,-1],["k",-1,-1],["am",-1,-1],["iam",98,-1],["iem",-1,-1],["im",-1,-1],["sim",101,-1],["om",-1,-1],["tum",-1,-1],["ėm",-1,-1],["tumėm",105,-1],["an",-1,-1],["on",-1,-1],["ion",108,-1],["un",-1,-1],["iun",110,-1],["ėn",-1,-1],["o",-1,-1],["io",113,-1],["enio",114,-1],["ėjo",113,-1],["uo",113,-1],["s",-1,-1],["as",118,-1],["ias",119,-1],["es",118,-1],["ies",121,-1],["is",118,-1],["ais",123,-1],["iais",124,-1],["tumeis",123,-1],["imis",123,-1],["enimis",127,-1],["omis",123,-1],["iomis",129,-1],["umis",123,-1],["ėmis",123,-1],["enis",123,-1],["asis",123,-1],["ysis",123,-1],["ams",118,-1],["iams",136,-1],["iems",118,-1],["ims",118,-1],["enims",139,-1],["erims",139,-1],["oms",118,-1],["ioms",142,-1],["ums",118,-1],["ėms",118,-1],["ens",118,-1],["os",118,-1],["ios",147,-1],["uos",147,-1],["iuos",149,-1],["ers",118,-1],["us",118,-1],["aus",152,-1],["iaus",153,-1],["ius",152,-1],["ys",118,-1],["enys",156,-1],["erys",156,-1],["ąs",118,-1],["iąs",159,-1],["ės",118,-1],["amės",161,-1],["iamės",162,-1],["imės",161,-1],["kimės",164,-1],["simės",164,-1],["omės",161,-1],["ėmės",161,-1],["tumėmės",168,-1],["atės",161,-1],["iatės",170,-1],["sitės",161,-1],["otės",161,-1],["ėtės",161,-1],["tumėtės",174,-1],["įs",118,-1],["ūs",118,-1],["tųs",118,-1],["at",-1,-1],["iat",179,-1],["it",-1,-1],["sit",181,-1],["ot",-1,-1],["ėt",-1,-1],["tumėt",184,-1],["u",-1,-1],["au",186,-1],["iau",187,-1],["čiau",188,-1],["iu",186,-1],["eniu",190,-1],["siu",190,-1],["y",-1,-1],["ą",-1,-1],["ią",194,-1],["ė",-1,-1],["ę",-1,-1],["į",-1,-1],["enį",198,-1],["erį",198,-1],["ų",-1,-1],["ių",201,-1],["erų",201,-1]],a=[["ing",-1,-1],["aj",-1,-1],["iaj",1,-1],["iej",-1,-1],["oj",-1,-1],["ioj",4,-1],["uoj",4,-1],["iuoj",6,-1],["auj",-1,-1],["ąj",-1,-1],["iąj",9,-1],["ėj",-1,-1],["ųj",-1,-1],["iųj",12,-1],["ok",-1,-1],["iok",14,-1],["iuk",-1,-1],["uliuk",16,-1],["učiuk",16,-1],["išk",-1,-1],["iul",-1,-1],["yl",-1,-1],["ėl",-1,-1],["am",-1,-1],["dam",23,-1],["jam",23,-1],["zgan",-1,-1],["ain",-1,-1],["esn",-1,-1],["op",-1,-1],["iop",29,-1],["ias",-1,-1],["ies",-1,-1],["ais",-1,-1],["iais",33,-1],["os",-1,-1],["ios",35,-1],["uos",35,-1],["iuos",37,-1],["aus",-1,-1],["iaus",39,-1],["ąs",-1,-1],["iąs",41,-1],["ęs",-1,-1],["utėait",-1,-1],["ant",-1,-1],["iant",45,-1],["siant",46,-1],["int",-1,-1],["ot",-1,-1],["uot",49,-1],["iuot",50,-1],["yt",-1,-1],["ėt",-1,-1],["ykšt",-1,-1],["iau",-1,-1],["dav",-1,-1],["sv",-1,-1],["šv",-1,-1],["ykšč",-1,-1],["ę",-1,-1],["ėję",60,-1]],u=[["ojime",-1,7],["ėjime",-1,3],["avime",-1,6],["okate",-1,8],["aite",-1,1],["uote",-1,2],["asius",-1,5],["okatės",-1,8],["aitės",-1,1],["uotės",-1,2],["esiu",-1,4]],s=[["č",-1,1],["dž",-1,2]],o=[["gd",-1,1]],m=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,16,0,64,1,0,64,0,0,0,0,0,0,0,4,4],c=0;function n(){var i;if(e.ket=e.cursor,0!=(i=e.find_among_b(s)))switch(e.bra=e.cursor,i){case 1:if(e.slice_from("t"))break;return;case 2:if(e.slice_from("d"))break;return}}this.stem=function(){c=e.limit;var i=e.cursor,s=e.cursor,r=e.cursor,r=(e.eq_s("a")?(e.cursor=r,e.current.length<=6||e.cursor>=e.limit?e.cursor=s:e.cursor++):e.cursor=s,e.go_out_grouping(m,97,371)&&(e.cursor++,e.go_in_grouping(m,97,371))&&(e.cursor++,c=e.cursor),e.cursor=i,e.limit_backward=e.cursor,e.cursor=e.limit,e.limit-e.cursor),s=((()=>{var i;if(e.ket=e.cursor,0!=(i=e.find_among_b(u)))switch(e.bra=e.cursor,i){case 1:if(e.slice_from("aitė"))break;return;case 2:if(e.slice_from("uotė"))break;return;case 3:if(e.slice_from("ėjimas"))break;return;case 4:if(e.slice_from("esys"))break;return;case 5:if(e.slice_from("asys"))break;return;case 6:if(e.slice_from("avimas"))break;return;case 7:if(e.slice_from("ojimas"))break;return;case 8:if(e.slice_from("okatė"))break}})(),e.cursor=e.limit-r,e.limit-e.cursor),r=(e.cursor{for(;;){var i=e.limit-e.cursor;if(!(e.cursor{var r;if(s.ket=s.cursor,0!=(r=s.find_among_b(t)))switch(s.bra=s.cursor,r){case 1:if(s.slice_del())break;return;case 2:var i=s.limit-s.cursor;if(s.eq_s_b("ए")||(s.cursor=s.limit-i,s.eq_s_b("े"))||(s.cursor=s.limit-i,s.slice_del()))break}})(),s.cursor=s.limit-r;;){var i=s.limit-s.cursor,e=s.limit-s.cursor;if((()=>{var r;if(s.ket=s.cursor,0!=(r=s.find_among_b(c)))switch(s.bra=s.cursor,r){case 1:var i=s.limit-s.cursor;if(!s.eq_s_b("यौ")&&(s.cursor=s.limit-i,!s.eq_s_b("छौ")&&(s.cursor=s.limit-i,!s.eq_s_b("नौ"))&&(s.cursor=s.limit-i,!s.eq_s_b("थे"))))return;if(s.slice_del())break;return;case 2:if(!s.eq_s_b("त्र"))return;if(s.slice_del())break}})(),s.cursor=s.limit-e,s.ket=s.cursor,0==s.find_among_b(u)||(s.bra=s.cursor,!s.slice_del())){s.cursor=s.limit-i;break}}return s.cursor=s.limit_backward,!0},this.stemWord=function(r){return s.setCurrent(r),this.stem(),s.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/norwegian-stemmer.js b/sphinx/search/minified-js/norwegian-stemmer.js index c8ec76cc1ca..5cf580e3ed8 100644 --- a/sphinx/search/minified-js/norwegian-stemmer.js +++ b/sphinx/search/minified-js/norwegian-stemmer.js @@ -1 +1 @@ -NorwegianStemmer=function(){var r=new BaseStemmer;var e=[["a",-1,1],["e",-1,1],["ede",1,1],["ande",1,1],["ende",1,1],["ane",1,1],["ene",1,1],["hetene",6,1],["erte",1,3],["en",-1,1],["heten",9,1],["ar",-1,1],["er",-1,1],["heter",12,1],["s",-1,2],["as",14,1],["es",14,1],["edes",16,1],["endes",16,1],["enes",16,1],["hetenes",19,1],["ens",14,1],["hetens",21,1],["ers",14,1],["ets",14,1],["et",-1,1],["het",25,1],["ert",-1,3],["ast",-1,1]];var i=[["dt",-1,-1],["vt",-1,-1]];var t=[["leg",-1,1],["eleg",0,1],["ig",-1,1],["eig",2,1],["lig",2,1],["elig",4,1],["els",-1,1],["lov",-1,1],["elov",7,1],["slov",7,1],["hetslov",9,1]];var a=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128];var s=[119,125,149,1];var u=0;var c=0;function l(){c=r.limit;var e=r.cursor;{var i=r.cursor+3;if(i>r.limit){return false}r.cursor=i}u=r.cursor;r.cursor=e;r:while(true){var t=r.cursor;e:{if(!r.in_grouping(a,97,248)){break e}r.cursor=t;break r}r.cursor=t;if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(a,97,248)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}c=r.cursor;r:{if(!(ct.limit||(t.cursor=i,m=t.cursor,t.cursor=e,t.go_out_grouping(u,97,248)&&(t.cursor++,t.go_in_grouping(u,97,248))&&(t.cursor++,n=t.cursor,m<=n||(n=m))),t.cursor=r,t.limit_backward=t.cursor,t.cursor=t.limit,t.limit-t.cursor),e=((()=>{var r;if(!(t.cursor=r.limit){break e}r.cursor++}if(!r.slice_from("Y")){return false}l=true;continue}r.cursor=s;break}}r.cursor=i;n=r.limit;o=r.limit;var u=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(c,97,121)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(c,97,121)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}n=r.cursor;e:while(true){i:{if(!r.in_grouping(c,97,121)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(c,97,121)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}o=r.cursor}r.cursor=u;r.limit_backward=r.cursor;r.cursor=r.limit;var t=r.limit-r.cursor;k();r.cursor=r.limit-t;var f=r.limit-r.cursor;v();r.cursor=r.limit-f;var b=r.limit-r.cursor;g();r.cursor=r.limit-b;var m=r.limit-r.cursor;d();r.cursor=r.limit-m;var _=r.limit-r.cursor;w();r.cursor=r.limit-_;var z=r.limit-r.cursor;h();r.cursor=r.limit-z;var y=r.limit-r.cursor;p();r.cursor=r.limit-y;var Y=r.limit-r.cursor;q();r.cursor=r.limit-Y;r.cursor=r.limit_backward;var C=r.cursor;r:{if(!l){break r}while(true){var S=r.cursor;e:{i:while(true){var B=r.cursor;s:{r.bra=r.cursor;if(!r.eq_s("Y")){break s}r.ket=r.cursor;r.cursor=B;break i}r.cursor=B;if(r.cursor>=r.limit){break e}r.cursor++}if(!r.slice_from("y")){return false}continue}r.cursor=S;break}}r.cursor=C;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}}; \ No newline at end of file +var PorterStemmer=function(){var u=new BaseStemmer,t=[["s",-1,3],["ies",0,2],["sses",0,1],["ss",0,-1]],a=[["",-1,3],["bb",0,2],["dd",0,2],["ff",0,2],["gg",0,2],["bl",0,1],["mm",0,2],["nn",0,2],["pp",0,2],["rr",0,2],["at",0,1],["tt",0,2],["iz",0,1]],n=[["ed",-1,2],["eed",0,1],["ing",-1,2]],l=[["anci",-1,3],["enci",-1,2],["abli",-1,4],["eli",-1,6],["alli",-1,9],["ousli",-1,11],["entli",-1,5],["aliti",-1,9],["biliti",-1,13],["iviti",-1,12],["tional",-1,1],["ational",10,8],["alism",-1,9],["ation",-1,8],["ization",13,7],["izer",-1,7],["ator",-1,8],["iveness",-1,12],["fulness",-1,10],["ousness",-1,11]],f=[["icate",-1,2],["ative",-1,3],["alize",-1,1],["iciti",-1,2],["ical",-1,2],["ful",-1,3],["ness",-1,3]],_=[["ic",-1,1],["ance",-1,1],["ence",-1,1],["able",-1,1],["ible",-1,1],["ate",-1,1],["ive",-1,1],["ize",-1,1],["iti",-1,1],["al",-1,1],["ism",-1,1],["ion",-1,2],["er",-1,1],["ous",-1,1],["ant",-1,1],["ent",-1,1],["ment",15,1],["ement",16,1],["ou",-1,1]],m=[17,65,16,1],r=[1,17,65,208,1],b=!1,k=0,g=0;function d(){return u.out_grouping_b(r,89,121)&&u.in_grouping_b(m,97,121)&&!!u.out_grouping_b(m,97,121)}function v(){return g<=u.cursor}function p(){return k<=u.cursor}this.stem=function(){b=!1;var r=u.cursor;if(u.bra=u.cursor,u.eq_s("y")){if(u.ket=u.cursor,!u.slice_from("Y"))return!1;b=!0}u.cursor=r;for(r=u.cursor;;){var i=u.cursor;r:{for(;;){var e=u.cursor;if(u.in_grouping(m,97,121)&&(u.bra=u.cursor,u.eq_s("y"))){u.ket=u.cursor,u.cursor=e;break}if(u.cursor=e,u.cursor>=u.limit)break r;u.cursor++}if(!u.slice_from("Y"))return!1;b=!0;continue}u.cursor=i;break}u.cursor=r,g=u.limit,k=u.limit;var r=u.cursor,r=(u.go_out_grouping(m,97,121)&&(u.cursor++,u.go_in_grouping(m,97,121))&&(u.cursor++,g=u.cursor,u.go_out_grouping(m,97,121))&&(u.cursor++,u.go_in_grouping(m,97,121))&&(u.cursor++,k=u.cursor),u.cursor=r,u.limit_backward=u.cursor,u.cursor=u.limit,u.limit-u.cursor),r=((()=>{var r;if(u.ket=u.cursor,0!=(r=u.find_among_b(t)))switch(u.bra=u.cursor,r){case 1:if(u.slice_from("ss"))break;return;case 2:if(u.slice_from("i"))break;return;case 3:if(u.slice_del())break}})(),u.cursor=u.limit-r,u.limit-u.cursor),r=((()=>{if(u.ket=u.cursor,0!=(i=u.find_among_b(n)))switch(u.bra=u.cursor,i){case 1:if(!v())return;if(u.slice_from("ee"))break;return;case 2:var r=u.limit-u.cursor;if(!u.go_out_grouping_b(m,97,121))return;if(u.cursor--,u.cursor=u.limit-r,!u.slice_del())return;var r=u.limit-u.cursor,i=u.find_among_b(a);switch(u.cursor=u.limit-r,i){case 1:var e=u.cursor;u.insert(u.cursor,u.cursor,"e"),u.cursor=e;break;case 2:if(u.ket=u.cursor,u.cursor<=u.limit_backward)return;if(u.cursor--,u.bra=u.cursor,u.slice_del())break;return;case 3:if(u.cursor!=g)return;e=u.limit-u.cursor;if(!d())return;u.cursor=u.limit-e;e=u.cursor;u.insert(u.cursor,u.cursor,"e"),u.cursor=e}}})(),u.cursor=u.limit-r,u.limit-u.cursor),s=(u.ket=u.cursor,s=u.limit-u.cursor,(u.eq_s_b("y")||(u.cursor=u.limit-s,u.eq_s_b("Y")))&&(u.bra=u.cursor,u.go_out_grouping_b(m,97,121))&&(u.cursor--,u.slice_from("i")),u.cursor=u.limit-r,u.limit-u.cursor),r=((()=>{var r;if(u.ket=u.cursor,0!=(r=u.find_among_b(l))&&(u.bra=u.cursor,v()))switch(r){case 1:if(u.slice_from("tion"))break;return;case 2:if(u.slice_from("ence"))break;return;case 3:if(u.slice_from("ance"))break;return;case 4:if(u.slice_from("able"))break;return;case 5:if(u.slice_from("ent"))break;return;case 6:if(u.slice_from("e"))break;return;case 7:if(u.slice_from("ize"))break;return;case 8:if(u.slice_from("ate"))break;return;case 9:if(u.slice_from("al"))break;return;case 10:if(u.slice_from("ful"))break;return;case 11:if(u.slice_from("ous"))break;return;case 12:if(u.slice_from("ive"))break;return;case 13:if(u.slice_from("ble"))break}})(),u.cursor=u.limit-s,u.limit-u.cursor),s=((()=>{var r;if(u.ket=u.cursor,0!=(r=u.find_among_b(f))&&(u.bra=u.cursor,v()))switch(r){case 1:if(u.slice_from("al"))break;return;case 2:if(u.slice_from("ic"))break;return;case 3:if(u.slice_del())break}})(),u.cursor=u.limit-r,u.limit-u.cursor),r=((()=>{var r;if(u.ket=u.cursor,0!=(r=u.find_among_b(_))&&(u.bra=u.cursor,p()))switch(r){case 1:if(u.slice_del())break;return;case 2:var i=u.limit-u.cursor;if(!u.eq_s_b("s")&&(u.cursor=u.limit-i,!u.eq_s_b("t")))return;if(u.slice_del())break}})(),u.cursor=u.limit-s,u.limit-u.cursor),s=((()=>{if(u.ket=u.cursor,u.eq_s_b("e")){if(u.bra=u.cursor,!p()){if(!v())return;var r=u.limit-u.cursor;if(d())return;u.cursor=u.limit-r}u.slice_del()}})(),u.cursor=u.limit-r,u.limit-u.cursor),r=(u.ket=u.cursor,u.eq_s_b("l")&&(u.bra=u.cursor,p())&&u.eq_s_b("l")&&u.slice_del(),u.cursor=u.limit-s,u.cursor=u.limit_backward,u.cursor);if(b)for(;;){var c=u.cursor;r:{for(;;){var o=u.cursor;if(u.bra=u.cursor,u.eq_s("Y")){u.ket=u.cursor,u.cursor=o;break}if(u.cursor=o,u.cursor>=u.limit)break r;u.cursor++}if(u.slice_from("y"))continue;return!1}u.cursor=c;break}return u.cursor=r,!0},this.stemWord=function(r){return u.setCurrent(r),this.stem(),u.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/portuguese-stemmer.js b/sphinx/search/minified-js/portuguese-stemmer.js index 022d860e6b3..9cc42155d49 100644 --- a/sphinx/search/minified-js/portuguese-stemmer.js +++ b/sphinx/search/minified-js/portuguese-stemmer.js @@ -1 +1 @@ -PortugueseStemmer=function(){var r=new BaseStemmer;var e=[["",-1,3],["ã",0,1],["õ",0,2]];var i=[["",-1,3],["a~",0,1],["o~",0,2]];var s=[["ic",-1,-1],["ad",-1,-1],["os",-1,-1],["iv",-1,1]];var a=[["ante",-1,1],["avel",-1,1],["ível",-1,1]];var u=[["ic",-1,1],["abil",-1,1],["iv",-1,1]];var o=[["ica",-1,1],["ância",-1,1],["ência",-1,4],["logia",-1,2],["ira",-1,9],["adora",-1,1],["osa",-1,1],["ista",-1,1],["iva",-1,8],["eza",-1,1],["idade",-1,7],["ante",-1,1],["mente",-1,6],["amente",12,5],["ável",-1,1],["ível",-1,1],["ico",-1,1],["ismo",-1,1],["oso",-1,1],["amento",-1,1],["imento",-1,1],["ivo",-1,8],["aça~o",-1,1],["uça~o",-1,3],["ador",-1,1],["icas",-1,1],["ências",-1,4],["logias",-1,2],["iras",-1,9],["adoras",-1,1],["osas",-1,1],["istas",-1,1],["ivas",-1,8],["ezas",-1,1],["idades",-1,7],["adores",-1,1],["antes",-1,1],["aço~es",-1,1],["uço~es",-1,3],["icos",-1,1],["ismos",-1,1],["osos",-1,1],["amentos",-1,1],["imentos",-1,1],["ivos",-1,8]];var t=[["ada",-1,1],["ida",-1,1],["ia",-1,1],["aria",2,1],["eria",2,1],["iria",2,1],["ara",-1,1],["era",-1,1],["ira",-1,1],["ava",-1,1],["asse",-1,1],["esse",-1,1],["isse",-1,1],["aste",-1,1],["este",-1,1],["iste",-1,1],["ei",-1,1],["arei",16,1],["erei",16,1],["irei",16,1],["am",-1,1],["iam",20,1],["ariam",21,1],["eriam",21,1],["iriam",21,1],["aram",20,1],["eram",20,1],["iram",20,1],["avam",20,1],["em",-1,1],["arem",29,1],["erem",29,1],["irem",29,1],["assem",29,1],["essem",29,1],["issem",29,1],["ado",-1,1],["ido",-1,1],["ando",-1,1],["endo",-1,1],["indo",-1,1],["ara~o",-1,1],["era~o",-1,1],["ira~o",-1,1],["ar",-1,1],["er",-1,1],["ir",-1,1],["as",-1,1],["adas",47,1],["idas",47,1],["ias",47,1],["arias",50,1],["erias",50,1],["irias",50,1],["aras",47,1],["eras",47,1],["iras",47,1],["avas",47,1],["es",-1,1],["ardes",58,1],["erdes",58,1],["irdes",58,1],["ares",58,1],["eres",58,1],["ires",58,1],["asses",58,1],["esses",58,1],["isses",58,1],["astes",58,1],["estes",58,1],["istes",58,1],["is",-1,1],["ais",71,1],["eis",71,1],["areis",73,1],["ereis",73,1],["ireis",73,1],["áreis",73,1],["éreis",73,1],["íreis",73,1],["ásseis",73,1],["ésseis",73,1],["ísseis",73,1],["áveis",73,1],["íeis",73,1],["aríeis",84,1],["eríeis",84,1],["iríeis",84,1],["ados",-1,1],["idos",-1,1],["amos",-1,1],["áramos",90,1],["éramos",90,1],["íramos",90,1],["ávamos",90,1],["íamos",90,1],["aríamos",95,1],["eríamos",95,1],["iríamos",95,1],["emos",-1,1],["aremos",99,1],["eremos",99,1],["iremos",99,1],["ássemos",99,1],["êssemos",99,1],["íssemos",99,1],["imos",-1,1],["armos",-1,1],["ermos",-1,1],["irmos",-1,1],["ámos",-1,1],["arás",-1,1],["erás",-1,1],["irás",-1,1],["eu",-1,1],["iu",-1,1],["ou",-1,1],["ará",-1,1],["erá",-1,1],["irá",-1,1]];var c=[["a",-1,1],["i",-1,1],["o",-1,1],["os",-1,1],["á",-1,1],["í",-1,1],["ó",-1,1]];var f=[["e",-1,1],["ç",-1,2],["é",-1,1],["ê",-1,1]];var l=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,3,19,12,2];var n=0;var m=0;var b=0;function k(){var i;while(true){var s=r.cursor;r:{r.bra=r.cursor;i=r.find_among(e);if(i==0){break r}r.ket=r.cursor;switch(i){case 1:if(!r.slice_from("a~")){return false}break;case 2:if(!r.slice_from("o~")){return false}break;case 3:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}return true}function _(){b=r.limit;m=r.limit;n=r.limit;var e=r.cursor;r:{e:{var i=r.cursor;i:{if(!r.in_grouping(l,97,250)){break i}s:{var s=r.cursor;a:{if(!r.out_grouping(l,97,250)){break a}u:while(true){o:{if(!r.in_grouping(l,97,250)){break o}break u}if(r.cursor>=r.limit){break a}r.cursor++}break s}r.cursor=s;if(!r.in_grouping(l,97,250)){break i}a:while(true){u:{if(!r.out_grouping(l,97,250)){break u}break a}if(r.cursor>=r.limit){break i}r.cursor++}}break e}r.cursor=i;if(!r.out_grouping(l,97,250)){break r}i:{var a=r.cursor;s:{if(!r.out_grouping(l,97,250)){break s}a:while(true){u:{if(!r.in_grouping(l,97,250)){break u}break a}if(r.cursor>=r.limit){break s}r.cursor++}break i}r.cursor=a;if(!r.in_grouping(l,97,250)){break r}if(r.cursor>=r.limit){break r}r.cursor++}}b=r.cursor}r.cursor=e;var u=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(l,97,250)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(l,97,250)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}m=r.cursor;e:while(true){i:{if(!r.in_grouping(l,97,250)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(l,97,250)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}n=r.cursor}r.cursor=u;return true}function v(){var e;while(true){var s=r.cursor;r:{r.bra=r.cursor;e=r.find_among(i);if(e==0){break r}r.ket=r.cursor;switch(e){case 1:if(!r.slice_from("ã")){return false}break;case 2:if(!r.slice_from("õ")){return false}break;case 3:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}return true}function d(){if(!(b<=r.cursor)){return false}return true}function g(){if(!(m<=r.cursor)){return false}return true}function w(){if(!(n<=r.cursor)){return false}return true}function h(){var e;r.ket=r.cursor;e=r.find_among_b(o);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!w()){return false}if(!r.slice_del()){return false}break;case 2:if(!w()){return false}if(!r.slice_from("log")){return false}break;case 3:if(!w()){return false}if(!r.slice_from("u")){return false}break;case 4:if(!w()){return false}if(!r.slice_from("ente")){return false}break;case 5:if(!g()){return false}if(!r.slice_del()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(s);if(e==0){r.cursor=r.limit-i;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-i;break r}if(!r.slice_del()){return false}switch(e){case 1:r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-i;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-i;break r}if(!r.slice_del()){return false}break}}break;case 6:if(!w()){return false}if(!r.slice_del()){return false}var t=r.limit-r.cursor;r:{r.ket=r.cursor;if(r.find_among_b(a)==0){r.cursor=r.limit-t;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-t;break r}if(!r.slice_del()){return false}}break;case 7:if(!w()){return false}if(!r.slice_del()){return false}var c=r.limit-r.cursor;r:{r.ket=r.cursor;if(r.find_among_b(u)==0){r.cursor=r.limit-c;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}}break;case 8:if(!w()){return false}if(!r.slice_del()){return false}var f=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-f;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-f;break r}if(!r.slice_del()){return false}}break;case 9:if(!d()){return false}if(!r.eq_s_b("e")){return false}if(!r.slice_from("ir")){return false}break}return true}function p(){if(r.cursor{for(var r;;){var i=u.cursor;r:{switch(u.bra=u.cursor,r=u.find_among(c),u.ket=u.cursor,r){case 1:if(u.slice_from("a~"))break;return;case 2:if(u.slice_from("o~"))break;return;case 3:if(u.cursor>=u.limit)break r;u.cursor++}continue}u.cursor=i;break}})(),u.cursor=r,k=u.limit,d=u.limit,b=u.limit,u.cursor);r:{i:{var i=u.cursor;s:if(u.in_grouping(_,97,250)){var s=u.cursor;if(!u.out_grouping(_,97,250)||!u.go_out_grouping(_,97,250)){if(u.cursor=s,!u.in_grouping(_,97,250))break s;if(!u.go_in_grouping(_,97,250))break s}u.cursor++;break i}if(u.cursor=i,!u.out_grouping(_,97,250))break r;s=u.cursor;if(u.out_grouping(_,97,250)&&u.go_out_grouping(_,97,250));else{if(u.cursor=s,!u.in_grouping(_,97,250))break r;if(u.cursor>=u.limit)break r}u.cursor++}k=u.cursor}u.cursor=r,r=u.cursor,u.go_out_grouping(_,97,250)&&(u.cursor++,u.go_in_grouping(_,97,250))&&(u.cursor++,d=u.cursor,u.go_out_grouping(_,97,250))&&(u.cursor++,u.go_in_grouping(_,97,250))&&(u.cursor++,b=u.cursor),u.cursor=r,u.limit_backward=u.cursor,u.cursor=u.limit;r=u.limit-u.cursor;r:{var e=u.limit-u.cursor,o=u.limit-u.cursor,a=u.limit-u.cursor;if(p()||(u.cursor=u.limit-a,(()=>{if(!(u.cursor{var r;if(u.ket=u.cursor,0!=(r=u.find_among_b(f)))switch(u.bra=u.cursor,r){case 1:if(!g())return;if(!u.slice_del())return;u.ket=u.cursor;r:{var i=u.limit-u.cursor;if(u.eq_s_b("u")){u.bra=u.cursor;var s=u.limit-u.cursor;if(u.eq_s_b("g")){u.cursor=u.limit-s;break r}}if(u.cursor=u.limit-i,!u.eq_s_b("i"))return;u.bra=u.cursor;s=u.limit-u.cursor;if(!u.eq_s_b("c"))return;u.cursor=u.limit-s}if(!g())return;if(u.slice_del())break;return;case 2:if(u.slice_from("c"))break}})(),u.cursor=u.limit-r,u.cursor=u.limit_backward,r=u.cursor;return(()=>{for(var r;;){var i=u.cursor;r:{switch(u.bra=u.cursor,r=u.find_among(t),u.ket=u.cursor,r){case 1:if(u.slice_from("ã"))break;return;case 2:if(u.slice_from("õ"))break;return;case 3:if(u.cursor>=u.limit)break r;u.cursor++}continue}u.cursor=i;break}})(),u.cursor=r,!0},this.stemWord=function(r){return u.setCurrent(r),this.stem(),u.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/romanian-stemmer.js b/sphinx/search/minified-js/romanian-stemmer.js index 01c54d0185c..aefb071550d 100644 --- a/sphinx/search/minified-js/romanian-stemmer.js +++ b/sphinx/search/minified-js/romanian-stemmer.js @@ -1 +1 @@ -RomanianStemmer=function(){var r=new BaseStemmer;var i=[["",-1,3],["I",0,1],["U",0,2]];var e=[["ea",-1,3],["aţia",-1,7],["aua",-1,2],["iua",-1,4],["aţie",-1,7],["ele",-1,3],["ile",-1,5],["iile",6,4],["iei",-1,4],["atei",-1,6],["ii",-1,4],["ului",-1,1],["ul",-1,1],["elor",-1,3],["ilor",-1,4],["iilor",14,4]];var a=[["icala",-1,4],["iciva",-1,4],["ativa",-1,5],["itiva",-1,6],["icale",-1,4],["aţiune",-1,5],["iţiune",-1,6],["atoare",-1,5],["itoare",-1,6],["ătoare",-1,5],["icitate",-1,4],["abilitate",-1,1],["ibilitate",-1,2],["ivitate",-1,3],["icive",-1,4],["ative",-1,5],["itive",-1,6],["icali",-1,4],["atori",-1,5],["icatori",18,4],["itori",-1,6],["ători",-1,5],["icitati",-1,4],["abilitati",-1,1],["ivitati",-1,3],["icivi",-1,4],["ativi",-1,5],["itivi",-1,6],["icităi",-1,4],["abilităi",-1,1],["ivităi",-1,3],["icităţi",-1,4],["abilităţi",-1,1],["ivităţi",-1,3],["ical",-1,4],["ator",-1,5],["icator",35,4],["itor",-1,6],["ător",-1,5],["iciv",-1,4],["ativ",-1,5],["itiv",-1,6],["icală",-1,4],["icivă",-1,4],["ativă",-1,5],["itivă",-1,6]];var t=[["ica",-1,1],["abila",-1,1],["ibila",-1,1],["oasa",-1,1],["ata",-1,1],["ita",-1,1],["anta",-1,1],["ista",-1,3],["uta",-1,1],["iva",-1,1],["ic",-1,1],["ice",-1,1],["abile",-1,1],["ibile",-1,1],["isme",-1,3],["iune",-1,2],["oase",-1,1],["ate",-1,1],["itate",17,1],["ite",-1,1],["ante",-1,1],["iste",-1,3],["ute",-1,1],["ive",-1,1],["ici",-1,1],["abili",-1,1],["ibili",-1,1],["iuni",-1,2],["atori",-1,1],["osi",-1,1],["ati",-1,1],["itati",30,1],["iti",-1,1],["anti",-1,1],["isti",-1,3],["uti",-1,1],["işti",-1,3],["ivi",-1,1],["ităi",-1,1],["oşi",-1,1],["ităţi",-1,1],["abil",-1,1],["ibil",-1,1],["ism",-1,3],["ator",-1,1],["os",-1,1],["at",-1,1],["it",-1,1],["ant",-1,1],["ist",-1,3],["ut",-1,1],["iv",-1,1],["ică",-1,1],["abilă",-1,1],["ibilă",-1,1],["oasă",-1,1],["ată",-1,1],["ită",-1,1],["antă",-1,1],["istă",-1,3],["ută",-1,1],["ivă",-1,1]];var s=[["ea",-1,1],["ia",-1,1],["esc",-1,1],["ăsc",-1,1],["ind",-1,1],["ând",-1,1],["are",-1,1],["ere",-1,1],["ire",-1,1],["âre",-1,1],["se",-1,2],["ase",10,1],["sese",10,2],["ise",10,1],["use",10,1],["âse",10,1],["eşte",-1,1],["ăşte",-1,1],["eze",-1,1],["ai",-1,1],["eai",19,1],["iai",19,1],["sei",-1,2],["eşti",-1,1],["ăşti",-1,1],["ui",-1,1],["ezi",-1,1],["âi",-1,1],["aşi",-1,1],["seşi",-1,2],["aseşi",29,1],["seseşi",29,2],["iseşi",29,1],["useşi",29,1],["âseşi",29,1],["işi",-1,1],["uşi",-1,1],["âşi",-1,1],["aţi",-1,2],["eaţi",38,1],["iaţi",38,1],["eţi",-1,2],["iţi",-1,2],["âţi",-1,2],["arăţi",-1,1],["serăţi",-1,2],["aserăţi",45,1],["seserăţi",45,2],["iserăţi",45,1],["userăţi",45,1],["âserăţi",45,1],["irăţi",-1,1],["urăţi",-1,1],["ârăţi",-1,1],["am",-1,1],["eam",54,1],["iam",54,1],["em",-1,2],["asem",57,1],["sesem",57,2],["isem",57,1],["usem",57,1],["âsem",57,1],["im",-1,2],["âm",-1,2],["ăm",-1,2],["arăm",65,1],["serăm",65,2],["aserăm",67,1],["seserăm",67,2],["iserăm",67,1],["userăm",67,1],["âserăm",67,1],["irăm",65,1],["urăm",65,1],["ârăm",65,1],["au",-1,1],["eau",76,1],["iau",76,1],["indu",-1,1],["ându",-1,1],["ez",-1,1],["ească",-1,1],["ară",-1,1],["seră",-1,2],["aseră",84,1],["seseră",84,2],["iseră",84,1],["useră",84,1],["âseră",84,1],["iră",-1,1],["ură",-1,1],["âră",-1,1],["ează",-1,1]];var u=[["a",-1,1],["e",-1,1],["ie",1,1],["i",-1,1],["ă",-1,1]];var c=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,2,32,0,0,4];var o=false;var f=0;var l=0;var n=0;function b(){while(true){var i=r.cursor;r:{i:while(true){var e=r.cursor;e:{if(!r.in_grouping(c,97,259)){break e}r.bra=r.cursor;a:{var a=r.cursor;t:{if(!r.eq_s("u")){break t}r.ket=r.cursor;if(!r.in_grouping(c,97,259)){break t}if(!r.slice_from("U")){return false}break a}r.cursor=a;if(!r.eq_s("i")){break e}r.ket=r.cursor;if(!r.in_grouping(c,97,259)){break e}if(!r.slice_from("I")){return false}}r.cursor=e;break i}r.cursor=e;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=i;break}return true}function m(){n=r.limit;l=r.limit;f=r.limit;var i=r.cursor;r:{i:{var e=r.cursor;e:{if(!r.in_grouping(c,97,259)){break e}a:{var a=r.cursor;t:{if(!r.out_grouping(c,97,259)){break t}s:while(true){u:{if(!r.in_grouping(c,97,259)){break u}break s}if(r.cursor>=r.limit){break t}r.cursor++}break a}r.cursor=a;if(!r.in_grouping(c,97,259)){break e}t:while(true){s:{if(!r.out_grouping(c,97,259)){break s}break t}if(r.cursor>=r.limit){break e}r.cursor++}}break i}r.cursor=e;if(!r.out_grouping(c,97,259)){break r}e:{var t=r.cursor;a:{if(!r.out_grouping(c,97,259)){break a}t:while(true){s:{if(!r.in_grouping(c,97,259)){break s}break t}if(r.cursor>=r.limit){break a}r.cursor++}break e}r.cursor=t;if(!r.in_grouping(c,97,259)){break r}if(r.cursor>=r.limit){break r}r.cursor++}}n=r.cursor}r.cursor=i;var s=r.cursor;r:{i:while(true){e:{if(!r.in_grouping(c,97,259)){break e}break i}if(r.cursor>=r.limit){break r}r.cursor++}i:while(true){e:{if(!r.out_grouping(c,97,259)){break e}break i}if(r.cursor>=r.limit){break r}r.cursor++}l=r.cursor;i:while(true){e:{if(!r.in_grouping(c,97,259)){break e}break i}if(r.cursor>=r.limit){break r}r.cursor++}i:while(true){e:{if(!r.out_grouping(c,97,259)){break e}break i}if(r.cursor>=r.limit){break r}r.cursor++}f=r.cursor}r.cursor=s;return true}function k(){var e;while(true){var a=r.cursor;r:{r.bra=r.cursor;e=r.find_among(i);if(e==0){break r}r.ket=r.cursor;switch(e){case 1:if(!r.slice_from("i")){return false}break;case 2:if(!r.slice_from("u")){return false}break;case 3:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=a;break}return true}function _(){if(!(n<=r.cursor)){return false}return true}function v(){if(!(l<=r.cursor)){return false}return true}function g(){if(!(f<=r.cursor)){return false}return true}function w(){var i;r.ket=r.cursor;i=r.find_among_b(e);if(i==0){return false}r.bra=r.cursor;if(!v()){return false}switch(i){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("a")){return false}break;case 3:if(!r.slice_from("e")){return false}break;case 4:if(!r.slice_from("i")){return false}break;case 5:{var a=r.limit-r.cursor;r:{if(!r.eq_s_b("ab")){break r}return false}r.cursor=r.limit-a}if(!r.slice_from("i")){return false}break;case 6:if(!r.slice_from("at")){return false}break;case 7:if(!r.slice_from("aţi")){return false}break}return true}function d(){var i;var e=r.limit-r.cursor;r.ket=r.cursor;i=r.find_among_b(a);if(i==0){return false}r.bra=r.cursor;if(!v()){return false}switch(i){case 1:if(!r.slice_from("abil")){return false}break;case 2:if(!r.slice_from("ibil")){return false}break;case 3:if(!r.slice_from("iv")){return false}break;case 4:if(!r.slice_from("ic")){return false}break;case 5:if(!r.slice_from("at")){return false}break;case 6:if(!r.slice_from("it")){return false}break}o=true;r.cursor=r.limit-e;return true}function h(){var i;o=false;while(true){var e=r.limit-r.cursor;r:{if(!d()){break r}continue}r.cursor=r.limit-e;break}r.ket=r.cursor;i=r.find_among_b(t);if(i==0){return false}r.bra=r.cursor;if(!g()){return false}switch(i){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.eq_s_b("ţ")){return false}r.bra=r.cursor;if(!r.slice_from("t")){return false}break;case 3:if(!r.slice_from("ist")){return false}break}o=true;return true}function p(){var i;if(r.cursor{var i,r=s.limit-s.cursor;if(s.ket=s.cursor,0!=(i=s.find_among_b(e))&&(s.bra=s.cursor,_())){switch(i){case 1:if(s.slice_from("abil"))break;return;case 2:if(s.slice_from("ibil"))break;return;case 3:if(s.slice_from("iv"))break;return;case 4:if(s.slice_from("ic"))break;return;case 5:if(s.slice_from("at"))break;return;case 6:if(s.slice_from("it"))break;return}return l=!0,s.cursor=s.limit-r,1}})()){s.cursor=s.limit-r;break}}if(s.ket=s.cursor,0!=(i=s.find_among_b(a))&&(s.bra=s.cursor,m<=s.cursor)){switch(i){case 1:if(s.slice_del())break;return;case 2:if(!s.eq_s_b("ț"))return;if(s.bra=s.cursor,s.slice_from("t"))break;return;case 3:if(s.slice_from("ist"))break;return}l=!0}}function g(){s.ket=s.cursor,0!=s.find_among_b(i)&&(s.bra=s.cursor,b<=s.cursor)&&s.slice_del()}this.stem=function(){(()=>{for(var i,r=s.cursor;;){var e=s.cursor;i:{for(;;){var a=s.cursor;if(s.bra=s.cursor,0!=(i=s.find_among(t))){switch(s.ket=s.cursor,i){case 1:if(s.slice_from("ș"))break;return;case 2:if(s.slice_from("ț"))break;return}s.cursor=a;break}if(s.cursor=a,s.cursor>=s.limit)break i;s.cursor++}continue}s.cursor=e;break}s.cursor=r})();var i=s.cursor,i=((()=>{for(;;){var i=s.cursor;i:{for(;;){var r=s.cursor;r:if(s.in_grouping(n,97,259)){s.bra=s.cursor;e:{var e=s.cursor;if(s.eq_s("u")&&(s.ket=s.cursor,s.in_grouping(n,97,259))){if(s.slice_from("U"))break e;return}if(s.cursor=e,!s.eq_s("i"))break r;if(s.ket=s.cursor,!s.in_grouping(n,97,259))break r;if(!s.slice_from("I"))return}s.cursor=r;break}if(s.cursor=r,s.cursor>=s.limit)break i;s.cursor++}continue}s.cursor=i;break}})(),s.cursor=i,b=s.limit,f=s.limit,m=s.limit,s.cursor);i:{r:{var r=s.cursor;e:if(s.in_grouping(n,97,259)){var e=s.cursor;if(!s.out_grouping(n,97,259)||!s.go_out_grouping(n,97,259)){if(s.cursor=e,!s.in_grouping(n,97,259))break e;if(!s.go_in_grouping(n,97,259))break e}s.cursor++;break r}if(s.cursor=r,!s.out_grouping(n,97,259))break i;e=s.cursor;if(s.out_grouping(n,97,259)&&s.go_out_grouping(n,97,259));else{if(s.cursor=e,!s.in_grouping(n,97,259))break i;if(s.cursor>=s.limit)break i}s.cursor++}b=s.cursor}s.cursor=i,i=s.cursor,s.go_out_grouping(n,97,259)&&(s.cursor++,s.go_in_grouping(n,97,259))&&(s.cursor++,f=s.cursor,s.go_out_grouping(n,97,259))&&(s.cursor++,s.go_in_grouping(n,97,259))&&(s.cursor++,m=s.cursor),s.cursor=i,s.limit_backward=s.cursor,s.cursor=s.limit;var i=s.limit-s.cursor,i=((()=>{var i;if(s.ket=s.cursor,0!=(i=s.find_among_b(o))&&(s.bra=s.cursor,_()))switch(i){case 1:if(s.slice_del())break;return;case 2:if(s.slice_from("a"))break;return;case 3:if(s.slice_from("e"))break;return;case 4:if(s.slice_from("i"))break;return;case 5:var r=s.limit-s.cursor;if(s.eq_s_b("ab"))return;if(s.cursor=s.limit-r,s.slice_from("i"))break;return;case 6:if(s.slice_from("at"))break;return;case 7:if(s.slice_from("ați"))break}})(),s.cursor=s.limit-i,s.limit-s.cursor),i=(k(),s.cursor=s.limit-i,s.limit-s.cursor),a=s.limit-s.cursor,a=(l||(s.cursor=s.limit-a,(()=>{var i;if(!(s.cursor{for(var i;;){var r=s.cursor;i:{switch(s.bra=s.cursor,i=s.find_among(u),s.ket=s.cursor,i){case 1:if(s.slice_from("i"))break;return;case 2:if(s.slice_from("u"))break;return;case 3:if(s.cursor>=s.limit)break i;s.cursor++}continue}s.cursor=r;break}})(),s.cursor=i,!0},this.stemWord=function(i){return s.setCurrent(i),this.stem(),s.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/russian-stemmer.js b/sphinx/search/minified-js/russian-stemmer.js index 698d92bcdb8..7b5410c5e82 100644 --- a/sphinx/search/minified-js/russian-stemmer.js +++ b/sphinx/search/minified-js/russian-stemmer.js @@ -1 +1 @@ -RussianStemmer=function(){var r=new BaseStemmer;var e=[["в",-1,1],["ив",0,2],["ыв",0,2],["вши",-1,1],["ивши",3,2],["ывши",3,2],["вшись",-1,1],["ившись",6,2],["ывшись",6,2]];var i=[["ее",-1,1],["ие",-1,1],["ое",-1,1],["ые",-1,1],["ими",-1,1],["ыми",-1,1],["ей",-1,1],["ий",-1,1],["ой",-1,1],["ый",-1,1],["ем",-1,1],["им",-1,1],["ом",-1,1],["ым",-1,1],["его",-1,1],["ого",-1,1],["ему",-1,1],["ому",-1,1],["их",-1,1],["ых",-1,1],["ею",-1,1],["ою",-1,1],["ую",-1,1],["юю",-1,1],["ая",-1,1],["яя",-1,1]];var u=[["ем",-1,1],["нн",-1,1],["вш",-1,1],["ивш",2,2],["ывш",2,2],["щ",-1,1],["ющ",5,1],["ующ",6,2]];var s=[["сь",-1,1],["ся",-1,1]];var a=[["ла",-1,1],["ила",0,2],["ыла",0,2],["на",-1,1],["ена",3,2],["ете",-1,1],["ите",-1,2],["йте",-1,1],["ейте",7,2],["уйте",7,2],["ли",-1,1],["или",10,2],["ыли",10,2],["й",-1,1],["ей",13,2],["уй",13,2],["л",-1,1],["ил",16,2],["ыл",16,2],["ем",-1,1],["им",-1,2],["ым",-1,2],["н",-1,1],["ен",22,2],["ло",-1,1],["ило",24,2],["ыло",24,2],["но",-1,1],["ено",27,2],["нно",27,1],["ет",-1,1],["ует",30,2],["ит",-1,2],["ыт",-1,2],["ют",-1,1],["уют",34,2],["ят",-1,2],["ны",-1,1],["ены",37,2],["ть",-1,1],["ить",39,2],["ыть",39,2],["ешь",-1,1],["ишь",-1,2],["ю",-1,2],["ую",44,2]];var t=[["а",-1,1],["ев",-1,1],["ов",-1,1],["е",-1,1],["ие",3,1],["ье",3,1],["и",-1,1],["еи",6,1],["ии",6,1],["ами",6,1],["ями",6,1],["иями",10,1],["й",-1,1],["ей",12,1],["ией",13,1],["ий",12,1],["ой",12,1],["ам",-1,1],["ем",-1,1],["ием",18,1],["ом",-1,1],["ям",-1,1],["иям",21,1],["о",-1,1],["у",-1,1],["ах",-1,1],["ях",-1,1],["иях",26,1],["ы",-1,1],["ь",-1,1],["ю",-1,1],["ию",30,1],["ью",30,1],["я",-1,1],["ия",33,1],["ья",33,1]];var c=[["ост",-1,1],["ость",-1,1]];var f=[["ейше",-1,1],["н",-1,2],["ейш",-1,1],["ь",-1,3]];var l=[33,65,8,232];var o=0;var n=0;function b(){n=r.limit;o=r.limit;var e=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(l,1072,1103)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}n=r.cursor;e:while(true){i:{if(!r.out_grouping(l,1072,1103)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.in_grouping(l,1072,1103)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(l,1072,1103)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}o=r.cursor}r.cursor=e;return true}function _(){if(!(o<=r.cursor)){return false}return true}function k(){var i;r.ket=r.cursor;i=r.find_among_b(e);if(i==0){return false}r.bra=r.cursor;switch(i){case 1:r:{var u=r.limit-r.cursor;e:{if(!r.eq_s_b("а")){break e}break r}r.cursor=r.limit-u;if(!r.eq_s_b("я")){return false}}if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}break}return true}function m(){r.ket=r.cursor;if(r.find_among_b(i)==0){return false}r.bra=r.cursor;if(!r.slice_del()){return false}return true}function v(){var e;if(!m()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(u);if(e==0){r.cursor=r.limit-i;break r}r.bra=r.cursor;switch(e){case 1:e:{var s=r.limit-r.cursor;i:{if(!r.eq_s_b("а")){break i}break e}r.cursor=r.limit-s;if(!r.eq_s_b("я")){r.cursor=r.limit-i;break r}}if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}break}}return true}function d(){r.ket=r.cursor;if(r.find_among_b(s)==0){return false}r.bra=r.cursor;if(!r.slice_del()){return false}return true}function g(){var e;r.ket=r.cursor;e=r.find_among_b(a);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:r:{var i=r.limit-r.cursor;e:{if(!r.eq_s_b("а")){break e}break r}r.cursor=r.limit-i;if(!r.eq_s_b("я")){return false}}if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}break}return true}function w(){r.ket=r.cursor;if(r.find_among_b(t)==0){return false}r.bra=r.cursor;if(!r.slice_del()){return false}return true}function h(){r.ket=r.cursor;if(r.find_among_b(c)==0){return false}r.bra=r.cursor;if(!_()){return false}if(!r.slice_del()){return false}return true}function q(){var e;r.ket=r.cursor;e=r.find_among_b(f);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("н")){return false}r.bra=r.cursor;if(!r.eq_s_b("н")){return false}if(!r.slice_del()){return false}break;case 2:if(!r.eq_s_b("н")){return false}if(!r.slice_del()){return false}break;case 3:if(!r.slice_del()){return false}break}return true}this.stem=function(){var e=r.cursor;r:{while(true){var i=r.cursor;e:{i:while(true){var u=r.cursor;u:{r.bra=r.cursor;if(!r.eq_s("ё")){break u}r.ket=r.cursor;r.cursor=u;break i}r.cursor=u;if(r.cursor>=r.limit){break e}r.cursor++}if(!r.slice_from("е")){return false}continue}r.cursor=i;break}}r.cursor=e;b();r.limit_backward=r.cursor;r.cursor=r.limit;if(r.cursor=u.limit)break r;u.cursor++}if(u.slice_from("е"))continue;return!1}u.cursor=i;break}if(u.cursor=r,b=u.limit,m=u.limit,r=u.cursor,u.go_out_grouping(n,1072,1103)&&(u.cursor++,b=u.cursor,u.go_in_grouping(n,1072,1103))&&(u.cursor++,u.go_out_grouping(n,1072,1103))&&(u.cursor++,u.go_in_grouping(n,1072,1103))&&(u.cursor++,m=u.cursor),u.cursor=r,u.limit_backward=u.cursor,u.cursor=u.limit,u.cursor{var r;if(u.ket=u.cursor,0!=(r=u.find_among_b(o))){switch(u.bra=u.cursor,r){case 1:var i=u.limit-u.cursor;if(!u.eq_s_b("а")&&(u.cursor=u.limit-i,!u.eq_s_b("я")))return;if(u.slice_del())break;return;case 2:if(u.slice_del())break;return}return 1}})()){u.cursor=u.limit-c;c=u.limit-u.cursor,c=(u.ket=u.cursor,0!=u.find_among_b(t)&&(u.bra=u.cursor,u.slice_del())||(u.cursor=u.limit-c),u.limit-u.cursor);if(!f()&&(u.cursor=u.limit-c,!(()=>{var r;if(u.ket=u.cursor,0!=(r=u.find_among_b(a))){switch(u.bra=u.cursor,r){case 1:var i=u.limit-u.cursor;if(!u.eq_s_b("а")&&(u.cursor=u.limit-i,!u.eq_s_b("я")))return;if(u.slice_del())break;return;case 2:if(u.slice_del())break;return}return 1}})())&&(u.cursor=u.limit-c,u.ket=u.cursor,0==u.find_among_b(l)||(u.bra=u.cursor,!u.slice_del())))break r}}u.cursor=u.limit-e;e=u.limit-u.cursor;if(u.ket=u.cursor,u.eq_s_b("и")){if(u.bra=u.cursor,!u.slice_del())return!1}else u.cursor=u.limit-e;e=u.limit-u.cursor,k(),u.cursor=u.limit-e,e=u.limit-u.cursor;return(()=>{var r;if(u.ket=u.cursor,0!=(r=u.find_among_b(_)))switch(u.bra=u.cursor,r){case 1:if(!u.slice_del())return;if(u.ket=u.cursor,!u.eq_s_b("н"))return;if(u.bra=u.cursor,!u.eq_s_b("н"))return;if(u.slice_del())break;return;case 2:if(!u.eq_s_b("н"))return;if(u.slice_del())break;return;case 3:if(u.slice_del())break}})(),u.cursor=u.limit-e,u.limit_backward=r,u.cursor=u.limit_backward,!0},this.stemWord=function(r){return u.setCurrent(r),this.stem(),u.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/serbian-stemmer.js b/sphinx/search/minified-js/serbian-stemmer.js new file mode 100644 index 00000000000..0ac2621eb22 --- /dev/null +++ b/sphinx/search/minified-js/serbian-stemmer.js @@ -0,0 +1 @@ +var SerbianStemmer=function(){var m=new BaseStemmer,s=[["а",-1,1],["б",-1,2],["в",-1,3],["г",-1,4],["д",-1,5],["е",-1,7],["ж",-1,8],["з",-1,9],["и",-1,10],["к",-1,12],["л",-1,13],["м",-1,15],["н",-1,16],["о",-1,18],["п",-1,19],["р",-1,20],["с",-1,21],["т",-1,22],["у",-1,24],["ф",-1,25],["х",-1,26],["ц",-1,27],["ч",-1,28],["ш",-1,30],["ђ",-1,6],["ј",-1,11],["љ",-1,14],["њ",-1,17],["ћ",-1,23],["џ",-1,29]],r=[["daba",-1,73],["ajaca",-1,12],["ejaca",-1,14],["ljaca",-1,13],["njaca",-1,85],["ojaca",-1,15],["alaca",-1,82],["elaca",-1,83],["olaca",-1,84],["maca",-1,75],["naca",-1,76],["raca",-1,81],["saca",-1,80],["vaca",-1,79],["šaca",-1,18],["aoca",-1,82],["acaka",-1,55],["ajaka",-1,16],["ojaka",-1,17],["anaka",-1,78],["ataka",-1,58],["etaka",-1,59],["itaka",-1,60],["otaka",-1,61],["utaka",-1,62],["ačaka",-1,54],["esama",-1,67],["izama",-1,87],["jacima",-1,5],["nicima",-1,23],["ticima",-1,24],["teticima",30,21],["zicima",-1,25],["atcima",-1,58],["utcima",-1,62],["čcima",-1,74],["pesima",-1,2],["inzima",-1,19],["lozima",-1,1],["metara",-1,68],["centara",-1,69],["istara",-1,70],["ekata",-1,86],["anata",-1,53],["nstava",-1,22],["kustava",-1,29],["ajac",-1,12],["ejac",-1,14],["ljac",-1,13],["njac",-1,85],["anjac",49,11],["ojac",-1,15],["alac",-1,82],["elac",-1,83],["olac",-1,84],["mac",-1,75],["nac",-1,76],["rac",-1,81],["sac",-1,80],["vac",-1,79],["šac",-1,18],["jebe",-1,88],["olce",-1,84],["kuse",-1,27],["rave",-1,42],["save",-1,52],["šave",-1,51],["baci",-1,89],["jaci",-1,5],["tvenici",-1,20],["snici",-1,26],["tetici",-1,21],["bojci",-1,4],["vojci",-1,3],["ojsci",-1,66],["atci",-1,58],["itci",-1,60],["utci",-1,62],["čci",-1,74],["pesi",-1,2],["inzi",-1,19],["lozi",-1,1],["acak",-1,55],["usak",-1,57],["atak",-1,58],["etak",-1,59],["itak",-1,60],["otak",-1,61],["utak",-1,62],["ačak",-1,54],["ušak",-1,56],["izam",-1,87],["tican",-1,65],["cajan",-1,7],["čajan",-1,6],["voljan",-1,77],["eskan",-1,63],["alan",-1,40],["bilan",-1,33],["gilan",-1,37],["nilan",-1,39],["rilan",-1,38],["silan",-1,36],["tilan",-1,34],["avilan",-1,35],["laran",-1,9],["eran",-1,8],["asan",-1,91],["esan",-1,10],["dusan",-1,31],["kusan",-1,28],["atan",-1,47],["pletan",-1,50],["tetan",-1,49],["antan",-1,32],["pravan",-1,44],["stavan",-1,43],["sivan",-1,46],["tivan",-1,45],["ozan",-1,41],["tičan",-1,64],["ašan",-1,90],["dušan",-1,30],["metar",-1,68],["centar",-1,69],["istar",-1,70],["ekat",-1,86],["enat",-1,48],["oscu",-1,72],["ošću",-1,71]],o=[["aca",-1,124],["eca",-1,125],["uca",-1,126],["ga",-1,20],["acega",3,124],["ecega",3,125],["ucega",3,126],["anjijega",3,84],["enjijega",3,85],["snjijega",3,122],["šnjijega",3,86],["kijega",3,95],["skijega",11,1],["škijega",11,2],["elijega",3,83],["nijega",3,13],["osijega",3,123],["atijega",3,120],["evitijega",3,92],["ovitijega",3,93],["astijega",3,94],["avijega",3,77],["evijega",3,78],["ivijega",3,79],["ovijega",3,80],["ošijega",3,91],["anjega",3,84],["enjega",3,85],["snjega",3,122],["šnjega",3,86],["kega",3,95],["skega",30,1],["škega",30,2],["elega",3,83],["nega",3,13],["anega",34,10],["enega",34,87],["snega",34,159],["šnega",34,88],["osega",3,123],["atega",3,120],["evitega",3,92],["ovitega",3,93],["astega",3,94],["avega",3,77],["evega",3,78],["ivega",3,79],["ovega",3,80],["aćega",3,14],["ećega",3,15],["ućega",3,16],["ošega",3,91],["acoga",3,124],["ecoga",3,125],["ucoga",3,126],["anjoga",3,84],["enjoga",3,85],["snjoga",3,122],["šnjoga",3,86],["koga",3,95],["skoga",59,1],["škoga",59,2],["loga",3,19],["eloga",62,83],["noga",3,13],["cinoga",64,137],["činoga",64,89],["osoga",3,123],["atoga",3,120],["evitoga",3,92],["ovitoga",3,93],["astoga",3,94],["avoga",3,77],["evoga",3,78],["ivoga",3,79],["ovoga",3,80],["aćoga",3,14],["ećoga",3,15],["ućoga",3,16],["ošoga",3,91],["uga",3,18],["aja",-1,109],["caja",81,26],["laja",81,30],["raja",81,31],["ćaja",81,28],["čaja",81,27],["đaja",81,29],["bija",-1,32],["cija",-1,33],["dija",-1,34],["fija",-1,40],["gija",-1,39],["anjija",-1,84],["enjija",-1,85],["snjija",-1,122],["šnjija",-1,86],["kija",-1,95],["skija",97,1],["škija",97,2],["lija",-1,24],["elija",100,83],["mija",-1,37],["nija",-1,13],["ganija",103,9],["manija",103,6],["panija",103,7],["ranija",103,8],["tanija",103,5],["pija",-1,41],["rija",-1,42],["rarija",110,21],["sija",-1,23],["osija",112,123],["tija",-1,44],["atija",114,120],["evitija",114,92],["ovitija",114,93],["otija",114,22],["astija",114,94],["avija",-1,77],["evija",-1,78],["ivija",-1,79],["ovija",-1,80],["zija",-1,45],["ošija",-1,91],["žija",-1,38],["anja",-1,84],["enja",-1,85],["snja",-1,122],["šnja",-1,86],["ka",-1,95],["ska",131,1],["ška",131,2],["ala",-1,104],["acala",134,128],["astajala",134,106],["istajala",134,107],["ostajala",134,108],["ijala",134,47],["injala",134,114],["nala",134,46],["irala",134,100],["urala",134,105],["tala",134,113],["astala",144,110],["istala",144,111],["ostala",144,112],["avala",134,97],["evala",134,96],["ivala",134,98],["ovala",134,76],["uvala",134,99],["ačala",134,102],["ela",-1,83],["ila",-1,116],["acila",155,124],["lucila",155,121],["nila",155,103],["astanila",158,110],["istanila",158,111],["ostanila",158,112],["rosila",155,127],["jetila",155,118],["ozila",155,48],["ačila",155,101],["lučila",155,117],["rošila",155,90],["ola",-1,50],["asla",-1,115],["nula",-1,13],["gama",-1,20],["logama",171,19],["ugama",171,18],["ajama",-1,109],["cajama",174,26],["lajama",174,30],["rajama",174,31],["ćajama",174,28],["čajama",174,27],["đajama",174,29],["bijama",-1,32],["cijama",-1,33],["dijama",-1,34],["fijama",-1,40],["gijama",-1,39],["lijama",-1,35],["mijama",-1,37],["nijama",-1,36],["ganijama",188,9],["manijama",188,6],["panijama",188,7],["ranijama",188,8],["tanijama",188,5],["pijama",-1,41],["rijama",-1,42],["sijama",-1,43],["tijama",-1,44],["zijama",-1,45],["žijama",-1,38],["alama",-1,104],["ijalama",200,47],["nalama",200,46],["elama",-1,119],["ilama",-1,116],["ramama",-1,52],["lemama",-1,51],["inama",-1,11],["cinama",207,137],["činama",207,89],["rama",-1,52],["arama",210,53],["drama",210,54],["erama",210,55],["orama",210,56],["basama",-1,135],["gasama",-1,131],["jasama",-1,129],["kasama",-1,133],["nasama",-1,132],["tasama",-1,130],["vasama",-1,134],["esama",-1,152],["isama",-1,154],["etama",-1,70],["estama",-1,71],["istama",-1,72],["kstama",-1,73],["ostama",-1,74],["avama",-1,77],["evama",-1,78],["ivama",-1,79],["bašama",-1,63],["gašama",-1,64],["jašama",-1,61],["kašama",-1,62],["našama",-1,60],["tašama",-1,59],["vašama",-1,65],["ešama",-1,66],["išama",-1,67],["lema",-1,51],["acima",-1,124],["ecima",-1,125],["ucima",-1,126],["ajima",-1,109],["cajima",245,26],["lajima",245,30],["rajima",245,31],["ćajima",245,28],["čajima",245,27],["đajima",245,29],["bijima",-1,32],["cijima",-1,33],["dijima",-1,34],["fijima",-1,40],["gijima",-1,39],["anjijima",-1,84],["enjijima",-1,85],["snjijima",-1,122],["šnjijima",-1,86],["kijima",-1,95],["skijima",261,1],["škijima",261,2],["lijima",-1,35],["elijima",264,83],["mijima",-1,37],["nijima",-1,13],["ganijima",267,9],["manijima",267,6],["panijima",267,7],["ranijima",267,8],["tanijima",267,5],["pijima",-1,41],["rijima",-1,42],["sijima",-1,43],["osijima",275,123],["tijima",-1,44],["atijima",277,120],["evitijima",277,92],["ovitijima",277,93],["astijima",277,94],["avijima",-1,77],["evijima",-1,78],["ivijima",-1,79],["ovijima",-1,80],["zijima",-1,45],["ošijima",-1,91],["žijima",-1,38],["anjima",-1,84],["enjima",-1,85],["snjima",-1,122],["šnjima",-1,86],["kima",-1,95],["skima",293,1],["škima",293,2],["alima",-1,104],["ijalima",296,47],["nalima",296,46],["elima",-1,83],["ilima",-1,116],["ozilima",300,48],["olima",-1,50],["lemima",-1,51],["nima",-1,13],["anima",304,10],["inima",304,11],["cinima",306,137],["činima",306,89],["onima",304,12],["arima",-1,53],["drima",-1,54],["erima",-1,55],["orima",-1,56],["basima",-1,135],["gasima",-1,131],["jasima",-1,129],["kasima",-1,133],["nasima",-1,132],["tasima",-1,130],["vasima",-1,134],["esima",-1,57],["isima",-1,58],["osima",-1,123],["atima",-1,120],["ikatima",324,68],["latima",324,69],["etima",-1,70],["evitima",-1,92],["ovitima",-1,93],["astima",-1,94],["estima",-1,71],["istima",-1,72],["kstima",-1,73],["ostima",-1,74],["ištima",-1,75],["avima",-1,77],["evima",-1,78],["ajevima",337,109],["cajevima",338,26],["lajevima",338,30],["rajevima",338,31],["ćajevima",338,28],["čajevima",338,27],["đajevima",338,29],["ivima",-1,79],["ovima",-1,80],["govima",346,20],["ugovima",347,17],["lovima",346,82],["olovima",349,49],["movima",346,81],["onovima",346,12],["stvima",-1,3],["štvima",-1,4],["aćima",-1,14],["ećima",-1,15],["ućima",-1,16],["bašima",-1,63],["gašima",-1,64],["jašima",-1,61],["kašima",-1,62],["našima",-1,60],["tašima",-1,59],["vašima",-1,65],["ešima",-1,66],["išima",-1,67],["ošima",-1,91],["na",-1,13],["ana",368,10],["acana",369,128],["urana",369,105],["tana",369,113],["avana",369,97],["evana",369,96],["ivana",369,98],["uvana",369,99],["ačana",369,102],["acena",368,124],["lucena",368,121],["ačena",368,101],["lučena",368,117],["ina",368,11],["cina",382,137],["anina",382,10],["čina",382,89],["ona",368,12],["ara",-1,53],["dra",-1,54],["era",-1,55],["ora",-1,56],["basa",-1,135],["gasa",-1,131],["jasa",-1,129],["kasa",-1,133],["nasa",-1,132],["tasa",-1,130],["vasa",-1,134],["esa",-1,57],["isa",-1,58],["osa",-1,123],["ata",-1,120],["ikata",401,68],["lata",401,69],["eta",-1,70],["evita",-1,92],["ovita",-1,93],["asta",-1,94],["esta",-1,71],["ista",-1,72],["ksta",-1,73],["osta",-1,74],["nuta",-1,13],["išta",-1,75],["ava",-1,77],["eva",-1,78],["ajeva",415,109],["cajeva",416,26],["lajeva",416,30],["rajeva",416,31],["ćajeva",416,28],["čajeva",416,27],["đajeva",416,29],["iva",-1,79],["ova",-1,80],["gova",424,20],["ugova",425,17],["lova",424,82],["olova",427,49],["mova",424,81],["onova",424,12],["stva",-1,3],["štva",-1,4],["aća",-1,14],["eća",-1,15],["uća",-1,16],["baša",-1,63],["gaša",-1,64],["jaša",-1,61],["kaša",-1,62],["naša",-1,60],["taša",-1,59],["vaša",-1,65],["eša",-1,66],["iša",-1,67],["oša",-1,91],["ace",-1,124],["ece",-1,125],["uce",-1,126],["luce",448,121],["astade",-1,110],["istade",-1,111],["ostade",-1,112],["ge",-1,20],["loge",453,19],["uge",453,18],["aje",-1,104],["caje",456,26],["laje",456,30],["raje",456,31],["astaje",456,106],["istaje",456,107],["ostaje",456,108],["ćaje",456,28],["čaje",456,27],["đaje",456,29],["ije",-1,116],["bije",466,32],["cije",466,33],["dije",466,34],["fije",466,40],["gije",466,39],["anjije",466,84],["enjije",466,85],["snjije",466,122],["šnjije",466,86],["kije",466,95],["skije",476,1],["škije",476,2],["lije",466,35],["elije",479,83],["mije",466,37],["nije",466,13],["ganije",482,9],["manije",482,6],["panije",482,7],["ranije",482,8],["tanije",482,5],["pije",466,41],["rije",466,42],["sije",466,43],["osije",490,123],["tije",466,44],["atije",492,120],["evitije",492,92],["ovitije",492,93],["astije",492,94],["avije",466,77],["evije",466,78],["ivije",466,79],["ovije",466,80],["zije",466,45],["ošije",466,91],["žije",466,38],["anje",-1,84],["enje",-1,85],["snje",-1,122],["šnje",-1,86],["uje",-1,25],["lucuje",508,121],["iruje",508,100],["lučuje",508,117],["ke",-1,95],["ske",512,1],["ške",512,2],["ale",-1,104],["acale",515,128],["astajale",515,106],["istajale",515,107],["ostajale",515,108],["ijale",515,47],["injale",515,114],["nale",515,46],["irale",515,100],["urale",515,105],["tale",515,113],["astale",525,110],["istale",525,111],["ostale",525,112],["avale",515,97],["evale",515,96],["ivale",515,98],["ovale",515,76],["uvale",515,99],["ačale",515,102],["ele",-1,83],["ile",-1,116],["acile",536,124],["lucile",536,121],["nile",536,103],["rosile",536,127],["jetile",536,118],["ozile",536,48],["ačile",536,101],["lučile",536,117],["rošile",536,90],["ole",-1,50],["asle",-1,115],["nule",-1,13],["rame",-1,52],["leme",-1,51],["acome",-1,124],["ecome",-1,125],["ucome",-1,126],["anjome",-1,84],["enjome",-1,85],["snjome",-1,122],["šnjome",-1,86],["kome",-1,95],["skome",558,1],["škome",558,2],["elome",-1,83],["nome",-1,13],["cinome",562,137],["činome",562,89],["osome",-1,123],["atome",-1,120],["evitome",-1,92],["ovitome",-1,93],["astome",-1,94],["avome",-1,77],["evome",-1,78],["ivome",-1,79],["ovome",-1,80],["aćome",-1,14],["ećome",-1,15],["ućome",-1,16],["ošome",-1,91],["ne",-1,13],["ane",578,10],["acane",579,128],["urane",579,105],["tane",579,113],["astane",582,110],["istane",582,111],["ostane",582,112],["avane",579,97],["evane",579,96],["ivane",579,98],["uvane",579,99],["ačane",579,102],["acene",578,124],["lucene",578,121],["ačene",578,101],["lučene",578,117],["ine",578,11],["cine",595,137],["anine",595,10],["čine",595,89],["one",578,12],["are",-1,53],["dre",-1,54],["ere",-1,55],["ore",-1,56],["ase",-1,161],["base",604,135],["acase",604,128],["gase",604,131],["jase",604,129],["astajase",608,138],["istajase",608,139],["ostajase",608,140],["injase",608,150],["kase",604,133],["nase",604,132],["irase",604,155],["urase",604,156],["tase",604,130],["vase",604,134],["avase",618,144],["evase",618,145],["ivase",618,146],["ovase",618,148],["uvase",618,147],["ese",-1,57],["ise",-1,58],["acise",625,124],["lucise",625,121],["rosise",625,127],["jetise",625,149],["ose",-1,123],["astadose",630,141],["istadose",630,142],["ostadose",630,143],["ate",-1,104],["acate",634,128],["ikate",634,68],["late",634,69],["irate",634,100],["urate",634,105],["tate",634,113],["avate",634,97],["evate",634,96],["ivate",634,98],["uvate",634,99],["ačate",634,102],["ete",-1,70],["astadete",646,110],["istadete",646,111],["ostadete",646,112],["astajete",646,106],["istajete",646,107],["ostajete",646,108],["ijete",646,116],["injete",646,114],["ujete",646,25],["lucujete",655,121],["irujete",655,100],["lučujete",655,117],["nete",646,13],["astanete",659,110],["istanete",659,111],["ostanete",659,112],["astete",646,115],["ite",-1,116],["acite",664,124],["lucite",664,121],["nite",664,13],["astanite",667,110],["istanite",667,111],["ostanite",667,112],["rosite",664,127],["jetite",664,118],["astite",664,115],["evite",664,92],["ovite",664,93],["ačite",664,101],["lučite",664,117],["rošite",664,90],["ajte",-1,104],["urajte",679,105],["tajte",679,113],["astajte",681,106],["istajte",681,107],["ostajte",681,108],["avajte",679,97],["evajte",679,96],["ivajte",679,98],["uvajte",679,99],["ijte",-1,116],["lucujte",-1,121],["irujte",-1,100],["lučujte",-1,117],["aste",-1,94],["acaste",693,128],["astajaste",693,106],["istajaste",693,107],["ostajaste",693,108],["injaste",693,114],["iraste",693,100],["uraste",693,105],["taste",693,113],["avaste",693,97],["evaste",693,96],["ivaste",693,98],["ovaste",693,76],["uvaste",693,99],["ačaste",693,102],["este",-1,71],["iste",-1,72],["aciste",709,124],["luciste",709,121],["niste",709,103],["rosiste",709,127],["jetiste",709,118],["ačiste",709,101],["lučiste",709,117],["rošiste",709,90],["kste",-1,73],["oste",-1,74],["astadoste",719,110],["istadoste",719,111],["ostadoste",719,112],["nuste",-1,13],["ište",-1,75],["ave",-1,77],["eve",-1,78],["ajeve",726,109],["cajeve",727,26],["lajeve",727,30],["rajeve",727,31],["ćajeve",727,28],["čajeve",727,27],["đajeve",727,29],["ive",-1,79],["ove",-1,80],["gove",735,20],["ugove",736,17],["love",735,82],["olove",738,49],["move",735,81],["onove",735,12],["aće",-1,14],["eće",-1,15],["uće",-1,16],["ače",-1,101],["luče",-1,117],["aše",-1,104],["baše",747,63],["gaše",747,64],["jaše",747,61],["astajaše",750,106],["istajaše",750,107],["ostajaše",750,108],["injaše",750,114],["kaše",747,62],["naše",747,60],["iraše",747,100],["uraše",747,105],["taše",747,59],["vaše",747,65],["avaše",760,97],["evaše",760,96],["ivaše",760,98],["ovaše",760,76],["uvaše",760,99],["ačaše",747,102],["eše",-1,66],["iše",-1,67],["jetiše",768,118],["ačiše",768,101],["lučiše",768,117],["rošiše",768,90],["oše",-1,91],["astadoše",773,110],["istadoše",773,111],["ostadoše",773,112],["aceg",-1,124],["eceg",-1,125],["uceg",-1,126],["anjijeg",-1,84],["enjijeg",-1,85],["snjijeg",-1,122],["šnjijeg",-1,86],["kijeg",-1,95],["skijeg",784,1],["škijeg",784,2],["elijeg",-1,83],["nijeg",-1,13],["osijeg",-1,123],["atijeg",-1,120],["evitijeg",-1,92],["ovitijeg",-1,93],["astijeg",-1,94],["avijeg",-1,77],["evijeg",-1,78],["ivijeg",-1,79],["ovijeg",-1,80],["ošijeg",-1,91],["anjeg",-1,84],["enjeg",-1,85],["snjeg",-1,122],["šnjeg",-1,86],["keg",-1,95],["eleg",-1,83],["neg",-1,13],["aneg",805,10],["eneg",805,87],["sneg",805,159],["šneg",805,88],["oseg",-1,123],["ateg",-1,120],["aveg",-1,77],["eveg",-1,78],["iveg",-1,79],["oveg",-1,80],["aćeg",-1,14],["ećeg",-1,15],["ućeg",-1,16],["ošeg",-1,91],["acog",-1,124],["ecog",-1,125],["ucog",-1,126],["anjog",-1,84],["enjog",-1,85],["snjog",-1,122],["šnjog",-1,86],["kog",-1,95],["skog",827,1],["škog",827,2],["elog",-1,83],["nog",-1,13],["cinog",831,137],["činog",831,89],["osog",-1,123],["atog",-1,120],["evitog",-1,92],["ovitog",-1,93],["astog",-1,94],["avog",-1,77],["evog",-1,78],["ivog",-1,79],["ovog",-1,80],["aćog",-1,14],["ećog",-1,15],["ućog",-1,16],["ošog",-1,91],["ah",-1,104],["acah",847,128],["astajah",847,106],["istajah",847,107],["ostajah",847,108],["injah",847,114],["irah",847,100],["urah",847,105],["tah",847,113],["avah",847,97],["evah",847,96],["ivah",847,98],["ovah",847,76],["uvah",847,99],["ačah",847,102],["ih",-1,116],["acih",862,124],["ecih",862,125],["ucih",862,126],["lucih",865,121],["anjijih",862,84],["enjijih",862,85],["snjijih",862,122],["šnjijih",862,86],["kijih",862,95],["skijih",871,1],["škijih",871,2],["elijih",862,83],["nijih",862,13],["osijih",862,123],["atijih",862,120],["evitijih",862,92],["ovitijih",862,93],["astijih",862,94],["avijih",862,77],["evijih",862,78],["ivijih",862,79],["ovijih",862,80],["ošijih",862,91],["anjih",862,84],["enjih",862,85],["snjih",862,122],["šnjih",862,86],["kih",862,95],["skih",890,1],["ških",890,2],["elih",862,83],["nih",862,13],["cinih",894,137],["činih",894,89],["osih",862,123],["rosih",897,127],["atih",862,120],["jetih",862,118],["evitih",862,92],["ovitih",862,93],["astih",862,94],["avih",862,77],["evih",862,78],["ivih",862,79],["ovih",862,80],["aćih",862,14],["ećih",862,15],["ućih",862,16],["ačih",862,101],["lučih",862,117],["oših",862,91],["roših",913,90],["astadoh",-1,110],["istadoh",-1,111],["ostadoh",-1,112],["acuh",-1,124],["ecuh",-1,125],["ucuh",-1,126],["aćuh",-1,14],["ećuh",-1,15],["ućuh",-1,16],["aci",-1,124],["aceci",-1,124],["ieci",-1,162],["ajuci",-1,161],["irajuci",927,155],["urajuci",927,156],["astajuci",927,138],["istajuci",927,139],["ostajuci",927,140],["avajuci",927,144],["evajuci",927,145],["ivajuci",927,146],["uvajuci",927,147],["ujuci",-1,157],["lucujuci",937,121],["irujuci",937,155],["luci",-1,121],["nuci",-1,164],["etuci",-1,153],["astuci",-1,136],["gi",-1,20],["ugi",944,18],["aji",-1,109],["caji",946,26],["laji",946,30],["raji",946,31],["ćaji",946,28],["čaji",946,27],["đaji",946,29],["biji",-1,32],["ciji",-1,33],["diji",-1,34],["fiji",-1,40],["giji",-1,39],["anjiji",-1,84],["enjiji",-1,85],["snjiji",-1,122],["šnjiji",-1,86],["kiji",-1,95],["skiji",962,1],["škiji",962,2],["liji",-1,35],["eliji",965,83],["miji",-1,37],["niji",-1,13],["ganiji",968,9],["maniji",968,6],["paniji",968,7],["raniji",968,8],["taniji",968,5],["piji",-1,41],["riji",-1,42],["siji",-1,43],["osiji",976,123],["tiji",-1,44],["atiji",978,120],["evitiji",978,92],["ovitiji",978,93],["astiji",978,94],["aviji",-1,77],["eviji",-1,78],["iviji",-1,79],["oviji",-1,80],["ziji",-1,45],["ošiji",-1,91],["žiji",-1,38],["anji",-1,84],["enji",-1,85],["snji",-1,122],["šnji",-1,86],["ki",-1,95],["ski",994,1],["ški",994,2],["ali",-1,104],["acali",997,128],["astajali",997,106],["istajali",997,107],["ostajali",997,108],["ijali",997,47],["injali",997,114],["nali",997,46],["irali",997,100],["urali",997,105],["tali",997,113],["astali",1007,110],["istali",1007,111],["ostali",1007,112],["avali",997,97],["evali",997,96],["ivali",997,98],["ovali",997,76],["uvali",997,99],["ačali",997,102],["eli",-1,83],["ili",-1,116],["acili",1018,124],["lucili",1018,121],["nili",1018,103],["rosili",1018,127],["jetili",1018,118],["ozili",1018,48],["ačili",1018,101],["lučili",1018,117],["rošili",1018,90],["oli",-1,50],["asli",-1,115],["nuli",-1,13],["rami",-1,52],["lemi",-1,51],["ni",-1,13],["ani",1033,10],["acani",1034,128],["urani",1034,105],["tani",1034,113],["avani",1034,97],["evani",1034,96],["ivani",1034,98],["uvani",1034,99],["ačani",1034,102],["aceni",1033,124],["luceni",1033,121],["ačeni",1033,101],["lučeni",1033,117],["ini",1033,11],["cini",1047,137],["čini",1047,89],["oni",1033,12],["ari",-1,53],["dri",-1,54],["eri",-1,55],["ori",-1,56],["basi",-1,135],["gasi",-1,131],["jasi",-1,129],["kasi",-1,133],["nasi",-1,132],["tasi",-1,130],["vasi",-1,134],["esi",-1,152],["isi",-1,154],["osi",-1,123],["avsi",-1,161],["acavsi",1065,128],["iravsi",1065,155],["tavsi",1065,160],["etavsi",1068,153],["astavsi",1068,141],["istavsi",1068,142],["ostavsi",1068,143],["ivsi",-1,162],["nivsi",1073,158],["rosivsi",1073,127],["nuvsi",-1,164],["ati",-1,104],["acati",1077,128],["astajati",1077,106],["istajati",1077,107],["ostajati",1077,108],["injati",1077,114],["ikati",1077,68],["lati",1077,69],["irati",1077,100],["urati",1077,105],["tati",1077,113],["astati",1087,110],["istati",1087,111],["ostati",1087,112],["avati",1077,97],["evati",1077,96],["ivati",1077,98],["ovati",1077,76],["uvati",1077,99],["ačati",1077,102],["eti",-1,70],["iti",-1,116],["aciti",1098,124],["luciti",1098,121],["niti",1098,103],["rositi",1098,127],["jetiti",1098,118],["eviti",1098,92],["oviti",1098,93],["ačiti",1098,101],["lučiti",1098,117],["rošiti",1098,90],["asti",-1,94],["esti",-1,71],["isti",-1,72],["ksti",-1,73],["osti",-1,74],["nuti",-1,13],["avi",-1,77],["evi",-1,78],["ajevi",1116,109],["cajevi",1117,26],["lajevi",1117,30],["rajevi",1117,31],["ćajevi",1117,28],["čajevi",1117,27],["đajevi",1117,29],["ivi",-1,79],["ovi",-1,80],["govi",1125,20],["ugovi",1126,17],["lovi",1125,82],["olovi",1128,49],["movi",1125,81],["onovi",1125,12],["ieći",-1,116],["ačeći",-1,101],["ajući",-1,104],["irajući",1134,100],["urajući",1134,105],["astajući",1134,106],["istajući",1134,107],["ostajući",1134,108],["avajući",1134,97],["evajući",1134,96],["ivajući",1134,98],["uvajući",1134,99],["ujući",-1,25],["irujući",1144,100],["lučujući",1144,117],["nući",-1,13],["etući",-1,70],["astući",-1,115],["ači",-1,101],["luči",-1,117],["baši",-1,63],["gaši",-1,64],["jaši",-1,61],["kaši",-1,62],["naši",-1,60],["taši",-1,59],["vaši",-1,65],["eši",-1,66],["iši",-1,67],["oši",-1,91],["avši",-1,104],["iravši",1162,100],["tavši",1162,113],["etavši",1164,70],["astavši",1164,110],["istavši",1164,111],["ostavši",1164,112],["ačavši",1162,102],["ivši",-1,116],["nivši",1170,103],["rošivši",1170,90],["nuvši",-1,13],["aj",-1,104],["uraj",1174,105],["taj",1174,113],["avaj",1174,97],["evaj",1174,96],["ivaj",1174,98],["uvaj",1174,99],["ij",-1,116],["acoj",-1,124],["ecoj",-1,125],["ucoj",-1,126],["anjijoj",-1,84],["enjijoj",-1,85],["snjijoj",-1,122],["šnjijoj",-1,86],["kijoj",-1,95],["skijoj",1189,1],["škijoj",1189,2],["elijoj",-1,83],["nijoj",-1,13],["osijoj",-1,123],["evitijoj",-1,92],["ovitijoj",-1,93],["astijoj",-1,94],["avijoj",-1,77],["evijoj",-1,78],["ivijoj",-1,79],["ovijoj",-1,80],["ošijoj",-1,91],["anjoj",-1,84],["enjoj",-1,85],["snjoj",-1,122],["šnjoj",-1,86],["koj",-1,95],["skoj",1207,1],["škoj",1207,2],["aloj",-1,104],["eloj",-1,83],["noj",-1,13],["cinoj",1212,137],["činoj",1212,89],["osoj",-1,123],["atoj",-1,120],["evitoj",-1,92],["ovitoj",-1,93],["astoj",-1,94],["avoj",-1,77],["evoj",-1,78],["ivoj",-1,79],["ovoj",-1,80],["aćoj",-1,14],["ećoj",-1,15],["ućoj",-1,16],["ošoj",-1,91],["lucuj",-1,121],["iruj",-1,100],["lučuj",-1,117],["al",-1,104],["iral",1231,100],["ural",1231,105],["el",-1,119],["il",-1,116],["am",-1,104],["acam",1236,128],["iram",1236,100],["uram",1236,105],["tam",1236,113],["avam",1236,97],["evam",1236,96],["ivam",1236,98],["uvam",1236,99],["ačam",1236,102],["em",-1,119],["acem",1246,124],["ecem",1246,125],["ucem",1246,126],["astadem",1246,110],["istadem",1246,111],["ostadem",1246,112],["ajem",1246,104],["cajem",1253,26],["lajem",1253,30],["rajem",1253,31],["astajem",1253,106],["istajem",1253,107],["ostajem",1253,108],["ćajem",1253,28],["čajem",1253,27],["đajem",1253,29],["ijem",1246,116],["anjijem",1263,84],["enjijem",1263,85],["snjijem",1263,123],["šnjijem",1263,86],["kijem",1263,95],["skijem",1268,1],["škijem",1268,2],["lijem",1263,24],["elijem",1271,83],["nijem",1263,13],["rarijem",1263,21],["sijem",1263,23],["osijem",1275,123],["atijem",1263,120],["evitijem",1263,92],["ovitijem",1263,93],["otijem",1263,22],["astijem",1263,94],["avijem",1263,77],["evijem",1263,78],["ivijem",1263,79],["ovijem",1263,80],["ošijem",1263,91],["anjem",1246,84],["enjem",1246,85],["injem",1246,114],["snjem",1246,122],["šnjem",1246,86],["ujem",1246,25],["lucujem",1292,121],["irujem",1292,100],["lučujem",1292,117],["kem",1246,95],["skem",1296,1],["škem",1296,2],["elem",1246,83],["nem",1246,13],["anem",1300,10],["astanem",1301,110],["istanem",1301,111],["ostanem",1301,112],["enem",1300,87],["snem",1300,159],["šnem",1300,88],["basem",1246,135],["gasem",1246,131],["jasem",1246,129],["kasem",1246,133],["nasem",1246,132],["tasem",1246,130],["vasem",1246,134],["esem",1246,152],["isem",1246,154],["osem",1246,123],["atem",1246,120],["etem",1246,70],["evitem",1246,92],["ovitem",1246,93],["astem",1246,94],["istem",1246,151],["ištem",1246,75],["avem",1246,77],["evem",1246,78],["ivem",1246,79],["aćem",1246,14],["ećem",1246,15],["ućem",1246,16],["bašem",1246,63],["gašem",1246,64],["jašem",1246,61],["kašem",1246,62],["našem",1246,60],["tašem",1246,59],["vašem",1246,65],["ešem",1246,66],["išem",1246,67],["ošem",1246,91],["im",-1,116],["acim",1341,124],["ecim",1341,125],["ucim",1341,126],["lucim",1344,121],["anjijim",1341,84],["enjijim",1341,85],["snjijim",1341,122],["šnjijim",1341,86],["kijim",1341,95],["skijim",1350,1],["škijim",1350,2],["elijim",1341,83],["nijim",1341,13],["osijim",1341,123],["atijim",1341,120],["evitijim",1341,92],["ovitijim",1341,93],["astijim",1341,94],["avijim",1341,77],["evijim",1341,78],["ivijim",1341,79],["ovijim",1341,80],["ošijim",1341,91],["anjim",1341,84],["enjim",1341,85],["snjim",1341,122],["šnjim",1341,86],["kim",1341,95],["skim",1369,1],["škim",1369,2],["elim",1341,83],["nim",1341,13],["cinim",1373,137],["činim",1373,89],["osim",1341,123],["rosim",1376,127],["atim",1341,120],["jetim",1341,118],["evitim",1341,92],["ovitim",1341,93],["astim",1341,94],["avim",1341,77],["evim",1341,78],["ivim",1341,79],["ovim",1341,80],["aćim",1341,14],["ećim",1341,15],["ućim",1341,16],["ačim",1341,101],["lučim",1341,117],["ošim",1341,91],["rošim",1392,90],["acom",-1,124],["ecom",-1,125],["ucom",-1,126],["gom",-1,20],["logom",1397,19],["ugom",1397,18],["bijom",-1,32],["cijom",-1,33],["dijom",-1,34],["fijom",-1,40],["gijom",-1,39],["lijom",-1,35],["mijom",-1,37],["nijom",-1,36],["ganijom",1407,9],["manijom",1407,6],["panijom",1407,7],["ranijom",1407,8],["tanijom",1407,5],["pijom",-1,41],["rijom",-1,42],["sijom",-1,43],["tijom",-1,44],["zijom",-1,45],["žijom",-1,38],["anjom",-1,84],["enjom",-1,85],["snjom",-1,122],["šnjom",-1,86],["kom",-1,95],["skom",1423,1],["škom",1423,2],["alom",-1,104],["ijalom",1426,47],["nalom",1426,46],["elom",-1,83],["ilom",-1,116],["ozilom",1430,48],["olom",-1,50],["ramom",-1,52],["lemom",-1,51],["nom",-1,13],["anom",1435,10],["inom",1435,11],["cinom",1437,137],["aninom",1437,10],["činom",1437,89],["onom",1435,12],["arom",-1,53],["drom",-1,54],["erom",-1,55],["orom",-1,56],["basom",-1,135],["gasom",-1,131],["jasom",-1,129],["kasom",-1,133],["nasom",-1,132],["tasom",-1,130],["vasom",-1,134],["esom",-1,57],["isom",-1,58],["osom",-1,123],["atom",-1,120],["ikatom",1456,68],["latom",1456,69],["etom",-1,70],["evitom",-1,92],["ovitom",-1,93],["astom",-1,94],["estom",-1,71],["istom",-1,72],["kstom",-1,73],["ostom",-1,74],["avom",-1,77],["evom",-1,78],["ivom",-1,79],["ovom",-1,80],["lovom",1470,82],["movom",1470,81],["stvom",-1,3],["štvom",-1,4],["aćom",-1,14],["ećom",-1,15],["ućom",-1,16],["bašom",-1,63],["gašom",-1,64],["jašom",-1,61],["kašom",-1,62],["našom",-1,60],["tašom",-1,59],["vašom",-1,65],["ešom",-1,66],["išom",-1,67],["ošom",-1,91],["an",-1,104],["acan",1488,128],["iran",1488,100],["uran",1488,105],["tan",1488,113],["avan",1488,97],["evan",1488,96],["ivan",1488,98],["uvan",1488,99],["ačan",1488,102],["acen",-1,124],["lucen",-1,121],["ačen",-1,101],["lučen",-1,117],["anin",-1,10],["ao",-1,104],["acao",1503,128],["astajao",1503,106],["istajao",1503,107],["ostajao",1503,108],["injao",1503,114],["irao",1503,100],["urao",1503,105],["tao",1503,113],["astao",1511,110],["istao",1511,111],["ostao",1511,112],["avao",1503,97],["evao",1503,96],["ivao",1503,98],["ovao",1503,76],["uvao",1503,99],["ačao",1503,102],["go",-1,20],["ugo",1521,18],["io",-1,116],["acio",1523,124],["lucio",1523,121],["lio",1523,24],["nio",1523,103],["rario",1523,21],["sio",1523,23],["rosio",1529,127],["jetio",1523,118],["otio",1523,22],["ačio",1523,101],["lučio",1523,117],["rošio",1523,90],["bijo",-1,32],["cijo",-1,33],["dijo",-1,34],["fijo",-1,40],["gijo",-1,39],["lijo",-1,35],["mijo",-1,37],["nijo",-1,36],["pijo",-1,41],["rijo",-1,42],["sijo",-1,43],["tijo",-1,44],["zijo",-1,45],["žijo",-1,38],["anjo",-1,84],["enjo",-1,85],["snjo",-1,122],["šnjo",-1,86],["ko",-1,95],["sko",1554,1],["ško",1554,2],["alo",-1,104],["acalo",1557,128],["astajalo",1557,106],["istajalo",1557,107],["ostajalo",1557,108],["ijalo",1557,47],["injalo",1557,114],["nalo",1557,46],["iralo",1557,100],["uralo",1557,105],["talo",1557,113],["astalo",1567,110],["istalo",1567,111],["ostalo",1567,112],["avalo",1557,97],["evalo",1557,96],["ivalo",1557,98],["ovalo",1557,76],["uvalo",1557,99],["ačalo",1557,102],["elo",-1,83],["ilo",-1,116],["acilo",1578,124],["lucilo",1578,121],["nilo",1578,103],["rosilo",1578,127],["jetilo",1578,118],["ačilo",1578,101],["lučilo",1578,117],["rošilo",1578,90],["aslo",-1,115],["nulo",-1,13],["amo",-1,104],["acamo",1589,128],["ramo",1589,52],["iramo",1591,100],["uramo",1591,105],["tamo",1589,113],["avamo",1589,97],["evamo",1589,96],["ivamo",1589,98],["uvamo",1589,99],["ačamo",1589,102],["emo",-1,119],["astademo",1600,110],["istademo",1600,111],["ostademo",1600,112],["astajemo",1600,106],["istajemo",1600,107],["ostajemo",1600,108],["ijemo",1600,116],["injemo",1600,114],["ujemo",1600,25],["lucujemo",1609,121],["irujemo",1609,100],["lučujemo",1609,117],["lemo",1600,51],["nemo",1600,13],["astanemo",1614,110],["istanemo",1614,111],["ostanemo",1614,112],["etemo",1600,70],["astemo",1600,115],["imo",-1,116],["acimo",1620,124],["lucimo",1620,121],["nimo",1620,13],["astanimo",1623,110],["istanimo",1623,111],["ostanimo",1623,112],["rosimo",1620,127],["etimo",1620,70],["jetimo",1628,118],["astimo",1620,115],["ačimo",1620,101],["lučimo",1620,117],["rošimo",1620,90],["ajmo",-1,104],["urajmo",1634,105],["tajmo",1634,113],["astajmo",1636,106],["istajmo",1636,107],["ostajmo",1636,108],["avajmo",1634,97],["evajmo",1634,96],["ivajmo",1634,98],["uvajmo",1634,99],["ijmo",-1,116],["ujmo",-1,25],["lucujmo",1645,121],["irujmo",1645,100],["lučujmo",1645,117],["asmo",-1,104],["acasmo",1649,128],["astajasmo",1649,106],["istajasmo",1649,107],["ostajasmo",1649,108],["injasmo",1649,114],["irasmo",1649,100],["urasmo",1649,105],["tasmo",1649,113],["avasmo",1649,97],["evasmo",1649,96],["ivasmo",1649,98],["ovasmo",1649,76],["uvasmo",1649,99],["ačasmo",1649,102],["ismo",-1,116],["acismo",1664,124],["lucismo",1664,121],["nismo",1664,103],["rosismo",1664,127],["jetismo",1664,118],["ačismo",1664,101],["lučismo",1664,117],["rošismo",1664,90],["astadosmo",-1,110],["istadosmo",-1,111],["ostadosmo",-1,112],["nusmo",-1,13],["no",-1,13],["ano",1677,104],["acano",1678,128],["urano",1678,105],["tano",1678,113],["avano",1678,97],["evano",1678,96],["ivano",1678,98],["uvano",1678,99],["ačano",1678,102],["aceno",1677,124],["luceno",1677,121],["ačeno",1677,101],["lučeno",1677,117],["ino",1677,11],["cino",1691,137],["čino",1691,89],["ato",-1,120],["ikato",1694,68],["lato",1694,69],["eto",-1,70],["evito",-1,92],["ovito",-1,93],["asto",-1,94],["esto",-1,71],["isto",-1,72],["ksto",-1,73],["osto",-1,74],["nuto",-1,13],["nuo",-1,13],["avo",-1,77],["evo",-1,78],["ivo",-1,79],["ovo",-1,80],["stvo",-1,3],["štvo",-1,4],["as",-1,161],["acas",1713,128],["iras",1713,155],["uras",1713,156],["tas",1713,160],["avas",1713,144],["evas",1713,145],["ivas",1713,146],["uvas",1713,147],["es",-1,163],["astades",1722,141],["istades",1722,142],["ostades",1722,143],["astajes",1722,138],["istajes",1722,139],["ostajes",1722,140],["ijes",1722,162],["injes",1722,150],["ujes",1722,157],["lucujes",1731,121],["irujes",1731,155],["nes",1722,164],["astanes",1734,141],["istanes",1734,142],["ostanes",1734,143],["etes",1722,153],["astes",1722,136],["is",-1,162],["acis",1740,124],["lucis",1740,121],["nis",1740,158],["rosis",1740,127],["jetis",1740,149],["at",-1,104],["acat",1746,128],["astajat",1746,106],["istajat",1746,107],["ostajat",1746,108],["injat",1746,114],["irat",1746,100],["urat",1746,105],["tat",1746,113],["astat",1754,110],["istat",1754,111],["ostat",1754,112],["avat",1746,97],["evat",1746,96],["ivat",1746,98],["irivat",1760,100],["ovat",1746,76],["uvat",1746,99],["ačat",1746,102],["it",-1,116],["acit",1765,124],["lucit",1765,121],["rosit",1765,127],["jetit",1765,118],["ačit",1765,101],["lučit",1765,117],["rošit",1765,90],["nut",-1,13],["astadu",-1,110],["istadu",-1,111],["ostadu",-1,112],["gu",-1,20],["logu",1777,19],["ugu",1777,18],["ahu",-1,104],["acahu",1780,128],["astajahu",1780,106],["istajahu",1780,107],["ostajahu",1780,108],["injahu",1780,114],["irahu",1780,100],["urahu",1780,105],["avahu",1780,97],["evahu",1780,96],["ivahu",1780,98],["ovahu",1780,76],["uvahu",1780,99],["ačahu",1780,102],["aju",-1,104],["caju",1794,26],["acaju",1795,128],["laju",1794,30],["raju",1794,31],["iraju",1798,100],["uraju",1798,105],["taju",1794,113],["astaju",1801,106],["istaju",1801,107],["ostaju",1801,108],["avaju",1794,97],["evaju",1794,96],["ivaju",1794,98],["uvaju",1794,99],["ćaju",1794,28],["čaju",1794,27],["ačaju",1810,102],["đaju",1794,29],["iju",-1,116],["biju",1813,32],["ciju",1813,33],["diju",1813,34],["fiju",1813,40],["giju",1813,39],["anjiju",1813,84],["enjiju",1813,85],["snjiju",1813,122],["šnjiju",1813,86],["kiju",1813,95],["liju",1813,24],["eliju",1824,83],["miju",1813,37],["niju",1813,13],["ganiju",1827,9],["maniju",1827,6],["paniju",1827,7],["raniju",1827,8],["taniju",1827,5],["piju",1813,41],["riju",1813,42],["rariju",1834,21],["siju",1813,23],["osiju",1836,123],["tiju",1813,44],["atiju",1838,120],["otiju",1838,22],["aviju",1813,77],["eviju",1813,78],["iviju",1813,79],["oviju",1813,80],["ziju",1813,45],["ošiju",1813,91],["žiju",1813,38],["anju",-1,84],["enju",-1,85],["snju",-1,122],["šnju",-1,86],["uju",-1,25],["lucuju",1852,121],["iruju",1852,100],["lučuju",1852,117],["ku",-1,95],["sku",1856,1],["šku",1856,2],["alu",-1,104],["ijalu",1859,47],["nalu",1859,46],["elu",-1,83],["ilu",-1,116],["ozilu",1863,48],["olu",-1,50],["ramu",-1,52],["acemu",-1,124],["ecemu",-1,125],["ucemu",-1,126],["anjijemu",-1,84],["enjijemu",-1,85],["snjijemu",-1,122],["šnjijemu",-1,86],["kijemu",-1,95],["skijemu",1874,1],["škijemu",1874,2],["elijemu",-1,83],["nijemu",-1,13],["osijemu",-1,123],["atijemu",-1,120],["evitijemu",-1,92],["ovitijemu",-1,93],["astijemu",-1,94],["avijemu",-1,77],["evijemu",-1,78],["ivijemu",-1,79],["ovijemu",-1,80],["ošijemu",-1,91],["anjemu",-1,84],["enjemu",-1,85],["snjemu",-1,122],["šnjemu",-1,86],["kemu",-1,95],["skemu",1893,1],["škemu",1893,2],["lemu",-1,51],["elemu",1896,83],["nemu",-1,13],["anemu",1898,10],["enemu",1898,87],["snemu",1898,159],["šnemu",1898,88],["osemu",-1,123],["atemu",-1,120],["evitemu",-1,92],["ovitemu",-1,93],["astemu",-1,94],["avemu",-1,77],["evemu",-1,78],["ivemu",-1,79],["ovemu",-1,80],["aćemu",-1,14],["ećemu",-1,15],["ućemu",-1,16],["ošemu",-1,91],["acomu",-1,124],["ecomu",-1,125],["ucomu",-1,126],["anjomu",-1,84],["enjomu",-1,85],["snjomu",-1,122],["šnjomu",-1,86],["komu",-1,95],["skomu",1923,1],["škomu",1923,2],["elomu",-1,83],["nomu",-1,13],["cinomu",1927,137],["činomu",1927,89],["osomu",-1,123],["atomu",-1,120],["evitomu",-1,92],["ovitomu",-1,93],["astomu",-1,94],["avomu",-1,77],["evomu",-1,78],["ivomu",-1,79],["ovomu",-1,80],["aćomu",-1,14],["ećomu",-1,15],["ućomu",-1,16],["ošomu",-1,91],["nu",-1,13],["anu",1943,10],["astanu",1944,110],["istanu",1944,111],["ostanu",1944,112],["inu",1943,11],["cinu",1948,137],["aninu",1948,10],["činu",1948,89],["onu",1943,12],["aru",-1,53],["dru",-1,54],["eru",-1,55],["oru",-1,56],["basu",-1,135],["gasu",-1,131],["jasu",-1,129],["kasu",-1,133],["nasu",-1,132],["tasu",-1,130],["vasu",-1,134],["esu",-1,57],["isu",-1,58],["osu",-1,123],["atu",-1,120],["ikatu",1967,68],["latu",1967,69],["etu",-1,70],["evitu",-1,92],["ovitu",-1,93],["astu",-1,94],["estu",-1,71],["istu",-1,72],["kstu",-1,73],["ostu",-1,74],["ištu",-1,75],["avu",-1,77],["evu",-1,78],["ivu",-1,79],["ovu",-1,80],["lovu",1982,82],["movu",1982,81],["stvu",-1,3],["štvu",-1,4],["bašu",-1,63],["gašu",-1,64],["jašu",-1,61],["kašu",-1,62],["našu",-1,60],["tašu",-1,59],["vašu",-1,65],["ešu",-1,66],["išu",-1,67],["ošu",-1,91],["avav",-1,97],["evav",-1,96],["ivav",-1,98],["uvav",-1,99],["kov",-1,95],["aš",-1,104],["iraš",2002,100],["uraš",2002,105],["taš",2002,113],["avaš",2002,97],["evaš",2002,96],["ivaš",2002,98],["uvaš",2002,99],["ačaš",2002,102],["eš",-1,119],["astadeš",2011,110],["istadeš",2011,111],["ostadeš",2011,112],["astaješ",2011,106],["istaješ",2011,107],["ostaješ",2011,108],["iješ",2011,116],["inješ",2011,114],["uješ",2011,25],["iruješ",2020,100],["lučuješ",2020,117],["neš",2011,13],["astaneš",2023,110],["istaneš",2023,111],["ostaneš",2023,112],["eteš",2011,70],["asteš",2011,115],["iš",-1,116],["niš",2029,103],["jetiš",2029,118],["ačiš",2029,101],["lučiš",2029,117],["rošiš",2029,90]],t=[["a",-1,1],["oga",0,1],["ama",0,1],["ima",0,1],["ena",0,1],["e",-1,1],["og",-1,1],["anog",6,1],["enog",6,1],["anih",-1,1],["enih",-1,1],["i",-1,1],["ani",11,1],["eni",11,1],["anoj",-1,1],["enoj",-1,1],["anim",-1,1],["enim",-1,1],["om",-1,1],["enom",18,1],["o",-1,1],["ano",20,1],["eno",20,1],["ost",-1,1],["u",-1,1],["enu",24,1]],u=[17,65,16],n=[65,4,0,0,0,0,0,0,0,0,0,4,0,0,128],j=[119,95,23,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,32,136,0,0,0,0,0,0,0,0,0,128,0,0,0,16],c=[1],f=0,l=!1;function v(){return f<=m.cursor}this.stem=function(){(()=>{for(var a,e=m.cursor;;){var i=m.cursor;a:{for(;;){var r=m.cursor;if(m.bra=m.cursor,0!=(a=m.find_among(s))){switch(m.ket=m.cursor,a){case 1:if(m.slice_from("a"))break;return;case 2:if(m.slice_from("b"))break;return;case 3:if(m.slice_from("v"))break;return;case 4:if(m.slice_from("g"))break;return;case 5:if(m.slice_from("d"))break;return;case 6:if(m.slice_from("đ"))break;return;case 7:if(m.slice_from("e"))break;return;case 8:if(m.slice_from("ž"))break;return;case 9:if(m.slice_from("z"))break;return;case 10:if(m.slice_from("i"))break;return;case 11:if(m.slice_from("j"))break;return;case 12:if(m.slice_from("k"))break;return;case 13:if(m.slice_from("l"))break;return;case 14:if(m.slice_from("lj"))break;return;case 15:if(m.slice_from("m"))break;return;case 16:if(m.slice_from("n"))break;return;case 17:if(m.slice_from("nj"))break;return;case 18:if(m.slice_from("o"))break;return;case 19:if(m.slice_from("p"))break;return;case 20:if(m.slice_from("r"))break;return;case 21:if(m.slice_from("s"))break;return;case 22:if(m.slice_from("t"))break;return;case 23:if(m.slice_from("ć"))break;return;case 24:if(m.slice_from("u"))break;return;case 25:if(m.slice_from("f"))break;return;case 26:if(m.slice_from("h"))break;return;case 27:if(m.slice_from("c"))break;return;case 28:if(m.slice_from("č"))break;return;case 29:if(m.slice_from("dž"))break;return;case 30:if(m.slice_from("š"))break;return}m.cursor=r;break}if(m.cursor=r,m.cursor>=m.limit)break a;m.cursor++}continue}m.cursor=i;break}m.cursor=e})(),(()=>{for(var a=m.cursor;;){var e=m.cursor;a:{for(;;){var i=m.cursor;if(m.in_grouping(j,98,382)&&(m.bra=m.cursor,m.eq_s("ije"))&&(m.ket=m.cursor,m.in_grouping(j,98,382))){if(!m.slice_from("e"))return;m.cursor=i;break}if(m.cursor=i,m.cursor>=m.limit)break a;m.cursor++}continue}m.cursor=e;break}for(m.cursor=a,a=m.cursor;;){var r=m.cursor;a:{for(;;){var s=m.cursor;if(m.in_grouping(j,98,382)&&(m.bra=m.cursor,m.eq_s("je"))&&(m.ket=m.cursor,m.in_grouping(j,98,382))){if(!m.slice_from("e"))return;m.cursor=s;break}if(m.cursor=s,m.cursor>=m.limit)break a;m.cursor++}continue}m.cursor=r;break}for(m.cursor=a,a=m.cursor;;){var o=m.cursor;a:{for(;;){var t=m.cursor;if(m.bra=m.cursor,m.eq_s("dj")){if(m.ket=m.cursor,!m.slice_from("đ"))return;m.cursor=t;break}if(m.cursor=t,m.cursor>=m.limit)break a;m.cursor++}continue}m.cursor=o;break}m.cursor=a})(),l=!0;var a=m.cursor,a=(m.go_out_grouping(n,263,382)&&(m.cursor++,l=!1),m.cursor=a,f=m.limit,m.cursor),a=(m.go_out_grouping(u,97,117)&&(m.cursor++,2<=(f=m.cursor)||m.go_in_grouping(u,97,117)&&(m.cursor++,f=m.cursor)),m.cursor=a,m.cursor);a:{for(;;){if(m.eq_s("r"))break;if(m.cursor>=m.limit)break a;m.cursor++}var e=m.cursor;if(m.cursor<2){if(m.cursor=e,!m.go_in_grouping(c,114,114))break a;m.cursor++}f-m.cursor<=1||(f=m.cursor)}m.cursor=a,m.limit_backward=m.cursor,m.cursor=m.limit;var a=m.limit-m.cursor,a=((()=>{var a;if(m.ket=m.cursor,0!=(a=m.find_among_b(r)))switch(m.bra=m.cursor,a){case 1:if(m.slice_from("loga"))break;return;case 2:if(m.slice_from("peh"))break;return;case 3:if(m.slice_from("vojka"))break;return;case 4:if(m.slice_from("bojka"))break;return;case 5:if(m.slice_from("jak"))break;return;case 6:if(m.slice_from("čajni"))break;return;case 7:if(!l)return;if(m.slice_from("cajni"))break;return;case 8:if(m.slice_from("erni"))break;return;case 9:if(m.slice_from("larni"))break;return;case 10:if(m.slice_from("esni"))break;return;case 11:if(m.slice_from("anjca"))break;return;case 12:if(m.slice_from("ajca"))break;return;case 13:if(m.slice_from("ljca"))break;return;case 14:if(m.slice_from("ejca"))break;return;case 15:if(m.slice_from("ojca"))break;return;case 16:if(m.slice_from("ajka"))break;return;case 17:if(m.slice_from("ojka"))break;return;case 18:if(m.slice_from("šca"))break;return;case 19:if(m.slice_from("ing"))break;return;case 20:if(m.slice_from("tvenik"))break;return;case 21:if(m.slice_from("tetika"))break;return;case 22:if(m.slice_from("nstva"))break;return;case 23:if(m.slice_from("nik"))break;return;case 24:if(m.slice_from("tik"))break;return;case 25:if(m.slice_from("zik"))break;return;case 26:if(m.slice_from("snik"))break;return;case 27:if(m.slice_from("kusi"))break;return;case 28:if(m.slice_from("kusni"))break;return;case 29:if(m.slice_from("kustva"))break;return;case 30:if(m.slice_from("dušni"))break;return;case 31:if(!l)return;if(m.slice_from("dusni"))break;return;case 32:if(m.slice_from("antni"))break;return;case 33:if(m.slice_from("bilni"))break;return;case 34:if(m.slice_from("tilni"))break;return;case 35:if(m.slice_from("avilni"))break;return;case 36:if(m.slice_from("silni"))break;return;case 37:if(m.slice_from("gilni"))break;return;case 38:if(m.slice_from("rilni"))break;return;case 39:if(m.slice_from("nilni"))break;return;case 40:if(m.slice_from("alni"))break;return;case 41:if(m.slice_from("ozni"))break;return;case 42:if(m.slice_from("ravi"))break;return;case 43:if(m.slice_from("stavni"))break;return;case 44:if(m.slice_from("pravni"))break;return;case 45:if(m.slice_from("tivni"))break;return;case 46:if(m.slice_from("sivni"))break;return;case 47:if(m.slice_from("atni"))break;return;case 48:if(m.slice_from("enta"))break;return;case 49:if(m.slice_from("tetni"))break;return;case 50:if(m.slice_from("pletni"))break;return;case 51:if(m.slice_from("šavi"))break;return;case 52:if(!l)return;if(m.slice_from("savi"))break;return;case 53:if(m.slice_from("anta"))break;return;case 54:if(m.slice_from("ačka"))break;return;case 55:if(!l)return;if(m.slice_from("acka"))break;return;case 56:if(m.slice_from("uška"))break;return;case 57:if(!l)return;if(m.slice_from("uska"))break;return;case 58:if(m.slice_from("atka"))break;return;case 59:if(m.slice_from("etka"))break;return;case 60:if(m.slice_from("itka"))break;return;case 61:if(m.slice_from("otka"))break;return;case 62:if(m.slice_from("utka"))break;return;case 63:if(m.slice_from("eskna"))break;return;case 64:if(m.slice_from("tični"))break;return;case 65:if(!l)return;if(m.slice_from("ticni"))break;return;case 66:if(m.slice_from("ojska"))break;return;case 67:if(m.slice_from("esma"))break;return;case 68:if(m.slice_from("metra"))break;return;case 69:if(m.slice_from("centra"))break;return;case 70:if(m.slice_from("istra"))break;return;case 71:if(m.slice_from("osti"))break;return;case 72:if(!l)return;if(m.slice_from("osti"))break;return;case 73:if(m.slice_from("dba"))break;return;case 74:if(m.slice_from("čka"))break;return;case 75:if(m.slice_from("mca"))break;return;case 76:if(m.slice_from("nca"))break;return;case 77:if(m.slice_from("voljni"))break;return;case 78:if(m.slice_from("anki"))break;return;case 79:if(m.slice_from("vca"))break;return;case 80:if(m.slice_from("sca"))break;return;case 81:if(m.slice_from("rca"))break;return;case 82:if(m.slice_from("alca"))break;return;case 83:if(m.slice_from("elca"))break;return;case 84:if(m.slice_from("olca"))break;return;case 85:if(m.slice_from("njca"))break;return;case 86:if(m.slice_from("ekta"))break;return;case 87:if(m.slice_from("izma"))break;return;case 88:if(m.slice_from("jebi"))break;return;case 89:if(m.slice_from("baci"))break;return;case 90:if(m.slice_from("ašni"))break;return;case 91:if(!l)return;if(m.slice_from("asni"))break}})(),m.cursor=m.limit-a,m.limit-m.cursor),i=m.limit-m.cursor;return(()=>{var a;if(m.ket=m.cursor,0!=(a=m.find_among_b(o))&&(m.bra=m.cursor,v())){switch(a){case 1:if(m.slice_from("sk"))break;return;case 2:if(m.slice_from("šk"))break;return;case 3:if(m.slice_from("stv"))break;return;case 4:if(m.slice_from("štv"))break;return;case 5:if(m.slice_from("tanij"))break;return;case 6:if(m.slice_from("manij"))break;return;case 7:if(m.slice_from("panij"))break;return;case 8:if(m.slice_from("ranij"))break;return;case 9:if(m.slice_from("ganij"))break;return;case 10:if(m.slice_from("an"))break;return;case 11:if(m.slice_from("in"))break;return;case 12:if(m.slice_from("on"))break;return;case 13:if(m.slice_from("n"))break;return;case 14:if(m.slice_from("ać"))break;return;case 15:if(m.slice_from("eć"))break;return;case 16:if(m.slice_from("uć"))break;return;case 17:if(m.slice_from("ugov"))break;return;case 18:if(m.slice_from("ug"))break;return;case 19:if(m.slice_from("log"))break;return;case 20:if(m.slice_from("g"))break;return;case 21:if(m.slice_from("rari"))break;return;case 22:if(m.slice_from("oti"))break;return;case 23:if(m.slice_from("si"))break;return;case 24:if(m.slice_from("li"))break;return;case 25:if(m.slice_from("uj"))break;return;case 26:if(m.slice_from("caj"))break;return;case 27:if(m.slice_from("čaj"))break;return;case 28:if(m.slice_from("ćaj"))break;return;case 29:if(m.slice_from("đaj"))break;return;case 30:if(m.slice_from("laj"))break;return;case 31:if(m.slice_from("raj"))break;return;case 32:if(m.slice_from("bij"))break;return;case 33:if(m.slice_from("cij"))break;return;case 34:if(m.slice_from("dij"))break;return;case 35:if(m.slice_from("lij"))break;return;case 36:if(m.slice_from("nij"))break;return;case 37:if(m.slice_from("mij"))break;return;case 38:if(m.slice_from("žij"))break;return;case 39:if(m.slice_from("gij"))break;return;case 40:if(m.slice_from("fij"))break;return;case 41:if(m.slice_from("pij"))break;return;case 42:if(m.slice_from("rij"))break;return;case 43:if(m.slice_from("sij"))break;return;case 44:if(m.slice_from("tij"))break;return;case 45:if(m.slice_from("zij"))break;return;case 46:if(m.slice_from("nal"))break;return;case 47:if(m.slice_from("ijal"))break;return;case 48:if(m.slice_from("ozil"))break;return;case 49:if(m.slice_from("olov"))break;return;case 50:if(m.slice_from("ol"))break;return;case 51:if(m.slice_from("lem"))break;return;case 52:if(m.slice_from("ram"))break;return;case 53:if(m.slice_from("ar"))break;return;case 54:if(m.slice_from("dr"))break;return;case 55:if(m.slice_from("er"))break;return;case 56:if(m.slice_from("or"))break;return;case 57:if(m.slice_from("es"))break;return;case 58:if(m.slice_from("is"))break;return;case 59:if(m.slice_from("taš"))break;return;case 60:if(m.slice_from("naš"))break;return;case 61:if(m.slice_from("jaš"))break;return;case 62:if(m.slice_from("kaš"))break;return;case 63:if(m.slice_from("baš"))break;return;case 64:if(m.slice_from("gaš"))break;return;case 65:if(m.slice_from("vaš"))break;return;case 66:if(m.slice_from("eš"))break;return;case 67:if(m.slice_from("iš"))break;return;case 68:if(m.slice_from("ikat"))break;return;case 69:if(m.slice_from("lat"))break;return;case 70:if(m.slice_from("et"))break;return;case 71:if(m.slice_from("est"))break;return;case 72:if(m.slice_from("ist"))break;return;case 73:if(m.slice_from("kst"))break;return;case 74:if(m.slice_from("ost"))break;return;case 75:if(m.slice_from("išt"))break;return;case 76:if(m.slice_from("ova"))break;return;case 77:if(m.slice_from("av"))break;return;case 78:if(m.slice_from("ev"))break;return;case 79:if(m.slice_from("iv"))break;return;case 80:if(m.slice_from("ov"))break;return;case 81:if(m.slice_from("mov"))break;return;case 82:if(m.slice_from("lov"))break;return;case 83:if(m.slice_from("el"))break;return;case 84:if(m.slice_from("anj"))break;return;case 85:if(m.slice_from("enj"))break;return;case 86:if(m.slice_from("šnj"))break;return;case 87:if(m.slice_from("en"))break;return;case 88:if(m.slice_from("šn"))break;return;case 89:if(m.slice_from("čin"))break;return;case 90:if(m.slice_from("roši"))break;return;case 91:if(m.slice_from("oš"))break;return;case 92:if(m.slice_from("evit"))break;return;case 93:if(m.slice_from("ovit"))break;return;case 94:if(m.slice_from("ast"))break;return;case 95:if(m.slice_from("k"))break;return;case 96:if(m.slice_from("eva"))break;return;case 97:if(m.slice_from("ava"))break;return;case 98:if(m.slice_from("iva"))break;return;case 99:if(m.slice_from("uva"))break;return;case 100:if(m.slice_from("ir"))break;return;case 101:if(m.slice_from("ač"))break;return;case 102:if(m.slice_from("ača"))break;return;case 103:if(m.slice_from("ni"))break;return;case 104:if(m.slice_from("a"))break;return;case 105:if(m.slice_from("ur"))break;return;case 106:if(m.slice_from("astaj"))break;return;case 107:if(m.slice_from("istaj"))break;return;case 108:if(m.slice_from("ostaj"))break;return;case 109:if(m.slice_from("aj"))break;return;case 110:if(m.slice_from("asta"))break;return;case 111:if(m.slice_from("ista"))break;return;case 112:if(m.slice_from("osta"))break;return;case 113:if(m.slice_from("ta"))break;return;case 114:if(m.slice_from("inj"))break;return;case 115:if(m.slice_from("as"))break;return;case 116:if(m.slice_from("i"))break;return;case 117:if(m.slice_from("luč"))break;return;case 118:if(m.slice_from("jeti"))break;return;case 119:if(m.slice_from("e"))break;return;case 120:if(m.slice_from("at"))break;return;case 121:if(!l)return;if(m.slice_from("luc"))break;return;case 122:if(!l)return;if(m.slice_from("snj"))break;return;case 123:if(!l)return;if(m.slice_from("os"))break;return;case 124:if(!l)return;if(m.slice_from("ac"))break;return;case 125:if(!l)return;if(m.slice_from("ec"))break;return;case 126:if(!l)return;if(m.slice_from("uc"))break;return;case 127:if(!l)return;if(m.slice_from("rosi"))break;return;case 128:if(!l)return;if(m.slice_from("aca"))break;return;case 129:if(!l)return;if(m.slice_from("jas"))break;return;case 130:if(!l)return;if(m.slice_from("tas"))break;return;case 131:if(!l)return;if(m.slice_from("gas"))break;return;case 132:if(!l)return;if(m.slice_from("nas"))break;return;case 133:if(!l)return;if(m.slice_from("kas"))break;return;case 134:if(!l)return;if(m.slice_from("vas"))break;return;case 135:if(!l)return;if(m.slice_from("bas"))break;return;case 136:if(!l)return;if(m.slice_from("as"))break;return;case 137:if(!l)return;if(m.slice_from("cin"))break;return;case 138:if(!l)return;if(m.slice_from("astaj"))break;return;case 139:if(!l)return;if(m.slice_from("istaj"))break;return;case 140:if(!l)return;if(m.slice_from("ostaj"))break;return;case 141:if(!l)return;if(m.slice_from("asta"))break;return;case 142:if(!l)return;if(m.slice_from("ista"))break;return;case 143:if(!l)return;if(m.slice_from("osta"))break;return;case 144:if(!l)return;if(m.slice_from("ava"))break;return;case 145:if(!l)return;if(m.slice_from("eva"))break;return;case 146:if(!l)return;if(m.slice_from("iva"))break;return;case 147:if(!l)return;if(m.slice_from("uva"))break;return;case 148:if(!l)return;if(m.slice_from("ova"))break;return;case 149:if(!l)return;if(m.slice_from("jeti"))break;return;case 150:if(!l)return;if(m.slice_from("inj"))break;return;case 151:if(!l)return;if(m.slice_from("ist"))break;return;case 152:if(!l)return;if(m.slice_from("es"))break;return;case 153:if(!l)return;if(m.slice_from("et"))break;return;case 154:if(!l)return;if(m.slice_from("is"))break;return;case 155:if(!l)return;if(m.slice_from("ir"))break;return;case 156:if(!l)return;if(m.slice_from("ur"))break;return;case 157:if(!l)return;if(m.slice_from("uj"))break;return;case 158:if(!l)return;if(m.slice_from("ni"))break;return;case 159:if(!l)return;if(m.slice_from("sn"))break;return;case 160:if(!l)return;if(m.slice_from("ta"))break;return;case 161:if(!l)return;if(m.slice_from("a"))break;return;case 162:if(!l)return;if(m.slice_from("i"))break;return;case 163:if(!l)return;if(m.slice_from("e"))break;return;case 164:if(!l)return;if(m.slice_from("n"))break;return}return 1}})()||(m.cursor=m.limit-i,m.ket=m.cursor,0!=m.find_among_b(t)&&(m.bra=m.cursor,v())&&m.slice_from("")),m.cursor=m.limit-a,m.cursor=m.limit_backward,!0},this.stemWord=function(a){return m.setCurrent(a),this.stem(),m.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/spanish-stemmer.js b/sphinx/search/minified-js/spanish-stemmer.js index ef634a8b75c..c47ed2e414a 100644 --- a/sphinx/search/minified-js/spanish-stemmer.js +++ b/sphinx/search/minified-js/spanish-stemmer.js @@ -1 +1 @@ -SpanishStemmer=function(){var r=new BaseStemmer;var e=[["",-1,6],["á",0,1],["é",0,2],["í",0,3],["ó",0,4],["ú",0,5]];var i=[["la",-1,-1],["sela",0,-1],["le",-1,-1],["me",-1,-1],["se",-1,-1],["lo",-1,-1],["selo",5,-1],["las",-1,-1],["selas",7,-1],["les",-1,-1],["los",-1,-1],["selos",10,-1],["nos",-1,-1]];var a=[["ando",-1,6],["iendo",-1,6],["yendo",-1,7],["ándo",-1,2],["iéndo",-1,1],["ar",-1,6],["er",-1,6],["ir",-1,6],["ár",-1,3],["ér",-1,4],["ír",-1,5]];var s=[["ic",-1,-1],["ad",-1,-1],["os",-1,-1],["iv",-1,1]];var u=[["able",-1,1],["ible",-1,1],["ante",-1,1]];var o=[["ic",-1,1],["abil",-1,1],["iv",-1,1]];var t=[["ica",-1,1],["ancia",-1,2],["encia",-1,5],["adora",-1,2],["osa",-1,1],["ista",-1,1],["iva",-1,9],["anza",-1,1],["logía",-1,3],["idad",-1,8],["able",-1,1],["ible",-1,1],["ante",-1,2],["mente",-1,7],["amente",13,6],["ación",-1,2],["ución",-1,4],["ico",-1,1],["ismo",-1,1],["oso",-1,1],["amiento",-1,1],["imiento",-1,1],["ivo",-1,9],["ador",-1,2],["icas",-1,1],["ancias",-1,2],["encias",-1,5],["adoras",-1,2],["osas",-1,1],["istas",-1,1],["ivas",-1,9],["anzas",-1,1],["logías",-1,3],["idades",-1,8],["ables",-1,1],["ibles",-1,1],["aciones",-1,2],["uciones",-1,4],["adores",-1,2],["antes",-1,2],["icos",-1,1],["ismos",-1,1],["osos",-1,1],["amientos",-1,1],["imientos",-1,1],["ivos",-1,9]];var c=[["ya",-1,1],["ye",-1,1],["yan",-1,1],["yen",-1,1],["yeron",-1,1],["yendo",-1,1],["yo",-1,1],["yas",-1,1],["yes",-1,1],["yais",-1,1],["yamos",-1,1],["yó",-1,1]];var l=[["aba",-1,2],["ada",-1,2],["ida",-1,2],["ara",-1,2],["iera",-1,2],["ía",-1,2],["aría",5,2],["ería",5,2],["iría",5,2],["ad",-1,2],["ed",-1,2],["id",-1,2],["ase",-1,2],["iese",-1,2],["aste",-1,2],["iste",-1,2],["an",-1,2],["aban",16,2],["aran",16,2],["ieran",16,2],["ían",16,2],["arían",20,2],["erían",20,2],["irían",20,2],["en",-1,1],["asen",24,2],["iesen",24,2],["aron",-1,2],["ieron",-1,2],["arán",-1,2],["erán",-1,2],["irán",-1,2],["ado",-1,2],["ido",-1,2],["ando",-1,2],["iendo",-1,2],["ar",-1,2],["er",-1,2],["ir",-1,2],["as",-1,2],["abas",39,2],["adas",39,2],["idas",39,2],["aras",39,2],["ieras",39,2],["ías",39,2],["arías",45,2],["erías",45,2],["irías",45,2],["es",-1,1],["ases",49,2],["ieses",49,2],["abais",-1,2],["arais",-1,2],["ierais",-1,2],["íais",-1,2],["aríais",55,2],["eríais",55,2],["iríais",55,2],["aseis",-1,2],["ieseis",-1,2],["asteis",-1,2],["isteis",-1,2],["áis",-1,2],["éis",-1,1],["aréis",64,2],["eréis",64,2],["iréis",64,2],["ados",-1,2],["idos",-1,2],["amos",-1,2],["ábamos",70,2],["áramos",70,2],["iéramos",70,2],["íamos",70,2],["aríamos",74,2],["eríamos",74,2],["iríamos",74,2],["emos",-1,1],["aremos",78,2],["eremos",78,2],["iremos",78,2],["ásemos",78,2],["iésemos",78,2],["imos",-1,2],["arás",-1,2],["erás",-1,2],["irás",-1,2],["ís",-1,2],["ará",-1,2],["erá",-1,2],["irá",-1,2],["aré",-1,2],["eré",-1,2],["iré",-1,2],["ió",-1,2]];var f=[["a",-1,1],["e",-1,2],["o",-1,1],["os",-1,1],["á",-1,1],["é",-1,2],["í",-1,1],["ó",-1,1]];var n=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,4,10];var b=0;var m=0;var k=0;function _(){k=r.limit;m=r.limit;b=r.limit;var e=r.cursor;r:{e:{var i=r.cursor;i:{if(!r.in_grouping(n,97,252)){break i}a:{var a=r.cursor;s:{if(!r.out_grouping(n,97,252)){break s}u:while(true){o:{if(!r.in_grouping(n,97,252)){break o}break u}if(r.cursor>=r.limit){break s}r.cursor++}break a}r.cursor=a;if(!r.in_grouping(n,97,252)){break i}s:while(true){u:{if(!r.out_grouping(n,97,252)){break u}break s}if(r.cursor>=r.limit){break i}r.cursor++}}break e}r.cursor=i;if(!r.out_grouping(n,97,252)){break r}i:{var s=r.cursor;a:{if(!r.out_grouping(n,97,252)){break a}s:while(true){u:{if(!r.in_grouping(n,97,252)){break u}break s}if(r.cursor>=r.limit){break a}r.cursor++}break i}r.cursor=s;if(!r.in_grouping(n,97,252)){break r}if(r.cursor>=r.limit){break r}r.cursor++}}k=r.cursor}r.cursor=e;var u=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(n,97,252)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(n,97,252)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}m=r.cursor;e:while(true){i:{if(!r.in_grouping(n,97,252)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(n,97,252)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}b=r.cursor}r.cursor=u;return true}function d(){var i;while(true){var a=r.cursor;r:{r.bra=r.cursor;i=r.find_among(e);if(i==0){break r}r.ket=r.cursor;switch(i){case 1:if(!r.slice_from("a")){return false}break;case 2:if(!r.slice_from("e")){return false}break;case 3:if(!r.slice_from("i")){return false}break;case 4:if(!r.slice_from("o")){return false}break;case 5:if(!r.slice_from("u")){return false}break;case 6:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=a;break}return true}function v(){if(!(k<=r.cursor)){return false}return true}function g(){if(!(m<=r.cursor)){return false}return true}function w(){if(!(b<=r.cursor)){return false}return true}function h(){var e;r.ket=r.cursor;if(r.find_among_b(i)==0){return false}r.bra=r.cursor;e=r.find_among_b(a);if(e==0){return false}if(!v()){return false}switch(e){case 1:r.bra=r.cursor;if(!r.slice_from("iendo")){return false}break;case 2:r.bra=r.cursor;if(!r.slice_from("ando")){return false}break;case 3:r.bra=r.cursor;if(!r.slice_from("ar")){return false}break;case 4:r.bra=r.cursor;if(!r.slice_from("er")){return false}break;case 5:r.bra=r.cursor;if(!r.slice_from("ir")){return false}break;case 6:if(!r.slice_del()){return false}break;case 7:if(!r.eq_s_b("u")){return false}if(!r.slice_del()){return false}break}return true}function p(){var e;r.ket=r.cursor;e=r.find_among_b(t);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!w()){return false}if(!r.slice_del()){return false}break;case 2:if(!w()){return false}if(!r.slice_del()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("ic")){r.cursor=r.limit-i;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-i;break r}if(!r.slice_del()){return false}}break;case 3:if(!w()){return false}if(!r.slice_from("log")){return false}break;case 4:if(!w()){return false}if(!r.slice_from("u")){return false}break;case 5:if(!w()){return false}if(!r.slice_from("ente")){return false}break;case 6:if(!g()){return false}if(!r.slice_del()){return false}var a=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(s);if(e==0){r.cursor=r.limit-a;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-a;break r}if(!r.slice_del()){return false}switch(e){case 1:r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-a;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-a;break r}if(!r.slice_del()){return false}break}}break;case 7:if(!w()){return false}if(!r.slice_del()){return false}var c=r.limit-r.cursor;r:{r.ket=r.cursor;if(r.find_among_b(u)==0){r.cursor=r.limit-c;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}}break;case 8:if(!w()){return false}if(!r.slice_del()){return false}var l=r.limit-r.cursor;r:{r.ket=r.cursor;if(r.find_among_b(o)==0){r.cursor=r.limit-l;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-l;break r}if(!r.slice_del()){return false}}break;case 9:if(!w()){return false}if(!r.slice_del()){return false}var f=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-f;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-f;break r}if(!r.slice_del()){return false}}break}return true}function y(){if(r.cursor=a.limit)break r}a.cursor++}g=a.cursor}a.cursor=r,r=a.cursor,a.go_out_grouping(b,97,252)&&(a.cursor++,a.go_in_grouping(b,97,252))&&(a.cursor++,k=a.cursor,a.go_out_grouping(b,97,252))&&(a.cursor++,a.go_in_grouping(b,97,252))&&(a.cursor++,d=a.cursor),a.cursor=r,a.limit_backward=a.cursor,a.cursor=a.limit;var r=a.limit-a.cursor,r=((()=>{var r;if(a.ket=a.cursor,0!=a.find_among_b(c)&&(a.bra=a.cursor,0!=(r=a.find_among_b(u)))&&v())switch(r){case 1:if(a.bra=a.cursor,a.slice_from("iendo"))break;return;case 2:if(a.bra=a.cursor,a.slice_from("ando"))break;return;case 3:if(a.bra=a.cursor,a.slice_from("ar"))break;return;case 4:if(a.bra=a.cursor,a.slice_from("er"))break;return;case 5:if(a.bra=a.cursor,a.slice_from("ir"))break;return;case 6:if(a.slice_del())break;return;case 7:if(!a.eq_s_b("u"))return;if(a.slice_del())break}})(),a.cursor=a.limit-r,a.limit-a.cursor),s=a.limit-a.cursor,s=(p()||(a.cursor=a.limit-s,(()=>{if(!(a.cursor{var r;if(!(a.cursor{var r;if(a.ket=a.cursor,0!=(r=a.find_among_b(_)))switch(a.bra=a.cursor,r){case 1:if(!v())return;if(a.slice_del())break;return;case 2:if(!v())return;if(!a.slice_del())return;var i=a.limit-a.cursor;if(a.ket=a.cursor,a.eq_s_b("u")){a.bra=a.cursor;var e=a.limit-a.cursor;if(a.eq_s_b("g"))if(a.cursor=a.limit-e,v()){if(!a.slice_del());}else a.cursor=a.limit-i;else a.cursor=a.limit-i}else a.cursor=a.limit-i}})(),a.cursor=a.limit-s,a.cursor=a.limit_backward,a.cursor);return(()=>{for(var r;;){var i=a.cursor;r:{switch(a.bra=a.cursor,r=a.find_among(o),a.ket=a.cursor,r){case 1:if(a.slice_from("a"))break;return;case 2:if(a.slice_from("e"))break;return;case 3:if(a.slice_from("i"))break;return;case 4:if(a.slice_from("o"))break;return;case 5:if(a.slice_from("u"))break;return;case 6:if(a.cursor>=a.limit)break r;a.cursor++}continue}a.cursor=i;break}})(),a.cursor=r,!0},this.stemWord=function(r){return a.setCurrent(r),this.stem(),a.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/swedish-stemmer.js b/sphinx/search/minified-js/swedish-stemmer.js index b975f54284d..d66010809c6 100644 --- a/sphinx/search/minified-js/swedish-stemmer.js +++ b/sphinx/search/minified-js/swedish-stemmer.js @@ -1 +1 @@ -SwedishStemmer=function(){var r=new BaseStemmer;var e=[["a",-1,1],["arna",0,1],["erna",0,1],["heterna",2,1],["orna",0,1],["ad",-1,1],["e",-1,1],["ade",6,1],["ande",6,1],["arne",6,1],["are",6,1],["aste",6,1],["en",-1,1],["anden",12,1],["aren",12,1],["heten",12,1],["ern",-1,1],["ar",-1,1],["er",-1,1],["heter",18,1],["or",-1,1],["s",-1,2],["as",21,1],["arnas",22,1],["ernas",22,1],["ornas",22,1],["es",21,1],["ades",26,1],["andes",26,1],["ens",21,1],["arens",29,1],["hetens",29,1],["erns",21,1],["at",-1,1],["andet",-1,1],["het",-1,1],["ast",-1,1]];var a=[["dd",-1,-1],["gd",-1,-1],["nn",-1,-1],["dt",-1,-1],["gt",-1,-1],["kt",-1,-1],["tt",-1,-1]];var i=[["ig",-1,1],["lig",0,1],["els",-1,1],["fullt",-1,3],["löst",-1,2]];var t=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,24,0,32];var s=[119,127,149];var u=0;var n=0;function c(){n=r.limit;var e=r.cursor;{var a=r.cursor+3;if(a>r.limit){return false}r.cursor=a}u=r.cursor;r.cursor=e;r:while(true){var i=r.cursor;e:{if(!r.in_grouping(t,97,246)){break e}r.cursor=i;break r}r.cursor=i;if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(t,97,246)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}n=r.cursor;r:{if(!(na.limit_backward))return a.cursor=a.limit-r,r=a.limit-a.cursor,0==a.find_among_b(i)?(a.cursor=a.limit-r,1):void 0}this.stem=function(){var r=a.cursor,i=(m=a.limit,t=a.cursor,(i=a.cursor+3)>a.limit||(a.cursor=i,l=a.cursor,a.cursor=t,a.go_out_grouping(u,97,246)&&(a.cursor++,a.go_in_grouping(u,97,246))&&(a.cursor++,m=a.cursor,l<=m||(m=l))),a.cursor=r,a.limit_backward=a.cursor,a.cursor=a.limit,a.limit-a.cursor),t=((()=>{var r;if(!(a.cursor{var r;if(!(a.cursor{var r;if(z=!1,A()){l.limit_backward=l.cursor,l.cursor=l.limit;var i=l.limit-l.cursor;r:{var c=l.limit-l.cursor;if(l.ket=l.cursor,0!=(r=l.find_among_b(p))){switch(l.bra=l.cursor,r){case 1:if(l.slice_del())break;return;case 2:var e=l.limit-l.cursor;if(0!=l.find_among_b(W))break r;if(l.cursor=l.limit-e,l.slice_del())break;return;case 3:var s=l.limit-l.cursor;if(0!=l.find_among_b(j))break r;if(l.cursor=l.limit-s,l.slice_del())break;return;case 4:var o=l.limit-l.cursor;if(l.eq_s_b("ச"))break r;if(l.cursor=l.limit-o,l.slice_from("்"))break;return;case 5:if(l.slice_from("்"))break;return;case 6:var u=l.limit-l.cursor;if(!l.eq_s_b("்"))break r;if(l.cursor=l.limit-u,l.slice_del())break;return}z=!0,l.cursor=l.limit-c}}if(l.cursor=l.limit-i,i=l.limit-l.cursor,l.ket=l.cursor,0!=l.find_among_b(x)){if(l.bra=l.cursor,!l.slice_del())return;z=!0}return l.cursor=l.limit-i,l.cursor=l.limit_backward,E(),!!z}})()){l.cursor=r;break}}}this.stem=function(){y=!1;var r,i,c=l.cursor;return F(),l.cursor=c,!!A()&&(c=l.cursor,l.bra=l.cursor,l.eq_s("எ")&&0!=l.find_among(e)&&l.eq_s("்")&&(l.ket=l.cursor,l.slice_del())&&(r=l.cursor,D(),l.cursor=r),l.cursor=c,r=l.cursor,l.bra=l.cursor,0!=l.find_among(s)&&0!=l.find_among(o)&&l.eq_s("்")&&(l.ket=l.cursor,l.slice_del())&&(c=l.cursor,D(),l.cursor=c),l.cursor=r,c=l.cursor,A()&&(l.limit_backward=l.cursor,l.cursor=l.limit,i=l.limit-l.cursor,l.ket=l.cursor,0!=l.find_among_b(v)&&(l.bra=l.cursor,!l.slice_from("்"))||(l.cursor=l.limit-i,l.cursor=l.limit_backward,E())),l.cursor=c,i=l.cursor,A()&&(l.limit_backward=l.cursor,l.cursor=l.limit,l.ket=l.cursor,l.eq_s_b("ும்"))&&(l.bra=l.cursor,l.slice_from("்"))&&(l.cursor=l.limit_backward,c=l.cursor,F(),l.cursor=c),l.cursor=i,c=l.cursor,(()=>{var r;if(A()&&(l.limit_backward=l.cursor,l.cursor=l.limit,l.ket=l.cursor,0!=(r=l.find_among_b(q)))){switch(l.bra=l.cursor,r){case 1:if(l.slice_from("்"))break;return;case 2:var i=l.limit-l.cursor;if(0!=l.find_among_b(w))return;if(l.cursor=l.limit-i,l.slice_from("்"))break;return;case 3:if(l.slice_del())break;return}l.cursor=l.limit_backward,E()}})(),l.cursor=c,c=l.cursor,(()=>{var r;if(y=!1,A()){l.limit_backward=l.cursor,l.cursor=l.limit;r:{var i=l.limit-l.cursor;i:{var c=l.limit-l.cursor;if(l.ket=l.cursor,0!=(r=l.find_among_b(S))){switch(l.bra=l.cursor,r){case 1:if(l.slice_del())break;return;case 2:if(l.slice_from("்"))break;return;case 3:var e=l.limit-l.cursor;if(l.eq_s_b("ம"))break i;if(l.cursor=l.limit-e,l.slice_from("்"))break;return;case 4:if(l.current.length<7)break i;if(l.slice_from("்"))break;return;case 5:var s=l.limit-l.cursor;if(0!=l.find_among_b(h))break i;if(l.cursor=l.limit-s,l.slice_from("்"))break;return;case 6:var o=l.limit-l.cursor;if(0!=l.find_among_b(C))break i;if(l.cursor=l.limit-o,l.slice_del())break;return;case 7:if(l.slice_from("ி"))break;return}l.cursor=l.limit-c;break r}}l.cursor=l.limit-i;i=l.limit-l.cursor;if(l.ket=l.cursor,!l.eq_s_b("ை"))return;var u=l.limit-l.cursor,a=l.limit-l.cursor;if(0==l.find_among_b(B))l.cursor=l.limit-a;else{l.cursor=l.limit-u;a=l.limit-l.cursor;if(0==l.find_among_b(T))return;if(!l.eq_s_b("்"))return;l.cursor=l.limit-a}if(l.bra=l.cursor,!l.slice_from("்"))return;l.cursor=l.limit-i}y=!0;var t=l.limit-l.cursor;l.ket=l.cursor,l.eq_s_b("ின்")&&(l.bra=l.cursor,!l.slice_from("்"))||(l.cursor=l.limit-t,l.cursor=l.limit_backward,E())}})(),l.cursor=c,c=l.cursor,(()=>{var r;if(l.limit_backward=l.cursor,l.cursor=l.limit,l.ket=l.cursor,0!=(r=l.find_among_b(d))){switch(l.bra=l.cursor,r){case 1:r:{var i=l.limit-l.cursor;if(0!=l.find_among_b(u)){if(l.slice_from("ுங்"))break r;return}if(l.cursor=l.limit-i,!l.slice_from("்"))return}break;case 2:if(l.slice_from("ல்"))break;return;case 3:if(l.slice_from("ள்"))break;return;case 4:if(l.slice_del())break;return}l.cursor=l.limit_backward}})(),l.cursor=c,c=l.cursor,A()&&(l.limit_backward=l.cursor,l.cursor=l.limit,l.ket=l.cursor,0!=l.find_among_b(g))&&(l.bra=l.cursor,l.slice_del())&&(l.cursor=l.limit_backward),l.cursor=c,c=l.cursor,G(),l.cursor=c,!0)},this.stemWord=function(r){return l.setCurrent(r),this.stem(),l.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/minified-js/turkish-stemmer.js b/sphinx/search/minified-js/turkish-stemmer.js index 4c0a699bfbe..476e4abc4ad 100644 --- a/sphinx/search/minified-js/turkish-stemmer.js +++ b/sphinx/search/minified-js/turkish-stemmer.js @@ -1 +1 @@ -TurkishStemmer=function(){var r=new BaseStemmer;var i=[["m",-1,-1],["n",-1,-1],["miz",-1,-1],["niz",-1,-1],["muz",-1,-1],["nuz",-1,-1],["müz",-1,-1],["nüz",-1,-1],["mız",-1,-1],["nız",-1,-1]];var e=[["leri",-1,-1],["ları",-1,-1]];var u=[["ni",-1,-1],["nu",-1,-1],["nü",-1,-1],["nı",-1,-1]];var a=[["in",-1,-1],["un",-1,-1],["ün",-1,-1],["ın",-1,-1]];var s=[["a",-1,-1],["e",-1,-1]];var t=[["na",-1,-1],["ne",-1,-1]];var l=[["da",-1,-1],["ta",-1,-1],["de",-1,-1],["te",-1,-1]];var c=[["nda",-1,-1],["nde",-1,-1]];var o=[["dan",-1,-1],["tan",-1,-1],["den",-1,-1],["ten",-1,-1]];var f=[["ndan",-1,-1],["nden",-1,-1]];var n=[["la",-1,-1],["le",-1,-1]];var b=[["ca",-1,-1],["ce",-1,-1]];var m=[["im",-1,-1],["um",-1,-1],["üm",-1,-1],["ım",-1,-1]];var k=[["sin",-1,-1],["sun",-1,-1],["sün",-1,-1],["sın",-1,-1]];var _=[["iz",-1,-1],["uz",-1,-1],["üz",-1,-1],["ız",-1,-1]];var v=[["siniz",-1,-1],["sunuz",-1,-1],["sünüz",-1,-1],["sınız",-1,-1]];var d=[["lar",-1,-1],["ler",-1,-1]];var g=[["niz",-1,-1],["nuz",-1,-1],["nüz",-1,-1],["nız",-1,-1]];var w=[["dir",-1,-1],["tir",-1,-1],["dur",-1,-1],["tur",-1,-1],["dür",-1,-1],["tür",-1,-1],["dır",-1,-1],["tır",-1,-1]];var q=[["casına",-1,-1],["cesine",-1,-1]];var p=[["di",-1,-1],["ti",-1,-1],["dik",-1,-1],["tik",-1,-1],["duk",-1,-1],["tuk",-1,-1],["dük",-1,-1],["tük",-1,-1],["dık",-1,-1],["tık",-1,-1],["dim",-1,-1],["tim",-1,-1],["dum",-1,-1],["tum",-1,-1],["düm",-1,-1],["tüm",-1,-1],["dım",-1,-1],["tım",-1,-1],["din",-1,-1],["tin",-1,-1],["dun",-1,-1],["tun",-1,-1],["dün",-1,-1],["tün",-1,-1],["dın",-1,-1],["tın",-1,-1],["du",-1,-1],["tu",-1,-1],["dü",-1,-1],["tü",-1,-1],["dı",-1,-1],["tı",-1,-1]];var h=[["sa",-1,-1],["se",-1,-1],["sak",-1,-1],["sek",-1,-1],["sam",-1,-1],["sem",-1,-1],["san",-1,-1],["sen",-1,-1]];var z=[["miş",-1,-1],["muş",-1,-1],["müş",-1,-1],["mış",-1,-1]];var y=[["b",-1,1],["c",-1,2],["d",-1,3],["ğ",-1,4]];var C=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,32,8,0,0,0,0,0,0,1];var S=[1,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,0,0,0,0,0,1];var B=[1,64,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1];var T=[17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,130];var W=[1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1];var j=[17];var x=[65];var A=[65];var D=false;function E(){var i=r.limit-r.cursor;r:while(true){var e=r.limit-r.cursor;i:{if(!r.in_grouping_b(C,97,305)){break i}r.cursor=r.limit-e;break r}r.cursor=r.limit-e;if(r.cursor<=r.limit_backward){return false}r.cursor--}r:{var u=r.limit-r.cursor;i:{if(!r.eq_s_b("a")){break i}e:while(true){var a=r.limit-r.cursor;u:{if(!r.in_grouping_b(B,97,305)){break u}r.cursor=r.limit-a;break e}r.cursor=r.limit-a;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("e")){break i}e:while(true){var s=r.limit-r.cursor;u:{if(!r.in_grouping_b(T,101,252)){break u}r.cursor=r.limit-s;break e}r.cursor=r.limit-s;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("ı")){break i}e:while(true){var t=r.limit-r.cursor;u:{if(!r.in_grouping_b(W,97,305)){break u}r.cursor=r.limit-t;break e}r.cursor=r.limit-t;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("i")){break i}e:while(true){var l=r.limit-r.cursor;u:{if(!r.in_grouping_b(j,101,105)){break u}r.cursor=r.limit-l;break e}r.cursor=r.limit-l;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("o")){break i}e:while(true){var c=r.limit-r.cursor;u:{if(!r.in_grouping_b(x,111,117)){break u}r.cursor=r.limit-c;break e}r.cursor=r.limit-c;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("ö")){break i}e:while(true){var o=r.limit-r.cursor;u:{if(!r.in_grouping_b(A,246,252)){break u}r.cursor=r.limit-o;break e}r.cursor=r.limit-o;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("u")){break i}e:while(true){var f=r.limit-r.cursor;u:{if(!r.in_grouping_b(x,111,117)){break u}r.cursor=r.limit-f;break e}r.cursor=r.limit-f;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;if(!r.eq_s_b("ü")){return false}i:while(true){var n=r.limit-r.cursor;e:{if(!r.in_grouping_b(A,246,252)){break e}r.cursor=r.limit-n;break i}r.cursor=r.limit-n;if(r.cursor<=r.limit_backward){return false}r.cursor--}}r.cursor=r.limit-i;return true}function F(){r:{var i=r.limit-r.cursor;i:{if(!r.eq_s_b("n")){break i}var e=r.limit-r.cursor;if(!r.in_grouping_b(C,97,305)){break i}r.cursor=r.limit-e;break r}r.cursor=r.limit-i;{var u=r.limit-r.cursor;i:{var a=r.limit-r.cursor;if(!r.eq_s_b("n")){break i}r.cursor=r.limit-a;return false}r.cursor=r.limit-u}var s=r.limit-r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;if(!r.in_grouping_b(C,97,305)){return false}r.cursor=r.limit-s}return true}function G(){r:{var i=r.limit-r.cursor;i:{if(!r.eq_s_b("s")){break i}var e=r.limit-r.cursor;if(!r.in_grouping_b(C,97,305)){break i}r.cursor=r.limit-e;break r}r.cursor=r.limit-i;{var u=r.limit-r.cursor;i:{var a=r.limit-r.cursor;if(!r.eq_s_b("s")){break i}r.cursor=r.limit-a;return false}r.cursor=r.limit-u}var s=r.limit-r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;if(!r.in_grouping_b(C,97,305)){return false}r.cursor=r.limit-s}return true}function H(){r:{var i=r.limit-r.cursor;i:{if(!r.eq_s_b("y")){break i}var e=r.limit-r.cursor;if(!r.in_grouping_b(C,97,305)){break i}r.cursor=r.limit-e;break r}r.cursor=r.limit-i;{var u=r.limit-r.cursor;i:{var a=r.limit-r.cursor;if(!r.eq_s_b("y")){break i}r.cursor=r.limit-a;return false}r.cursor=r.limit-u}var s=r.limit-r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;if(!r.in_grouping_b(C,97,305)){return false}r.cursor=r.limit-s}return true}function I(){r:{var i=r.limit-r.cursor;i:{if(!r.in_grouping_b(S,105,305)){break i}var e=r.limit-r.cursor;if(!r.out_grouping_b(C,97,305)){break i}r.cursor=r.limit-e;break r}r.cursor=r.limit-i;{var u=r.limit-r.cursor;i:{var a=r.limit-r.cursor;if(!r.in_grouping_b(S,105,305)){break i}r.cursor=r.limit-a;return false}r.cursor=r.limit-u}var s=r.limit-r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;if(!r.out_grouping_b(C,97,305)){return false}r.cursor=r.limit-s}return true}function J(){if(r.find_among_b(i)==0){return false}if(!I()){return false}return true}function K(){if(!E()){return false}if(!r.in_grouping_b(S,105,305)){return false}if(!G()){return false}return true}function L(){if(r.find_among_b(e)==0){return false}return true}function M(){if(!E()){return false}if(!r.in_grouping_b(S,105,305)){return false}if(!H()){return false}return true}function N(){if(!E()){return false}if(r.find_among_b(u)==0){return false}return true}function O(){if(!E()){return false}if(r.find_among_b(a)==0){return false}if(!F()){return false}return true}function P(){if(!E()){return false}if(r.find_among_b(s)==0){return false}if(!H()){return false}return true}function Q(){if(!E()){return false}if(r.find_among_b(t)==0){return false}return true}function R(){if(!E()){return false}if(r.find_among_b(l)==0){return false}return true}function U(){if(!E()){return false}if(r.find_among_b(c)==0){return false}return true}function V(){if(!E()){return false}if(r.find_among_b(o)==0){return false}return true}function X(){if(!E()){return false}if(r.find_among_b(f)==0){return false}return true}function Y(){if(!E()){return false}if(r.find_among_b(n)==0){return false}if(!H()){return false}return true}function Z(){if(!r.eq_s_b("ki")){return false}return true}function $(){if(!E()){return false}if(r.find_among_b(b)==0){return false}if(!F()){return false}return true}function rr(){if(!E()){return false}if(r.find_among_b(m)==0){return false}if(!H()){return false}return true}function ir(){if(!E()){return false}if(r.find_among_b(k)==0){return false}return true}function er(){if(!E()){return false}if(r.find_among_b(_)==0){return false}if(!H()){return false}return true}function ur(){if(r.find_among_b(v)==0){return false}return true}function ar(){if(!E()){return false}if(r.find_among_b(d)==0){return false}return true}function sr(){if(!E()){return false}if(r.find_among_b(g)==0){return false}return true}function tr(){if(!E()){return false}if(r.find_among_b(w)==0){return false}return true}function lr(){if(r.find_among_b(q)==0){return false}return true}function cr(){if(!E()){return false}if(r.find_among_b(p)==0){return false}if(!H()){return false}return true}function or(){if(r.find_among_b(h)==0){return false}if(!H()){return false}return true}function fr(){if(!E()){return false}if(r.find_among_b(z)==0){return false}if(!H()){return false}return true}function nr(){if(!r.eq_s_b("ken")){return false}if(!H()){return false}return true}function br(){r.ket=r.cursor;D=true;r:{var i=r.limit-r.cursor;i:{e:{var e=r.limit-r.cursor;u:{if(!fr()){break u}break e}r.cursor=r.limit-e;u:{if(!cr()){break u}break e}r.cursor=r.limit-e;u:{if(!or()){break u}break e}r.cursor=r.limit-e;if(!nr()){break i}}break r}r.cursor=r.limit-i;i:{if(!lr()){break i}e:{var u=r.limit-r.cursor;u:{if(!ur()){break u}break e}r.cursor=r.limit-u;u:{if(!ar()){break u}break e}r.cursor=r.limit-u;u:{if(!rr()){break u}break e}r.cursor=r.limit-u;u:{if(!ir()){break u}break e}r.cursor=r.limit-u;u:{if(!er()){break u}break e}r.cursor=r.limit-u}if(!fr()){break i}break r}r.cursor=r.limit-i;i:{if(!ar()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var a=r.limit-r.cursor;e:{r.ket=r.cursor;u:{var s=r.limit-r.cursor;a:{if(!tr()){break a}break u}r.cursor=r.limit-s;a:{if(!cr()){break a}break u}r.cursor=r.limit-s;a:{if(!or()){break a}break u}r.cursor=r.limit-s;if(!fr()){r.cursor=r.limit-a;break e}}}D=false;break r}r.cursor=r.limit-i;i:{if(!sr()){break i}e:{var t=r.limit-r.cursor;u:{if(!cr()){break u}break e}r.cursor=r.limit-t;if(!or()){break i}}break r}r.cursor=r.limit-i;i:{e:{var l=r.limit-r.cursor;u:{if(!ur()){break u}break e}r.cursor=r.limit-l;u:{if(!er()){break u}break e}r.cursor=r.limit-l;u:{if(!ir()){break u}break e}r.cursor=r.limit-l;if(!rr()){break i}}r.bra=r.cursor;if(!r.slice_del()){return false}var c=r.limit-r.cursor;e:{r.ket=r.cursor;if(!fr()){r.cursor=r.limit-c;break e}}break r}r.cursor=r.limit-i;if(!tr()){return false}r.bra=r.cursor;if(!r.slice_del()){return false}var o=r.limit-r.cursor;i:{r.ket=r.cursor;e:{var f=r.limit-r.cursor;u:{if(!ur()){break u}break e}r.cursor=r.limit-f;u:{if(!ar()){break u}break e}r.cursor=r.limit-f;u:{if(!rr()){break u}break e}r.cursor=r.limit-f;u:{if(!ir()){break u}break e}r.cursor=r.limit-f;u:{if(!er()){break u}break e}r.cursor=r.limit-f}if(!fr()){r.cursor=r.limit-o;break i}}}r.bra=r.cursor;if(!r.slice_del()){return false}return true}function mr(){r.ket=r.cursor;if(!Z()){return false}r:{var i=r.limit-r.cursor;i:{if(!R()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var e=r.limit-r.cursor;e:{r.ket=r.cursor;u:{var u=r.limit-r.cursor;a:{if(!ar()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}var a=r.limit-r.cursor;s:{if(!mr()){r.cursor=r.limit-a;break s}}break u}r.cursor=r.limit-u;if(!J()){r.cursor=r.limit-e;break e}r.bra=r.cursor;if(!r.slice_del()){return false}var s=r.limit-r.cursor;a:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-s;break a}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-s;break a}}}}break r}r.cursor=r.limit-i;i:{if(!O()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var t=r.limit-r.cursor;e:{r.ket=r.cursor;u:{var l=r.limit-r.cursor;a:{if(!L()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}break u}r.cursor=r.limit-l;a:{r.ket=r.cursor;s:{var c=r.limit-r.cursor;t:{if(!J()){break t}break s}r.cursor=r.limit-c;if(!K()){break a}}r.bra=r.cursor;if(!r.slice_del()){return false}var o=r.limit-r.cursor;s:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-o;break s}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-o;break s}}break u}r.cursor=r.limit-l;if(!mr()){r.cursor=r.limit-t;break e}}}break r}r.cursor=r.limit-i;if(!U()){return false}i:{var f=r.limit-r.cursor;e:{if(!L()){break e}r.bra=r.cursor;if(!r.slice_del()){return false}break i}r.cursor=r.limit-f;e:{if(!K()){break e}r.bra=r.cursor;if(!r.slice_del()){return false}var n=r.limit-r.cursor;u:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-n;break u}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-n;break u}}break i}r.cursor=r.limit-f;if(!mr()){return false}}}return true}function kr(){r:{var i=r.limit-r.cursor;i:{r.ket=r.cursor;if(!ar()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var e=r.limit-r.cursor;e:{if(!mr()){r.cursor=r.limit-e;break e}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;if(!$()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var u=r.limit-r.cursor;e:{u:{var a=r.limit-r.cursor;a:{r.ket=r.cursor;if(!L()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}break u}r.cursor=r.limit-a;a:{r.ket=r.cursor;s:{var s=r.limit-r.cursor;t:{if(!J()){break t}break s}r.cursor=r.limit-s;if(!K()){break a}}r.bra=r.cursor;if(!r.slice_del()){return false}var t=r.limit-r.cursor;s:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-t;break s}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-t;break s}}break u}r.cursor=r.limit-a;r.ket=r.cursor;if(!ar()){r.cursor=r.limit-u;break e}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-u;break e}}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;e:{var l=r.limit-r.cursor;u:{if(!U()){break u}break e}r.cursor=r.limit-l;if(!Q()){break i}}e:{var c=r.limit-r.cursor;u:{if(!L()){break u}r.bra=r.cursor;if(!r.slice_del()){return false}break e}r.cursor=r.limit-c;u:{if(!K()){break u}r.bra=r.cursor;if(!r.slice_del()){return false}var o=r.limit-r.cursor;a:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-o;break a}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-o;break a}}break e}r.cursor=r.limit-c;if(!mr()){break i}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;e:{var f=r.limit-r.cursor;u:{if(!X()){break u}break e}r.cursor=r.limit-f;if(!N()){break i}}e:{var n=r.limit-r.cursor;u:{if(!K()){break u}r.bra=r.cursor;if(!r.slice_del()){return false}var b=r.limit-r.cursor;a:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-b;break a}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-b;break a}}break e}r.cursor=r.limit-n;if(!L()){break i}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;if(!V()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var m=r.limit-r.cursor;e:{r.ket=r.cursor;u:{var k=r.limit-r.cursor;a:{if(!J()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}var _=r.limit-r.cursor;s:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-_;break s}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-_;break s}}break u}r.cursor=r.limit-k;a:{if(!ar()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}var v=r.limit-r.cursor;s:{if(!mr()){r.cursor=r.limit-v;break s}}break u}r.cursor=r.limit-k;if(!mr()){r.cursor=r.limit-m;break e}}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;e:{var d=r.limit-r.cursor;u:{if(!O()){break u}break e}r.cursor=r.limit-d;if(!Y()){break i}}r.bra=r.cursor;if(!r.slice_del()){return false}var g=r.limit-r.cursor;e:{u:{var w=r.limit-r.cursor;a:{r.ket=r.cursor;if(!ar()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){break a}break u}r.cursor=r.limit-w;a:{r.ket=r.cursor;s:{var q=r.limit-r.cursor;t:{if(!J()){break t}break s}r.cursor=r.limit-q;if(!K()){break a}}r.bra=r.cursor;if(!r.slice_del()){return false}var p=r.limit-r.cursor;s:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-p;break s}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-p;break s}}break u}r.cursor=r.limit-w;if(!mr()){r.cursor=r.limit-g;break e}}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;if(!L()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}break r}r.cursor=r.limit-i;i:{if(!mr()){break i}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;e:{var h=r.limit-r.cursor;u:{if(!R()){break u}break e}r.cursor=r.limit-h;u:{if(!M()){break u}break e}r.cursor=r.limit-h;if(!P()){break i}}r.bra=r.cursor;if(!r.slice_del()){return false}var z=r.limit-r.cursor;e:{r.ket=r.cursor;u:{var y=r.limit-r.cursor;a:{if(!J()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}var C=r.limit-r.cursor;s:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-C;break s}}break u}r.cursor=r.limit-y;if(!ar()){r.cursor=r.limit-z;break e}}r.bra=r.cursor;if(!r.slice_del()){return false}r.ket=r.cursor;if(!mr()){r.cursor=r.limit-z;break e}}break r}r.cursor=r.limit-i;r.ket=r.cursor;i:{var S=r.limit-r.cursor;e:{if(!J()){break e}break i}r.cursor=r.limit-S;if(!K()){return false}}r.bra=r.cursor;if(!r.slice_del()){return false}var B=r.limit-r.cursor;i:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-B;break i}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-B;break i}}}return true}function _r(){var i;r.ket=r.cursor;i=r.find_among_b(y);if(i==0){return false}r.bra=r.cursor;switch(i){case 1:if(!r.slice_from("p")){return false}break;case 2:if(!r.slice_from("ç")){return false}break;case 3:if(!r.slice_from("t")){return false}break;case 4:if(!r.slice_from("k")){return false}break}return true}function vr(){var i=r.limit-r.cursor;r:{var e=r.limit-r.cursor;i:{if(!r.eq_s_b("d")){break i}break r}r.cursor=r.limit-e;if(!r.eq_s_b("g")){return false}}r.cursor=r.limit-i;r:{var u=r.limit-r.cursor;i:{var a=r.limit-r.cursor;e:while(true){var s=r.limit-r.cursor;u:{if(!r.in_grouping_b(C,97,305)){break u}r.cursor=r.limit-s;break e}r.cursor=r.limit-s;if(r.cursor<=r.limit_backward){break i}r.cursor--}e:{var t=r.limit-r.cursor;u:{if(!r.eq_s_b("a")){break u}break e}r.cursor=r.limit-t;if(!r.eq_s_b("ı")){break i}}r.cursor=r.limit-a;{var l=r.cursor;r.insert(r.cursor,r.cursor,"ı");r.cursor=l}break r}r.cursor=r.limit-u;i:{var c=r.limit-r.cursor;e:while(true){var o=r.limit-r.cursor;u:{if(!r.in_grouping_b(C,97,305)){break u}r.cursor=r.limit-o;break e}r.cursor=r.limit-o;if(r.cursor<=r.limit_backward){break i}r.cursor--}e:{var f=r.limit-r.cursor;u:{if(!r.eq_s_b("e")){break u}break e}r.cursor=r.limit-f;if(!r.eq_s_b("i")){break i}}r.cursor=r.limit-c;{var n=r.cursor;r.insert(r.cursor,r.cursor,"i");r.cursor=n}break r}r.cursor=r.limit-u;i:{var b=r.limit-r.cursor;e:while(true){var m=r.limit-r.cursor;u:{if(!r.in_grouping_b(C,97,305)){break u}r.cursor=r.limit-m;break e}r.cursor=r.limit-m;if(r.cursor<=r.limit_backward){break i}r.cursor--}e:{var k=r.limit-r.cursor;u:{if(!r.eq_s_b("o")){break u}break e}r.cursor=r.limit-k;if(!r.eq_s_b("u")){break i}}r.cursor=r.limit-b;{var _=r.cursor;r.insert(r.cursor,r.cursor,"u");r.cursor=_}break r}r.cursor=r.limit-u;var v=r.limit-r.cursor;i:while(true){var d=r.limit-r.cursor;e:{if(!r.in_grouping_b(C,97,305)){break e}r.cursor=r.limit-d;break i}r.cursor=r.limit-d;if(r.cursor<=r.limit_backward){return false}r.cursor--}i:{var g=r.limit-r.cursor;e:{if(!r.eq_s_b("ö")){break e}break i}r.cursor=r.limit-g;if(!r.eq_s_b("ü")){return false}}r.cursor=r.limit-v;{var w=r.cursor;r.insert(r.cursor,r.cursor,"ü");r.cursor=w}}return true}function dr(){if(!r.eq_s_b("ad")){return false}var i=r.limit-r.cursor;r:{if(!r.eq_s_b("soy")){r.cursor=r.limit-i;break r}}if(r.cursor>r.limit_backward){return false}return true}function gr(){var i=r.cursor;{var e=2;while(true){var u=r.cursor;r:{i:while(true){e:{if(!r.in_grouping(C,97,305)){break e}break i}if(r.cursor>=r.limit){break r}r.cursor++}e--;continue}r.cursor=u;break}if(e>0){return false}}r.cursor=i;return true}function wr(){r.limit_backward=r.cursor;r.cursor=r.limit;{var i=r.limit-r.cursor;r:{if(!dr()){break r}return false}r.cursor=r.limit-i}var e=r.limit-r.cursor;vr();r.cursor=r.limit-e;var u=r.limit-r.cursor;_r();r.cursor=r.limit-u;r.cursor=r.limit_backward;return true}this.stem=function(){if(!gr()){return false}r.limit_backward=r.cursor;r.cursor=r.limit;var i=r.limit-r.cursor;br();r.cursor=r.limit-i;if(!D){return false}var e=r.limit-r.cursor;kr();r.cursor=r.limit-e;r.cursor=r.limit_backward;if(!wr()){return false}return true};this["stemWord"]=function(i){r.setCurrent(i);this.stem();return r.getCurrent()}}; \ No newline at end of file +var TurkishStemmer=function(){var q=new BaseStemmer,u=[["m",-1,-1],["n",-1,-1],["miz",-1,-1],["niz",-1,-1],["muz",-1,-1],["nuz",-1,-1],["müz",-1,-1],["nüz",-1,-1],["mız",-1,-1],["nız",-1,-1]],r=[["leri",-1,-1],["ları",-1,-1]],p=[["ni",-1,-1],["nu",-1,-1],["nü",-1,-1],["nı",-1,-1]],i=[["in",-1,-1],["un",-1,-1],["ün",-1,-1],["ın",-1,-1]],z=[["a",-1,-1],["e",-1,-1]],w=[["na",-1,-1],["ne",-1,-1]],s=[["da",-1,-1],["ta",-1,-1],["de",-1,-1],["te",-1,-1]],o=[["nda",-1,-1],["nde",-1,-1]],h=[["dan",-1,-1],["tan",-1,-1],["den",-1,-1],["ten",-1,-1]],y=[["ndan",-1,-1],["nden",-1,-1]],C=[["la",-1,-1],["le",-1,-1]],I=[["ca",-1,-1],["ce",-1,-1]],g=[["im",-1,-1],["um",-1,-1],["üm",-1,-1],["ım",-1,-1]],v=[["sin",-1,-1],["sun",-1,-1],["sün",-1,-1],["sın",-1,-1]],J=[["iz",-1,-1],["uz",-1,-1],["üz",-1,-1],["ız",-1,-1]],K=[["siniz",-1,-1],["sunuz",-1,-1],["sünüz",-1,-1],["sınız",-1,-1]],L=[["lar",-1,-1],["ler",-1,-1]],M=[["niz",-1,-1],["nuz",-1,-1],["nüz",-1,-1],["nız",-1,-1]],N=[["dir",-1,-1],["tir",-1,-1],["dur",-1,-1],["tur",-1,-1],["dür",-1,-1],["tür",-1,-1],["dır",-1,-1],["tır",-1,-1]],O=[["casına",-1,-1],["cesine",-1,-1]],P=[["di",-1,-1],["ti",-1,-1],["dik",-1,-1],["tik",-1,-1],["duk",-1,-1],["tuk",-1,-1],["dük",-1,-1],["tük",-1,-1],["dık",-1,-1],["tık",-1,-1],["dim",-1,-1],["tim",-1,-1],["dum",-1,-1],["tum",-1,-1],["düm",-1,-1],["tüm",-1,-1],["dım",-1,-1],["tım",-1,-1],["din",-1,-1],["tin",-1,-1],["dun",-1,-1],["tun",-1,-1],["dün",-1,-1],["tün",-1,-1],["dın",-1,-1],["tın",-1,-1],["du",-1,-1],["tu",-1,-1],["dü",-1,-1],["tü",-1,-1],["dı",-1,-1],["tı",-1,-1]],Q=[["sa",-1,-1],["se",-1,-1],["sak",-1,-1],["sek",-1,-1],["sam",-1,-1],["sem",-1,-1],["san",-1,-1],["sen",-1,-1]],R=[["miş",-1,-1],["muş",-1,-1],["müş",-1,-1],["mış",-1,-1]],U=[["b",-1,1],["c",-1,2],["d",-1,3],["ğ",-1,4]],t=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,32,8,0,0,0,0,0,0,1],S=[1,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,0,0,0,0,0,1],V=[1,64,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],X=[17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,130],Y=[1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],Z=[17],c=[65],e=[65],l=!1;function B(){var r=q.limit-q.cursor;if(q.go_out_grouping_b(t,97,305)){var i=q.limit-q.cursor;if(!(q.eq_s_b("a")&&q.go_out_grouping_b(V,97,305)||(q.cursor=q.limit-i,q.eq_s_b("e")&&q.go_out_grouping_b(X,101,252))||(q.cursor=q.limit-i,q.eq_s_b("ı")&&q.go_out_grouping_b(Y,97,305))||(q.cursor=q.limit-i,q.eq_s_b("i")&&q.go_out_grouping_b(Z,101,105))||(q.cursor=q.limit-i,q.eq_s_b("o")&&q.go_out_grouping_b(c,111,117))||(q.cursor=q.limit-i,q.eq_s_b("ö")&&q.go_out_grouping_b(e,246,252))||(q.cursor=q.limit-i,q.eq_s_b("u")&&q.go_out_grouping_b(c,111,117)))){if(q.cursor=q.limit-i,!q.eq_s_b("ü"))return;if(!q.go_out_grouping_b(e,246,252))return}return q.cursor=q.limit-r,1}}function T(){r:{var r=q.limit-q.cursor;if(q.eq_s_b("n")){var i=q.limit-q.cursor;if(q.in_grouping_b(t,97,305)){q.cursor=q.limit-i;break r}}q.cursor=q.limit-r;i=q.limit-q.cursor,r=q.limit-q.cursor;if(q.eq_s_b("n"))return void(q.cursor=q.limit-r);q.cursor=q.limit-i;r=q.limit-q.cursor;if(q.cursor<=q.limit_backward)return;if(q.cursor--,!q.in_grouping_b(t,97,305))return;q.cursor=q.limit-r}return 1}function W(){r:{var r=q.limit-q.cursor;if(q.eq_s_b("y")){var i=q.limit-q.cursor;if(q.in_grouping_b(t,97,305)){q.cursor=q.limit-i;break r}}q.cursor=q.limit-r;i=q.limit-q.cursor,r=q.limit-q.cursor;if(q.eq_s_b("y"))return void(q.cursor=q.limit-r);q.cursor=q.limit-i;r=q.limit-q.cursor;if(q.cursor<=q.limit_backward)return;if(q.cursor--,!q.in_grouping_b(t,97,305))return;q.cursor=q.limit-r}return 1}function j(){if(0!=q.find_among_b(u)){r:{var r=q.limit-q.cursor;if(q.in_grouping_b(S,105,305)){var i=q.limit-q.cursor;if(q.out_grouping_b(t,97,305)){q.cursor=q.limit-i;break r}}q.cursor=q.limit-r;i=q.limit-q.cursor,r=q.limit-q.cursor;if(q.in_grouping_b(S,105,305))return!!(q.cursor=q.limit-r,0);q.cursor=q.limit-i;r=q.limit-q.cursor;if(q.cursor<=q.limit_backward)return!!void 0;if(q.cursor--,!q.out_grouping_b(t,97,305))return!!void 0;q.cursor=q.limit-r}return!!1}}function x(){if(B()&&q.in_grouping_b(S,105,305)){r:{var r=q.limit-q.cursor;if(q.eq_s_b("s")){var i=q.limit-q.cursor;if(q.in_grouping_b(t,97,305)){q.cursor=q.limit-i;break r}}q.cursor=q.limit-r;i=q.limit-q.cursor,r=q.limit-q.cursor;if(q.eq_s_b("s"))return!!(q.cursor=q.limit-r,0);q.cursor=q.limit-i;r=q.limit-q.cursor;if(q.cursor<=q.limit_backward)return!!void 0;if(q.cursor--,!q.in_grouping_b(t,97,305))return!!void 0;q.cursor=q.limit-r}return!!1}}function A(){return 0!=q.find_among_b(r)}function D(){return B()&&0!=q.find_among_b(i)&&!!T()}function E(){return B()&&0!=q.find_among_b(s)}function F(){return B()&&0!=q.find_among_b(o)}function m(){return B()&&0!=q.find_among_b(g)&&!!W()}function n(){return B()&&0!=q.find_among_b(v)}function _(){return B()&&0!=q.find_among_b(J)&&!!W()}function f(){return 0!=q.find_among_b(K)}function G(){return B()&&0!=q.find_among_b(L)}function a(){return B()&&0!=q.find_among_b(N)}function b(){return B()&&0!=q.find_among_b(P)&&!!W()}function d(){return 0!=q.find_among_b(Q)&&!!W()}function k(){return B()&&0!=q.find_among_b(R)&&!!W()}function $(){q.ket=q.cursor,l=!0;r:{var r=q.limit-q.cursor,i=q.limit-q.cursor;if(!(k()||(q.cursor=q.limit-i,b())||(q.cursor=q.limit-i,d())||(q.cursor=q.limit-i,q.eq_s_b("ken")&&W()))){if(q.cursor=q.limit-r,0!=q.find_among_b(O)){i=q.limit-q.cursor;if(f()||(q.cursor=q.limit-i,G())||(q.cursor=q.limit-i,m())||(q.cursor=q.limit-i,n())||(q.cursor=q.limit-i,_())||(q.cursor=q.limit-i),k())break r}if(q.cursor=q.limit-r,G()){if(q.bra=q.cursor,!q.slice_del())return;var i=q.limit-q.cursor,u=(q.ket=q.cursor,q.limit-q.cursor);a()||(q.cursor=q.limit-u,b())||(q.cursor=q.limit-u,d())||(q.cursor=q.limit-u,k())||(q.cursor=q.limit-i),l=!1}else{if(q.cursor=q.limit-r,B()&&0!=q.find_among_b(M)){u=q.limit-q.cursor;if(b()||(q.cursor=q.limit-u,d()))break r}q.cursor=q.limit-r;i=q.limit-q.cursor;if(f()||(q.cursor=q.limit-i,_())||(q.cursor=q.limit-i,n())||(q.cursor=q.limit-i,m())){if(q.bra=q.cursor,!q.slice_del())return;u=q.limit-q.cursor;q.ket=q.cursor,k()||(q.cursor=q.limit-u)}else{if(q.cursor=q.limit-r,!a())return;if(q.bra=q.cursor,!q.slice_del())return;i=q.limit-q.cursor,u=(q.ket=q.cursor,q.limit-q.cursor);f()||(q.cursor=q.limit-u,G())||(q.cursor=q.limit-u,m())||(q.cursor=q.limit-u,n())||(q.cursor=q.limit-u,_())||(q.cursor=q.limit-u),k()||(q.cursor=q.limit-i)}}}}q.bra=q.cursor,q.slice_del()}function H(){if(q.ket=q.cursor,q.eq_s_b("ki")){var r=q.limit-q.cursor;if(E()){if(q.bra=q.cursor,!q.slice_del())return;var i=q.limit-q.cursor;r:{q.ket=q.cursor;var u=q.limit-q.cursor;if(G()){if(q.bra=q.cursor,!q.slice_del())return;var s=q.limit-q.cursor;H()||(q.cursor=q.limit-s)}else{if(q.cursor=q.limit-u,!j()){q.cursor=q.limit-i;break r}if(q.bra=q.cursor,!q.slice_del())return;s=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;H()||(q.cursor=q.limit-s)}else q.cursor=q.limit-s}}}else if(q.cursor=q.limit-r,D()){if(q.bra=q.cursor,!q.slice_del())return;var o=q.limit-q.cursor;r:{q.ket=q.cursor;i:{var t=q.limit-q.cursor;if(A()){if(q.bra=q.cursor,q.slice_del())break i;return}q.cursor=q.limit-t,q.ket=q.cursor;var c=q.limit-q.cursor;if(j()||(q.cursor=q.limit-c,x())){if(q.bra=q.cursor,!q.slice_del())return;c=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;H()||(q.cursor=q.limit-c)}else q.cursor=q.limit-c}else if(q.cursor=q.limit-t,!H()){q.cursor=q.limit-o;break r}}}}else{if(q.cursor=q.limit-r,!F())return;r:{var e=q.limit-q.cursor;if(A()){if(q.bra=q.cursor,q.slice_del())break r;return}if(q.cursor=q.limit-e,x()){if(q.bra=q.cursor,!q.slice_del())return;var l=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;H()||(q.cursor=q.limit-l)}else q.cursor=q.limit-l}else if(q.cursor=q.limit-e,!H())return}}return 1}}function rr(){r:{var r=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;var i=q.limit-q.cursor;H()||(q.cursor=q.limit-i)}else if(q.cursor=q.limit-r,q.ket=q.cursor,B()&&0!=q.find_among_b(I)&&T()){if(q.bra=q.cursor,!q.slice_del())return;var u=q.limit-q.cursor;i:u:{var s=q.limit-q.cursor;if(q.ket=q.cursor,A()){if(q.bra=q.cursor,q.slice_del())break u;return}q.cursor=q.limit-s,q.ket=q.cursor;var o=q.limit-q.cursor;if(j()||(q.cursor=q.limit-o,x())){if(q.bra=q.cursor,!q.slice_del())return;o=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;H()||(q.cursor=q.limit-o)}else q.cursor=q.limit-o}else{if(q.cursor=q.limit-s,q.ket=q.cursor,!G()){q.cursor=q.limit-u;break i}if(q.bra=q.cursor,!q.slice_del())return;if(!H()){q.cursor=q.limit-u;break i}}}}else{q.cursor=q.limit-r;i:{q.ket=q.cursor;var t=q.limit-q.cursor;if(F()||(q.cursor=q.limit-t,B()&&0!=q.find_among_b(w))){u:{var c=q.limit-q.cursor;if(A()){if(q.bra=q.cursor,q.slice_del())break u;return}if(q.cursor=q.limit-c,x()){if(q.bra=q.cursor,!q.slice_del())return;var e=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;H()||(q.cursor=q.limit-e)}else q.cursor=q.limit-e}else if(q.cursor=q.limit-c,!H())break i}break r}}q.cursor=q.limit-r;i:{q.ket=q.cursor;var l=q.limit-q.cursor;if(B()&&0!=q.find_among_b(y)||(q.cursor=q.limit-l,B()&&0!=q.find_among_b(p))){l=q.limit-q.cursor;if(x()){if(q.bra=q.cursor,!q.slice_del())return;var m=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;H()||(q.cursor=q.limit-m)}else q.cursor=q.limit-m}else if(q.cursor=q.limit-l,!A())break i;break r}}if(q.cursor=q.limit-r,q.ket=q.cursor,B()&&0!=q.find_among_b(h)){if(q.bra=q.cursor,!q.slice_del())return;var n=q.limit-q.cursor;i:{q.ket=q.cursor;var _=q.limit-q.cursor;if(j()){if(q.bra=q.cursor,!q.slice_del())return;var f=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;H()||(q.cursor=q.limit-f)}else q.cursor=q.limit-f}else if(q.cursor=q.limit-_,G()){if(q.bra=q.cursor,!q.slice_del())return;f=q.limit-q.cursor;H()||(q.cursor=q.limit-f)}else if(q.cursor=q.limit-_,!H()){q.cursor=q.limit-n;break i}}}else{q.cursor=q.limit-r,q.ket=q.cursor;m=q.limit-q.cursor;if(D()||(q.cursor=q.limit-m,B()&&0!=q.find_among_b(C)&&W())){if(q.bra=q.cursor,!q.slice_del())return;var a=q.limit-q.cursor;i:u:{var b=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;if(H())break u}q.cursor=q.limit-b,q.ket=q.cursor;var d=q.limit-q.cursor;if(j()||(q.cursor=q.limit-d,x())){if(q.bra=q.cursor,!q.slice_del())return;d=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;H()||(q.cursor=q.limit-d)}else q.cursor=q.limit-d}else if(q.cursor=q.limit-b,!H()){q.cursor=q.limit-a;break i}}}else{if(q.cursor=q.limit-r,q.ket=q.cursor,A()){if(q.bra=q.cursor,q.slice_del())break r;return}if(q.cursor=q.limit-r,!H()){q.cursor=q.limit-r,q.ket=q.cursor;l=q.limit-q.cursor;if(E()||(q.cursor=q.limit-l,B()&&q.in_grouping_b(S,105,305)&&W())||(q.cursor=q.limit-l,B()&&0!=q.find_among_b(z)&&W())){if(q.bra=q.cursor,!q.slice_del())return;var k=q.limit-q.cursor;i:{q.ket=q.cursor;var g=q.limit-q.cursor;if(j()){if(q.bra=q.cursor,!q.slice_del())return;var v=q.limit-q.cursor;q.ket=q.cursor,G()||(q.cursor=q.limit-v)}else if(q.cursor=q.limit-g,!G()){q.cursor=q.limit-k;break i}if(q.bra=q.cursor,!q.slice_del())return;q.ket=q.cursor,H()||(q.cursor=q.limit-k)}}else{q.cursor=q.limit-r,q.ket=q.cursor;m=q.limit-q.cursor;if(!j()&&(q.cursor=q.limit-m,!x()))return;if(q.bra=q.cursor,!q.slice_del())return;l=q.limit-q.cursor;if(q.ket=q.cursor,G()){if(q.bra=q.cursor,!q.slice_del())return;H()||(q.cursor=q.limit-l)}else q.cursor=q.limit-l}}}}}}}function ir(){q.limit_backward=q.cursor,q.cursor=q.limit;var r=q.limit-q.cursor;if(!(()=>{var r;return!q.eq_s_b("ad")||(r=q.limit-q.cursor,q.eq_s_b("soy")||(q.cursor=q.limit-r),q.cursor>q.limit_backward)?void 0:1})())return q.cursor=q.limit-r,r=q.limit-q.cursor,(()=>{q.ket=q.cursor,q.bra=q.cursor;var r=q.limit-q.cursor;if((q.eq_s_b("d")||(q.cursor=q.limit-r,q.eq_s_b("g")))&&q.go_out_grouping_b(t,97,305))r:{var i=q.limit-q.cursor,u=q.limit-q.cursor;if(q.eq_s_b("a")||(q.cursor=q.limit-u,q.eq_s_b("ı"))){if(q.slice_from("ı"))break r;return}q.cursor=q.limit-i;u=q.limit-q.cursor;if(q.eq_s_b("e")||(q.cursor=q.limit-u,q.eq_s_b("i"))){if(q.slice_from("i"))break r;return}q.cursor=q.limit-i;u=q.limit-q.cursor;if(q.eq_s_b("o")||(q.cursor=q.limit-u,q.eq_s_b("u"))){if(q.slice_from("u"))break r;return}q.cursor=q.limit-i;u=q.limit-q.cursor;if(!q.eq_s_b("ö")&&(q.cursor=q.limit-u,!q.eq_s_b("ü")))return;if(!q.slice_from("ü"))return}})(),q.cursor=q.limit-r,r=q.limit-q.cursor,(()=>{var r;if(q.ket=q.cursor,0!=(r=q.find_among_b(U)))switch(q.bra=q.cursor,r){case 1:if(q.slice_from("p"))break;return;case 2:if(q.slice_from("ç"))break;return;case 3:if(q.slice_from("t"))break;return;case 4:if(q.slice_from("k"))break}})(),q.cursor=q.limit-r,q.cursor=q.limit_backward,1}this.stem=function(){if((()=>{var r=q.cursor;r:{for(q.bra=q.cursor;;){var i=q.cursor,u=q.cursor;if(!q.eq_s("'")){q.cursor=u,q.cursor=i;break}if(q.cursor=i,q.cursor>=q.limit)break r;q.cursor++}if(q.ket=q.cursor,!q.slice_del())return}q.cursor=r,r=q.cursor;r:{var s=q.cursor+2;if(!(s>q.limit)){for(q.cursor=s;;){var o=q.cursor;if(q.eq_s("'")){q.cursor=o;break}if(q.cursor=o,q.cursor>=q.limit)break r;q.cursor++}if(q.bra=q.cursor,q.cursor=q.limit,q.ket=q.cursor,!q.slice_del())return}}q.cursor=r})(),!(()=>{for(var r=q.cursor,i=2;0{for(var r,e=t.cursor;;){var s=t.cursor;r:{for(;;){var i=t.cursor;e:if(t.bra=t.cursor,0!=(r=t.find_among(l))){switch(t.ket=t.cursor,r){case 1:var c=t.cursor;if(t.eq_s("ּ"))break e;if(t.cursor=c,t.slice_from("װ"))break;return;case 2:var o=t.cursor;if(t.eq_s("ִ"))break e;if(t.cursor=o,t.slice_from("ױ"))break;return;case 3:var u=t.cursor;if(t.eq_s("ִ"))break e;if(t.cursor=u,t.slice_from("ײ"))break;return;case 4:if(t.slice_from("כ"))break;return;case 5:if(t.slice_from("מ"))break;return;case 6:if(t.slice_from("נ"))break;return;case 7:if(t.slice_from("פ"))break;return;case 8:if(t.slice_from("צ"))break;return}t.cursor=i;break}if(t.cursor=i,t.cursor>=t.limit)break r;t.cursor++}continue}t.cursor=s;break}for(t.cursor=e,e=t.cursor;;){var a=t.cursor;r:{for(;;){var f=t.cursor;if(t.bra=t.cursor,t.in_grouping(k,1456,1474)){if(t.ket=t.cursor,!t.slice_del())return;t.cursor=f;break}if(t.cursor=f,t.cursor>=t.limit)break r;t.cursor++}continue}t.cursor=a;break}t.cursor=e})();var r=t.cursor;return(()=>{q=t.limit;var r=t.cursor;if(t.bra=t.cursor,t.eq_s("גע")){t.ket=t.cursor;var e=t.cursor,s=t.cursor;if(!t.eq_s("לט")&&(t.cursor=s,!t.eq_s("בנ"))&&(t.cursor=s,t.cursort.limit||(t.cursor=e,v=t.cursor,t.cursor=s,r=t.cursor,0==t.find_among(f)&&(t.cursor=r),e=t.cursor,t.in_grouping(d,1489,1520)&&t.in_grouping(d,1489,1520)&&t.in_grouping(d,1489,1520)?q=t.cursor:(t.cursor=e,t.go_out_grouping(g,1488,1522)&&(t.cursor++,t.go_in_grouping(g,1488,1522))&&(q=t.cursor,v<=q||(q=v))))})(),t.cursor=r,t.limit_backward=t.cursor,t.cursor=t.limit,e(),t.cursor=t.limit_backward,!0},this.stemWord=function(r){return t.setCurrent(r),this.stem(),t.getCurrent()}}; \ No newline at end of file diff --git a/sphinx/search/nl.py b/sphinx/search/nl.py index 2d2f2b8a8b6..de1a7d1f17d 100644 --- a/sphinx/search/nl.py +++ b/sphinx/search/nl.py @@ -1,124 +1,21 @@ -"""Dutch search language: includes the JS porter stemmer.""" +"""Dutch search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -dutch_stopwords = parse_stop_word(""" -| source: https://snowball.tartarus.org/algorithms/dutch/stop.txt -de | the -en | and -van | of, from -ik | I, the ego -te | (1) chez, at etc, (2) to, (3) too -dat | that, which -die | that, those, who, which -in | in, inside -een | a, an, one -hij | he -het | the, it -niet | not, nothing, naught -zijn | (1) to be, being, (2) his, one's, its -is | is -was | (1) was, past tense of all persons sing. of 'zijn' (to be) (2) wax, (3) the washing, (4) rise of river -op | on, upon, at, in, up, used up -aan | on, upon, to (as dative) -met | with, by -als | like, such as, when -voor | (1) before, in front of, (2) furrow -had | had, past tense all persons sing. of 'hebben' (have) -er | there -maar | but, only -om | round, about, for etc -hem | him -dan | then -zou | should/would, past tense all persons sing. of 'zullen' -of | or, whether, if -wat | what, something, anything -mijn | possessive and noun 'mine' -men | people, 'one' -dit | this -zo | so, thus, in this way -door | through by -over | over, across -ze | she, her, they, them -zich | oneself -bij | (1) a bee, (2) by, near, at -ook | also, too -tot | till, until -je | you -mij | me -uit | out of, from -der | Old Dutch form of 'van der' still found in surnames -daar | (1) there, (2) because -haar | (1) her, their, them, (2) hair -naar | (1) unpleasant, unwell etc, (2) towards, (3) as -heb | present first person sing. of 'to have' -hoe | how, why -heeft | present third person sing. of 'to have' -hebben | 'to have' and various parts thereof -deze | this -u | you -want | (1) for, (2) mitten, (3) rigging -nog | yet, still -zal | 'shall', first and third person sing. of verb 'zullen' (will) -me | me -zij | she, they -nu | now -ge | 'thou', still used in Belgium and south Netherlands -geen | none -omdat | because -iets | something, somewhat -worden | to become, grow, get -toch | yet, still -al | all, every, each -waren | (1) 'were' (2) to wander, (3) wares, (3) -veel | much, many -meer | (1) more, (2) lake -doen | to do, to make -toen | then, when -moet | noun 'spot/mote' and present form of 'to must' -ben | (1) am, (2) 'are' in interrogative second person singular of 'to be' -zonder | without -kan | noun 'can' and present form of 'to be able' -hun | their, them -dus | so, consequently -alles | all, everything, anything -onder | under, beneath -ja | yes, of course -eens | once, one day -hier | here -wie | who -werd | imperfect third person sing. of 'become' -altijd | always -doch | yet, but etc -wordt | present third person sing. of 'become' -wezen | (1) to be, (2) 'been' as in 'been fishing', (3) orphans -kunnen | to be able -ons | us/our -zelf | self -tegen | against, towards, at -na | after, near -reeds | already -wil | (1) present tense of 'want', (2) 'will', noun, (3) fender -kon | could; past tense of 'to be able' -niets | nothing -uw | your -iemand | somebody -geweest | been; past participle of 'be' -andere | other -""") # NoQA: E501 +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.nl import DUTCH_STOPWORDS class SearchDutch(SearchLanguage): lang = 'nl' language_name = 'Dutch' js_stemmer_rawcode = 'dutch-stemmer.js' - stopwords = dutch_stopwords + stopwords = DUTCH_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('dutch') def stem(self, word: str) -> str: diff --git a/sphinx/search/no.py b/sphinx/search/no.py index dfc7786d46a..45b202f0926 100644 --- a/sphinx/search/no.py +++ b/sphinx/search/no.py @@ -1,199 +1,21 @@ -"""Norwegian search language: includes the JS Norwegian stemmer.""" +"""Norwegian search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -norwegian_stopwords = parse_stop_word(""" -| source: https://snowball.tartarus.org/algorithms/norwegian/stop.txt -og | and -i | in -jeg | I -det | it/this/that -at | to (w. inf.) -en | a/an -et | a/an -den | it/this/that -til | to -er | is/am/are -som | who/that -på | on -de | they / you(formal) -med | with -han | he -av | of -ikke | not -ikkje | not * -der | there -så | so -var | was/were -meg | me -seg | you -men | but -ett | one -har | have -om | about -vi | we -min | my -mitt | my -ha | have -hadde | had -hun | she -nå | now -over | over -da | when/as -ved | by/know -fra | from -du | you -ut | out -sin | your -dem | them -oss | us -opp | up -man | you/one -kan | can -hans | his -hvor | where -eller | or -hva | what -skal | shall/must -selv | self (reflective) -sjøl | self (reflective) -her | here -alle | all -vil | will -bli | become -ble | became -blei | became * -blitt | have become -kunne | could -inn | in -når | when -være | be -kom | come -noen | some -noe | some -ville | would -dere | you -som | who/which/that -deres | their/theirs -kun | only/just -ja | yes -etter | after -ned | down -skulle | should -denne | this -for | for/because -deg | you -si | hers/his -sine | hers/his -sitt | hers/his -mot | against -å | to -meget | much -hvorfor | why -dette | this -disse | these/those -uten | without -hvordan | how -ingen | none -din | your -ditt | your -blir | become -samme | same -hvilken | which -hvilke | which (plural) -sånn | such a -inni | inside/within -mellom | between -vår | our -hver | each -hvem | who -vors | us/ours -hvis | whose -både | both -bare | only/just -enn | than -fordi | as/because -før | before -mange | many -også | also -slik | just -vært | been -være | to be -båe | both * -begge | both -siden | since -dykk | your * -dykkar | yours * -dei | they * -deira | them * -deires | theirs * -deim | them * -di | your (fem.) * -då | as/when * -eg | I * -ein | a/an * -eit | a/an * -eitt | a/an * -elles | or * -honom | he * -hjå | at * -ho | she * -hoe | she * -henne | her -hennar | her/hers -hennes | hers -hoss | how * -hossen | how * -ikkje | not * -ingi | noone * -inkje | noone * -korleis | how * -korso | how * -kva | what/which * -kvar | where * -kvarhelst | where * -kven | who/whom * -kvi | why * -kvifor | why * -me | we * -medan | while * -mi | my * -mine | my * -mykje | much * -no | now * -nokon | some (masc./neut.) * -noka | some (fem.) * -nokor | some * -noko | some * -nokre | some * -si | his/hers * -sia | since * -sidan | since * -so | so * -somt | some * -somme | some * -um | about* -upp | up * -vere | be * -vore | was * -verte | become * -vort | become * -varte | became * -vart | became * -""") +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.no import NORWEGIAN_STOPWORDS class SearchNorwegian(SearchLanguage): lang = 'no' language_name = 'Norwegian' js_stemmer_rawcode = 'norwegian-stemmer.js' - stopwords = norwegian_stopwords + stopwords = NORWEGIAN_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('norwegian') def stem(self, word: str) -> str: diff --git a/sphinx/search/non-minified-js/arabic-stemmer.js b/sphinx/search/non-minified-js/arabic-stemmer.js new file mode 100644 index 00000000000..dbab12d81e1 --- /dev/null +++ b/sphinx/search/non-minified-js/arabic-stemmer.js @@ -0,0 +1,1612 @@ +// Generated from arabic.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var ArabicStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["\u0640", -1, 1], + ["\u064B", -1, 1], + ["\u064C", -1, 1], + ["\u064D", -1, 1], + ["\u064E", -1, 1], + ["\u064F", -1, 1], + ["\u0650", -1, 1], + ["\u0651", -1, 1], + ["\u0652", -1, 1], + ["\u0660", -1, 2], + ["\u0661", -1, 3], + ["\u0662", -1, 4], + ["\u0663", -1, 5], + ["\u0664", -1, 6], + ["\u0665", -1, 7], + ["\u0666", -1, 8], + ["\u0667", -1, 9], + ["\u0668", -1, 10], + ["\u0669", -1, 11], + ["\uFE80", -1, 12], + ["\uFE81", -1, 16], + ["\uFE82", -1, 16], + ["\uFE83", -1, 13], + ["\uFE84", -1, 13], + ["\uFE85", -1, 17], + ["\uFE86", -1, 17], + ["\uFE87", -1, 14], + ["\uFE88", -1, 14], + ["\uFE89", -1, 15], + ["\uFE8A", -1, 15], + ["\uFE8B", -1, 15], + ["\uFE8C", -1, 15], + ["\uFE8D", -1, 18], + ["\uFE8E", -1, 18], + ["\uFE8F", -1, 19], + ["\uFE90", -1, 19], + ["\uFE91", -1, 19], + ["\uFE92", -1, 19], + ["\uFE93", -1, 20], + ["\uFE94", -1, 20], + ["\uFE95", -1, 21], + ["\uFE96", -1, 21], + ["\uFE97", -1, 21], + ["\uFE98", -1, 21], + ["\uFE99", -1, 22], + ["\uFE9A", -1, 22], + ["\uFE9B", -1, 22], + ["\uFE9C", -1, 22], + ["\uFE9D", -1, 23], + ["\uFE9E", -1, 23], + ["\uFE9F", -1, 23], + ["\uFEA0", -1, 23], + ["\uFEA1", -1, 24], + ["\uFEA2", -1, 24], + ["\uFEA3", -1, 24], + ["\uFEA4", -1, 24], + ["\uFEA5", -1, 25], + ["\uFEA6", -1, 25], + ["\uFEA7", -1, 25], + ["\uFEA8", -1, 25], + ["\uFEA9", -1, 26], + ["\uFEAA", -1, 26], + ["\uFEAB", -1, 27], + ["\uFEAC", -1, 27], + ["\uFEAD", -1, 28], + ["\uFEAE", -1, 28], + ["\uFEAF", -1, 29], + ["\uFEB0", -1, 29], + ["\uFEB1", -1, 30], + ["\uFEB2", -1, 30], + ["\uFEB3", -1, 30], + ["\uFEB4", -1, 30], + ["\uFEB5", -1, 31], + ["\uFEB6", -1, 31], + ["\uFEB7", -1, 31], + ["\uFEB8", -1, 31], + ["\uFEB9", -1, 32], + ["\uFEBA", -1, 32], + ["\uFEBB", -1, 32], + ["\uFEBC", -1, 32], + ["\uFEBD", -1, 33], + ["\uFEBE", -1, 33], + ["\uFEBF", -1, 33], + ["\uFEC0", -1, 33], + ["\uFEC1", -1, 34], + ["\uFEC2", -1, 34], + ["\uFEC3", -1, 34], + ["\uFEC4", -1, 34], + ["\uFEC5", -1, 35], + ["\uFEC6", -1, 35], + ["\uFEC7", -1, 35], + ["\uFEC8", -1, 35], + ["\uFEC9", -1, 36], + ["\uFECA", -1, 36], + ["\uFECB", -1, 36], + ["\uFECC", -1, 36], + ["\uFECD", -1, 37], + ["\uFECE", -1, 37], + ["\uFECF", -1, 37], + ["\uFED0", -1, 37], + ["\uFED1", -1, 38], + ["\uFED2", -1, 38], + ["\uFED3", -1, 38], + ["\uFED4", -1, 38], + ["\uFED5", -1, 39], + ["\uFED6", -1, 39], + ["\uFED7", -1, 39], + ["\uFED8", -1, 39], + ["\uFED9", -1, 40], + ["\uFEDA", -1, 40], + ["\uFEDB", -1, 40], + ["\uFEDC", -1, 40], + ["\uFEDD", -1, 41], + ["\uFEDE", -1, 41], + ["\uFEDF", -1, 41], + ["\uFEE0", -1, 41], + ["\uFEE1", -1, 42], + ["\uFEE2", -1, 42], + ["\uFEE3", -1, 42], + ["\uFEE4", -1, 42], + ["\uFEE5", -1, 43], + ["\uFEE6", -1, 43], + ["\uFEE7", -1, 43], + ["\uFEE8", -1, 43], + ["\uFEE9", -1, 44], + ["\uFEEA", -1, 44], + ["\uFEEB", -1, 44], + ["\uFEEC", -1, 44], + ["\uFEED", -1, 45], + ["\uFEEE", -1, 45], + ["\uFEEF", -1, 46], + ["\uFEF0", -1, 46], + ["\uFEF1", -1, 47], + ["\uFEF2", -1, 47], + ["\uFEF3", -1, 47], + ["\uFEF4", -1, 47], + ["\uFEF5", -1, 51], + ["\uFEF6", -1, 51], + ["\uFEF7", -1, 49], + ["\uFEF8", -1, 49], + ["\uFEF9", -1, 50], + ["\uFEFA", -1, 50], + ["\uFEFB", -1, 48], + ["\uFEFC", -1, 48] + ]; + + /** @const */ var a_1 = [ + ["\u0622", -1, 1], + ["\u0623", -1, 1], + ["\u0624", -1, 1], + ["\u0625", -1, 1], + ["\u0626", -1, 1] + ]; + + /** @const */ var a_2 = [ + ["\u0622", -1, 1], + ["\u0623", -1, 1], + ["\u0624", -1, 2], + ["\u0625", -1, 1], + ["\u0626", -1, 3] + ]; + + /** @const */ var a_3 = [ + ["\u0627\u0644", -1, 2], + ["\u0628\u0627\u0644", -1, 1], + ["\u0643\u0627\u0644", -1, 1], + ["\u0644\u0644", -1, 2] + ]; + + /** @const */ var a_4 = [ + ["\u0623\u0622", -1, 2], + ["\u0623\u0623", -1, 1], + ["\u0623\u0624", -1, 1], + ["\u0623\u0625", -1, 4], + ["\u0623\u0627", -1, 3] + ]; + + /** @const */ var a_5 = [ + ["\u0641", -1, 1], + ["\u0648", -1, 1] + ]; + + /** @const */ var a_6 = [ + ["\u0627\u0644", -1, 2], + ["\u0628\u0627\u0644", -1, 1], + ["\u0643\u0627\u0644", -1, 1], + ["\u0644\u0644", -1, 2] + ]; + + /** @const */ var a_7 = [ + ["\u0628", -1, 1], + ["\u0628\u0627", 0, -1], + ["\u0628\u0628", 0, 2], + ["\u0643\u0643", -1, 3] + ]; + + /** @const */ var a_8 = [ + ["\u0633\u0623", -1, 4], + ["\u0633\u062A", -1, 2], + ["\u0633\u0646", -1, 3], + ["\u0633\u064A", -1, 1] + ]; + + /** @const */ var a_9 = [ + ["\u062A\u0633\u062A", -1, 1], + ["\u0646\u0633\u062A", -1, 1], + ["\u064A\u0633\u062A", -1, 1] + ]; + + /** @const */ var a_10 = [ + ["\u0643\u0645\u0627", -1, 3], + ["\u0647\u0645\u0627", -1, 3], + ["\u0646\u0627", -1, 2], + ["\u0647\u0627", -1, 2], + ["\u0643", -1, 1], + ["\u0643\u0645", -1, 2], + ["\u0647\u0645", -1, 2], + ["\u0647\u0646", -1, 2], + ["\u0647", -1, 1], + ["\u064A", -1, 1] + ]; + + /** @const */ var a_11 = [ + ["\u0646", -1, 1] + ]; + + /** @const */ var a_12 = [ + ["\u0627", -1, 1], + ["\u0648", -1, 1], + ["\u064A", -1, 1] + ]; + + /** @const */ var a_13 = [ + ["\u0627\u062A", -1, 1] + ]; + + /** @const */ var a_14 = [ + ["\u062A", -1, 1] + ]; + + /** @const */ var a_15 = [ + ["\u0629", -1, 1] + ]; + + /** @const */ var a_16 = [ + ["\u064A", -1, 1] + ]; + + /** @const */ var a_17 = [ + ["\u0643\u0645\u0627", -1, 3], + ["\u0647\u0645\u0627", -1, 3], + ["\u0646\u0627", -1, 2], + ["\u0647\u0627", -1, 2], + ["\u0643", -1, 1], + ["\u0643\u0645", -1, 2], + ["\u0647\u0645", -1, 2], + ["\u0643\u0646", -1, 2], + ["\u0647\u0646", -1, 2], + ["\u0647", -1, 1], + ["\u0643\u0645\u0648", -1, 3], + ["\u0646\u064A", -1, 2] + ]; + + /** @const */ var a_18 = [ + ["\u0627", -1, 1], + ["\u062A\u0627", 0, 2], + ["\u062A\u0645\u0627", 0, 4], + ["\u0646\u0627", 0, 2], + ["\u062A", -1, 1], + ["\u0646", -1, 1], + ["\u0627\u0646", 5, 3], + ["\u062A\u0646", 5, 2], + ["\u0648\u0646", 5, 3], + ["\u064A\u0646", 5, 3], + ["\u064A", -1, 1] + ]; + + /** @const */ var a_19 = [ + ["\u0648\u0627", -1, 1], + ["\u062A\u0645", -1, 1] + ]; + + /** @const */ var a_20 = [ + ["\u0648", -1, 1], + ["\u062A\u0645\u0648", 0, 2] + ]; + + /** @const */ var a_21 = [ + ["\u0649", -1, 1] + ]; + + var /** boolean */ B_is_defined = false; + var /** boolean */ B_is_verb = false; + var /** boolean */ B_is_noun = false; + + + /** @return {boolean} */ + function r_Normalize_pre() { + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + while(true) + { + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + lab2: { + /** @const */ var /** number */ v_3 = base.cursor; + lab3: { + base.bra = base.cursor; + among_var = base.find_among(a_0); + if (among_var == 0) + { + break lab3; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!base.slice_from("0")) + { + return false; + } + break; + case 3: + if (!base.slice_from("1")) + { + return false; + } + break; + case 4: + if (!base.slice_from("2")) + { + return false; + } + break; + case 5: + if (!base.slice_from("3")) + { + return false; + } + break; + case 6: + if (!base.slice_from("4")) + { + return false; + } + break; + case 7: + if (!base.slice_from("5")) + { + return false; + } + break; + case 8: + if (!base.slice_from("6")) + { + return false; + } + break; + case 9: + if (!base.slice_from("7")) + { + return false; + } + break; + case 10: + if (!base.slice_from("8")) + { + return false; + } + break; + case 11: + if (!base.slice_from("9")) + { + return false; + } + break; + case 12: + if (!base.slice_from("\u0621")) + { + return false; + } + break; + case 13: + if (!base.slice_from("\u0623")) + { + return false; + } + break; + case 14: + if (!base.slice_from("\u0625")) + { + return false; + } + break; + case 15: + if (!base.slice_from("\u0626")) + { + return false; + } + break; + case 16: + if (!base.slice_from("\u0622")) + { + return false; + } + break; + case 17: + if (!base.slice_from("\u0624")) + { + return false; + } + break; + case 18: + if (!base.slice_from("\u0627")) + { + return false; + } + break; + case 19: + if (!base.slice_from("\u0628")) + { + return false; + } + break; + case 20: + if (!base.slice_from("\u0629")) + { + return false; + } + break; + case 21: + if (!base.slice_from("\u062A")) + { + return false; + } + break; + case 22: + if (!base.slice_from("\u062B")) + { + return false; + } + break; + case 23: + if (!base.slice_from("\u062C")) + { + return false; + } + break; + case 24: + if (!base.slice_from("\u062D")) + { + return false; + } + break; + case 25: + if (!base.slice_from("\u062E")) + { + return false; + } + break; + case 26: + if (!base.slice_from("\u062F")) + { + return false; + } + break; + case 27: + if (!base.slice_from("\u0630")) + { + return false; + } + break; + case 28: + if (!base.slice_from("\u0631")) + { + return false; + } + break; + case 29: + if (!base.slice_from("\u0632")) + { + return false; + } + break; + case 30: + if (!base.slice_from("\u0633")) + { + return false; + } + break; + case 31: + if (!base.slice_from("\u0634")) + { + return false; + } + break; + case 32: + if (!base.slice_from("\u0635")) + { + return false; + } + break; + case 33: + if (!base.slice_from("\u0636")) + { + return false; + } + break; + case 34: + if (!base.slice_from("\u0637")) + { + return false; + } + break; + case 35: + if (!base.slice_from("\u0638")) + { + return false; + } + break; + case 36: + if (!base.slice_from("\u0639")) + { + return false; + } + break; + case 37: + if (!base.slice_from("\u063A")) + { + return false; + } + break; + case 38: + if (!base.slice_from("\u0641")) + { + return false; + } + break; + case 39: + if (!base.slice_from("\u0642")) + { + return false; + } + break; + case 40: + if (!base.slice_from("\u0643")) + { + return false; + } + break; + case 41: + if (!base.slice_from("\u0644")) + { + return false; + } + break; + case 42: + if (!base.slice_from("\u0645")) + { + return false; + } + break; + case 43: + if (!base.slice_from("\u0646")) + { + return false; + } + break; + case 44: + if (!base.slice_from("\u0647")) + { + return false; + } + break; + case 45: + if (!base.slice_from("\u0648")) + { + return false; + } + break; + case 46: + if (!base.slice_from("\u0649")) + { + return false; + } + break; + case 47: + if (!base.slice_from("\u064A")) + { + return false; + } + break; + case 48: + if (!base.slice_from("\u0644\u0627")) + { + return false; + } + break; + case 49: + if (!base.slice_from("\u0644\u0623")) + { + return false; + } + break; + case 50: + if (!base.slice_from("\u0644\u0625")) + { + return false; + } + break; + case 51: + if (!base.slice_from("\u0644\u0622")) + { + return false; + } + break; + } + break lab2; + } + base.cursor = v_3; + if (base.cursor >= base.limit) + { + break lab1; + } + base.cursor++; + } + continue; + } + base.cursor = v_2; + break; + } + } + base.cursor = v_1; + return true; + }; + + /** @return {boolean} */ + function r_Normalize_post() { + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + base.limit_backward = base.cursor; base.cursor = base.limit; + base.ket = base.cursor; + if (base.find_among_b(a_1) == 0) + { + break lab0; + } + base.bra = base.cursor; + if (!base.slice_from("\u0621")) + { + return false; + } + base.cursor = base.limit_backward; + } + base.cursor = v_1; + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + while(true) + { + /** @const */ var /** number */ v_3 = base.cursor; + lab2: { + lab3: { + /** @const */ var /** number */ v_4 = base.cursor; + lab4: { + base.bra = base.cursor; + among_var = base.find_among(a_2); + if (among_var == 0) + { + break lab4; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("\u0627")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u0648")) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u064A")) + { + return false; + } + break; + } + break lab3; + } + base.cursor = v_4; + if (base.cursor >= base.limit) + { + break lab2; + } + base.cursor++; + } + continue; + } + base.cursor = v_3; + break; + } + } + base.cursor = v_2; + return true; + }; + + /** @return {boolean} */ + function r_Checks1() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_3); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (base.current.length <= 4) + { + return false; + } + B_is_noun = true; + B_is_verb = false; + B_is_defined = true; + break; + case 2: + if (base.current.length <= 3) + { + return false; + } + B_is_noun = true; + B_is_verb = false; + B_is_defined = true; + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Prefix_Step1() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_4); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (base.current.length <= 3) + { + return false; + } + if (!base.slice_from("\u0623")) + { + return false; + } + break; + case 2: + if (base.current.length <= 3) + { + return false; + } + if (!base.slice_from("\u0622")) + { + return false; + } + break; + case 3: + if (base.current.length <= 3) + { + return false; + } + if (!base.slice_from("\u0627")) + { + return false; + } + break; + case 4: + if (base.current.length <= 3) + { + return false; + } + if (!base.slice_from("\u0625")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Prefix_Step2() { + base.bra = base.cursor; + if (base.find_among(a_5) == 0) + { + return false; + } + base.ket = base.cursor; + if (base.current.length <= 3) + { + return false; + } + { + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + if (!(base.eq_s("\u0627"))) + { + break lab0; + } + return false; + } + base.cursor = v_1; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_Prefix_Step3a_Noun() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_6); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (base.current.length <= 5) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (base.current.length <= 4) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Prefix_Step3b_Noun() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_7); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (base.current.length <= 3) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (base.current.length <= 3) + { + return false; + } + if (!base.slice_from("\u0628")) + { + return false; + } + break; + case 3: + if (base.current.length <= 3) + { + return false; + } + if (!base.slice_from("\u0643")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Prefix_Step3_Verb() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_8); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (base.current.length <= 4) + { + return false; + } + if (!base.slice_from("\u064A")) + { + return false; + } + break; + case 2: + if (base.current.length <= 4) + { + return false; + } + if (!base.slice_from("\u062A")) + { + return false; + } + break; + case 3: + if (base.current.length <= 4) + { + return false; + } + if (!base.slice_from("\u0646")) + { + return false; + } + break; + case 4: + if (base.current.length <= 4) + { + return false; + } + if (!base.slice_from("\u0623")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Prefix_Step4_Verb() { + base.bra = base.cursor; + if (base.find_among(a_9) == 0) + { + return false; + } + base.ket = base.cursor; + if (base.current.length <= 4) + { + return false; + } + B_is_verb = true; + B_is_noun = false; + if (!base.slice_from("\u0627\u0633\u062A")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Noun_Step1a() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_10); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (base.current.length < 4) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (base.current.length < 5) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 3: + if (base.current.length < 6) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Noun_Step1b() { + base.ket = base.cursor; + if (base.find_among_b(a_11) == 0) + { + return false; + } + base.bra = base.cursor; + if (base.current.length <= 5) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Noun_Step2a() { + base.ket = base.cursor; + if (base.find_among_b(a_12) == 0) + { + return false; + } + base.bra = base.cursor; + if (base.current.length <= 4) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Noun_Step2b() { + base.ket = base.cursor; + if (base.find_among_b(a_13) == 0) + { + return false; + } + base.bra = base.cursor; + if (base.current.length < 5) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Noun_Step2c1() { + base.ket = base.cursor; + if (base.find_among_b(a_14) == 0) + { + return false; + } + base.bra = base.cursor; + if (base.current.length < 4) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Noun_Step2c2() { + base.ket = base.cursor; + if (base.find_among_b(a_15) == 0) + { + return false; + } + base.bra = base.cursor; + if (base.current.length < 4) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Noun_Step3() { + base.ket = base.cursor; + if (base.find_among_b(a_16) == 0) + { + return false; + } + base.bra = base.cursor; + if (base.current.length < 3) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Verb_Step1() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_17); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (base.current.length < 4) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (base.current.length < 5) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 3: + if (base.current.length < 6) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Verb_Step2a() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_18); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (base.current.length < 4) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (base.current.length < 5) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 3: + if (base.current.length <= 5) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 4: + if (base.current.length < 6) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Verb_Step2b() { + base.ket = base.cursor; + if (base.find_among_b(a_19) == 0) + { + return false; + } + base.bra = base.cursor; + if (base.current.length < 5) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_Verb_Step2c() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_20); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (base.current.length < 4) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (base.current.length < 6) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Suffix_All_alef_maqsura() { + base.ket = base.cursor; + if (base.find_among_b(a_21) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_from("\u064A")) + { + return false; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + B_is_noun = true; + B_is_verb = true; + B_is_defined = false; + /** @const */ var /** number */ v_1 = base.cursor; + r_Checks1(); + base.cursor = v_1; + r_Normalize_pre(); + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab0: { + lab1: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab2: { + if (!B_is_verb) + { + break lab2; + } + lab3: { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab4: { + { + var v_5 = 1; + while(true) + { + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + lab5: { + if (!r_Suffix_Verb_Step1()) + { + break lab5; + } + v_5--; + continue; + } + base.cursor = base.limit - v_6; + break; + } + if (v_5 > 0) + { + break lab4; + } + } + lab6: { + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab7: { + if (!r_Suffix_Verb_Step2a()) + { + break lab7; + } + break lab6; + } + base.cursor = base.limit - v_7; + lab8: { + if (!r_Suffix_Verb_Step2c()) + { + break lab8; + } + break lab6; + } + base.cursor = base.limit - v_7; + if (base.cursor <= base.limit_backward) + { + break lab4; + } + base.cursor--; + } + break lab3; + } + base.cursor = base.limit - v_4; + lab9: { + if (!r_Suffix_Verb_Step2b()) + { + break lab9; + } + break lab3; + } + base.cursor = base.limit - v_4; + if (!r_Suffix_Verb_Step2a()) + { + break lab2; + } + } + break lab1; + } + base.cursor = base.limit - v_3; + lab10: { + if (!B_is_noun) + { + break lab10; + } + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + lab11: { + lab12: { + /** @const */ var /** number */ v_9 = base.limit - base.cursor; + lab13: { + if (!r_Suffix_Noun_Step2c2()) + { + break lab13; + } + break lab12; + } + base.cursor = base.limit - v_9; + lab14: { + lab15: { + if (!B_is_defined) + { + break lab15; + } + break lab14; + } + if (!r_Suffix_Noun_Step1a()) + { + break lab14; + } + lab16: { + /** @const */ var /** number */ v_10 = base.limit - base.cursor; + lab17: { + if (!r_Suffix_Noun_Step2a()) + { + break lab17; + } + break lab16; + } + base.cursor = base.limit - v_10; + lab18: { + if (!r_Suffix_Noun_Step2b()) + { + break lab18; + } + break lab16; + } + base.cursor = base.limit - v_10; + lab19: { + if (!r_Suffix_Noun_Step2c1()) + { + break lab19; + } + break lab16; + } + base.cursor = base.limit - v_10; + if (base.cursor <= base.limit_backward) + { + break lab14; + } + base.cursor--; + } + break lab12; + } + base.cursor = base.limit - v_9; + lab20: { + if (!r_Suffix_Noun_Step1b()) + { + break lab20; + } + lab21: { + /** @const */ var /** number */ v_11 = base.limit - base.cursor; + lab22: { + if (!r_Suffix_Noun_Step2a()) + { + break lab22; + } + break lab21; + } + base.cursor = base.limit - v_11; + lab23: { + if (!r_Suffix_Noun_Step2b()) + { + break lab23; + } + break lab21; + } + base.cursor = base.limit - v_11; + if (!r_Suffix_Noun_Step2c1()) + { + break lab20; + } + } + break lab12; + } + base.cursor = base.limit - v_9; + lab24: { + lab25: { + if (!B_is_defined) + { + break lab25; + } + break lab24; + } + if (!r_Suffix_Noun_Step2a()) + { + break lab24; + } + break lab12; + } + base.cursor = base.limit - v_9; + if (!r_Suffix_Noun_Step2b()) + { + base.cursor = base.limit - v_8; + break lab11; + } + } + } + if (!r_Suffix_Noun_Step3()) + { + break lab10; + } + break lab1; + } + base.cursor = base.limit - v_3; + if (!r_Suffix_All_alef_maqsura()) + { + break lab0; + } + } + } + base.cursor = base.limit - v_2; + base.cursor = base.limit_backward; + /** @const */ var /** number */ v_12 = base.cursor; + lab26: { + /** @const */ var /** number */ v_13 = base.cursor; + lab27: { + if (!r_Prefix_Step1()) + { + base.cursor = v_13; + break lab27; + } + } + /** @const */ var /** number */ v_14 = base.cursor; + lab28: { + if (!r_Prefix_Step2()) + { + base.cursor = v_14; + break lab28; + } + } + lab29: { + /** @const */ var /** number */ v_15 = base.cursor; + lab30: { + if (!r_Prefix_Step3a_Noun()) + { + break lab30; + } + break lab29; + } + base.cursor = v_15; + lab31: { + if (!B_is_noun) + { + break lab31; + } + if (!r_Prefix_Step3b_Noun()) + { + break lab31; + } + break lab29; + } + base.cursor = v_15; + if (!B_is_verb) + { + break lab26; + } + /** @const */ var /** number */ v_16 = base.cursor; + lab32: { + if (!r_Prefix_Step3_Verb()) + { + base.cursor = v_16; + break lab32; + } + } + if (!r_Prefix_Step4_Verb()) + { + break lab26; + } + } + } + base.cursor = v_12; + r_Normalize_post(); + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/armenian-stemmer.js b/sphinx/search/non-minified-js/armenian-stemmer.js new file mode 100644 index 00000000000..915146dbd0a --- /dev/null +++ b/sphinx/search/non-minified-js/armenian-stemmer.js @@ -0,0 +1,350 @@ +// Generated from armenian.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var ArmenianStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["\u0580\u0578\u0580\u0564", -1, 1], + ["\u0565\u0580\u0578\u0580\u0564", 0, 1], + ["\u0561\u056C\u056B", -1, 1], + ["\u0561\u056F\u056B", -1, 1], + ["\u0578\u0580\u0561\u056F", -1, 1], + ["\u0565\u0572", -1, 1], + ["\u0561\u056F\u0561\u0576", -1, 1], + ["\u0561\u0580\u0561\u0576", -1, 1], + ["\u0565\u0576", -1, 1], + ["\u0565\u056F\u0565\u0576", 8, 1], + ["\u0565\u0580\u0565\u0576", 8, 1], + ["\u0578\u0580\u0567\u0576", -1, 1], + ["\u056B\u0576", -1, 1], + ["\u0563\u056B\u0576", 12, 1], + ["\u0578\u057E\u056B\u0576", 12, 1], + ["\u056C\u0561\u0575\u0576", -1, 1], + ["\u057E\u0578\u0582\u0576", -1, 1], + ["\u057A\u0565\u057D", -1, 1], + ["\u056B\u057E", -1, 1], + ["\u0561\u057F", -1, 1], + ["\u0561\u057E\u0565\u057F", -1, 1], + ["\u056F\u0578\u057F", -1, 1], + ["\u0562\u0561\u0580", -1, 1] + ]; + + /** @const */ var a_1 = [ + ["\u0561", -1, 1], + ["\u0561\u0581\u0561", 0, 1], + ["\u0565\u0581\u0561", 0, 1], + ["\u057E\u0565", -1, 1], + ["\u0561\u0581\u0580\u056B", -1, 1], + ["\u0561\u0581\u056B", -1, 1], + ["\u0565\u0581\u056B", -1, 1], + ["\u057E\u0565\u0581\u056B", 6, 1], + ["\u0561\u056C", -1, 1], + ["\u0568\u0561\u056C", 8, 1], + ["\u0561\u0576\u0561\u056C", 8, 1], + ["\u0565\u0576\u0561\u056C", 8, 1], + ["\u0561\u0581\u0576\u0561\u056C", 8, 1], + ["\u0565\u056C", -1, 1], + ["\u0568\u0565\u056C", 13, 1], + ["\u0576\u0565\u056C", 13, 1], + ["\u0581\u0576\u0565\u056C", 15, 1], + ["\u0565\u0581\u0576\u0565\u056C", 16, 1], + ["\u0579\u0565\u056C", 13, 1], + ["\u057E\u0565\u056C", 13, 1], + ["\u0561\u0581\u057E\u0565\u056C", 19, 1], + ["\u0565\u0581\u057E\u0565\u056C", 19, 1], + ["\u057F\u0565\u056C", 13, 1], + ["\u0561\u057F\u0565\u056C", 22, 1], + ["\u0578\u057F\u0565\u056C", 22, 1], + ["\u056F\u0578\u057F\u0565\u056C", 24, 1], + ["\u057E\u0561\u056E", -1, 1], + ["\u0578\u0582\u0574", -1, 1], + ["\u057E\u0578\u0582\u0574", 27, 1], + ["\u0561\u0576", -1, 1], + ["\u0581\u0561\u0576", 29, 1], + ["\u0561\u0581\u0561\u0576", 30, 1], + ["\u0561\u0581\u0580\u056B\u0576", -1, 1], + ["\u0561\u0581\u056B\u0576", -1, 1], + ["\u0565\u0581\u056B\u0576", -1, 1], + ["\u057E\u0565\u0581\u056B\u0576", 34, 1], + ["\u0561\u056C\u056B\u057D", -1, 1], + ["\u0565\u056C\u056B\u057D", -1, 1], + ["\u0561\u057E", -1, 1], + ["\u0561\u0581\u0561\u057E", 38, 1], + ["\u0565\u0581\u0561\u057E", 38, 1], + ["\u0561\u056C\u0578\u057E", -1, 1], + ["\u0565\u056C\u0578\u057E", -1, 1], + ["\u0561\u0580", -1, 1], + ["\u0561\u0581\u0561\u0580", 43, 1], + ["\u0565\u0581\u0561\u0580", 43, 1], + ["\u0561\u0581\u0580\u056B\u0580", -1, 1], + ["\u0561\u0581\u056B\u0580", -1, 1], + ["\u0565\u0581\u056B\u0580", -1, 1], + ["\u057E\u0565\u0581\u056B\u0580", 48, 1], + ["\u0561\u0581", -1, 1], + ["\u0565\u0581", -1, 1], + ["\u0561\u0581\u0580\u0565\u0581", 51, 1], + ["\u0561\u056C\u0578\u0582\u0581", -1, 1], + ["\u0565\u056C\u0578\u0582\u0581", -1, 1], + ["\u0561\u056C\u0578\u0582", -1, 1], + ["\u0565\u056C\u0578\u0582", -1, 1], + ["\u0561\u0584", -1, 1], + ["\u0581\u0561\u0584", 57, 1], + ["\u0561\u0581\u0561\u0584", 58, 1], + ["\u0561\u0581\u0580\u056B\u0584", -1, 1], + ["\u0561\u0581\u056B\u0584", -1, 1], + ["\u0565\u0581\u056B\u0584", -1, 1], + ["\u057E\u0565\u0581\u056B\u0584", 62, 1], + ["\u0561\u0576\u0584", -1, 1], + ["\u0581\u0561\u0576\u0584", 64, 1], + ["\u0561\u0581\u0561\u0576\u0584", 65, 1], + ["\u0561\u0581\u0580\u056B\u0576\u0584", -1, 1], + ["\u0561\u0581\u056B\u0576\u0584", -1, 1], + ["\u0565\u0581\u056B\u0576\u0584", -1, 1], + ["\u057E\u0565\u0581\u056B\u0576\u0584", 69, 1] + ]; + + /** @const */ var a_2 = [ + ["\u0578\u0580\u0564", -1, 1], + ["\u0578\u0582\u0575\u0569", -1, 1], + ["\u0578\u0582\u0570\u056B", -1, 1], + ["\u0581\u056B", -1, 1], + ["\u056B\u056C", -1, 1], + ["\u0561\u056F", -1, 1], + ["\u0575\u0561\u056F", 5, 1], + ["\u0561\u0576\u0561\u056F", 5, 1], + ["\u056B\u056F", -1, 1], + ["\u0578\u0582\u056F", -1, 1], + ["\u0561\u0576", -1, 1], + ["\u057A\u0561\u0576", 10, 1], + ["\u057D\u057F\u0561\u0576", 10, 1], + ["\u0561\u0580\u0561\u0576", 10, 1], + ["\u0565\u0572\u0567\u0576", -1, 1], + ["\u0575\u0578\u0582\u0576", -1, 1], + ["\u0578\u0582\u0569\u0575\u0578\u0582\u0576", 15, 1], + ["\u0561\u056E\u0578", -1, 1], + ["\u056B\u0579", -1, 1], + ["\u0578\u0582\u057D", -1, 1], + ["\u0578\u0582\u057D\u057F", -1, 1], + ["\u0563\u0561\u0580", -1, 1], + ["\u057E\u0578\u0580", -1, 1], + ["\u0561\u057E\u0578\u0580", 22, 1], + ["\u0578\u0581", -1, 1], + ["\u0561\u0576\u0585\u0581", -1, 1], + ["\u0578\u0582", -1, 1], + ["\u0584", -1, 1], + ["\u0579\u0565\u0584", 27, 1], + ["\u056B\u0584", 27, 1], + ["\u0561\u056C\u056B\u0584", 29, 1], + ["\u0561\u0576\u056B\u0584", 29, 1], + ["\u057E\u0561\u056E\u0584", 27, 1], + ["\u0578\u0582\u0575\u0584", 27, 1], + ["\u0565\u0576\u0584", 27, 1], + ["\u0578\u0576\u0584", 27, 1], + ["\u0578\u0582\u0576\u0584", 27, 1], + ["\u0574\u0578\u0582\u0576\u0584", 36, 1], + ["\u056B\u0579\u0584", 27, 1], + ["\u0561\u0580\u0584", 27, 1] + ]; + + /** @const */ var a_3 = [ + ["\u057D\u0561", -1, 1], + ["\u057E\u0561", -1, 1], + ["\u0561\u0574\u0562", -1, 1], + ["\u0564", -1, 1], + ["\u0561\u0576\u0564", 3, 1], + ["\u0578\u0582\u0569\u0575\u0561\u0576\u0564", 4, 1], + ["\u057E\u0561\u0576\u0564", 4, 1], + ["\u0578\u057B\u0564", 3, 1], + ["\u0565\u0580\u0564", 3, 1], + ["\u0576\u0565\u0580\u0564", 8, 1], + ["\u0578\u0582\u0564", 3, 1], + ["\u0568", -1, 1], + ["\u0561\u0576\u0568", 11, 1], + ["\u0578\u0582\u0569\u0575\u0561\u0576\u0568", 12, 1], + ["\u057E\u0561\u0576\u0568", 12, 1], + ["\u0578\u057B\u0568", 11, 1], + ["\u0565\u0580\u0568", 11, 1], + ["\u0576\u0565\u0580\u0568", 16, 1], + ["\u056B", -1, 1], + ["\u057E\u056B", 18, 1], + ["\u0565\u0580\u056B", 18, 1], + ["\u0576\u0565\u0580\u056B", 20, 1], + ["\u0561\u0576\u0578\u0582\u0574", -1, 1], + ["\u0565\u0580\u0578\u0582\u0574", -1, 1], + ["\u0576\u0565\u0580\u0578\u0582\u0574", 23, 1], + ["\u0576", -1, 1], + ["\u0561\u0576", 25, 1], + ["\u0578\u0582\u0569\u0575\u0561\u0576", 26, 1], + ["\u057E\u0561\u0576", 26, 1], + ["\u056B\u0576", 25, 1], + ["\u0565\u0580\u056B\u0576", 29, 1], + ["\u0576\u0565\u0580\u056B\u0576", 30, 1], + ["\u0578\u0582\u0569\u0575\u0561\u0576\u0576", 25, 1], + ["\u0565\u0580\u0576", 25, 1], + ["\u0576\u0565\u0580\u0576", 33, 1], + ["\u0578\u0582\u0576", 25, 1], + ["\u0578\u057B", -1, 1], + ["\u0578\u0582\u0569\u0575\u0561\u0576\u057D", -1, 1], + ["\u057E\u0561\u0576\u057D", -1, 1], + ["\u0578\u057B\u057D", -1, 1], + ["\u0578\u057E", -1, 1], + ["\u0561\u0576\u0578\u057E", 40, 1], + ["\u057E\u0578\u057E", 40, 1], + ["\u0565\u0580\u0578\u057E", 40, 1], + ["\u0576\u0565\u0580\u0578\u057E", 43, 1], + ["\u0565\u0580", -1, 1], + ["\u0576\u0565\u0580", 45, 1], + ["\u0581", -1, 1], + ["\u056B\u0581", 47, 1], + ["\u057E\u0561\u0576\u056B\u0581", 48, 1], + ["\u0578\u057B\u056B\u0581", 48, 1], + ["\u057E\u056B\u0581", 48, 1], + ["\u0565\u0580\u056B\u0581", 48, 1], + ["\u0576\u0565\u0580\u056B\u0581", 52, 1], + ["\u0581\u056B\u0581", 48, 1], + ["\u0578\u0581", 47, 1], + ["\u0578\u0582\u0581", 47, 1] + ]; + + /** @const */ var /** Array */ g_v = [209, 4, 128, 0, 18]; + + var /** number */ I_p2 = 0; + var /** number */ I_pV = 0; + + + /** @return {boolean} */ + function r_mark_regions() { + I_pV = base.limit; + I_p2 = base.limit; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + if (!base.go_out_grouping(g_v, 1377, 1413)) + { + break lab0; + } + base.cursor++; + I_pV = base.cursor; + if (!base.go_in_grouping(g_v, 1377, 1413)) + { + break lab0; + } + base.cursor++; + if (!base.go_out_grouping(g_v, 1377, 1413)) + { + break lab0; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 1377, 1413)) + { + break lab0; + } + base.cursor++; + I_p2 = base.cursor; + } + base.cursor = v_1; + return true; + }; + + /** @return {boolean} */ + function r_R2() { + return I_p2 <= base.cursor; + }; + + /** @return {boolean} */ + function r_adjective() { + base.ket = base.cursor; + if (base.find_among_b(a_0) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_verb() { + base.ket = base.cursor; + if (base.find_among_b(a_1) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_noun() { + base.ket = base.cursor; + if (base.find_among_b(a_2) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_ending() { + base.ket = base.cursor; + if (base.find_among_b(a_3) == 0) + { + return false; + } + base.bra = base.cursor; + if (!r_R2()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + r_mark_regions(); + base.limit_backward = base.cursor; base.cursor = base.limit; + if (base.cursor < I_pV) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit_backward; + base.limit_backward = I_pV; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + r_ending(); + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + r_verb(); + base.cursor = base.limit - v_3; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + r_adjective(); + base.cursor = base.limit - v_4; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + r_noun(); + base.cursor = base.limit - v_5; + base.limit_backward = v_1; + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/base-stemmer.js b/sphinx/search/non-minified-js/base-stemmer.js index ca6cca156a3..e6fa0c49260 100644 --- a/sphinx/search/non-minified-js/base-stemmer.js +++ b/sphinx/search/non-minified-js/base-stemmer.js @@ -1,5 +1,18 @@ +// @ts-check + /**@constructor*/ BaseStemmer = function() { + /** @protected */ + this.current = ''; + this.cursor = 0; + this.limit = 0; + this.limit_backward = 0; + this.bra = 0; + this.ket = 0; + + /** + * @param {string} value + */ this.setCurrent = function(value) { this.current = value; this.cursor = 0; @@ -9,11 +22,18 @@ BaseStemmer = function() { this.ket = this.limit; }; + /** + * @return {string} + */ this.getCurrent = function() { return this.current; }; + /** + * @param {BaseStemmer} other + */ this.copy_from = function(other) { + /** @protected */ this.current = other.current; this.cursor = other.cursor; this.limit = other.limit; @@ -22,7 +42,14 @@ BaseStemmer = function() { this.ket = other.ket; }; + /** + * @param {number[]} s + * @param {number} min + * @param {number} max + * @return {boolean} + */ this.in_grouping = function(s, min, max) { + /** @protected */ if (this.cursor >= this.limit) return false; var ch = this.current.charCodeAt(this.cursor); if (ch > max || ch < min) return false; @@ -32,7 +59,34 @@ BaseStemmer = function() { return true; }; + /** + * @param {number[]} s + * @param {number} min + * @param {number} max + * @return {boolean} + */ + this.go_in_grouping = function(s, min, max) { + /** @protected */ + while (this.cursor < this.limit) { + var ch = this.current.charCodeAt(this.cursor); + if (ch > max || ch < min) + return true; + ch -= min; + if ((s[ch >>> 3] & (0x1 << (ch & 0x7))) == 0) + return true; + this.cursor++; + } + return false; + }; + + /** + * @param {number[]} s + * @param {number} min + * @param {number} max + * @return {boolean} + */ this.in_grouping_b = function(s, min, max) { + /** @protected */ if (this.cursor <= this.limit_backward) return false; var ch = this.current.charCodeAt(this.cursor - 1); if (ch > max || ch < min) return false; @@ -42,7 +96,32 @@ BaseStemmer = function() { return true; }; + /** + * @param {number[]} s + * @param {number} min + * @param {number} max + * @return {boolean} + */ + this.go_in_grouping_b = function(s, min, max) { + /** @protected */ + while (this.cursor > this.limit_backward) { + var ch = this.current.charCodeAt(this.cursor - 1); + if (ch > max || ch < min) return true; + ch -= min; + if ((s[ch >>> 3] & (0x1 << (ch & 0x7))) == 0) return true; + this.cursor--; + } + return false; + }; + + /** + * @param {number[]} s + * @param {number} min + * @param {number} max + * @return {boolean} + */ this.out_grouping = function(s, min, max) { + /** @protected */ if (this.cursor >= this.limit) return false; var ch = this.current.charCodeAt(this.cursor); if (ch > max || ch < min) { @@ -57,7 +136,35 @@ BaseStemmer = function() { return false; }; + /** + * @param {number[]} s + * @param {number} min + * @param {number} max + * @return {boolean} + */ + this.go_out_grouping = function(s, min, max) { + /** @protected */ + while (this.cursor < this.limit) { + var ch = this.current.charCodeAt(this.cursor); + if (ch <= max && ch >= min) { + ch -= min; + if ((s[ch >>> 3] & (0X1 << (ch & 0x7))) != 0) { + return true; + } + } + this.cursor++; + } + return false; + }; + + /** + * @param {number[]} s + * @param {number} min + * @param {number} max + * @return {boolean} + */ this.out_grouping_b = function(s, min, max) { + /** @protected */ if (this.cursor <= this.limit_backward) return false; var ch = this.current.charCodeAt(this.cursor - 1); if (ch > max || ch < min) { @@ -72,8 +179,34 @@ BaseStemmer = function() { return false; }; + /** + * @param {number[]} s + * @param {number} min + * @param {number} max + * @return {boolean} + */ + this.go_out_grouping_b = function(s, min, max) { + /** @protected */ + while (this.cursor > this.limit_backward) { + var ch = this.current.charCodeAt(this.cursor - 1); + if (ch <= max && ch >= min) { + ch -= min; + if ((s[ch >>> 3] & (0x1 << (ch & 0x7))) != 0) { + return true; + } + } + this.cursor--; + } + return false; + }; + + /** + * @param {string} s + * @return {boolean} + */ this.eq_s = function(s) { + /** @protected */ if (this.limit - this.cursor < s.length) return false; if (this.current.slice(this.cursor, this.cursor + s.length) != s) { @@ -83,8 +216,13 @@ BaseStemmer = function() { return true; }; + /** + * @param {string} s + * @return {boolean} + */ this.eq_s_b = function(s) { + /** @protected */ if (this.cursor - this.limit_backward < s.length) return false; if (this.current.slice(this.cursor - s.length, this.cursor) != s) { @@ -94,8 +232,13 @@ BaseStemmer = function() { return true; }; - /** @return {number} */ this.find_among = function(v) + /** + * @param {Among[]} v + * @return {number} + */ + this.find_among = function(v) { + /** @protected */ var i = 0; var j = v.length; @@ -165,8 +308,13 @@ BaseStemmer = function() { }; // find_among_b is for backwards processing. Same comments apply + /** + * @param {Among[]} v + * @return {number} + */ this.find_among_b = function(v) { + /** @protected */ var i = 0; var j = v.length @@ -232,8 +380,15 @@ BaseStemmer = function() { /* to replace chars between c_bra and c_ket in this.current by the * chars in s. */ + /** + * @param {number} c_bra + * @param {number} c_ket + * @param {string} s + * @return {number} + */ this.replace_s = function(c_bra, c_ket, s) { + /** @protected */ var adjustment = s.length - (c_ket - c_bra); this.current = this.current.slice(0, c_bra) + s + this.current.slice(c_ket); this.limit += adjustment; @@ -242,8 +397,12 @@ BaseStemmer = function() { return adjustment; }; + /** + * @return {boolean} + */ this.slice_check = function() { + /** @protected */ if (this.bra < 0 || this.bra > this.ket || this.ket > this.limit || @@ -254,8 +413,13 @@ BaseStemmer = function() { return true; }; + /** + * @param {number} c_bra + * @return {boolean} + */ this.slice_from = function(s) { + /** @protected */ var result = false; if (this.slice_check()) { @@ -265,20 +429,34 @@ BaseStemmer = function() { return result; }; + /** + * @return {boolean} + */ this.slice_del = function() { + /** @protected */ return this.slice_from(""); }; + /** + * @param {number} c_bra + * @param {number} c_ket + * @param {string} s + */ this.insert = function(c_bra, c_ket, s) { + /** @protected */ var adjustment = this.replace_s(c_bra, c_ket, s); if (c_bra <= this.bra) this.bra += adjustment; if (c_bra <= this.ket) this.ket += adjustment; }; + /** + * @return {string} + */ this.slice_to = function() { + /** @protected */ var result = ''; if (this.slice_check()) { @@ -287,8 +465,12 @@ BaseStemmer = function() { return result; }; + /** + * @return {string} + */ this.assign_to = function() { + /** @protected */ return this.current.slice(0, this.limit); }; }; diff --git a/sphinx/search/non-minified-js/basque-stemmer.js b/sphinx/search/non-minified-js/basque-stemmer.js new file mode 100644 index 00000000000..5ed3a26af26 --- /dev/null +++ b/sphinx/search/non-minified-js/basque-stemmer.js @@ -0,0 +1,736 @@ +// Generated from basque.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var BasqueStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["idea", -1, 1], + ["bidea", 0, 1], + ["kidea", 0, 1], + ["pidea", 0, 1], + ["kundea", -1, 1], + ["galea", -1, 1], + ["tailea", -1, 1], + ["tzailea", -1, 1], + ["gunea", -1, 1], + ["kunea", -1, 1], + ["tzaga", -1, 1], + ["gaia", -1, 1], + ["aldia", -1, 1], + ["taldia", 12, 1], + ["karia", -1, 1], + ["garria", -1, 2], + ["karria", -1, 1], + ["ka", -1, 1], + ["tzaka", 17, 1], + ["la", -1, 1], + ["mena", -1, 1], + ["pena", -1, 1], + ["kina", -1, 1], + ["ezina", -1, 1], + ["tezina", 23, 1], + ["kuna", -1, 1], + ["tuna", -1, 1], + ["kizuna", -1, 1], + ["era", -1, 1], + ["bera", 28, 1], + ["arabera", 29, -1], + ["kera", 28, 1], + ["pera", 28, 1], + ["orra", -1, 1], + ["korra", 33, 1], + ["dura", -1, 1], + ["gura", -1, 1], + ["kura", -1, 1], + ["tura", -1, 1], + ["eta", -1, 1], + ["keta", 39, 1], + ["gailua", -1, 1], + ["eza", -1, 1], + ["erreza", 42, 1], + ["tza", -1, 2], + ["gaitza", 44, 1], + ["kaitza", 44, 1], + ["kuntza", 44, 1], + ["ide", -1, 1], + ["bide", 48, 1], + ["kide", 48, 1], + ["pide", 48, 1], + ["kunde", -1, 1], + ["tzake", -1, 1], + ["tzeke", -1, 1], + ["le", -1, 1], + ["gale", 55, 1], + ["taile", 55, 1], + ["tzaile", 55, 1], + ["gune", -1, 1], + ["kune", -1, 1], + ["tze", -1, 1], + ["atze", 61, 1], + ["gai", -1, 1], + ["aldi", -1, 1], + ["taldi", 64, 1], + ["ki", -1, 1], + ["ari", -1, 1], + ["kari", 67, 1], + ["lari", 67, 1], + ["tari", 67, 1], + ["etari", 70, 1], + ["garri", -1, 2], + ["karri", -1, 1], + ["arazi", -1, 1], + ["tarazi", 74, 1], + ["an", -1, 1], + ["ean", 76, 1], + ["rean", 77, 1], + ["kan", 76, 1], + ["etan", 76, 1], + ["atseden", -1, -1], + ["men", -1, 1], + ["pen", -1, 1], + ["kin", -1, 1], + ["rekin", 84, 1], + ["ezin", -1, 1], + ["tezin", 86, 1], + ["tun", -1, 1], + ["kizun", -1, 1], + ["go", -1, 1], + ["ago", 90, 1], + ["tio", -1, 1], + ["dako", -1, 1], + ["or", -1, 1], + ["kor", 94, 1], + ["tzat", -1, 1], + ["du", -1, 1], + ["gailu", -1, 1], + ["tu", -1, 1], + ["atu", 99, 1], + ["aldatu", 100, 1], + ["tatu", 100, 1], + ["baditu", 99, -1], + ["ez", -1, 1], + ["errez", 104, 1], + ["tzez", 104, 1], + ["gaitz", -1, 1], + ["kaitz", -1, 1] + ]; + + /** @const */ var a_1 = [ + ["ada", -1, 1], + ["kada", 0, 1], + ["anda", -1, 1], + ["denda", -1, 1], + ["gabea", -1, 1], + ["kabea", -1, 1], + ["aldea", -1, 1], + ["kaldea", 6, 1], + ["taldea", 6, 1], + ["ordea", -1, 1], + ["zalea", -1, 1], + ["tzalea", 10, 1], + ["gilea", -1, 1], + ["emea", -1, 1], + ["kumea", -1, 1], + ["nea", -1, 1], + ["enea", 15, 1], + ["zionea", 15, 1], + ["unea", 15, 1], + ["gunea", 18, 1], + ["pea", -1, 1], + ["aurrea", -1, 1], + ["tea", -1, 1], + ["kotea", 22, 1], + ["artea", 22, 1], + ["ostea", 22, 1], + ["etxea", -1, 1], + ["ga", -1, 1], + ["anga", 27, 1], + ["gaia", -1, 1], + ["aldia", -1, 1], + ["taldia", 30, 1], + ["handia", -1, 1], + ["mendia", -1, 1], + ["geia", -1, 1], + ["egia", -1, 1], + ["degia", 35, 1], + ["tegia", 35, 1], + ["nahia", -1, 1], + ["ohia", -1, 1], + ["kia", -1, 1], + ["tokia", 40, 1], + ["oia", -1, 1], + ["koia", 42, 1], + ["aria", -1, 1], + ["karia", 44, 1], + ["laria", 44, 1], + ["taria", 44, 1], + ["eria", -1, 1], + ["keria", 48, 1], + ["teria", 48, 1], + ["garria", -1, 2], + ["larria", -1, 1], + ["kirria", -1, 1], + ["duria", -1, 1], + ["asia", -1, 1], + ["tia", -1, 1], + ["ezia", -1, 1], + ["bizia", -1, 1], + ["ontzia", -1, 1], + ["ka", -1, 1], + ["joka", 60, 3], + ["aurka", 60, -1], + ["ska", 60, 1], + ["xka", 60, 1], + ["zka", 60, 1], + ["gibela", -1, 1], + ["gela", -1, 1], + ["kaila", -1, 1], + ["skila", -1, 1], + ["tila", -1, 1], + ["ola", -1, 1], + ["na", -1, 1], + ["kana", 72, 1], + ["ena", 72, 1], + ["garrena", 74, 1], + ["gerrena", 74, 1], + ["urrena", 74, 1], + ["zaina", 72, 1], + ["tzaina", 78, 1], + ["kina", 72, 1], + ["mina", 72, 1], + ["garna", 72, 1], + ["una", 72, 1], + ["duna", 83, 1], + ["asuna", 83, 1], + ["tasuna", 85, 1], + ["ondoa", -1, 1], + ["kondoa", 87, 1], + ["ngoa", -1, 1], + ["zioa", -1, 1], + ["koa", -1, 1], + ["takoa", 91, 1], + ["zkoa", 91, 1], + ["noa", -1, 1], + ["zinoa", 94, 1], + ["aroa", -1, 1], + ["taroa", 96, 1], + ["zaroa", 96, 1], + ["eroa", -1, 1], + ["oroa", -1, 1], + ["osoa", -1, 1], + ["toa", -1, 1], + ["ttoa", 102, 1], + ["ztoa", 102, 1], + ["txoa", -1, 1], + ["tzoa", -1, 1], + ["\u00F1oa", -1, 1], + ["ra", -1, 1], + ["ara", 108, 1], + ["dara", 109, 1], + ["liara", 109, 1], + ["tiara", 109, 1], + ["tara", 109, 1], + ["etara", 113, 1], + ["tzara", 109, 1], + ["bera", 108, 1], + ["kera", 108, 1], + ["pera", 108, 1], + ["ora", 108, 2], + ["tzarra", 108, 1], + ["korra", 108, 1], + ["tra", 108, 1], + ["sa", -1, 1], + ["osa", 123, 1], + ["ta", -1, 1], + ["eta", 125, 1], + ["keta", 126, 1], + ["sta", 125, 1], + ["dua", -1, 1], + ["mendua", 129, 1], + ["ordua", 129, 1], + ["lekua", -1, 1], + ["burua", -1, 1], + ["durua", -1, 1], + ["tsua", -1, 1], + ["tua", -1, 1], + ["mentua", 136, 1], + ["estua", 136, 1], + ["txua", -1, 1], + ["zua", -1, 1], + ["tzua", 140, 1], + ["za", -1, 1], + ["eza", 142, 1], + ["eroza", 142, 1], + ["tza", 142, 2], + ["koitza", 145, 1], + ["antza", 145, 1], + ["gintza", 145, 1], + ["kintza", 145, 1], + ["kuntza", 145, 1], + ["gabe", -1, 1], + ["kabe", -1, 1], + ["kide", -1, 1], + ["alde", -1, 1], + ["kalde", 154, 1], + ["talde", 154, 1], + ["orde", -1, 1], + ["ge", -1, 1], + ["zale", -1, 1], + ["tzale", 159, 1], + ["gile", -1, 1], + ["eme", -1, 1], + ["kume", -1, 1], + ["ne", -1, 1], + ["zione", 164, 1], + ["une", 164, 1], + ["gune", 166, 1], + ["pe", -1, 1], + ["aurre", -1, 1], + ["te", -1, 1], + ["kote", 170, 1], + ["arte", 170, 1], + ["oste", 170, 1], + ["etxe", -1, 1], + ["gai", -1, 1], + ["di", -1, 1], + ["aldi", 176, 1], + ["taldi", 177, 1], + ["geldi", 176, -1], + ["handi", 176, 1], + ["mendi", 176, 1], + ["gei", -1, 1], + ["egi", -1, 1], + ["degi", 183, 1], + ["tegi", 183, 1], + ["nahi", -1, 1], + ["ohi", -1, 1], + ["ki", -1, 1], + ["toki", 188, 1], + ["oi", -1, 1], + ["goi", 190, 1], + ["koi", 190, 1], + ["ari", -1, 1], + ["kari", 193, 1], + ["lari", 193, 1], + ["tari", 193, 1], + ["garri", -1, 2], + ["larri", -1, 1], + ["kirri", -1, 1], + ["duri", -1, 1], + ["asi", -1, 1], + ["ti", -1, 1], + ["ontzi", -1, 1], + ["\u00F1i", -1, 1], + ["ak", -1, 1], + ["ek", -1, 1], + ["tarik", -1, 1], + ["gibel", -1, 1], + ["ail", -1, 1], + ["kail", 209, 1], + ["kan", -1, 1], + ["tan", -1, 1], + ["etan", 212, 1], + ["en", -1, 4], + ["ren", 214, 2], + ["garren", 215, 1], + ["gerren", 215, 1], + ["urren", 215, 1], + ["ten", 214, 4], + ["tzen", 214, 4], + ["zain", -1, 1], + ["tzain", 221, 1], + ["kin", -1, 1], + ["min", -1, 1], + ["dun", -1, 1], + ["asun", -1, 1], + ["tasun", 226, 1], + ["aizun", -1, 1], + ["ondo", -1, 1], + ["kondo", 229, 1], + ["go", -1, 1], + ["ngo", 231, 1], + ["zio", -1, 1], + ["ko", -1, 1], + ["trako", 234, 5], + ["tako", 234, 1], + ["etako", 236, 1], + ["eko", 234, 1], + ["tariko", 234, 1], + ["sko", 234, 1], + ["tuko", 234, 1], + ["minutuko", 241, 6], + ["zko", 234, 1], + ["no", -1, 1], + ["zino", 244, 1], + ["ro", -1, 1], + ["aro", 246, 1], + ["igaro", 247, -1], + ["taro", 247, 1], + ["zaro", 247, 1], + ["ero", 246, 1], + ["giro", 246, 1], + ["oro", 246, 1], + ["oso", -1, 1], + ["to", -1, 1], + ["tto", 255, 1], + ["zto", 255, 1], + ["txo", -1, 1], + ["tzo", -1, 1], + ["gintzo", 259, 1], + ["\u00F1o", -1, 1], + ["zp", -1, 1], + ["ar", -1, 1], + ["dar", 263, 1], + ["behar", 263, 1], + ["zehar", 263, -1], + ["liar", 263, 1], + ["tiar", 263, 1], + ["tar", 263, 1], + ["tzar", 263, 1], + ["or", -1, 2], + ["kor", 271, 1], + ["os", -1, 1], + ["ket", -1, 1], + ["du", -1, 1], + ["mendu", 275, 1], + ["ordu", 275, 1], + ["leku", -1, 1], + ["buru", -1, 2], + ["duru", -1, 1], + ["tsu", -1, 1], + ["tu", -1, 1], + ["tatu", 282, 4], + ["mentu", 282, 1], + ["estu", 282, 1], + ["txu", -1, 1], + ["zu", -1, 1], + ["tzu", 287, 1], + ["gintzu", 288, 1], + ["z", -1, 1], + ["ez", 290, 1], + ["eroz", 290, 1], + ["tz", 290, 1], + ["koitz", 293, 1] + ]; + + /** @const */ var a_2 = [ + ["zlea", -1, 2], + ["keria", -1, 1], + ["la", -1, 1], + ["era", -1, 1], + ["dade", -1, 1], + ["tade", -1, 1], + ["date", -1, 1], + ["tate", -1, 1], + ["gi", -1, 1], + ["ki", -1, 1], + ["ik", -1, 1], + ["lanik", 10, 1], + ["rik", 10, 1], + ["larik", 12, 1], + ["ztik", 10, 1], + ["go", -1, 1], + ["ro", -1, 1], + ["ero", 16, 1], + ["to", -1, 1] + ]; + + /** @const */ var /** Array */ g_v = [17, 65, 16]; + + var /** number */ I_p2 = 0; + var /** number */ I_p1 = 0; + var /** number */ I_pV = 0; + + + /** @return {boolean} */ + function r_mark_regions() { + I_pV = base.limit; + I_p1 = base.limit; + I_p2 = base.limit; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + lab1: { + /** @const */ var /** number */ v_2 = base.cursor; + lab2: { + if (!(base.in_grouping(g_v, 97, 117))) + { + break lab2; + } + lab3: { + /** @const */ var /** number */ v_3 = base.cursor; + lab4: { + if (!(base.out_grouping(g_v, 97, 117))) + { + break lab4; + } + if (!base.go_out_grouping(g_v, 97, 117)) + { + break lab4; + } + base.cursor++; + break lab3; + } + base.cursor = v_3; + if (!(base.in_grouping(g_v, 97, 117))) + { + break lab2; + } + if (!base.go_in_grouping(g_v, 97, 117)) + { + break lab2; + } + base.cursor++; + } + break lab1; + } + base.cursor = v_2; + if (!(base.out_grouping(g_v, 97, 117))) + { + break lab0; + } + lab5: { + /** @const */ var /** number */ v_4 = base.cursor; + lab6: { + if (!(base.out_grouping(g_v, 97, 117))) + { + break lab6; + } + if (!base.go_out_grouping(g_v, 97, 117)) + { + break lab6; + } + base.cursor++; + break lab5; + } + base.cursor = v_4; + if (!(base.in_grouping(g_v, 97, 117))) + { + break lab0; + } + if (base.cursor >= base.limit) + { + break lab0; + } + base.cursor++; + } + } + I_pV = base.cursor; + } + base.cursor = v_1; + /** @const */ var /** number */ v_5 = base.cursor; + lab7: { + if (!base.go_out_grouping(g_v, 97, 117)) + { + break lab7; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 117)) + { + break lab7; + } + base.cursor++; + I_p1 = base.cursor; + if (!base.go_out_grouping(g_v, 97, 117)) + { + break lab7; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 117)) + { + break lab7; + } + base.cursor++; + I_p2 = base.cursor; + } + base.cursor = v_5; + return true; + }; + + /** @return {boolean} */ + function r_RV() { + return I_pV <= base.cursor; + }; + + /** @return {boolean} */ + function r_R2() { + return I_p2 <= base.cursor; + }; + + /** @return {boolean} */ + function r_R1() { + return I_p1 <= base.cursor; + }; + + /** @return {boolean} */ + function r_aditzak() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_0); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_RV()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!r_R2()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_izenak() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_1); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_RV()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!r_R2()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 3: + if (!base.slice_from("jok")) + { + return false; + } + break; + case 4: + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 5: + if (!base.slice_from("tra")) + { + return false; + } + break; + case 6: + if (!base.slice_from("minutu")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_adjetiboak() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_2); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_RV()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!base.slice_from("z")) + { + return false; + } + break; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + r_mark_regions(); + base.limit_backward = base.cursor; base.cursor = base.limit; + while(true) + { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (!r_aditzak()) + { + break lab0; + } + continue; + } + base.cursor = base.limit - v_1; + break; + } + while(true) + { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + if (!r_izenak()) + { + break lab1; + } + continue; + } + base.cursor = base.limit - v_2; + break; + } + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + r_adjetiboak(); + base.cursor = base.limit - v_3; + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/catalan-stemmer.js b/sphinx/search/non-minified-js/catalan-stemmer.js new file mode 100644 index 00000000000..441e655adda --- /dev/null +++ b/sphinx/search/non-minified-js/catalan-stemmer.js @@ -0,0 +1,886 @@ +// Generated from catalan.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var CatalanStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["", -1, 7], + ["\u00B7", 0, 6], + ["\u00E0", 0, 1], + ["\u00E1", 0, 1], + ["\u00E8", 0, 2], + ["\u00E9", 0, 2], + ["\u00EC", 0, 3], + ["\u00ED", 0, 3], + ["\u00EF", 0, 3], + ["\u00F2", 0, 4], + ["\u00F3", 0, 4], + ["\u00FA", 0, 5], + ["\u00FC", 0, 5] + ]; + + /** @const */ var a_1 = [ + ["la", -1, 1], + ["-la", 0, 1], + ["sela", 0, 1], + ["le", -1, 1], + ["me", -1, 1], + ["-me", 4, 1], + ["se", -1, 1], + ["-te", -1, 1], + ["hi", -1, 1], + ["'hi", 8, 1], + ["li", -1, 1], + ["-li", 10, 1], + ["'l", -1, 1], + ["'m", -1, 1], + ["-m", -1, 1], + ["'n", -1, 1], + ["-n", -1, 1], + ["ho", -1, 1], + ["'ho", 17, 1], + ["lo", -1, 1], + ["selo", 19, 1], + ["'s", -1, 1], + ["las", -1, 1], + ["selas", 22, 1], + ["les", -1, 1], + ["-les", 24, 1], + ["'ls", -1, 1], + ["-ls", -1, 1], + ["'ns", -1, 1], + ["-ns", -1, 1], + ["ens", -1, 1], + ["los", -1, 1], + ["selos", 31, 1], + ["nos", -1, 1], + ["-nos", 33, 1], + ["vos", -1, 1], + ["us", -1, 1], + ["-us", 36, 1], + ["'t", -1, 1] + ]; + + /** @const */ var a_2 = [ + ["ica", -1, 4], + ["l\u00F3gica", 0, 3], + ["enca", -1, 1], + ["ada", -1, 2], + ["ancia", -1, 1], + ["encia", -1, 1], + ["\u00E8ncia", -1, 1], + ["\u00EDcia", -1, 1], + ["logia", -1, 3], + ["inia", -1, 1], + ["\u00EDinia", 9, 1], + ["eria", -1, 1], + ["\u00E0ria", -1, 1], + ["at\u00F2ria", -1, 1], + ["alla", -1, 1], + ["ella", -1, 1], + ["\u00EDvola", -1, 1], + ["ima", -1, 1], + ["\u00EDssima", 17, 1], + ["qu\u00EDssima", 18, 5], + ["ana", -1, 1], + ["ina", -1, 1], + ["era", -1, 1], + ["sfera", 22, 1], + ["ora", -1, 1], + ["dora", 24, 1], + ["adora", 25, 1], + ["adura", -1, 1], + ["esa", -1, 1], + ["osa", -1, 1], + ["assa", -1, 1], + ["essa", -1, 1], + ["issa", -1, 1], + ["eta", -1, 1], + ["ita", -1, 1], + ["ota", -1, 1], + ["ista", -1, 1], + ["ialista", 36, 1], + ["ionista", 36, 1], + ["iva", -1, 1], + ["ativa", 39, 1], + ["n\u00E7a", -1, 1], + ["log\u00EDa", -1, 3], + ["ic", -1, 4], + ["\u00EDstic", 43, 1], + ["enc", -1, 1], + ["esc", -1, 1], + ["ud", -1, 1], + ["atge", -1, 1], + ["ble", -1, 1], + ["able", 49, 1], + ["ible", 49, 1], + ["isme", -1, 1], + ["ialisme", 52, 1], + ["ionisme", 52, 1], + ["ivisme", 52, 1], + ["aire", -1, 1], + ["icte", -1, 1], + ["iste", -1, 1], + ["ici", -1, 1], + ["\u00EDci", -1, 1], + ["logi", -1, 3], + ["ari", -1, 1], + ["tori", -1, 1], + ["al", -1, 1], + ["il", -1, 1], + ["all", -1, 1], + ["ell", -1, 1], + ["\u00EDvol", -1, 1], + ["isam", -1, 1], + ["issem", -1, 1], + ["\u00ECssem", -1, 1], + ["\u00EDssem", -1, 1], + ["\u00EDssim", -1, 1], + ["qu\u00EDssim", 73, 5], + ["amen", -1, 1], + ["\u00ECssin", -1, 1], + ["ar", -1, 1], + ["ificar", 77, 1], + ["egar", 77, 1], + ["ejar", 77, 1], + ["itar", 77, 1], + ["itzar", 77, 1], + ["fer", -1, 1], + ["or", -1, 1], + ["dor", 84, 1], + ["dur", -1, 1], + ["doras", -1, 1], + ["ics", -1, 4], + ["l\u00F3gics", 88, 3], + ["uds", -1, 1], + ["nces", -1, 1], + ["ades", -1, 2], + ["ancies", -1, 1], + ["encies", -1, 1], + ["\u00E8ncies", -1, 1], + ["\u00EDcies", -1, 1], + ["logies", -1, 3], + ["inies", -1, 1], + ["\u00EDnies", -1, 1], + ["eries", -1, 1], + ["\u00E0ries", -1, 1], + ["at\u00F2ries", -1, 1], + ["bles", -1, 1], + ["ables", 103, 1], + ["ibles", 103, 1], + ["imes", -1, 1], + ["\u00EDssimes", 106, 1], + ["qu\u00EDssimes", 107, 5], + ["formes", -1, 1], + ["ismes", -1, 1], + ["ialismes", 110, 1], + ["ines", -1, 1], + ["eres", -1, 1], + ["ores", -1, 1], + ["dores", 114, 1], + ["idores", 115, 1], + ["dures", -1, 1], + ["eses", -1, 1], + ["oses", -1, 1], + ["asses", -1, 1], + ["ictes", -1, 1], + ["ites", -1, 1], + ["otes", -1, 1], + ["istes", -1, 1], + ["ialistes", 124, 1], + ["ionistes", 124, 1], + ["iques", -1, 4], + ["l\u00F3giques", 127, 3], + ["ives", -1, 1], + ["atives", 129, 1], + ["log\u00EDes", -1, 3], + ["alleng\u00FCes", -1, 1], + ["icis", -1, 1], + ["\u00EDcis", -1, 1], + ["logis", -1, 3], + ["aris", -1, 1], + ["toris", -1, 1], + ["ls", -1, 1], + ["als", 138, 1], + ["ells", 138, 1], + ["ims", -1, 1], + ["\u00EDssims", 141, 1], + ["qu\u00EDssims", 142, 5], + ["ions", -1, 1], + ["cions", 144, 1], + ["acions", 145, 2], + ["esos", -1, 1], + ["osos", -1, 1], + ["assos", -1, 1], + ["issos", -1, 1], + ["ers", -1, 1], + ["ors", -1, 1], + ["dors", 152, 1], + ["adors", 153, 1], + ["idors", 153, 1], + ["ats", -1, 1], + ["itats", 156, 1], + ["bilitats", 157, 1], + ["ivitats", 157, 1], + ["ativitats", 159, 1], + ["\u00EFtats", 156, 1], + ["ets", -1, 1], + ["ants", -1, 1], + ["ents", -1, 1], + ["ments", 164, 1], + ["aments", 165, 1], + ["ots", -1, 1], + ["uts", -1, 1], + ["ius", -1, 1], + ["trius", 169, 1], + ["atius", 169, 1], + ["\u00E8s", -1, 1], + ["\u00E9s", -1, 1], + ["\u00EDs", -1, 1], + ["d\u00EDs", 174, 1], + ["\u00F3s", -1, 1], + ["itat", -1, 1], + ["bilitat", 177, 1], + ["ivitat", 177, 1], + ["ativitat", 179, 1], + ["\u00EFtat", -1, 1], + ["et", -1, 1], + ["ant", -1, 1], + ["ent", -1, 1], + ["ient", 184, 1], + ["ment", 184, 1], + ["ament", 186, 1], + ["isament", 187, 1], + ["ot", -1, 1], + ["isseu", -1, 1], + ["\u00ECsseu", -1, 1], + ["\u00EDsseu", -1, 1], + ["triu", -1, 1], + ["\u00EDssiu", -1, 1], + ["atiu", -1, 1], + ["\u00F3", -1, 1], + ["i\u00F3", 196, 1], + ["ci\u00F3", 197, 1], + ["aci\u00F3", 198, 1] + ]; + + /** @const */ var a_3 = [ + ["aba", -1, 1], + ["esca", -1, 1], + ["isca", -1, 1], + ["\u00EFsca", -1, 1], + ["ada", -1, 1], + ["ida", -1, 1], + ["uda", -1, 1], + ["\u00EFda", -1, 1], + ["ia", -1, 1], + ["aria", 8, 1], + ["iria", 8, 1], + ["ara", -1, 1], + ["iera", -1, 1], + ["ira", -1, 1], + ["adora", -1, 1], + ["\u00EFra", -1, 1], + ["ava", -1, 1], + ["ixa", -1, 1], + ["itza", -1, 1], + ["\u00EDa", -1, 1], + ["ar\u00EDa", 19, 1], + ["er\u00EDa", 19, 1], + ["ir\u00EDa", 19, 1], + ["\u00EFa", -1, 1], + ["isc", -1, 1], + ["\u00EFsc", -1, 1], + ["ad", -1, 1], + ["ed", -1, 1], + ["id", -1, 1], + ["ie", -1, 1], + ["re", -1, 1], + ["dre", 30, 1], + ["ase", -1, 1], + ["iese", -1, 1], + ["aste", -1, 1], + ["iste", -1, 1], + ["ii", -1, 1], + ["ini", -1, 1], + ["esqui", -1, 1], + ["eixi", -1, 1], + ["itzi", -1, 1], + ["am", -1, 1], + ["em", -1, 1], + ["arem", 42, 1], + ["irem", 42, 1], + ["\u00E0rem", 42, 1], + ["\u00EDrem", 42, 1], + ["\u00E0ssem", 42, 1], + ["\u00E9ssem", 42, 1], + ["iguem", 42, 1], + ["\u00EFguem", 42, 1], + ["avem", 42, 1], + ["\u00E0vem", 42, 1], + ["\u00E1vem", 42, 1], + ["ir\u00ECem", 42, 1], + ["\u00EDem", 42, 1], + ["ar\u00EDem", 55, 1], + ["ir\u00EDem", 55, 1], + ["assim", -1, 1], + ["essim", -1, 1], + ["issim", -1, 1], + ["\u00E0ssim", -1, 1], + ["\u00E8ssim", -1, 1], + ["\u00E9ssim", -1, 1], + ["\u00EDssim", -1, 1], + ["\u00EFm", -1, 1], + ["an", -1, 1], + ["aban", 66, 1], + ["arian", 66, 1], + ["aran", 66, 1], + ["ieran", 66, 1], + ["iran", 66, 1], + ["\u00EDan", 66, 1], + ["ar\u00EDan", 72, 1], + ["er\u00EDan", 72, 1], + ["ir\u00EDan", 72, 1], + ["en", -1, 1], + ["ien", 76, 1], + ["arien", 77, 1], + ["irien", 77, 1], + ["aren", 76, 1], + ["eren", 76, 1], + ["iren", 76, 1], + ["\u00E0ren", 76, 1], + ["\u00EFren", 76, 1], + ["asen", 76, 1], + ["iesen", 76, 1], + ["assen", 76, 1], + ["essen", 76, 1], + ["issen", 76, 1], + ["\u00E9ssen", 76, 1], + ["\u00EFssen", 76, 1], + ["esquen", 76, 1], + ["isquen", 76, 1], + ["\u00EFsquen", 76, 1], + ["aven", 76, 1], + ["ixen", 76, 1], + ["eixen", 96, 1], + ["\u00EFxen", 76, 1], + ["\u00EFen", 76, 1], + ["in", -1, 1], + ["inin", 100, 1], + ["sin", 100, 1], + ["isin", 102, 1], + ["assin", 102, 1], + ["essin", 102, 1], + ["issin", 102, 1], + ["\u00EFssin", 102, 1], + ["esquin", 100, 1], + ["eixin", 100, 1], + ["aron", -1, 1], + ["ieron", -1, 1], + ["ar\u00E1n", -1, 1], + ["er\u00E1n", -1, 1], + ["ir\u00E1n", -1, 1], + ["i\u00EFn", -1, 1], + ["ado", -1, 1], + ["ido", -1, 1], + ["ando", -1, 2], + ["iendo", -1, 1], + ["io", -1, 1], + ["ixo", -1, 1], + ["eixo", 121, 1], + ["\u00EFxo", -1, 1], + ["itzo", -1, 1], + ["ar", -1, 1], + ["tzar", 125, 1], + ["er", -1, 1], + ["eixer", 127, 1], + ["ir", -1, 1], + ["ador", -1, 1], + ["as", -1, 1], + ["abas", 131, 1], + ["adas", 131, 1], + ["idas", 131, 1], + ["aras", 131, 1], + ["ieras", 131, 1], + ["\u00EDas", 131, 1], + ["ar\u00EDas", 137, 1], + ["er\u00EDas", 137, 1], + ["ir\u00EDas", 137, 1], + ["ids", -1, 1], + ["es", -1, 1], + ["ades", 142, 1], + ["ides", 142, 1], + ["udes", 142, 1], + ["\u00EFdes", 142, 1], + ["atges", 142, 1], + ["ies", 142, 1], + ["aries", 148, 1], + ["iries", 148, 1], + ["ares", 142, 1], + ["ires", 142, 1], + ["adores", 142, 1], + ["\u00EFres", 142, 1], + ["ases", 142, 1], + ["ieses", 142, 1], + ["asses", 142, 1], + ["esses", 142, 1], + ["isses", 142, 1], + ["\u00EFsses", 142, 1], + ["ques", 142, 1], + ["esques", 161, 1], + ["\u00EFsques", 161, 1], + ["aves", 142, 1], + ["ixes", 142, 1], + ["eixes", 165, 1], + ["\u00EFxes", 142, 1], + ["\u00EFes", 142, 1], + ["abais", -1, 1], + ["arais", -1, 1], + ["ierais", -1, 1], + ["\u00EDais", -1, 1], + ["ar\u00EDais", 172, 1], + ["er\u00EDais", 172, 1], + ["ir\u00EDais", 172, 1], + ["aseis", -1, 1], + ["ieseis", -1, 1], + ["asteis", -1, 1], + ["isteis", -1, 1], + ["inis", -1, 1], + ["sis", -1, 1], + ["isis", 181, 1], + ["assis", 181, 1], + ["essis", 181, 1], + ["issis", 181, 1], + ["\u00EFssis", 181, 1], + ["esquis", -1, 1], + ["eixis", -1, 1], + ["itzis", -1, 1], + ["\u00E1is", -1, 1], + ["ar\u00E9is", -1, 1], + ["er\u00E9is", -1, 1], + ["ir\u00E9is", -1, 1], + ["ams", -1, 1], + ["ados", -1, 1], + ["idos", -1, 1], + ["amos", -1, 1], + ["\u00E1bamos", 197, 1], + ["\u00E1ramos", 197, 1], + ["i\u00E9ramos", 197, 1], + ["\u00EDamos", 197, 1], + ["ar\u00EDamos", 201, 1], + ["er\u00EDamos", 201, 1], + ["ir\u00EDamos", 201, 1], + ["aremos", -1, 1], + ["eremos", -1, 1], + ["iremos", -1, 1], + ["\u00E1semos", -1, 1], + ["i\u00E9semos", -1, 1], + ["imos", -1, 1], + ["adors", -1, 1], + ["ass", -1, 1], + ["erass", 212, 1], + ["ess", -1, 1], + ["ats", -1, 1], + ["its", -1, 1], + ["ents", -1, 1], + ["\u00E0s", -1, 1], + ["ar\u00E0s", 218, 1], + ["ir\u00E0s", 218, 1], + ["ar\u00E1s", -1, 1], + ["er\u00E1s", -1, 1], + ["ir\u00E1s", -1, 1], + ["\u00E9s", -1, 1], + ["ar\u00E9s", 224, 1], + ["\u00EDs", -1, 1], + ["i\u00EFs", -1, 1], + ["at", -1, 1], + ["it", -1, 1], + ["ant", -1, 1], + ["ent", -1, 1], + ["int", -1, 1], + ["ut", -1, 1], + ["\u00EFt", -1, 1], + ["au", -1, 1], + ["erau", 235, 1], + ["ieu", -1, 1], + ["ineu", -1, 1], + ["areu", -1, 1], + ["ireu", -1, 1], + ["\u00E0reu", -1, 1], + ["\u00EDreu", -1, 1], + ["asseu", -1, 1], + ["esseu", -1, 1], + ["eresseu", 244, 1], + ["\u00E0sseu", -1, 1], + ["\u00E9sseu", -1, 1], + ["igueu", -1, 1], + ["\u00EFgueu", -1, 1], + ["\u00E0veu", -1, 1], + ["\u00E1veu", -1, 1], + ["itzeu", -1, 1], + ["\u00ECeu", -1, 1], + ["ir\u00ECeu", 253, 1], + ["\u00EDeu", -1, 1], + ["ar\u00EDeu", 255, 1], + ["ir\u00EDeu", 255, 1], + ["assiu", -1, 1], + ["issiu", -1, 1], + ["\u00E0ssiu", -1, 1], + ["\u00E8ssiu", -1, 1], + ["\u00E9ssiu", -1, 1], + ["\u00EDssiu", -1, 1], + ["\u00EFu", -1, 1], + ["ix", -1, 1], + ["eix", 265, 1], + ["\u00EFx", -1, 1], + ["itz", -1, 1], + ["i\u00E0", -1, 1], + ["ar\u00E0", -1, 1], + ["ir\u00E0", -1, 1], + ["itz\u00E0", -1, 1], + ["ar\u00E1", -1, 1], + ["er\u00E1", -1, 1], + ["ir\u00E1", -1, 1], + ["ir\u00E8", -1, 1], + ["ar\u00E9", -1, 1], + ["er\u00E9", -1, 1], + ["ir\u00E9", -1, 1], + ["\u00ED", -1, 1], + ["i\u00EF", -1, 1], + ["i\u00F3", -1, 1] + ]; + + /** @const */ var a_4 = [ + ["a", -1, 1], + ["e", -1, 1], + ["i", -1, 1], + ["\u00EFn", -1, 1], + ["o", -1, 1], + ["ir", -1, 1], + ["s", -1, 1], + ["is", 6, 1], + ["os", 6, 1], + ["\u00EFs", 6, 1], + ["it", -1, 1], + ["eu", -1, 1], + ["iu", -1, 1], + ["iqu", -1, 2], + ["itz", -1, 1], + ["\u00E0", -1, 1], + ["\u00E1", -1, 1], + ["\u00E9", -1, 1], + ["\u00EC", -1, 1], + ["\u00ED", -1, 1], + ["\u00EF", -1, 1], + ["\u00F3", -1, 1] + ]; + + /** @const */ var /** Array */ g_v = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 129, 81, 6, 10]; + + var /** number */ I_p2 = 0; + var /** number */ I_p1 = 0; + + + /** @return {boolean} */ + function r_mark_regions() { + I_p1 = base.limit; + I_p2 = base.limit; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + if (!base.go_out_grouping(g_v, 97, 252)) + { + break lab0; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 252)) + { + break lab0; + } + base.cursor++; + I_p1 = base.cursor; + if (!base.go_out_grouping(g_v, 97, 252)) + { + break lab0; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 252)) + { + break lab0; + } + base.cursor++; + I_p2 = base.cursor; + } + base.cursor = v_1; + return true; + }; + + /** @return {boolean} */ + function r_cleaning() { + var /** number */ among_var; + while(true) + { + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + base.bra = base.cursor; + among_var = base.find_among(a_0); + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("a")) + { + return false; + } + break; + case 2: + if (!base.slice_from("e")) + { + return false; + } + break; + case 3: + if (!base.slice_from("i")) + { + return false; + } + break; + case 4: + if (!base.slice_from("o")) + { + return false; + } + break; + case 5: + if (!base.slice_from("u")) + { + return false; + } + break; + case 6: + if (!base.slice_from(".")) + { + return false; + } + break; + case 7: + if (base.cursor >= base.limit) + { + break lab0; + } + base.cursor++; + break; + } + continue; + } + base.cursor = v_1; + break; + } + return true; + }; + + /** @return {boolean} */ + function r_R1() { + return I_p1 <= base.cursor; + }; + + /** @return {boolean} */ + function r_R2() { + return I_p2 <= base.cursor; + }; + + /** @return {boolean} */ + function r_attached_pronoun() { + base.ket = base.cursor; + if (base.find_among_b(a_1) == 0) + { + return false; + } + base.bra = base.cursor; + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_standard_suffix() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_2); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!r_R2()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 3: + if (!r_R2()) + { + return false; + } + if (!base.slice_from("log")) + { + return false; + } + break; + case 4: + if (!r_R2()) + { + return false; + } + if (!base.slice_from("ic")) + { + return false; + } + break; + case 5: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("c")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_verb_suffix() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_3); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!r_R2()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_residual_suffix() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_4); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("ic")) + { + return false; + } + break; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + r_mark_regions(); + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + r_attached_pronoun(); + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab0: { + lab1: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab2: { + if (!r_standard_suffix()) + { + break lab2; + } + break lab1; + } + base.cursor = base.limit - v_3; + if (!r_verb_suffix()) + { + break lab0; + } + } + } + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + r_residual_suffix(); + base.cursor = base.limit - v_4; + base.cursor = base.limit_backward; + /** @const */ var /** number */ v_5 = base.cursor; + r_cleaning(); + base.cursor = v_5; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/danish-stemmer.js b/sphinx/search/non-minified-js/danish-stemmer.js index 46b5d55b0e1..b0867495bbf 100644 --- a/sphinx/search/non-minified-js/danish-stemmer.js +++ b/sphinx/search/non-minified-js/danish-stemmer.js @@ -1,8 +1,9 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from danish.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -DanishStemmer = function() { +var DanishStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ ["hed", -1, 1], ["ethed", 0, 1], @@ -67,9 +68,9 @@ DanishStemmer = function() { /** @return {boolean} */ function r_mark_regions() { I_p1 = base.limit; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; { - var /** number */ c1 = base.cursor + 3; + /** @const */ var /** number */ c1 = base.cursor + 3; if (c1 > base.limit) { return false; @@ -78,44 +79,21 @@ DanishStemmer = function() { } I_x = base.cursor; base.cursor = v_1; - golab0: while(true) + if (!base.go_out_grouping(g_v, 97, 248)) { - var /** number */ v_2 = base.cursor; - lab1: { - if (!(base.in_grouping(g_v, 97, 248))) - { - break lab1; - } - base.cursor = v_2; - break golab0; - } - base.cursor = v_2; - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } - golab2: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 248)) { - lab3: { - if (!(base.out_grouping(g_v, 97, 248))) - { - break lab3; - } - break golab2; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } + base.cursor++; I_p1 = base.cursor; - lab4: { - if (!(I_p1 < I_x)) + lab0: { + if (I_p1 >= I_x) { - break lab4; + break lab0; } I_p1 = I_x; } @@ -129,17 +107,17 @@ DanishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_0); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; switch (among_var) { case 1: if (!base.slice_del()) @@ -163,21 +141,21 @@ DanishStemmer = function() { /** @return {boolean} */ function r_consonant_pair() { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; if (base.cursor < I_p1) { return false; } - var /** number */ v_3 = base.limit_backward; + /** @const */ var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; if (base.find_among_b(a_1) == 0) { - base.limit_backward = v_3; + base.limit_backward = v_2; return false; } base.bra = base.cursor; - base.limit_backward = v_3; + base.limit_backward = v_2; base.cursor = base.limit - v_1; if (base.cursor <= base.limit_backward) { @@ -195,7 +173,7 @@ DanishStemmer = function() { /** @return {boolean} */ function r_other_suffix() { var /** number */ among_var; - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("st"))) @@ -217,26 +195,26 @@ DanishStemmer = function() { { return false; } - var /** number */ v_3 = base.limit_backward; + /** @const */ var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_2); if (among_var == 0) { - base.limit_backward = v_3; + base.limit_backward = v_2; return false; } base.bra = base.cursor; - base.limit_backward = v_3; + base.limit_backward = v_2; switch (among_var) { case 1: if (!base.slice_del()) { return false; } - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; r_consonant_pair(); - base.cursor = base.limit - v_4; + base.cursor = base.limit - v_3; break; case 2: if (!base.slice_from("l\u00F8s")) @@ -254,12 +232,12 @@ DanishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; if (!(base.in_grouping_b(g_c, 98, 122))) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; @@ -268,7 +246,7 @@ DanishStemmer = function() { { return false; } - base.limit_backward = v_2; + base.limit_backward = v_1; if (!(base.eq_s_b(S_ch))) { return false; @@ -281,20 +259,20 @@ DanishStemmer = function() { }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; r_mark_regions(); base.cursor = v_1; base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; r_main_suffix(); base.cursor = base.limit - v_2; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; r_consonant_pair(); base.cursor = base.limit - v_3; - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; r_other_suffix(); base.cursor = base.limit - v_4; - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; r_undouble(); base.cursor = base.limit - v_5; base.cursor = base.limit_backward; diff --git a/sphinx/search/non-minified-js/dutch-stemmer.js b/sphinx/search/non-minified-js/dutch-stemmer.js index 0ad11e212cc..50e53e7b510 100644 --- a/sphinx/search/non-minified-js/dutch-stemmer.js +++ b/sphinx/search/non-minified-js/dutch-stemmer.js @@ -1,678 +1,1960 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from dutch.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -DutchStemmer = function() { +var DutchStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ - ["", -1, 6], - ["\u00E1", 0, 1], - ["\u00E4", 0, 1], - ["\u00E9", 0, 2], - ["\u00EB", 0, 2], - ["\u00ED", 0, 3], - ["\u00EF", 0, 3], - ["\u00F3", 0, 4], - ["\u00F6", 0, 4], - ["\u00FA", 0, 5], - ["\u00FC", 0, 5] + ["a", -1, 1], + ["e", -1, 2], + ["o", -1, 1], + ["u", -1, 1], + ["\u00E0", -1, 1], + ["\u00E1", -1, 1], + ["\u00E2", -1, 1], + ["\u00E4", -1, 1], + ["\u00E8", -1, 2], + ["\u00E9", -1, 2], + ["\u00EA", -1, 2], + ["e\u00EB", -1, 3], + ["i\u00EB", -1, 4], + ["\u00F2", -1, 1], + ["\u00F3", -1, 1], + ["\u00F4", -1, 1], + ["\u00F6", -1, 1], + ["\u00F9", -1, 1], + ["\u00FA", -1, 1], + ["\u00FB", -1, 1], + ["\u00FC", -1, 1] ]; /** @const */ var a_1 = [ - ["", -1, 3], - ["I", 0, 2], - ["Y", 0, 1] + ["nde", -1, 8], + ["en", -1, 7], + ["s", -1, 2], + ["'s", 2, 1], + ["es", 2, 4], + ["ies", 4, 3], + ["aus", 2, 6], + ["\u00E9s", 2, 5] ]; /** @const */ var a_2 = [ - ["dd", -1, -1], - ["kk", -1, -1], - ["tt", -1, -1] + ["de", -1, 5], + ["ge", -1, 2], + ["ische", -1, 4], + ["je", -1, 1], + ["lijke", -1, 3], + ["le", -1, 9], + ["ene", -1, 10], + ["re", -1, 8], + ["se", -1, 7], + ["te", -1, 6], + ["ieve", -1, 11] ]; /** @const */ var a_3 = [ - ["ene", -1, 2], - ["se", -1, 3], - ["en", -1, 2], - ["heden", 2, 1], - ["s", -1, 3] + ["heid", -1, 3], + ["fie", -1, 7], + ["gie", -1, 8], + ["atie", -1, 1], + ["isme", -1, 5], + ["ing", -1, 5], + ["arij", -1, 6], + ["erij", -1, 5], + ["sel", -1, 3], + ["rder", -1, 4], + ["ster", -1, 3], + ["iteit", -1, 2], + ["dst", -1, 10], + ["tst", -1, 9] ]; /** @const */ var a_4 = [ - ["end", -1, 1], - ["ig", -1, 2], - ["ing", -1, 1], - ["lijk", -1, 3], - ["baar", -1, 4], - ["bar", -1, 5] + ["end", -1, 9], + ["atief", -1, 2], + ["erig", -1, 9], + ["achtig", -1, 3], + ["ioneel", -1, 1], + ["baar", -1, 3], + ["laar", -1, 5], + ["naar", -1, 4], + ["raar", -1, 6], + ["eriger", -1, 9], + ["achtiger", -1, 3], + ["lijker", -1, 8], + ["tant", -1, 7], + ["erigst", -1, 9], + ["achtigst", -1, 3], + ["lijkst", -1, 8] ]; /** @const */ var a_5 = [ - ["aa", -1, -1], - ["ee", -1, -1], - ["oo", -1, -1], - ["uu", -1, -1] + ["ig", -1, 1], + ["iger", -1, 1], + ["igst", -1, 1] + ]; + + /** @const */ var a_6 = [ + ["ft", -1, 2], + ["kt", -1, 1], + ["pt", -1, 3] + ]; + + /** @const */ var a_7 = [ + ["bb", -1, 1], + ["cc", -1, 2], + ["dd", -1, 3], + ["ff", -1, 4], + ["gg", -1, 5], + ["hh", -1, 6], + ["jj", -1, 7], + ["kk", -1, 8], + ["ll", -1, 9], + ["mm", -1, 10], + ["nn", -1, 11], + ["pp", -1, 12], + ["qq", -1, 13], + ["rr", -1, 14], + ["ss", -1, 15], + ["tt", -1, 16], + ["v", -1, 4], + ["vv", 16, 17], + ["ww", -1, 18], + ["xx", -1, 19], + ["z", -1, 15], + ["zz", 20, 20] + ]; + + /** @const */ var a_8 = [ + ["d", -1, 1], + ["t", -1, 2] + ]; + + /** @const */ var a_9 = [ + ["", -1, -1], + ["eft", 0, 1], + ["vaa", 0, 1], + ["val", 0, 1], + ["vali", 3, -1], + ["vare", 0, 1] + ]; + + /** @const */ var a_10 = [ + ["\u00EB", -1, 1], + ["\u00EF", -1, 2] + ]; + + /** @const */ var a_11 = [ + ["\u00EB", -1, 1], + ["\u00EF", -1, 2] ]; - /** @const */ var /** Array */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; + /** @const */ var /** Array */ g_E = [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 120]; + + /** @const */ var /** Array */ g_AIOU = [1, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 11, 120, 46, 15]; - /** @const */ var /** Array */ g_v_I = [1, 0, 0, 17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; + /** @const */ var /** Array */ g_AEIOU = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 139, 127, 46, 15]; - /** @const */ var /** Array */ g_v_j = [17, 67, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; + /** @const */ var /** Array */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 139, 127, 46, 15]; + /** @const */ var /** Array */ g_v_WX = [17, 65, 208, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 139, 127, 46, 15]; + + var /** boolean */ B_GE_removed = false; + var /** boolean */ B_stemmed = false; var /** number */ I_p2 = 0; var /** number */ I_p1 = 0; - var /** boolean */ B_e_found = false; + var /** string */ S_ch = ''; /** @return {boolean} */ - function r_prelude() { - var /** number */ among_var; - var /** number */ v_1 = base.cursor; - while(true) + function r_R1() { + return I_p1 <= base.cursor; + }; + + /** @return {boolean} */ + function r_R2() { + return I_p2 <= base.cursor; + }; + + /** @return {boolean} */ + function r_V() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + if (!(base.in_grouping_b(g_v, 97, 252))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_2; + if (!(base.eq_s_b("ij"))) + { + return false; + } + } + base.cursor = base.limit - v_1; + return true; + }; + + /** @return {boolean} */ + function r_VX() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + if (base.cursor <= base.limit_backward) + { + return false; + } + base.cursor--; + lab0: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + if (!(base.in_grouping_b(g_v, 97, 252))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_2; + if (!(base.eq_s_b("ij"))) + { + return false; + } + } + base.cursor = base.limit - v_1; + return true; + }; + + /** @return {boolean} */ + function r_C() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab0: { - base.bra = base.cursor; - among_var = base.find_among(a_0); - if (among_var == 0) + if (!(base.eq_s_b("ij"))) { break lab0; } - base.ket = base.cursor; - switch (among_var) { - case 1: - if (!base.slice_from("a")) - { - return false; - } - break; - case 2: - if (!base.slice_from("e")) - { - return false; - } - break; - case 3: - if (!base.slice_from("i")) - { - return false; - } - break; - case 4: - if (!base.slice_from("o")) - { - return false; - } - break; - case 5: - if (!base.slice_from("u")) - { - return false; - } - break; - case 6: - if (base.cursor >= base.limit) - { - break lab0; - } - base.cursor++; - break; - } - continue; + return false; } - base.cursor = v_2; - break; + base.cursor = base.limit - v_2; } - base.cursor = v_1; - var /** number */ v_3 = base.cursor; - lab1: { - base.bra = base.cursor; - if (!(base.eq_s("y"))) + if (!(base.out_grouping_b(g_v, 97, 252))) + { + return false; + } + base.cursor = base.limit - v_1; + return true; + }; + + /** @return {boolean} */ + function r_lengthen_V() { + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (!(base.out_grouping_b(g_v_WX, 97, 252))) { - base.cursor = v_3; - break lab1; + break lab0; } base.ket = base.cursor; - if (!base.slice_from("Y")) + among_var = base.find_among_b(a_0); + if (among_var == 0) { - return false; + break lab0; } - } - while(true) - { - var /** number */ v_4 = base.cursor; - lab2: { - golab3: while(true) - { - var /** number */ v_5 = base.cursor; - lab4: { - if (!(base.in_grouping(g_v, 97, 232))) + base.bra = base.cursor; + switch (among_var) { + case 1: + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab2: { + if (!(base.out_grouping_b(g_AEIOU, 97, 252))) + { + break lab2; + } + break lab1; + } + base.cursor = base.limit - v_3; + if (base.cursor > base.limit_backward) { - break lab4; + break lab0; } - base.bra = base.cursor; + } + base.cursor = base.limit - v_2; + S_ch = base.slice_to(); + if (S_ch == '') + { + return false; + } + { + /** @const */ var /** number */ c1 = base.cursor; + base.insert(base.cursor, base.cursor, S_ch); + base.cursor = c1; + } + break; + case 2: + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab3: { + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab4: { + if (!(base.out_grouping_b(g_AEIOU, 97, 252))) + { + break lab4; + } + break lab3; + } + base.cursor = base.limit - v_5; + if (base.cursor > base.limit_backward) + { + break lab0; + } + } + { + /** @const */ var /** number */ v_6 = base.limit - base.cursor; lab5: { - var /** number */ v_6 = base.cursor; lab6: { - if (!(base.eq_s("i"))) - { + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab7: { + if (!(base.in_grouping_b(g_AIOU, 97, 252))) + { + break lab7; + } break lab6; } - base.ket = base.cursor; - if (!(base.in_grouping(g_v, 97, 232))) + base.cursor = base.limit - v_7; + if (!(base.in_grouping_b(g_E, 101, 235))) { - break lab6; + break lab5; } - if (!base.slice_from("I")) + if (base.cursor > base.limit_backward) { - return false; + break lab5; } - break lab5; } - base.cursor = v_6; - if (!(base.eq_s("y"))) + break lab0; + } + base.cursor = base.limit - v_6; + } + { + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + lab8: { + if (base.cursor <= base.limit_backward) { - break lab4; + break lab8; + } + base.cursor--; + if (!(base.in_grouping_b(g_AIOU, 97, 252))) + { + break lab8; } - base.ket = base.cursor; - if (!base.slice_from("Y")) + if (!(base.out_grouping_b(g_AEIOU, 97, 252))) { - return false; + break lab8; } + break lab0; } - base.cursor = v_5; - break golab3; + base.cursor = base.limit - v_8; } - base.cursor = v_5; - if (base.cursor >= base.limit) + base.cursor = base.limit - v_4; + S_ch = base.slice_to(); + if (S_ch == '') { - break lab2; + return false; } - base.cursor++; - } - continue; + { + /** @const */ var /** number */ c2 = base.cursor; + base.insert(base.cursor, base.cursor, S_ch); + base.cursor = c2; + } + break; + case 3: + if (!base.slice_from("e\u00EBe")) + { + return false; + } + break; + case 4: + if (!base.slice_from("iee")) + { + return false; + } + break; } - base.cursor = v_4; - break; } + base.cursor = base.limit - v_1; return true; }; /** @return {boolean} */ - function r_mark_regions() { - I_p1 = base.limit; - I_p2 = base.limit; - golab0: while(true) + function r_Step_1() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_1); + if (among_var == 0) { - lab1: { - if (!(base.in_grouping(g_v, 97, 232))) + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_del()) { - break lab1; + return false; } - break golab0; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; - } - golab2: while(true) - { - lab3: { - if (!(base.out_grouping(g_v, 97, 232))) + break; + case 2: + if (!r_R1()) { - break lab3; + return false; } - break golab2; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; - } - I_p1 = base.cursor; - lab4: { - if (!(I_p1 < 3)) - { - break lab4; - } - I_p1 = 3; - } - golab5: while(true) - { - lab6: { - if (!(base.in_grouping(g_v, 97, 232))) { - break lab6; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (!(base.eq_s_b("t"))) + { + break lab0; + } + if (!r_R1()) + { + break lab0; + } + return false; + } + base.cursor = base.limit - v_1; } - break golab5; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; - } - golab7: while(true) - { - lab8: { - if (!(base.out_grouping(g_v, 97, 232))) + if (!r_C()) { - break lab8; + return false; } - break golab7; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; - } - I_p2 = base.cursor; - return true; - }; - - /** @return {boolean} */ - function r_postlude() { - var /** number */ among_var; - while(true) - { - var /** number */ v_1 = base.cursor; - lab0: { - base.bra = base.cursor; - among_var = base.find_among(a_1); - if (among_var == 0) + if (!base.slice_del()) { - break lab0; + return false; + } + break; + case 3: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("ie")) + { + return false; + } + break; + case 4: + lab1: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab2: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + if (!(base.eq_s_b("ar"))) + { + break lab2; + } + if (!r_R1()) + { + break lab2; + } + if (!r_C()) + { + break lab2; + } + base.cursor = base.limit - v_3; + if (!base.slice_del()) + { + return false; + } + r_lengthen_V(); + break lab1; + } + base.cursor = base.limit - v_2; + lab3: { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + if (!(base.eq_s_b("er"))) + { + break lab3; + } + if (!r_R1()) + { + break lab3; + } + if (!r_C()) + { + break lab3; + } + base.cursor = base.limit - v_4; + if (!base.slice_del()) + { + return false; + } + break lab1; + } + base.cursor = base.limit - v_2; + if (!r_R1()) + { + return false; + } + if (!r_C()) + { + return false; + } + if (!base.slice_from("e")) + { + return false; + } + } + break; + case 5: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("\u00E9")) + { + return false; + } + break; + case 6: + if (!r_R1()) + { + return false; + } + if (!r_V()) + { + return false; + } + if (!base.slice_from("au")) + { + return false; + } + break; + case 7: + lab4: { + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab5: { + if (!(base.eq_s_b("hed"))) + { + break lab5; + } + if (!r_R1()) + { + break lab5; + } + base.bra = base.cursor; + if (!base.slice_from("heid")) + { + return false; + } + break lab4; + } + base.cursor = base.limit - v_5; + lab6: { + if (!(base.eq_s_b("nd"))) + { + break lab6; + } + if (!base.slice_del()) + { + return false; + } + break lab4; + } + base.cursor = base.limit - v_5; + lab7: { + if (!(base.eq_s_b("d"))) + { + break lab7; + } + if (!r_R1()) + { + break lab7; + } + if (!r_C()) + { + break lab7; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + break lab4; + } + base.cursor = base.limit - v_5; + lab8: { + lab9: { + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + lab10: { + if (!(base.eq_s_b("i"))) + { + break lab10; + } + break lab9; + } + base.cursor = base.limit - v_6; + if (!(base.eq_s_b("j"))) + { + break lab8; + } + } + if (!r_V()) + { + break lab8; + } + if (!base.slice_del()) + { + return false; + } + break lab4; + } + base.cursor = base.limit - v_5; + if (!r_R1()) + { + return false; + } + if (!r_C()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + r_lengthen_V(); + } + break; + case 8: + if (!base.slice_from("nd")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Step_2() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_2); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("'t"))) + { + break lab1; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab2: { + if (!(base.eq_s_b("et"))) + { + break lab2; + } + base.bra = base.cursor; + if (!r_R1()) + { + break lab2; + } + if (!r_C()) + { + break lab2; + } + if (!base.slice_del()) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab3: { + if (!(base.eq_s_b("rnt"))) + { + break lab3; + } + base.bra = base.cursor; + if (!base.slice_from("rn")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab4: { + if (!(base.eq_s_b("t"))) + { + break lab4; + } + base.bra = base.cursor; + if (!r_R1()) + { + break lab4; + } + if (!r_VX()) + { + break lab4; + } + if (!base.slice_del()) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab5: { + if (!(base.eq_s_b("ink"))) + { + break lab5; + } + base.bra = base.cursor; + if (!base.slice_from("ing")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab6: { + if (!(base.eq_s_b("mp"))) + { + break lab6; + } + base.bra = base.cursor; + if (!base.slice_from("m")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab7: { + if (!(base.eq_s_b("'"))) + { + break lab7; + } + base.bra = base.cursor; + if (!r_R1()) + { + break lab7; + } + if (!base.slice_del()) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + base.bra = base.cursor; + if (!r_R1()) + { + return false; + } + if (!r_C()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + } + break; + case 2: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("g")) + { + return false; + } + break; + case 3: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("lijk")) + { + return false; + } + break; + case 4: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("isch")) + { + return false; + } + break; + case 5: + if (!r_R1()) + { + return false; + } + if (!r_C()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 6: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("t")) + { + return false; + } + break; + case 7: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("s")) + { + return false; + } + break; + case 8: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("r")) + { + return false; + } + break; + case 9: + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + base.insert(base.cursor, base.cursor, "l"); + r_lengthen_V(); + break; + case 10: + if (!r_R1()) + { + return false; + } + if (!r_C()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + base.insert(base.cursor, base.cursor, "en"); + r_lengthen_V(); + break; + case 11: + if (!r_R1()) + { + return false; + } + if (!r_C()) + { + return false; + } + if (!base.slice_from("ief")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Step_3() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_3); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R1()) + { + return false; + } + if (!base.slice_from("eer")) + { + return false; + } + break; + case 2: + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + r_lengthen_V(); + break; + case 3: + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 4: + if (!base.slice_from("r")) + { + return false; + } + break; + case 5: + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("ild"))) + { + break lab1; + } + if (!base.slice_from("er")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + r_lengthen_V(); + } + break; + case 6: + if (!r_R1()) + { + return false; + } + if (!r_C()) + { + return false; + } + if (!base.slice_from("aar")) + { + return false; + } + break; + case 7: + if (!r_R2()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + base.insert(base.cursor, base.cursor, "f"); + r_lengthen_V(); + break; + case 8: + if (!r_R2()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + base.insert(base.cursor, base.cursor, "g"); + r_lengthen_V(); + break; + case 9: + if (!r_R1()) + { + return false; } + if (!r_C()) + { + return false; + } + if (!base.slice_from("t")) + { + return false; + } + break; + case 10: + if (!r_R1()) + { + return false; + } + if (!r_C()) + { + return false; + } + if (!base.slice_from("d")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Step_4() { + var /** number */ among_var; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { base.ket = base.cursor; + among_var = base.find_among_b(a_4); + if (among_var == 0) + { + break lab1; + } + base.bra = base.cursor; switch (among_var) { case 1: - if (!base.slice_from("y")) + if (!r_R1()) + { + break lab1; + } + if (!base.slice_from("ie")) + { + return false; + } + break; + case 2: + if (!r_R1()) + { + break lab1; + } + if (!base.slice_from("eer")) + { + return false; + } + break; + case 3: + if (!r_R1()) + { + break lab1; + } + if (!base.slice_del()) + { + return false; + } + break; + case 4: + if (!r_R1()) + { + break lab1; + } + if (!r_V()) + { + break lab1; + } + if (!base.slice_from("n")) + { + return false; + } + break; + case 5: + if (!r_R1()) + { + break lab1; + } + if (!r_V()) + { + break lab1; + } + if (!base.slice_from("l")) + { + return false; + } + break; + case 6: + if (!r_R1()) + { + break lab1; + } + if (!r_V()) + { + break lab1; + } + if (!base.slice_from("r")) + { + return false; + } + break; + case 7: + if (!r_R1()) + { + break lab1; + } + if (!base.slice_from("teer")) { return false; } break; - case 2: - if (!base.slice_from("i")) + case 8: + if (!r_R1()) + { + break lab1; + } + if (!base.slice_from("lijk")) { return false; } break; - case 3: - if (base.cursor >= base.limit) + case 9: + if (!r_R1()) { - break lab0; + break lab1; + } + if (!r_C()) + { + break lab1; + } + if (!base.slice_del()) + { + return false; } - base.cursor++; + r_lengthen_V(); break; } - continue; + break lab0; } - base.cursor = v_1; - break; + base.cursor = base.limit - v_1; + base.ket = base.cursor; + if (base.find_among_b(a_5) == 0) + { + return false; + } + base.bra = base.cursor; + if (!r_R1()) + { + return false; + } + { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab2: { + if (!(base.eq_s_b("inn"))) + { + break lab2; + } + if (base.cursor > base.limit_backward) + { + break lab2; + } + return false; + } + base.cursor = base.limit - v_2; + } + if (!r_C()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + r_lengthen_V(); } return true; }; /** @return {boolean} */ - function r_R1() { - if (!(I_p1 <= base.cursor)) + function r_Step_7() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_6); + if (among_var == 0) { return false; } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("k")) + { + return false; + } + break; + case 2: + if (!base.slice_from("f")) + { + return false; + } + break; + case 3: + if (!base.slice_from("p")) + { + return false; + } + break; + } return true; }; /** @return {boolean} */ - function r_R2() { - if (!(I_p2 <= base.cursor)) + function r_Step_6() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_7); + if (among_var == 0) { return false; } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("b")) + { + return false; + } + break; + case 2: + if (!base.slice_from("c")) + { + return false; + } + break; + case 3: + if (!base.slice_from("d")) + { + return false; + } + break; + case 4: + if (!base.slice_from("f")) + { + return false; + } + break; + case 5: + if (!base.slice_from("g")) + { + return false; + } + break; + case 6: + if (!base.slice_from("h")) + { + return false; + } + break; + case 7: + if (!base.slice_from("j")) + { + return false; + } + break; + case 8: + if (!base.slice_from("k")) + { + return false; + } + break; + case 9: + if (!base.slice_from("l")) + { + return false; + } + break; + case 10: + if (!base.slice_from("m")) + { + return false; + } + break; + case 11: + { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (!(base.eq_s_b("i"))) + { + break lab0; + } + if (base.cursor > base.limit_backward) + { + break lab0; + } + return false; + } + base.cursor = base.limit - v_1; + } + if (!base.slice_from("n")) + { + return false; + } + break; + case 12: + if (!base.slice_from("p")) + { + return false; + } + break; + case 13: + if (!base.slice_from("q")) + { + return false; + } + break; + case 14: + if (!base.slice_from("r")) + { + return false; + } + break; + case 15: + if (!base.slice_from("s")) + { + return false; + } + break; + case 16: + if (!base.slice_from("t")) + { + return false; + } + break; + case 17: + if (!base.slice_from("v")) + { + return false; + } + break; + case 18: + if (!base.slice_from("w")) + { + return false; + } + break; + case 19: + if (!base.slice_from("x")) + { + return false; + } + break; + case 20: + if (!base.slice_from("z")) + { + return false; + } + break; + } return true; }; /** @return {boolean} */ - function r_undouble() { - var /** number */ v_1 = base.limit - base.cursor; - if (base.find_among_b(a_2) == 0) + function r_Step_1c() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_8); + if (among_var == 0) { return false; } - base.cursor = base.limit - v_1; - base.ket = base.cursor; - if (base.cursor <= base.limit_backward) + base.bra = base.cursor; + if (!r_R1()) { return false; } - base.cursor--; - base.bra = base.cursor; - if (!base.slice_del()) + if (!r_C()) { return false; } + switch (among_var) { + case 1: + { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (!(base.eq_s_b("n"))) + { + break lab0; + } + if (!r_R1()) + { + break lab0; + } + return false; + } + base.cursor = base.limit - v_1; + } + lab1: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab2: { + if (!(base.eq_s_b("in"))) + { + break lab2; + } + if (base.cursor > base.limit_backward) + { + break lab2; + } + if (!base.slice_from("n")) + { + return false; + } + break lab1; + } + base.cursor = base.limit - v_2; + if (!base.slice_del()) + { + return false; + } + } + break; + case 2: + { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab3: { + if (!(base.eq_s_b("h"))) + { + break lab3; + } + if (!r_R1()) + { + break lab3; + } + return false; + } + base.cursor = base.limit - v_3; + } + { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab4: { + if (!(base.eq_s_b("en"))) + { + break lab4; + } + if (base.cursor > base.limit_backward) + { + break lab4; + } + return false; + } + base.cursor = base.limit - v_4; + } + if (!base.slice_del()) + { + return false; + } + break; + } return true; }; /** @return {boolean} */ - function r_e_ending() { - B_e_found = false; - base.ket = base.cursor; - if (!(base.eq_s_b("e"))) + function r_Lose_prefix() { + var /** number */ among_var; + base.bra = base.cursor; + if (!(base.eq_s("ge"))) { return false; } - base.bra = base.cursor; - if (!r_R1()) + base.ket = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; { - return false; + /** @const */ var /** number */ c1 = base.cursor + 3; + if (c1 > base.limit) + { + return false; + } + base.cursor = c1; } - var /** number */ v_1 = base.limit - base.cursor; - if (!(base.out_grouping_b(g_v, 97, 232))) + base.cursor = v_1; + /** @const */ var /** number */ v_2 = base.cursor; + golab0: while(true) { - return false; + /** @const */ var /** number */ v_3 = base.cursor; + lab1: { + lab2: { + /** @const */ var /** number */ v_4 = base.cursor; + lab3: { + if (!(base.eq_s("ij"))) + { + break lab3; + } + break lab2; + } + base.cursor = v_4; + if (!(base.in_grouping(g_v, 97, 252))) + { + break lab1; + } + } + break golab0; + } + base.cursor = v_3; + if (base.cursor >= base.limit) + { + return false; + } + base.cursor++; } - base.cursor = base.limit - v_1; - if (!base.slice_del()) + while(true) { + /** @const */ var /** number */ v_5 = base.cursor; + lab4: { + lab5: { + /** @const */ var /** number */ v_6 = base.cursor; + lab6: { + if (!(base.eq_s("ij"))) + { + break lab6; + } + break lab5; + } + base.cursor = v_6; + if (!(base.in_grouping(g_v, 97, 252))) + { + break lab4; + } + } + continue; + } + base.cursor = v_5; + break; + } + lab7: { + if (base.cursor < base.limit) + { + break lab7; + } return false; } - B_e_found = true; - if (!r_undouble()) + base.cursor = v_2; + among_var = base.find_among(a_9); + switch (among_var) { + case 1: + return false; + } + B_GE_removed = true; + if (!base.slice_del()) { return false; } + /** @const */ var /** number */ v_7 = base.cursor; + lab8: { + base.bra = base.cursor; + among_var = base.find_among(a_10); + if (among_var == 0) + { + break lab8; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("e")) + { + return false; + } + break; + case 2: + if (!base.slice_from("i")) + { + return false; + } + break; + } + } + base.cursor = v_7; return true; }; /** @return {boolean} */ - function r_en_ending() { - if (!r_R1()) + function r_Lose_infix() { + var /** number */ among_var; + if (base.cursor >= base.limit) { return false; } - var /** number */ v_1 = base.limit - base.cursor; - if (!(base.out_grouping_b(g_v, 97, 232))) + base.cursor++; + golab0: while(true) { - return false; + lab1: { + base.bra = base.cursor; + if (!(base.eq_s("ge"))) + { + break lab1; + } + base.ket = base.cursor; + break golab0; + } + if (base.cursor >= base.limit) + { + return false; + } + base.cursor++; } - base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_1 = base.cursor; + { + /** @const */ var /** number */ c1 = base.cursor + 3; + if (c1 > base.limit) + { + return false; + } + base.cursor = c1; + } + base.cursor = v_1; + /** @const */ var /** number */ v_2 = base.cursor; + golab2: while(true) { - var /** number */ v_2 = base.limit - base.cursor; - lab0: { - if (!(base.eq_s_b("gem"))) - { - break lab0; + /** @const */ var /** number */ v_3 = base.cursor; + lab3: { + lab4: { + /** @const */ var /** number */ v_4 = base.cursor; + lab5: { + if (!(base.eq_s("ij"))) + { + break lab5; + } + break lab4; + } + base.cursor = v_4; + if (!(base.in_grouping(g_v, 97, 252))) + { + break lab3; + } } + break golab2; + } + base.cursor = v_3; + if (base.cursor >= base.limit) + { return false; } - base.cursor = base.limit - v_2; + base.cursor++; } - if (!base.slice_del()) + while(true) { + /** @const */ var /** number */ v_5 = base.cursor; + lab6: { + lab7: { + /** @const */ var /** number */ v_6 = base.cursor; + lab8: { + if (!(base.eq_s("ij"))) + { + break lab8; + } + break lab7; + } + base.cursor = v_6; + if (!(base.in_grouping(g_v, 97, 252))) + { + break lab6; + } + } + continue; + } + base.cursor = v_5; + break; + } + lab9: { + if (base.cursor < base.limit) + { + break lab9; + } return false; } - if (!r_undouble()) + base.cursor = v_2; + B_GE_removed = true; + if (!base.slice_del()) { return false; } - return true; - }; - - /** @return {boolean} */ - function r_standard_suffix() { - var /** number */ among_var; - var /** number */ v_1 = base.limit - base.cursor; - lab0: { - base.ket = base.cursor; - among_var = base.find_among_b(a_3); + /** @const */ var /** number */ v_7 = base.cursor; + lab10: { + base.bra = base.cursor; + among_var = base.find_among(a_11); if (among_var == 0) { - break lab0; + break lab10; } - base.bra = base.cursor; + base.ket = base.cursor; switch (among_var) { case 1: - if (!r_R1()) - { - break lab0; - } - if (!base.slice_from("heid")) + if (!base.slice_from("e")) { return false; } break; case 2: - if (!r_en_ending()) + if (!base.slice_from("i")) { - break lab0; + return false; } break; - case 3: - if (!r_R1()) - { - break lab0; - } - if (!(base.out_grouping_b(g_v_j, 97, 232))) + } + } + base.cursor = v_7; + return true; + }; + + /** @return {boolean} */ + function r_measure() { + I_p1 = base.limit; + I_p2 = base.limit; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + while(true) + { + lab1: { + if (!(base.out_grouping(g_v, 97, 252))) { - break lab0; + break lab1; } - if (!base.slice_del()) - { - return false; + continue; + } + break; + } + { + var v_2 = 1; + while(true) + { + /** @const */ var /** number */ v_3 = base.cursor; + lab2: { + lab3: { + /** @const */ var /** number */ v_4 = base.cursor; + lab4: { + if (!(base.eq_s("ij"))) + { + break lab4; + } + break lab3; + } + base.cursor = v_4; + if (!(base.in_grouping(g_v, 97, 252))) + { + break lab2; + } + } + v_2--; + continue; } + base.cursor = v_3; break; + } + if (v_2 > 0) + { + break lab0; + } } - } - base.cursor = base.limit - v_1; - var /** number */ v_2 = base.limit - base.cursor; - r_e_ending(); - base.cursor = base.limit - v_2; - var /** number */ v_3 = base.limit - base.cursor; - lab1: { - base.ket = base.cursor; - if (!(base.eq_s_b("heid"))) + if (!(base.out_grouping(g_v, 97, 252))) { - break lab1; + break lab0; } - base.bra = base.cursor; - if (!r_R2()) + I_p1 = base.cursor; + while(true) { - break lab1; + lab5: { + if (!(base.out_grouping(g_v, 97, 252))) + { + break lab5; + } + continue; + } + break; } { - var /** number */ v_4 = base.limit - base.cursor; - lab2: { - if (!(base.eq_s_b("c"))) - { - break lab2; + var v_5 = 1; + while(true) + { + /** @const */ var /** number */ v_6 = base.cursor; + lab6: { + lab7: { + /** @const */ var /** number */ v_7 = base.cursor; + lab8: { + if (!(base.eq_s("ij"))) + { + break lab8; + } + break lab7; + } + base.cursor = v_7; + if (!(base.in_grouping(g_v, 97, 252))) + { + break lab6; + } + } + v_5--; + continue; } - break lab1; + base.cursor = v_6; + break; + } + if (v_5 > 0) + { + break lab0; } - base.cursor = base.limit - v_4; } - if (!base.slice_del()) + if (!(base.out_grouping(g_v, 97, 252))) { - return false; + break lab0; } - base.ket = base.cursor; - if (!(base.eq_s_b("en"))) + I_p2 = base.cursor; + } + base.cursor = v_1; + return true; + }; + + this.stem = /** @return {boolean} */ function() { + B_stemmed = false; + r_measure(); + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (!r_Step_1()) { - break lab1; + break lab0; } - base.bra = base.cursor; - if (!r_en_ending()) + B_stemmed = true; + } + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + if (!r_Step_2()) { break lab1; } + B_stemmed = true; + } + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab2: { + if (!r_Step_3()) + { + break lab2; + } + B_stemmed = true; } base.cursor = base.limit - v_3; - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab3: { - base.ket = base.cursor; - among_var = base.find_among_b(a_4); - if (among_var == 0) + if (!r_Step_4()) { break lab3; } - base.bra = base.cursor; - switch (among_var) { - case 1: - if (!r_R2()) - { - break lab3; - } - if (!base.slice_del()) - { - return false; - } - lab4: { - var /** number */ v_6 = base.limit - base.cursor; - lab5: { - base.ket = base.cursor; - if (!(base.eq_s_b("ig"))) - { - break lab5; - } - base.bra = base.cursor; - if (!r_R2()) - { - break lab5; - } - { - var /** number */ v_7 = base.limit - base.cursor; - lab6: { - if (!(base.eq_s_b("e"))) - { - break lab6; - } - break lab5; - } - base.cursor = base.limit - v_7; - } - if (!base.slice_del()) - { - return false; - } - break lab4; - } - base.cursor = base.limit - v_6; - if (!r_undouble()) - { - break lab3; - } - } - break; - case 2: - if (!r_R2()) - { - break lab3; - } - { - var /** number */ v_8 = base.limit - base.cursor; - lab7: { - if (!(base.eq_s_b("e"))) - { - break lab7; - } - break lab3; - } - base.cursor = base.limit - v_8; - } - if (!base.slice_del()) - { - return false; - } - break; - case 3: - if (!r_R2()) - { - break lab3; - } - if (!base.slice_del()) - { - return false; - } - if (!r_e_ending()) - { - break lab3; - } - break; - case 4: - if (!r_R2()) - { - break lab3; - } - if (!base.slice_del()) - { - return false; - } - break; - case 5: - if (!r_R2()) - { - break lab3; - } - if (!B_e_found) - { - break lab3; - } - if (!base.slice_del()) - { - return false; - } - break; + B_stemmed = true; + } + base.cursor = base.limit - v_4; + base.cursor = base.limit_backward; + B_GE_removed = false; + /** @const */ var /** number */ v_5 = base.cursor; + lab4: { + /** @const */ var /** number */ v_6 = base.cursor; + if (!r_Lose_prefix()) + { + break lab4; } + base.cursor = v_6; + r_measure(); } - base.cursor = base.limit - v_5; - var /** number */ v_9 = base.limit - base.cursor; - lab8: { - if (!(base.out_grouping_b(g_v_I, 73, 232))) + base.cursor = v_5; + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab5: { + if (!B_GE_removed) { - break lab8; + break lab5; } - var /** number */ v_10 = base.limit - base.cursor; - if (base.find_among_b(a_5) == 0) + B_stemmed = true; + if (!r_Step_1c()) { - break lab8; + break lab5; } - if (!(base.out_grouping_b(g_v, 97, 232))) + } + base.cursor = base.limit - v_7; + base.cursor = base.limit_backward; + B_GE_removed = false; + /** @const */ var /** number */ v_8 = base.cursor; + lab6: { + /** @const */ var /** number */ v_9 = base.cursor; + if (!r_Lose_infix()) { - break lab8; + break lab6; } - base.cursor = base.limit - v_10; - base.ket = base.cursor; - if (base.cursor <= base.limit_backward) + base.cursor = v_9; + r_measure(); + } + base.cursor = v_8; + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; + lab7: { + if (!B_GE_removed) { - break lab8; + break lab7; } - base.cursor--; - base.bra = base.cursor; - if (!base.slice_del()) + B_stemmed = true; + if (!r_Step_1c()) { - return false; + break lab7; } } - base.cursor = base.limit - v_9; - return true; - }; - - this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; - r_prelude(); - base.cursor = v_1; - var /** number */ v_2 = base.cursor; - r_mark_regions(); - base.cursor = v_2; + base.cursor = base.limit - v_10; + base.cursor = base.limit_backward; base.limit_backward = base.cursor; base.cursor = base.limit; - r_standard_suffix(); + /** @const */ var /** number */ v_11 = base.limit - base.cursor; + lab8: { + if (!r_Step_7()) + { + break lab8; + } + B_stemmed = true; + } + base.cursor = base.limit - v_11; + /** @const */ var /** number */ v_12 = base.limit - base.cursor; + lab9: { + if (!B_stemmed) + { + break lab9; + } + if (!r_Step_6()) + { + break lab9; + } + } + base.cursor = base.limit - v_12; base.cursor = base.limit_backward; - var /** number */ v_4 = base.cursor; - r_postlude(); - base.cursor = v_4; return true; }; diff --git a/sphinx/search/non-minified-js/dutch_porter-stemmer.js b/sphinx/search/non-minified-js/dutch_porter-stemmer.js new file mode 100644 index 00000000000..6bbf2bf2e8e --- /dev/null +++ b/sphinx/search/non-minified-js/dutch_porter-stemmer.js @@ -0,0 +1,637 @@ +// Generated from dutch_porter.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var DutchPorterStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["", -1, 6], + ["\u00E1", 0, 1], + ["\u00E4", 0, 1], + ["\u00E9", 0, 2], + ["\u00EB", 0, 2], + ["\u00ED", 0, 3], + ["\u00EF", 0, 3], + ["\u00F3", 0, 4], + ["\u00F6", 0, 4], + ["\u00FA", 0, 5], + ["\u00FC", 0, 5] + ]; + + /** @const */ var a_1 = [ + ["", -1, 3], + ["I", 0, 2], + ["Y", 0, 1] + ]; + + /** @const */ var a_2 = [ + ["dd", -1, -1], + ["kk", -1, -1], + ["tt", -1, -1] + ]; + + /** @const */ var a_3 = [ + ["ene", -1, 2], + ["se", -1, 3], + ["en", -1, 2], + ["heden", 2, 1], + ["s", -1, 3] + ]; + + /** @const */ var a_4 = [ + ["end", -1, 1], + ["ig", -1, 2], + ["ing", -1, 1], + ["lijk", -1, 3], + ["baar", -1, 4], + ["bar", -1, 5] + ]; + + /** @const */ var a_5 = [ + ["aa", -1, -1], + ["ee", -1, -1], + ["oo", -1, -1], + ["uu", -1, -1] + ]; + + /** @const */ var /** Array */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; + + /** @const */ var /** Array */ g_v_I = [1, 0, 0, 17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; + + /** @const */ var /** Array */ g_v_j = [17, 67, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; + + var /** number */ I_x = 0; + var /** number */ I_p2 = 0; + var /** number */ I_p1 = 0; + var /** boolean */ B_e_found = false; + + + /** @return {boolean} */ + function r_prelude() { + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.cursor; + while(true) + { + /** @const */ var /** number */ v_2 = base.cursor; + lab0: { + base.bra = base.cursor; + among_var = base.find_among(a_0); + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("a")) + { + return false; + } + break; + case 2: + if (!base.slice_from("e")) + { + return false; + } + break; + case 3: + if (!base.slice_from("i")) + { + return false; + } + break; + case 4: + if (!base.slice_from("o")) + { + return false; + } + break; + case 5: + if (!base.slice_from("u")) + { + return false; + } + break; + case 6: + if (base.cursor >= base.limit) + { + break lab0; + } + base.cursor++; + break; + } + continue; + } + base.cursor = v_2; + break; + } + base.cursor = v_1; + /** @const */ var /** number */ v_3 = base.cursor; + lab1: { + base.bra = base.cursor; + if (!(base.eq_s("y"))) + { + base.cursor = v_3; + break lab1; + } + base.ket = base.cursor; + if (!base.slice_from("Y")) + { + return false; + } + } + while(true) + { + /** @const */ var /** number */ v_4 = base.cursor; + lab2: { + if (!base.go_out_grouping(g_v, 97, 232)) + { + break lab2; + } + base.cursor++; + /** @const */ var /** number */ v_5 = base.cursor; + lab3: { + base.bra = base.cursor; + lab4: { + /** @const */ var /** number */ v_6 = base.cursor; + lab5: { + if (!(base.eq_s("i"))) + { + break lab5; + } + base.ket = base.cursor; + /** @const */ var /** number */ v_7 = base.cursor; + lab6: { + if (!(base.in_grouping(g_v, 97, 232))) + { + break lab6; + } + if (!base.slice_from("I")) + { + return false; + } + } + base.cursor = v_7; + break lab4; + } + base.cursor = v_6; + if (!(base.eq_s("y"))) + { + base.cursor = v_5; + break lab3; + } + base.ket = base.cursor; + if (!base.slice_from("Y")) + { + return false; + } + } + } + continue; + } + base.cursor = v_4; + break; + } + return true; + }; + + /** @return {boolean} */ + function r_mark_regions() { + I_p1 = base.limit; + I_p2 = base.limit; + /** @const */ var /** number */ v_1 = base.cursor; + { + /** @const */ var /** number */ c1 = base.cursor + 3; + if (c1 > base.limit) + { + return false; + } + base.cursor = c1; + } + I_x = base.cursor; + base.cursor = v_1; + if (!base.go_out_grouping(g_v, 97, 232)) + { + return false; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 232)) + { + return false; + } + base.cursor++; + I_p1 = base.cursor; + lab0: { + if (I_p1 >= I_x) + { + break lab0; + } + I_p1 = I_x; + } + if (!base.go_out_grouping(g_v, 97, 232)) + { + return false; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 232)) + { + return false; + } + base.cursor++; + I_p2 = base.cursor; + return true; + }; + + /** @return {boolean} */ + function r_postlude() { + var /** number */ among_var; + while(true) + { + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + base.bra = base.cursor; + among_var = base.find_among(a_1); + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("y")) + { + return false; + } + break; + case 2: + if (!base.slice_from("i")) + { + return false; + } + break; + case 3: + if (base.cursor >= base.limit) + { + break lab0; + } + base.cursor++; + break; + } + continue; + } + base.cursor = v_1; + break; + } + return true; + }; + + /** @return {boolean} */ + function r_R1() { + return I_p1 <= base.cursor; + }; + + /** @return {boolean} */ + function r_R2() { + return I_p2 <= base.cursor; + }; + + /** @return {boolean} */ + function r_undouble() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + if (base.find_among_b(a_2) == 0) + { + return false; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + if (base.cursor <= base.limit_backward) + { + return false; + } + base.cursor--; + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_e_ending() { + B_e_found = false; + base.ket = base.cursor; + if (!(base.eq_s_b("e"))) + { + return false; + } + base.bra = base.cursor; + if (!r_R1()) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + if (!(base.out_grouping_b(g_v, 97, 232))) + { + return false; + } + base.cursor = base.limit - v_1; + if (!base.slice_del()) + { + return false; + } + B_e_found = true; + if (!r_undouble()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_en_ending() { + if (!r_R1()) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + if (!(base.out_grouping_b(g_v, 97, 232))) + { + return false; + } + base.cursor = base.limit - v_1; + { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab0: { + if (!(base.eq_s_b("gem"))) + { + break lab0; + } + return false; + } + base.cursor = base.limit - v_2; + } + if (!base.slice_del()) + { + return false; + } + if (!r_undouble()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_standard_suffix() { + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + among_var = base.find_among_b(a_3); + if (among_var == 0) + { + break lab0; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R1()) + { + break lab0; + } + if (!base.slice_from("heid")) + { + return false; + } + break; + case 2: + if (!r_en_ending()) + { + break lab0; + } + break; + case 3: + if (!r_R1()) + { + break lab0; + } + if (!(base.out_grouping_b(g_v_j, 97, 232))) + { + break lab0; + } + if (!base.slice_del()) + { + return false; + } + break; + } + } + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + r_e_ending(); + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + if (!(base.eq_s_b("heid"))) + { + break lab1; + } + base.bra = base.cursor; + if (!r_R2()) + { + break lab1; + } + { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab2: { + if (!(base.eq_s_b("c"))) + { + break lab2; + } + break lab1; + } + base.cursor = base.limit - v_4; + } + if (!base.slice_del()) + { + return false; + } + base.ket = base.cursor; + if (!(base.eq_s_b("en"))) + { + break lab1; + } + base.bra = base.cursor; + if (!r_en_ending()) + { + break lab1; + } + } + base.cursor = base.limit - v_3; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab3: { + base.ket = base.cursor; + among_var = base.find_among_b(a_4); + if (among_var == 0) + { + break lab3; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R2()) + { + break lab3; + } + if (!base.slice_del()) + { + return false; + } + lab4: { + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + lab5: { + base.ket = base.cursor; + if (!(base.eq_s_b("ig"))) + { + break lab5; + } + base.bra = base.cursor; + if (!r_R2()) + { + break lab5; + } + { + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab6: { + if (!(base.eq_s_b("e"))) + { + break lab6; + } + break lab5; + } + base.cursor = base.limit - v_7; + } + if (!base.slice_del()) + { + return false; + } + break lab4; + } + base.cursor = base.limit - v_6; + if (!r_undouble()) + { + break lab3; + } + } + break; + case 2: + if (!r_R2()) + { + break lab3; + } + { + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + lab7: { + if (!(base.eq_s_b("e"))) + { + break lab7; + } + break lab3; + } + base.cursor = base.limit - v_8; + } + if (!base.slice_del()) + { + return false; + } + break; + case 3: + if (!r_R2()) + { + break lab3; + } + if (!base.slice_del()) + { + return false; + } + if (!r_e_ending()) + { + break lab3; + } + break; + case 4: + if (!r_R2()) + { + break lab3; + } + if (!base.slice_del()) + { + return false; + } + break; + case 5: + if (!r_R2()) + { + break lab3; + } + if (!B_e_found) + { + break lab3; + } + if (!base.slice_del()) + { + return false; + } + break; + } + } + base.cursor = base.limit - v_5; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; + lab8: { + if (!(base.out_grouping_b(g_v_I, 73, 232))) + { + break lab8; + } + /** @const */ var /** number */ v_10 = base.limit - base.cursor; + if (base.find_among_b(a_5) == 0) + { + break lab8; + } + if (!(base.out_grouping_b(g_v, 97, 232))) + { + break lab8; + } + base.cursor = base.limit - v_10; + base.ket = base.cursor; + if (base.cursor <= base.limit_backward) + { + break lab8; + } + base.cursor--; + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + } + base.cursor = base.limit - v_9; + return true; + }; + + this.stem = /** @return {boolean} */ function() { + /** @const */ var /** number */ v_1 = base.cursor; + r_prelude(); + base.cursor = v_1; + /** @const */ var /** number */ v_2 = base.cursor; + r_mark_regions(); + base.cursor = v_2; + base.limit_backward = base.cursor; base.cursor = base.limit; + r_standard_suffix(); + base.cursor = base.limit_backward; + /** @const */ var /** number */ v_3 = base.cursor; + r_postlude(); + base.cursor = v_3; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/english-stemmer.js b/sphinx/search/non-minified-js/english-stemmer.js new file mode 100644 index 00000000000..056760ee8aa --- /dev/null +++ b/sphinx/search/non-minified-js/english-stemmer.js @@ -0,0 +1,1066 @@ +// Generated from english.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var EnglishStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["arsen", -1, -1], + ["commun", -1, -1], + ["emerg", -1, -1], + ["gener", -1, -1], + ["later", -1, -1], + ["organ", -1, -1], + ["past", -1, -1], + ["univers", -1, -1] + ]; + + /** @const */ var a_1 = [ + ["'", -1, 1], + ["'s'", 0, 1], + ["'s", -1, 1] + ]; + + /** @const */ var a_2 = [ + ["ied", -1, 2], + ["s", -1, 3], + ["ies", 1, 2], + ["sses", 1, 1], + ["ss", 1, -1], + ["us", 1, -1] + ]; + + /** @const */ var a_3 = [ + ["succ", -1, 1], + ["proc", -1, 1], + ["exc", -1, 1] + ]; + + /** @const */ var a_4 = [ + ["even", -1, 2], + ["cann", -1, 2], + ["inn", -1, 2], + ["earr", -1, 2], + ["herr", -1, 2], + ["out", -1, 2], + ["y", -1, 1] + ]; + + /** @const */ var a_5 = [ + ["", -1, -1], + ["ed", 0, 2], + ["eed", 1, 1], + ["ing", 0, 3], + ["edly", 0, 2], + ["eedly", 4, 1], + ["ingly", 0, 2] + ]; + + /** @const */ var a_6 = [ + ["", -1, 3], + ["bb", 0, 2], + ["dd", 0, 2], + ["ff", 0, 2], + ["gg", 0, 2], + ["bl", 0, 1], + ["mm", 0, 2], + ["nn", 0, 2], + ["pp", 0, 2], + ["rr", 0, 2], + ["at", 0, 1], + ["tt", 0, 2], + ["iz", 0, 1] + ]; + + /** @const */ var a_7 = [ + ["anci", -1, 3], + ["enci", -1, 2], + ["ogi", -1, 14], + ["li", -1, 16], + ["bli", 3, 12], + ["abli", 4, 4], + ["alli", 3, 8], + ["fulli", 3, 9], + ["lessli", 3, 15], + ["ousli", 3, 10], + ["entli", 3, 5], + ["aliti", -1, 8], + ["biliti", -1, 12], + ["iviti", -1, 11], + ["tional", -1, 1], + ["ational", 14, 7], + ["alism", -1, 8], + ["ation", -1, 7], + ["ization", 17, 6], + ["izer", -1, 6], + ["ator", -1, 7], + ["iveness", -1, 11], + ["fulness", -1, 9], + ["ousness", -1, 10], + ["ogist", -1, 13] + ]; + + /** @const */ var a_8 = [ + ["icate", -1, 4], + ["ative", -1, 6], + ["alize", -1, 3], + ["iciti", -1, 4], + ["ical", -1, 4], + ["tional", -1, 1], + ["ational", 5, 2], + ["ful", -1, 5], + ["ness", -1, 5] + ]; + + /** @const */ var a_9 = [ + ["ic", -1, 1], + ["ance", -1, 1], + ["ence", -1, 1], + ["able", -1, 1], + ["ible", -1, 1], + ["ate", -1, 1], + ["ive", -1, 1], + ["ize", -1, 1], + ["iti", -1, 1], + ["al", -1, 1], + ["ism", -1, 1], + ["ion", -1, 2], + ["er", -1, 1], + ["ous", -1, 1], + ["ant", -1, 1], + ["ent", -1, 1], + ["ment", 15, 1], + ["ement", 16, 1] + ]; + + /** @const */ var a_10 = [ + ["e", -1, 1], + ["l", -1, 2] + ]; + + /** @const */ var a_11 = [ + ["andes", -1, -1], + ["atlas", -1, -1], + ["bias", -1, -1], + ["cosmos", -1, -1], + ["early", -1, 5], + ["gently", -1, 3], + ["howe", -1, -1], + ["idly", -1, 2], + ["news", -1, -1], + ["only", -1, 6], + ["singly", -1, 7], + ["skies", -1, 1], + ["sky", -1, -1], + ["ugly", -1, 4] + ]; + + /** @const */ var /** Array */ g_aeo = [17, 64]; + + /** @const */ var /** Array */ g_v = [17, 65, 16, 1]; + + /** @const */ var /** Array */ g_v_WXY = [1, 17, 65, 208, 1]; + + /** @const */ var /** Array */ g_valid_LI = [55, 141, 2]; + + var /** boolean */ B_Y_found = false; + var /** number */ I_p2 = 0; + var /** number */ I_p1 = 0; + + + /** @return {boolean} */ + function r_prelude() { + B_Y_found = false; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + base.bra = base.cursor; + if (!(base.eq_s("'"))) + { + break lab0; + } + base.ket = base.cursor; + if (!base.slice_del()) + { + return false; + } + } + base.cursor = v_1; + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + base.bra = base.cursor; + if (!(base.eq_s("y"))) + { + break lab1; + } + base.ket = base.cursor; + if (!base.slice_from("Y")) + { + return false; + } + B_Y_found = true; + } + base.cursor = v_2; + /** @const */ var /** number */ v_3 = base.cursor; + lab2: { + while(true) + { + /** @const */ var /** number */ v_4 = base.cursor; + lab3: { + golab4: while(true) + { + /** @const */ var /** number */ v_5 = base.cursor; + lab5: { + if (!(base.in_grouping(g_v, 97, 121))) + { + break lab5; + } + base.bra = base.cursor; + if (!(base.eq_s("y"))) + { + break lab5; + } + base.ket = base.cursor; + base.cursor = v_5; + break golab4; + } + base.cursor = v_5; + if (base.cursor >= base.limit) + { + break lab3; + } + base.cursor++; + } + if (!base.slice_from("Y")) + { + return false; + } + B_Y_found = true; + continue; + } + base.cursor = v_4; + break; + } + } + base.cursor = v_3; + return true; + }; + + /** @return {boolean} */ + function r_mark_regions() { + I_p1 = base.limit; + I_p2 = base.limit; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + lab1: { + /** @const */ var /** number */ v_2 = base.cursor; + lab2: { + if (base.find_among(a_0) == 0) + { + break lab2; + } + break lab1; + } + base.cursor = v_2; + if (!base.go_out_grouping(g_v, 97, 121)) + { + break lab0; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 121)) + { + break lab0; + } + base.cursor++; + } + I_p1 = base.cursor; + if (!base.go_out_grouping(g_v, 97, 121)) + { + break lab0; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 121)) + { + break lab0; + } + base.cursor++; + I_p2 = base.cursor; + } + base.cursor = v_1; + return true; + }; + + /** @return {boolean} */ + function r_shortv() { + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (!(base.out_grouping_b(g_v_WXY, 89, 121))) + { + break lab1; + } + if (!(base.in_grouping_b(g_v, 97, 121))) + { + break lab1; + } + if (!(base.out_grouping_b(g_v, 97, 121))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab2: { + if (!(base.out_grouping_b(g_v, 97, 121))) + { + break lab2; + } + if (!(base.in_grouping_b(g_v, 97, 121))) + { + break lab2; + } + if (base.cursor > base.limit_backward) + { + break lab2; + } + break lab0; + } + base.cursor = base.limit - v_1; + if (!(base.eq_s_b("past"))) + { + return false; + } + } + return true; + }; + + /** @return {boolean} */ + function r_R1() { + return I_p1 <= base.cursor; + }; + + /** @return {boolean} */ + function r_R2() { + return I_p2 <= base.cursor; + }; + + /** @return {boolean} */ + function r_Step_1a() { + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + if (base.find_among_b(a_1) == 0) + { + base.cursor = base.limit - v_1; + break lab0; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + } + base.ket = base.cursor; + among_var = base.find_among_b(a_2); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("ss")) + { + return false; + } + break; + case 2: + lab1: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab2: { + { + /** @const */ var /** number */ c1 = base.cursor - 2; + if (c1 < base.limit_backward) + { + break lab2; + } + base.cursor = c1; + } + if (!base.slice_from("i")) + { + return false; + } + break lab1; + } + base.cursor = base.limit - v_2; + if (!base.slice_from("ie")) + { + return false; + } + } + break; + case 3: + if (base.cursor <= base.limit_backward) + { + return false; + } + base.cursor--; + if (!base.go_out_grouping_b(g_v, 97, 121)) + { + return false; + } + base.cursor--; + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Step_1b() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_5); + base.bra = base.cursor; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + switch (among_var) { + case 1: + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab2: { + lab3: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab4: { + if (base.find_among_b(a_3) == 0) + { + break lab4; + } + if (base.cursor > base.limit_backward) + { + break lab4; + } + break lab3; + } + base.cursor = base.limit - v_3; + if (!r_R1()) + { + break lab2; + } + if (!base.slice_from("ee")) + { + return false; + } + } + } + base.cursor = base.limit - v_2; + break; + case 2: + break lab1; + case 3: + among_var = base.find_among_b(a_4); + if (among_var == 0) + { + break lab1; + } + switch (among_var) { + case 1: + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + if (!(base.out_grouping_b(g_v, 97, 121))) + { + break lab1; + } + if (base.cursor > base.limit_backward) + { + break lab1; + } + base.cursor = base.limit - v_4; + base.bra = base.cursor; + if (!base.slice_from("ie")) + { + return false; + } + break; + case 2: + if (base.cursor > base.limit_backward) + { + break lab1; + } + break; + } + break; + } + break lab0; + } + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + if (!base.go_out_grouping_b(g_v, 97, 121)) + { + return false; + } + base.cursor--; + base.cursor = base.limit - v_5; + if (!base.slice_del()) + { + return false; + } + base.ket = base.cursor; + base.bra = base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + among_var = base.find_among_b(a_6); + switch (among_var) { + case 1: + if (!base.slice_from("e")) + { + return false; + } + return false; + case 2: + { + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab5: { + if (!(base.in_grouping_b(g_aeo, 97, 111))) + { + break lab5; + } + if (base.cursor > base.limit_backward) + { + break lab5; + } + return false; + } + base.cursor = base.limit - v_7; + } + break; + case 3: + if (base.cursor != I_p1) + { + return false; + } + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + if (!r_shortv()) + { + return false; + } + base.cursor = base.limit - v_8; + if (!base.slice_from("e")) + { + return false; + } + return false; + } + base.cursor = base.limit - v_6; + base.ket = base.cursor; + if (base.cursor <= base.limit_backward) + { + return false; + } + base.cursor--; + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + } + return true; + }; + + /** @return {boolean} */ + function r_Step_1c() { + base.ket = base.cursor; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("y"))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_1; + if (!(base.eq_s_b("Y"))) + { + return false; + } + } + base.bra = base.cursor; + if (!(base.out_grouping_b(g_v, 97, 121))) + { + return false; + } + lab2: { + if (base.cursor > base.limit_backward) + { + break lab2; + } + return false; + } + if (!base.slice_from("i")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_Step_2() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_7); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + if (!r_R1()) + { + return false; + } + switch (among_var) { + case 1: + if (!base.slice_from("tion")) + { + return false; + } + break; + case 2: + if (!base.slice_from("ence")) + { + return false; + } + break; + case 3: + if (!base.slice_from("ance")) + { + return false; + } + break; + case 4: + if (!base.slice_from("able")) + { + return false; + } + break; + case 5: + if (!base.slice_from("ent")) + { + return false; + } + break; + case 6: + if (!base.slice_from("ize")) + { + return false; + } + break; + case 7: + if (!base.slice_from("ate")) + { + return false; + } + break; + case 8: + if (!base.slice_from("al")) + { + return false; + } + break; + case 9: + if (!base.slice_from("ful")) + { + return false; + } + break; + case 10: + if (!base.slice_from("ous")) + { + return false; + } + break; + case 11: + if (!base.slice_from("ive")) + { + return false; + } + break; + case 12: + if (!base.slice_from("ble")) + { + return false; + } + break; + case 13: + if (!base.slice_from("og")) + { + return false; + } + break; + case 14: + if (!(base.eq_s_b("l"))) + { + return false; + } + if (!base.slice_from("og")) + { + return false; + } + break; + case 15: + if (!base.slice_from("less")) + { + return false; + } + break; + case 16: + if (!(base.in_grouping_b(g_valid_LI, 99, 116))) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Step_3() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_8); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + if (!r_R1()) + { + return false; + } + switch (among_var) { + case 1: + if (!base.slice_from("tion")) + { + return false; + } + break; + case 2: + if (!base.slice_from("ate")) + { + return false; + } + break; + case 3: + if (!base.slice_from("al")) + { + return false; + } + break; + case 4: + if (!base.slice_from("ic")) + { + return false; + } + break; + case 5: + if (!base.slice_del()) + { + return false; + } + break; + case 6: + if (!r_R2()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Step_4() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_9); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + if (!r_R2()) + { + return false; + } + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + break; + case 2: + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("s"))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_1; + if (!(base.eq_s_b("t"))) + { + return false; + } + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Step_5() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_10); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + lab0: { + lab1: { + if (!r_R2()) + { + break lab1; + } + break lab0; + } + if (!r_R1()) + { + return false; + } + { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab2: { + if (!r_shortv()) + { + break lab2; + } + return false; + } + base.cursor = base.limit - v_1; + } + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!r_R2()) + { + return false; + } + if (!(base.eq_s_b("l"))) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_exception1() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_11); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + if (base.cursor < base.limit) + { + return false; + } + switch (among_var) { + case 1: + if (!base.slice_from("sky")) + { + return false; + } + break; + case 2: + if (!base.slice_from("idl")) + { + return false; + } + break; + case 3: + if (!base.slice_from("gentl")) + { + return false; + } + break; + case 4: + if (!base.slice_from("ugli")) + { + return false; + } + break; + case 5: + if (!base.slice_from("earli")) + { + return false; + } + break; + case 6: + if (!base.slice_from("onli")) + { + return false; + } + break; + case 7: + if (!base.slice_from("singl")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_postlude() { + if (!B_Y_found) + { + return false; + } + while(true) + { + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + golab1: while(true) + { + /** @const */ var /** number */ v_2 = base.cursor; + lab2: { + base.bra = base.cursor; + if (!(base.eq_s("Y"))) + { + break lab2; + } + base.ket = base.cursor; + base.cursor = v_2; + break golab1; + } + base.cursor = v_2; + if (base.cursor >= base.limit) + { + break lab0; + } + base.cursor++; + } + if (!base.slice_from("y")) + { + return false; + } + continue; + } + base.cursor = v_1; + break; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + lab0: { + /** @const */ var /** number */ v_1 = base.cursor; + lab1: { + if (!r_exception1()) + { + break lab1; + } + break lab0; + } + base.cursor = v_1; + lab2: { + { + /** @const */ var /** number */ v_2 = base.cursor; + lab3: { + { + /** @const */ var /** number */ c1 = base.cursor + 3; + if (c1 > base.limit) + { + break lab3; + } + base.cursor = c1; + } + break lab2; + } + base.cursor = v_2; + } + break lab0; + } + base.cursor = v_1; + r_prelude(); + r_mark_regions(); + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + r_Step_1a(); + base.cursor = base.limit - v_3; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + r_Step_1b(); + base.cursor = base.limit - v_4; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + r_Step_1c(); + base.cursor = base.limit - v_5; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + r_Step_2(); + base.cursor = base.limit - v_6; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + r_Step_3(); + base.cursor = base.limit - v_7; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + r_Step_4(); + base.cursor = base.limit - v_8; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; + r_Step_5(); + base.cursor = base.limit - v_9; + base.cursor = base.limit_backward; + /** @const */ var /** number */ v_10 = base.cursor; + r_postlude(); + base.cursor = v_10; + } + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/esperanto-stemmer.js b/sphinx/search/non-minified-js/esperanto-stemmer.js new file mode 100644 index 00000000000..8fc6af00f1a --- /dev/null +++ b/sphinx/search/non-minified-js/esperanto-stemmer.js @@ -0,0 +1,762 @@ +// Generated from esperanto.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var EsperantoStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["", -1, 14], + ["-", 0, 13], + ["cx", 0, 1], + ["gx", 0, 2], + ["hx", 0, 3], + ["jx", 0, 4], + ["q", 0, 12], + ["sx", 0, 5], + ["ux", 0, 6], + ["w", 0, 12], + ["x", 0, 12], + ["y", 0, 12], + ["\u00E1", 0, 7], + ["\u00E9", 0, 8], + ["\u00ED", 0, 9], + ["\u00F3", 0, 10], + ["\u00FA", 0, 11] + ]; + + /** @const */ var a_1 = [ + ["as", -1, -1], + ["i", -1, -1], + ["is", 1, -1], + ["os", -1, -1], + ["u", -1, -1], + ["us", 4, -1] + ]; + + /** @const */ var a_2 = [ + ["ci", -1, -1], + ["gi", -1, -1], + ["hi", -1, -1], + ["li", -1, -1], + ["ili", 3, -1], + ["\u015Dli", 3, -1], + ["mi", -1, -1], + ["ni", -1, -1], + ["oni", 7, -1], + ["ri", -1, -1], + ["si", -1, -1], + ["vi", -1, -1], + ["ivi", 11, -1], + ["\u011Di", -1, -1], + ["\u015Di", -1, -1], + ["i\u015Di", 14, -1], + ["mal\u015Di", 14, -1] + ]; + + /** @const */ var a_3 = [ + ["amb", -1, -1], + ["bald", -1, -1], + ["malbald", 1, -1], + ["morg", -1, -1], + ["postmorg", 3, -1], + ["adi", -1, -1], + ["hodi", -1, -1], + ["ank", -1, -1], + ["\u0109irk", -1, -1], + ["tut\u0109irk", 8, -1], + ["presk", -1, -1], + ["almen", -1, -1], + ["apen", -1, -1], + ["hier", -1, -1], + ["anta\u016Dhier", 13, -1], + ["malgr", -1, -1], + ["ankor", -1, -1], + ["kontr", -1, -1], + ["anstat", -1, -1], + ["kvaz", -1, -1] + ]; + + /** @const */ var a_4 = [ + ["aliu", -1, -1], + ["unu", -1, -1] + ]; + + /** @const */ var a_5 = [ + ["aha", -1, -1], + ["haha", 0, -1], + ["haleluja", -1, -1], + ["hola", -1, -1], + ["hosana", -1, -1], + ["maltra", -1, -1], + ["hura", -1, -1], + ["\u0125a\u0125a", -1, -1], + ["ekde", -1, -1], + ["elde", -1, -1], + ["disde", -1, -1], + ["ehe", -1, -1], + ["maltre", -1, -1], + ["dirlididi", -1, -1], + ["malpli", -1, -1], + ["mal\u0109i", -1, -1], + ["malkaj", -1, -1], + ["amen", -1, -1], + ["tamen", 17, -1], + ["oho", -1, -1], + ["maltro", -1, -1], + ["minus", -1, -1], + ["uhu", -1, -1], + ["muu", -1, -1] + ]; + + /** @const */ var a_6 = [ + ["tri", -1, -1], + ["du", -1, -1], + ["unu", -1, -1] + ]; + + /** @const */ var a_7 = [ + ["dek", -1, -1], + ["cent", -1, -1] + ]; + + /** @const */ var a_8 = [ + ["k", -1, -1], + ["kelk", 0, -1], + ["nen", -1, -1], + ["t", -1, -1], + ["mult", 3, -1], + ["samt", 3, -1], + ["\u0109", -1, -1] + ]; + + /** @const */ var a_9 = [ + ["a", -1, -1], + ["e", -1, -1], + ["i", -1, -1], + ["j", -1, -1, r_not_after_letter], + ["aj", 3, -1], + ["oj", 3, -1], + ["n", -1, -1, r_not_after_letter], + ["an", 6, -1], + ["en", 6, -1], + ["jn", 6, -1, r_not_after_letter], + ["ajn", 9, -1], + ["ojn", 9, -1], + ["on", 6, -1], + ["o", -1, -1], + ["as", -1, -1], + ["is", -1, -1], + ["os", -1, -1], + ["us", -1, -1], + ["u", -1, -1] + ]; + + /** @const */ var /** Array */ g_vowel = [17, 65, 16]; + + /** @const */ var /** Array */ g_aou = [1, 64, 16]; + + /** @const */ var /** Array */ g_digit = [255, 3]; + + var /** boolean */ B_foreign = false; + + + /** @return {boolean} */ + function r_canonical_form() { + var /** number */ among_var; + B_foreign = false; + while(true) + { + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + base.bra = base.cursor; + among_var = base.find_among(a_0); + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("\u0109")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u011D")) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u0125")) + { + return false; + } + break; + case 4: + if (!base.slice_from("\u0135")) + { + return false; + } + break; + case 5: + if (!base.slice_from("\u015D")) + { + return false; + } + break; + case 6: + if (!base.slice_from("\u016D")) + { + return false; + } + break; + case 7: + if (!base.slice_from("a")) + { + return false; + } + B_foreign = true; + break; + case 8: + if (!base.slice_from("e")) + { + return false; + } + B_foreign = true; + break; + case 9: + if (!base.slice_from("i")) + { + return false; + } + B_foreign = true; + break; + case 10: + if (!base.slice_from("o")) + { + return false; + } + B_foreign = true; + break; + case 11: + if (!base.slice_from("u")) + { + return false; + } + B_foreign = true; + break; + case 12: + B_foreign = true; + break; + case 13: + B_foreign = false; + break; + case 14: + if (base.cursor >= base.limit) + { + break lab0; + } + base.cursor++; + break; + } + continue; + } + base.cursor = v_1; + break; + } + lab1: { + if (!B_foreign) + { + break lab1; + } + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_initial_apostrophe() { + base.bra = base.cursor; + if (!(base.eq_s("'"))) + { + return false; + } + base.ket = base.cursor; + if (!(base.eq_s("st"))) + { + return false; + } + if (base.find_among(a_1) == 0) + { + return false; + } + if (base.cursor < base.limit) + { + return false; + } + if (!base.slice_from("e")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_pronoun() { + base.ket = base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (!(base.eq_s_b("n"))) + { + base.cursor = base.limit - v_1; + break lab0; + } + } + base.bra = base.cursor; + if (base.find_among_b(a_2) == 0) + { + return false; + } + lab1: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab2: { + if (base.cursor > base.limit_backward) + { + break lab2; + } + break lab1; + } + base.cursor = base.limit - v_2; + if (!(base.eq_s_b("-"))) + { + return false; + } + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_final_apostrophe() { + base.ket = base.cursor; + if (!(base.eq_s_b("'"))) + { + return false; + } + base.bra = base.cursor; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("l"))) + { + break lab1; + } + if (base.cursor > base.limit_backward) + { + break lab1; + } + if (!base.slice_from("a")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab2: { + if (!(base.eq_s_b("un"))) + { + break lab2; + } + if (base.cursor > base.limit_backward) + { + break lab2; + } + if (!base.slice_from("u")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab3: { + if (base.find_among_b(a_3) == 0) + { + break lab3; + } + lab4: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab5: { + if (base.cursor > base.limit_backward) + { + break lab5; + } + break lab4; + } + base.cursor = base.limit - v_2; + if (!(base.eq_s_b("-"))) + { + break lab3; + } + } + if (!base.slice_from("a\u016D")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + if (!base.slice_from("o")) + { + return false; + } + } + return true; + }; + + /** @return {boolean} */ + function r_ujn_suffix() { + base.ket = base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (!(base.eq_s_b("n"))) + { + base.cursor = base.limit - v_1; + break lab0; + } + } + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("j"))) + { + base.cursor = base.limit - v_2; + break lab1; + } + } + base.bra = base.cursor; + if (base.find_among_b(a_4) == 0) + { + return false; + } + lab2: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab3: { + if (base.cursor > base.limit_backward) + { + break lab3; + } + break lab2; + } + base.cursor = base.limit - v_3; + if (!(base.eq_s_b("-"))) + { + return false; + } + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_uninflected() { + if (base.find_among_b(a_5) == 0) + { + return false; + } + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (base.cursor > base.limit_backward) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_1; + if (!(base.eq_s_b("-"))) + { + return false; + } + } + return true; + }; + + /** @return {boolean} */ + function r_merged_numeral() { + if (base.find_among_b(a_6) == 0) + { + return false; + } + if (base.find_among_b(a_7) == 0) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_correlative() { + base.ket = base.cursor; + base.bra = base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab2: { + if (!(base.eq_s_b("n"))) + { + base.cursor = base.limit - v_3; + break lab2; + } + } + base.bra = base.cursor; + if (!(base.eq_s_b("e"))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab3: { + if (!(base.eq_s_b("n"))) + { + base.cursor = base.limit - v_4; + break lab3; + } + } + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab4: { + if (!(base.eq_s_b("j"))) + { + base.cursor = base.limit - v_5; + break lab4; + } + } + base.bra = base.cursor; + if (!(base.in_grouping_b(g_aou, 97, 117))) + { + return false; + } + } + if (!(base.eq_s_b("i"))) + { + return false; + } + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + lab5: { + if (base.find_among_b(a_8) == 0) + { + base.cursor = base.limit - v_6; + break lab5; + } + } + lab6: { + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab7: { + if (base.cursor > base.limit_backward) + { + break lab7; + } + break lab6; + } + base.cursor = base.limit - v_7; + if (!(base.eq_s_b("-"))) + { + return false; + } + } + base.cursor = base.limit - v_1; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_long_word() { + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + for (var /** number */ v_2 = 2; v_2 > 0; v_2--) + { + if (!base.go_out_grouping_b(g_vowel, 97, 117)) + { + break lab1; + } + base.cursor--; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab2: { + golab3: while(true) + { + lab4: { + if (!(base.eq_s_b("-"))) + { + break lab4; + } + break golab3; + } + if (base.cursor <= base.limit_backward) + { + break lab2; + } + base.cursor--; + } + if (base.cursor <= base.limit_backward) + { + break lab2; + } + base.cursor--; + break lab0; + } + base.cursor = base.limit - v_1; + if (!base.go_out_grouping_b(g_digit, 48, 57)) + { + return false; + } + base.cursor--; + } + return true; + }; + + /** @return {boolean} */ + function r_not_after_letter() { + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("-"))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_1; + if (!(base.in_grouping_b(g_digit, 48, 57))) + { + return false; + } + } + return true; + }; + + /** @return {boolean} */ + function r_standard_suffix() { + base.ket = base.cursor; + if (base.find_among_b(a_9) == 0) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (!(base.eq_s_b("-"))) + { + base.cursor = base.limit - v_1; + break lab0; + } + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + /** @const */ var /** number */ v_1 = base.cursor; + if (!r_canonical_form()) + { + return false; + } + base.cursor = v_1; + /** @const */ var /** number */ v_2 = base.cursor; + r_initial_apostrophe(); + base.cursor = v_2; + base.limit_backward = base.cursor; base.cursor = base.limit; + { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab0: { + if (!r_pronoun()) + { + break lab0; + } + return false; + } + base.cursor = base.limit - v_3; + } + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + r_final_apostrophe(); + base.cursor = base.limit - v_4; + { + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab1: { + if (!r_correlative()) + { + break lab1; + } + return false; + } + base.cursor = base.limit - v_5; + } + { + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + lab2: { + if (!r_uninflected()) + { + break lab2; + } + return false; + } + base.cursor = base.limit - v_6; + } + { + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab3: { + if (!r_merged_numeral()) + { + break lab3; + } + return false; + } + base.cursor = base.limit - v_7; + } + { + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + lab4: { + if (!r_ujn_suffix()) + { + break lab4; + } + return false; + } + base.cursor = base.limit - v_8; + } + /** @const */ var /** number */ v_9 = base.limit - base.cursor; + if (!r_long_word()) + { + return false; + } + base.cursor = base.limit - v_9; + if (!r_standard_suffix()) + { + return false; + } + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/estonian-stemmer.js b/sphinx/search/non-minified-js/estonian-stemmer.js new file mode 100644 index 00000000000..2700c0b3379 --- /dev/null +++ b/sphinx/search/non-minified-js/estonian-stemmer.js @@ -0,0 +1,1088 @@ +// Generated from estonian.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var EstonianStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["gi", -1, 1], + ["ki", -1, 2] + ]; + + /** @const */ var a_1 = [ + ["da", -1, 3], + ["mata", -1, 1], + ["b", -1, 3], + ["ksid", -1, 1], + ["nuksid", 3, 1], + ["me", -1, 3], + ["sime", 5, 1], + ["ksime", 6, 1], + ["nuksime", 7, 1], + ["akse", -1, 2], + ["dakse", 9, 1], + ["takse", 9, 1], + ["site", -1, 1], + ["ksite", 12, 1], + ["nuksite", 13, 1], + ["n", -1, 3], + ["sin", 15, 1], + ["ksin", 16, 1], + ["nuksin", 17, 1], + ["daks", -1, 1], + ["taks", -1, 1] + ]; + + /** @const */ var a_2 = [ + ["aa", -1, -1], + ["ee", -1, -1], + ["ii", -1, -1], + ["oo", -1, -1], + ["uu", -1, -1], + ["\u00E4\u00E4", -1, -1], + ["\u00F5\u00F5", -1, -1], + ["\u00F6\u00F6", -1, -1], + ["\u00FC\u00FC", -1, -1] + ]; + + /** @const */ var a_3 = [ + ["i", -1, 1] + ]; + + /** @const */ var a_4 = [ + ["lane", -1, 1], + ["line", -1, 3], + ["mine", -1, 2], + ["lasse", -1, 1], + ["lisse", -1, 3], + ["misse", -1, 2], + ["lasi", -1, 1], + ["lisi", -1, 3], + ["misi", -1, 2], + ["last", -1, 1], + ["list", -1, 3], + ["mist", -1, 2] + ]; + + /** @const */ var a_5 = [ + ["ga", -1, 1], + ["ta", -1, 1], + ["le", -1, 1], + ["sse", -1, 1], + ["l", -1, 1], + ["s", -1, 1], + ["ks", 5, 1], + ["t", -1, 2], + ["lt", 7, 1], + ["st", 7, 1] + ]; + + /** @const */ var a_6 = [ + ["", -1, 2], + ["las", 0, 1], + ["lis", 0, 1], + ["mis", 0, 1], + ["t", 0, -1] + ]; + + /** @const */ var a_7 = [ + ["d", -1, 4], + ["sid", 0, 2], + ["de", -1, 4], + ["ikkude", 2, 1], + ["ike", -1, 1], + ["ikke", -1, 1], + ["te", -1, 3] + ]; + + /** @const */ var a_8 = [ + ["va", -1, -1], + ["du", -1, -1], + ["nu", -1, -1], + ["tu", -1, -1] + ]; + + /** @const */ var a_9 = [ + ["kk", -1, 1], + ["pp", -1, 2], + ["tt", -1, 3] + ]; + + /** @const */ var a_10 = [ + ["ma", -1, 2], + ["mai", -1, 1], + ["m", -1, 1] + ]; + + /** @const */ var a_11 = [ + ["joob", -1, 1], + ["jood", -1, 1], + ["joodakse", 1, 1], + ["jooma", -1, 1], + ["joomata", 3, 1], + ["joome", -1, 1], + ["joon", -1, 1], + ["joote", -1, 1], + ["joovad", -1, 1], + ["juua", -1, 1], + ["juuakse", 9, 1], + ["j\u00E4i", -1, 12], + ["j\u00E4id", 11, 12], + ["j\u00E4ime", 11, 12], + ["j\u00E4in", 11, 12], + ["j\u00E4ite", 11, 12], + ["j\u00E4\u00E4b", -1, 12], + ["j\u00E4\u00E4d", -1, 12], + ["j\u00E4\u00E4da", 17, 12], + ["j\u00E4\u00E4dakse", 18, 12], + ["j\u00E4\u00E4di", 17, 12], + ["j\u00E4\u00E4ks", -1, 12], + ["j\u00E4\u00E4ksid", 21, 12], + ["j\u00E4\u00E4ksime", 21, 12], + ["j\u00E4\u00E4ksin", 21, 12], + ["j\u00E4\u00E4ksite", 21, 12], + ["j\u00E4\u00E4ma", -1, 12], + ["j\u00E4\u00E4mata", 26, 12], + ["j\u00E4\u00E4me", -1, 12], + ["j\u00E4\u00E4n", -1, 12], + ["j\u00E4\u00E4te", -1, 12], + ["j\u00E4\u00E4vad", -1, 12], + ["j\u00F5i", -1, 1], + ["j\u00F5id", 32, 1], + ["j\u00F5ime", 32, 1], + ["j\u00F5in", 32, 1], + ["j\u00F5ite", 32, 1], + ["keeb", -1, 4], + ["keed", -1, 4], + ["keedakse", 38, 4], + ["keeks", -1, 4], + ["keeksid", 40, 4], + ["keeksime", 40, 4], + ["keeksin", 40, 4], + ["keeksite", 40, 4], + ["keema", -1, 4], + ["keemata", 45, 4], + ["keeme", -1, 4], + ["keen", -1, 4], + ["kees", -1, 4], + ["keeta", -1, 4], + ["keete", -1, 4], + ["keevad", -1, 4], + ["k\u00E4ia", -1, 8], + ["k\u00E4iakse", 53, 8], + ["k\u00E4ib", -1, 8], + ["k\u00E4id", -1, 8], + ["k\u00E4idi", 56, 8], + ["k\u00E4iks", -1, 8], + ["k\u00E4iksid", 58, 8], + ["k\u00E4iksime", 58, 8], + ["k\u00E4iksin", 58, 8], + ["k\u00E4iksite", 58, 8], + ["k\u00E4ima", -1, 8], + ["k\u00E4imata", 63, 8], + ["k\u00E4ime", -1, 8], + ["k\u00E4in", -1, 8], + ["k\u00E4is", -1, 8], + ["k\u00E4ite", -1, 8], + ["k\u00E4ivad", -1, 8], + ["laob", -1, 16], + ["laod", -1, 16], + ["laoks", -1, 16], + ["laoksid", 72, 16], + ["laoksime", 72, 16], + ["laoksin", 72, 16], + ["laoksite", 72, 16], + ["laome", -1, 16], + ["laon", -1, 16], + ["laote", -1, 16], + ["laovad", -1, 16], + ["loeb", -1, 14], + ["loed", -1, 14], + ["loeks", -1, 14], + ["loeksid", 83, 14], + ["loeksime", 83, 14], + ["loeksin", 83, 14], + ["loeksite", 83, 14], + ["loeme", -1, 14], + ["loen", -1, 14], + ["loete", -1, 14], + ["loevad", -1, 14], + ["loob", -1, 7], + ["lood", -1, 7], + ["loodi", 93, 7], + ["looks", -1, 7], + ["looksid", 95, 7], + ["looksime", 95, 7], + ["looksin", 95, 7], + ["looksite", 95, 7], + ["looma", -1, 7], + ["loomata", 100, 7], + ["loome", -1, 7], + ["loon", -1, 7], + ["loote", -1, 7], + ["loovad", -1, 7], + ["luua", -1, 7], + ["luuakse", 106, 7], + ["l\u00F5i", -1, 6], + ["l\u00F5id", 108, 6], + ["l\u00F5ime", 108, 6], + ["l\u00F5in", 108, 6], + ["l\u00F5ite", 108, 6], + ["l\u00F6\u00F6b", -1, 5], + ["l\u00F6\u00F6d", -1, 5], + ["l\u00F6\u00F6dakse", 114, 5], + ["l\u00F6\u00F6di", 114, 5], + ["l\u00F6\u00F6ks", -1, 5], + ["l\u00F6\u00F6ksid", 117, 5], + ["l\u00F6\u00F6ksime", 117, 5], + ["l\u00F6\u00F6ksin", 117, 5], + ["l\u00F6\u00F6ksite", 117, 5], + ["l\u00F6\u00F6ma", -1, 5], + ["l\u00F6\u00F6mata", 122, 5], + ["l\u00F6\u00F6me", -1, 5], + ["l\u00F6\u00F6n", -1, 5], + ["l\u00F6\u00F6te", -1, 5], + ["l\u00F6\u00F6vad", -1, 5], + ["l\u00FC\u00FCa", -1, 5], + ["l\u00FC\u00FCakse", 128, 5], + ["m\u00FC\u00FCa", -1, 13], + ["m\u00FC\u00FCakse", 130, 13], + ["m\u00FC\u00FCb", -1, 13], + ["m\u00FC\u00FCd", -1, 13], + ["m\u00FC\u00FCdi", 133, 13], + ["m\u00FC\u00FCks", -1, 13], + ["m\u00FC\u00FCksid", 135, 13], + ["m\u00FC\u00FCksime", 135, 13], + ["m\u00FC\u00FCksin", 135, 13], + ["m\u00FC\u00FCksite", 135, 13], + ["m\u00FC\u00FCma", -1, 13], + ["m\u00FC\u00FCmata", 140, 13], + ["m\u00FC\u00FCme", -1, 13], + ["m\u00FC\u00FCn", -1, 13], + ["m\u00FC\u00FCs", -1, 13], + ["m\u00FC\u00FCte", -1, 13], + ["m\u00FC\u00FCvad", -1, 13], + ["n\u00E4eb", -1, 18], + ["n\u00E4ed", -1, 18], + ["n\u00E4eks", -1, 18], + ["n\u00E4eksid", 149, 18], + ["n\u00E4eksime", 149, 18], + ["n\u00E4eksin", 149, 18], + ["n\u00E4eksite", 149, 18], + ["n\u00E4eme", -1, 18], + ["n\u00E4en", -1, 18], + ["n\u00E4ete", -1, 18], + ["n\u00E4evad", -1, 18], + ["n\u00E4gema", -1, 18], + ["n\u00E4gemata", 158, 18], + ["n\u00E4ha", -1, 18], + ["n\u00E4hakse", 160, 18], + ["n\u00E4hti", -1, 18], + ["p\u00F5eb", -1, 15], + ["p\u00F5ed", -1, 15], + ["p\u00F5eks", -1, 15], + ["p\u00F5eksid", 165, 15], + ["p\u00F5eksime", 165, 15], + ["p\u00F5eksin", 165, 15], + ["p\u00F5eksite", 165, 15], + ["p\u00F5eme", -1, 15], + ["p\u00F5en", -1, 15], + ["p\u00F5ete", -1, 15], + ["p\u00F5evad", -1, 15], + ["saab", -1, 2], + ["saad", -1, 2], + ["saada", 175, 2], + ["saadakse", 176, 2], + ["saadi", 175, 2], + ["saaks", -1, 2], + ["saaksid", 179, 2], + ["saaksime", 179, 2], + ["saaksin", 179, 2], + ["saaksite", 179, 2], + ["saama", -1, 2], + ["saamata", 184, 2], + ["saame", -1, 2], + ["saan", -1, 2], + ["saate", -1, 2], + ["saavad", -1, 2], + ["sai", -1, 2], + ["said", 190, 2], + ["saime", 190, 2], + ["sain", 190, 2], + ["saite", 190, 2], + ["s\u00F5i", -1, 9], + ["s\u00F5id", 195, 9], + ["s\u00F5ime", 195, 9], + ["s\u00F5in", 195, 9], + ["s\u00F5ite", 195, 9], + ["s\u00F6\u00F6b", -1, 9], + ["s\u00F6\u00F6d", -1, 9], + ["s\u00F6\u00F6dakse", 201, 9], + ["s\u00F6\u00F6di", 201, 9], + ["s\u00F6\u00F6ks", -1, 9], + ["s\u00F6\u00F6ksid", 204, 9], + ["s\u00F6\u00F6ksime", 204, 9], + ["s\u00F6\u00F6ksin", 204, 9], + ["s\u00F6\u00F6ksite", 204, 9], + ["s\u00F6\u00F6ma", -1, 9], + ["s\u00F6\u00F6mata", 209, 9], + ["s\u00F6\u00F6me", -1, 9], + ["s\u00F6\u00F6n", -1, 9], + ["s\u00F6\u00F6te", -1, 9], + ["s\u00F6\u00F6vad", -1, 9], + ["s\u00FC\u00FCa", -1, 9], + ["s\u00FC\u00FCakse", 215, 9], + ["teeb", -1, 17], + ["teed", -1, 17], + ["teeks", -1, 17], + ["teeksid", 219, 17], + ["teeksime", 219, 17], + ["teeksin", 219, 17], + ["teeksite", 219, 17], + ["teeme", -1, 17], + ["teen", -1, 17], + ["teete", -1, 17], + ["teevad", -1, 17], + ["tegema", -1, 17], + ["tegemata", 228, 17], + ["teha", -1, 17], + ["tehakse", 230, 17], + ["tehti", -1, 17], + ["toob", -1, 10], + ["tood", -1, 10], + ["toodi", 234, 10], + ["tooks", -1, 10], + ["tooksid", 236, 10], + ["tooksime", 236, 10], + ["tooksin", 236, 10], + ["tooksite", 236, 10], + ["tooma", -1, 10], + ["toomata", 241, 10], + ["toome", -1, 10], + ["toon", -1, 10], + ["toote", -1, 10], + ["toovad", -1, 10], + ["tuua", -1, 10], + ["tuuakse", 247, 10], + ["t\u00F5i", -1, 10], + ["t\u00F5id", 249, 10], + ["t\u00F5ime", 249, 10], + ["t\u00F5in", 249, 10], + ["t\u00F5ite", 249, 10], + ["viia", -1, 3], + ["viiakse", 254, 3], + ["viib", -1, 3], + ["viid", -1, 3], + ["viidi", 257, 3], + ["viiks", -1, 3], + ["viiksid", 259, 3], + ["viiksime", 259, 3], + ["viiksin", 259, 3], + ["viiksite", 259, 3], + ["viima", -1, 3], + ["viimata", 264, 3], + ["viime", -1, 3], + ["viin", -1, 3], + ["viisime", -1, 3], + ["viisin", -1, 3], + ["viisite", -1, 3], + ["viite", -1, 3], + ["viivad", -1, 3], + ["v\u00F5ib", -1, 11], + ["v\u00F5id", -1, 11], + ["v\u00F5ida", 274, 11], + ["v\u00F5idakse", 275, 11], + ["v\u00F5idi", 274, 11], + ["v\u00F5iks", -1, 11], + ["v\u00F5iksid", 278, 11], + ["v\u00F5iksime", 278, 11], + ["v\u00F5iksin", 278, 11], + ["v\u00F5iksite", 278, 11], + ["v\u00F5ima", -1, 11], + ["v\u00F5imata", 283, 11], + ["v\u00F5ime", -1, 11], + ["v\u00F5in", -1, 11], + ["v\u00F5is", -1, 11], + ["v\u00F5ite", -1, 11], + ["v\u00F5ivad", -1, 11] + ]; + + /** @const */ var /** Array */ g_V1 = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8, 0, 48, 8]; + + /** @const */ var /** Array */ g_RV = [17, 65, 16]; + + /** @const */ var /** Array */ g_KI = [117, 66, 6, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 0, 0, 0, 16]; + + /** @const */ var /** Array */ g_GI = [21, 123, 243, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8, 0, 48, 8]; + + var /** number */ I_p1 = 0; + + + /** @return {boolean} */ + function r_mark_regions() { + I_p1 = base.limit; + if (!base.go_out_grouping(g_V1, 97, 252)) + { + return false; + } + base.cursor++; + if (!base.go_in_grouping(g_V1, 97, 252)) + { + return false; + } + base.cursor++; + I_p1 = base.cursor; + return true; + }; + + /** @return {boolean} */ + function r_emphasis() { + var /** number */ among_var; + if (base.cursor < I_p1) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit_backward; + base.limit_backward = I_p1; + base.ket = base.cursor; + among_var = base.find_among_b(a_0); + if (among_var == 0) + { + base.limit_backward = v_1; + return false; + } + base.bra = base.cursor; + base.limit_backward = v_1; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + { + /** @const */ var /** number */ c1 = base.cursor - 4; + if (c1 < base.limit_backward) + { + return false; + } + base.cursor = c1; + } + base.cursor = base.limit - v_2; + switch (among_var) { + case 1: + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + if (!(base.in_grouping_b(g_GI, 97, 252))) + { + return false; + } + base.cursor = base.limit - v_3; + { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab0: { + if (!r_LONGV()) + { + break lab0; + } + return false; + } + base.cursor = base.limit - v_4; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!(base.in_grouping_b(g_KI, 98, 382))) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_verb() { + var /** number */ among_var; + if (base.cursor < I_p1) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit_backward; + base.limit_backward = I_p1; + base.ket = base.cursor; + among_var = base.find_among_b(a_1); + if (among_var == 0) + { + base.limit_backward = v_1; + return false; + } + base.bra = base.cursor; + base.limit_backward = v_1; + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!base.slice_from("a")) + { + return false; + } + break; + case 3: + if (!(base.in_grouping_b(g_V1, 97, 252))) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_LONGV() { + if (base.find_among_b(a_2) == 0) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_i_plural() { + if (base.cursor < I_p1) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit_backward; + base.limit_backward = I_p1; + base.ket = base.cursor; + if (base.find_among_b(a_3) == 0) + { + base.limit_backward = v_1; + return false; + } + base.bra = base.cursor; + base.limit_backward = v_1; + if (!(base.in_grouping_b(g_RV, 97, 117))) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_special_noun_endings() { + var /** number */ among_var; + if (base.cursor < I_p1) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit_backward; + base.limit_backward = I_p1; + base.ket = base.cursor; + among_var = base.find_among_b(a_4); + if (among_var == 0) + { + base.limit_backward = v_1; + return false; + } + base.bra = base.cursor; + base.limit_backward = v_1; + switch (among_var) { + case 1: + if (!base.slice_from("lase")) + { + return false; + } + break; + case 2: + if (!base.slice_from("mise")) + { + return false; + } + break; + case 3: + if (!base.slice_from("lise")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_case_ending() { + var /** number */ among_var; + if (base.cursor < I_p1) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit_backward; + base.limit_backward = I_p1; + base.ket = base.cursor; + among_var = base.find_among_b(a_5); + if (among_var == 0) + { + base.limit_backward = v_1; + return false; + } + base.bra = base.cursor; + base.limit_backward = v_1; + switch (among_var) { + case 1: + lab0: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + if (!(base.in_grouping_b(g_RV, 97, 117))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_2; + if (!r_LONGV()) + { + return false; + } + } + break; + case 2: + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + { + /** @const */ var /** number */ c1 = base.cursor - 4; + if (c1 < base.limit_backward) + { + return false; + } + base.cursor = c1; + } + base.cursor = base.limit - v_3; + break; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_plural_three_first_cases() { + var /** number */ among_var; + if (base.cursor < I_p1) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit_backward; + base.limit_backward = I_p1; + base.ket = base.cursor; + among_var = base.find_among_b(a_7); + if (among_var == 0) + { + base.limit_backward = v_1; + return false; + } + base.bra = base.cursor; + base.limit_backward = v_1; + switch (among_var) { + case 1: + if (!base.slice_from("iku")) + { + return false; + } + break; + case 2: + { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab0: { + if (!r_LONGV()) + { + break lab0; + } + return false; + } + base.cursor = base.limit - v_2; + } + if (!base.slice_del()) + { + return false; + } + break; + case 3: + lab1: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab2: { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + { + /** @const */ var /** number */ c1 = base.cursor - 4; + if (c1 < base.limit_backward) + { + break lab2; + } + base.cursor = c1; + } + base.cursor = base.limit - v_4; + among_var = base.find_among_b(a_6); + switch (among_var) { + case 1: + if (!base.slice_from("e")) + { + return false; + } + break; + case 2: + if (!base.slice_del()) + { + return false; + } + break; + } + break lab1; + } + base.cursor = base.limit - v_3; + if (!base.slice_from("t")) + { + return false; + } + } + break; + case 4: + lab3: { + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab4: { + if (!(base.in_grouping_b(g_RV, 97, 117))) + { + break lab4; + } + break lab3; + } + base.cursor = base.limit - v_5; + if (!r_LONGV()) + { + return false; + } + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_nu() { + if (base.cursor < I_p1) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit_backward; + base.limit_backward = I_p1; + base.ket = base.cursor; + if (base.find_among_b(a_8) == 0) + { + base.limit_backward = v_1; + return false; + } + base.bra = base.cursor; + base.limit_backward = v_1; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_undouble_kpt() { + var /** number */ among_var; + if (!(base.in_grouping_b(g_V1, 97, 252))) + { + return false; + } + if (I_p1 > base.cursor) + { + return false; + } + base.ket = base.cursor; + among_var = base.find_among_b(a_9); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("k")) + { + return false; + } + break; + case 2: + if (!base.slice_from("p")) + { + return false; + } + break; + case 3: + if (!base.slice_from("t")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_degrees() { + var /** number */ among_var; + if (base.cursor < I_p1) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit_backward; + base.limit_backward = I_p1; + base.ket = base.cursor; + among_var = base.find_among_b(a_10); + if (among_var == 0) + { + base.limit_backward = v_1; + return false; + } + base.bra = base.cursor; + base.limit_backward = v_1; + switch (among_var) { + case 1: + if (!(base.in_grouping_b(g_RV, 97, 117))) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_substantive() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + r_special_noun_endings(); + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + r_case_ending(); + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + r_plural_three_first_cases(); + base.cursor = base.limit - v_3; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + r_degrees(); + base.cursor = base.limit - v_4; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + r_i_plural(); + base.cursor = base.limit - v_5; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + r_nu(); + base.cursor = base.limit - v_6; + return true; + }; + + /** @return {boolean} */ + function r_verb_exceptions() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_11); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + if (base.cursor < base.limit) + { + return false; + } + switch (among_var) { + case 1: + if (!base.slice_from("joo")) + { + return false; + } + break; + case 2: + if (!base.slice_from("saa")) + { + return false; + } + break; + case 3: + if (!base.slice_from("viima")) + { + return false; + } + break; + case 4: + if (!base.slice_from("keesi")) + { + return false; + } + break; + case 5: + if (!base.slice_from("l\u00F6\u00F6")) + { + return false; + } + break; + case 6: + if (!base.slice_from("l\u00F5i")) + { + return false; + } + break; + case 7: + if (!base.slice_from("loo")) + { + return false; + } + break; + case 8: + if (!base.slice_from("k\u00E4isi")) + { + return false; + } + break; + case 9: + if (!base.slice_from("s\u00F6\u00F6")) + { + return false; + } + break; + case 10: + if (!base.slice_from("too")) + { + return false; + } + break; + case 11: + if (!base.slice_from("v\u00F5isi")) + { + return false; + } + break; + case 12: + if (!base.slice_from("j\u00E4\u00E4ma")) + { + return false; + } + break; + case 13: + if (!base.slice_from("m\u00FC\u00FCsi")) + { + return false; + } + break; + case 14: + if (!base.slice_from("luge")) + { + return false; + } + break; + case 15: + if (!base.slice_from("p\u00F5de")) + { + return false; + } + break; + case 16: + if (!base.slice_from("ladu")) + { + return false; + } + break; + case 17: + if (!base.slice_from("tegi")) + { + return false; + } + break; + case 18: + if (!base.slice_from("n\u00E4gi")) + { + return false; + } + break; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + { + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + if (!r_verb_exceptions()) + { + break lab0; + } + return false; + } + base.cursor = v_1; + } + /** @const */ var /** number */ v_2 = base.cursor; + r_mark_regions(); + base.cursor = v_2; + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + r_emphasis(); + base.cursor = base.limit - v_3; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab1: { + lab2: { + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab3: { + if (!r_verb()) + { + break lab3; + } + break lab2; + } + base.cursor = base.limit - v_5; + r_substantive(); + } + } + base.cursor = base.limit - v_4; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + r_undouble_kpt(); + base.cursor = base.limit - v_6; + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/finnish-stemmer.js b/sphinx/search/non-minified-js/finnish-stemmer.js index c907c4a70b4..07fd78516f6 100644 --- a/sphinx/search/non-minified-js/finnish-stemmer.js +++ b/sphinx/search/non-minified-js/finnish-stemmer.js @@ -1,8 +1,9 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from finnish.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -FinnishStemmer = function() { +var FinnishStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ ["pa", -1, 1], ["sti", -1, 2], @@ -141,84 +142,34 @@ FinnishStemmer = function() { function r_mark_regions() { I_p1 = base.limit; I_p2 = base.limit; - golab0: while(true) + if (!base.go_out_grouping(g_V1, 97, 246)) { - var /** number */ v_1 = base.cursor; - lab1: { - if (!(base.in_grouping(g_V1, 97, 246))) - { - break lab1; - } - base.cursor = v_1; - break golab0; - } - base.cursor = v_1; - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } - golab2: while(true) + base.cursor++; + if (!base.go_in_grouping(g_V1, 97, 246)) { - lab3: { - if (!(base.out_grouping(g_V1, 97, 246))) - { - break lab3; - } - break golab2; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } + base.cursor++; I_p1 = base.cursor; - golab4: while(true) + if (!base.go_out_grouping(g_V1, 97, 246)) { - var /** number */ v_3 = base.cursor; - lab5: { - if (!(base.in_grouping(g_V1, 97, 246))) - { - break lab5; - } - base.cursor = v_3; - break golab4; - } - base.cursor = v_3; - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } - golab6: while(true) + base.cursor++; + if (!base.go_in_grouping(g_V1, 97, 246)) { - lab7: { - if (!(base.out_grouping(g_V1, 97, 246))) - { - break lab7; - } - break golab6; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } + base.cursor++; I_p2 = base.cursor; return true; }; /** @return {boolean} */ function r_R2() { - if (!(I_p2 <= base.cursor)) - { - return false; - } - return true; + return I_p2 <= base.cursor; }; /** @return {boolean} */ @@ -228,17 +179,17 @@ FinnishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_0); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; switch (among_var) { case 1: if (!(base.in_grouping_b(g_particle_end, 97, 246))) @@ -267,21 +218,21 @@ FinnishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_4); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; switch (among_var) { case 1: { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("k"))) { @@ -289,7 +240,7 @@ FinnishStemmer = function() { } return false; } - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; } if (!base.slice_del()) { @@ -381,17 +332,17 @@ FinnishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_6); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; switch (among_var) { case 1: if (!(base.eq_s_b("a"))) @@ -430,11 +381,11 @@ FinnishStemmer = function() { } break; case 7: - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab0: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab1: { - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab2: { if (!r_LONG()) { @@ -442,17 +393,17 @@ FinnishStemmer = function() { } break lab1; } - base.cursor = base.limit - v_5; + base.cursor = base.limit - v_4; if (!(base.eq_s_b("ie"))) { - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; break lab0; } } - base.cursor = base.limit - v_4; + base.cursor = base.limit - v_3; if (base.cursor <= base.limit_backward) { - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; break lab0; } base.cursor--; @@ -485,21 +436,21 @@ FinnishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p2; base.ket = base.cursor; among_var = base.find_among_b(a_7); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; switch (among_var) { case 1: { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("po"))) { @@ -507,7 +458,7 @@ FinnishStemmer = function() { } return false; } - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; } break; } @@ -524,16 +475,16 @@ FinnishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; if (base.find_among_b(a_8) == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; if (!base.slice_del()) { return false; @@ -548,46 +499,46 @@ FinnishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; if (!(base.eq_s_b("t"))) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; if (!(base.in_grouping_b(g_V1, 97, 246))) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; if (!base.slice_del()) { return false; } - base.limit_backward = v_2; + base.limit_backward = v_1; if (base.cursor < I_p2) { return false; } - var /** number */ v_5 = base.limit_backward; + /** @const */ var /** number */ v_3 = base.limit_backward; base.limit_backward = I_p2; base.ket = base.cursor; among_var = base.find_among_b(a_9); if (among_var == 0) { - base.limit_backward = v_5; + base.limit_backward = v_3; return false; } base.bra = base.cursor; - base.limit_backward = v_5; + base.limit_backward = v_3; switch (among_var) { case 1: { - var /** number */ v_6 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("po"))) { @@ -595,7 +546,7 @@ FinnishStemmer = function() { } return false; } - base.cursor = base.limit - v_6; + base.cursor = base.limit - v_4; } break; } @@ -612,16 +563,16 @@ FinnishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab0: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; if (!r_LONG()) { break lab0; } - base.cursor = base.limit - v_4; + base.cursor = base.limit - v_3; base.ket = base.cursor; if (base.cursor <= base.limit_backward) { @@ -634,8 +585,8 @@ FinnishStemmer = function() { return false; } } - base.cursor = base.limit - v_3; - var /** number */ v_5 = base.limit - base.cursor; + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab1: { base.ket = base.cursor; if (!(base.in_grouping_b(g_AEI, 97, 228))) @@ -652,8 +603,8 @@ FinnishStemmer = function() { return false; } } - base.cursor = base.limit - v_5; - var /** number */ v_6 = base.limit - base.cursor; + base.cursor = base.limit - v_4; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab2: { base.ket = base.cursor; if (!(base.eq_s_b("j"))) @@ -662,7 +613,7 @@ FinnishStemmer = function() { } base.bra = base.cursor; lab3: { - var /** number */ v_7 = base.limit - base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; lab4: { if (!(base.eq_s_b("o"))) { @@ -670,7 +621,7 @@ FinnishStemmer = function() { } break lab3; } - base.cursor = base.limit - v_7; + base.cursor = base.limit - v_6; if (!(base.eq_s_b("u"))) { break lab2; @@ -681,8 +632,8 @@ FinnishStemmer = function() { return false; } } - base.cursor = base.limit - v_6; - var /** number */ v_8 = base.limit - base.cursor; + base.cursor = base.limit - v_5; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; lab5: { base.ket = base.cursor; if (!(base.eq_s_b("o"))) @@ -699,25 +650,11 @@ FinnishStemmer = function() { return false; } } - base.cursor = base.limit - v_8; - base.limit_backward = v_2; - golab6: while(true) + base.cursor = base.limit - v_7; + base.limit_backward = v_1; + if (!base.go_in_grouping_b(g_V1, 97, 246)) { - var /** number */ v_9 = base.limit - base.cursor; - lab7: { - if (!(base.out_grouping_b(g_V1, 97, 246))) - { - break lab7; - } - base.cursor = base.limit - v_9; - break golab6; - } - base.cursor = base.limit - v_9; - if (base.cursor <= base.limit_backward) - { - return false; - } - base.cursor--; + return false; } base.ket = base.cursor; if (!(base.in_grouping_b(g_C, 98, 122))) @@ -742,21 +679,21 @@ FinnishStemmer = function() { }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; r_mark_regions(); base.cursor = v_1; B_ending_removed = false; base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; r_particle_etc(); base.cursor = base.limit - v_2; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; r_possessive(); base.cursor = base.limit - v_3; - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; r_case_ending(); base.cursor = base.limit - v_4; - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; r_other_endings(); base.cursor = base.limit - v_5; lab0: { @@ -765,18 +702,18 @@ FinnishStemmer = function() { { break lab1; } - var /** number */ v_7 = base.limit - base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; r_i_plural(); - base.cursor = base.limit - v_7; + base.cursor = base.limit - v_6; break lab0; } - var /** number */ v_8 = base.limit - base.cursor; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; r_t_plural(); - base.cursor = base.limit - v_8; + base.cursor = base.limit - v_7; } - var /** number */ v_9 = base.limit - base.cursor; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; r_tidy(); - base.cursor = base.limit - v_9; + base.cursor = base.limit - v_8; base.cursor = base.limit_backward; return true; }; diff --git a/sphinx/search/non-minified-js/french-stemmer.js b/sphinx/search/non-minified-js/french-stemmer.js index c9708312a8f..0e7b0655494 100644 --- a/sphinx/search/non-minified-js/french-stemmer.js +++ b/sphinx/search/non-minified-js/french-stemmer.js @@ -1,10 +1,12 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from french.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -FrenchStemmer = function() { +var FrenchStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ ["col", -1, -1], + ["ni", -1, 1], ["par", -1, -1], ["tap", -1, -1] ]; @@ -42,7 +44,7 @@ FrenchStemmer = function() { ["logie", -1, 3], ["able", -1, 1], ["isme", -1, 1], - ["euse", -1, 11], + ["euse", -1, 12], ["iste", -1, 1], ["ive", -1, 8], ["if", -1, 8], @@ -57,7 +59,7 @@ FrenchStemmer = function() { ["logies", -1, 3], ["ables", -1, 1], ["ismes", -1, 1], - ["euses", -1, 11], + ["euses", -1, 12], ["istes", -1, 1], ["ives", -1, 8], ["ifs", -1, 8], @@ -65,18 +67,19 @@ FrenchStemmer = function() { ["ations", -1, 2], ["utions", -1, 4], ["ateurs", -1, 2], - ["ments", -1, 15], + ["ments", -1, 16], ["ements", 30, 6], - ["issements", 31, 12], + ["issements", 31, 13], ["it\u00E9s", -1, 7], - ["ment", -1, 15], + ["ment", -1, 16], ["ement", 34, 6], - ["issement", 35, 12], - ["amment", 34, 13], - ["emment", 34, 14], + ["issement", 35, 13], + ["amment", 34, 14], + ["emment", 34, 15], ["aux", -1, 10], ["eaux", 39, 9], ["eux", -1, 1], + ["oux", -1, 11], ["it\u00E9", -1, 7] ]; @@ -119,47 +122,56 @@ FrenchStemmer = function() { ]; /** @const */ var a_6 = [ + ["al", -1, 1], + ["\u00E9pl", -1, -1], + ["auv", -1, -1] + ]; + + /** @const */ var a_7 = [ ["a", -1, 3], ["era", 0, 2], + ["aise", -1, 4], ["asse", -1, 3], ["ante", -1, 3], ["\u00E9e", -1, 2], ["ai", -1, 3], - ["erai", 5, 2], + ["erai", 6, 2], ["er", -1, 2], ["as", -1, 3], - ["eras", 8, 2], + ["eras", 9, 2], ["\u00E2mes", -1, 3], + ["aises", -1, 4], ["asses", -1, 3], ["antes", -1, 3], ["\u00E2tes", -1, 3], ["\u00E9es", -1, 2], - ["ais", -1, 3], - ["erais", 15, 2], + ["ais", -1, 4], + ["eais", 17, 2], + ["erais", 17, 2], ["ions", -1, 1], - ["erions", 17, 2], - ["assions", 17, 3], + ["erions", 20, 2], + ["assions", 20, 3], ["erons", -1, 2], ["ants", -1, 3], ["\u00E9s", -1, 2], ["ait", -1, 3], - ["erait", 23, 2], + ["erait", 26, 2], ["ant", -1, 3], ["aIent", -1, 3], - ["eraIent", 26, 2], + ["eraIent", 29, 2], ["\u00E8rent", -1, 2], ["assent", -1, 3], ["eront", -1, 2], ["\u00E2t", -1, 3], ["ez", -1, 2], - ["iez", 32, 2], - ["eriez", 33, 2], - ["assiez", 33, 3], - ["erez", 32, 2], + ["iez", 35, 2], + ["eriez", 36, 2], + ["assiez", 36, 3], + ["erez", 35, 2], ["\u00E9", -1, 2] ]; - /** @const */ var a_7 = [ + /** @const */ var a_8 = [ ["e", -1, 3], ["I\u00E8re", 0, 2], ["i\u00E8re", 0, 2], @@ -168,7 +180,7 @@ FrenchStemmer = function() { ["ier", -1, 2] ]; - /** @const */ var a_8 = [ + /** @const */ var a_9 = [ ["ell", -1, -1], ["eill", -1, -1], ["enn", -1, -1], @@ -178,6 +190,10 @@ FrenchStemmer = function() { /** @const */ var /** Array */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 130, 103, 8, 5]; + /** @const */ var /** Array */ g_oux_ending = [65, 85]; + + /** @const */ var /** Array */ g_elision_char = [131, 14, 3]; + /** @const */ var /** Array */ g_keep_with_s = [1, 65, 20, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; var /** number */ I_p2 = 0; @@ -185,18 +201,55 @@ FrenchStemmer = function() { var /** number */ I_pV = 0; + /** @return {boolean} */ + function r_elisions() { + base.bra = base.cursor; + lab0: { + /** @const */ var /** number */ v_1 = base.cursor; + lab1: { + if (!(base.in_grouping(g_elision_char, 99, 116))) + { + break lab1; + } + break lab0; + } + base.cursor = v_1; + if (!(base.eq_s("qu"))) + { + return false; + } + } + if (!(base.eq_s("'"))) + { + return false; + } + base.ket = base.cursor; + lab2: { + if (base.cursor < base.limit) + { + break lab2; + } + return false; + } + if (!base.slice_del()) + { + return false; + } + return true; + }; + /** @return {boolean} */ function r_prelude() { while(true) { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { golab1: while(true) { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab2: { lab3: { - var /** number */ v_3 = base.cursor; + /** @const */ var /** number */ v_3 = base.cursor; lab4: { if (!(base.in_grouping(g_v, 97, 251))) { @@ -204,7 +257,7 @@ FrenchStemmer = function() { } base.bra = base.cursor; lab5: { - var /** number */ v_4 = base.cursor; + /** @const */ var /** number */ v_4 = base.cursor; lab6: { if (!(base.eq_s("u"))) { @@ -333,13 +386,14 @@ FrenchStemmer = function() { /** @return {boolean} */ function r_mark_regions() { + var /** number */ among_var; I_pV = base.limit; I_p1 = base.limit; I_p2 = base.limit; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { lab1: { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 251))) { @@ -358,10 +412,19 @@ FrenchStemmer = function() { } base.cursor = v_2; lab3: { - if (base.find_among(a_0) == 0) + among_var = base.find_among(a_0); + if (among_var == 0) { break lab3; } + switch (among_var) { + case 1: + if (!(base.in_grouping(g_v, 97, 251))) + { + break lab3; + } + break; + } break lab1; } base.cursor = v_2; @@ -370,91 +433,41 @@ FrenchStemmer = function() { break lab0; } base.cursor++; - golab4: while(true) + if (!base.go_out_grouping(g_v, 97, 251)) { - lab5: { - if (!(base.in_grouping(g_v, 97, 251))) - { - break lab5; - } - break golab4; - } - if (base.cursor >= base.limit) - { - break lab0; - } - base.cursor++; + break lab0; } + base.cursor++; } I_pV = base.cursor; } base.cursor = v_1; - var /** number */ v_4 = base.cursor; - lab6: { - golab7: while(true) + /** @const */ var /** number */ v_3 = base.cursor; + lab4: { + if (!base.go_out_grouping(g_v, 97, 251)) { - lab8: { - if (!(base.in_grouping(g_v, 97, 251))) - { - break lab8; - } - break golab7; - } - if (base.cursor >= base.limit) - { - break lab6; - } - base.cursor++; + break lab4; } - golab9: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 251)) { - lab10: { - if (!(base.out_grouping(g_v, 97, 251))) - { - break lab10; - } - break golab9; - } - if (base.cursor >= base.limit) - { - break lab6; - } - base.cursor++; + break lab4; } + base.cursor++; I_p1 = base.cursor; - golab11: while(true) + if (!base.go_out_grouping(g_v, 97, 251)) { - lab12: { - if (!(base.in_grouping(g_v, 97, 251))) - { - break lab12; - } - break golab11; - } - if (base.cursor >= base.limit) - { - break lab6; - } - base.cursor++; + break lab4; } - golab13: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 251)) { - lab14: { - if (!(base.out_grouping(g_v, 97, 251))) - { - break lab14; - } - break golab13; - } - if (base.cursor >= base.limit) - { - break lab6; - } - base.cursor++; + break lab4; } + base.cursor++; I_p2 = base.cursor; } - base.cursor = v_4; + base.cursor = v_3; return true; }; @@ -463,14 +476,10 @@ FrenchStemmer = function() { var /** number */ among_var; while(true) { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_1); - if (among_var == 0) - { - break lab0; - } base.ket = base.cursor; switch (among_var) { case 1: @@ -527,29 +536,17 @@ FrenchStemmer = function() { /** @return {boolean} */ function r_RV() { - if (!(I_pV <= base.cursor)) - { - return false; - } - return true; + return I_pV <= base.cursor; }; /** @return {boolean} */ function r_R1() { - if (!(I_p1 <= base.cursor)) - { - return false; - } - return true; + return I_p1 <= base.cursor; }; /** @return {boolean} */ function r_R2() { - if (!(I_p2 <= base.cursor)) - { - return false; - } - return true; + return I_p2 <= base.cursor; }; /** @return {boolean} */ @@ -582,7 +579,7 @@ FrenchStemmer = function() { { return false; } - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("ic"))) @@ -592,7 +589,7 @@ FrenchStemmer = function() { } base.bra = base.cursor; lab1: { - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab2: { if (!r_R2()) { @@ -651,7 +648,7 @@ FrenchStemmer = function() { { return false; } - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab3: { base.ket = base.cursor; among_var = base.find_among_b(a_2); @@ -691,7 +688,7 @@ FrenchStemmer = function() { break; case 2: lab4: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab5: { if (!r_R2()) { @@ -749,7 +746,7 @@ FrenchStemmer = function() { { return false; } - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab6: { base.ket = base.cursor; among_var = base.find_among_b(a_3); @@ -762,7 +759,7 @@ FrenchStemmer = function() { switch (among_var) { case 1: lab7: { - var /** number */ v_6 = base.limit - base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; lab8: { if (!r_R2()) { @@ -783,7 +780,7 @@ FrenchStemmer = function() { break; case 2: lab9: { - var /** number */ v_7 = base.limit - base.cursor; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; lab10: { if (!r_R2()) { @@ -825,7 +822,7 @@ FrenchStemmer = function() { { return false; } - var /** number */ v_8 = base.limit - base.cursor; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; lab11: { base.ket = base.cursor; if (!(base.eq_s_b("at"))) @@ -851,7 +848,7 @@ FrenchStemmer = function() { } base.bra = base.cursor; lab12: { - var /** number */ v_9 = base.limit - base.cursor; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; lab13: { if (!r_R2()) { @@ -888,8 +885,18 @@ FrenchStemmer = function() { } break; case 11: + if (!(base.in_grouping_b(g_oux_ending, 98, 112))) + { + return false; + } + if (!base.slice_from("ou")) + { + return false; + } + break; + case 12: lab14: { - var /** number */ v_10 = base.limit - base.cursor; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; lab15: { if (!r_R2()) { @@ -912,7 +919,7 @@ FrenchStemmer = function() { } } break; - case 12: + case 13: if (!r_R1()) { return false; @@ -926,7 +933,7 @@ FrenchStemmer = function() { return false; } break; - case 13: + case 14: if (!r_RV()) { return false; @@ -936,7 +943,7 @@ FrenchStemmer = function() { return false; } return false; - case 14: + case 15: if (!r_RV()) { return false; @@ -946,8 +953,8 @@ FrenchStemmer = function() { return false; } return false; - case 15: - var /** number */ v_11 = base.limit - base.cursor; + case 16: + /** @const */ var /** number */ v_11 = base.limit - base.cursor; if (!(base.in_grouping_b(g_v, 97, 251))) { return false; @@ -972,37 +979,37 @@ FrenchStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; if (base.find_among_b(a_5) == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("H"))) { break lab0; } - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; } if (!(base.out_grouping_b(g_v, 97, 251))) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } if (!base.slice_del()) { return false; } - base.limit_backward = v_2; + base.limit_backward = v_1; return true; }; @@ -1013,21 +1020,21 @@ FrenchStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; - among_var = base.find_among_b(a_6); + among_var = base.find_among_b(a_7); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; + base.limit_backward = v_1; switch (among_var) { case 1: if (!r_R2()) { - base.limit_backward = v_2; return false; } if (!base.slice_del()) @@ -1042,34 +1049,64 @@ FrenchStemmer = function() { } break; case 3: - if (!base.slice_del()) - { - return false; - } - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab0: { - base.ket = base.cursor; if (!(base.eq_s_b("e"))) { - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; break lab0; } - base.bra = base.cursor; - if (!base.slice_del()) + if (!r_RV()) { + base.cursor = base.limit - v_2; + break lab0; + } + base.bra = base.cursor; + } + if (!base.slice_del()) + { + return false; + } + break; + case 4: + { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab1: { + among_var = base.find_among_b(a_6); + if (among_var == 0) + { + break lab1; + } + switch (among_var) { + case 1: + if (base.cursor <= base.limit_backward) + { + break lab1; + } + base.cursor--; + if (base.cursor > base.limit_backward) + { + break lab1; + } + break; + } return false; } + base.cursor = base.limit - v_3; + } + if (!base.slice_del()) + { + return false; } break; } - base.limit_backward = v_2; return true; }; /** @return {boolean} */ function r_residual_suffix() { var /** number */ among_var; - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("s"))) @@ -1078,9 +1115,9 @@ FrenchStemmer = function() { break lab0; } base.bra = base.cursor; - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab1: { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab2: { if (!(base.eq_s_b("Hi"))) { @@ -1105,13 +1142,13 @@ FrenchStemmer = function() { { return false; } - var /** number */ v_5 = base.limit_backward; + /** @const */ var /** number */ v_4 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; - among_var = base.find_among_b(a_7); + among_var = base.find_among_b(a_8); if (among_var == 0) { - base.limit_backward = v_5; + base.limit_backward = v_4; return false; } base.bra = base.cursor; @@ -1119,11 +1156,11 @@ FrenchStemmer = function() { case 1: if (!r_R2()) { - base.limit_backward = v_5; + base.limit_backward = v_4; return false; } lab3: { - var /** number */ v_6 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab4: { if (!(base.eq_s_b("s"))) { @@ -1131,10 +1168,10 @@ FrenchStemmer = function() { } break lab3; } - base.cursor = base.limit - v_6; + base.cursor = base.limit - v_5; if (!(base.eq_s_b("t"))) { - base.limit_backward = v_5; + base.limit_backward = v_4; return false; } } @@ -1156,14 +1193,14 @@ FrenchStemmer = function() { } break; } - base.limit_backward = v_5; + base.limit_backward = v_4; return true; }; /** @return {boolean} */ function r_un_double() { - var /** number */ v_1 = base.limit - base.cursor; - if (base.find_among_b(a_8) == 0) + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + if (base.find_among_b(a_9) == 0) { return false; } @@ -1205,7 +1242,7 @@ FrenchStemmer = function() { } base.ket = base.cursor; lab1: { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab2: { if (!(base.eq_s_b("\u00E9"))) { @@ -1213,7 +1250,7 @@ FrenchStemmer = function() { } break lab1; } - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; if (!(base.eq_s_b("\u00E8"))) { return false; @@ -1228,19 +1265,22 @@ FrenchStemmer = function() { }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; - r_prelude(); + /** @const */ var /** number */ v_1 = base.cursor; + r_elisions(); base.cursor = v_1; + /** @const */ var /** number */ v_2 = base.cursor; + r_prelude(); + base.cursor = v_2; r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab0: { lab1: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab2: { - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab3: { - var /** number */ v_6 = base.limit - base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; lab4: { if (!r_standard_suffix()) { @@ -1263,11 +1303,11 @@ FrenchStemmer = function() { } } base.cursor = base.limit - v_5; - var /** number */ v_7 = base.limit - base.cursor; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; lab6: { base.ket = base.cursor; lab7: { - var /** number */ v_8 = base.limit - base.cursor; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; lab8: { if (!(base.eq_s_b("Y"))) { @@ -1303,14 +1343,14 @@ FrenchStemmer = function() { } } base.cursor = base.limit - v_3; - var /** number */ v_9 = base.limit - base.cursor; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; r_un_double(); base.cursor = base.limit - v_9; - var /** number */ v_10 = base.limit - base.cursor; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; r_un_accent(); base.cursor = base.limit - v_10; base.cursor = base.limit_backward; - var /** number */ v_11 = base.cursor; + /** @const */ var /** number */ v_11 = base.cursor; r_postlude(); base.cursor = v_11; return true; diff --git a/sphinx/search/non-minified-js/german-stemmer.js b/sphinx/search/non-minified-js/german-stemmer.js index f5ff81bc9d7..007a8668575 100644 --- a/sphinx/search/non-minified-js/german-stemmer.js +++ b/sphinx/search/non-minified-js/german-stemmer.js @@ -1,9 +1,19 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from german.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -GermanStemmer = function() { +var GermanStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ + ["", -1, 5], + ["ae", 0, 2], + ["oe", 0, 3], + ["qu", 0, -1], + ["ue", 0, 4], + ["\u00DF", 0, 1] + ]; + + /** @const */ var a_1 = [ ["", -1, 5], ["U", 0, 2], ["Y", 0, 1], @@ -12,29 +22,42 @@ GermanStemmer = function() { ["\u00FC", 0, 2] ]; - /** @const */ var a_1 = [ - ["e", -1, 2], + /** @const */ var a_2 = [ + ["e", -1, 3], ["em", -1, 1], - ["en", -1, 2], - ["ern", -1, 1], - ["er", -1, 1], - ["s", -1, 3], - ["es", 5, 2] + ["en", -1, 3], + ["erinnen", 2, 2], + ["erin", -1, 2], + ["ln", -1, 5], + ["ern", -1, 2], + ["er", -1, 2], + ["s", -1, 4], + ["es", 8, 3], + ["lns", 8, 5] ]; - /** @const */ var a_2 = [ + /** @const */ var a_3 = [ + ["tick", -1, -1], + ["plan", -1, -1], + ["geordn", -1, -1], + ["intern", -1, -1], + ["tr", -1, -1] + ]; + + /** @const */ var a_4 = [ ["en", -1, 1], ["er", -1, 1], + ["et", -1, 3], ["st", -1, 2], - ["est", 2, 1] + ["est", 3, 1] ]; - /** @const */ var a_3 = [ + /** @const */ var a_5 = [ ["ig", -1, 1], ["lich", -1, 1] ]; - /** @const */ var a_4 = [ + /** @const */ var a_6 = [ ["end", -1, 1], ["ig", -1, 2], ["ung", -1, 1], @@ -47,6 +70,8 @@ GermanStemmer = function() { /** @const */ var /** Array */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8, 0, 32, 8]; + /** @const */ var /** Array */ g_et_ending = [1, 128, 198, 227, 32, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; + /** @const */ var /** Array */ g_s_ending = [117, 30, 5]; /** @const */ var /** Array */ g_st_ending = [117, 30, 4]; @@ -58,98 +83,113 @@ GermanStemmer = function() { /** @return {boolean} */ function r_prelude() { - var /** number */ v_1 = base.cursor; + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.cursor; while(true) { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab0: { - lab1: { - var /** number */ v_3 = base.cursor; - lab2: { - base.bra = base.cursor; - if (!(base.eq_s("\u00DF"))) - { - break lab2; - } - base.ket = base.cursor; - if (!base.slice_from("ss")) - { - return false; - } - break lab1; - } - base.cursor = v_3; - if (base.cursor >= base.limit) - { - break lab0; - } - base.cursor++; - } - continue; - } - base.cursor = v_2; - break; - } - base.cursor = v_1; - while(true) - { - var /** number */ v_4 = base.cursor; - lab3: { - golab4: while(true) + golab1: while(true) { - var /** number */ v_5 = base.cursor; - lab5: { + /** @const */ var /** number */ v_3 = base.cursor; + lab2: { if (!(base.in_grouping(g_v, 97, 252))) { - break lab5; + break lab2; } base.bra = base.cursor; - lab6: { - var /** number */ v_6 = base.cursor; - lab7: { + lab3: { + /** @const */ var /** number */ v_4 = base.cursor; + lab4: { if (!(base.eq_s("u"))) { - break lab7; + break lab4; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 252))) { - break lab7; + break lab4; } if (!base.slice_from("U")) { return false; } - break lab6; + break lab3; } - base.cursor = v_6; + base.cursor = v_4; if (!(base.eq_s("y"))) { - break lab5; + break lab2; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 252))) { - break lab5; + break lab2; } if (!base.slice_from("Y")) { return false; } } - base.cursor = v_5; - break golab4; + base.cursor = v_3; + break golab1; } - base.cursor = v_5; + base.cursor = v_3; if (base.cursor >= base.limit) { - break lab3; + break lab0; } base.cursor++; } continue; } - base.cursor = v_4; + base.cursor = v_2; + break; + } + base.cursor = v_1; + while(true) + { + /** @const */ var /** number */ v_5 = base.cursor; + lab5: { + base.bra = base.cursor; + among_var = base.find_among(a_0); + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("ss")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u00E4")) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u00F6")) + { + return false; + } + break; + case 4: + if (!base.slice_from("\u00FC")) + { + return false; + } + break; + case 5: + if (base.cursor >= base.limit) + { + break lab5; + } + base.cursor++; + break; + } + continue; + } + base.cursor = v_5; break; } return true; @@ -159,9 +199,9 @@ GermanStemmer = function() { function r_mark_regions() { I_p1 = base.limit; I_p2 = base.limit; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; { - var /** number */ c1 = base.cursor + 3; + /** @const */ var /** number */ c1 = base.cursor + 3; if (c1 > base.limit) { return false; @@ -170,74 +210,34 @@ GermanStemmer = function() { } I_x = base.cursor; base.cursor = v_1; - golab0: while(true) + if (!base.go_out_grouping(g_v, 97, 252)) { - lab1: { - if (!(base.in_grouping(g_v, 97, 252))) - { - break lab1; - } - break golab0; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } - golab2: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 252)) { - lab3: { - if (!(base.out_grouping(g_v, 97, 252))) - { - break lab3; - } - break golab2; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } + base.cursor++; I_p1 = base.cursor; - lab4: { - if (!(I_p1 < I_x)) + lab0: { + if (I_p1 >= I_x) { - break lab4; + break lab0; } I_p1 = I_x; } - golab5: while(true) + if (!base.go_out_grouping(g_v, 97, 252)) { - lab6: { - if (!(base.in_grouping(g_v, 97, 252))) - { - break lab6; - } - break golab5; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } - golab7: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 252)) { - lab8: { - if (!(base.out_grouping(g_v, 97, 252))) - { - break lab8; - } - break golab7; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } + base.cursor++; I_p2 = base.cursor; return true; }; @@ -247,14 +247,10 @@ GermanStemmer = function() { var /** number */ among_var; while(true) { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; - among_var = base.find_among(a_0); - if (among_var == 0) - { - break lab0; - } + among_var = base.find_among(a_1); base.ket = base.cursor; switch (among_var) { case 1: @@ -299,29 +295,21 @@ GermanStemmer = function() { /** @return {boolean} */ function r_R1() { - if (!(I_p1 <= base.cursor)) - { - return false; - } - return true; + return I_p1 <= base.cursor; }; /** @return {boolean} */ function r_R2() { - if (!(I_p2 <= base.cursor)) - { - return false; - } - return true; + return I_p2 <= base.cursor; }; /** @return {boolean} */ function r_standard_suffix() { var /** number */ among_var; - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; - among_var = base.find_among_b(a_1); + among_var = base.find_among_b(a_2); if (among_var == 0) { break lab0; @@ -333,6 +321,17 @@ GermanStemmer = function() { } switch (among_var) { case 1: + { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("syst"))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_2; + } if (!base.slice_del()) { return false; @@ -343,19 +342,25 @@ GermanStemmer = function() { { return false; } - var /** number */ v_2 = base.limit - base.cursor; - lab1: { + break; + case 3: + if (!base.slice_del()) + { + return false; + } + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab2: { base.ket = base.cursor; if (!(base.eq_s_b("s"))) { - base.cursor = base.limit - v_2; - break lab1; + base.cursor = base.limit - v_3; + break lab2; } base.bra = base.cursor; if (!(base.eq_s_b("nis"))) { - base.cursor = base.limit - v_2; - break lab1; + base.cursor = base.limit - v_3; + break lab2; } if (!base.slice_del()) { @@ -363,7 +368,7 @@ GermanStemmer = function() { } } break; - case 3: + case 4: if (!(base.in_grouping_b(g_s_ending, 98, 116))) { break lab0; @@ -373,21 +378,27 @@ GermanStemmer = function() { return false; } break; + case 5: + if (!base.slice_from("l")) + { + return false; + } + break; } } base.cursor = base.limit - v_1; - var /** number */ v_3 = base.limit - base.cursor; - lab2: { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab3: { base.ket = base.cursor; - among_var = base.find_among_b(a_2); + among_var = base.find_among_b(a_4); if (among_var == 0) { - break lab2; + break lab3; } base.bra = base.cursor; if (!r_R1()) { - break lab2; + break lab3; } switch (among_var) { case 1: @@ -399,13 +410,13 @@ GermanStemmer = function() { case 2: if (!(base.in_grouping_b(g_st_ending, 98, 116))) { - break lab2; + break lab3; } { - var /** number */ c1 = base.cursor - 3; + /** @const */ var /** number */ c1 = base.cursor - 3; if (c1 < base.limit_backward) { - break lab2; + break lab3; } base.cursor = c1; } @@ -414,21 +425,44 @@ GermanStemmer = function() { return false; } break; + case 3: + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + if (!(base.in_grouping_b(g_et_ending, 85, 228))) + { + break lab3; + } + base.cursor = base.limit - v_5; + { + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + lab4: { + if (base.find_among_b(a_3) == 0) + { + break lab4; + } + break lab3; + } + base.cursor = base.limit - v_6; + } + if (!base.slice_del()) + { + return false; + } + break; } } - base.cursor = base.limit - v_3; - var /** number */ v_4 = base.limit - base.cursor; - lab3: { + base.cursor = base.limit - v_4; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab5: { base.ket = base.cursor; - among_var = base.find_among_b(a_4); + among_var = base.find_among_b(a_6); if (among_var == 0) { - break lab3; + break lab5; } base.bra = base.cursor; if (!r_R2()) { - break lab3; + break lab5; } switch (among_var) { case 1: @@ -436,31 +470,31 @@ GermanStemmer = function() { { return false; } - var /** number */ v_5 = base.limit - base.cursor; - lab4: { + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + lab6: { base.ket = base.cursor; if (!(base.eq_s_b("ig"))) { - base.cursor = base.limit - v_5; - break lab4; + base.cursor = base.limit - v_8; + break lab6; } base.bra = base.cursor; { - var /** number */ v_6 = base.limit - base.cursor; - lab5: { + /** @const */ var /** number */ v_9 = base.limit - base.cursor; + lab7: { if (!(base.eq_s_b("e"))) { - break lab5; + break lab7; } - base.cursor = base.limit - v_5; - break lab4; + base.cursor = base.limit - v_8; + break lab6; } - base.cursor = base.limit - v_6; + base.cursor = base.limit - v_9; } if (!r_R2()) { - base.cursor = base.limit - v_5; - break lab4; + base.cursor = base.limit - v_8; + break lab6; } if (!base.slice_del()) { @@ -470,15 +504,15 @@ GermanStemmer = function() { break; case 2: { - var /** number */ v_7 = base.limit - base.cursor; - lab6: { + /** @const */ var /** number */ v_10 = base.limit - base.cursor; + lab8: { if (!(base.eq_s_b("e"))) { - break lab6; + break lab8; } - break lab3; + break lab5; } - base.cursor = base.limit - v_7; + base.cursor = base.limit - v_10; } if (!base.slice_del()) { @@ -490,30 +524,30 @@ GermanStemmer = function() { { return false; } - var /** number */ v_8 = base.limit - base.cursor; - lab7: { + /** @const */ var /** number */ v_11 = base.limit - base.cursor; + lab9: { base.ket = base.cursor; - lab8: { - var /** number */ v_9 = base.limit - base.cursor; - lab9: { + lab10: { + /** @const */ var /** number */ v_12 = base.limit - base.cursor; + lab11: { if (!(base.eq_s_b("er"))) { - break lab9; + break lab11; } - break lab8; + break lab10; } - base.cursor = base.limit - v_9; + base.cursor = base.limit - v_12; if (!(base.eq_s_b("en"))) { - base.cursor = base.limit - v_8; - break lab7; + base.cursor = base.limit - v_11; + break lab9; } } base.bra = base.cursor; if (!r_R1()) { - base.cursor = base.limit - v_8; - break lab7; + base.cursor = base.limit - v_11; + break lab9; } if (!base.slice_del()) { @@ -526,19 +560,19 @@ GermanStemmer = function() { { return false; } - var /** number */ v_10 = base.limit - base.cursor; - lab10: { + /** @const */ var /** number */ v_13 = base.limit - base.cursor; + lab12: { base.ket = base.cursor; - if (base.find_among_b(a_3) == 0) + if (base.find_among_b(a_5) == 0) { - base.cursor = base.limit - v_10; - break lab10; + base.cursor = base.limit - v_13; + break lab12; } base.bra = base.cursor; if (!r_R2()) { - base.cursor = base.limit - v_10; - break lab10; + base.cursor = base.limit - v_13; + break lab12; } if (!base.slice_del()) { @@ -548,23 +582,23 @@ GermanStemmer = function() { break; } } - base.cursor = base.limit - v_4; + base.cursor = base.limit - v_7; return true; }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; r_prelude(); base.cursor = v_1; - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; r_mark_regions(); base.cursor = v_2; base.limit_backward = base.cursor; base.cursor = base.limit; r_standard_suffix(); base.cursor = base.limit_backward; - var /** number */ v_4 = base.cursor; + /** @const */ var /** number */ v_3 = base.cursor; r_postlude(); - base.cursor = v_4; + base.cursor = v_3; return true; }; diff --git a/sphinx/search/non-minified-js/greek-stemmer.js b/sphinx/search/non-minified-js/greek-stemmer.js new file mode 100644 index 00000000000..06ad1692fb1 --- /dev/null +++ b/sphinx/search/non-minified-js/greek-stemmer.js @@ -0,0 +1,2873 @@ +// Generated from greek.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var GreekStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["", -1, 25], + ["\u0386", 0, 1], + ["\u0388", 0, 5], + ["\u0389", 0, 7], + ["\u038A", 0, 9], + ["\u038C", 0, 15], + ["\u038E", 0, 20], + ["\u038F", 0, 24], + ["\u0390", 0, 7], + ["\u0391", 0, 1], + ["\u0392", 0, 2], + ["\u0393", 0, 3], + ["\u0394", 0, 4], + ["\u0395", 0, 5], + ["\u0396", 0, 6], + ["\u0397", 0, 7], + ["\u0398", 0, 8], + ["\u0399", 0, 9], + ["\u039A", 0, 10], + ["\u039B", 0, 11], + ["\u039C", 0, 12], + ["\u039D", 0, 13], + ["\u039E", 0, 14], + ["\u039F", 0, 15], + ["\u03A0", 0, 16], + ["\u03A1", 0, 17], + ["\u03A3", 0, 18], + ["\u03A4", 0, 19], + ["\u03A5", 0, 20], + ["\u03A6", 0, 21], + ["\u03A7", 0, 22], + ["\u03A8", 0, 23], + ["\u03A9", 0, 24], + ["\u03AA", 0, 9], + ["\u03AB", 0, 20], + ["\u03AC", 0, 1], + ["\u03AD", 0, 5], + ["\u03AE", 0, 7], + ["\u03AF", 0, 9], + ["\u03B0", 0, 20], + ["\u03C2", 0, 18], + ["\u03CA", 0, 7], + ["\u03CB", 0, 20], + ["\u03CC", 0, 15], + ["\u03CD", 0, 20], + ["\u03CE", 0, 24] + ]; + + /** @const */ var a_1 = [ + ["\u03C3\u03BA\u03B1\u03B3\u03B9\u03B1", -1, 2], + ["\u03C6\u03B1\u03B3\u03B9\u03B1", -1, 1], + ["\u03BF\u03BB\u03BF\u03B3\u03B9\u03B1", -1, 3], + ["\u03C3\u03BF\u03B3\u03B9\u03B1", -1, 4], + ["\u03C4\u03B1\u03C4\u03BF\u03B3\u03B9\u03B1", -1, 5], + ["\u03BA\u03C1\u03B5\u03B1\u03C4\u03B1", -1, 6], + ["\u03C0\u03B5\u03C1\u03B1\u03C4\u03B1", -1, 7], + ["\u03C4\u03B5\u03C1\u03B1\u03C4\u03B1", -1, 8], + ["\u03B3\u03B5\u03B3\u03BF\u03BD\u03BF\u03C4\u03B1", -1, 11], + ["\u03BA\u03B1\u03B8\u03B5\u03C3\u03C4\u03C9\u03C4\u03B1", -1, 10], + ["\u03C6\u03C9\u03C4\u03B1", -1, 9], + ["\u03C0\u03B5\u03C1\u03B1\u03C4\u03B7", -1, 7], + ["\u03C3\u03BA\u03B1\u03B3\u03B9\u03C9\u03BD", -1, 2], + ["\u03C6\u03B1\u03B3\u03B9\u03C9\u03BD", -1, 1], + ["\u03BF\u03BB\u03BF\u03B3\u03B9\u03C9\u03BD", -1, 3], + ["\u03C3\u03BF\u03B3\u03B9\u03C9\u03BD", -1, 4], + ["\u03C4\u03B1\u03C4\u03BF\u03B3\u03B9\u03C9\u03BD", -1, 5], + ["\u03BA\u03C1\u03B5\u03B1\u03C4\u03C9\u03BD", -1, 6], + ["\u03C0\u03B5\u03C1\u03B1\u03C4\u03C9\u03BD", -1, 7], + ["\u03C4\u03B5\u03C1\u03B1\u03C4\u03C9\u03BD", -1, 8], + ["\u03B3\u03B5\u03B3\u03BF\u03BD\u03BF\u03C4\u03C9\u03BD", -1, 11], + ["\u03BA\u03B1\u03B8\u03B5\u03C3\u03C4\u03C9\u03C4\u03C9\u03BD", -1, 10], + ["\u03C6\u03C9\u03C4\u03C9\u03BD", -1, 9], + ["\u03BA\u03C1\u03B5\u03B1\u03C3", -1, 6], + ["\u03C0\u03B5\u03C1\u03B1\u03C3", -1, 7], + ["\u03C4\u03B5\u03C1\u03B1\u03C3", -1, 8], + ["\u03B3\u03B5\u03B3\u03BF\u03BD\u03BF\u03C3", -1, 11], + ["\u03BA\u03C1\u03B5\u03B1\u03C4\u03BF\u03C3", -1, 6], + ["\u03C0\u03B5\u03C1\u03B1\u03C4\u03BF\u03C3", -1, 7], + ["\u03C4\u03B5\u03C1\u03B1\u03C4\u03BF\u03C3", -1, 8], + ["\u03B3\u03B5\u03B3\u03BF\u03BD\u03BF\u03C4\u03BF\u03C3", -1, 11], + ["\u03BA\u03B1\u03B8\u03B5\u03C3\u03C4\u03C9\u03C4\u03BF\u03C3", -1, 10], + ["\u03C6\u03C9\u03C4\u03BF\u03C3", -1, 9], + ["\u03BA\u03B1\u03B8\u03B5\u03C3\u03C4\u03C9\u03C3", -1, 10], + ["\u03C6\u03C9\u03C3", -1, 9], + ["\u03C3\u03BA\u03B1\u03B3\u03B9\u03BF\u03C5", -1, 2], + ["\u03C6\u03B1\u03B3\u03B9\u03BF\u03C5", -1, 1], + ["\u03BF\u03BB\u03BF\u03B3\u03B9\u03BF\u03C5", -1, 3], + ["\u03C3\u03BF\u03B3\u03B9\u03BF\u03C5", -1, 4], + ["\u03C4\u03B1\u03C4\u03BF\u03B3\u03B9\u03BF\u03C5", -1, 5] + ]; + + /** @const */ var a_2 = [ + ["\u03C0\u03B1", -1, 1], + ["\u03BE\u03B1\u03BD\u03B1\u03C0\u03B1", 0, 1], + ["\u03B5\u03C0\u03B1", 0, 1], + ["\u03C0\u03B5\u03C1\u03B9\u03C0\u03B1", 0, 1], + ["\u03B1\u03BD\u03B1\u03BC\u03C0\u03B1", 0, 1], + ["\u03B5\u03BC\u03C0\u03B1", 0, 1], + ["\u03B2", -1, 2], + ["\u03B4\u03B1\u03BD\u03B5", -1, 1], + ["\u03B2\u03B1\u03B8\u03C5\u03C1\u03B9", -1, 2], + ["\u03B2\u03B1\u03C1\u03BA", -1, 2], + ["\u03BC\u03B1\u03C1\u03BA", -1, 2], + ["\u03BB", -1, 2], + ["\u03BC", -1, 2], + ["\u03BA\u03BF\u03C1\u03BD", -1, 2], + ["\u03B1\u03B8\u03C1\u03BF", -1, 1], + ["\u03C3\u03C5\u03BD\u03B1\u03B8\u03C1\u03BF", 14, 1], + ["\u03C0", -1, 2], + ["\u03B9\u03BC\u03C0", 16, 2], + ["\u03C1", -1, 2], + ["\u03BC\u03B1\u03C1", 18, 2], + ["\u03B1\u03BC\u03C0\u03B1\u03C1", 18, 2], + ["\u03B3\u03BA\u03C1", 18, 2], + ["\u03B2\u03BF\u03BB\u03B2\u03BF\u03C1", 18, 2], + ["\u03B3\u03BB\u03C5\u03BA\u03BF\u03C1", 18, 2], + ["\u03C0\u03B9\u03C0\u03B5\u03C1\u03BF\u03C1", 18, 2], + ["\u03C0\u03C1", 18, 2], + ["\u03BC\u03C0\u03C1", 25, 2], + ["\u03B1\u03C1\u03C1", 18, 2], + ["\u03B3\u03BB\u03C5\u03BA\u03C5\u03C1", 18, 2], + ["\u03C0\u03BF\u03BB\u03C5\u03C1", 18, 2], + ["\u03BB\u03BF\u03C5", -1, 2] + ]; + + /** @const */ var a_3 = [ + ["\u03B9\u03B6\u03B1", -1, 1], + ["\u03B9\u03B6\u03B5", -1, 1], + ["\u03B9\u03B6\u03B1\u03BC\u03B5", -1, 1], + ["\u03B9\u03B6\u03BF\u03C5\u03BC\u03B5", -1, 1], + ["\u03B9\u03B6\u03B1\u03BD\u03B5", -1, 1], + ["\u03B9\u03B6\u03BF\u03C5\u03BD\u03B5", -1, 1], + ["\u03B9\u03B6\u03B1\u03C4\u03B5", -1, 1], + ["\u03B9\u03B6\u03B5\u03C4\u03B5", -1, 1], + ["\u03B9\u03B6\u03B5\u03B9", -1, 1], + ["\u03B9\u03B6\u03B1\u03BD", -1, 1], + ["\u03B9\u03B6\u03BF\u03C5\u03BD", -1, 1], + ["\u03B9\u03B6\u03B5\u03C3", -1, 1], + ["\u03B9\u03B6\u03B5\u03B9\u03C3", -1, 1], + ["\u03B9\u03B6\u03C9", -1, 1] + ]; + + /** @const */ var a_4 = [ + ["\u03B2\u03B9", -1, 1], + ["\u03BB\u03B9", -1, 1], + ["\u03B1\u03BB", -1, 1], + ["\u03B5\u03BD", -1, 1], + ["\u03C3", -1, 1], + ["\u03C7", -1, 1], + ["\u03C5\u03C8", -1, 1], + ["\u03B6\u03C9", -1, 1] + ]; + + /** @const */ var a_5 = [ + ["\u03C9\u03B8\u03B7\u03BA\u03B1", -1, 1], + ["\u03C9\u03B8\u03B7\u03BA\u03B5", -1, 1], + ["\u03C9\u03B8\u03B7\u03BA\u03B1\u03BC\u03B5", -1, 1], + ["\u03C9\u03B8\u03B7\u03BA\u03B1\u03BD\u03B5", -1, 1], + ["\u03C9\u03B8\u03B7\u03BA\u03B1\u03C4\u03B5", -1, 1], + ["\u03C9\u03B8\u03B7\u03BA\u03B1\u03BD", -1, 1], + ["\u03C9\u03B8\u03B7\u03BA\u03B5\u03C3", -1, 1] + ]; + + /** @const */ var a_6 = [ + ["\u03BE\u03B1\u03BD\u03B1\u03C0\u03B1", -1, 1], + ["\u03B5\u03C0\u03B1", -1, 1], + ["\u03C0\u03B5\u03C1\u03B9\u03C0\u03B1", -1, 1], + ["\u03B1\u03BD\u03B1\u03BC\u03C0\u03B1", -1, 1], + ["\u03B5\u03BC\u03C0\u03B1", -1, 1], + ["\u03C7\u03B1\u03C1\u03C4\u03BF\u03C0\u03B1", -1, 1], + ["\u03B5\u03BE\u03B1\u03C1\u03C7\u03B1", -1, 1], + ["\u03B3\u03B5", -1, 2], + ["\u03B3\u03BA\u03B5", -1, 2], + ["\u03BA\u03BB\u03B5", -1, 1], + ["\u03B5\u03BA\u03BB\u03B5", 9, 1], + ["\u03B1\u03C0\u03B5\u03BA\u03BB\u03B5", 10, 1], + ["\u03B1\u03C0\u03BF\u03BA\u03BB\u03B5", 9, 1], + ["\u03B5\u03C3\u03C9\u03BA\u03BB\u03B5", 9, 1], + ["\u03B4\u03B1\u03BD\u03B5", -1, 1], + ["\u03C0\u03B5", -1, 1], + ["\u03B5\u03C0\u03B5", 15, 1], + ["\u03BC\u03B5\u03C4\u03B5\u03C0\u03B5", 16, 1], + ["\u03B5\u03C3\u03B5", -1, 1], + ["\u03B3\u03BA", -1, 2], + ["\u03BC", -1, 2], + ["\u03C0\u03BF\u03C5\u03BA\u03B1\u03BC", 20, 2], + ["\u03BA\u03BF\u03BC", 20, 2], + ["\u03B1\u03BD", -1, 2], + ["\u03BF\u03BB\u03BF", -1, 2], + ["\u03B1\u03B8\u03C1\u03BF", -1, 1], + ["\u03C3\u03C5\u03BD\u03B1\u03B8\u03C1\u03BF", 25, 1], + ["\u03C0", -1, 2], + ["\u03BB\u03B1\u03C1", -1, 2], + ["\u03B4\u03B7\u03BC\u03BF\u03BA\u03C1\u03B1\u03C4", -1, 2], + ["\u03B1\u03C6", -1, 2], + ["\u03B3\u03B9\u03B3\u03B1\u03BD\u03C4\u03BF\u03B1\u03C6", 30, 2] + ]; + + /** @const */ var a_7 = [ + ["\u03B9\u03C3\u03B1", -1, 1], + ["\u03B9\u03C3\u03B1\u03BC\u03B5", -1, 1], + ["\u03B9\u03C3\u03B1\u03BD\u03B5", -1, 1], + ["\u03B9\u03C3\u03B5", -1, 1], + ["\u03B9\u03C3\u03B1\u03C4\u03B5", -1, 1], + ["\u03B9\u03C3\u03B1\u03BD", -1, 1], + ["\u03B9\u03C3\u03B5\u03C3", -1, 1] + ]; + + /** @const */ var a_8 = [ + ["\u03BE\u03B1\u03BD\u03B1\u03C0\u03B1", -1, 1], + ["\u03B5\u03C0\u03B1", -1, 1], + ["\u03C0\u03B5\u03C1\u03B9\u03C0\u03B1", -1, 1], + ["\u03B1\u03BD\u03B1\u03BC\u03C0\u03B1", -1, 1], + ["\u03B5\u03BC\u03C0\u03B1", -1, 1], + ["\u03C7\u03B1\u03C1\u03C4\u03BF\u03C0\u03B1", -1, 1], + ["\u03B5\u03BE\u03B1\u03C1\u03C7\u03B1", -1, 1], + ["\u03BA\u03BB\u03B5", -1, 1], + ["\u03B5\u03BA\u03BB\u03B5", 7, 1], + ["\u03B1\u03C0\u03B5\u03BA\u03BB\u03B5", 8, 1], + ["\u03B1\u03C0\u03BF\u03BA\u03BB\u03B5", 7, 1], + ["\u03B5\u03C3\u03C9\u03BA\u03BB\u03B5", 7, 1], + ["\u03B4\u03B1\u03BD\u03B5", -1, 1], + ["\u03C0\u03B5", -1, 1], + ["\u03B5\u03C0\u03B5", 13, 1], + ["\u03BC\u03B5\u03C4\u03B5\u03C0\u03B5", 14, 1], + ["\u03B5\u03C3\u03B5", -1, 1], + ["\u03B1\u03B8\u03C1\u03BF", -1, 1], + ["\u03C3\u03C5\u03BD\u03B1\u03B8\u03C1\u03BF", 17, 1] + ]; + + /** @const */ var a_9 = [ + ["\u03B9\u03C3\u03BF\u03C5\u03BC\u03B5", -1, 1], + ["\u03B9\u03C3\u03BF\u03C5\u03BD\u03B5", -1, 1], + ["\u03B9\u03C3\u03B5\u03C4\u03B5", -1, 1], + ["\u03B9\u03C3\u03B5\u03B9", -1, 1], + ["\u03B9\u03C3\u03BF\u03C5\u03BD", -1, 1], + ["\u03B9\u03C3\u03B5\u03B9\u03C3", -1, 1], + ["\u03B9\u03C3\u03C9", -1, 1] + ]; + + /** @const */ var a_10 = [ + ["\u03B1\u03C4\u03B1", -1, 2], + ["\u03C6\u03B1", -1, 2], + ["\u03B7\u03C6\u03B1", 1, 2], + ["\u03BC\u03B5\u03B3", -1, 2], + ["\u03BB\u03C5\u03B3", -1, 2], + ["\u03B7\u03B4", -1, 2], + ["\u03BA\u03BB\u03B5", -1, 1], + ["\u03B5\u03C3\u03C9\u03BA\u03BB\u03B5", 6, 1], + ["\u03C0\u03BB\u03B5", -1, 1], + ["\u03B4\u03B1\u03BD\u03B5", -1, 1], + ["\u03C3\u03B5", -1, 1], + ["\u03B1\u03C3\u03B5", 10, 1], + ["\u03BA\u03B1\u03B8", -1, 2], + ["\u03B5\u03C7\u03B8", -1, 2], + ["\u03BA\u03B1\u03BA", -1, 2], + ["\u03BC\u03B1\u03BA", -1, 2], + ["\u03C3\u03BA", -1, 2], + ["\u03C6\u03B9\u03BB", -1, 2], + ["\u03BA\u03C5\u03BB", -1, 2], + ["\u03BC", -1, 2], + ["\u03B3\u03B5\u03BC", 19, 2], + ["\u03B1\u03C7\u03BD", -1, 2], + ["\u03C3\u03C5\u03BD\u03B1\u03B8\u03C1\u03BF", -1, 1], + ["\u03C0", -1, 2], + ["\u03B1\u03C0", 23, 2], + ["\u03B5\u03BC\u03C0", 23, 2], + ["\u03B5\u03C5\u03C0", 23, 2], + ["\u03B1\u03C1", -1, 2], + ["\u03B1\u03BF\u03C1", -1, 2], + ["\u03B3\u03C5\u03C1", -1, 2], + ["\u03C7\u03C1", -1, 2], + ["\u03C7\u03C9\u03C1", -1, 2], + ["\u03BA\u03C4", -1, 2], + ["\u03B1\u03BA\u03C4", 32, 2], + ["\u03C7\u03C4", -1, 2], + ["\u03B1\u03C7\u03C4", 34, 2], + ["\u03C4\u03B1\u03C7", -1, 2], + ["\u03C3\u03C7", -1, 2], + ["\u03B1\u03C3\u03C7", 37, 2], + ["\u03C5\u03C8", -1, 2] + ]; + + /** @const */ var a_11 = [ + ["\u03B9\u03C3\u03C4\u03B1", -1, 1], + ["\u03B9\u03C3\u03C4\u03B5", -1, 1], + ["\u03B9\u03C3\u03C4\u03B7", -1, 1], + ["\u03B9\u03C3\u03C4\u03BF\u03B9", -1, 1], + ["\u03B9\u03C3\u03C4\u03C9\u03BD", -1, 1], + ["\u03B9\u03C3\u03C4\u03BF", -1, 1], + ["\u03B9\u03C3\u03C4\u03B5\u03C3", -1, 1], + ["\u03B9\u03C3\u03C4\u03B7\u03C3", -1, 1], + ["\u03B9\u03C3\u03C4\u03BF\u03C3", -1, 1], + ["\u03B9\u03C3\u03C4\u03BF\u03C5\u03C3", -1, 1], + ["\u03B9\u03C3\u03C4\u03BF\u03C5", -1, 1] + ]; + + /** @const */ var a_12 = [ + ["\u03B5\u03B3\u03BA\u03BB\u03B5", -1, 1], + ["\u03B1\u03C0\u03BF\u03BA\u03BB\u03B5", -1, 1], + ["\u03B4\u03B1\u03BD\u03B5", -1, 2], + ["\u03B1\u03BD\u03C4\u03B9\u03B4\u03B1\u03BD\u03B5", 2, 2], + ["\u03C3\u03B5", -1, 1], + ["\u03BC\u03B5\u03C4\u03B1\u03C3\u03B5", 4, 1], + ["\u03BC\u03B9\u03BA\u03C1\u03BF\u03C3\u03B5", 4, 1] + ]; + + /** @const */ var a_13 = [ + ["\u03B1\u03C4\u03BF\u03BC\u03B9\u03BA", -1, 2], + ["\u03B5\u03B8\u03BD\u03B9\u03BA", -1, 4], + ["\u03C4\u03BF\u03C0\u03B9\u03BA", -1, 7], + ["\u03B5\u03BA\u03BB\u03B5\u03BA\u03C4\u03B9\u03BA", -1, 5], + ["\u03C3\u03BA\u03B5\u03C0\u03C4\u03B9\u03BA", -1, 6], + ["\u03B3\u03BD\u03C9\u03C3\u03C4\u03B9\u03BA", -1, 3], + ["\u03B1\u03B3\u03BD\u03C9\u03C3\u03C4\u03B9\u03BA", 5, 1], + ["\u03B1\u03BB\u03B5\u03BE\u03B1\u03BD\u03B4\u03C1\u03B9\u03BD", -1, 8], + ["\u03B8\u03B5\u03B1\u03C4\u03C1\u03B9\u03BD", -1, 10], + ["\u03B2\u03C5\u03B6\u03B1\u03BD\u03C4\u03B9\u03BD", -1, 9] + ]; + + /** @const */ var a_14 = [ + ["\u03B9\u03C3\u03BC\u03BF\u03B9", -1, 1], + ["\u03B9\u03C3\u03BC\u03C9\u03BD", -1, 1], + ["\u03B9\u03C3\u03BC\u03BF", -1, 1], + ["\u03B9\u03C3\u03BC\u03BF\u03C3", -1, 1], + ["\u03B9\u03C3\u03BC\u03BF\u03C5\u03C3", -1, 1], + ["\u03B9\u03C3\u03BC\u03BF\u03C5", -1, 1] + ]; + + /** @const */ var a_15 = [ + ["\u03C3", -1, 1], + ["\u03C7", -1, 1] + ]; + + /** @const */ var a_16 = [ + ["\u03BF\u03C5\u03B4\u03B1\u03BA\u03B9\u03B1", -1, 1], + ["\u03B1\u03C1\u03B1\u03BA\u03B9\u03B1", -1, 1], + ["\u03BF\u03C5\u03B4\u03B1\u03BA\u03B9", -1, 1], + ["\u03B1\u03C1\u03B1\u03BA\u03B9", -1, 1] + ]; + + /** @const */ var a_17 = [ + ["\u03B2", -1, 2], + ["\u03B2\u03B1\u03BC\u03B2", 0, 1], + ["\u03C3\u03BB\u03BF\u03B2", 0, 1], + ["\u03C4\u03C3\u03B5\u03C7\u03BF\u03C3\u03BB\u03BF\u03B2", 2, 1], + ["\u03BA\u03B1\u03C1\u03B4", -1, 2], + ["\u03B6", -1, 2], + ["\u03C4\u03B6", 5, 1], + ["\u03BA", -1, 1], + ["\u03BA\u03B1\u03C0\u03B1\u03BA", 7, 1], + ["\u03C3\u03BF\u03BA", 7, 1], + ["\u03C3\u03BA", 7, 1], + ["\u03B2\u03B1\u03BB", -1, 2], + ["\u03BC\u03B1\u03BB", -1, 1], + ["\u03B3\u03BB", -1, 2], + ["\u03C4\u03C1\u03B9\u03C0\u03BF\u03BB", -1, 2], + ["\u03C0\u03BB", -1, 1], + ["\u03BB\u03BF\u03C5\u03BB", -1, 1], + ["\u03C6\u03C5\u03BB", -1, 1], + ["\u03BA\u03B1\u03B9\u03BC", -1, 1], + ["\u03BA\u03BB\u03B9\u03BC", -1, 1], + ["\u03C6\u03B1\u03C1\u03BC", -1, 1], + ["\u03B3\u03B9\u03B1\u03BD", -1, 2], + ["\u03C3\u03C0\u03B1\u03BD", -1, 1], + ["\u03B7\u03B3\u03BF\u03C5\u03BC\u03B5\u03BD", -1, 2], + ["\u03BA\u03BF\u03BD", -1, 1], + ["\u03BC\u03B1\u03BA\u03C1\u03C5\u03BD", -1, 2], + ["\u03C0", -1, 2], + ["\u03BA\u03B1\u03C4\u03C1\u03B1\u03C0", 26, 1], + ["\u03C1", -1, 1], + ["\u03B2\u03C1", 28, 1], + ["\u03BB\u03B1\u03B2\u03C1", 29, 1], + ["\u03B1\u03BC\u03B2\u03C1", 29, 1], + ["\u03BC\u03B5\u03C1", 28, 1], + ["\u03C0\u03B1\u03C4\u03B5\u03C1", 28, 2], + ["\u03B1\u03BD\u03B8\u03C1", 28, 1], + ["\u03BA\u03BF\u03C1", 28, 1], + ["\u03C3", -1, 1], + ["\u03BD\u03B1\u03B3\u03BA\u03B1\u03C3", 36, 1], + ["\u03C4\u03BF\u03C3", 36, 2], + ["\u03BC\u03BF\u03C5\u03C3\u03C4", -1, 1], + ["\u03C1\u03C5", -1, 1], + ["\u03C6", -1, 1], + ["\u03C3\u03C6", 41, 1], + ["\u03B1\u03BB\u03B9\u03C3\u03C6", 42, 1], + ["\u03BD\u03C5\u03C6", 41, 2], + ["\u03C7", -1, 1] + ]; + + /** @const */ var a_18 = [ + ["\u03B1\u03BA\u03B9\u03B1", -1, 1], + ["\u03B1\u03C1\u03B1\u03BA\u03B9\u03B1", 0, 1], + ["\u03B9\u03C4\u03C3\u03B1", -1, 1], + ["\u03B1\u03BA\u03B9", -1, 1], + ["\u03B1\u03C1\u03B1\u03BA\u03B9", 3, 1], + ["\u03B9\u03C4\u03C3\u03C9\u03BD", -1, 1], + ["\u03B9\u03C4\u03C3\u03B1\u03C3", -1, 1], + ["\u03B9\u03C4\u03C3\u03B5\u03C3", -1, 1] + ]; + + /** @const */ var a_19 = [ + ["\u03C8\u03B1\u03BB", -1, 1], + ["\u03B1\u03B9\u03C6\u03BD", -1, 1], + ["\u03BF\u03BB\u03BF", -1, 1], + ["\u03B9\u03C1", -1, 1] + ]; + + /** @const */ var a_20 = [ + ["\u03B5", -1, 1], + ["\u03C0\u03B1\u03B9\u03C7\u03BD", -1, 1] + ]; + + /** @const */ var a_21 = [ + ["\u03B9\u03B4\u03B9\u03B1", -1, 1], + ["\u03B9\u03B4\u03B9\u03C9\u03BD", -1, 1], + ["\u03B9\u03B4\u03B9\u03BF", -1, 1] + ]; + + /** @const */ var a_22 = [ + ["\u03B9\u03B2", -1, 1], + ["\u03B4", -1, 1], + ["\u03C6\u03C1\u03B1\u03B3\u03BA", -1, 1], + ["\u03BB\u03C5\u03BA", -1, 1], + ["\u03BF\u03B2\u03B5\u03BB", -1, 1], + ["\u03BC\u03B7\u03BD", -1, 1], + ["\u03C1", -1, 1] + ]; + + /** @const */ var a_23 = [ + ["\u03B9\u03C3\u03BA\u03B5", -1, 1], + ["\u03B9\u03C3\u03BA\u03BF", -1, 1], + ["\u03B9\u03C3\u03BA\u03BF\u03C3", -1, 1], + ["\u03B9\u03C3\u03BA\u03BF\u03C5", -1, 1] + ]; + + /** @const */ var a_24 = [ + ["\u03B1\u03B4\u03C9\u03BD", -1, 1], + ["\u03B1\u03B4\u03B5\u03C3", -1, 1] + ]; + + /** @const */ var a_25 = [ + ["\u03B3\u03B9\u03B1\u03B3\u03B9", -1, -1], + ["\u03B8\u03B5\u03B9", -1, -1], + ["\u03BF\u03BA", -1, -1], + ["\u03BC\u03B1\u03BC", -1, -1], + ["\u03BC\u03B1\u03BD", -1, -1], + ["\u03BC\u03C0\u03B1\u03BC\u03C0", -1, -1], + ["\u03C0\u03B5\u03B8\u03B5\u03C1", -1, -1], + ["\u03C0\u03B1\u03C4\u03B5\u03C1", -1, -1], + ["\u03BA\u03C5\u03C1", -1, -1], + ["\u03BD\u03C4\u03B1\u03BD\u03C4", -1, -1] + ]; + + /** @const */ var a_26 = [ + ["\u03B5\u03B4\u03C9\u03BD", -1, 1], + ["\u03B5\u03B4\u03B5\u03C3", -1, 1] + ]; + + /** @const */ var a_27 = [ + ["\u03BC\u03B9\u03BB", -1, 1], + ["\u03B4\u03B1\u03C0", -1, 1], + ["\u03B3\u03B7\u03C0", -1, 1], + ["\u03B9\u03C0", -1, 1], + ["\u03B5\u03BC\u03C0", -1, 1], + ["\u03BF\u03C0", -1, 1], + ["\u03BA\u03C1\u03B1\u03C3\u03C0", -1, 1], + ["\u03C5\u03C0", -1, 1] + ]; + + /** @const */ var a_28 = [ + ["\u03BF\u03C5\u03B4\u03C9\u03BD", -1, 1], + ["\u03BF\u03C5\u03B4\u03B5\u03C3", -1, 1] + ]; + + /** @const */ var a_29 = [ + ["\u03C4\u03C1\u03B1\u03B3", -1, 1], + ["\u03C6\u03B5", -1, 1], + ["\u03BA\u03B1\u03BB\u03B9\u03B1\u03BA", -1, 1], + ["\u03B1\u03C1\u03BA", -1, 1], + ["\u03C3\u03BA", -1, 1], + ["\u03C0\u03B5\u03C4\u03B1\u03BB", -1, 1], + ["\u03B2\u03B5\u03BB", -1, 1], + ["\u03BB\u03BF\u03C5\u03BB", -1, 1], + ["\u03C6\u03BB", -1, 1], + ["\u03C7\u03BD", -1, 1], + ["\u03C0\u03BB\u03B5\u03BE", -1, 1], + ["\u03C3\u03C0", -1, 1], + ["\u03C6\u03C1", -1, 1], + ["\u03C3", -1, 1], + ["\u03BB\u03B9\u03C7", -1, 1] + ]; + + /** @const */ var a_30 = [ + ["\u03B5\u03C9\u03BD", -1, 1], + ["\u03B5\u03C9\u03C3", -1, 1] + ]; + + /** @const */ var a_31 = [ + ["\u03B4", -1, 1], + ["\u03B9\u03B4", 0, 1], + ["\u03B8", -1, 1], + ["\u03B3\u03B1\u03BB", -1, 1], + ["\u03B5\u03BB", -1, 1], + ["\u03BD", -1, 1], + ["\u03C0", -1, 1], + ["\u03C0\u03B1\u03C1", -1, 1] + ]; + + /** @const */ var a_32 = [ + ["\u03B9\u03B1", -1, 1], + ["\u03B9\u03C9\u03BD", -1, 1], + ["\u03B9\u03BF\u03C5", -1, 1] + ]; + + /** @const */ var a_33 = [ + ["\u03B9\u03BA\u03B1", -1, 1], + ["\u03B9\u03BA\u03C9\u03BD", -1, 1], + ["\u03B9\u03BA\u03BF", -1, 1], + ["\u03B9\u03BA\u03BF\u03C5", -1, 1] + ]; + + /** @const */ var a_34 = [ + ["\u03B1\u03B4", -1, 1], + ["\u03C3\u03C5\u03BD\u03B1\u03B4", 0, 1], + ["\u03BA\u03B1\u03C4\u03B1\u03B4", 0, 1], + ["\u03B1\u03BD\u03C4\u03B9\u03B4", -1, 1], + ["\u03B5\u03BD\u03B4", -1, 1], + ["\u03C6\u03C5\u03BB\u03BF\u03B4", -1, 1], + ["\u03C5\u03C0\u03BF\u03B4", -1, 1], + ["\u03C0\u03C1\u03C9\u03C4\u03BF\u03B4", -1, 1], + ["\u03B5\u03BE\u03C9\u03B4", -1, 1], + ["\u03B7\u03B8", -1, 1], + ["\u03B1\u03BD\u03B7\u03B8", 9, 1], + ["\u03BE\u03B9\u03BA", -1, 1], + ["\u03B1\u03BB", -1, 1], + ["\u03B1\u03BC\u03BC\u03BF\u03C7\u03B1\u03BB", 12, 1], + ["\u03C3\u03C5\u03BD\u03BF\u03BC\u03B7\u03BB", -1, 1], + ["\u03BC\u03C0\u03BF\u03BB", -1, 1], + ["\u03BC\u03BF\u03C5\u03BB", -1, 1], + ["\u03C4\u03C3\u03B1\u03BC", -1, 1], + ["\u03B2\u03C1\u03C9\u03BC", -1, 1], + ["\u03B1\u03BC\u03B1\u03BD", -1, 1], + ["\u03BC\u03C0\u03B1\u03BD", -1, 1], + ["\u03BA\u03B1\u03BB\u03BB\u03B9\u03BD", -1, 1], + ["\u03C0\u03BF\u03C3\u03C4\u03B5\u03BB\u03BD", -1, 1], + ["\u03C6\u03B9\u03BB\u03BF\u03BD", -1, 1], + ["\u03BA\u03B1\u03BB\u03C0", -1, 1], + ["\u03B3\u03B5\u03C1", -1, 1], + ["\u03C7\u03B1\u03C3", -1, 1], + ["\u03BC\u03C0\u03BF\u03C3", -1, 1], + ["\u03C0\u03BB\u03B9\u03B1\u03C4\u03C3", -1, 1], + ["\u03C0\u03B5\u03C4\u03C3", -1, 1], + ["\u03C0\u03B9\u03C4\u03C3", -1, 1], + ["\u03C6\u03C5\u03C3", -1, 1], + ["\u03BC\u03C0\u03B1\u03B3\u03B9\u03B1\u03C4", -1, 1], + ["\u03BD\u03B9\u03C4", -1, 1], + ["\u03C0\u03B9\u03BA\u03B1\u03BD\u03C4", -1, 1], + ["\u03C3\u03B5\u03C1\u03C4", -1, 1] + ]; + + /** @const */ var a_35 = [ + ["\u03B1\u03B3\u03B1\u03BC\u03B5", -1, 1], + ["\u03B7\u03BA\u03B1\u03BC\u03B5", -1, 1], + ["\u03B7\u03B8\u03B7\u03BA\u03B1\u03BC\u03B5", 1, 1], + ["\u03B7\u03C3\u03B1\u03BC\u03B5", -1, 1], + ["\u03BF\u03C5\u03C3\u03B1\u03BC\u03B5", -1, 1] + ]; + + /** @const */ var a_36 = [ + ["\u03B2\u03BF\u03C5\u03B2", -1, 1], + ["\u03BE\u03B5\u03B8", -1, 1], + ["\u03C0\u03B5\u03B8", -1, 1], + ["\u03B1\u03C0\u03BF\u03B8", -1, 1], + ["\u03B1\u03C0\u03BF\u03BA", -1, 1], + ["\u03BF\u03C5\u03BB", -1, 1], + ["\u03B1\u03BD\u03B1\u03C0", -1, 1], + ["\u03C0\u03B9\u03BA\u03C1", -1, 1], + ["\u03C0\u03BF\u03C4", -1, 1], + ["\u03B1\u03C0\u03BF\u03C3\u03C4", -1, 1], + ["\u03C7", -1, 1], + ["\u03C3\u03B9\u03C7", 10, 1] + ]; + + /** @const */ var a_37 = [ + ["\u03C4\u03C1", -1, 1], + ["\u03C4\u03C3", -1, 1] + ]; + + /** @const */ var a_38 = [ + ["\u03B1\u03B3\u03B1\u03BD\u03B5", -1, 1], + ["\u03B7\u03BA\u03B1\u03BD\u03B5", -1, 1], + ["\u03B7\u03B8\u03B7\u03BA\u03B1\u03BD\u03B5", 1, 1], + ["\u03B7\u03C3\u03B1\u03BD\u03B5", -1, 1], + ["\u03BF\u03C5\u03C3\u03B1\u03BD\u03B5", -1, 1], + ["\u03BF\u03BD\u03C4\u03B1\u03BD\u03B5", -1, 1], + ["\u03B9\u03BF\u03BD\u03C4\u03B1\u03BD\u03B5", 5, 1], + ["\u03BF\u03C5\u03BD\u03C4\u03B1\u03BD\u03B5", -1, 1], + ["\u03B9\u03BF\u03C5\u03BD\u03C4\u03B1\u03BD\u03B5", 7, 1], + ["\u03BF\u03C4\u03B1\u03BD\u03B5", -1, 1], + ["\u03B9\u03BF\u03C4\u03B1\u03BD\u03B5", 9, 1] + ]; + + /** @const */ var a_39 = [ + ["\u03C4\u03B1\u03B2", -1, 1], + ["\u03BD\u03C4\u03B1\u03B2", 0, 1], + ["\u03C8\u03B7\u03BB\u03BF\u03C4\u03B1\u03B2", 0, 1], + ["\u03BB\u03B9\u03B2", -1, 1], + ["\u03BA\u03BB\u03B9\u03B2", 3, 1], + ["\u03BE\u03B7\u03C1\u03BF\u03BA\u03BB\u03B9\u03B2", 4, 1], + ["\u03B3", -1, 1], + ["\u03B1\u03B3", 6, 1], + ["\u03C4\u03C1\u03B1\u03B3", 7, 1], + ["\u03C4\u03C3\u03B1\u03B3", 7, 1], + ["\u03B1\u03B8\u03B9\u03B3\u03B3", 6, 1], + ["\u03C4\u03C3\u03B9\u03B3\u03B3", 6, 1], + ["\u03B1\u03C4\u03C3\u03B9\u03B3\u03B3", 11, 1], + ["\u03C3\u03C4\u03B5\u03B3", 6, 1], + ["\u03B1\u03C0\u03B7\u03B3", 6, 1], + ["\u03C3\u03B9\u03B3", 6, 1], + ["\u03B1\u03BD\u03BF\u03C1\u03B3", 6, 1], + ["\u03B5\u03BD\u03BF\u03C1\u03B3", 6, 1], + ["\u03BA\u03B1\u03BB\u03C0\u03BF\u03C5\u03B6", -1, 1], + ["\u03B8", -1, 1], + ["\u03BC\u03C9\u03B1\u03BC\u03B5\u03B8", 19, 1], + ["\u03C0\u03B9\u03B8", 19, 1], + ["\u03B1\u03C0\u03B9\u03B8", 21, 1], + ["\u03B4\u03B5\u03BA", -1, 1], + ["\u03C0\u03B5\u03BB\u03B5\u03BA", -1, 1], + ["\u03B9\u03BA", -1, 1], + ["\u03B1\u03BD\u03B9\u03BA", 25, 1], + ["\u03B2\u03BF\u03C5\u03BB\u03BA", -1, 1], + ["\u03B2\u03B1\u03C3\u03BA", -1, 1], + ["\u03B2\u03C1\u03B1\u03C7\u03C5\u03BA", -1, 1], + ["\u03B3\u03B1\u03BB", -1, 1], + ["\u03BA\u03B1\u03C4\u03B1\u03B3\u03B1\u03BB", 30, 1], + ["\u03BF\u03BB\u03BF\u03B3\u03B1\u03BB", 30, 1], + ["\u03B2\u03B1\u03B8\u03C5\u03B3\u03B1\u03BB", 30, 1], + ["\u03BC\u03B5\u03BB", -1, 1], + ["\u03BA\u03B1\u03C3\u03C4\u03B5\u03BB", -1, 1], + ["\u03C0\u03BF\u03C1\u03C4\u03BF\u03BB", -1, 1], + ["\u03C0\u03BB", -1, 1], + ["\u03B4\u03B9\u03C0\u03BB", 37, 1], + ["\u03BB\u03B1\u03BF\u03C0\u03BB", 37, 1], + ["\u03C8\u03C5\u03C7\u03BF\u03C0\u03BB", 37, 1], + ["\u03BF\u03C5\u03BB", -1, 1], + ["\u03BC", -1, 1], + ["\u03BF\u03BB\u03B9\u03B3\u03BF\u03B4\u03B1\u03BC", 42, 1], + ["\u03BC\u03BF\u03C5\u03C3\u03BF\u03C5\u03BB\u03BC", 42, 1], + ["\u03B4\u03C1\u03B1\u03B4\u03BF\u03C5\u03BC", 42, 1], + ["\u03B2\u03C1\u03B1\u03C7\u03BC", 42, 1], + ["\u03BD", -1, 1], + ["\u03B1\u03BC\u03B5\u03C1\u03B9\u03BA\u03B1\u03BD", 47, 1], + ["\u03C0", -1, 1], + ["\u03B1\u03B4\u03B1\u03C0", 49, 1], + ["\u03C7\u03B1\u03BC\u03B7\u03BB\u03BF\u03B4\u03B1\u03C0", 49, 1], + ["\u03C0\u03BF\u03BB\u03C5\u03B4\u03B1\u03C0", 49, 1], + ["\u03BA\u03BF\u03C0", 49, 1], + ["\u03C5\u03C0\u03BF\u03BA\u03BF\u03C0", 53, 1], + ["\u03C4\u03C3\u03BF\u03C0", 49, 1], + ["\u03C3\u03C0", 49, 1], + ["\u03B5\u03C1", -1, 1], + ["\u03B3\u03B5\u03C1", 57, 1], + ["\u03B2\u03B5\u03C4\u03B5\u03C1", 57, 1], + ["\u03BB\u03BF\u03C5\u03B8\u03B7\u03C1", -1, 1], + ["\u03BA\u03BF\u03C1\u03BC\u03BF\u03C1", -1, 1], + ["\u03C0\u03B5\u03C1\u03B9\u03C4\u03C1", -1, 1], + ["\u03BF\u03C5\u03C1", -1, 1], + ["\u03C3", -1, 1], + ["\u03B2\u03B1\u03C3", 64, 1], + ["\u03C0\u03BF\u03BB\u03B9\u03C3", 64, 1], + ["\u03C3\u03B1\u03C1\u03B1\u03BA\u03B1\u03C4\u03C3", 64, 1], + ["\u03B8\u03C5\u03C3", 64, 1], + ["\u03B4\u03B9\u03B1\u03C4", -1, 1], + ["\u03C0\u03BB\u03B1\u03C4", -1, 1], + ["\u03C4\u03C3\u03B1\u03C1\u03BB\u03B1\u03C4", -1, 1], + ["\u03C4\u03B5\u03C4", -1, 1], + ["\u03C0\u03BF\u03C5\u03C1\u03B9\u03C4", -1, 1], + ["\u03C3\u03BF\u03C5\u03BB\u03C4", -1, 1], + ["\u03BC\u03B1\u03B9\u03BD\u03C4", -1, 1], + ["\u03B6\u03C9\u03BD\u03C4", -1, 1], + ["\u03BA\u03B1\u03C3\u03C4", -1, 1], + ["\u03C6", -1, 1], + ["\u03B4\u03B9\u03B1\u03C6", 78, 1], + ["\u03C3\u03C4\u03B5\u03C6", 78, 1], + ["\u03C6\u03C9\u03C4\u03BF\u03C3\u03C4\u03B5\u03C6", 80, 1], + ["\u03C0\u03B5\u03C1\u03B7\u03C6", 78, 1], + ["\u03C5\u03C0\u03B5\u03C1\u03B7\u03C6", 82, 1], + ["\u03BA\u03BF\u03B9\u03BB\u03B1\u03C1\u03C6", 78, 1], + ["\u03C0\u03B5\u03BD\u03C4\u03B1\u03C1\u03C6", 78, 1], + ["\u03BF\u03C1\u03C6", 78, 1], + ["\u03C7", -1, 1], + ["\u03B1\u03BC\u03B7\u03C7", 87, 1], + ["\u03B2\u03B9\u03BF\u03BC\u03B7\u03C7", 87, 1], + ["\u03BC\u03B5\u03B3\u03BB\u03BF\u03B2\u03B9\u03BF\u03BC\u03B7\u03C7", 89, 1], + ["\u03BA\u03B1\u03C0\u03BD\u03BF\u03B2\u03B9\u03BF\u03BC\u03B7\u03C7", 89, 1], + ["\u03BC\u03B9\u03BA\u03C1\u03BF\u03B2\u03B9\u03BF\u03BC\u03B7\u03C7", 89, 1], + ["\u03C0\u03BF\u03BB\u03C5\u03BC\u03B7\u03C7", 87, 1], + ["\u03BB\u03B9\u03C7", 87, 1] + ]; + + /** @const */ var a_40 = [ + ["\u03B7\u03C3\u03B5\u03C4\u03B5", -1, 1] + ]; + + /** @const */ var a_41 = [ + ["\u03B5\u03BD\u03B4", -1, 1], + ["\u03C3\u03C5\u03BD\u03B4", -1, 1], + ["\u03BF\u03B4", -1, 1], + ["\u03B4\u03B9\u03B1\u03B8", -1, 1], + ["\u03BA\u03B1\u03B8", -1, 1], + ["\u03C1\u03B1\u03B8", -1, 1], + ["\u03C4\u03B1\u03B8", -1, 1], + ["\u03C4\u03B9\u03B8", -1, 1], + ["\u03B5\u03BA\u03B8", -1, 1], + ["\u03B5\u03BD\u03B8", -1, 1], + ["\u03C3\u03C5\u03BD\u03B8", -1, 1], + ["\u03C1\u03BF\u03B8", -1, 1], + ["\u03C5\u03C0\u03B5\u03C1\u03B8", -1, 1], + ["\u03C3\u03B8", -1, 1], + ["\u03B5\u03C5\u03B8", -1, 1], + ["\u03B1\u03C1\u03BA", -1, 1], + ["\u03C9\u03C6\u03B5\u03BB", -1, 1], + ["\u03B2\u03BF\u03BB", -1, 1], + ["\u03B1\u03B9\u03BD", -1, 1], + ["\u03C0\u03BF\u03BD", -1, 1], + ["\u03C1\u03BF\u03BD", -1, 1], + ["\u03C3\u03C5\u03BD", -1, 1], + ["\u03B2\u03B1\u03C1", -1, 1], + ["\u03B2\u03C1", -1, 1], + ["\u03B1\u03B9\u03C1", -1, 1], + ["\u03C6\u03BF\u03C1", -1, 1], + ["\u03B5\u03C5\u03C1", -1, 1], + ["\u03C0\u03C5\u03C1", -1, 1], + ["\u03C7\u03C9\u03C1", -1, 1], + ["\u03BD\u03B5\u03C4", -1, 1], + ["\u03C3\u03C7", -1, 1] + ]; + + /** @const */ var a_42 = [ + ["\u03C0\u03B1\u03B3", -1, 1], + ["\u03B4", -1, 1], + ["\u03B1\u03B4", 1, 1], + ["\u03B8", -1, 1], + ["\u03B1\u03B8", 3, 1], + ["\u03C4\u03BF\u03BA", -1, 1], + ["\u03C3\u03BA", -1, 1], + ["\u03C0\u03B1\u03C1\u03B1\u03BA\u03B1\u03BB", -1, 1], + ["\u03C3\u03BA\u03B5\u03BB", -1, 1], + ["\u03B1\u03C0\u03BB", -1, 1], + ["\u03B5\u03BC", -1, 1], + ["\u03B1\u03BD", -1, 1], + ["\u03B2\u03B5\u03BD", -1, 1], + ["\u03B2\u03B1\u03C1\u03BF\u03BD", -1, 1], + ["\u03BA\u03BF\u03C0", -1, 1], + ["\u03C3\u03B5\u03C1\u03C0", -1, 1], + ["\u03B1\u03B2\u03B1\u03C1", -1, 1], + ["\u03B5\u03BD\u03B1\u03C1", -1, 1], + ["\u03B1\u03B2\u03C1", -1, 1], + ["\u03BC\u03C0\u03BF\u03C1", -1, 1], + ["\u03B8\u03B1\u03C1\u03C1", -1, 1], + ["\u03BD\u03C4\u03C1", -1, 1], + ["\u03C5", -1, 1], + ["\u03BD\u03B9\u03C6", -1, 1], + ["\u03C3\u03C5\u03C1\u03C6", -1, 1] + ]; + + /** @const */ var a_43 = [ + ["\u03BF\u03BD\u03C4\u03B1\u03C3", -1, 1], + ["\u03C9\u03BD\u03C4\u03B1\u03C3", -1, 1] + ]; + + /** @const */ var a_44 = [ + ["\u03BF\u03BC\u03B1\u03C3\u03C4\u03B5", -1, 1], + ["\u03B9\u03BF\u03BC\u03B1\u03C3\u03C4\u03B5", 0, 1] + ]; + + /** @const */ var a_45 = [ + ["\u03C0", -1, 1], + ["\u03B1\u03C0", 0, 1], + ["\u03B1\u03BA\u03B1\u03C4\u03B1\u03C0", 1, 1], + ["\u03C3\u03C5\u03BC\u03C0", 0, 1], + ["\u03B1\u03C3\u03C5\u03BC\u03C0", 3, 1], + ["\u03B1\u03BC\u03B5\u03C4\u03B1\u03BC\u03C6", -1, 1] + ]; + + /** @const */ var a_46 = [ + ["\u03B6", -1, 1], + ["\u03B1\u03BB", -1, 1], + ["\u03C0\u03B1\u03C1\u03B1\u03BA\u03B1\u03BB", 1, 1], + ["\u03B5\u03BA\u03C4\u03B5\u03BB", -1, 1], + ["\u03BC", -1, 1], + ["\u03BE", -1, 1], + ["\u03C0\u03C1\u03BF", -1, 1], + ["\u03B1\u03C1", -1, 1], + ["\u03BD\u03B9\u03C3", -1, 1] + ]; + + /** @const */ var a_47 = [ + ["\u03B7\u03B8\u03B7\u03BA\u03B1", -1, 1], + ["\u03B7\u03B8\u03B7\u03BA\u03B5", -1, 1], + ["\u03B7\u03B8\u03B7\u03BA\u03B5\u03C3", -1, 1] + ]; + + /** @const */ var a_48 = [ + ["\u03C0\u03B9\u03B8", -1, 1], + ["\u03BF\u03B8", -1, 1], + ["\u03BD\u03B1\u03C1\u03B8", -1, 1], + ["\u03C3\u03BA\u03BF\u03C5\u03BB", -1, 1], + ["\u03C3\u03BA\u03C9\u03BB", -1, 1], + ["\u03C3\u03C6", -1, 1] + ]; + + /** @const */ var a_49 = [ + ["\u03B8", -1, 1], + ["\u03B4\u03B9\u03B1\u03B8", 0, 1], + ["\u03C0\u03B1\u03C1\u03B1\u03BA\u03B1\u03C4\u03B1\u03B8", 0, 1], + ["\u03C3\u03C5\u03BD\u03B8", 0, 1], + ["\u03C0\u03C1\u03BF\u03C3\u03B8", 0, 1] + ]; + + /** @const */ var a_50 = [ + ["\u03B7\u03BA\u03B1", -1, 1], + ["\u03B7\u03BA\u03B5", -1, 1], + ["\u03B7\u03BA\u03B5\u03C3", -1, 1] + ]; + + /** @const */ var a_51 = [ + ["\u03C6\u03B1\u03B3", -1, 1], + ["\u03BB\u03B7\u03B3", -1, 1], + ["\u03C6\u03C1\u03C5\u03B4", -1, 1], + ["\u03BC\u03B1\u03BD\u03C4\u03B9\u03BB", -1, 1], + ["\u03BC\u03B1\u03BB\u03BB", -1, 1], + ["\u03BF\u03BC", -1, 1], + ["\u03B2\u03BB\u03B5\u03C0", -1, 1], + ["\u03C0\u03BF\u03B4\u03B1\u03C1", -1, 1], + ["\u03BA\u03C5\u03BC\u03B1\u03C4", -1, 1], + ["\u03C0\u03C1\u03C9\u03C4", -1, 1], + ["\u03BB\u03B1\u03C7", -1, 1], + ["\u03C0\u03B1\u03BD\u03C4\u03B1\u03C7", -1, 1] + ]; + + /** @const */ var a_52 = [ + ["\u03C4\u03C3\u03B1", -1, 1], + ["\u03C7\u03B1\u03B4", -1, 1], + ["\u03BC\u03B5\u03B4", -1, 1], + ["\u03BB\u03B1\u03BC\u03C0\u03B9\u03B4", -1, 1], + ["\u03B4\u03B5", -1, 1], + ["\u03C0\u03BB\u03B5", -1, 1], + ["\u03BC\u03B5\u03C3\u03B1\u03B6", -1, 1], + ["\u03B4\u03B5\u03C3\u03C0\u03BF\u03B6", -1, 1], + ["\u03B1\u03B9\u03B8", -1, 1], + ["\u03C6\u03B1\u03C1\u03BC\u03B1\u03BA", -1, 1], + ["\u03B1\u03B3\u03BA", -1, 1], + ["\u03B1\u03BD\u03B7\u03BA", -1, 1], + ["\u03BB", -1, 1], + ["\u03BC", -1, 1], + ["\u03B1\u03BC", 13, 1], + ["\u03B2\u03C1\u03BF\u03BC", 13, 1], + ["\u03C5\u03C0\u03BF\u03C4\u03B5\u03B9\u03BD", -1, 1], + ["\u03B5\u03BA\u03BB\u03B9\u03C0", -1, 1], + ["\u03C1", -1, 1], + ["\u03B5\u03BD\u03B4\u03B9\u03B1\u03C6\u03B5\u03C1", 18, 1], + ["\u03B1\u03BD\u03B1\u03C1\u03C1", 18, 1], + ["\u03C0\u03B1\u03C4", -1, 1], + ["\u03BA\u03B1\u03B8\u03B1\u03C1\u03B5\u03C5", -1, 1], + ["\u03B4\u03B5\u03C5\u03C4\u03B5\u03C1\u03B5\u03C5", -1, 1], + ["\u03BB\u03B5\u03C7", -1, 1] + ]; + + /** @const */ var a_53 = [ + ["\u03BF\u03C5\u03C3\u03B1", -1, 1], + ["\u03BF\u03C5\u03C3\u03B5", -1, 1], + ["\u03BF\u03C5\u03C3\u03B5\u03C3", -1, 1] + ]; + + /** @const */ var a_54 = [ + ["\u03C0\u03B5\u03BB", -1, 1], + ["\u03BB\u03BB", -1, 1], + ["\u03C3\u03BC\u03B7\u03BD", -1, 1], + ["\u03C1\u03C0", -1, 1], + ["\u03C0\u03C1", -1, 1], + ["\u03C6\u03C1", -1, 1], + ["\u03C7\u03BF\u03C1\u03C4", -1, 1], + ["\u03BF\u03C6", -1, 1], + ["\u03C8\u03BF\u03C6", 7, -1], + ["\u03C3\u03C6", -1, 1], + ["\u03BB\u03BF\u03C7", -1, 1], + ["\u03BD\u03B1\u03C5\u03BB\u03BF\u03C7", 10, -1] + ]; + + /** @const */ var a_55 = [ + ["\u03B1\u03BC\u03B1\u03BB\u03BB\u03B9", -1, 1], + ["\u03BB", -1, 1], + ["\u03B1\u03BC\u03B1\u03BB", 1, 1], + ["\u03BC", -1, 1], + ["\u03BF\u03C5\u03BB\u03B1\u03BC", 3, 1], + ["\u03B5\u03BD", -1, 1], + ["\u03B4\u03B5\u03C1\u03B2\u03B5\u03BD", 5, 1], + ["\u03C0", -1, 1], + ["\u03B1\u03B5\u03B9\u03C0", 7, 1], + ["\u03B1\u03C1\u03C4\u03B9\u03C0", 7, 1], + ["\u03C3\u03C5\u03BC\u03C0", 7, 1], + ["\u03BD\u03B5\u03BF\u03C0", 7, 1], + ["\u03BA\u03C1\u03BF\u03BA\u03B1\u03BB\u03BF\u03C0", 7, 1], + ["\u03BF\u03BB\u03BF\u03C0", 7, 1], + ["\u03C0\u03C1\u03BF\u03C3\u03C9\u03C0\u03BF\u03C0", 7, 1], + ["\u03C3\u03B9\u03B4\u03B7\u03C1\u03BF\u03C0", 7, 1], + ["\u03B4\u03C1\u03BF\u03C3\u03BF\u03C0", 7, 1], + ["\u03B1\u03C3\u03C0", 7, 1], + ["\u03B1\u03BD\u03C5\u03C0", 7, 1], + ["\u03C1", -1, 1], + ["\u03B1\u03C3\u03C0\u03B1\u03C1", 19, 1], + ["\u03C7\u03B1\u03C1", 19, 1], + ["\u03B1\u03C7\u03B1\u03C1", 21, 1], + ["\u03B1\u03C0\u03B5\u03C1", 19, 1], + ["\u03C4\u03C1", 19, 1], + ["\u03BF\u03C5\u03C1", 19, 1], + ["\u03C4", -1, 1], + ["\u03B4\u03B9\u03B1\u03C4", 26, 1], + ["\u03B5\u03C0\u03B9\u03C4", 26, 1], + ["\u03C3\u03C5\u03BD\u03C4", 26, 1], + ["\u03BF\u03BC\u03BF\u03C4", 26, 1], + ["\u03BD\u03BF\u03BC\u03BF\u03C4", 30, 1], + ["\u03B1\u03C0\u03BF\u03C4", 26, 1], + ["\u03C5\u03C0\u03BF\u03C4", 26, 1], + ["\u03B1\u03B2\u03B1\u03C3\u03C4", 26, 1], + ["\u03B1\u03B9\u03BC\u03BF\u03C3\u03C4", 26, 1], + ["\u03C0\u03C1\u03BF\u03C3\u03C4", 26, 1], + ["\u03B1\u03BD\u03C5\u03C3\u03C4", 26, 1], + ["\u03BD\u03B1\u03C5", -1, 1], + ["\u03B1\u03C6", -1, 1], + ["\u03BE\u03B5\u03C6", -1, 1], + ["\u03B1\u03B4\u03B7\u03C6", -1, 1], + ["\u03C0\u03B1\u03BC\u03C6", -1, 1], + ["\u03C0\u03BF\u03BB\u03C5\u03C6", -1, 1] + ]; + + /** @const */ var a_56 = [ + ["\u03B1\u03B3\u03B1", -1, 1], + ["\u03B1\u03B3\u03B5", -1, 1], + ["\u03B1\u03B3\u03B5\u03C3", -1, 1] + ]; + + /** @const */ var a_57 = [ + ["\u03B7\u03C3\u03B1", -1, 1], + ["\u03B7\u03C3\u03B5", -1, 1], + ["\u03B7\u03C3\u03BF\u03C5", -1, 1] + ]; + + /** @const */ var a_58 = [ + ["\u03BD", -1, 1], + ["\u03B4\u03C9\u03B4\u03B5\u03BA\u03B1\u03BD", 0, 1], + ["\u03B5\u03C0\u03C4\u03B1\u03BD", 0, 1], + ["\u03BC\u03B5\u03B3\u03B1\u03BB\u03BF\u03BD", 0, 1], + ["\u03B5\u03C1\u03B7\u03BC\u03BF\u03BD", 0, 1], + ["\u03C7\u03B5\u03C1\u03C3\u03BF\u03BD", 0, 1] + ]; + + /** @const */ var a_59 = [ + ["\u03B7\u03C3\u03C4\u03B5", -1, 1] + ]; + + /** @const */ var a_60 = [ + ["\u03C3\u03B2", -1, 1], + ["\u03B1\u03C3\u03B2", 0, 1], + ["\u03B1\u03C0\u03BB", -1, 1], + ["\u03B1\u03B5\u03B9\u03BC\u03BD", -1, 1], + ["\u03C7\u03C1", -1, 1], + ["\u03B1\u03C7\u03C1", 4, 1], + ["\u03BA\u03BF\u03B9\u03BD\u03BF\u03C7\u03C1", 4, 1], + ["\u03B4\u03C5\u03C3\u03C7\u03C1", 4, 1], + ["\u03B5\u03C5\u03C7\u03C1", 4, 1], + ["\u03C0\u03B1\u03BB\u03B9\u03BC\u03C8", -1, 1] + ]; + + /** @const */ var a_61 = [ + ["\u03BF\u03C5\u03BD\u03B5", -1, 1], + ["\u03B7\u03B8\u03BF\u03C5\u03BD\u03B5", 0, 1], + ["\u03B7\u03C3\u03BF\u03C5\u03BD\u03B5", 0, 1] + ]; + + /** @const */ var a_62 = [ + ["\u03C3\u03C0\u03B9", -1, 1], + ["\u03BD", -1, 1], + ["\u03B5\u03BE\u03C9\u03BD", 1, 1], + ["\u03C1", -1, 1], + ["\u03C3\u03C4\u03C1\u03B1\u03B2\u03BF\u03BC\u03BF\u03C5\u03C4\u03C3", -1, 1], + ["\u03BA\u03B1\u03BA\u03BF\u03BC\u03BF\u03C5\u03C4\u03C3", -1, 1] + ]; + + /** @const */ var a_63 = [ + ["\u03BF\u03C5\u03BC\u03B5", -1, 1], + ["\u03B7\u03B8\u03BF\u03C5\u03BC\u03B5", 0, 1], + ["\u03B7\u03C3\u03BF\u03C5\u03BC\u03B5", 0, 1] + ]; + + /** @const */ var a_64 = [ + ["\u03B1\u03B6", -1, 1], + ["\u03C9\u03C1\u03B9\u03BF\u03C0\u03BB", -1, 1], + ["\u03B1\u03C3\u03BF\u03C5\u03C3", -1, 1], + ["\u03C0\u03B1\u03C1\u03B1\u03C3\u03BF\u03C5\u03C3", 2, 1], + ["\u03B1\u03BB\u03BB\u03BF\u03C3\u03BF\u03C5\u03C3", -1, 1], + ["\u03C6", -1, 1], + ["\u03C7", -1, 1] + ]; + + /** @const */ var a_65 = [ + ["\u03BC\u03B1\u03C4\u03B1", -1, 1], + ["\u03BC\u03B1\u03C4\u03C9\u03BD", -1, 1], + ["\u03BC\u03B1\u03C4\u03BF\u03C3", -1, 1] + ]; + + /** @const */ var a_66 = [ + ["\u03B1", -1, 1], + ["\u03B9\u03BF\u03C5\u03BC\u03B1", 0, 1], + ["\u03BF\u03BC\u03BF\u03C5\u03BD\u03B1", 0, 1], + ["\u03B9\u03BF\u03BC\u03BF\u03C5\u03BD\u03B1", 2, 1], + ["\u03BF\u03C3\u03BF\u03C5\u03BD\u03B1", 0, 1], + ["\u03B9\u03BF\u03C3\u03BF\u03C5\u03BD\u03B1", 4, 1], + ["\u03B5", -1, 1], + ["\u03B1\u03B3\u03B1\u03C4\u03B5", 6, 1], + ["\u03B7\u03BA\u03B1\u03C4\u03B5", 6, 1], + ["\u03B7\u03B8\u03B7\u03BA\u03B1\u03C4\u03B5", 8, 1], + ["\u03B7\u03C3\u03B1\u03C4\u03B5", 6, 1], + ["\u03BF\u03C5\u03C3\u03B1\u03C4\u03B5", 6, 1], + ["\u03B5\u03B9\u03C4\u03B5", 6, 1], + ["\u03B7\u03B8\u03B5\u03B9\u03C4\u03B5", 12, 1], + ["\u03B9\u03B5\u03BC\u03B1\u03C3\u03C4\u03B5", 6, 1], + ["\u03BF\u03C5\u03BC\u03B1\u03C3\u03C4\u03B5", 6, 1], + ["\u03B9\u03BF\u03C5\u03BC\u03B1\u03C3\u03C4\u03B5", 15, 1], + ["\u03B9\u03B5\u03C3\u03B1\u03C3\u03C4\u03B5", 6, 1], + ["\u03BF\u03C3\u03B1\u03C3\u03C4\u03B5", 6, 1], + ["\u03B9\u03BF\u03C3\u03B1\u03C3\u03C4\u03B5", 18, 1], + ["\u03B7", -1, 1], + ["\u03B9", -1, 1], + ["\u03B1\u03BC\u03B1\u03B9", 21, 1], + ["\u03B9\u03B5\u03BC\u03B1\u03B9", 21, 1], + ["\u03BF\u03BC\u03B1\u03B9", 21, 1], + ["\u03BF\u03C5\u03BC\u03B1\u03B9", 21, 1], + ["\u03B1\u03C3\u03B1\u03B9", 21, 1], + ["\u03B5\u03C3\u03B1\u03B9", 21, 1], + ["\u03B9\u03B5\u03C3\u03B1\u03B9", 27, 1], + ["\u03B1\u03C4\u03B1\u03B9", 21, 1], + ["\u03B5\u03C4\u03B1\u03B9", 21, 1], + ["\u03B9\u03B5\u03C4\u03B1\u03B9", 30, 1], + ["\u03BF\u03BD\u03C4\u03B1\u03B9", 21, 1], + ["\u03BF\u03C5\u03BD\u03C4\u03B1\u03B9", 21, 1], + ["\u03B9\u03BF\u03C5\u03BD\u03C4\u03B1\u03B9", 33, 1], + ["\u03B5\u03B9", 21, 1], + ["\u03B1\u03B5\u03B9", 35, 1], + ["\u03B7\u03B8\u03B5\u03B9", 35, 1], + ["\u03B7\u03C3\u03B5\u03B9", 35, 1], + ["\u03BF\u03B9", 21, 1], + ["\u03B1\u03BD", -1, 1], + ["\u03B1\u03B3\u03B1\u03BD", 40, 1], + ["\u03B7\u03BA\u03B1\u03BD", 40, 1], + ["\u03B7\u03B8\u03B7\u03BA\u03B1\u03BD", 42, 1], + ["\u03B7\u03C3\u03B1\u03BD", 40, 1], + ["\u03BF\u03C5\u03C3\u03B1\u03BD", 40, 1], + ["\u03BF\u03BD\u03C4\u03BF\u03C5\u03C3\u03B1\u03BD", 45, 1], + ["\u03B9\u03BF\u03BD\u03C4\u03BF\u03C5\u03C3\u03B1\u03BD", 46, 1], + ["\u03BF\u03BD\u03C4\u03B1\u03BD", 40, 1], + ["\u03B9\u03BF\u03BD\u03C4\u03B1\u03BD", 48, 1], + ["\u03BF\u03C5\u03BD\u03C4\u03B1\u03BD", 40, 1], + ["\u03B9\u03BF\u03C5\u03BD\u03C4\u03B1\u03BD", 50, 1], + ["\u03BF\u03C4\u03B1\u03BD", 40, 1], + ["\u03B9\u03BF\u03C4\u03B1\u03BD", 52, 1], + ["\u03BF\u03BC\u03B1\u03C3\u03C4\u03B1\u03BD", 40, 1], + ["\u03B9\u03BF\u03BC\u03B1\u03C3\u03C4\u03B1\u03BD", 54, 1], + ["\u03BF\u03C3\u03B1\u03C3\u03C4\u03B1\u03BD", 40, 1], + ["\u03B9\u03BF\u03C3\u03B1\u03C3\u03C4\u03B1\u03BD", 56, 1], + ["\u03BF\u03C5\u03BD", -1, 1], + ["\u03B7\u03B8\u03BF\u03C5\u03BD", 58, 1], + ["\u03BF\u03BC\u03BF\u03C5\u03BD", 58, 1], + ["\u03B9\u03BF\u03BC\u03BF\u03C5\u03BD", 60, 1], + ["\u03B7\u03C3\u03BF\u03C5\u03BD", 58, 1], + ["\u03BF\u03C3\u03BF\u03C5\u03BD", 58, 1], + ["\u03B9\u03BF\u03C3\u03BF\u03C5\u03BD", 63, 1], + ["\u03C9\u03BD", -1, 1], + ["\u03B7\u03B4\u03C9\u03BD", 65, 1], + ["\u03BF", -1, 1], + ["\u03B1\u03C3", -1, 1], + ["\u03B5\u03C3", -1, 1], + ["\u03B7\u03B4\u03B5\u03C3", 69, 1], + ["\u03B7\u03C3\u03B5\u03C3", 69, 1], + ["\u03B7\u03C3", -1, 1], + ["\u03B5\u03B9\u03C3", -1, 1], + ["\u03B7\u03B8\u03B5\u03B9\u03C3", 73, 1], + ["\u03BF\u03C3", -1, 1], + ["\u03C5\u03C3", -1, 1], + ["\u03BF\u03C5\u03C3", 76, 1], + ["\u03C5", -1, 1], + ["\u03BF\u03C5", 78, 1], + ["\u03C9", -1, 1], + ["\u03B1\u03C9", 80, 1], + ["\u03B7\u03B8\u03C9", 80, 1], + ["\u03B7\u03C3\u03C9", 80, 1] + ]; + + /** @const */ var a_67 = [ + ["\u03BF\u03C4\u03B5\u03C1", -1, 1], + ["\u03B5\u03C3\u03C4\u03B5\u03C1", -1, 1], + ["\u03C5\u03C4\u03B5\u03C1", -1, 1], + ["\u03C9\u03C4\u03B5\u03C1", -1, 1], + ["\u03BF\u03C4\u03B1\u03C4", -1, 1], + ["\u03B5\u03C3\u03C4\u03B1\u03C4", -1, 1], + ["\u03C5\u03C4\u03B1\u03C4", -1, 1], + ["\u03C9\u03C4\u03B1\u03C4", -1, 1] + ]; + + /** @const */ var /** Array */ g_v = [81, 65, 16, 1]; + + /** @const */ var /** Array */ g_v2 = [81, 65, 0, 1]; + + var /** boolean */ B_test1 = false; + + + /** @return {boolean} */ + function r_has_min_length() { + return base.current.length >= 3; + }; + + /** @return {boolean} */ + function r_tolower() { + var /** number */ among_var; + while(true) + { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + among_var = base.find_among_b(a_0); + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("\u03B1")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u03B2")) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u03B3")) + { + return false; + } + break; + case 4: + if (!base.slice_from("\u03B4")) + { + return false; + } + break; + case 5: + if (!base.slice_from("\u03B5")) + { + return false; + } + break; + case 6: + if (!base.slice_from("\u03B6")) + { + return false; + } + break; + case 7: + if (!base.slice_from("\u03B7")) + { + return false; + } + break; + case 8: + if (!base.slice_from("\u03B8")) + { + return false; + } + break; + case 9: + if (!base.slice_from("\u03B9")) + { + return false; + } + break; + case 10: + if (!base.slice_from("\u03BA")) + { + return false; + } + break; + case 11: + if (!base.slice_from("\u03BB")) + { + return false; + } + break; + case 12: + if (!base.slice_from("\u03BC")) + { + return false; + } + break; + case 13: + if (!base.slice_from("\u03BD")) + { + return false; + } + break; + case 14: + if (!base.slice_from("\u03BE")) + { + return false; + } + break; + case 15: + if (!base.slice_from("\u03BF")) + { + return false; + } + break; + case 16: + if (!base.slice_from("\u03C0")) + { + return false; + } + break; + case 17: + if (!base.slice_from("\u03C1")) + { + return false; + } + break; + case 18: + if (!base.slice_from("\u03C3")) + { + return false; + } + break; + case 19: + if (!base.slice_from("\u03C4")) + { + return false; + } + break; + case 20: + if (!base.slice_from("\u03C5")) + { + return false; + } + break; + case 21: + if (!base.slice_from("\u03C6")) + { + return false; + } + break; + case 22: + if (!base.slice_from("\u03C7")) + { + return false; + } + break; + case 23: + if (!base.slice_from("\u03C8")) + { + return false; + } + break; + case 24: + if (!base.slice_from("\u03C9")) + { + return false; + } + break; + case 25: + if (base.cursor <= base.limit_backward) + { + break lab0; + } + base.cursor--; + break; + } + continue; + } + base.cursor = base.limit - v_1; + break; + } + return true; + }; + + /** @return {boolean} */ + function r_step_1() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_1); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("\u03C6\u03B1")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u03C3\u03BA\u03B1")) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u03BF\u03BB\u03BF")) + { + return false; + } + break; + case 4: + if (!base.slice_from("\u03C3\u03BF")) + { + return false; + } + break; + case 5: + if (!base.slice_from("\u03C4\u03B1\u03C4\u03BF")) + { + return false; + } + break; + case 6: + if (!base.slice_from("\u03BA\u03C1\u03B5")) + { + return false; + } + break; + case 7: + if (!base.slice_from("\u03C0\u03B5\u03C1")) + { + return false; + } + break; + case 8: + if (!base.slice_from("\u03C4\u03B5\u03C1")) + { + return false; + } + break; + case 9: + if (!base.slice_from("\u03C6\u03C9")) + { + return false; + } + break; + case 10: + if (!base.slice_from("\u03BA\u03B1\u03B8\u03B5\u03C3\u03C4")) + { + return false; + } + break; + case 11: + if (!base.slice_from("\u03B3\u03B5\u03B3\u03BF\u03BD")) + { + return false; + } + break; + } + B_test1 = false; + return true; + }; + + /** @return {boolean} */ + function r_step_s1() { + var /** number */ among_var; + base.ket = base.cursor; + if (base.find_among_b(a_3) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + among_var = base.find_among_b(a_2); + if (among_var == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + switch (among_var) { + case 1: + if (!base.slice_from("\u03B9")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u03B9\u03B6")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_step_s2() { + base.ket = base.cursor; + if (base.find_among_b(a_5) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_4) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03C9\u03BD")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_s3() { + var /** number */ among_var; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + if (!(base.eq_s_b("\u03B9\u03C3\u03B1"))) + { + break lab1; + } + base.bra = base.cursor; + if (base.cursor > base.limit_backward) + { + break lab1; + } + if (!base.slice_from("\u03B9\u03C3")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + } + if (base.find_among_b(a_7) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + among_var = base.find_among_b(a_6); + if (among_var == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + switch (among_var) { + case 1: + if (!base.slice_from("\u03B9")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u03B9\u03C3")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_step_s4() { + base.ket = base.cursor; + if (base.find_among_b(a_9) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_8) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B9")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_s5() { + var /** number */ among_var; + base.ket = base.cursor; + if (base.find_among_b(a_11) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + among_var = base.find_among_b(a_10); + if (among_var == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + switch (among_var) { + case 1: + if (!base.slice_from("\u03B9")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u03B9\u03C3\u03C4")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_step_s6() { + var /** number */ among_var; + base.ket = base.cursor; + if (base.find_among_b(a_14) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + base.bra = base.cursor; + among_var = base.find_among_b(a_12); + if (among_var == 0) + { + break lab1; + } + if (base.cursor > base.limit_backward) + { + break lab1; + } + switch (among_var) { + case 1: + if (!base.slice_from("\u03B9\u03C3\u03BC")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u03B9")) + { + return false; + } + break; + } + break lab0; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + among_var = base.find_among_b(a_13); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("\u03B1\u03B3\u03BD\u03C9\u03C3\u03C4")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u03B1\u03C4\u03BF\u03BC")) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u03B3\u03BD\u03C9\u03C3\u03C4")) + { + return false; + } + break; + case 4: + if (!base.slice_from("\u03B5\u03B8\u03BD")) + { + return false; + } + break; + case 5: + if (!base.slice_from("\u03B5\u03BA\u03BB\u03B5\u03BA\u03C4")) + { + return false; + } + break; + case 6: + if (!base.slice_from("\u03C3\u03BA\u03B5\u03C0\u03C4")) + { + return false; + } + break; + case 7: + if (!base.slice_from("\u03C4\u03BF\u03C0")) + { + return false; + } + break; + case 8: + if (!base.slice_from("\u03B1\u03BB\u03B5\u03BE\u03B1\u03BD\u03B4\u03C1")) + { + return false; + } + break; + case 9: + if (!base.slice_from("\u03B2\u03C5\u03B6\u03B1\u03BD\u03C4")) + { + return false; + } + break; + case 10: + if (!base.slice_from("\u03B8\u03B5\u03B1\u03C4\u03C1")) + { + return false; + } + break; + } + } + return true; + }; + + /** @return {boolean} */ + function r_step_s7() { + base.ket = base.cursor; + if (base.find_among_b(a_16) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_15) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B1\u03C1\u03B1\u03BA")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_s8() { + var /** number */ among_var; + base.ket = base.cursor; + if (base.find_among_b(a_18) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + base.bra = base.cursor; + among_var = base.find_among_b(a_17); + if (among_var == 0) + { + break lab1; + } + if (base.cursor > base.limit_backward) + { + break lab1; + } + switch (among_var) { + case 1: + if (!base.slice_from("\u03B1\u03BA")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u03B9\u03C4\u03C3")) + { + return false; + } + break; + } + break lab0; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + base.bra = base.cursor; + if (!(base.eq_s_b("\u03BA\u03BF\u03C1"))) + { + return false; + } + if (!base.slice_from("\u03B9\u03C4\u03C3")) + { + return false; + } + } + return true; + }; + + /** @return {boolean} */ + function r_step_s9() { + base.ket = base.cursor; + if (base.find_among_b(a_21) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_19) == 0) + { + break lab1; + } + if (base.cursor > base.limit_backward) + { + break lab1; + } + if (!base.slice_from("\u03B9\u03B4")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_20) == 0) + { + return false; + } + if (!base.slice_from("\u03B9\u03B4")) + { + return false; + } + } + return true; + }; + + /** @return {boolean} */ + function r_step_s10() { + base.ket = base.cursor; + if (base.find_among_b(a_23) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_22) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B9\u03C3\u03BA")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_2a() { + base.ket = base.cursor; + if (base.find_among_b(a_24) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (base.find_among_b(a_25) == 0) + { + break lab0; + } + return false; + } + base.cursor = base.limit - v_1; + } + { + /** @const */ var /** number */ c1 = base.cursor; + base.insert(base.cursor, base.cursor, "\u03B1\u03B4"); + base.cursor = c1; + } + return true; + }; + + /** @return {boolean} */ + function r_step_2b() { + base.ket = base.cursor; + if (base.find_among_b(a_26) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_27) == 0) + { + return false; + } + if (!base.slice_from("\u03B5\u03B4")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_2c() { + base.ket = base.cursor; + if (base.find_among_b(a_28) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_29) == 0) + { + return false; + } + if (!base.slice_from("\u03BF\u03C5\u03B4")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_2d() { + base.ket = base.cursor; + if (base.find_among_b(a_30) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_31) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B5")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_3() { + base.ket = base.cursor; + if (base.find_among_b(a_32) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (!(base.in_grouping_b(g_v, 945, 969))) + { + return false; + } + if (!base.slice_from("\u03B9")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_4() { + base.ket = base.cursor; + if (base.find_among_b(a_33) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + base.bra = base.cursor; + if (!(base.in_grouping_b(g_v, 945, 969))) + { + break lab1; + } + if (!base.slice_from("\u03B9\u03BA")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + } + base.bra = base.cursor; + if (base.find_among_b(a_34) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B9\u03BA")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_5a() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + if (!(base.eq_s_b("\u03B1\u03B3\u03B1\u03BC\u03B5"))) + { + break lab0; + } + base.bra = base.cursor; + if (base.cursor > base.limit_backward) + { + break lab0; + } + if (!base.slice_from("\u03B1\u03B3\u03B1\u03BC")) + { + return false; + } + } + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + if (base.find_among_b(a_35) == 0) + { + break lab1; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + } + base.cursor = base.limit - v_2; + base.ket = base.cursor; + if (!(base.eq_s_b("\u03B1\u03BC\u03B5"))) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_36) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B1\u03BC")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_5b() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + if (base.find_among_b(a_38) == 0) + { + break lab0; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_37) == 0) + { + break lab0; + } + if (base.cursor > base.limit_backward) + { + break lab0; + } + if (!base.slice_from("\u03B1\u03B3\u03B1\u03BD")) + { + return false; + } + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + if (!(base.eq_s_b("\u03B1\u03BD\u03B5"))) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + lab1: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab2: { + base.ket = base.cursor; + base.bra = base.cursor; + if (!(base.in_grouping_b(g_v2, 945, 969))) + { + break lab2; + } + if (!base.slice_from("\u03B1\u03BD")) + { + return false; + } + break lab1; + } + base.cursor = base.limit - v_2; + base.ket = base.cursor; + } + base.bra = base.cursor; + if (base.find_among_b(a_39) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B1\u03BD")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_5c() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + if (base.find_among_b(a_40) == 0) + { + break lab0; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + if (!(base.eq_s_b("\u03B5\u03C4\u03B5"))) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + lab1: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab2: { + base.ket = base.cursor; + base.bra = base.cursor; + if (!(base.in_grouping_b(g_v2, 945, 969))) + { + break lab2; + } + if (!base.slice_from("\u03B5\u03C4")) + { + return false; + } + break lab1; + } + base.cursor = base.limit - v_2; + lab3: { + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_41) == 0) + { + break lab3; + } + if (!base.slice_from("\u03B5\u03C4")) + { + return false; + } + break lab1; + } + base.cursor = base.limit - v_2; + base.ket = base.cursor; + } + base.bra = base.cursor; + if (base.find_among_b(a_42) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B5\u03C4")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_5d() { + base.ket = base.cursor; + if (base.find_among_b(a_43) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + base.bra = base.cursor; + if (!(base.eq_s_b("\u03B1\u03C1\u03C7"))) + { + break lab1; + } + if (base.cursor > base.limit_backward) + { + break lab1; + } + if (!base.slice_from("\u03BF\u03BD\u03C4")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + base.bra = base.cursor; + if (!(base.eq_s_b("\u03BA\u03C1\u03B5"))) + { + return false; + } + if (!base.slice_from("\u03C9\u03BD\u03C4")) + { + return false; + } + } + return true; + }; + + /** @return {boolean} */ + function r_step_5e() { + base.ket = base.cursor; + if (base.find_among_b(a_44) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (!(base.eq_s_b("\u03BF\u03BD"))) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03BF\u03BC\u03B1\u03C3\u03C4")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_5f() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + if (!(base.eq_s_b("\u03B9\u03B5\u03C3\u03C4\u03B5"))) + { + break lab0; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_45) == 0) + { + break lab0; + } + if (base.cursor > base.limit_backward) + { + break lab0; + } + if (!base.slice_from("\u03B9\u03B5\u03C3\u03C4")) + { + return false; + } + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + if (!(base.eq_s_b("\u03B5\u03C3\u03C4\u03B5"))) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_46) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B9\u03B5\u03C3\u03C4")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_5g() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + if (base.find_among_b(a_47) == 0) + { + break lab0; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + if (base.find_among_b(a_50) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + lab1: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab2: { + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_48) == 0) + { + break lab2; + } + if (!base.slice_from("\u03B7\u03BA")) + { + return false; + } + break lab1; + } + base.cursor = base.limit - v_2; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_49) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B7\u03BA")) + { + return false; + } + } + return true; + }; + + /** @return {boolean} */ + function r_step_5h() { + base.ket = base.cursor; + if (base.find_among_b(a_53) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_51) == 0) + { + break lab1; + } + if (!base.slice_from("\u03BF\u03C5\u03C3")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_52) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03BF\u03C5\u03C3")) + { + return false; + } + } + return true; + }; + + /** @return {boolean} */ + function r_step_5i() { + var /** number */ among_var; + base.ket = base.cursor; + if (base.find_among_b(a_56) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + base.bra = base.cursor; + if (!(base.eq_s_b("\u03BA\u03BF\u03BB\u03BB"))) + { + break lab1; + } + if (!base.slice_from("\u03B1\u03B3")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab2: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab3: { + base.ket = base.cursor; + base.bra = base.cursor; + among_var = base.find_among_b(a_54); + if (among_var == 0) + { + break lab3; + } + switch (among_var) { + case 1: + if (!base.slice_from("\u03B1\u03B3")) + { + return false; + } + break; + } + break lab2; + } + base.cursor = base.limit - v_2; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_55) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B1\u03B3")) + { + return false; + } + } + } + return true; + }; + + /** @return {boolean} */ + function r_step_5j() { + base.ket = base.cursor; + if (base.find_among_b(a_57) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_58) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B7\u03C3")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_5k() { + base.ket = base.cursor; + if (base.find_among_b(a_59) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_60) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03B7\u03C3\u03C4")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_5l() { + base.ket = base.cursor; + if (base.find_among_b(a_61) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_62) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03BF\u03C5\u03BD")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_5m() { + base.ket = base.cursor; + if (base.find_among_b(a_63) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_test1 = false; + base.ket = base.cursor; + base.bra = base.cursor; + if (base.find_among_b(a_64) == 0) + { + return false; + } + if (base.cursor > base.limit_backward) + { + return false; + } + if (!base.slice_from("\u03BF\u03C5\u03BC")) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_6() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + if (base.find_among_b(a_65) == 0) + { + break lab0; + } + base.bra = base.cursor; + if (!base.slice_from("\u03BC\u03B1")) + { + return false; + } + } + base.cursor = base.limit - v_1; + if (!B_test1) + { + return false; + } + base.ket = base.cursor; + if (base.find_among_b(a_66) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step_7() { + base.ket = base.cursor; + if (base.find_among_b(a_67) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + r_tolower(); + base.cursor = base.limit - v_1; + if (!r_has_min_length()) + { + return false; + } + B_test1 = true; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + r_step_1(); + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + r_step_s1(); + base.cursor = base.limit - v_3; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + r_step_s2(); + base.cursor = base.limit - v_4; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + r_step_s3(); + base.cursor = base.limit - v_5; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + r_step_s4(); + base.cursor = base.limit - v_6; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + r_step_s5(); + base.cursor = base.limit - v_7; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + r_step_s6(); + base.cursor = base.limit - v_8; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; + r_step_s7(); + base.cursor = base.limit - v_9; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; + r_step_s8(); + base.cursor = base.limit - v_10; + /** @const */ var /** number */ v_11 = base.limit - base.cursor; + r_step_s9(); + base.cursor = base.limit - v_11; + /** @const */ var /** number */ v_12 = base.limit - base.cursor; + r_step_s10(); + base.cursor = base.limit - v_12; + /** @const */ var /** number */ v_13 = base.limit - base.cursor; + r_step_2a(); + base.cursor = base.limit - v_13; + /** @const */ var /** number */ v_14 = base.limit - base.cursor; + r_step_2b(); + base.cursor = base.limit - v_14; + /** @const */ var /** number */ v_15 = base.limit - base.cursor; + r_step_2c(); + base.cursor = base.limit - v_15; + /** @const */ var /** number */ v_16 = base.limit - base.cursor; + r_step_2d(); + base.cursor = base.limit - v_16; + /** @const */ var /** number */ v_17 = base.limit - base.cursor; + r_step_3(); + base.cursor = base.limit - v_17; + /** @const */ var /** number */ v_18 = base.limit - base.cursor; + r_step_4(); + base.cursor = base.limit - v_18; + /** @const */ var /** number */ v_19 = base.limit - base.cursor; + r_step_5a(); + base.cursor = base.limit - v_19; + /** @const */ var /** number */ v_20 = base.limit - base.cursor; + r_step_5b(); + base.cursor = base.limit - v_20; + /** @const */ var /** number */ v_21 = base.limit - base.cursor; + r_step_5c(); + base.cursor = base.limit - v_21; + /** @const */ var /** number */ v_22 = base.limit - base.cursor; + r_step_5d(); + base.cursor = base.limit - v_22; + /** @const */ var /** number */ v_23 = base.limit - base.cursor; + r_step_5e(); + base.cursor = base.limit - v_23; + /** @const */ var /** number */ v_24 = base.limit - base.cursor; + r_step_5f(); + base.cursor = base.limit - v_24; + /** @const */ var /** number */ v_25 = base.limit - base.cursor; + r_step_5g(); + base.cursor = base.limit - v_25; + /** @const */ var /** number */ v_26 = base.limit - base.cursor; + r_step_5h(); + base.cursor = base.limit - v_26; + /** @const */ var /** number */ v_27 = base.limit - base.cursor; + r_step_5j(); + base.cursor = base.limit - v_27; + /** @const */ var /** number */ v_28 = base.limit - base.cursor; + r_step_5i(); + base.cursor = base.limit - v_28; + /** @const */ var /** number */ v_29 = base.limit - base.cursor; + r_step_5k(); + base.cursor = base.limit - v_29; + /** @const */ var /** number */ v_30 = base.limit - base.cursor; + r_step_5l(); + base.cursor = base.limit - v_30; + /** @const */ var /** number */ v_31 = base.limit - base.cursor; + r_step_5m(); + base.cursor = base.limit - v_31; + /** @const */ var /** number */ v_32 = base.limit - base.cursor; + r_step_6(); + base.cursor = base.limit - v_32; + /** @const */ var /** number */ v_33 = base.limit - base.cursor; + r_step_7(); + base.cursor = base.limit - v_33; + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/hindi-stemmer.js b/sphinx/search/non-minified-js/hindi-stemmer.js new file mode 100644 index 00000000000..26a715e7e77 --- /dev/null +++ b/sphinx/search/non-minified-js/hindi-stemmer.js @@ -0,0 +1,181 @@ +// Generated from hindi.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var HindiStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["\u0906\u0901", -1, -1], + ["\u093E\u0901", -1, -1], + ["\u0907\u092F\u093E\u0901", 1, -1], + ["\u0906\u0907\u092F\u093E\u0901", 2, -1], + ["\u093E\u0907\u092F\u093E\u0901", 2, -1], + ["\u093F\u092F\u093E\u0901", 1, -1], + ["\u0906\u0902", -1, -1], + ["\u0909\u0906\u0902", 6, -1], + ["\u0941\u0906\u0902", 6, -1], + ["\u0908\u0902", -1, -1], + ["\u0906\u0908\u0902", 9, -1], + ["\u093E\u0908\u0902", 9, -1], + ["\u090F\u0902", -1, -1], + ["\u0906\u090F\u0902", 12, -1], + ["\u0909\u090F\u0902", 12, -1], + ["\u093E\u090F\u0902", 12, -1], + ["\u0924\u093E\u090F\u0902", 15, -1, r_CONSONANT], + ["\u0905\u0924\u093E\u090F\u0902", 16, -1], + ["\u0928\u093E\u090F\u0902", 15, -1, r_CONSONANT], + ["\u0905\u0928\u093E\u090F\u0902", 18, -1], + ["\u0941\u090F\u0902", 12, -1], + ["\u0913\u0902", -1, -1], + ["\u0906\u0913\u0902", 21, -1], + ["\u0909\u0913\u0902", 21, -1], + ["\u093E\u0913\u0902", 21, -1], + ["\u0924\u093E\u0913\u0902", 24, -1, r_CONSONANT], + ["\u0905\u0924\u093E\u0913\u0902", 25, -1], + ["\u0928\u093E\u0913\u0902", 24, -1, r_CONSONANT], + ["\u0905\u0928\u093E\u0913\u0902", 27, -1], + ["\u0941\u0913\u0902", 21, -1], + ["\u093E\u0902", -1, -1], + ["\u0907\u092F\u093E\u0902", 30, -1], + ["\u0906\u0907\u092F\u093E\u0902", 31, -1], + ["\u093E\u0907\u092F\u093E\u0902", 31, -1], + ["\u093F\u092F\u093E\u0902", 30, -1], + ["\u0940\u0902", -1, -1], + ["\u0924\u0940\u0902", 35, -1, r_CONSONANT], + ["\u0905\u0924\u0940\u0902", 36, -1], + ["\u0906\u0924\u0940\u0902", 36, -1], + ["\u093E\u0924\u0940\u0902", 36, -1], + ["\u0947\u0902", -1, -1], + ["\u094B\u0902", -1, -1], + ["\u0907\u092F\u094B\u0902", 41, -1], + ["\u0906\u0907\u092F\u094B\u0902", 42, -1], + ["\u093E\u0907\u092F\u094B\u0902", 42, -1], + ["\u093F\u092F\u094B\u0902", 41, -1], + ["\u0905", -1, -1], + ["\u0906", -1, -1], + ["\u0907", -1, -1], + ["\u0908", -1, -1], + ["\u0906\u0908", 49, -1], + ["\u093E\u0908", 49, -1], + ["\u0909", -1, -1], + ["\u090A", -1, -1], + ["\u090F", -1, -1], + ["\u0906\u090F", 54, -1], + ["\u0907\u090F", 54, -1], + ["\u0906\u0907\u090F", 56, -1], + ["\u093E\u0907\u090F", 56, -1], + ["\u093E\u090F", 54, -1], + ["\u093F\u090F", 54, -1], + ["\u0913", -1, -1], + ["\u0906\u0913", 61, -1], + ["\u093E\u0913", 61, -1], + ["\u0915\u0930", -1, -1, r_CONSONANT], + ["\u0905\u0915\u0930", 64, -1], + ["\u0906\u0915\u0930", 64, -1], + ["\u093E\u0915\u0930", 64, -1], + ["\u093E", -1, -1], + ["\u090A\u0902\u0917\u093E", 68, -1], + ["\u0906\u090A\u0902\u0917\u093E", 69, -1], + ["\u093E\u090A\u0902\u0917\u093E", 69, -1], + ["\u0942\u0902\u0917\u093E", 68, -1], + ["\u090F\u0917\u093E", 68, -1], + ["\u0906\u090F\u0917\u093E", 73, -1], + ["\u093E\u090F\u0917\u093E", 73, -1], + ["\u0947\u0917\u093E", 68, -1], + ["\u0924\u093E", 68, -1, r_CONSONANT], + ["\u0905\u0924\u093E", 77, -1], + ["\u0906\u0924\u093E", 77, -1], + ["\u093E\u0924\u093E", 77, -1], + ["\u0928\u093E", 68, -1, r_CONSONANT], + ["\u0905\u0928\u093E", 81, -1], + ["\u0906\u0928\u093E", 81, -1], + ["\u093E\u0928\u093E", 81, -1], + ["\u0906\u092F\u093E", 68, -1], + ["\u093E\u092F\u093E", 68, -1], + ["\u093F", -1, -1], + ["\u0940", -1, -1], + ["\u090A\u0902\u0917\u0940", 88, -1], + ["\u0906\u090A\u0902\u0917\u0940", 89, -1], + ["\u093E\u090A\u0902\u0917\u0940", 89, -1], + ["\u090F\u0902\u0917\u0940", 88, -1], + ["\u0906\u090F\u0902\u0917\u0940", 92, -1], + ["\u093E\u090F\u0902\u0917\u0940", 92, -1], + ["\u0942\u0902\u0917\u0940", 88, -1], + ["\u0947\u0902\u0917\u0940", 88, -1], + ["\u090F\u0917\u0940", 88, -1], + ["\u0906\u090F\u0917\u0940", 97, -1], + ["\u093E\u090F\u0917\u0940", 97, -1], + ["\u0913\u0917\u0940", 88, -1], + ["\u0906\u0913\u0917\u0940", 100, -1], + ["\u093E\u0913\u0917\u0940", 100, -1], + ["\u0947\u0917\u0940", 88, -1], + ["\u094B\u0917\u0940", 88, -1], + ["\u0924\u0940", 88, -1, r_CONSONANT], + ["\u0905\u0924\u0940", 105, -1], + ["\u0906\u0924\u0940", 105, -1], + ["\u093E\u0924\u0940", 105, -1], + ["\u0928\u0940", 88, -1, r_CONSONANT], + ["\u0905\u0928\u0940", 109, -1], + ["\u0941", -1, -1], + ["\u0942", -1, -1], + ["\u0947", -1, -1], + ["\u090F\u0902\u0917\u0947", 113, -1], + ["\u0906\u090F\u0902\u0917\u0947", 114, -1], + ["\u093E\u090F\u0902\u0917\u0947", 114, -1], + ["\u0947\u0902\u0917\u0947", 113, -1], + ["\u0913\u0917\u0947", 113, -1], + ["\u0906\u0913\u0917\u0947", 118, -1], + ["\u093E\u0913\u0917\u0947", 118, -1], + ["\u094B\u0917\u0947", 113, -1], + ["\u0924\u0947", 113, -1, r_CONSONANT], + ["\u0905\u0924\u0947", 122, -1], + ["\u0906\u0924\u0947", 122, -1], + ["\u093E\u0924\u0947", 122, -1], + ["\u0928\u0947", 113, -1, r_CONSONANT], + ["\u0905\u0928\u0947", 126, -1], + ["\u0906\u0928\u0947", 126, -1], + ["\u093E\u0928\u0947", 126, -1], + ["\u094B", -1, -1], + ["\u094D", -1, -1] + ]; + + /** @const */ var /** Array */ g_consonant = [255, 255, 255, 255, 159, 0, 0, 0, 248, 7]; + + + /** @return {boolean} */ + function r_CONSONANT() { + if (!(base.in_grouping_b(g_consonant, 2325, 2399))) + { + return false; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + if (base.cursor >= base.limit) + { + return false; + } + base.cursor++; + base.limit_backward = base.cursor; base.cursor = base.limit; + base.ket = base.cursor; + if (base.find_among_b(a_0) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/hungarian-stemmer.js b/sphinx/search/non-minified-js/hungarian-stemmer.js index 2c550ac0d0e..886e1cf39b2 100644 --- a/sphinx/search/non-minified-js/hungarian-stemmer.js +++ b/sphinx/search/non-minified-js/hungarian-stemmer.js @@ -1,25 +1,15 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from hungarian.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -HungarianStemmer = function() { +var HungarianStemmer = function() { var base = new BaseStemmer(); - /** @const */ var a_0 = [ - ["cs", -1, -1], - ["dzs", -1, -1], - ["gy", -1, -1], - ["ly", -1, -1], - ["ny", -1, -1], - ["sz", -1, -1], - ["ty", -1, -1], - ["zs", -1, -1] - ]; - /** @const */ var a_1 = [ + /** @const */ var a_0 = [ ["\u00E1", -1, 1], ["\u00E9", -1, 2] ]; - /** @const */ var a_2 = [ + /** @const */ var a_1 = [ ["bb", -1, -1], ["cc", -1, -1], ["dd", -1, -1], @@ -45,12 +35,12 @@ HungarianStemmer = function() { ["zz", -1, -1] ]; - /** @const */ var a_3 = [ + /** @const */ var a_2 = [ ["al", -1, 1], ["el", -1, 1] ]; - /** @const */ var a_4 = [ + /** @const */ var a_3 = [ ["ba", -1, -1], ["ra", -1, -1], ["be", -1, -1], @@ -97,13 +87,13 @@ HungarianStemmer = function() { ["v\u00E9", -1, -1] ]; - /** @const */ var a_5 = [ + /** @const */ var a_4 = [ ["\u00E1n", -1, 2], ["\u00E9n", -1, 1], ["\u00E1nk\u00E9nt", -1, 2] ]; - /** @const */ var a_6 = [ + /** @const */ var a_5 = [ ["stul", -1, 1], ["astul", 0, 1], ["\u00E1stul", 0, 2], @@ -112,12 +102,12 @@ HungarianStemmer = function() { ["\u00E9st\u00FCl", 3, 3] ]; - /** @const */ var a_7 = [ + /** @const */ var a_6 = [ ["\u00E1", -1, 1], ["\u00E9", -1, 1] ]; - /** @const */ var a_8 = [ + /** @const */ var a_7 = [ ["k", -1, 3], ["ak", 0, 3], ["ek", 0, 3], @@ -127,7 +117,7 @@ HungarianStemmer = function() { ["\u00F6k", 0, 3] ]; - /** @const */ var a_9 = [ + /** @const */ var a_8 = [ ["\u00E9i", -1, 1], ["\u00E1\u00E9i", 0, 3], ["\u00E9\u00E9i", 0, 2], @@ -142,7 +132,7 @@ HungarianStemmer = function() { ["\u00E9\u00E9", 3, 2] ]; - /** @const */ var a_10 = [ + /** @const */ var a_9 = [ ["a", -1, 1], ["ja", 0, 1], ["d", -1, 1], @@ -176,7 +166,7 @@ HungarianStemmer = function() { ["\u00E9", -1, 3] ]; - /** @const */ var a_11 = [ + /** @const */ var a_10 = [ ["id", -1, 1], ["aid", 0, 1], ["jaid", 1, 1], @@ -230,69 +220,30 @@ HungarianStemmer = function() { function r_mark_regions() { I_p1 = base.limit; lab0: { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab1: { if (!(base.in_grouping(g_v, 97, 369))) { break lab1; } - golab2: while(true) - { - var /** number */ v_2 = base.cursor; - lab3: { - if (!(base.out_grouping(g_v, 97, 369))) - { - break lab3; - } - base.cursor = v_2; - break golab2; - } - base.cursor = v_2; - if (base.cursor >= base.limit) - { - break lab1; - } - base.cursor++; - } - lab4: { - var /** number */ v_3 = base.cursor; - lab5: { - if (base.find_among(a_0) == 0) - { - break lab5; - } - break lab4; - } - base.cursor = v_3; - if (base.cursor >= base.limit) + /** @const */ var /** number */ v_2 = base.cursor; + lab2: { + if (!base.go_in_grouping(g_v, 97, 369)) { - break lab1; + break lab2; } base.cursor++; + I_p1 = base.cursor; } - I_p1 = base.cursor; + base.cursor = v_2; break lab0; } base.cursor = v_1; - if (!(base.out_grouping(g_v, 97, 369))) + if (!base.go_out_grouping(g_v, 97, 369)) { return false; } - golab6: while(true) - { - lab7: { - if (!(base.in_grouping(g_v, 97, 369))) - { - break lab7; - } - break golab6; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; - } + base.cursor++; I_p1 = base.cursor; } return true; @@ -300,18 +251,14 @@ HungarianStemmer = function() { /** @return {boolean} */ function r_R1() { - if (!(I_p1 <= base.cursor)) - { - return false; - } - return true; + return I_p1 <= base.cursor; }; /** @return {boolean} */ function r_v_ending() { var /** number */ among_var; base.ket = base.cursor; - among_var = base.find_among_b(a_1); + among_var = base.find_among_b(a_0); if (among_var == 0) { return false; @@ -340,8 +287,8 @@ HungarianStemmer = function() { /** @return {boolean} */ function r_double() { - var /** number */ v_1 = base.limit - base.cursor; - if (base.find_among_b(a_2) == 0) + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + if (base.find_among_b(a_1) == 0) { return false; } @@ -357,14 +304,11 @@ HungarianStemmer = function() { } base.cursor--; base.ket = base.cursor; + if (base.cursor <= base.limit_backward) { - var /** number */ c1 = base.cursor - 1; - if (c1 < base.limit_backward) - { - return false; - } - base.cursor = c1; + return false; } + base.cursor--; base.bra = base.cursor; if (!base.slice_del()) { @@ -376,7 +320,7 @@ HungarianStemmer = function() { /** @return {boolean} */ function r_instrum() { base.ket = base.cursor; - if (base.find_among_b(a_3) == 0) + if (base.find_among_b(a_2) == 0) { return false; } @@ -403,7 +347,7 @@ HungarianStemmer = function() { /** @return {boolean} */ function r_case() { base.ket = base.cursor; - if (base.find_among_b(a_4) == 0) + if (base.find_among_b(a_3) == 0) { return false; } @@ -427,7 +371,7 @@ HungarianStemmer = function() { function r_case_special() { var /** number */ among_var; base.ket = base.cursor; - among_var = base.find_among_b(a_5); + among_var = base.find_among_b(a_4); if (among_var == 0) { return false; @@ -458,7 +402,7 @@ HungarianStemmer = function() { function r_case_other() { var /** number */ among_var; base.ket = base.cursor; - among_var = base.find_among_b(a_6); + among_var = base.find_among_b(a_5); if (among_var == 0) { return false; @@ -494,7 +438,7 @@ HungarianStemmer = function() { /** @return {boolean} */ function r_factive() { base.ket = base.cursor; - if (base.find_among_b(a_7) == 0) + if (base.find_among_b(a_6) == 0) { return false; } @@ -522,7 +466,7 @@ HungarianStemmer = function() { function r_plural() { var /** number */ among_var; base.ket = base.cursor; - among_var = base.find_among_b(a_8); + among_var = base.find_among_b(a_7); if (among_var == 0) { return false; @@ -559,7 +503,7 @@ HungarianStemmer = function() { function r_owned() { var /** number */ among_var; base.ket = base.cursor; - among_var = base.find_among_b(a_9); + among_var = base.find_among_b(a_8); if (among_var == 0) { return false; @@ -596,7 +540,7 @@ HungarianStemmer = function() { function r_sing_owner() { var /** number */ among_var; base.ket = base.cursor; - among_var = base.find_among_b(a_10); + among_var = base.find_among_b(a_9); if (among_var == 0) { return false; @@ -633,7 +577,7 @@ HungarianStemmer = function() { function r_plur_owner() { var /** number */ among_var; base.ket = base.cursor; - among_var = base.find_among_b(a_11); + among_var = base.find_among_b(a_10); if (among_var == 0) { return false; @@ -667,35 +611,35 @@ HungarianStemmer = function() { }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; r_mark_regions(); base.cursor = v_1; base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; r_instrum(); base.cursor = base.limit - v_2; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; r_case(); base.cursor = base.limit - v_3; - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; r_case_special(); base.cursor = base.limit - v_4; - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; r_case_other(); base.cursor = base.limit - v_5; - var /** number */ v_6 = base.limit - base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; r_factive(); base.cursor = base.limit - v_6; - var /** number */ v_7 = base.limit - base.cursor; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; r_owned(); base.cursor = base.limit - v_7; - var /** number */ v_8 = base.limit - base.cursor; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; r_sing_owner(); base.cursor = base.limit - v_8; - var /** number */ v_9 = base.limit - base.cursor; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; r_plur_owner(); base.cursor = base.limit - v_9; - var /** number */ v_10 = base.limit - base.cursor; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; r_plural(); base.cursor = base.limit - v_10; base.cursor = base.limit_backward; diff --git a/sphinx/search/non-minified-js/indonesian-stemmer.js b/sphinx/search/non-minified-js/indonesian-stemmer.js new file mode 100644 index 00000000000..714c410e738 --- /dev/null +++ b/sphinx/search/non-minified-js/indonesian-stemmer.js @@ -0,0 +1,409 @@ +// Generated from indonesian.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var IndonesianStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["kah", -1, 1], + ["lah", -1, 1], + ["pun", -1, 1] + ]; + + /** @const */ var a_1 = [ + ["nya", -1, 1], + ["ku", -1, 1], + ["mu", -1, 1] + ]; + + /** @const */ var a_2 = [ + ["i", -1, 1, r_SUFFIX_I_OK], + ["an", -1, 1, r_SUFFIX_AN_OK], + ["kan", 1, 1, r_SUFFIX_KAN_OK] + ]; + + /** @const */ var a_3 = [ + ["di", -1, 1], + ["ke", -1, 2], + ["me", -1, 1], + ["mem", 2, 5], + ["men", 2, 1], + ["meng", 4, 1], + ["meny", 4, 3, r_VOWEL], + ["pem", -1, 6], + ["pen", -1, 2], + ["peng", 8, 2], + ["peny", 8, 4, r_VOWEL], + ["ter", -1, 1] + ]; + + /** @const */ var a_4 = [ + ["be", -1, 3, r_KER], + ["belajar", 0, 4], + ["ber", 0, 3], + ["pe", -1, 1], + ["pelajar", 3, 2], + ["per", 3, 1] + ]; + + /** @const */ var /** Array */ g_vowel = [17, 65, 16]; + + var /** number */ I_prefix = 0; + var /** number */ I_measure = 0; + + + /** @return {boolean} */ + function r_remove_particle() { + base.ket = base.cursor; + if (base.find_among_b(a_0) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + I_measure -= 1; + return true; + }; + + /** @return {boolean} */ + function r_remove_possessive_pronoun() { + base.ket = base.cursor; + if (base.find_among_b(a_1) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + I_measure -= 1; + return true; + }; + + /** @return {boolean} */ + function r_SUFFIX_KAN_OK() { + if (I_prefix == 3) + { + return false; + } + if (I_prefix == 2) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_SUFFIX_AN_OK() { + return I_prefix != 1; + }; + + /** @return {boolean} */ + function r_SUFFIX_I_OK() { + if (I_prefix > 2) + { + return false; + } + { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (!(base.eq_s_b("s"))) + { + break lab0; + } + return false; + } + base.cursor = base.limit - v_1; + } + return true; + }; + + /** @return {boolean} */ + function r_remove_suffix() { + base.ket = base.cursor; + if (base.find_among_b(a_2) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + I_measure -= 1; + return true; + }; + + /** @return {boolean} */ + function r_VOWEL() { + if (!(base.in_grouping(g_vowel, 97, 117))) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_KER() { + if (!(base.out_grouping(g_vowel, 97, 117))) + { + return false; + } + if (!(base.eq_s("er"))) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_remove_first_order_prefix() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_3); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + I_prefix = 1; + I_measure -= 1; + break; + case 2: + if (!base.slice_del()) + { + return false; + } + I_prefix = 3; + I_measure -= 1; + break; + case 3: + I_prefix = 1; + if (!base.slice_from("s")) + { + return false; + } + I_measure -= 1; + break; + case 4: + I_prefix = 3; + if (!base.slice_from("s")) + { + return false; + } + I_measure -= 1; + break; + case 5: + I_prefix = 1; + I_measure -= 1; + lab0: { + /** @const */ var /** number */ v_1 = base.cursor; + lab1: { + /** @const */ var /** number */ v_2 = base.cursor; + if (!(base.in_grouping(g_vowel, 97, 117))) + { + break lab1; + } + base.cursor = v_2; + if (!base.slice_from("p")) + { + return false; + } + break lab0; + } + base.cursor = v_1; + if (!base.slice_del()) + { + return false; + } + } + break; + case 6: + I_prefix = 3; + I_measure -= 1; + lab2: { + /** @const */ var /** number */ v_3 = base.cursor; + lab3: { + /** @const */ var /** number */ v_4 = base.cursor; + if (!(base.in_grouping(g_vowel, 97, 117))) + { + break lab3; + } + base.cursor = v_4; + if (!base.slice_from("p")) + { + return false; + } + break lab2; + } + base.cursor = v_3; + if (!base.slice_del()) + { + return false; + } + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_remove_second_order_prefix() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_4); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + I_prefix = 2; + I_measure -= 1; + break; + case 2: + if (!base.slice_from("ajar")) + { + return false; + } + I_measure -= 1; + break; + case 3: + if (!base.slice_del()) + { + return false; + } + I_prefix = 4; + I_measure -= 1; + break; + case 4: + if (!base.slice_from("ajar")) + { + return false; + } + I_prefix = 4; + I_measure -= 1; + break; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + I_measure = 0; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + while(true) + { + lab1: { + if (!base.go_out_grouping(g_vowel, 97, 117)) + { + break lab1; + } + base.cursor++; + I_measure += 1; + continue; + } + break; + } + } + base.cursor = v_1; + if (I_measure <= 2) + { + return false; + } + I_prefix = 0; + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + r_remove_particle(); + base.cursor = base.limit - v_2; + if (I_measure <= 2) + { + return false; + } + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + r_remove_possessive_pronoun(); + base.cursor = base.limit - v_3; + base.cursor = base.limit_backward; + if (I_measure <= 2) + { + return false; + } + lab2: { + /** @const */ var /** number */ v_4 = base.cursor; + lab3: { + /** @const */ var /** number */ v_5 = base.cursor; + if (!r_remove_first_order_prefix()) + { + break lab3; + } + /** @const */ var /** number */ v_6 = base.cursor; + lab4: { + /** @const */ var /** number */ v_7 = base.cursor; + if (I_measure <= 2) + { + break lab4; + } + base.limit_backward = base.cursor; base.cursor = base.limit; + if (!r_remove_suffix()) + { + break lab4; + } + base.cursor = base.limit_backward; + base.cursor = v_7; + if (I_measure <= 2) + { + break lab4; + } + if (!r_remove_second_order_prefix()) + { + break lab4; + } + } + base.cursor = v_6; + base.cursor = v_5; + break lab2; + } + base.cursor = v_4; + /** @const */ var /** number */ v_8 = base.cursor; + r_remove_second_order_prefix(); + base.cursor = v_8; + /** @const */ var /** number */ v_9 = base.cursor; + lab5: { + if (I_measure <= 2) + { + break lab5; + } + base.limit_backward = base.cursor; base.cursor = base.limit; + if (!r_remove_suffix()) + { + break lab5; + } + base.cursor = base.limit_backward; + } + base.cursor = v_9; + } + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/irish-stemmer.js b/sphinx/search/non-minified-js/irish-stemmer.js new file mode 100644 index 00000000000..ec6601efb04 --- /dev/null +++ b/sphinx/search/non-minified-js/irish-stemmer.js @@ -0,0 +1,378 @@ +// Generated from irish.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var IrishStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["b'", -1, 1], + ["bh", -1, 4], + ["bhf", 1, 2], + ["bp", -1, 8], + ["ch", -1, 5], + ["d'", -1, 1], + ["d'fh", 5, 2], + ["dh", -1, 6], + ["dt", -1, 9], + ["fh", -1, 2], + ["gc", -1, 5], + ["gh", -1, 7], + ["h-", -1, 1], + ["m'", -1, 1], + ["mb", -1, 4], + ["mh", -1, 10], + ["n-", -1, 1], + ["nd", -1, 6], + ["ng", -1, 7], + ["ph", -1, 8], + ["sh", -1, 3], + ["t-", -1, 1], + ["th", -1, 9], + ["ts", -1, 3] + ]; + + /** @const */ var a_1 = [ + ["\u00EDochta", -1, 1], + ["a\u00EDochta", 0, 1], + ["ire", -1, 2], + ["aire", 2, 2], + ["abh", -1, 1], + ["eabh", 4, 1], + ["ibh", -1, 1], + ["aibh", 6, 1], + ["amh", -1, 1], + ["eamh", 8, 1], + ["imh", -1, 1], + ["aimh", 10, 1], + ["\u00EDocht", -1, 1], + ["a\u00EDocht", 12, 1], + ["ir\u00ED", -1, 2], + ["air\u00ED", 14, 2] + ]; + + /** @const */ var a_2 = [ + ["\u00F3ideacha", -1, 6], + ["patacha", -1, 5], + ["achta", -1, 1], + ["arcachta", 2, 2], + ["eachta", 2, 1], + ["grafa\u00EDochta", -1, 4], + ["paite", -1, 5], + ["ach", -1, 1], + ["each", 7, 1], + ["\u00F3ideach", 8, 6], + ["gineach", 8, 3], + ["patach", 7, 5], + ["grafa\u00EDoch", -1, 4], + ["pataigh", -1, 5], + ["\u00F3idigh", -1, 6], + ["acht\u00FAil", -1, 1], + ["eacht\u00FAil", 15, 1], + ["gineas", -1, 3], + ["ginis", -1, 3], + ["acht", -1, 1], + ["arcacht", 19, 2], + ["eacht", 19, 1], + ["grafa\u00EDocht", -1, 4], + ["arcachta\u00ED", -1, 2], + ["grafa\u00EDochta\u00ED", -1, 4] + ]; + + /** @const */ var a_3 = [ + ["imid", -1, 1], + ["aimid", 0, 1], + ["\u00EDmid", -1, 1], + ["a\u00EDmid", 2, 1], + ["adh", -1, 2], + ["eadh", 4, 2], + ["faidh", -1, 1], + ["fidh", -1, 1], + ["\u00E1il", -1, 2], + ["ain", -1, 2], + ["tear", -1, 2], + ["tar", -1, 2] + ]; + + /** @const */ var /** Array */ g_v = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 17, 4, 2]; + + var /** number */ I_p2 = 0; + var /** number */ I_p1 = 0; + var /** number */ I_pV = 0; + + + /** @return {boolean} */ + function r_mark_regions() { + I_pV = base.limit; + I_p1 = base.limit; + I_p2 = base.limit; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + if (!base.go_out_grouping(g_v, 97, 250)) + { + break lab0; + } + base.cursor++; + I_pV = base.cursor; + if (!base.go_in_grouping(g_v, 97, 250)) + { + break lab0; + } + base.cursor++; + I_p1 = base.cursor; + if (!base.go_out_grouping(g_v, 97, 250)) + { + break lab0; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 250)) + { + break lab0; + } + base.cursor++; + I_p2 = base.cursor; + } + base.cursor = v_1; + return true; + }; + + /** @return {boolean} */ + function r_initial_morph() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_0); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!base.slice_from("f")) + { + return false; + } + break; + case 3: + if (!base.slice_from("s")) + { + return false; + } + break; + case 4: + if (!base.slice_from("b")) + { + return false; + } + break; + case 5: + if (!base.slice_from("c")) + { + return false; + } + break; + case 6: + if (!base.slice_from("d")) + { + return false; + } + break; + case 7: + if (!base.slice_from("g")) + { + return false; + } + break; + case 8: + if (!base.slice_from("p")) + { + return false; + } + break; + case 9: + if (!base.slice_from("t")) + { + return false; + } + break; + case 10: + if (!base.slice_from("m")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_RV() { + return I_pV <= base.cursor; + }; + + /** @return {boolean} */ + function r_R1() { + return I_p1 <= base.cursor; + }; + + /** @return {boolean} */ + function r_R2() { + return I_p2 <= base.cursor; + }; + + /** @return {boolean} */ + function r_noun_sfx() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_1); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!r_R2()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_deriv() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_2); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R2()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!base.slice_from("arc")) + { + return false; + } + break; + case 3: + if (!base.slice_from("gin")) + { + return false; + } + break; + case 4: + if (!base.slice_from("graf")) + { + return false; + } + break; + case 5: + if (!base.slice_from("paite")) + { + return false; + } + break; + case 6: + if (!base.slice_from("\u00F3id")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_verb_sfx() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_3); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_RV()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!r_R1()) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + /** @const */ var /** number */ v_1 = base.cursor; + r_initial_morph(); + base.cursor = v_1; + r_mark_regions(); + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + r_noun_sfx(); + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + r_deriv(); + base.cursor = base.limit - v_3; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + r_verb_sfx(); + base.cursor = base.limit - v_4; + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/italian-stemmer.js b/sphinx/search/non-minified-js/italian-stemmer.js index df6ddfd332a..f5ab55ecc8d 100644 --- a/sphinx/search/non-minified-js/italian-stemmer.js +++ b/sphinx/search/non-minified-js/italian-stemmer.js @@ -1,8 +1,9 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from italian.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -ItalianStemmer = function() { +var ItalianStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ ["", -1, 7], ["qu", 0, 6], @@ -238,17 +239,13 @@ ItalianStemmer = function() { /** @return {boolean} */ function r_prelude() { var /** number */ among_var; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; while(true) { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_0); - if (among_var == 0) - { - break lab0; - } base.ket = base.cursor; switch (among_var) { case 1: @@ -303,11 +300,11 @@ ItalianStemmer = function() { base.cursor = v_1; while(true) { - var /** number */ v_3 = base.cursor; + /** @const */ var /** number */ v_3 = base.cursor; lab1: { golab2: while(true) { - var /** number */ v_4 = base.cursor; + /** @const */ var /** number */ v_4 = base.cursor; lab3: { if (!(base.in_grouping(g_v, 97, 249))) { @@ -315,7 +312,7 @@ ItalianStemmer = function() { } base.bra = base.cursor; lab4: { - var /** number */ v_5 = base.cursor; + /** @const */ var /** number */ v_5 = base.cursor; lab5: { if (!(base.eq_s("u"))) { @@ -370,37 +367,27 @@ ItalianStemmer = function() { I_pV = base.limit; I_p1 = base.limit; I_p2 = base.limit; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { lab1: { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 249))) { break lab2; } lab3: { - var /** number */ v_3 = base.cursor; + /** @const */ var /** number */ v_3 = base.cursor; lab4: { if (!(base.out_grouping(g_v, 97, 249))) { break lab4; } - golab5: while(true) + if (!base.go_out_grouping(g_v, 97, 249)) { - lab6: { - if (!(base.in_grouping(g_v, 97, 249))) - { - break lab6; - } - break golab5; - } - if (base.cursor >= base.limit) - { - break lab4; - } - base.cursor++; + break lab4; } + base.cursor++; break lab3; } base.cursor = v_3; @@ -408,21 +395,19 @@ ItalianStemmer = function() { { break lab2; } - golab7: while(true) + if (!base.go_in_grouping(g_v, 97, 249)) { - lab8: { - if (!(base.out_grouping(g_v, 97, 249))) - { - break lab8; - } - break golab7; - } - if (base.cursor >= base.limit) - { - break lab2; - } - base.cursor++; + break lab2; } + base.cursor++; + } + break lab1; + } + base.cursor = v_2; + lab5: { + if (!(base.eq_s("divan"))) + { + break lab5; } break lab1; } @@ -431,31 +416,21 @@ ItalianStemmer = function() { { break lab0; } - lab9: { - var /** number */ v_6 = base.cursor; - lab10: { + lab6: { + /** @const */ var /** number */ v_4 = base.cursor; + lab7: { if (!(base.out_grouping(g_v, 97, 249))) { - break lab10; + break lab7; } - golab11: while(true) + if (!base.go_out_grouping(g_v, 97, 249)) { - lab12: { - if (!(base.in_grouping(g_v, 97, 249))) - { - break lab12; - } - break golab11; - } - if (base.cursor >= base.limit) - { - break lab10; - } - base.cursor++; + break lab7; } - break lab9; + base.cursor++; + break lab6; } - base.cursor = v_6; + base.cursor = v_4; if (!(base.in_grouping(g_v, 97, 249))) { break lab0; @@ -470,72 +445,32 @@ ItalianStemmer = function() { I_pV = base.cursor; } base.cursor = v_1; - var /** number */ v_8 = base.cursor; - lab13: { - golab14: while(true) + /** @const */ var /** number */ v_5 = base.cursor; + lab8: { + if (!base.go_out_grouping(g_v, 97, 249)) { - lab15: { - if (!(base.in_grouping(g_v, 97, 249))) - { - break lab15; - } - break golab14; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab8; } - golab16: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 249)) { - lab17: { - if (!(base.out_grouping(g_v, 97, 249))) - { - break lab17; - } - break golab16; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab8; } + base.cursor++; I_p1 = base.cursor; - golab18: while(true) + if (!base.go_out_grouping(g_v, 97, 249)) { - lab19: { - if (!(base.in_grouping(g_v, 97, 249))) - { - break lab19; - } - break golab18; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab8; } - golab20: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 249)) { - lab21: { - if (!(base.out_grouping(g_v, 97, 249))) - { - break lab21; - } - break golab20; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab8; } + base.cursor++; I_p2 = base.cursor; } - base.cursor = v_8; + base.cursor = v_5; return true; }; @@ -544,14 +479,10 @@ ItalianStemmer = function() { var /** number */ among_var; while(true) { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_1); - if (among_var == 0) - { - break lab0; - } base.ket = base.cursor; switch (among_var) { case 1: @@ -584,29 +515,17 @@ ItalianStemmer = function() { /** @return {boolean} */ function r_RV() { - if (!(I_pV <= base.cursor)) - { - return false; - } - return true; + return I_pV <= base.cursor; }; /** @return {boolean} */ function r_R1() { - if (!(I_p1 <= base.cursor)) - { - return false; - } - return true; + return I_p1 <= base.cursor; }; /** @return {boolean} */ function r_R2() { - if (!(I_p2 <= base.cursor)) - { - return false; - } - return true; + return I_p2 <= base.cursor; }; /** @return {boolean} */ @@ -674,7 +593,7 @@ ItalianStemmer = function() { { return false; } - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("ic"))) @@ -743,7 +662,7 @@ ItalianStemmer = function() { { return false; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab1: { base.ket = base.cursor; among_var = base.find_among_b(a_4); @@ -793,7 +712,7 @@ ItalianStemmer = function() { { return false; } - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab2: { base.ket = base.cursor; if (base.find_among_b(a_5) == 0) @@ -822,7 +741,7 @@ ItalianStemmer = function() { { return false; } - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab3: { base.ket = base.cursor; if (!(base.eq_s_b("at"))) @@ -868,12 +787,12 @@ ItalianStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; if (base.find_among_b(a_7) == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; @@ -881,13 +800,13 @@ ItalianStemmer = function() { { return false; } - base.limit_backward = v_2; + base.limit_backward = v_1; return true; }; /** @return {boolean} */ function r_vowel_suffix() { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.in_grouping_b(g_AEIO, 97, 242))) @@ -922,7 +841,7 @@ ItalianStemmer = function() { return false; } } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab1: { base.ket = base.cursor; if (!(base.eq_s_b("h"))) @@ -950,18 +869,18 @@ ItalianStemmer = function() { }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; r_prelude(); base.cursor = v_1; r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; r_attached_pronoun(); - base.cursor = base.limit - v_3; - var /** number */ v_4 = base.limit - base.cursor; + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab0: { lab1: { - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab2: { if (!r_standard_suffix()) { @@ -969,21 +888,21 @@ ItalianStemmer = function() { } break lab1; } - base.cursor = base.limit - v_5; + base.cursor = base.limit - v_4; if (!r_verb_suffix()) { break lab0; } } } - base.cursor = base.limit - v_4; - var /** number */ v_6 = base.limit - base.cursor; + base.cursor = base.limit - v_3; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; r_vowel_suffix(); - base.cursor = base.limit - v_6; + base.cursor = base.limit - v_5; base.cursor = base.limit_backward; - var /** number */ v_7 = base.cursor; + /** @const */ var /** number */ v_6 = base.cursor; r_postlude(); - base.cursor = v_7; + base.cursor = v_6; return true; }; diff --git a/sphinx/search/non-minified-js/lithuanian-stemmer.js b/sphinx/search/non-minified-js/lithuanian-stemmer.js new file mode 100644 index 00000000000..213ff5979b2 --- /dev/null +++ b/sphinx/search/non-minified-js/lithuanian-stemmer.js @@ -0,0 +1,534 @@ +// Generated from lithuanian.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var LithuanianStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["a", -1, -1], + ["ia", 0, -1], + ["eria", 1, -1], + ["osna", 0, -1], + ["iosna", 3, -1], + ["uosna", 3, -1], + ["iuosna", 5, -1], + ["ysna", 0, -1], + ["\u0117sna", 0, -1], + ["e", -1, -1], + ["ie", 9, -1], + ["enie", 10, -1], + ["erie", 10, -1], + ["oje", 9, -1], + ["ioje", 13, -1], + ["uje", 9, -1], + ["iuje", 15, -1], + ["yje", 9, -1], + ["enyje", 17, -1], + ["eryje", 17, -1], + ["\u0117je", 9, -1], + ["ame", 9, -1], + ["iame", 21, -1], + ["sime", 9, -1], + ["ome", 9, -1], + ["\u0117me", 9, -1], + ["tum\u0117me", 25, -1], + ["ose", 9, -1], + ["iose", 27, -1], + ["uose", 27, -1], + ["iuose", 29, -1], + ["yse", 9, -1], + ["enyse", 31, -1], + ["eryse", 31, -1], + ["\u0117se", 9, -1], + ["ate", 9, -1], + ["iate", 35, -1], + ["ite", 9, -1], + ["kite", 37, -1], + ["site", 37, -1], + ["ote", 9, -1], + ["tute", 9, -1], + ["\u0117te", 9, -1], + ["tum\u0117te", 42, -1], + ["i", -1, -1], + ["ai", 44, -1], + ["iai", 45, -1], + ["eriai", 46, -1], + ["ei", 44, -1], + ["tumei", 48, -1], + ["ki", 44, -1], + ["imi", 44, -1], + ["erimi", 51, -1], + ["umi", 44, -1], + ["iumi", 53, -1], + ["si", 44, -1], + ["asi", 55, -1], + ["iasi", 56, -1], + ["esi", 55, -1], + ["iesi", 58, -1], + ["siesi", 59, -1], + ["isi", 55, -1], + ["aisi", 61, -1], + ["eisi", 61, -1], + ["tumeisi", 63, -1], + ["uisi", 61, -1], + ["osi", 55, -1], + ["\u0117josi", 66, -1], + ["uosi", 66, -1], + ["iuosi", 68, -1], + ["siuosi", 69, -1], + ["usi", 55, -1], + ["ausi", 71, -1], + ["\u010Diausi", 72, -1], + ["\u0105si", 55, -1], + ["\u0117si", 55, -1], + ["\u0173si", 55, -1], + ["t\u0173si", 76, -1], + ["ti", 44, -1], + ["enti", 78, -1], + ["inti", 78, -1], + ["oti", 78, -1], + ["ioti", 81, -1], + ["uoti", 81, -1], + ["iuoti", 83, -1], + ["auti", 78, -1], + ["iauti", 85, -1], + ["yti", 78, -1], + ["\u0117ti", 78, -1], + ["tel\u0117ti", 88, -1], + ["in\u0117ti", 88, -1], + ["ter\u0117ti", 88, -1], + ["ui", 44, -1], + ["iui", 92, -1], + ["eniui", 93, -1], + ["oj", -1, -1], + ["\u0117j", -1, -1], + ["k", -1, -1], + ["am", -1, -1], + ["iam", 98, -1], + ["iem", -1, -1], + ["im", -1, -1], + ["sim", 101, -1], + ["om", -1, -1], + ["tum", -1, -1], + ["\u0117m", -1, -1], + ["tum\u0117m", 105, -1], + ["an", -1, -1], + ["on", -1, -1], + ["ion", 108, -1], + ["un", -1, -1], + ["iun", 110, -1], + ["\u0117n", -1, -1], + ["o", -1, -1], + ["io", 113, -1], + ["enio", 114, -1], + ["\u0117jo", 113, -1], + ["uo", 113, -1], + ["s", -1, -1], + ["as", 118, -1], + ["ias", 119, -1], + ["es", 118, -1], + ["ies", 121, -1], + ["is", 118, -1], + ["ais", 123, -1], + ["iais", 124, -1], + ["tumeis", 123, -1], + ["imis", 123, -1], + ["enimis", 127, -1], + ["omis", 123, -1], + ["iomis", 129, -1], + ["umis", 123, -1], + ["\u0117mis", 123, -1], + ["enis", 123, -1], + ["asis", 123, -1], + ["ysis", 123, -1], + ["ams", 118, -1], + ["iams", 136, -1], + ["iems", 118, -1], + ["ims", 118, -1], + ["enims", 139, -1], + ["erims", 139, -1], + ["oms", 118, -1], + ["ioms", 142, -1], + ["ums", 118, -1], + ["\u0117ms", 118, -1], + ["ens", 118, -1], + ["os", 118, -1], + ["ios", 147, -1], + ["uos", 147, -1], + ["iuos", 149, -1], + ["ers", 118, -1], + ["us", 118, -1], + ["aus", 152, -1], + ["iaus", 153, -1], + ["ius", 152, -1], + ["ys", 118, -1], + ["enys", 156, -1], + ["erys", 156, -1], + ["\u0105s", 118, -1], + ["i\u0105s", 159, -1], + ["\u0117s", 118, -1], + ["am\u0117s", 161, -1], + ["iam\u0117s", 162, -1], + ["im\u0117s", 161, -1], + ["kim\u0117s", 164, -1], + ["sim\u0117s", 164, -1], + ["om\u0117s", 161, -1], + ["\u0117m\u0117s", 161, -1], + ["tum\u0117m\u0117s", 168, -1], + ["at\u0117s", 161, -1], + ["iat\u0117s", 170, -1], + ["sit\u0117s", 161, -1], + ["ot\u0117s", 161, -1], + ["\u0117t\u0117s", 161, -1], + ["tum\u0117t\u0117s", 174, -1], + ["\u012Fs", 118, -1], + ["\u016Bs", 118, -1], + ["t\u0173s", 118, -1], + ["at", -1, -1], + ["iat", 179, -1], + ["it", -1, -1], + ["sit", 181, -1], + ["ot", -1, -1], + ["\u0117t", -1, -1], + ["tum\u0117t", 184, -1], + ["u", -1, -1], + ["au", 186, -1], + ["iau", 187, -1], + ["\u010Diau", 188, -1], + ["iu", 186, -1], + ["eniu", 190, -1], + ["siu", 190, -1], + ["y", -1, -1], + ["\u0105", -1, -1], + ["i\u0105", 194, -1], + ["\u0117", -1, -1], + ["\u0119", -1, -1], + ["\u012F", -1, -1], + ["en\u012F", 198, -1], + ["er\u012F", 198, -1], + ["\u0173", -1, -1], + ["i\u0173", 201, -1], + ["er\u0173", 201, -1] + ]; + + /** @const */ var a_1 = [ + ["ing", -1, -1], + ["aj", -1, -1], + ["iaj", 1, -1], + ["iej", -1, -1], + ["oj", -1, -1], + ["ioj", 4, -1], + ["uoj", 4, -1], + ["iuoj", 6, -1], + ["auj", -1, -1], + ["\u0105j", -1, -1], + ["i\u0105j", 9, -1], + ["\u0117j", -1, -1], + ["\u0173j", -1, -1], + ["i\u0173j", 12, -1], + ["ok", -1, -1], + ["iok", 14, -1], + ["iuk", -1, -1], + ["uliuk", 16, -1], + ["u\u010Diuk", 16, -1], + ["i\u0161k", -1, -1], + ["iul", -1, -1], + ["yl", -1, -1], + ["\u0117l", -1, -1], + ["am", -1, -1], + ["dam", 23, -1], + ["jam", 23, -1], + ["zgan", -1, -1], + ["ain", -1, -1], + ["esn", -1, -1], + ["op", -1, -1], + ["iop", 29, -1], + ["ias", -1, -1], + ["ies", -1, -1], + ["ais", -1, -1], + ["iais", 33, -1], + ["os", -1, -1], + ["ios", 35, -1], + ["uos", 35, -1], + ["iuos", 37, -1], + ["aus", -1, -1], + ["iaus", 39, -1], + ["\u0105s", -1, -1], + ["i\u0105s", 41, -1], + ["\u0119s", -1, -1], + ["ut\u0117ait", -1, -1], + ["ant", -1, -1], + ["iant", 45, -1], + ["siant", 46, -1], + ["int", -1, -1], + ["ot", -1, -1], + ["uot", 49, -1], + ["iuot", 50, -1], + ["yt", -1, -1], + ["\u0117t", -1, -1], + ["yk\u0161t", -1, -1], + ["iau", -1, -1], + ["dav", -1, -1], + ["sv", -1, -1], + ["\u0161v", -1, -1], + ["yk\u0161\u010D", -1, -1], + ["\u0119", -1, -1], + ["\u0117j\u0119", 60, -1] + ]; + + /** @const */ var a_2 = [ + ["ojime", -1, 7], + ["\u0117jime", -1, 3], + ["avime", -1, 6], + ["okate", -1, 8], + ["aite", -1, 1], + ["uote", -1, 2], + ["asius", -1, 5], + ["okat\u0117s", -1, 8], + ["ait\u0117s", -1, 1], + ["uot\u0117s", -1, 2], + ["esiu", -1, 4] + ]; + + /** @const */ var a_3 = [ + ["\u010D", -1, 1], + ["d\u017E", -1, 2] + ]; + + /** @const */ var a_4 = [ + ["gd", -1, 1] + ]; + + /** @const */ var /** Array */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 16, 0, 64, 1, 0, 64, 0, 0, 0, 0, 0, 0, 0, 4, 4]; + + var /** number */ I_p1 = 0; + + + /** @return {boolean} */ + function r_step1() { + if (base.cursor < I_p1) + { + return false; + } + /** @const */ var /** number */ v_1 = base.limit_backward; + base.limit_backward = I_p1; + base.ket = base.cursor; + if (base.find_among_b(a_0) == 0) + { + base.limit_backward = v_1; + return false; + } + base.bra = base.cursor; + base.limit_backward = v_1; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + /** @return {boolean} */ + function r_step2() { + while(true) + { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (base.cursor < I_p1) + { + break lab0; + } + /** @const */ var /** number */ v_2 = base.limit_backward; + base.limit_backward = I_p1; + base.ket = base.cursor; + if (base.find_among_b(a_1) == 0) + { + base.limit_backward = v_2; + break lab0; + } + base.bra = base.cursor; + base.limit_backward = v_2; + if (!base.slice_del()) + { + return false; + } + continue; + } + base.cursor = base.limit - v_1; + break; + } + return true; + }; + + /** @return {boolean} */ + function r_fix_conflicts() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_2); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("ait\u0117")) + { + return false; + } + break; + case 2: + if (!base.slice_from("uot\u0117")) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u0117jimas")) + { + return false; + } + break; + case 4: + if (!base.slice_from("esys")) + { + return false; + } + break; + case 5: + if (!base.slice_from("asys")) + { + return false; + } + break; + case 6: + if (!base.slice_from("avimas")) + { + return false; + } + break; + case 7: + if (!base.slice_from("ojimas")) + { + return false; + } + break; + case 8: + if (!base.slice_from("okat\u0117")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_fix_chdz() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_3); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("t")) + { + return false; + } + break; + case 2: + if (!base.slice_from("d")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_fix_gd() { + base.ket = base.cursor; + if (base.find_among_b(a_4) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_from("g")) + { + return false; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + I_p1 = base.limit; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + /** @const */ var /** number */ v_3 = base.cursor; + if (!(base.eq_s("a"))) + { + base.cursor = v_2; + break lab1; + } + base.cursor = v_3; + if (base.current.length <= 6) + { + base.cursor = v_2; + break lab1; + } + if (base.cursor >= base.limit) + { + base.cursor = v_2; + break lab1; + } + base.cursor++; + } + if (!base.go_out_grouping(g_v, 97, 371)) + { + break lab0; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 371)) + { + break lab0; + } + base.cursor++; + I_p1 = base.cursor; + } + base.cursor = v_1; + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + r_fix_conflicts(); + base.cursor = base.limit - v_4; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + r_step1(); + base.cursor = base.limit - v_5; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + r_fix_chdz(); + base.cursor = base.limit - v_6; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + r_step2(); + base.cursor = base.limit - v_7; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + r_fix_chdz(); + base.cursor = base.limit - v_8; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; + r_fix_gd(); + base.cursor = base.limit - v_9; + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/nepali-stemmer.js b/sphinx/search/non-minified-js/nepali-stemmer.js new file mode 100644 index 00000000000..d6352d00a4d --- /dev/null +++ b/sphinx/search/non-minified-js/nepali-stemmer.js @@ -0,0 +1,282 @@ +// Generated from nepali.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var NepaliStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["\u0932\u093E\u0907", -1, 1], + ["\u0932\u093E\u0908", -1, 1], + ["\u0938\u0901\u0917", -1, 1], + ["\u0938\u0902\u0917", -1, 1], + ["\u092E\u093E\u0930\u094D\u092B\u0924", -1, 1], + ["\u0930\u0924", -1, 1], + ["\u0915\u093E", -1, 2], + ["\u092E\u093E", -1, 1], + ["\u0926\u094D\u0935\u093E\u0930\u093E", -1, 1], + ["\u0915\u093F", -1, 2], + ["\u092A\u091B\u093F", -1, 1], + ["\u0915\u0940", -1, 2], + ["\u0932\u0947", -1, 1], + ["\u0915\u0948", -1, 2], + ["\u0938\u0901\u0917\u0948", -1, 1], + ["\u092E\u0948", -1, 1], + ["\u0915\u094B", -1, 2] + ]; + + /** @const */ var a_1 = [ + ["\u0901", -1, 1], + ["\u0902", -1, 1], + ["\u0948", -1, 2] + ]; + + /** @const */ var a_2 = [ + ["\u0925\u093F\u090F", -1, 1], + ["\u091B", -1, 1], + ["\u0907\u091B", 1, 1], + ["\u090F\u091B", 1, 1], + ["\u093F\u091B", 1, 1], + ["\u0947\u091B", 1, 1], + ["\u0928\u0947\u091B", 5, 1], + ["\u0939\u0941\u0928\u0947\u091B", 6, 1], + ["\u0907\u0928\u094D\u091B", 1, 1], + ["\u093F\u0928\u094D\u091B", 1, 1], + ["\u0939\u0941\u0928\u094D\u091B", 1, 1], + ["\u090F\u0915\u093E", -1, 1], + ["\u0907\u090F\u0915\u093E", 11, 1], + ["\u093F\u090F\u0915\u093E", 11, 1], + ["\u0947\u0915\u093E", -1, 1], + ["\u0928\u0947\u0915\u093E", 14, 1], + ["\u0926\u093E", -1, 1], + ["\u0907\u0926\u093E", 16, 1], + ["\u093F\u0926\u093E", 16, 1], + ["\u0926\u0947\u0916\u093F", -1, 1], + ["\u092E\u093E\u0925\u093F", -1, 1], + ["\u090F\u0915\u0940", -1, 1], + ["\u0907\u090F\u0915\u0940", 21, 1], + ["\u093F\u090F\u0915\u0940", 21, 1], + ["\u0947\u0915\u0940", -1, 1], + ["\u0926\u0947\u0916\u0940", -1, 1], + ["\u0925\u0940", -1, 1], + ["\u0926\u0940", -1, 1], + ["\u091B\u0941", -1, 1], + ["\u090F\u091B\u0941", 28, 1], + ["\u0947\u091B\u0941", 28, 1], + ["\u0928\u0947\u091B\u0941", 30, 1], + ["\u0928\u0941", -1, 1], + ["\u0939\u0930\u0941", -1, 1], + ["\u0939\u0930\u0942", -1, 1], + ["\u091B\u0947", -1, 1], + ["\u0925\u0947", -1, 1], + ["\u0928\u0947", -1, 1], + ["\u090F\u0915\u0948", -1, 1], + ["\u0947\u0915\u0948", -1, 1], + ["\u0928\u0947\u0915\u0948", 39, 1], + ["\u0926\u0948", -1, 1], + ["\u0907\u0926\u0948", 41, 1], + ["\u093F\u0926\u0948", 41, 1], + ["\u090F\u0915\u094B", -1, 1], + ["\u0907\u090F\u0915\u094B", 44, 1], + ["\u093F\u090F\u0915\u094B", 44, 1], + ["\u0947\u0915\u094B", -1, 1], + ["\u0928\u0947\u0915\u094B", 47, 1], + ["\u0926\u094B", -1, 1], + ["\u0907\u0926\u094B", 49, 1], + ["\u093F\u0926\u094B", 49, 1], + ["\u092F\u094B", -1, 1], + ["\u0907\u092F\u094B", 52, 1], + ["\u092D\u092F\u094B", 52, 1], + ["\u093F\u092F\u094B", 52, 1], + ["\u0925\u093F\u092F\u094B", 55, 1], + ["\u0926\u093F\u092F\u094B", 55, 1], + ["\u0925\u094D\u092F\u094B", 52, 1], + ["\u091B\u094C", -1, 1], + ["\u0907\u091B\u094C", 59, 1], + ["\u090F\u091B\u094C", 59, 1], + ["\u093F\u091B\u094C", 59, 1], + ["\u0947\u091B\u094C", 59, 1], + ["\u0928\u0947\u091B\u094C", 63, 1], + ["\u092F\u094C", -1, 1], + ["\u0925\u093F\u092F\u094C", 65, 1], + ["\u091B\u094D\u092F\u094C", 65, 1], + ["\u0925\u094D\u092F\u094C", 65, 1], + ["\u091B\u0928\u094D", -1, 1], + ["\u0907\u091B\u0928\u094D", 69, 1], + ["\u090F\u091B\u0928\u094D", 69, 1], + ["\u093F\u091B\u0928\u094D", 69, 1], + ["\u0947\u091B\u0928\u094D", 69, 1], + ["\u0928\u0947\u091B\u0928\u094D", 73, 1], + ["\u0932\u093E\u0928\u094D", -1, 1], + ["\u091B\u093F\u0928\u094D", -1, 1], + ["\u0925\u093F\u0928\u094D", -1, 1], + ["\u092A\u0930\u094D", -1, 1], + ["\u0907\u0938\u094D", -1, 1], + ["\u0925\u093F\u0907\u0938\u094D", 79, 1], + ["\u091B\u0938\u094D", -1, 1], + ["\u0907\u091B\u0938\u094D", 81, 1], + ["\u090F\u091B\u0938\u094D", 81, 1], + ["\u093F\u091B\u0938\u094D", 81, 1], + ["\u0947\u091B\u0938\u094D", 81, 1], + ["\u0928\u0947\u091B\u0938\u094D", 85, 1], + ["\u093F\u0938\u094D", -1, 1], + ["\u0925\u093F\u0938\u094D", 87, 1], + ["\u091B\u0947\u0938\u094D", -1, 1], + ["\u0939\u094B\u0938\u094D", -1, 1] + ]; + + + /** @return {boolean} */ + function r_remove_category_1() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_0); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + break; + case 2: + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("\u090F"))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab2: { + if (!(base.eq_s_b("\u0947"))) + { + break lab2; + } + break lab0; + } + base.cursor = base.limit - v_1; + if (!base.slice_del()) + { + return false; + } + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_remove_category_2() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_1); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("\u092F\u094C"))) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab2: { + if (!(base.eq_s_b("\u091B\u094C"))) + { + break lab2; + } + break lab0; + } + base.cursor = base.limit - v_1; + lab3: { + if (!(base.eq_s_b("\u0928\u094C"))) + { + break lab3; + } + break lab0; + } + base.cursor = base.limit - v_1; + if (!(base.eq_s_b("\u0925\u0947"))) + { + return false; + } + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!(base.eq_s_b("\u0924\u094D\u0930"))) + { + return false; + } + if (!base.slice_del()) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_remove_category_3() { + base.ket = base.cursor; + if (base.find_among_b(a_2) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + r_remove_category_1(); + base.cursor = base.limit - v_1; + while(true) + { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab0: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + r_remove_category_2(); + base.cursor = base.limit - v_3; + if (!r_remove_category_3()) + { + break lab0; + } + continue; + } + base.cursor = base.limit - v_2; + break; + } + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/norwegian-stemmer.js b/sphinx/search/non-minified-js/norwegian-stemmer.js index e1760631ab9..149e63c1a32 100644 --- a/sphinx/search/non-minified-js/norwegian-stemmer.js +++ b/sphinx/search/non-minified-js/norwegian-stemmer.js @@ -1,9 +1,28 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from norwegian.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -NorwegianStemmer = function() { +var NorwegianStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ + ["", -1, 1], + ["ind", 0, -1], + ["kk", 0, -1], + ["nk", 0, -1], + ["amm", 0, -1], + ["omm", 0, -1], + ["kap", 0, -1], + ["skap", 6, 1], + ["pp", 0, -1], + ["lt", 0, -1], + ["ast", 0, -1], + ["\u00F8st", 0, -1], + ["v", 0, -1], + ["hav", 12, 1], + ["giv", 12, 1] + ]; + + /** @const */ var a_1 = [ ["a", -1, 1], ["e", -1, 1], ["ede", 1, 1], @@ -12,13 +31,13 @@ NorwegianStemmer = function() { ["ane", 1, 1], ["ene", 1, 1], ["hetene", 6, 1], - ["erte", 1, 3], + ["erte", 1, 4], ["en", -1, 1], ["heten", 9, 1], ["ar", -1, 1], ["er", -1, 1], ["heter", 12, 1], - ["s", -1, 2], + ["s", -1, 3], ["as", 14, 1], ["es", 14, 1], ["edes", 16, 1], @@ -27,20 +46,20 @@ NorwegianStemmer = function() { ["hetenes", 19, 1], ["ens", 14, 1], ["hetens", 21, 1], - ["ers", 14, 1], + ["ers", 14, 2], ["ets", 14, 1], ["et", -1, 1], ["het", 25, 1], - ["ert", -1, 3], + ["ert", -1, 4], ["ast", -1, 1] ]; - /** @const */ var a_1 = [ + /** @const */ var a_2 = [ ["dt", -1, -1], ["vt", -1, -1] ]; - /** @const */ var a_2 = [ + /** @const */ var a_3 = [ ["leg", -1, 1], ["eleg", 0, 1], ["ig", -1, 1], @@ -54,9 +73,9 @@ NorwegianStemmer = function() { ["hetslov", 9, 1] ]; - /** @const */ var /** Array */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 48, 0, 128]; + /** @const */ var /** Array */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 48, 2, 142]; - /** @const */ var /** Array */ g_s_ending = [119, 125, 149, 1]; + /** @const */ var /** Array */ g_s_ending = [119, 125, 148, 1]; var /** number */ I_x = 0; var /** number */ I_p1 = 0; @@ -65,9 +84,9 @@ NorwegianStemmer = function() { /** @return {boolean} */ function r_mark_regions() { I_p1 = base.limit; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; { - var /** number */ c1 = base.cursor + 3; + /** @const */ var /** number */ c1 = base.cursor + 3; if (c1 > base.limit) { return false; @@ -76,44 +95,21 @@ NorwegianStemmer = function() { } I_x = base.cursor; base.cursor = v_1; - golab0: while(true) + if (!base.go_out_grouping(g_v, 97, 248)) { - var /** number */ v_2 = base.cursor; - lab1: { - if (!(base.in_grouping(g_v, 97, 248))) - { - break lab1; - } - base.cursor = v_2; - break golab0; - } - base.cursor = v_2; - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } - golab2: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 248)) { - lab3: { - if (!(base.out_grouping(g_v, 97, 248))) - { - break lab3; - } - break golab2; - } - if (base.cursor >= base.limit) - { - return false; - } - base.cursor++; + return false; } + base.cursor++; I_p1 = base.cursor; - lab4: { - if (!(I_p1 < I_x)) + lab0: { + if (I_p1 >= I_x) { - break lab4; + break lab0; } I_p1 = I_x; } @@ -127,17 +123,17 @@ NorwegianStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; - among_var = base.find_among_b(a_0); + among_var = base.find_among_b(a_1); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; switch (among_var) { case 1: if (!base.slice_del()) @@ -146,8 +142,19 @@ NorwegianStemmer = function() { } break; case 2: + among_var = base.find_among_b(a_0); + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + break; + } + break; + case 3: lab0: { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab1: { if (!(base.in_grouping_b(g_s_ending, 98, 122))) { @@ -155,7 +162,26 @@ NorwegianStemmer = function() { } break lab0; } - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; + lab2: { + if (!(base.eq_s_b("r"))) + { + break lab2; + } + { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab3: { + if (!(base.eq_s_b("e"))) + { + break lab3; + } + break lab2; + } + base.cursor = base.limit - v_3; + } + break lab0; + } + base.cursor = base.limit - v_2; if (!(base.eq_s_b("k"))) { return false; @@ -170,7 +196,7 @@ NorwegianStemmer = function() { return false; } break; - case 3: + case 4: if (!base.slice_from("er")) { return false; @@ -182,21 +208,21 @@ NorwegianStemmer = function() { /** @return {boolean} */ function r_consonant_pair() { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; if (base.cursor < I_p1) { return false; } - var /** number */ v_3 = base.limit_backward; + /** @const */ var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; - if (base.find_among_b(a_1) == 0) + if (base.find_among_b(a_2) == 0) { - base.limit_backward = v_3; + base.limit_backward = v_2; return false; } base.bra = base.cursor; - base.limit_backward = v_3; + base.limit_backward = v_2; base.cursor = base.limit - v_1; if (base.cursor <= base.limit_backward) { @@ -217,16 +243,16 @@ NorwegianStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; - if (base.find_among_b(a_2) == 0) + if (base.find_among_b(a_3) == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; if (!base.slice_del()) { return false; @@ -235,17 +261,17 @@ NorwegianStemmer = function() { }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; r_mark_regions(); base.cursor = v_1; base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; r_main_suffix(); base.cursor = base.limit - v_2; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; r_consonant_pair(); base.cursor = base.limit - v_3; - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; r_other_suffix(); base.cursor = base.limit - v_4; base.cursor = base.limit_backward; diff --git a/sphinx/search/non-minified-js/porter-stemmer.js b/sphinx/search/non-minified-js/porter-stemmer.js index 0747d2cf3ea..182b9d5edfb 100644 --- a/sphinx/search/non-minified-js/porter-stemmer.js +++ b/sphinx/search/non-minified-js/porter-stemmer.js @@ -1,8 +1,9 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from porter.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -PorterStemmer = function() { +var PorterStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ ["s", -1, 3], ["ies", 0, 2], @@ -115,20 +116,12 @@ PorterStemmer = function() { /** @return {boolean} */ function r_R1() { - if (!(I_p1 <= base.cursor)) - { - return false; - } - return true; + return I_p1 <= base.cursor; }; /** @return {boolean} */ function r_R2() { - if (!(I_p2 <= base.cursor)) - { - return false; - } - return true; + return I_p2 <= base.cursor; }; /** @return {boolean} */ @@ -186,38 +179,24 @@ PorterStemmer = function() { } break; case 2: - var /** number */ v_1 = base.limit - base.cursor; - golab0: while(true) + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + if (!base.go_out_grouping_b(g_v, 97, 121)) { - lab1: { - if (!(base.in_grouping_b(g_v, 97, 121))) - { - break lab1; - } - break golab0; - } - if (base.cursor <= base.limit_backward) - { - return false; - } - base.cursor--; + return false; } + base.cursor--; base.cursor = base.limit - v_1; if (!base.slice_del()) { return false; } - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; among_var = base.find_among_b(a_1); - if (among_var == 0) - { - return false; - } - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; switch (among_var) { case 1: { - var /** number */ c1 = base.cursor; + /** @const */ var /** number */ c1 = base.cursor; base.insert(base.cursor, base.cursor, "e"); base.cursor = c1; } @@ -240,14 +219,14 @@ PorterStemmer = function() { { return false; } - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; if (!r_shortv()) { return false; } - base.cursor = base.limit - v_4; + base.cursor = base.limit - v_3; { - var /** number */ c2 = base.cursor; + /** @const */ var /** number */ c2 = base.cursor; base.insert(base.cursor, base.cursor, "e"); base.cursor = c2; } @@ -262,7 +241,7 @@ PorterStemmer = function() { function r_Step_1c() { base.ket = base.cursor; lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("y"))) { @@ -277,21 +256,11 @@ PorterStemmer = function() { } } base.bra = base.cursor; - golab2: while(true) + if (!base.go_out_grouping_b(g_v, 97, 121)) { - lab3: { - if (!(base.in_grouping_b(g_v, 97, 121))) - { - break lab3; - } - break golab2; - } - if (base.cursor <= base.limit_backward) - { - return false; - } - base.cursor--; + return false; } + base.cursor--; if (!base.slice_from("i")) { return false; @@ -456,7 +425,7 @@ PorterStemmer = function() { break; case 2: lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("s"))) { @@ -488,7 +457,6 @@ PorterStemmer = function() { } base.bra = base.cursor; lab0: { - var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!r_R2()) { @@ -496,13 +464,12 @@ PorterStemmer = function() { } break lab0; } - base.cursor = base.limit - v_1; if (!r_R1()) { return false; } { - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab2: { if (!r_shortv()) { @@ -510,7 +477,7 @@ PorterStemmer = function() { } return false; } - base.cursor = base.limit - v_2; + base.cursor = base.limit - v_1; } } if (!base.slice_del()) @@ -545,7 +512,7 @@ PorterStemmer = function() { this.stem = /** @return {boolean} */ function() { B_Y_found = false; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; if (!(base.eq_s("y"))) @@ -560,15 +527,15 @@ PorterStemmer = function() { B_Y_found = true; } base.cursor = v_1; - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab1: { while(true) { - var /** number */ v_3 = base.cursor; + /** @const */ var /** number */ v_3 = base.cursor; lab2: { golab3: while(true) { - var /** number */ v_4 = base.cursor; + /** @const */ var /** number */ v_4 = base.cursor; lab4: { if (!(base.in_grouping(g_v, 97, 121))) { @@ -604,125 +571,85 @@ PorterStemmer = function() { base.cursor = v_2; I_p1 = base.limit; I_p2 = base.limit; - var /** number */ v_5 = base.cursor; + /** @const */ var /** number */ v_5 = base.cursor; lab5: { - golab6: while(true) + if (!base.go_out_grouping(g_v, 97, 121)) { - lab7: { - if (!(base.in_grouping(g_v, 97, 121))) - { - break lab7; - } - break golab6; - } - if (base.cursor >= base.limit) - { - break lab5; - } - base.cursor++; + break lab5; } - golab8: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 121)) { - lab9: { - if (!(base.out_grouping(g_v, 97, 121))) - { - break lab9; - } - break golab8; - } - if (base.cursor >= base.limit) - { - break lab5; - } - base.cursor++; + break lab5; } + base.cursor++; I_p1 = base.cursor; - golab10: while(true) + if (!base.go_out_grouping(g_v, 97, 121)) { - lab11: { - if (!(base.in_grouping(g_v, 97, 121))) - { - break lab11; - } - break golab10; - } - if (base.cursor >= base.limit) - { - break lab5; - } - base.cursor++; + break lab5; } - golab12: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 121)) { - lab13: { - if (!(base.out_grouping(g_v, 97, 121))) - { - break lab13; - } - break golab12; - } - if (base.cursor >= base.limit) - { - break lab5; - } - base.cursor++; + break lab5; } + base.cursor++; I_p2 = base.cursor; } base.cursor = v_5; base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_10 = base.limit - base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; r_Step_1a(); - base.cursor = base.limit - v_10; - var /** number */ v_11 = base.limit - base.cursor; + base.cursor = base.limit - v_6; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; r_Step_1b(); - base.cursor = base.limit - v_11; - var /** number */ v_12 = base.limit - base.cursor; + base.cursor = base.limit - v_7; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; r_Step_1c(); - base.cursor = base.limit - v_12; - var /** number */ v_13 = base.limit - base.cursor; + base.cursor = base.limit - v_8; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; r_Step_2(); - base.cursor = base.limit - v_13; - var /** number */ v_14 = base.limit - base.cursor; + base.cursor = base.limit - v_9; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; r_Step_3(); - base.cursor = base.limit - v_14; - var /** number */ v_15 = base.limit - base.cursor; + base.cursor = base.limit - v_10; + /** @const */ var /** number */ v_11 = base.limit - base.cursor; r_Step_4(); - base.cursor = base.limit - v_15; - var /** number */ v_16 = base.limit - base.cursor; + base.cursor = base.limit - v_11; + /** @const */ var /** number */ v_12 = base.limit - base.cursor; r_Step_5a(); - base.cursor = base.limit - v_16; - var /** number */ v_17 = base.limit - base.cursor; + base.cursor = base.limit - v_12; + /** @const */ var /** number */ v_13 = base.limit - base.cursor; r_Step_5b(); - base.cursor = base.limit - v_17; + base.cursor = base.limit - v_13; base.cursor = base.limit_backward; - var /** number */ v_18 = base.cursor; - lab14: { + /** @const */ var /** number */ v_14 = base.cursor; + lab6: { if (!B_Y_found) { - break lab14; + break lab6; } while(true) { - var /** number */ v_19 = base.cursor; - lab15: { - golab16: while(true) + /** @const */ var /** number */ v_15 = base.cursor; + lab7: { + golab8: while(true) { - var /** number */ v_20 = base.cursor; - lab17: { + /** @const */ var /** number */ v_16 = base.cursor; + lab9: { base.bra = base.cursor; if (!(base.eq_s("Y"))) { - break lab17; + break lab9; } base.ket = base.cursor; - base.cursor = v_20; - break golab16; + base.cursor = v_16; + break golab8; } - base.cursor = v_20; + base.cursor = v_16; if (base.cursor >= base.limit) { - break lab15; + break lab7; } base.cursor++; } @@ -732,11 +659,11 @@ PorterStemmer = function() { } continue; } - base.cursor = v_19; + base.cursor = v_15; break; } } - base.cursor = v_18; + base.cursor = v_14; return true; }; diff --git a/sphinx/search/non-minified-js/portuguese-stemmer.js b/sphinx/search/non-minified-js/portuguese-stemmer.js index 662b976565a..2b4a63fafe6 100644 --- a/sphinx/search/non-minified-js/portuguese-stemmer.js +++ b/sphinx/search/non-minified-js/portuguese-stemmer.js @@ -1,8 +1,9 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from portuguese.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -PortugueseStemmer = function() { +var PortugueseStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ ["", -1, 3], ["\u00E3", 0, 1], @@ -234,14 +235,10 @@ PortugueseStemmer = function() { var /** number */ among_var; while(true) { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_0); - if (among_var == 0) - { - break lab0; - } base.ket = base.cursor; switch (among_var) { case 1: @@ -277,37 +274,27 @@ PortugueseStemmer = function() { I_pV = base.limit; I_p1 = base.limit; I_p2 = base.limit; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { lab1: { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 250))) { break lab2; } lab3: { - var /** number */ v_3 = base.cursor; + /** @const */ var /** number */ v_3 = base.cursor; lab4: { if (!(base.out_grouping(g_v, 97, 250))) { break lab4; } - golab5: while(true) + if (!base.go_out_grouping(g_v, 97, 250)) { - lab6: { - if (!(base.in_grouping(g_v, 97, 250))) - { - break lab6; - } - break golab5; - } - if (base.cursor >= base.limit) - { - break lab4; - } - base.cursor++; + break lab4; } + base.cursor++; break lab3; } base.cursor = v_3; @@ -315,21 +302,11 @@ PortugueseStemmer = function() { { break lab2; } - golab7: while(true) + if (!base.go_in_grouping(g_v, 97, 250)) { - lab8: { - if (!(base.out_grouping(g_v, 97, 250))) - { - break lab8; - } - break golab7; - } - if (base.cursor >= base.limit) - { - break lab2; - } - base.cursor++; + break lab2; } + base.cursor++; } break lab1; } @@ -338,31 +315,21 @@ PortugueseStemmer = function() { { break lab0; } - lab9: { - var /** number */ v_6 = base.cursor; - lab10: { + lab5: { + /** @const */ var /** number */ v_4 = base.cursor; + lab6: { if (!(base.out_grouping(g_v, 97, 250))) { - break lab10; + break lab6; } - golab11: while(true) + if (!base.go_out_grouping(g_v, 97, 250)) { - lab12: { - if (!(base.in_grouping(g_v, 97, 250))) - { - break lab12; - } - break golab11; - } - if (base.cursor >= base.limit) - { - break lab10; - } - base.cursor++; + break lab6; } - break lab9; + base.cursor++; + break lab5; } - base.cursor = v_6; + base.cursor = v_4; if (!(base.in_grouping(g_v, 97, 250))) { break lab0; @@ -377,72 +344,32 @@ PortugueseStemmer = function() { I_pV = base.cursor; } base.cursor = v_1; - var /** number */ v_8 = base.cursor; - lab13: { - golab14: while(true) + /** @const */ var /** number */ v_5 = base.cursor; + lab7: { + if (!base.go_out_grouping(g_v, 97, 250)) { - lab15: { - if (!(base.in_grouping(g_v, 97, 250))) - { - break lab15; - } - break golab14; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } - golab16: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 250)) { - lab17: { - if (!(base.out_grouping(g_v, 97, 250))) - { - break lab17; - } - break golab16; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } + base.cursor++; I_p1 = base.cursor; - golab18: while(true) + if (!base.go_out_grouping(g_v, 97, 250)) { - lab19: { - if (!(base.in_grouping(g_v, 97, 250))) - { - break lab19; - } - break golab18; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } - golab20: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 250)) { - lab21: { - if (!(base.out_grouping(g_v, 97, 250))) - { - break lab21; - } - break golab20; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } + base.cursor++; I_p2 = base.cursor; } - base.cursor = v_8; + base.cursor = v_5; return true; }; @@ -451,14 +378,10 @@ PortugueseStemmer = function() { var /** number */ among_var; while(true) { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_1); - if (among_var == 0) - { - break lab0; - } base.ket = base.cursor; switch (among_var) { case 1: @@ -491,29 +414,17 @@ PortugueseStemmer = function() { /** @return {boolean} */ function r_RV() { - if (!(I_pV <= base.cursor)) - { - return false; - } - return true; + return I_pV <= base.cursor; }; /** @return {boolean} */ function r_R1() { - if (!(I_p1 <= base.cursor)) - { - return false; - } - return true; + return I_p1 <= base.cursor; }; /** @return {boolean} */ function r_R2() { - if (!(I_p2 <= base.cursor)) - { - return false; - } - return true; + return I_p2 <= base.cursor; }; /** @return {boolean} */ @@ -576,7 +487,7 @@ PortugueseStemmer = function() { { return false; } - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; among_var = base.find_among_b(a_2); @@ -626,7 +537,7 @@ PortugueseStemmer = function() { { return false; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab1: { base.ket = base.cursor; if (base.find_among_b(a_3) == 0) @@ -655,7 +566,7 @@ PortugueseStemmer = function() { { return false; } - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab2: { base.ket = base.cursor; if (base.find_among_b(a_4) == 0) @@ -684,7 +595,7 @@ PortugueseStemmer = function() { { return false; } - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab3: { base.ket = base.cursor; if (!(base.eq_s_b("at"))) @@ -728,12 +639,12 @@ PortugueseStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; if (base.find_among_b(a_6) == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; @@ -741,7 +652,7 @@ PortugueseStemmer = function() { { return false; } - base.limit_backward = v_2; + base.limit_backward = v_1; return true; }; @@ -786,14 +697,14 @@ PortugueseStemmer = function() { } base.ket = base.cursor; lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("u"))) { break lab1; } base.bra = base.cursor; - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; if (!(base.eq_s_b("g"))) { break lab1; @@ -807,7 +718,7 @@ PortugueseStemmer = function() { return false; } base.bra = base.cursor; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; if (!(base.eq_s_b("c"))) { return false; @@ -834,19 +745,19 @@ PortugueseStemmer = function() { }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; r_prelude(); base.cursor = v_1; r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab0: { lab1: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab2: { - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab3: { - var /** number */ v_6 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab4: { if (!r_standard_suffix()) { @@ -854,14 +765,14 @@ PortugueseStemmer = function() { } break lab3; } - base.cursor = base.limit - v_6; + base.cursor = base.limit - v_5; if (!r_verb_suffix()) { break lab2; } } - base.cursor = base.limit - v_5; - var /** number */ v_7 = base.limit - base.cursor; + base.cursor = base.limit - v_4; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; lab5: { base.ket = base.cursor; if (!(base.eq_s_b("i"))) @@ -869,12 +780,12 @@ PortugueseStemmer = function() { break lab5; } base.bra = base.cursor; - var /** number */ v_8 = base.limit - base.cursor; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; if (!(base.eq_s_b("c"))) { break lab5; } - base.cursor = base.limit - v_8; + base.cursor = base.limit - v_7; if (!r_RV()) { break lab5; @@ -884,24 +795,24 @@ PortugueseStemmer = function() { return false; } } - base.cursor = base.limit - v_7; + base.cursor = base.limit - v_6; break lab1; } - base.cursor = base.limit - v_4; + base.cursor = base.limit - v_3; if (!r_residual_suffix()) { break lab0; } } } - base.cursor = base.limit - v_3; - var /** number */ v_9 = base.limit - base.cursor; + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; r_residual_form(); - base.cursor = base.limit - v_9; + base.cursor = base.limit - v_8; base.cursor = base.limit_backward; - var /** number */ v_10 = base.cursor; + /** @const */ var /** number */ v_9 = base.cursor; r_postlude(); - base.cursor = v_10; + base.cursor = v_9; return true; }; diff --git a/sphinx/search/non-minified-js/romanian-stemmer.js b/sphinx/search/non-minified-js/romanian-stemmer.js index 67538f1c008..4c58e819ec2 100644 --- a/sphinx/search/non-minified-js/romanian-stemmer.js +++ b/sphinx/search/non-minified-js/romanian-stemmer.js @@ -1,20 +1,26 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from romanian.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -RomanianStemmer = function() { +var RomanianStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ + ["\u015F", -1, 1], + ["\u0163", -1, 2] + ]; + + /** @const */ var a_1 = [ ["", -1, 3], ["I", 0, 1], ["U", 0, 2] ]; - /** @const */ var a_1 = [ + /** @const */ var a_2 = [ ["ea", -1, 3], - ["a\u0163ia", -1, 7], + ["a\u021Bia", -1, 7], ["aua", -1, 2], ["iua", -1, 4], - ["a\u0163ie", -1, 7], + ["a\u021Bie", -1, 7], ["ele", -1, 3], ["ile", -1, 5], ["iile", 6, 4], @@ -28,14 +34,14 @@ RomanianStemmer = function() { ["iilor", 14, 4] ]; - /** @const */ var a_2 = [ + /** @const */ var a_3 = [ ["icala", -1, 4], ["iciva", -1, 4], ["ativa", -1, 5], ["itiva", -1, 6], ["icale", -1, 4], - ["a\u0163iune", -1, 5], - ["i\u0163iune", -1, 6], + ["a\u021Biune", -1, 5], + ["i\u021Biune", -1, 6], ["atoare", -1, 5], ["itoare", -1, 6], ["\u0103toare", -1, 5], @@ -60,9 +66,9 @@ RomanianStemmer = function() { ["icit\u0103i", -1, 4], ["abilit\u0103i", -1, 1], ["ivit\u0103i", -1, 3], - ["icit\u0103\u0163i", -1, 4], - ["abilit\u0103\u0163i", -1, 1], - ["ivit\u0103\u0163i", -1, 3], + ["icit\u0103\u021Bi", -1, 4], + ["abilit\u0103\u021Bi", -1, 1], + ["ivit\u0103\u021Bi", -1, 3], ["ical", -1, 4], ["ator", -1, 5], ["icator", 35, 4], @@ -77,7 +83,7 @@ RomanianStemmer = function() { ["itiv\u0103", -1, 6] ]; - /** @const */ var a_3 = [ + /** @const */ var a_4 = [ ["ica", -1, 1], ["abila", -1, 1], ["ibila", -1, 1], @@ -114,11 +120,11 @@ RomanianStemmer = function() { ["anti", -1, 1], ["isti", -1, 3], ["uti", -1, 1], - ["i\u015Fti", -1, 3], + ["i\u0219ti", -1, 3], ["ivi", -1, 1], ["it\u0103i", -1, 1], - ["o\u015Fi", -1, 1], - ["it\u0103\u0163i", -1, 1], + ["o\u0219i", -1, 1], + ["it\u0103\u021Bi", -1, 1], ["abil", -1, 1], ["ibil", -1, 1], ["ism", -1, 3], @@ -142,7 +148,7 @@ RomanianStemmer = function() { ["iv\u0103", -1, 1] ]; - /** @const */ var a_4 = [ + /** @const */ var a_5 = [ ["ea", -1, 1], ["ia", -1, 1], ["esc", -1, 1], @@ -159,44 +165,44 @@ RomanianStemmer = function() { ["ise", 10, 1], ["use", 10, 1], ["\u00E2se", 10, 1], - ["e\u015Fte", -1, 1], - ["\u0103\u015Fte", -1, 1], + ["e\u0219te", -1, 1], + ["\u0103\u0219te", -1, 1], ["eze", -1, 1], ["ai", -1, 1], ["eai", 19, 1], ["iai", 19, 1], ["sei", -1, 2], - ["e\u015Fti", -1, 1], - ["\u0103\u015Fti", -1, 1], + ["e\u0219ti", -1, 1], + ["\u0103\u0219ti", -1, 1], ["ui", -1, 1], ["ezi", -1, 1], ["\u00E2i", -1, 1], - ["a\u015Fi", -1, 1], - ["se\u015Fi", -1, 2], - ["ase\u015Fi", 29, 1], - ["sese\u015Fi", 29, 2], - ["ise\u015Fi", 29, 1], - ["use\u015Fi", 29, 1], - ["\u00E2se\u015Fi", 29, 1], - ["i\u015Fi", -1, 1], - ["u\u015Fi", -1, 1], - ["\u00E2\u015Fi", -1, 1], - ["a\u0163i", -1, 2], - ["ea\u0163i", 38, 1], - ["ia\u0163i", 38, 1], - ["e\u0163i", -1, 2], - ["i\u0163i", -1, 2], - ["\u00E2\u0163i", -1, 2], - ["ar\u0103\u0163i", -1, 1], - ["ser\u0103\u0163i", -1, 2], - ["aser\u0103\u0163i", 45, 1], - ["seser\u0103\u0163i", 45, 2], - ["iser\u0103\u0163i", 45, 1], - ["user\u0103\u0163i", 45, 1], - ["\u00E2ser\u0103\u0163i", 45, 1], - ["ir\u0103\u0163i", -1, 1], - ["ur\u0103\u0163i", -1, 1], - ["\u00E2r\u0103\u0163i", -1, 1], + ["a\u0219i", -1, 1], + ["se\u0219i", -1, 2], + ["ase\u0219i", 29, 1], + ["sese\u0219i", 29, 2], + ["ise\u0219i", 29, 1], + ["use\u0219i", 29, 1], + ["\u00E2se\u0219i", 29, 1], + ["i\u0219i", -1, 1], + ["u\u0219i", -1, 1], + ["\u00E2\u0219i", -1, 1], + ["a\u021Bi", -1, 2], + ["ea\u021Bi", 38, 1], + ["ia\u021Bi", 38, 1], + ["e\u021Bi", -1, 2], + ["i\u021Bi", -1, 2], + ["\u00E2\u021Bi", -1, 2], + ["ar\u0103\u021Bi", -1, 1], + ["ser\u0103\u021Bi", -1, 2], + ["aser\u0103\u021Bi", 45, 1], + ["seser\u0103\u021Bi", 45, 2], + ["iser\u0103\u021Bi", 45, 1], + ["user\u0103\u021Bi", 45, 1], + ["\u00E2ser\u0103\u021Bi", 45, 1], + ["ir\u0103\u021Bi", -1, 1], + ["ur\u0103\u021Bi", -1, 1], + ["\u00E2r\u0103\u021Bi", -1, 1], ["am", -1, 1], ["eam", 54, 1], ["iam", 54, 1], @@ -239,7 +245,7 @@ RomanianStemmer = function() { ["eaz\u0103", -1, 1] ]; - /** @const */ var a_5 = [ + /** @const */ var a_6 = [ ["a", -1, 1], ["e", -1, 1], ["ie", 1, 1], @@ -255,15 +261,69 @@ RomanianStemmer = function() { var /** number */ I_pV = 0; + /** @return {boolean} */ + function r_norm() { + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + while(true) + { + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + golab2: while(true) + { + /** @const */ var /** number */ v_3 = base.cursor; + lab3: { + base.bra = base.cursor; + among_var = base.find_among(a_0); + if (among_var == 0) + { + break lab3; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("\u0219")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u021B")) + { + return false; + } + break; + } + base.cursor = v_3; + break golab2; + } + base.cursor = v_3; + if (base.cursor >= base.limit) + { + break lab1; + } + base.cursor++; + } + continue; + } + base.cursor = v_2; + break; + } + } + base.cursor = v_1; + return true; + }; + /** @return {boolean} */ function r_prelude() { while(true) { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { golab1: while(true) { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 259))) { @@ -271,7 +331,7 @@ RomanianStemmer = function() { } base.bra = base.cursor; lab3: { - var /** number */ v_3 = base.cursor; + /** @const */ var /** number */ v_3 = base.cursor; lab4: { if (!(base.eq_s("u"))) { @@ -326,37 +386,27 @@ RomanianStemmer = function() { I_pV = base.limit; I_p1 = base.limit; I_p2 = base.limit; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { lab1: { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 259))) { break lab2; } lab3: { - var /** number */ v_3 = base.cursor; + /** @const */ var /** number */ v_3 = base.cursor; lab4: { if (!(base.out_grouping(g_v, 97, 259))) { break lab4; } - golab5: while(true) + if (!base.go_out_grouping(g_v, 97, 259)) { - lab6: { - if (!(base.in_grouping(g_v, 97, 259))) - { - break lab6; - } - break golab5; - } - if (base.cursor >= base.limit) - { - break lab4; - } - base.cursor++; + break lab4; } + base.cursor++; break lab3; } base.cursor = v_3; @@ -364,21 +414,11 @@ RomanianStemmer = function() { { break lab2; } - golab7: while(true) + if (!base.go_in_grouping(g_v, 97, 259)) { - lab8: { - if (!(base.out_grouping(g_v, 97, 259))) - { - break lab8; - } - break golab7; - } - if (base.cursor >= base.limit) - { - break lab2; - } - base.cursor++; + break lab2; } + base.cursor++; } break lab1; } @@ -387,31 +427,21 @@ RomanianStemmer = function() { { break lab0; } - lab9: { - var /** number */ v_6 = base.cursor; - lab10: { + lab5: { + /** @const */ var /** number */ v_4 = base.cursor; + lab6: { if (!(base.out_grouping(g_v, 97, 259))) { - break lab10; + break lab6; } - golab11: while(true) + if (!base.go_out_grouping(g_v, 97, 259)) { - lab12: { - if (!(base.in_grouping(g_v, 97, 259))) - { - break lab12; - } - break golab11; - } - if (base.cursor >= base.limit) - { - break lab10; - } - base.cursor++; + break lab6; } - break lab9; + base.cursor++; + break lab5; } - base.cursor = v_6; + base.cursor = v_4; if (!(base.in_grouping(g_v, 97, 259))) { break lab0; @@ -426,72 +456,32 @@ RomanianStemmer = function() { I_pV = base.cursor; } base.cursor = v_1; - var /** number */ v_8 = base.cursor; - lab13: { - golab14: while(true) + /** @const */ var /** number */ v_5 = base.cursor; + lab7: { + if (!base.go_out_grouping(g_v, 97, 259)) { - lab15: { - if (!(base.in_grouping(g_v, 97, 259))) - { - break lab15; - } - break golab14; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } - golab16: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 259)) { - lab17: { - if (!(base.out_grouping(g_v, 97, 259))) - { - break lab17; - } - break golab16; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } + base.cursor++; I_p1 = base.cursor; - golab18: while(true) + if (!base.go_out_grouping(g_v, 97, 259)) { - lab19: { - if (!(base.in_grouping(g_v, 97, 259))) - { - break lab19; - } - break golab18; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } - golab20: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 259)) { - lab21: { - if (!(base.out_grouping(g_v, 97, 259))) - { - break lab21; - } - break golab20; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } + base.cursor++; I_p2 = base.cursor; } - base.cursor = v_8; + base.cursor = v_5; return true; }; @@ -500,14 +490,10 @@ RomanianStemmer = function() { var /** number */ among_var; while(true) { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; - among_var = base.find_among(a_0); - if (among_var == 0) - { - break lab0; - } + among_var = base.find_among(a_1); base.ket = base.cursor; switch (among_var) { case 1: @@ -540,36 +526,24 @@ RomanianStemmer = function() { /** @return {boolean} */ function r_RV() { - if (!(I_pV <= base.cursor)) - { - return false; - } - return true; + return I_pV <= base.cursor; }; /** @return {boolean} */ function r_R1() { - if (!(I_p1 <= base.cursor)) - { - return false; - } - return true; + return I_p1 <= base.cursor; }; /** @return {boolean} */ function r_R2() { - if (!(I_p2 <= base.cursor)) - { - return false; - } - return true; + return I_p2 <= base.cursor; }; /** @return {boolean} */ function r_step_0() { var /** number */ among_var; base.ket = base.cursor; - among_var = base.find_among_b(a_1); + among_var = base.find_among_b(a_2); if (among_var == 0) { return false; @@ -606,7 +580,7 @@ RomanianStemmer = function() { break; case 5: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("ab"))) { @@ -628,7 +602,7 @@ RomanianStemmer = function() { } break; case 7: - if (!base.slice_from("a\u0163i")) + if (!base.slice_from("a\u021Bi")) { return false; } @@ -640,9 +614,9 @@ RomanianStemmer = function() { /** @return {boolean} */ function r_combo_suffix() { var /** number */ among_var; - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; base.ket = base.cursor; - among_var = base.find_among_b(a_2); + among_var = base.find_among_b(a_3); if (among_var == 0) { return false; @@ -701,7 +675,7 @@ RomanianStemmer = function() { B_standard_suffix_removed = false; while(true) { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { if (!r_combo_suffix()) { @@ -713,7 +687,7 @@ RomanianStemmer = function() { break; } base.ket = base.cursor; - among_var = base.find_among_b(a_3); + among_var = base.find_among_b(a_4); if (among_var == 0) { return false; @@ -731,7 +705,7 @@ RomanianStemmer = function() { } break; case 2: - if (!(base.eq_s_b("\u0163"))) + if (!(base.eq_s_b("\u021B"))) { return false; } @@ -759,20 +733,20 @@ RomanianStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; - among_var = base.find_among_b(a_4); + among_var = base.find_among_b(a_5); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; switch (among_var) { case 1: lab0: { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab1: { if (!(base.out_grouping_b(g_v, 97, 259))) { @@ -780,10 +754,10 @@ RomanianStemmer = function() { } break lab0; } - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; if (!(base.eq_s_b("u"))) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } } @@ -799,14 +773,14 @@ RomanianStemmer = function() { } break; } - base.limit_backward = v_2; + base.limit_backward = v_1; return true; }; /** @return {boolean} */ function r_vowel_suffix() { base.ket = base.cursor; - if (base.find_among_b(a_5) == 0) + if (base.find_among_b(a_6) == 0) { return false; } @@ -823,21 +797,22 @@ RomanianStemmer = function() { }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; + r_norm(); + /** @const */ var /** number */ v_1 = base.cursor; r_prelude(); base.cursor = v_1; r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; r_step_0(); - base.cursor = base.limit - v_3; - var /** number */ v_4 = base.limit - base.cursor; + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; r_standard_suffix(); - base.cursor = base.limit - v_4; - var /** number */ v_5 = base.limit - base.cursor; + base.cursor = base.limit - v_3; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab0: { lab1: { - var /** number */ v_6 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab2: { if (!B_standard_suffix_removed) { @@ -845,21 +820,21 @@ RomanianStemmer = function() { } break lab1; } - base.cursor = base.limit - v_6; + base.cursor = base.limit - v_5; if (!r_verb_suffix()) { break lab0; } } } - base.cursor = base.limit - v_5; - var /** number */ v_7 = base.limit - base.cursor; + base.cursor = base.limit - v_4; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; r_vowel_suffix(); - base.cursor = base.limit - v_7; + base.cursor = base.limit - v_6; base.cursor = base.limit_backward; - var /** number */ v_8 = base.cursor; + /** @const */ var /** number */ v_7 = base.cursor; r_postlude(); - base.cursor = v_8; + base.cursor = v_7; return true; }; diff --git a/sphinx/search/non-minified-js/russian-stemmer.js b/sphinx/search/non-minified-js/russian-stemmer.js index 28ded5fc816..36c655d6bd7 100644 --- a/sphinx/search/non-minified-js/russian-stemmer.js +++ b/sphinx/search/non-minified-js/russian-stemmer.js @@ -1,8 +1,9 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from russian.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -RussianStemmer = function() { +var RussianStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ ["\u0432", -1, 1], ["\u0438\u0432", 0, 2], @@ -170,69 +171,29 @@ RussianStemmer = function() { function r_mark_regions() { I_pV = base.limit; I_p2 = base.limit; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { - golab1: while(true) + if (!base.go_out_grouping(g_v, 1072, 1103)) { - lab2: { - if (!(base.in_grouping(g_v, 1072, 1103))) - { - break lab2; - } - break golab1; - } - if (base.cursor >= base.limit) - { - break lab0; - } - base.cursor++; + break lab0; } + base.cursor++; I_pV = base.cursor; - golab3: while(true) + if (!base.go_in_grouping(g_v, 1072, 1103)) { - lab4: { - if (!(base.out_grouping(g_v, 1072, 1103))) - { - break lab4; - } - break golab3; - } - if (base.cursor >= base.limit) - { - break lab0; - } - base.cursor++; + break lab0; } - golab5: while(true) + base.cursor++; + if (!base.go_out_grouping(g_v, 1072, 1103)) { - lab6: { - if (!(base.in_grouping(g_v, 1072, 1103))) - { - break lab6; - } - break golab5; - } - if (base.cursor >= base.limit) - { - break lab0; - } - base.cursor++; + break lab0; } - golab7: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 1072, 1103)) { - lab8: { - if (!(base.out_grouping(g_v, 1072, 1103))) - { - break lab8; - } - break golab7; - } - if (base.cursor >= base.limit) - { - break lab0; - } - base.cursor++; + break lab0; } + base.cursor++; I_p2 = base.cursor; } base.cursor = v_1; @@ -241,11 +202,7 @@ RussianStemmer = function() { /** @return {boolean} */ function r_R2() { - if (!(I_p2 <= base.cursor)) - { - return false; - } - return true; + return I_p2 <= base.cursor; }; /** @return {boolean} */ @@ -261,7 +218,7 @@ RussianStemmer = function() { switch (among_var) { case 1: lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("\u0430"))) { @@ -312,7 +269,7 @@ RussianStemmer = function() { { return false; } - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; among_var = base.find_among_b(a_2); @@ -325,7 +282,7 @@ RussianStemmer = function() { switch (among_var) { case 1: lab1: { - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab2: { if (!(base.eq_s_b("\u0430"))) { @@ -384,7 +341,7 @@ RussianStemmer = function() { switch (among_var) { case 1: lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("\u0430"))) { @@ -499,15 +456,15 @@ RussianStemmer = function() { }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { while(true) { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab1: { golab2: while(true) { - var /** number */ v_3 = base.cursor; + /** @const */ var /** number */ v_3 = base.cursor; lab3: { base.bra = base.cursor; if (!(base.eq_s("\u0451"))) @@ -542,12 +499,12 @@ RussianStemmer = function() { { return false; } - var /** number */ v_6 = base.limit_backward; + /** @const */ var /** number */ v_4 = base.limit_backward; base.limit_backward = I_pV; - var /** number */ v_7 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab4: { lab5: { - var /** number */ v_8 = base.limit - base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; lab6: { if (!r_perfective_gerund()) { @@ -555,17 +512,17 @@ RussianStemmer = function() { } break lab5; } - base.cursor = base.limit - v_8; - var /** number */ v_9 = base.limit - base.cursor; + base.cursor = base.limit - v_6; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; lab7: { if (!r_reflexive()) { - base.cursor = base.limit - v_9; + base.cursor = base.limit - v_7; break lab7; } } lab8: { - var /** number */ v_10 = base.limit - base.cursor; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; lab9: { if (!r_adjectival()) { @@ -573,7 +530,7 @@ RussianStemmer = function() { } break lab8; } - base.cursor = base.limit - v_10; + base.cursor = base.limit - v_8; lab10: { if (!r_verb()) { @@ -581,7 +538,7 @@ RussianStemmer = function() { } break lab8; } - base.cursor = base.limit - v_10; + base.cursor = base.limit - v_8; if (!r_noun()) { break lab4; @@ -589,13 +546,13 @@ RussianStemmer = function() { } } } - base.cursor = base.limit - v_7; - var /** number */ v_11 = base.limit - base.cursor; + base.cursor = base.limit - v_5; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; lab11: { base.ket = base.cursor; if (!(base.eq_s_b("\u0438"))) { - base.cursor = base.limit - v_11; + base.cursor = base.limit - v_9; break lab11; } base.bra = base.cursor; @@ -604,13 +561,13 @@ RussianStemmer = function() { return false; } } - var /** number */ v_12 = base.limit - base.cursor; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; r_derivational(); - base.cursor = base.limit - v_12; - var /** number */ v_13 = base.limit - base.cursor; + base.cursor = base.limit - v_10; + /** @const */ var /** number */ v_11 = base.limit - base.cursor; r_tidy_up(); - base.cursor = base.limit - v_13; - base.limit_backward = v_6; + base.cursor = base.limit - v_11; + base.limit_backward = v_4; base.cursor = base.limit_backward; return true; }; diff --git a/sphinx/search/non-minified-js/serbian-stemmer.js b/sphinx/search/non-minified-js/serbian-stemmer.js new file mode 100644 index 00000000000..7d6d0ce32e9 --- /dev/null +++ b/sphinx/search/non-minified-js/serbian-stemmer.js @@ -0,0 +1,4516 @@ +// Generated from serbian.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var SerbianStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["\u0430", -1, 1], + ["\u0431", -1, 2], + ["\u0432", -1, 3], + ["\u0433", -1, 4], + ["\u0434", -1, 5], + ["\u0435", -1, 7], + ["\u0436", -1, 8], + ["\u0437", -1, 9], + ["\u0438", -1, 10], + ["\u043A", -1, 12], + ["\u043B", -1, 13], + ["\u043C", -1, 15], + ["\u043D", -1, 16], + ["\u043E", -1, 18], + ["\u043F", -1, 19], + ["\u0440", -1, 20], + ["\u0441", -1, 21], + ["\u0442", -1, 22], + ["\u0443", -1, 24], + ["\u0444", -1, 25], + ["\u0445", -1, 26], + ["\u0446", -1, 27], + ["\u0447", -1, 28], + ["\u0448", -1, 30], + ["\u0452", -1, 6], + ["\u0458", -1, 11], + ["\u0459", -1, 14], + ["\u045A", -1, 17], + ["\u045B", -1, 23], + ["\u045F", -1, 29] + ]; + + /** @const */ var a_1 = [ + ["daba", -1, 73], + ["ajaca", -1, 12], + ["ejaca", -1, 14], + ["ljaca", -1, 13], + ["njaca", -1, 85], + ["ojaca", -1, 15], + ["alaca", -1, 82], + ["elaca", -1, 83], + ["olaca", -1, 84], + ["maca", -1, 75], + ["naca", -1, 76], + ["raca", -1, 81], + ["saca", -1, 80], + ["vaca", -1, 79], + ["\u0161aca", -1, 18], + ["aoca", -1, 82], + ["acaka", -1, 55], + ["ajaka", -1, 16], + ["ojaka", -1, 17], + ["anaka", -1, 78], + ["ataka", -1, 58], + ["etaka", -1, 59], + ["itaka", -1, 60], + ["otaka", -1, 61], + ["utaka", -1, 62], + ["a\u010Daka", -1, 54], + ["esama", -1, 67], + ["izama", -1, 87], + ["jacima", -1, 5], + ["nicima", -1, 23], + ["ticima", -1, 24], + ["teticima", 30, 21], + ["zicima", -1, 25], + ["atcima", -1, 58], + ["utcima", -1, 62], + ["\u010Dcima", -1, 74], + ["pesima", -1, 2], + ["inzima", -1, 19], + ["lozima", -1, 1], + ["metara", -1, 68], + ["centara", -1, 69], + ["istara", -1, 70], + ["ekata", -1, 86], + ["anata", -1, 53], + ["nstava", -1, 22], + ["kustava", -1, 29], + ["ajac", -1, 12], + ["ejac", -1, 14], + ["ljac", -1, 13], + ["njac", -1, 85], + ["anjac", 49, 11], + ["ojac", -1, 15], + ["alac", -1, 82], + ["elac", -1, 83], + ["olac", -1, 84], + ["mac", -1, 75], + ["nac", -1, 76], + ["rac", -1, 81], + ["sac", -1, 80], + ["vac", -1, 79], + ["\u0161ac", -1, 18], + ["jebe", -1, 88], + ["olce", -1, 84], + ["kuse", -1, 27], + ["rave", -1, 42], + ["save", -1, 52], + ["\u0161ave", -1, 51], + ["baci", -1, 89], + ["jaci", -1, 5], + ["tvenici", -1, 20], + ["snici", -1, 26], + ["tetici", -1, 21], + ["bojci", -1, 4], + ["vojci", -1, 3], + ["ojsci", -1, 66], + ["atci", -1, 58], + ["itci", -1, 60], + ["utci", -1, 62], + ["\u010Dci", -1, 74], + ["pesi", -1, 2], + ["inzi", -1, 19], + ["lozi", -1, 1], + ["acak", -1, 55], + ["usak", -1, 57], + ["atak", -1, 58], + ["etak", -1, 59], + ["itak", -1, 60], + ["otak", -1, 61], + ["utak", -1, 62], + ["a\u010Dak", -1, 54], + ["u\u0161ak", -1, 56], + ["izam", -1, 87], + ["tican", -1, 65], + ["cajan", -1, 7], + ["\u010Dajan", -1, 6], + ["voljan", -1, 77], + ["eskan", -1, 63], + ["alan", -1, 40], + ["bilan", -1, 33], + ["gilan", -1, 37], + ["nilan", -1, 39], + ["rilan", -1, 38], + ["silan", -1, 36], + ["tilan", -1, 34], + ["avilan", -1, 35], + ["laran", -1, 9], + ["eran", -1, 8], + ["asan", -1, 91], + ["esan", -1, 10], + ["dusan", -1, 31], + ["kusan", -1, 28], + ["atan", -1, 47], + ["pletan", -1, 50], + ["tetan", -1, 49], + ["antan", -1, 32], + ["pravan", -1, 44], + ["stavan", -1, 43], + ["sivan", -1, 46], + ["tivan", -1, 45], + ["ozan", -1, 41], + ["ti\u010Dan", -1, 64], + ["a\u0161an", -1, 90], + ["du\u0161an", -1, 30], + ["metar", -1, 68], + ["centar", -1, 69], + ["istar", -1, 70], + ["ekat", -1, 86], + ["enat", -1, 48], + ["oscu", -1, 72], + ["o\u0161\u0107u", -1, 71] + ]; + + /** @const */ var a_2 = [ + ["aca", -1, 124], + ["eca", -1, 125], + ["uca", -1, 126], + ["ga", -1, 20], + ["acega", 3, 124], + ["ecega", 3, 125], + ["ucega", 3, 126], + ["anjijega", 3, 84], + ["enjijega", 3, 85], + ["snjijega", 3, 122], + ["\u0161njijega", 3, 86], + ["kijega", 3, 95], + ["skijega", 11, 1], + ["\u0161kijega", 11, 2], + ["elijega", 3, 83], + ["nijega", 3, 13], + ["osijega", 3, 123], + ["atijega", 3, 120], + ["evitijega", 3, 92], + ["ovitijega", 3, 93], + ["astijega", 3, 94], + ["avijega", 3, 77], + ["evijega", 3, 78], + ["ivijega", 3, 79], + ["ovijega", 3, 80], + ["o\u0161ijega", 3, 91], + ["anjega", 3, 84], + ["enjega", 3, 85], + ["snjega", 3, 122], + ["\u0161njega", 3, 86], + ["kega", 3, 95], + ["skega", 30, 1], + ["\u0161kega", 30, 2], + ["elega", 3, 83], + ["nega", 3, 13], + ["anega", 34, 10], + ["enega", 34, 87], + ["snega", 34, 159], + ["\u0161nega", 34, 88], + ["osega", 3, 123], + ["atega", 3, 120], + ["evitega", 3, 92], + ["ovitega", 3, 93], + ["astega", 3, 94], + ["avega", 3, 77], + ["evega", 3, 78], + ["ivega", 3, 79], + ["ovega", 3, 80], + ["a\u0107ega", 3, 14], + ["e\u0107ega", 3, 15], + ["u\u0107ega", 3, 16], + ["o\u0161ega", 3, 91], + ["acoga", 3, 124], + ["ecoga", 3, 125], + ["ucoga", 3, 126], + ["anjoga", 3, 84], + ["enjoga", 3, 85], + ["snjoga", 3, 122], + ["\u0161njoga", 3, 86], + ["koga", 3, 95], + ["skoga", 59, 1], + ["\u0161koga", 59, 2], + ["loga", 3, 19], + ["eloga", 62, 83], + ["noga", 3, 13], + ["cinoga", 64, 137], + ["\u010Dinoga", 64, 89], + ["osoga", 3, 123], + ["atoga", 3, 120], + ["evitoga", 3, 92], + ["ovitoga", 3, 93], + ["astoga", 3, 94], + ["avoga", 3, 77], + ["evoga", 3, 78], + ["ivoga", 3, 79], + ["ovoga", 3, 80], + ["a\u0107oga", 3, 14], + ["e\u0107oga", 3, 15], + ["u\u0107oga", 3, 16], + ["o\u0161oga", 3, 91], + ["uga", 3, 18], + ["aja", -1, 109], + ["caja", 81, 26], + ["laja", 81, 30], + ["raja", 81, 31], + ["\u0107aja", 81, 28], + ["\u010Daja", 81, 27], + ["\u0111aja", 81, 29], + ["bija", -1, 32], + ["cija", -1, 33], + ["dija", -1, 34], + ["fija", -1, 40], + ["gija", -1, 39], + ["anjija", -1, 84], + ["enjija", -1, 85], + ["snjija", -1, 122], + ["\u0161njija", -1, 86], + ["kija", -1, 95], + ["skija", 97, 1], + ["\u0161kija", 97, 2], + ["lija", -1, 24], + ["elija", 100, 83], + ["mija", -1, 37], + ["nija", -1, 13], + ["ganija", 103, 9], + ["manija", 103, 6], + ["panija", 103, 7], + ["ranija", 103, 8], + ["tanija", 103, 5], + ["pija", -1, 41], + ["rija", -1, 42], + ["rarija", 110, 21], + ["sija", -1, 23], + ["osija", 112, 123], + ["tija", -1, 44], + ["atija", 114, 120], + ["evitija", 114, 92], + ["ovitija", 114, 93], + ["otija", 114, 22], + ["astija", 114, 94], + ["avija", -1, 77], + ["evija", -1, 78], + ["ivija", -1, 79], + ["ovija", -1, 80], + ["zija", -1, 45], + ["o\u0161ija", -1, 91], + ["\u017Eija", -1, 38], + ["anja", -1, 84], + ["enja", -1, 85], + ["snja", -1, 122], + ["\u0161nja", -1, 86], + ["ka", -1, 95], + ["ska", 131, 1], + ["\u0161ka", 131, 2], + ["ala", -1, 104], + ["acala", 134, 128], + ["astajala", 134, 106], + ["istajala", 134, 107], + ["ostajala", 134, 108], + ["ijala", 134, 47], + ["injala", 134, 114], + ["nala", 134, 46], + ["irala", 134, 100], + ["urala", 134, 105], + ["tala", 134, 113], + ["astala", 144, 110], + ["istala", 144, 111], + ["ostala", 144, 112], + ["avala", 134, 97], + ["evala", 134, 96], + ["ivala", 134, 98], + ["ovala", 134, 76], + ["uvala", 134, 99], + ["a\u010Dala", 134, 102], + ["ela", -1, 83], + ["ila", -1, 116], + ["acila", 155, 124], + ["lucila", 155, 121], + ["nila", 155, 103], + ["astanila", 158, 110], + ["istanila", 158, 111], + ["ostanila", 158, 112], + ["rosila", 155, 127], + ["jetila", 155, 118], + ["ozila", 155, 48], + ["a\u010Dila", 155, 101], + ["lu\u010Dila", 155, 117], + ["ro\u0161ila", 155, 90], + ["ola", -1, 50], + ["asla", -1, 115], + ["nula", -1, 13], + ["gama", -1, 20], + ["logama", 171, 19], + ["ugama", 171, 18], + ["ajama", -1, 109], + ["cajama", 174, 26], + ["lajama", 174, 30], + ["rajama", 174, 31], + ["\u0107ajama", 174, 28], + ["\u010Dajama", 174, 27], + ["\u0111ajama", 174, 29], + ["bijama", -1, 32], + ["cijama", -1, 33], + ["dijama", -1, 34], + ["fijama", -1, 40], + ["gijama", -1, 39], + ["lijama", -1, 35], + ["mijama", -1, 37], + ["nijama", -1, 36], + ["ganijama", 188, 9], + ["manijama", 188, 6], + ["panijama", 188, 7], + ["ranijama", 188, 8], + ["tanijama", 188, 5], + ["pijama", -1, 41], + ["rijama", -1, 42], + ["sijama", -1, 43], + ["tijama", -1, 44], + ["zijama", -1, 45], + ["\u017Eijama", -1, 38], + ["alama", -1, 104], + ["ijalama", 200, 47], + ["nalama", 200, 46], + ["elama", -1, 119], + ["ilama", -1, 116], + ["ramama", -1, 52], + ["lemama", -1, 51], + ["inama", -1, 11], + ["cinama", 207, 137], + ["\u010Dinama", 207, 89], + ["rama", -1, 52], + ["arama", 210, 53], + ["drama", 210, 54], + ["erama", 210, 55], + ["orama", 210, 56], + ["basama", -1, 135], + ["gasama", -1, 131], + ["jasama", -1, 129], + ["kasama", -1, 133], + ["nasama", -1, 132], + ["tasama", -1, 130], + ["vasama", -1, 134], + ["esama", -1, 152], + ["isama", -1, 154], + ["etama", -1, 70], + ["estama", -1, 71], + ["istama", -1, 72], + ["kstama", -1, 73], + ["ostama", -1, 74], + ["avama", -1, 77], + ["evama", -1, 78], + ["ivama", -1, 79], + ["ba\u0161ama", -1, 63], + ["ga\u0161ama", -1, 64], + ["ja\u0161ama", -1, 61], + ["ka\u0161ama", -1, 62], + ["na\u0161ama", -1, 60], + ["ta\u0161ama", -1, 59], + ["va\u0161ama", -1, 65], + ["e\u0161ama", -1, 66], + ["i\u0161ama", -1, 67], + ["lema", -1, 51], + ["acima", -1, 124], + ["ecima", -1, 125], + ["ucima", -1, 126], + ["ajima", -1, 109], + ["cajima", 245, 26], + ["lajima", 245, 30], + ["rajima", 245, 31], + ["\u0107ajima", 245, 28], + ["\u010Dajima", 245, 27], + ["\u0111ajima", 245, 29], + ["bijima", -1, 32], + ["cijima", -1, 33], + ["dijima", -1, 34], + ["fijima", -1, 40], + ["gijima", -1, 39], + ["anjijima", -1, 84], + ["enjijima", -1, 85], + ["snjijima", -1, 122], + ["\u0161njijima", -1, 86], + ["kijima", -1, 95], + ["skijima", 261, 1], + ["\u0161kijima", 261, 2], + ["lijima", -1, 35], + ["elijima", 264, 83], + ["mijima", -1, 37], + ["nijima", -1, 13], + ["ganijima", 267, 9], + ["manijima", 267, 6], + ["panijima", 267, 7], + ["ranijima", 267, 8], + ["tanijima", 267, 5], + ["pijima", -1, 41], + ["rijima", -1, 42], + ["sijima", -1, 43], + ["osijima", 275, 123], + ["tijima", -1, 44], + ["atijima", 277, 120], + ["evitijima", 277, 92], + ["ovitijima", 277, 93], + ["astijima", 277, 94], + ["avijima", -1, 77], + ["evijima", -1, 78], + ["ivijima", -1, 79], + ["ovijima", -1, 80], + ["zijima", -1, 45], + ["o\u0161ijima", -1, 91], + ["\u017Eijima", -1, 38], + ["anjima", -1, 84], + ["enjima", -1, 85], + ["snjima", -1, 122], + ["\u0161njima", -1, 86], + ["kima", -1, 95], + ["skima", 293, 1], + ["\u0161kima", 293, 2], + ["alima", -1, 104], + ["ijalima", 296, 47], + ["nalima", 296, 46], + ["elima", -1, 83], + ["ilima", -1, 116], + ["ozilima", 300, 48], + ["olima", -1, 50], + ["lemima", -1, 51], + ["nima", -1, 13], + ["anima", 304, 10], + ["inima", 304, 11], + ["cinima", 306, 137], + ["\u010Dinima", 306, 89], + ["onima", 304, 12], + ["arima", -1, 53], + ["drima", -1, 54], + ["erima", -1, 55], + ["orima", -1, 56], + ["basima", -1, 135], + ["gasima", -1, 131], + ["jasima", -1, 129], + ["kasima", -1, 133], + ["nasima", -1, 132], + ["tasima", -1, 130], + ["vasima", -1, 134], + ["esima", -1, 57], + ["isima", -1, 58], + ["osima", -1, 123], + ["atima", -1, 120], + ["ikatima", 324, 68], + ["latima", 324, 69], + ["etima", -1, 70], + ["evitima", -1, 92], + ["ovitima", -1, 93], + ["astima", -1, 94], + ["estima", -1, 71], + ["istima", -1, 72], + ["kstima", -1, 73], + ["ostima", -1, 74], + ["i\u0161tima", -1, 75], + ["avima", -1, 77], + ["evima", -1, 78], + ["ajevima", 337, 109], + ["cajevima", 338, 26], + ["lajevima", 338, 30], + ["rajevima", 338, 31], + ["\u0107ajevima", 338, 28], + ["\u010Dajevima", 338, 27], + ["\u0111ajevima", 338, 29], + ["ivima", -1, 79], + ["ovima", -1, 80], + ["govima", 346, 20], + ["ugovima", 347, 17], + ["lovima", 346, 82], + ["olovima", 349, 49], + ["movima", 346, 81], + ["onovima", 346, 12], + ["stvima", -1, 3], + ["\u0161tvima", -1, 4], + ["a\u0107ima", -1, 14], + ["e\u0107ima", -1, 15], + ["u\u0107ima", -1, 16], + ["ba\u0161ima", -1, 63], + ["ga\u0161ima", -1, 64], + ["ja\u0161ima", -1, 61], + ["ka\u0161ima", -1, 62], + ["na\u0161ima", -1, 60], + ["ta\u0161ima", -1, 59], + ["va\u0161ima", -1, 65], + ["e\u0161ima", -1, 66], + ["i\u0161ima", -1, 67], + ["o\u0161ima", -1, 91], + ["na", -1, 13], + ["ana", 368, 10], + ["acana", 369, 128], + ["urana", 369, 105], + ["tana", 369, 113], + ["avana", 369, 97], + ["evana", 369, 96], + ["ivana", 369, 98], + ["uvana", 369, 99], + ["a\u010Dana", 369, 102], + ["acena", 368, 124], + ["lucena", 368, 121], + ["a\u010Dena", 368, 101], + ["lu\u010Dena", 368, 117], + ["ina", 368, 11], + ["cina", 382, 137], + ["anina", 382, 10], + ["\u010Dina", 382, 89], + ["ona", 368, 12], + ["ara", -1, 53], + ["dra", -1, 54], + ["era", -1, 55], + ["ora", -1, 56], + ["basa", -1, 135], + ["gasa", -1, 131], + ["jasa", -1, 129], + ["kasa", -1, 133], + ["nasa", -1, 132], + ["tasa", -1, 130], + ["vasa", -1, 134], + ["esa", -1, 57], + ["isa", -1, 58], + ["osa", -1, 123], + ["ata", -1, 120], + ["ikata", 401, 68], + ["lata", 401, 69], + ["eta", -1, 70], + ["evita", -1, 92], + ["ovita", -1, 93], + ["asta", -1, 94], + ["esta", -1, 71], + ["ista", -1, 72], + ["ksta", -1, 73], + ["osta", -1, 74], + ["nuta", -1, 13], + ["i\u0161ta", -1, 75], + ["ava", -1, 77], + ["eva", -1, 78], + ["ajeva", 415, 109], + ["cajeva", 416, 26], + ["lajeva", 416, 30], + ["rajeva", 416, 31], + ["\u0107ajeva", 416, 28], + ["\u010Dajeva", 416, 27], + ["\u0111ajeva", 416, 29], + ["iva", -1, 79], + ["ova", -1, 80], + ["gova", 424, 20], + ["ugova", 425, 17], + ["lova", 424, 82], + ["olova", 427, 49], + ["mova", 424, 81], + ["onova", 424, 12], + ["stva", -1, 3], + ["\u0161tva", -1, 4], + ["a\u0107a", -1, 14], + ["e\u0107a", -1, 15], + ["u\u0107a", -1, 16], + ["ba\u0161a", -1, 63], + ["ga\u0161a", -1, 64], + ["ja\u0161a", -1, 61], + ["ka\u0161a", -1, 62], + ["na\u0161a", -1, 60], + ["ta\u0161a", -1, 59], + ["va\u0161a", -1, 65], + ["e\u0161a", -1, 66], + ["i\u0161a", -1, 67], + ["o\u0161a", -1, 91], + ["ace", -1, 124], + ["ece", -1, 125], + ["uce", -1, 126], + ["luce", 448, 121], + ["astade", -1, 110], + ["istade", -1, 111], + ["ostade", -1, 112], + ["ge", -1, 20], + ["loge", 453, 19], + ["uge", 453, 18], + ["aje", -1, 104], + ["caje", 456, 26], + ["laje", 456, 30], + ["raje", 456, 31], + ["astaje", 456, 106], + ["istaje", 456, 107], + ["ostaje", 456, 108], + ["\u0107aje", 456, 28], + ["\u010Daje", 456, 27], + ["\u0111aje", 456, 29], + ["ije", -1, 116], + ["bije", 466, 32], + ["cije", 466, 33], + ["dije", 466, 34], + ["fije", 466, 40], + ["gije", 466, 39], + ["anjije", 466, 84], + ["enjije", 466, 85], + ["snjije", 466, 122], + ["\u0161njije", 466, 86], + ["kije", 466, 95], + ["skije", 476, 1], + ["\u0161kije", 476, 2], + ["lije", 466, 35], + ["elije", 479, 83], + ["mije", 466, 37], + ["nije", 466, 13], + ["ganije", 482, 9], + ["manije", 482, 6], + ["panije", 482, 7], + ["ranije", 482, 8], + ["tanije", 482, 5], + ["pije", 466, 41], + ["rije", 466, 42], + ["sije", 466, 43], + ["osije", 490, 123], + ["tije", 466, 44], + ["atije", 492, 120], + ["evitije", 492, 92], + ["ovitije", 492, 93], + ["astije", 492, 94], + ["avije", 466, 77], + ["evije", 466, 78], + ["ivije", 466, 79], + ["ovije", 466, 80], + ["zije", 466, 45], + ["o\u0161ije", 466, 91], + ["\u017Eije", 466, 38], + ["anje", -1, 84], + ["enje", -1, 85], + ["snje", -1, 122], + ["\u0161nje", -1, 86], + ["uje", -1, 25], + ["lucuje", 508, 121], + ["iruje", 508, 100], + ["lu\u010Duje", 508, 117], + ["ke", -1, 95], + ["ske", 512, 1], + ["\u0161ke", 512, 2], + ["ale", -1, 104], + ["acale", 515, 128], + ["astajale", 515, 106], + ["istajale", 515, 107], + ["ostajale", 515, 108], + ["ijale", 515, 47], + ["injale", 515, 114], + ["nale", 515, 46], + ["irale", 515, 100], + ["urale", 515, 105], + ["tale", 515, 113], + ["astale", 525, 110], + ["istale", 525, 111], + ["ostale", 525, 112], + ["avale", 515, 97], + ["evale", 515, 96], + ["ivale", 515, 98], + ["ovale", 515, 76], + ["uvale", 515, 99], + ["a\u010Dale", 515, 102], + ["ele", -1, 83], + ["ile", -1, 116], + ["acile", 536, 124], + ["lucile", 536, 121], + ["nile", 536, 103], + ["rosile", 536, 127], + ["jetile", 536, 118], + ["ozile", 536, 48], + ["a\u010Dile", 536, 101], + ["lu\u010Dile", 536, 117], + ["ro\u0161ile", 536, 90], + ["ole", -1, 50], + ["asle", -1, 115], + ["nule", -1, 13], + ["rame", -1, 52], + ["leme", -1, 51], + ["acome", -1, 124], + ["ecome", -1, 125], + ["ucome", -1, 126], + ["anjome", -1, 84], + ["enjome", -1, 85], + ["snjome", -1, 122], + ["\u0161njome", -1, 86], + ["kome", -1, 95], + ["skome", 558, 1], + ["\u0161kome", 558, 2], + ["elome", -1, 83], + ["nome", -1, 13], + ["cinome", 562, 137], + ["\u010Dinome", 562, 89], + ["osome", -1, 123], + ["atome", -1, 120], + ["evitome", -1, 92], + ["ovitome", -1, 93], + ["astome", -1, 94], + ["avome", -1, 77], + ["evome", -1, 78], + ["ivome", -1, 79], + ["ovome", -1, 80], + ["a\u0107ome", -1, 14], + ["e\u0107ome", -1, 15], + ["u\u0107ome", -1, 16], + ["o\u0161ome", -1, 91], + ["ne", -1, 13], + ["ane", 578, 10], + ["acane", 579, 128], + ["urane", 579, 105], + ["tane", 579, 113], + ["astane", 582, 110], + ["istane", 582, 111], + ["ostane", 582, 112], + ["avane", 579, 97], + ["evane", 579, 96], + ["ivane", 579, 98], + ["uvane", 579, 99], + ["a\u010Dane", 579, 102], + ["acene", 578, 124], + ["lucene", 578, 121], + ["a\u010Dene", 578, 101], + ["lu\u010Dene", 578, 117], + ["ine", 578, 11], + ["cine", 595, 137], + ["anine", 595, 10], + ["\u010Dine", 595, 89], + ["one", 578, 12], + ["are", -1, 53], + ["dre", -1, 54], + ["ere", -1, 55], + ["ore", -1, 56], + ["ase", -1, 161], + ["base", 604, 135], + ["acase", 604, 128], + ["gase", 604, 131], + ["jase", 604, 129], + ["astajase", 608, 138], + ["istajase", 608, 139], + ["ostajase", 608, 140], + ["injase", 608, 150], + ["kase", 604, 133], + ["nase", 604, 132], + ["irase", 604, 155], + ["urase", 604, 156], + ["tase", 604, 130], + ["vase", 604, 134], + ["avase", 618, 144], + ["evase", 618, 145], + ["ivase", 618, 146], + ["ovase", 618, 148], + ["uvase", 618, 147], + ["ese", -1, 57], + ["ise", -1, 58], + ["acise", 625, 124], + ["lucise", 625, 121], + ["rosise", 625, 127], + ["jetise", 625, 149], + ["ose", -1, 123], + ["astadose", 630, 141], + ["istadose", 630, 142], + ["ostadose", 630, 143], + ["ate", -1, 104], + ["acate", 634, 128], + ["ikate", 634, 68], + ["late", 634, 69], + ["irate", 634, 100], + ["urate", 634, 105], + ["tate", 634, 113], + ["avate", 634, 97], + ["evate", 634, 96], + ["ivate", 634, 98], + ["uvate", 634, 99], + ["a\u010Date", 634, 102], + ["ete", -1, 70], + ["astadete", 646, 110], + ["istadete", 646, 111], + ["ostadete", 646, 112], + ["astajete", 646, 106], + ["istajete", 646, 107], + ["ostajete", 646, 108], + ["ijete", 646, 116], + ["injete", 646, 114], + ["ujete", 646, 25], + ["lucujete", 655, 121], + ["irujete", 655, 100], + ["lu\u010Dujete", 655, 117], + ["nete", 646, 13], + ["astanete", 659, 110], + ["istanete", 659, 111], + ["ostanete", 659, 112], + ["astete", 646, 115], + ["ite", -1, 116], + ["acite", 664, 124], + ["lucite", 664, 121], + ["nite", 664, 13], + ["astanite", 667, 110], + ["istanite", 667, 111], + ["ostanite", 667, 112], + ["rosite", 664, 127], + ["jetite", 664, 118], + ["astite", 664, 115], + ["evite", 664, 92], + ["ovite", 664, 93], + ["a\u010Dite", 664, 101], + ["lu\u010Dite", 664, 117], + ["ro\u0161ite", 664, 90], + ["ajte", -1, 104], + ["urajte", 679, 105], + ["tajte", 679, 113], + ["astajte", 681, 106], + ["istajte", 681, 107], + ["ostajte", 681, 108], + ["avajte", 679, 97], + ["evajte", 679, 96], + ["ivajte", 679, 98], + ["uvajte", 679, 99], + ["ijte", -1, 116], + ["lucujte", -1, 121], + ["irujte", -1, 100], + ["lu\u010Dujte", -1, 117], + ["aste", -1, 94], + ["acaste", 693, 128], + ["astajaste", 693, 106], + ["istajaste", 693, 107], + ["ostajaste", 693, 108], + ["injaste", 693, 114], + ["iraste", 693, 100], + ["uraste", 693, 105], + ["taste", 693, 113], + ["avaste", 693, 97], + ["evaste", 693, 96], + ["ivaste", 693, 98], + ["ovaste", 693, 76], + ["uvaste", 693, 99], + ["a\u010Daste", 693, 102], + ["este", -1, 71], + ["iste", -1, 72], + ["aciste", 709, 124], + ["luciste", 709, 121], + ["niste", 709, 103], + ["rosiste", 709, 127], + ["jetiste", 709, 118], + ["a\u010Diste", 709, 101], + ["lu\u010Diste", 709, 117], + ["ro\u0161iste", 709, 90], + ["kste", -1, 73], + ["oste", -1, 74], + ["astadoste", 719, 110], + ["istadoste", 719, 111], + ["ostadoste", 719, 112], + ["nuste", -1, 13], + ["i\u0161te", -1, 75], + ["ave", -1, 77], + ["eve", -1, 78], + ["ajeve", 726, 109], + ["cajeve", 727, 26], + ["lajeve", 727, 30], + ["rajeve", 727, 31], + ["\u0107ajeve", 727, 28], + ["\u010Dajeve", 727, 27], + ["\u0111ajeve", 727, 29], + ["ive", -1, 79], + ["ove", -1, 80], + ["gove", 735, 20], + ["ugove", 736, 17], + ["love", 735, 82], + ["olove", 738, 49], + ["move", 735, 81], + ["onove", 735, 12], + ["a\u0107e", -1, 14], + ["e\u0107e", -1, 15], + ["u\u0107e", -1, 16], + ["a\u010De", -1, 101], + ["lu\u010De", -1, 117], + ["a\u0161e", -1, 104], + ["ba\u0161e", 747, 63], + ["ga\u0161e", 747, 64], + ["ja\u0161e", 747, 61], + ["astaja\u0161e", 750, 106], + ["istaja\u0161e", 750, 107], + ["ostaja\u0161e", 750, 108], + ["inja\u0161e", 750, 114], + ["ka\u0161e", 747, 62], + ["na\u0161e", 747, 60], + ["ira\u0161e", 747, 100], + ["ura\u0161e", 747, 105], + ["ta\u0161e", 747, 59], + ["va\u0161e", 747, 65], + ["ava\u0161e", 760, 97], + ["eva\u0161e", 760, 96], + ["iva\u0161e", 760, 98], + ["ova\u0161e", 760, 76], + ["uva\u0161e", 760, 99], + ["a\u010Da\u0161e", 747, 102], + ["e\u0161e", -1, 66], + ["i\u0161e", -1, 67], + ["jeti\u0161e", 768, 118], + ["a\u010Di\u0161e", 768, 101], + ["lu\u010Di\u0161e", 768, 117], + ["ro\u0161i\u0161e", 768, 90], + ["o\u0161e", -1, 91], + ["astado\u0161e", 773, 110], + ["istado\u0161e", 773, 111], + ["ostado\u0161e", 773, 112], + ["aceg", -1, 124], + ["eceg", -1, 125], + ["uceg", -1, 126], + ["anjijeg", -1, 84], + ["enjijeg", -1, 85], + ["snjijeg", -1, 122], + ["\u0161njijeg", -1, 86], + ["kijeg", -1, 95], + ["skijeg", 784, 1], + ["\u0161kijeg", 784, 2], + ["elijeg", -1, 83], + ["nijeg", -1, 13], + ["osijeg", -1, 123], + ["atijeg", -1, 120], + ["evitijeg", -1, 92], + ["ovitijeg", -1, 93], + ["astijeg", -1, 94], + ["avijeg", -1, 77], + ["evijeg", -1, 78], + ["ivijeg", -1, 79], + ["ovijeg", -1, 80], + ["o\u0161ijeg", -1, 91], + ["anjeg", -1, 84], + ["enjeg", -1, 85], + ["snjeg", -1, 122], + ["\u0161njeg", -1, 86], + ["keg", -1, 95], + ["eleg", -1, 83], + ["neg", -1, 13], + ["aneg", 805, 10], + ["eneg", 805, 87], + ["sneg", 805, 159], + ["\u0161neg", 805, 88], + ["oseg", -1, 123], + ["ateg", -1, 120], + ["aveg", -1, 77], + ["eveg", -1, 78], + ["iveg", -1, 79], + ["oveg", -1, 80], + ["a\u0107eg", -1, 14], + ["e\u0107eg", -1, 15], + ["u\u0107eg", -1, 16], + ["o\u0161eg", -1, 91], + ["acog", -1, 124], + ["ecog", -1, 125], + ["ucog", -1, 126], + ["anjog", -1, 84], + ["enjog", -1, 85], + ["snjog", -1, 122], + ["\u0161njog", -1, 86], + ["kog", -1, 95], + ["skog", 827, 1], + ["\u0161kog", 827, 2], + ["elog", -1, 83], + ["nog", -1, 13], + ["cinog", 831, 137], + ["\u010Dinog", 831, 89], + ["osog", -1, 123], + ["atog", -1, 120], + ["evitog", -1, 92], + ["ovitog", -1, 93], + ["astog", -1, 94], + ["avog", -1, 77], + ["evog", -1, 78], + ["ivog", -1, 79], + ["ovog", -1, 80], + ["a\u0107og", -1, 14], + ["e\u0107og", -1, 15], + ["u\u0107og", -1, 16], + ["o\u0161og", -1, 91], + ["ah", -1, 104], + ["acah", 847, 128], + ["astajah", 847, 106], + ["istajah", 847, 107], + ["ostajah", 847, 108], + ["injah", 847, 114], + ["irah", 847, 100], + ["urah", 847, 105], + ["tah", 847, 113], + ["avah", 847, 97], + ["evah", 847, 96], + ["ivah", 847, 98], + ["ovah", 847, 76], + ["uvah", 847, 99], + ["a\u010Dah", 847, 102], + ["ih", -1, 116], + ["acih", 862, 124], + ["ecih", 862, 125], + ["ucih", 862, 126], + ["lucih", 865, 121], + ["anjijih", 862, 84], + ["enjijih", 862, 85], + ["snjijih", 862, 122], + ["\u0161njijih", 862, 86], + ["kijih", 862, 95], + ["skijih", 871, 1], + ["\u0161kijih", 871, 2], + ["elijih", 862, 83], + ["nijih", 862, 13], + ["osijih", 862, 123], + ["atijih", 862, 120], + ["evitijih", 862, 92], + ["ovitijih", 862, 93], + ["astijih", 862, 94], + ["avijih", 862, 77], + ["evijih", 862, 78], + ["ivijih", 862, 79], + ["ovijih", 862, 80], + ["o\u0161ijih", 862, 91], + ["anjih", 862, 84], + ["enjih", 862, 85], + ["snjih", 862, 122], + ["\u0161njih", 862, 86], + ["kih", 862, 95], + ["skih", 890, 1], + ["\u0161kih", 890, 2], + ["elih", 862, 83], + ["nih", 862, 13], + ["cinih", 894, 137], + ["\u010Dinih", 894, 89], + ["osih", 862, 123], + ["rosih", 897, 127], + ["atih", 862, 120], + ["jetih", 862, 118], + ["evitih", 862, 92], + ["ovitih", 862, 93], + ["astih", 862, 94], + ["avih", 862, 77], + ["evih", 862, 78], + ["ivih", 862, 79], + ["ovih", 862, 80], + ["a\u0107ih", 862, 14], + ["e\u0107ih", 862, 15], + ["u\u0107ih", 862, 16], + ["a\u010Dih", 862, 101], + ["lu\u010Dih", 862, 117], + ["o\u0161ih", 862, 91], + ["ro\u0161ih", 913, 90], + ["astadoh", -1, 110], + ["istadoh", -1, 111], + ["ostadoh", -1, 112], + ["acuh", -1, 124], + ["ecuh", -1, 125], + ["ucuh", -1, 126], + ["a\u0107uh", -1, 14], + ["e\u0107uh", -1, 15], + ["u\u0107uh", -1, 16], + ["aci", -1, 124], + ["aceci", -1, 124], + ["ieci", -1, 162], + ["ajuci", -1, 161], + ["irajuci", 927, 155], + ["urajuci", 927, 156], + ["astajuci", 927, 138], + ["istajuci", 927, 139], + ["ostajuci", 927, 140], + ["avajuci", 927, 144], + ["evajuci", 927, 145], + ["ivajuci", 927, 146], + ["uvajuci", 927, 147], + ["ujuci", -1, 157], + ["lucujuci", 937, 121], + ["irujuci", 937, 155], + ["luci", -1, 121], + ["nuci", -1, 164], + ["etuci", -1, 153], + ["astuci", -1, 136], + ["gi", -1, 20], + ["ugi", 944, 18], + ["aji", -1, 109], + ["caji", 946, 26], + ["laji", 946, 30], + ["raji", 946, 31], + ["\u0107aji", 946, 28], + ["\u010Daji", 946, 27], + ["\u0111aji", 946, 29], + ["biji", -1, 32], + ["ciji", -1, 33], + ["diji", -1, 34], + ["fiji", -1, 40], + ["giji", -1, 39], + ["anjiji", -1, 84], + ["enjiji", -1, 85], + ["snjiji", -1, 122], + ["\u0161njiji", -1, 86], + ["kiji", -1, 95], + ["skiji", 962, 1], + ["\u0161kiji", 962, 2], + ["liji", -1, 35], + ["eliji", 965, 83], + ["miji", -1, 37], + ["niji", -1, 13], + ["ganiji", 968, 9], + ["maniji", 968, 6], + ["paniji", 968, 7], + ["raniji", 968, 8], + ["taniji", 968, 5], + ["piji", -1, 41], + ["riji", -1, 42], + ["siji", -1, 43], + ["osiji", 976, 123], + ["tiji", -1, 44], + ["atiji", 978, 120], + ["evitiji", 978, 92], + ["ovitiji", 978, 93], + ["astiji", 978, 94], + ["aviji", -1, 77], + ["eviji", -1, 78], + ["iviji", -1, 79], + ["oviji", -1, 80], + ["ziji", -1, 45], + ["o\u0161iji", -1, 91], + ["\u017Eiji", -1, 38], + ["anji", -1, 84], + ["enji", -1, 85], + ["snji", -1, 122], + ["\u0161nji", -1, 86], + ["ki", -1, 95], + ["ski", 994, 1], + ["\u0161ki", 994, 2], + ["ali", -1, 104], + ["acali", 997, 128], + ["astajali", 997, 106], + ["istajali", 997, 107], + ["ostajali", 997, 108], + ["ijali", 997, 47], + ["injali", 997, 114], + ["nali", 997, 46], + ["irali", 997, 100], + ["urali", 997, 105], + ["tali", 997, 113], + ["astali", 1007, 110], + ["istali", 1007, 111], + ["ostali", 1007, 112], + ["avali", 997, 97], + ["evali", 997, 96], + ["ivali", 997, 98], + ["ovali", 997, 76], + ["uvali", 997, 99], + ["a\u010Dali", 997, 102], + ["eli", -1, 83], + ["ili", -1, 116], + ["acili", 1018, 124], + ["lucili", 1018, 121], + ["nili", 1018, 103], + ["rosili", 1018, 127], + ["jetili", 1018, 118], + ["ozili", 1018, 48], + ["a\u010Dili", 1018, 101], + ["lu\u010Dili", 1018, 117], + ["ro\u0161ili", 1018, 90], + ["oli", -1, 50], + ["asli", -1, 115], + ["nuli", -1, 13], + ["rami", -1, 52], + ["lemi", -1, 51], + ["ni", -1, 13], + ["ani", 1033, 10], + ["acani", 1034, 128], + ["urani", 1034, 105], + ["tani", 1034, 113], + ["avani", 1034, 97], + ["evani", 1034, 96], + ["ivani", 1034, 98], + ["uvani", 1034, 99], + ["a\u010Dani", 1034, 102], + ["aceni", 1033, 124], + ["luceni", 1033, 121], + ["a\u010Deni", 1033, 101], + ["lu\u010Deni", 1033, 117], + ["ini", 1033, 11], + ["cini", 1047, 137], + ["\u010Dini", 1047, 89], + ["oni", 1033, 12], + ["ari", -1, 53], + ["dri", -1, 54], + ["eri", -1, 55], + ["ori", -1, 56], + ["basi", -1, 135], + ["gasi", -1, 131], + ["jasi", -1, 129], + ["kasi", -1, 133], + ["nasi", -1, 132], + ["tasi", -1, 130], + ["vasi", -1, 134], + ["esi", -1, 152], + ["isi", -1, 154], + ["osi", -1, 123], + ["avsi", -1, 161], + ["acavsi", 1065, 128], + ["iravsi", 1065, 155], + ["tavsi", 1065, 160], + ["etavsi", 1068, 153], + ["astavsi", 1068, 141], + ["istavsi", 1068, 142], + ["ostavsi", 1068, 143], + ["ivsi", -1, 162], + ["nivsi", 1073, 158], + ["rosivsi", 1073, 127], + ["nuvsi", -1, 164], + ["ati", -1, 104], + ["acati", 1077, 128], + ["astajati", 1077, 106], + ["istajati", 1077, 107], + ["ostajati", 1077, 108], + ["injati", 1077, 114], + ["ikati", 1077, 68], + ["lati", 1077, 69], + ["irati", 1077, 100], + ["urati", 1077, 105], + ["tati", 1077, 113], + ["astati", 1087, 110], + ["istati", 1087, 111], + ["ostati", 1087, 112], + ["avati", 1077, 97], + ["evati", 1077, 96], + ["ivati", 1077, 98], + ["ovati", 1077, 76], + ["uvati", 1077, 99], + ["a\u010Dati", 1077, 102], + ["eti", -1, 70], + ["iti", -1, 116], + ["aciti", 1098, 124], + ["luciti", 1098, 121], + ["niti", 1098, 103], + ["rositi", 1098, 127], + ["jetiti", 1098, 118], + ["eviti", 1098, 92], + ["oviti", 1098, 93], + ["a\u010Diti", 1098, 101], + ["lu\u010Diti", 1098, 117], + ["ro\u0161iti", 1098, 90], + ["asti", -1, 94], + ["esti", -1, 71], + ["isti", -1, 72], + ["ksti", -1, 73], + ["osti", -1, 74], + ["nuti", -1, 13], + ["avi", -1, 77], + ["evi", -1, 78], + ["ajevi", 1116, 109], + ["cajevi", 1117, 26], + ["lajevi", 1117, 30], + ["rajevi", 1117, 31], + ["\u0107ajevi", 1117, 28], + ["\u010Dajevi", 1117, 27], + ["\u0111ajevi", 1117, 29], + ["ivi", -1, 79], + ["ovi", -1, 80], + ["govi", 1125, 20], + ["ugovi", 1126, 17], + ["lovi", 1125, 82], + ["olovi", 1128, 49], + ["movi", 1125, 81], + ["onovi", 1125, 12], + ["ie\u0107i", -1, 116], + ["a\u010De\u0107i", -1, 101], + ["aju\u0107i", -1, 104], + ["iraju\u0107i", 1134, 100], + ["uraju\u0107i", 1134, 105], + ["astaju\u0107i", 1134, 106], + ["istaju\u0107i", 1134, 107], + ["ostaju\u0107i", 1134, 108], + ["avaju\u0107i", 1134, 97], + ["evaju\u0107i", 1134, 96], + ["ivaju\u0107i", 1134, 98], + ["uvaju\u0107i", 1134, 99], + ["uju\u0107i", -1, 25], + ["iruju\u0107i", 1144, 100], + ["lu\u010Duju\u0107i", 1144, 117], + ["nu\u0107i", -1, 13], + ["etu\u0107i", -1, 70], + ["astu\u0107i", -1, 115], + ["a\u010Di", -1, 101], + ["lu\u010Di", -1, 117], + ["ba\u0161i", -1, 63], + ["ga\u0161i", -1, 64], + ["ja\u0161i", -1, 61], + ["ka\u0161i", -1, 62], + ["na\u0161i", -1, 60], + ["ta\u0161i", -1, 59], + ["va\u0161i", -1, 65], + ["e\u0161i", -1, 66], + ["i\u0161i", -1, 67], + ["o\u0161i", -1, 91], + ["av\u0161i", -1, 104], + ["irav\u0161i", 1162, 100], + ["tav\u0161i", 1162, 113], + ["etav\u0161i", 1164, 70], + ["astav\u0161i", 1164, 110], + ["istav\u0161i", 1164, 111], + ["ostav\u0161i", 1164, 112], + ["a\u010Dav\u0161i", 1162, 102], + ["iv\u0161i", -1, 116], + ["niv\u0161i", 1170, 103], + ["ro\u0161iv\u0161i", 1170, 90], + ["nuv\u0161i", -1, 13], + ["aj", -1, 104], + ["uraj", 1174, 105], + ["taj", 1174, 113], + ["avaj", 1174, 97], + ["evaj", 1174, 96], + ["ivaj", 1174, 98], + ["uvaj", 1174, 99], + ["ij", -1, 116], + ["acoj", -1, 124], + ["ecoj", -1, 125], + ["ucoj", -1, 126], + ["anjijoj", -1, 84], + ["enjijoj", -1, 85], + ["snjijoj", -1, 122], + ["\u0161njijoj", -1, 86], + ["kijoj", -1, 95], + ["skijoj", 1189, 1], + ["\u0161kijoj", 1189, 2], + ["elijoj", -1, 83], + ["nijoj", -1, 13], + ["osijoj", -1, 123], + ["evitijoj", -1, 92], + ["ovitijoj", -1, 93], + ["astijoj", -1, 94], + ["avijoj", -1, 77], + ["evijoj", -1, 78], + ["ivijoj", -1, 79], + ["ovijoj", -1, 80], + ["o\u0161ijoj", -1, 91], + ["anjoj", -1, 84], + ["enjoj", -1, 85], + ["snjoj", -1, 122], + ["\u0161njoj", -1, 86], + ["koj", -1, 95], + ["skoj", 1207, 1], + ["\u0161koj", 1207, 2], + ["aloj", -1, 104], + ["eloj", -1, 83], + ["noj", -1, 13], + ["cinoj", 1212, 137], + ["\u010Dinoj", 1212, 89], + ["osoj", -1, 123], + ["atoj", -1, 120], + ["evitoj", -1, 92], + ["ovitoj", -1, 93], + ["astoj", -1, 94], + ["avoj", -1, 77], + ["evoj", -1, 78], + ["ivoj", -1, 79], + ["ovoj", -1, 80], + ["a\u0107oj", -1, 14], + ["e\u0107oj", -1, 15], + ["u\u0107oj", -1, 16], + ["o\u0161oj", -1, 91], + ["lucuj", -1, 121], + ["iruj", -1, 100], + ["lu\u010Duj", -1, 117], + ["al", -1, 104], + ["iral", 1231, 100], + ["ural", 1231, 105], + ["el", -1, 119], + ["il", -1, 116], + ["am", -1, 104], + ["acam", 1236, 128], + ["iram", 1236, 100], + ["uram", 1236, 105], + ["tam", 1236, 113], + ["avam", 1236, 97], + ["evam", 1236, 96], + ["ivam", 1236, 98], + ["uvam", 1236, 99], + ["a\u010Dam", 1236, 102], + ["em", -1, 119], + ["acem", 1246, 124], + ["ecem", 1246, 125], + ["ucem", 1246, 126], + ["astadem", 1246, 110], + ["istadem", 1246, 111], + ["ostadem", 1246, 112], + ["ajem", 1246, 104], + ["cajem", 1253, 26], + ["lajem", 1253, 30], + ["rajem", 1253, 31], + ["astajem", 1253, 106], + ["istajem", 1253, 107], + ["ostajem", 1253, 108], + ["\u0107ajem", 1253, 28], + ["\u010Dajem", 1253, 27], + ["\u0111ajem", 1253, 29], + ["ijem", 1246, 116], + ["anjijem", 1263, 84], + ["enjijem", 1263, 85], + ["snjijem", 1263, 123], + ["\u0161njijem", 1263, 86], + ["kijem", 1263, 95], + ["skijem", 1268, 1], + ["\u0161kijem", 1268, 2], + ["lijem", 1263, 24], + ["elijem", 1271, 83], + ["nijem", 1263, 13], + ["rarijem", 1263, 21], + ["sijem", 1263, 23], + ["osijem", 1275, 123], + ["atijem", 1263, 120], + ["evitijem", 1263, 92], + ["ovitijem", 1263, 93], + ["otijem", 1263, 22], + ["astijem", 1263, 94], + ["avijem", 1263, 77], + ["evijem", 1263, 78], + ["ivijem", 1263, 79], + ["ovijem", 1263, 80], + ["o\u0161ijem", 1263, 91], + ["anjem", 1246, 84], + ["enjem", 1246, 85], + ["injem", 1246, 114], + ["snjem", 1246, 122], + ["\u0161njem", 1246, 86], + ["ujem", 1246, 25], + ["lucujem", 1292, 121], + ["irujem", 1292, 100], + ["lu\u010Dujem", 1292, 117], + ["kem", 1246, 95], + ["skem", 1296, 1], + ["\u0161kem", 1296, 2], + ["elem", 1246, 83], + ["nem", 1246, 13], + ["anem", 1300, 10], + ["astanem", 1301, 110], + ["istanem", 1301, 111], + ["ostanem", 1301, 112], + ["enem", 1300, 87], + ["snem", 1300, 159], + ["\u0161nem", 1300, 88], + ["basem", 1246, 135], + ["gasem", 1246, 131], + ["jasem", 1246, 129], + ["kasem", 1246, 133], + ["nasem", 1246, 132], + ["tasem", 1246, 130], + ["vasem", 1246, 134], + ["esem", 1246, 152], + ["isem", 1246, 154], + ["osem", 1246, 123], + ["atem", 1246, 120], + ["etem", 1246, 70], + ["evitem", 1246, 92], + ["ovitem", 1246, 93], + ["astem", 1246, 94], + ["istem", 1246, 151], + ["i\u0161tem", 1246, 75], + ["avem", 1246, 77], + ["evem", 1246, 78], + ["ivem", 1246, 79], + ["a\u0107em", 1246, 14], + ["e\u0107em", 1246, 15], + ["u\u0107em", 1246, 16], + ["ba\u0161em", 1246, 63], + ["ga\u0161em", 1246, 64], + ["ja\u0161em", 1246, 61], + ["ka\u0161em", 1246, 62], + ["na\u0161em", 1246, 60], + ["ta\u0161em", 1246, 59], + ["va\u0161em", 1246, 65], + ["e\u0161em", 1246, 66], + ["i\u0161em", 1246, 67], + ["o\u0161em", 1246, 91], + ["im", -1, 116], + ["acim", 1341, 124], + ["ecim", 1341, 125], + ["ucim", 1341, 126], + ["lucim", 1344, 121], + ["anjijim", 1341, 84], + ["enjijim", 1341, 85], + ["snjijim", 1341, 122], + ["\u0161njijim", 1341, 86], + ["kijim", 1341, 95], + ["skijim", 1350, 1], + ["\u0161kijim", 1350, 2], + ["elijim", 1341, 83], + ["nijim", 1341, 13], + ["osijim", 1341, 123], + ["atijim", 1341, 120], + ["evitijim", 1341, 92], + ["ovitijim", 1341, 93], + ["astijim", 1341, 94], + ["avijim", 1341, 77], + ["evijim", 1341, 78], + ["ivijim", 1341, 79], + ["ovijim", 1341, 80], + ["o\u0161ijim", 1341, 91], + ["anjim", 1341, 84], + ["enjim", 1341, 85], + ["snjim", 1341, 122], + ["\u0161njim", 1341, 86], + ["kim", 1341, 95], + ["skim", 1369, 1], + ["\u0161kim", 1369, 2], + ["elim", 1341, 83], + ["nim", 1341, 13], + ["cinim", 1373, 137], + ["\u010Dinim", 1373, 89], + ["osim", 1341, 123], + ["rosim", 1376, 127], + ["atim", 1341, 120], + ["jetim", 1341, 118], + ["evitim", 1341, 92], + ["ovitim", 1341, 93], + ["astim", 1341, 94], + ["avim", 1341, 77], + ["evim", 1341, 78], + ["ivim", 1341, 79], + ["ovim", 1341, 80], + ["a\u0107im", 1341, 14], + ["e\u0107im", 1341, 15], + ["u\u0107im", 1341, 16], + ["a\u010Dim", 1341, 101], + ["lu\u010Dim", 1341, 117], + ["o\u0161im", 1341, 91], + ["ro\u0161im", 1392, 90], + ["acom", -1, 124], + ["ecom", -1, 125], + ["ucom", -1, 126], + ["gom", -1, 20], + ["logom", 1397, 19], + ["ugom", 1397, 18], + ["bijom", -1, 32], + ["cijom", -1, 33], + ["dijom", -1, 34], + ["fijom", -1, 40], + ["gijom", -1, 39], + ["lijom", -1, 35], + ["mijom", -1, 37], + ["nijom", -1, 36], + ["ganijom", 1407, 9], + ["manijom", 1407, 6], + ["panijom", 1407, 7], + ["ranijom", 1407, 8], + ["tanijom", 1407, 5], + ["pijom", -1, 41], + ["rijom", -1, 42], + ["sijom", -1, 43], + ["tijom", -1, 44], + ["zijom", -1, 45], + ["\u017Eijom", -1, 38], + ["anjom", -1, 84], + ["enjom", -1, 85], + ["snjom", -1, 122], + ["\u0161njom", -1, 86], + ["kom", -1, 95], + ["skom", 1423, 1], + ["\u0161kom", 1423, 2], + ["alom", -1, 104], + ["ijalom", 1426, 47], + ["nalom", 1426, 46], + ["elom", -1, 83], + ["ilom", -1, 116], + ["ozilom", 1430, 48], + ["olom", -1, 50], + ["ramom", -1, 52], + ["lemom", -1, 51], + ["nom", -1, 13], + ["anom", 1435, 10], + ["inom", 1435, 11], + ["cinom", 1437, 137], + ["aninom", 1437, 10], + ["\u010Dinom", 1437, 89], + ["onom", 1435, 12], + ["arom", -1, 53], + ["drom", -1, 54], + ["erom", -1, 55], + ["orom", -1, 56], + ["basom", -1, 135], + ["gasom", -1, 131], + ["jasom", -1, 129], + ["kasom", -1, 133], + ["nasom", -1, 132], + ["tasom", -1, 130], + ["vasom", -1, 134], + ["esom", -1, 57], + ["isom", -1, 58], + ["osom", -1, 123], + ["atom", -1, 120], + ["ikatom", 1456, 68], + ["latom", 1456, 69], + ["etom", -1, 70], + ["evitom", -1, 92], + ["ovitom", -1, 93], + ["astom", -1, 94], + ["estom", -1, 71], + ["istom", -1, 72], + ["kstom", -1, 73], + ["ostom", -1, 74], + ["avom", -1, 77], + ["evom", -1, 78], + ["ivom", -1, 79], + ["ovom", -1, 80], + ["lovom", 1470, 82], + ["movom", 1470, 81], + ["stvom", -1, 3], + ["\u0161tvom", -1, 4], + ["a\u0107om", -1, 14], + ["e\u0107om", -1, 15], + ["u\u0107om", -1, 16], + ["ba\u0161om", -1, 63], + ["ga\u0161om", -1, 64], + ["ja\u0161om", -1, 61], + ["ka\u0161om", -1, 62], + ["na\u0161om", -1, 60], + ["ta\u0161om", -1, 59], + ["va\u0161om", -1, 65], + ["e\u0161om", -1, 66], + ["i\u0161om", -1, 67], + ["o\u0161om", -1, 91], + ["an", -1, 104], + ["acan", 1488, 128], + ["iran", 1488, 100], + ["uran", 1488, 105], + ["tan", 1488, 113], + ["avan", 1488, 97], + ["evan", 1488, 96], + ["ivan", 1488, 98], + ["uvan", 1488, 99], + ["a\u010Dan", 1488, 102], + ["acen", -1, 124], + ["lucen", -1, 121], + ["a\u010Den", -1, 101], + ["lu\u010Den", -1, 117], + ["anin", -1, 10], + ["ao", -1, 104], + ["acao", 1503, 128], + ["astajao", 1503, 106], + ["istajao", 1503, 107], + ["ostajao", 1503, 108], + ["injao", 1503, 114], + ["irao", 1503, 100], + ["urao", 1503, 105], + ["tao", 1503, 113], + ["astao", 1511, 110], + ["istao", 1511, 111], + ["ostao", 1511, 112], + ["avao", 1503, 97], + ["evao", 1503, 96], + ["ivao", 1503, 98], + ["ovao", 1503, 76], + ["uvao", 1503, 99], + ["a\u010Dao", 1503, 102], + ["go", -1, 20], + ["ugo", 1521, 18], + ["io", -1, 116], + ["acio", 1523, 124], + ["lucio", 1523, 121], + ["lio", 1523, 24], + ["nio", 1523, 103], + ["rario", 1523, 21], + ["sio", 1523, 23], + ["rosio", 1529, 127], + ["jetio", 1523, 118], + ["otio", 1523, 22], + ["a\u010Dio", 1523, 101], + ["lu\u010Dio", 1523, 117], + ["ro\u0161io", 1523, 90], + ["bijo", -1, 32], + ["cijo", -1, 33], + ["dijo", -1, 34], + ["fijo", -1, 40], + ["gijo", -1, 39], + ["lijo", -1, 35], + ["mijo", -1, 37], + ["nijo", -1, 36], + ["pijo", -1, 41], + ["rijo", -1, 42], + ["sijo", -1, 43], + ["tijo", -1, 44], + ["zijo", -1, 45], + ["\u017Eijo", -1, 38], + ["anjo", -1, 84], + ["enjo", -1, 85], + ["snjo", -1, 122], + ["\u0161njo", -1, 86], + ["ko", -1, 95], + ["sko", 1554, 1], + ["\u0161ko", 1554, 2], + ["alo", -1, 104], + ["acalo", 1557, 128], + ["astajalo", 1557, 106], + ["istajalo", 1557, 107], + ["ostajalo", 1557, 108], + ["ijalo", 1557, 47], + ["injalo", 1557, 114], + ["nalo", 1557, 46], + ["iralo", 1557, 100], + ["uralo", 1557, 105], + ["talo", 1557, 113], + ["astalo", 1567, 110], + ["istalo", 1567, 111], + ["ostalo", 1567, 112], + ["avalo", 1557, 97], + ["evalo", 1557, 96], + ["ivalo", 1557, 98], + ["ovalo", 1557, 76], + ["uvalo", 1557, 99], + ["a\u010Dalo", 1557, 102], + ["elo", -1, 83], + ["ilo", -1, 116], + ["acilo", 1578, 124], + ["lucilo", 1578, 121], + ["nilo", 1578, 103], + ["rosilo", 1578, 127], + ["jetilo", 1578, 118], + ["a\u010Dilo", 1578, 101], + ["lu\u010Dilo", 1578, 117], + ["ro\u0161ilo", 1578, 90], + ["aslo", -1, 115], + ["nulo", -1, 13], + ["amo", -1, 104], + ["acamo", 1589, 128], + ["ramo", 1589, 52], + ["iramo", 1591, 100], + ["uramo", 1591, 105], + ["tamo", 1589, 113], + ["avamo", 1589, 97], + ["evamo", 1589, 96], + ["ivamo", 1589, 98], + ["uvamo", 1589, 99], + ["a\u010Damo", 1589, 102], + ["emo", -1, 119], + ["astademo", 1600, 110], + ["istademo", 1600, 111], + ["ostademo", 1600, 112], + ["astajemo", 1600, 106], + ["istajemo", 1600, 107], + ["ostajemo", 1600, 108], + ["ijemo", 1600, 116], + ["injemo", 1600, 114], + ["ujemo", 1600, 25], + ["lucujemo", 1609, 121], + ["irujemo", 1609, 100], + ["lu\u010Dujemo", 1609, 117], + ["lemo", 1600, 51], + ["nemo", 1600, 13], + ["astanemo", 1614, 110], + ["istanemo", 1614, 111], + ["ostanemo", 1614, 112], + ["etemo", 1600, 70], + ["astemo", 1600, 115], + ["imo", -1, 116], + ["acimo", 1620, 124], + ["lucimo", 1620, 121], + ["nimo", 1620, 13], + ["astanimo", 1623, 110], + ["istanimo", 1623, 111], + ["ostanimo", 1623, 112], + ["rosimo", 1620, 127], + ["etimo", 1620, 70], + ["jetimo", 1628, 118], + ["astimo", 1620, 115], + ["a\u010Dimo", 1620, 101], + ["lu\u010Dimo", 1620, 117], + ["ro\u0161imo", 1620, 90], + ["ajmo", -1, 104], + ["urajmo", 1634, 105], + ["tajmo", 1634, 113], + ["astajmo", 1636, 106], + ["istajmo", 1636, 107], + ["ostajmo", 1636, 108], + ["avajmo", 1634, 97], + ["evajmo", 1634, 96], + ["ivajmo", 1634, 98], + ["uvajmo", 1634, 99], + ["ijmo", -1, 116], + ["ujmo", -1, 25], + ["lucujmo", 1645, 121], + ["irujmo", 1645, 100], + ["lu\u010Dujmo", 1645, 117], + ["asmo", -1, 104], + ["acasmo", 1649, 128], + ["astajasmo", 1649, 106], + ["istajasmo", 1649, 107], + ["ostajasmo", 1649, 108], + ["injasmo", 1649, 114], + ["irasmo", 1649, 100], + ["urasmo", 1649, 105], + ["tasmo", 1649, 113], + ["avasmo", 1649, 97], + ["evasmo", 1649, 96], + ["ivasmo", 1649, 98], + ["ovasmo", 1649, 76], + ["uvasmo", 1649, 99], + ["a\u010Dasmo", 1649, 102], + ["ismo", -1, 116], + ["acismo", 1664, 124], + ["lucismo", 1664, 121], + ["nismo", 1664, 103], + ["rosismo", 1664, 127], + ["jetismo", 1664, 118], + ["a\u010Dismo", 1664, 101], + ["lu\u010Dismo", 1664, 117], + ["ro\u0161ismo", 1664, 90], + ["astadosmo", -1, 110], + ["istadosmo", -1, 111], + ["ostadosmo", -1, 112], + ["nusmo", -1, 13], + ["no", -1, 13], + ["ano", 1677, 104], + ["acano", 1678, 128], + ["urano", 1678, 105], + ["tano", 1678, 113], + ["avano", 1678, 97], + ["evano", 1678, 96], + ["ivano", 1678, 98], + ["uvano", 1678, 99], + ["a\u010Dano", 1678, 102], + ["aceno", 1677, 124], + ["luceno", 1677, 121], + ["a\u010Deno", 1677, 101], + ["lu\u010Deno", 1677, 117], + ["ino", 1677, 11], + ["cino", 1691, 137], + ["\u010Dino", 1691, 89], + ["ato", -1, 120], + ["ikato", 1694, 68], + ["lato", 1694, 69], + ["eto", -1, 70], + ["evito", -1, 92], + ["ovito", -1, 93], + ["asto", -1, 94], + ["esto", -1, 71], + ["isto", -1, 72], + ["ksto", -1, 73], + ["osto", -1, 74], + ["nuto", -1, 13], + ["nuo", -1, 13], + ["avo", -1, 77], + ["evo", -1, 78], + ["ivo", -1, 79], + ["ovo", -1, 80], + ["stvo", -1, 3], + ["\u0161tvo", -1, 4], + ["as", -1, 161], + ["acas", 1713, 128], + ["iras", 1713, 155], + ["uras", 1713, 156], + ["tas", 1713, 160], + ["avas", 1713, 144], + ["evas", 1713, 145], + ["ivas", 1713, 146], + ["uvas", 1713, 147], + ["es", -1, 163], + ["astades", 1722, 141], + ["istades", 1722, 142], + ["ostades", 1722, 143], + ["astajes", 1722, 138], + ["istajes", 1722, 139], + ["ostajes", 1722, 140], + ["ijes", 1722, 162], + ["injes", 1722, 150], + ["ujes", 1722, 157], + ["lucujes", 1731, 121], + ["irujes", 1731, 155], + ["nes", 1722, 164], + ["astanes", 1734, 141], + ["istanes", 1734, 142], + ["ostanes", 1734, 143], + ["etes", 1722, 153], + ["astes", 1722, 136], + ["is", -1, 162], + ["acis", 1740, 124], + ["lucis", 1740, 121], + ["nis", 1740, 158], + ["rosis", 1740, 127], + ["jetis", 1740, 149], + ["at", -1, 104], + ["acat", 1746, 128], + ["astajat", 1746, 106], + ["istajat", 1746, 107], + ["ostajat", 1746, 108], + ["injat", 1746, 114], + ["irat", 1746, 100], + ["urat", 1746, 105], + ["tat", 1746, 113], + ["astat", 1754, 110], + ["istat", 1754, 111], + ["ostat", 1754, 112], + ["avat", 1746, 97], + ["evat", 1746, 96], + ["ivat", 1746, 98], + ["irivat", 1760, 100], + ["ovat", 1746, 76], + ["uvat", 1746, 99], + ["a\u010Dat", 1746, 102], + ["it", -1, 116], + ["acit", 1765, 124], + ["lucit", 1765, 121], + ["rosit", 1765, 127], + ["jetit", 1765, 118], + ["a\u010Dit", 1765, 101], + ["lu\u010Dit", 1765, 117], + ["ro\u0161it", 1765, 90], + ["nut", -1, 13], + ["astadu", -1, 110], + ["istadu", -1, 111], + ["ostadu", -1, 112], + ["gu", -1, 20], + ["logu", 1777, 19], + ["ugu", 1777, 18], + ["ahu", -1, 104], + ["acahu", 1780, 128], + ["astajahu", 1780, 106], + ["istajahu", 1780, 107], + ["ostajahu", 1780, 108], + ["injahu", 1780, 114], + ["irahu", 1780, 100], + ["urahu", 1780, 105], + ["avahu", 1780, 97], + ["evahu", 1780, 96], + ["ivahu", 1780, 98], + ["ovahu", 1780, 76], + ["uvahu", 1780, 99], + ["a\u010Dahu", 1780, 102], + ["aju", -1, 104], + ["caju", 1794, 26], + ["acaju", 1795, 128], + ["laju", 1794, 30], + ["raju", 1794, 31], + ["iraju", 1798, 100], + ["uraju", 1798, 105], + ["taju", 1794, 113], + ["astaju", 1801, 106], + ["istaju", 1801, 107], + ["ostaju", 1801, 108], + ["avaju", 1794, 97], + ["evaju", 1794, 96], + ["ivaju", 1794, 98], + ["uvaju", 1794, 99], + ["\u0107aju", 1794, 28], + ["\u010Daju", 1794, 27], + ["a\u010Daju", 1810, 102], + ["\u0111aju", 1794, 29], + ["iju", -1, 116], + ["biju", 1813, 32], + ["ciju", 1813, 33], + ["diju", 1813, 34], + ["fiju", 1813, 40], + ["giju", 1813, 39], + ["anjiju", 1813, 84], + ["enjiju", 1813, 85], + ["snjiju", 1813, 122], + ["\u0161njiju", 1813, 86], + ["kiju", 1813, 95], + ["liju", 1813, 24], + ["eliju", 1824, 83], + ["miju", 1813, 37], + ["niju", 1813, 13], + ["ganiju", 1827, 9], + ["maniju", 1827, 6], + ["paniju", 1827, 7], + ["raniju", 1827, 8], + ["taniju", 1827, 5], + ["piju", 1813, 41], + ["riju", 1813, 42], + ["rariju", 1834, 21], + ["siju", 1813, 23], + ["osiju", 1836, 123], + ["tiju", 1813, 44], + ["atiju", 1838, 120], + ["otiju", 1838, 22], + ["aviju", 1813, 77], + ["eviju", 1813, 78], + ["iviju", 1813, 79], + ["oviju", 1813, 80], + ["ziju", 1813, 45], + ["o\u0161iju", 1813, 91], + ["\u017Eiju", 1813, 38], + ["anju", -1, 84], + ["enju", -1, 85], + ["snju", -1, 122], + ["\u0161nju", -1, 86], + ["uju", -1, 25], + ["lucuju", 1852, 121], + ["iruju", 1852, 100], + ["lu\u010Duju", 1852, 117], + ["ku", -1, 95], + ["sku", 1856, 1], + ["\u0161ku", 1856, 2], + ["alu", -1, 104], + ["ijalu", 1859, 47], + ["nalu", 1859, 46], + ["elu", -1, 83], + ["ilu", -1, 116], + ["ozilu", 1863, 48], + ["olu", -1, 50], + ["ramu", -1, 52], + ["acemu", -1, 124], + ["ecemu", -1, 125], + ["ucemu", -1, 126], + ["anjijemu", -1, 84], + ["enjijemu", -1, 85], + ["snjijemu", -1, 122], + ["\u0161njijemu", -1, 86], + ["kijemu", -1, 95], + ["skijemu", 1874, 1], + ["\u0161kijemu", 1874, 2], + ["elijemu", -1, 83], + ["nijemu", -1, 13], + ["osijemu", -1, 123], + ["atijemu", -1, 120], + ["evitijemu", -1, 92], + ["ovitijemu", -1, 93], + ["astijemu", -1, 94], + ["avijemu", -1, 77], + ["evijemu", -1, 78], + ["ivijemu", -1, 79], + ["ovijemu", -1, 80], + ["o\u0161ijemu", -1, 91], + ["anjemu", -1, 84], + ["enjemu", -1, 85], + ["snjemu", -1, 122], + ["\u0161njemu", -1, 86], + ["kemu", -1, 95], + ["skemu", 1893, 1], + ["\u0161kemu", 1893, 2], + ["lemu", -1, 51], + ["elemu", 1896, 83], + ["nemu", -1, 13], + ["anemu", 1898, 10], + ["enemu", 1898, 87], + ["snemu", 1898, 159], + ["\u0161nemu", 1898, 88], + ["osemu", -1, 123], + ["atemu", -1, 120], + ["evitemu", -1, 92], + ["ovitemu", -1, 93], + ["astemu", -1, 94], + ["avemu", -1, 77], + ["evemu", -1, 78], + ["ivemu", -1, 79], + ["ovemu", -1, 80], + ["a\u0107emu", -1, 14], + ["e\u0107emu", -1, 15], + ["u\u0107emu", -1, 16], + ["o\u0161emu", -1, 91], + ["acomu", -1, 124], + ["ecomu", -1, 125], + ["ucomu", -1, 126], + ["anjomu", -1, 84], + ["enjomu", -1, 85], + ["snjomu", -1, 122], + ["\u0161njomu", -1, 86], + ["komu", -1, 95], + ["skomu", 1923, 1], + ["\u0161komu", 1923, 2], + ["elomu", -1, 83], + ["nomu", -1, 13], + ["cinomu", 1927, 137], + ["\u010Dinomu", 1927, 89], + ["osomu", -1, 123], + ["atomu", -1, 120], + ["evitomu", -1, 92], + ["ovitomu", -1, 93], + ["astomu", -1, 94], + ["avomu", -1, 77], + ["evomu", -1, 78], + ["ivomu", -1, 79], + ["ovomu", -1, 80], + ["a\u0107omu", -1, 14], + ["e\u0107omu", -1, 15], + ["u\u0107omu", -1, 16], + ["o\u0161omu", -1, 91], + ["nu", -1, 13], + ["anu", 1943, 10], + ["astanu", 1944, 110], + ["istanu", 1944, 111], + ["ostanu", 1944, 112], + ["inu", 1943, 11], + ["cinu", 1948, 137], + ["aninu", 1948, 10], + ["\u010Dinu", 1948, 89], + ["onu", 1943, 12], + ["aru", -1, 53], + ["dru", -1, 54], + ["eru", -1, 55], + ["oru", -1, 56], + ["basu", -1, 135], + ["gasu", -1, 131], + ["jasu", -1, 129], + ["kasu", -1, 133], + ["nasu", -1, 132], + ["tasu", -1, 130], + ["vasu", -1, 134], + ["esu", -1, 57], + ["isu", -1, 58], + ["osu", -1, 123], + ["atu", -1, 120], + ["ikatu", 1967, 68], + ["latu", 1967, 69], + ["etu", -1, 70], + ["evitu", -1, 92], + ["ovitu", -1, 93], + ["astu", -1, 94], + ["estu", -1, 71], + ["istu", -1, 72], + ["kstu", -1, 73], + ["ostu", -1, 74], + ["i\u0161tu", -1, 75], + ["avu", -1, 77], + ["evu", -1, 78], + ["ivu", -1, 79], + ["ovu", -1, 80], + ["lovu", 1982, 82], + ["movu", 1982, 81], + ["stvu", -1, 3], + ["\u0161tvu", -1, 4], + ["ba\u0161u", -1, 63], + ["ga\u0161u", -1, 64], + ["ja\u0161u", -1, 61], + ["ka\u0161u", -1, 62], + ["na\u0161u", -1, 60], + ["ta\u0161u", -1, 59], + ["va\u0161u", -1, 65], + ["e\u0161u", -1, 66], + ["i\u0161u", -1, 67], + ["o\u0161u", -1, 91], + ["avav", -1, 97], + ["evav", -1, 96], + ["ivav", -1, 98], + ["uvav", -1, 99], + ["kov", -1, 95], + ["a\u0161", -1, 104], + ["ira\u0161", 2002, 100], + ["ura\u0161", 2002, 105], + ["ta\u0161", 2002, 113], + ["ava\u0161", 2002, 97], + ["eva\u0161", 2002, 96], + ["iva\u0161", 2002, 98], + ["uva\u0161", 2002, 99], + ["a\u010Da\u0161", 2002, 102], + ["e\u0161", -1, 119], + ["astade\u0161", 2011, 110], + ["istade\u0161", 2011, 111], + ["ostade\u0161", 2011, 112], + ["astaje\u0161", 2011, 106], + ["istaje\u0161", 2011, 107], + ["ostaje\u0161", 2011, 108], + ["ije\u0161", 2011, 116], + ["inje\u0161", 2011, 114], + ["uje\u0161", 2011, 25], + ["iruje\u0161", 2020, 100], + ["lu\u010Duje\u0161", 2020, 117], + ["ne\u0161", 2011, 13], + ["astane\u0161", 2023, 110], + ["istane\u0161", 2023, 111], + ["ostane\u0161", 2023, 112], + ["ete\u0161", 2011, 70], + ["aste\u0161", 2011, 115], + ["i\u0161", -1, 116], + ["ni\u0161", 2029, 103], + ["jeti\u0161", 2029, 118], + ["a\u010Di\u0161", 2029, 101], + ["lu\u010Di\u0161", 2029, 117], + ["ro\u0161i\u0161", 2029, 90] + ]; + + /** @const */ var a_3 = [ + ["a", -1, 1], + ["oga", 0, 1], + ["ama", 0, 1], + ["ima", 0, 1], + ["ena", 0, 1], + ["e", -1, 1], + ["og", -1, 1], + ["anog", 6, 1], + ["enog", 6, 1], + ["anih", -1, 1], + ["enih", -1, 1], + ["i", -1, 1], + ["ani", 11, 1], + ["eni", 11, 1], + ["anoj", -1, 1], + ["enoj", -1, 1], + ["anim", -1, 1], + ["enim", -1, 1], + ["om", -1, 1], + ["enom", 18, 1], + ["o", -1, 1], + ["ano", 20, 1], + ["eno", 20, 1], + ["ost", -1, 1], + ["u", -1, 1], + ["enu", 24, 1] + ]; + + /** @const */ var /** Array */ g_v = [17, 65, 16]; + + /** @const */ var /** Array */ g_sa = [65, 4, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4, 0, 0, 128]; + + /** @const */ var /** Array */ g_ca = [119, 95, 23, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 32, 136, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 0, 0, 0, 16]; + + /** @const */ var /** Array */ g_rg = [1]; + + var /** number */ I_p1 = 0; + var /** boolean */ B_no_diacritics = false; + + + /** @return {boolean} */ + function r_cyr_to_lat() { + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + while(true) + { + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + golab2: while(true) + { + /** @const */ var /** number */ v_3 = base.cursor; + lab3: { + base.bra = base.cursor; + among_var = base.find_among(a_0); + if (among_var == 0) + { + break lab3; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("a")) + { + return false; + } + break; + case 2: + if (!base.slice_from("b")) + { + return false; + } + break; + case 3: + if (!base.slice_from("v")) + { + return false; + } + break; + case 4: + if (!base.slice_from("g")) + { + return false; + } + break; + case 5: + if (!base.slice_from("d")) + { + return false; + } + break; + case 6: + if (!base.slice_from("\u0111")) + { + return false; + } + break; + case 7: + if (!base.slice_from("e")) + { + return false; + } + break; + case 8: + if (!base.slice_from("\u017E")) + { + return false; + } + break; + case 9: + if (!base.slice_from("z")) + { + return false; + } + break; + case 10: + if (!base.slice_from("i")) + { + return false; + } + break; + case 11: + if (!base.slice_from("j")) + { + return false; + } + break; + case 12: + if (!base.slice_from("k")) + { + return false; + } + break; + case 13: + if (!base.slice_from("l")) + { + return false; + } + break; + case 14: + if (!base.slice_from("lj")) + { + return false; + } + break; + case 15: + if (!base.slice_from("m")) + { + return false; + } + break; + case 16: + if (!base.slice_from("n")) + { + return false; + } + break; + case 17: + if (!base.slice_from("nj")) + { + return false; + } + break; + case 18: + if (!base.slice_from("o")) + { + return false; + } + break; + case 19: + if (!base.slice_from("p")) + { + return false; + } + break; + case 20: + if (!base.slice_from("r")) + { + return false; + } + break; + case 21: + if (!base.slice_from("s")) + { + return false; + } + break; + case 22: + if (!base.slice_from("t")) + { + return false; + } + break; + case 23: + if (!base.slice_from("\u0107")) + { + return false; + } + break; + case 24: + if (!base.slice_from("u")) + { + return false; + } + break; + case 25: + if (!base.slice_from("f")) + { + return false; + } + break; + case 26: + if (!base.slice_from("h")) + { + return false; + } + break; + case 27: + if (!base.slice_from("c")) + { + return false; + } + break; + case 28: + if (!base.slice_from("\u010D")) + { + return false; + } + break; + case 29: + if (!base.slice_from("d\u017E")) + { + return false; + } + break; + case 30: + if (!base.slice_from("\u0161")) + { + return false; + } + break; + } + base.cursor = v_3; + break golab2; + } + base.cursor = v_3; + if (base.cursor >= base.limit) + { + break lab1; + } + base.cursor++; + } + continue; + } + base.cursor = v_2; + break; + } + } + base.cursor = v_1; + return true; + }; + + /** @return {boolean} */ + function r_prelude() { + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + while(true) + { + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + golab2: while(true) + { + /** @const */ var /** number */ v_3 = base.cursor; + lab3: { + if (!(base.in_grouping(g_ca, 98, 382))) + { + break lab3; + } + base.bra = base.cursor; + if (!(base.eq_s("ije"))) + { + break lab3; + } + base.ket = base.cursor; + if (!(base.in_grouping(g_ca, 98, 382))) + { + break lab3; + } + if (!base.slice_from("e")) + { + return false; + } + base.cursor = v_3; + break golab2; + } + base.cursor = v_3; + if (base.cursor >= base.limit) + { + break lab1; + } + base.cursor++; + } + continue; + } + base.cursor = v_2; + break; + } + } + base.cursor = v_1; + /** @const */ var /** number */ v_4 = base.cursor; + lab4: { + while(true) + { + /** @const */ var /** number */ v_5 = base.cursor; + lab5: { + golab6: while(true) + { + /** @const */ var /** number */ v_6 = base.cursor; + lab7: { + if (!(base.in_grouping(g_ca, 98, 382))) + { + break lab7; + } + base.bra = base.cursor; + if (!(base.eq_s("je"))) + { + break lab7; + } + base.ket = base.cursor; + if (!(base.in_grouping(g_ca, 98, 382))) + { + break lab7; + } + if (!base.slice_from("e")) + { + return false; + } + base.cursor = v_6; + break golab6; + } + base.cursor = v_6; + if (base.cursor >= base.limit) + { + break lab5; + } + base.cursor++; + } + continue; + } + base.cursor = v_5; + break; + } + } + base.cursor = v_4; + /** @const */ var /** number */ v_7 = base.cursor; + lab8: { + while(true) + { + /** @const */ var /** number */ v_8 = base.cursor; + lab9: { + golab10: while(true) + { + /** @const */ var /** number */ v_9 = base.cursor; + lab11: { + base.bra = base.cursor; + if (!(base.eq_s("dj"))) + { + break lab11; + } + base.ket = base.cursor; + if (!base.slice_from("\u0111")) + { + return false; + } + base.cursor = v_9; + break golab10; + } + base.cursor = v_9; + if (base.cursor >= base.limit) + { + break lab9; + } + base.cursor++; + } + continue; + } + base.cursor = v_8; + break; + } + } + base.cursor = v_7; + return true; + }; + + /** @return {boolean} */ + function r_mark_regions() { + B_no_diacritics = true; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + if (!base.go_out_grouping(g_sa, 263, 382)) + { + break lab0; + } + base.cursor++; + B_no_diacritics = false; + } + base.cursor = v_1; + I_p1 = base.limit; + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + if (!base.go_out_grouping(g_v, 97, 117)) + { + break lab1; + } + base.cursor++; + I_p1 = base.cursor; + if (I_p1 >= 2) + { + break lab1; + } + if (!base.go_in_grouping(g_v, 97, 117)) + { + break lab1; + } + base.cursor++; + I_p1 = base.cursor; + } + base.cursor = v_2; + /** @const */ var /** number */ v_3 = base.cursor; + lab2: { + golab3: while(true) + { + lab4: { + if (!(base.eq_s("r"))) + { + break lab4; + } + break golab3; + } + if (base.cursor >= base.limit) + { + break lab2; + } + base.cursor++; + } + lab5: { + /** @const */ var /** number */ v_4 = base.cursor; + lab6: { + if (base.cursor < 2) + { + break lab6; + } + break lab5; + } + base.cursor = v_4; + if (!base.go_in_grouping(g_rg, 114, 114)) + { + break lab2; + } + base.cursor++; + } + if ((I_p1 - base.cursor) <= 1) + { + break lab2; + } + I_p1 = base.cursor; + } + base.cursor = v_3; + return true; + }; + + /** @return {boolean} */ + function r_R1() { + return I_p1 <= base.cursor; + }; + + /** @return {boolean} */ + function r_Step_1() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_1); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("loga")) + { + return false; + } + break; + case 2: + if (!base.slice_from("peh")) + { + return false; + } + break; + case 3: + if (!base.slice_from("vojka")) + { + return false; + } + break; + case 4: + if (!base.slice_from("bojka")) + { + return false; + } + break; + case 5: + if (!base.slice_from("jak")) + { + return false; + } + break; + case 6: + if (!base.slice_from("\u010Dajni")) + { + return false; + } + break; + case 7: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("cajni")) + { + return false; + } + break; + case 8: + if (!base.slice_from("erni")) + { + return false; + } + break; + case 9: + if (!base.slice_from("larni")) + { + return false; + } + break; + case 10: + if (!base.slice_from("esni")) + { + return false; + } + break; + case 11: + if (!base.slice_from("anjca")) + { + return false; + } + break; + case 12: + if (!base.slice_from("ajca")) + { + return false; + } + break; + case 13: + if (!base.slice_from("ljca")) + { + return false; + } + break; + case 14: + if (!base.slice_from("ejca")) + { + return false; + } + break; + case 15: + if (!base.slice_from("ojca")) + { + return false; + } + break; + case 16: + if (!base.slice_from("ajka")) + { + return false; + } + break; + case 17: + if (!base.slice_from("ojka")) + { + return false; + } + break; + case 18: + if (!base.slice_from("\u0161ca")) + { + return false; + } + break; + case 19: + if (!base.slice_from("ing")) + { + return false; + } + break; + case 20: + if (!base.slice_from("tvenik")) + { + return false; + } + break; + case 21: + if (!base.slice_from("tetika")) + { + return false; + } + break; + case 22: + if (!base.slice_from("nstva")) + { + return false; + } + break; + case 23: + if (!base.slice_from("nik")) + { + return false; + } + break; + case 24: + if (!base.slice_from("tik")) + { + return false; + } + break; + case 25: + if (!base.slice_from("zik")) + { + return false; + } + break; + case 26: + if (!base.slice_from("snik")) + { + return false; + } + break; + case 27: + if (!base.slice_from("kusi")) + { + return false; + } + break; + case 28: + if (!base.slice_from("kusni")) + { + return false; + } + break; + case 29: + if (!base.slice_from("kustva")) + { + return false; + } + break; + case 30: + if (!base.slice_from("du\u0161ni")) + { + return false; + } + break; + case 31: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("dusni")) + { + return false; + } + break; + case 32: + if (!base.slice_from("antni")) + { + return false; + } + break; + case 33: + if (!base.slice_from("bilni")) + { + return false; + } + break; + case 34: + if (!base.slice_from("tilni")) + { + return false; + } + break; + case 35: + if (!base.slice_from("avilni")) + { + return false; + } + break; + case 36: + if (!base.slice_from("silni")) + { + return false; + } + break; + case 37: + if (!base.slice_from("gilni")) + { + return false; + } + break; + case 38: + if (!base.slice_from("rilni")) + { + return false; + } + break; + case 39: + if (!base.slice_from("nilni")) + { + return false; + } + break; + case 40: + if (!base.slice_from("alni")) + { + return false; + } + break; + case 41: + if (!base.slice_from("ozni")) + { + return false; + } + break; + case 42: + if (!base.slice_from("ravi")) + { + return false; + } + break; + case 43: + if (!base.slice_from("stavni")) + { + return false; + } + break; + case 44: + if (!base.slice_from("pravni")) + { + return false; + } + break; + case 45: + if (!base.slice_from("tivni")) + { + return false; + } + break; + case 46: + if (!base.slice_from("sivni")) + { + return false; + } + break; + case 47: + if (!base.slice_from("atni")) + { + return false; + } + break; + case 48: + if (!base.slice_from("enta")) + { + return false; + } + break; + case 49: + if (!base.slice_from("tetni")) + { + return false; + } + break; + case 50: + if (!base.slice_from("pletni")) + { + return false; + } + break; + case 51: + if (!base.slice_from("\u0161avi")) + { + return false; + } + break; + case 52: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("savi")) + { + return false; + } + break; + case 53: + if (!base.slice_from("anta")) + { + return false; + } + break; + case 54: + if (!base.slice_from("a\u010Dka")) + { + return false; + } + break; + case 55: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("acka")) + { + return false; + } + break; + case 56: + if (!base.slice_from("u\u0161ka")) + { + return false; + } + break; + case 57: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("uska")) + { + return false; + } + break; + case 58: + if (!base.slice_from("atka")) + { + return false; + } + break; + case 59: + if (!base.slice_from("etka")) + { + return false; + } + break; + case 60: + if (!base.slice_from("itka")) + { + return false; + } + break; + case 61: + if (!base.slice_from("otka")) + { + return false; + } + break; + case 62: + if (!base.slice_from("utka")) + { + return false; + } + break; + case 63: + if (!base.slice_from("eskna")) + { + return false; + } + break; + case 64: + if (!base.slice_from("ti\u010Dni")) + { + return false; + } + break; + case 65: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ticni")) + { + return false; + } + break; + case 66: + if (!base.slice_from("ojska")) + { + return false; + } + break; + case 67: + if (!base.slice_from("esma")) + { + return false; + } + break; + case 68: + if (!base.slice_from("metra")) + { + return false; + } + break; + case 69: + if (!base.slice_from("centra")) + { + return false; + } + break; + case 70: + if (!base.slice_from("istra")) + { + return false; + } + break; + case 71: + if (!base.slice_from("osti")) + { + return false; + } + break; + case 72: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("osti")) + { + return false; + } + break; + case 73: + if (!base.slice_from("dba")) + { + return false; + } + break; + case 74: + if (!base.slice_from("\u010Dka")) + { + return false; + } + break; + case 75: + if (!base.slice_from("mca")) + { + return false; + } + break; + case 76: + if (!base.slice_from("nca")) + { + return false; + } + break; + case 77: + if (!base.slice_from("voljni")) + { + return false; + } + break; + case 78: + if (!base.slice_from("anki")) + { + return false; + } + break; + case 79: + if (!base.slice_from("vca")) + { + return false; + } + break; + case 80: + if (!base.slice_from("sca")) + { + return false; + } + break; + case 81: + if (!base.slice_from("rca")) + { + return false; + } + break; + case 82: + if (!base.slice_from("alca")) + { + return false; + } + break; + case 83: + if (!base.slice_from("elca")) + { + return false; + } + break; + case 84: + if (!base.slice_from("olca")) + { + return false; + } + break; + case 85: + if (!base.slice_from("njca")) + { + return false; + } + break; + case 86: + if (!base.slice_from("ekta")) + { + return false; + } + break; + case 87: + if (!base.slice_from("izma")) + { + return false; + } + break; + case 88: + if (!base.slice_from("jebi")) + { + return false; + } + break; + case 89: + if (!base.slice_from("baci")) + { + return false; + } + break; + case 90: + if (!base.slice_from("a\u0161ni")) + { + return false; + } + break; + case 91: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("asni")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Step_2() { + var /** number */ among_var; + base.ket = base.cursor; + among_var = base.find_among_b(a_2); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + if (!r_R1()) + { + return false; + } + switch (among_var) { + case 1: + if (!base.slice_from("sk")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u0161k")) + { + return false; + } + break; + case 3: + if (!base.slice_from("stv")) + { + return false; + } + break; + case 4: + if (!base.slice_from("\u0161tv")) + { + return false; + } + break; + case 5: + if (!base.slice_from("tanij")) + { + return false; + } + break; + case 6: + if (!base.slice_from("manij")) + { + return false; + } + break; + case 7: + if (!base.slice_from("panij")) + { + return false; + } + break; + case 8: + if (!base.slice_from("ranij")) + { + return false; + } + break; + case 9: + if (!base.slice_from("ganij")) + { + return false; + } + break; + case 10: + if (!base.slice_from("an")) + { + return false; + } + break; + case 11: + if (!base.slice_from("in")) + { + return false; + } + break; + case 12: + if (!base.slice_from("on")) + { + return false; + } + break; + case 13: + if (!base.slice_from("n")) + { + return false; + } + break; + case 14: + if (!base.slice_from("a\u0107")) + { + return false; + } + break; + case 15: + if (!base.slice_from("e\u0107")) + { + return false; + } + break; + case 16: + if (!base.slice_from("u\u0107")) + { + return false; + } + break; + case 17: + if (!base.slice_from("ugov")) + { + return false; + } + break; + case 18: + if (!base.slice_from("ug")) + { + return false; + } + break; + case 19: + if (!base.slice_from("log")) + { + return false; + } + break; + case 20: + if (!base.slice_from("g")) + { + return false; + } + break; + case 21: + if (!base.slice_from("rari")) + { + return false; + } + break; + case 22: + if (!base.slice_from("oti")) + { + return false; + } + break; + case 23: + if (!base.slice_from("si")) + { + return false; + } + break; + case 24: + if (!base.slice_from("li")) + { + return false; + } + break; + case 25: + if (!base.slice_from("uj")) + { + return false; + } + break; + case 26: + if (!base.slice_from("caj")) + { + return false; + } + break; + case 27: + if (!base.slice_from("\u010Daj")) + { + return false; + } + break; + case 28: + if (!base.slice_from("\u0107aj")) + { + return false; + } + break; + case 29: + if (!base.slice_from("\u0111aj")) + { + return false; + } + break; + case 30: + if (!base.slice_from("laj")) + { + return false; + } + break; + case 31: + if (!base.slice_from("raj")) + { + return false; + } + break; + case 32: + if (!base.slice_from("bij")) + { + return false; + } + break; + case 33: + if (!base.slice_from("cij")) + { + return false; + } + break; + case 34: + if (!base.slice_from("dij")) + { + return false; + } + break; + case 35: + if (!base.slice_from("lij")) + { + return false; + } + break; + case 36: + if (!base.slice_from("nij")) + { + return false; + } + break; + case 37: + if (!base.slice_from("mij")) + { + return false; + } + break; + case 38: + if (!base.slice_from("\u017Eij")) + { + return false; + } + break; + case 39: + if (!base.slice_from("gij")) + { + return false; + } + break; + case 40: + if (!base.slice_from("fij")) + { + return false; + } + break; + case 41: + if (!base.slice_from("pij")) + { + return false; + } + break; + case 42: + if (!base.slice_from("rij")) + { + return false; + } + break; + case 43: + if (!base.slice_from("sij")) + { + return false; + } + break; + case 44: + if (!base.slice_from("tij")) + { + return false; + } + break; + case 45: + if (!base.slice_from("zij")) + { + return false; + } + break; + case 46: + if (!base.slice_from("nal")) + { + return false; + } + break; + case 47: + if (!base.slice_from("ijal")) + { + return false; + } + break; + case 48: + if (!base.slice_from("ozil")) + { + return false; + } + break; + case 49: + if (!base.slice_from("olov")) + { + return false; + } + break; + case 50: + if (!base.slice_from("ol")) + { + return false; + } + break; + case 51: + if (!base.slice_from("lem")) + { + return false; + } + break; + case 52: + if (!base.slice_from("ram")) + { + return false; + } + break; + case 53: + if (!base.slice_from("ar")) + { + return false; + } + break; + case 54: + if (!base.slice_from("dr")) + { + return false; + } + break; + case 55: + if (!base.slice_from("er")) + { + return false; + } + break; + case 56: + if (!base.slice_from("or")) + { + return false; + } + break; + case 57: + if (!base.slice_from("es")) + { + return false; + } + break; + case 58: + if (!base.slice_from("is")) + { + return false; + } + break; + case 59: + if (!base.slice_from("ta\u0161")) + { + return false; + } + break; + case 60: + if (!base.slice_from("na\u0161")) + { + return false; + } + break; + case 61: + if (!base.slice_from("ja\u0161")) + { + return false; + } + break; + case 62: + if (!base.slice_from("ka\u0161")) + { + return false; + } + break; + case 63: + if (!base.slice_from("ba\u0161")) + { + return false; + } + break; + case 64: + if (!base.slice_from("ga\u0161")) + { + return false; + } + break; + case 65: + if (!base.slice_from("va\u0161")) + { + return false; + } + break; + case 66: + if (!base.slice_from("e\u0161")) + { + return false; + } + break; + case 67: + if (!base.slice_from("i\u0161")) + { + return false; + } + break; + case 68: + if (!base.slice_from("ikat")) + { + return false; + } + break; + case 69: + if (!base.slice_from("lat")) + { + return false; + } + break; + case 70: + if (!base.slice_from("et")) + { + return false; + } + break; + case 71: + if (!base.slice_from("est")) + { + return false; + } + break; + case 72: + if (!base.slice_from("ist")) + { + return false; + } + break; + case 73: + if (!base.slice_from("kst")) + { + return false; + } + break; + case 74: + if (!base.slice_from("ost")) + { + return false; + } + break; + case 75: + if (!base.slice_from("i\u0161t")) + { + return false; + } + break; + case 76: + if (!base.slice_from("ova")) + { + return false; + } + break; + case 77: + if (!base.slice_from("av")) + { + return false; + } + break; + case 78: + if (!base.slice_from("ev")) + { + return false; + } + break; + case 79: + if (!base.slice_from("iv")) + { + return false; + } + break; + case 80: + if (!base.slice_from("ov")) + { + return false; + } + break; + case 81: + if (!base.slice_from("mov")) + { + return false; + } + break; + case 82: + if (!base.slice_from("lov")) + { + return false; + } + break; + case 83: + if (!base.slice_from("el")) + { + return false; + } + break; + case 84: + if (!base.slice_from("anj")) + { + return false; + } + break; + case 85: + if (!base.slice_from("enj")) + { + return false; + } + break; + case 86: + if (!base.slice_from("\u0161nj")) + { + return false; + } + break; + case 87: + if (!base.slice_from("en")) + { + return false; + } + break; + case 88: + if (!base.slice_from("\u0161n")) + { + return false; + } + break; + case 89: + if (!base.slice_from("\u010Din")) + { + return false; + } + break; + case 90: + if (!base.slice_from("ro\u0161i")) + { + return false; + } + break; + case 91: + if (!base.slice_from("o\u0161")) + { + return false; + } + break; + case 92: + if (!base.slice_from("evit")) + { + return false; + } + break; + case 93: + if (!base.slice_from("ovit")) + { + return false; + } + break; + case 94: + if (!base.slice_from("ast")) + { + return false; + } + break; + case 95: + if (!base.slice_from("k")) + { + return false; + } + break; + case 96: + if (!base.slice_from("eva")) + { + return false; + } + break; + case 97: + if (!base.slice_from("ava")) + { + return false; + } + break; + case 98: + if (!base.slice_from("iva")) + { + return false; + } + break; + case 99: + if (!base.slice_from("uva")) + { + return false; + } + break; + case 100: + if (!base.slice_from("ir")) + { + return false; + } + break; + case 101: + if (!base.slice_from("a\u010D")) + { + return false; + } + break; + case 102: + if (!base.slice_from("a\u010Da")) + { + return false; + } + break; + case 103: + if (!base.slice_from("ni")) + { + return false; + } + break; + case 104: + if (!base.slice_from("a")) + { + return false; + } + break; + case 105: + if (!base.slice_from("ur")) + { + return false; + } + break; + case 106: + if (!base.slice_from("astaj")) + { + return false; + } + break; + case 107: + if (!base.slice_from("istaj")) + { + return false; + } + break; + case 108: + if (!base.slice_from("ostaj")) + { + return false; + } + break; + case 109: + if (!base.slice_from("aj")) + { + return false; + } + break; + case 110: + if (!base.slice_from("asta")) + { + return false; + } + break; + case 111: + if (!base.slice_from("ista")) + { + return false; + } + break; + case 112: + if (!base.slice_from("osta")) + { + return false; + } + break; + case 113: + if (!base.slice_from("ta")) + { + return false; + } + break; + case 114: + if (!base.slice_from("inj")) + { + return false; + } + break; + case 115: + if (!base.slice_from("as")) + { + return false; + } + break; + case 116: + if (!base.slice_from("i")) + { + return false; + } + break; + case 117: + if (!base.slice_from("lu\u010D")) + { + return false; + } + break; + case 118: + if (!base.slice_from("jeti")) + { + return false; + } + break; + case 119: + if (!base.slice_from("e")) + { + return false; + } + break; + case 120: + if (!base.slice_from("at")) + { + return false; + } + break; + case 121: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("luc")) + { + return false; + } + break; + case 122: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("snj")) + { + return false; + } + break; + case 123: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("os")) + { + return false; + } + break; + case 124: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ac")) + { + return false; + } + break; + case 125: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ec")) + { + return false; + } + break; + case 126: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("uc")) + { + return false; + } + break; + case 127: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("rosi")) + { + return false; + } + break; + case 128: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("aca")) + { + return false; + } + break; + case 129: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("jas")) + { + return false; + } + break; + case 130: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("tas")) + { + return false; + } + break; + case 131: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("gas")) + { + return false; + } + break; + case 132: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("nas")) + { + return false; + } + break; + case 133: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("kas")) + { + return false; + } + break; + case 134: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("vas")) + { + return false; + } + break; + case 135: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("bas")) + { + return false; + } + break; + case 136: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("as")) + { + return false; + } + break; + case 137: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("cin")) + { + return false; + } + break; + case 138: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("astaj")) + { + return false; + } + break; + case 139: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("istaj")) + { + return false; + } + break; + case 140: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ostaj")) + { + return false; + } + break; + case 141: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("asta")) + { + return false; + } + break; + case 142: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ista")) + { + return false; + } + break; + case 143: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("osta")) + { + return false; + } + break; + case 144: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ava")) + { + return false; + } + break; + case 145: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("eva")) + { + return false; + } + break; + case 146: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("iva")) + { + return false; + } + break; + case 147: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("uva")) + { + return false; + } + break; + case 148: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ova")) + { + return false; + } + break; + case 149: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("jeti")) + { + return false; + } + break; + case 150: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("inj")) + { + return false; + } + break; + case 151: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ist")) + { + return false; + } + break; + case 152: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("es")) + { + return false; + } + break; + case 153: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("et")) + { + return false; + } + break; + case 154: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("is")) + { + return false; + } + break; + case 155: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ir")) + { + return false; + } + break; + case 156: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ur")) + { + return false; + } + break; + case 157: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("uj")) + { + return false; + } + break; + case 158: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ni")) + { + return false; + } + break; + case 159: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("sn")) + { + return false; + } + break; + case 160: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("ta")) + { + return false; + } + break; + case 161: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("a")) + { + return false; + } + break; + case 162: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("i")) + { + return false; + } + break; + case 163: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("e")) + { + return false; + } + break; + case 164: + if (!B_no_diacritics) + { + return false; + } + if (!base.slice_from("n")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_Step_3() { + base.ket = base.cursor; + if (base.find_among_b(a_3) == 0) + { + return false; + } + base.bra = base.cursor; + if (!r_R1()) + { + return false; + } + if (!base.slice_from("")) + { + return false; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + r_cyr_to_lat(); + r_prelude(); + r_mark_regions(); + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + r_Step_1(); + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab0: { + lab1: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab2: { + if (!r_Step_2()) + { + break lab2; + } + break lab1; + } + base.cursor = base.limit - v_3; + if (!r_Step_3()) + { + break lab0; + } + } + } + base.cursor = base.limit - v_2; + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/spanish-stemmer.js b/sphinx/search/non-minified-js/spanish-stemmer.js index fffd6160b13..f800db7467d 100644 --- a/sphinx/search/non-minified-js/spanish-stemmer.js +++ b/sphinx/search/non-minified-js/spanish-stemmer.js @@ -1,8 +1,9 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from spanish.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -SpanishStemmer = function() { +var SpanishStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ ["", -1, 6], ["\u00E1", 0, 1], @@ -77,6 +78,8 @@ SpanishStemmer = function() { ["ante", -1, 2], ["mente", -1, 7], ["amente", 13, 6], + ["acion", -1, 2], + ["ucion", -1, 4], ["aci\u00F3n", -1, 2], ["uci\u00F3n", -1, 4], ["ico", -1, 1], @@ -247,37 +250,27 @@ SpanishStemmer = function() { I_pV = base.limit; I_p1 = base.limit; I_p2 = base.limit; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { lab1: { - var /** number */ v_2 = base.cursor; + /** @const */ var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 252))) { break lab2; } lab3: { - var /** number */ v_3 = base.cursor; + /** @const */ var /** number */ v_3 = base.cursor; lab4: { if (!(base.out_grouping(g_v, 97, 252))) { break lab4; } - golab5: while(true) + if (!base.go_out_grouping(g_v, 97, 252)) { - lab6: { - if (!(base.in_grouping(g_v, 97, 252))) - { - break lab6; - } - break golab5; - } - if (base.cursor >= base.limit) - { - break lab4; - } - base.cursor++; + break lab4; } + base.cursor++; break lab3; } base.cursor = v_3; @@ -285,21 +278,11 @@ SpanishStemmer = function() { { break lab2; } - golab7: while(true) + if (!base.go_in_grouping(g_v, 97, 252)) { - lab8: { - if (!(base.out_grouping(g_v, 97, 252))) - { - break lab8; - } - break golab7; - } - if (base.cursor >= base.limit) - { - break lab2; - } - base.cursor++; + break lab2; } + base.cursor++; } break lab1; } @@ -308,31 +291,21 @@ SpanishStemmer = function() { { break lab0; } - lab9: { - var /** number */ v_6 = base.cursor; - lab10: { + lab5: { + /** @const */ var /** number */ v_4 = base.cursor; + lab6: { if (!(base.out_grouping(g_v, 97, 252))) { - break lab10; + break lab6; } - golab11: while(true) + if (!base.go_out_grouping(g_v, 97, 252)) { - lab12: { - if (!(base.in_grouping(g_v, 97, 252))) - { - break lab12; - } - break golab11; - } - if (base.cursor >= base.limit) - { - break lab10; - } - base.cursor++; + break lab6; } - break lab9; + base.cursor++; + break lab5; } - base.cursor = v_6; + base.cursor = v_4; if (!(base.in_grouping(g_v, 97, 252))) { break lab0; @@ -347,72 +320,32 @@ SpanishStemmer = function() { I_pV = base.cursor; } base.cursor = v_1; - var /** number */ v_8 = base.cursor; - lab13: { - golab14: while(true) + /** @const */ var /** number */ v_5 = base.cursor; + lab7: { + if (!base.go_out_grouping(g_v, 97, 252)) { - lab15: { - if (!(base.in_grouping(g_v, 97, 252))) - { - break lab15; - } - break golab14; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } - golab16: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 252)) { - lab17: { - if (!(base.out_grouping(g_v, 97, 252))) - { - break lab17; - } - break golab16; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } + base.cursor++; I_p1 = base.cursor; - golab18: while(true) + if (!base.go_out_grouping(g_v, 97, 252)) { - lab19: { - if (!(base.in_grouping(g_v, 97, 252))) - { - break lab19; - } - break golab18; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } - golab20: while(true) + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 252)) { - lab21: { - if (!(base.out_grouping(g_v, 97, 252))) - { - break lab21; - } - break golab20; - } - if (base.cursor >= base.limit) - { - break lab13; - } - base.cursor++; + break lab7; } + base.cursor++; I_p2 = base.cursor; } - base.cursor = v_8; + base.cursor = v_5; return true; }; @@ -421,14 +354,10 @@ SpanishStemmer = function() { var /** number */ among_var; while(true) { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_0); - if (among_var == 0) - { - break lab0; - } base.ket = base.cursor; switch (among_var) { case 1: @@ -479,29 +408,17 @@ SpanishStemmer = function() { /** @return {boolean} */ function r_RV() { - if (!(I_pV <= base.cursor)) - { - return false; - } - return true; + return I_pV <= base.cursor; }; /** @return {boolean} */ function r_R1() { - if (!(I_p1 <= base.cursor)) - { - return false; - } - return true; + return I_p1 <= base.cursor; }; /** @return {boolean} */ function r_R2() { - if (!(I_p2 <= base.cursor)) - { - return false; - } - return true; + return I_p2 <= base.cursor; }; /** @return {boolean} */ @@ -608,7 +525,7 @@ SpanishStemmer = function() { { return false; } - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("ic"))) @@ -667,7 +584,7 @@ SpanishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab1: { base.ket = base.cursor; among_var = base.find_among_b(a_3); @@ -717,7 +634,7 @@ SpanishStemmer = function() { { return false; } - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab2: { base.ket = base.cursor; if (base.find_among_b(a_4) == 0) @@ -746,7 +663,7 @@ SpanishStemmer = function() { { return false; } - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab3: { base.ket = base.cursor; if (base.find_among_b(a_5) == 0) @@ -775,7 +692,7 @@ SpanishStemmer = function() { { return false; } - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab4: { base.ket = base.cursor; if (!(base.eq_s_b("at"))) @@ -805,16 +722,16 @@ SpanishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; if (base.find_among_b(a_7) == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; if (!(base.eq_s_b("u"))) { return false; @@ -833,33 +750,33 @@ SpanishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; among_var = base.find_among_b(a_8); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; switch (among_var) { case 1: - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("u"))) { - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; break lab0; } - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; if (!(base.eq_s_b("g"))) { - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; break lab0; } - base.cursor = base.limit - v_4; + base.cursor = base.limit - v_3; } base.bra = base.cursor; if (!base.slice_del()) @@ -907,7 +824,7 @@ SpanishStemmer = function() { { return false; } - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("u"))) @@ -916,7 +833,7 @@ SpanishStemmer = function() { break lab0; } base.bra = base.cursor; - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; if (!(base.eq_s_b("g"))) { base.cursor = base.limit - v_1; @@ -941,13 +858,13 @@ SpanishStemmer = function() { this.stem = /** @return {boolean} */ function() { r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; r_attached_pronoun(); - base.cursor = base.limit - v_2; - var /** number */ v_3 = base.limit - base.cursor; + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab0: { lab1: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab2: { if (!r_standard_suffix()) { @@ -955,7 +872,7 @@ SpanishStemmer = function() { } break lab1; } - base.cursor = base.limit - v_4; + base.cursor = base.limit - v_3; lab3: { if (!r_y_verb_suffix()) { @@ -963,21 +880,21 @@ SpanishStemmer = function() { } break lab1; } - base.cursor = base.limit - v_4; + base.cursor = base.limit - v_3; if (!r_verb_suffix()) { break lab0; } } } - base.cursor = base.limit - v_3; - var /** number */ v_5 = base.limit - base.cursor; + base.cursor = base.limit - v_2; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; r_residual_suffix(); - base.cursor = base.limit - v_5; + base.cursor = base.limit - v_4; base.cursor = base.limit_backward; - var /** number */ v_6 = base.cursor; + /** @const */ var /** number */ v_5 = base.cursor; r_postlude(); - base.cursor = v_6; + base.cursor = v_5; return true; }; diff --git a/sphinx/search/non-minified-js/swedish-stemmer.js b/sphinx/search/non-minified-js/swedish-stemmer.js index 4d7d49fc0e5..bf1a64268d2 100644 --- a/sphinx/search/non-minified-js/swedish-stemmer.js +++ b/sphinx/search/non-minified-js/swedish-stemmer.js @@ -1,9 +1,34 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from swedish.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -SwedishStemmer = function() { +var SwedishStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ + ["fab", -1, -1], + ["h", -1, -1], + ["pak", -1, -1], + ["rak", -1, -1], + ["stak", -1, -1], + ["kom", -1, -1], + ["iet", -1, -1], + ["cit", -1, -1], + ["dit", -1, -1], + ["alit", -1, -1], + ["ilit", -1, -1], + ["mit", -1, -1], + ["nit", -1, -1], + ["pit", -1, -1], + ["rit", -1, -1], + ["sit", -1, -1], + ["tit", -1, -1], + ["uit", -1, -1], + ["ivit", -1, -1], + ["kvit", -1, -1], + ["xit", -1, -1] + ]; + + /** @const */ var a_1 = [ ["a", -1, 1], ["arna", 0, 1], ["erna", 0, 1], @@ -38,12 +63,13 @@ SwedishStemmer = function() { ["hetens", 29, 1], ["erns", 21, 1], ["at", -1, 1], - ["andet", -1, 1], - ["het", -1, 1], + ["et", -1, 3], + ["andet", 34, 1], + ["het", 34, 1], ["ast", -1, 1] ]; - /** @const */ var a_1 = [ + /** @const */ var a_2 = [ ["dd", -1, -1], ["gd", -1, -1], ["nn", -1, -1], @@ -53,18 +79,20 @@ SwedishStemmer = function() { ["tt", -1, -1] ]; - /** @const */ var a_2 = [ + /** @const */ var a_3 = [ ["ig", -1, 1], ["lig", 0, 1], ["els", -1, 1], ["fullt", -1, 3], - ["l\u00F6st", -1, 2] + ["\u00F6st", -1, 2] ]; /** @const */ var /** Array */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 24, 0, 32]; /** @const */ var /** Array */ g_s_ending = [119, 127, 149]; + /** @const */ var /** Array */ g_ost_ending = [173, 58]; + var /** number */ I_x = 0; var /** number */ I_p1 = 0; @@ -72,9 +100,9 @@ SwedishStemmer = function() { /** @return {boolean} */ function r_mark_regions() { I_p1 = base.limit; - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; { - var /** number */ c1 = base.cursor + 3; + /** @const */ var /** number */ c1 = base.cursor + 3; if (c1 > base.limit) { return false; @@ -83,46 +111,56 @@ SwedishStemmer = function() { } I_x = base.cursor; base.cursor = v_1; - golab0: while(true) + if (!base.go_out_grouping(g_v, 97, 246)) { - var /** number */ v_2 = base.cursor; - lab1: { - if (!(base.in_grouping(g_v, 97, 246))) - { - break lab1; - } - base.cursor = v_2; - break golab0; + return false; + } + base.cursor++; + if (!base.go_in_grouping(g_v, 97, 246)) + { + return false; + } + base.cursor++; + I_p1 = base.cursor; + lab0: { + if (I_p1 >= I_x) + { + break lab0; } - base.cursor = v_2; - if (base.cursor >= base.limit) + I_p1 = I_x; + } + return true; + }; + + /** @return {boolean} */ + function r_et_condition() { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + if (!(base.out_grouping_b(g_v, 97, 246))) + { + return false; + } + if (!(base.in_grouping_b(g_v, 97, 246))) + { + return false; + } + lab0: { + if (base.cursor > base.limit_backward) { - return false; + break lab0; } - base.cursor++; + return false; } - golab2: while(true) + base.cursor = base.limit - v_1; { - lab3: { - if (!(base.out_grouping(g_v, 97, 246))) + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + if (base.find_among_b(a_0) == 0) { - break lab3; + break lab1; } - break golab2; - } - if (base.cursor >= base.limit) - { return false; } - base.cursor++; - } - I_p1 = base.cursor; - lab4: { - if (!(I_p1 < I_x)) - { - break lab4; - } - I_p1 = I_x; + base.cursor = base.limit - v_2; } return true; }; @@ -134,17 +172,17 @@ SwedishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; - among_var = base.find_among_b(a_0); + among_var = base.find_among_b(a_1); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; - base.limit_backward = v_2; + base.limit_backward = v_1; switch (among_var) { case 1: if (!base.slice_del()) @@ -153,7 +191,33 @@ SwedishStemmer = function() { } break; case 2: - if (!(base.in_grouping_b(g_s_ending, 98, 121))) + lab0: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { + if (!(base.eq_s_b("et"))) + { + break lab1; + } + if (!r_et_condition()) + { + break lab1; + } + base.bra = base.cursor; + break lab0; + } + base.cursor = base.limit - v_2; + if (!(base.in_grouping_b(g_s_ending, 98, 121))) + { + return false; + } + } + if (!base.slice_del()) + { + return false; + } + break; + case 3: + if (!r_et_condition()) { return false; } @@ -172,19 +236,19 @@ SwedishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; - var /** number */ v_3 = base.limit - base.cursor; - if (base.find_among_b(a_1) == 0) + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + if (base.find_among_b(a_2) == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; base.ket = base.cursor; if (base.cursor <= base.limit_backward) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.cursor--; @@ -193,7 +257,7 @@ SwedishStemmer = function() { { return false; } - base.limit_backward = v_2; + base.limit_backward = v_1; return true; }; @@ -204,16 +268,17 @@ SwedishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit_backward; + /** @const */ var /** number */ v_1 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; - among_var = base.find_among_b(a_2); + among_var = base.find_among_b(a_3); if (among_var == 0) { - base.limit_backward = v_2; + base.limit_backward = v_1; return false; } base.bra = base.cursor; + base.limit_backward = v_1; switch (among_var) { case 1: if (!base.slice_del()) @@ -222,7 +287,11 @@ SwedishStemmer = function() { } break; case 2: - if (!base.slice_from("l\u00F6s")) + if (!(base.in_grouping_b(g_ost_ending, 105, 118))) + { + return false; + } + if (!base.slice_from("\u00F6s")) { return false; } @@ -234,22 +303,21 @@ SwedishStemmer = function() { } break; } - base.limit_backward = v_2; return true; }; this.stem = /** @return {boolean} */ function() { - var /** number */ v_1 = base.cursor; + /** @const */ var /** number */ v_1 = base.cursor; r_mark_regions(); base.cursor = v_1; base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; r_main_suffix(); base.cursor = base.limit - v_2; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; r_consonant_pair(); base.cursor = base.limit - v_3; - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; r_other_suffix(); base.cursor = base.limit - v_4; base.cursor = base.limit_backward; diff --git a/sphinx/search/non-minified-js/tamil-stemmer.js b/sphinx/search/non-minified-js/tamil-stemmer.js new file mode 100644 index 00000000000..2ae474784d7 --- /dev/null +++ b/sphinx/search/non-minified-js/tamil-stemmer.js @@ -0,0 +1,1189 @@ +// Generated from tamil.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var TamilStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["\u0BB5\u0BC1", -1, 3], + ["\u0BB5\u0BC2", -1, 4], + ["\u0BB5\u0BCA", -1, 2], + ["\u0BB5\u0BCB", -1, 1] + ]; + + /** @const */ var a_1 = [ + ["\u0B95", -1, -1], + ["\u0B99", -1, -1], + ["\u0B9A", -1, -1], + ["\u0B9E", -1, -1], + ["\u0BA4", -1, -1], + ["\u0BA8", -1, -1], + ["\u0BAA", -1, -1], + ["\u0BAE", -1, -1], + ["\u0BAF", -1, -1], + ["\u0BB5", -1, -1] + ]; + + /** @const */ var a_2 = [ + ["\u0BBF", -1, -1], + ["\u0BC0", -1, -1], + ["\u0BC8", -1, -1] + ]; + + /** @const */ var a_3 = [ + ["\u0BBE", -1, -1], + ["\u0BBF", -1, -1], + ["\u0BC0", -1, -1], + ["\u0BC1", -1, -1], + ["\u0BC2", -1, -1], + ["\u0BC6", -1, -1], + ["\u0BC7", -1, -1], + ["\u0BC8", -1, -1] + ]; + + /** @const */ var a_4 = [ + ["", -1, 2], + ["\u0BC8", 0, 1], + ["\u0BCD", 0, 1] + ]; + + /** @const */ var a_5 = [ + ["\u0BA8\u0BCD\u0BA4", -1, 1], + ["\u0BAF", -1, 1], + ["\u0BB5", -1, 1], + ["\u0BA9\u0BC1", -1, 8], + ["\u0BC1\u0B95\u0BCD", -1, 7], + ["\u0BC1\u0B95\u0BCD\u0B95\u0BCD", -1, 7], + ["\u0B9F\u0BCD\u0B95\u0BCD", -1, 3], + ["\u0BB1\u0BCD\u0B95\u0BCD", -1, 4], + ["\u0B99\u0BCD", -1, 9], + ["\u0B9F\u0BCD\u0B9F\u0BCD", -1, 5], + ["\u0BA4\u0BCD\u0BA4\u0BCD", -1, 6], + ["\u0BA8\u0BCD\u0BA4\u0BCD", -1, 1], + ["\u0BA8\u0BCD", -1, 1], + ["\u0B9F\u0BCD\u0BAA\u0BCD", -1, 3], + ["\u0BAF\u0BCD", -1, 2], + ["\u0BA9\u0BCD\u0BB1\u0BCD", -1, 4], + ["\u0BB5\u0BCD", -1, 1] + ]; + + /** @const */ var a_6 = [ + ["\u0B95", -1, -1], + ["\u0B9A", -1, -1], + ["\u0B9F", -1, -1], + ["\u0BA4", -1, -1], + ["\u0BAA", -1, -1], + ["\u0BB1", -1, -1] + ]; + + /** @const */ var a_7 = [ + ["\u0B95", -1, -1], + ["\u0B9A", -1, -1], + ["\u0B9F", -1, -1], + ["\u0BA4", -1, -1], + ["\u0BAA", -1, -1], + ["\u0BB1", -1, -1] + ]; + + /** @const */ var a_8 = [ + ["\u0B9E", -1, -1], + ["\u0BA3", -1, -1], + ["\u0BA8", -1, -1], + ["\u0BA9", -1, -1], + ["\u0BAE", -1, -1], + ["\u0BAF", -1, -1], + ["\u0BB0", -1, -1], + ["\u0BB2", -1, -1], + ["\u0BB3", -1, -1], + ["\u0BB4", -1, -1], + ["\u0BB5", -1, -1] + ]; + + /** @const */ var a_9 = [ + ["\u0BBE", -1, -1], + ["\u0BBF", -1, -1], + ["\u0BC0", -1, -1], + ["\u0BC1", -1, -1], + ["\u0BC2", -1, -1], + ["\u0BC6", -1, -1], + ["\u0BC7", -1, -1], + ["\u0BC8", -1, -1], + ["\u0BCD", -1, -1] + ]; + + /** @const */ var a_10 = [ + ["\u0B85", -1, -1], + ["\u0B87", -1, -1], + ["\u0B89", -1, -1] + ]; + + /** @const */ var a_11 = [ + ["\u0B95", -1, -1], + ["\u0B99", -1, -1], + ["\u0B9A", -1, -1], + ["\u0B9E", -1, -1], + ["\u0BA4", -1, -1], + ["\u0BA8", -1, -1], + ["\u0BAA", -1, -1], + ["\u0BAE", -1, -1], + ["\u0BAF", -1, -1], + ["\u0BB5", -1, -1] + ]; + + /** @const */ var a_12 = [ + ["\u0B95", -1, -1], + ["\u0B9A", -1, -1], + ["\u0B9F", -1, -1], + ["\u0BA4", -1, -1], + ["\u0BAA", -1, -1], + ["\u0BB1", -1, -1] + ]; + + /** @const */ var a_13 = [ + ["\u0B95\u0BB3\u0BCD", -1, 4], + ["\u0BC1\u0B99\u0BCD\u0B95\u0BB3\u0BCD", 0, 1], + ["\u0B9F\u0BCD\u0B95\u0BB3\u0BCD", 0, 3], + ["\u0BB1\u0BCD\u0B95\u0BB3\u0BCD", 0, 2] + ]; + + /** @const */ var a_14 = [ + ["\u0BBE", -1, -1], + ["\u0BC7", -1, -1], + ["\u0BCB", -1, -1] + ]; + + /** @const */ var a_15 = [ + ["\u0BAA\u0BBF", -1, -1], + ["\u0BB5\u0BBF", -1, -1] + ]; + + /** @const */ var a_16 = [ + ["\u0BBE", -1, -1], + ["\u0BBF", -1, -1], + ["\u0BC0", -1, -1], + ["\u0BC1", -1, -1], + ["\u0BC2", -1, -1], + ["\u0BC6", -1, -1], + ["\u0BC7", -1, -1], + ["\u0BC8", -1, -1] + ]; + + /** @const */ var a_17 = [ + ["\u0BAA\u0B9F\u0BCD\u0B9F", -1, 3], + ["\u0BAA\u0B9F\u0BCD\u0B9F\u0BA3", -1, 3], + ["\u0BA4\u0BBE\u0BA9", -1, 3], + ["\u0BAA\u0B9F\u0BBF\u0BA4\u0BBE\u0BA9", 2, 3], + ["\u0BC6\u0BA9", -1, 1], + ["\u0BBE\u0B95\u0BBF\u0BAF", -1, 1], + ["\u0B95\u0BC1\u0BB0\u0BBF\u0BAF", -1, 3], + ["\u0BC1\u0B9F\u0BC8\u0BAF", -1, 1], + ["\u0BB2\u0BCD\u0BB2", -1, 2], + ["\u0BC1\u0BB3\u0BCD\u0BB3", -1, 1], + ["\u0BBE\u0B95\u0BBF", -1, 1], + ["\u0BAA\u0B9F\u0BBF", -1, 3], + ["\u0BBF\u0BA9\u0BCD\u0BB1\u0BBF", -1, 1], + ["\u0BAA\u0BB1\u0BCD\u0BB1\u0BBF", -1, 3], + ["\u0BAA\u0B9F\u0BC1", -1, 3], + ["\u0BB5\u0BBF\u0B9F\u0BC1", -1, 3], + ["\u0BAA\u0B9F\u0BCD\u0B9F\u0BC1", -1, 3], + ["\u0BB5\u0BBF\u0B9F\u0BCD\u0B9F\u0BC1", -1, 3], + ["\u0BAA\u0B9F\u0BCD\u0B9F\u0BA4\u0BC1", -1, 3], + ["\u0BC6\u0BA9\u0BCD\u0BB1\u0BC1", -1, 1], + ["\u0BC1\u0B9F\u0BC8", -1, 1], + ["\u0BBF\u0BB2\u0BCD\u0BB2\u0BC8", -1, 1], + ["\u0BC1\u0B9F\u0BA9\u0BCD", -1, 1], + ["\u0BBF\u0B9F\u0BAE\u0BCD", -1, 1], + ["\u0BC6\u0BB2\u0BCD\u0BB2\u0BBE\u0BAE\u0BCD", -1, 3], + ["\u0BC6\u0BA9\u0BC1\u0BAE\u0BCD", -1, 1] + ]; + + /** @const */ var a_18 = [ + ["\u0BBE", -1, -1], + ["\u0BBF", -1, -1], + ["\u0BC0", -1, -1], + ["\u0BC1", -1, -1], + ["\u0BC2", -1, -1], + ["\u0BC6", -1, -1], + ["\u0BC7", -1, -1], + ["\u0BC8", -1, -1] + ]; + + /** @const */ var a_19 = [ + ["\u0BBE", -1, -1], + ["\u0BBF", -1, -1], + ["\u0BC0", -1, -1], + ["\u0BC1", -1, -1], + ["\u0BC2", -1, -1], + ["\u0BC6", -1, -1], + ["\u0BC7", -1, -1], + ["\u0BC8", -1, -1] + ]; + + /** @const */ var a_20 = [ + ["\u0BB5\u0BBF\u0B9F", -1, 2], + ["\u0BC0", -1, 7], + ["\u0BCA\u0B9F\u0BC1", -1, 2], + ["\u0BCB\u0B9F\u0BC1", -1, 2], + ["\u0BA4\u0BC1", -1, 6], + ["\u0BBF\u0BB0\u0BC1\u0BA8\u0BCD\u0BA4\u0BC1", 4, 2], + ["\u0BBF\u0BA9\u0BCD\u0BB1\u0BC1", -1, 2], + ["\u0BC1\u0B9F\u0BC8", -1, 2], + ["\u0BA9\u0BC8", -1, 1], + ["\u0B95\u0BA3\u0BCD", -1, 1], + ["\u0BBF\u0BA9\u0BCD", -1, 3], + ["\u0BAE\u0BC1\u0BA9\u0BCD", -1, 1], + ["\u0BBF\u0B9F\u0BAE\u0BCD", -1, 4], + ["\u0BBF\u0BB1\u0BCD", -1, 2], + ["\u0BAE\u0BC7\u0BB1\u0BCD", -1, 1], + ["\u0BB2\u0BCD", -1, 5], + ["\u0BBE\u0BAE\u0BB2\u0BCD", 15, 2], + ["\u0BBE\u0BB2\u0BCD", 15, 2], + ["\u0BBF\u0BB2\u0BCD", 15, 2], + ["\u0BAE\u0BC7\u0BB2\u0BCD", 15, 1], + ["\u0BC1\u0BB3\u0BCD", -1, 2], + ["\u0B95\u0BC0\u0BB4\u0BCD", -1, 1] + ]; + + /** @const */ var a_21 = [ + ["\u0B95", -1, -1], + ["\u0B9A", -1, -1], + ["\u0B9F", -1, -1], + ["\u0BA4", -1, -1], + ["\u0BAA", -1, -1], + ["\u0BB1", -1, -1] + ]; + + /** @const */ var a_22 = [ + ["\u0B95", -1, -1], + ["\u0B9A", -1, -1], + ["\u0B9F", -1, -1], + ["\u0BA4", -1, -1], + ["\u0BAA", -1, -1], + ["\u0BB1", -1, -1] + ]; + + /** @const */ var a_23 = [ + ["\u0B85", -1, -1], + ["\u0B86", -1, -1], + ["\u0B87", -1, -1], + ["\u0B88", -1, -1], + ["\u0B89", -1, -1], + ["\u0B8A", -1, -1], + ["\u0B8E", -1, -1], + ["\u0B8F", -1, -1], + ["\u0B90", -1, -1], + ["\u0B92", -1, -1], + ["\u0B93", -1, -1], + ["\u0B94", -1, -1] + ]; + + /** @const */ var a_24 = [ + ["\u0BBE", -1, -1], + ["\u0BBF", -1, -1], + ["\u0BC0", -1, -1], + ["\u0BC1", -1, -1], + ["\u0BC2", -1, -1], + ["\u0BC6", -1, -1], + ["\u0BC7", -1, -1], + ["\u0BC8", -1, -1] + ]; + + /** @const */ var a_25 = [ + ["\u0B95", -1, 1], + ["\u0BA4", -1, 1], + ["\u0BA9", -1, 1], + ["\u0BAA", -1, 1], + ["\u0BAF", -1, 1], + ["\u0BBE", -1, 5], + ["\u0B95\u0BC1", -1, 6], + ["\u0BAA\u0B9F\u0BC1", -1, 1], + ["\u0BA4\u0BC1", -1, 3], + ["\u0BBF\u0BB1\u0BCD\u0BB1\u0BC1", -1, 1], + ["\u0BA9\u0BC8", -1, 1], + ["\u0BB5\u0BC8", -1, 1], + ["\u0BA9\u0BA9\u0BCD", -1, 1], + ["\u0BAA\u0BA9\u0BCD", -1, 1], + ["\u0BB5\u0BA9\u0BCD", -1, 2], + ["\u0BBE\u0BA9\u0BCD", -1, 4], + ["\u0BA9\u0BBE\u0BA9\u0BCD", 15, 1], + ["\u0BAE\u0BBF\u0BA9\u0BCD", -1, 1], + ["\u0BA9\u0BC6\u0BA9\u0BCD", -1, 1], + ["\u0BC7\u0BA9\u0BCD", -1, 5], + ["\u0BA9\u0BAE\u0BCD", -1, 1], + ["\u0BAA\u0BAE\u0BCD", -1, 1], + ["\u0BBE\u0BAE\u0BCD", -1, 5], + ["\u0B95\u0BC1\u0BAE\u0BCD", -1, 1], + ["\u0B9F\u0BC1\u0BAE\u0BCD", -1, 5], + ["\u0BA4\u0BC1\u0BAE\u0BCD", -1, 1], + ["\u0BB1\u0BC1\u0BAE\u0BCD", -1, 1], + ["\u0BC6\u0BAE\u0BCD", -1, 5], + ["\u0BC7\u0BAE\u0BCD", -1, 5], + ["\u0BCB\u0BAE\u0BCD", -1, 5], + ["\u0BBE\u0BAF\u0BCD", -1, 5], + ["\u0BA9\u0BB0\u0BCD", -1, 1], + ["\u0BAA\u0BB0\u0BCD", -1, 1], + ["\u0BC0\u0BAF\u0BB0\u0BCD", -1, 5], + ["\u0BB5\u0BB0\u0BCD", -1, 1], + ["\u0BBE\u0BB0\u0BCD", -1, 5], + ["\u0BA9\u0BBE\u0BB0\u0BCD", 35, 1], + ["\u0BAE\u0BBE\u0BB0\u0BCD", 35, 1], + ["\u0B95\u0BCA\u0BA3\u0BCD\u0B9F\u0BBF\u0BB0\u0BCD", -1, 1], + ["\u0BA9\u0BBF\u0BB0\u0BCD", -1, 5], + ["\u0BC0\u0BB0\u0BCD", -1, 5], + ["\u0BA9\u0BB3\u0BCD", -1, 1], + ["\u0BAA\u0BB3\u0BCD", -1, 1], + ["\u0BB5\u0BB3\u0BCD", -1, 1], + ["\u0BBE\u0BB3\u0BCD", -1, 5], + ["\u0BA9\u0BBE\u0BB3\u0BCD", 44, 1] + ]; + + /** @const */ var a_26 = [ + ["\u0B95\u0BBF\u0BB1", -1, -1], + ["\u0B95\u0BBF\u0BA9\u0BCD\u0BB1", -1, -1], + ["\u0BBE\u0BA8\u0BBF\u0BA9\u0BCD\u0BB1", -1, -1], + ["\u0B95\u0BBF\u0BB1\u0BCD", -1, -1], + ["\u0B95\u0BBF\u0BA9\u0BCD\u0BB1\u0BCD", -1, -1], + ["\u0BBE\u0BA8\u0BBF\u0BA9\u0BCD\u0BB1\u0BCD", -1, -1] + ]; + + var /** boolean */ B_found_vetrumai_urupu = false; + var /** boolean */ B_found_a_match = false; + + + /** @return {boolean} */ + function r_has_min_length() { + return base.current.length > 4; + }; + + /** @return {boolean} */ + function r_fix_va_start() { + var /** number */ among_var; + base.bra = base.cursor; + among_var = base.find_among(a_0); + if (among_var == 0) + { + return false; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("\u0B93")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u0B92")) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u0B89")) + { + return false; + } + break; + case 4: + if (!base.slice_from("\u0B8A")) + { + return false; + } + break; + } + return true; + }; + + /** @return {boolean} */ + function r_fix_endings() { + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + while(true) + { + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + if (!r_fix_ending()) + { + break lab1; + } + continue; + } + base.cursor = v_2; + break; + } + } + base.cursor = v_1; + return true; + }; + + /** @return {boolean} */ + function r_remove_question_prefixes() { + base.bra = base.cursor; + if (!(base.eq_s("\u0B8E"))) + { + return false; + } + if (base.find_among(a_1) == 0) + { + return false; + } + if (!(base.eq_s("\u0BCD"))) + { + return false; + } + base.ket = base.cursor; + if (!base.slice_del()) + { + return false; + } + /** @const */ var /** number */ v_1 = base.cursor; + r_fix_va_start(); + base.cursor = v_1; + return true; + }; + + /** @return {boolean} */ + function r_fix_ending() { + var /** number */ among_var; + if (base.current.length <= 3) + { + return false; + } + base.limit_backward = base.cursor; base.cursor = base.limit; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + base.ket = base.cursor; + among_var = base.find_among_b(a_5); + if (among_var == 0) + { + break lab1; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + break; + case 2: + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + if (base.find_among_b(a_2) == 0) + { + break lab1; + } + base.cursor = base.limit - v_2; + if (!base.slice_del()) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u0BB3\u0BCD")) + { + return false; + } + break; + case 4: + if (!base.slice_from("\u0BB2\u0BCD")) + { + return false; + } + break; + case 5: + if (!base.slice_from("\u0B9F\u0BC1")) + { + return false; + } + break; + case 6: + if (!B_found_vetrumai_urupu) + { + break lab1; + } + { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab2: { + if (!(base.eq_s_b("\u0BC8"))) + { + break lab2; + } + break lab1; + } + base.cursor = base.limit - v_3; + } + if (!base.slice_from("\u0BAE\u0BCD")) + { + return false; + } + break; + case 7: + if (!base.slice_from("\u0BCD")) + { + return false; + } + break; + case 8: + { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab3: { + if (base.find_among_b(a_3) == 0) + { + break lab3; + } + break lab1; + } + base.cursor = base.limit - v_4; + } + if (!base.slice_del()) + { + return false; + } + break; + case 9: + among_var = base.find_among_b(a_4); + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u0BAE\u0BCD")) + { + return false; + } + break; + } + break; + } + break lab0; + } + base.cursor = base.limit - v_1; + base.ket = base.cursor; + if (!(base.eq_s_b("\u0BCD"))) + { + return false; + } + lab4: { + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab5: { + if (base.find_among_b(a_6) == 0) + { + break lab5; + } + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + lab6: { + if (!(base.eq_s_b("\u0BCD"))) + { + base.cursor = base.limit - v_6; + break lab6; + } + if (base.find_among_b(a_7) == 0) + { + base.cursor = base.limit - v_6; + break lab6; + } + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + break lab4; + } + base.cursor = base.limit - v_5; + lab7: { + if (base.find_among_b(a_8) == 0) + { + break lab7; + } + base.bra = base.cursor; + if (!(base.eq_s_b("\u0BCD"))) + { + break lab7; + } + if (!base.slice_del()) + { + return false; + } + break lab4; + } + base.cursor = base.limit - v_5; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + if (base.find_among_b(a_9) == 0) + { + return false; + } + base.cursor = base.limit - v_7; + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + } + } + base.cursor = base.limit_backward; + return true; + }; + + /** @return {boolean} */ + function r_remove_pronoun_prefixes() { + base.bra = base.cursor; + if (base.find_among(a_10) == 0) + { + return false; + } + if (base.find_among(a_11) == 0) + { + return false; + } + if (!(base.eq_s("\u0BCD"))) + { + return false; + } + base.ket = base.cursor; + if (!base.slice_del()) + { + return false; + } + /** @const */ var /** number */ v_1 = base.cursor; + r_fix_va_start(); + base.cursor = v_1; + return true; + }; + + /** @return {boolean} */ + function r_remove_plural_suffix() { + var /** number */ among_var; + base.limit_backward = base.cursor; base.cursor = base.limit; + base.ket = base.cursor; + among_var = base.find_among_b(a_13); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + if (base.find_among_b(a_12) == 0) + { + break lab1; + } + if (!base.slice_from("\u0BC1\u0B99\u0BCD")) + { + return false; + } + break lab0; + } + base.cursor = base.limit - v_1; + if (!base.slice_from("\u0BCD")) + { + return false; + } + } + break; + case 2: + if (!base.slice_from("\u0BB2\u0BCD")) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u0BB3\u0BCD")) + { + return false; + } + break; + case 4: + if (!base.slice_del()) + { + return false; + } + break; + } + base.cursor = base.limit_backward; + return true; + }; + + /** @return {boolean} */ + function r_remove_question_suffixes() { + if (!r_has_min_length()) + { + return false; + } + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + if (base.find_among_b(a_14) == 0) + { + break lab0; + } + base.bra = base.cursor; + if (!base.slice_from("\u0BCD")) + { + return false; + } + } + base.cursor = base.limit - v_1; + base.cursor = base.limit_backward; + r_fix_endings(); + return true; + }; + + /** @return {boolean} */ + function r_remove_command_suffixes() { + if (!r_has_min_length()) + { + return false; + } + base.limit_backward = base.cursor; base.cursor = base.limit; + base.ket = base.cursor; + if (base.find_among_b(a_15) == 0) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + base.cursor = base.limit_backward; + return true; + }; + + /** @return {boolean} */ + function r_remove_um() { + if (!r_has_min_length()) + { + return false; + } + base.limit_backward = base.cursor; base.cursor = base.limit; + base.ket = base.cursor; + if (!(base.eq_s_b("\u0BC1\u0BAE\u0BCD"))) + { + return false; + } + base.bra = base.cursor; + if (!base.slice_from("\u0BCD")) + { + return false; + } + base.cursor = base.limit_backward; + /** @const */ var /** number */ v_1 = base.cursor; + r_fix_ending(); + base.cursor = v_1; + return true; + }; + + /** @return {boolean} */ + function r_remove_common_word_endings() { + var /** number */ among_var; + if (!r_has_min_length()) + { + return false; + } + base.limit_backward = base.cursor; base.cursor = base.limit; + base.ket = base.cursor; + among_var = base.find_among_b(a_17); + if (among_var == 0) + { + return false; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("\u0BCD")) + { + return false; + } + break; + case 2: + { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + if (base.find_among_b(a_16) == 0) + { + break lab0; + } + return false; + } + base.cursor = base.limit - v_1; + } + if (!base.slice_from("\u0BCD")) + { + return false; + } + break; + case 3: + if (!base.slice_del()) + { + return false; + } + break; + } + base.cursor = base.limit_backward; + r_fix_endings(); + return true; + }; + + /** @return {boolean} */ + function r_remove_vetrumai_urupukal() { + var /** number */ among_var; + B_found_vetrumai_urupu = false; + if (!r_has_min_length()) + { + return false; + } + base.limit_backward = base.cursor; base.cursor = base.limit; + lab0: { + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab1: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + base.ket = base.cursor; + among_var = base.find_among_b(a_20); + if (among_var == 0) + { + break lab1; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u0BCD")) + { + return false; + } + break; + case 3: + { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab2: { + if (!(base.eq_s_b("\u0BAE"))) + { + break lab2; + } + break lab1; + } + base.cursor = base.limit - v_3; + } + if (!base.slice_from("\u0BCD")) + { + return false; + } + break; + case 4: + if (base.current.length < 7) + { + break lab1; + } + if (!base.slice_from("\u0BCD")) + { + return false; + } + break; + case 5: + { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab3: { + if (base.find_among_b(a_18) == 0) + { + break lab3; + } + break lab1; + } + base.cursor = base.limit - v_4; + } + if (!base.slice_from("\u0BCD")) + { + return false; + } + break; + case 6: + { + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab4: { + if (base.find_among_b(a_19) == 0) + { + break lab4; + } + break lab1; + } + base.cursor = base.limit - v_5; + } + if (!base.slice_del()) + { + return false; + } + break; + case 7: + if (!base.slice_from("\u0BBF")) + { + return false; + } + break; + } + base.cursor = base.limit - v_2; + break lab0; + } + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + base.ket = base.cursor; + if (!(base.eq_s_b("\u0BC8"))) + { + return false; + } + lab5: { + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab6: { + { + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + lab7: { + if (base.find_among_b(a_21) == 0) + { + break lab7; + } + break lab6; + } + base.cursor = base.limit - v_8; + } + break lab5; + } + base.cursor = base.limit - v_7; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; + if (base.find_among_b(a_22) == 0) + { + return false; + } + if (!(base.eq_s_b("\u0BCD"))) + { + return false; + } + base.cursor = base.limit - v_9; + } + base.bra = base.cursor; + if (!base.slice_from("\u0BCD")) + { + return false; + } + base.cursor = base.limit - v_6; + } + B_found_vetrumai_urupu = true; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; + lab8: { + base.ket = base.cursor; + if (!(base.eq_s_b("\u0BBF\u0BA9\u0BCD"))) + { + break lab8; + } + base.bra = base.cursor; + if (!base.slice_from("\u0BCD")) + { + return false; + } + } + base.cursor = base.limit - v_10; + base.cursor = base.limit_backward; + r_fix_endings(); + return true; + }; + + /** @return {boolean} */ + function r_remove_tense_suffixes() { + while(true) + { + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + if (!r_remove_tense_suffix()) + { + break lab0; + } + continue; + } + base.cursor = v_1; + break; + } + return true; + }; + + /** @return {boolean} */ + function r_remove_tense_suffix() { + var /** number */ among_var; + B_found_a_match = false; + if (!r_has_min_length()) + { + return false; + } + base.limit_backward = base.cursor; base.cursor = base.limit; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + base.ket = base.cursor; + among_var = base.find_among_b(a_25); + if (among_var == 0) + { + break lab0; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_del()) + { + return false; + } + break; + case 2: + { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab1: { + if (base.find_among_b(a_23) == 0) + { + break lab1; + } + break lab0; + } + base.cursor = base.limit - v_3; + } + if (!base.slice_del()) + { + return false; + } + break; + case 3: + { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab2: { + if (base.find_among_b(a_24) == 0) + { + break lab2; + } + break lab0; + } + base.cursor = base.limit - v_4; + } + if (!base.slice_del()) + { + return false; + } + break; + case 4: + { + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab3: { + if (!(base.eq_s_b("\u0B9A"))) + { + break lab3; + } + break lab0; + } + base.cursor = base.limit - v_5; + } + if (!base.slice_from("\u0BCD")) + { + return false; + } + break; + case 5: + if (!base.slice_from("\u0BCD")) + { + return false; + } + break; + case 6: + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + if (!(base.eq_s_b("\u0BCD"))) + { + break lab0; + } + base.cursor = base.limit - v_6; + if (!base.slice_del()) + { + return false; + } + break; + } + B_found_a_match = true; + base.cursor = base.limit - v_2; + } + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab4: { + base.ket = base.cursor; + if (base.find_among_b(a_26) == 0) + { + break lab4; + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + B_found_a_match = true; + } + base.cursor = base.limit - v_7; + base.cursor = base.limit_backward; + r_fix_endings(); + if (!B_found_a_match) + { + return false; + } + return true; + }; + + this.stem = /** @return {boolean} */ function() { + B_found_vetrumai_urupu = false; + /** @const */ var /** number */ v_1 = base.cursor; + r_fix_ending(); + base.cursor = v_1; + if (!r_has_min_length()) + { + return false; + } + /** @const */ var /** number */ v_2 = base.cursor; + r_remove_question_prefixes(); + base.cursor = v_2; + /** @const */ var /** number */ v_3 = base.cursor; + r_remove_pronoun_prefixes(); + base.cursor = v_3; + /** @const */ var /** number */ v_4 = base.cursor; + r_remove_question_suffixes(); + base.cursor = v_4; + /** @const */ var /** number */ v_5 = base.cursor; + r_remove_um(); + base.cursor = v_5; + /** @const */ var /** number */ v_6 = base.cursor; + r_remove_common_word_endings(); + base.cursor = v_6; + /** @const */ var /** number */ v_7 = base.cursor; + r_remove_vetrumai_urupukal(); + base.cursor = v_7; + /** @const */ var /** number */ v_8 = base.cursor; + r_remove_plural_suffix(); + base.cursor = v_8; + /** @const */ var /** number */ v_9 = base.cursor; + r_remove_command_suffixes(); + base.cursor = v_9; + /** @const */ var /** number */ v_10 = base.cursor; + r_remove_tense_suffixes(); + base.cursor = v_10; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/non-minified-js/turkish-stemmer.js b/sphinx/search/non-minified-js/turkish-stemmer.js index 8ba74b9218e..c57ba798066 100644 --- a/sphinx/search/non-minified-js/turkish-stemmer.js +++ b/sphinx/search/non-minified-js/turkish-stemmer.js @@ -1,8 +1,9 @@ -// Generated by Snowball 2.1.0 - https://snowballstem.org/ +// Generated from turkish.sbl by Snowball 3.0.1 - https://snowballstem.org/ /**@constructor*/ -TurkishStemmer = function() { +var TurkishStemmer = function() { var base = new BaseStemmer(); + /** @const */ var a_0 = [ ["m", -1, -1], ["n", -1, -1], @@ -216,230 +217,104 @@ TurkishStemmer = function() { /** @return {boolean} */ function r_check_vowel_harmony() { - var /** number */ v_1 = base.limit - base.cursor; - golab0: while(true) + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + if (!base.go_out_grouping_b(g_vowel, 97, 305)) { - var /** number */ v_2 = base.limit - base.cursor; - lab1: { - if (!(base.in_grouping_b(g_vowel, 97, 305))) - { - break lab1; - } - base.cursor = base.limit - v_2; - break golab0; - } - base.cursor = base.limit - v_2; - if (base.cursor <= base.limit_backward) - { - return false; - } - base.cursor--; + return false; } - lab2: { - var /** number */ v_3 = base.limit - base.cursor; - lab3: { + lab0: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab1: { if (!(base.eq_s_b("a"))) { - break lab3; + break lab1; } - golab4: while(true) + if (!base.go_out_grouping_b(g_vowel1, 97, 305)) { - var /** number */ v_4 = base.limit - base.cursor; - lab5: { - if (!(base.in_grouping_b(g_vowel1, 97, 305))) - { - break lab5; - } - base.cursor = base.limit - v_4; - break golab4; - } - base.cursor = base.limit - v_4; - if (base.cursor <= base.limit_backward) - { - break lab3; - } - base.cursor--; + break lab1; } - break lab2; + break lab0; } - base.cursor = base.limit - v_3; - lab6: { + base.cursor = base.limit - v_2; + lab2: { if (!(base.eq_s_b("e"))) { - break lab6; + break lab2; } - golab7: while(true) + if (!base.go_out_grouping_b(g_vowel2, 101, 252)) { - var /** number */ v_5 = base.limit - base.cursor; - lab8: { - if (!(base.in_grouping_b(g_vowel2, 101, 252))) - { - break lab8; - } - base.cursor = base.limit - v_5; - break golab7; - } - base.cursor = base.limit - v_5; - if (base.cursor <= base.limit_backward) - { - break lab6; - } - base.cursor--; + break lab2; } - break lab2; + break lab0; } - base.cursor = base.limit - v_3; - lab9: { + base.cursor = base.limit - v_2; + lab3: { if (!(base.eq_s_b("\u0131"))) { - break lab9; + break lab3; } - golab10: while(true) + if (!base.go_out_grouping_b(g_vowel3, 97, 305)) { - var /** number */ v_6 = base.limit - base.cursor; - lab11: { - if (!(base.in_grouping_b(g_vowel3, 97, 305))) - { - break lab11; - } - base.cursor = base.limit - v_6; - break golab10; - } - base.cursor = base.limit - v_6; - if (base.cursor <= base.limit_backward) - { - break lab9; - } - base.cursor--; + break lab3; } - break lab2; + break lab0; } - base.cursor = base.limit - v_3; - lab12: { + base.cursor = base.limit - v_2; + lab4: { if (!(base.eq_s_b("i"))) { - break lab12; + break lab4; } - golab13: while(true) + if (!base.go_out_grouping_b(g_vowel4, 101, 105)) { - var /** number */ v_7 = base.limit - base.cursor; - lab14: { - if (!(base.in_grouping_b(g_vowel4, 101, 105))) - { - break lab14; - } - base.cursor = base.limit - v_7; - break golab13; - } - base.cursor = base.limit - v_7; - if (base.cursor <= base.limit_backward) - { - break lab12; - } - base.cursor--; + break lab4; } - break lab2; + break lab0; } - base.cursor = base.limit - v_3; - lab15: { + base.cursor = base.limit - v_2; + lab5: { if (!(base.eq_s_b("o"))) { - break lab15; + break lab5; } - golab16: while(true) + if (!base.go_out_grouping_b(g_vowel5, 111, 117)) { - var /** number */ v_8 = base.limit - base.cursor; - lab17: { - if (!(base.in_grouping_b(g_vowel5, 111, 117))) - { - break lab17; - } - base.cursor = base.limit - v_8; - break golab16; - } - base.cursor = base.limit - v_8; - if (base.cursor <= base.limit_backward) - { - break lab15; - } - base.cursor--; + break lab5; } - break lab2; + break lab0; } - base.cursor = base.limit - v_3; - lab18: { + base.cursor = base.limit - v_2; + lab6: { if (!(base.eq_s_b("\u00F6"))) { - break lab18; + break lab6; } - golab19: while(true) + if (!base.go_out_grouping_b(g_vowel6, 246, 252)) { - var /** number */ v_9 = base.limit - base.cursor; - lab20: { - if (!(base.in_grouping_b(g_vowel6, 246, 252))) - { - break lab20; - } - base.cursor = base.limit - v_9; - break golab19; - } - base.cursor = base.limit - v_9; - if (base.cursor <= base.limit_backward) - { - break lab18; - } - base.cursor--; + break lab6; } - break lab2; + break lab0; } - base.cursor = base.limit - v_3; - lab21: { + base.cursor = base.limit - v_2; + lab7: { if (!(base.eq_s_b("u"))) { - break lab21; + break lab7; } - golab22: while(true) + if (!base.go_out_grouping_b(g_vowel5, 111, 117)) { - var /** number */ v_10 = base.limit - base.cursor; - lab23: { - if (!(base.in_grouping_b(g_vowel5, 111, 117))) - { - break lab23; - } - base.cursor = base.limit - v_10; - break golab22; - } - base.cursor = base.limit - v_10; - if (base.cursor <= base.limit_backward) - { - break lab21; - } - base.cursor--; + break lab7; } - break lab2; + break lab0; } - base.cursor = base.limit - v_3; + base.cursor = base.limit - v_2; if (!(base.eq_s_b("\u00FC"))) { return false; } - golab24: while(true) + if (!base.go_out_grouping_b(g_vowel6, 246, 252)) { - var /** number */ v_11 = base.limit - base.cursor; - lab25: { - if (!(base.in_grouping_b(g_vowel6, 246, 252))) - { - break lab25; - } - base.cursor = base.limit - v_11; - break golab24; - } - base.cursor = base.limit - v_11; - if (base.cursor <= base.limit_backward) - { - return false; - } - base.cursor--; + return false; } } base.cursor = base.limit - v_1; @@ -449,13 +324,13 @@ TurkishStemmer = function() { /** @return {boolean} */ function r_mark_suffix_with_optional_n_consonant() { lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("n"))) { break lab1; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab1; @@ -465,9 +340,9 @@ TurkishStemmer = function() { } base.cursor = base.limit - v_1; { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab2: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; if (!(base.eq_s_b("n"))) { break lab2; @@ -477,7 +352,7 @@ TurkishStemmer = function() { } base.cursor = base.limit - v_3; } - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; if (base.cursor <= base.limit_backward) { return false; @@ -495,13 +370,13 @@ TurkishStemmer = function() { /** @return {boolean} */ function r_mark_suffix_with_optional_s_consonant() { lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("s"))) { break lab1; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab1; @@ -511,9 +386,9 @@ TurkishStemmer = function() { } base.cursor = base.limit - v_1; { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab2: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; if (!(base.eq_s_b("s"))) { break lab2; @@ -523,7 +398,7 @@ TurkishStemmer = function() { } base.cursor = base.limit - v_3; } - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; if (base.cursor <= base.limit_backward) { return false; @@ -541,13 +416,13 @@ TurkishStemmer = function() { /** @return {boolean} */ function r_mark_suffix_with_optional_y_consonant() { lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("y"))) { break lab1; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab1; @@ -557,9 +432,9 @@ TurkishStemmer = function() { } base.cursor = base.limit - v_1; { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab2: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; if (!(base.eq_s_b("y"))) { break lab2; @@ -569,7 +444,7 @@ TurkishStemmer = function() { } base.cursor = base.limit - v_3; } - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; if (base.cursor <= base.limit_backward) { return false; @@ -587,13 +462,13 @@ TurkishStemmer = function() { /** @return {boolean} */ function r_mark_suffix_with_optional_U_vowel() { lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.in_grouping_b(g_U, 105, 305))) { break lab1; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; if (!(base.out_grouping_b(g_vowel, 97, 305))) { break lab1; @@ -603,9 +478,9 @@ TurkishStemmer = function() { } base.cursor = base.limit - v_1; { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab2: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; if (!(base.in_grouping_b(g_U, 105, 305))) { break lab2; @@ -615,7 +490,7 @@ TurkishStemmer = function() { } base.cursor = base.limit - v_3; } - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; if (base.cursor <= base.limit_backward) { return false; @@ -1010,10 +885,10 @@ TurkishStemmer = function() { base.ket = base.cursor; B_continue_stemming_noun_suffixes = true; lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { lab2: { - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab3: { if (!r_mark_ymUs_()) { @@ -1052,7 +927,7 @@ TurkishStemmer = function() { break lab6; } lab7: { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab8: { if (!r_mark_sUnUz()) { @@ -1111,11 +986,11 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab14: { base.ket = base.cursor; lab15: { - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab16: { if (!r_mark_DUr()) { @@ -1157,7 +1032,7 @@ TurkishStemmer = function() { break lab19; } lab20: { - var /** number */ v_6 = base.limit - base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; lab21: { if (!r_mark_yDU()) { @@ -1176,7 +1051,7 @@ TurkishStemmer = function() { base.cursor = base.limit - v_1; lab22: { lab23: { - var /** number */ v_7 = base.limit - base.cursor; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; lab24: { if (!r_mark_sUnUz()) { @@ -1211,7 +1086,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_8 = base.limit - base.cursor; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; lab27: { base.ket = base.cursor; if (!r_mark_ymUs_()) @@ -1232,11 +1107,11 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_9 = base.limit - base.cursor; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; lab28: { base.ket = base.cursor; lab29: { - var /** number */ v_10 = base.limit - base.cursor; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; lab30: { if (!r_mark_sUnUz()) { @@ -1301,7 +1176,7 @@ TurkishStemmer = function() { return false; } lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!r_mark_DA()) { @@ -1312,11 +1187,11 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab2: { base.ket = base.cursor; lab3: { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab4: { if (!r_mark_lAr()) { @@ -1327,7 +1202,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab5: { if (!r_stem_suffix_chain_before_ki()) { @@ -1348,7 +1223,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab6: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -1382,11 +1257,11 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_6 = base.limit - base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; lab8: { base.ket = base.cursor; lab9: { - var /** number */ v_7 = base.limit - base.cursor; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; lab10: { if (!r_mark_lArI()) { @@ -1403,7 +1278,7 @@ TurkishStemmer = function() { lab11: { base.ket = base.cursor; lab12: { - var /** number */ v_8 = base.limit - base.cursor; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; lab13: { if (!r_mark_possessives()) { @@ -1422,7 +1297,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_9 = base.limit - base.cursor; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; lab14: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -1459,7 +1334,7 @@ TurkishStemmer = function() { return false; } lab15: { - var /** number */ v_10 = base.limit - base.cursor; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; lab16: { if (!r_mark_lArI()) { @@ -1483,7 +1358,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_11 = base.limit - base.cursor; + /** @const */ var /** number */ v_11 = base.limit - base.cursor; lab18: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -1517,7 +1392,7 @@ TurkishStemmer = function() { /** @return {boolean} */ function r_stem_noun_suffixes() { lab0: { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -1529,7 +1404,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab2: { if (!r_stem_suffix_chain_before_ki()) { @@ -1551,10 +1426,10 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab4: { lab5: { - var /** number */ v_4 = base.limit - base.cursor; + /** @const */ var /** number */ v_4 = base.limit - base.cursor; lab6: { base.ket = base.cursor; if (!r_mark_lArI()) @@ -1572,7 +1447,7 @@ TurkishStemmer = function() { lab7: { base.ket = base.cursor; lab8: { - var /** number */ v_5 = base.limit - base.cursor; + /** @const */ var /** number */ v_5 = base.limit - base.cursor; lab9: { if (!r_mark_possessives()) { @@ -1591,7 +1466,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_6 = base.limit - base.cursor; + /** @const */ var /** number */ v_6 = base.limit - base.cursor; lab10: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -1637,7 +1512,7 @@ TurkishStemmer = function() { lab11: { base.ket = base.cursor; lab12: { - var /** number */ v_7 = base.limit - base.cursor; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; lab13: { if (!r_mark_ndA()) { @@ -1652,7 +1527,7 @@ TurkishStemmer = function() { } } lab14: { - var /** number */ v_8 = base.limit - base.cursor; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; lab15: { if (!r_mark_lArI()) { @@ -1676,7 +1551,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_9 = base.limit - base.cursor; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; lab17: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -1709,7 +1584,7 @@ TurkishStemmer = function() { lab18: { base.ket = base.cursor; lab19: { - var /** number */ v_10 = base.limit - base.cursor; + /** @const */ var /** number */ v_10 = base.limit - base.cursor; lab20: { if (!r_mark_ndAn()) { @@ -1724,7 +1599,7 @@ TurkishStemmer = function() { } } lab21: { - var /** number */ v_11 = base.limit - base.cursor; + /** @const */ var /** number */ v_11 = base.limit - base.cursor; lab22: { if (!r_mark_sU()) { @@ -1735,7 +1610,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_12 = base.limit - base.cursor; + /** @const */ var /** number */ v_12 = base.limit - base.cursor; lab23: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -1776,11 +1651,11 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_13 = base.limit - base.cursor; + /** @const */ var /** number */ v_13 = base.limit - base.cursor; lab25: { base.ket = base.cursor; lab26: { - var /** number */ v_14 = base.limit - base.cursor; + /** @const */ var /** number */ v_14 = base.limit - base.cursor; lab27: { if (!r_mark_possessives()) { @@ -1791,7 +1666,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_15 = base.limit - base.cursor; + /** @const */ var /** number */ v_15 = base.limit - base.cursor; lab28: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -1823,7 +1698,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_16 = base.limit - base.cursor; + /** @const */ var /** number */ v_16 = base.limit - base.cursor; lab30: { if (!r_stem_suffix_chain_before_ki()) { @@ -1847,7 +1722,7 @@ TurkishStemmer = function() { lab31: { base.ket = base.cursor; lab32: { - var /** number */ v_17 = base.limit - base.cursor; + /** @const */ var /** number */ v_17 = base.limit - base.cursor; lab33: { if (!r_mark_nUn()) { @@ -1866,10 +1741,10 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_18 = base.limit - base.cursor; + /** @const */ var /** number */ v_18 = base.limit - base.cursor; lab34: { lab35: { - var /** number */ v_19 = base.limit - base.cursor; + /** @const */ var /** number */ v_19 = base.limit - base.cursor; lab36: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -1891,7 +1766,7 @@ TurkishStemmer = function() { lab37: { base.ket = base.cursor; lab38: { - var /** number */ v_20 = base.limit - base.cursor; + /** @const */ var /** number */ v_20 = base.limit - base.cursor; lab39: { if (!r_mark_possessives()) { @@ -1910,7 +1785,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_21 = base.limit - base.cursor; + /** @const */ var /** number */ v_21 = base.limit - base.cursor; lab40: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -1967,7 +1842,7 @@ TurkishStemmer = function() { lab43: { base.ket = base.cursor; lab44: { - var /** number */ v_22 = base.limit - base.cursor; + /** @const */ var /** number */ v_22 = base.limit - base.cursor; lab45: { if (!r_mark_DA()) { @@ -1994,11 +1869,11 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_23 = base.limit - base.cursor; + /** @const */ var /** number */ v_23 = base.limit - base.cursor; lab47: { base.ket = base.cursor; lab48: { - var /** number */ v_24 = base.limit - base.cursor; + /** @const */ var /** number */ v_24 = base.limit - base.cursor; lab49: { if (!r_mark_possessives()) { @@ -2009,7 +1884,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_25 = base.limit - base.cursor; + /** @const */ var /** number */ v_25 = base.limit - base.cursor; lab50: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -2044,7 +1919,7 @@ TurkishStemmer = function() { base.cursor = base.limit - v_1; base.ket = base.cursor; lab51: { - var /** number */ v_26 = base.limit - base.cursor; + /** @const */ var /** number */ v_26 = base.limit - base.cursor; lab52: { if (!r_mark_possessives()) { @@ -2063,7 +1938,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_27 = base.limit - base.cursor; + /** @const */ var /** number */ v_27 = base.limit - base.cursor; lab53: { base.ket = base.cursor; if (!r_mark_lAr()) @@ -2127,9 +2002,10 @@ TurkishStemmer = function() { /** @return {boolean} */ function r_append_U_to_stems_ending_with_d_or_g() { - var /** number */ v_1 = base.limit - base.cursor; + base.ket = base.cursor; + base.bra = base.cursor; lab0: { - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("d"))) { @@ -2137,186 +2013,105 @@ TurkishStemmer = function() { } break lab0; } - base.cursor = base.limit - v_2; + base.cursor = base.limit - v_1; if (!(base.eq_s_b("g"))) { return false; } } - base.cursor = base.limit - v_1; + if (!base.go_out_grouping_b(g_vowel, 97, 305)) + { + return false; + } lab2: { - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; lab3: { - var /** number */ v_4 = base.limit - base.cursor; - golab4: while(true) - { - var /** number */ v_5 = base.limit - base.cursor; + lab4: { + /** @const */ var /** number */ v_3 = base.limit - base.cursor; lab5: { - if (!(base.in_grouping_b(g_vowel, 97, 305))) - { - break lab5; - } - base.cursor = base.limit - v_5; - break golab4; - } - base.cursor = base.limit - v_5; - if (base.cursor <= base.limit_backward) - { - break lab3; - } - base.cursor--; - } - lab6: { - var /** number */ v_6 = base.limit - base.cursor; - lab7: { if (!(base.eq_s_b("a"))) { - break lab7; + break lab5; } - break lab6; + break lab4; } - base.cursor = base.limit - v_6; + base.cursor = base.limit - v_3; if (!(base.eq_s_b("\u0131"))) { break lab3; } } - base.cursor = base.limit - v_4; + if (!base.slice_from("\u0131")) { - var /** number */ c1 = base.cursor; - base.insert(base.cursor, base.cursor, "\u0131"); - base.cursor = c1; + return false; } break lab2; } - base.cursor = base.limit - v_3; - lab8: { - var /** number */ v_7 = base.limit - base.cursor; - golab9: while(true) - { - var /** number */ v_8 = base.limit - base.cursor; - lab10: { - if (!(base.in_grouping_b(g_vowel, 97, 305))) - { - break lab10; - } - base.cursor = base.limit - v_8; - break golab9; - } - base.cursor = base.limit - v_8; - if (base.cursor <= base.limit_backward) - { - break lab8; - } - base.cursor--; - } - lab11: { - var /** number */ v_9 = base.limit - base.cursor; - lab12: { + base.cursor = base.limit - v_2; + lab6: { + lab7: { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab8: { if (!(base.eq_s_b("e"))) { - break lab12; + break lab8; } - break lab11; + break lab7; } - base.cursor = base.limit - v_9; + base.cursor = base.limit - v_4; if (!(base.eq_s_b("i"))) { - break lab8; + break lab6; } } - base.cursor = base.limit - v_7; + if (!base.slice_from("i")) { - var /** number */ c2 = base.cursor; - base.insert(base.cursor, base.cursor, "i"); - base.cursor = c2; + return false; } break lab2; } - base.cursor = base.limit - v_3; - lab13: { - var /** number */ v_10 = base.limit - base.cursor; - golab14: while(true) - { - var /** number */ v_11 = base.limit - base.cursor; - lab15: { - if (!(base.in_grouping_b(g_vowel, 97, 305))) - { - break lab15; - } - base.cursor = base.limit - v_11; - break golab14; - } - base.cursor = base.limit - v_11; - if (base.cursor <= base.limit_backward) - { - break lab13; - } - base.cursor--; - } - lab16: { - var /** number */ v_12 = base.limit - base.cursor; - lab17: { + base.cursor = base.limit - v_2; + lab9: { + lab10: { + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab11: { if (!(base.eq_s_b("o"))) { - break lab17; + break lab11; } - break lab16; + break lab10; } - base.cursor = base.limit - v_12; + base.cursor = base.limit - v_5; if (!(base.eq_s_b("u"))) { - break lab13; - } - } - base.cursor = base.limit - v_10; - { - var /** number */ c3 = base.cursor; - base.insert(base.cursor, base.cursor, "u"); - base.cursor = c3; - } - break lab2; - } - base.cursor = base.limit - v_3; - var /** number */ v_13 = base.limit - base.cursor; - golab18: while(true) - { - var /** number */ v_14 = base.limit - base.cursor; - lab19: { - if (!(base.in_grouping_b(g_vowel, 97, 305))) - { - break lab19; + break lab9; } - base.cursor = base.limit - v_14; - break golab18; } - base.cursor = base.limit - v_14; - if (base.cursor <= base.limit_backward) + if (!base.slice_from("u")) { return false; } - base.cursor--; + break lab2; } - lab20: { - var /** number */ v_15 = base.limit - base.cursor; - lab21: { + base.cursor = base.limit - v_2; + lab12: { + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + lab13: { if (!(base.eq_s_b("\u00F6"))) { - break lab21; + break lab13; } - break lab20; + break lab12; } - base.cursor = base.limit - v_15; + base.cursor = base.limit - v_6; if (!(base.eq_s_b("\u00FC"))) { return false; } } - base.cursor = base.limit - v_13; + if (!base.slice_from("\u00FC")) { - var /** number */ c4 = base.cursor; - base.insert(base.cursor, base.cursor, "\u00FC"); - base.cursor = c4; + return false; } } return true; @@ -2328,7 +2123,7 @@ TurkishStemmer = function() { { return false; } - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("soy"))) { @@ -2344,39 +2139,92 @@ TurkishStemmer = function() { }; /** @return {boolean} */ - function r_more_than_one_syllable_word() { - var /** number */ v_1 = base.cursor; - { - var v_2 = 2; - while(true) + function r_remove_proper_noun_suffix() { + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + base.bra = base.cursor; + golab1: while(true) { - var /** number */ v_3 = base.cursor; - lab0: { - golab1: while(true) + /** @const */ var /** number */ v_2 = base.cursor; + lab2: { { - lab2: { - if (!(base.in_grouping(g_vowel, 97, 305))) + /** @const */ var /** number */ v_3 = base.cursor; + lab3: { + if (!(base.eq_s("'"))) { - break lab2; + break lab3; } - break golab1; - } - if (base.cursor >= base.limit) - { - break lab0; + break lab2; } - base.cursor++; + base.cursor = v_3; } - v_2--; - continue; + base.cursor = v_2; + break golab1; } - base.cursor = v_3; - break; + base.cursor = v_2; + if (base.cursor >= base.limit) + { + break lab0; + } + base.cursor++; } - if (v_2 > 0) + base.ket = base.cursor; + if (!base.slice_del()) + { + return false; + } + } + base.cursor = v_1; + /** @const */ var /** number */ v_4 = base.cursor; + lab4: { + { + /** @const */ var /** number */ c1 = base.cursor + 2; + if (c1 > base.limit) + { + break lab4; + } + base.cursor = c1; + } + golab5: while(true) + { + /** @const */ var /** number */ v_5 = base.cursor; + lab6: { + if (!(base.eq_s("'"))) + { + break lab6; + } + base.cursor = v_5; + break golab5; + } + base.cursor = v_5; + if (base.cursor >= base.limit) + { + break lab4; + } + base.cursor++; + } + base.bra = base.cursor; + base.cursor = base.limit; + base.ket = base.cursor; + if (!base.slice_del()) + { + return false; + } + } + base.cursor = v_4; + return true; + }; + + /** @return {boolean} */ + function r_more_than_one_syllable_word() { + /** @const */ var /** number */ v_1 = base.cursor; + for (var /** number */ v_2 = 2; v_2 > 0; v_2--) + { + if (!base.go_out_grouping(g_vowel, 97, 305)) { return false; } + base.cursor++; } base.cursor = v_1; return true; @@ -2386,7 +2234,7 @@ TurkishStemmer = function() { function r_postlude() { base.limit_backward = base.cursor; base.cursor = base.limit; { - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; lab0: { if (!r_is_reserved_word()) { @@ -2396,10 +2244,10 @@ TurkishStemmer = function() { } base.cursor = base.limit - v_1; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; r_append_U_to_stems_ending_with_d_or_g(); base.cursor = base.limit - v_2; - var /** number */ v_3 = base.limit - base.cursor; + /** @const */ var /** number */ v_3 = base.limit - base.cursor; r_post_process_last_consonants(); base.cursor = base.limit - v_3; base.cursor = base.limit_backward; @@ -2407,19 +2255,20 @@ TurkishStemmer = function() { }; this.stem = /** @return {boolean} */ function() { + r_remove_proper_noun_suffix(); if (!r_more_than_one_syllable_word()) { return false; } base.limit_backward = base.cursor; base.cursor = base.limit; - var /** number */ v_1 = base.limit - base.cursor; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; r_stem_nominal_verb_suffixes(); base.cursor = base.limit - v_1; if (!B_continue_stemming_noun_suffixes) { return false; } - var /** number */ v_2 = base.limit - base.cursor; + /** @const */ var /** number */ v_2 = base.limit - base.cursor; r_stem_noun_suffixes(); base.cursor = base.limit - v_2; base.cursor = base.limit_backward; diff --git a/sphinx/search/non-minified-js/yiddish-stemmer.js b/sphinx/search/non-minified-js/yiddish-stemmer.js new file mode 100644 index 00000000000..b9a7ddb411c --- /dev/null +++ b/sphinx/search/non-minified-js/yiddish-stemmer.js @@ -0,0 +1,1160 @@ +// Generated from yiddish.sbl by Snowball 3.0.1 - https://snowballstem.org/ + +/**@constructor*/ +var YiddishStemmer = function() { + var base = new BaseStemmer(); + + /** @const */ var a_0 = [ + ["\u05D5\u05D5", -1, 1], + ["\u05D5\u05D9", -1, 2], + ["\u05D9\u05D9", -1, 3], + ["\u05DA", -1, 4], + ["\u05DD", -1, 5], + ["\u05DF", -1, 6], + ["\u05E3", -1, 7], + ["\u05E5", -1, 8] + ]; + + /** @const */ var a_1 = [ + ["\u05D0\u05D3\u05D5\u05E8\u05DB", -1, 1], + ["\u05D0\u05D4\u05D9\u05E0", -1, 1], + ["\u05D0\u05D4\u05E2\u05E8", -1, 1], + ["\u05D0\u05D4\u05F2\u05DE", -1, 1], + ["\u05D0\u05D5\u05DE", -1, 1], + ["\u05D0\u05D5\u05E0\u05D8\u05E2\u05E8", -1, 1], + ["\u05D0\u05D9\u05D1\u05E2\u05E8", -1, 1], + ["\u05D0\u05E0", -1, 1], + ["\u05D0\u05E0\u05D8", 7, 1], + ["\u05D0\u05E0\u05D8\u05E7\u05E2\u05D2\u05E0", 8, 1], + ["\u05D0\u05E0\u05D9\u05D3\u05E2\u05E8", 7, 1], + ["\u05D0\u05E4", -1, 1], + ["\u05D0\u05E4\u05D9\u05E8", 11, 1], + ["\u05D0\u05E7\u05E2\u05D2\u05E0", -1, 1], + ["\u05D0\u05E8\u05D0\u05E4", -1, 1], + ["\u05D0\u05E8\u05D5\u05DE", -1, 1], + ["\u05D0\u05E8\u05D5\u05E0\u05D8\u05E2\u05E8", -1, 1], + ["\u05D0\u05E8\u05D9\u05D1\u05E2\u05E8", -1, 1], + ["\u05D0\u05E8\u05F1\u05E1", -1, 1], + ["\u05D0\u05E8\u05F1\u05E4", -1, 1], + ["\u05D0\u05E8\u05F2\u05E0", -1, 1], + ["\u05D0\u05F0\u05E2\u05E7", -1, 1], + ["\u05D0\u05F1\u05E1", -1, 1], + ["\u05D0\u05F1\u05E4", -1, 1], + ["\u05D0\u05F2\u05E0", -1, 1], + ["\u05D1\u05D0", -1, 1], + ["\u05D1\u05F2", -1, 1], + ["\u05D3\u05D5\u05E8\u05DB", -1, 1], + ["\u05D3\u05E2\u05E8", -1, 1], + ["\u05DE\u05D9\u05D8", -1, 1], + ["\u05E0\u05D0\u05DB", -1, 1], + ["\u05E4\u05D0\u05E8", -1, 1], + ["\u05E4\u05D0\u05E8\u05D1\u05F2", 31, 1], + ["\u05E4\u05D0\u05E8\u05F1\u05E1", 31, 1], + ["\u05E4\u05D5\u05E0\u05D0\u05E0\u05D3\u05E2\u05E8", -1, 1], + ["\u05E6\u05D5", -1, 1], + ["\u05E6\u05D5\u05D6\u05D0\u05DE\u05E2\u05E0", 35, 1], + ["\u05E6\u05D5\u05E0\u05F1\u05E4", 35, 1], + ["\u05E6\u05D5\u05E8\u05D9\u05E7", 35, 1], + ["\u05E6\u05E2", -1, 1] + ]; + + /** @const */ var a_2 = [ + ["\u05D3\u05D6\u05E9", -1, -1], + ["\u05E9\u05D8\u05E8", -1, -1], + ["\u05E9\u05D8\u05E9", -1, -1], + ["\u05E9\u05E4\u05E8", -1, -1] + ]; + + /** @const */ var a_3 = [ + ["\u05E7\u05DC\u05D9\u05D1", -1, 9], + ["\u05E8\u05D9\u05D1", -1, 10], + ["\u05D8\u05E8\u05D9\u05D1", 1, 7], + ["\u05E9\u05E8\u05D9\u05D1", 1, 15], + ["\u05D4\u05F1\u05D1", -1, 23], + ["\u05E9\u05F0\u05D9\u05D2", -1, 12], + ["\u05D2\u05D0\u05E0\u05D2", -1, 1], + ["\u05D6\u05D5\u05E0\u05D2", -1, 18], + ["\u05E9\u05DC\u05D5\u05E0\u05D2", -1, 21], + ["\u05E6\u05F0\u05D5\u05E0\u05D2", -1, 20], + ["\u05D1\u05F1\u05D2", -1, 22], + ["\u05D1\u05D5\u05E0\u05D3", -1, 16], + ["\u05F0\u05D9\u05D6", -1, 6], + ["\u05D1\u05D9\u05D8", -1, 4], + ["\u05DC\u05D9\u05D8", -1, 8], + ["\u05DE\u05D9\u05D8", -1, 3], + ["\u05E9\u05E0\u05D9\u05D8", -1, 14], + ["\u05E0\u05D5\u05DE", -1, 2], + ["\u05E9\u05D8\u05D0\u05E0", -1, 25], + ["\u05D1\u05D9\u05E1", -1, 5], + ["\u05E9\u05DE\u05D9\u05E1", -1, 13], + ["\u05E8\u05D9\u05E1", -1, 11], + ["\u05D8\u05E8\u05D5\u05E0\u05E7", -1, 19], + ["\u05E4\u05D0\u05E8\u05DC\u05F1\u05E8", -1, 24], + ["\u05E9\u05F0\u05F1\u05E8", -1, 26], + ["\u05F0\u05D5\u05D8\u05E9", -1, 17] + ]; + + /** @const */ var a_4 = [ + ["\u05D5\u05E0\u05D2", -1, 1], + ["\u05E1\u05D8\u05D5", -1, 1], + ["\u05D8", -1, 1], + ["\u05D1\u05E8\u05D0\u05DB\u05D8", 2, 31], + ["\u05E1\u05D8", 2, 1], + ["\u05D9\u05E1\u05D8", 4, 33], + ["\u05E2\u05D8", 2, 1], + ["\u05E9\u05D0\u05E4\u05D8", 2, 1], + ["\u05D4\u05F2\u05D8", 2, 1], + ["\u05E7\u05F2\u05D8", 2, 1], + ["\u05D9\u05E7\u05F2\u05D8", 9, 1], + ["\u05DC\u05E2\u05DB", -1, 1], + ["\u05E2\u05DC\u05E2\u05DB", 11, 1], + ["\u05D9\u05D6\u05DE", -1, 1], + ["\u05D9\u05DE", -1, 1], + ["\u05E2\u05DE", -1, 1], + ["\u05E2\u05E0\u05E2\u05DE", 15, 3], + ["\u05D8\u05E2\u05E0\u05E2\u05DE", 16, 4], + ["\u05E0", -1, 1], + ["\u05E7\u05DC\u05D9\u05D1\u05E0", 18, 14], + ["\u05E8\u05D9\u05D1\u05E0", 18, 15], + ["\u05D8\u05E8\u05D9\u05D1\u05E0", 20, 12], + ["\u05E9\u05E8\u05D9\u05D1\u05E0", 20, 7], + ["\u05D4\u05F1\u05D1\u05E0", 18, 27], + ["\u05E9\u05F0\u05D9\u05D2\u05E0", 18, 17], + ["\u05D6\u05D5\u05E0\u05D2\u05E0", 18, 22], + ["\u05E9\u05DC\u05D5\u05E0\u05D2\u05E0", 18, 25], + ["\u05E6\u05F0\u05D5\u05E0\u05D2\u05E0", 18, 24], + ["\u05D1\u05F1\u05D2\u05E0", 18, 26], + ["\u05D1\u05D5\u05E0\u05D3\u05E0", 18, 20], + ["\u05F0\u05D9\u05D6\u05E0", 18, 11], + ["\u05D8\u05E0", 18, 4], + ["GE\u05D1\u05D9\u05D8\u05E0", 31, 9], + ["GE\u05DC\u05D9\u05D8\u05E0", 31, 13], + ["GE\u05DE\u05D9\u05D8\u05E0", 31, 8], + ["\u05E9\u05E0\u05D9\u05D8\u05E0", 31, 19], + ["\u05E1\u05D8\u05E0", 31, 1], + ["\u05D9\u05E1\u05D8\u05E0", 36, 1], + ["\u05E2\u05D8\u05E0", 31, 1], + ["GE\u05D1\u05D9\u05E1\u05E0", 18, 10], + ["\u05E9\u05DE\u05D9\u05E1\u05E0", 18, 18], + ["GE\u05E8\u05D9\u05E1\u05E0", 18, 16], + ["\u05E2\u05E0", 18, 1], + ["\u05D2\u05D0\u05E0\u05D2\u05E2\u05E0", 42, 5], + ["\u05E2\u05DC\u05E2\u05E0", 42, 1], + ["\u05E0\u05D5\u05DE\u05E2\u05E0", 42, 6], + ["\u05D9\u05D6\u05DE\u05E2\u05E0", 42, 1], + ["\u05E9\u05D8\u05D0\u05E0\u05E2\u05E0", 42, 29], + ["\u05D8\u05E8\u05D5\u05E0\u05E7\u05E0", 18, 23], + ["\u05E4\u05D0\u05E8\u05DC\u05F1\u05E8\u05E0", 18, 28], + ["\u05E9\u05F0\u05F1\u05E8\u05E0", 18, 30], + ["\u05F0\u05D5\u05D8\u05E9\u05E0", 18, 21], + ["\u05D2\u05F2\u05E0", 18, 5], + ["\u05E1", -1, 1], + ["\u05D8\u05E1", 53, 4], + ["\u05E2\u05D8\u05E1", 54, 1], + ["\u05E0\u05E1", 53, 1], + ["\u05D8\u05E0\u05E1", 56, 4], + ["\u05E2\u05E0\u05E1", 56, 3], + ["\u05E2\u05E1", 53, 1], + ["\u05D9\u05E2\u05E1", 59, 2], + ["\u05E2\u05DC\u05E2\u05E1", 59, 1], + ["\u05E2\u05E8\u05E1", 53, 1], + ["\u05E2\u05E0\u05E2\u05E8\u05E1", 62, 1], + ["\u05E2", -1, 1], + ["\u05D8\u05E2", 64, 4], + ["\u05E1\u05D8\u05E2", 65, 1], + ["\u05E2\u05D8\u05E2", 65, 1], + ["\u05D9\u05E2", 64, -1], + ["\u05E2\u05DC\u05E2", 64, 1], + ["\u05E2\u05E0\u05E2", 64, 3], + ["\u05D8\u05E2\u05E0\u05E2", 70, 4], + ["\u05E2\u05E8", -1, 1], + ["\u05D8\u05E2\u05E8", 72, 4], + ["\u05E1\u05D8\u05E2\u05E8", 73, 1], + ["\u05E2\u05D8\u05E2\u05E8", 73, 1], + ["\u05E2\u05E0\u05E2\u05E8", 72, 3], + ["\u05D8\u05E2\u05E0\u05E2\u05E8", 76, 4], + ["\u05D5\u05EA", -1, 32] + ]; + + /** @const */ var a_5 = [ + ["\u05D5\u05E0\u05D2", -1, 1], + ["\u05E9\u05D0\u05E4\u05D8", -1, 1], + ["\u05D4\u05F2\u05D8", -1, 1], + ["\u05E7\u05F2\u05D8", -1, 1], + ["\u05D9\u05E7\u05F2\u05D8", 3, 1], + ["\u05DC", -1, 2] + ]; + + /** @const */ var a_6 = [ + ["\u05D9\u05D2", -1, 1], + ["\u05D9\u05E7", -1, 1], + ["\u05D3\u05D9\u05E7", 1, 1], + ["\u05E0\u05D3\u05D9\u05E7", 2, 1], + ["\u05E2\u05E0\u05D3\u05D9\u05E7", 3, 1], + ["\u05D1\u05DC\u05D9\u05E7", 1, -1], + ["\u05D2\u05DC\u05D9\u05E7", 1, -1], + ["\u05E0\u05D9\u05E7", 1, 1], + ["\u05D9\u05E9", -1, 1] + ]; + + /** @const */ var /** Array */ g_niked = [255, 155, 6]; + + /** @const */ var /** Array */ g_vowel = [33, 2, 4, 0, 6]; + + /** @const */ var /** Array */ g_consonant = [239, 254, 253, 131]; + + var /** number */ I_x = 0; + var /** number */ I_p1 = 0; + + + /** @return {boolean} */ + function r_prelude() { + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + while(true) + { + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + golab2: while(true) + { + /** @const */ var /** number */ v_3 = base.cursor; + lab3: { + base.bra = base.cursor; + among_var = base.find_among(a_0); + if (among_var == 0) + { + break lab3; + } + base.ket = base.cursor; + switch (among_var) { + case 1: + { + /** @const */ var /** number */ v_4 = base.cursor; + lab4: { + if (!(base.eq_s("\u05BC"))) + { + break lab4; + } + break lab3; + } + base.cursor = v_4; + } + if (!base.slice_from("\u05F0")) + { + return false; + } + break; + case 2: + { + /** @const */ var /** number */ v_5 = base.cursor; + lab5: { + if (!(base.eq_s("\u05B4"))) + { + break lab5; + } + break lab3; + } + base.cursor = v_5; + } + if (!base.slice_from("\u05F1")) + { + return false; + } + break; + case 3: + { + /** @const */ var /** number */ v_6 = base.cursor; + lab6: { + if (!(base.eq_s("\u05B4"))) + { + break lab6; + } + break lab3; + } + base.cursor = v_6; + } + if (!base.slice_from("\u05F2")) + { + return false; + } + break; + case 4: + if (!base.slice_from("\u05DB")) + { + return false; + } + break; + case 5: + if (!base.slice_from("\u05DE")) + { + return false; + } + break; + case 6: + if (!base.slice_from("\u05E0")) + { + return false; + } + break; + case 7: + if (!base.slice_from("\u05E4")) + { + return false; + } + break; + case 8: + if (!base.slice_from("\u05E6")) + { + return false; + } + break; + } + base.cursor = v_3; + break golab2; + } + base.cursor = v_3; + if (base.cursor >= base.limit) + { + break lab1; + } + base.cursor++; + } + continue; + } + base.cursor = v_2; + break; + } + } + base.cursor = v_1; + /** @const */ var /** number */ v_7 = base.cursor; + lab7: { + while(true) + { + /** @const */ var /** number */ v_8 = base.cursor; + lab8: { + golab9: while(true) + { + /** @const */ var /** number */ v_9 = base.cursor; + lab10: { + base.bra = base.cursor; + if (!(base.in_grouping(g_niked, 1456, 1474))) + { + break lab10; + } + base.ket = base.cursor; + if (!base.slice_del()) + { + return false; + } + base.cursor = v_9; + break golab9; + } + base.cursor = v_9; + if (base.cursor >= base.limit) + { + break lab8; + } + base.cursor++; + } + continue; + } + base.cursor = v_8; + break; + } + } + base.cursor = v_7; + return true; + }; + + /** @return {boolean} */ + function r_mark_regions() { + I_p1 = base.limit; + /** @const */ var /** number */ v_1 = base.cursor; + lab0: { + base.bra = base.cursor; + if (!(base.eq_s("\u05D2\u05E2"))) + { + base.cursor = v_1; + break lab0; + } + base.ket = base.cursor; + { + /** @const */ var /** number */ v_2 = base.cursor; + lab1: { + lab2: { + /** @const */ var /** number */ v_3 = base.cursor; + lab3: { + if (!(base.eq_s("\u05DC\u05D8"))) + { + break lab3; + } + break lab2; + } + base.cursor = v_3; + lab4: { + if (!(base.eq_s("\u05D1\u05E0"))) + { + break lab4; + } + break lab2; + } + base.cursor = v_3; + if (base.cursor < base.limit) + { + break lab1; + } + } + base.cursor = v_1; + break lab0; + } + base.cursor = v_2; + } + if (!base.slice_from("GE")) + { + return false; + } + } + /** @const */ var /** number */ v_4 = base.cursor; + lab5: { + if (base.find_among(a_1) == 0) + { + base.cursor = v_4; + break lab5; + } + lab6: { + /** @const */ var /** number */ v_5 = base.cursor; + lab7: { + /** @const */ var /** number */ v_6 = base.cursor; + lab8: { + /** @const */ var /** number */ v_7 = base.cursor; + lab9: { + if (!(base.eq_s("\u05E6\u05D5\u05D2\u05E0"))) + { + break lab9; + } + break lab8; + } + base.cursor = v_7; + lab10: { + if (!(base.eq_s("\u05E6\u05D5\u05E7\u05D8"))) + { + break lab10; + } + break lab8; + } + base.cursor = v_7; + if (!(base.eq_s("\u05E6\u05D5\u05E7\u05E0"))) + { + break lab7; + } + } + if (base.cursor < base.limit) + { + break lab7; + } + base.cursor = v_6; + break lab6; + } + base.cursor = v_5; + lab11: { + /** @const */ var /** number */ v_8 = base.cursor; + if (!(base.eq_s("\u05D2\u05E2\u05D1\u05E0"))) + { + break lab11; + } + base.cursor = v_8; + break lab6; + } + base.cursor = v_5; + lab12: { + base.bra = base.cursor; + if (!(base.eq_s("\u05D2\u05E2"))) + { + break lab12; + } + base.ket = base.cursor; + if (!base.slice_from("GE")) + { + return false; + } + break lab6; + } + base.cursor = v_5; + base.bra = base.cursor; + if (!(base.eq_s("\u05E6\u05D5"))) + { + base.cursor = v_4; + break lab5; + } + base.ket = base.cursor; + if (!base.slice_from("TSU")) + { + return false; + } + } + } + /** @const */ var /** number */ v_9 = base.cursor; + { + /** @const */ var /** number */ c1 = base.cursor + 3; + if (c1 > base.limit) + { + return false; + } + base.cursor = c1; + } + I_x = base.cursor; + base.cursor = v_9; + /** @const */ var /** number */ v_10 = base.cursor; + lab13: { + if (base.find_among(a_2) == 0) + { + base.cursor = v_10; + break lab13; + } + } + { + /** @const */ var /** number */ v_11 = base.cursor; + lab14: { + if (!(base.in_grouping(g_consonant, 1489, 1520))) + { + break lab14; + } + if (!(base.in_grouping(g_consonant, 1489, 1520))) + { + break lab14; + } + if (!(base.in_grouping(g_consonant, 1489, 1520))) + { + break lab14; + } + I_p1 = base.cursor; + return false; + } + base.cursor = v_11; + } + if (!base.go_out_grouping(g_vowel, 1488, 1522)) + { + return false; + } + base.cursor++; + if (!base.go_in_grouping(g_vowel, 1488, 1522)) + { + return false; + } + I_p1 = base.cursor; + lab15: { + if (I_p1 >= I_x) + { + break lab15; + } + I_p1 = I_x; + } + return true; + }; + + /** @return {boolean} */ + function r_R1() { + return I_p1 <= base.cursor; + }; + + /** @return {boolean} */ + function r_R1plus3() { + return I_p1 <= (base.cursor + 3); + }; + + /** @return {boolean} */ + function r_standard_suffix() { + var /** number */ among_var; + /** @const */ var /** number */ v_1 = base.limit - base.cursor; + lab0: { + base.ket = base.cursor; + among_var = base.find_among_b(a_4); + if (among_var == 0) + { + break lab0; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R1()) + { + break lab0; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!r_R1()) + { + break lab0; + } + if (!base.slice_from("\u05D9\u05E2")) + { + return false; + } + break; + case 3: + if (!r_R1()) + { + break lab0; + } + if (!base.slice_del()) + { + return false; + } + base.ket = base.cursor; + among_var = base.find_among_b(a_3); + if (among_var == 0) + { + break lab0; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!base.slice_from("\u05D2\u05F2")) + { + return false; + } + break; + case 2: + if (!base.slice_from("\u05E0\u05E2\u05DE")) + { + return false; + } + break; + case 3: + if (!base.slice_from("\u05DE\u05F2\u05D3")) + { + return false; + } + break; + case 4: + if (!base.slice_from("\u05D1\u05F2\u05D8")) + { + return false; + } + break; + case 5: + if (!base.slice_from("\u05D1\u05F2\u05E1")) + { + return false; + } + break; + case 6: + if (!base.slice_from("\u05F0\u05F2\u05D6")) + { + return false; + } + break; + case 7: + if (!base.slice_from("\u05D8\u05E8\u05F2\u05D1")) + { + return false; + } + break; + case 8: + if (!base.slice_from("\u05DC\u05F2\u05D8")) + { + return false; + } + break; + case 9: + if (!base.slice_from("\u05E7\u05DC\u05F2\u05D1")) + { + return false; + } + break; + case 10: + if (!base.slice_from("\u05E8\u05F2\u05D1")) + { + return false; + } + break; + case 11: + if (!base.slice_from("\u05E8\u05F2\u05E1")) + { + return false; + } + break; + case 12: + if (!base.slice_from("\u05E9\u05F0\u05F2\u05D2")) + { + return false; + } + break; + case 13: + if (!base.slice_from("\u05E9\u05DE\u05F2\u05E1")) + { + return false; + } + break; + case 14: + if (!base.slice_from("\u05E9\u05E0\u05F2\u05D3")) + { + return false; + } + break; + case 15: + if (!base.slice_from("\u05E9\u05E8\u05F2\u05D1")) + { + return false; + } + break; + case 16: + if (!base.slice_from("\u05D1\u05D9\u05E0\u05D3")) + { + return false; + } + break; + case 17: + if (!base.slice_from("\u05F0\u05D9\u05D8\u05E9")) + { + return false; + } + break; + case 18: + if (!base.slice_from("\u05D6\u05D9\u05E0\u05D2")) + { + return false; + } + break; + case 19: + if (!base.slice_from("\u05D8\u05E8\u05D9\u05E0\u05E7")) + { + return false; + } + break; + case 20: + if (!base.slice_from("\u05E6\u05F0\u05D9\u05E0\u05D2")) + { + return false; + } + break; + case 21: + if (!base.slice_from("\u05E9\u05DC\u05D9\u05E0\u05D2")) + { + return false; + } + break; + case 22: + if (!base.slice_from("\u05D1\u05F2\u05D2")) + { + return false; + } + break; + case 23: + if (!base.slice_from("\u05D4\u05F2\u05D1")) + { + return false; + } + break; + case 24: + if (!base.slice_from("\u05E4\u05D0\u05E8\u05DC\u05D9\u05E8")) + { + return false; + } + break; + case 25: + if (!base.slice_from("\u05E9\u05D8\u05F2")) + { + return false; + } + break; + case 26: + if (!base.slice_from("\u05E9\u05F0\u05E2\u05E8")) + { + return false; + } + break; + } + break; + case 4: + lab1: { + /** @const */ var /** number */ v_2 = base.limit - base.cursor; + lab2: { + if (!r_R1()) + { + break lab2; + } + if (!base.slice_del()) + { + return false; + } + break lab1; + } + base.cursor = base.limit - v_2; + if (!base.slice_from("\u05D8")) + { + return false; + } + } + base.ket = base.cursor; + if (!(base.eq_s_b("\u05D1\u05E8\u05D0\u05DB"))) + { + break lab0; + } + /** @const */ var /** number */ v_3 = base.limit - base.cursor; + lab3: { + if (!(base.eq_s_b("\u05D2\u05E2"))) + { + base.cursor = base.limit - v_3; + break lab3; + } + } + base.bra = base.cursor; + if (!base.slice_from("\u05D1\u05E8\u05E2\u05E0\u05D2")) + { + return false; + } + break; + case 5: + if (!base.slice_from("\u05D2\u05F2")) + { + return false; + } + break; + case 6: + if (!base.slice_from("\u05E0\u05E2\u05DE")) + { + return false; + } + break; + case 7: + if (!base.slice_from("\u05E9\u05E8\u05F2\u05D1")) + { + return false; + } + break; + case 8: + if (!base.slice_from("\u05DE\u05F2\u05D3")) + { + return false; + } + break; + case 9: + if (!base.slice_from("\u05D1\u05F2\u05D8")) + { + return false; + } + break; + case 10: + if (!base.slice_from("\u05D1\u05F2\u05E1")) + { + return false; + } + break; + case 11: + if (!base.slice_from("\u05F0\u05F2\u05D6")) + { + return false; + } + break; + case 12: + if (!base.slice_from("\u05D8\u05E8\u05F2\u05D1")) + { + return false; + } + break; + case 13: + if (!base.slice_from("\u05DC\u05F2\u05D8")) + { + return false; + } + break; + case 14: + if (!base.slice_from("\u05E7\u05DC\u05F2\u05D1")) + { + return false; + } + break; + case 15: + if (!base.slice_from("\u05E8\u05F2\u05D1")) + { + return false; + } + break; + case 16: + if (!base.slice_from("\u05E8\u05F2\u05E1")) + { + return false; + } + break; + case 17: + if (!base.slice_from("\u05E9\u05F0\u05F2\u05D2")) + { + return false; + } + break; + case 18: + if (!base.slice_from("\u05E9\u05DE\u05F2\u05E1")) + { + return false; + } + break; + case 19: + if (!base.slice_from("\u05E9\u05E0\u05F2\u05D3")) + { + return false; + } + break; + case 20: + if (!base.slice_from("\u05D1\u05D9\u05E0\u05D3")) + { + return false; + } + break; + case 21: + if (!base.slice_from("\u05F0\u05D9\u05D8\u05E9")) + { + return false; + } + break; + case 22: + if (!base.slice_from("\u05D6\u05D9\u05E0\u05D2")) + { + return false; + } + break; + case 23: + if (!base.slice_from("\u05D8\u05E8\u05D9\u05E0\u05E7")) + { + return false; + } + break; + case 24: + if (!base.slice_from("\u05E6\u05F0\u05D9\u05E0\u05D2")) + { + return false; + } + break; + case 25: + if (!base.slice_from("\u05E9\u05DC\u05D9\u05E0\u05D2")) + { + return false; + } + break; + case 26: + if (!base.slice_from("\u05D1\u05F2\u05D2")) + { + return false; + } + break; + case 27: + if (!base.slice_from("\u05D4\u05F2\u05D1")) + { + return false; + } + break; + case 28: + if (!base.slice_from("\u05E4\u05D0\u05E8\u05DC\u05D9\u05E8")) + { + return false; + } + break; + case 29: + if (!base.slice_from("\u05E9\u05D8\u05F2")) + { + return false; + } + break; + case 30: + if (!base.slice_from("\u05E9\u05F0\u05E2\u05E8")) + { + return false; + } + break; + case 31: + if (!base.slice_from("\u05D1\u05E8\u05E2\u05E0\u05D2")) + { + return false; + } + break; + case 32: + if (!r_R1()) + { + break lab0; + } + if (!base.slice_from("\u05D4")) + { + return false; + } + break; + case 33: + lab4: { + /** @const */ var /** number */ v_4 = base.limit - base.cursor; + lab5: { + lab6: { + /** @const */ var /** number */ v_5 = base.limit - base.cursor; + lab7: { + if (!(base.eq_s_b("\u05D2"))) + { + break lab7; + } + break lab6; + } + base.cursor = base.limit - v_5; + if (!(base.eq_s_b("\u05E9"))) + { + break lab5; + } + } + /** @const */ var /** number */ v_6 = base.limit - base.cursor; + lab8: { + if (!r_R1plus3()) + { + base.cursor = base.limit - v_6; + break lab8; + } + if (!base.slice_from("\u05D9\u05E1")) + { + return false; + } + } + break lab4; + } + base.cursor = base.limit - v_4; + if (!r_R1()) + { + break lab0; + } + if (!base.slice_del()) + { + return false; + } + } + break; + } + } + base.cursor = base.limit - v_1; + /** @const */ var /** number */ v_7 = base.limit - base.cursor; + lab9: { + base.ket = base.cursor; + among_var = base.find_among_b(a_5); + if (among_var == 0) + { + break lab9; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R1()) + { + break lab9; + } + if (!base.slice_del()) + { + return false; + } + break; + case 2: + if (!r_R1()) + { + break lab9; + } + if (!(base.in_grouping_b(g_consonant, 1489, 1520))) + { + break lab9; + } + if (!base.slice_del()) + { + return false; + } + break; + } + } + base.cursor = base.limit - v_7; + /** @const */ var /** number */ v_8 = base.limit - base.cursor; + lab10: { + base.ket = base.cursor; + among_var = base.find_among_b(a_6); + if (among_var == 0) + { + break lab10; + } + base.bra = base.cursor; + switch (among_var) { + case 1: + if (!r_R1()) + { + break lab10; + } + if (!base.slice_del()) + { + return false; + } + break; + } + } + base.cursor = base.limit - v_8; + /** @const */ var /** number */ v_9 = base.limit - base.cursor; + lab11: { + while(true) + { + /** @const */ var /** number */ v_10 = base.limit - base.cursor; + lab12: { + golab13: while(true) + { + /** @const */ var /** number */ v_11 = base.limit - base.cursor; + lab14: { + base.ket = base.cursor; + lab15: { + /** @const */ var /** number */ v_12 = base.limit - base.cursor; + lab16: { + if (!(base.eq_s_b("GE"))) + { + break lab16; + } + break lab15; + } + base.cursor = base.limit - v_12; + if (!(base.eq_s_b("TSU"))) + { + break lab14; + } + } + base.bra = base.cursor; + if (!base.slice_del()) + { + return false; + } + base.cursor = base.limit - v_11; + break golab13; + } + base.cursor = base.limit - v_11; + if (base.cursor <= base.limit_backward) + { + break lab12; + } + base.cursor--; + } + continue; + } + base.cursor = base.limit - v_10; + break; + } + } + base.cursor = base.limit - v_9; + return true; + }; + + this.stem = /** @return {boolean} */ function() { + r_prelude(); + /** @const */ var /** number */ v_1 = base.cursor; + r_mark_regions(); + base.cursor = v_1; + base.limit_backward = base.cursor; base.cursor = base.limit; + r_standard_suffix(); + base.cursor = base.limit_backward; + return true; + }; + + /**@return{string}*/ + this['stemWord'] = function(/**string*/word) { + base.setCurrent(word); + this.stem(); + return base.getCurrent(); + }; +}; diff --git a/sphinx/search/pt.py b/sphinx/search/pt.py index bf9b7a3a2f8..a10e4cd2b53 100644 --- a/sphinx/search/pt.py +++ b/sphinx/search/pt.py @@ -1,258 +1,21 @@ -"""Portuguese search language: includes the JS Portuguese stemmer.""" +"""Portuguese search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -portuguese_stopwords = parse_stop_word(""" -| source: https://snowball.tartarus.org/algorithms/portuguese/stop.txt -de | of, from -a | the; to, at; her -o | the; him -que | who, that -e | and -do | de + o -da | de + a -em | in -um | a -para | for - | é from SER -com | with -não | not, no -uma | a -os | the; them -no | em + o -se | himself etc -na | em + a -por | for -mais | more -as | the; them -dos | de + os -como | as, like -mas | but - | foi from SER -ao | a + o -ele | he -das | de + as - | tem from TER -à | a + a -seu | his -sua | her -ou | or - | ser from SER -quando | when -muito | much - | há from HAV -nos | em + os; us -já | already, now - | está from EST -eu | I -também | also -só | only, just -pelo | per + o -pela | per + a -até | up to -isso | that -ela | he -entre | between - | era from SER -depois | after -sem | without -mesmo | same -aos | a + os - | ter from TER -seus | his -quem | whom -nas | em + as -me | me -esse | that -eles | they - | estão from EST -você | you - | tinha from TER - | foram from SER -essa | that -num | em + um -nem | nor -suas | her -meu | my -às | a + as -minha | my - | têm from TER -numa | em + uma -pelos | per + os -elas | they - | havia from HAV - | seja from SER -qual | which - | será from SER -nós | we - | tenho from TER -lhe | to him, her -deles | of them -essas | those -esses | those -pelas | per + as -este | this - | fosse from SER -dele | of him - - | other words. There are many contractions such as naquele = em+aquele, - | mo = me+o, but they are rare. - | Indefinite article plural forms are also rare. - -tu | thou -te | thee -vocês | you (plural) -vos | you -lhes | to them -meus | my -minhas -teu | thy -tua -teus -tuas -nosso | our -nossa -nossos -nossas - -dela | of her -delas | of them - -esta | this -estes | these -estas | these -aquele | that -aquela | that -aqueles | those -aquelas | those -isto | this -aquilo | that - - | forms of estar, to be (not including the infinitive): -estou -está -estamos -estão -estive -esteve -estivemos -estiveram -estava -estávamos -estavam -estivera -estivéramos -esteja -estejamos -estejam -estivesse -estivéssemos -estivessem -estiver -estivermos -estiverem - - | forms of haver, to have (not including the infinitive): -hei -há -havemos -hão -houve -houvemos -houveram -houvera -houvéramos -haja -hajamos -hajam -houvesse -houvéssemos -houvessem -houver -houvermos -houverem -houverei -houverá -houveremos -houverão -houveria -houveríamos -houveriam - - | forms of ser, to be (not including the infinitive): -sou -somos -são -era -éramos -eram -fui -foi -fomos -foram -fora -fôramos -seja -sejamos -sejam -fosse -fôssemos -fossem -for -formos -forem -serei -será -seremos -serão -seria -seríamos -seriam - - | forms of ter, to have (not including the infinitive): -tenho -tem -temos -tém -tinha -tínhamos -tinham -tive -teve -tivemos -tiveram -tivera -tivéramos -tenha -tenhamos -tenham -tivesse -tivéssemos -tivessem -tiver -tivermos -tiverem -terei -terá -teremos -terão -teria -teríamos -teriam -""") +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.pt import PORTUGUESE_STOPWORDS class SearchPortuguese(SearchLanguage): lang = 'pt' language_name = 'Portuguese' js_stemmer_rawcode = 'portuguese-stemmer.js' - stopwords = portuguese_stopwords + stopwords = PORTUGUESE_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('portuguese') def stem(self, word: str) -> str: diff --git a/sphinx/search/ro.py b/sphinx/search/ro.py index 0c00486319a..e9d29602f4e 100644 --- a/sphinx/search/ro.py +++ b/sphinx/search/ro.py @@ -1,4 +1,4 @@ -"""Romanian search language: includes the JS Romanian stemmer.""" +"""Romanian search language.""" from __future__ import annotations @@ -11,9 +11,10 @@ class SearchRomanian(SearchLanguage): lang = 'ro' language_name = 'Romanian' js_stemmer_rawcode = 'romanian-stemmer.js' - stopwords: set[str] = set() + stopwords = frozenset() - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('romanian') def stem(self, word: str) -> str: diff --git a/sphinx/search/ru.py b/sphinx/search/ru.py index e93046cba94..584b19b9f79 100644 --- a/sphinx/search/ru.py +++ b/sphinx/search/ru.py @@ -1,248 +1,21 @@ -"""Russian search language: includes the JS Russian stemmer.""" +"""Russian search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -russian_stopwords = parse_stop_word(""" -| source: https://snowball.tartarus.org/algorithms/russian/stop.txt -и | and -в | in/into -во | alternative form -не | not -что | what/that -он | he -на | on/onto -я | i -с | from -со | alternative form -как | how -а | milder form of `no' (but) -то | conjunction and form of `that' -все | all -она | she -так | so, thus -его | him -но | but -да | yes/and -ты | thou -к | towards, by -у | around, chez -же | intensifier particle -вы | you -за | beyond, behind -бы | conditional/subj. particle -по | up to, along -только | only -ее | her -мне | to me -было | it was -вот | here is/are, particle -от | away from -меня | me -еще | still, yet, more -нет | no, there isnt/arent -о | about -из | out of -ему | to him -теперь | now -когда | when -даже | even -ну | so, well -вдруг | suddenly -ли | interrogative particle -если | if -уже | already, but homonym of `narrower' -или | or -ни | neither -быть | to be -был | he was -него | prepositional form of его -до | up to -вас | you accusative -нибудь | indef. suffix preceded by hyphen -опять | again -уж | already, but homonym of `adder' -вам | to you -сказал | he said -ведь | particle `after all' -там | there -потом | then -себя | oneself -ничего | nothing -ей | to her -может | usually with `быть' as `maybe' -они | they -тут | here -где | where -есть | there is/are -надо | got to, must -ней | prepositional form of ей -для | for -мы | we -тебя | thee -их | them, their -чем | than -была | she was -сам | self -чтоб | in order to -без | without -будто | as if -человек | man, person, one -чего | genitive form of `what' -раз | once -тоже | also -себе | to oneself -под | beneath -жизнь | life -будет | will be -ж | short form of intensifer particle `же' -тогда | then -кто | who -этот | this -говорил | was saying -того | genitive form of `that' -потому | for that reason -этого | genitive form of `this' -какой | which -совсем | altogether -ним | prepositional form of `его', `они' -здесь | here -этом | prepositional form of `этот' -один | one -почти | almost -мой | my -тем | instrumental/dative plural of `тот', `то' -чтобы | full form of `in order that' -нее | her (acc.) -кажется | it seems -сейчас | now -были | they were -куда | where to -зачем | why -сказать | to say -всех | all (acc., gen. preposn. plural) -никогда | never -сегодня | today -можно | possible, one can -при | by -наконец | finally -два | two -об | alternative form of `о', about -другой | another -хоть | even -после | after -над | above -больше | more -тот | that one (masc.) -через | across, in -эти | these -нас | us -про | about -всего | in all, only, of all -них | prepositional form of `они' (they) -какая | which, feminine -много | lots -разве | interrogative particle -сказала | she said -три | three -эту | this, acc. fem. sing. -моя | my, feminine -впрочем | moreover, besides -хорошо | good -свою | ones own, acc. fem. sing. -этой | oblique form of `эта', fem. `this' -перед | in front of -иногда | sometimes -лучше | better -чуть | a little -том | preposn. form of `that one' -нельзя | one must not -такой | such a one -им | to them -более | more -всегда | always -конечно | of course -всю | acc. fem. sing of `all' -между | between - - - | b: some paradigms - | - | personal pronouns - | - | я меня мне мной [мною] - | ты тебя тебе тобой [тобою] - | он его ему им [него, нему, ним] - | она ее эи ею [нее, нэи, нею] - | оно его ему им [него, нему, ним] - | - | мы нас нам нами - | вы вас вам вами - | они их им ими [них, ним, ними] - | - | себя себе собой [собою] - | - | demonstrative pronouns: этот (this), тот (that) - | - | этот эта это эти - | этого эты это эти - | этого этой этого этих - | этому этой этому этим - | этим этой этим [этою] этими - | этом этой этом этих - | - | тот та то те - | того ту то те - | того той того тех - | тому той тому тем - | тем той тем [тою] теми - | том той том тех - | - | determinative pronouns - | - | (a) весь (all) - | - | весь вся все все - | всего всю все все - | всего всей всего всех - | всему всей всему всем - | всем всей всем [всею] всеми - | всем всей всем всех - | - | (b) сам (himself etc) - | - | сам сама само сами - | самого саму само самих - | самого самой самого самих - | самому самой самому самим - | самим самой самим [самою] самими - | самом самой самом самих - | - | stems of verbs `to be', `to have', `to do' and modal - | - | быть бы буд быв есть суть - | име - | дел - | мог мож мочь - | уме - | хоч хот - | долж - | можн - | нужн - | нельзя -""") +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.ru import RUSSIAN_STOPWORDS class SearchRussian(SearchLanguage): lang = 'ru' language_name = 'Russian' js_stemmer_rawcode = 'russian-stemmer.js' - stopwords = russian_stopwords + stopwords = RUSSIAN_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('russian') def stem(self, word: str) -> str: diff --git a/sphinx/search/sv.py b/sphinx/search/sv.py index b4fa1bd06a2..8b138ebdf80 100644 --- a/sphinx/search/sv.py +++ b/sphinx/search/sv.py @@ -1,137 +1,21 @@ -"""Swedish search language: includes the JS Swedish stemmer.""" +"""Swedish search language.""" from __future__ import annotations import snowballstemmer -from sphinx.search import SearchLanguage, parse_stop_word - -swedish_stopwords = parse_stop_word(""" -| source: https://snowball.tartarus.org/algorithms/swedish/stop.txt -och | and -det | it, this/that -att | to (with infinitive) -i | in, at -en | a -jag | I -hon | she -som | who, that -han | he -på | on -den | it, this/that -med | with -var | where, each -sig | him(self) etc -för | for -så | so (also: seed) -till | to -är | is -men | but -ett | a -om | if; around, about -hade | had -de | they, these/those -av | of -icke | not, no -mig | me -du | you -henne | her -då | then, when -sin | his -nu | now -har | have -inte | inte någon = no one -hans | his -honom | him -skulle | 'sake' -hennes | her -där | there -min | my -man | one (pronoun) -ej | nor -vid | at, by, on (also: vast) -kunde | could -något | some etc -från | from, off -ut | out -när | when -efter | after, behind -upp | up -vi | we -dem | them -vara | be -vad | what -över | over -än | than -dig | you -kan | can -sina | his -här | here -ha | have -mot | towards -alla | all -under | under (also: wonder) -någon | some etc -eller | or (else) -allt | all -mycket | much -sedan | since -ju | why -denna | this/that -själv | myself, yourself etc -detta | this/that -åt | to -utan | without -varit | was -hur | how -ingen | no -mitt | my -ni | you -bli | to be, become -blev | from bli -oss | us -din | thy -dessa | these/those -några | some etc -deras | their -blir | from bli -mina | my -samma | (the) same -vilken | who, that -er | you, your -sådan | such a -vår | our -blivit | from bli -dess | its -inom | within -mellan | between -sådant | such a -varför | why -varje | each -vilka | who, that -ditt | thy -vem | who -vilket | who, that -sitta | his -sådana | such a -vart | each -dina | thy -vars | whose -vårt | our -våra | our -ert | your -era | your -vilkas | whose -""") +from sphinx.search import SearchLanguage +from sphinx.search._stopwords.sv import SWEDISH_STOPWORDS class SearchSwedish(SearchLanguage): lang = 'sv' language_name = 'Swedish' js_stemmer_rawcode = 'swedish-stemmer.js' - stopwords = swedish_stopwords + stopwords = SWEDISH_STOPWORDS - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('swedish') def stem(self, word: str) -> str: diff --git a/sphinx/search/tr.py b/sphinx/search/tr.py index b999e1d96d8..40131f0e372 100644 --- a/sphinx/search/tr.py +++ b/sphinx/search/tr.py @@ -1,4 +1,4 @@ -"""Turkish search language: includes the JS Turkish stemmer.""" +"""Turkish search language.""" from __future__ import annotations @@ -11,9 +11,10 @@ class SearchTurkish(SearchLanguage): lang = 'tr' language_name = 'Turkish' js_stemmer_rawcode = 'turkish-stemmer.js' - stopwords: set[str] = set() + stopwords = frozenset() - def init(self, options: dict[str, str]) -> None: + def __init__(self, options: dict[str, str]) -> None: + super().__init__(options) self.stemmer = snowballstemmer.stemmer('turkish') def stem(self, word: str) -> str: diff --git a/sphinx/search/zh.py b/sphinx/search/zh.py index 0f7e4dfd5f9..0fbd08e1a2d 100644 --- a/sphinx/search/zh.py +++ b/sphinx/search/zh.py @@ -9,14 +9,16 @@ import snowballstemmer from sphinx.search import SearchLanguage +from sphinx.search._stopwords.en import ENGLISH_STOPWORDS if TYPE_CHECKING: from collections.abc import Iterator try: import jieba # type: ignore[import-not-found] - from jieba import cut_for_search - from jieba import load_userdict as jieba_load_userdict + + jieba_load_userdict = jieba.load_userdict + cut_for_search = jieba.cut_for_search except ImportError: JIEBA_DEFAULT_DICT = '' @@ -32,219 +34,19 @@ def cut_for_search(sentence: str, HMM: bool = True) -> Iterator[str]: ) del jieba -english_stopwords = { - 'a', 'and', 'are', 'as', 'at', - 'be', 'but', 'by', - 'for', - 'if', 'in', 'into', 'is', 'it', - 'near', 'no', 'not', - 'of', 'on', 'or', - 'such', - 'that', 'the', 'their', 'then', 'there', 'these', 'they', 'this', 'to', - 'was', 'will', 'with', -} # fmt: skip - -js_porter_stemmer = """ -/** - * Porter Stemmer - */ -var Stemmer = function() { - - var step2list = { - ational: 'ate', - tional: 'tion', - enci: 'ence', - anci: 'ance', - izer: 'ize', - bli: 'ble', - alli: 'al', - entli: 'ent', - eli: 'e', - ousli: 'ous', - ization: 'ize', - ation: 'ate', - ator: 'ate', - alism: 'al', - iveness: 'ive', - fulness: 'ful', - ousness: 'ous', - aliti: 'al', - iviti: 'ive', - biliti: 'ble', - logi: 'log' - }; - - var step3list = { - icate: 'ic', - ative: '', - alize: 'al', - iciti: 'ic', - ical: 'ic', - ful: '', - ness: '' - }; - - var c = "[^aeiou]"; // consonant - var v = "[aeiouy]"; // vowel - var C = c + "[^aeiouy]*"; // consonant sequence - var V = v + "[aeiou]*"; // vowel sequence - - var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 - var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 - var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 - var s_v = "^(" + C + ")?" + v; // vowel in stem - - this.stemWord = function (w) { - var stem; - var suffix; - var firstch; - var origword = w; - - if (w.length < 3) - return w; - - var re; - var re2; - var re3; - var re4; - - firstch = w.substr(0,1); - if (firstch == "y") - w = firstch.toUpperCase() + w.substr(1); - - // Step 1a - re = /^(.+?)(ss|i)es$/; - re2 = /^(.+?)([^s])s$/; - - if (re.test(w)) - w = w.replace(re,"$1$2"); - else if (re2.test(w)) - w = w.replace(re2,"$1$2"); - - // Step 1b - re = /^(.+?)eed$/; - re2 = /^(.+?)(ed|ing)$/; - if (re.test(w)) { - var fp = re.exec(w); - re = new RegExp(mgr0); - if (re.test(fp[1])) { - re = /.$/; - w = w.replace(re,""); - } - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1]; - re2 = new RegExp(s_v); - if (re2.test(stem)) { - w = stem; - re2 = /(at|bl|iz)$/; - re3 = new RegExp("([^aeiouylsz])\\\\1$"); - re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re2.test(w)) - w = w + "e"; - else if (re3.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - else if (re4.test(w)) - w = w + "e"; - } - } - - // Step 1c - re = /^(.+?)y$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(s_v); - if (re.test(stem)) - w = stem + "i"; - } - - // Step 2 - re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|\ -ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step2list[suffix]; - } - - // Step 3 - re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step3list[suffix]; - } - - // Step 4 - re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|\ -iti|ous|ive|ize)$/; - re2 = /^(.+?)(s|t)(ion)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - if (re.test(stem)) - w = stem; - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1] + fp[2]; - re2 = new RegExp(mgr1); - if (re2.test(stem)) - w = stem; - } - - // Step 5 - re = /^(.+?)e$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - re2 = new RegExp(meq1); - re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) - w = stem; - } - re = /ll$/; - re2 = new RegExp(mgr1); - if (re.test(w) && re2.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - - // and turn initial Y back to y - if (firstch == "y") - w = firstch.toLowerCase() + w.substr(1); - return w; - } -} -""" - class SearchChinese(SearchLanguage): """Chinese search implementation""" lang = 'zh' language_name = 'Chinese' - js_stemmer_code = js_porter_stemmer - stopwords = english_stopwords + js_stemmer_rawcode = 'english-stemmer.js' + stopwords = ENGLISH_STOPWORDS latin1_letters = re.compile(r'[a-zA-Z0-9_]+') def __init__(self, options: dict[str, str]) -> None: super().__init__(options) self.latin_terms: set[str] = set() - - def init(self, options: dict[str, str]) -> None: dict_path = options.get('dict', JIEBA_DEFAULT_DICT) if dict_path and Path(dict_path).is_file(): jieba_load_userdict(str(dict_path)) diff --git a/sphinx/templates/latex/latex.tex.jinja b/sphinx/templates/latex/latex.tex.jinja index deb030504db..4ba2c46a793 100644 --- a/sphinx/templates/latex/latex.tex.jinja +++ b/sphinx/templates/latex/latex.tex.jinja @@ -16,6 +16,7 @@ \ifdefined\pdfimageresolution \pdfimageresolution= \numexpr \dimexpr1in\relax/\sphinxpxdimen\relax \fi +\newdimen\sphinxremdimen\sphinxremdimen = <%= pointsize%> %% let collapsible pdf bookmarks panel have high depth per default \PassOptionsToPackage{bookmarksdepth=5}{hyperref} <% if use_xindy -%> diff --git a/sphinx/templates/latex/tabulary.tex.jinja b/sphinx/templates/latex/tabulary.tex.jinja index 6ebcec6d264..7ba065ed1a7 100644 --- a/sphinx/templates/latex/tabulary.tex.jinja +++ b/sphinx/templates/latex/tabulary.tex.jinja @@ -21,6 +21,9 @@ <% if 'nocolorrows' in table.styles -%> \sphinxthistablewithnocolorrowsstyle <% endif -%> +<% if table.is_nested -%> +\sphinxthistabularywithnohlinesifinlongtable +<% endif -%> <% if table.align -%> <%- if table.align in ('center', 'default') -%> \centering diff --git a/sphinx/testing/fixtures.py b/sphinx/testing/fixtures.py index ec143faccf4..c6fdebe6e23 100644 --- a/sphinx/testing/fixtures.py +++ b/sphinx/testing/fixtures.py @@ -143,7 +143,7 @@ def test_params(request: Any) -> dict[str, Any]: if result['shared_result'] and not isinstance(result['shared_result'], str): msg = 'You can only provide a string type of value for "shared_result"' - raise pytest.Exception(msg) + pytest.fail(msg) return result @@ -151,7 +151,7 @@ def test_params(request: Any) -> dict[str, Any]: def app( test_params: dict[str, Any], app_params: _app_params, - make_app: Callable[[], SphinxTestApp], + make_app: Callable[..., SphinxTestApp], shared_result: SharedResult, ) -> Iterator[SphinxTestApp]: """Provides the 'sphinx.application.Sphinx' object""" @@ -183,7 +183,7 @@ def warning(app: SphinxTestApp) -> StringIO: @pytest.fixture -def make_app(test_params: dict[str, Any]) -> Iterator[Callable[[], SphinxTestApp]]: +def make_app(test_params: dict[str, Any]) -> Iterator[Callable[..., SphinxTestApp]]: """Provides make_app function to initialize SphinxTestApp instance. if you want to initialize 'app' in your test function. please use this instead of using SphinxTestApp class directory. diff --git a/sphinx/testing/path.py b/sphinx/testing/path.py deleted file mode 100644 index fe91c66143b..00000000000 --- a/sphinx/testing/path.py +++ /dev/null @@ -1,200 +0,0 @@ -from __future__ import annotations - -import os -import shutil -import sys -import warnings -from typing import TYPE_CHECKING - -from sphinx.deprecation import RemovedInSphinx90Warning - -if TYPE_CHECKING: - import builtins - from collections.abc import Callable - from typing import IO, Any - -warnings.warn( - "'sphinx.testing.path' is deprecated. Use 'os.path' or 'pathlib' instead.", - RemovedInSphinx90Warning, - stacklevel=2, -) - -FILESYSTEMENCODING = sys.getfilesystemencoding() or sys.getdefaultencoding() - - -def getumask() -> int: - """Get current umask value""" - umask = os.umask(0) # Note: Change umask value temporarily to obtain it - os.umask(umask) - - return umask - - -UMASK = getumask() - - -class path(str): # NoQA: FURB189 - """Represents a path which behaves like a string.""" - - __slots__ = () - - @property - def parent(self) -> path: - """The name of the directory the file or directory is in.""" - return self.__class__(os.path.dirname(self)) - - def basename(self) -> str: - return os.path.basename(self) - - def abspath(self) -> path: - """Returns the absolute path.""" - return self.__class__(os.path.abspath(self)) - - def isabs(self) -> bool: - """Returns ``True`` if the path is absolute.""" - return os.path.isabs(self) - - def isdir(self) -> bool: - """Returns ``True`` if the path is a directory.""" - return os.path.isdir(self) - - is_dir = isdir - - def isfile(self) -> bool: - """Returns ``True`` if the path is a file.""" - return os.path.isfile(self) - - is_file = isfile - - def islink(self) -> bool: - """Returns ``True`` if the path is a symbolic link.""" - return os.path.islink(self) - - is_symlink = islink - - def ismount(self) -> bool: - """Returns ``True`` if the path is a mount point.""" - return os.path.ismount(self) - - is_mount = ismount - - def rmtree( - self, - ignore_errors: bool = False, - onerror: Callable[[Callable[..., Any], str, Any], object] | None = None, - ) -> None: - """Removes the file or directory and any files or directories it may - contain. - - :param ignore_errors: - If ``True`` errors are silently ignored, otherwise an exception - is raised in case an error occurs. - - :param onerror: - A callback which gets called with the arguments `func`, `path` and - `exc_info`. `func` is one of :func:`os.listdir`, :func:`os.remove` - or :func:`os.rmdir`. `path` is the argument to the function which - caused it to fail and `exc_info` is a tuple as returned by - :func:`sys.exc_info`. - """ - shutil.rmtree(self, ignore_errors=ignore_errors, onerror=onerror) - - def copytree(self, destination: str, symlinks: bool = False) -> None: - """Recursively copy a directory to the given `destination`. If the given - `destination` does not exist it will be created. - - :param symlinks: - If ``True`` symbolic links in the source tree result in symbolic - links in the destination tree otherwise the contents of the files - pointed to by the symbolic links are copied. - """ - shutil.copytree(self, destination, symlinks=symlinks) - if os.environ.get('SPHINX_READONLY_TESTDIR'): - # If source tree is marked read-only (e.g. because it is on a read-only - # filesystem), `shutil.copytree` will mark the destination as read-only - # as well. To avoid failures when adding additional files/directories - # to the destination tree, ensure destination directories are not marked - # read-only. - for root, _dirs, files in os.walk(destination): - os.chmod(root, 0o755 & ~UMASK) - for name in files: - os.chmod(os.path.join(root, name), 0o644 & ~UMASK) - - def movetree(self, destination: str) -> None: - """Recursively move the file or directory to the given `destination` - similar to the Unix "mv" command. - - If the `destination` is a file it may be overwritten depending on the - :func:`os.rename` semantics. - """ - shutil.move(self, destination) - - move = movetree - - def unlink(self) -> None: - """Removes a file.""" - os.unlink(self) - - def stat(self) -> Any: - """Returns a stat of the file.""" - return os.stat(self) - - def utime(self, arg: Any) -> None: - os.utime(self, arg) - - def open(self, mode: str = 'r', **kwargs: Any) -> IO[str]: - return open(self, mode, **kwargs) - - def write_text(self, text: str, encoding: str = 'utf-8', **kwargs: Any) -> None: - """Writes the given `text` to the file.""" - with open(self, 'w', encoding=encoding, **kwargs) as f: - f.write(text) - - def read_text(self, encoding: str = 'utf-8', **kwargs: Any) -> str: - """Returns the text in the file.""" - with open(self, encoding=encoding, **kwargs) as f: - return f.read() - - def read_bytes(self) -> builtins.bytes: - """Returns the bytes in the file.""" - with open(self, mode='rb') as f: - return f.read() - - def write_bytes(self, bytes: bytes, append: bool = False) -> None: - """Writes the given `bytes` to the file. - - :param append: - If ``True`` given `bytes` are added at the end of the file. - """ - if append: - mode = 'ab' - else: - mode = 'wb' - with open(self, mode=mode) as f: - f.write(bytes) - - def exists(self) -> bool: - """Returns ``True`` if the path exist.""" - return os.path.exists(self) - - def lexists(self) -> bool: - """Returns ``True`` if the path exists unless it is a broken symbolic - link. - """ - return os.path.lexists(self) - - def makedirs(self, mode: int = 0o777, exist_ok: bool = False) -> None: - """Recursively create directories.""" - os.makedirs(self, mode, exist_ok=exist_ok) - - def joinpath(self, *args: Any) -> path: - """Joins the path with the argument given and returns the result.""" - return self.__class__(os.path.join(self, *map(self.__class__, args))) - - def listdir(self) -> list[str]: - return os.listdir(self) - - __div__ = __truediv__ = joinpath - - def __repr__(self) -> str: - return f'{self.__class__.__name__}({super().__repr__()})' diff --git a/sphinx/testing/restructuredtext.py b/sphinx/testing/restructuredtext.py index b04b61a4021..548ef5f27b4 100644 --- a/sphinx/testing/restructuredtext.py +++ b/sphinx/testing/restructuredtext.py @@ -2,11 +2,8 @@ from typing import TYPE_CHECKING -from docutils.core import publish_doctree - -from sphinx.io import SphinxStandaloneReader from sphinx.parsers import RSTParser -from sphinx.util.docutils import sphinx_domains +from sphinx.util.docutils import _parse_str_to_doctree if TYPE_CHECKING: from docutils import nodes @@ -15,27 +12,35 @@ def parse(app: Sphinx, text: str, docname: str = 'index') -> nodes.document: - """Parse a string as reStructuredText with Sphinx application.""" + """Parse a string as reStructuredText with Sphinx.""" + config = app.config env = app.env + registry = app.registry + srcdir = app.srcdir + + # Get settings + settings_overrides = { + 'env': env, + 'gettext_compact': True, + 'input_encoding': 'utf-8', + 'output_encoding': 'unicode', + 'traceback': True, + } + + # Create parser + parser = RSTParser() + parser._config = config + parser._env = env + + env.current_document.docname = docname try: - app.env.current_document.docname = docname - reader = SphinxStandaloneReader() - reader.setup(app) - parser = RSTParser() - parser.set_application(app) - with sphinx_domains(env): - return publish_doctree( - text, - str(app.srcdir / f'{docname}.rst'), - reader=reader, - parser=parser, - settings_overrides={ - 'env': env, - 'gettext_compact': True, - 'input_encoding': 'utf-8', - 'output_encoding': 'unicode', - 'traceback': True, - }, - ) + return _parse_str_to_doctree( + text, + filename=srcdir / f'{docname}.rst', + default_settings=settings_overrides, + env=env, + parser=parser, + transforms=registry.get_transforms(), + ) finally: env.current_document.docname = '' diff --git a/sphinx/testing/util.py b/sphinx/testing/util.py index a7244bb32d5..28336bc86ad 100644 --- a/sphinx/testing/util.py +++ b/sphinx/testing/util.py @@ -15,7 +15,6 @@ import sphinx.application import sphinx.locale import sphinx.pycode -from sphinx._cli.util.errors import strip_escape_sequences from sphinx.util.docutils import additional_nodes if TYPE_CHECKING: @@ -45,7 +44,7 @@ def assert_node(node: Node, cls: Any = None, xpath: str = '', **kwargs: Any) -> assert_node(node[0], cls[1:], xpath=xpath + '[0]', **kwargs) elif isinstance(cls, tuple): assert ( - isinstance(node, list | nodes.Element) + isinstance(node, (list, nodes.Element)) ), f'The node{xpath} does not have any items' # fmt: skip assert ( len(node) == len(cls) @@ -267,25 +266,3 @@ def _clean_up_global_state() -> None: # clean up autodoc global state sphinx.pycode.ModuleAnalyzer.cache.clear() - - -# deprecated name -> (object to return, canonical path or '', removal version) -_DEPRECATED_OBJECTS: dict[str, tuple[Any, str, tuple[int, int]]] = { - 'strip_escseq': ( - strip_escape_sequences, - 'sphinx.util.console.strip_escape_sequences', - (9, 0), - ), -} - - -def __getattr__(name: str) -> Any: - if name not in _DEPRECATED_OBJECTS: - msg = f'module {__name__!r} has no attribute {name!r}' - raise AttributeError(msg) - - from sphinx.deprecation import _deprecation_warning - - deprecated_object, canonical_name, remove = _DEPRECATED_OBJECTS[name] - _deprecation_warning(__name__, name, canonical_name, remove=remove) - return deprecated_object diff --git a/sphinx/texinputs/sphinx.sty b/sphinx/texinputs/sphinx.sty index 8837485c5f7..769e6b9725f 100644 --- a/sphinx/texinputs/sphinx.sty +++ b/sphinx/texinputs/sphinx.sty @@ -9,7 +9,7 @@ % by the Sphinx LaTeX writer. \NeedsTeXFormat{LaTeX2e}[1995/12/01] -\ProvidesPackage{sphinx}[2024/11/23 v8.2.0 Sphinx LaTeX package (sphinx-doc)] +\ProvidesPackage{sphinx}[2025/08/03 v9.0.0 Sphinx LaTeX package (sphinx-doc)] % provides \ltx@ifundefined % (many packages load ltxcmds: graphicx does for pdftex and lualatex but @@ -67,7 +67,7 @@ Footnote rendering may have had problems, due to extra package or document class; check latex log for instructions}% \@namedef{sphinx_buildwarning_badiconpackage}{% - You have set iconpackage=\spx@opt@iconpackage, but this LaTeX package + You have set iconpackage=\spx@usr@iconpackage, but this LaTeX package is not found}% %% OPTION HANDLING @@ -672,7 +672,7 @@ % defaults for them remain not to have specific colour. % % 7.4.0 adds keys for admonition titles: for background and foreground colors, -% and for icons (whose defaults are picked from Free Fontawesome 5). +% and for icons. \def\spx@tempa#1{% \expandafter\spx@tempb \csname if#1withshadowcolor\expandafter\endcsname @@ -869,80 +869,125 @@ } % 7.4.0 Support for icons in admonition titles -% We try to -% - get Sphinx PDF builds to process fine in absence of fontawesome5 -% - use fontawesome5 if present, but not if user prefers another package -% - provide an interface for using other LaTeX code for icons -% - provide an interface for using some other package than fontawesome5 -% Indeed we can't load fontawesome5 unconditionally even if available, -% as it proves incompatible with fontawesome package. -% We thus must delay its loading. -\IfFileExists{fontawesome5.sty}{% - \DeclareStringOption[fontawesome5]{iconpackage}% +% +% We let Sphinx use, listed in order of priority: +% - a user-specified package via iconpackage key, +% - fontawesome7 (supported since 9.0.0), +% - fontawesome6 (supported since 9.0.0), +% - fontawesome5, +% - fontawesome, +% - or nothing at all, and then icons are not drawn. +% To allow a user-specified package, an extra interface +% is provided for specifying the icon-drawing LaTeX code. +% +% We can't load fontawesome7 (or 6 or 5) unconditionally even if available, as it +% is incompatible with fontawesome package which may be preferred by user. We +% thus must delay loading the package to at begin document, and for now can +% only set the default value of iconpackage key. +\IfFileExists{fontawesome7.sty}{% + \DeclareStringOption[fontawesome7]{iconpackage}% }% {% - \IfFileExists{fontawesome.sty} - {\DeclareStringOption[fontawesome]{iconpackage}} - {\DeclareStringOption[none]{iconpackage}}% + \IfFileExists{fontawesome6.sty}{% + \DeclareStringOption[fontawesome6]{iconpackage}% + }% + {% + \IfFileExists{fontawesome5.sty}{% + \DeclareStringOption[fontawesome5]{iconpackage}% + }% + {% + \IfFileExists{fontawesome.sty} + {\DeclareStringOption[fontawesome]{iconpackage}} + {\DeclareStringOption[none]{iconpackage}}% + }% + }% }% -\newcommand\spx@faIcon[2][]{}% -% The above \spx@faIcon which gobbles one mandatory and one optional -% argument is put into use only if both fontawesome5 and fontawesome -% LaTeX packages are not available, as part of the defaults for the -% div.*_title-icon keys (these keys can be redefined via the sphinxsetup -% interface). -% -\def\spxstring@fontawesome{fontawesome} -\def\spxstring@fontawesomev{fontawesome5} +% Unfortunately icon macro names are not the same across fontawesome, +% fontawesome5, fontawesome6 and fontawesome7 LaTeX packages. +% At 9.0.0 we refactor the +% icon support code into something easier to maintain in future in case of a +% fontawesome8, etc... +% +% TODO: Handle spaces possibly caused by bad user usage of iconpackage key? +% This would need to check how LaTeX handle spaces in package name +% in \RequirePackage command. Things in this area may have changed +% recently (2025/04). \AtBeginDocument{% \ifx\spx@opt@iconpackage\spxstring@none \else \IfFileExists{\spx@opt@iconpackage.sty} - {\RequirePackage{\spx@opt@iconpackage}% - \ifx\spx@opt@iconpackage\spxstring@fontawesomev - \renewcommand\spx@faIcon{\faIcon}% - \else - \ifx\spx@opt@iconpackage\spxstring@fontawesome - \renewcommand\spx@faIcon[2][]{\faicon{##2}}% - % The \ifdefined's are a bit silly because we know that - % fontawesome.sty does not provide it, but perhaps - % there can be some new release of that package? - \ifdefined\faicon@lightbulb\else - \let\faicon@lightbulb\faLightbulbO - \fi - \ifdefined\faicon@radiation\else - \let\faicon@radiation\faBolt - \fi - \ifdefined\faicon@pen\else - \let\faicon@pen\faPencil - \fi - % if neither has been required, \spx@faIcon will simply swallow - % its argument and it is up to user - % to set the various div.*_title-icon keys appropriately. - \fi\fi % - }% + {\RequirePackage{\spx@opt@iconpackage}}% {% - \sphinxbuildwarning{badiconpackage}% - \PackageWarningNoLine{sphinx}{% - You have set iconpackage=\spx@opt@iconpackage\MessageBreak - But \spx@opt@iconpackage.sty is not found by LaTeX} + \let\spx@usr@iconpackage\spx@opt@iconpackage + \sphinxbuildwarning{badiconpackage}% + \PackageWarningNoLine{sphinx}{% + You have set iconpackage=\spx@usr@iconpackage\MessageBreak + But \spx@usr@iconpackage.sty is not found by LaTeX} + \let\spx@opt@iconpackage\spxstring@none }% \fi } +% Icon defaults depending on package used. +% Attention! no extra spaces (to align here) when using \@namedef! + +\@namedef{spx@fontawesome6@note}{\faIcon{circle-info}} +\@namedef{spx@fontawesome6@hint}{\faIcon[regular]{lightbulb}} +\@namedef{spx@fontawesome6@tip}{\faIcon[regular]{lightbulb}} +\@namedef{spx@fontawesome6@seealso}{\faIcon{share}} +\@namedef{spx@fontawesome6@todo}{\faIcon{pen}} +\@namedef{spx@fontawesome6@important}{\faIcon{circle-pause}} +\@namedef{spx@fontawesome6@caution}{\faIcon{radiation}} +\@namedef{spx@fontawesome6@warning}{\faIcon{triangle-exclamation}} +\@namedef{spx@fontawesome6@attention}{\faIcon{triangle-exclamation}} +\@namedef{spx@fontawesome6@danger}{\faIcon{radiation}} +\@namedef{spx@fontawesome6@error}{\faIcon{circle-xmark}} + +% Turns out that fontawesome7 commands for our target icons are +% same as with fontawesome6. So make a loop to spare a few lines here. +\@for\x:=note,hint,tip,seealso,todo,important,caution,warning,attention,% + danger,error% +\do{\expandafter\let\csname spx@fontawesome7@\x\expandafter\endcsname + \csname spx@fontawesome6@\x\endcsname} + +\@namedef{spx@fontawesome5@note}{\faIcon{info-circle}} +\@namedef{spx@fontawesome5@hint}{\faIcon[regular]{lightbulb}} +\@namedef{spx@fontawesome5@tip}{\faIcon[regular]{lightbulb}} +\@namedef{spx@fontawesome5@seealso}{\faIcon{share}} +\@namedef{spx@fontawesome5@todo}{\faIcon{pen}} +\@namedef{spx@fontawesome5@important}{\faIcon{pause-circle}} +\@namedef{spx@fontawesome5@caution}{\faIcon{radiation}} +\@namedef{spx@fontawesome5@warning}{\faIcon{exclamation-triangle}} +\@namedef{spx@fontawesome5@attention}{\faIcon{exclamation-triangle}} +\@namedef{spx@fontawesome5@danger}{\faIcon{radiation}} +\@namedef{spx@fontawesome5@error}{\faIcon{times-circle}} + +\def\spx@fontawesome@note {\faicon{info-circle}} +\def\spx@fontawesome@hint {\faicon{lightbulb-o}} +\def\spx@fontawesome@tip {\faicon{lightbulb-o}} +\def\spx@fontawesome@seealso {\faicon{share}} +\def\spx@fontawesome@todo {\faicon{pencil}} +\def\spx@fontawesome@important{\faicon{pause-circle}} +\def\spx@fontawesome@caution {\faicon{bolt}} +\def\spx@fontawesome@warning {\faicon{exclamation-triangle}} +\def\spx@fontawesome@attention{\faicon{exclamation-triangle}} +\def\spx@fontawesome@danger {\faicon{bolt}} +\def\spx@fontawesome@error {\faicon{times-circle}} + +% \spx@none@{note,hint,...} left undefined, the \@nameuse will be \relax +\def\spx@titleicon@default#1{\@nameuse{spx@\spx@opt@iconpackage @#1}} \setkeys{sphinx}{ -% Icon defaults. - div.note_title-icon = \spx@faIcon{info-circle}, - div.hint_title-icon = \spx@faIcon[regular]{lightbulb}, - div.tip_title-icon = \spx@faIcon[regular]{lightbulb}, - div.seealso_title-icon = \spx@faIcon{share}, - div.todo_title-icon = \spx@faIcon{pen}, - div.important_title-icon = \spx@faIcon{pause-circle}, - div.caution_title-icon = \spx@faIcon{radiation}, - div.warning_title-icon = \spx@faIcon{exclamation-triangle}, - div.attention_title-icon = \spx@faIcon{exclamation-triangle}, - div.danger_title-icon = \spx@faIcon{radiation}, - div.error_title-icon = \spx@faIcon{times-circle}, + div.note_title-icon = \spx@titleicon@default{note}, + div.hint_title-icon = \spx@titleicon@default{hint}, + div.tip_title-icon = \spx@titleicon@default{tip}, + div.seealso_title-icon = \spx@titleicon@default{seealso}, + div.todo_title-icon = \spx@titleicon@default{todo}, + div.important_title-icon = \spx@titleicon@default{important}, + div.caution_title-icon = \spx@titleicon@default{caution}, + div.warning_title-icon = \spx@titleicon@default{warning}, + div.attention_title-icon = \spx@titleicon@default{attention}, + div.danger_title-icon = \spx@titleicon@default{danger}, + div.error_title-icon = \spx@titleicon@default{error}, % MEMO: the new at 8.1.0 defaults for contents/topic/sidebar directives % use no icons, they use \sphinxdotitlerow which detects automatically % whether title-icon key has been set or not. @@ -1192,5 +1237,25 @@ % FIXME: this line should be dropped, as "9" is default anyhow. \ifdefined\pdfcompresslevel\pdfcompresslevel = 9 \fi - +%%% SUPPORT FOR CSS3 EXTRA LENGTH UNITS +% cf rstdim_to_latexdim in latex.py +% +\def\sphinxchdimen{\dimexpr\fontcharwd\font`0\relax} +% TODO: decide if we want rather \textwidth/\textheight. +\newdimen\sphinxvwdimen + \sphinxvwdimen=\dimexpr0.01\paperwidth\relax +\newdimen\sphinxvhdimen + \sphinxvhdimen=\dimexpr0.01\paperheight\relax +\newdimen\sphinxvmindimen + \sphinxvmindimen=\dimexpr + \ifdim\paperwidth<\paperheight\sphinxvwdimen\else\sphinxvhdimen\fi + \relax +\newdimen\sphinxvmaxdimen + \sphinxvmaxdimen=\dimexpr + \ifdim\paperwidth<\paperheight\sphinxvhdimen\else\sphinxvwdimen\fi + \relax +\newdimen\sphinxQdimen + \sphinxQdimen=0.25mm +% MEMO: \sphinxremdimen is defined in the template as it needs +% the config variable pointsize. \endinput diff --git a/sphinx/texinputs/sphinxlatexadmonitions.sty b/sphinx/texinputs/sphinxlatexadmonitions.sty index 0519903591b..dd3145d8a7e 100644 --- a/sphinx/texinputs/sphinxlatexadmonitions.sty +++ b/sphinx/texinputs/sphinxlatexadmonitions.sty @@ -1,7 +1,7 @@ %% NOTICES AND ADMONITIONS % % change this info string if making any custom modification -\ProvidesPackage{sphinxlatexadmonitions}[2024/10/11 v8.1.1 admonitions] +\ProvidesPackage{sphinxlatexadmonitions}[2025/10/24 v9.0.0 admonitions] % Provides support for this output mark-up from Sphinx latex writer: % @@ -53,6 +53,7 @@ % - \spx@boxes@fcolorbox@setup from sphinxpackageboxes.sty % \RequirePackage{framed} +\RequirePackage{needspace} % Those are required either before or after by sphinx.sty anyhow, but for % clarity we list them here: \RequirePackage{sphinxlatexgraphics} @@ -107,7 +108,12 @@ % % Code adapted from framed.sty's "snugshade" environment. % Nesting works (inner frames do not allow page breaks). +% +% At 9.0, avoid admonition title getting separated from contents at a +% page break. +\newcommand\sphinxheavyboxneedspacecommand{\needspace{5\baselineskip}} \newenvironment{sphinxheavybox}{\par + \sphinxheavyboxneedspacecommand % (MEMO: it is not a problem here if there is no sphinxShadowColor, % as it used only if set) \spx@boxes@fcolorbox@setup{\spx@noticetype}% @@ -342,8 +348,7 @@ \textcolor{sphinx#1TtlFgColor}{% \@nameuse{sphinx#1TtlIcon}% % The next macro is located here for legacy reasons of earlier - % functioning of \spx@faIcon. When fontawesome{5,}.sty both - % are unavailable, it (formerly) gobbled this next macro. + % functioning of sphinx.sty now removed \spx@faIcon macro. % We leave it here now although it could be moved to after % the closing brace. \sphinxtitlerowaftericonspacecmd diff --git a/sphinx/texinputs/sphinxlatexliterals.sty b/sphinx/texinputs/sphinxlatexliterals.sty index 11991d9c3e8..b0f349720a9 100644 --- a/sphinx/texinputs/sphinxlatexliterals.sty +++ b/sphinx/texinputs/sphinxlatexliterals.sty @@ -1,7 +1,7 @@ %% LITERAL BLOCKS % % change this info string if making any custom modification -\ProvidesPackage{sphinxlatexliterals}[2024/07/01 v7.4.0 code-blocks and parsed literals] +\ProvidesPackage{sphinxlatexliterals}[2025/08/06 v9.0.0 code-blocks and parsed literals] % Provides support for this output mark-up from Sphinx latex writer: % @@ -241,6 +241,8 @@ % _, }, ^, &, >, -, ~, and \: stay at end of broken line. % Use of \textquotesingle for straight quote. % FIXME: convert this to package options ? +% MEMO: "beforelist" and "afterlist" hold no relation with lists, +% they are just "\do lists" in the inherited TeX sense. \newcommand*\sphinxbreaksbeforelist {% \do\PYGZob\{\do\PYGZlt\<\do\PYGZsh\#\do\PYGZpc\%% {, <, #, %, \do\PYGZdl\$\do\PYGZdq\"% $, " @@ -278,6 +280,8 @@ \catcode`##1\active}% \sphinxbreaksafteractivelist \lccode`\~`\~ + % visit_desc_name will insert non TeX-escaped ~ in the source + \let~\spx@verbatim@space } % If the linebreak is at a space, the latter will be displayed as visible @@ -962,7 +966,13 @@ \let\sphinxhyphen\sphinxhyphenininlineliteral \ifspx@opt@inlineliteralwraps % break at . , ; ? ! / + % and also at ~ which will be handled like are spaces in verbatim \sphinxbreaksviaactive + % but for this we need to set this box which is empty by default: + % MEMO: it looks suboptimal to redo this each time but this is + % to obey a \sphinxsetup via raw LaTeX to set verbatimvisiblespace, + % a possibility which however will be used by 0% of Sphinx users... + \sbox\sphinxvisiblespacebox {\spx@opt@verbatimvisiblespace}% % break also at \ \setbox8=\hbox{\textbackslash}% \def\sphinx@textbackslash{\copy8}% diff --git a/sphinx/texinputs/sphinxlatexobjects.sty b/sphinx/texinputs/sphinxlatexobjects.sty index 1147a016227..2a05dd6de8c 100644 --- a/sphinx/texinputs/sphinxlatexobjects.sty +++ b/sphinx/texinputs/sphinxlatexobjects.sty @@ -1,7 +1,7 @@ %% MODULE RELEASE DATA AND OBJECT DESCRIPTIONS % % change this info string if making any custom modification -\ProvidesPackage{sphinxlatexobjects}[2025/02/11 documentation environments] +\ProvidesPackage{sphinxlatexobjects}[2025/06/06 documentation environments] % Provides support for this output mark-up from Sphinx latex writer: % @@ -155,20 +155,23 @@ \pysigadjustitemsep } \newcommand{\pysiglinewithargsret}[3]{% - % as #1 may contain a footnote using \label we need to make \label - % a no-op here to avoid LaTeX complaining about duplicates -\let\spx@label\label\let\label\@gobble - \settowidth{\py@argswidth}{#1\pysigarglistopen}% -\let\label\spx@label + % #1 may contain a footnote (especially with latex_show_urls='footnote' + % and some intersphinx added hyperlinking). Here we want to measure + % a width but not typeset such a footnote (else #13619). + % Miraculously a sphinxpackagefootnote.sty tabulary compatibility + % layer employing the amsmath \ifmeasuring@ can be used here to let + % a footnote influence the actual width up to opening brace but not + % actually get typeset at this stage... + % MEMO: "argswidth" is misleading here, this code measures the name + % not the arguments. + \settowidth{\py@argswidth}{\measuring@true#1\pysigarglistopen}% \py@argswidth=\dimexpr\linewidth+\labelwidth-\py@argswidth\relax\relax \item[{#1\pysigarglistopen\py@sigparams{#2}{#3}\strut}] \pysigadjustitemsep } -\newcommand{\pysiglinewithargsretwithtypelist}[4]{ -% #1 = name, #2 = typelist, #3 = arglist, #4 = retann -\let\spx@label\label\let\label\@gobble - \settowidth{\py@argswidth}{#1\pysigtypelistopen}% -\let\label\spx@label +\newcommand{\pysiglinewithargsretwithtypelist}[4]{% + % same comment as in \pysiglinewithargsret + \settowidth{\py@argswidth}{\measuring@true#1\pysigtypelistopen}% \py@argswidth=\dimexpr\linewidth+\labelwidth-\py@argswidth\relax\relax \item[{#1\pysigtypelistopen\py@sigparamswithtypelist{#2}{#3}{#4}\strut}] \pysigadjustitemsep @@ -244,9 +247,8 @@ \newcommand{\pysigwithonelineperargwithtypelist}[4]{ % #1 = name, #2 = typelist, #3 = arglist, #4 = retann % render the type parameters list on one line, but each argument is rendered on its own line -\let\spx@label\label\let\label\@gobble - \settowidth{\py@argswidth}{#1\pysigtypelistopen}% -\let\label\spx@label + % for \measuring@true see comment in \pysiglinewithargsret + \settowidth{\py@argswidth}{\measuring@true#1\pysigtypelistopen}% \py@argswidth=\dimexpr\linewidth+\labelwidth-\py@argswidth\relax\relax \item[{#1\pysigtypelistopen\parbox[t]{\py@argswidth}{% \raggedright #2\pysigtypelistclose\pysigarglistopen\strut}\strut}] diff --git a/sphinx/texinputs/sphinxlatexstyletext.sty b/sphinx/texinputs/sphinxlatexstyletext.sty index d083cd96a83..b6408cfb218 100644 --- a/sphinx/texinputs/sphinxlatexstyletext.sty +++ b/sphinx/texinputs/sphinxlatexstyletext.sty @@ -1,7 +1,7 @@ %% TEXT STYLING % % change this info string if making any custom modification -\ProvidesPackage{sphinxlatexstyletext}[2024/07/28 v8.1.0 text styling] +\ProvidesPackage{sphinxlatexstyletext}[2025/05/24 v9.0.0 text styling] % 7.4.0 has moved all that is related to admonitions to sphinxlatexadmonitions.sty % 8.1.0 has moved topic/contents/sidebar to sphinxlatexshadowbox.sty @@ -57,7 +57,11 @@ % reduce hyperref "Token not allowed in a PDF string" warnings on PDF builds \AtBeginDocument{\pdfstringdefDisableCommands{% % all "protected" macros possibly ending up in section titles should be here -% TODO: examine if \sphinxhref, \sphinxurl, \sphinnolinkurl should be handled +% next four were added so that URLs and internal links in titles can be allowed + \let\sphinxurl \@firstofone + \let\sphinxnolinkurl\@firstofone + \let\sphinxhref \@secondoftwo + \def\hyperref[#1]#2{#2}% for PDF bookmark to ignore #1 \let\sphinxstyleemphasis \@firstofone \let\sphinxstyleliteralemphasis \@firstofone \let\sphinxstylestrong \@firstofone diff --git a/sphinx/texinputs/sphinxlatextables.sty b/sphinx/texinputs/sphinxlatextables.sty index 4114955e071..9c9bb74de0d 100644 --- a/sphinx/texinputs/sphinxlatextables.sty +++ b/sphinx/texinputs/sphinxlatextables.sty @@ -1,7 +1,7 @@ %% TABLES (WITH SUPPORT FOR MERGED CELLS OF GENERAL CONTENTS) % % change this info string if making any custom modification -\ProvidesPackage{sphinxlatextables}[2024/07/01 v7.4.0 tables]% +\ProvidesPackage{sphinxlatextables}[2025/06/30 v9.0.0 tables]% % Provides support for this output mark-up from Sphinx latex writer % and table templates: @@ -42,6 +42,29 @@ % - \sphinxthistablewithnocolorrowsstyle % - \sphinxthistablewithvlinesstyle % - \sphinxthistablewithnovlinesstyle +% - \sphinxbeforeendvarwidth + +% At 9.0, ALL table cell contents are wrapped into a varwidth environment. +% This helps solve issues such as #3447, #8828, and helps use tabulary +% in many more cases hence obtain better looking tables. +\def\sphinxbeforeendvarwidth{\par\vskip-\baselineskip\hbox{\strut}} +% MEMO: Mark-up uses the above macro right before all \end{varwdith} so that +% if the cell in a row extends lower than the others, its last line acquires +% standard "depth". Else it may lack any depth if without descenders such as +% "p" or "q" letters and the horizontal line or color panel will look strange. +% It originates in PR #3435 from 2017 which solved *many* table issues for +% merged cells (and injected the varwidth technique now at 9.0 applied to +% all cells). The original used \vbox{\hbox{\strut}} but that \vbox appears +% to do nothing, and it was decided after some testing (July 2025) to remove +% it, the original rationale for it being now lost. + +% These conditionals added at 9.0 for nested tables not to break row colors +% (#13635). Nested tables are only partially supported by Sphinx LaTeX. +% The method here is with no changes to neither writer nor templates. +\newif\ifspx@intable +\newif\ifspx@thistableisnested +% Try to allow nested tables in a longtable. But tabulary causes problems. +\newif\ifspx@longtable % % Also provides user command (see docs) % - \sphixncolorblend @@ -62,8 +85,8 @@ \RequirePackage{tabulary} % tabulary has a bug with its re-definition of \multicolumn in its first pass % which is not \long. But now Sphinx does not use LaTeX's \multicolumn but its -% own macro. Hence we don't even need to patch tabulary. See -% sphinxpackagemulticell.sty +% own macro. Hence we don't even need to patch tabulary. +% % X or S (Sphinx) may have meanings if some table package is loaded hence % \X was chosen to avoid possibility of conflict \newcolumntype{\X}[2]{p{\dimexpr @@ -109,7 +132,9 @@ \LTpre\z@skip\LTpost\z@skip % set to zero longtable's own skips \edef\sphinxbaselineskip{\dimexpr\the\dimexpr\baselineskip\relax\relax}% \spx@inframedtrue % message to sphinxheavybox - }% + \spx@table@setnestedflags + \spx@longtabletrue +} % Compatibility with caption package \def\sphinxthelongtablecaptionisattop{% \spx@ifcaptionpackage{\noalign{\vskip-\belowcaptionskip}}{}% @@ -122,10 +147,29 @@ \def\sphinxatlongtableend{\@nobreakfalse % latex3/latex2e#173 \prevdepth\z@\vskip\sphinxtablepost\relax}% % B. Table with tabular or tabulary -\def\sphinxattablestart{\par\vskip\dimexpr\sphinxtablepre\relax +\def\sphinxattablestart{\par + \ifvmode % guard against being nested in a table cell + \vskip\dimexpr\sphinxtablepre\relax + \fi \spx@inframedtrue % message to sphinxheavybox + \spx@table@setnestedflags }% -\let\sphinxattableend\sphinxatlongtableend +% MEMO: this happens inside a savenotes environment and hence flags +% are reset on exit of it. +\def\spx@table@setnestedflags{% Issue #13635 + \ifspx@intable + \let\spx@table@resetcolortbl\spx@nestedtable@resetcolortbl + \spx@thistableisnestedtrue + \else + \spx@intabletrue + \fi + }% +\def\sphinxattableend{% + \@nobreakfalse % <- probably unneeded as this is not a longtable + \ifvmode % guard against being nested in a table cell + \prevdepth\z@\vskip\sphinxtablepost\relax + \fi +}% % This is used by tabular and tabulary templates \newcommand*\sphinxcapstartof[1]{% \vskip\parskip @@ -223,7 +267,32 @@ % % configuration of tabulary \setlength{\tymin}{3\fontcharwd\font`0 }% minimal width of "squeezed" columns -\setlength{\tymax}{10000pt}% allow enough room for paragraphs to "compete" +\setlength{\tymax}{3000pt}% allow enough room for paragraphs to "compete" +% +% MEMO: tabulary initially renders cell contents "horizontally" to measure +% them and compare their relative importance. Its goal is to choose the +% column width so that, roughly, all columns will look about evenly +% filled. "Horizontal" rendering is incompatible with many LaTeX +% structures such as lists, so prior to Sphinx 9.0 cells with such +% "problematic" contents caused Sphinx to use tabular not tabulary; the +% tabular would then render each column in absence of :widths: option or +% tabularcolumns directive the same width equal to available text width +% divided by number of columns. At 9.0, "problematic" contents is +% wrapped into a "varwidth" environment, as was already done formerly +% for merged cells, and this avoids tabulary causing errors such as +% "incompatible with LR mode"; \sphinxcolwidth is used which sets +% the initial horizontal width for "varwidth". In the first tabulary +% pass, \sphinxcolwidth is configured (by us) to use \tymax. +% +% During testing, it was determined that the former 10000pt setting for +% \tymax would cause "Dimension too large" TeX error if two columns or +% more had cells containing admonitions (such contents does not allow +% "varwidth" to reduce the width automatically). So we use now 3000pt +% which allows up to 5 such columns while being large enough for +% tabulary algorithm to give good results for cells containing a few +% dozen words. The tabulary default of 2\textwidth proves to be too +% small for that. +% % we need access to tabulary's final computed width. \@tempdima is too volatile % to hope it has kept tabulary's value when \sphinxcolwidth needs it. \newdimen\sphinx@TY@tablewidth @@ -270,10 +339,11 @@ % cells (the code does inserts & tokens, see TN1b). It was decided to keep it % simple with \sphinxstartmulticolumn...\sphinxstopmulticolumn. % +% **** ATTENTION: Sphinx does generate at least some nested tables in LaTeX +% **** TODO: clarify if next paragraph means we must raise an +% **** if LaTeX writer detects a merged cell inside nested table. % MEMO about nesting: if sphinxmulticolumn is encountered in a nested tabular -% inside a tabulary it will think to be at top level in the tabulary. But -% Sphinx generates no nested tables, and if some LaTeX macro uses internally a -% tabular this will not have a \sphinxstartmulticolumn within it! +% inside a tabulary it will think to be at top level in the tabulary. % % 5.3.0 adds a check for multirow as single-row multi-column will allow a row % colour but multi-row multi-column should not. @@ -376,8 +446,7 @@ }% \newcommand*\sphinxcolwidth[2]{% % this dimension will always be used for varwidth, and serves as maximum - % width when cells are merged either via multirow or multicolumn or both, - % as always their contents is wrapped in varwidth environment. + % width for cells whose contents are wrapped in varwidth environment. \ifnum#1>\@ne % multi-column (and possibly also multi-row) % we wrote our own multicolumn code especially to handle that (and allow % verbatim contents) @@ -857,7 +926,32 @@ }% \the\everycr }% - \global\rownum\@ne % is done from inside table so ok with tabulary two passes + \ifspx@thistableisnested + % Attention that tabulary does two passes so we need to push the + % initial rownum and, after the first pass, we must reset it! + % Fortunately Sphinx LaTeX writer makes parent table tabular or + % longtable if a nested table is a tabulary. So we don't need to + % worry about distinguishing if this or parent is tabulary. + \ifx\TY@final\@undefined % tabular + \spx@gpush@rownum + \else + \ifx\equation$% tabulary, first pass + \spx@gpush@rownum + \else % tabulary, second pass + \spx@gpop@rownum % reset \rownum + \spx@gpush@rownum% and push it again. + \fi + \fi + % To make nested tables stand out in a color row, we toggle the parity. + % TODO: Double-check if compatible with method for color of header + % row. + % TODO: Perhaps better to use specific colors for nested tables? + % This would mean though adding new sphinxsetup parameters + % and extending the documentation... + \ifodd\rownum\global\rownum\z@\else\global\rownum\@ne\fi + \else + \global\rownum\@ne + \fi \sphinxSwitchCaseRowColor\rownum % set up color for the first body row \sphinxrowcolorON % has been done from \sphinxtoprule location but let's do % it again in case \sphinxtabletoprulehook has been used @@ -883,20 +977,39 @@ \let\sphinxtabledecrementrownum\@empty % \sphinxtableafterendhook will be modified by colorrows class to execute -% this after the table +% this after the table. \def\spx@table@resetcolortbl{% \sphinxrowcolorOFF - \spx@table@reset@CTeverycr + \spx@table@reset@CT@everycr % this last bit is done in order for the \sphinxbottomrule from the "foot" -% longtable template to be able to use same code as the \sphinxbottomrule -% at end of table body; see \sphinxbooktabsspecialbottomrule code +% part of the longtable template to be able to use same code as the +% \sphinxbottomrule at end of table body; see \sphinxbooktabsspecialbottomrule. \global\rownum\z@ + \global\let\spx@rownum@stack\@empty } -\def\spx@table@reset@CTeverycr{% +% Most of \spx@table@resetcolortbl must be avoided if the table is nested. +% Besides the sphinxTableRowColor must be reset because it has been +% redefined by the cells of the nested table. So this is the alternative +% macro which is executed on exit of nested table. +\def\spx@nestedtable@resetcolortbl{% + \ifx\spx@rownum@stack\@empty\else +% The stack can be empty if this is executed on exit of a nested table, +% and the parent table has received the "nocolorrows" class, but globally +% colorrows are activated (default). So we protected against that case. + \spx@gpop@rownum + \fi + \sphinxSwitchCaseRowColor\rownum +} +\def\spx@table@reset@CT@everycr{% % we should probably be more cautious and not hard-code here the colortbl -% set-up; so the macro is defined without @ to fac +% set-up. \global\CT@everycr{\noalign{\global\let\CT@row@color\relax}\the\everycr}% } +\let\spx@rownum@stack\@empty +\def\spx@gpush@rownum{\xdef\spx@rownum@stack{\the\rownum.\spx@rownum@stack}}% +\def\spx@gpop@rownum{\afterassignment\spx@gpop@rownum@i + \global\rownum=\spx@rownum@stack\relax} +\def\spx@gpop@rownum@i.#1\relax{\gdef\spx@rownum@stack{#1}} % At last the style macros \sphinxthistablewithstandardstyle etc... @@ -1019,6 +1132,10 @@ local use of booktabs table style}% % borderless style \def\sphinxthistablewithborderlessstyle{% + \sphinxthistablewithnohlines + \def\spx@arrayrulewidth{\z@}% +}% +\def\sphinxthistablewithnohlines{% \let\sphinxhline \@empty \let\sphinxcline \@gobble \let\sphinxvlinecrossing\@gobble @@ -1026,7 +1143,9 @@ local use of booktabs table style}% \let\spx@toprule \@empty \let\sphinxmidrule \@empty \let\sphinxbottomrule \@empty - \def\spx@arrayrulewidth{\z@}% +}% +\def\sphinxthistabularywithnohlinesifinlongtable{% + \ifspx@longtable\sphinxthistablewithnohlines\fi }% % colorrows style @@ -1047,10 +1166,13 @@ local use of booktabs table style}% % % this one is not set to \@empty by nocolorrows, because it looks harmless % to execute it always, as it simply resets to standard colortbl state after -% the table; so we don't need an @@ version for this one +% the table [^1]; so we don't need an @@ version for this one. +% .. [1]: which is bad if nested in another table. This is taken care of +% at level of \sphinxattablestart and \sphinxatlongtablestart. \spx@prepend\spx@table@resetcolortbl\to\sphinxtableafterendhook } \def\spx@prepend#1\to#2{% attention about using this only with #2 "storage macro" +% MEMO: #1 is prepended with no expansion, i.e. "as is". \toks@{#1}% \toks@\expandafter\expandafter\expandafter{\expandafter\the\expandafter\toks@#2}% \edef#2{\the\toks@}% @@ -1064,9 +1186,10 @@ local use of booktabs table style}% \let\spx@table@startbodycolorrows\@empty \let\sphinxtabledecrementrownum \@empty % we don't worry about \sphinxtableafterendhook as the \spx@table@resetcolortbl -% done at end can not do harm; and we could also have not bothered with the +% done at end can not do harm [^1]; and we could also have not bothered with the % \sphinxtabledecrementrownum as its \rownum decrement, if active, is harmless -% in non-colorrows context +% in non-colorrows context. +% .. [1]: if nested in another table it is modified to do no harm. } % (not so easy) implementation of the booktabscolorgaps option. This option diff --git a/sphinx/texinputs/sphinxpackagefootnote.sty b/sphinx/texinputs/sphinxpackagefootnote.sty index 7f2e2913874..f68bcf38800 100644 --- a/sphinx/texinputs/sphinxpackagefootnote.sty +++ b/sphinx/texinputs/sphinxpackagefootnote.sty @@ -1,6 +1,6 @@ \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{sphinxpackagefootnote}% - [2024/05/17 v7.3.x Sphinx custom footnotehyper package (Sphinx team)] + [2025/11/15 v9.0.0 Sphinx custom footnotehyper package (Sphinx team)] %% %% Package: sphinxpackagefootnote %% Version: based on footnotehyper.sty 2021/02/04 v1.1d @@ -19,11 +19,13 @@ % - \sphinxfootnotemark[N] % where N is a number. % -%% Some small differences from upstream footnotehyper.sty: +%% Some small differences from footnotehyper.sty 2021/02/04 v1.1d: %% - a tabulary compatibility layer (partial but enough for Sphinx), %% - usage of \spx@opt@BeforeFootnote %% - usage of \sphinxunactivateextrasandspace from sphinx.sty, %% - \sphinxlongtablepatch +%% - fix for a change of babel-french from late June 2025 +%% (\localleftbox undefined with pdflatex/xelatex, issue #14059) %% %% Starting with Sphinx v4.5.0, inherited footnotehyper macros for %% footnote/footnotetext receive some Sphinx specific extras to @@ -274,8 +276,11 @@ \fi }% \def\FNH@check{% - \ifx\@makefntextFB\@undefined\expandafter\FNH@check@ - \else\expandafter\FNH@frenchb@ + \ifx\@makefntextFB\@undefined + \expandafter\FNH@check@ + \else + \providecommand\localleftbox[1]{}% + \expandafter\FNH@frenchb@ \fi }% \def\FNH@frenchb@{% diff --git a/sphinx/themes/basic/static/doctools.js b/sphinx/themes/basic/static/doctools.js index 0398ebb9f03..807cdb176c0 100644 --- a/sphinx/themes/basic/static/doctools.js +++ b/sphinx/themes/basic/static/doctools.js @@ -59,7 +59,7 @@ const Documentation = { Object.assign(Documentation.TRANSLATIONS, catalog.messages); Documentation.PLURAL_EXPR = new Function( "n", - `return (${catalog.plural_expr})` + `return (${catalog.plural_expr})`, ); Documentation.LOCALE = catalog.locale; }, @@ -89,7 +89,7 @@ const Documentation = { const togglerElements = document.querySelectorAll("img.toggler"); togglerElements.forEach((el) => - el.addEventListener("click", (event) => toggler(event.currentTarget)) + el.addEventListener("click", (event) => toggler(event.currentTarget)), ); togglerElements.forEach((el) => (el.style.display = "")); if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); @@ -98,14 +98,15 @@ const Documentation = { initOnKeyListeners: () => { // only install a listener if it is really needed if ( - !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && - !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS + !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS + && !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS ) return; document.addEventListener("keydown", (event) => { // bail for input elements - if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) + return; // bail with special keys if (event.altKey || event.ctrlKey || event.metaKey) return; diff --git a/sphinx/themes/basic/static/language_data.js.jinja b/sphinx/themes/basic/static/language_data.js.jinja index 64aefa798c7..daefea7eb9e 100644 --- a/sphinx/themes/basic/static/language_data.js.jinja +++ b/sphinx/themes/basic/static/language_data.js.jinja @@ -1,12 +1,13 @@ /* * This script contains the language-specific data used by searchtools.js, - * namely the list of stopwords, stemmer, scorer and splitter. + * namely the set of stopwords, stemmer, scorer and splitter. */ -var stopwords = {{ search_language_stop_words }}; +const stopwords = new Set({{ search_language_stop_words }}); +window.stopwords = stopwords; // Export to global scope {% if search_language_stemming_code %} -/* Non-minified version is copied as a separate JS file, if available */ +/* Non-minified versions are copied as separate JavaScript files, if available */ {{ search_language_stemming_code|safe }} {% endif -%} diff --git a/sphinx/themes/basic/static/searchtools.js b/sphinx/themes/basic/static/searchtools.js index 91f4be57fc8..e29b1c754ba 100644 --- a/sphinx/themes/basic/static/searchtools.js +++ b/sphinx/themes/basic/static/searchtools.js @@ -41,11 +41,12 @@ if (typeof Scorer === "undefined") { } // Global search result kind enum, used by themes to style search results. +// prettier-ignore class SearchResultKind { - static get index() { return "index"; } - static get object() { return "object"; } - static get text() { return "text"; } - static get title() { return "title"; } + static get index() { return "index"; } + static get object() { return "object"; } + static get text() { return "text"; } + static get title() { return "title"; } } const _removeChildren = (element) => { @@ -58,6 +59,15 @@ const _removeChildren = (element) => { const _escapeRegExp = (string) => string.replace(/[.*+\-?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string +const _escapeHTML = (text) => { + return text + .replaceAll("&", "&") + .replaceAll("<", "<") + .replaceAll(">", ">") + .replaceAll('"', """) + .replaceAll("'", "'"); +}; + const _displayItem = (item, searchTerms, highlightTerms) => { const docBuilder = DOCUMENTATION_OPTIONS.BUILDER; const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX; @@ -90,25 +100,30 @@ const _displayItem = (item, searchTerms, highlightTerms) => { let linkEl = listItem.appendChild(document.createElement("a")); linkEl.href = linkUrl + anchor; linkEl.dataset.score = score; - linkEl.innerHTML = title; + linkEl.innerHTML = _escapeHTML(title); if (descr) { listItem.appendChild(document.createElement("span")).innerHTML = - " (" + descr + ")"; + ` (${_escapeHTML(descr)})`; // highlight search terms in the description - if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js - highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); - } - else if (showSearchSummary) + if (SPHINX_HIGHLIGHT_ENABLED) + // SPHINX_HIGHLIGHT_ENABLED is set in sphinx_highlight.js + highlightTerms.forEach((term) => + _highlightText(listItem, term, "highlighted"), + ); + } else if (showSearchSummary) fetch(requestUrl) .then((responseData) => responseData.text()) .then((data) => { if (data) listItem.appendChild( - Search.makeSearchSummary(data, searchTerms, anchor) + Search.makeSearchSummary(data, searchTerms, anchor), ); // highlight search terms in the summary - if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js - highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); + if (SPHINX_HIGHLIGHT_ENABLED) + // SPHINX_HIGHLIGHT_ENABLED is set in sphinx_highlight.js + highlightTerms.forEach((term) => + _highlightText(listItem, term, "highlighted"), + ); }); Search.output.appendChild(listItem); }; @@ -117,14 +132,14 @@ const _finishSearch = (resultCount) => { Search.title.innerText = _("Search Results"); if (!resultCount) Search.status.innerText = Documentation.gettext( - "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories." + "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.", ); else Search.status.innerText = Documentation.ngettext( "Search finished, found one page matching the search query.", "Search finished, found ${resultCount} pages matching the search query.", resultCount, - ).replace('${resultCount}', resultCount); + ).replace("${resultCount}", resultCount); }; const _displayNextItem = ( results, @@ -138,7 +153,7 @@ const _displayNextItem = ( _displayItem(results.pop(), searchTerms, highlightTerms); setTimeout( () => _displayNextItem(results, resultCount, searchTerms, highlightTerms), - 5 + 5, ); } // search finished, update title and status message @@ -170,9 +185,10 @@ const _orderResultsByScoreThenName = (a, b) => { * This is the same as ``\W+`` in Python, preserving the surrogate pair area. */ if (typeof splitQuery === "undefined") { - var splitQuery = (query) => query + var splitQuery = (query) => + query .split(/[^\p{Letter}\p{Number}_\p{Emoji_Presentation}]+/gu) - .filter(term => term) // remove remaining empty strings + .filter((term) => term); // remove remaining empty strings } /** @@ -184,16 +200,23 @@ const Search = { _pulse_status: -1, htmlToText: (htmlString, anchor) => { - const htmlElement = new DOMParser().parseFromString(htmlString, 'text/html'); + const htmlElement = new DOMParser().parseFromString( + htmlString, + "text/html", + ); for (const removalQuery of [".headerlink", "script", "style"]) { - htmlElement.querySelectorAll(removalQuery).forEach((el) => { el.remove() }); + htmlElement.querySelectorAll(removalQuery).forEach((el) => { + el.remove(); + }); } if (anchor) { - const anchorContent = htmlElement.querySelector(`[role="main"] ${anchor}`); + const anchorContent = htmlElement.querySelector( + `[role="main"] ${anchor}`, + ); if (anchorContent) return anchorContent.textContent; console.warn( - `Anchored content block not found. Sphinx search tries to obtain it via DOM query '[role=main] ${anchor}'. Check your theme or template.` + `Anchored content block not found. Sphinx search tries to obtain it via DOM query '[role=main] ${anchor}'. Check your theme or template.`, ); } @@ -202,7 +225,7 @@ const Search = { if (docContent) return docContent.textContent; console.warn( - "Content block not found. Sphinx search tries to obtain it via DOM query '[role=main]'. Check your theme or template." + "Content block not found. Sphinx search tries to obtain it via DOM query '[role=main]'. Check your theme or template.", ); return ""; }, @@ -287,12 +310,8 @@ const Search = { const queryTermLower = queryTerm.toLowerCase(); // maybe skip this "word" - // stopwords array is from language_data.js - if ( - stopwords.indexOf(queryTermLower) !== -1 || - queryTerm.match(/^\d+$/) - ) - return; + // stopwords set is from language_data.js + if (stopwords.has(queryTermLower) || queryTerm.match(/^\d+$/)) return; // stem the word let word = stemmer.stemWord(queryTermLower); @@ -304,8 +323,12 @@ const Search = { } }); - if (SPHINX_HIGHLIGHT_ENABLED) { // set in sphinx_highlight.js - localStorage.setItem("sphinx_highlight_terms", [...highlightTerms].join(" ")) + if (SPHINX_HIGHLIGHT_ENABLED) { + // SPHINX_HIGHLIGHT_ENABLED is set in sphinx_highlight.js + localStorage.setItem( + "sphinx_highlight_terms", + [...highlightTerms].join(" "), + ); } // console.debug("SEARCH: searching for:"); @@ -318,7 +341,13 @@ const Search = { /** * execute search (requires search index to be loaded) */ - _performSearch: (query, searchTerms, excludedTerms, highlightTerms, objectTerms) => { + _performSearch: ( + query, + searchTerms, + excludedTerms, + highlightTerms, + objectTerms, + ) => { const filenames = Search._index.filenames; const docNames = Search._index.docnames; const titles = Search._index.titles; @@ -334,10 +363,15 @@ const Search = { const queryLower = query.toLowerCase().trim(); for (const [title, foundTitles] of Object.entries(allTitles)) { - if (title.toLowerCase().trim().includes(queryLower) && (queryLower.length >= title.length/2)) { + if ( + title.toLowerCase().trim().includes(queryLower) + && queryLower.length >= title.length / 2 + ) { for (const [file, id] of foundTitles) { - const score = Math.round(Scorer.title * queryLower.length / title.length); - const boost = titles[file] === title ? 1 : 0; // add a boost for document titles + const score = Math.round( + (Scorer.title * queryLower.length) / title.length, + ); + const boost = titles[file] === title ? 1 : 0; // add a boost for document titles normalResults.push([ docNames[file], titles[file] !== title ? `${titles[file]} > ${title}` : title, @@ -353,9 +387,9 @@ const Search = { // search for explicit entries in index directives for (const [entry, foundEntries] of Object.entries(indexEntries)) { - if (entry.includes(queryLower) && (queryLower.length >= entry.length/2)) { + if (entry.includes(queryLower) && queryLower.length >= entry.length / 2) { for (const [file, id, isMain] of foundEntries) { - const score = Math.round(100 * queryLower.length / entry.length); + const score = Math.round((100 * queryLower.length) / entry.length); const result = [ docNames[file], titles[file], @@ -376,11 +410,13 @@ const Search = { // lookup as object objectTerms.forEach((term) => - normalResults.push(...Search.performObjectSearch(term, objectTerms)) + normalResults.push(...Search.performObjectSearch(term, objectTerms)), ); // lookup as search terms in fulltext - normalResults.push(...Search.performTermsSearch(searchTerms, excludedTerms)); + normalResults.push( + ...Search.performTermsSearch(searchTerms, excludedTerms), + ); // let the scorer override scores with a custom scoring function if (Scorer.score) { @@ -401,7 +437,11 @@ const Search = { // note the reversing of results, so that in the case of duplicates, the highest-scoring entry is kept let seen = new Set(); results = results.reverse().reduce((acc, result) => { - let resultStr = result.slice(0, 4).concat([result[5]]).map(v => String(v)).join(','); + let resultStr = result + .slice(0, 4) + .concat([result[5]]) + .map((v) => String(v)) + .join(","); if (!seen.has(resultStr)) { acc.push(result); seen.add(resultStr); @@ -413,8 +453,20 @@ const Search = { }, query: (query) => { - const [searchQuery, searchTerms, excludedTerms, highlightTerms, objectTerms] = Search._parseQuery(query); - const results = Search._performSearch(searchQuery, searchTerms, excludedTerms, highlightTerms, objectTerms); + const [ + searchQuery, + searchTerms, + excludedTerms, + highlightTerms, + objectTerms, + ] = Search._parseQuery(query); + const results = Search._performSearch( + searchQuery, + searchTerms, + excludedTerms, + highlightTerms, + objectTerms, + ); // for debugging //Search.lastresults = results.slice(); // a copy @@ -437,7 +489,7 @@ const Search = { const results = []; const objectSearchCallback = (prefix, match) => { - const name = match[4] + const name = match[4]; const fullname = (prefix ? prefix + "." : "") + name; const fullnameLower = fullname.toLowerCase(); if (fullnameLower.indexOf(object) < 0) return; @@ -489,9 +541,7 @@ const Search = { ]); }; Object.keys(objects).forEach((prefix) => - objects[prefix].forEach((array) => - objectSearchCallback(prefix, array) - ) + objects[prefix].forEach((array) => objectSearchCallback(prefix, array)), ); return results; }, @@ -516,8 +566,14 @@ const Search = { // find documents, if any, containing the query word in their text/title term indices // use Object.hasOwnProperty to avoid mismatching against prototype properties const arr = [ - { files: terms.hasOwnProperty(word) ? terms[word] : undefined, score: Scorer.term }, - { files: titleTerms.hasOwnProperty(word) ? titleTerms[word] : undefined, score: Scorer.title }, + { + files: terms.hasOwnProperty(word) ? terms[word] : undefined, + score: Scorer.term, + }, + { + files: titleTerms.hasOwnProperty(word) ? titleTerms[word] : undefined, + score: Scorer.title, + }, ]; // add support for partial matches if (word.length > 2) { @@ -558,7 +614,8 @@ const Search = { // create the mapping files.forEach((file) => { if (!fileMap.has(file)) fileMap.set(file, [word]); - else if (fileMap.get(file).indexOf(word) === -1) fileMap.get(file).push(word); + else if (fileMap.get(file).indexOf(word) === -1) + fileMap.get(file).push(word); }); }); @@ -569,11 +626,11 @@ const Search = { // as search terms with length < 3 are discarded const filteredTermCount = [...searchTerms].filter( - (term) => term.length > 2 + (term) => term.length > 2, ).length; if ( - wordList.length !== searchTerms.size && - wordList.length !== filteredTermCount + wordList.length !== searchTerms.size + && wordList.length !== filteredTermCount ) continue; @@ -581,10 +638,10 @@ const Search = { if ( [...excludedTerms].some( (term) => - terms[term] === file || - titleTerms[term] === file || - (terms[term] || []).includes(file) || - (titleTerms[term] || []).includes(file) + terms[term] === file + || titleTerms[term] === file + || (terms[term] || []).includes(file) + || (titleTerms[term] || []).includes(file), ) ) break; @@ -626,7 +683,8 @@ const Search = { let summary = document.createElement("p"); summary.classList.add("context"); - summary.textContent = top + text.substr(startWithContext, 240).trim() + tail; + summary.textContent = + top + text.substr(startWithContext, 240).trim() + tail; return summary; }, diff --git a/sphinx/themes/basic/static/sphinx_highlight.js b/sphinx/themes/basic/static/sphinx_highlight.js index 8a96c69a194..a74e103a831 100644 --- a/sphinx/themes/basic/static/sphinx_highlight.js +++ b/sphinx/themes/basic/static/sphinx_highlight.js @@ -1,7 +1,7 @@ /* Highlighting utilities for Sphinx HTML documentation. */ "use strict"; -const SPHINX_HIGHLIGHT_ENABLED = true +const SPHINX_HIGHLIGHT_ENABLED = true; /** * highlight a given string on a node by wrapping it in @@ -13,9 +13,9 @@ const _highlight = (node, addItems, text, className) => { const parent = node.parentNode; const pos = val.toLowerCase().indexOf(text); if ( - pos >= 0 && - !parent.classList.contains(className) && - !parent.classList.contains("nohighlight") + pos >= 0 + && !parent.classList.contains(className) + && !parent.classList.contains("nohighlight") ) { let span; @@ -30,13 +30,7 @@ const _highlight = (node, addItems, text, className) => { span.appendChild(document.createTextNode(val.substr(pos, text.length))); const rest = document.createTextNode(val.substr(pos + text.length)); - parent.insertBefore( - span, - parent.insertBefore( - rest, - node.nextSibling - ) - ); + parent.insertBefore(span, parent.insertBefore(rest, node.nextSibling)); node.nodeValue = val.substr(0, pos); /* There may be more occurrences of search term in this node. So call this * function recursively on the remaining fragment. @@ -46,7 +40,7 @@ const _highlight = (node, addItems, text, className) => { if (isInSVG) { const rect = document.createElementNS( "http://www.w3.org/2000/svg", - "rect" + "rect", ); const bbox = parent.getBBox(); rect.x.baseVal.value = bbox.x; @@ -65,7 +59,7 @@ const _highlightText = (thisNode, text, className) => { let addItems = []; _highlight(thisNode, addItems, text, className); addItems.forEach((obj) => - obj.parent.insertAdjacentElement("beforebegin", obj.target) + obj.parent.insertAdjacentElement("beforebegin", obj.target), ); }; @@ -73,25 +67,31 @@ const _highlightText = (thisNode, text, className) => { * Small JavaScript module for the documentation. */ const SphinxHighlight = { - /** * highlight the search words provided in localstorage in the text */ highlightSearchWords: () => { - if (!SPHINX_HIGHLIGHT_ENABLED) return; // bail if no highlight + if (!SPHINX_HIGHLIGHT_ENABLED) return; // bail if no highlight // get and clear terms from localstorage const url = new URL(window.location); const highlight = - localStorage.getItem("sphinx_highlight_terms") - || url.searchParams.get("highlight") - || ""; - localStorage.removeItem("sphinx_highlight_terms") - url.searchParams.delete("highlight"); - window.history.replaceState({}, "", url); + localStorage.getItem("sphinx_highlight_terms") + || url.searchParams.get("highlight") + || ""; + localStorage.removeItem("sphinx_highlight_terms"); + // Update history only if '?highlight' is present; otherwise it + // clears text fragments (not set in window.location by the browser) + if (url.searchParams.has("highlight")) { + url.searchParams.delete("highlight"); + window.history.replaceState({}, "", url); + } // get individual terms from highlight string - const terms = highlight.toLowerCase().split(/\s+/).filter(x => x); + const terms = highlight + .toLowerCase() + .split(/\s+/) + .filter((x) => x); if (terms.length === 0) return; // nothing to do // There should never be more than one element matching "div.body" @@ -107,11 +107,11 @@ const SphinxHighlight = { document .createRange() .createContextualFragment( - '" - ) + '", + ), ); }, @@ -125,7 +125,7 @@ const SphinxHighlight = { document .querySelectorAll("span.highlighted") .forEach((el) => el.classList.remove("highlighted")); - localStorage.removeItem("sphinx_highlight_terms") + localStorage.removeItem("sphinx_highlight_terms"); }, initEscapeListener: () => { @@ -134,10 +134,15 @@ const SphinxHighlight = { document.addEventListener("keydown", (event) => { // bail for input elements - if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) + return; // bail with special keys - if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return; - if (DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS && (event.key === "Escape")) { + if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) + return; + if ( + DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS + && event.key === "Escape" + ) { SphinxHighlight.hideSearchWords(); event.preventDefault(); } diff --git a/sphinx/themes/scrolls/static/theme_extras.js b/sphinx/themes/scrolls/static/theme_extras.js index df2be407339..84cc1509808 100644 --- a/sphinx/themes/scrolls/static/theme_extras.js +++ b/sphinx/themes/scrolls/static/theme_extras.js @@ -1,12 +1,12 @@ const initialiseThemeExtras = () => { - const toc = document.getElementById("toc") - toc.style.display = "" - const items = toc.getElementsByTagName("ul")[0] - items.style.display = "none" - toc.getElementsByTagName("h3").addEventListener("click", () => { - if (items.style.display !== "none") toc.classList.remove("expandedtoc") - else toc.classList.add("expandedtoc"); - }) -} -if (document.readyState !== "loading") initialiseThemeExtras() -else document.addEventListener("DOMContentLoaded", initialiseThemeExtras) + const toc = document.getElementById("toc"); + toc.style.display = ""; + const items = toc.getElementsByTagName("ul")[0]; + items.style.display = "none"; + toc.getElementsByTagName("h3").addEventListener("click", () => { + if (items.style.display !== "none") toc.classList.remove("expandedtoc"); + else toc.classList.add("expandedtoc"); + }); +}; +if (document.readyState !== "loading") initialiseThemeExtras(); +else document.addEventListener("DOMContentLoaded", initialiseThemeExtras); diff --git a/sphinx/theming.py b/sphinx/theming.py index a27dbfe0973..9e06faaeffc 100644 --- a/sphinx/theming.py +++ b/sphinx/theming.py @@ -28,6 +28,8 @@ from typing import Any, Required, TypedDict from sphinx.application import Sphinx + from sphinx.config import Config + from sphinx.registry import SphinxComponentRegistry class _ThemeToml(TypedDict, total=False): theme: Required[_ThemeTomlTheme] @@ -148,13 +150,21 @@ def _cleanup(self) -> None: class HTMLThemeFactory: """A factory class for HTML Themes.""" - def __init__(self, app: Sphinx) -> None: + def __init__( + self, + *, + confdir: Path, + app: Sphinx, + config: Config, + registry: SphinxComponentRegistry, + ) -> None: self._app = app - self._themes = app.registry.html_themes + self._confdir = confdir + self._themes = registry.html_themes self._entry_point_themes: dict[str, Callable[[], None]] = {} self._load_builtin_themes() - if getattr(app.config, 'html_theme_path', None): - self._load_additional_themes(app.config.html_theme_path) + if html_theme_path := getattr(config, 'html_theme_path', None): + self._load_additional_themes(html_theme_path) self._load_entry_point_themes() def _load_builtin_themes(self) -> None: @@ -166,7 +176,7 @@ def _load_builtin_themes(self) -> None: def _load_additional_themes(self, theme_paths: list[str]) -> None: """Load additional themes placed at specified directories.""" for theme_path in theme_paths: - abs_theme_path = (self._app.confdir / theme_path).resolve() + abs_theme_path = (self._confdir / theme_path).resolve() themes = self._find_themes(abs_theme_path) for name, theme in themes.items(): self._themes[name] = _StrPath(theme) diff --git a/sphinx/transforms/__init__.py b/sphinx/transforms/__init__.py index e1f905d2d0f..eb04025954b 100644 --- a/sphinx/transforms/__init__.py +++ b/sphinx/transforms/__init__.py @@ -15,17 +15,17 @@ from docutils.utils.smartquotes import smartchars from sphinx import addnodes +from sphinx.deprecation import _deprecation_warning from sphinx.locale import _, __ from sphinx.util import logging -from sphinx.util.docutils import new_document from sphinx.util.i18n import format_date from sphinx.util.nodes import apply_source_workaround, is_smartquotable if TYPE_CHECKING: - from collections.abc import Iterator - from typing import Any, Literal, TypeAlias + from collections.abc import Iterable, Iterator + from typing import Any, ClassVar, Literal - from docutils.nodes import Node, Text + from docutils.nodes import Node from typing_extensions import TypeIs from sphinx.application import Sphinx @@ -34,7 +34,7 @@ from sphinx.environment import BuildEnvironment from sphinx.util.typing import ExtensionMetadata - _DEFAULT_SUBSTITUTION_NAMES: TypeAlias = Literal[ + type _DEFAULT_SUBSTITUTION_NAMES = Literal[ 'version', 'release', 'today', @@ -62,7 +62,10 @@ class SphinxTransform(Transform): @property def app(self) -> Sphinx: """Reference to the :class:`.Sphinx` object.""" - return self.env.app + cls_module = self.__class__.__module__ + cls_name = self.__class__.__qualname__ + _deprecation_warning(cls_module, f'{cls_name}.app', remove=(11, 0)) + return self.env._app @property def env(self) -> BuildEnvironment: @@ -89,10 +92,12 @@ def apply_transforms(self) -> None: if not hasattr(self.document.settings, 'env') and self.env: self.document.settings.env = self.env - super().apply_transforms() # type: ignore[misc] + super().apply_transforms() else: # wrap the target node by document node during transforming try: + from sphinx.util.docutils import new_document + document = new_document('') if self.env: document.settings.env = self.env @@ -217,7 +222,7 @@ class SortIds(SphinxTransform): def apply(self, **kwargs: Any) -> None: for node in self.document.findall(nodes.section): if len(node['ids']) > 1 and node['ids'][0].startswith('id'): - node['ids'] = node['ids'][1:] + [node['ids'][0]] + node['ids'] = [*node['ids'][1:], node['ids'][0]] TRANSLATABLE_NODES = { @@ -236,7 +241,7 @@ class ApplySourceWorkaround(SphinxTransform): def apply(self, **kwargs: Any) -> None: for node in self.document.findall(): - if isinstance(node, nodes.TextElement | nodes.image | nodes.topic): + if isinstance(node, (nodes.TextElement, nodes.image, nodes.topic)): apply_source_workaround(node) @@ -276,6 +281,7 @@ def is_translatable_node(node: Node) -> TypeIs[nodes.Element]: return isinstance(node, target_nodes) for node in self.document.findall(is_translatable_node): + assert isinstance(node, nodes.Element) node['translatable'] = True @@ -359,15 +365,19 @@ class SphinxSmartQuotes(SmartQuotes, SphinxTransform): """ default_priority = 750 + smartquotes_action: ClassVar[str] = SmartQuotes.smartquotes_action def apply(self, **kwargs: Any) -> None: if not self.is_available(): return # override default settings with :confval:`smartquotes_action` - self.smartquotes_action = self.config.smartquotes_action + # TODO: TYPING: Upstream docutils should be updated so that + # smartquotes_action accepts any iterable of characters + # and can be overridden per-instance. + self.smartquotes_action = self.config.smartquotes_action # type: ignore[misc] - super().apply() # type: ignore[no-untyped-call] + super().apply() def is_available(self) -> bool: builders = self.config.smartquotes_excludes.get('builders', []) @@ -379,7 +389,7 @@ def is_available(self) -> bool: if self.config.smartquotes is False: # disabled by confval smartquotes return False - if self.app.builder.name in builders: + if self.env._builder_cls.name in builders: # disabled by confval smartquotes_excludes['builders'] return False if self.config.language in languages: @@ -390,7 +400,9 @@ def is_available(self) -> bool: language = self.env.settings['language_code'] return any(tag in smartchars.quotes for tag in normalize_language_tag(language)) - def get_tokens(self, txtnodes: list[Text]) -> Iterator[tuple[str, str]]: + def get_tokens( # type: ignore[override] + self, txtnodes: Iterable[Node] + ) -> Iterator[tuple[Literal['literal', 'plain'], str]]: # A generator that yields ``(texttype, nodetext)`` tuples for a list # of "Text" nodes (interface to ``smartquotes.educate_tokens()``). for txtnode in txtnodes: @@ -409,7 +421,7 @@ class DoctreeReadEvent(SphinxTransform): default_priority = 880 def apply(self, **kwargs: Any) -> None: - self.app.events.emit('doctree-read', self.document) + self.env.events.emit('doctree-read', self.document) class GlossarySorter(SphinxTransform): @@ -477,7 +489,7 @@ def _reorder_index_target_nodes(start_node: nodes.target) -> None: # as we want *consecutive* target & index nodes. node: nodes.Node for node in start_node.findall(descend=False, siblings=True): - if isinstance(node, nodes.target | addnodes.index): + if isinstance(node, (nodes.target, addnodes.index)): nodes_to_reorder.append(node) continue break # must be a consecutive run of target or index nodes diff --git a/sphinx/transforms/i18n.py b/sphinx/transforms/i18n.py index 815ca606bce..3be280859c2 100644 --- a/sphinx/transforms/i18n.py +++ b/sphinx/transforms/i18n.py @@ -2,13 +2,13 @@ from __future__ import annotations -import contextlib +from operator import attrgetter from re import DOTALL, match from textwrap import indent -from typing import TYPE_CHECKING, Any, TypeVar +from typing import TYPE_CHECKING, Any +import docutils.utils from docutils import nodes -from docutils.io import StringInput from sphinx import addnodes from sphinx.domains.std import make_glossary_term, split_term_classifiers @@ -17,6 +17,7 @@ from sphinx.locale import init as init_locale from sphinx.transforms import SphinxTransform from sphinx.util import get_filetype, logging +from sphinx.util.docutils import LoggingReporter from sphinx.util.i18n import docname_to_domain from sphinx.util.index_entries import split_index_msg from sphinx.util.nodes import ( @@ -28,10 +29,13 @@ ) if TYPE_CHECKING: - from collections.abc import Sequence + from collections.abc import Callable, Sequence from sphinx.application import Sphinx from sphinx.config import Config + from sphinx.environment import BuildEnvironment + from sphinx.registry import SphinxComponentRegistry + from sphinx.util.docutils import _DocutilsSettings from sphinx.util.typing import ExtensionMetadata @@ -44,52 +48,49 @@ EXCLUDED_PENDING_XREF_ATTRIBUTES = ('refexplicit',) -N = TypeVar('N', bound=nodes.Node) - - -def publish_msgstr( - app: Sphinx, +def _publish_msgstr( source: str, source_path: str, source_line: int, + *, config: Config, - settings: Any, + env: BuildEnvironment, + registry: SphinxComponentRegistry, + settings: _DocutilsSettings, ) -> nodes.Element: """Publish msgstr (single line) into docutils document - :param sphinx.application.Sphinx app: sphinx application :param str source: source text :param str source_path: source path for warning indication :param source_line: source line for warning indication + :param sphinx.util.docutils._DocutilsSettings settings: docutils settings :param sphinx.config.Config config: sphinx config - :param docutils.frontend.Values settings: docutils settings + :param sphinx.environment.BuildEnvironment env: sphinx environment + :param sphinx.registry.SphinxComponentRegistry registry: sphinx registry :return: document :rtype: docutils.nodes.document """ + filetype = get_filetype(config.source_suffix, source_path) + doc = docutils.utils.new_document( + f'{source_path}:{source_line}:', settings + ) + doc.reporter = LoggingReporter.from_reporter(doc.reporter) + + # clear rst_prolog temporarily + rst_prolog = config.rst_prolog + config.rst_prolog = None try: - # clear rst_prolog temporarily - rst_prolog = config.rst_prolog - config.rst_prolog = None - - from sphinx.io import SphinxI18nReader - - reader = SphinxI18nReader() - reader.setup(app) - filetype = get_filetype(config.source_suffix, source_path) - parser = app.registry.create_source_parser(app, filetype) - doc = reader.read( - source=StringInput( - source=source, source_path=f'{source_path}:{source_line}:' - ), - parser=parser, - settings=settings, - ) - with contextlib.suppress(IndexError): # empty node - return doc[0] - return doc + parser = registry.create_source_parser(filetype, config=config, env=env) + parser.parse(source, doc) + doc.current_source = doc.current_line = None finally: config.rst_prolog = rst_prolog + try: + return doc[0] # type: ignore[return-value] + except IndexError: # empty node + return doc + def parse_noqa(source: str) -> tuple[str, bool]: m = match(r'(.*)(? None: - for node in self.document.findall(addnodes.translatable): + matcher = NodeMatcher(addnodes.translatable) # type: ignore[type-abstract] + for node in matcher.findall(self.document): node.preserve_original_messages() @@ -129,10 +131,25 @@ def compare_references( old_refs: Sequence[nodes.Element], new_refs: Sequence[nodes.Element], warning_msg: str, + *, + key_func: Callable[[nodes.Element], Any] = attrgetter('rawsource'), ) -> None: - """Warn about mismatches between references in original and translated content.""" - # FIXME: could use a smarter strategy than len(old_refs) == len(new_refs) - if not self.noqa and len(old_refs) != len(new_refs): + """Warn about mismatches between references in original and translated content. + Ignores the order of references when comparing. This allows translators to + reorder references while still catching missing or extra references. + + :param key_func: A function to extract the comparison key from each reference. + Defaults to extracting the ``rawsource`` attribute. + """ + old_ref_keys = list(map(key_func, old_refs)) + new_ref_keys = list(map(key_func, new_refs)) + + # The ref_keys lists may contain ``None``, so compare hashes. + # Recall objects which compare equal have the same hash value. + old_ref_keys.sort(key=hash) + new_ref_keys.sort(key=hash) + + if not self.noqa and old_ref_keys != new_ref_keys: old_ref_rawsources = [ref.rawsource for ref in old_refs] new_ref_rawsources = [ref.rawsource for ref in new_refs] logger.warning( @@ -211,7 +228,7 @@ def update_title_mapping(self) -> bool: def update_autofootnote_references(self) -> None: # auto-numbered foot note reference should use original 'ids'. - def list_replace_or_append(lst: list[N], old: N, new: N) -> None: + def list_replace_or_append[N: nodes.Node](lst: list[N], old: N, new: N) -> None: if old in lst: lst[lst.index(old)] = new else: @@ -344,6 +361,8 @@ def update_pending_xrefs(self) -> None: 'inconsistent term references in translated message.' ' original: {0}, translated: {1}' ), + # Compare by reftarget only, allowing translated display text. + key_func=lambda ref: ref.get('reftarget'), ) xref_reftarget_map: dict[tuple[str, str, str] | None, dict[str, Any]] = {} @@ -386,7 +405,9 @@ def apply(self, **kwargs: Any) -> None: settings, source = self.document.settings, self.document['source'] msgstr = '' - textdomain = docname_to_domain(self.env.docname, self.config.gettext_compact) + textdomain = docname_to_domain( + self.env.current_document.docname, self.config.gettext_compact + ) # fetch translations srcdir = self.env.srcdir @@ -435,13 +456,14 @@ def apply(self, **kwargs: Any) -> None: if isinstance(node, LITERAL_TYPE_NODES): msgstr = '::\n\n' + indent(msgstr, ' ' * 3) - patch = publish_msgstr( - self.app, + patch = _publish_msgstr( msgstr, source, node.line, # type: ignore[arg-type] - self.config, - settings, + config=self.config, + env=self.env, + registry=self.env._registry, + settings=settings, ) # FIXME: no warnings about inconsistent references in this part # XXX doctest and other block markup @@ -455,13 +477,14 @@ def apply(self, **kwargs: Any) -> None: if isinstance(node, nodes.term): for _id in node['ids']: term, first_classifier = split_term_classifiers(msgstr) - patch = publish_msgstr( - self.app, + patch = _publish_msgstr( term or '', source, node.line, # type: ignore[arg-type] - self.config, - settings, + config=self.config, + env=self.env, + registry=self.env._registry, + settings=settings, ) updater.patch = make_glossary_term( self.env, @@ -532,13 +555,14 @@ def apply(self, **kwargs: Any) -> None: # This generates:
        msgstr
        msgstr = msgstr + '\n' + '=' * len(msgstr) * 2 - patch = publish_msgstr( - self.app, + patch = _publish_msgstr( msgstr, source, node.line, # type: ignore[arg-type] - self.config, - settings, + config=self.config, + env=self.env, + registry=self.env._registry, + settings=settings, ) # Structural Subelements phase2 if isinstance(node, nodes.title): @@ -612,7 +636,7 @@ class TranslationProgressTotaliser(SphinxTransform): def apply(self, **kwargs: Any) -> None: from sphinx.builders.gettext import MessageCatalogBuilder - if isinstance(self.app.builder, MessageCatalogBuilder): + if issubclass(self.env._builder_cls, MessageCatalogBuilder): return total = translated = 0 @@ -635,7 +659,7 @@ class AddTranslationClasses(SphinxTransform): def apply(self, **kwargs: Any) -> None: from sphinx.builders.gettext import MessageCatalogBuilder - if isinstance(self.app.builder, MessageCatalogBuilder): + if issubclass(self.env._builder_cls, MessageCatalogBuilder): return if not self.config.translation_progress_classes: @@ -673,7 +697,7 @@ class RemoveTranslatableInline(SphinxTransform): def apply(self, **kwargs: Any) -> None: from sphinx.builders.gettext import MessageCatalogBuilder - if isinstance(self.app.builder, MessageCatalogBuilder): + if issubclass(self.env._builder_cls, MessageCatalogBuilder): return matcher = NodeMatcher(nodes.inline, translatable=Any) diff --git a/sphinx/transforms/post_transforms/__init__.py b/sphinx/transforms/post_transforms/__init__.py index d9c5031b31c..54118f80ced 100644 --- a/sphinx/transforms/post_transforms/__init__.py +++ b/sphinx/transforms/post_transforms/__init__.py @@ -18,7 +18,7 @@ if TYPE_CHECKING: from collections.abc import Sequence - from typing import Any + from typing import Any, ClassVar from docutils.nodes import Element, Node @@ -47,9 +47,9 @@ def apply(self, **kwargs: Any) -> None: def is_supported(self) -> bool: """Check this transform working for current builder.""" - if self.builders and self.app.builder.name not in self.builders: + if self.builders and self.env._builder_cls.name not in self.builders: return False - return not self.formats or self.app.builder.format in self.formats + return not self.formats or self.env._builder_cls.format in self.formats def run(self, **kwargs: Any) -> None: """Main method of post transforms. @@ -62,7 +62,7 @@ def run(self, **kwargs: Any) -> None: class ReferencesResolver(SphinxPostTransform): """Resolves cross-references on doctrees.""" - default_priority = 10 + default_priority: ClassVar[int] = 10 def run(self, **kwargs: Any) -> None: for node in self.document.findall(addnodes.pending_xref): @@ -98,7 +98,7 @@ def _resolve_pending_xref( new_node: nodes.reference | None typ = node['reftype'] target = node['reftarget'] - ref_doc = node.setdefault('refdoc', self.env.docname) + ref_doc = node.setdefault('refdoc', self.env.current_document.docname) ref_domain = node.get('refdomain', '') domain: Domain | None if ref_domain: @@ -125,7 +125,7 @@ def _resolve_pending_xref( try: # no new node found? try the missing-reference event - new_node = self.app.events.emit_firstresult( + new_node = self.env.events.emit_firstresult( 'missing-reference', self.env, node, @@ -169,10 +169,11 @@ def _resolve_pending_xref_in_domain( typ: str, target: str, ) -> nodes.reference | None: + builder = self.env._app.builder # let the domain try to resolve the reference if domain is not None: return domain.resolve_xref( - self.env, ref_doc, self.app.builder, typ, target, node, contnode + self.env, ref_doc, builder, typ, target, node, contnode ) # really hardwired reference types @@ -193,7 +194,7 @@ def _resolve_pending_any_xref( ) -> nodes.reference | None: """Resolve reference generated by the "any" role.""" env = self.env - builder = self.app.builder + builder = self.env._app.builder domains = env.domains results: list[tuple[str, nodes.reference]] = [] @@ -227,12 +228,7 @@ def _resolve_pending_any_xref( if not results: return None if len(results) > 1: - - def stringify(name: str, node: Element) -> str: - reftitle = node.get('reftitle', node.astext()) - return f':{name}:`{reftitle}`' - - candidates = ' or '.join(starmap(stringify, results)) + candidates = ' or '.join(starmap(self._stringify, results)) msg = __( "more than one target found for 'any' cross-reference %r: could be %s" ) @@ -251,6 +247,11 @@ def stringify(name: str, node: Element) -> str: new_node[0]['classes'].extend((res_domain, res_role.replace(':', '-'))) return new_node + @staticmethod + def _stringify(name: str, node: Element) -> str: + reftitle = node.get('reftitle', node.astext()) + return f':{name}:`{reftitle}`' + def warn_missing_reference( self, refdoc: str, @@ -273,25 +274,16 @@ def warn_missing_reference( ): # fmt: skip warn = False if self.config.nitpick_ignore_regex: - - def matches_ignore(entry_type: str, entry_target: str) -> bool: - return any( - ( - re.fullmatch(ignore_type, entry_type) - and re.fullmatch(ignore_target, entry_target) - ) - for ignore_type, ignore_target in self.config.nitpick_ignore_regex - ) - - if matches_ignore(dtype, target): + if _matches_ignore(self.config.nitpick_ignore_regex, dtype, target): warn = False # for "std" types also try without domain name - if (not domain or domain.name == 'std') and matches_ignore(typ, target): - warn = False + if not domain or domain.name == 'std': + if _matches_ignore(self.config.nitpick_ignore_regex, typ, target): + warn = False if not warn: return - if self.app.events.emit_firstresult('warn-missing-reference', domain, node): + if self.env.events.emit_firstresult('warn-missing-reference', domain, node): return elif domain and typ in domain.dangling_warnings: msg = domain.dangling_warnings[typ] % {'target': target} @@ -317,6 +309,18 @@ def find_pending_xref_condition( return None +def _matches_ignore( + ignore_patterns: Sequence[tuple[str, str]], entry_type: str, entry_target: str +) -> bool: + return any( + ( + re.fullmatch(ignore_type, entry_type) + and re.fullmatch(ignore_target, entry_target) + ) + for ignore_type, ignore_target in ignore_patterns + ) + + class OnlyNodeTransform(SphinxPostTransform): default_priority = 50 @@ -325,7 +329,7 @@ def run(self, **kwargs: Any) -> None: # result in a "Losing ids" exception if there is a target node before # the only node, so we make sure docutils can transfer the id to # something, even if it's just a comment and will lose the id anyway... - process_only_nodes(self.document, self.app.tags) + process_only_nodes(self.document, self.env._tags) class SigElementFallbackTransform(SphinxPostTransform): @@ -340,7 +344,7 @@ def has_visitor( return hasattr(translator, 'visit_%s' % node.__name__) try: - translator = self.app.builder.get_translator_class() + translator = self.env._registry.get_translator_class(self.env._builder_cls) except AttributeError: # do nothing if no translator class is specified (e.g., on a dummy builder) return diff --git a/sphinx/transforms/post_transforms/code.py b/sphinx/transforms/post_transforms/code.py index 2d89bc65ac8..1db5800487d 100644 --- a/sphinx/transforms/post_transforms/code.py +++ b/sphinx/transforms/post_transforms/code.py @@ -13,7 +13,7 @@ from sphinx.transforms import SphinxTransform if TYPE_CHECKING: - from typing import Any + from typing import Any, ClassVar from docutils.nodes import Node, TextElement @@ -35,7 +35,7 @@ class HighlightLanguageTransform(SphinxTransform): removes ``highlightlang`` node from doctree. """ - default_priority = 400 + default_priority: ClassVar[int] = 400 def apply(self, **kwargs: Any) -> None: visitor = HighlightLanguageVisitor( diff --git a/sphinx/transforms/post_transforms/images.py b/sphinx/transforms/post_transforms/images.py index d4c6262e529..6e6e9becb20 100644 --- a/sphinx/transforms/post_transforms/images.py +++ b/sphinx/transforms/post_transforms/images.py @@ -45,16 +45,16 @@ def handle(self, node: nodes.image) -> None: @property def imagedir(self) -> _StrPath: - return self.app.doctreedir / 'images' + return self.env.doctreedir / 'images' class ImageDownloader(BaseImageConverter): default_priority = 100 def match(self, node: nodes.image) -> bool: - if not self.app.builder.supported_image_types: + if not self.env._builder_cls.supported_image_types: return False - if self.app.builder.supported_remote_images: + if self.env._builder_cls.supported_remote_images: return False return '://' in node['uri'] @@ -123,14 +123,14 @@ def _process_image(self, node: nodes.image, path: Path) -> None: node['candidates'].pop('?') node['candidates'][mimetype] = path_str node['uri'] = path_str - self.env.images.add_file(self.env.docname, path_str) + self.env.images.add_file(self.env.current_document.docname, path_str) class DataURIExtractor(BaseImageConverter): default_priority = 150 def match(self, node: nodes.image) -> bool: - if self.app.builder.supported_data_uri_images is True: + if self.env._builder_cls.supported_data_uri_images is True: return False # do not transform the image; data URIs are valid in the build output return node['uri'].startswith('data:') @@ -156,7 +156,7 @@ def handle(self, node: nodes.image) -> None: node['candidates'].pop('?') node['candidates'][image.mimetype] = path_str node['uri'] = path_str - self.env.images.add_file(self.env.docname, path_str) + self.env.images.add_file(self.env.current_document.docname, path_str) def get_filename_for(filename: str, mimetype: str) -> str: @@ -208,12 +208,12 @@ class ImageConverter(BaseImageConverter): conversion_rules: list[tuple[str, str]] = [] def match(self, node: nodes.image) -> bool: - if not self.app.builder.supported_image_types: + if not self.env._builder_cls.supported_image_types: return False if '?' in node['candidates']: return False node_mime_types = set(self.guess_mimetypes(node)) - supported_image_types = set(self.app.builder.supported_image_types) + supported_image_types = set(self.env._builder_cls.supported_image_types) if node_mime_types & supported_image_types: # builder supports the image; no need to convert return False @@ -233,7 +233,7 @@ def match(self, node: nodes.image) -> bool: def get_conversion_rule(self, node: nodes.image) -> tuple[str, str]: for candidate in self.guess_mimetypes(node): - for supported in self.app.builder.supported_image_types: + for supported in self.env._builder_cls.supported_image_types: rule = (candidate, supported) if rule in self.conversion_rules: return rule @@ -250,7 +250,7 @@ def guess_mimetypes(self, node: nodes.image) -> list[str]: if '?' in node['candidates']: return [] elif '*' in node['candidates']: - path = self.app.srcdir / node['uri'] + path = self.env.srcdir / node['uri'] guessed = guess_mimetype(path) return [guessed] if guessed is not None else [] else: @@ -269,7 +269,7 @@ def handle(self, node: nodes.image) -> None: ensuredir(self.imagedir) destpath = self.imagedir / filename - abs_srcpath = self.app.srcdir / srcpath + abs_srcpath = self.env.srcdir / srcpath if self.convert(abs_srcpath, destpath): if '*' in node['candidates']: node['candidates']['*'] = str(destpath) @@ -278,7 +278,7 @@ def handle(self, node: nodes.image) -> None: node['uri'] = str(destpath) self.env.original_image_uri[destpath] = srcpath - self.env.images.add_file(self.env.docname, destpath) + self.env.images.add_file(self.env.current_document.docname, destpath) def convert( self, _from: str | os.PathLike[str], _to: str | os.PathLike[str] diff --git a/sphinx/transforms/references.py b/sphinx/transforms/references.py index 447e9ded568..8655dbfa5f3 100644 --- a/sphinx/transforms/references.py +++ b/sphinx/transforms/references.py @@ -25,7 +25,7 @@ def apply(self, **kwargs: Any) -> None: # suppress INFO level messages for a while reporter.report_level = max(reporter.WARNING_LEVEL, reporter.report_level) - super().apply() # type: ignore[no-untyped-call] + super().apply() finally: reporter.report_level = report_level @@ -36,7 +36,9 @@ class SphinxDomains(SphinxTransform): default_priority = 850 def apply(self, **kwargs: Any) -> None: - self.env.domains._process_doc(self.env, self.env.docname, self.document) + self.env.domains._process_doc( + self.env, self.env.current_document.docname, self.document + ) def setup(app: Sphinx) -> ExtensionMetadata: diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py index 246bf8fc872..e50ed92a627 100644 --- a/sphinx/util/__init__.py +++ b/sphinx/util/__init__.py @@ -69,35 +69,7 @@ def __getattr__(name: str) -> Any: return mod - # RemovedInSphinx90Warning - if name == 'split_index_msg': - from sphinx.util.index_entries import split_index_msg as obj - - canonical_name = f'{obj.__module__}.{obj.__qualname__}' - _deprecation_warning(__name__, name, canonical_name, remove=(9, 0)) - return obj - - if name == 'split_into': - from sphinx.util.index_entries import _split_into as obj - - _deprecation_warning(__name__, name, '', remove=(9, 0)) - return obj - - if name == 'ExtensionError': - from sphinx.errors import ExtensionError as obj # NoQA: N813 - - canonical_name = f'{obj.__module__}.{obj.__qualname__}' - _deprecation_warning(__name__, name, canonical_name, remove=(9, 0)) - return obj - - if name in {'md5', 'sha1'}: - obj = globals()[f'_{name}'] - canonical_name = f'hashlib.{name}' - _deprecation_warning(__name__, name, canonical_name, remove=(9, 0)) - return obj - # RemovedInSphinx10Warning - if name in {'DownloadFiles', 'FilenameUniqDict'}: from sphinx.util import _files as mod diff --git a/sphinx/util/_io.py b/sphinx/util/_io.py index 94ad9f8f0d0..f363e1fc58d 100644 --- a/sphinx/util/_io.py +++ b/sphinx/util/_io.py @@ -28,6 +28,6 @@ def write(self, text: str, /) -> None: def flush(self) -> None: if hasattr(self.stream_term, 'flush'): - self.stream_term.flush() + self.stream_term.flush() # ty: ignore[call-non-callable] if hasattr(self.stream_file, 'flush'): - self.stream_file.flush() + self.stream_file.flush() # ty: ignore[call-non-callable] diff --git a/sphinx/util/_pathlib.py b/sphinx/util/_pathlib.py index 0506131f962..73b07ec94aa 100644 --- a/sphinx/util/_pathlib.py +++ b/sphinx/util/_pathlib.py @@ -1,4 +1,4 @@ -"""What follows is awful and will be gone in Sphinx 9. +"""What follows is awful and will be gone in Sphinx 10. Instances of _StrPath should not be constructed except in Sphinx itself. Consumers of Sphinx APIs should prefer using ``pathlib.Path`` objects @@ -8,7 +8,7 @@ To continue treating path-like objects as strings, use ``os.fspath``, or explicit string coercion. -In Sphinx 9, ``Path`` objects will be expected and returned in all instances +In Sphinx 10, ``Path`` objects will be expected and returned in all instances that ``_StrPath`` is currently used. """ @@ -19,7 +19,7 @@ from pathlib import Path, PosixPath, PurePath, WindowsPath from typing import TYPE_CHECKING, overload -from sphinx.deprecation import RemovedInSphinx90Warning +from sphinx.deprecation import RemovedInSphinx10Warning if TYPE_CHECKING: from typing import Any @@ -28,7 +28,7 @@ _PATH_NAME = Path().__class__.__name__ _MSG = ( - 'Sphinx 9 will drop support for representing paths as strings. ' + 'Sphinx 10 will drop support for representing paths as strings. ' 'Use "pathlib.Path" or "os.fspath" instead.' ) @@ -43,39 +43,39 @@ def replace( # type: ignore[override] ) -> str: # replace exists in both Path and str; # in Path it makes filesystem changes, so we use the safer str version - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return self.__str__().replace(old, new, count) # NoQA: PLC2801 def __getattr__(self, item: str) -> Any: if item in _STR_METHODS: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return getattr(self.__str__(), item) msg = f'{_PATH_NAME!r} has no attribute {item!r}' raise AttributeError(msg) def __add__(self, other: str) -> str: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return self.__str__() + other def __radd__(self, other: str) -> str: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return other + self.__str__() def __bool__(self) -> bool: if not self.__str__(): - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return False return True def __contains__(self, item: str) -> bool: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return item in self.__str__() def __eq__(self, other: object) -> bool: if isinstance(other, PurePath): return super().__eq__(other) if isinstance(other, str): - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return self.__str__() == other return NotImplemented @@ -83,11 +83,11 @@ def __hash__(self) -> int: return super().__hash__() def __getitem__(self, item: int | slice) -> str: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return self.__str__()[item] def __len__(self) -> int: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return len(self.__str__()) else: @@ -98,39 +98,39 @@ def replace( # type: ignore[override] ) -> str: # replace exists in both Path and str; # in Path it makes filesystem changes, so we use the safer str version - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return self.__str__().replace(old, new, count) # NoQA: PLC2801 def __getattr__(self, item: str) -> Any: if item in _STR_METHODS: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return getattr(self.__str__(), item) msg = f'{_PATH_NAME!r} has no attribute {item!r}' raise AttributeError(msg) def __add__(self, other: str) -> str: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return self.__str__() + other def __radd__(self, other: str) -> str: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return other + self.__str__() def __bool__(self) -> bool: if not self.__str__(): - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return False return True def __contains__(self, item: str) -> bool: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return item in self.__str__() def __eq__(self, other: object) -> bool: if isinstance(other, PurePath): return super().__eq__(other) if isinstance(other, str): - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return self.__str__() == other return NotImplemented @@ -138,11 +138,11 @@ def __hash__(self) -> int: return super().__hash__() def __getitem__(self, item: int | slice) -> str: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return self.__str__()[item] def __len__(self) -> int: - warnings.warn(_MSG, RemovedInSphinx90Warning, stacklevel=2) + warnings.warn(_MSG, RemovedInSphinx10Warning, stacklevel=2) return len(self.__str__()) diff --git a/sphinx/util/_serialise.py b/sphinx/util/_serialise.py index df2d66c717d..fd984f23558 100644 --- a/sphinx/util/_serialise.py +++ b/sphinx/util/_serialise.py @@ -19,9 +19,9 @@ def stable_hash(obj: Any) -> str: """ if isinstance(obj, dict): obj = sorted(map(stable_hash, obj.items())) - if isinstance(obj, list | tuple | set | frozenset): + if isinstance(obj, (list, tuple, set, frozenset)): obj = sorted(map(stable_hash, obj)) - elif isinstance(obj, type | types.FunctionType): + elif isinstance(obj, (type, types.FunctionType)): # The default repr() of functions includes the ID, which is not ideal. # We use the fully qualified name instead. obj = f'{obj.__module__}.{obj.__qualname__}' @@ -39,13 +39,15 @@ def stable_str(obj: Any, *, indent: int | None = None) -> str: def _stable_str_prep(obj: Any) -> dict[str, Any] | list[Any] | str: if isinstance(obj, dict): # Convert to a sorted dict - obj = [(_stable_str_prep(k), _stable_str_prep(v)) for k, v in obj.items()] - obj.sort() - return dict(obj) - if isinstance(obj, list | tuple | set | frozenset): + lst: list[tuple[Any, Any]] = [ + (_stable_str_prep(k), _stable_str_prep(v)) for k, v in obj.items() + ] + lst.sort() + return dict(lst) + if isinstance(obj, (list, tuple, set, frozenset)): # Convert to a sorted list return sorted(map(_stable_str_prep, obj), key=str) - if isinstance(obj, type | types.FunctionType): + if isinstance(obj, (type, types.FunctionType)): # The default repr() of functions includes the ID, which is not ideal. # We use the fully qualified name instead. return f'{obj.__module__}.{obj.__qualname__}' diff --git a/sphinx/util/cfamily.py b/sphinx/util/cfamily.py index 6071d90cf74..6595859c629 100644 --- a/sphinx/util/cfamily.py +++ b/sphinx/util/cfamily.py @@ -13,13 +13,13 @@ if TYPE_CHECKING: from collections.abc import Callable, Sequence - from typing import Any, NoReturn, TypeAlias + from typing import Any, NoReturn from docutils.nodes import TextElement from sphinx.config import Config - StringifyTransform: TypeAlias = Callable[[Any], str] + type StringifyTransform = Callable[[Any], str] logger = logging.getLogger(__name__) @@ -356,7 +356,10 @@ def fail(self, msg: str) -> NoReturn: raise self._make_multi_error(errors, '') def warn(self, msg: str) -> None: - logger.warning(msg, location=self.location) + subtype = 'c' if self.language == 'C' else 'cpp' + logger.warning( + msg, location=self.location, type='source_code_parser', subtype=subtype + ) def match(self, regex: re.Pattern[str]) -> bool: match = regex.match(self.definition, self.pos) diff --git a/sphinx/util/display.py b/sphinx/util/display.py index 1edca4e6c7d..e134f8caf7e 100644 --- a/sphinx/util/display.py +++ b/sphinx/util/display.py @@ -10,24 +10,20 @@ if TYPE_CHECKING: from collections.abc import Callable, Iterable, Iterator from types import TracebackType - from typing import Any, ParamSpec, TypeVar - - T = TypeVar('T') - P = ParamSpec('P') - R = TypeVar('R') + from typing import Any logger = logging.getLogger(__name__) def display_chunk(chunk: Any) -> str: - if isinstance(chunk, list | tuple): + if isinstance(chunk, (list, tuple)): if len(chunk) == 1: return str(chunk[0]) return f'{chunk[0]} .. {chunk[-1]}' return str(chunk) -def status_iterator( +def status_iterator[T]( iterable: Iterable[T], summary: str, color: str = 'darkgreen', @@ -90,7 +86,7 @@ def __exit__( return False - def __call__(self, f: Callable[P, R]) -> Callable[P, R]: + def __call__[**P, R](self, f: Callable[P, R]) -> Callable[P, R]: @functools.wraps(f) def wrapper(*args: P.args, **kwargs: P.kwargs) -> R: # type: ignore[return] with self: diff --git a/sphinx/util/docfields.py b/sphinx/util/docfields.py index 1c24a73bf2e..7644694823f 100644 --- a/sphinx/util/docfields.py +++ b/sphinx/util/docfields.py @@ -17,8 +17,6 @@ from sphinx.util.nodes import get_node_line if TYPE_CHECKING: - from typing import TypeAlias, TypeVar - from docutils.nodes import Element, Node from docutils.parsers.rst.states import Inliner @@ -26,10 +24,9 @@ from sphinx.environment import BuildEnvironment from sphinx.util.typing import TextlikeNode - ObjDescT = TypeVar('ObjDescT') - _FieldEntry: TypeAlias = tuple[str, list[Node]] - _FieldTypes: TypeAlias = dict[str, list[Node]] - _EntriesTriple: TypeAlias = tuple['Field', _FieldEntry | list[_FieldEntry], Element] + type _FieldEntry = tuple[str, list[Node]] + type _FieldTypes = dict[str, list[Node]] + type _EntriesTriple = tuple[Field, _FieldEntry | list[_FieldEntry], Element] logger = logging.getLogger(__name__) @@ -118,7 +115,7 @@ def make_xref( if location is not None: with contextlib.suppress(ValueError): lineno = get_node_line(location) - ns, messages = role(rolename, target, target, lineno, inliner, {}, []) + ns, _messages = role(rolename, target, target, lineno, inliner, {}, []) return nodes.inline(target, '', *ns) def make_xrefs( @@ -342,7 +339,7 @@ def handle_item(fieldarg: str, content: list[Node]) -> nodes.paragraph: return nodes.field('', fieldname, fieldbody) -class DocFieldTransformer: +class DocFieldTransformer[ObjDescT]: """Transforms field lists in "doc field" syntax into better-looking equivalents, using the field type definitions given on a domain. """ @@ -386,7 +383,7 @@ def _transform_step_1( field_body = cast('nodes.field_body', field[1]) try: # split into field type and argument - fieldtype_name, fieldarg = field_name.astext().split(None, 1) + fieldtype_name, fieldarg = field_name.astext().split(None, maxsplit=1) except ValueError: # maybe an argument-less field type? fieldtype_name, fieldarg = field_name.astext(), '' @@ -442,7 +439,7 @@ def _transform_step_1( if is_typefield: # filter out only inline nodes; others will result in invalid # markup being written out - content = [n for n in content if isinstance(n, nodes.Inline | nodes.Text)] + content = [n for n in content if isinstance(n, (nodes.Inline, nodes.Text))] if content: types.setdefault(typename, {})[fieldarg] = content return @@ -458,9 +455,12 @@ def _transform_step_1( fieldarg = argname translatable_content = nodes.inline(field_body.rawsource, translatable=True) - translatable_content.document = field_body.parent.document - translatable_content.source = field_body.parent.source - translatable_content.line = field_body.parent.line + parent = field_body.parent + assert parent is not None + assert parent.document is not None + translatable_content.document = parent.document + translatable_content.source = parent.source + translatable_content.line = parent.line translatable_content += content # grouped entries need to be collected in one entry, while others diff --git a/sphinx/util/docstrings.py b/sphinx/util/docstrings.py index 53e7620edc2..6f23096d92b 100644 --- a/sphinx/util/docstrings.py +++ b/sphinx/util/docstrings.py @@ -26,7 +26,7 @@ def separate_metadata(s: str | None) -> tuple[str | None, dict[str, str]]: else: matched = field_list_item_re.match(line) if matched and not in_other_element: - field_name = matched.group()[1:].split(':', 1)[0] + field_name = matched.group()[1:].partition(':')[0] if field_name.startswith('meta '): name = field_name[5:].strip() metadata[name] = line[matched.end() :].strip() diff --git a/sphinx/util/docutils.py b/sphinx/util/docutils.py index 70d8e69be6f..e307d8829ba 100644 --- a/sphinx/util/docutils.py +++ b/sphinx/util/docutils.py @@ -4,21 +4,26 @@ import os import re -from contextlib import contextmanager +import warnings +from contextlib import contextmanager, nullcontext from copy import copy from pathlib import Path from typing import TYPE_CHECKING import docutils +import docutils.frontend from docutils import nodes from docutils.io import FileOutput from docutils.parsers.rst import Directive, directives, roles +from docutils.readers import standalone from docutils.statemachine import StateMachine +from docutils.transforms.references import DanglingReferences from docutils.utils import Reporter, unescape from sphinx.errors import SphinxError from sphinx.locale import __ -from sphinx.util import logging +from sphinx.transforms import SphinxTransformer +from sphinx.util import logging, rst from sphinx.util.parsing import nested_parse_to_nodes logger = logging.getLogger(__name__) @@ -27,20 +32,25 @@ ) if TYPE_CHECKING: - from collections.abc import Iterator, Sequence + from collections.abc import Iterator, Mapping, Sequence from types import ModuleType, TracebackType from typing import Any, Protocol - from docutils.frontend import Values + from docutils import Component from docutils.nodes import Element, Node, system_message + from docutils.parsers import Parser from docutils.parsers.rst.states import Inliner from docutils.statemachine import State, StringList + from docutils.transforms import Transform from sphinx.builders import Builder from sphinx.config import Config from sphinx.environment import BuildEnvironment + from sphinx.events import EventManager from sphinx.util.typing import RoleFunction + type _DocutilsSettings = docutils.frontend.Values # pyright: ignore[reportDeprecated] # ty: ignore[deprecated] + class _LanguageModule(Protocol): labels: dict[str, str] author_separators: list[str] @@ -66,6 +76,13 @@ def __call__( ) -> tuple[RoleFunction | None, list[system_message]]: ... +_READER_TRANSFORMS = [ + transform + for transform in standalone.Reader().get_transforms() + if transform is not DanglingReferences +] + + additional_nodes: set[type[Element]] = set() @@ -270,7 +287,7 @@ def role( lineno: int, reporter: Reporter, ) -> tuple[RoleFunction, list[system_message]]: - return self.role_func( + return self.role_func( # ty: ignore[invalid-return-type] role_name, language_module, # type: ignore[return-value] lineno, @@ -370,7 +387,7 @@ def write(self, text: str) -> None: if not matched: logger.warning(text.rstrip('\r\n'), type='docutils') else: - location, type, level = matched.groups() + location, type, _level = matched.groups() message = report_re.sub('', text).rstrip() logger.log(type, message, location=location, type='docutils') @@ -450,7 +467,9 @@ def write(self, data: str) -> str: if on_disk == data: return data - return super().write(data) + # TODO: TYPING: Upstream docutils should annotate FileOutput.write() + # so that this suppression is unnecessary. + return super().write(data) # type: ignore[no-untyped-call] class SphinxDirective(Directive): @@ -485,7 +504,10 @@ def get_source_info(self) -> tuple[str, int]: .. versionadded:: 3.0 """ - return self.state_machine.get_source_and_line(self.lineno) + source, line = self.state_machine.get_source_and_line(self.lineno) + assert source is not None + assert line is not None + return source, line def set_source_info(self, node: Node) -> None: """Set source and line number to the node. @@ -662,7 +684,10 @@ def get_source_info(self, lineno: int | None = None) -> tuple[str, int]: # .. versionadded:: 3.0 if lineno is None: lineno = self.lineno - return self.inliner.reporter.get_source_and_line(lineno) # type: ignore[attr-defined] + source, line = self.inliner.reporter.get_source_and_line(lineno) + assert source is not None + assert line is not None + return str(source), line def set_source_info(self, node: Node, lineno: int | None = None) -> None: # .. versionadded:: 2.0 @@ -791,7 +816,7 @@ def unknown_visit(self, node: Node) -> None: # cache a vanilla instance of nodes.document # Used in new_document() function -__document_cache__: tuple[Values, Reporter] +__document_cache__: tuple[_DocutilsSettings, Reporter] def new_document(source_path: str, settings: Any = None) -> nodes.document: @@ -816,3 +841,103 @@ def new_document(source_path: str, settings: Any = None) -> nodes.document: document = nodes.document(settings, reporter, source=source_path) document.note_source(source_path, -1) return document + + +def _parse_str_to_doctree( + content: str, + *, + filename: Path, + default_role: str = '', + default_settings: Mapping[str, Any], + env: BuildEnvironment, + events: EventManager | None = None, + parser: Parser, + transforms: Sequence[type[Transform]] = (), +) -> nodes.document: + env.current_document._parser = parser + + # Propagate exceptions by default when used programmatically: + defaults = {'traceback': True, **default_settings} + settings = _get_settings( + standalone.Reader, parser, defaults=defaults, read_config_files=True + ) + settings._source = str(filename) + + # Create root document node + reporter = LoggingReporter( + source=str(filename), + report_level=settings.report_level, + halt_level=settings.halt_level, + debug=settings.debug, + error_handler=settings.error_encoding_error_handler, + ) + document = nodes.document(settings, reporter, source=str(filename)) + document.note_source(str(filename), -1) + + # substitute transformer + document.transformer = transformer = SphinxTransformer(document) + transformer.add_transforms(_READER_TRANSFORMS) + transformer.add_transforms(transforms) + transformer.add_transforms(parser.get_transforms()) + + if default_role: + default_role_cm = rst.default_role(env.current_document.docname, default_role) + else: + default_role_cm = nullcontext() # type: ignore[assignment] + with sphinx_domains(env), default_role_cm: + # TODO: Move the stanza below to Builder.read_doc(), within + # a sphinx_domains() context manager. + # This will require changes to IntersphinxDispatcher and/or + # CustomReSTDispatcher. + if events is not None: + # emit "source-read" event + arg = [content] + events.emit('source-read', env.current_document.docname, arg) + content = arg[0] + + # parse content to abstract syntax tree + parser.parse(content, document) + document.current_source = document.current_line = None + + # run transforms + transformer.apply_transforms() + + return document + + +def _get_settings( + *components: Component | type[Component], + defaults: Mapping[str, Any], + read_config_files: bool = False, +) -> _DocutilsSettings: + with warnings.catch_warnings(action='ignore', category=DeprecationWarning): + # DeprecationWarning: The frontend.OptionParser class will be replaced + # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later. + # DeprecationWarning: The frontend.Option class will be removed + # in Docutils 0.21 or later. + option_parser = docutils.frontend.OptionParser( # pyright: ignore[reportDeprecated] # ty: ignore[deprecated] + components=components, + defaults=defaults, + read_config_files=read_config_files, + ) + with warnings.catch_warnings(action='ignore', category=DeprecationWarning): + # DeprecationWarning: frontend.Values class will be removed + # in Docutils 2.0 or later. + settings = option_parser.get_default_values() + return settings + + +if docutils.__version_info__[:2] < (0, 22): + from docutils.parsers.rst import roles + + def _normalize_options(options: dict[str, Any] | None) -> dict[str, Any]: + if options is None: + return {} + n_options = options.copy() + roles.set_classes(n_options) # pyright: ignore[reportDeprecated] # ty: ignore[deprecated] + return n_options + +else: + from docutils.parsers.rst.roles import ( + normalize_options as _normalize_options, # NoQA: F401 # ty: ignore[unresolved-import] + ) diff --git a/sphinx/util/http_date.py b/sphinx/util/http_date.py index db0ae306b54..af5448d0e97 100644 --- a/sphinx/util/http_date.py +++ b/sphinx/util/http_date.py @@ -6,11 +6,8 @@ from __future__ import annotations import time -import warnings from email.utils import parsedate_tz -from sphinx.deprecation import RemovedInSphinx90Warning - _WEEKDAY_NAME = ('Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun') _MONTH_NAME = ('', # Placeholder for indexing purposes 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', @@ -32,19 +29,17 @@ def rfc1123_to_epoch(rfc1123: str) -> float: if t is None: raise ValueError if not rfc1123.endswith(' GMT'): - warnings.warn( + msg = ( 'HTTP-date string does not meet RFC 7231 requirements ' - f"(must end with 'GMT'): {rfc1123!r}", - RemovedInSphinx90Warning, - stacklevel=3, + f"(must end with 'GMT'): {rfc1123!r}" ) - epoch_secs = time.mktime(time.struct_time(t[:9])) + _GMT_OFFSET - if (gmt_offset := t[9]) != 0: - warnings.warn( + raise ValueError(msg) + gmt_offset = t[9] + if gmt_offset != 0: + msg = ( 'HTTP-date string does not meet RFC 7231 requirements ' - f'(must be GMT time): {rfc1123!r}', - RemovedInSphinx90Warning, - stacklevel=3, + f'(must be GMT time): {rfc1123!r}' ) - return epoch_secs - (gmt_offset or 0) + raise ValueError(msg) + epoch_secs = time.mktime(time.struct_time(t[:9])) + _GMT_OFFSET return epoch_secs diff --git a/sphinx/util/i18n.py b/sphinx/util/i18n.py index 6cc4b31766e..06bae4b8861 100644 --- a/sphinx/util/i18n.py +++ b/sphinx/util/i18n.py @@ -21,7 +21,7 @@ if TYPE_CHECKING: import datetime as dt from collections.abc import Iterator - from typing import Protocol, TypeAlias + from typing import Protocol from babel.core import Locale @@ -53,7 +53,7 @@ def __call__( locale: str | Locale | None = ..., ) -> str: ... - Formatter: TypeAlias = DateFormatter | TimeFormatter | DatetimeFormatter + type Formatter = DateFormatter | TimeFormatter | DatetimeFormatter from datetime import UTC @@ -168,7 +168,7 @@ def docname_to_domain(docname: str, compaction: bool | str) -> str: if isinstance(compaction, str): return compaction if compaction: - return docname.split(SEP, 1)[0] + return docname.partition(SEP)[0] else: return docname @@ -218,7 +218,7 @@ def docname_to_domain(docname: str, compaction: bool | str) -> str: def babel_format_date( - date: datetime, + date: dt.datetime, format: str, locale: str, formatter: Formatter = babel.dates.format_date, @@ -228,6 +228,14 @@ def babel_format_date( if not hasattr(date, 'tzinfo'): formatter = babel.dates.format_date + if not locale: + # Babel would not accept a falsy locale + # (or would try to fall back to the LC_TIME + # locale, which would be not what was requested), + # so we can just short-cut to English, as we + # would for the `"fallback to English"` case. + locale = 'en' + try: return formatter(date, format, locale=locale) except (ValueError, babel.core.UnknownLocaleError): @@ -311,7 +319,7 @@ def get_image_filename_for_language( ) -> str: root, ext = os.path.splitext(filename) dirname = os.path.dirname(root) - docpath = os.path.dirname(env.docname) + docpath = os.path.dirname(env.current_document.docname) try: return env.config.figure_language_filename.format( root=root, diff --git a/sphinx/util/images.py b/sphinx/util/images.py index b43a0705d36..e9963d484fe 100644 --- a/sphinx/util/images.py +++ b/sphinx/util/images.py @@ -5,6 +5,7 @@ import base64 from pathlib import Path from typing import TYPE_CHECKING, NamedTuple, overload +from urllib.parse import unquote_to_bytes import imagesize @@ -91,20 +92,27 @@ def parse_data_uri(uri: str) -> DataURI | None: if not uri.startswith('data:'): return None + if ',' not in uri: + msg = 'malformed data URI' + raise ValueError(msg) + # data:[][;charset=][;base64], mimetype = 'text/plain' charset = 'US-ASCII' - properties, data = uri[5:].split(',', 1) + uri = uri[5:] + properties, _, data = uri.partition(',') for prop in properties.split(';'): if prop == 'base64': pass # skip - elif prop.startswith('charset='): + elif prop.lower().startswith('charset='): charset = prop[8:] elif prop: - mimetype = prop + mimetype = prop.lower() - image_data = base64.b64decode(data) + image_data = unquote_to_bytes(data) # data might be percent-encoded + if properties.endswith(';base64'): + image_data = base64.decodebytes(image_data) return DataURI(mimetype, charset, image_data) diff --git a/sphinx/util/index_entries.py b/sphinx/util/index_entries.py index 10046842976..36dba388146 100644 --- a/sphinx/util/index_entries.py +++ b/sphinx/util/index_entries.py @@ -20,7 +20,7 @@ def split_index_msg(entry_type: str, value: str) -> list[str]: def _split_into(n: int, type: str, value: str) -> list[str]: """Split an index entry into a given number of parts at semicolons.""" - parts = [x.strip() for x in value.split(';', n - 1)] + parts = [x.strip() for x in value.split(';', maxsplit=n - 1)] if len(list(filter(None, parts))) < n: msg = f'invalid {type} index entry {value!r}' raise ValueError(msg) diff --git a/sphinx/util/inspect.py b/sphinx/util/inspect.py index d2cba2b8ddc..7e750c876cf 100644 --- a/sphinx/util/inspect.py +++ b/sphinx/util/inspect.py @@ -27,7 +27,7 @@ from collections.abc import Callable, Iterator, Sequence from inspect import _ParameterKind from types import MethodType, ModuleType - from typing import Final, Protocol, TypeAlias + from typing import Final, Protocol from typing_extensions import TypeIs @@ -47,7 +47,7 @@ def __delete__(self, instance: Any, /) -> None: ... class _AttrGetter(Protocol): def __call__(self, obj: Any, name: str, default: Any = ..., /) -> Any: ... - _RoutineType: TypeAlias = ( + type _RoutineType = ( types.FunctionType | types.LambdaType | types.MethodType @@ -57,7 +57,7 @@ def __call__(self, obj: Any, name: str, default: Any = ..., /) -> Any: ... | types.MethodDescriptorType | types.ClassMethodDescriptorType ) - _SignatureType: TypeAlias = ( + type _SignatureType = ( Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any] ) @@ -103,7 +103,7 @@ class methods and static methods. if ispartial(obj): obj = obj.func elif inspect.isroutine(obj) and hasattr(obj, '__wrapped__'): - obj = obj.__wrapped__ + obj = obj.__wrapped__ # pyright: ignore[reportFunctionMemberAccess] elif isclassmethod(obj) or isstaticmethod(obj): obj = obj.__func__ else: @@ -114,7 +114,7 @@ class methods and static methods. if ispartial(obj): obj = obj.func elif inspect.isroutine(obj) and hasattr(obj, '__wrapped__'): - obj = obj.__wrapped__ + obj = obj.__wrapped__ # pyright: ignore[reportFunctionMemberAccess] elif isclassmethod(obj) or isstaticmethod(obj): obj = obj.__func__ else: @@ -131,7 +131,7 @@ def getall(obj: Any) -> Sequence[str] | None: __all__ = safe_getattr(obj, '__all__', None) if __all__ is None: return None - if isinstance(__all__, list | tuple) and all(isinstance(e, str) for e in __all__): + if isinstance(__all__, (list, tuple)) and all(isinstance(e, str) for e in __all__): return __all__ raise ValueError(__all__) @@ -160,7 +160,7 @@ def getmro(obj: Any) -> tuple[type, ...]: return () -def getorigbases(obj: Any) -> tuple[Any, ...] | None: +def getorigbases(obj: Any) -> tuple[type, ...] | None: """Safely get ``obj.__orig_bases__``. This returns ``None`` if the object is not a class or if ``__orig_bases__`` @@ -195,7 +195,7 @@ def getslots(obj: Any) -> dict[str, Any] | dict[str, None] | None: return __slots__ elif isinstance(__slots__, str): return {__slots__: None} - elif isinstance(__slots__, list | tuple): + elif isinstance(__slots__, (list, tuple)): return dict.fromkeys(__slots__) else: raise ValueError @@ -225,7 +225,7 @@ def unpartial(obj: Any) -> Any: def ispartial(obj: Any) -> TypeIs[partial[Any] | partialmethod[Any]]: """Check if the object is a partial function or method.""" - return isinstance(obj, partial | partialmethod) + return isinstance(obj, (partial, partialmethod)) def isclassmethod( @@ -374,8 +374,8 @@ def isattributedescriptor(obj: Any) -> bool: if isinstance(unwrapped, _DESCRIPTOR_LIKE): # attribute must not be a method descriptor return False - # attribute must not be an instancemethod (C-API) - return type(unwrapped).__name__ != 'instancemethod' + # attribute must not be an instancemethod (C-API) nor nb_method (specific for nanobind) + return type(unwrapped).__name__ not in {'instancemethod', 'nb_method'} return False @@ -385,7 +385,7 @@ def is_singledispatch_function(obj: Any) -> bool: inspect.isfunction(obj) and hasattr(obj, 'dispatch') and hasattr(obj, 'register') - and obj.dispatch.__module__ == 'functools' + and obj.dispatch.__module__ == 'functools' # pyright: ignore[reportFunctionMemberAccess] ) @@ -436,19 +436,19 @@ def _is_wrapped_coroutine(obj: Any) -> bool: """Check if the object is wrapped coroutine-function.""" if isstaticmethod(obj) or isclassmethod(obj) or ispartial(obj): # staticmethod, classmethod and partial method are not a wrapped coroutine-function - # Note: Since 3.10, staticmethod and classmethod becomes a kind of wrappers + # Note: staticmethod and classmethod are a kind of wrapper return False return hasattr(obj, '__wrapped__') def isproperty(obj: Any) -> TypeIs[property | cached_property[Any]]: """Check if the object is property (possibly cached).""" - return isinstance(obj, property | cached_property) + return isinstance(obj, (property, cached_property)) def isgenericalias(obj: Any) -> TypeIs[types.GenericAlias]: """Check if the object is a generic alias.""" - return isinstance(obj, types.GenericAlias | typing._BaseGenericAlias) # type: ignore[attr-defined] + return isinstance(obj, (types.GenericAlias, typing._BaseGenericAlias)) # type: ignore[attr-defined] def safe_getattr(obj: Any, name: str, *defargs: Any) -> Any: @@ -616,6 +616,14 @@ def __hash__(self) -> int: def __repr__(self) -> str: return f'{self.__class__.__name__}({self.name!r})' + def __or__(self, other: Any) -> Any: + # When evaluating type hints, our forward ref can appear in type expressions, + # i.e. `Alias | None`. This means it needs to support ``__or__`` and ``__ror__``. + return typing.Union[self, other] # NoQA: UP007 + + def __ror__(self, other: Any) -> Any: + return typing.Union[other, self] # NoQA: UP007 + class TypeAliasModule: """Pseudo module class for :confval:`autodoc_type_aliases`.""" @@ -702,6 +710,16 @@ def _should_unwrap(subject: _SignatureType) -> bool: ) +# Python 3.14 uses deferred evaluation of annotations by default. +# Using annotationlib's FORWARDREF format gives us more robust handling +# of forward references in type annotations. +signature_kwds: dict[str, Any] = {} +if sys.version_info[:2] >= (3, 14): + import annotationlib # type: ignore[import-not-found] + + signature_kwds['annotation_format'] = annotationlib.Format.FORWARDREF + + def signature( subject: _SignatureType, bound_method: bool = False, @@ -718,12 +736,16 @@ def signature( try: if _should_unwrap(subject): - signature = inspect.signature(subject) # type: ignore[arg-type] + signature = inspect.signature(subject, **signature_kwds) # type: ignore[arg-type] else: - signature = inspect.signature(subject, follow_wrapped=True) # type: ignore[arg-type] + signature = inspect.signature( + subject, # type: ignore[arg-type] + follow_wrapped=True, + **signature_kwds, + ) except ValueError: # follow built-in wrappers up (ex. functools.lru_cache) - signature = inspect.signature(subject) # type: ignore[arg-type] + signature = inspect.signature(subject, **signature_kwds) # type: ignore[arg-type] parameters = list(signature.parameters.values()) return_annotation = signature.return_annotation @@ -772,7 +794,7 @@ def signature( def evaluate_signature( sig: Signature, globalns: dict[str, Any] | None = None, - localns: dict[str, Any] | None = None, + localns: Mapping[str, Any] | None = None, ) -> Signature: """Evaluate unresolved type annotations in a signature object.""" if globalns is None: @@ -796,7 +818,7 @@ def evaluate_signature( def _evaluate_forwardref( ref: ForwardRef, globalns: dict[str, Any] | None, - localns: dict[str, Any] | None, + localns: Mapping[str, Any] | None, ) -> Any: """Evaluate a forward reference.""" if sys.version_info[:2] >= (3, 14): @@ -809,16 +831,16 @@ def _evaluate_forwardref( # before 3.12.4 still has the old signature). # # See: https://github.com/python/cpython/pull/118104. - return ref._evaluate( + return ref._evaluate( # pyright: ignore[reportDeprecated] globalns, localns, type_params=(), recursive_guard=frozenset() - ) # type: ignore[call-arg] + ) return ref._evaluate(globalns, localns, recursive_guard=frozenset()) def _evaluate( annotation: Any, globalns: dict[str, Any], - localns: dict[str, Any], + localns: Mapping[str, Any], ) -> Any: """Evaluate unresolved type annotation.""" try: @@ -854,6 +876,25 @@ def stringify_signature( (ex. io.StringIO -> StringIO) :param short_literals: If enabled, use short literal types. """ + args, retann = _stringify_signature_to_parts( + sig=sig, + show_annotation=show_annotation, + show_return_annotation=show_return_annotation, + unqualified_typehints=unqualified_typehints, + short_literals=short_literals, + ) + if retann: + return f'{args} -> {retann}' + return str(args) + + +def _stringify_signature_to_parts( + sig: Signature, + show_annotation: bool = True, + show_return_annotation: bool = True, + unqualified_typehints: bool = False, + short_literals: bool = False, +) -> tuple[str, str]: mode: _StringifyMode if unqualified_typehints: mode = 'smart' @@ -909,17 +950,18 @@ def stringify_signature( args.append('/') concatenated_args = ', '.join(args) + concatenated_args = f'({concatenated_args})' if ( sig.return_annotation is EMPTY or not show_annotation or not show_return_annotation ): - return f'({concatenated_args})' + retann = '' else: retann = stringify_annotation( sig.return_annotation, mode, short_literals=short_literals ) - return f'({concatenated_args}) -> {retann}' + return concatenated_args, retann def signature_from_str(signature: str) -> Signature: @@ -1051,10 +1093,8 @@ def getdoc( return doc -def _getdoc_internal( - obj: Any, attrgetter: Callable[[Any, str, Any], Any] = safe_getattr -) -> str | None: - doc = attrgetter(obj, '__doc__', None) +def _getdoc_internal(obj: Any, /) -> str | None: + doc = safe_getattr(obj, '__doc__', None) if isinstance(doc, str): return doc return None diff --git a/sphinx/util/inventory.py b/sphinx/util/inventory.py index d37398a5562..467d72e0db8 100644 --- a/sphinx/util/inventory.py +++ b/sphinx/util/inventory.py @@ -75,7 +75,7 @@ def _loads_v1(cls, lines: Sequence[str], *, uri: str) -> _Inventory: projname = lines[0].rstrip()[11:] # Project name version = lines[1].rstrip()[11:] # Project version for line in lines[2:]: - name, item_type, location = line.rstrip().split(None, 2) + name, item_type, location = line.rstrip().split(None, maxsplit=2) location = posixpath.join(uri, location) # version 1 did not add anchors to the location if item_type == 'mod': @@ -311,7 +311,9 @@ def __setstate__(self, state: tuple[str, str, str, str]) -> None: def __getitem__(self, key: int | slice) -> str | tuple[str, ...]: warnings.warn( - 'The tuple interface for _InventoryItem objects is deprecated.', + 'The tuple interface for _InventoryItem objects is deprecated.' + ' Please access the `project_name`, `project_version`, ' + '`uri`, and `displayname` attributes directly.', RemovedInSphinx10Warning, stacklevel=2, ) @@ -320,7 +322,9 @@ def __getitem__(self, key: int | slice) -> str | tuple[str, ...]: def __iter__(self) -> Iterator[str]: warnings.warn( - 'The iter() interface for _InventoryItem objects is deprecated.', + 'The iter() interface for _InventoryItem objects is deprecated.' + ' Please access the `project_name`, `project_version`, ' + '`uri`, and `displayname` attributes directly.', RemovedInSphinx10Warning, stacklevel=2, ) diff --git a/sphinx/util/logging.py b/sphinx/util/logging.py index fab8acc3b90..9ad035c49af 100644 --- a/sphinx/util/logging.py +++ b/sphinx/util/logging.py @@ -430,7 +430,7 @@ class WarningSuppressor(logging.Filter): """Filter logs by `suppress_warnings`.""" def __init__(self, app: Sphinx) -> None: - self.app = app + self._app = app super().__init__() def filter(self, record: logging.LogRecord) -> bool: @@ -438,7 +438,7 @@ def filter(self, record: logging.LogRecord) -> bool: subtype = getattr(record, 'subtype', '') try: - suppress_warnings = self.app.config.suppress_warnings + suppress_warnings = self._app.config.suppress_warnings except AttributeError: # config is not initialized yet (ex. in conf.py) suppress_warnings = () @@ -446,7 +446,7 @@ def filter(self, record: logging.LogRecord) -> bool: if is_suppressed_warning(type, subtype, suppress_warnings): return False else: - self.app._warncount += 1 + self._app._warncount += 1 return True @@ -496,7 +496,7 @@ class SphinxLogRecordTranslator(logging.Filter): LogRecordClass: type[logging.LogRecord] def __init__(self, app: Sphinx) -> None: - self.app = app + self._app = app super().__init__() def filter(self, record: SphinxWarningLogRecord) -> bool: # type: ignore[override] @@ -509,15 +509,15 @@ def filter(self, record: SphinxWarningLogRecord) -> bool: # type: ignore[overri docname, lineno = location if docname: if lineno: - record.location = f'{self.app.env.doc2path(docname)}:{lineno}' + record.location = f'{self._app.env.doc2path(docname)}:{lineno}' else: - record.location = f'{self.app.env.doc2path(docname)}' + record.location = f'{self._app.env.doc2path(docname)}' else: record.location = None elif isinstance(location, nodes.Node): record.location = get_node_location(location) elif location and ':' not in location: - record.location = f'{self.app.env.doc2path(location)}' + record.location = f'{self._app.env.doc2path(location)}' return True @@ -537,7 +537,7 @@ def filter(self, record: SphinxWarningLogRecord) -> bool: # type: ignore[overri ret = super().filter(record) try: - show_warning_types = self.app.config.show_warning_types + show_warning_types = self._app.config.show_warning_types except AttributeError: # config is not initialized yet (ex. in conf.py) show_warning_types = False @@ -602,14 +602,18 @@ class LastMessagesWriter: """Stream writer storing last 10 messages in memory to save trackback""" def __init__(self, app: Sphinx, stream: IO[str]) -> None: - self.app = app + self._app = app def write(self, data: str) -> None: - self.app.messagelog.append(data) + self._app.messagelog.append(data) -def setup(app: Sphinx, status: IO[str], warning: IO[str]) -> None: +def setup( + app: Sphinx, status: IO[str], warning: IO[str], *, verbosity: int = 0 +) -> None: """Setup root logger for Sphinx""" + log_level = VERBOSITY_MAP[max(verbosity, 0)] + logger = logging.getLogger(NAMESPACE) logger.setLevel(logging.DEBUG) logger.propagate = False @@ -621,7 +625,7 @@ def setup(app: Sphinx, status: IO[str], warning: IO[str]) -> None: info_handler = NewLineStreamHandler(SafeEncodingWriter(status)) info_handler.addFilter(InfoFilter()) info_handler.addFilter(InfoLogRecordTranslator(app)) - info_handler.setLevel(VERBOSITY_MAP[app.verbosity]) + info_handler.setLevel(log_level) info_handler.setFormatter(ColorizeFormatter()) warning_handler = WarningStreamHandler(SafeEncodingWriter(warning)) @@ -635,7 +639,7 @@ def setup(app: Sphinx, status: IO[str], warning: IO[str]) -> None: messagelog_handler = logging.StreamHandler(LastMessagesWriter(app, status)) messagelog_handler.addFilter(InfoFilter()) - messagelog_handler.setLevel(VERBOSITY_MAP[app.verbosity]) + messagelog_handler.setLevel(log_level) logger.addHandler(info_handler) logger.addHandler(warning_handler) diff --git a/sphinx/util/math.py b/sphinx/util/math.py index f482e0c4dac..898aab2d617 100644 --- a/sphinx/util/math.py +++ b/sphinx/util/math.py @@ -14,7 +14,7 @@ def get_node_equation_number(writer: HTML5Translator, node: nodes.math_block) -> if writer.builder.config.math_numfig and writer.builder.config.numfig: figtype = 'displaymath' if writer.builder.name == 'singlehtml': - key = f'{writer.docnames[-1]}/{figtype}' # type: ignore[has-type] + key = f'{writer.docnames[-1]}/{figtype}' else: key = figtype diff --git a/sphinx/util/nodes.py b/sphinx/util/nodes.py index e29dc376884..90c44c6a9c1 100644 --- a/sphinx/util/nodes.py +++ b/sphinx/util/nodes.py @@ -5,7 +5,8 @@ import contextlib import re import unicodedata -from typing import TYPE_CHECKING, Any, Generic, TypeVar, cast +from io import StringIO +from typing import TYPE_CHECKING, Any, cast from docutils import nodes from docutils.nodes import Node @@ -35,10 +36,7 @@ caption_ref_re = explicit_title_re # b/w compat alias -N = TypeVar('N', bound=Node) - - -class NodeMatcher(Generic[N]): +class NodeMatcher[N: Node]: """A helper class for Node.findall(). It checks that the given node is an instance of the specified node-classes and @@ -197,13 +195,13 @@ def apply_source_workaround(node: Element) -> None: node, ( # https://github.com/sphinx-doc/sphinx/issues/1305 rubric directive - nodes.rubric + nodes.rubric, # https://github.com/sphinx-doc/sphinx/issues/1477 line node - | nodes.line + nodes.line, # https://github.com/sphinx-doc/sphinx/issues/3093 image directive in substitution - | nodes.image + nodes.image, # https://github.com/sphinx-doc/sphinx/issues/3335 field list syntax - | nodes.field_name + nodes.field_name, ), ): logger.debug( @@ -289,6 +287,35 @@ def is_translatable(node: Node) -> bool: ) # fmt: skip +def _clean_extracted_message(text: str) -> str: + """Remove trailing backslashes from each line of *text*.""" + if '\\' in text: + # TODO(picnixz): if possible, find a regex alternative + # that is not vulnerable to a ReDOS (the code below is + # equivalent to re.sub(r'[ \t]*\\[ \t]*$', text, re.MULTILINE)). + buffer = StringIO() + for line in text.splitlines(keepends=True): + split = line.rsplit('\\', maxsplit=1) + if len(split) == 2: + prefix, suffix = split + if re.match(r'^[ \t]*\s$', suffix): + # The line ends with some NL character, preceded by + # one or more whitespaces (to be dropped), the backslash, + # and possibly other whitespaces on its left. + buffer.write(prefix.rstrip(' \t')) + buffer.write(suffix.lstrip(' \t')) + elif not suffix: + # backslash is at the end of the LAST line + buffer.write(prefix.rstrip(' \t')) + else: + # backslash is is in the middle of the line + buffer.write(line) + else: + buffer.write(line) + text = buffer.getvalue() + return text.replace('\n', ' ').strip() + + def extract_messages(doctree: Element) -> Iterable[tuple[Element, str]]: """Extract translatable messages from a document tree.""" for node in doctree.findall(is_translatable): @@ -311,7 +338,8 @@ def extract_messages(doctree: Element) -> Iterable[tuple[Element, str]]: elif isinstance(node, nodes.meta): msg = node['content'] else: - msg = node.rawsource.replace('\n', ' ').strip() # type: ignore[attr-defined] + text = node.rawsource # type: ignore[attr-defined] + msg = _clean_extracted_message(text) # XXX nodes rendering empty are likely a bug in sphinx.addnodes if msg: @@ -363,8 +391,8 @@ def traverse_translatable_index( def nested_parse_with_titles( - state: RSTState, content: StringList, node: Node, content_offset: int = 0 -) -> str: + state: RSTState, content: StringList, node: Element, content_offset: int = 0 +) -> int: """Version of state.nested_parse() that allows titles and does not require titles to have the same decoration as the calling document. @@ -404,8 +432,6 @@ def process_index_entry( entry: str, targetid: str, ) -> list[tuple[str, str, str, str, str | None]]: - from sphinx.domains.python import pairindextypes - indexentries: list[tuple[str, str, str, str, str | None]] = [] entry = entry.strip() oentry = entry @@ -413,42 +439,46 @@ def process_index_entry( if entry.startswith('!'): main = 'main' entry = entry[1:].lstrip() - for index_type in pairindextypes: + + for index_type in ( + 'module', + 'keyword', + 'operator', + 'object', + 'exception', + 'statement', + 'builtin', + ): if entry.startswith(f'{index_type}:'): value = entry[len(index_type) + 1 :].strip() - value = f'{pairindextypes[index_type]}; {value}' - # xref RemovedInSphinx90Warning - logger.warning( - __( - '%r is deprecated for index entries (from entry %r). ' - "Use 'pair: %s' instead." - ), - index_type, - entry, - value, - type='index', - ) - indexentries.append(('pair', value, targetid, main, None)) + if index_type == 'builtin': + value = f'built-in function; {value}' + else: + value = f'{index_type}; {value}' + msg = __( + '%r is no longer supported for index entries (from entry %r). ' + "Use 'pair: %s' instead." + ) % (index_type, entry, value) + raise ValueError(msg) + + for index_type in indextypes: + if entry.startswith(f'{index_type}:'): + value = entry[len(index_type) + 1 :].strip() + if index_type == 'double': + index_type = 'pair' + indexentries.append((index_type, value, targetid, main, None)) break + # shorthand notation for single entries else: - for index_type in indextypes: - if entry.startswith(f'{index_type}:'): - value = entry[len(index_type) + 1 :].strip() - if index_type == 'double': - index_type = 'pair' - indexentries.append((index_type, value, targetid, main, None)) - break - # shorthand notation for single entries - else: - for value in oentry.split(','): - value = value.strip() - main = '' - if value.startswith('!'): - main = 'main' - value = value[1:].lstrip() - if not value: - continue - indexentries.append(('single', value, targetid, main, None)) + for value in oentry.split(','): + value = value.strip() + main = '' + if value.startswith('!'): + main = 'main' + value = value[1:].lstrip() + if not value: + continue + indexentries.append(('single', value, targetid, main, None)) return indexentries @@ -652,8 +682,10 @@ def set_source_info(directive: Directive, node: Node) -> None: def set_role_source_info(inliner: Inliner, lineno: int, node: Node) -> None: - gsal = inliner.reporter.get_source_and_line # type: ignore[attr-defined] - node.source, node.line = gsal(lineno) + gsal = inliner.reporter.get_source_and_line + source, line = gsal(lineno) + node.source = source # type: ignore[assignment] + node.line = line def copy_source_info(src: Element, dst: Element) -> None: diff --git a/sphinx/util/osutil.py b/sphinx/util/osutil.py index 807db899af9..9a3c5f4948c 100644 --- a/sphinx/util/osutil.py +++ b/sphinx/util/osutil.py @@ -47,8 +47,8 @@ def relative_uri(base: str, to: str) -> str: """Return a relative URL from ``base`` to ``to``.""" if to.startswith(SEP): return to - b2 = base.split('#')[0].split(SEP) - t2 = to.split('#')[0].split(SEP) + b2 = base.partition('#')[0].split(SEP) + t2 = to.partition('#')[0].split(SEP) # remove common segments (except the last segment) for x, y in zip(b2[:-1], t2[:-1], strict=False): if x != y: @@ -186,8 +186,6 @@ def _relative_path(path: Path, root: Path, /) -> Path: if path.anchor != root.anchor or '..' in root.parts: # If the drives are different, no relative path exists. return path - if sys.version_info[:2] < (3, 12): - return Path(os.path.relpath(path, root)) return path.relative_to(root, walk_up=True) diff --git a/sphinx/util/parallel.py b/sphinx/util/parallel.py index 3dd5e574c58..af50907ef1b 100644 --- a/sphinx/util/parallel.py +++ b/sphinx/util/parallel.py @@ -101,7 +101,7 @@ def add_task( self._args[tid] = arg precv, psend = multiprocessing.Pipe(False) context: Any = multiprocessing.get_context('fork') - proc = context.Process(target=self._process, args=(psend, task_func, arg)) + proc = context.Process(target=self._process, args=(psend, task_func, arg)) # ty: ignore[unresolved-attribute] self._procs[tid] = proc self._precvs_waiting[tid] = precv try: diff --git a/sphinx/util/parsing.py b/sphinx/util/parsing.py index 4c4a6477683..aa6c34251c2 100644 --- a/sphinx/util/parsing.py +++ b/sphinx/util/parsing.py @@ -39,8 +39,7 @@ def nested_parse_to_nodes( Note that this option bypasses Docutils' usual checks on doctree structure, and misuse of this option can lead to an incoherent doctree. In Docutils, section nodes should - only be children of ``Structural`` nodes, which includes - ``document``, ``section``, and ``sidebar`` nodes. + only be children of ``document`` or ``section`` nodes. :param keep_title_context: If this is False (the default), then *content* is parsed as if it were an independent document, meaning that title decorations (e.g. underlines) @@ -50,6 +49,10 @@ def nested_parse_to_nodes( If this is True, then title underlines must match those in the surrounding document, otherwise the behaviour is undefined. + Warning: Up to Docutils 0.21, sections with a decoration style + matching a level that is higher than the current section level are + silently discarded! Since Docutils 0.22.1, an error is reported. + .. versionadded:: 7.4 """ document = state.document diff --git a/sphinx/util/requests.py b/sphinx/util/requests.py index b439ce437e8..dd39ca83fff 100644 --- a/sphinx/util/requests.py +++ b/sphinx/util/requests.py @@ -35,12 +35,12 @@ def _get_tls_cacert(url: str, certs: str | dict[str, str] | None) -> str | bool: """Get additional CA cert for a specific URL.""" if not certs: return True - elif isinstance(certs, str | tuple): + elif isinstance(certs, (str, tuple)): return certs else: hostname = urlsplit(url).netloc if '@' in hostname: - _, hostname = hostname.split('@', 1) + hostname = hostname.partition('@')[-1] return certs.get(hostname, True) diff --git a/sphinx/util/rst.py b/sphinx/util/rst.py index c848a9b3657..485f369766e 100644 --- a/sphinx/util/rst.py +++ b/sphinx/util/rst.py @@ -1,15 +1,15 @@ -"""reST helper functions.""" +"""reStructuredText helper functions.""" from __future__ import annotations import re from collections import defaultdict from contextlib import contextmanager -from typing import TYPE_CHECKING, cast +from typing import TYPE_CHECKING from unicodedata import east_asian_width from docutils.parsers.rst import roles -from docutils.parsers.rst.languages import en as english # type: ignore[attr-defined] +from docutils.parsers.rst.languages import en as english from docutils.parsers.rst.states import Body from docutils.utils import Reporter from jinja2 import pass_environment @@ -25,7 +25,7 @@ logger = logging.getLogger(__name__) -FIELD_NAME_RE = re.compile(Body.patterns['field_marker']) +_FIELD_NAME_RE = re.compile(Body.patterns['field_marker']) symbols_re = re.compile(r'([!-\-/:-@\[-`{-~])') # symbols without dot(0x2e) SECTIONING_CHARS = ['=', '-', '~'] @@ -66,7 +66,7 @@ def heading(env: Environment, text: str, level: int = 1) -> str: def default_role(docname: str, name: str) -> Iterator[None]: if name: dummy_reporter = Reporter('', 4, 4) - role_fn, _ = roles.role(name, english, 0, dummy_reporter) + role_fn, _ = roles.role(name, english, 0, dummy_reporter) # type: ignore[arg-type] if role_fn: docutils.register_role('', role_fn) # type: ignore[arg-type] else: @@ -77,39 +77,39 @@ def default_role(docname: str, name: str) -> Iterator[None]: docutils.unregister_role('') -def prepend_prolog(content: StringList, prolog: str) -> None: - """Prepend a string to content body as prolog.""" - if prolog: - pos = 0 - for line in content: - if FIELD_NAME_RE.match(line): - pos += 1 - else: - break - - if pos > 0: - # insert a blank line after docinfo - content.insert(pos, '', '', 0) +def _prepend_prologue(content: StringList, prologue: str) -> None: + """Prepend a string to content body as a prologue.""" + if not prologue: + return + pos = 0 + for line in content: + if _FIELD_NAME_RE.match(line): pos += 1 + else: + break - # insert prolog (after docinfo if exists) - lineno = 0 - for lineno, line in enumerate(prolog.splitlines()): - content.insert(pos + lineno, line, '', lineno) + if pos > 0: + # insert a blank line after docinfo + content.insert(pos, '', '', 0) + pos += 1 - content.insert(pos + lineno + 1, '', '', 0) + # insert prologue (after docinfo if exists) + lineno = 0 + for lineno, line in enumerate(prologue.splitlines()): + content.insert(pos + lineno, line, '', lineno) + content.insert(pos + lineno + 1, '', '', 0) -def append_epilog(content: StringList, epilog: str) -> None: - """Append a string to content body as epilog.""" - if epilog: - if len(content) > 0: - source, lineno = content.info(-1) - # lineno will never be None, since len(content) > 0 - lineno = cast('int', lineno) - else: - source = '' - lineno = 0 - content.append('', source, lineno + 1) - for lineno, line in enumerate(epilog.splitlines()): - content.append(line, '', lineno) + +def _append_epilogue(content: StringList, epilogue: str) -> None: + """Append a string to content body as an epilogue.""" + if not epilogue: + return + if len(content) > 0: + source, lineno = content.items[-1] + else: + source = '' + lineno = 0 + content.append('', source, lineno + 1) + for lineno, line in enumerate(epilogue.splitlines()): + content.append(line, '', lineno) diff --git a/sphinx/util/tags.py b/sphinx/util/tags.py index 4467534a945..228f1dbffc5 100644 --- a/sphinx/util/tags.py +++ b/sphinx/util/tags.py @@ -1,17 +1,13 @@ from __future__ import annotations -import warnings from typing import TYPE_CHECKING import jinja2.environment import jinja2.nodes import jinja2.parser -from sphinx.deprecation import RemovedInSphinx90Warning - if TYPE_CHECKING: - from collections.abc import Iterator, Sequence - from typing import Literal + from collections.abc import Collection, Iterator _ENV = jinja2.environment.Environment() @@ -42,7 +38,7 @@ def parse_compare(self) -> jinja2.nodes.Expr: class Tags: - def __init__(self, tags: Sequence[str] = ()) -> None: + def __init__(self, tags: Collection[str] = ()) -> None: self._tags = set(tags or ()) self._condition_cache: dict[str, bool] = {} @@ -67,15 +63,6 @@ def add(self, tag: str) -> None: def remove(self, tag: str) -> None: self._tags.discard(tag) - @property - def tags(self) -> dict[str, Literal[True]]: - warnings.warn( - 'Tags.tags is deprecated, use methods on Tags.', - RemovedInSphinx90Warning, - stacklevel=2, - ) - return dict.fromkeys(self._tags, True) - def eval_condition(self, condition: str) -> bool: """Evaluate a boolean condition. diff --git a/sphinx/util/template.py b/sphinx/util/template.py index 03a9649345a..c7bb3993302 100644 --- a/sphinx/util/template.py +++ b/sphinx/util/template.py @@ -42,7 +42,7 @@ def render_string(self, source: str, context: dict[str, Any]) -> str: class FileRenderer(BaseRenderer): def __init__(self, search_path: Sequence[str | os.PathLike[str]]) -> None: - if isinstance(search_path, str | os.PathLike): + if isinstance(search_path, (str, os.PathLike)): search_path = [search_path] else: # filter "None" paths diff --git a/sphinx/util/typing.py b/sphinx/util/typing.py index 1a68a18e29a..dc19754cbf2 100644 --- a/sphinx/util/typing.py +++ b/sphinx/util/typing.py @@ -7,7 +7,7 @@ import types import typing from collections.abc import Callable, Sequence -from typing import TYPE_CHECKING +from typing import TYPE_CHECKING, TypeAliasType from docutils import nodes from docutils.parsers.rst.states import Inliner @@ -16,23 +16,32 @@ if TYPE_CHECKING: from collections.abc import Mapping - from typing import Annotated, Any, Final, Literal, Protocol, TypeAlias + from typing import Annotated, Any, Final, Literal, Protocol from typing_extensions import TypeIs from sphinx.application import Sphinx from sphinx.util.inventory import _InventoryItem - _RestifyMode: TypeAlias = Literal[ + type _RestifyMode = Literal[ 'fully-qualified-except-typing', 'smart', ] - _StringifyMode: TypeAlias = Literal[ + type _StringifyMode = Literal[ 'fully-qualified-except-typing', 'fully-qualified', 'smart', ] +AnyTypeAliasType: tuple[type, ...] = (TypeAliasType,) + +try: + import typing_extensions +except ImportError: + pass +else: + AnyTypeAliasType += (typing_extensions.TypeAliasType,) + logger = logging.getLogger(__name__) @@ -116,10 +125,10 @@ def is_invalid_builtin_class(obj: Any) -> str: # Text like nodes which are initialized with text and rawsource -TextlikeNode: TypeAlias = nodes.Text | nodes.TextElement +type TextlikeNode = nodes.Text | nodes.TextElement # path matcher -PathMatcher: TypeAlias = Callable[[str], bool] +type PathMatcher = Callable[[str], bool] # common role functions if TYPE_CHECKING: @@ -138,19 +147,19 @@ def __call__( ) -> tuple[list[nodes.Node], list[nodes.system_message]]: ... else: - RoleFunction: TypeAlias = Callable[ + type RoleFunction = Callable[ [str, str, str, int, Inliner, dict[str, typing.Any], Sequence[str]], tuple[list[nodes.Node], list[nodes.system_message]], ] # A option spec for directive -OptionSpec: TypeAlias = dict[str, Callable[[str], typing.Any]] +type OptionSpec = dict[str, Callable[[str], typing.Any]] # title getter functions for enumerable nodes (see sphinx.domains.std) -TitleGetter: TypeAlias = Callable[[nodes.Node], str] +type TitleGetter = Callable[[nodes.Node], str] # inventory data on memory -Inventory: TypeAlias = dict[str, dict[str, '_InventoryItem']] +type Inventory = dict[str, dict[str, _InventoryItem]] class ExtensionMetadata(typing.TypedDict, total=False): @@ -174,13 +183,13 @@ class ExtensionMetadata(typing.TypedDict, total=False): if TYPE_CHECKING: - _ExtensionSetupFunc: TypeAlias = Callable[[Sphinx], ExtensionMetadata] # NoQA: PYI047 (false positive) + type _ExtensionSetupFunc = Callable[[Sphinx], ExtensionMetadata] # NoQA: PYI047 (false positive) def get_type_hints( obj: Any, globalns: dict[str, Any] | None = None, - localns: dict[str, Any] | None = None, + localns: Mapping[str, Any] | None = None, include_extras: bool = False, ) -> dict[str, Any]: """Return a dictionary containing type hints for a function, method, module or class @@ -240,7 +249,7 @@ def restify(cls: Any, mode: _RestifyMode = 'fully-qualified-except-typing') -> s 'smart' Show the name of the annotation. """ - from sphinx.ext.autodoc.mock import ismock, ismockmodule # lazy loading + from sphinx.ext.autodoc._dynamic._mock import ismock, ismockmodule # lazy loading from sphinx.util.inspect import isgenericalias, object_description # lazy loading valid_modes = {'fully-qualified-except-typing', 'smart'} @@ -291,9 +300,6 @@ def restify(cls: Any, mode: _RestifyMode = 'fully-qualified-except-typing') -> s else: meta_args.append(repr(m)) meta = ', '.join(meta_args) - if sys.version_info[:2] <= (3, 11): - # Hardcoded to fix errors on Python 3.11 and earlier. - return rf':py:class:`~typing.Annotated`\ [{args}, {meta}]' return ( f':py:class:`{module_prefix}{cls.__module__}.{cls.__name__}`' rf'\ [{args}, {meta}]' @@ -309,6 +315,11 @@ def restify(cls: Any, mode: _RestifyMode = 'fully-qualified-except-typing') -> s # are printed natively and ``None``-like types are kept as is. # *cls* is defined in ``typing``, and thus ``__args__`` must exist return ' | '.join(restify(a, mode) for a in cls.__args__) + elif isinstance(cls, AnyTypeAliasType): + # TODO: Use ``__qualname__`` here unconditionally (not yet supported) + if hasattr(cls, '__qualname__'): + return f':py:type:`{module_prefix}{cls.__module__}.{cls.__qualname__}`' + return f':py:type:`{module_prefix}{cls.__module__}.{cls.__name__}`' # type: ignore[attr-defined] elif cls.__module__ in {'__builtin__', 'builtins'}: if hasattr(cls, '__args__'): if not cls.__args__: # Empty tuple, list, ... @@ -407,7 +418,7 @@ def stringify_annotation( :param short_literals: Render :py:class:`Literals` in PEP 604 style (``|``). """ - from sphinx.ext.autodoc.mock import ismock, ismockmodule # lazy loading + from sphinx.ext.autodoc._dynamic._mock import ismock, ismockmodule # lazy loading valid_modes = {'fully-qualified-except-typing', 'fully-qualified', 'smart'} if mode not in valid_modes: @@ -440,7 +451,9 @@ def stringify_annotation( annotation_module_is_typing = True # Extract the annotation's base type by considering formattable cases - if isinstance(annotation, typing.TypeVar) and not _is_unpack_form(annotation): + if isinstance( + annotation, (typing.TypeVar, AnyTypeAliasType) + ) and not _is_unpack_form(annotation): # typing_extensions.Unpack is incorrectly determined as a TypeVar if annotation_module_is_typing and mode in { 'fully-qualified-except-typing', @@ -456,7 +469,7 @@ def stringify_annotation( return module_prefix + f'{annotation_module}.{annotation_name}' elif fixed_annotation := is_invalid_builtin_class(annotation): return module_prefix + fixed_annotation - elif _is_annotated_form(annotation): # for py310+ + elif _is_annotated_form(annotation): pass elif annotation_module == 'builtins' and annotation_qualname: args = getattr(annotation, '__args__', None) @@ -524,7 +537,7 @@ def stringify_annotation( # Process the generic arguments (if any). # They must be a list or a tuple, otherwise they are considered 'broken'. annotation_args = getattr(annotation, '__args__', ()) - if annotation_args and isinstance(annotation_args, list | tuple): + if annotation_args and isinstance(annotation_args, (list, tuple)): if ( qualname in {'Union', 'types.UnionType'} and all(getattr(a, '__origin__', ...) is typing.Literal for a in annotation_args) @@ -558,7 +571,7 @@ def stringify_annotation( _format_literal_arg_stringify(a, mode=mode) for a in annotation_args ) return f'{module_prefix}Literal[{args}]' - elif _is_annotated_form(annotation): # for py310+ + elif _is_annotated_form(annotation): args = stringify_annotation( annotation_args[0], mode=mode, short_literals=short_literals ) @@ -583,11 +596,6 @@ def stringify_annotation( else: meta_args.append(repr(m)) meta = ', '.join(meta_args) - if sys.version_info[:2] <= (3, 11): - if mode == 'fully-qualified-except-typing': - return f'Annotated[{args}, {meta}]' - module_prefix = module_prefix.replace('builtins', 'typing') - return f'{module_prefix}Annotated[{args}, {meta}]' return f'{module_prefix}Annotated[{args}, {meta}]' elif all(is_system_TypeVar(a) for a in annotation_args): # Suppress arguments if all system defined TypeVars (ex. Dict[KT, VT]) diff --git a/sphinx/versioning.py b/sphinx/versioning.py index 3de5a17ec9c..02bc6edd055 100644 --- a/sphinx/versioning.py +++ b/sphinx/versioning.py @@ -160,7 +160,7 @@ def apply(self, **kwargs: Any) -> None: if env.versioning_compare: # get old doctree - filename = env.doctreedir / f'{env.docname}.doctree' + filename = env.doctreedir / f'{env.current_document.docname}.doctree' try: with open(filename, 'rb') as f: old_doctree = pickle.load(f) diff --git a/sphinx/writers/html.py b/sphinx/writers/html.py index e2c04ca32db..cb273cbdbd3 100644 --- a/sphinx/writers/html.py +++ b/sphinx/writers/html.py @@ -4,7 +4,7 @@ from typing import TYPE_CHECKING, cast -from docutils.writers.html4css1 import Writer +from docutils.writers import html4css1 from sphinx.util import logging from sphinx.writers.html5 import HTML5Translator @@ -20,7 +20,7 @@ # https://www.arnebrodowski.de/blog/write-your-own-restructuredtext-writer.html -class HTMLWriter(Writer): # type: ignore[misc] +class HTMLWriter(html4css1.Writer): # override embed-stylesheet default value to False. settings_default_overrides = {'embed_stylesheet': False} @@ -33,6 +33,7 @@ def translate(self) -> None: # sadly, this is mostly copied from parent class visitor = self.builder.create_translator(self.document, self.builder) self.visitor = cast('HTML5Translator', visitor) + assert self.document is not None self.document.walkabout(visitor) self.output = self.visitor.astext() for attr in ( diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py index b39b463d6db..5ab57784c73 100644 --- a/sphinx/writers/html5.py +++ b/sphinx/writers/html5.py @@ -17,6 +17,8 @@ from sphinx.util.images import get_image_size if TYPE_CHECKING: + from collections.abc import Callable + from docutils.nodes import Element, Node, Text from sphinx.builders import Builder @@ -41,7 +43,7 @@ def multiply_length(length: str, scale: int) -> str: return f'{int(result)}{unit}' -class HTML5Translator(SphinxTranslator, BaseTranslator): # type: ignore[misc] +class HTML5Translator(SphinxTranslator, BaseTranslator): """Our custom HTML translator.""" builder: StandaloneHTMLBuilder @@ -305,10 +307,10 @@ def depart_desc_optional(self, node: Element) -> None: self.param_group_index += 1 def visit_desc_annotation(self, node: Element) -> None: - self.body.append(self.starttag(node, 'em', '', CLASS='property')) + self.body.append(self.starttag(node, 'span', '', CLASS='property')) def depart_desc_annotation(self, node: Element) -> None: - self.body.append('
        ') + self.body.append('') ############################################## @@ -347,7 +349,10 @@ def visit_reference(self, node: Element) -> None: atts['target'] = node['target'] if 'rel' in node: atts['rel'] = node['rel'] - self.body.append(self.starttag(node, 'a', '', **atts)) + # TODO: TYPING: Upstream docutils should type HTMLTranslator.starttag() + # to accept **attributes; current stub treats the 4th parameter + # as empty: bool. + self.body.append(self.starttag(node, 'a', '', **atts)) # type: ignore[arg-type] if node.get('secnumber'): self.body.append( @@ -357,11 +362,13 @@ def visit_reference(self, node: Element) -> None: def visit_number_reference(self, node: Element) -> None: self.visit_reference(node) - def depart_number_reference(self, node: Element) -> None: + def depart_number_reference(self, node: nodes.reference) -> None: self.depart_reference(node) # overwritten -- we don't want source comments to show up in the HTML - def visit_comment(self, node: Element) -> None: + def visit_comment( + self, node: nodes.comment, sub: Callable[[str, str], str] | None = None + ) -> None: raise nodes.SkipNode # overwritten @@ -372,8 +379,16 @@ def visit_admonition(self, node: Element, name: str = '') -> None: tag_name = 'details' if collapsible == 'open': attributes['open'] = 'open' + # TODO: TYPING: Upstream docutils should type HTMLTranslator.starttag() + # to accept **attributes; current stub treats the 4th parameter + # as empty: bool. self.body.append( - self.starttag(node, tag_name, CLASS=f'admonition {name}', **attributes) + self.starttag( + node, + tag_name, + CLASS=f'admonition {name}', + **attributes, # type: ignore[arg-type] + ) ) self.context.append(f'\n') if name: @@ -451,7 +466,7 @@ def add_permalink_ref(self, node: Element, title: str) -> None: ) # overwritten - def visit_bullet_list(self, node: Element) -> None: + def visit_bullet_list(self, node: nodes.bullet_list) -> None: if len(node) == 1 and isinstance(node[0], addnodes.toctree): # avoid emitting empty
          raise nodes.SkipNode @@ -474,7 +489,7 @@ def visit_classifier(self, node: Element) -> None: def depart_classifier(self, node: Element) -> None: self.body.append('') - next_node: Node = node.next_node(descend=False, siblings=True) + next_node: Node | None = node.next_node(descend=False, siblings=True) if not isinstance(next_node, nodes.classifier): # close `
          ` tag at the tail of classifiers self.body.append('
          ') @@ -485,7 +500,7 @@ def visit_term(self, node: Element) -> None: # overwritten def depart_term(self, node: Element) -> None: - next_node: Node = node.next_node(descend=False, siblings=True) + next_node: Node | None = node.next_node(descend=False, siblings=True) if isinstance(next_node, nodes.classifier): # Leave the end tag to `self.depart_classifier()`, in case # there's a classifier. @@ -498,7 +513,7 @@ def depart_term(self, node: Element) -> None: self.body.append('') # overwritten - def visit_title(self, node: Element) -> None: + def visit_title(self, node: nodes.title) -> None: if ( isinstance(node.parent, addnodes.compact_paragraph) and node.parent.get('toctree') @@ -535,7 +550,7 @@ def visit_title(self, node: Element) -> None: self.body.pop() self.context[-1] = '

          \n' - def depart_title(self, node: Element) -> None: + def depart_title(self, node: nodes.title) -> None: close_tag = self.context[-1] if ( self.config.html_permalinks @@ -586,7 +601,7 @@ def depart_rubric(self, node: nodes.rubric) -> None: super().depart_rubric(node) # overwritten - def visit_literal_block(self, node: Element) -> None: + def visit_literal_block(self, node: nodes.literal_block) -> None: if node.rawsource != node.astext(): # most probably a parsed-literal block -- don't highlight return super().visit_literal_block(node) @@ -614,7 +629,7 @@ def visit_literal_block(self, node: Element) -> None: self.body.append(starttag + highlighted + '
          \n') raise nodes.SkipNode - def visit_caption(self, node: Element) -> None: + def visit_caption(self, node: nodes.caption) -> None: if ( isinstance(node.parent, nodes.container) and node.parent.get('literal_block') @@ -625,7 +640,7 @@ def visit_caption(self, node: Element) -> None: self.add_fignumber(node.parent) self.body.append(self.starttag(node, 'span', '', CLASS='caption-text')) - def depart_caption(self, node: Element) -> None: + def depart_caption(self, node: nodes.caption) -> None: self.body.append('') # append permalink if available @@ -648,7 +663,7 @@ def depart_caption(self, node: Element) -> None: super().depart_caption(node) def visit_doctest_block(self, node: Element) -> None: - self.visit_literal_block(node) + self.visit_literal_block(node) # type: ignore[arg-type] # overwritten to add the
          (for XHTML compliance) def visit_block_quote(self, node: Element) -> None: @@ -724,14 +739,20 @@ def visit_download_reference(self, node: Element) -> None: elif 'refuri' in node: atts['class'] += ' external' atts['href'] = node['refuri'] - self.body.append(self.starttag(node, 'a', '', **atts)) + # TODO: TYPING: Upstream docutils should type HTMLTranslator.starttag() + # to accept **attributes; current stub treats the 4th parameter + # as empty: bool. + self.body.append(self.starttag(node, 'a', '', **atts)) # type: ignore[arg-type] self.context.append('') elif 'filename' in node: atts['class'] += ' internal' atts['href'] = posixpath.join( self.builder.dlpath, urllib.parse.quote(node['filename']) ) - self.body.append(self.starttag(node, 'a', '', **atts)) + # TODO: TYPING: Upstream docutils should type HTMLTranslator.starttag() + # to accept **attributes; current stub treats the 4th parameter + # as empty: bool. + self.body.append(self.starttag(node, 'a', '', **atts)) # type: ignore[arg-type] self.context.append('') else: self.context.append('') @@ -740,14 +761,14 @@ def depart_download_reference(self, node: Element) -> None: self.body.append(self.context.pop()) # overwritten - def visit_figure(self, node: Element) -> None: + def visit_figure(self, node: nodes.figure) -> None: # set align=default if align not specified to give a default style node.setdefault('align', 'default') return super().visit_figure(node) # overwritten - def visit_image(self, node: Element) -> None: + def visit_image(self, node: nodes.image) -> None: olduri = node['uri'] # rewrite the URI if the environment knows about it if olduri in self.builder.images: @@ -775,7 +796,7 @@ def visit_image(self, node: Element) -> None: super().visit_image(node) # overwritten - def depart_image(self, node: Element) -> None: + def depart_image(self, node: nodes.image) -> None: if node['uri'].lower().endswith(('svg', 'svgz')): pass else: @@ -892,36 +913,39 @@ def visit_tip(self, node: Element) -> None: def depart_tip(self, node: Element) -> None: self.depart_admonition(node) - def visit_literal_emphasis(self, node: Element) -> None: + def visit_literal_emphasis(self, node: nodes.emphasis) -> None: return self.visit_emphasis(node) - def depart_literal_emphasis(self, node: Element) -> None: + def depart_literal_emphasis(self, node: nodes.emphasis) -> None: return self.depart_emphasis(node) - def visit_literal_strong(self, node: Element) -> None: + def visit_literal_strong(self, node: nodes.strong) -> None: return self.visit_strong(node) - def depart_literal_strong(self, node: Element) -> None: + def depart_literal_strong(self, node: nodes.strong) -> None: return self.depart_strong(node) def visit_abbreviation(self, node: Element) -> None: attrs = {} if explanation := node.get('explanation', ''): attrs['title'] = explanation - self.body.append(self.starttag(node, 'abbr', '', **attrs)) + # TODO: TYPING: Upstream docutils should type HTMLTranslator.starttag() + # to accept **attributes; current stub treats the 4th parameter + # as empty: bool. + self.body.append(self.starttag(node, 'abbr', '', **attrs)) # type: ignore[arg-type] def depart_abbreviation(self, node: Element) -> None: self.body.append('') - def visit_manpage(self, node: Element) -> None: + def visit_manpage(self, node: nodes.emphasis) -> None: self.visit_literal_emphasis(node) - def depart_manpage(self, node: Element) -> None: + def depart_manpage(self, node: nodes.emphasis) -> None: self.depart_literal_emphasis(node) # overwritten to add even/odd classes - def visit_table(self, node: Element) -> None: + def visit_table(self, node: nodes.table) -> None: self._table_row_indices.append(0) atts = {} @@ -933,10 +957,13 @@ def visit_table(self, node: Element) -> None: if 'width' in node: atts['style'] = 'width: %s' % node['width'] - tag = self.starttag(node, 'table', CLASS=' '.join(classes), **atts) + # TODO: TYPING: Upstream docutils should type HTMLTranslator.starttag() + # to accept **attributes; current stub treats the 4th parameter + # as empty: bool. + tag = self.starttag(node, 'table', CLASS=' '.join(classes), **atts) # type: ignore[arg-type] self.body.append(tag) - def depart_table(self, node: Element) -> None: + def depart_table(self, node: nodes.table) -> None: self._table_row_indices.pop() super().depart_table(node) @@ -949,11 +976,11 @@ def visit_row(self, node: Element) -> None: self.body.append(self.starttag(node, 'tr', '')) node.column = 0 # type: ignore[attr-defined] - def visit_field_list(self, node: Element) -> None: + def visit_field_list(self, node: nodes.field_list) -> None: self._fieldlist_row_indices.append(0) return super().visit_field_list(node) - def depart_field_list(self, node: Element) -> None: + def depart_field_list(self, node: nodes.field_list) -> None: self._fieldlist_row_indices.pop() return super().depart_field_list(node) diff --git a/sphinx/writers/latex.py b/sphinx/writers/latex.py index a2a17855c18..c46c6909aed 100644 --- a/sphinx/writers/latex.py +++ b/sphinx/writers/latex.py @@ -132,8 +132,9 @@ def __init__(self, node: Element) -> None: self.colsep = None self.colwidths: list[int] = [] self.has_problematic = False - self.has_oldproblematic = False self.has_verbatim = False + # cf https://github.com/sphinx-doc/sphinx/issues/13646#issuecomment-2958309632 + self.is_nested = False self.caption: list[str] = [] self.stubs: list[int] = [] @@ -146,29 +147,49 @@ def __init__(self, node: Element) -> None: self.cell_id = 0 # last assigned cell_id def is_longtable(self) -> bool: - """True if and only if table uses longtable environment.""" + """True if and only if table uses longtable environment. + + In absence of longtable class can only be used trustfully on departing + the table, as the number of rows is not known until then. + """ return self.row > 30 or 'longtable' in self.classes def get_table_type(self) -> str: """Returns the LaTeX environment name for the table. + It is used at time of ``depart_table()`` and again via ``get_colspec()``. The class currently supports: * longtable * tabular * tabulary """ - if self.is_longtable(): + if self.is_longtable() and not self.is_nested: return 'longtable' elif self.has_verbatim: return 'tabular' elif self.colspec: - return 'tabulary' + # tabulary complains (only a LaTeX warning) if none of its column + # types is used. The next test will have false positive from + # syntax such as >{\RaggedRight} but it will catch *{3}{J} which + # does require tabulary and would crash tabular + # It is user responsibility not to use a tabulary column type for + # a column having a problematic cell. + if any(c in 'LRCJT' for c in self.colspec): + return 'tabulary' + else: + return 'tabular' elif self.has_problematic or ( self.colwidths and 'colwidths-given' in self.classes ): return 'tabular' else: + # A nested tabulary in a longtable can not use any \hline's, + # i.e. it can not use "booktabs" or "standard" styles (due to a + # LaTeX upstream bug we do not try to solve). But we can't know + # here if it ends up in a tabular or longtable. So it is via + # LaTeX macros inserted by the tabulary template that the problem + # will be solved. return 'tabulary' def get_colspec(self) -> str: @@ -178,6 +199,7 @@ def get_colspec(self) -> str: .. note:: + This is used by the template renderer at time of depart_table(). The ``\\X`` and ``T`` column type specifiers are defined in ``sphinxlatextables.sty``. """ @@ -199,12 +221,6 @@ def get_colspec(self) -> str: elif self.get_table_type() == 'tabulary': # sphinx.sty sets T to be J by default. return '{' + _colsep + (('T' + _colsep) * self.colcount) + '}' + CR - elif self.has_oldproblematic: - return ( - r'{%s*{%d}{\X{1}{%d}%s}}' - % (_colsep, self.colcount, self.colcount, _colsep) - + CR - ) else: return '{' + _colsep + (('l' + _colsep) * self.colcount) + '}' + CR @@ -281,6 +297,9 @@ def escape_abbr(text: str) -> str: def rstdim_to_latexdim(width_str: str, scale: int = 100) -> str: """Convert `width_str` with rst length to LaTeX length.""" + # MEMO: the percent unit is interpreted here as a percentage + # of \linewidth. Let's keep in mind though that \linewidth + # is dynamic in LaTeX, e.g. it is smaller in lists. match = re.match(r'^(\d*\.?\d*)\s*(\S*)$', width_str) if not match: raise ValueError @@ -294,6 +313,8 @@ def rstdim_to_latexdim(width_str: str, scale: int = 100) -> str: res = '%sbp' % amount # convert to 'bp' elif unit == '%': res = r'%.3f\linewidth' % (float(amount) / 100.0) + elif unit in {'ch', 'rem', 'vw', 'vh', 'vmin', 'vmax', 'Q'}: + res = rf'{amount}\sphinx{unit}dimen' else: amount_float = float(amount) * scale / 100.0 if unit in {'', 'px'}: @@ -302,8 +323,13 @@ def rstdim_to_latexdim(width_str: str, scale: int = 100) -> str: res = '%.5fbp' % amount_float elif unit == '%': res = r'%.5f\linewidth' % (amount_float / 100.0) + elif unit in {'ch', 'rem', 'vw', 'vh', 'vmin', 'vmax', 'Q'}: + res = rf'{amount_float:.5f}\sphinx{unit}dimen' else: res = f'{amount_float:.5f}{unit}' + # Those further units are passed through and accepted "as is" by TeX: + # em and ex (both font dependent), bp, cm, mm, in, and pc. + # Non-CSS units (TeX only presumably) are cc, nc, dd, nd, and sp. return res @@ -327,7 +353,6 @@ def __init__( self.in_footnote = 0 self.in_caption = 0 self.in_term = 0 - self.needs_linetrimming = 0 self.in_minipage = 0 # only used by figure inside an admonition self.no_latex_floats = 0 @@ -781,8 +806,6 @@ def visit_desc(self, node: Element) -> None: else: self.body.append(BLANKLINE) self.body.append(r'\begin{fulllineitems}' + CR) - if self.table: - self.table.has_problematic = True def depart_desc(self, node: Element) -> None: if self.in_desc_signature: @@ -1084,8 +1107,6 @@ def visit_seealso(self, node: Element) -> None: r'\begin{sphinxseealso}{%s:}' % admonitionlabels['seealso'] + CR ) self.no_latex_floats += 1 - if self.table: - self.table.has_problematic = True def depart_seealso(self, node: Element) -> None: self.body.append(BLANKLINE) @@ -1146,23 +1167,17 @@ def visit_tabular_col_spec(self, node: Element) -> None: raise nodes.SkipNode def visit_table(self, node: Element) -> None: - if len(self.tables) == 1: - assert self.table is not None - if self.table.get_table_type() == 'longtable': - raise UnsupportedError( - '%s:%s: longtable does not support nesting a table.' - % (self.curfilestack[-1], node.line or '') - ) - # change type of parent table to tabular - # see https://groups.google.com/d/msg/sphinx-users/7m3NeOBixeo/9LKP2B4WBQAJ - self.table.has_problematic = True - elif len(self.tables) > 2: + table = Table(node) + assert table is not None + if len(self.tables) >= 1: + table.is_nested = True + # TODO: do we want > 2, > 1, or actually nothing here? + if len(self.tables) > 2: raise UnsupportedError( '%s:%s: deeply nested tables are not implemented.' % (self.curfilestack[-1], node.line or '') ) - table = Table(node) self.tables.append(table) if table.colsep is None: table.colsep = '|' * ( @@ -1191,6 +1206,35 @@ def depart_table(self, node: Element) -> None: assert self.table is not None labels = self.hypertarget_to(node) table_type = self.table.get_table_type() + if table_type == 'tabulary': + if len(self.tables) > 1: + # tell parents to not be tabulary + for _ in self.tables[:-1]: + _.has_problematic = True + else: + # We try to catch a tabularcolumns using L, R, J, C, or T. + # We can not simply test for presence in the colspec of + # one of those letters due to syntax such as >{\RaggedRight}. + # The test will not catch *{3}{J} syntax, but it would be + # overkill to try to implement LaTeX preamble mini-language. + if self.table.colspec: + assert len(self.table.colspec) > 2 + # cf how self.table.colspec got set in visit_table(). + _colspec_as_given = self.table.colspec[1:-2] + _colspec_stripped = re.sub(r'\{.*?\}', '', _colspec_as_given) + if any(c in _colspec_stripped for c in 'LRJCT'): + logger.warning( + __( + 'colspec %s was given which appears to use ' + 'tabulary syntax. But this table can not be ' + 'rendered as a tabulary; the given colspec will ' + 'be ignored.' + ), + _colspec_as_given, + type='latex', + location=node, + ) + self.table.colspec = '' table = self.render( table_type + '.tex.jinja', {'table': self.table, 'labels': labels} ) @@ -1321,19 +1365,25 @@ def visit_entry(self, node: Element) -> None: r'\sphinxmultirow{%d}{%d}{%%' % (cell.height, cell.cell_id) + CR ) context = '}%' + CR + context - if cell.width > 1 or cell.height > 1: - self.body.append( - r'\begin{varwidth}[t]{\sphinxcolwidth{%d}{%d}}' - % (cell.width, self.table.colcount) - + CR - ) - context = ( - r'\par' + CR + r'\vskip-\baselineskip' - r'\vbox{\hbox{\strut}}\end{varwidth}%' + CR + context - ) - self.needs_linetrimming = 1 - if len(list(node.findall(nodes.paragraph))) >= 2: - self.table.has_oldproblematic = True + # 9.0 wraps ALL cells contents in "varwidth". This fixes a + # number of issues and allows more usage of tabulary. + # + # "varwidth" usage allows a *tight fit* to multiple paragraphs, + # line blocks, bullet lists, enumerated lists; it is less + # successful at finding a tight fit for object descriptions or + # admonitions: the table will then probably occupy full-width, and + # columns containing such cells will auto-divide the total width + # equally. + # + # "\sphinxcolwidth" has an appropriate definition in + # sphinxlatextables.sty which in particular takes into account + # tabulary "two-pass" system. + self.body.append( + r'\begin{varwidth}[t]{\sphinxcolwidth{%d}{%d}}' + % (cell.width, self.table.colcount) + + CR + ) + context = r'\sphinxbeforeendvarwidth' + CR + r'\end{varwidth}%' + CR + context if ( isinstance(node.parent.parent, nodes.thead) or (cell.col in self.table.stubs) @@ -1346,23 +1396,20 @@ def visit_entry(self, node: Element) -> None: pass else: self.body.append(r'\sphinxstyletheadfamily ') - if self.needs_linetrimming: - self.pushbody([]) + self.pushbody([]) self.context.append(context) def depart_entry(self, node: Element) -> None: - if self.needs_linetrimming: - self.needs_linetrimming = 0 - body = self.popbody() + assert self.table is not None + body = self.popbody() - # Remove empty lines from top of merged cell - while body and body[0] == CR: - body.pop(0) - self.body.extend(body) + # Remove empty lines from top of merged cell + while body and body[0] == CR: + body.pop(0) + self.body.extend(body) self.body.append(self.context.pop()) - assert self.table is not None cell = self.table.cell() assert cell is not None self.table.col += cell.width @@ -1400,8 +1447,6 @@ def visit_acks(self, node: Element) -> None: def visit_bullet_list(self, node: Element) -> None: if not self.compact_list: self.body.append(r'\begin{itemize}' + CR) - if self.table: - self.table.has_problematic = True def depart_bullet_list(self, node: Element) -> None: if not self.compact_list: @@ -1439,8 +1484,6 @@ def get_nested_level(node: Element) -> int: ) if 'start' in node: self.body.append(r'\setcounter{%s}{%d}' % (enum, node['start'] - 1) + CR) - if self.table: - self.table.has_problematic = True def depart_enumerated_list(self, node: Element) -> None: self.body.append(r'\end{enumerate}' + CR) @@ -1455,8 +1498,6 @@ def depart_list_item(self, node: Element) -> None: def visit_definition_list(self, node: Element) -> None: self.body.append(r'\begin{description}' + CR) - if self.table: - self.table.has_problematic = True def depart_definition_list(self, node: Element) -> None: self.body.append(r'\end{description}' + CR) @@ -1496,8 +1537,6 @@ def depart_definition(self, node: Element) -> None: def visit_field_list(self, node: Element) -> None: self.body.append(r'\begin{quote}\begin{description}' + CR) - if self.table: - self.table.has_problematic = True def depart_field_list(self, node: Element) -> None: self.body.append(r'\end{description}\end{quote}' + CR) @@ -1524,7 +1563,7 @@ def visit_paragraph(self, node: Element) -> None: ): # insert blank line, if the paragraph follows a non-paragraph node in a compound self.body.append(r'\noindent' + CR) - elif index == 1 and isinstance(node.parent, nodes.footnote | footnotetext): + elif index == 1 and isinstance(node.parent, (nodes.footnote, footnotetext)): # don't insert blank line, if the paragraph is second child of a footnote # (first one is label node) pass @@ -1539,8 +1578,6 @@ def depart_paragraph(self, node: Element) -> None: def visit_centered(self, node: Element) -> None: self.body.append(CR + r'\begin{center}') - if self.table: - self.table.has_problematic = True def depart_centered(self, node: Element) -> None: self.body.append(CR + r'\end{center}') @@ -1555,8 +1592,6 @@ def visit_hlist(self, node: Element) -> None: r'\begin{itemize}\setlength{\itemsep}{0pt}' r'\setlength{\parskip}{0pt}' + CR ) - if self.table: - self.table.has_problematic = True def depart_hlist(self, node: Element) -> None: self.compact_list -= 1 @@ -1752,8 +1787,6 @@ def depart_legend(self, node: Element) -> None: def visit_admonition(self, node: Element) -> None: self.body.append(CR + r'\begin{sphinxadmonition}{note}') self.no_latex_floats += 1 - if self.table: - self.table.has_problematic = True def depart_admonition(self, node: Element) -> None: self.body.append(r'\end{sphinxadmonition}' + CR) @@ -1765,8 +1798,6 @@ def _visit_named_admonition(self, node: Element) -> None: CR + r'\begin{sphinxadmonition}{%s}{%s:}' % (node.tagname, label) ) self.no_latex_floats += 1 - if self.table: - self.table.has_problematic = True def _depart_named_admonition(self, node: Element) -> None: self.body.append(r'\end{sphinxadmonition}' + CR) @@ -1819,7 +1850,7 @@ def add_target(id: str) -> None: self.body.append(self.hypertarget(id, anchor=anchor)) # skip if visitor for next node supports hyperlink - next_node: Node = node + next_node: Node | None = node while isinstance(next_node, nodes.target): next_node = next_node.next_node(ascend=True) @@ -1827,7 +1858,8 @@ def add_target(id: str) -> None: if isinstance(next_node, HYPERLINK_SUPPORT_NODES): return if ( - domain.get_enumerable_node_type(next_node) + next_node is not None + and domain.get_enumerable_node_type(next_node) and domain.get_numfig_title(next_node) ): # fmt: skip return @@ -1843,30 +1875,10 @@ def add_target(id: str) -> None: and node['refid'] == prev_node['refid'] ): # a target for a hyperlink reference having alias - pass + return else: add_target(node['refid']) - # Temporary fix for https://github.com/sphinx-doc/sphinx/issues/11093 - # TODO: investigate if a more elegant solution exists - # (see comments of https://github.com/sphinx-doc/sphinx/issues/11093) - if node.get('ismod', False): - # Detect if the previous nodes are label targets. If so, remove - # the refid thereof from node['ids'] to avoid duplicated ids. - def has_dup_label(sib: Node | None) -> bool: - return isinstance(sib, nodes.target) and sib.get('refid') in node['ids'] - - prev = get_prev_node(node) - if has_dup_label(prev): - ids = node['ids'][:] # copy to avoid side-effects - while has_dup_label(prev): - ids.remove(prev['refid']) # type: ignore[index] - prev = get_prev_node(prev) # type: ignore[arg-type] - else: - ids = iter(node['ids']) # read-only iterator - else: - ids = iter(node['ids']) # read-only iterator - - for id in ids: + for id in node['ids']: add_target(id) def depart_target(self, node: Element) -> None: @@ -1962,7 +1974,7 @@ def visit_reference(self, node: Element) -> None: uri = node.get('refuri', '') if not uri and node.get('refid'): uri = '%' + self.curfilestack[-1] + '#' + node['refid'] - if self.in_title or not uri: + if not uri: self.context.append('') elif uri.startswith('#'): # references to labels in the same document @@ -2265,8 +2277,6 @@ def visit_line_block(self, node: Element) -> None: self.body.append(r'\begin{DUlineblock}{\DUlineblockindent}' + CR) else: self.body.append(CR + r'\begin{DUlineblock}{0em}' + CR) - if self.table: - self.table.has_problematic = True def depart_line_block(self, node: Element) -> None: self.body.append(r'\end{DUlineblock}' + CR) @@ -2278,18 +2288,16 @@ def visit_block_quote(self, node: Element) -> None: done = 0 if len(node.children) == 1: child = node.children[0] - if isinstance(child, nodes.bullet_list | nodes.enumerated_list): + if isinstance(child, (nodes.bullet_list, nodes.enumerated_list)): done = 1 if not done: self.body.append(r'\begin{quote}' + CR) - if self.table: - self.table.has_problematic = True def depart_block_quote(self, node: Element) -> None: done = 0 if len(node.children) == 1: child = node.children[0] - if isinstance(child, nodes.bullet_list | nodes.enumerated_list): + if isinstance(child, (nodes.bullet_list, nodes.enumerated_list)): done = 1 if not done: self.body.append(r'\end{quote}' + CR) @@ -2323,8 +2331,6 @@ def depart_option_group(self, node: Element) -> None: def visit_option_list(self, node: Element) -> None: self.body.append(r'\begin{optionlist}{3cm}' + CR) - if self.table: - self.table.has_problematic = True def depart_option_list(self, node: Element) -> None: self.body.append(r'\end{optionlist}' + CR) diff --git a/sphinx/writers/manpage.py b/sphinx/writers/manpage.py index 171761fa2b0..fd655d08ea6 100644 --- a/sphinx/writers/manpage.py +++ b/sphinx/writers/manpage.py @@ -5,8 +5,7 @@ from typing import TYPE_CHECKING, cast from docutils import nodes -from docutils.writers.manpage import Translator as BaseTranslator -from docutils.writers.manpage import Writer +from docutils.writers import manpage from sphinx import addnodes from sphinx.locale import _, admonitionlabels @@ -26,12 +25,13 @@ logger = logging.getLogger(__name__) -class ManualPageWriter(Writer): # type: ignore[misc] +class ManualPageWriter(manpage.Writer): def __init__(self, builder: Builder) -> None: super().__init__() self.builder = builder def translate(self) -> None: + assert self.document is not None transform = NestedInlineTransform(self.document) transform.apply() visitor = self.builder.create_translator(self.document, self.builder) @@ -71,7 +71,7 @@ def apply(self, **kwargs: Any) -> None: node.parent.remove(node) -class ManualPageTranslator(SphinxTranslator, BaseTranslator): # type: ignore[misc] +class ManualPageTranslator(SphinxTranslator, manpage.Translator): """Custom man page translator.""" _docinfo: dict[str, Any] = {} @@ -130,17 +130,17 @@ def depart_start_of_file(self, node: Element) -> None: # Top-level nodes for descriptions ################################## - def visit_desc(self, node: Element) -> None: + def visit_desc(self, node: nodes.definition_list) -> None: self.visit_definition_list(node) - def depart_desc(self, node: Element) -> None: + def depart_desc(self, node: nodes.definition_list) -> None: self.depart_definition_list(node) - def visit_desc_signature(self, node: Element) -> None: - self.visit_definition_list_item(node) + def visit_desc_signature(self, node: nodes.term) -> None: + self.visit_definition_list_item(node) # type: ignore[arg-type] self.visit_term(node) - def depart_desc_signature(self, node: Element) -> None: + def depart_desc_signature(self, node: nodes.term) -> None: self.depart_term(node) def visit_desc_signature_line(self, node: Element) -> None: @@ -149,10 +149,10 @@ def visit_desc_signature_line(self, node: Element) -> None: def depart_desc_signature_line(self, node: Element) -> None: self.body.append(' ') - def visit_desc_content(self, node: Element) -> None: + def visit_desc_content(self, node: nodes.definition) -> None: self.visit_definition(node) - def depart_desc_content(self, node: Element) -> None: + def depart_desc_content(self, node: nodes.definition) -> None: self.depart_definition(node) def visit_desc_inline(self, node: Element) -> None: @@ -231,25 +231,25 @@ def depart_desc_annotation(self, node: Element) -> None: ############################################## - def visit_versionmodified(self, node: Element) -> None: + def visit_versionmodified(self, node: nodes.paragraph) -> None: self.visit_paragraph(node) - def depart_versionmodified(self, node: Element) -> None: + def depart_versionmodified(self, node: nodes.paragraph) -> None: self.depart_paragraph(node) # overwritten -- don't make whole of term bold if it includes strong node - def visit_term(self, node: Element) -> None: + def visit_term(self, node: nodes.term) -> None: if any(node.findall(nodes.strong)): self.body.append('\n') else: super().visit_term(node) # overwritten -- we don't want source comments to show up - def visit_comment(self, node: Element) -> None: + def visit_comment(self, node: Element) -> None: # type: ignore[override] raise nodes.SkipNode # overwritten -- added ensure_eol() - def visit_footnote(self, node: Element) -> None: + def visit_footnote(self, node: nodes.footnote) -> None: self.ensure_eol() super().visit_footnote(node) @@ -264,10 +264,10 @@ def visit_rubric(self, node: Element) -> None: def depart_rubric(self, node: Element) -> None: self.body.append('\n') - def visit_seealso(self, node: Element) -> None: + def visit_seealso(self, node: nodes.admonition) -> None: self.visit_admonition(node, 'seealso') - def depart_seealso(self, node: Element) -> None: + def depart_seealso(self, node: nodes.admonition) -> None: self.depart_admonition(node) def visit_productionlist(self, node: Element) -> None: @@ -291,7 +291,7 @@ def visit_image(self, node: Element) -> None: raise nodes.SkipNode # overwritten -- don't visit inner marked up nodes - def visit_reference(self, node: Element) -> None: + def visit_reference(self, node: nodes.reference) -> None: uri = node.get('refuri', '') is_safe_to_click = uri.startswith(('mailto:', 'http:', 'https:', 'ftp:')) if is_safe_to_click: @@ -301,7 +301,7 @@ def visit_reference(self, node: Element) -> None: self.body.append(self.defs['reference'][0]) # avoid repeating escaping code... fine since # visit_Text calls astext() and only works on that afterwards - self.visit_Text(node) + self.visit_Text(node) # type: ignore[arg-type] self.body.append(self.defs['reference'][1]) if uri and not uri.startswith('#'): @@ -369,10 +369,10 @@ def visit_acks(self, node: Element) -> None: self.body.append('\n') raise nodes.SkipNode - def visit_hlist(self, node: Element) -> None: + def visit_hlist(self, node: nodes.bullet_list) -> None: self.visit_bullet_list(node) - def depart_hlist(self, node: Element) -> None: + def depart_hlist(self, node: nodes.bullet_list) -> None: self.depart_bullet_list(node) def visit_hlistcol(self, node: Element) -> None: @@ -381,16 +381,16 @@ def visit_hlistcol(self, node: Element) -> None: def depart_hlistcol(self, node: Element) -> None: pass - def visit_literal_emphasis(self, node: Element) -> None: + def visit_literal_emphasis(self, node: nodes.emphasis) -> None: return self.visit_emphasis(node) - def depart_literal_emphasis(self, node: Element) -> None: + def depart_literal_emphasis(self, node: nodes.emphasis) -> None: return self.depart_emphasis(node) - def visit_literal_strong(self, node: Element) -> None: + def visit_literal_strong(self, node: nodes.strong) -> None: return self.visit_strong(node) - def depart_literal_strong(self, node: Element) -> None: + def depart_literal_strong(self, node: nodes.strong) -> None: return self.depart_strong(node) def visit_abbreviation(self, node: Element) -> None: @@ -399,14 +399,14 @@ def visit_abbreviation(self, node: Element) -> None: def depart_abbreviation(self, node: Element) -> None: pass - def visit_manpage(self, node: Element) -> None: + def visit_manpage(self, node: nodes.strong) -> None: return self.visit_strong(node) - def depart_manpage(self, node: Element) -> None: + def depart_manpage(self, node: nodes.strong) -> None: return self.depart_strong(node) # overwritten: handle section titles better than in 0.6 release - def visit_caption(self, node: Element) -> None: + def visit_caption(self, node: nodes.caption) -> None: if ( isinstance(node.parent, nodes.container) and node.parent.get('literal_block') @@ -415,7 +415,7 @@ def visit_caption(self, node: Element) -> None: else: super().visit_caption(node) - def depart_caption(self, node: Element) -> None: + def depart_caption(self, node: nodes.caption) -> None: if ( isinstance(node.parent, nodes.container) and node.parent.get('literal_block') @@ -425,7 +425,7 @@ def depart_caption(self, node: Element) -> None: super().depart_caption(node) # overwritten: handle section titles better than in 0.6 release - def visit_title(self, node: Element) -> None: + def visit_title(self, node: nodes.title) -> None: if isinstance(node.parent, addnodes.seealso): self.body.append('.IP "') return None @@ -438,7 +438,7 @@ def visit_title(self, node: Element) -> None: raise nodes.SkipNode return super().visit_title(node) - def depart_title(self, node: Element) -> None: + def depart_title(self, node: nodes.title) -> None: if isinstance(node.parent, addnodes.seealso): self.body.append('"\n') return None diff --git a/sphinx/writers/texinfo.py b/sphinx/writers/texinfo.py index b4f1272d49d..a40d65ebc7b 100644 --- a/sphinx/writers/texinfo.py +++ b/sphinx/writers/texinfo.py @@ -290,7 +290,10 @@ def add_node_name(name: str) -> str: ] # each section is also a node for section in self.document.findall(nodes.section): - title = cast('nodes.TextElement', section.next_node(nodes.Titular)) # type: ignore[type-var] + # TODO: TYPING: Node.next_node() should accept the non-Node + # mixin classes in docutils.nodes. + title = section.next_node(nodes.Titular) # type: ignore[type-var] + assert isinstance(title, nodes.Node) name = title.astext() if title else '' section['node_name'] = add_node_name(name) @@ -306,7 +309,7 @@ def collect_node_menus(self) -> None: # try to find a suitable "Top" node title = self.document.next_node(nodes.title) top = title.parent if title else self.document - if not isinstance(top, nodes.document | nodes.section): + if not isinstance(top, (nodes.document, nodes.section)): top = self.document if top is not self.document: entries = node_menus[top['node_name']] @@ -416,7 +419,7 @@ def add_menu_entries( name = self.node_names[entry] # special formatting for entries that are divided by an em-dash try: - parts = reg.split(name, 1) + parts = reg.split(name, maxsplit=1) except TypeError: # could be a gettext proxy parts = [name] @@ -638,7 +641,7 @@ def visit_title(self, node: Element) -> None: parent = node.parent if isinstance(parent, nodes.table): return - if isinstance(parent, nodes.Admonition | nodes.sidebar | nodes.topic): + if isinstance(parent, (nodes.Admonition, nodes.sidebar, nodes.topic)): raise nodes.SkipNode if not isinstance(parent, nodes.section): logger.warning( @@ -711,7 +714,7 @@ def depart_target(self, node: Element) -> None: def visit_reference(self, node: Element) -> None: # an xref's target is displayed in Info so we ignore a few # cases for the sake of appearance - if isinstance(node.parent, nodes.title | addnodes.desc_type): + if isinstance(node.parent, (nodes.title, addnodes.desc_type)): return if len(node) != 0 and isinstance(node[0], nodes.image): return @@ -748,7 +751,7 @@ def visit_reference(self, node: Element) -> None: uri = self.escape_arg(uri) id = 'Top' if '#' in uri: - uri, id = uri.split('#', 1) + uri, _, id = uri.partition('#') id = self.escape_id(id) name = self.escape_menu(name) if name == id: @@ -886,7 +889,7 @@ def depart_collected_footnote(self, node: Element) -> None: def visit_footnote_reference(self, node: Element) -> None: num = node.astext().strip() try: - footnode, used = self.footnotestack[-1][num] + footnode, _used = self.footnotestack[-1][num] except (KeyError, IndexError) as exc: raise nodes.SkipNode from exc # footnotes are repeated for each reference @@ -1002,7 +1005,7 @@ def visit_term(self, node: Element) -> None: self.add_anchor(id, node) # anchors and indexes need to go in front for n in node[::]: - if isinstance(n, addnodes.index | nodes.target): + if isinstance(n, (addnodes.index, nodes.target)): n.walkabout(self) node.remove(n) self.body.append('\n%s ' % self.at_item_x) @@ -1173,7 +1176,7 @@ def depart_decoration(self, node: Element) -> None: def visit_topic(self, node: Element) -> None: # ignore TOC's since we have to have a "menu" anyway - if 'contents' in node.get('classes', ()): + if (classes := node.get('classes', ())) and 'contents' in classes: raise nodes.SkipNode title = cast('nodes.title', node[0]) self.visit_rubric(title) diff --git a/sphinx/writers/text.py b/sphinx/writers/text.py index 1f14781fc19..a542ab45c08 100644 --- a/sphinx/writers/text.py +++ b/sphinx/writers/text.py @@ -292,18 +292,18 @@ def _wrap_chunks(self, chunks: list[str]) -> list[str]: else: indent = self.initial_indent + # Note that column_width(x) > len(x) is possible, + # but _handle_long_word() handles negative widths. width = self.width - column_width(indent) if self.drop_whitespace and not chunks[-1].strip() and lines: del chunks[-1] while chunks: - l = column_width(chunks[-1]) - - if cur_len + l <= width: + chunk_width = column_width(chunks[-1]) + if cur_len + chunk_width <= width: cur_line.append(chunks.pop()) - cur_len += l - + cur_len += chunk_width else: break @@ -318,47 +318,73 @@ def _wrap_chunks(self, chunks: list[str]) -> list[str]: return lines - def _break_word(self, word: str, space_left: int) -> tuple[str, str]: - """Break line by unicode width instead of len(word).""" + @staticmethod + def _find_break_end(word: str, space_left: int) -> int: + """Break word by Unicode width instead of len(word). + + The returned position 'end' satisfies:: + + assert column_width(word[:end]) <= space_left + assert end == len(word) or column_width(word[:end+1]) > space_left + """ total = 0 - for i, c in enumerate(word): + for end, c in enumerate(word, start=1): total += column_width(c) if total > space_left: - return word[: i - 1], word[i - 1 :] - return word, '' + return end - 1 + return len(word) def _split(self, text: str) -> list[str]: """Override original method that only split by 'wordsep_re'. This '_split' splits wide-characters into chunks by one character. """ - - def split(t: str) -> list[str]: - return super(TextWrapper, self)._split(t) - chunks: list[str] = [] - for chunk in split(text): - for w, g in groupby(chunk, column_width): - if w == 1: - chunks.extend(split(''.join(g))) + for chunk in super()._split(text): + for w, g in groupby(chunk, _column_width_safe): + if w <= 1: + chunks += super()._split(''.join(g)) else: - chunks.extend(list(g)) + chunks += g return chunks def _handle_long_word( self, reversed_chunks: list[str], cur_line: list[str], cur_len: int, width: int ) -> None: - """Override original method for using self._break_word() instead of slice.""" - space_left = max(width - cur_len, 1) - if self.break_long_words: - l, r = self._break_word(reversed_chunks[-1], space_left) - cur_line.append(l) - reversed_chunks[-1] = r + """Override using self._find_break() instead of str.find().""" + # Make sure at least one character is stripped off on every pass. + # + # Do NOT use space_left = max(width - cur_len, 1) as corner cases + # with "self.drop_whitespace == False" and "self.width == 1" fail. + space_left = 1 if width < 1 else (width - cur_len) + if self.break_long_words: + # Some characters may have len(X) < space_left < column_width(X) + # so we should only wrap chunks for which len(X) > space_left. + end = space_left + chunk = reversed_chunks[-1] + if space_left > 0: + end = self._find_break_end(chunk, space_left) + if end == 0 and space_left: + # force processing at least one character + end = 1 + cur_line.append(chunk[:end]) + reversed_chunks[-1] = chunk[end:] elif not cur_line: cur_line.append(reversed_chunks.pop()) +def _column_width_safe(x: str) -> int: + # Handle characters that are 0-width. We should refine + # the grouping to prevent splitting a word at combining + # characters or in a group of combining characters with + # at most one non-combining character as the combining + # characters may act on the right or left character. + # + # See https://github.com/sphinx-doc/sphinx/issues/13741. + return max(1, column_width(x)) + + MAXWIDTH = 70 STDINDENT = 3 diff --git a/sphinx/writers/xml.py b/sphinx/writers/xml.py index 51f77ee2f01..67c69d97ec6 100644 --- a/sphinx/writers/xml.py +++ b/sphinx/writers/xml.py @@ -4,15 +4,17 @@ from typing import TYPE_CHECKING -from docutils.writers.docutils_xml import Writer as BaseXMLWriter +from docutils.writers import docutils_xml if TYPE_CHECKING: from typing import Any + from docutils.writers.docutils_xml import XMLTranslator + from sphinx.builders import Builder -class XMLWriter(BaseXMLWriter): # type: ignore[misc] +class XMLWriter(docutils_xml.Writer): output: str def __init__(self, builder: Builder) -> None: @@ -21,6 +23,7 @@ def __init__(self, builder: Builder) -> None: self._config = builder.config def translate(self, *args: Any, **kwargs: Any) -> None: + assert self.document is not None self.document.settings.newlines = self.document.settings.indents = ( self._config.xml_pretty ) @@ -29,12 +32,13 @@ def translate(self, *args: Any, **kwargs: Any) -> None: # copied from docutils.writers.docutils_xml.Writer.translate() # so that we can override the translator class - self.visitor = visitor = self.builder.create_translator(self.document) + visitor: XMLTranslator = self.builder.create_translator(self.document) # type: ignore[assignment] + self.visitor = visitor self.document.walkabout(visitor) - self.output = ''.join(visitor.output) # type: ignore[attr-defined] + self.output = ''.join(visitor.output) -class PseudoXMLWriter(BaseXMLWriter): # type: ignore[misc] +class PseudoXMLWriter(docutils_xml.Writer): supported = ('pprint', 'pformat', 'pseudoxml') """Formats this writer supports.""" @@ -49,6 +53,7 @@ def __init__(self, builder: Builder) -> None: self.builder = builder def translate(self) -> None: + assert self.document is not None self.output = self.document.pformat() def supports(self, format: str) -> bool: diff --git a/tests/conftest.py b/tests/conftest.py index 8860e24e65c..b884f132f79 100644 --- a/tests/conftest.py +++ b/tests/conftest.py @@ -12,21 +12,16 @@ import sphinx import sphinx.locale -import sphinx.pycode from sphinx.testing.util import _clean_up_global_state +from tests.utils import TEST_ROOTS_DIR + if TYPE_CHECKING: from collections.abc import Callable, Iterator from typing import Any from sphinx.testing.util import SphinxTestApp -_TESTS_ROOT = Path(__file__).resolve().parent -if 'CI' in os.environ and (_TESTS_ROOT / 'roots-read-only').is_dir(): - _ROOTS_DIR = _TESTS_ROOT / 'roots-read-only' -else: - _ROOTS_DIR = _TESTS_ROOT / 'roots' - def _init_console( locale_dir: str | os.PathLike[str] | None = sphinx.locale._LOCALE_DIR, @@ -46,14 +41,14 @@ def _init_console( pytest_plugins = ['sphinx.testing.fixtures'] # Exclude 'roots' dirs for pytest test collector -collect_ignore = ['roots'] +collect_ignore = ['roots', 'roots-read-only'] os.environ['SPHINX_AUTODOC_RELOAD_MODULES'] = '1' @pytest.fixture(scope='session') def rootdir() -> Path: - return _ROOTS_DIR + return TEST_ROOTS_DIR def pytest_report_header(config: pytest.Config) -> str: @@ -62,7 +57,7 @@ def pytest_report_header(config: pytest.Config) -> str: ] if sys.version_info[:2] >= (3, 13): lines.append(f'GIL enabled?: {sys._is_gil_enabled()}') - lines.append(f'test roots directory: {_ROOTS_DIR}') + lines.append(f'test roots directory: {TEST_ROOTS_DIR}') if hasattr(config, '_tmp_path_factory'): lines.append(f'base tmp_path: {config._tmp_path_factory.getbasetemp()}') return '\n'.join(lines) diff --git a/tests/js/fixtures/cpp/searchindex.js b/tests/js/fixtures/cpp/searchindex.js index 42adb88db92..1dac186a7e7 100644 --- a/tests/js/fixtures/cpp/searchindex.js +++ b/tests/js/fixtures/cpp/searchindex.js @@ -1 +1 @@ -Search.setIndex({"alltitles":{},"docnames":["index"],"envversion":{"sphinx":65,"sphinx.domains.c":3,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":9,"sphinx.domains.index":1,"sphinx.domains.javascript":3,"sphinx.domains.math":2,"sphinx.domains.python":4,"sphinx.domains.rst":2,"sphinx.domains.std":2},"filenames":["index.rst"],"indexentries":{"sphinx (c++ class)":[[0,"_CPPv46Sphinx",false]]},"objects":{"":[[0,0,1,"_CPPv46Sphinx","Sphinx"]]},"objnames":{"0":["cpp","class","C++ class"]},"objtypes":{"0":"cpp:class"},"terms":{"The":0,"becaus":0,"c":0,"can":0,"cardin":0,"challeng":0,"charact":0,"class":0,"descript":0,"drop":0,"engin":0,"fixtur":0,"frequent":0,"gener":0,"i":0,"index":0,"inflat":0,"mathemat":0,"occur":0,"often":0,"project":0,"punctuat":0,"queri":0,"relat":0,"sampl":0,"search":0,"size":0,"sphinx":0,"term":0,"thei":0,"thi":0,"token":0,"us":0,"web":0,"would":0},"titles":["<no title>"],"titleterms":{}}) \ No newline at end of file +Search.setIndex({"alltitles":{},"docnames":["index"],"envversion":{"sphinx":66,"sphinx.domains.c":3,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":9,"sphinx.domains.index":1,"sphinx.domains.javascript":3,"sphinx.domains.math":2,"sphinx.domains.python":4,"sphinx.domains.rst":2,"sphinx.domains.std":2},"filenames":["index.rst"],"indexentries":{"sphinx (c++ class)":[[0,"_CPPv46Sphinx",false]]},"objects":{"":[[0,0,1,"_CPPv46Sphinx","Sphinx"]]},"objnames":{"0":["cpp","class","C++ class"]},"objtypes":{"0":"cpp:class"},"terms":{"The":0,"This":0,"becaus":0,"c":0,"can":0,"cardin":0,"challeng":0,"charact":0,"class":0,"descript":0,"drop":0,"engin":0,"fixtur":0,"frequent":0,"generat":0,"index":0,"inflat":0,"mathemat":0,"occur":0,"often":0,"project":0,"punctuat":0,"queri":0,"relat":0,"sampl":0,"search":0,"size":0,"sphinx":0,"term":0,"token":0,"use":0,"web":0},"titles":[""],"titleterms":{}}) \ No newline at end of file diff --git a/tests/js/fixtures/multiterm/searchindex.js b/tests/js/fixtures/multiterm/searchindex.js index 6f27d39329b..bd732522b3d 100644 --- a/tests/js/fixtures/multiterm/searchindex.js +++ b/tests/js/fixtures/multiterm/searchindex.js @@ -1 +1 @@ -Search.setIndex({"alltitles":{"Main Page":[[0,null]]},"docnames":["index"],"envversion":{"sphinx":65,"sphinx.domains.c":3,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":9,"sphinx.domains.index":1,"sphinx.domains.javascript":3,"sphinx.domains.math":2,"sphinx.domains.python":4,"sphinx.domains.rst":2,"sphinx.domains.std":2},"filenames":["index.rst"],"indexentries":{},"objects":{},"objnames":{},"objtypes":{},"terms":{"At":0,"adjac":0,"all":0,"an":0,"appear":0,"applic":0,"ar":0,"built":0,"can":0,"check":0,"contain":0,"do":0,"document":0,"doesn":0,"each":0,"fixtur":0,"format":0,"function":0,"futur":0,"html":0,"i":0,"includ":0,"match":0,"messag":0,"multipl":0,"multiterm":0,"order":0,"other":0,"output":0,"perform":0,"perhap":0,"phrase":0,"project":0,"queri":0,"requir":0,"same":0,"search":0,"successfulli":0,"support":0,"t":0,"term":0,"test":0,"thi":0,"time":0,"us":0,"when":0,"write":0},"titles":["Main Page"],"titleterms":{"main":0,"page":0}}) \ No newline at end of file +Search.setIndex({"alltitles":{"Main Page":[[0,null]]},"docnames":["index"],"envversion":{"sphinx":66,"sphinx.domains.c":3,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":9,"sphinx.domains.index":1,"sphinx.domains.javascript":3,"sphinx.domains.math":2,"sphinx.domains.python":4,"sphinx.domains.rst":2,"sphinx.domains.std":2},"filenames":["index.rst"],"indexentries":{},"objects":{},"objnames":{},"objtypes":{},"terms":{"At":0,"This":0,"adjac":0,"appear":0,"applic":0,"built":0,"can":0,"check":0,"contain":0,"document":0,"doesn":0,"fixtur":0,"format":0,"function":0,"futur":0,"html":0,"includ":0,"match":0,"messag":0,"multipl":0,"multiterm":0,"order":0,"output":0,"perform":0,"perhap":0,"phrase":0,"project":0,"queri":0,"requir":0,"search":0,"success":0,"support":0,"t":0,"term":0,"test":0,"time":0,"use":0,"will":0,"write":0},"titles":["Main Page"],"titleterms":{"main":0,"page":0}}) \ No newline at end of file diff --git a/tests/js/fixtures/partial/searchindex.js b/tests/js/fixtures/partial/searchindex.js index cd9dbabb149..8a65718e2ea 100644 --- a/tests/js/fixtures/partial/searchindex.js +++ b/tests/js/fixtures/partial/searchindex.js @@ -1 +1 @@ -Search.setIndex({"alltitles":{"sphinx_utils module":[[0,null]]},"docnames":["index"],"envversion":{"sphinx":65,"sphinx.domains.c":3,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":9,"sphinx.domains.index":1,"sphinx.domains.javascript":3,"sphinx.domains.math":2,"sphinx.domains.python":4,"sphinx.domains.rst":2,"sphinx.domains.std":2},"filenames":["index.rst"],"indexentries":{},"objects":{},"objnames":{},"objtypes":{},"terms":{"ar":0,"both":0,"built":0,"confirm":0,"document":0,"function":0,"html":0,"i":0,"includ":0,"input":0,"javascript":0,"match":0,"partial":0,"possibl":0,"project":0,"provid":0,"restructuredtext":0,"sampl":0,"search":0,"should":0,"term":0,"thi":0,"titl":0,"us":0,"when":0},"titles":["sphinx_utils module"],"titleterms":{"modul":0,"sphinx_util":0}}) \ No newline at end of file +Search.setIndex({"alltitles":{"sphinx_utils module":[[0,null]]},"docnames":["index"],"envversion":{"sphinx":66,"sphinx.domains.c":3,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":9,"sphinx.domains.index":1,"sphinx.domains.javascript":3,"sphinx.domains.math":2,"sphinx.domains.python":4,"sphinx.domains.rst":2,"sphinx.domains.std":2},"filenames":["index.rst"],"indexentries":{},"objects":{},"objnames":{},"objtypes":{},"terms":{"This":0,"built":0,"confirm":0,"document":0,"function":0,"html":0,"includ":0,"input":0,"javascript":0,"match":0,"partial":0,"possibl":0,"project":0,"provid":0,"restructuredtext":0,"sampl":0,"search":0,"term":0,"titl":0,"use":0},"titles":["sphinx_utils module"],"titleterms":{"modul":0,"sphinx_util":0}}) \ No newline at end of file diff --git a/tests/js/fixtures/titles/searchindex.js b/tests/js/fixtures/titles/searchindex.js index cb9abd1da07..fe325c7742d 100644 --- a/tests/js/fixtures/titles/searchindex.js +++ b/tests/js/fixtures/titles/searchindex.js @@ -1 +1 @@ -Search.setIndex({"alltitles":{"Main Page":[[0,null]],"Relevance":[[0,"relevance"],[1,null]],"Result Scoring":[[0,"result-scoring"]]},"docnames":["index","relevance"],"envversion":{"sphinx":65,"sphinx.domains.c":3,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":9,"sphinx.domains.index":1,"sphinx.domains.javascript":3,"sphinx.domains.math":2,"sphinx.domains.python":4,"sphinx.domains.rst":2,"sphinx.domains.std":2},"filenames":["index.rst","relevance.rst"],"indexentries":{"example (class in relevance)":[[0,"relevance.Example",false]],"module":[[0,"module-relevance",false]],"relevance":[[0,"index-1",false],[0,"module-relevance",false]],"relevance (relevance.example attribute)":[[0,"relevance.Example.relevance",false]],"scoring":[[0,"index-0",true]]},"objects":{"":[[0,0,0,"-","relevance"]],"relevance":[[0,1,1,"","Example"]],"relevance.Example":[[0,2,1,"","relevance"]]},"objnames":{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","attribute","Python attribute"]},"objtypes":{"0":"py:module","1":"py:class","2":"py:attribute"},"terms":{"":[0,1],"A":1,"By":0,"For":[0,1],"In":[0,1],"against":0,"align":0,"also":1,"an":0,"answer":0,"appear":1,"ar":1,"area":0,"ask":0,"assign":0,"attempt":0,"attribut":0,"both":0,"built":1,"can":[0,1],"class":0,"code":[0,1],"collect":0,"consid":1,"contain":0,"context":0,"corpu":1,"could":1,"demonstr":0,"describ":1,"detail":1,"determin":[0,1],"docstr":0,"document":[0,1],"domain":1,"dure":0,"engin":0,"evalu":0,"exampl":[0,1],"extract":0,"feedback":0,"find":0,"found":0,"from":0,"function":1,"ha":1,"handl":0,"happen":1,"head":0,"help":0,"highli":[0,1],"how":0,"i":[0,1],"improv":0,"inform":0,"intend":0,"issu":[0,1],"itself":1,"knowledg":0,"languag":1,"less":1,"like":[0,1],"mani":0,"match":0,"mention":1,"more":0,"name":[0,1],"numer":0,"object":0,"often":0,"one":[0,1],"onli":[0,1],"order":0,"other":0,"over":0,"page":1,"part":1,"particular":0,"present":0,"printf":1,"program":1,"project":0,"queri":[0,1],"question":0,"re":0,"rel":0,"research":0,"result":1,"retriev":0,"sai":0,"same":1,"search":[0,1],"seem":0,"softwar":1,"some":1,"sphinx":0,"straightforward":1,"subject":0,"subsect":0,"term":[0,1],"test":0,"text":0,"than":[0,1],"thei":0,"them":0,"thi":0,"time":0,"titl":0,"two":0,"typic":0,"us":0,"user":[0,1],"we":[0,1],"when":0,"whether":1,"which":0,"within":0,"word":0,"would":[0,1]},"titles":["Main Page","Relevance"],"titleterms":{"main":0,"page":0,"relev":[0,1],"result":0,"score":0}}) \ No newline at end of file +Search.setIndex({"alltitles":{"Main Page":[[0,null]],"Relevance":[[0,"relevance"],[1,null]],"Result Scoring":[[0,"result-scoring"]]},"docnames":["index","relevance"],"envversion":{"sphinx":66,"sphinx.domains.c":3,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":9,"sphinx.domains.index":1,"sphinx.domains.javascript":3,"sphinx.domains.math":2,"sphinx.domains.python":4,"sphinx.domains.rst":2,"sphinx.domains.std":2},"filenames":["index.rst","relevance.rst"],"indexentries":{"example (class in relevance)":[[0,"relevance.Example",false]],"module":[[0,"module-relevance",false]],"relevance":[[0,"index-1",false],[0,"module-relevance",false]],"relevance (relevance.example attribute)":[[0,"relevance.Example.relevance",false]],"scoring":[[0,"index-0",true]]},"objects":{"":[[0,0,0,"-","relevance"]],"relevance":[[0,1,1,"","Example"]],"relevance.Example":[[0,2,1,"","relevance"]]},"objnames":{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","attribute","Python attribute"]},"objtypes":{"0":"py:module","1":"py:class","2":"py:attribute"},"terms":{"A":1,"By":0,"For":[0,1],"In":[0,1],"This":0,"align":0,"also":1,"answer":0,"appear":1,"area":0,"ask":0,"assign":0,"attempt":0,"attribut":0,"built":1,"can":[0,1],"class":0,"code":[0,1],"collect":0,"consid":1,"contain":0,"context":0,"corpus":1,"demonstr":0,"describ":1,"detail":1,"determin":[0,1],"docstr":0,"document":[0,1],"domain":1,"dure":0,"engin":0,"evalu":0,"exampl":[0,1],"extract":0,"feedback":0,"find":0,"found":0,"function":1,"handl":0,"happen":1,"head":0,"help":0,"high":[0,1],"improv":0,"inform":0,"intend":0,"issu":[0,1],"knowledg":0,"languag":1,"less":1,"like":[0,1],"mani":0,"match":0,"mention":1,"name":[0,1],"numer":0,"object":0,"often":0,"one":[0,1],"onli":[0,1],"order":0,"page":1,"part":1,"particular":0,"present":0,"printf":1,"program":1,"project":0,"queri":[0,1],"question":0,"re":0,"relat":0,"research":0,"result":1,"retriev":0,"s":[0,1],"say":0,"search":[0,1],"seem":0,"softwar":1,"sphinx":0,"straightforward":1,"subject":0,"subsect":0,"term":[0,1],"test":0,"text":0,"time":0,"titl":0,"two":0,"typic":0,"use":0,"user":[0,1],"whether":1,"will":0,"within":0,"word":0},"titles":["Main Page","Relevance"],"titleterms":{"main":0,"page":0,"relev":[0,1],"result":0,"score":0}}) \ No newline at end of file diff --git a/tests/js/jasmine-browser.mjs b/tests/js/jasmine-browser.mjs index b84217fd8c5..f11c04b95b7 100644 --- a/tests/js/jasmine-browser.mjs +++ b/tests/js/jasmine-browser.mjs @@ -1,28 +1,26 @@ export default { srcDir: ".", srcFiles: [ - 'sphinx/themes/basic/static/doctools.js', - 'sphinx/themes/basic/static/searchtools.js', - 'sphinx/themes/basic/static/sphinx_highlight.js', - 'tests/js/fixtures/**/*.js', - 'tests/js/documentation_options.js', - 'tests/js/language_data.js', + "sphinx/themes/basic/static/doctools.js", + "sphinx/themes/basic/static/searchtools.js", + "sphinx/themes/basic/static/sphinx_highlight.js", + "tests/js/fixtures/**/*.js", + "tests/js/documentation_options.js", + "tests/js/language_data.js", ], specDir: "tests/js", - specFiles: [ - '**/*.spec.js', - ], + specFiles: ["**/*.spec.js"], helpers: [], env: { stopSpecOnExpectationFailure: false, stopOnSpecFailure: false, - random: true + random: true, }, listenAddress: "127.0.0.1", hostname: "127.0.0.1", browser: { - name: "headlessFirefox" - } + name: "headlessFirefox", + }, }; diff --git a/tests/js/language_data.js b/tests/js/language_data.js index 15e4a8447f0..c98e91ff6e2 100644 --- a/tests/js/language_data.js +++ b/tests/js/language_data.js @@ -3,17 +3,16 @@ * namely the list of stopwords, stemmer, scorer and splitter. */ -var stopwords = []; +const stopwords = new Set([]); +window.stopwords = stopwords; // Export to global scope - -/* Non-minified version is copied as a separate JS file, if available */ +/* Non-minified versions are copied as separate JavaScript files, if available */ /** * Dummy stemmer for languages without stemming rules. */ -var Stemmer = function() { - this.stemWord = function(w) { +var Stemmer = function () { + this.stemWord = function (w) { return w; - } -} - + }; +}; diff --git a/tests/js/searchtools.spec.js b/tests/js/searchtools.spec.js index 809fd19d0f4..68a48a9f6bb 100644 --- a/tests/js/searchtools.spec.js +++ b/tests/js/searchtools.spec.js @@ -1,10 +1,9 @@ -describe('Basic html theme search', function() { - +describe("Basic html theme search", function () { function loadFixture(name) { - req = new XMLHttpRequest(); - req.open("GET", `__src__/tests/js/fixtures/${name}`, false); - req.send(null); - return req.responseText; + req = new XMLHttpRequest(); + req.open("GET", `__src__/tests/js/fixtures/${name}`, false); + req.send(null); + return req.responseText; } function checkRanking(expectedRanking, results) { @@ -16,7 +15,11 @@ describe('Basic html theme search', function() { let [expectedPage, expectedTitle, expectedTarget] = nextExpected; let [page, title, target] = result; - if (page == expectedPage && title == expectedTitle && target == expectedTarget) { + if ( + page == expectedPage + && title == expectedTitle + && target == expectedTarget + ) { [nextExpected, ...remainingItems] = remainingItems; } } @@ -25,16 +28,17 @@ describe('Basic html theme search', function() { expect(nextExpected).toEqual(undefined); } - describe('terms search', function() { - - it('should find "C++" when in index', function() { + describe("terms search", function () { + it('should find "C++" when in index', function () { eval(loadFixture("cpp/searchindex.js")); - [_searchQuery, searchterms, excluded, ..._remainingItems] = Search._parseQuery('C++'); + [_searchQuery, searchterms, excluded, ..._remainingItems] = + Search._parseQuery("C++"); + // prettier-ignore hits = [[ "index", - "<no title>", + "", "", null, 5, @@ -44,10 +48,12 @@ describe('Basic html theme search', function() { expect(Search.performTermsSearch(searchterms, excluded)).toEqual(hits); }); - it('should be able to search for multiple terms', function() { + it("should be able to search for multiple terms", function () { eval(loadFixture("multiterm/searchindex.js")); - [_searchQuery, searchterms, excluded, ..._remainingItems] = Search._parseQuery('main page'); + [_searchQuery, searchterms, excluded, ..._remainingItems] = + Search._parseQuery("main page"); + // prettier-ignore hits = [[ 'index', 'Main Page', @@ -60,11 +66,13 @@ describe('Basic html theme search', function() { expect(Search.performTermsSearch(searchterms, excluded)).toEqual(hits); }); - it('should partially-match "sphinx" when in title index', function() { + it('should partially-match "sphinx" when in title index', function () { eval(loadFixture("partial/searchindex.js")); - [_searchQuery, searchterms, excluded, ..._remainingItems] = Search._parseQuery('sphinx'); + [_searchQuery, searchterms, excluded, ..._remainingItems] = + Search._parseQuery("sphinx"); + // prettier-ignore hits = [[ "index", "sphinx_utils module", @@ -77,13 +85,15 @@ describe('Basic html theme search', function() { expect(Search.performTermsSearch(searchterms, excluded)).toEqual(hits); }); - it('should partially-match within "possible" when in term index', function() { + it('should partially-match within "possible" when in term index', function () { eval(loadFixture("partial/searchindex.js")); - [_searchQuery, searchterms, excluded, ..._remainingItems] = Search._parseQuery('ossibl'); + [_searchQuery, searchterms, excluded, ..._remainingItems] = + Search._parseQuery("ossibl"); terms = Search._index.terms; titleterms = Search._index.titleterms; + // prettier-ignore hits = [[ "index", "sphinx_utils module", @@ -93,18 +103,19 @@ describe('Basic html theme search', function() { "index.rst", "text" ]]; - expect(Search.performTermsSearch(searchterms, excluded, terms, titleterms)).toEqual(hits); + expect( + Search.performTermsSearch(searchterms, excluded, terms, titleterms), + ).toEqual(hits); }); - }); - describe('aggregation of search results', function() { - - it('should combine document title and document term matches', function() { + describe("aggregation of search results", function () { + it("should combine document title and document term matches", function () { eval(loadFixture("multiterm/searchindex.js")); - searchParameters = Search._parseQuery('main page'); + searchParameters = Search._parseQuery("main page"); + // prettier-ignore hits = [ [ 'index', @@ -118,11 +129,9 @@ describe('Basic html theme search', function() { ]; expect(Search._performSearch(...searchParameters)).toEqual(hits); }); - }); - describe('search result ranking', function() { - + describe("search result ranking", function () { /* * These tests should not proscribe precise expected ordering of search * results; instead each test case should describe a single relevance rule @@ -137,95 +146,96 @@ describe('Basic html theme search', function() { * [1] - https://github.com/sphinx-doc/sphinx.git/ */ - it('should score a code module match above a page-title match', function() { + it("should score a code module match above a page-title match", function () { eval(loadFixture("titles/searchindex.js")); + // prettier-ignore expectedRanking = [ ['index', 'relevance', '#module-relevance'], /* py:module documentation */ ['relevance', 'Relevance', ''], /* main title */ ]; - searchParameters = Search._parseQuery('relevance'); + searchParameters = Search._parseQuery("relevance"); results = Search._performSearch(...searchParameters); checkRanking(expectedRanking, results); }); - it('should score a main-title match above an object member match', function() { + it("should score a main-title match above an object member match", function () { eval(loadFixture("titles/searchindex.js")); + // prettier-ignore expectedRanking = [ ['relevance', 'Relevance', ''], /* main title */ ['index', 'relevance.Example.relevance', '#relevance.Example.relevance'], /* py:class attribute */ ]; - searchParameters = Search._parseQuery('relevance'); + searchParameters = Search._parseQuery("relevance"); results = Search._performSearch(...searchParameters); checkRanking(expectedRanking, results); }); - it('should score a title match above a standard index entry match', function() { + it("should score a title match above a standard index entry match", function () { eval(loadFixture("titles/searchindex.js")); + // prettier-ignore expectedRanking = [ ['relevance', 'Relevance', ''], /* title */ ['index', 'Main Page', '#index-1'], /* index entry */ ]; - searchParameters = Search._parseQuery('relevance'); + searchParameters = Search._parseQuery("relevance"); results = Search._performSearch(...searchParameters); checkRanking(expectedRanking, results); }); - it('should score a priority index entry match above a title match', function() { + it("should score a priority index entry match above a title match", function () { eval(loadFixture("titles/searchindex.js")); + // prettier-ignore expectedRanking = [ ['index', 'Main Page', '#index-0'], /* index entry */ ['index', 'Main Page > Result Scoring', '#result-scoring'], /* title */ ]; - searchParameters = Search._parseQuery('scoring'); + searchParameters = Search._parseQuery("scoring"); results = Search._performSearch(...searchParameters); checkRanking(expectedRanking, results); }); - it('should score a main-title match above a subheading-title match', function() { + it("should score a main-title match above a subheading-title match", function () { eval(loadFixture("titles/searchindex.js")); + // prettier-ignore expectedRanking = [ ['relevance', 'Relevance', ''], /* main title */ ['index', 'Main Page > Relevance', '#relevance'], /* subsection heading title */ ]; - searchParameters = Search._parseQuery('relevance'); + searchParameters = Search._parseQuery("relevance"); results = Search._performSearch(...searchParameters); checkRanking(expectedRanking, results); }); - }); - describe('can handle edge-case search queries', function() { - - it('does not find the javascript prototype property in unrelated documents', function() { + describe("can handle edge-case search queries", function () { + it("does not find the javascript prototype property in unrelated documents", function () { eval(loadFixture("partial/searchindex.js")); - searchParameters = Search._parseQuery('__proto__'); + searchParameters = Search._parseQuery("__proto__"); + // prettier-ignore hits = []; expect(Search._performSearch(...searchParameters)).toEqual(hits); }); - }); - }); -describe("htmlToText", function() { - +describe("htmlToText", function () { const testHTML = ` @@ -257,44 +267,47 @@ describe("htmlToText", function() { `; it("basic case", () => { - expect(Search.htmlToText(testHTML).trim().split(/\s+/)).toEqual([ - 'Getting', 'Started', 'Some', 'text', - 'Other', 'Section', 'Other', 'text', - 'Yet', 'Another', 'Section', 'More', 'text' - ]); + expect(Search.htmlToText(testHTML).trim().split(/\s+/)).toEqual( + /* prettier-ignore */ [ + "Getting", "Started", "Some", "text", + "Other", "Section", "Other", "text", + "Yet", "Another", "Section", "More", "text" + ], + ); }); it("will start reading from the anchor", () => { - expect(Search.htmlToText(testHTML, '#other-section').trim().split(/\s+/)).toEqual(['Other', 'Section', 'Other', 'text']); + expect( + Search.htmlToText(testHTML, "#other-section").trim().split(/\s+/), + ).toEqual(["Other", "Section", "Other", "text"]); }); }); // Regression test for https://github.com/sphinx-doc/sphinx/issues/3150 -describe('splitQuery regression tests', () => { - - it('can split English words', () => { - const parts = splitQuery(' Hello World ') - expect(parts).toEqual(['Hello', 'World']) - }) - - it('can split special characters', () => { - const parts = splitQuery('Pin-Code') - expect(parts).toEqual(['Pin', 'Code']) - }) - - it('can split Chinese characters', () => { - const parts = splitQuery('Hello from 中国 上海') - expect(parts).toEqual(['Hello', 'from', '中国', '上海']) - }) - - it('can split Emoji (surrogate pair) characters. It should keep emojis.', () => { - const parts = splitQuery('😁😁') - expect(parts).toEqual(['😁😁']) - }) - - it('can split umlauts. It should keep umlauts.', () => { - const parts = splitQuery('Löschen Prüfung Abändern ærlig spørsmål') - expect(parts).toEqual(['Löschen', 'Prüfung', 'Abändern', 'ærlig', 'spørsmål']) - }) - -}) +describe("splitQuery regression tests", () => { + it("can split English words", () => { + const parts = splitQuery(" Hello World "); + expect(parts).toEqual(["Hello", "World"]); + }); + + it("can split special characters", () => { + const parts = splitQuery("Pin-Code"); + expect(parts).toEqual(["Pin", "Code"]); + }); + + it("can split Chinese characters", () => { + const parts = splitQuery("Hello from 中国 上海"); + expect(parts).toEqual(["Hello", "from", "中国", "上海"]); + }); + + it("can split Emoji (surrogate pair) characters. It should keep emojis.", () => { + const parts = splitQuery("😁😁"); + expect(parts).toEqual(["😁😁"]); + }); + + it("can split umlauts. It should keep umlauts.", () => { + const parts = splitQuery("Löschen Prüfung Abändern ærlig spørsmål"); + // prettier-ignore + expect(parts).toEqual(["Löschen", "Prüfung", "Abändern", "ærlig", "spørsmål"]) + }); +}); diff --git a/tests/js/sphinx_highlight.spec.js b/tests/js/sphinx_highlight.spec.js index 1f52eabb96f..4d57d867745 100644 --- a/tests/js/sphinx_highlight.spec.js +++ b/tests/js/sphinx_highlight.spec.js @@ -1,30 +1,33 @@ -describe('highlightText', function() { +describe("highlightText", function () { + const cyrillicTerm = "шеллы"; + const umlautTerm = "gänsefüßchen"; - const cyrillicTerm = 'шеллы'; - const umlautTerm = 'gänsefüßchen'; - - it('should highlight text incl. special characters correctly in HTML', function() { + it("should highlight text incl. special characters correctly in HTML", function () { const highlightTestSpan = new DOMParser().parseFromString( - 'This is the шеллы and Gänsefüßchen test!', 'text/html').body.firstChild - _highlightText(highlightTestSpan, cyrillicTerm, 'highlighted'); - _highlightText(highlightTestSpan, umlautTerm, 'highlighted'); + "This is the шеллы and Gänsefüßchen test!", + "text/html", + ).body.firstChild; + _highlightText(highlightTestSpan, cyrillicTerm, "highlighted"); + _highlightText(highlightTestSpan, umlautTerm, "highlighted"); const expectedHtmlString = - 'This is the шеллы and ' + - 'Gänsefüßchen test!'; + 'This is the шеллы and ' + + 'Gänsefüßchen test!'; expect(highlightTestSpan.innerHTML).toEqual(expectedHtmlString); }); - it('should highlight text incl. special characters correctly in SVG', function() { + it("should highlight text incl. special characters correctly in SVG", function () { const highlightTestSvg = new DOMParser().parseFromString( - '' + - '' + - '' + - 'This is the шеллы and Gänsefüßchen test!' + - '' + - '' + - '', 'text/html').body.firstChild - _highlightText(highlightTestSvg, cyrillicTerm, 'highlighted'); - _highlightText(highlightTestSvg, umlautTerm, 'highlighted'); + '' + + '' + + '' + + "This is the шеллы and Gänsefüßchen test!" + + "" + + "" + + "", + "text/html", + ).body.firstChild; + _highlightText(highlightTestSvg, cyrillicTerm, "highlighted"); + _highlightText(highlightTestSvg, umlautTerm, "highlighted"); /* Note wild cards and ``toMatch``; allowing for some variability seems to be necessary, even between different FF versions */ const expectedSvgString = @@ -32,8 +35,9 @@ describe('highlightText', function() { + '' + '' + 'This is the шеллы and ' - + 'Gänsefüßchen test!'; - expect(new XMLSerializer().serializeToString(highlightTestSvg.firstChild)).toMatch(new RegExp(expectedSvgString)); + + "Gänsefüßchen test!"; + expect( + new XMLSerializer().serializeToString(highlightTestSvg.firstChild), + ).toMatch(new RegExp(expectedSvgString)); }); - }); diff --git a/tests/roots/test-build-html-translator/conf.py b/tests/roots/test-build-html-translator/conf.py deleted file mode 100644 index 89448d45741..00000000000 --- a/tests/roots/test-build-html-translator/conf.py +++ /dev/null @@ -1,16 +0,0 @@ -from sphinx.writers.html import HTML5Translator - -project = 'test' - - -class ConfHTMLTranslator(HTML5Translator): - depart_with_node = 0 - - def depart_admonition(self, node=None): - if node is not None: - self.depart_with_node += 1 - HTML5Translator.depart_admonition(self, node) - - -def setup(app): - app.set_translator('html', ConfHTMLTranslator) diff --git a/tests/roots/test-build-html-translator/index.rst b/tests/roots/test-build-html-translator/index.rst deleted file mode 100644 index 1610d2b4501..00000000000 --- a/tests/roots/test-build-html-translator/index.rst +++ /dev/null @@ -1,24 +0,0 @@ -======================= -Test HTML admonitions -======================= - -.. seealso:: test - -.. note:: test - -.. warning:: test - -.. attention:: test - -.. caution:: test - -.. danger:: test - -.. error:: test - -.. hint:: test - -.. important:: test - -.. tip:: test - diff --git a/tests/roots/test-changes/base.rst b/tests/roots/test-changes/base.rst index 81d90e66ef4..a6a83e4a282 100644 --- a/tests/roots/test-changes/base.rst +++ b/tests/roots/test-changes/base.rst @@ -1,23 +1,38 @@ Version markup -------------- -.. versionadded:: 0.6 +.. version-added:: 0.6 Some funny **stuff**. -.. versionchanged:: 0.6 +.. version-changed:: 0.6 Even more funny stuff. -.. deprecated:: 0.6 +.. version-deprecated:: 0.6 Boring stuff. -.. versionremoved:: 0.6 +.. version-removed:: 0.6 Goodbye boring stuff. -.. versionadded:: 1.2 +.. version-added:: 1.2 + + First paragraph of version-added. + +.. version-changed:: 1.2 + First paragraph of version-changed. + + Second paragraph of version-changed. - First paragraph of versionadded. +.. version-deprecated:: 1.3 + First paragraph of version-deprecated. -.. versionchanged:: 1.2 - First paragraph of versionchanged. +.. version-added:: 0.6 + Deprecated alias - Second paragraph of versionchanged. +.. version-changed:: 0.6 + Deprecated alias + +.. versionremoved:: 0.6 + Deprecated alias + +.. deprecated:: 0.6 + Deprecated alias diff --git a/tests/roots/test-changes/c-api.rst b/tests/roots/test-changes/c-api.rst index f0ad413cd2e..6ded4afebd5 100644 --- a/tests/roots/test-changes/c-api.rst +++ b/tests/roots/test-changes/c-api.rst @@ -8,7 +8,7 @@ Memory Allocate *n* bytes of memory. - .. versionchanged:: 0.6 + .. version-changed:: 0.6 Can now be replaced with a different allocator. @@ -17,7 +17,7 @@ System Access to the system allocator. -.. versionadded:: 0.6 +.. version-added:: 0.6 .. c:function:: void* Test_SysMalloc(size_t n) diff --git a/tests/roots/test-changes/library/utils.rst b/tests/roots/test-changes/library/utils.rst index 86446995b2f..56675715593 100644 --- a/tests/roots/test-changes/library/utils.rst +++ b/tests/roots/test-changes/library/utils.rst @@ -16,10 +16,10 @@ Classes Class for handling paths. - .. versionadded:: 0.5 + .. version-added:: 0.5 - Innovative new way to handle paths. + Innovative new way to handle paths. - .. deprecated:: 0.6 + .. version-deprecated:: 0.6 So, that was a bad idea it turns out. diff --git a/tests/roots/test-domain-py-xref-type-alias/conf.py b/tests/roots/test-domain-py-xref-type-alias/conf.py new file mode 100644 index 00000000000..e69de29bb2d diff --git a/tests/roots/test-domain-py-xref-type-alias/index.rst b/tests/roots/test-domain-py-xref-type-alias/index.rst new file mode 100644 index 00000000000..5d436e90102 --- /dev/null +++ b/tests/roots/test-domain-py-xref-type-alias/index.rst @@ -0,0 +1,47 @@ +Type Alias Cross-Reference Test +=============================== + +This tests that type aliases in function signatures can be cross-referenced properly. + + +.. py:module:: alias_module + + Module to test type alias cross-reference resolution. + + +.. py:data:: Handler + :module: alias_module + + A generic type alias for error handlers + + alias of :py:class:`type`\ [:py:class:`Exception`] + + +.. py:type:: HandlerType + :module: alias_module + :canonical: type[Exception] + + A PEP 695 type alias for error handlers + + +.. py:data:: pathlike + :module: alias_module + :value: str | pathlib.Path + + Any type of path + + +.. py:function:: process_error(handler: Handler, other: ~alias_module.HandlerType) -> str + :module: alias_module + + Process an error with a custom handler type. + + Tests generic type alias cross-reference resolution. + + +.. py:function:: read_file(path: pathlike) -> bytes + :module: alias_module + + Read a file and return its contents. + + Tests Union type alias cross-reference resolution. diff --git a/tests/roots/test-ext-autodoc/conf.py b/tests/roots/test-ext-autodoc/conf.py index f134359a32a..98cfc20effa 100644 --- a/tests/roots/test-ext-autodoc/conf.py +++ b/tests/roots/test-ext-autodoc/conf.py @@ -9,4 +9,10 @@ 'dummy', ] +autodoc_type_aliases = { + 'buffer_like': 'buffer_like', + 'pathlike': 'pathlike', + 'Handler': 'Handler', +} + nitpicky = True diff --git a/tests/roots/test-ext-autodoc/target/enums.py b/tests/roots/test-ext-autodoc/target/enums.py index 6b2731672d2..9d6bcdbc97f 100644 --- a/tests/roots/test-ext-autodoc/target/enums.py +++ b/tests/roots/test-ext-autodoc/target/enums.py @@ -1,4 +1,4 @@ -# ruff: NoQA: D403, PIE796 +# ruff: NoQA: PIE796 import enum from typing import final diff --git a/tests/roots/test-ext-autodoc/target/final.py b/tests/roots/test-ext-autodoc/target/final.py index a8c3860e384..bd233abb580 100644 --- a/tests/roots/test-ext-autodoc/target/final.py +++ b/tests/roots/test-ext-autodoc/target/final.py @@ -3,6 +3,9 @@ import typing from typing import final +import typing_extensions +from typing_extensions import final as final_ext # noqa: UP035 + @typing.final class Class: @@ -14,3 +17,11 @@ def meth1(self): def meth2(self): """docstring""" + + @final_ext + def meth3(self): + """docstring""" + + @typing_extensions.final + def meth4(self): + """docstring""" diff --git a/tests/roots/test-ext-autodoc/target/generic_class.py b/tests/roots/test-ext-autodoc/target/generic_class.py index 957681ae485..3ab7415c1e3 100644 --- a/tests/roots/test-ext-autodoc/target/generic_class.py +++ b/tests/roots/test-ext-autodoc/target/generic_class.py @@ -7,7 +7,7 @@ # Test that typing.Generic's __new__ method does not mask our class' # __init__ signature. -class A(Generic[T]): +class A(Generic[T]): # NoQA: UP046 """docstring for A""" def __init__(self, a, b=None): diff --git a/tests/roots/test-ext-autodoc/target/need_mocks.py b/tests/roots/test-ext-autodoc/target/need_mocks.py index 1b8af7055d6..73782a2fde8 100644 --- a/tests/roots/test-ext-autodoc/target/need_mocks.py +++ b/tests/roots/test-ext-autodoc/target/need_mocks.py @@ -1,10 +1,9 @@ import missing_module import missing_package1.missing_module1 +import sphinx.missing_module4 from missing_module import missing_name from missing_package2 import missing_module2 from missing_package3.missing_module3 import missing_name # NoQA: F811 - -import sphinx.missing_module4 from sphinx.missing_module4 import missing_name2 diff --git a/tests/roots/test-ext-autodoc/target/overload3.py b/tests/roots/test-ext-autodoc/target/overload3.py new file mode 100644 index 00000000000..a3cc34a9f85 --- /dev/null +++ b/tests/roots/test-ext-autodoc/target/overload3.py @@ -0,0 +1,18 @@ +import typing +from typing import TYPE_CHECKING, overload + +import typing_extensions +from typing_extensions import overload as over_ext # noqa: UP035 + + +@overload +def test(x: int) -> int: ... +@typing.overload +def test(x: list[int]) -> list[int]: ... +@over_ext +def test(x: str) -> str: ... +@typing_extensions.overload +def test(x: float) -> float: ... +def test(x): + """Documentation.""" + return x diff --git a/tests/roots/test-ext-autodoc/target/pep695.py b/tests/roots/test-ext-autodoc/target/pep695.py new file mode 100644 index 00000000000..3e57ed4baf4 --- /dev/null +++ b/tests/roots/test-ext-autodoc/target/pep695.py @@ -0,0 +1,72 @@ +from __future__ import annotations + +import pathlib +from typing import NewType, TypeAliasType + +import typing_extensions + +#: Some buffer-like object +buffer_like = bytes | bytearray | memoryview + +#: Any type of path +pathlike = str | pathlib.Path + +#: A generic type alias +Handler = type[Exception] + + +class Foo: + """This is class Foo.""" + + +type Pep695Alias = Foo +"""This is PEP695 type alias.""" + +type Pep695AliasUndocumented = Foo + +TypeAliasTypeExplicit = TypeAliasType('TypeAliasTypeExplicit', Foo) # NoQA: UP040 +"""This is an explicitly constructed typing.TypeAlias.""" + +HandlerTypeAliasType = TypeAliasType('HandlerTypeAliasType', type[Exception]) # NoQA: UP040 +"""This is an explicitly constructed generic alias typing.TypeAlias.""" + +TypeAliasTypeExtension = typing_extensions.TypeAliasType('TypeAliasTypeExtension', Foo) # NoQA: UP040 +"""This is an explicitly constructed typing_extensions.TypeAlias.""" + +#: This is PEP695 complex type alias with doc comment. +type Pep695AliasC = dict[str, Foo] + +type Pep695AliasUnion = str | int +"""This is PEP695 type alias for union.""" + +type Pep695AliasOfAlias = Pep695AliasC +"""This is PEP695 type alias of PEP695 alias.""" + +Bar = NewType('Bar', Pep695Alias) +"""This is newtype of Pep695Alias.""" + + +def ret_pep695(a: Pep695Alias) -> Pep695Alias: + """This fn accepts and returns PEP695 alias.""" + ... + + +def read_file(path: pathlike) -> bytes: + """Read a file and return its contents. + + Tests Union type alias cross-reference resolution. + """ + + +def process_error(handler: Handler, other: HandlerTypeAliasType) -> str: + """Process an error with a custom handler type. + + Tests generic type alias cross-reference resolution. + """ + + +def buffer_len(data: buffer_like) -> int: + """Return length of a buffer-like object. + + Tests Union type alias cross-reference resolution. + """ diff --git a/tests/roots/test-ext-autodoc/target/properties.py b/tests/roots/test-ext-autodoc/target/properties.py index 84d1c2a1a19..071bf182b55 100644 --- a/tests/roots/test-ext-autodoc/target/properties.py +++ b/tests/roots/test-ext-autodoc/target/properties.py @@ -1,3 +1,10 @@ +import sys + +TYPE_CHECKING = False +if sys.version_info[:2] < (3, 14) or TYPE_CHECKING: + TypeCheckingOnlyName = int + + class Foo: """docstring""" @@ -20,3 +27,7 @@ def prop1_with_type_comment(self): def prop2_with_type_comment(cls): # type: () -> int """docstring""" + + @property + def prop3_with_undefined_anotation(self) -> TypeCheckingOnlyName: + """docstring""" diff --git a/tests/roots/test-ext-doctest-fail-fast/conf.py b/tests/roots/test-ext-doctest-fail-fast/conf.py new file mode 100644 index 00000000000..227afbb2c95 --- /dev/null +++ b/tests/roots/test-ext-doctest-fail-fast/conf.py @@ -0,0 +1,11 @@ +extensions = ['sphinx.ext.doctest'] + +project = 'test project for doctest' +root_doc = 'fail-fast' +source_suffix = { + '.txt': 'restructuredtext', +} +exclude_patterns = ['_build'] + +# Set in tests. +# doctest_fail_fast = ... diff --git a/tests/roots/test-ext-doctest-fail-fast/fail-fast.txt b/tests/roots/test-ext-doctest-fail-fast/fail-fast.txt new file mode 100644 index 00000000000..70a05af487b --- /dev/null +++ b/tests/roots/test-ext-doctest-fail-fast/fail-fast.txt @@ -0,0 +1,11 @@ +Testing fast failure in the doctest extension +============================================= + +>>> 1 + 1 +2 + +>>> 1 + 1 +3 + +>>> 1 + 1 +3 diff --git a/tests/roots/test-ext-math-duplicate-label/conf.py b/tests/roots/test-ext-math-duplicate-label/conf.py new file mode 100644 index 00000000000..635774bdfa4 --- /dev/null +++ b/tests/roots/test-ext-math-duplicate-label/conf.py @@ -0,0 +1 @@ +extensions = ['sphinx.ext.mathjax'] diff --git a/tests/roots/test-ext-math-duplicate-label/index.rst b/tests/roots/test-ext-math-duplicate-label/index.rst new file mode 100644 index 00000000000..fa4304d096e --- /dev/null +++ b/tests/roots/test-ext-math-duplicate-label/index.rst @@ -0,0 +1,16 @@ +Test duplicate equation labels +=============================== + +First equation with label: + +.. math:: + :label: duplicated + + a^2 + b^2 = c^2 + +Second equation with the same label: + +.. math:: + :label: duplicated + + e^{i\pi} + 1 = 0 diff --git a/tests/roots/test-ext-math/_static/custom_mathjax_config.js b/tests/roots/test-ext-math/_static/custom_mathjax_config.js new file mode 100644 index 00000000000..bdcc29251b0 --- /dev/null +++ b/tests/roots/test-ext-math/_static/custom_mathjax_config.js @@ -0,0 +1 @@ +window.MathJax = {"extensions": ["tex2jax.js"]} diff --git a/tests/roots/test-intl/backslashes.txt b/tests/roots/test-intl/backslashes.txt new file mode 100644 index 00000000000..7a16b6f6b62 --- /dev/null +++ b/tests/roots/test-intl/backslashes.txt @@ -0,0 +1,38 @@ +:tocdepth: 2 + +i18n with backslashes +===================== + +line 1\ +line 2 \ +line 3 \ +line 4a \ and 4b \ +line with spaces after backslash \ +last line with spaces \ +and done 1 + +.. gettext parses the following lines as "abc", + while a C pre-processor would have produced "abc". + +a \ +b\ +c \ + +last trailing \ \ \ +is ignored + + +See [#]_ + +.. [#] footnote with backslashes \ + and done 2 + + +.. note:: directive with \ + backslashes + + +.. function:: foo(a, \ + b, \ + c, d, e, f) + the foo diff --git a/tests/roots/test-intl/index.txt b/tests/roots/test-intl/index.txt index ac68314f97d..a5c031dcdbd 100644 --- a/tests/roots/test-intl/index.txt +++ b/tests/roots/test-intl/index.txt @@ -32,6 +32,8 @@ CONTENTS translation_progress topic markup + backslashes + refs_reordered .. toctree:: :maxdepth: 2 diff --git a/tests/roots/test-intl/refs_inconsistency.txt b/tests/roots/test-intl/refs_inconsistency.txt index 48405975be4..77ff49eb284 100644 --- a/tests/roots/test-intl/refs_inconsistency.txt +++ b/tests/roots/test-intl/refs_inconsistency.txt @@ -6,8 +6,12 @@ i18n with refs inconsistency * [100]_ for [#]_ citation [ref2]_. * for reference_. * normal text. +* we ignore the [order]_ of the [refs]_ in [translations]_. .. [#] This is a auto numbered footnote. .. [ref2] This is a citation. .. [100] This is a numbered footnote. .. _reference: https://www.example.com +.. [order] order +.. [refs] references +.. [translations] translations diff --git a/tests/roots/test-intl/refs_reordered.txt b/tests/roots/test-intl/refs_reordered.txt new file mode 100644 index 00000000000..f5dd37fdfe3 --- /dev/null +++ b/tests/roots/test-intl/refs_reordered.txt @@ -0,0 +1,16 @@ +:tocdepth: 2 + +i18n with reordered and translated references +============================================== + +.. glossary:: + + term one + First glossary term + + term two + Second glossary term + +1. Multiple refs reordered: :term:`term one` and :term:`term two`. + +2. Single ref with translated display text: :term:`term one`. diff --git a/tests/roots/test-intl/versionchange.txt b/tests/roots/test-intl/versionchange.txt index 764534246c0..69b9ada1858 100644 --- a/tests/roots/test-intl/versionchange.txt +++ b/tests/roots/test-intl/versionchange.txt @@ -3,16 +3,16 @@ i18n with versionchange ============================ -.. deprecated:: 1.0 - This is the *first* paragraph of deprecated. +.. version-deprecated:: 1.0 + This is the *first* paragraph of version-deprecated. - This is the *second* paragraph of deprecated. + This is the *second* paragraph of version-deprecated. -.. versionadded:: 1.0 - This is the *first* paragraph of versionadded. +.. version-added:: 1.0 + This is the *first* paragraph of version-added. -.. versionchanged:: 1.0 +.. version-changed:: 1.0 - This is the *first* paragraph of versionchanged. + This is the *first* paragraph of version-changed. -.. versionremoved:: 1.0 This is the *first* paragraph of versionremoved. +.. version-removed:: 1.0 This is the *first* paragraph of version-removed. diff --git a/tests/roots/test-intl/xx/LC_MESSAGES/refs_inconsistency.po b/tests/roots/test-intl/xx/LC_MESSAGES/refs_inconsistency.po index 9d8d13f612c..fa91facb71b 100644 --- a/tests/roots/test-intl/xx/LC_MESSAGES/refs_inconsistency.po +++ b/tests/roots/test-intl/xx/LC_MESSAGES/refs_inconsistency.po @@ -28,6 +28,9 @@ msgstr "reference_ FOR reference_." msgid "normal text." msgstr "ORPHAN REFERENCE: `I18N WITH REFS INCONSISTENCY`_." +msgid "we ignore the [order]_ of the [refs]_ in [translations]_." +msgstr "the [refs]_ [translations]_ [order]_ is ignored." + msgid "This is a auto numbered footnote." msgstr "THIS IS A AUTO NUMBERED FOOTNOTE." @@ -36,4 +39,3 @@ msgstr "THIS IS A CITATION." msgid "This is a numbered footnote." msgstr "THIS IS A NUMBERED FOOTNOTE." - diff --git a/tests/roots/test-intl/xx/LC_MESSAGES/refs_reordered.po b/tests/roots/test-intl/xx/LC_MESSAGES/refs_reordered.po new file mode 100644 index 00000000000..4391b8fdb31 --- /dev/null +++ b/tests/roots/test-intl/xx/LC_MESSAGES/refs_reordered.po @@ -0,0 +1,31 @@ +# Test for reordered and translated references. +# These should NOT trigger inconsistency warnings. +# +msgid "" +msgstr "" +"Project-Id-Version: sphinx 1.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-01-01 00:00+0000\n" +"PO-Revision-Date: 2024-01-01 00:00+0000\n" +"Last-Translator: Test\n" +"Language-Team: xx\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +msgid "i18n with reordered and translated references" +msgstr "I18N WITH REORDERED AND TRANSLATED REFERENCES" + +msgid "First glossary term" +msgstr "FIRST GLOSSARY TERM" + +msgid "Second glossary term" +msgstr "SECOND GLOSSARY TERM" + +# Reordered references - should NOT warn because targets are the same +msgid "Multiple refs reordered: :term:`term one` and :term:`term two`." +msgstr "MULTIPLE REFS REORDERED: :term:`term two` AND :term:`term one`." + +# Translated display text - should NOT warn because reftarget is the same +msgid "Single ref with translated display text: :term:`term one`." +msgstr "SINGLE REF WITH TRANSLATED DISPLAY TEXT: :term:`TRANSLATED TERM ONE `." diff --git a/tests/roots/test-intl/xx/LC_MESSAGES/versionchange.po b/tests/roots/test-intl/xx/LC_MESSAGES/versionchange.po index b1d786580f0..8f1b88bcaca 100644 --- a/tests/roots/test-intl/xx/LC_MESSAGES/versionchange.po +++ b/tests/roots/test-intl/xx/LC_MESSAGES/versionchange.po @@ -19,12 +19,24 @@ msgstr "" msgid "i18n with versionchange" msgstr "I18N WITH VERSIONCHANGE" +msgid "This is the *first* paragraph of version-deprecated." +msgstr "THIS IS THE *FIRST* PARAGRAPH OF VERSION-DEPRECATED." + +msgid "This is the *second* paragraph of version-deprecated." +msgstr "THIS IS THE *SECOND* PARAGRAPH OF VERSION-DEPRECATED." + +msgid "This is the *first* paragraph of version-added." +msgstr "THIS IS THE *FIRST* PARAGRAPH OF VERSION-ADDED." + +msgid "This is the *first* paragraph of version-changed." +msgstr "THIS IS THE *FIRST* PARAGRAPH OF VERSION-CHANGED." + +msgid "This is the *first* paragraph of version-removed." +msgstr "THIS IS THE *FIRST* PARAGRAPH OF VERSION-REMOVED." + msgid "This is the *first* paragraph of deprecated." msgstr "THIS IS THE *FIRST* PARAGRAPH OF DEPRECATED." -msgid "This is the *second* paragraph of deprecated." -msgstr "THIS IS THE *SECOND* PARAGRAPH OF DEPRECATED." - msgid "This is the *first* paragraph of versionadded." msgstr "THIS IS THE *FIRST* PARAGRAPH OF VERSIONADDED." diff --git a/tests/roots/test-latex-images-css3-lengths/conf.py b/tests/roots/test-latex-images-css3-lengths/conf.py new file mode 100644 index 00000000000..e69de29bb2d diff --git a/tests/roots/test-latex-images-css3-lengths/img.png b/tests/roots/test-latex-images-css3-lengths/img.png new file mode 100644 index 00000000000..a97e86d66af Binary files /dev/null and b/tests/roots/test-latex-images-css3-lengths/img.png differ diff --git a/tests/roots/test-latex-images-css3-lengths/index.rst b/tests/roots/test-latex-images-css3-lengths/index.rst new file mode 100644 index 00000000000..52255262b1c --- /dev/null +++ b/tests/roots/test-latex-images-css3-lengths/index.rst @@ -0,0 +1,25 @@ +============= + TEST IMAGES +============= + +test-latex-images-css3-lengths +============================== + +.. image:: img.png + :width: 10.03ch + :height: 9.97rem + +.. image:: img.png + :width: 60vw + :height: 10vh + +.. image:: img.png + :width: 10.5vmin + :height: 10.5vmax + +.. image:: img.png + :width: 195.345Q + +.. image:: img.png + :width: 195.345Q + :scale: 50% diff --git a/tests/roots/test-latex-labels/index.rst b/tests/roots/test-latex-labels/index.rst index 0021d5d4215..4abf72e2e03 100644 --- a/tests/roots/test-latex-labels/index.rst +++ b/tests/roots/test-latex-labels/index.rst @@ -69,6 +69,6 @@ subsubsection otherdoc -* Embedded standalone hyperlink reference: `subsection `_. +* Named hyperlink reference with embedded alias reference: `subsection `_. .. See: https://github.com/sphinx-doc/sphinx/issues/5948 diff --git a/tests/roots/test-latex-table/complex.rst b/tests/roots/test-latex-table/complex.rst index d648ff194c4..d35927a96e0 100644 --- a/tests/roots/test-latex-table/complex.rst +++ b/tests/roots/test-latex-table/complex.rst @@ -20,8 +20,8 @@ grid table | cell5-1 | +---------+---------+---------+ -grid table with tabularcolumns having no vline ----------------------------------------------- +grid table with tabularcolumns +------------------------------ .. tabularcolumns:: TTT diff --git a/tests/roots/test-latex-table/expects/complex_spanning_cell.tex b/tests/roots/test-latex-table/expects/complex_spanning_cell.tex index d2d61894251..645d84b30b9 100644 --- a/tests/roots/test-latex-table/expects/complex_spanning_cell.tex +++ b/tests/roots/test-latex-table/expects/complex_spanning_cell.tex @@ -23,45 +23,49 @@ \begin{varwidth}[t]{\sphinxcolwidth{1}{5}} \sphinxAtStartPar cell1\sphinxhyphen{}1 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% &\sphinxmultirow{3}{2}{% \begin{varwidth}[t]{\sphinxcolwidth{1}{5}} \sphinxAtStartPar cell1\sphinxhyphen{}2 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% -& +&\begin{varwidth}[t]{\sphinxcolwidth{1}{5}} \sphinxAtStartPar cell1\sphinxhyphen{}3 +\sphinxbeforeendvarwidth +\end{varwidth}% &\sphinxmultirow{3}{4}{% \begin{varwidth}[t]{\sphinxcolwidth{1}{5}} \sphinxAtStartPar cell1\sphinxhyphen{}4 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% &\sphinxmultirow{2}{5}{% \begin{varwidth}[t]{\sphinxcolwidth{1}{5}} \sphinxAtStartPar cell1\sphinxhyphen{}5 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% \\ \sphinxvlinecrossing{1}\sphinxcline{3-3}\sphinxvlinecrossing{4}\sphinxfixclines{5}\sphinxtablestrut{1}&\sphinxtablestrut{2}&\sphinxmultirow{2}{6}{% \begin{varwidth}[t]{\sphinxcolwidth{1}{5}} \sphinxAtStartPar cell2\sphinxhyphen{}3 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% &\sphinxtablestrut{4}&\sphinxtablestrut{5}\\ -\sphinxvlinecrossing{1}\sphinxvlinecrossing{2}\sphinxvlinecrossing{3}\sphinxcline{5-5}\sphinxfixclines{5}\sphinxtablestrut{1}&\sphinxtablestrut{2}&\sphinxtablestrut{6}&\sphinxtablestrut{4}& +\sphinxvlinecrossing{1}\sphinxvlinecrossing{2}\sphinxvlinecrossing{3}\sphinxcline{5-5}\sphinxfixclines{5}\sphinxtablestrut{1}&\sphinxtablestrut{2}&\sphinxtablestrut{6}&\sphinxtablestrut{4}&\begin{varwidth}[t]{\sphinxcolwidth{1}{5}} \sphinxAtStartPar cell3\sphinxhyphen{}5 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{tabulary} diff --git a/tests/roots/test-latex-table/expects/gridtable.tex b/tests/roots/test-latex-table/expects/grid_table.tex similarity index 55% rename from tests/roots/test-latex-table/expects/gridtable.tex rename to tests/roots/test-latex-table/expects/grid_table.tex index 407abe7f2c8..e5b3a6bda31 100644 --- a/tests/roots/test-latex-table/expects/gridtable.tex +++ b/tests/roots/test-latex-table/expects/grid_table.tex @@ -6,41 +6,53 @@ \centering \begin{tabulary}{\linewidth}[t]{|T|T|T|} \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar header3 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule -\sphinxtableatstartofbodyhook +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell1\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% &\sphinxmultirow{2}{5}{% \begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell1\sphinxhyphen{}2 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% -& +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell1\sphinxhyphen{}3 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxcline{1-1}\sphinxcline{3-3}\sphinxfixclines{3}\sphinxmultirow{2}{7}{% \begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% -&\sphinxtablestrut{5}& +&\sphinxtablestrut{5}&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell2\sphinxhyphen{}3 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxcline{2-3}\sphinxfixclines{3}\sphinxtablestrut{7}&\sphinxstartmulticolumn{2}% \sphinxmultirow{2}{9}{% @@ -50,24 +62,26 @@ \sphinxAtStartPar cell3\sphinxhyphen{}2\sphinxhyphen{}par2 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% \sphinxstopmulticolumn \\ -\sphinxcline{1-1}\sphinxfixclines{3} +\sphinxcline{1-1}\sphinxfixclines{3}\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell4\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% &\multicolumn{2}{l|}{\sphinxtablestrut{9}}\\ \sphinxhline\sphinxstartmulticolumn{3}% \begin{varwidth}[t]{\sphinxcolwidth{3}{3}} \sphinxAtStartPar cell5\sphinxhyphen{}1 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% \sphinxstopmulticolumn \\ \sphinxbottomrule \end{tabulary} \sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/gridtable_with_tabularcolumn.tex b/tests/roots/test-latex-table/expects/grid_table_with_tabularcolumns.tex similarity index 53% rename from tests/roots/test-latex-table/expects/gridtable_with_tabularcolumn.tex rename to tests/roots/test-latex-table/expects/grid_table_with_tabularcolumns.tex index c77b99041ff..1fb5bf3f34e 100644 --- a/tests/roots/test-latex-table/expects/gridtable_with_tabularcolumn.tex +++ b/tests/roots/test-latex-table/expects/grid_table_with_tabularcolumns.tex @@ -1,4 +1,4 @@ -\label{\detokenize{complex:grid-table-with-tabularcolumns-having-no-vline}} +\label{\detokenize{complex:grid-table-with-tabularcolumns}} \begin{savenotes}\sphinxattablestart \sphinxthistablewithglobalstyle @@ -6,41 +6,53 @@ \centering \begin{tabulary}{\linewidth}[t]{TTT} \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar header3 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule -\sphinxtableatstartofbodyhook +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell1\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% &\sphinxmultirow{2}{5}{% \begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell1\sphinxhyphen{}2 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% -& +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell1\sphinxhyphen{}3 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxcline{1-1}\sphinxcline{3-3}\sphinxfixclines{3}\sphinxmultirow{2}{7}{% \begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% -&\sphinxtablestrut{5}& +&\sphinxtablestrut{5}&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell2\sphinxhyphen{}3 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxcline{2-3}\sphinxfixclines{3}\sphinxtablestrut{7}&\sphinxstartmulticolumn{2}% \sphinxmultirow{2}{9}{% @@ -50,24 +62,26 @@ \sphinxAtStartPar cell3\sphinxhyphen{}2\sphinxhyphen{}par2 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% }% \sphinxstopmulticolumn \\ -\sphinxcline{1-1}\sphinxfixclines{3} +\sphinxcline{1-1}\sphinxfixclines{3}\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} \sphinxAtStartPar cell4\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% &\multicolumn{2}{l}{\sphinxtablestrut{9}}\\ \sphinxhline\sphinxstartmulticolumn{3}% \begin{varwidth}[t]{\sphinxcolwidth{3}{3}} \sphinxAtStartPar cell5\sphinxhyphen{}1 -\par -\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}% +\sphinxbeforeendvarwidth +\end{varwidth}% \sphinxstopmulticolumn \\ \sphinxbottomrule \end{tabulary} \sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/longtable.tex b/tests/roots/test-latex-table/expects/longtable.tex index 1fe1022b7d5..518b2cc0196 100644 --- a/tests/roots/test-latex-table/expects/longtable.tex +++ b/tests/roots/test-latex-table/expects/longtable.tex @@ -10,12 +10,16 @@ \makeatother \begin{longtable}{ll} \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule \endfirsthead @@ -24,12 +28,16 @@ \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% }\\ \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule \endhead @@ -42,29 +50,41 @@ \endlastfoot \sphinxtableatstartofbodyhook - +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{longtable} \sphinxtableafterendhook \sphinxatlongtableend -\end{savenotes} +\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/longtable_having_align.tex b/tests/roots/test-latex-table/expects/longtable_having_align_option.tex similarity index 50% rename from tests/roots/test-latex-table/expects/longtable_having_align.tex rename to tests/roots/test-latex-table/expects/longtable_having_align_option.tex index 4a4df1824e7..90f975bf21c 100644 --- a/tests/roots/test-latex-table/expects/longtable_having_align.tex +++ b/tests/roots/test-latex-table/expects/longtable_having_align_option.tex @@ -9,12 +9,16 @@ \makeatother \begin{longtable}{|l|l|} \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule \endfirsthead @@ -23,12 +27,16 @@ \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% }\\ \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule \endhead @@ -41,29 +49,41 @@ \endlastfoot \sphinxtableatstartofbodyhook - +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{longtable} \sphinxtableafterendhook \sphinxatlongtableend -\end{savenotes} +\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/longtable_having_caption.tex b/tests/roots/test-latex-table/expects/longtable_having_caption.tex index a1aa65d7a8b..17617ab5929 100644 --- a/tests/roots/test-latex-table/expects/longtable_having_caption.tex +++ b/tests/roots/test-latex-table/expects/longtable_having_caption.tex @@ -11,12 +11,16 @@ \sphinxthelongtablecaptionisattop \caption{caption for longtable\strut}\label{\detokenize{longtable:id1}}\\*[\sphinxlongtablecapskipadjust] \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule \endfirsthead @@ -25,12 +29,16 @@ \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% }\\ \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule \endhead @@ -43,29 +51,41 @@ \endlastfoot \sphinxtableatstartofbodyhook - +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{longtable} \sphinxtableafterendhook \sphinxatlongtableend -\end{savenotes} +\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/longtable_having_formerly_problematic.tex b/tests/roots/test-latex-table/expects/longtable_having_formerly_problematic.tex new file mode 100644 index 00000000000..2298fbc7a1d --- /dev/null +++ b/tests/roots/test-latex-table/expects/longtable_having_formerly_problematic.tex @@ -0,0 +1,97 @@ +\label{\detokenize{longtable:longtable-having-formerly-problematic}} + +\begin{savenotes} +\sphinxatlongtablestart +\sphinxthistablewithglobalstyle +\makeatletter + \LTleft \@totalleftmargin plus1fill + \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill +\makeatother +\begin{longtable}{|l|l|} +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\endfirsthead + +\multicolumn{2}{c}{\sphinxnorowcolor + \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% +}\\ +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\endhead + +\sphinxbottomrule +\multicolumn{2}{r}{\sphinxnorowcolor + \makebox[0pt][r]{\sphinxtablecontinued{continues on next page}}% +}\\ +\endfoot + +\endlastfoot +\sphinxtableatstartofbodyhook +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\begin{itemize} +\item {} +\sphinxAtStartPar +item1 + +\item {} +\sphinxAtStartPar +item2 + +\end{itemize} +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxbottomrule +\end{longtable} +\sphinxtableafterendhook +\sphinxatlongtableend +\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/longtable_having_problematic_cell.tex b/tests/roots/test-latex-table/expects/longtable_having_problematic_cell.tex deleted file mode 100644 index 240a7609384..00000000000 --- a/tests/roots/test-latex-table/expects/longtable_having_problematic_cell.tex +++ /dev/null @@ -1,76 +0,0 @@ -\label{\detokenize{longtable:longtable-having-problematic-cell}} - -\begin{savenotes} -\sphinxatlongtablestart -\sphinxthistablewithglobalstyle -\makeatletter - \LTleft \@totalleftmargin plus1fill - \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill -\makeatother -\begin{longtable}{|*{2}{\X{1}{2}|}} -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\endfirsthead - -\multicolumn{2}{c}{\sphinxnorowcolor - \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% -}\\ -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\endhead - -\sphinxbottomrule -\multicolumn{2}{r}{\sphinxnorowcolor - \makebox[0pt][r]{\sphinxtablecontinued{continues on next page}}% -}\\ -\endfoot - -\endlastfoot -\sphinxtableatstartofbodyhook -\begin{itemize} -\item {} -\sphinxAtStartPar -item1 - -\item {} -\sphinxAtStartPar -item2 - -\end{itemize} -& -\sphinxAtStartPar -cell1\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell2\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell2\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell3\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell3\sphinxhyphen{}2 -\\ -\sphinxbottomrule -\end{longtable} -\sphinxtableafterendhook -\sphinxatlongtableend -\end{savenotes} diff --git a/tests/roots/test-latex-table/expects/longtable_having_stub_columns_and_formerly_problematic.tex b/tests/roots/test-latex-table/expects/longtable_having_stub_columns_and_formerly_problematic.tex new file mode 100644 index 00000000000..8a95833e326 --- /dev/null +++ b/tests/roots/test-latex-table/expects/longtable_having_stub_columns_and_formerly_problematic.tex @@ -0,0 +1,106 @@ +\label{\detokenize{longtable:longtable-having-stub-columns-and-formerly-problematic}} + +\begin{savenotes} +\sphinxatlongtablestart +\sphinxthistablewithglobalstyle +\makeatletter + \LTleft \@totalleftmargin plus1fill + \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill +\makeatother +\begin{longtable}{|l|l|l|} +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +header3 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\endfirsthead + +\multicolumn{3}{c}{\sphinxnorowcolor + \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% +}\\ +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +header3 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\endhead + +\sphinxbottomrule +\multicolumn{3}{r}{\sphinxnorowcolor + \makebox[0pt][r]{\sphinxtablecontinued{continues on next page}}% +}\\ +\endfoot + +\endlastfoot +\sphinxtableatstartofbodyhook +\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \begin{itemize} +\item {} +\sphinxAtStartPar +instub1\sphinxhyphen{}1a + +\item {} +\sphinxAtStartPar +instub1\sphinxhyphen{}1b + +\end{itemize} +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +instub1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxAtStartPar +notinstub1\sphinxhyphen{}3 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +cell2\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxAtStartPar +cell2\sphinxhyphen{}3 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxbottomrule +\end{longtable} +\sphinxtableafterendhook +\sphinxatlongtableend +\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/longtable_having_stub_columns_and_problematic_cell.tex b/tests/roots/test-latex-table/expects/longtable_having_stub_columns_and_problematic_cell.tex deleted file mode 100644 index 897830b1c02..00000000000 --- a/tests/roots/test-latex-table/expects/longtable_having_stub_columns_and_problematic_cell.tex +++ /dev/null @@ -1,81 +0,0 @@ -\label{\detokenize{longtable:longtable-having-both-stub-columns-and-problematic-cell}} - -\begin{savenotes} -\sphinxatlongtablestart -\sphinxthistablewithglobalstyle -\makeatletter - \LTleft \@totalleftmargin plus1fill - \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill -\makeatother -\begin{longtable}{|*{3}{\X{1}{3}|}} -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header3 -\\ -\sphinxmidrule -\endfirsthead - -\multicolumn{3}{c}{\sphinxnorowcolor - \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% -}\\ -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header3 -\\ -\sphinxmidrule -\endhead - -\sphinxbottomrule -\multicolumn{3}{r}{\sphinxnorowcolor - \makebox[0pt][r]{\sphinxtablecontinued{continues on next page}}% -}\\ -\endfoot - -\endlastfoot -\sphinxtableatstartofbodyhook -\sphinxstyletheadfamily \begin{itemize} -\item {} -\sphinxAtStartPar -instub1\sphinxhyphen{}1a - -\item {} -\sphinxAtStartPar -instub1\sphinxhyphen{}1b - -\end{itemize} -&\sphinxstyletheadfamily -\sphinxAtStartPar -instub1\sphinxhyphen{}2 -& -\sphinxAtStartPar -notinstub1\sphinxhyphen{}3 -\\ -\sphinxhline\sphinxstyletheadfamily -\sphinxAtStartPar -cell2\sphinxhyphen{}1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -cell2\sphinxhyphen{}2 -& -\sphinxAtStartPar -cell2\sphinxhyphen{}3 -\\ -\sphinxbottomrule -\end{longtable} -\sphinxtableafterendhook -\sphinxatlongtableend -\end{savenotes} diff --git a/tests/roots/test-latex-table/expects/longtable_having_verbatim.tex b/tests/roots/test-latex-table/expects/longtable_having_verbatim.tex index b9f75129c68..d7a86633d75 100644 --- a/tests/roots/test-latex-table/expects/longtable_having_verbatim.tex +++ b/tests/roots/test-latex-table/expects/longtable_having_verbatim.tex @@ -9,12 +9,16 @@ \makeatother \begin{longtable}{|*{2}{\X{1}{2}|}} \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule \endfirsthead @@ -23,12 +27,16 @@ \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% }\\ \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule \endhead @@ -41,30 +49,43 @@ \endlastfoot \sphinxtableatstartofbodyhook +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \begin{sphinxVerbatimintable}[commandchars=\\\{\}] \PYG{n}{hello} \PYG{n}{world} \end{sphinxVerbatimintable} -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{longtable} \sphinxtableafterendhook \sphinxatlongtableend -\end{savenotes} +\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/longtable_having_widths_and_formerly_problematic.tex b/tests/roots/test-latex-table/expects/longtable_having_widths_and_formerly_problematic.tex new file mode 100644 index 00000000000..fb9f39f5f30 --- /dev/null +++ b/tests/roots/test-latex-table/expects/longtable_having_widths_and_formerly_problematic.tex @@ -0,0 +1,97 @@ +\label{\detokenize{longtable:longtable-having-widths-and-formerly-problematic}} + +\begin{savenotes} +\sphinxatlongtablestart +\sphinxthistablewithglobalstyle +\makeatletter + \LTleft \@totalleftmargin plus1fill + \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill +\makeatother +\begin{longtable}{|\X{30}{100}|\X{70}{100}|} +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\endfirsthead + +\multicolumn{2}{c}{\sphinxnorowcolor + \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% +}\\ +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\endhead + +\sphinxbottomrule +\multicolumn{2}{r}{\sphinxnorowcolor + \makebox[0pt][r]{\sphinxtablecontinued{continues on next page}}% +}\\ +\endfoot + +\endlastfoot +\sphinxtableatstartofbodyhook +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\begin{itemize} +\item {} +\sphinxAtStartPar +item1 + +\item {} +\sphinxAtStartPar +item2 + +\end{itemize} +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxbottomrule +\end{longtable} +\sphinxtableafterendhook +\sphinxatlongtableend +\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/longtable_having_widths_and_problematic_cell.tex b/tests/roots/test-latex-table/expects/longtable_having_widths_and_problematic_cell.tex deleted file mode 100644 index b4758caa08e..00000000000 --- a/tests/roots/test-latex-table/expects/longtable_having_widths_and_problematic_cell.tex +++ /dev/null @@ -1,76 +0,0 @@ -\label{\detokenize{longtable:longtable-having-both-widths-and-problematic-cell}} - -\begin{savenotes} -\sphinxatlongtablestart -\sphinxthistablewithglobalstyle -\makeatletter - \LTleft \@totalleftmargin plus1fill - \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill -\makeatother -\begin{longtable}{|\X{30}{100}|\X{70}{100}|} -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\endfirsthead - -\multicolumn{2}{c}{\sphinxnorowcolor - \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% -}\\ -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\endhead - -\sphinxbottomrule -\multicolumn{2}{r}{\sphinxnorowcolor - \makebox[0pt][r]{\sphinxtablecontinued{continues on next page}}% -}\\ -\endfoot - -\endlastfoot -\sphinxtableatstartofbodyhook -\begin{itemize} -\item {} -\sphinxAtStartPar -item1 - -\item {} -\sphinxAtStartPar -item2 - -\end{itemize} -& -\sphinxAtStartPar -cell1\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell2\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell2\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell3\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell3\sphinxhyphen{}2 -\\ -\sphinxbottomrule -\end{longtable} -\sphinxtableafterendhook -\sphinxatlongtableend -\end{savenotes} diff --git a/tests/roots/test-latex-table/expects/longtable_having_widths.tex b/tests/roots/test-latex-table/expects/longtable_having_widths_option.tex similarity index 58% rename from tests/roots/test-latex-table/expects/longtable_having_widths.tex rename to tests/roots/test-latex-table/expects/longtable_having_widths_option.tex index bcad23be4f0..d09b56d6900 100644 --- a/tests/roots/test-latex-table/expects/longtable_having_widths.tex +++ b/tests/roots/test-latex-table/expects/longtable_having_widths_option.tex @@ -10,12 +10,16 @@ \begin{longtable}{|\X{30}{100}|\X{70}{100}|} \noalign{\phantomsection\label{\detokenize{longtable:namedlongtable}}\label{\detokenize{longtable:mylongtable}}}% \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule \endfirsthead @@ -24,12 +28,16 @@ \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% }\\ \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule \endhead @@ -42,26 +50,38 @@ \endlastfoot \sphinxtableatstartofbodyhook - +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{longtable} @@ -70,4 +90,4 @@ \end{savenotes} \sphinxAtStartPar -See {\hyperref[\detokenize{longtable:mylongtable}]{\sphinxcrossref{mylongtable}}}, same as {\hyperref[\detokenize{longtable:namedlongtable}]{\sphinxcrossref{\DUrole{std}{\DUrole{std-ref}{this one}}}}}. +See {\hyperref[\detokenize{longtable:mylongtable}]{\sphinxcrossref{mylongtable}}}, same as {\hyperref[\detokenize{longtable:namedlongtable}]{\sphinxcrossref{\DUrole{std}{\DUrole{std-ref}{this one}}}}}. \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/longtable_with_tabularcolumn.tex b/tests/roots/test-latex-table/expects/longtable_with_tabularcolumn.tex deleted file mode 100644 index 4c380fed7a4..00000000000 --- a/tests/roots/test-latex-table/expects/longtable_with_tabularcolumn.tex +++ /dev/null @@ -1,70 +0,0 @@ -\label{\detokenize{longtable:longtable-with-tabularcolumn}} - -\begin{savenotes} -\sphinxatlongtablestart -\sphinxthistablewithglobalstyle -\sphinxthistablewithvlinesstyle -\makeatletter - \LTleft \@totalleftmargin plus1fill - \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill -\makeatother -\begin{longtable}{|c|c|} -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\endfirsthead - -\multicolumn{2}{c}{\sphinxnorowcolor - \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% -}\\ -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\endhead - -\sphinxbottomrule -\multicolumn{2}{r}{\sphinxnorowcolor - \makebox[0pt][r]{\sphinxtablecontinued{continues on next page}}% -}\\ -\endfoot - -\endlastfoot -\sphinxtableatstartofbodyhook - -\sphinxAtStartPar -cell1\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell1\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell2\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell2\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell3\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell3\sphinxhyphen{}2 -\\ -\sphinxbottomrule -\end{longtable} -\sphinxtableafterendhook -\sphinxatlongtableend -\end{savenotes} diff --git a/tests/roots/test-latex-table/expects/longtable_with_tabularcolumns.tex b/tests/roots/test-latex-table/expects/longtable_with_tabularcolumns.tex new file mode 100644 index 00000000000..764dfd8ff9b --- /dev/null +++ b/tests/roots/test-latex-table/expects/longtable_with_tabularcolumns.tex @@ -0,0 +1,90 @@ +\label{\detokenize{longtable:longtable-with-tabularcolumns}} + +\begin{savenotes} +\sphinxatlongtablestart +\sphinxthistablewithglobalstyle +\sphinxthistablewithvlinesstyle +\makeatletter + \LTleft \@totalleftmargin plus1fill + \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill +\makeatother +\begin{longtable}{|c|c|} +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\endfirsthead + +\multicolumn{2}{c}{\sphinxnorowcolor + \makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}% +}\\ +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\endhead + +\sphinxbottomrule +\multicolumn{2}{r}{\sphinxnorowcolor + \makebox[0pt][r]{\sphinxtablecontinued{continues on next page}}% +}\\ +\endfoot + +\endlastfoot +\sphinxtableatstartofbodyhook +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxbottomrule +\end{longtable} +\sphinxtableafterendhook +\sphinxatlongtableend +\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/simple_table.tex b/tests/roots/test-latex-table/expects/simple_table.tex index 7bd85c737b2..8a17635fe64 100644 --- a/tests/roots/test-latex-table/expects/simple_table.tex +++ b/tests/roots/test-latex-table/expects/simple_table.tex @@ -5,36 +5,52 @@ \centering \begin{tabulary}{\linewidth}[t]{|T|T|} \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule -\sphinxtableatstartofbodyhook +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{tabulary} \sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/table_having_caption.tex b/tests/roots/test-latex-table/expects/table_having_caption.tex index f2ce5536021..450d370e1ba 100644 --- a/tests/roots/test-latex-table/expects/table_having_caption.tex +++ b/tests/roots/test-latex-table/expects/table_having_caption.tex @@ -9,36 +9,52 @@ \sphinxaftertopcaption \begin{tabulary}{\linewidth}[t]{|T|T|} \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule -\sphinxtableatstartofbodyhook +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{tabulary} \sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/table_having_formerly_problematic.tex b/tests/roots/test-latex-table/expects/table_having_formerly_problematic.tex new file mode 100644 index 00000000000..fb882fea57f --- /dev/null +++ b/tests/roots/test-latex-table/expects/table_having_formerly_problematic.tex @@ -0,0 +1,64 @@ +\label{\detokenize{tabular:table-having-formerly-problematic}} + +\begin{savenotes}\sphinxattablestart +\sphinxthistablewithglobalstyle +\centering +\begin{tabulary}{\linewidth}[t]{|T|T|} +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\begin{itemize} +\item {} +\sphinxAtStartPar +item1 + +\item {} +\sphinxAtStartPar +item2 + +\end{itemize} +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxbottomrule +\end{tabulary} +\sphinxtableafterendhook\par +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/table_having_problematic_cell.tex b/tests/roots/test-latex-table/expects/table_having_problematic_cell.tex deleted file mode 100644 index 7d7ad4b715b..00000000000 --- a/tests/roots/test-latex-table/expects/table_having_problematic_cell.tex +++ /dev/null @@ -1,47 +0,0 @@ -\label{\detokenize{tabular:table-having-problematic-cell}} - -\begin{savenotes}\sphinxattablestart -\sphinxthistablewithglobalstyle -\centering -\begin{tabular}[t]{|*{2}{\X{1}{2}|}} -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\sphinxtableatstartofbodyhook\begin{itemize} -\item {} -\sphinxAtStartPar -item1 - -\item {} -\sphinxAtStartPar -item2 - -\end{itemize} -& -\sphinxAtStartPar -cell1\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell2\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell2\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell3\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell3\sphinxhyphen{}2 -\\ -\sphinxbottomrule -\end{tabular} -\sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} diff --git a/tests/roots/test-latex-table/expects/table_having_stub_columns_and_formerly_problematic.tex b/tests/roots/test-latex-table/expects/table_having_stub_columns_and_formerly_problematic.tex new file mode 100644 index 00000000000..548008a2379 --- /dev/null +++ b/tests/roots/test-latex-table/expects/table_having_stub_columns_and_formerly_problematic.tex @@ -0,0 +1,68 @@ +\label{\detokenize{tabular:table-having-stub-columns-and-formerly-problematic}} + +\begin{savenotes}\sphinxattablestart +\sphinxthistablewithglobalstyle +\centering +\begin{tabulary}{\linewidth}[t]{|T|T|T|} +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +header3 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \begin{itemize} +\item {} +\sphinxAtStartPar +instub1\sphinxhyphen{}1a + +\item {} +\sphinxAtStartPar +instub1\sphinxhyphen{}1b + +\end{itemize} +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +instub1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxAtStartPar +notinstub1\sphinxhyphen{}3 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +cell2\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxstyletheadfamily \sphinxAtStartPar +cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{3}} +\sphinxAtStartPar +cell2\sphinxhyphen{}3 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxbottomrule +\end{tabulary} +\sphinxtableafterendhook\par +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/table_having_stub_columns_and_problematic_cell.tex b/tests/roots/test-latex-table/expects/table_having_stub_columns_and_problematic_cell.tex deleted file mode 100644 index fbd797a1bd3..00000000000 --- a/tests/roots/test-latex-table/expects/table_having_stub_columns_and_problematic_cell.tex +++ /dev/null @@ -1,49 +0,0 @@ -\label{\detokenize{tabular:table-having-both-stub-columns-and-problematic-cell}} - -\begin{savenotes}\sphinxattablestart -\sphinxthistablewithglobalstyle -\centering -\begin{tabular}[t]{|*{3}{\X{1}{3}|}} -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header3 -\\ -\sphinxmidrule -\sphinxtableatstartofbodyhook\sphinxstyletheadfamily \begin{itemize} -\item {} -\sphinxAtStartPar -instub1\sphinxhyphen{}1a - -\item {} -\sphinxAtStartPar -instub1\sphinxhyphen{}1b - -\end{itemize} -&\sphinxstyletheadfamily -\sphinxAtStartPar -instub1\sphinxhyphen{}2 -& -\sphinxAtStartPar -notinstub1\sphinxhyphen{}3 -\\ -\sphinxhline\sphinxstyletheadfamily -\sphinxAtStartPar -cell2\sphinxhyphen{}1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -cell2\sphinxhyphen{}2 -& -\sphinxAtStartPar -cell2\sphinxhyphen{}3 -\\ -\sphinxbottomrule -\end{tabular} -\sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} diff --git a/tests/roots/test-latex-table/expects/table_having_threeparagraphs_cell_in_first_col.tex b/tests/roots/test-latex-table/expects/table_having_three_paragraphs_cell_in_first_col.tex similarity index 53% rename from tests/roots/test-latex-table/expects/table_having_threeparagraphs_cell_in_first_col.tex rename to tests/roots/test-latex-table/expects/table_having_three_paragraphs_cell_in_first_col.tex index 9acd9a86d46..ad1d9ee79b7 100644 --- a/tests/roots/test-latex-table/expects/table_having_threeparagraphs_cell_in_first_col.tex +++ b/tests/roots/test-latex-table/expects/table_having_three_paragraphs_cell_in_first_col.tex @@ -1,16 +1,18 @@ -\label{\detokenize{tabular:table-with-cell-in-first-column-having-three-paragraphs}} +\label{\detokenize{tabular:table-having-three-paragraphs-cell-in-first-col}} \begin{savenotes}\sphinxattablestart \sphinxthistablewithglobalstyle \centering \begin{tabulary}{\linewidth}[t]{|T|} \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{1}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule -\sphinxtableatstartofbodyhook +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{1}} \sphinxAtStartPar cell1\sphinxhyphen{}1\sphinxhyphen{}par1 @@ -19,8 +21,10 @@ \sphinxAtStartPar cell1\sphinxhyphen{}1\sphinxhyphen{}par3 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{tabulary} \sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/table_having_verbatim.tex b/tests/roots/test-latex-table/expects/table_having_verbatim.tex index a002de58618..adc6baf6ceb 100644 --- a/tests/roots/test-latex-table/expects/table_having_verbatim.tex +++ b/tests/roots/test-latex-table/expects/table_having_verbatim.tex @@ -5,37 +5,54 @@ \centering \begin{tabular}[t]{|*{2}{\X{1}{2}|}} \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule -\sphinxtableatstartofbodyhook +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} + \begin{sphinxVerbatimintable}[commandchars=\\\{\}] \PYG{n}{hello} \PYG{n}{world} \end{sphinxVerbatimintable} -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{tabular} \sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/table_having_widths_and_formerly_problematic.tex b/tests/roots/test-latex-table/expects/table_having_widths_and_formerly_problematic.tex new file mode 100644 index 00000000000..c103ab0a8aa --- /dev/null +++ b/tests/roots/test-latex-table/expects/table_having_widths_and_formerly_problematic.tex @@ -0,0 +1,64 @@ +\label{\detokenize{tabular:table-having-widths-and-formerly-problematic}} + +\begin{savenotes}\sphinxattablestart +\sphinxthistablewithglobalstyle +\centering +\begin{tabular}[t]{|\X{30}{100}|\X{70}{100}|} +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\begin{itemize} +\item {} +\sphinxAtStartPar +item1 + +\item {} +\sphinxAtStartPar +item2 + +\end{itemize} +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxbottomrule +\end{tabular} +\sphinxtableafterendhook\par +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/table_having_widths_and_problematic_cell.tex b/tests/roots/test-latex-table/expects/table_having_widths_and_problematic_cell.tex deleted file mode 100644 index 1baf92c1ae6..00000000000 --- a/tests/roots/test-latex-table/expects/table_having_widths_and_problematic_cell.tex +++ /dev/null @@ -1,47 +0,0 @@ -\label{\detokenize{tabular:table-having-both-widths-and-problematic-cell}} - -\begin{savenotes}\sphinxattablestart -\sphinxthistablewithglobalstyle -\centering -\begin{tabular}[t]{|\X{30}{100}|\X{70}{100}|} -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\sphinxtableatstartofbodyhook\begin{itemize} -\item {} -\sphinxAtStartPar -item1 - -\item {} -\sphinxAtStartPar -item2 - -\end{itemize} -& -\sphinxAtStartPar -cell1\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell2\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell2\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell3\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell3\sphinxhyphen{}2 -\\ -\sphinxbottomrule -\end{tabular} -\sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} diff --git a/tests/roots/test-latex-table/expects/table_having_widths.tex b/tests/roots/test-latex-table/expects/table_having_widths_option.tex similarity index 50% rename from tests/roots/test-latex-table/expects/table_having_widths.tex rename to tests/roots/test-latex-table/expects/table_having_widths_option.tex index e9863d277f6..668f4c63206 100644 --- a/tests/roots/test-latex-table/expects/table_having_widths.tex +++ b/tests/roots/test-latex-table/expects/table_having_widths_option.tex @@ -8,34 +8,50 @@ \phantomsection\label{\detokenize{tabular:namedtabular}}\label{\detokenize{tabular:mytabular}}\nobreak \begin{tabular}[t]{\X{30}{100}\X{70}{100}} \sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar header2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxmidrule -\sphinxtableatstartofbodyhook +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ -\sphinxhline +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}1 -& +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} \sphinxAtStartPar cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% \\ \sphinxbottomrule \end{tabular} @@ -43,4 +59,4 @@ \sphinxattableend\end{savenotes} \sphinxAtStartPar -See {\hyperref[\detokenize{tabular:mytabular}]{\sphinxcrossref{\DUrole{std}{\DUrole{std-ref}{this}}}}}, same as {\hyperref[\detokenize{tabular:namedtabular}]{\sphinxcrossref{namedtabular}}}. +See {\hyperref[\detokenize{tabular:mytabular}]{\sphinxcrossref{\DUrole{std}{\DUrole{std-ref}{this}}}}}, same as {\hyperref[\detokenize{tabular:namedtabular}]{\sphinxcrossref{namedtabular}}}. \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/table_with_tabularcolumns.tex b/tests/roots/test-latex-table/expects/table_with_tabularcolumns.tex new file mode 100644 index 00000000000..64edba98e89 --- /dev/null +++ b/tests/roots/test-latex-table/expects/table_with_tabularcolumns.tex @@ -0,0 +1,57 @@ +\label{\detokenize{tabular:table-with-tabularcolumns}} + +\begin{savenotes}\sphinxattablestart +\sphinxthistablewithglobalstyle +\sphinxthistablewithnovlinesstyle +\centering +\begin{tabular}[t]{cc} +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxbottomrule +\end{tabular} +\sphinxtableafterendhook\par +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/tabular_having_align_option.tex b/tests/roots/test-latex-table/expects/tabular_having_align_option.tex new file mode 100644 index 00000000000..ba61c6bde2c --- /dev/null +++ b/tests/roots/test-latex-table/expects/tabular_having_align_option.tex @@ -0,0 +1,56 @@ +\label{\detokenize{tabular:tabular-having-align-option}} + +\begin{savenotes}\sphinxattablestart +\sphinxthistablewithglobalstyle +\raggedright +\begin{tabular}[t]{|\X{30}{100}|\X{70}{100}|} +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxbottomrule +\end{tabular} +\sphinxtableafterendhook\par +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/tabular_having_widths.tex b/tests/roots/test-latex-table/expects/tabular_having_widths.tex deleted file mode 100644 index 15321d693cf..00000000000 --- a/tests/roots/test-latex-table/expects/tabular_having_widths.tex +++ /dev/null @@ -1,40 +0,0 @@ -\label{\detokenize{tabular:table-having-align-option-tabular}} - -\begin{savenotes}\sphinxattablestart -\sphinxthistablewithglobalstyle -\raggedright -\begin{tabular}[t]{|\X{30}{100}|\X{70}{100}|} -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\sphinxtableatstartofbodyhook -\sphinxAtStartPar -cell1\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell1\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell2\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell2\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell3\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell3\sphinxhyphen{}2 -\\ -\sphinxbottomrule -\end{tabular} -\sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} diff --git a/tests/roots/test-latex-table/expects/tabularcolumn.tex b/tests/roots/test-latex-table/expects/tabularcolumn.tex deleted file mode 100644 index fcb01be3f50..00000000000 --- a/tests/roots/test-latex-table/expects/tabularcolumn.tex +++ /dev/null @@ -1,41 +0,0 @@ -\label{\detokenize{tabular:table-with-tabularcolumn}} - -\begin{savenotes}\sphinxattablestart -\sphinxthistablewithglobalstyle -\sphinxthistablewithnovlinesstyle -\centering -\begin{tabulary}{\linewidth}[t]{cc} -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\sphinxtableatstartofbodyhook -\sphinxAtStartPar -cell1\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell1\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell2\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell2\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell3\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell3\sphinxhyphen{}2 -\\ -\sphinxbottomrule -\end{tabulary} -\sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} diff --git a/tests/roots/test-latex-table/expects/tabulary_having_align_option.tex b/tests/roots/test-latex-table/expects/tabulary_having_align_option.tex new file mode 100644 index 00000000000..2d62b0e3ff1 --- /dev/null +++ b/tests/roots/test-latex-table/expects/tabulary_having_align_option.tex @@ -0,0 +1,56 @@ +\label{\detokenize{tabular:tabulary-having-align-option}} + +\begin{savenotes}\sphinxattablestart +\sphinxthistablewithglobalstyle +\raggedleft +\begin{tabulary}{\linewidth}[t]{|T|T|} +\sphinxtoprule +\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxstyletheadfamily \sphinxAtStartPar +header2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxmidrule +\sphinxtableatstartofbodyhook\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell1\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell2\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxhline\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}1 +\sphinxbeforeendvarwidth +\end{varwidth}% +&\begin{varwidth}[t]{\sphinxcolwidth{1}{2}} +\sphinxAtStartPar +cell3\sphinxhyphen{}2 +\sphinxbeforeendvarwidth +\end{varwidth}% +\\ +\sphinxbottomrule +\end{tabulary} +\sphinxtableafterendhook\par +\sphinxattableend\end{savenotes} \ No newline at end of file diff --git a/tests/roots/test-latex-table/expects/tabulary_having_widths.tex b/tests/roots/test-latex-table/expects/tabulary_having_widths.tex deleted file mode 100644 index 24634163010..00000000000 --- a/tests/roots/test-latex-table/expects/tabulary_having_widths.tex +++ /dev/null @@ -1,40 +0,0 @@ -\label{\detokenize{tabular:table-having-align-option-tabulary}} - -\begin{savenotes}\sphinxattablestart -\sphinxthistablewithglobalstyle -\raggedleft -\begin{tabulary}{\linewidth}[t]{|T|T|} -\sphinxtoprule -\sphinxstyletheadfamily -\sphinxAtStartPar -header1 -&\sphinxstyletheadfamily -\sphinxAtStartPar -header2 -\\ -\sphinxmidrule -\sphinxtableatstartofbodyhook -\sphinxAtStartPar -cell1\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell1\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell2\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell2\sphinxhyphen{}2 -\\ -\sphinxhline -\sphinxAtStartPar -cell3\sphinxhyphen{}1 -& -\sphinxAtStartPar -cell3\sphinxhyphen{}2 -\\ -\sphinxbottomrule -\end{tabulary} -\sphinxtableafterendhook\par -\sphinxattableend\end{savenotes} diff --git a/tests/roots/test-latex-table/longtable.rst b/tests/roots/test-latex-table/longtable.rst index da6fa5c5cec..89a37b8ed8d 100644 --- a/tests/roots/test-latex-table/longtable.rst +++ b/tests/roots/test-latex-table/longtable.rst @@ -15,8 +15,8 @@ longtable cell3-1 cell3-2 ======= ======= -longtable having :widths: option --------------------------------- +longtable having widths option +------------------------------ .. _mylongtable: @@ -35,8 +35,8 @@ longtable having :widths: option See mylongtable_, same as :ref:`this one `. -longtable having :align: option -------------------------------- +longtable having align option +----------------------------- .. table:: :align: right @@ -50,8 +50,8 @@ longtable having :align: option cell3-1 cell3-2 ======= ======= -longtable with tabularcolumn ----------------------------- +longtable with tabularcolumns +----------------------------- .. tabularcolumns:: |c|c| @@ -101,13 +101,12 @@ longtable having verbatim * - cell3-1 - cell3-2 -longtable having both :widths: and problematic cell ---------------------------------------------------- +longtable having formerly problematic +------------------------------------- .. list-table:: :class: longtable :header-rows: 1 - :widths: 30,70 * - header1 - header2 @@ -119,12 +118,13 @@ longtable having both :widths: and problematic cell * - cell3-1 - cell3-2 -longtable having problematic cell ---------------------------------- +longtable having widths and formerly problematic +------------------------------------------------ .. list-table:: :class: longtable :header-rows: 1 + :widths: 30,70 * - header1 - header2 @@ -136,8 +136,8 @@ longtable having problematic cell * - cell3-1 - cell3-2 -longtable having both stub columns and problematic cell -------------------------------------------------------- +longtable having stub columns and formerly problematic +------------------------------------------------------ .. list-table:: :class: longtable diff --git a/tests/roots/test-latex-table/tabular.rst b/tests/roots/test-latex-table/tabular.rst index 15db823a05b..b5011539795 100644 --- a/tests/roots/test-latex-table/tabular.rst +++ b/tests/roots/test-latex-table/tabular.rst @@ -12,8 +12,8 @@ cell2-1 cell2-2 cell3-1 cell3-2 ======= ======= -table having :widths: option ----------------------------- +table having widths option +-------------------------- .. _mytabular: @@ -32,8 +32,8 @@ table having :widths: option See :ref:`this `, same as namedtabular_. -table having :align: option (tabulary) --------------------------------------- +tabulary having align option +---------------------------- .. table:: :align: right @@ -46,8 +46,8 @@ table having :align: option (tabulary) cell3-1 cell3-2 ======= ======= -table having :align: option (tabular) -------------------------------------- +tabular having align option +--------------------------- .. table:: :align: left @@ -61,8 +61,8 @@ table having :align: option (tabular) cell3-1 cell3-2 ======= ======= -table with tabularcolumn ------------------------- +table with tabularcolumns +------------------------- .. tabularcolumns:: cc @@ -74,8 +74,8 @@ cell2-1 cell2-2 cell3-1 cell3-2 ======= ======= -table with cell in first column having three paragraphs -------------------------------------------------------- +table having three paragraphs cell in first col +----------------------------------------------- +--------------+ | header1 | @@ -121,12 +121,11 @@ table having verbatim * - cell3-1 - cell3-2 -table having both :widths: and problematic cell ------------------------------------------------ +table having formerly problematic +--------------------------------- .. list-table:: :header-rows: 1 - :widths: 30,70 * - header1 - header2 @@ -138,11 +137,12 @@ table having both :widths: and problematic cell * - cell3-1 - cell3-2 -table having problematic cell ------------------------------ +table having widths and formerly problematic +-------------------------------------------- .. list-table:: :header-rows: 1 + :widths: 30,70 * - header1 - header2 @@ -154,8 +154,8 @@ table having problematic cell * - cell3-1 - cell3-2 -table having both stub columns and problematic cell ---------------------------------------------------- +table having stub columns and formerly problematic +-------------------------------------------------- .. list-table:: :header-rows: 1 diff --git a/tests/roots/test-linkcheck-case-check/conf.py b/tests/roots/test-linkcheck-case-check/conf.py new file mode 100644 index 00000000000..0c319123c30 --- /dev/null +++ b/tests/roots/test-linkcheck-case-check/conf.py @@ -0,0 +1 @@ +linkcheck_timeout = 0.25 diff --git a/tests/roots/test-linkcheck-case-check/index.rst b/tests/roots/test-linkcheck-case-check/index.rst new file mode 100644 index 00000000000..1747d27ebcd --- /dev/null +++ b/tests/roots/test-linkcheck-case-check/index.rst @@ -0,0 +1,5 @@ +`path1 `_ + +`path2 `_ + +`PATH3 `_ diff --git a/tests/roots/test-root/conf.py b/tests/roots/test-root/conf.py index 0a750789128..ae637153467 100644 --- a/tests/roots/test-root/conf.py +++ b/tests/roots/test-root/conf.py @@ -35,6 +35,7 @@ pygments_style = 'sphinx' show_authors = True numfig = True +linkcheck_timeout = 0.25 html_sidebars = { '**': [ diff --git a/tests/roots/test-root/markup.txt b/tests/roots/test-root/markup.txt index 91f41946620..8f5e026a25f 100644 --- a/tests/roots/test-root/markup.txt +++ b/tests/roots/test-root/markup.txt @@ -182,7 +182,7 @@ With Tables ------ -.. tabularcolumns:: |L|p{5cm}|R| +.. tabularcolumns:: |*{1}{L|}p{5cm}|*{1}{R}| .. _my-table: @@ -223,6 +223,20 @@ Tables with multirow and multicol: | | +----+ + +---+---+ + | +---+ | + | | h | | + | +---+ | + +---+---+ + + .. rst-class:: longtable + + +---+---+ + | +---+ | + | | h | | + | +---+ | + +---+---+ + .. list-table:: :header-rows: 0 @@ -278,27 +292,38 @@ Figures Version markup -------------- -.. versionadded:: 0.6 +.. version-added:: 0.6 Some funny **stuff**. -.. versionchanged:: 0.6 +.. version-changed:: 0.6 Even more funny stuff. -.. deprecated:: 0.6 +.. version-deprecated:: 0.6 Boring stuff. -.. versionremoved:: 0.6 +.. version-removed:: 0.6 Goodbye boring stuff. -.. versionadded:: 1.2 +.. version-added:: 1.2 + + First paragraph of version-added. - First paragraph of versionadded. +.. version-changed:: 1.2 + First paragraph of version-changed. -.. versionchanged:: 1.2 - First paragraph of versionchanged. + Second paragraph of version-changed. - Second paragraph of versionchanged. +.. version-added:: 0.6 + Deprecated alias for version-added. +.. version-changed:: 0.6 + Deprecated alias for version-changed. + +.. deprecated:: 0.6 + Deprecated alias for version-deprecated. + +.. versionremoved:: 0.6 + Deprecated alias for version-removed. Code blocks ----------- @@ -469,3 +494,9 @@ Smart quotes .. [#] Like footnotes. + +Link in a title: `Field lists `_ +--------------------------------------------------------------------------------------------------------------------- + +Again: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#field-lists +------------------------------------------------------------------------------------------ diff --git a/tests/roots/test-search/escapedtitle.rst b/tests/roots/test-search/escapedtitle.rst new file mode 100644 index 00000000000..70f4c982d5b --- /dev/null +++ b/tests/roots/test-search/escapedtitle.rst @@ -0,0 +1,4 @@ +`escaped` title with < and > in it +================================== + +this document has escaped content in the title but also the characters < and > in it \ No newline at end of file diff --git a/tests/roots/test-toctree-only/conf.py b/tests/roots/test-toctree-only/conf.py new file mode 100644 index 00000000000..e69de29bb2d diff --git a/tests/roots/test-toctree-only/index.rst b/tests/roots/test-toctree-only/index.rst new file mode 100644 index 00000000000..cbfb903a588 --- /dev/null +++ b/tests/roots/test-toctree-only/index.rst @@ -0,0 +1,26 @@ +test-toctree-only +================= + +.. only:: not nonexistent + + hello world + + .. only:: text or not text + + .. js:data:: test_toctree_only1 + + lorem ipsum dolor sit amet... + + .. only:: not lorem + + .. only:: not ipsum + + .. js:data:: test_toctree_only2 + + lorem ipsum dolor sit amet... + + after ``only:: not ipsum`` + + .. js:data:: test_toctree_only2 + +we're just normal men; we're just innocent men diff --git a/tests/roots/test-warnings/undecodable.rst b/tests/roots/test-warnings/undecodable.rst deleted file mode 100644 index a4cf5c3706b..00000000000 --- a/tests/roots/test-warnings/undecodable.rst +++ /dev/null @@ -1,3 +0,0 @@ -:orphan: - -here: diff --git a/tests/test_addnodes.py b/tests/test_addnodes.py index b3f77ad2bb9..8cac53b2828 100644 --- a/tests/test_addnodes.py +++ b/tests/test_addnodes.py @@ -20,7 +20,9 @@ def sig_elements() -> Iterator[set[type[addnodes.desc_sig_element]]]: addnodes.SIG_ELEMENTS = original # restore the previous value -def test_desc_sig_element_nodes(sig_elements): +def test_desc_sig_element_nodes( + sig_elements: set[type[addnodes.desc_sig_element]], +) -> None: """Test the registration of ``desc_sig_element`` subclasses.""" # expected desc_sig_* node classes (must be declared *after* reloading # the module since otherwise the objects are not the correct ones) diff --git a/tests/test_application.py b/tests/test_application.py index b2bd7bbc66c..73c3f3556ca 100644 --- a/tests/test_application.py +++ b/tests/test_application.py @@ -20,6 +20,7 @@ if TYPE_CHECKING: import os + from typing import Any def test_instantiation( @@ -50,7 +51,7 @@ def test_instantiation( @pytest.mark.sphinx('html', testroot='root') def test_events(app: SphinxTestApp) -> None: - def empty(): + def empty() -> None: pass with pytest.raises(ExtensionError) as excinfo: @@ -62,7 +63,7 @@ def empty(): app.add_event('my_event') assert "Event 'my_event' already present" in str(excinfo.value) - def mock_callback(a_app, *args): + def mock_callback(a_app: SphinxTestApp, *args: Any) -> str: assert a_app is app assert emit_args == args return 'ret' diff --git a/tests/test_builders/test_build.py b/tests/test_builders/test_build.py index 587494c442b..8677fa07705 100644 --- a/tests/test_builders/test_build.py +++ b/tests/test_builders/test_build.py @@ -9,11 +9,18 @@ from sphinx.errors import SphinxError +from tests.utils import extract_element, extract_node + if TYPE_CHECKING: + from collections.abc import Callable + from pathlib import Path + from sphinx.testing.util import SphinxTestApp -def test_root_doc_not_found(tmp_path, make_app): +def test_root_doc_not_found( + tmp_path: Path, make_app: Callable[..., SphinxTestApp] +) -> None: (tmp_path / 'conf.py').touch() assert [p.name for p in tmp_path.iterdir()] == ['conf.py'] @@ -56,56 +63,58 @@ def test_multiple_parents_toctree(app: SphinxTestApp) -> None: @pytest.mark.usefixtures('_http_teapot') @pytest.mark.sphinx('dummy', testroot='images') -def test_image_glob(app): +def test_image_glob(app: SphinxTestApp) -> None: app.build(force_all=True) # index.rst doctree = app.env.get_doctree('index') + assert isinstance(doctree[0], nodes.Element) - assert isinstance(doctree[0][1], nodes.image) - assert doctree[0][1]['candidates'] == {'*': 'rimg.png'} - assert doctree[0][1]['uri'] == 'rimg.png' + assert isinstance(extract_node(doctree, 0, 1), nodes.image) + assert extract_element(doctree, 0, 1)['candidates'] == {'*': 'rimg.png'} + assert extract_element(doctree, 0, 1)['uri'] == 'rimg.png' - assert isinstance(doctree[0][2], nodes.figure) - assert isinstance(doctree[0][2][0], nodes.image) - assert doctree[0][2][0]['candidates'] == {'*': 'rimg.png'} - assert doctree[0][2][0]['uri'] == 'rimg.png' + assert isinstance(extract_node(doctree, 0, 2), nodes.figure) + assert isinstance(extract_node(doctree, 0, 2, 0), nodes.image) + assert extract_element(doctree, 0, 2, 0)['candidates'] == {'*': 'rimg.png'} + assert extract_element(doctree, 0, 2, 0)['uri'] == 'rimg.png' - assert isinstance(doctree[0][3], nodes.image) - assert doctree[0][3]['candidates'] == { + assert isinstance(extract_node(doctree, 0, 3), nodes.image) + assert extract_element(doctree, 0, 3)['candidates'] == { 'application/pdf': 'img.pdf', 'image/gif': 'img.gif', 'image/png': 'img.png', } - assert doctree[0][3]['uri'] == 'img.*' + assert extract_element(doctree, 0, 3)['uri'] == 'img.*' - assert isinstance(doctree[0][4], nodes.figure) - assert isinstance(doctree[0][4][0], nodes.image) - assert doctree[0][4][0]['candidates'] == { + assert isinstance(extract_node(doctree, 0, 4), nodes.figure) + assert isinstance(extract_node(doctree, 0, 4, 0), nodes.image) + assert extract_element(doctree, 0, 4, 0)['candidates'] == { 'application/pdf': 'img.pdf', 'image/gif': 'img.gif', 'image/png': 'img.png', } - assert doctree[0][4][0]['uri'] == 'img.*' + assert extract_element(doctree, 0, 4, 0)['uri'] == 'img.*' # subdir/index.rst doctree = app.env.get_doctree('subdir/index') + assert isinstance(doctree[0], nodes.Element) - assert isinstance(doctree[0][1], nodes.image) - assert doctree[0][1]['candidates'] == {'*': 'subdir/rimg.png'} - assert doctree[0][1]['uri'] == 'subdir/rimg.png' + assert isinstance(extract_node(doctree, 0, 1), nodes.image) + assert extract_element(doctree, 0, 1)['candidates'] == {'*': 'subdir/rimg.png'} + assert extract_element(doctree, 0, 1)['uri'] == 'subdir/rimg.png' - assert isinstance(doctree[0][2], nodes.image) - assert doctree[0][2]['candidates'] == { + assert isinstance(extract_node(doctree, 0, 2), nodes.image) + assert extract_element(doctree, 0, 2)['candidates'] == { 'application/pdf': 'subdir/svgimg.pdf', 'image/svg+xml': 'subdir/svgimg.svg', } - assert doctree[0][2]['uri'] == 'subdir/svgimg.*' + assert extract_element(doctree, 0, 2)['uri'] == 'subdir/svgimg.*' - assert isinstance(doctree[0][3], nodes.figure) - assert isinstance(doctree[0][3][0], nodes.image) - assert doctree[0][3][0]['candidates'] == { + assert isinstance(extract_node(doctree, 0, 3), nodes.figure) + assert isinstance(extract_node(doctree, 0, 3, 0), nodes.image) + assert extract_element(doctree, 0, 3, 0)['candidates'] == { 'application/pdf': 'subdir/svgimg.pdf', 'image/svg+xml': 'subdir/svgimg.svg', } - assert doctree[0][3][0]['uri'] == 'subdir/svgimg.*' + assert extract_element(doctree, 0, 3, 0)['uri'] == 'subdir/svgimg.*' diff --git a/tests/test_builders/test_build_epub.py b/tests/test_builders/test_build_epub.py index b8c7395c22c..631419ba3b6 100644 --- a/tests/test_builders/test_build_epub.py +++ b/tests/test_builders/test_build_epub.py @@ -5,6 +5,7 @@ import os import subprocess import xml.etree.ElementTree as ET +from collections import Counter from pathlib import Path from subprocess import CalledProcessError from typing import TYPE_CHECKING @@ -542,3 +543,143 @@ def test_copy_images(app: SphinxTestApp) -> None: 'svgimg.svg', 'testimäge.png', } + + +@pytest.mark.sphinx('epub', testroot='builder-dirhtml') +def test_epub_manifest_path_separator_normalization(app: SphinxTestApp) -> None: + """Test that path separators are normalized to forward slashes + in EPUB manifests, even on Windows. + """ + app.build() + + # Read the content.opf file + opf_path = app.outdir / 'content.opf' + assert opf_path.exists(), 'content.opf was not generated' + + # Parse manifest and spine elements + # Verify that all idrefs in spine match ids in manifest + + tree = ET.parse(str(opf_path)) # noqa: S314 + root = tree.getroot() + + # Define namespace + ns = {'opf': 'http://www.idpf.org/2007/opf'} + + # Collect items from manifest + manifest_ids: set[str | None] = set() + manifest_hrefs: dict[str, str] = {} + for item in root.findall('.//opf:manifest/opf:item', ns): + item_id: str | None = item.get('id') + item_href: str | None = item.get('href') + manifest_ids.add(item_id) + if item_id is not None and item_href is not None: + manifest_hrefs[item_id] = item_href + + # Check idrefs in spine + spine_idrefs = [] + for itemref in root.findall('.//opf:spine/opf:itemref', ns): + idref: str | None = itemref.get('idref') + spine_idrefs.append(idref) + + # Verify all spine idrefs exist in manifest + for idref in spine_idrefs: + assert idref in manifest_ids, ( + f"spine idref '{idref}' does not exist in manifest" + ) + + # Verify hrefs do not contain backslashes + # (should be normalized to forward slashes even on Windows) + for item_id, href in manifest_hrefs.items(): + assert '\\' not in href, ( + f"manifest item '{item_id}' href '{href}' contains backslashes" + ) + + # Verify no duplicate IDs are assigned to the same href + href_to_ids: dict[str, list[str | None]] = {} + for item_id, href in manifest_hrefs.items(): + # Normalize path for comparison + normalized_href = href.replace('\\', '/') + if normalized_href not in href_to_ids: + href_to_ids[normalized_href] = [] + href_to_ids[normalized_href].append(item_id) + + # Detect duplicate IDs + duplicates: dict[str, list[str | None]] = { + href: ids for href, ids in href_to_ids.items() if len(ids) > 1 + } + assert not duplicates, f'Multiple IDs assigned to the same file: {duplicates}' + + +@pytest.mark.sphinx('epub', testroot='builder-dirhtml') +def test_epub_manifest_subdirectory_paths(app: SphinxTestApp) -> None: + """Test that path separators are correctly normalized to forward slashes + even for paths containing subdirectories. + """ + app.build() + + opf_path = app.outdir / 'content.opf' + assert opf_path.exists() + + tree = ET.parse(str(opf_path)) # noqa: S314 + root = tree.getroot() + + ns: dict[str, str] = {'opf': 'http://www.idpf.org/2007/opf'} + + # Check all manifest item hrefs + for item in root.findall('.//opf:manifest/opf:item', ns): + href: str | None = item.get('href') + if href is not None: + # Verify no backslashes are present + assert '\\' not in href, ( + f"href '{href}' contains backslashes (should be forward slashes)" + ) + + # For paths with subdirectories, verify they are separated by forward slashes + if href is not None and '/' in href: + # Verify the path is correctly constructed + parts: list[str] = href.split('/') + assert all(parts), f"href '{href}' contains empty path segments" + + +@pytest.mark.sphinx('epub', testroot='basic') +def test_epub_spine_idref_consistency(app: SphinxTestApp) -> None: + """Test that spine idrefs and manifest ids are consistent. + Verify that path separator normalization ensures the same file + is reliably referenced with the same ID. + """ + app.build() + + opf_path = app.outdir / 'content.opf' + + tree = ET.parse(str(opf_path)) # noqa: S314 + root = tree.getroot() + + ns: dict[str, str] = {'opf': 'http://www.idpf.org/2007/opf'} + + # Create id→href mapping from manifest + id_to_href = {} + for item in root.findall('.//opf:manifest/opf:item', ns): + item_id: str | None = item.get('id') + item_href: str | None = item.get('href') + id_to_href[item_id] = item_href + + # For each idref in spine, verify corresponding href exists + # and that href is unique + spine_hrefs = [] + for itemref in root.findall('.//opf:spine/opf:itemref', ns): + idref: str | None = itemref.get('idref') + assert idref in id_to_href, f"manifest item not found for spine idref '{idref}'" + + href = id_to_href[idref] + spine_hrefs.append(href) + + # Warn if the same href is referenced multiple times + # (normally each file should appear only once in spine) + href_counts = Counter(spine_hrefs) + duplicated_hrefs: list[str | None] = [ + href for href, count in href_counts.items() if count > 1 + ] + + # Note: Some EPUBs may intentionally reference the same file multiple times, + # so this is logged as informational rather than a strict error + assert len(duplicated_hrefs) == 0 diff --git a/tests/test_builders/test_build_gettext.py b/tests/test_builders/test_build_gettext.py index 08c6e07d9ac..30798cc5070 100644 --- a/tests/test_builders/test_build_gettext.py +++ b/tests/test_builders/test_build_gettext.py @@ -323,3 +323,29 @@ def test_gettext_literalblock_additional(app: SphinxTestApp) -> None: "stdout object\\n>>>\\n>>> if __name__ == '__main__': # if run this py " 'file as python script\\n... main() # call main', ] + + +@pytest.mark.sphinx('gettext', testroot='intl', srcdir='gettext') +def test_gettext_trailing_backslashes(app: SphinxTestApp) -> None: + app.build(force_all=True) + + assert (app.outdir / 'backslashes.pot').is_file() + pot = (app.outdir / 'backslashes.pot').read_text(encoding='utf8') + msg_ids = get_msgids(pot) + assert msg_ids == [ + 'i18n with backslashes', + ( + 'line 1 line 2 line 3 ' + # middle backslashes are escaped normally + 'line 4a \\\\ and 4b ' + # whitespaces after backslashes are dropped + 'line with spaces after backslash ' + 'last line with spaces ' + 'and done 1' + ), + 'a b c', + 'last trailing \\\\ \\\\ is ignored', + 'See [#]_', + 'footnote with backslashes and done 2', + 'directive with backslashes', + ] diff --git a/tests/test_builders/test_build_html.py b/tests/test_builders/test_build_html.py index d374ff93177..d7c12ce89c3 100644 --- a/tests/test_builders/test_build_html.py +++ b/tests/test_builders/test_build_html.py @@ -8,7 +8,12 @@ from typing import TYPE_CHECKING import pytest +from docutils import nodes +from docutils.parsers import rst +from docutils.readers import standalone +from docutils.writers import html5_polyglot +from sphinx import addnodes from sphinx._cli.util.errors import strip_escape_sequences from sphinx.builders.html import ( StandaloneHTMLBuilder, @@ -17,18 +22,25 @@ ) from sphinx.errors import ConfigError from sphinx.testing.util import etree_parse +from sphinx.util.docutils import _get_settings, new_document from sphinx.util.inventory import InventoryFile, _InventoryItem +from sphinx.writers.html5 import HTML5Translator from tests.test_builders.xpath_data import FIGURE_CAPTION from tests.test_builders.xpath_util import check_xpath if TYPE_CHECKING: + from collections.abc import Callable, Sequence + from pathlib import Path from typing import Any + from xml.etree.ElementTree import Element, ElementTree from sphinx.testing.util import SphinxTestApp -def test_html_sidebars_error(make_app, tmp_path): +def test_html_sidebars_error( + make_app: Callable[..., SphinxTestApp], tmp_path: Path +) -> None: (tmp_path / 'conf.py').touch() with pytest.raises( ConfigError, @@ -43,7 +55,7 @@ def test_html_sidebars_error(make_app, tmp_path): ) -def test_html4_error(make_app, tmp_path): +def test_html4_error(make_app: Callable[..., SphinxTestApp], tmp_path: Path) -> None: (tmp_path / 'conf.py').touch() with pytest.raises( ConfigError, @@ -132,7 +144,13 @@ def test_html4_error(make_app, tmp_path): ) @pytest.mark.sphinx('html', testroot='root') @pytest.mark.test_params(shared_result='test_build_html_output_docutils18') -def test_docutils_output(app, cached_etree_parse, fname, path, check): +def test_docutils_output( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + fname: str, + path: str, + check: str, +) -> None: app.build() check_xpath(cached_etree_parse(app.outdir / fname), fname, path, check) @@ -146,15 +164,42 @@ def test_html_parallel(app: SphinxTestApp) -> None: app.build() -@pytest.mark.sphinx('html', testroot='build-html-translator') +class ConfHTMLTranslator(HTML5Translator): + depart_with_node = 0 + + def depart_admonition(self, node: nodes.Element | None = None) -> None: + if node is not None: + self.depart_with_node += 1 + super().depart_admonition(node) + + +@pytest.mark.sphinx('html', testroot='_blank') def test_html_translator(app: SphinxTestApp) -> None: - app.build() - assert isinstance(app.builder, StandaloneHTMLBuilder) # type-checking - assert app.builder.docwriter.visitor.depart_with_node == 10 + settings = _get_settings( + standalone.Reader, rst.Parser, html5_polyglot.Writer, defaults={} + ) + doctree = new_document(__file__, settings) + doctree.append(addnodes.seealso('test', nodes.Text('test'))) + doctree.append(nodes.note('test', nodes.Text('test'))) + doctree.append(nodes.warning('test', nodes.Text('test'))) + doctree.append(nodes.attention('test', nodes.Text('test'))) + doctree.append(nodes.caution('test', nodes.Text('test'))) + doctree.append(nodes.danger('test', nodes.Text('test'))) + doctree.append(nodes.error('test', nodes.Text('test'))) + doctree.append(nodes.hint('test', nodes.Text('test'))) + doctree.append(nodes.important('test', nodes.Text('test'))) + doctree.append(nodes.tip('test', nodes.Text('test'))) + + visitor = ConfHTMLTranslator(doctree, app.builder) + assert isinstance(visitor, ConfHTMLTranslator) + assert isinstance(visitor, HTML5Translator) + doctree.walkabout(visitor) + + assert visitor.depart_with_node == 10 @pytest.mark.parametrize( - 'expect', + ('path', 'check', 'be_found'), [ (FIGURE_CAPTION + "//span[@class='caption-number']", 'Fig. 1', True), (FIGURE_CAPTION + "//span[@class='caption-number']", 'Fig. 2', True), @@ -173,9 +218,21 @@ def test_html_translator(app: SphinxTestApp) -> None: testroot='add_enumerable_node', srcdir='test_enumerable_node', ) -def test_enumerable_node(app, cached_etree_parse, expect): +def test_enumerable_node( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + path: str, + check: str, + be_found: bool, +) -> None: app.build() - check_xpath(cached_etree_parse(app.outdir / 'index.html'), 'index.html', *expect) + check_xpath( + cached_etree_parse(app.outdir / 'index.html'), + 'index.html', + path, + check, + be_found, + ) @pytest.mark.sphinx( @@ -304,7 +361,7 @@ def test_html_raw_directive(app: SphinxTestApp) -> None: @pytest.mark.parametrize( - 'expect', + ('path', 'check', 'be_found'), [ (".//link[@href='_static/persistent.css'][@rel='stylesheet']", '', True), ( @@ -351,9 +408,21 @@ def test_html_raw_directive(app: SphinxTestApp) -> None: ], ) @pytest.mark.sphinx('html', testroot='stylesheets') -def test_alternate_stylesheets(app, cached_etree_parse, expect): +def test_alternate_stylesheets( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + path: str, + check: str, + be_found: bool, +) -> None: app.build() - check_xpath(cached_etree_parse(app.outdir / 'index.html'), 'index.html', *expect) + check_xpath( + cached_etree_parse(app.outdir / 'index.html'), + 'index.html', + path, + check, + be_found, + ) @pytest.mark.sphinx('html', testroot='html_style') @@ -382,8 +451,6 @@ def test_html_style(app: SphinxTestApp) -> None: }, ) def test_html_sidebar(app: SphinxTestApp) -> None: - ctx: dict[str, Any] = {} - # default for alabaster app.build(force_all=True) result = (app.outdir / 'index.html').read_text(encoding='utf8') @@ -399,12 +466,12 @@ def test_html_sidebar(app: SphinxTestApp) -> None: assert '

          This Page

          ' in result assert isinstance(app.builder, StandaloneHTMLBuilder) # type-checking - app.builder.add_sidebars('index', ctx) - assert ctx['sidebars'] == [ + sidebars = app.builder._get_sidebars('index') + assert sidebars == ( 'localtoc.html', 'searchfield.html', 'sourcelink.html', - ] + ) # only sourcelink.html app.config.html_sidebars = {'**': ['sourcelink.html']} @@ -422,8 +489,8 @@ def test_html_sidebar(app: SphinxTestApp) -> None: assert '

          This Page

          ' in result assert isinstance(app.builder, StandaloneHTMLBuilder) # type-checking - app.builder.add_sidebars('index', ctx) - assert ctx['sidebars'] == ['sourcelink.html'] + sidebars = app.builder._get_sidebars('index') + assert sidebars == ('sourcelink.html',) # no sidebars app.config.html_sidebars = {'**': []} @@ -443,17 +510,17 @@ def test_html_sidebar(app: SphinxTestApp) -> None: assert '

          This Page

          ' not in result assert isinstance(app.builder, StandaloneHTMLBuilder) # type-checking - app.builder.add_sidebars('index', ctx) - assert ctx['sidebars'] == [] + sidebars = app.builder._get_sidebars('index') + assert sidebars == () @pytest.mark.parametrize( - ('fname', 'expect'), + ('fname', 'path', 'check', 'be_found'), [ - ('index.html', (".//h1/em/a[@href='https://example.com/cp.1']", '', True)), - ('index.html', (".//em/a[@href='https://example.com/man.1']", '', True)), - ('index.html', (".//em/a[@href='https://example.com/ls.1']", '', True)), - ('index.html', (".//em/a[@href='https://example.com/sphinx.']", '', True)), + ('index.html', ".//h1/em/a[@href='https://example.com/cp.1']", '', True), + ('index.html', ".//em/a[@href='https://example.com/man.1']", '', True), + ('index.html', ".//em/a[@href='https://example.com/ls.1']", '', True), + ('index.html', ".//em/a[@href='https://example.com/sphinx.']", '', True), ], ) @pytest.mark.sphinx( @@ -462,9 +529,16 @@ def test_html_sidebar(app: SphinxTestApp) -> None: confoverrides={'manpages_url': 'https://example.com/{page}.{section}'}, ) @pytest.mark.test_params(shared_result='test_build_html_manpage_url') -def test_html_manpage(app, cached_etree_parse, fname, expect): +def test_html_manpage( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + fname: str, + path: str, + check: str, + be_found: bool, +) -> None: app.build() - check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect) + check_xpath(cached_etree_parse(app.outdir / fname), fname, path, check, be_found) @pytest.mark.sphinx( @@ -599,7 +673,7 @@ def test_html_remove_sources_before_write_gh_issue_10786(app: SphinxTestApp) -> # See: https://github.com/sphinx-doc/sphinx/issues/10786 target = app.srcdir / 'img.png' - def handler(app): + def handler(app: SphinxTestApp) -> list[tuple[str, dict[str, Any], str]]: assert target.exists() target.unlink() return [] @@ -621,7 +695,9 @@ def handler(app): testroot='domain-py-python_maximum_signature_line_length', confoverrides={'python_maximum_signature_line_length': 1}, ) -def test_html_pep_695_one_type_per_line(app, cached_etree_parse): +def test_html_pep_695_one_type_per_line( + app: SphinxTestApp, cached_etree_parse: Callable[[Path], ElementTree] +) -> None: app.build() fname = app.outdir / 'index.html' etree = cached_etree_parse(fname) @@ -630,7 +706,7 @@ class chk: def __init__(self, expect: str) -> None: self.expect = expect - def __call__(self, nodes): + def __call__(self, nodes: Sequence[Element]) -> None: assert len(nodes) == 1, nodes objnode = ''.join(nodes[0].itertext()).replace('\n\n', '') objnode = objnode.rstrip(chr(182)) # remove '¶' symbol @@ -689,7 +765,7 @@ class chk: def __init__(self, expect: str) -> None: self.expect = expect - def __call__(self, nodes): + def __call__(self, nodes: Sequence[Element]) -> None: assert len(nodes) == 1, nodes objnode = ''.join(nodes[0].itertext()).replace('\n\n', '') objnode = objnode.rstrip(chr(182)) # remove '¶' symbol @@ -735,15 +811,17 @@ def test_html_admonition_collapse(app: SphinxTestApp) -> None: fname = app.outdir / 'index.html' etree = etree_parse(fname) - def _create_check(text: str, open: bool): # type: ignore[no-untyped-def] - def _check(els): + def _create_check(text: str, open: bool) -> Callable[[Sequence[Element]], None]: + def _check(els: Sequence[Element]) -> None: assert len(els) == 1 el = els[0] if open: assert el.attrib['open'] == 'open' else: assert 'open' not in el.attrib - assert el.find('p').text == text + p = el.find('p') + assert p is not None + assert p.text == text return _check diff --git a/tests/test_builders/test_build_html_5_output.py b/tests/test_builders/test_build_html_5_output.py index db9dd8a749c..b712d1415a3 100644 --- a/tests/test_builders/test_build_html_5_output.py +++ b/tests/test_builders/test_build_html_5_output.py @@ -12,8 +12,9 @@ if TYPE_CHECKING: from collections.abc import Callable, Iterable + from pathlib import Path from typing import Literal - from xml.etree.ElementTree import Element + from xml.etree.ElementTree import Element, ElementTree from sphinx.testing.util import SphinxTestApp @@ -205,23 +206,53 @@ def checker(nodes: Iterable[Element]) -> Literal[True]: ( 'markup.html', ".//div[@class='versionadded']/p/span", - tail_check('First paragraph of versionadded'), + tail_check('First paragraph of version-added'), + ), + ( + 'markup.html', + ".//div[@class='versionadded']/p/span", + tail_check('Deprecated alias for version-added'), ), ( 'markup.html', ".//div[@class='versionchanged']/p/span", - tail_check('First paragraph of versionchanged'), + tail_check('First paragraph of version-changed'), ), ( 'markup.html', ".//div[@class='versionchanged']/p", - 'Second paragraph of versionchanged', + 'Second paragraph of version-changed', + ), + ( + 'markup.html', + ".//div[@class='versionchanged']/p/span", + tail_check('Deprecated alias for version-changed'), + ), + ( + 'markup.html', + ".//div[@class='deprecated']/p/span", + 'Deprecated since version 0.6: ', + ), + ( + 'markup.html', + ".//div[@class='deprecated']/p/span", + tail_check('Boring stuff.'), + ), + ( + 'markup.html', + ".//div[@class='deprecated']/p/span", + tail_check('Deprecated alias for version-deprecated'), ), ( 'markup.html', ".//div[@class='versionremoved']/p/span", 'Removed in version 0.6: ', ), + ( + 'markup.html', + ".//div[@class='versionremoved']/p/span", + tail_check('Deprecated alias for version-removed'), + ), # footnote reference ('markup.html', ".//a[@class='footnote-reference brackets']", r'1'), # created by reference lookup @@ -493,19 +524,31 @@ def checker(nodes: Iterable[Element]) -> Literal[True]: tags=['testtag'], confoverrides={'html_context.hckey_co': 'hcval_co'}, ) -def test_html5_output(app, cached_etree_parse, fname, path, check): +def test_html5_output( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + fname: str, + path: str, + check: str, +) -> None: app.build() check_xpath(cached_etree_parse(app.outdir / fname), fname, path, check) @pytest.mark.sphinx('html', testroot='markup-rubric') def test_html5_rubric(app: SphinxTestApp) -> None: - def insert_invalid_rubric_heading_level(app, doctree, docname): + def insert_invalid_rubric_heading_level( + app: SphinxTestApp, + doctree: nodes.document, + docname: str, + ) -> None: if docname != 'index': return new_node = nodes.rubric('', 'INSERTED RUBRIC') new_node['heading-level'] = 7 - doctree[0].append(new_node) + section = doctree[0] + assert isinstance(section, nodes.Element) + section.append(new_node) app.connect('doctree-resolved', insert_invalid_rubric_heading_level) app.build() diff --git a/tests/test_builders/test_build_html_assets.py b/tests/test_builders/test_build_html_assets.py index 7478f41829d..9059b423224 100644 --- a/tests/test_builders/test_build_html_assets.py +++ b/tests/test_builders/test_build_html_assets.py @@ -68,7 +68,7 @@ def test_html_assets(app: SphinxTestApp) -> None: @pytest.mark.sphinx('html', testroot='html_assets') -def test_assets_order(app, monkeypatch): +def test_assets_order(app: SphinxTestApp, monkeypatch: pytest.MonkeyPatch) -> None: monkeypatch.setattr(sphinx.builders.html, '_file_checksum', lambda o, f: '') app.add_css_file('normal.css') diff --git a/tests/test_builders/test_build_html_image.py b/tests/test_builders/test_build_html_image.py index 40e1b1cc421..6c256602806 100644 --- a/tests/test_builders/test_build_html_image.py +++ b/tests/test_builders/test_build_html_image.py @@ -75,12 +75,10 @@ def test_html_scaled_image_link(app: SphinxTestApp) -> None: context, ) else: - # Docutils 0.21 adds a newline before the closing tag - closing_space = '\n' if docutils.__version_info__[:2] >= (0, 21) else '' assert re.search( '\n' '_images/img.png' - f'{closing_space}', + '\n', context, ) diff --git a/tests/test_builders/test_build_html_maths.py b/tests/test_builders/test_build_html_maths.py index cc21142b355..8654ca99604 100644 --- a/tests/test_builders/test_build_html_maths.py +++ b/tests/test_builders/test_build_html_maths.py @@ -8,6 +8,9 @@ from sphinx.errors import ConfigError if TYPE_CHECKING: + from collections.abc import Callable + + from sphinx.testing.fixtures import _app_params from sphinx.testing.util import SphinxTestApp @@ -42,7 +45,9 @@ def test_html_math_renderer_is_imgmath(app: SphinxTestApp) -> None: testroot='basic', confoverrides={'extensions': ['sphinxcontrib.jsmath', 'sphinx.ext.imgmath']}, ) -def test_html_math_renderer_is_duplicated(make_app, app_params): +def test_html_math_renderer_is_duplicated( + make_app: Callable[..., SphinxTestApp], app_params: _app_params +) -> None: args, kwargs = app_params with pytest.raises( ConfigError, @@ -83,7 +88,9 @@ def test_html_math_renderer_is_chosen(app: SphinxTestApp) -> None: 'html_math_renderer': 'imgmath', }, ) -def test_html_math_renderer_is_mismatched(make_app, app_params): +def test_html_math_renderer_is_mismatched( + make_app: Callable[..., SphinxTestApp], app_params: _app_params +) -> None: args, kwargs = app_params with pytest.raises( ConfigError, diff --git a/tests/test_builders/test_build_html_numfig.py b/tests/test_builders/test_build_html_numfig.py index e338c5b92e5..144d9958d0d 100644 --- a/tests/test_builders/test_build_html_numfig.py +++ b/tests/test_builders/test_build_html_numfig.py @@ -11,6 +11,10 @@ from tests.test_builders.xpath_util import check_xpath if TYPE_CHECKING: + from collections.abc import Callable + from pathlib import Path + from xml.etree.ElementTree import ElementTree + from sphinx.testing.util import SphinxTestApp @@ -73,7 +77,14 @@ def test_numfig_disabled_warn(app: SphinxTestApp) -> None: ) @pytest.mark.sphinx('html', testroot='numfig') @pytest.mark.test_params(shared_result='test_build_html_numfig') -def test_numfig_disabled(app, cached_etree_parse, fname, path, check, be_found): +def test_numfig_disabled( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + fname: str, + path: str, + check: str | None, + be_found: bool, +) -> None: app.build() check_xpath(cached_etree_parse(app.outdir / fname), fname, path, check, be_found) @@ -305,8 +316,13 @@ def test_numfig_without_numbered_toctree_warn(app: SphinxTestApp) -> None: confoverrides={'numfig': True}, ) def test_numfig_without_numbered_toctree( - app, cached_etree_parse, fname, path, check, be_found -): + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + fname: str, + path: str, + check: str | None, + be_found: bool, +) -> None: # remove :numbered: option index = (app.srcdir / 'index.rst').read_text(encoding='utf8') index = re.sub(':numbered:.*', '', index) @@ -538,8 +554,13 @@ def test_numfig_with_numbered_toctree_warn(app: SphinxTestApp) -> None: ) @pytest.mark.test_params(shared_result='test_build_html_numfig_on') def test_numfig_with_numbered_toctree( - app, cached_etree_parse, fname, path, check, be_found -): + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + fname: str, + path: str, + check: str | None, + be_found: bool, +) -> None: app.build() check_xpath(cached_etree_parse(app.outdir / fname), fname, path, check, be_found) @@ -780,7 +801,14 @@ def test_numfig_with_prefix_warn(app: SphinxTestApp) -> None: }, ) @pytest.mark.test_params(shared_result='test_build_html_numfig_format_warn') -def test_numfig_with_prefix(app, cached_etree_parse, fname, path, check, be_found): +def test_numfig_with_prefix( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + fname: str, + path: str, + check: str | None, + be_found: bool, +) -> None: app.build() check_xpath(cached_etree_parse(app.outdir / fname), fname, path, check, be_found) @@ -1006,8 +1034,13 @@ def test_numfig_with_secnum_depth_warn(app: SphinxTestApp) -> None: ) @pytest.mark.test_params(shared_result='test_build_html_numfig_depth_2') def test_numfig_with_secnum_depth( - app, cached_etree_parse, fname, path, check, be_found -): + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + fname: str, + path: str, + check: str | None, + be_found: bool, +) -> None: app.build() check_xpath(cached_etree_parse(app.outdir / fname), fname, path, check, be_found) @@ -1103,6 +1136,10 @@ def test_numfig_with_secnum_depth( confoverrides={'numfig': True}, ) @pytest.mark.test_params(shared_result='test_build_html_numfig_on') -def test_numfig_with_singlehtml(app, cached_etree_parse, expect): +def test_numfig_with_singlehtml( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + expect: tuple[str, str, bool], +) -> None: app.build() check_xpath(cached_etree_parse(app.outdir / 'index.html'), 'index.html', *expect) diff --git a/tests/test_builders/test_build_html_tocdepth.py b/tests/test_builders/test_build_html_tocdepth.py index 003ba02e5f0..0fe83e0ff34 100644 --- a/tests/test_builders/test_build_html_tocdepth.py +++ b/tests/test_builders/test_build_html_tocdepth.py @@ -2,11 +2,20 @@ from __future__ import annotations +from typing import TYPE_CHECKING + import pytest from tests.test_builders.xpath_html_util import _intradocument_hyperlink_check from tests.test_builders.xpath_util import check_xpath +if TYPE_CHECKING: + from collections.abc import Callable + from pathlib import Path + from xml.etree.ElementTree import ElementTree + + from sphinx.testing.util import SphinxTestApp + @pytest.mark.parametrize( ('fname', 'path', 'check', 'be_found'), @@ -68,7 +77,14 @@ ) @pytest.mark.sphinx('html', testroot='tocdepth') @pytest.mark.test_params(shared_result='test_build_html_tocdepth') -def test_tocdepth(app, cached_etree_parse, fname, path, check, be_found): +def test_tocdepth( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + fname: str, + path: str, + check: str, + be_found: bool, +) -> None: app.build() # https://github.com/sphinx-doc/sphinx/issues/1251 check_xpath(cached_etree_parse(app.outdir / fname), fname, path, check, be_found) @@ -111,6 +127,10 @@ def test_tocdepth(app, cached_etree_parse, fname, path, check, be_found): ) @pytest.mark.sphinx('singlehtml', testroot='tocdepth') @pytest.mark.test_params(shared_result='test_build_html_tocdepth') -def test_tocdepth_singlehtml(app, cached_etree_parse, expect): +def test_tocdepth_singlehtml( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + expect: tuple[str, str, bool], +) -> None: app.build() check_xpath(cached_etree_parse(app.outdir / 'index.html'), 'index.html', *expect) diff --git a/tests/test_builders/test_build_html_toctree.py b/tests/test_builders/test_build_html_toctree.py index 255a2001960..ae0dc04fc08 100644 --- a/tests/test_builders/test_build_html_toctree.py +++ b/tests/test_builders/test_build_html_toctree.py @@ -14,6 +14,10 @@ from tests.test_builders.xpath_util import check_xpath if TYPE_CHECKING: + from collections.abc import Callable, Sequence + from pathlib import Path + from xml.etree.ElementTree import Element, ElementTree + from sphinx.testing.util import SphinxTestApp @@ -71,7 +75,11 @@ def test_numbered_toctree(app: SphinxTestApp) -> None: ], ) @pytest.mark.sphinx('singlehtml', testroot='toctree') -def test_singlehtml_hyperlinks(app, cached_etree_parse, expect): +def test_singlehtml_hyperlinks( + app: SphinxTestApp, + cached_etree_parse: Callable[[Path], ElementTree], + expect: tuple[str, str | Callable[[Sequence[Element]], None]], +) -> None: app.build() check_xpath(cached_etree_parse(app.outdir / 'index.html'), 'index.html', *expect) @@ -81,7 +89,9 @@ def test_singlehtml_hyperlinks(app, cached_etree_parse, expect): testroot='toctree-multiple-parents', confoverrides={'html_theme': 'alabaster'}, ) -def test_toctree_multiple_parents(app, cached_etree_parse): +def test_toctree_multiple_parents( + app: SphinxTestApp, cached_etree_parse: Callable[[Path], ElementTree] +) -> None: # The lexicographically greatest parent of the document in global toctree # should be chosen, regardless of the order in which files are read with patch.object(app.builder, '_read_serial') as m: diff --git a/tests/test_builders/test_build_latex.py b/tests/test_builders/test_build_latex.py index ea585cd6f21..ad0de59f37b 100644 --- a/tests/test_builders/test_build_latex.py +++ b/tests/test_builders/test_build_latex.py @@ -10,8 +10,10 @@ from pathlib import Path from shutil import copyfile from subprocess import CalledProcessError +from types import NoneType from typing import TYPE_CHECKING +import docutils import pygments import pytest @@ -23,7 +25,7 @@ from sphinx.util.osutil import ensuredir from sphinx.writers.latex import LaTeXTranslator -from tests.utils import http_server +from tests.utils import TEST_ROOTS_DIR, http_server if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp @@ -45,7 +47,7 @@ # only run latex if all needed packages are there -def kpsetest(*filenames): +def kpsetest(*filenames: str) -> bool: try: subprocess.run(['kpsewhich', *list(filenames)], capture_output=True, check=True) # NoQA: S607 return True @@ -54,7 +56,12 @@ def kpsetest(*filenames): # compile latex document with app.config.latex_engine -def compile_latex_document(app, filename='projectnamenotset.tex', docclass='manual'): +def compile_latex_document( + app: SphinxTestApp, + filename: str = 'projectnamenotset.tex', + docclass: str = 'manual', + runtwice: bool = False, +) -> None: # now, try to run latex over it try: with chdir(app.outdir): @@ -72,6 +79,17 @@ def compile_latex_document(app, filename='projectnamenotset.tex', docclass='manu filename, ] subprocess.run(args, capture_output=True, check=True) + # Run a second time (if engine is pdflatex), to have a chance to + # detect problems caused on second LaTeX pass (for example, this + # is required for the TOC in PDF to show up, for internal + # hyperlinks to actually work). Of course, this increases + # duration of test, but also its usefulness. + # TODO: in theory the correct way is to run Latexmk with options + # as configured in the Makefile and in presence of latexmkrc + # or latexmkjarc and also sphinx.xdy and other xindy support. + # And two passes are not enough except for simplest documents. + if runtwice: + subprocess.run(args, capture_output=True, check=True) except OSError as exc: # most likely the latex executable was not found raise pytest.skip.Exception from exc except CalledProcessError as exc: @@ -89,44 +107,51 @@ def compile_latex_document(app, filename='projectnamenotset.tex', docclass='manu not kpsetest(*STYLEFILES), reason='not running latex, the required styles do not seem to be installed', ) +skip_if_docutils_not_at_least_at_0_22 = pytest.mark.skipif( + docutils.__version_info__[:2] < (0, 22), + reason='this test requires Docutils at least at 0.22', +) class RemoteImageHandler(http.server.BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' - def do_GET(self): - content, content_type = None, None - if self.path == '/sphinx.png': - with open('tests/roots/test-local-logo/images/img.png', 'rb') as f: - content = f.read() - content_type = 'image/png' - - if content: - self.send_response(200, 'OK') - self.send_header('Content-Length', str(len(content))) - self.send_header('Content-Type', content_type) - self.end_headers() - self.wfile.write(content) - else: - self.send_response(404, 'Not Found') - self.send_header('Content-Length', '0') - self.end_headers() + def do_GET(self) -> None: + if self.path != '/sphinx.png': + self._send_not_found() + return + + img_path = TEST_ROOTS_DIR / 'test-local-logo' / 'images' / 'img.png' + content = img_path.read_bytes() + self._send_bytes(content, 'image/png') + + def _send_bytes(self, content: bytes, content_type: str) -> None: + self.send_response(200, 'OK') + self.send_header('Content-Length', str(len(content))) + self.send_header('Content-Type', content_type) + self.end_headers() + self.wfile.write(content) + + def _send_not_found(self) -> None: + self.send_response(404, 'Not Found') + self.send_header('Content-Length', '0') + self.end_headers() @skip_if_requested @skip_if_stylefiles_notfound @pytest.mark.parametrize( - ('engine', 'docclass', 'python_maximum_signature_line_length'), + ('engine', 'docclass', 'python_maximum_signature_line_length', 'runtwice'), # Only running test with `python_maximum_signature_line_length` not None with last # LaTeX engine to reduce testing time, as if this configuration does not fail with # one engine, it's almost impossible it would fail with another. [ - ('pdflatex', 'manual', None), - ('pdflatex', 'howto', None), - ('lualatex', 'manual', None), - ('lualatex', 'howto', None), - ('xelatex', 'manual', 1), - ('xelatex', 'howto', 1), + ('pdflatex', 'manual', None, True), + ('pdflatex', 'howto', None, True), + ('lualatex', 'manual', None, False), + ('lualatex', 'howto', None, False), + ('xelatex', 'manual', 1, False), + ('xelatex', 'howto', 1, False), ], ) @pytest.mark.sphinx( @@ -134,7 +159,13 @@ def do_GET(self): testroot='root', freshenv=True, ) -def test_build_latex_doc(app, engine, docclass, python_maximum_signature_line_length): +def test_build_latex_doc( + app: SphinxTestApp, + engine: str, + docclass: str, + python_maximum_signature_line_length: int | None, + runtwice: bool, +) -> None: app.config.python_maximum_signature_line_length = ( python_maximum_signature_line_length ) @@ -143,7 +174,7 @@ def test_build_latex_doc(app, engine, docclass, python_maximum_signature_line_le } intersphinx_setup(app) app.config.latex_engine = engine - app.config.latex_documents = [app.config.latex_documents[0][:4] + (docclass,)] + app.config.latex_documents = [(*app.config.latex_documents[0][:4], docclass)] if engine == 'xelatex': app.config.latex_table_style = ['booktabs'] elif engine == 'lualatex': @@ -158,7 +189,23 @@ def test_build_latex_doc(app, engine, docclass, python_maximum_signature_line_le # file from latex_additional_files assert (app.outdir / 'svgimg.svg').is_file() - compile_latex_document(app, 'sphinxtests.tex', docclass) + compile_latex_document(app, 'sphinxtests.tex', docclass, runtwice) + + +@skip_if_requested +@skip_if_stylefiles_notfound +@skip_if_docutils_not_at_least_at_0_22 +@pytest.mark.parametrize('engine', ['pdflatex', 'lualatex', 'xelatex']) +@pytest.mark.sphinx( + 'latex', + testroot='latex-images-css3-lengths', +) +def test_build_latex_with_css3_lengths(app: SphinxTestApp, engine: str) -> None: + app.config.latex_engine = engine + app.config.latex_documents = [(*app.config.latex_documents[0][:4], 'howto')] + app.builder.init() + app.build(force_all=True) + compile_latex_document(app, docclass='howto') @pytest.mark.sphinx('latex', testroot='root') @@ -944,13 +991,20 @@ def test_footnote(app: SphinxTestApp) -> None: 'footnote in table caption\n%\n\\end{footnotetext}\\ignorespaces %\n' '\\begin{footnotetext}[5]\\sphinxAtStartFootnote\n' 'footnote in table header\n%\n\\end{footnotetext}\\ignorespaces ' + '\\begin{varwidth}[t]{\\sphinxcolwidth{1}{2}}' '\n\\sphinxAtStartPar\n' - 'VIDIOC\\_CROPCAP\n&\n\\sphinxAtStartPar\n' + 'VIDIOC\\_CROPCAP\n' + '\\sphinxbeforeendvarwidth\n' + '\\end{varwidth}%\n' ) in result assert ( + '&\\begin{varwidth}[t]{\\sphinxcolwidth{1}{2}}\n' + '\\sphinxAtStartPar\n' 'Information about VIDIOC\\_CROPCAP %\n' '\\begin{footnote}[6]\\sphinxAtStartFootnote\n' - 'footnote in table not in header\n%\n\\end{footnote}\n\\\\\n' + 'footnote in table not in header\n%\n\\end{footnote}\n' + '\\sphinxbeforeendvarwidth\n' + '\\end{varwidth}%\n\\\\\n' '\\sphinxbottomrule\n\\end{tabulary}\n' '\\sphinxtableafterendhook\\par\n\\sphinxattableend\\end{savenotes}\n' ) in result @@ -1008,11 +1062,15 @@ def test_reference_in_caption_and_codeblock_in_footnote(app: SphinxTestApp) -> N '{I am in a footnote}}}}}' ) in result assert ( - '&\n\\sphinxAtStartPar\nThis is one more footnote with some code in it %\n' + '&\\begin{varwidth}[t]{\\sphinxcolwidth{1}{2}}\n' + '\\sphinxAtStartPar\nThis is one more footnote with some code in it %\n' '\\begin{footnote}[12]\\sphinxAtStartFootnote\n' 'Third footnote in longtable\n' ) in result - assert '\\end{sphinxVerbatim}\n%\n\\end{footnote}.\n' in result + assert ( + '\\end{sphinxVerbatim}\n%\n\\end{footnote}.\n' + '\\sphinxbeforeendvarwidth\n\\end{varwidth}%\n\\\\' + ) in result assert '\\begin{sphinxVerbatim}[commandchars=\\\\\\{\\}]' in result @@ -1554,71 +1612,33 @@ def test_latex_table_tabulars(app: SphinxTestApp) -> None: result = (app.outdir / 'projectnamenotset.tex').read_text(encoding='utf8') tables = {} for chap in re.split(r'\\(?:section|chapter){', result)[1:]: - sectname, content = chap.split('}', 1) + sectname, _, content = chap.partition('}') content = re.sub(r'\\sphinxstepscope', '', content) # filter a separator tables[sectname] = content.strip() - def get_expected(name): + def get_expected(name: str) -> str: return ( (app.srcdir / 'expects' / (name + '.tex')) .read_text(encoding='utf8') .strip() ) - # simple_table - actual = tables['simple table'] - expected = get_expected('simple_table') - assert actual == expected - - # table having :widths: option - actual = tables['table having :widths: option'] - expected = get_expected('table_having_widths') - assert actual == expected - - # table having :align: option (tabulary) - actual = tables['table having :align: option (tabulary)'] - expected = get_expected('tabulary_having_widths') - assert actual == expected - - # table having :align: option (tabular) - actual = tables['table having :align: option (tabular)'] - expected = get_expected('tabular_having_widths') - assert actual == expected - - # table with tabularcolumn - actual = tables['table with tabularcolumn'] - expected = get_expected('tabularcolumn') - assert actual == expected - - # table with cell in first column having three paragraphs - actual = tables['table with cell in first column having three paragraphs'] - expected = get_expected('table_having_threeparagraphs_cell_in_first_col') - assert actual == expected - - # table having caption - actual = tables['table having caption'] - expected = get_expected('table_having_caption') - assert actual == expected - - # table having verbatim - actual = tables['table having verbatim'] - expected = get_expected('table_having_verbatim') - assert actual == expected - - # table having problematic cell - actual = tables['table having problematic cell'] - expected = get_expected('table_having_problematic_cell') - assert actual == expected - - # table having both :widths: and problematic cell - actual = tables['table having both :widths: and problematic cell'] - expected = get_expected('table_having_widths_and_problematic_cell') - assert actual == expected - - # table having both stub columns and problematic cell - actual = tables['table having both stub columns and problematic cell'] - expected = get_expected('table_having_stub_columns_and_problematic_cell') - assert actual == expected + for sectname in ( + 'simple table', + 'table having widths option', + 'tabulary having align option', + 'tabular having align option', + 'table with tabularcolumns', + 'table having three paragraphs cell in first col', + 'table having caption', + 'table having verbatim', + 'table having formerly problematic', + 'table having widths and formerly problematic', + 'table having stub columns and formerly problematic', + ): + actual = tables[sectname] + expected = get_expected(sectname.replace(' ', '_')) + assert actual == expected @pytest.mark.sphinx( @@ -1632,61 +1652,31 @@ def test_latex_table_longtable(app: SphinxTestApp) -> None: result = (app.outdir / 'projectnamenotset.tex').read_text(encoding='utf8') tables = {} for chap in re.split(r'\\(?:section|chapter){', result)[1:]: - sectname, content = chap.split('}', 1) + sectname, _, content = chap.partition('}') content = re.sub(r'\\sphinxstepscope', '', content) # filter a separator tables[sectname] = content.strip() - def get_expected(name): + def get_expected(name: str) -> str: return ( (app.srcdir / 'expects' / (name + '.tex')) .read_text(encoding='utf8') .strip() ) - # longtable - actual = tables['longtable'] - expected = get_expected('longtable') - assert actual == expected - - # longtable having :widths: option - actual = tables['longtable having :widths: option'] - expected = get_expected('longtable_having_widths') - assert actual == expected - - # longtable having :align: option - actual = tables['longtable having :align: option'] - expected = get_expected('longtable_having_align') - assert actual == expected - - # longtable with tabularcolumn - actual = tables['longtable with tabularcolumn'] - expected = get_expected('longtable_with_tabularcolumn') - assert actual == expected - - # longtable having caption - actual = tables['longtable having caption'] - expected = get_expected('longtable_having_caption') - assert actual == expected - - # longtable having verbatim - actual = tables['longtable having verbatim'] - expected = get_expected('longtable_having_verbatim') - assert actual == expected - - # longtable having problematic cell - actual = tables['longtable having problematic cell'] - expected = get_expected('longtable_having_problematic_cell') - assert actual == expected - - # longtable having both :widths: and problematic cell - actual = tables['longtable having both :widths: and problematic cell'] - expected = get_expected('longtable_having_widths_and_problematic_cell') - assert actual == expected - - # longtable having both stub columns and problematic cell - actual = tables['longtable having both stub columns and problematic cell'] - expected = get_expected('longtable_having_stub_columns_and_problematic_cell') - assert actual == expected + for sectname in ( + 'longtable', + 'longtable having widths option', + 'longtable having align option', + 'longtable with tabularcolumns', + 'longtable having caption', + 'longtable having verbatim', + 'longtable having formerly problematic', + 'longtable having widths and formerly problematic', + 'longtable having stub columns and formerly problematic', + ): + actual = tables[sectname] + expected = get_expected(sectname.replace(' ', '_')) + assert actual == expected @pytest.mark.sphinx( @@ -1700,32 +1690,24 @@ def test_latex_table_complex_tables(app: SphinxTestApp) -> None: result = (app.outdir / 'projectnamenotset.tex').read_text(encoding='utf8') tables = {} for chap in re.split(r'\\(?:section|renewcommand){', result)[1:]: - sectname, content = chap.split('}', 1) + sectname, _, content = chap.partition('}') tables[sectname] = content.strip() - def get_expected(name): + def get_expected(name: str) -> str: return ( (app.srcdir / 'expects' / (name + '.tex')) .read_text(encoding='utf8') .strip() ) - # grid table - actual = tables['grid table'] - expected = get_expected('gridtable') - assert actual == expected - - # grid table with tabularcolumns - # MEMO: filename should end with tabularcolumns but tabularcolumn has been - # used in existing other cases - actual = tables['grid table with tabularcolumns having no vline'] - expected = get_expected('gridtable_with_tabularcolumn') - assert actual == expected - - # complex spanning cell - actual = tables['complex spanning cell'] - expected = get_expected('complex_spanning_cell') - assert actual == expected + for sectname in ( + 'grid table', + 'grid table with tabularcolumns', + 'complex spanning cell', + ): + actual = tables[sectname] + expected = get_expected(sectname.replace(' ', '_')) + assert actual == expected @pytest.mark.sphinx('latex', testroot='latex-table') @@ -1948,10 +1930,16 @@ def test_latex_labels(app: SphinxTestApp) -> None: result = (app.outdir / 'projectnamenotset.tex').read_text(encoding='utf8') + # ref: docutils r10151 + if docutils.__version_info__[:2] < (0, 22): + figure_id, table_id = 'id1', 'id2' + else: + figure_id, table_id = 'id2', 'id3' + # figures assert ( r'\caption{labeled figure}' - r'\label{\detokenize{index:id1}}' + r'\label{\detokenize{index:' + figure_id + '}}' r'\label{\detokenize{index:figure2}}' r'\label{\detokenize{index:figure1}}' r'\end{figure}' @@ -1977,7 +1965,7 @@ def test_latex_labels(app: SphinxTestApp) -> None: # tables assert ( r'\sphinxcaption{table caption}' - r'\label{\detokenize{index:id2}}' + r'\label{\detokenize{index:' + table_id + '}}' r'\label{\detokenize{index:table2}}' r'\label{\detokenize{index:table1}}' ) in result @@ -2001,9 +1989,11 @@ def test_latex_labels(app: SphinxTestApp) -> None: r'\label{\detokenize{otherdoc::doc}}' ) in result - # Embedded standalone hyperlink reference + # Named hyperlink reference with embedded alias reference # See: https://github.com/sphinx-doc/sphinx/issues/5948 assert result.count(r'\label{\detokenize{index:section1}}') == 1 + # https://github.com/sphinx-doc/sphinx/issues/13609 + assert r'\phantomsection\label{\detokenize{index:id' not in result @pytest.mark.sphinx('latex', testroot='latex-figure-in-admonition') @@ -2015,7 +2005,7 @@ def test_latex_figure_in_admonition(app: SphinxTestApp) -> None: assert f'{type} directive.\n\n\\begin{{figure}}[H]' in result -def test_default_latex_documents(): +def test_default_latex_documents() -> None: from sphinx.util import texescape texescape.init() @@ -2024,8 +2014,8 @@ def test_default_latex_documents(): 'project': 'STASI™ Documentation', 'author': "Wolfgang Schäuble & G'Beckstein.", }) - config.add('latex_engine', None, True, None) - config.add('latex_theme', 'manual', True, None) + config.add('latex_engine', None, 'env', (str, NoneType)) + config.add('latex_theme', 'manual', 'env', (str,)) expected = [ ( 'index', diff --git a/tests/test_builders/test_build_linkcheck.py b/tests/test_builders/test_build_linkcheck.py index 32b7ae79ff7..7b036ec4506 100644 --- a/tests/test_builders/test_build_linkcheck.py +++ b/tests/test_builders/test_build_linkcheck.py @@ -10,11 +10,11 @@ import wsgiref.handlers from base64 import b64encode from http.server import BaseHTTPRequestHandler +from io import StringIO from queue import Queue from typing import TYPE_CHECKING from unittest import mock -import docutils import pytest from urllib3.poolmanager import PoolManager @@ -27,6 +27,7 @@ RateLimit, compile_linkcheck_allowed_redirects, ) +from sphinx.errors import ConfigError from sphinx.testing.util import SphinxTestApp from sphinx.util import requests from sphinx.util._pathlib import _StrPath @@ -37,7 +38,8 @@ if TYPE_CHECKING: from collections.abc import Callable, Iterable - from typing import Any + from pathlib import Path + from typing import Any, Self from urllib3 import HTTPConnectionPool @@ -50,7 +52,7 @@ class DefaultsHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' - def do_HEAD(self): + def do_HEAD(self) -> None: if self.path[1:].rstrip() in {'', 'anchor.html'}: self.send_response(200, 'OK') self.send_header('Content-Length', '0') @@ -60,7 +62,7 @@ def do_HEAD(self): self.send_header('Content-Length', '0') self.end_headers() - def do_GET(self): + def do_GET(self) -> None: if self.path[1:].rstrip() == '': content = b'ok\n\n' elif self.path[1:].rstrip() == 'anchor.html': @@ -92,25 +94,25 @@ def __init__(self) -> None: new=self._collect_connections(), ) - def _collect_connections(self) -> Callable[[object, str], HTTPConnectionPool]: - def connection_collector(obj, url): + def _collect_connections(self) -> Callable[[PoolManager, str], HTTPConnectionPool]: + def connection_collector(obj: PoolManager, url: str) -> HTTPConnectionPool: connection = self.urllib3_connection_from_url(obj, url) # type: ignore[no-untyped-call] self.connections.add(connection) return connection return connection_collector - def __enter__(self): + def __enter__(self) -> Self: self.patcher.start() return self - def __exit__(self, *args, **kwargs): + def __exit__(self, *args: object, **kwargs: Any) -> None: for connection in self.connections: connection.close() self.patcher.stop() @property - def connection_count(self): + def connection_count(self) -> int: return len(self.connections) @@ -174,11 +176,7 @@ def _missing_resource(filename: str, lineno: int) -> dict[str, str | int]: 'info': f'404 Client Error: Not Found for url: http://{address}/{filename}', } - accurate_linenumbers = docutils.__version_info__[:2] >= (0, 21) - image2_lineno = 12 if accurate_linenumbers else 13 - assert rowsby[f'http://{address}/image2.png'] == _missing_resource( - 'image2.png', image2_lineno - ) + assert rowsby[f'http://{address}/image2.png'] == _missing_resource('image2.png', 12) # looking for '#top' and '#does-not-exist' not found should fail assert rowsby[f'http://{address}/#top']['info'] == "Anchor 'top' not found" assert rowsby[f'http://{address}/#top']['status'] == 'broken' @@ -344,14 +342,14 @@ def _send_chunked(self, content: str) -> bool: return False return True - def do_HEAD(self): + def do_HEAD(self) -> None: if self.path in {'/valid', '/ignored'}: self.send_response(200, 'OK') else: self.send_response(404, 'Not Found') self.end_headers() - def do_GET(self): + def do_GET(self) -> None: if self.path == '/valid': self.send_response(200, 'OK') content = "

          valid anchor

          \n" @@ -421,7 +419,7 @@ def test_raises_for_invalid_status(app: SphinxTestApp) -> None: class InternalServerErrorHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' - def do_GET(self): + def do_GET(self) -> None: self.send_error(500, 'Internal Server Error') with serve_application(app, InternalServerErrorHandler) as address: @@ -443,7 +441,7 @@ def test_incomplete_html_anchor(app: SphinxTestApp) -> None: class IncompleteHTMLDocumentHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' - def do_GET(self): + def do_GET(self) -> None: content = b'this is
          not
          a valid HTML document' self.send_response(200, 'OK') self.send_header('Content-Length', str(len(content))) @@ -469,7 +467,7 @@ def test_decoding_error_anchor_ignored(app: SphinxTestApp) -> None: class NonASCIIHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' - def do_GET(self): + def do_GET(self) -> None: content = b'\x80\x00\x80\x00' # non-ASCII byte-string self.send_response(200, 'OK') self.send_header('Content-Length', str(len(content))) @@ -488,7 +486,7 @@ def do_GET(self): def custom_handler( valid_credentials: tuple[str, str] | None = None, - success_criteria: Callable[[Any], bool] = lambda _: True, + success_criteria: Callable[[BaseHTTPRequestHandler], bool] = lambda _: True, ) -> type[BaseHTTPRequestHandler]: """Returns an HTTP request handler that authenticates the client and then determines an appropriate HTTP response code, based on caller-provided credentials and optional @@ -523,11 +521,11 @@ class CustomHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' @authenticated - def do_HEAD(self): + def do_HEAD(self) -> None: self.do_GET() @authenticated - def do_GET(self): + def do_GET(self) -> None: if success_criteria(self): self.send_response(200, 'OK') self.send_header('Content-Length', '0') @@ -605,7 +603,7 @@ def test_auth_header_no_match(app: SphinxTestApp) -> None: freshenv=True, ) def test_linkcheck_request_headers(app: SphinxTestApp) -> None: - def check_headers(self): + def check_headers(self: BaseHTTPRequestHandler) -> bool: if 'X-Secret' in self.headers: return False return self.headers['Accept'] == 'text/html' @@ -631,7 +629,7 @@ def check_headers(self): freshenv=True, ) def test_linkcheck_request_headers_no_slash(app: SphinxTestApp) -> None: - def check_headers(self): + def check_headers(self: BaseHTTPRequestHandler) -> bool: if 'X-Secret' in self.headers: return False return self.headers['Accept'] == 'application/json' @@ -663,7 +661,7 @@ def check_headers(self): }, ) def test_linkcheck_request_headers_default(app: SphinxTestApp) -> None: - def check_headers(self): + def check_headers(self: BaseHTTPRequestHandler) -> bool: if self.headers['X-Secret'] != 'open sesami': return False return self.headers['Accept'] != 'application/json' @@ -677,7 +675,7 @@ def check_headers(self): assert content['status'] == 'working' -def make_redirect_handler(*, support_head: bool) -> type[BaseHTTPRequestHandler]: +def make_redirect_handler(*, support_head: bool = True) -> type[BaseHTTPRequestHandler]: class RedirectOnceHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' @@ -698,7 +696,7 @@ def do_GET(self) -> None: self.send_header('Content-Length', '0') self.end_headers() - def log_date_time_string(self): + def log_date_time_string(self) -> str: """Strip date and time from logged messages for assertions.""" return '' @@ -710,10 +708,13 @@ def log_date_time_string(self): testroot='linkcheck-localserver', freshenv=True, ) -def test_follows_redirects_on_HEAD(app, capsys): +def test_follows_redirects_on_HEAD( + app: SphinxTestApp, capsys: pytest.CaptureFixture[str] +) -> None: with serve_application(app, make_redirect_handler(support_head=True)) as address: + compile_linkcheck_allowed_redirects(app, app.config) app.build() - stdout, stderr = capsys.readouterr() + _stdout, stderr = capsys.readouterr() content = (app.outdir / 'output.txt').read_text(encoding='utf8') assert content == ( 'index.rst:1: [redirected with Found] ' @@ -725,6 +726,9 @@ def test_follows_redirects_on_HEAD(app, capsys): 127.0.0.1 - - [] "HEAD /?redirected=1 HTTP/1.1" 204 - """, ) + assert ( + f'redirect http://{address}/ - with Found to http://{address}/?redirected=1\n' + ) in strip_escape_sequences(app.status.getvalue()) assert app.warning.getvalue() == '' @@ -733,10 +737,13 @@ def test_follows_redirects_on_HEAD(app, capsys): testroot='linkcheck-localserver', freshenv=True, ) -def test_follows_redirects_on_GET(app, capsys): +def test_follows_redirects_on_GET( + app: SphinxTestApp, capsys: pytest.CaptureFixture[str] +) -> None: with serve_application(app, make_redirect_handler(support_head=False)) as address: + compile_linkcheck_allowed_redirects(app, app.config) app.build() - stdout, stderr = capsys.readouterr() + _stdout, stderr = capsys.readouterr() content = (app.outdir / 'output.txt').read_text(encoding='utf8') assert content == ( 'index.rst:1: [redirected with Found] ' @@ -749,9 +756,67 @@ def test_follows_redirects_on_GET(app, capsys): 127.0.0.1 - - [] "GET /?redirected=1 HTTP/1.1" 204 - """, ) + assert ( + f'redirect http://{address}/ - with Found to http://{address}/?redirected=1\n' + ) in strip_escape_sequences(app.status.getvalue()) assert app.warning.getvalue() == '' +@pytest.mark.sphinx( + 'linkcheck', + testroot='linkcheck-localserver', + freshenv=True, + confoverrides={'linkcheck_allowed_redirects': {}}, # warn about any redirects +) +def test_warns_disallowed_redirects( + app: SphinxTestApp, capsys: pytest.CaptureFixture[str] +) -> None: + with serve_application(app, make_redirect_handler()) as address: + compile_linkcheck_allowed_redirects(app, app.config) + app.build() + _stdout, stderr = capsys.readouterr() + content = (app.outdir / 'output.txt').read_text(encoding='utf8') + assert content == ( + 'index.rst:1: [redirected with Found] ' + f'http://{address}/ to http://{address}/?redirected=1\n' + ) + assert stderr == textwrap.dedent( + """\ + 127.0.0.1 - - [] "HEAD / HTTP/1.1" 302 - + 127.0.0.1 - - [] "HEAD /?redirected=1 HTTP/1.1" 204 - + """, + ) + assert len(app.warning.getvalue().splitlines()) == 1 + + +def test_linkcheck_allowed_redirects_config( + make_app: Callable[..., SphinxTestApp], tmp_path: Path +) -> None: + tmp_path.joinpath('conf.py').touch() + tmp_path.joinpath('index.rst').touch() + + # ``linkcheck_allowed_redirects = None`` is rejected + warning_stream = StringIO() + with pytest.raises(ConfigError): + make_app( + 'linkcheck', + srcdir=tmp_path, + confoverrides={'linkcheck_allowed_redirects': None}, + warning=warning_stream, + ) + assert strip_escape_sequences(warning_stream.getvalue()).splitlines() == [ + "WARNING: The config value `linkcheck_allowed_redirects' has type `NoneType'; expected `dict'." + ] + + # ``linkcheck_allowed_redirects = {}`` is permitted + app = make_app( + 'linkcheck', + srcdir=tmp_path, + confoverrides={'linkcheck_allowed_redirects': {}}, + ) + assert strip_escape_sequences(app.warning.getvalue()) == '' + + @pytest.mark.sphinx('linkcheck', testroot='linkcheck-localserver-warn-redirects') def test_linkcheck_allowed_redirects(app: SphinxTestApp) -> None: with serve_application(app, make_redirect_handler(support_head=False)) as address: @@ -784,12 +849,12 @@ def test_linkcheck_allowed_redirects(app: SphinxTestApp) -> None: class OKHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' - def do_HEAD(self): + def do_HEAD(self) -> None: self.send_response(200, 'OK') self.send_header('Content-Length', '0') self.end_headers() - def do_GET(self): + def do_GET(self) -> None: content = b'ok\n' self.send_response(200, 'OK') self.send_header('Content-Length', str(len(content))) @@ -803,7 +868,7 @@ def do_GET(self): testroot='linkcheck-localserver-https', freshenv=True, ) -def test_invalid_ssl(get_request, app): +def test_invalid_ssl(get_request: mock.Mock, app: SphinxTestApp) -> None: # Link indicates SSL should be used (https) but the server does not handle it. with serve_application(app, OKHandler) as address: app.build() @@ -885,7 +950,9 @@ def test_connect_to_selfsigned_with_tls_cacerts(app: SphinxTestApp) -> None: testroot='linkcheck-localserver-https', freshenv=True, ) -def test_connect_to_selfsigned_with_requests_env_var(monkeypatch, app): +def test_connect_to_selfsigned_with_requests_env_var( + monkeypatch: pytest.MonkeyPatch, app: SphinxTestApp +) -> None: monkeypatch.setenv('REQUESTS_CA_BUNDLE', CERT_FILE) with serve_application(app, OKHandler, tls_enabled=True) as address: app.build() @@ -927,13 +994,13 @@ def test_connect_to_selfsigned_nonexistent_cert_file(app: SphinxTestApp) -> None class InfiniteRedirectOnHeadHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' - def do_HEAD(self): + def do_HEAD(self) -> None: self.send_response(302, 'Found') self.send_header('Location', '/redirected') self.send_header('Content-Length', '0') self.end_headers() - def do_GET(self): + def do_GET(self) -> None: content = b'ok\n' self.send_response(200, 'OK') self.send_header('Content-Length', str(len(content))) @@ -949,7 +1016,9 @@ def do_GET(self): testroot='linkcheck-localserver', freshenv=True, ) -def test_TooManyRedirects_on_HEAD(app, monkeypatch): +def test_TooManyRedirects_on_HEAD( + app: SphinxTestApp, monkeypatch: pytest.MonkeyPatch +) -> None: import requests.sessions monkeypatch.setattr(requests.sessions, 'DEFAULT_REDIRECT_LIMIT', 5) @@ -990,7 +1059,7 @@ def test_ignore_local_redirection(app: SphinxTestApp) -> None: class RemoteDomainRedirectHandler(InfiniteRedirectOnHeadHandler): protocol_version = 'HTTP/1.1' - def do_GET(self): + def do_GET(self) -> None: self.send_response(301, 'Found') if self.path == '/': self.send_header('Location', '/local') @@ -1024,7 +1093,7 @@ def make_retry_after_handler( class RetryAfterHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' - def do_HEAD(self): + def do_HEAD(self) -> None: status, retry_after = responses.pop(0) self.send_response(status) if retry_after: @@ -1032,7 +1101,7 @@ def do_HEAD(self): self.send_header('Content-Length', '0') self.end_headers() - def log_date_time_string(self): + def log_date_time_string(self) -> str: """Strip date and time from logged messages for assertions.""" return '' @@ -1044,7 +1113,9 @@ def log_date_time_string(self): testroot='linkcheck-localserver', freshenv=True, ) -def test_too_many_requests_retry_after_int_delay(app, capsys): +def test_too_many_requests_retry_after_int_delay( + app: SphinxTestApp, capsys: pytest.CaptureFixture[str] +) -> None: with ( serve_application( app, make_retry_after_handler([(429, '0'), (200, None)]) @@ -1079,7 +1150,12 @@ def test_too_many_requests_retry_after_int_delay(app, capsys): testroot='linkcheck-localserver', freshenv=True, ) -def test_too_many_requests_retry_after_HTTP_date(tz, app, monkeypatch, capsys): +def test_too_many_requests_retry_after_HTTP_date( + tz: str | None, + app: SphinxTestApp, + monkeypatch: pytest.MonkeyPatch, + capsys: pytest.CaptureFixture[str], +) -> None: retry_after = wsgiref.handlers.format_date_time(time.time()) with monkeypatch.context() as m: @@ -1096,6 +1172,12 @@ def test_too_many_requests_retry_after_HTTP_date(tz, app, monkeypatch, capsys): ) as address: app.build() + # Undo side-effects: the monkeypatch context manager clears the TZ environment + # variable, but we also need to reset Python's internal notion of the current + # timezone. + if sys.platform != 'win32': + time.tzset() + content = (app.outdir / 'output.json').read_text(encoding='utf8') assert json.loads(content) == { 'filename': 'index.rst', @@ -1119,7 +1201,9 @@ def test_too_many_requests_retry_after_HTTP_date(tz, app, monkeypatch, capsys): testroot='linkcheck-localserver', freshenv=True, ) -def test_too_many_requests_retry_after_without_header(app, capsys): +def test_too_many_requests_retry_after_without_header( + app: SphinxTestApp, capsys: pytest.CaptureFixture[str] +) -> None: with ( serve_application( app, make_retry_after_handler([(429, None), (200, None)]) @@ -1158,7 +1242,7 @@ def test_requests_timeout(app: SphinxTestApp) -> None: class DelayedResponseHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' - def do_GET(self): + def do_GET(self) -> None: time.sleep(0.2) # wait before sending any response data self.send_response(200, 'OK') self.send_header('Content-Length', '0') @@ -1259,7 +1343,9 @@ def test_limit_rate_bails_out_after_waiting_max_time(app: SphinxTestApp) -> None @mock.patch('sphinx.util.requests.requests.Session.get_adapter') @pytest.mark.sphinx('html', testroot='root') -def test_connection_contention(get_adapter, app, capsys): +def test_connection_contention( + get_adapter: mock.Mock, app: SphinxTestApp, capsys: pytest.CaptureFixture[str] +) -> None: # Create a shared, but limited-size, connection pool import requests @@ -1310,10 +1396,10 @@ def test_connection_contention(get_adapter, app, capsys): class ConnectionResetHandler(BaseHTTPRequestHandler): protocol_version = 'HTTP/1.1' - def do_HEAD(self): + def do_HEAD(self) -> None: self.close_connection = True - def do_GET(self): + def do_GET(self) -> None: self.send_response(200, 'OK') self.send_header('Content-Length', '0') self.end_headers() @@ -1369,3 +1455,70 @@ def test_linkcheck_exclude_documents(app: SphinxTestApp) -> None: 'uri': 'https://www.sphinx-doc.org/this-is-another-broken-link', 'info': 'br0ken_link matched br[0-9]ken_link from linkcheck_exclude_documents', } in content + + +class CapitalisePathHandler(BaseHTTPRequestHandler): + """Test server that uppercases URL paths via redirects.""" + + protocol_version = 'HTTP/1.1' + + def do_GET(self) -> None: + if self.path.islower(): + # Redirect lowercase paths to uppercase versions + self.send_response(301, 'Moved Permanently') + self.send_header('Location', self.path.upper()) + self.send_header('Content-Length', '0') + self.end_headers() + else: + # Serve uppercase paths + content = b'ok\n\n' + self.send_response(200, 'OK') + self.send_header('Content-Length', str(len(content))) + self.end_headers() + self.wfile.write(content) + + +@pytest.mark.sphinx( + 'linkcheck', + testroot='linkcheck-case-check', + freshenv=True, +) +@pytest.mark.parametrize( + ('case_insensitive_pattern', 'expected_path1', 'expected_path2', 'expected_path3'), + [ + ([], 'redirected', 'redirected', 'working'), # default: case-sensitive + ( + [r'http://localhost:\d+/.*'], + 'working', + 'working', + 'working', + ), # all URLs case-insensitive + ( + [r'http://localhost:\d+/path1'], + 'working', + 'redirected', + 'working', + ), # only path1 case-insensitive + ], +) +def test_linkcheck_case_sensitivity( + app: SphinxTestApp, + case_insensitive_pattern: list[str], + expected_path1: str, + expected_path2: str, + expected_path3: str, +) -> None: + """Test case-sensitive and case-insensitive URL checking.""" + app.config.linkcheck_case_insensitive_urls = case_insensitive_pattern + + with serve_application(app, CapitalisePathHandler) as address: + app.build() + + content = (app.outdir / 'output.json').read_text(encoding='utf8') + rows = [json.loads(x) for x in content.splitlines()] + rowsby = {row['uri']: row for row in rows} + + # Verify expected status for each path + assert rowsby[f'http://{address}/path1']['status'] == expected_path1 + assert rowsby[f'http://{address}/path2']['status'] == expected_path2 + assert rowsby[f'http://{address}/PATH3']['status'] == expected_path3 diff --git a/tests/test_builders/test_build_manpage.py b/tests/test_builders/test_build_manpage.py index 7e796a15142..59ee10cccf5 100644 --- a/tests/test_builders/test_build_manpage.py +++ b/tests/test_builders/test_build_manpage.py @@ -4,7 +4,6 @@ from typing import TYPE_CHECKING -import docutils import pytest from sphinx.builders.manpage import default_man_pages @@ -65,25 +64,7 @@ def test_captioned_code_block(app: SphinxTestApp) -> None: app.build(force_all=True) content = (app.outdir / 'projectnamenotset.1').read_text(encoding='utf8') - if docutils.__version_info__[:2] < (0, 21): - expected = """\ -.sp -caption \\fItest\\fP rb -.INDENT 0.0 -.INDENT 3.5 -.sp -.nf -.ft C -def ruby? - false -end -.ft P -.fi -.UNINDENT -.UNINDENT -""" - else: - expected = """\ + expected = """\ .sp caption \\fItest\\fP rb .INDENT 0.0 diff --git a/tests/test_builders/test_build_warnings.py b/tests/test_builders/test_build_warnings.py index 65e359ad666..874bfe3beb3 100644 --- a/tests/test_builders/test_build_warnings.py +++ b/tests/test_builders/test_build_warnings.py @@ -12,6 +12,9 @@ from sphinx.errors import SphinxError if TYPE_CHECKING: + from collections.abc import Callable + from pathlib import Path + from sphinx.testing.util import SphinxTestApp ENV_WARNINGS = """\ @@ -22,8 +25,6 @@ {root}/index.rst:\\d+: WARNING: invalid single index entry '' \\[index\\] {root}/index.rst:\\d+: WARNING: image file not readable: foo.png \\[image.not_readable\\] {root}/index.rst:\\d+: WARNING: download file not readable: {root}/nonexisting.png \\[download.not_readable\\] -{root}/undecodable.rst:\\d+: WARNING: undecodable source characters, replacing \ -with "\\?": b?'here: >>>(\\\\|/)xbb<<<((\\\\|/)r)?' """ HTML_WARNINGS = ( @@ -117,7 +118,9 @@ def test_texinfo_warnings(app: SphinxTestApp) -> None: _check_warnings(warnings_exp, app.warning.getvalue()) -def test_uncacheable_config_warning(make_app, tmp_path): +def test_uncacheable_config_warning( + make_app: Callable[..., SphinxTestApp], tmp_path: Path +) -> None: """Test that an unpickleable config value raises a warning.""" tmp_path.joinpath('conf.py').write_text( """\ diff --git a/tests/test_builders/xpath_util.py b/tests/test_builders/xpath_util.py index b926c1aefec..6ea0891478d 100644 --- a/tests/test_builders/xpath_util.py +++ b/tests/test_builders/xpath_util.py @@ -68,7 +68,9 @@ def check_xpath( check(nodes) return - rex = re.compile(check) + # https://github.com/astral-sh/ty/issues/117 + # callable(...) does not currently narrow in ty. + rex = re.compile(check) # ty: ignore[no-matching-overload] if be_found: if any(rex.search(_get_text(node)) for node in nodes): return diff --git a/tests/test_command_line.py b/tests/test_command_line.py index 3f35a495fcc..11e3d6a7341 100644 --- a/tests/test_command_line.py +++ b/tests/test_command_line.py @@ -6,6 +6,7 @@ import pytest +from sphinx._cli.util.errors import strip_escape_sequences from sphinx.cmd import make_mode from sphinx.cmd.build import get_parser from sphinx.cmd.make_mode import run_make_mode @@ -150,7 +151,7 @@ def test_build_main_parse_arguments_pos_intermixed( if broken_argparse: with pytest.raises(SystemExit): parse_arguments(args) - stderr = capsys.readouterr().err.splitlines() + stderr = strip_escape_sequences(capsys.readouterr().err).splitlines() assert stderr[-1].endswith('error: unrecognized arguments: filename1 filename2') else: assert parse_arguments(args) == EXPECTED_BUILD_MAIN @@ -178,7 +179,7 @@ def test_make_mode_parse_arguments_pos_last( ] with pytest.raises(SystemExit): run_make_mode(args) - stderr = capsys.readouterr().err.splitlines() + stderr = strip_escape_sequences(capsys.readouterr().err).splitlines() assert stderr[-1].endswith('error: argument --builder/-b: expected one argument') @@ -195,7 +196,7 @@ def test_make_mode_parse_arguments_pos_middle( ] with pytest.raises(SystemExit): run_make_mode(args) - stderr = capsys.readouterr().err.splitlines() + stderr = strip_escape_sequences(capsys.readouterr().err).splitlines() assert stderr[-1].endswith('error: argument --builder/-b: expected one argument') @@ -232,5 +233,5 @@ def test_make_mode_parse_arguments_pos_intermixed( ] with pytest.raises(SystemExit): run_make_mode(args) - stderr = capsys.readouterr().err.splitlines() + stderr = strip_escape_sequences(capsys.readouterr().err).splitlines() assert stderr[-1].endswith('error: argument --builder/-b: expected one argument') diff --git a/tests/test_config/test_config.py b/tests/test_config/test_config.py index d297af6f2ee..f7245b88795 100644 --- a/tests/test_config/test_config.py +++ b/tests/test_config/test_config.py @@ -13,21 +13,19 @@ from sphinx.config import ( ENUM, Config, - _Opt, check_confval_types, is_serializable, ) -from sphinx.deprecation import RemovedInSphinx90Warning from sphinx.errors import ConfigError, ExtensionError, VersionRequirementError +from sphinx.testing.util import SphinxTestApp +from sphinx.util.tags import Tags if TYPE_CHECKING: from collections.abc import Iterable - from typing import TypeAlias + from pathlib import Path - from sphinx.testing.util import SphinxTestApp - - CircularList: TypeAlias = list[int | 'CircularList'] - CircularDict: TypeAlias = dict[str, int | 'CircularDict'] + type CircularList = list[int | 'CircularList'] + type CircularDict = dict[str, int | 'CircularDict'] def check_is_serializable(subject: object, *, circular: bool) -> None: @@ -53,7 +51,8 @@ def test_is_serializable() -> None: subject = [1, [2, {3, 'a'}], {'x': {'y': frozenset((4, 5))}}] check_is_serializable(subject, circular=False) - a, b = [1], [2] # type: (CircularList, CircularList) + a: CircularList = [1] + b: CircularList = [2] a.append(b) b.append(a) check_is_serializable(a, circular=True) @@ -64,19 +63,6 @@ def test_is_serializable() -> None: check_is_serializable(x, circular=True) -def test_config_opt_deprecated(recwarn): - opt = _Opt('default', '', ()) - - with pytest.warns(RemovedInSphinx90Warning): - default, rebuild, valid_types = opt - - with pytest.warns(RemovedInSphinx90Warning): - _ = opt[0] - - with pytest.warns(RemovedInSphinx90Warning): - _ = list(opt) - - @pytest.mark.sphinx( 'html', testroot='config', @@ -139,11 +125,11 @@ def test_core_config(app: SphinxTestApp) -> None: def test_config_not_found(tmp_path): with pytest.raises(ConfigError): - Config.read(tmp_path) + Config.read(tmp_path, overrides={}, tags=Tags()) @pytest.mark.parametrize('protocol', list(range(pickle.HIGHEST_PROTOCOL))) -def test_config_pickle_protocol(tmp_path, protocol: int): +def test_config_pickle_protocol(protocol: int) -> None: config = Config() pickled_config = pickle.loads(pickle.dumps(config, protocol)) @@ -153,7 +139,8 @@ def test_config_pickle_protocol(tmp_path, protocol: int): def test_config_pickle_circular_reference_in_list(): - a, b = [1], [2] # type: (CircularList, CircularList) + a: CircularList = [1] + b: CircularList = [2] a.append(b) b.append(a) @@ -198,9 +185,9 @@ def check( u: list[list[object] | int], v: list[list[object] | int], *, - counter: Counter[type, int] | None = None, + counter: Counter[type] | None = None, guard: frozenset[int] = frozenset(), - ) -> Counter[type, int]: + ) -> Counter[type]: counter = Counter() if counter is None else counter if id(u) in guard and id(v) in guard: @@ -262,7 +249,7 @@ def check( u: dict[str, dict[str, object] | int], v: dict[str, dict[str, object] | int], *, - counter: Counter[type, int] | None = None, + counter: Counter[type] | None = None, guard: frozenset[int] = frozenset(), ) -> Counter: counter = Counter() if counter is None else counter @@ -394,12 +381,12 @@ def test_errors_warnings(logger, tmp_path): # test the error for syntax errors in the config file (tmp_path / 'conf.py').write_text('project = \n', encoding='ascii') with pytest.raises(ConfigError) as excinfo: - Config.read(tmp_path, {}, None) + Config.read(tmp_path, overrides={}, tags=Tags()) assert 'conf.py' in str(excinfo.value) # test the automatic conversion of 2.x only code in configs (tmp_path / 'conf.py').write_text('project = u"Jägermeister"\n', encoding='utf8') - cfg = Config.read(tmp_path, {}, None) + cfg = Config.read(tmp_path, overrides={}, tags=Tags()) assert cfg.project == 'Jägermeister' assert logger.called is False @@ -440,7 +427,7 @@ def test_config_eol(logger, tmp_path): configfile = tmp_path / 'conf.py' for eol in (b'\n', b'\r\n'): configfile.write_bytes(b'project = "spam"' + eol) - cfg = Config.read(tmp_path, {}, None) + cfg = Config.read(tmp_path, overrides={}, tags=Tags()) assert cfg.project == 'spam' assert logger.called is False @@ -678,7 +665,7 @@ def test_conf_py_language_none(tmp_path): (tmp_path / 'conf.py').write_text('language = None', encoding='utf-8') # When we load conf.py into a Config object - cfg = Config.read(tmp_path, {}, None) + cfg = Config.read(tmp_path, overrides={}, tags=Tags()) # Then the language is coerced to English assert cfg.language == 'en' @@ -691,7 +678,7 @@ def test_conf_py_language_none_warning(logger, tmp_path): (tmp_path / 'conf.py').write_text('language = None', encoding='utf-8') # When we load conf.py into a Config object - Config.read(tmp_path, {}, None) + Config.read(tmp_path, overrides={}, tags=Tags()) # Then a warning is raised assert logger.warning.called @@ -708,7 +695,7 @@ def test_conf_py_no_language(tmp_path): (tmp_path / 'conf.py').touch() # When we load conf.py into a Config object - cfg = Config.read(tmp_path, {}, None) + cfg = Config.read(tmp_path, overrides={}, tags=Tags()) # Then the language is coerced to English assert cfg.language == 'en' @@ -720,7 +707,7 @@ def test_conf_py_nitpick_ignore_list(tmp_path): (tmp_path / 'conf.py').touch() # When we load conf.py into a Config object - cfg = Config.read(tmp_path, {}, None) + cfg = Config.read(tmp_path, overrides={}, tags=Tags()) # Then the default nitpick_ignore[_regex] is an empty list assert cfg.nitpick_ignore == [] @@ -810,3 +797,14 @@ def test_root_doc_and_master_doc_are_synchronized() -> None: c.root_doc = '1234' assert c.master_doc == '1234' assert c.root_doc == c.master_doc + + +def test_source_encoding_deprecation(tmp_path: Path) -> None: + (tmp_path / 'conf.py').touch() + app = SphinxTestApp( + buildername='dummy', + srcdir=tmp_path, + confoverrides={'source_encoding': 'latin-1'}, + ) + expected = 'Support for source encodings other than UTF-8 is deprecated and will be removed' + assert expected in app.warning.getvalue() diff --git a/tests/test_directives/test_directive_code.py b/tests/test_directives/test_directive_code.py index 625d15c1f31..3af77fb5b76 100644 --- a/tests/test_directives/test_directive_code.py +++ b/tests/test_directives/test_directive_code.py @@ -20,17 +20,17 @@ @pytest.fixture(scope='module') -def testroot(rootdir): +def testroot(rootdir: Path) -> Path: testroot_path = rootdir / 'test-directive-code' return testroot_path @pytest.fixture(scope='module') -def literal_inc_path(testroot): +def literal_inc_path(testroot: Path) -> Path: return testroot / 'literal.inc' -def test_LiteralIncludeReader(literal_inc_path): +def test_LiteralIncludeReader(literal_inc_path: Path) -> None: options = {'lineno-match': True} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) content, lines = reader.read() @@ -39,7 +39,7 @@ def test_LiteralIncludeReader(literal_inc_path): assert reader.lineno_start == 1 -def test_LiteralIncludeReader_lineno_start(literal_inc_path): +def test_LiteralIncludeReader_lineno_start(literal_inc_path: Path) -> None: options = {'lineno-start': 4} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) content, lines = reader.read() @@ -48,40 +48,40 @@ def test_LiteralIncludeReader_lineno_start(literal_inc_path): assert reader.lineno_start == 4 -def test_LiteralIncludeReader_pyobject1(literal_inc_path): +def test_LiteralIncludeReader_pyobject1(literal_inc_path: Path) -> None: options = {'lineno-match': True, 'pyobject': 'Foo'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'class Foo:\n pass\n' assert reader.lineno_start == 5 -def test_LiteralIncludeReader_pyobject2(literal_inc_path): +def test_LiteralIncludeReader_pyobject2(literal_inc_path: Path) -> None: options = {'pyobject': 'Bar'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'class Bar:\n def baz():\n pass\n' assert reader.lineno_start == 1 # no lineno-match -def test_LiteralIncludeReader_pyobject3(literal_inc_path): +def test_LiteralIncludeReader_pyobject3(literal_inc_path: Path) -> None: options = {'pyobject': 'Bar.baz'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == ' def baz():\n pass\n' -def test_LiteralIncludeReader_pyobject_and_lines(literal_inc_path): +def test_LiteralIncludeReader_pyobject_and_lines(literal_inc_path: Path) -> None: options = {'pyobject': 'Bar', 'lines': '2-'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == ' def baz():\n pass\n' -def test_LiteralIncludeReader_lines1(literal_inc_path): +def test_LiteralIncludeReader_lines1(literal_inc_path: Path) -> None: options = {'lines': '1-3'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == ( '# Literally included file using Python highlighting\n' '\n' @@ -89,10 +89,10 @@ def test_LiteralIncludeReader_lines1(literal_inc_path): ) -def test_LiteralIncludeReader_lines2(literal_inc_path): +def test_LiteralIncludeReader_lines2(literal_inc_path: Path) -> None: options = {'lines': '1,3,5'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == ( '# Literally included file using Python highlighting\n' 'foo = "Including Unicode characters: üöä"\n' @@ -100,16 +100,18 @@ def test_LiteralIncludeReader_lines2(literal_inc_path): ) -def test_LiteralIncludeReader_lines_and_lineno_match1(literal_inc_path): +def test_LiteralIncludeReader_lines_and_lineno_match1(literal_inc_path: Path) -> None: options = {'lines': '3-5', 'lineno-match': True} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'foo = "Including Unicode characters: üöä"\n\nclass Foo:\n' assert reader.lineno_start == 3 @pytest.mark.sphinx('html', testroot='root') # init locale for errors -def test_LiteralIncludeReader_lines_and_lineno_match2(literal_inc_path, app): +def test_LiteralIncludeReader_lines_and_lineno_match2( + literal_inc_path: Path, app: SphinxTestApp +) -> None: options = {'lines': '0,3,5', 'lineno-match': True} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) with pytest.raises( @@ -120,7 +122,9 @@ def test_LiteralIncludeReader_lines_and_lineno_match2(literal_inc_path, app): @pytest.mark.sphinx('html', testroot='root') # init locale for errors -def test_LiteralIncludeReader_lines_and_lineno_match3(literal_inc_path, app): +def test_LiteralIncludeReader_lines_and_lineno_match3( + literal_inc_path: Path, app: SphinxTestApp +) -> None: options = {'lines': '100-', 'lineno-match': True} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) with pytest.raises( @@ -130,23 +134,23 @@ def test_LiteralIncludeReader_lines_and_lineno_match3(literal_inc_path, app): reader.read() -def test_LiteralIncludeReader_start_at(literal_inc_path): +def test_LiteralIncludeReader_start_at(literal_inc_path: Path) -> None: options = {'lineno-match': True, 'start-at': 'Foo', 'end-at': 'Bar'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'class Foo:\n pass\n\nclass Bar:\n' assert reader.lineno_start == 5 -def test_LiteralIncludeReader_start_after(literal_inc_path): +def test_LiteralIncludeReader_start_after(literal_inc_path: Path) -> None: options = {'lineno-match': True, 'start-after': 'Foo', 'end-before': 'Bar'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == ' pass\n\n' assert reader.lineno_start == 6 -def test_LiteralIncludeReader_start_after_and_lines(literal_inc_path): +def test_LiteralIncludeReader_start_after_and_lines(literal_inc_path: Path) -> None: options = { 'lineno-match': True, 'lines': '6-', @@ -154,20 +158,20 @@ def test_LiteralIncludeReader_start_after_and_lines(literal_inc_path): 'end-before': 'comment', } reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == '\nclass Bar:\n def baz():\n pass\n\n' assert reader.lineno_start == 7 -def test_LiteralIncludeReader_start_at_and_lines(literal_inc_path): +def test_LiteralIncludeReader_start_at_and_lines(literal_inc_path: Path) -> None: options = {'lines': '2, 3, 5', 'start-at': 'foo', 'end-before': '#'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == '\nclass Foo:\n\n' assert reader.lineno_start == 1 -def test_LiteralIncludeReader_missing_start_and_end(literal_inc_path): +def test_LiteralIncludeReader_missing_start_and_end(literal_inc_path: Path) -> None: options = {'start-at': 'NOTHING'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) with pytest.raises(ValueError, match='start-at pattern not found: NOTHING'): @@ -189,49 +193,51 @@ def test_LiteralIncludeReader_missing_start_and_end(literal_inc_path): reader.read() -def test_LiteralIncludeReader_end_before(literal_inc_path): +def test_LiteralIncludeReader_end_before(literal_inc_path: Path) -> None: options = {'end-before': 'nclud'} # *nclud* matches first and third lines. reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == '# Literally included file using Python highlighting\n\n' -def test_LiteralIncludeReader_prepend(literal_inc_path): +def test_LiteralIncludeReader_prepend(literal_inc_path: Path) -> None: options = {'lines': '1', 'prepend': 'Hello', 'append': 'Sphinx'} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == ( 'Hello\n# Literally included file using Python highlighting\nSphinx\n' ) -def test_LiteralIncludeReader_dedent(literal_inc_path): +def test_LiteralIncludeReader_dedent(literal_inc_path: Path) -> None: # dedent: 2 options = {'lines': '9-11', 'dedent': 2} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == ' def baz():\n pass\n\n' # dedent: 4 options = {'lines': '9-11', 'dedent': 4} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'def baz():\n pass\n\n' # dedent: 6 options = {'lines': '9-11', 'dedent': 6} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'f baz():\n pass\n\n' # dedent: None options = {'lines': '9-11', 'dedent': None} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'def baz():\n pass\n\n' -def test_LiteralIncludeReader_dedent_and_append_and_prepend(literal_inc_path): +def test_LiteralIncludeReader_dedent_and_append_and_prepend( + literal_inc_path: Path, +) -> None: # dedent: 2 options = { 'lines': '9-11', @@ -240,36 +246,36 @@ def test_LiteralIncludeReader_dedent_and_append_and_prepend(literal_inc_path): 'append': '# comment', } reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'class Foo:\n def baz():\n pass\n\n# comment\n' -def test_LiteralIncludeReader_tabwidth(testroot): +def test_LiteralIncludeReader_tabwidth(testroot: Path) -> None: # tab-width: 4 options = {'tab-width': 4, 'pyobject': 'Qux'} reader = LiteralIncludeReader(testroot / 'target.py', options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'class Qux:\n def quux(self):\n pass\n' # tab-width: 8 options = {'tab-width': 8, 'pyobject': 'Qux'} reader = LiteralIncludeReader(testroot / 'target.py', options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'class Qux:\n def quux(self):\n pass\n' -def test_LiteralIncludeReader_tabwidth_dedent(testroot): +def test_LiteralIncludeReader_tabwidth_dedent(testroot: Path) -> None: options = {'tab-width': 4, 'dedent': 4, 'pyobject': 'Qux.quux'} reader = LiteralIncludeReader(testroot / 'target.py', options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == 'def quux(self):\n pass\n' -def test_LiteralIncludeReader_diff(testroot, literal_inc_path): +def test_LiteralIncludeReader_diff(testroot: Path, literal_inc_path: Path) -> None: literal_diff_path = testroot / 'literal-diff.inc' options = {'diff': literal_diff_path} reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG) - content, lines = reader.read() + content, _lines = reader.read() assert content == ( f'--- {literal_diff_path}\n' f'+++ {literal_inc_path}\n' diff --git a/tests/test_directives/test_directive_object_description.py b/tests/test_directives/test_directive_object_description.py index 210b9aac381..3a21595bea8 100644 --- a/tests/test_directives/test_directive_object_description.py +++ b/tests/test_directives/test_directive_object_description.py @@ -9,9 +9,10 @@ from docutils import nodes from sphinx import addnodes -from sphinx.io import create_publisher from sphinx.testing import restructuredtext -from sphinx.util.docutils import sphinx_domains +from sphinx.util.docutils import _parse_str_to_doctree + +from tests.utils import extract_node if TYPE_CHECKING: from sphinx.application import Sphinx @@ -22,12 +23,22 @@ def _doctree_for_test( app: Sphinx, env: BuildEnvironment, docname: str ) -> nodes.document: + config = app.config + registry = app.registry + + filename = env.doc2path(docname) + content = filename.read_text(encoding='utf-8') + env.prepare_settings(docname) - publisher = create_publisher(app, 'restructuredtext') - with sphinx_domains(env): - publisher.set_source(source_path=str(env.doc2path(docname))) - publisher.publish() - return publisher.document + parser = registry.create_source_parser('restructuredtext', config=config, env=env) + return _parse_str_to_doctree( + content, + filename=filename, + default_settings={'env': env}, + env=env, + parser=parser, + transforms=registry.get_transforms(), + ) @pytest.mark.sphinx('text', testroot='object-description-sections') @@ -49,13 +60,13 @@ def test_object_description_sections(app: SphinxTestApp) -> None: assert isinstance(doctree[0], addnodes.index) assert isinstance(doctree[1], addnodes.desc) - assert isinstance(doctree[1][0], addnodes.desc_signature) - assert isinstance(doctree[1][1], addnodes.desc_content) - assert isinstance(doctree[1][1][0], nodes.section) - assert isinstance(doctree[1][1][0][0], nodes.title) - assert doctree[1][1][0][0][0] == 'Overview' - assert isinstance(doctree[1][1][0][1], nodes.paragraph) - assert doctree[1][1][0][1][0] == 'Lorem ipsum dolar sit amet' + assert isinstance(extract_node(doctree, 1, 0), addnodes.desc_signature) + assert isinstance(extract_node(doctree, 1, 1), addnodes.desc_content) + assert isinstance(extract_node(doctree, 1, 1, 0), nodes.section) + assert isinstance(extract_node(doctree, 1, 1, 0, 0), nodes.title) + assert extract_node(doctree, 1, 1, 0, 0, 0) == 'Overview' + assert isinstance(extract_node(doctree, 1, 1, 0, 1), nodes.paragraph) + assert extract_node(doctree, 1, 1, 0, 1, 0) == 'Lorem ipsum dolar sit amet' @pytest.mark.sphinx('html', testroot='_blank') diff --git a/tests/test_directives/test_directive_only.py b/tests/test_directives/test_directive_only.py index 9e62f4cb3eb..d5451c6b7cc 100644 --- a/tests/test_directives/test_directive_only.py +++ b/tests/test_directives/test_directive_only.py @@ -9,44 +9,55 @@ from docutils import nodes if TYPE_CHECKING: + from typing import Any + from sphinx.testing.util import SphinxTestApp @pytest.mark.sphinx('text', testroot='directive-only') def test_sectioning(app: SphinxTestApp) -> None: - def getsects(section): - if not isinstance(section, nodes.section): - return [getsects(n) for n in section.children] - title = section.next_node(nodes.title).astext().strip() - subsects = [] - children = section.children[:] - while children: - node = children.pop(0) - if isinstance(node, nodes.section): - subsects.append(node) - continue - children = list(node.children) + children - return [title, [getsects(subsect) for subsect in subsects]] - - def testsects(prefix, sects, indent=0): - title = sects[0] - parent_num = title.split()[0] - assert prefix == parent_num, f'Section out of place: {title!r}' - for i, subsect in enumerate(sects[1]): - num = subsect[0].split()[0] - assert re.match('[0-9]+[.0-9]*[.]', num), ( - f'Unnumbered section: {subsect[0]!r}' - ) - testsects(prefix + str(i + 1) + '.', subsect, indent + 4) - app.build(filenames=[app.srcdir / 'only.rst']) doctree = app.env.get_doctree('only') app.env.apply_post_transforms(doctree, 'only') - parts = [getsects(n) for n in doctree.children if isinstance(n, nodes.section)] - for i, s in enumerate(parts): - testsects(str(i + 1) + '.', s, 4) - actual_headings = '\n'.join(p[0] for p in parts) + parts = [_get_sections(n) for n in doctree.children if isinstance(n, nodes.section)] + for i, section in enumerate(parts): + _test_sections(f'{i + 1}.', section, 4) + actual_headings = '\n'.join(p[0] for p in parts) # type: ignore[misc] assert len(parts) == 4, ( f'Expected 4 document level headings, got:\n{actual_headings}' ) + + +def _get_sections(section: nodes.Node) -> list[str | list[Any]]: + if not isinstance(section, nodes.section): + return list(map(_get_sections, section.children)) + next_title_node = section.next_node(nodes.title) + assert next_title_node is not None + title = next_title_node.astext().strip() + subsections = [] + children = section.children.copy() + while children: + node = children.pop(0) + if isinstance(node, nodes.section): + subsections.append(node) + continue + children = list(node.children) + children + return [title, list(map(_get_sections, subsections))] + + +def _test_sections( + prefix: str, sections: list[str | list[Any]], indent: int = 0 +) -> None: + title = sections[0] + assert isinstance(title, str) + parent_num = title.partition(' ')[0] + assert prefix == parent_num, f'Section out of place: {title!r}' + for i, subsection in enumerate(sections[1]): + subsection_title = subsection[0] + assert isinstance(subsection_title, str) + num = subsection_title.partition(' ')[0] + assert re.match('[0-9]+[.0-9]*[.]', num), ( + f'Unnumbered section: {subsection[0]!r}' + ) + _test_sections(f'{prefix}{i + 1}.', subsection, indent + 4) diff --git a/tests/test_directives/test_directive_other.py b/tests/test_directives/test_directive_other.py index 48f8c1698c8..1aa370cce8d 100644 --- a/tests/test_directives/test_directive_other.py +++ b/tests/test_directives/test_directive_other.py @@ -12,6 +12,8 @@ from sphinx.testing import restructuredtext from sphinx.testing.util import assert_node +from tests.utils import extract_node + if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp @@ -24,7 +26,7 @@ def test_toctree(app): doctree = restructuredtext.parse(app, text, 'index') assert_node(doctree, [nodes.document, nodes.compound, addnodes.toctree]) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), entries=[(None, 'foo'), (None, 'bar/index'), (None, 'baz')], includefiles=['foo', 'bar/index', 'baz'], ) @@ -38,7 +40,7 @@ def test_relative_toctree(app): doctree = restructuredtext.parse(app, text, 'bar/index') assert_node(doctree, [nodes.document, nodes.compound, addnodes.toctree]) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), entries=[ (None, 'bar/bar_1'), (None, 'bar/bar_2'), @@ -63,7 +65,7 @@ def test_toctree_urls_and_titles(app): doctree = restructuredtext.parse(app, text, 'index') assert_node(doctree, [nodes.document, nodes.compound, addnodes.toctree]) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), entries=[ ('Sphinx', 'https://www.sphinx-doc.org/'), (None, 'https://readthedocs.org/'), @@ -81,7 +83,7 @@ def test_toctree_glob(app): doctree = restructuredtext.parse(app, text, 'index') assert_node(doctree, [nodes.document, nodes.compound, addnodes.toctree]) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), entries=[(None, 'baz'), (None, 'foo'), (None, 'quux')], includefiles=['baz', 'foo', 'quux'], ) @@ -93,7 +95,7 @@ def test_toctree_glob(app): doctree = restructuredtext.parse(app, text, 'index') assert_node(doctree, [nodes.document, nodes.compound, addnodes.toctree]) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), entries=[(None, 'foo'), (None, 'baz'), (None, 'quux')], includefiles=['foo', 'baz', 'quux'], ) @@ -105,7 +107,7 @@ def test_toctree_glob(app): doctree = restructuredtext.parse(app, text, 'index') assert_node(doctree, [nodes.document, nodes.compound, addnodes.toctree]) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), entries=[(None, 'baz'), (None, 'foo'), (None, 'quux'), (None, 'foo')], includefiles=['baz', 'foo', 'quux', 'foo'], ) @@ -119,7 +121,7 @@ def test_toctree_glob_and_url(app): doctree = restructuredtext.parse(app, text, 'index') assert_node(doctree, [nodes.document, nodes.compound, addnodes.toctree]) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), entries=[(None, 'https://example.com/?q=sphinx')], includefiles=[], ) @@ -133,7 +135,7 @@ def test_reversed_toctree(app): doctree = restructuredtext.parse(app, text, 'index') assert_node(doctree, [nodes.document, nodes.compound, addnodes.toctree]) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), entries=[(None, 'baz'), (None, 'bar/index'), (None, 'foo')], includefiles=['baz', 'bar/index', 'foo'], ) @@ -145,6 +147,7 @@ def test_toctree_class(app): app.env.find_files(app.config, app.builder) doctree = restructuredtext.parse(app, text, 'index') assert_node(doctree, [nodes.document, nodes.compound, addnodes.toctree]) + assert isinstance(doctree[0], nodes.compound) assert doctree[0].attributes['classes'] == ['toctree-wrapper', 'custom-toc'] @@ -156,7 +159,7 @@ def test_toctree_twice(app): doctree = restructuredtext.parse(app, text, 'index') assert_node(doctree, [nodes.document, nodes.compound, addnodes.toctree]) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), entries=[(None, 'foo'), (None, 'foo')], includefiles=['foo', 'foo'], ) @@ -207,5 +210,5 @@ def source_read_handler(_app, _relative_path, _parent_docname, source): doctree = restructuredtext.parse(app, text, 'index') assert_node(doctree, addnodes.document) assert len(doctree.children) == 3 - assert_node(doctree.children[1], nodes.paragraph) + assert isinstance(doctree.children[1], nodes.paragraph) assert doctree.children[1].rawsource == 'The amazing foo.' diff --git a/tests/test_directives/test_directive_patch.py b/tests/test_directives/test_directive_patch.py index c24eb5a7c6d..c927db13d4a 100644 --- a/tests/test_directives/test_directive_patch.py +++ b/tests/test_directives/test_directive_patch.py @@ -47,8 +47,13 @@ def test_code_directive(app: SphinxTestApp) -> None: ) +def _as_element(node: nodes.Node) -> nodes.Element: + assert isinstance(node, nodes.Element) + return node + + @pytest.mark.sphinx('html', testroot='directive-csv-table') -def test_csv_table_directive(app): +def test_csv_table_directive(app: SphinxTestApp) -> None: # relative path from current document text = '.. csv-table::\n :file: example.csv\n' doctree = restructuredtext.parse(app, text, docname='subdir/index') @@ -62,8 +67,12 @@ def test_csv_table_directive(app): ], ), ) + table = _as_element(doctree[0]) + tgroup = _as_element(table[0]) + tbody = _as_element(tgroup[3]) + first_row = _as_element(tbody[0]) assert_node( - doctree[0][0][3][0], + first_row, ( [nodes.entry, nodes.paragraph, 'FOO'], [nodes.entry, nodes.paragraph, 'BAR'], @@ -84,8 +93,12 @@ def test_csv_table_directive(app): ], ), ) + table = _as_element(doctree[0]) + tgroup = _as_element(table[0]) + tbody = _as_element(tgroup[3]) + first_row = _as_element(tbody[0]) assert_node( - doctree[0][0][3][0], + first_row, ( [nodes.entry, nodes.paragraph, 'foo'], [nodes.entry, nodes.paragraph, 'bar'], diff --git a/tests/test_directives/test_directives_no_typesetting.py b/tests/test_directives/test_directives_no_typesetting.py index 68df4fbefcf..bfc32ef1114 100644 --- a/tests/test_directives/test_directives_no_typesetting.py +++ b/tests/test_directives/test_directives_no_typesetting.py @@ -9,6 +9,12 @@ from sphinx.testing import restructuredtext from sphinx.testing.util import assert_node +TYPE_CHECKING = False +if TYPE_CHECKING: + from sphinx.testing.util import SphinxTestApp + + type _IndexEntry = tuple[str, str, str, str, str | None] + DOMAINS = [ # directive, no-index, no-index-entry, signature of f, signature of g, index entry of g ( @@ -76,8 +82,14 @@ ) @pytest.mark.sphinx('html', testroot='root') def test_object_description_no_typesetting( - app, directive, no_index, no_index_entry, sig_f, sig_g, index_g -): + app: SphinxTestApp, + directive: str, + no_index: bool, + no_index_entry: bool, + sig_f: str, + sig_g: str, + index_g: _IndexEntry, +) -> None: text = f'.. {directive}:: {sig_f}\n :no-typesetting:\n' doctree = restructuredtext.parse(app, text) assert_node(doctree, (addnodes.index, nodes.target)) @@ -89,8 +101,14 @@ def test_object_description_no_typesetting( ) @pytest.mark.sphinx('html', testroot='root') def test_object_description_no_typesetting_twice( - app, directive, no_index, no_index_entry, sig_f, sig_g, index_g -): + app: SphinxTestApp, + directive: str, + no_index: bool, + no_index_entry: bool, + sig_f: str, + sig_g: str, + index_g: _IndexEntry, +) -> None: text = ( f'.. {directive}:: {sig_f}\n' f' :no-typesetting:\n' @@ -108,8 +126,14 @@ def test_object_description_no_typesetting_twice( ) @pytest.mark.sphinx('html', testroot='root') def test_object_description_no_typesetting_noindex_orig( - app, directive, no_index, no_index_entry, sig_f, sig_g, index_g -): + app: SphinxTestApp, + directive: str, + no_index: bool, + no_index_entry: bool, + sig_f: str, + sig_g: str, + index_g: _IndexEntry, +) -> None: if not no_index: pytest.skip(f'{directive} does not support :no-index: option') text = f'.. {directive}:: {sig_f}\n :no-index:\n.. {directive}:: {sig_g}\n' @@ -124,8 +148,14 @@ def test_object_description_no_typesetting_noindex_orig( ) @pytest.mark.sphinx('html', testroot='root') def test_object_description_no_typesetting_noindex( - app, directive, no_index, no_index_entry, sig_f, sig_g, index_g -): + app: SphinxTestApp, + directive: str, + no_index: bool, + no_index_entry: bool, + sig_f: str, + sig_g: str, + index_g: _IndexEntry, +) -> None: if not no_index: pytest.skip(f'{directive} does not support :no-index: option') text = ( @@ -147,8 +177,14 @@ def test_object_description_no_typesetting_noindex( ) @pytest.mark.sphinx('html', testroot='root') def test_object_description_no_typesetting_no_index_entry( - app, directive, no_index, no_index_entry, sig_f, sig_g, index_g -): + app: SphinxTestApp, + directive: str, + no_index: bool, + no_index_entry: bool, + sig_f: str, + sig_g: str, + index_g: _IndexEntry, +) -> None: if not no_index_entry: pytest.skip(f'{directive} does not support :no-index-entry: option') text = ( @@ -170,8 +206,14 @@ def test_object_description_no_typesetting_no_index_entry( ) @pytest.mark.sphinx('html', testroot='root') def test_object_description_no_typesetting_code( - app, directive, no_index, no_index_entry, sig_f, sig_g, index_g -): + app: SphinxTestApp, + directive: str, + no_index: bool, + no_index_entry: bool, + sig_f: str, + sig_g: str, + index_g: _IndexEntry, +) -> None: text = ( f'.. {directive}:: {sig_f}\n' f' :no-typesetting:\n' @@ -201,8 +243,14 @@ def test_object_description_no_typesetting_code( ) @pytest.mark.sphinx('html', testroot='root') def test_object_description_no_typesetting_heading( - app, directive, no_index, no_index_entry, sig_f, sig_g, index_g -): + app: SphinxTestApp, + directive: str, + no_index: bool, + no_index_entry: bool, + sig_f: str, + sig_g: str, + index_g: _IndexEntry, +) -> None: text = ( f'.. {directive}:: {sig_f}\n' f' :no-typesetting:\n' diff --git a/tests/test_domains/test_domain_c.py b/tests/test_domains/test_domain_c.py index 23ee25ffa83..07421eb6c2d 100644 --- a/tests/test_domains/test_domain_c.py +++ b/tests/test_domains/test_domain_c.py @@ -31,6 +31,8 @@ from sphinx.util.cfamily import DefinitionError from sphinx.writers.text import STDINDENT +from tests.utils import extract_node + if TYPE_CHECKING: from io import StringIO @@ -700,14 +702,14 @@ def test_extra_keywords() -> None: # raise DefinitionError -def split_warnings(warning: StringIO): +def split_warnings(warning: StringIO) -> list[str]: ws = warning.getvalue().split('\n') assert len(ws) >= 1 assert ws[-1] == '' return ws[:-1] -def filter_warnings(warning: StringIO, file): +def filter_warnings(warning: StringIO, file: str) -> list[str]: lines = split_warnings(warning) res = [ l @@ -989,7 +991,7 @@ def test_cfunction_signature_with_c_maximum_signature_line_length_equal(app): no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -1001,7 +1003,9 @@ def test_cfunction_signature_with_c_maximum_signature_line_length_equal(app): ], ) assert_node( - doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=False + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=False, ) @@ -1050,7 +1054,7 @@ def test_cfunction_signature_with_c_maximum_signature_line_length_force_single(a no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -1062,7 +1066,9 @@ def test_cfunction_signature_with_c_maximum_signature_line_length_force_single(a ], ) assert_node( - doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=False + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=False, ) @@ -1111,7 +1117,7 @@ def test_cfunction_signature_with_c_maximum_signature_line_length_break(app): no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -1122,7 +1128,11 @@ def test_cfunction_signature_with_c_maximum_signature_line_length_break(app): ), ], ) - assert_node(doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=True) + assert_node( + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=True, + ) @pytest.mark.sphinx( @@ -1170,7 +1180,7 @@ def test_cfunction_signature_with_maximum_signature_line_length_equal(app): no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -1182,7 +1192,9 @@ def test_cfunction_signature_with_maximum_signature_line_length_equal(app): ], ) assert_node( - doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=False + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=False, ) @@ -1231,7 +1243,7 @@ def test_cfunction_signature_with_maximum_signature_line_length_force_single(app no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -1243,7 +1255,9 @@ def test_cfunction_signature_with_maximum_signature_line_length_force_single(app ], ) assert_node( - doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=False + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=False, ) @@ -1292,7 +1306,7 @@ def test_cfunction_signature_with_maximum_signature_line_length_break(app): no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -1303,7 +1317,11 @@ def test_cfunction_signature_with_maximum_signature_line_length_break(app): ), ], ) - assert_node(doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=True) + assert_node( + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=True, + ) @pytest.mark.sphinx( @@ -1350,7 +1368,7 @@ def test_c_maximum_signature_line_length_overrides_global(app): no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -1362,7 +1380,9 @@ def test_c_maximum_signature_line_length_overrides_global(app): ], ) assert_node( - doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=False + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=False, ) diff --git a/tests/test_domains/test_domain_cpp.py b/tests/test_domains/test_domain_cpp.py index 88505a4aa91..856f904430c 100644 --- a/tests/test_domains/test_domain_cpp.py +++ b/tests/test_domains/test_domain_cpp.py @@ -32,9 +32,13 @@ from sphinx.util.cfamily import DefinitionError, NoOldIdError from sphinx.writers.text import STDINDENT +from tests.utils import extract_node + if TYPE_CHECKING: from io import StringIO + from sphinx.domains.cpp._ast import ASTTemplateParamType + def parse(name, string): class Config: @@ -47,7 +51,8 @@ class Config: parser.assert_end() # The scopedness would usually have been set by CPPEnumObject if name == 'enum': - ast.scoped = None # simulate unscoped enum + # simulate unscoped enum + ast.scoped = None # ty: ignore[unresolved-attribute] return ast @@ -1515,8 +1520,8 @@ def test_domain_cpp_ast_xref_parsing() -> None: ('template class...', True), ], ) -def test_domain_cpp_template_parameters_is_pack(param: str, is_pack: bool): - def parse_template_parameter(param: str): +def test_domain_cpp_template_parameters_is_pack(param: str, is_pack: bool) -> None: + def parse_template_parameter(param: str) -> ASTTemplateParamType: ast = parse('type', 'template<' + param + '> X') return ast.templatePrefix.templates[0].params[0] @@ -1531,7 +1536,7 @@ def parse_template_parameter(param: str): # raise DefinitionError -def filter_warnings(warning: StringIO, file): +def filter_warnings(warning: StringIO, file: str) -> list[str]: lines = warning.getvalue().split('\n') res = [ l @@ -2039,7 +2044,7 @@ def test_cpp_function_signature_with_cpp_maximum_signature_line_length_equal(app no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -2051,7 +2056,9 @@ def test_cpp_function_signature_with_cpp_maximum_signature_line_length_equal(app ], ) assert_node( - doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=False + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=False, ) @@ -2102,7 +2109,7 @@ def test_cpp_function_signature_with_cpp_maximum_signature_line_length_force_sin no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -2114,7 +2121,9 @@ def test_cpp_function_signature_with_cpp_maximum_signature_line_length_force_sin ], ) assert_node( - doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=False + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=False, ) @@ -2163,7 +2172,7 @@ def test_cpp_function_signature_with_cpp_maximum_signature_line_length_break(app no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -2174,7 +2183,11 @@ def test_cpp_function_signature_with_cpp_maximum_signature_line_length_break(app ), ], ) - assert_node(doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=True) + assert_node( + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=True, + ) @pytest.mark.sphinx( @@ -2222,7 +2235,7 @@ def test_cpp_function_signature_with_maximum_signature_line_length_equal(app): no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -2234,7 +2247,9 @@ def test_cpp_function_signature_with_maximum_signature_line_length_equal(app): ], ) assert_node( - doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=False + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=False, ) @@ -2283,7 +2298,7 @@ def test_cpp_function_signature_with_maximum_signature_line_length_force_single( no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -2295,7 +2310,9 @@ def test_cpp_function_signature_with_maximum_signature_line_length_force_single( ], ) assert_node( - doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=False + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=False, ) @@ -2344,7 +2361,7 @@ def test_cpp_function_signature_with_maximum_signature_line_length_break(app): no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -2355,7 +2372,11 @@ def test_cpp_function_signature_with_maximum_signature_line_length_break(app): ), ], ) - assert_node(doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=True) + assert_node( + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=True, + ) @pytest.mark.sphinx( @@ -2402,7 +2423,7 @@ def test_cpp_maximum_signature_line_length_overrides_global(app): no_index=False, ) assert_node( - doctree[1][0][0][3], + extract_node(doctree, 1, 0, 0, 3), [ desc_parameterlist, desc_parameter, @@ -2414,7 +2435,9 @@ def test_cpp_maximum_signature_line_length_overrides_global(app): ], ) assert_node( - doctree[1][0][0][3], desc_parameterlist, multi_line_parameter_list=False + extract_node(doctree, 1, 0, 0, 3), + desc_parameterlist, + multi_line_parameter_list=False, ) diff --git a/tests/test_domains/test_domain_js.py b/tests/test_domains/test_domain_js.py index d43c4b03ce1..54baa534139 100644 --- a/tests/test_domains/test_domain_js.py +++ b/tests/test_domains/test_domain_js.py @@ -26,6 +26,12 @@ from sphinx.testing.util import assert_node from sphinx.writers.text import STDINDENT +from tests.utils import extract_node + +TYPE_CHECKING = False +if TYPE_CHECKING: + from sphinx.testing.util import SphinxTestApp + @pytest.mark.sphinx('dummy', testroot='domain-js') def test_domain_js_xrefs(app): @@ -235,7 +241,7 @@ def test_js_function(app): ), ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [ desc_parameterlist, ( @@ -395,10 +401,14 @@ def test_jsfunction_signature_with_javascript_maximum_signature_line_length_equa no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [desc_parameterlist, desc_parameter, ([desc_sig_name, 'name'])], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=False) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=False, + ) @pytest.mark.sphinx( @@ -441,10 +451,14 @@ def test_jsfunction_signature_with_javascript_maximum_signature_line_length_forc no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [desc_parameterlist, desc_parameter, ([desc_sig_name, 'names'])], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=False) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=False, + ) @pytest.mark.sphinx( @@ -485,10 +499,14 @@ def test_jsfunction_signature_with_javascript_maximum_signature_line_length_brea no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [desc_parameterlist, desc_parameter, ([desc_sig_name, 'names'])], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=True) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=True, + ) @pytest.mark.sphinx( @@ -529,10 +547,14 @@ def test_jsfunction_signature_with_maximum_signature_line_length_equal(app): no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [desc_parameterlist, desc_parameter, ([desc_sig_name, 'name'])], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=False) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=False, + ) @pytest.mark.sphinx( @@ -573,10 +595,14 @@ def test_jsfunction_signature_with_maximum_signature_line_length_force_single(ap no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [desc_parameterlist, desc_parameter, ([desc_sig_name, 'names'])], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=False) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=False, + ) @pytest.mark.sphinx( @@ -617,10 +643,14 @@ def test_jsfunction_signature_with_maximum_signature_line_length_break(app): no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [desc_parameterlist, desc_parameter, ([desc_sig_name, 'names'])], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=True) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=True, + ) @pytest.mark.sphinx( @@ -657,8 +687,12 @@ def test_javascript_maximum_signature_line_length_overrides_global(app): no_index=False, ) expected_sig = [desc_parameterlist, desc_parameter, [desc_sig_name, 'name']] - assert_node(doctree[1][0][1], expected_sig) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=False) + assert_node(extract_node(doctree, 1, 0, 1), expected_sig) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=False, + ) @pytest.mark.sphinx( @@ -892,3 +926,19 @@ def test_domain_js_javascript_trailing_comma_in_multi_line_signatures_in_text(ap expected_f, ) assert expected_parameter_list_foo in content + + +# See: https://github.com/sphinx-doc/sphinx/issues/13217 +@pytest.mark.sphinx('html', testroot='_blank') +def test_js_function_parentheses_in_arguments_and_errors(app: SphinxTestApp) -> None: + text = """\ +.. js:function:: $.getJSON(href) + + :param string href: + :throws err: +""" + doctree = restructuredtext.parse(app, text) + refnodes = list(doctree.findall(addnodes.pending_xref)) + assert len(refnodes) == 2 + assert_node(refnodes[0], [addnodes.pending_xref, nodes.literal, 'string']) + assert_node(refnodes[1], [addnodes.pending_xref, nodes.literal, 'err']) diff --git a/tests/test_domains/test_domain_py.py b/tests/test_domains/test_domain_py.py index 151fb4494f7..19e92eca7a6 100644 --- a/tests/test_domains/test_domain_py.py +++ b/tests/test_domains/test_domain_py.py @@ -38,20 +38,28 @@ from sphinx.testing.util import assert_node from sphinx.writers.text import STDINDENT +from tests.utils import extract_node -def parse(sig): +TYPE_CHECKING = False +if TYPE_CHECKING: + from sphinx.application import Sphinx + from sphinx.environment import BuildEnvironment + from sphinx.testing.util import SphinxTestApp + + +def parse(sig: str, *, env: BuildEnvironment) -> str: m = py_sig_re.match(sig) if m is None: raise ValueError - name_prefix, tp_list, name, arglist, retann = m.groups() + _name_prefix, _tp_list, _name, arglist, _retann = m.groups() signode = addnodes.desc_signature(sig, '') - _pseudo_parse_arglist(signode, arglist) + _pseudo_parse_arglist(signode, arglist, env=env) return signode.astext() -def test_function_signatures() -> None: - rv = parse("compile(source : string, filename, symbol='file')") - assert rv == "(source : string, filename, symbol='file')" +def test_function_signatures(app: Sphinx) -> None: + rv = parse("compile(source : string, filename, symbol='file')", env=app.env) + assert rv == "(source: string, filename, symbol='file')" for params, expect in [ ('(a=1)', '(a=1)'), @@ -60,9 +68,9 @@ def test_function_signatures() -> None: ('(a=1[, b=None])', '(a=1, [b=None])'), ('(a=[], [b=None])', '(a=[], [b=None])'), ('(a=[][, b=None])', '(a=[], [b=None])'), - ('(a: Foo[Bar]=[][, b=None])', '(a: Foo[Bar]=[], [b=None])'), + ('(a: Foo[Bar]=[][, b=None])', '(a: Foo[Bar] = [], [b=None])'), ]: - rv = parse(f'func{params}') + rv = parse(f'func{params}', env=app.env) assert rv == expect # Note: 'def f[Foo[Bar]]()' is not valid Python but people might write @@ -70,7 +78,7 @@ def test_function_signatures() -> None: # variable. for tparams in ['', '[Foo]', '[Foo[Bar]]']: for retann in ['', '-> Foo', '-> Foo[Bar]', '-> anything else']: - rv = parse(f'func{tparams}{params} {retann}'.rstrip()) + rv = parse(f'func{tparams}{params} {retann}'.rstrip(), env=app.env) assert rv == expect @@ -508,6 +516,28 @@ def test_parse_annotation(app): ), ) + doctree = _parse_annotation('*tuple[str, int]', app.env) + assert_node( + doctree, + ( + [desc_sig_operator, '*'], + [pending_xref, 'tuple'], + [desc_sig_punctuation, '['], + [pending_xref, 'str'], + [desc_sig_punctuation, ','], + desc_sig_space, + [pending_xref, 'int'], + [desc_sig_punctuation, ']'], + ), + ) + assert_node( + doctree[1], + pending_xref, + refdomain='py', + reftype='class', + reftarget='tuple', + ) + @pytest.mark.sphinx('html', testroot='_blank') def test_parse_annotation_suppress(app): @@ -959,8 +989,12 @@ def test_python_maximum_signature_line_length_overrides_global(app): [nodes.inline, pending_xref, 'str'], ), ] - assert_node(doctree[1][0][1], expected_sig) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=False) + assert_node(extract_node(doctree, 1, 0, 1), expected_sig) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=False, + ) @pytest.mark.sphinx( @@ -1764,3 +1798,105 @@ def test_pep_695_and_pep_696_whitespaces_in_default(app, tp_list, tptext): text = f'.. py:function:: f{tp_list}() -> Annotated[T, Qux[int]()]' doctree = restructuredtext.parse(app, text) assert doctree.astext() == f'\n\nf{tptext}() -> Annotated[T, Qux[int]()]\n\n' + + +def test_deco_role(app): + text = """\ +.. py:decorator:: foo.bar + :no-contents-entry: + :no-index-entry: + :no-typesetting: +""" + + doctree = restructuredtext.parse(app, text + '\n:py:deco:`foo.bar`') + assert doctree.astext() == '\n\n\n\n@foo.bar' + + doctree = restructuredtext.parse(app, text + '\n:py:deco:`~foo.bar`') + assert doctree.astext() == '\n\n\n\n@bar' + + +def test_pytype_canonical(app): + text = """\ +.. py:type:: A + :canonical: int + +.. py:type:: B + :canonical: int + """ + + doctree = restructuredtext.parse(app, text) + assert not app.warning.getvalue() + + +@pytest.mark.sphinx('html', testroot='domain-py-xref-type-alias') +def test_type_alias_xref_resolution(app: SphinxTestApp) -> None: + """Test that type aliases in function signatures can be cross-referenced. + + This tests the fix for issue https://github.com/sphinx-doc/sphinx/issues/10785 + where type aliases documented as :py:data: but referenced as :py:class: in + function signatures would not resolve properly. + + Tests both a Union type alias and a generic type alias to ensure our + domain fallback mechanism works for various type alias patterns. + """ + app.config.nitpicky = True + app.build() + + # In nitpicky mode, check that no warnings were generated for type alias cross-references + warnings_text = app.warning.getvalue() + assert 'py:class reference target not found: pathlike' not in warnings_text, ( + f'Type alias cross-reference failed in nitpicky mode. Warnings: {warnings_text}' + ) + assert 'py:class reference target not found: Handler' not in warnings_text, ( + f'Type alias cross-reference failed for Handler. Warnings: {warnings_text}' + ) + + # Core functionality test: Verify type alias links are generated in function signatures + html_content = (app.outdir / 'index.html').read_text(encoding='utf8') + + # Both type aliases should be documented and have anchors + assert 'id="alias_module.pathlike"' in html_content, ( + 'pathlike type alias definition anchor not found in HTML' + ) + assert 'id="alias_module.Handler"' in html_content, ( + 'Handler type alias definition anchor not found in HTML' + ) + + # The critical test: type aliases in function signatures should be clickable links + # This tests the original issue - function signature type annotations should resolve + assert ( + 'read_file.*?', html_content, re.DOTALL + ) + assert read_file_match is not None, 'Could not find read_file function signature' + read_file_signature = read_file_match.group(0) + assert ( + 'process_error.*?', html_content, re.DOTALL + ) + assert process_error_match is not None, ( + 'Could not find process_error function signature' + ) + process_error_signature = process_error_match.group(0) + assert ( + ' None: + text = '.. py:function:: hello(a : ~typing.Any = ) -> None' + doctree = restructuredtext.parse(app, text) + assert_node( + doctree, + ( + addnodes.index, + [ + desc, + ( + [ + desc_signature, + ( + [desc_name, 'hello'], + desc_parameterlist, + [desc_returns, pending_xref, 'None'], + ), + ], + desc_content, + ), + ], + ), + ) + assert_node( + doctree[1], + addnodes.desc, + desctype='function', + domain='py', + objtype='function', + no_index=False, + ) + assert_node( + extract_node(doctree, 1, 0, 1), + ( + [ + desc_parameter, + ( + [desc_sig_name, 'a'], + [desc_sig_punctuation, ':'], + desc_sig_space, + [desc_sig_name, pending_xref, 'Any'], + desc_sig_space, + [desc_sig_operator, '='], + desc_sig_space, + [nodes.inline, ''], + ), + ], + ), + ) + + @pytest.mark.sphinx( 'html', testroot='root', @@ -526,7 +584,7 @@ def test_pyfunction_signature_with_python_maximum_signature_line_length_equal(ap no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [ desc_parameterlist, desc_parameter, @@ -538,7 +596,11 @@ def test_pyfunction_signature_with_python_maximum_signature_line_length_equal(ap ), ], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=False) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=False, + ) @pytest.mark.sphinx( @@ -582,7 +644,7 @@ def test_pyfunction_signature_with_python_maximum_signature_line_length_force_si no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [ desc_parameterlist, desc_parameter, @@ -594,7 +656,11 @@ def test_pyfunction_signature_with_python_maximum_signature_line_length_force_si ), ], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=False) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=False, + ) @pytest.mark.sphinx( @@ -636,7 +702,7 @@ def test_pyfunction_signature_with_python_maximum_signature_line_length_break(ap no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [ desc_parameterlist, desc_parameter, @@ -648,7 +714,11 @@ def test_pyfunction_signature_with_python_maximum_signature_line_length_break(ap ), ], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=True) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=True, + ) @pytest.mark.sphinx( @@ -690,7 +760,7 @@ def test_pyfunction_signature_with_maximum_signature_line_length_equal(app): no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [ desc_parameterlist, desc_parameter, @@ -702,7 +772,11 @@ def test_pyfunction_signature_with_maximum_signature_line_length_equal(app): ), ], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=False) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=False, + ) @pytest.mark.sphinx( @@ -744,7 +818,7 @@ def test_pyfunction_signature_with_maximum_signature_line_length_force_single(ap no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [ desc_parameterlist, desc_parameter, @@ -756,7 +830,11 @@ def test_pyfunction_signature_with_maximum_signature_line_length_force_single(ap ), ], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=False) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=False, + ) @pytest.mark.sphinx( @@ -798,7 +876,7 @@ def test_pyfunction_signature_with_maximum_signature_line_length_break(app): no_index=False, ) assert_node( - doctree[1][0][1], + extract_node(doctree, 1, 0, 1), [ desc_parameterlist, desc_parameter, @@ -810,4 +888,8 @@ def test_pyfunction_signature_with_maximum_signature_line_length_break(app): ), ], ) - assert_node(doctree[1][0][1], desc_parameterlist, multi_line_parameter_list=True) + assert_node( + extract_node(doctree, 1, 0, 1), + desc_parameterlist, + multi_line_parameter_list=True, + ) diff --git a/tests/test_domains/test_domain_py_pyobject.py b/tests/test_domains/test_domain_py_pyobject.py index 12b22a04dcc..04505d1faf1 100644 --- a/tests/test_domains/test_domain_py_pyobject.py +++ b/tests/test_domains/test_domain_py_pyobject.py @@ -22,6 +22,8 @@ from sphinx.testing import restructuredtext from sphinx.testing.util import assert_node +from tests.utils import extract_node + @pytest.mark.sphinx('html', testroot='_blank') def test_pyexception_signature(app): @@ -147,7 +149,7 @@ def test_pydata_with_union_type_operator(app): text = '.. py:data:: version\n :type: int | str' doctree = restructuredtext.parse(app, text) assert_node( - doctree[1][0], + extract_node(doctree, 1, 0), ( [desc_name, 'version'], [ @@ -195,9 +197,9 @@ def test_pyobject_prefix(app): ), ) # prefix is stripped - assert doctree[1][1][1].astext().strip() == 'say()' + assert extract_node(doctree, 1, 1, 1).astext().strip() == 'say()' # not stripped - assert doctree[1][1][3].astext().strip() == 'FooBar.say()' + assert extract_node(doctree, 1, 1, 3).astext().strip() == 'FooBar.say()' @pytest.mark.sphinx('html', testroot='_blank') @@ -234,7 +236,9 @@ def test_pydata(app): ], ), ) - assert_node(doctree[3][0][2][2], pending_xref, **{'py:module': 'example'}) + assert_node( + extract_node(doctree, 3, 0, 2, 2), pending_xref, **{'py:module': 'example'} + ) assert 'example.var' in domain.objects assert domain.objects['example.var'] == ('index', 'example.var', 'data', False) @@ -368,12 +372,12 @@ def test_pymethod_options(app): # method assert_node( - doctree[1][1][0], + extract_node(doctree, 1, 1, 0), addnodes.index, entries=[('single', 'meth1() (Class method)', 'Class.meth1', '', None)], ) assert_node( - doctree[1][1][1], + extract_node(doctree, 1, 1, 1), ( [desc_signature, ([desc_name, 'meth1'], [desc_parameterlist, ()])], [desc_content, ()], @@ -384,12 +388,12 @@ def test_pymethod_options(app): # :classmethod: assert_node( - doctree[1][1][2], + extract_node(doctree, 1, 1, 2), addnodes.index, entries=[('single', 'meth2() (Class class method)', 'Class.meth2', '', None)], ) assert_node( - doctree[1][1][3], + extract_node(doctree, 1, 1, 3), ( [ desc_signature, @@ -410,12 +414,12 @@ def test_pymethod_options(app): # :staticmethod: assert_node( - doctree[1][1][4], + extract_node(doctree, 1, 1, 4), addnodes.index, entries=[('single', 'meth3() (Class static method)', 'Class.meth3', '', None)], ) assert_node( - doctree[1][1][5], + extract_node(doctree, 1, 1, 5), ( [ desc_signature, @@ -433,12 +437,12 @@ def test_pymethod_options(app): # :async: assert_node( - doctree[1][1][6], + extract_node(doctree, 1, 1, 6), addnodes.index, entries=[('single', 'meth4() (Class method)', 'Class.meth4', '', None)], ) assert_node( - doctree[1][1][7], + extract_node(doctree, 1, 1, 7), ( [ desc_signature, @@ -456,12 +460,12 @@ def test_pymethod_options(app): # :abstractmethod: assert_node( - doctree[1][1][8], + extract_node(doctree, 1, 1, 8), addnodes.index, entries=[('single', 'meth5() (Class method)', 'Class.meth5', '', None)], ) assert_node( - doctree[1][1][9], + extract_node(doctree, 1, 1, 9), ( [ desc_signature, @@ -482,12 +486,12 @@ def test_pymethod_options(app): # :final: assert_node( - doctree[1][1][10], + extract_node(doctree, 1, 1, 10), addnodes.index, entries=[('single', 'meth6() (Class method)', 'Class.meth6', '', None)], ) assert_node( - doctree[1][1][11], + extract_node(doctree, 1, 1, 11), ( [ desc_signature, @@ -532,12 +536,12 @@ def test_pyclassmethod(app): ), ) assert_node( - doctree[1][1][0], + extract_node(doctree, 1, 1, 0), addnodes.index, entries=[('single', 'meth() (Class class method)', 'Class.meth', '', None)], ) assert_node( - doctree[1][1][1], + extract_node(doctree, 1, 1, 1), ( [ desc_signature, @@ -585,12 +589,12 @@ def test_pystaticmethod(app): ), ) assert_node( - doctree[1][1][0], + extract_node(doctree, 1, 1, 0), addnodes.index, entries=[('single', 'meth() (Class static method)', 'Class.meth', '', None)], ) assert_node( - doctree[1][1][1], + extract_node(doctree, 1, 1, 1), ( [ desc_signature, @@ -641,12 +645,12 @@ def test_pyattribute(app): ), ) assert_node( - doctree[1][1][0], + extract_node(doctree, 1, 1, 0), addnodes.index, entries=[('single', 'attr (Class attribute)', 'Class.attr', '', None)], ) assert_node( - doctree[1][1][1], + extract_node(doctree, 1, 1, 1), ( [ desc_signature, @@ -678,8 +682,12 @@ def test_pyattribute(app): [desc_content, ()], ), ) - assert_node(doctree[1][1][1][0][1][2], pending_xref, **{'py:class': 'Class'}) - assert_node(doctree[1][1][1][0][1][6], pending_xref, **{'py:class': 'Class'}) + assert_node( + extract_node(doctree, 1, 1, 1, 0, 1, 2), pending_xref, **{'py:class': 'Class'} + ) + assert_node( + extract_node(doctree, 1, 1, 1, 0, 1, 6), pending_xref, **{'py:class': 'Class'} + ) assert 'Class.attr' in domain.objects assert domain.objects['Class.attr'] == ('index', 'Class.attr', 'attribute', False) @@ -722,12 +730,12 @@ def test_pyproperty(app): ), ) assert_node( - doctree[1][1][0], + extract_node(doctree, 1, 1, 0), addnodes.index, entries=[('single', 'prop1 (Class property)', 'Class.prop1', '', None)], ) assert_node( - doctree[1][1][1], + extract_node(doctree, 1, 1, 1), ( [ desc_signature, @@ -756,12 +764,12 @@ def test_pyproperty(app): ), ) assert_node( - doctree[1][1][2], + extract_node(doctree, 1, 1, 2), addnodes.index, entries=[('single', 'prop2 (Class property)', 'Class.prop2', '', None)], ) assert_node( - doctree[1][1][3], + extract_node(doctree, 1, 1, 3), ( [ desc_signature, @@ -869,7 +877,7 @@ def test_py_type_alias(app): ), ) assert_node( - doctree[5][1][0], + extract_node(doctree, 5, 1, 0), addnodes.index, entries=[ ( @@ -882,7 +890,7 @@ def test_py_type_alias(app): ], ) assert_node( - doctree[5][1][1], + extract_node(doctree, 5, 1, 1), ( [ desc_signature, @@ -925,17 +933,17 @@ def test_domain_py_type_alias(app): content = (app.outdir / 'type_alias.html').read_text(encoding='utf8') assert ( - 'type ' + 'type ' 'module_one.' 'MyAlias' - ' =' + ' =' ' list' '[' 'int ' '| ' '' 'module_two.SomeClass' - ']' + ']' ) in content assert app.warning.getvalue() == '' diff --git a/tests/test_domains/test_domain_rst.py b/tests/test_domains/test_domain_rst.py index 2dff1807bf8..08d5ccebd78 100644 --- a/tests/test_domains/test_domain_rst.py +++ b/tests/test_domains/test_domain_rst.py @@ -19,6 +19,8 @@ from sphinx.testing import restructuredtext from sphinx.testing.util import assert_node +from tests.utils import extract_node + if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp @@ -223,7 +225,7 @@ def test_rst_directive_option_type(app: SphinxTestApp) -> None: @pytest.mark.sphinx('html', testroot='_blank') -def test_rst_directive_and_directive_option(app): +def test_rst_directive_and_directive_option(app: SphinxTestApp) -> None: text = '.. rst:directive:: foo\n\n .. rst:directive:option:: bar\n' doctree = restructuredtext.parse(app, text) assert_node( @@ -240,7 +242,7 @@ def test_rst_directive_and_directive_option(app): ), ) assert_node( - doctree[1][1][0], + extract_node(doctree, 1, 1, 0), entries=[ ( 'pair', @@ -252,10 +254,11 @@ def test_rst_directive_and_directive_option(app): ], ) assert_node( - doctree[1][1][1], ([desc_signature, desc_name, ':bar:'], [desc_content, ()]) + extract_node(doctree, 1, 1, 1), + ([desc_signature, desc_name, ':bar:'], [desc_content, ()]), ) assert_node( - doctree[1][1][1], + extract_node(doctree, 1, 1, 1), addnodes.desc, desctype='directive:option', domain='rst', diff --git a/tests/test_domains/test_domain_std.py b/tests/test_domains/test_domain_std.py index 743955f9ffa..438516ca92c 100644 --- a/tests/test_domains/test_domain_std.py +++ b/tests/test_domains/test_domain_std.py @@ -24,6 +24,8 @@ from sphinx.testing import restructuredtext from sphinx.testing.util import assert_node +from tests.utils import extract_node + if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp @@ -192,27 +194,32 @@ def test_glossary(app): ), ) assert_node( - doctree[0][0][0][0][1], + extract_node(doctree, 0, 0, 0, 0, 1), entries=[('single', 'term1', 'term-term1', 'main', None)], ) assert_node( - doctree[0][0][0][1][1], + extract_node(doctree, 0, 0, 0, 1, 1), entries=[('single', 'TERM2', 'term-TERM2', 'main', None)], ) - assert_node(doctree[0][0][0][2], [definition, nodes.paragraph, 'description']) assert_node( - doctree[0][0][1][0][1], + extract_node(doctree, 0, 0, 0, 2), [definition, nodes.paragraph, 'description'] + ) + assert_node( + extract_node(doctree, 0, 0, 1, 0, 1), entries=[('single', 'term3', 'term-term3', 'main', 'classifier')], ) assert_node( - doctree[0][0][1][1], + extract_node(doctree, 0, 0, 1, 1), [definition, nodes.paragraph, 'description\ndescription'], ) assert_node( - doctree[0][0][2][0][1], + extract_node(doctree, 0, 0, 2, 0, 1), entries=[('single', 'term4', 'term-term4', 'main', 'class1')], ) - assert_node(doctree[0][0][2][1], [nodes.definition, nodes.paragraph, 'description']) + assert_node( + extract_node(doctree, 0, 0, 2, 1), + [nodes.definition, nodes.paragraph, 'description'], + ) # index domain = app.env.domains.standard_domain @@ -302,7 +309,10 @@ def test_glossary_comment(app): ], ), ) - assert_node(doctree[0][0][0][1], [nodes.definition, nodes.paragraph, 'description']) + assert_node( + extract_node(doctree, 0, 0, 0, 1), + [nodes.definition, nodes.paragraph, 'description'], + ) @pytest.mark.sphinx('html', testroot='_blank') @@ -332,9 +342,12 @@ def test_glossary_comment2(app): ], ), ) - assert_node(doctree[0][0][0][1], [nodes.definition, nodes.paragraph, 'description']) assert_node( - doctree[0][0][1][1], + extract_node(doctree, 0, 0, 0, 1), + [nodes.definition, nodes.paragraph, 'description'], + ) + assert_node( + extract_node(doctree, 0, 0, 1, 1), [nodes.definition, nodes.paragraph, 'description\ndescription'], ) @@ -373,8 +386,14 @@ def test_glossary_sorted(app): ], ), ) - assert_node(doctree[0][0][0][2], [nodes.definition, nodes.paragraph, 'description']) - assert_node(doctree[0][0][1][1], [nodes.definition, nodes.paragraph, 'description']) + assert_node( + extract_node(doctree, 0, 0, 0, 2), + [nodes.definition, nodes.paragraph, 'description'], + ) + assert_node( + extract_node(doctree, 0, 0, 1, 1), + [nodes.definition, nodes.paragraph, 'description'], + ) @pytest.mark.sphinx('html', testroot='_blank') diff --git a/tests/test_environment/test_environment.py b/tests/test_environment/test_environment.py index 872d0b857ce..08e0abdd61b 100644 --- a/tests/test_environment/test_environment.py +++ b/tests/test_environment/test_environment.py @@ -21,11 +21,16 @@ ) if TYPE_CHECKING: + from collections.abc import Callable + + from sphinx.testing.fixtures import _app_params from sphinx.testing.util import SphinxTestApp @pytest.mark.sphinx('dummy', testroot='basic', copy_test_root=True) -def test_config_status(make_app, app_params): +def test_config_status( + make_app: Callable[..., SphinxTestApp], app_params: _app_params +) -> None: args, kwargs = app_params # clean build diff --git a/tests/test_environment/test_environment_record_dependencies.py b/tests/test_environment/test_environment_record_dependencies.py index c3690e410fb..b70242bdb45 100644 --- a/tests/test_environment/test_environment_record_dependencies.py +++ b/tests/test_environment/test_environment_record_dependencies.py @@ -6,8 +6,6 @@ import pytest -from sphinx.util._pathlib import _StrPath - if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp @@ -16,4 +14,4 @@ def test_record_dependencies_cleared(app: SphinxTestApp) -> None: app.builder.read() assert 'index' not in app.env.dependencies - assert app.env.dependencies['api'] == {_StrPath('example_module.py')} + assert app.env.dependencies['api'] == {app.srcdir / 'example_module.py'} diff --git a/tests/test_environment/test_environment_toctree.py b/tests/test_environment/test_environment_toctree.py index f6b849c5bec..37c042c2ba9 100644 --- a/tests/test_environment/test_environment_toctree.py +++ b/tests/test_environment/test_environment_toctree.py @@ -4,6 +4,7 @@ from typing import TYPE_CHECKING +import docutils import pytest from docutils import nodes from docutils.nodes import bullet_list, list_item, literal, reference, title @@ -11,8 +12,15 @@ from sphinx import addnodes from sphinx.addnodes import compact_paragraph, only from sphinx.builders.html import StandaloneHTMLBuilder -from sphinx.environment.adapters.toctree import document_toc, global_toctree_for_doc +from sphinx.environment.adapters.toctree import ( + _toctree_copy, + document_toc, + global_toctree_for_doc, +) from sphinx.testing.util import assert_node +from sphinx.util.tags import Tags + +from tests.utils import extract_node if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp @@ -62,12 +70,12 @@ def test_process_doc(app): ) assert_node( - toctree[0][0], + extract_node(toctree, 0, 0), [compact_paragraph, reference, 'Welcome to Sphinx Tests’s documentation!'], ) - assert_node(toctree[0][0][0], reference, anchorname='') + assert_node(extract_node(toctree, 0, 0, 0), reference, anchorname='') assert_node( - toctree[0][1][0], + extract_node(toctree, 0, 1, 0), addnodes.toctree, caption='Table of Contents', glob=False, @@ -85,9 +93,9 @@ def test_process_doc(app): ) # only branch - assert_node(toctree[0][1][1], addnodes.only, expr='html') + assert_node(extract_node(toctree, 0, 1, 1), addnodes.only, expr='html') assert_node( - toctree[0][1][1], + extract_node(toctree, 0, 1, 1), [ only, list_item, @@ -97,9 +105,13 @@ def test_process_doc(app): ), ], ) - assert_node(toctree[0][1][1][0][0][0], reference, anchorname='#section-for-html') assert_node( - toctree[0][1][1][0][1][0], + extract_node(toctree, 0, 1, 1, 0, 0, 0), + reference, + anchorname='#section-for-html', + ) + assert_node( + extract_node(toctree, 0, 1, 1, 0, 1, 0), addnodes.toctree, caption=None, glob=False, @@ -111,7 +123,7 @@ def test_process_doc(app): numbered=0, ) assert_node( - toctree[0][1][2], + extract_node(toctree, 0, 1, 2), ( [compact_paragraph, reference, 'subsection'], [bullet_list, list_item, compact_paragraph, reference, 'subsubsection'], @@ -119,7 +131,7 @@ def test_process_doc(app): ) assert_node( - toctree[1][0], + extract_node(toctree, 1, 0), [ compact_paragraph, reference, @@ -127,12 +139,12 @@ def test_process_doc(app): ], ) assert_node( - toctree[1][0][0], + extract_node(toctree, 1, 0, 0), reference, anchorname='#test-for-combination-of-globaltoc-html-and-hidden-toctree', ) assert_node( - toctree[1][1][0], + extract_node(toctree, 1, 1, 0), addnodes.toctree, caption=None, entries=[], @@ -143,7 +155,7 @@ def test_process_doc(app): numbered=0, ) assert_node( - toctree[1][1][1], + extract_node(toctree, 1, 1, 1), addnodes.toctree, caption=None, glob=False, @@ -157,7 +169,10 @@ def test_process_doc(app): ], ) - assert_node(toctree[2][0], [compact_paragraph, reference, 'Indices and tables']) + assert_node( + extract_node(toctree, 2, 0), + [compact_paragraph, reference, 'Indices and tables'], + ) # other collections assert app.env.toc_num_entries['index'] == 6 @@ -209,9 +224,11 @@ def test_glob(app): ], ) - assert_node(toctree[0][0], [compact_paragraph, reference, 'test-toctree-glob']) assert_node( - toctree[0][1][0], + extract_node(toctree, 0, 0), [compact_paragraph, reference, 'test-toctree-glob'] + ) + assert_node( + extract_node(toctree, 0, 1, 0), [ list_item, ( @@ -221,7 +238,7 @@ def test_glob(app): ], ) assert_node( - toctree[0][1][0][1][0], + extract_node(toctree, 0, 1, 0, 1, 0), addnodes.toctree, caption=None, glob=True, @@ -242,7 +259,7 @@ def test_glob(app): ], ) assert_node( - toctree[0][1][1], + extract_node(toctree, 0, 1, 1), [ list_item, ( @@ -252,7 +269,7 @@ def test_glob(app): ], ) assert_node( - toctree[0][1][1][1][0], + extract_node(toctree, 0, 1, 1, 1, 0), addnodes.toctree, caption=None, glob=True, @@ -330,15 +347,18 @@ def test_domain_objects(app): ], ) - assert_node(toctree[0][0], [compact_paragraph, reference, 'test-domain-objects']) + assert_node( + extract_node(toctree, 0, 0), + [compact_paragraph, reference, 'test-domain-objects'], + ) assert_node( - toctree[0][1][0], + extract_node(toctree, 0, 1, 0), [list_item, ([compact_paragraph, reference, literal, 'world()'])], ) assert_node( - toctree[0][1][1][1][3], + extract_node(toctree, 0, 1, 1, 1, 3), [ list_item, ([compact_paragraph, reference, literal, 'HelloWorldPrinter.print()']), @@ -500,25 +520,28 @@ def test_document_toc(app): ], ) assert_node( - toctree[0][0], + extract_node(toctree, 0, 0), [compact_paragraph, reference, 'Welcome to Sphinx Tests’s documentation!'], ) assert_node( - toctree[0][1][1], + extract_node(toctree, 0, 1, 1), ( [compact_paragraph, reference, 'subsection'], [bullet_list, list_item, compact_paragraph, reference, 'subsubsection'], ), ) assert_node( - toctree[1][0], + extract_node(toctree, 1, 0), [ compact_paragraph, reference, 'Test for combination of ‘globaltoc.html’ and hidden toctree', ], ) - assert_node(toctree[2][0], [compact_paragraph, reference, 'Indices and tables']) + assert_node( + extract_node(toctree, 2, 0), + [compact_paragraph, reference, 'Indices and tables'], + ) @pytest.mark.sphinx('xml', testroot='toctree') @@ -559,32 +582,35 @@ def test_document_toc_only(app): ], ) assert_node( - toctree[0][0], + extract_node(toctree, 0, 0), [compact_paragraph, reference, 'Welcome to Sphinx Tests’s documentation!'], ) assert_node( - toctree[0][1][1], + extract_node(toctree, 0, 1, 1), ( [compact_paragraph, reference, 'Section for HTML'], [bullet_list, addnodes.toctree], ), ) assert_node( - toctree[0][1][2], + extract_node(toctree, 0, 1, 2), ( [compact_paragraph, reference, 'subsection'], [bullet_list, list_item, compact_paragraph, reference, 'subsubsection'], ), ) assert_node( - toctree[1][0], + extract_node(toctree, 1, 0), [ compact_paragraph, reference, 'Test for combination of ‘globaltoc.html’ and hidden toctree', ], ) - assert_node(toctree[2][0], [compact_paragraph, reference, 'Indices and tables']) + assert_node( + extract_node(toctree, 2, 0), + [compact_paragraph, reference, 'Indices and tables'], + ) @pytest.mark.sphinx('xml', testroot='toctree') @@ -604,9 +630,10 @@ def test_document_toc_tocdepth(app): ), ], ) - assert_node(toctree[0][0], [compact_paragraph, reference, 'level 1']) + assert_node(extract_node(toctree, 0, 0), [compact_paragraph, reference, 'level 1']) assert_node( - toctree[0][1], [bullet_list, list_item, compact_paragraph, reference, 'level 2'] + extract_node(toctree, 0, 1), + [bullet_list, list_item, compact_paragraph, reference, 'level 2'], ) @@ -614,7 +641,9 @@ def test_document_toc_tocdepth(app): @pytest.mark.test_params(shared_result='test_environment_toctree_basic') def test_global_toctree_for_doc(app): app.build() - toctree = global_toctree_for_doc(app.env, 'index', app.builder, collapse=False) + toctree = global_toctree_for_doc( + app.env, 'index', app.builder, tags=app.tags, collapse=False + ) assert_node( toctree, [ @@ -638,7 +667,7 @@ def test_global_toctree_for_doc(app): ), ) assert_node( - toctree[1][0][1], + extract_node(toctree, 1, 0, 1), ( [list_item, compact_paragraph, reference, 'quux'], [list_item, compact_paragraph, reference, 'foo.1'], @@ -646,17 +675,34 @@ def test_global_toctree_for_doc(app): ), ) - assert_node(toctree[1][0][0][0], reference, refuri='foo', secnumber=[1]) - assert_node(toctree[1][0][1][0][0][0], reference, refuri='quux', secnumber=[1, 1]) assert_node( - toctree[1][0][1][1][0][0], reference, refuri='foo#foo-1', secnumber=[1, 2] + extract_node(toctree, 1, 0, 0, 0), reference, refuri='foo', secnumber=[1] ) assert_node( - toctree[1][0][1][2][0][0], reference, refuri='foo#foo-2', secnumber=[1, 3] + extract_node(toctree, 1, 0, 1, 0, 0, 0), + reference, + refuri='quux', + secnumber=[1, 1], ) - assert_node(toctree[1][1][0][0], reference, refuri='bar', secnumber=[2]) - assert_node(toctree[1][2][0][0], reference, refuri='https://sphinx-doc.org/') - assert_node(toctree[1][3][0][0], reference, refuri='') + assert_node( + extract_node(toctree, 1, 0, 1, 1, 0, 0), + reference, + refuri='foo#foo-1', + secnumber=[1, 2], + ) + assert_node( + extract_node(toctree, 1, 0, 1, 2, 0, 0), + reference, + refuri='foo#foo-2', + secnumber=[1, 3], + ) + assert_node( + extract_node(toctree, 1, 1, 0, 0), reference, refuri='bar', secnumber=[2] + ) + assert_node( + extract_node(toctree, 1, 2, 0, 0), reference, refuri='https://sphinx-doc.org/' + ) + assert_node(extract_node(toctree, 1, 3, 0, 0), reference, refuri='') assert_node( toctree[2], [bullet_list, list_item, compact_paragraph, reference, 'baz'] @@ -668,15 +714,23 @@ def test_global_toctree_for_doc(app): [list_item, compact_paragraph, reference, 'Python'], ), ) - assert_node(toctree[3][0][0][0], reference, refuri='https://sphinx-doc.org/latest/') - assert_node(toctree[3][1][0][0], reference, refuri='https://python.org/') + assert_node( + extract_node(toctree, 3, 0, 0, 0), + reference, + refuri='https://sphinx-doc.org/latest/', + ) + assert_node( + extract_node(toctree, 3, 1, 0, 0), reference, refuri='https://python.org/' + ) @pytest.mark.sphinx('xml', testroot='toctree') @pytest.mark.test_params(shared_result='test_environment_toctree_basic') def test_global_toctree_for_doc_collapse(app): app.build() - toctree = global_toctree_for_doc(app.env, 'index', app.builder, collapse=True) + toctree = global_toctree_for_doc( + app.env, 'index', app.builder, tags=app.tags, collapse=True + ) assert_node( toctree, [ @@ -699,10 +753,16 @@ def test_global_toctree_for_doc_collapse(app): ], ), ) - assert_node(toctree[1][0][0][0], reference, refuri='foo', secnumber=[1]) - assert_node(toctree[1][1][0][0], reference, refuri='bar', secnumber=[2]) - assert_node(toctree[1][2][0][0], reference, refuri='https://sphinx-doc.org/') - assert_node(toctree[1][3][0][0], reference, refuri='') + assert_node( + extract_node(toctree, 1, 0, 0, 0), reference, refuri='foo', secnumber=[1] + ) + assert_node( + extract_node(toctree, 1, 1, 0, 0), reference, refuri='bar', secnumber=[2] + ) + assert_node( + extract_node(toctree, 1, 2, 0, 0), reference, refuri='https://sphinx-doc.org/' + ) + assert_node(extract_node(toctree, 1, 3, 0, 0), reference, refuri='') assert_node( toctree[2], [bullet_list, list_item, compact_paragraph, reference, 'baz'] @@ -714,8 +774,14 @@ def test_global_toctree_for_doc_collapse(app): [list_item, compact_paragraph, reference, 'Python'], ), ) - assert_node(toctree[3][0][0][0], reference, refuri='https://sphinx-doc.org/latest/') - assert_node(toctree[3][1][0][0], reference, refuri='https://python.org/') + assert_node( + extract_node(toctree, 3, 0, 0, 0), + reference, + refuri='https://sphinx-doc.org/latest/', + ) + assert_node( + extract_node(toctree, 3, 1, 0, 0), reference, refuri='https://python.org/' + ) @pytest.mark.sphinx('xml', testroot='toctree') @@ -723,7 +789,7 @@ def test_global_toctree_for_doc_collapse(app): def test_global_toctree_for_doc_maxdepth(app): app.build() toctree = global_toctree_for_doc( - app.env, 'index', app.builder, collapse=False, maxdepth=3 + app.env, 'index', app.builder, tags=app.tags, collapse=False, maxdepth=3 ) assert_node( toctree, @@ -759,7 +825,7 @@ def test_global_toctree_for_doc_maxdepth(app): ), ) assert_node( - toctree[1][0][1], + extract_node(toctree, 1, 0, 1), ( [list_item, compact_paragraph, reference, 'quux'], [ @@ -773,27 +839,44 @@ def test_global_toctree_for_doc_maxdepth(app): ), ) assert_node( - toctree[1][0][1][1][1], + extract_node(toctree, 1, 0, 1, 1, 1), [bullet_list, list_item, compact_paragraph, reference, 'foo.1-1'], ) - assert_node(toctree[1][0][0][0], reference, refuri='foo', secnumber=[1]) - assert_node(toctree[1][0][1][0][0][0], reference, refuri='quux', secnumber=[1, 1]) assert_node( - toctree[1][0][1][1][0][0], reference, refuri='foo#foo-1', secnumber=[1, 2] + extract_node(toctree, 1, 0, 0, 0), reference, refuri='foo', secnumber=[1] + ) + assert_node( + extract_node(toctree, 1, 0, 1, 0, 0, 0), + reference, + refuri='quux', + secnumber=[1, 1], + ) + assert_node( + extract_node(toctree, 1, 0, 1, 1, 0, 0), + reference, + refuri='foo#foo-1', + secnumber=[1, 2], ) assert_node( - toctree[1][0][1][1][1][0][0][0], + extract_node(toctree, 1, 0, 1, 1, 1, 0, 0, 0), reference, refuri='foo#foo-1-1', secnumber=[1, 2, 1], ) assert_node( - toctree[1][0][1][2][0][0], reference, refuri='foo#foo-2', secnumber=[1, 3] + extract_node(toctree, 1, 0, 1, 2, 0, 0), + reference, + refuri='foo#foo-2', + secnumber=[1, 3], + ) + assert_node( + extract_node(toctree, 1, 1, 0, 0), reference, refuri='bar', secnumber=[2] + ) + assert_node( + extract_node(toctree, 1, 2, 0, 0), reference, refuri='https://sphinx-doc.org/' ) - assert_node(toctree[1][1][0][0], reference, refuri='bar', secnumber=[2]) - assert_node(toctree[1][2][0][0], reference, refuri='https://sphinx-doc.org/') - assert_node(toctree[1][3][0][0], reference, refuri='') + assert_node(extract_node(toctree, 1, 3, 0, 0), reference, refuri='') assert_node( toctree[2], [bullet_list, list_item, compact_paragraph, reference, 'baz'] @@ -805,8 +888,14 @@ def test_global_toctree_for_doc_maxdepth(app): [list_item, compact_paragraph, reference, 'Python'], ), ) - assert_node(toctree[3][0][0][0], reference, refuri='https://sphinx-doc.org/latest/') - assert_node(toctree[3][1][0][0], reference, refuri='https://python.org/') + assert_node( + extract_node(toctree, 3, 0, 0, 0), + reference, + refuri='https://sphinx-doc.org/latest/', + ) + assert_node( + extract_node(toctree, 3, 1, 0, 0), reference, refuri='https://python.org/' + ) @pytest.mark.sphinx('xml', testroot='toctree') @@ -814,7 +903,12 @@ def test_global_toctree_for_doc_maxdepth(app): def test_global_toctree_for_doc_includehidden(app): app.build() toctree = global_toctree_for_doc( - app.env, 'index', app.builder, collapse=False, includehidden=False + app.env, + 'index', + app.builder, + tags=app.tags, + collapse=False, + includehidden=False, ) assert_node( toctree, @@ -849,7 +943,7 @@ def test_global_toctree_for_doc_includehidden(app): ), ) assert_node( - toctree[1][0][1], + extract_node(toctree, 1, 0, 1), ( [list_item, compact_paragraph, reference, 'quux'], [list_item, compact_paragraph, reference, 'foo.1'], @@ -857,16 +951,33 @@ def test_global_toctree_for_doc_includehidden(app): ), ) - assert_node(toctree[1][0][0][0], reference, refuri='foo', secnumber=[1]) - assert_node(toctree[1][0][1][0][0][0], reference, refuri='quux', secnumber=[1, 1]) assert_node( - toctree[1][0][1][1][0][0], reference, refuri='foo#foo-1', secnumber=[1, 2] + extract_node(toctree, 1, 0, 0, 0), reference, refuri='foo', secnumber=[1] ) assert_node( - toctree[1][0][1][2][0][0], reference, refuri='foo#foo-2', secnumber=[1, 3] + extract_node(toctree, 1, 0, 1, 0, 0, 0), + reference, + refuri='quux', + secnumber=[1, 1], + ) + assert_node( + extract_node(toctree, 1, 0, 1, 1, 0, 0), + reference, + refuri='foo#foo-1', + secnumber=[1, 2], + ) + assert_node( + extract_node(toctree, 1, 0, 1, 2, 0, 0), + reference, + refuri='foo#foo-2', + secnumber=[1, 3], + ) + assert_node( + extract_node(toctree, 1, 1, 0, 0), reference, refuri='bar', secnumber=[2] + ) + assert_node( + extract_node(toctree, 1, 2, 0, 0), reference, refuri='https://sphinx-doc.org/' ) - assert_node(toctree[1][1][0][0], reference, refuri='bar', secnumber=[2]) - assert_node(toctree[1][2][0][0], reference, refuri='https://sphinx-doc.org/') assert_node( toctree[2], [bullet_list, list_item, compact_paragraph, reference, 'baz'] @@ -897,7 +1008,7 @@ def test_toctree_index(app): ], ) assert_node( - toctree[0][1][1], + extract_node(toctree, 0, 1, 1), addnodes.toctree, caption='Indices', glob=False, @@ -907,3 +1018,87 @@ def test_toctree_index(app): numbered=0, entries=[(None, 'genindex'), (None, 'modindex'), (None, 'search')], ) + + +@pytest.mark.sphinx('dummy', testroot='toctree-only') +def test_toctree_only(app): + # regression test for https://github.com/sphinx-doc/sphinx/issues/13022 + # we mainly care that this doesn't fail + + if docutils.__version_info__[:2] >= (0, 22): + true = '1' + else: + true = 'True' + expected_pformat = f"""\ + + + + + test-toctree-only + + + + + + test_toctree_only1 + + + + + test_toctree_only2 + + + + + test_toctree_only2 +""" + app.build() + toc = document_toc(app.env, 'index', app.tags) + assert toc.pformat(' ') == expected_pformat + + +def test_toctree_copy_only(): + # regression test for https://github.com/sphinx-doc/sphinx/issues/13022 + # ensure ``_toctree_copy()`` properly filters out ``only`` nodes, + # including nested nodes. + node = nodes.literal('lobster!', 'lobster!') + node = nodes.reference('', '', node, anchorname='', internal=True, refuri='index') + node = addnodes.only('', node, expr='lobster') + node = addnodes.compact_paragraph('', '', node, skip_section_number=True) + node = nodes.list_item('', node) + node = addnodes.only('', node, expr='not spam') + node = addnodes.only('', node, expr='lobster') + node = addnodes.only('', node, expr='not ham') + node = nodes.bullet_list('', node) + # this is a tree of the shape: + # + # + # + # + # + # + # + # + # + # lobster! + + tags = Tags({'lobster'}) + toc = _toctree_copy(node, 2, 0, False, tags) + # the filtered ToC should look like: + # + # + # + # + # + # lobster! + + # no only nodes should remain + assert list(toc.findall(addnodes.only)) == [] + + # the tree is preserved + assert isinstance(toc, nodes.bullet_list) + assert isinstance(toc[0], nodes.list_item) + assert isinstance(extract_node(toc, 0, 0), addnodes.compact_paragraph) + assert isinstance(extract_node(toc, 0, 0, 0), nodes.reference) + assert isinstance(extract_node(toc, 0, 0, 0, 0), nodes.literal) + assert extract_node(toc, 0, 0, 0, 0, 0) == nodes.Text('lobster!') diff --git a/tests/test_events.py b/tests/test_events.py index 56f76511dcb..50b7bb5fd76 100644 --- a/tests/test_events.py +++ b/tests/test_events.py @@ -3,16 +3,22 @@ from __future__ import annotations from types import SimpleNamespace +from typing import TYPE_CHECKING import pytest from sphinx.errors import ExtensionError from sphinx.events import EventManager +if TYPE_CHECKING: + from typing import NoReturn + + from sphinx.application import Sphinx + def test_event_priority() -> None: result = [] - app = object() # pass a dummy object as an app + app = SimpleNamespace(pdb=False) # pass a dummy object as an app events = EventManager(app) # type: ignore[arg-type] events.connect('builder-inited', lambda app: result.append(1), priority=500) events.connect('builder-inited', lambda app: result.append(2), priority=500) @@ -27,7 +33,7 @@ def test_event_priority() -> None: def test_event_allowed_exceptions() -> None: - def raise_error(app): + def raise_error(app: Sphinx) -> NoReturn: raise RuntimeError app = SimpleNamespace(pdb=False) # pass a dummy object as an app @@ -44,7 +50,7 @@ def raise_error(app): def test_event_pdb() -> None: - def raise_error(app): + def raise_error(app: Sphinx) -> NoReturn: raise RuntimeError app = SimpleNamespace(pdb=True) # pass a dummy object as an app diff --git a/tests/test_ext_autodoc/__init__.py b/tests/test_ext_autodoc/__init__.py new file mode 100644 index 00000000000..e69de29bb2d diff --git a/tests/test_ext_autodoc/autodoc_util.py b/tests/test_ext_autodoc/autodoc_util.py new file mode 100644 index 00000000000..f5eb2d44eef --- /dev/null +++ b/tests/test_ext_autodoc/autodoc_util.py @@ -0,0 +1,83 @@ +from __future__ import annotations + +from types import SimpleNamespace +from typing import TYPE_CHECKING + +from sphinx.environment import _CurrentDocument +from sphinx.events import EventManager +from sphinx.ext.autodoc._directive_options import _process_documenter_options +from sphinx.ext.autodoc._generate import _auto_document_object +from sphinx.ext.autodoc._shared import _AutodocConfig +from sphinx.util.inspect import safe_getattr + +if TYPE_CHECKING: + from collections.abc import Callable, Mapping + from typing import Any + + from sphinx.ext.autodoc._property_types import _AutodocObjType + +_DEFAULT_CONFIG = _AutodocConfig() + + +class FakeEvents(EventManager): + def __init__(self) -> None: + super().__init__(SimpleNamespace(pdb=False)) # type: ignore[arg-type] + + self.add('autodoc-before-process-signature') + self.add('autodoc-process-docstring') + self.add('autodoc-process-signature') + self.add('autodoc-skip-member') + self.add('autodoc-process-bases') + self.add('object-description-transform') + + def connect( + self, name: str, callback: Callable[..., Any], priority: int = 500 + ) -> int: + return super().connect(name, callback, priority) + + +def do_autodoc( + obj_type: _AutodocObjType, + name: str, + *, + config: _AutodocConfig = _DEFAULT_CONFIG, + current_document: _CurrentDocument | None = None, + events: FakeEvents | None = None, + expect_import_error: bool = False, + options: dict[str, Any] | None = None, + ref_context: Mapping[str, str | None] | None = None, +) -> list[str]: + if current_document is None: + current_document = _CurrentDocument(docname='index') + if events is None: + events = FakeEvents() + if ref_context is None: + ref_context = {} + reread_always: set[str] = set() + + options = {} if options is None else options.copy() + doc_options = _process_documenter_options( + obj_type=obj_type, + default_options=config.autodoc_default_options, + options=options, + ) + + content = _auto_document_object( + name=name, + obj_type=obj_type, + config=config, + current_document=current_document, + events=events, + get_attr=safe_getattr, + more_content=None, + options=doc_options, + record_dependencies=set(), + ref_context=ref_context, + reread_always=reread_always, + ) + if expect_import_error: + assert content is None + return [] + + assert content is not None + return content.data diff --git a/tests/test_ext_autodoc/conftest.py b/tests/test_ext_autodoc/conftest.py new file mode 100644 index 00000000000..22f99cc4e9c --- /dev/null +++ b/tests/test_ext_autodoc/conftest.py @@ -0,0 +1,20 @@ +from __future__ import annotations + +import sys + +import pytest + +from tests.utils import TEST_ROOTS_DIR + +TYPE_CHECKING = False +if TYPE_CHECKING: + from collections.abc import Iterator + + +@pytest.fixture(scope='module') +def inject_autodoc_root_into_sys_path() -> Iterator[None]: + autodoc_root_path = str(TEST_ROOTS_DIR / 'test-ext-autodoc') + + sys.path.insert(0, autodoc_root_path) + yield + sys.path[:] = [p for p in sys.path if p != autodoc_root_path] diff --git a/tests/test_extensions/test_ext_autodoc.py b/tests/test_ext_autodoc/test_ext_autodoc.py similarity index 63% rename from tests/test_extensions/test_ext_autodoc.py rename to tests/test_ext_autodoc/test_ext_autodoc.py index a06c1bbe30d..0d2c29d13fb 100644 --- a/tests/test_extensions/test_ext_autodoc.py +++ b/tests/test_ext_autodoc/test_ext_autodoc.py @@ -6,23 +6,29 @@ from __future__ import annotations -import functools import itertools -import operator +import logging +import pathlib import sys from typing import TYPE_CHECKING -from unittest.mock import Mock from warnings import catch_warnings import pytest -from sphinx import addnodes -from sphinx.ext.autodoc import ALL, ModuleLevelDocumenter, Options - -# NEVER import these objects from sphinx.ext.autodoc directly -from sphinx.ext.autodoc.directive import DocumenterBridge +from sphinx.environment import _CurrentDocument +from sphinx.ext.autodoc._directive_options import ( + _AutoDocumenterOptions, + inherited_members_option, +) +from sphinx.ext.autodoc._dynamic._docstrings import _get_docstring_lines +from sphinx.ext.autodoc._generate import _auto_document_object +from sphinx.ext.autodoc._legacy_class_based._documenters import Documenter +from sphinx.ext.autodoc._property_types import _ItemProperties +from sphinx.ext.autodoc._sentinels import ALL +from sphinx.ext.autodoc._shared import _AutodocAttrGetter, _AutodocConfig +from sphinx.util.inspect import safe_getattr -from tests.test_extensions.autodoc_util import do_autodoc +from tests.test_ext_autodoc.autodoc_util import FakeEvents, do_autodoc try: # Enable pyximport to test cython module @@ -35,359 +41,60 @@ if TYPE_CHECKING: from typing import Any - from sphinx.environment import BuildEnvironment - - -def make_directive_bridge(env: BuildEnvironment) -> DocumenterBridge: - options = Options( - inherited_members=False, - undoc_members=False, - private_members=False, - special_members=False, - imported_members=False, - show_inheritance=False, - no_index=False, - annotation=None, - synopsis='', - platform='', - deprecated=False, - members=[], - member_order='alphabetical', - exclude_members=set(), - ignore_module_all=False, - ) - - directive = DocumenterBridge( - env=env, - reporter=None, - options=options, - lineno=0, - state=Mock(), - ) - directive.state.document.settings.tab_width = 8 - - return directive - - -processed_signatures = [] + from sphinx.ext.autodoc._property_types import _AutodocObjType + from sphinx.ext.autodoc._shared import _AttrGetter +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') -@pytest.mark.sphinx('html', testroot='root') -def test_parse_name(app): - def verify(objtype, name, result): - inst = app.registry.documenters[objtype](directive, name) - assert inst.parse_name() - assert (inst.modname, inst.objpath, inst.args, inst.retann) == result +processed_signatures: list[tuple[str, str]] = [] - directive = make_directive_bridge(app.env) - # for modules - verify('module', 'test_ext_autodoc', ('test_ext_autodoc', [], None, None)) - verify('module', 'test.test_ext_autodoc', ('test.test_ext_autodoc', [], None, None)) - verify('module', 'test(arg)', ('test', [], 'arg', None)) - assert 'signature arguments' in app.warning.getvalue() +def get_docstring_lines(obj_type, obj): + config = _AutodocConfig() - # for functions/classes - verify( - 'function', - 'test_ext_autodoc.raises', - ('test_ext_autodoc', ['raises'], None, None), - ) - verify( - 'function', - 'test_ext_autodoc.raises(exc) -> None', - ('test_ext_autodoc', ['raises'], 'exc', 'None'), - ) - directive.env.current_document.autodoc_module = 'test_ext_autodoc' - verify('function', 'raises', ('test_ext_autodoc', ['raises'], None, None)) - directive.env.current_document.autodoc_module = '' - - directive.env.ref_context['py:module'] = 'test_ext_autodoc' - verify('function', 'raises', ('test_ext_autodoc', ['raises'], None, None)) - verify('class', 'Base', ('test_ext_autodoc', ['Base'], None, None)) - - # for members - directive.env.ref_context['py:module'] = 'sphinx.testing.util' - verify( - 'method', - 'SphinxTestApp.cleanup', - ('sphinx.testing.util', ['SphinxTestApp', 'cleanup'], None, None), + parent = object # dummy + props = _ItemProperties( + obj_type=obj_type, + module_name='', + parts=(obj.__name__,), + docstring_lines=(), + _obj=obj, + _obj___module__=getattr(obj, '__module__', None), ) - directive.env.ref_context['py:module'] = 'sphinx.testing.util' - directive.env.ref_context['py:class'] = 'Foo' - directive.env.current_document.autodoc_class = 'SphinxTestApp' - verify( - 'method', - 'cleanup', - ('sphinx.testing.util', ['SphinxTestApp', 'cleanup'], None, None), - ) - verify( - 'method', - 'SphinxTestApp.cleanup', - ('sphinx.testing.util', ['SphinxTestApp', 'cleanup'], None, None), - ) - - -@pytest.mark.sphinx('html', testroot='root') -def test_format_signature(app): - def process_signature(app, what, name, obj, options, args, retann): - processed_signatures.append((what, name)) - if name == 'bar': - return '42', None - return None - - def skip_member(app, what, name, obj, skip, options): - if name in {'__special1__', '__special2__'}: - return skip - if name.startswith('__'): - return True - if name == 'skipmeth': - return True - return None - - app.connect('autodoc-process-signature', process_signature) - app.connect('autodoc-skip-member', skip_member) - - directive = make_directive_bridge(app.env) - - def formatsig(objtype, name, obj, args, retann): - inst = app.registry.documenters[objtype](directive, name) - inst.fullname = name - inst.doc_as_attr = False # for class objtype - inst.parent = object # dummy - inst.object = obj - inst.objpath = [name] - inst.args = args - inst.retann = retann - res = inst.format_signature() - print(res) - return res - - # no signatures for modules - assert formatsig('module', 'test', None, None, None) == '' - - # test for functions - def f(a, b, c=1, **d): - pass - - def g(a='\n'): - pass - - assert formatsig('function', 'f', f, None, None) == '(a, b, c=1, **d)' - assert formatsig('function', 'f', f, 'a, b, c, d', None) == '(a, b, c, d)' - assert formatsig('function', 'g', g, None, None) == r"(a='\n')" - - if sys.version_info >= (3, 12): - for params, expect in [ - ('(a=1)', '(a=1)'), - ('(a: int=1)', '(a: int = 1)'), # auto whitespace formatting - ('(a:list[T] =[], b=None)', '(a: list[T] = [], b=None)'), # idem - ]: - ns = {} - exec(f'def f[T]{params}: pass', ns) # NoQA: S102 - f = ns['f'] - assert formatsig('function', 'f', f, None, None) == expect - assert formatsig('function', 'f', f, '...', None) == '(...)' - assert formatsig('function', 'f', f, '...', '...') == '(...) -> ...' - - exec(f'def f[T]{params} -> list[T]: return []', ns) # NoQA: S102 - f = ns['f'] - assert formatsig('function', 'f', f, None, None) == f'{expect} -> list[T]' - assert formatsig('function', 'f', f, '...', None) == '(...)' - assert formatsig('function', 'f', f, '...', '...') == '(...) -> ...' - - # TODO(picnixz): add more test cases for PEP-695 classes as well (though - # complex cases are less likely to appear and are painful to test). - - # test for classes - class D: - pass - - class E: - def __init__(self): - pass - - # an empty init and no init are the same - for C in (D, E): - assert formatsig('class', 'D', C, None, None) == '()' - - class SomeMeta(type): - def __call__(cls, a, b=None): - return type.__call__(cls, a, b) - - # these three are all equivalent - class F: - def __init__(self, a, b=None): - pass - - class FNew: - def __new__(cls, a, b=None): # NoQA: ARG004 - return super().__new__(cls) - - class FMeta(metaclass=SomeMeta): - pass - - # and subclasses should always inherit - class G(F): - pass - - class GNew(FNew): - pass - - class GMeta(FMeta): - pass - - # subclasses inherit - for C in (F, FNew, FMeta, G, GNew, GMeta): - assert formatsig('class', 'C', C, None, None) == '(a, b=None)' - assert formatsig('class', 'C', D, 'a, b', 'X') == '(a, b) -> X' - - class ListSubclass(list): # NoQA: FURB189 - pass - - # only supported if the python implementation decides to document it - if getattr(list, '__text_signature__', None) is not None: - assert formatsig('class', 'C', ListSubclass, None, None) == '(iterable=(), /)' - else: - assert formatsig('class', 'C', ListSubclass, None, None) == '' - - class ExceptionSubclass(Exception): - pass - - # Exception has no __text_signature__ at least in Python 3.11 - if getattr(Exception, '__text_signature__', None) is None: - assert formatsig('class', 'C', ExceptionSubclass, None, None) == '' - - # __init__ have signature at first line of docstring - directive.env.config.autoclass_content = 'both' - - class F2: - """some docstring for F2.""" - - def __init__(self, *args, **kw): - """__init__(a1, a2, kw1=True, kw2=False) - - some docstring for __init__. - """ - - class G2(F2): - pass - - assert formatsig('class', 'F2', F2, None, None) == '(a1, a2, kw1=True, kw2=False)' - assert formatsig('class', 'G2', G2, None, None) == '(a1, a2, kw1=True, kw2=False)' - - # test for methods - class H: - def foo1(self, b, *c): - pass - - def foo2(b, *c): # NoQA: N805 - pass - - def foo3(self, d='\n'): - pass - - assert formatsig('method', 'H.foo', H.foo1, None, None) == '(b, *c)' - assert formatsig('method', 'H.foo', H.foo1, 'a', None) == '(a)' - assert formatsig('method', 'H.foo', H.foo2, None, None) == '(*c)' - assert formatsig('method', 'H.foo', H.foo3, None, None) == r"(d='\n')" - - # test bound methods interpreted as functions - assert formatsig('function', 'foo', H().foo1, None, None) == '(b, *c)' - assert formatsig('function', 'foo', H().foo2, None, None) == '(*c)' - assert formatsig('function', 'foo', H().foo3, None, None) == r"(d='\n')" - - # test exception handling (exception is caught and args is '') - directive.env.config.autodoc_docstring_signature = False - assert formatsig('function', 'int', int, None, None) == '' - - # test processing by event handler - assert formatsig('method', 'bar', H.foo1, None, None) == '42' - - # test functions created via functools.partial - from functools import partial - - curried1 = partial(lambda a, b, c: None, 'A') - assert formatsig('function', 'curried1', curried1, None, None) == '(b, c)' - curried2 = partial(lambda a, b, c=42: None, 'A') - assert formatsig('function', 'curried2', curried2, None, None) == '(b, c=42)' - curried3 = partial(lambda a, b, *c: None, 'A') - assert formatsig('function', 'curried3', curried3, None, None) == '(b, *c)' - curried4 = partial(lambda a, b, c=42, *d, **e: None, 'A') - assert ( - formatsig('function', 'curried4', curried4, None, None) == '(b, c=42, *d, **e)' + ds = _get_docstring_lines( + props, + class_doc_from=config.autoclass_content, + get_attr=safe_getattr, + inherit_docstrings=config.autodoc_inherit_docstrings, + parent=parent, + tab_width=8, ) + # for testing purposes, concat them and strip the empty line at the end + res = list(itertools.chain.from_iterable(ds or ())) + if res: + res.pop() + return tuple(res) -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_process_signature_typing_generic(app): - actual = do_autodoc(app, 'class', 'target.generic_class.A', {}) - - assert list(actual) == [ - '', - '.. py:class:: A(a, b=None)', - ' :module: target.generic_class', - '', - ' docstring for A', - '', - ] - - -@pytest.mark.sphinx('html', testroot='root') -def test_autodoc_process_signature_typehints(app): - captured = [] - - def process_signature(*args): - captured.append(args) - - app.connect('autodoc-process-signature', process_signature) - - def func(x: int, y: int) -> int: # type: ignore[empty-body] - pass - - directive = make_directive_bridge(app.env) - inst = app.registry.documenters['function'](directive, 'func') - inst.fullname = 'func' - inst.object = func - inst.objpath = ['func'] - inst.format_signature() - assert captured == [ - (app, 'function', 'func', func, directive.genopt, '(x: int, y: int)', 'int') - ] - - -@pytest.mark.sphinx('html', testroot='root') -def test_get_doc(app): - directive = make_directive_bridge(app.env) - - def getdocl(objtype, obj): - inst = app.registry.documenters[objtype](directive, 'tmp') - inst.parent = object # dummy - inst.object = obj - inst.objpath = [obj.__name__] - inst.doc_as_attr = False - inst.format_signature() # handle docstring signatures! - ds = inst.get_doc() - # for testing purposes, concat them and strip the empty line at the end - res = functools.reduce(operator.iadd, ds, [])[:-1] - print(res) - return res - +def test_get_docstring_lines(): # objects without docstring def f(): pass - assert getdocl('function', f) == [] + assert get_docstring_lines('function', f) == () # standard function, diverse docstring styles... def f(): """Docstring""" - def g(): - """Docstring""" + assert get_docstring_lines('function', f) == ('Docstring',) + + def f(): + """ + Docstring + """ # NoQA: D212 - for func in (f, g): - assert getdocl('function', func) == ['Docstring'] + assert get_docstring_lines('function', f) == ('Docstring',) # first line vs. other lines indentation def f(): @@ -397,13 +104,18 @@ def f(): lines """ - assert getdocl('function', f) == ['First line', '', 'Other', ' lines'] + assert get_docstring_lines('function', f) == ( + 'First line', + '', + 'Other', + ' lines', + ) # charset guessing (this module is encoded in utf-8) def f(): """Döcstring""" - assert getdocl('function', f) == ['Döcstring'] + assert get_docstring_lines('function', f) == ('Döcstring',) # verify that method docstrings get extracted in both normal case # and in case of bound method posing as a function @@ -411,29 +123,33 @@ class J: def foo(self): """Method docstring""" - assert getdocl('method', J.foo) == ['Method docstring'] - assert getdocl('function', J().foo) == ['Method docstring'] + expected = ('Method docstring',) + assert get_docstring_lines('method', J.foo) == expected + assert get_docstring_lines('function', J().foo) == expected -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_new_documenter(app): - class MyDocumenter(ModuleLevelDocumenter): - objtype = 'integer' - directivetype = 'integer' - priority = 100 +class _MyDocumenter(Documenter): + objtype = 'integer' + directivetype = 'integer' + priority = 100 - @classmethod - def can_document_member(cls, member, membername, isattr, parent): - return isinstance(member, int) + @classmethod + def can_document_member(cls, member, membername, isattr, parent): + return isinstance(member, int) - def document_members(self, all_members=False): - return + def document_members(self, all_members=False): + return - app.add_autodocumenter(MyDocumenter) + +def test_new_documenter(): + config = _AutodocConfig() + # app.add_autodocumenter(_MyDocumenter) options = {'members': 'integer'} - actual = do_autodoc(app, 'module', 'target', options) - assert list(actual) == [ + # TODO: Fix! Perhaps add a way to signal module/class-level? + actual = do_autodoc('module', 'target', config=config, options=options) + return + assert actual == [ '', '.. py:module:: target', '', @@ -446,24 +162,11 @@ def document_members(self, all_members=False): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_attrgetter_using(app): - directive = make_directive_bridge(app.env) - directive.genopt['members'] = ALL - - directive.genopt['inherited_members'] = False - with catch_warnings(record=True): - _assert_getter_works(app, directive, 'class', 'target.Class', ['meth']) - - directive.genopt['inherited_members'] = True - with catch_warnings(record=True): - _assert_getter_works( - app, directive, 'class', 'target.inheritance.Derived', ['inheritedmeth'] - ) +getattr_spy = [] -def _assert_getter_works(app, directive, objtype, name, attrs=(), **kw): - getattr_spy = [] +def test_attrgetter_using(): + attrs = [] def _special_getattr(obj, attr_name, *defargs): if attr_name in attrs: @@ -471,10 +174,60 @@ def _special_getattr(obj, attr_name, *defargs): return None return getattr(obj, attr_name, *defargs) - app.add_autodoc_attrgetter(type, _special_getattr) + # See Sphinx.add_autodoc_attrgetter() + autodoc_attrgetters = {type: _special_getattr} + get_attr = _AutodocAttrGetter(autodoc_attrgetters) + options = _AutoDocumenterOptions(members=ALL) + + options.inherited_members = inherited_members_option(False) + attrs[:] = ['meth'] + with catch_warnings(record=True): + _assert_getter_works( + 'class', + 'target.Class', + *attrs, + get_attr=get_attr, + options=options, + ) + options.inherited_members = inherited_members_option(True) + attrs[:] = ['inheritedmeth'] + with catch_warnings(record=True): + _assert_getter_works( + 'class', + 'target.inheritance.Derived', + *attrs, + get_attr=get_attr, + options=options, + ) + + +def _assert_getter_works( + objtype: _AutodocObjType, + name: str, + *attrs: str, + get_attr: _AttrGetter, + options: _AutoDocumenterOptions, +) -> None: getattr_spy.clear() - app.registry.documenters[objtype](directive, name).generate(**kw) + + config = _AutodocConfig() + current_document = _CurrentDocument() + events = FakeEvents() + + _auto_document_object( + config=config, + current_document=current_document, + events=events, + get_attr=get_attr, + more_content=None, + name=name, + obj_type=objtype, + options=options, + record_dependencies=set(), + ref_context={}, + reread_always=set(), + ) hooked_members = {s[1] for s in getattr_spy} documented_members = {s[1] for s in processed_signatures} @@ -484,21 +237,25 @@ def _special_getattr(obj, attr_name, *defargs): assert fullname not in documented_members, f'{fullname!r} not intercepted' -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_py_module(app): +def test_py_module(caplog: pytest.LogCaptureFixture) -> None: + # work around sphinx.util.logging.setup() + logger = logging.getLogger('sphinx') + logger.handlers[:] = [caplog.handler] + caplog.set_level(logging.WARNING) + # without py:module - actual = do_autodoc(app, 'method', 'Class.meth') - assert list(actual) == [] + actual = do_autodoc('method', 'Class.meth', expect_import_error=True) + assert actual == [] + assert len(set(caplog.messages)) == 1 assert ( "don't know which module to import for autodocumenting 'Class.meth'" - ) in app.warning.getvalue() + ) in caplog.messages[0] + caplog.clear() # with py:module - app.env.ref_context['py:module'] = 'target' - app.warning.truncate(0) - - actual = do_autodoc(app, 'method', 'Class.meth') - assert list(actual) == [ + ref_context: dict[str, Any] = {'py:module': 'target'} + actual = do_autodoc('method', 'Class.meth', ref_context=ref_context) + assert actual == [ '', '.. py:method:: Class.meth()', ' :module: target', @@ -506,15 +263,12 @@ def test_py_module(app): ' Function.', '', ] - assert ( - "don't know which module to import for autodocumenting 'Class.meth'" - ) not in app.warning.getvalue() + assert len(caplog.records) == 0 -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_decorator(app): - actual = do_autodoc(app, 'decorator', 'target.decorator.deco1') - assert list(actual) == [ +def test_autodoc_decorator() -> None: + actual = do_autodoc('decorator', 'target.decorator.deco1') + assert actual == [ '', '.. py:decorator:: deco1', ' :module: target.decorator', @@ -523,8 +277,8 @@ def test_autodoc_decorator(app): '', ] - actual = do_autodoc(app, 'decorator', 'target.decorator.deco2') - assert list(actual) == [ + actual = do_autodoc('decorator', 'target.decorator.deco2') + assert actual == [ '', '.. py:decorator:: deco2(condition, message)', ' :module: target.decorator', @@ -534,10 +288,9 @@ def test_autodoc_decorator(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_exception(app): - actual = do_autodoc(app, 'exception', 'target.CustomEx') - assert list(actual) == [ +def test_autodoc_exception() -> None: + actual = do_autodoc('exception', 'target.CustomEx') + assert actual == [ '', '.. py:exception:: CustomEx', ' :module: target', @@ -547,39 +300,63 @@ def test_autodoc_exception(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_warnings(app): - app.env.current_document.docname = 'dummy' +def test_autodoc_warnings(caplog: pytest.LogCaptureFixture) -> None: + # work around sphinx.util.logging.setup() + logger = logging.getLogger('sphinx') + logger.handlers[:] = [caplog.handler] + caplog.set_level(logging.WARNING) + + current_document = _CurrentDocument(docname='dummy') # can't import module - do_autodoc(app, 'module', 'unknown') - assert "failed to import module 'unknown'" in app.warning.getvalue() + caplog.clear() + do_autodoc( + 'module', 'unknown', current_document=current_document, expect_import_error=True + ) + assert len(set(caplog.messages)) == 1 + assert "failed to import 'unknown'" in caplog.messages[0] # missing function - do_autodoc(app, 'function', 'unknown') - assert "import for autodocumenting 'unknown'" in app.warning.getvalue() + caplog.clear() + do_autodoc( + 'function', + 'unknown', + current_document=current_document, + expect_import_error=True, + ) + assert len(set(caplog.messages)) == 1 + assert "import for autodocumenting 'unknown'" in caplog.messages[0] - do_autodoc(app, 'function', 'target.unknown') - assert ( - "failed to import function 'unknown' from module 'target'" - ) in app.warning.getvalue() + caplog.clear() + do_autodoc( + 'function', + 'target.unknown', + current_document=current_document, + expect_import_error=True, + ) + assert len(set(caplog.messages)) == 1 + assert "failed to import 'unknown' from module 'target'" in caplog.messages[0] # missing method - do_autodoc(app, 'method', 'target.Class.unknown') - assert ( - "failed to import method 'Class.unknown' from module 'target'" - ) in app.warning.getvalue() + caplog.clear() + do_autodoc( + 'method', + 'target.Class.unknown', + current_document=current_document, + expect_import_error=True, + ) + assert len(set(caplog.messages)) == 1 + assert "failed to import 'Class.unknown' from module 'target'" in caplog.messages[0] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_attributes(app): +def test_autodoc_attributes() -> None: options = { 'synopsis': 'Synopsis', 'platform': 'Platform', 'deprecated': None, } - actual = do_autodoc(app, 'module', 'target', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target', options=options) + assert actual == [ '', '.. py:module:: target', ' :synopsis: Synopsis', @@ -589,18 +366,19 @@ def test_autodoc_attributes(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_members(app): +def test_autodoc_members() -> None: + options: dict[str, Any] + # default (no-members) - actual = do_autodoc(app, 'class', 'target.inheritance.Base') - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.inheritance.Base') + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ] # default ALL-members options = {'members': None} - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.inheritance.Base', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:attribute:: Base.inheritedattr', ' .. py:method:: Base.inheritedclassmeth()', @@ -610,8 +388,8 @@ def test_autodoc_members(app): # default specific-members options = {'members': 'inheritedmeth,inheritedstaticmeth'} - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.inheritance.Base', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:method:: Base.inheritedmeth()', ' .. py:method:: Base.inheritedstaticmeth(cls)', @@ -619,9 +397,11 @@ def test_autodoc_members(app): # ALL-members override autodoc_default_options options = {'members': None} - app.config.autodoc_default_options['members'] = 'inheritedstaticmeth' - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + config = _AutodocConfig(autodoc_default_options={'members': 'inheritedstaticmeth'}) + actual = do_autodoc( + 'class', 'target.inheritance.Base', config=config, options=options + ) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:attribute:: Base.inheritedattr', ' .. py:method:: Base.inheritedclassmeth()', @@ -631,32 +411,33 @@ def test_autodoc_members(app): # members override autodoc_default_options options = {'members': 'inheritedmeth'} - app.config.autodoc_default_options['members'] = 'inheritedstaticmeth' - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc( + 'class', 'target.inheritance.Base', config=config, options=options + ) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:method:: Base.inheritedmeth()', ] # members extends autodoc_default_options options = {'members': '+inheritedmeth'} - app.config.autodoc_default_options['members'] = 'inheritedstaticmeth' - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc( + 'class', 'target.inheritance.Base', config=config, options=options + ) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:method:: Base.inheritedmeth()', ' .. py:method:: Base.inheritedstaticmeth(cls)', ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_exclude_members(app): +def test_autodoc_exclude_members() -> None: options = { 'members': None, 'exclude-members': 'inheritedmeth,inheritedstaticmeth', } - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.inheritance.Base', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:attribute:: Base.inheritedattr', ' .. py:method:: Base.inheritedclassmeth()', @@ -667,8 +448,8 @@ def test_autodoc_exclude_members(app): 'members': 'inheritedmeth', 'exclude-members': 'inheritedmeth', } - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.inheritance.Base', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ] @@ -677,8 +458,8 @@ def test_autodoc_exclude_members(app): 'members': None, 'exclude-members': '+inheritedmeth,inheritedstaticmeth', } - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.inheritance.Base', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:attribute:: Base.inheritedattr', ' .. py:method:: Base.inheritedclassmeth()', @@ -689,9 +470,13 @@ def test_autodoc_exclude_members(app): 'members': None, 'exclude-members': 'inheritedmeth', } - app.config.autodoc_default_options['exclude-members'] = 'inheritedstaticmeth' - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + config = _AutodocConfig( + autodoc_default_options={'exclude-members': 'inheritedstaticmeth'} + ) + actual = do_autodoc( + 'class', 'target.inheritance.Base', config=config, options=options + ) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:attribute:: Base.inheritedattr', ' .. py:method:: Base.inheritedclassmeth()', @@ -703,9 +488,13 @@ def test_autodoc_exclude_members(app): 'members': None, 'exclude-members': '+inheritedmeth', } - app.config.autodoc_default_options['exclude-members'] = 'inheritedstaticmeth' - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + config = _AutodocConfig( + autodoc_default_options={'exclude-members': 'inheritedstaticmeth'} + ) + actual = do_autodoc( + 'class', 'target.inheritance.Base', config=config, options=options + ) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:attribute:: Base.inheritedattr', ' .. py:method:: Base.inheritedclassmeth()', @@ -713,11 +502,13 @@ def test_autodoc_exclude_members(app): # no exclude-members causes use autodoc_default_options options = {'members': None} - app.config.autodoc_default_options['exclude-members'] = ( - 'inheritedstaticmeth,inheritedmeth' + config = _AutodocConfig( + autodoc_default_options={'exclude-members': 'inheritedstaticmeth,inheritedmeth'} ) - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc( + 'class', 'target.inheritance.Base', config=config, options=options + ) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:attribute:: Base.inheritedattr', ' .. py:method:: Base.inheritedclassmeth()', @@ -728,11 +519,13 @@ def test_autodoc_exclude_members(app): 'members': None, 'exclude-members': None, } - app.config.autodoc_default_options['exclude-members'] = ( - 'inheritedstaticmeth,inheritedmeth' + config = _AutodocConfig( + autodoc_default_options={'exclude-members': 'inheritedstaticmeth,inheritedmeth'} ) - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc( + 'class', 'target.inheritance.Base', config=config, options=options + ) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Base()', ' .. py:attribute:: Base.inheritedattr', ' .. py:method:: Base.inheritedclassmeth()', @@ -741,14 +534,13 @@ def test_autodoc_exclude_members(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_undoc_members(app): +def test_autodoc_undoc_members() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.Class', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', ' .. py:method:: Class.a_staticmeth()', ' .. py:attribute:: Class.attr', @@ -770,9 +562,9 @@ def test_autodoc_undoc_members(app): # use autodoc_default_options options = {'members': None} - app.config.autodoc_default_options['undoc-members'] = None - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + config = _AutodocConfig(autodoc_default_options={'undoc-members': True}) + actual = do_autodoc('class', 'target.Class', config=config, options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', ' .. py:method:: Class.a_staticmeth()', ' .. py:attribute:: Class.attr', @@ -797,9 +589,8 @@ def test_autodoc_undoc_members(app): 'members': None, 'no-undoc-members': None, } - app.config.autodoc_default_options['undoc-members'] = None - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.Class', config=config, options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', ' .. py:attribute:: Class.attr', ' .. py:attribute:: Class.docattr', @@ -815,12 +606,11 @@ def test_autodoc_undoc_members(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_undoc_members_for_metadata_only(app): +def test_autodoc_undoc_members_for_metadata_only() -> None: # metadata only member is not displayed options = {'members': None} - actual = do_autodoc(app, 'module', 'target.metadata', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.metadata', options=options) + assert actual == [ '', '.. py:module:: target.metadata', '', @@ -831,8 +621,8 @@ def test_autodoc_undoc_members_for_metadata_only(app): 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'target.metadata', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.metadata', options=options) + assert actual == [ '', '.. py:module:: target.metadata', '', @@ -845,14 +635,13 @@ def test_autodoc_undoc_members_for_metadata_only(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_inherited_members(app): +def test_autodoc_inherited_members() -> None: options = { 'members': None, 'inherited-members': None, } - actual = do_autodoc(app, 'class', 'target.inheritance.Derived', options) - assert list(filter(lambda l: 'method::' in l, actual)) == [ + actual = do_autodoc('class', 'target.inheritance.Derived', options=options) + assert [line for line in actual if 'method::' in line] == [ ' .. py:method:: Derived.another_inheritedmeth()', ' .. py:method:: Derived.inheritedclassmeth()', ' .. py:method:: Derived.inheritedmeth()', @@ -860,8 +649,7 @@ def test_autodoc_inherited_members(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_inherited_members_Base(app): +def test_autodoc_inherited_members_Base() -> None: options = { 'members': None, 'inherited-members': 'Base', @@ -869,13 +657,12 @@ def test_autodoc_inherited_members_Base(app): } # check methods for object class are shown - actual = do_autodoc(app, 'class', 'target.inheritance.Derived', options) + actual = do_autodoc('class', 'target.inheritance.Derived', options=options) assert ' .. py:method:: Derived.inheritedmeth()' in actual assert ' .. py:method:: Derived.inheritedclassmeth' not in actual -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_inherited_members_None(app): +def test_autodoc_inherited_members_None() -> None: options = { 'members': None, 'inherited-members': 'None', @@ -883,33 +670,31 @@ def test_autodoc_inherited_members_None(app): } # check methods for object class are shown - actual = do_autodoc(app, 'class', 'target.inheritance.Derived', options) + actual = do_autodoc('class', 'target.inheritance.Derived', options=options) assert ' .. py:method:: Derived.__init__()' in actual assert ' .. py:method:: Derived.__str__()' in actual -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_imported_members(app): +def test_autodoc_imported_members() -> None: options = { 'members': None, 'imported-members': None, 'ignore-module-all': None, } - actual = do_autodoc(app, 'module', 'target', options) + actual = do_autodoc('module', 'target', options=options) assert ( '.. py:function:: function_to_be_imported(app: ~sphinx.application.Sphinx | None) -> str' ) in actual -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_special_members(app): +def test_autodoc_special_members() -> None: # specific special methods options = { 'undoc-members': None, 'special-members': '__init__,__special1__', } - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.Class', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', ' .. py:method:: Class.__init__(arg)', ' .. py:method:: Class.__special1__()', @@ -921,8 +706,8 @@ def test_autodoc_special_members(app): 'undoc-members': None, 'special-members': '__init__,__special1__', } - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.Class', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', ' .. py:method:: Class.__init__(arg)', ' .. py:method:: Class.__special1__()', @@ -938,10 +723,17 @@ def test_autodoc_special_members(app): } if sys.version_info >= (3, 13, 0, 'alpha', 5): options['exclude-members'] = '__static_attributes__,__firstlineno__' - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + if sys.version_info >= (3, 14, 0, 'alpha', 7): + ann_attrs: tuple[str, ...] = ( + ' .. py:attribute:: Class.__annotate_func__', + ' .. py:attribute:: Class.__annotations_cache__', + ) + else: + ann_attrs = (' .. py:attribute:: Class.__annotations__',) + actual = do_autodoc('class', 'target.Class', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', - ' .. py:attribute:: Class.__annotations__', + *ann_attrs, ' .. py:attribute:: Class.__dict__', ' .. py:method:: Class.__init__(arg)', ' .. py:attribute:: Class.__module__', @@ -968,9 +760,9 @@ def test_autodoc_special_members(app): # specific special methods from autodoc_default_options options = {'undoc-members': None} - app.config.autodoc_default_options['special-members'] = '__special2__' - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + config = _AutodocConfig(autodoc_default_options={'special-members': '__special2__'}) + actual = do_autodoc('class', 'target.Class', config=config, options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', ' .. py:method:: Class.__special2__()', ] @@ -980,9 +772,8 @@ def test_autodoc_special_members(app): 'undoc-members': None, 'special-members': '__init__,__special1__', } - app.config.autodoc_default_options['special-members'] = '__special2__' - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.Class', config=config, options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', ' .. py:method:: Class.__init__(arg)', ' .. py:method:: Class.__special1__()', @@ -993,9 +784,8 @@ def test_autodoc_special_members(app): 'undoc-members': None, 'special-members': '+__init__,__special1__', } - app.config.autodoc_default_options['special-members'] = '__special2__' - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.Class', config=config, options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', ' .. py:method:: Class.__init__(arg)', ' .. py:method:: Class.__special1__()', @@ -1003,12 +793,11 @@ def test_autodoc_special_members(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_ignore_module_all(app): +def test_autodoc_ignore_module_all() -> None: # default (no-ignore-module-all) options = {'members': None} - actual = do_autodoc(app, 'module', 'target', options) - assert list(filter(lambda l: 'class::' in l, actual)) == [ + actual = do_autodoc('module', 'target', options=options) + assert [line for line in actual if 'class::' in line] == [ '.. py:class:: Class(arg)', ] @@ -1017,8 +806,8 @@ def test_autodoc_ignore_module_all(app): 'members': None, 'ignore-module-all': None, } - actual = do_autodoc(app, 'module', 'target', options) - assert list(filter(lambda l: 'class::' in l, actual)) == [ + actual = do_autodoc('module', 'target', options=options) + assert [line for line in actual if 'class::' in line] == [ '.. py:class:: Class(arg)', '.. py:class:: CustomDict', '.. py:class:: InnerChild()', @@ -1029,11 +818,10 @@ def test_autodoc_ignore_module_all(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_noindex(app): +def test_autodoc_noindex() -> None: options = {'no-index': None} - actual = do_autodoc(app, 'module', 'target', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target', options=options) + assert actual == [ '', '.. py:module:: target', ' :no-index:', @@ -1042,8 +830,8 @@ def test_autodoc_noindex(app): # TODO: :no-index: should be propagated to children of target item. - actual = do_autodoc(app, 'class', 'target.inheritance.Base', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.inheritance.Base', options=options) + assert actual == [ '', '.. py:class:: Base()', ' :no-index:', @@ -1052,11 +840,10 @@ def test_autodoc_noindex(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_subclass_of_builtin_class(app): +def test_autodoc_subclass_of_builtin_class() -> None: options = {'members': None} - actual = do_autodoc(app, 'class', 'target.CustomDict', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.CustomDict', options=options) + assert actual == [ '', '.. py:class:: CustomDict', ' :module: target', @@ -1066,11 +853,10 @@ def test_autodoc_subclass_of_builtin_class(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_inner_class(app): +def test_autodoc_inner_class() -> None: options = {'members': None} - actual = do_autodoc(app, 'class', 'target.Outer', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.Outer', options=options) + assert actual == [ '', '.. py:class:: Outer()', ' :module: target', @@ -1096,8 +882,8 @@ def test_autodoc_inner_class(app): ' alias of :py:class:`dict`', ] - actual = do_autodoc(app, 'class', 'target.Outer.Inner', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.Outer.Inner', options=options) + assert actual == [ '', '.. py:class:: Inner()', ' :module: target.Outer', @@ -1113,8 +899,8 @@ def test_autodoc_inner_class(app): ] options['show-inheritance'] = None - actual = do_autodoc(app, 'class', 'target.InnerChild', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.InnerChild', options=options) + assert actual == [ '', '.. py:class:: InnerChild()', ' :module: target', @@ -1126,10 +912,9 @@ def test_autodoc_inner_class(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_classmethod(app): - actual = do_autodoc(app, 'method', 'target.inheritance.Base.inheritedclassmeth') - assert list(actual) == [ +def test_autodoc_classmethod() -> None: + actual = do_autodoc('method', 'target.inheritance.Base.inheritedclassmeth') + assert actual == [ '', '.. py:method:: Base.inheritedclassmeth()', ' :module: target.inheritance', @@ -1140,10 +925,9 @@ def test_autodoc_classmethod(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_staticmethod(app): - actual = do_autodoc(app, 'method', 'target.inheritance.Base.inheritedstaticmeth') - assert list(actual) == [ +def test_autodoc_staticmethod() -> None: + actual = do_autodoc('method', 'target.inheritance.Base.inheritedstaticmeth') + assert actual == [ '', '.. py:method:: Base.inheritedstaticmeth(cls)', ' :module: target.inheritance', @@ -1154,14 +938,13 @@ def test_autodoc_staticmethod(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_descriptor(app): +def test_autodoc_descriptor() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'class', 'target.descriptor.Class', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.descriptor.Class', options=options) + assert actual == [ '', '.. py:class:: Class()', ' :module: target.descriptor', @@ -1181,14 +964,13 @@ def test_autodoc_descriptor(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_cached_property(app): +def test_autodoc_cached_property() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'class', 'target.cached_property.Foo', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.cached_property.Foo', options=options) + assert actual == [ '', '.. py:class:: Foo()', ' :module: target.cached_property', @@ -1206,8 +988,7 @@ def test_autodoc_cached_property(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_member_order(app): +def test_autodoc_member_order() -> None: # case member-order='bysource' options = { 'members': None, @@ -1215,8 +996,8 @@ def test_autodoc_member_order(app): 'undoc-members': None, 'private-members': None, } - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.Class', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', ' .. py:method:: Class.meth()', ' .. py:method:: Class.undocmeth()', @@ -1244,8 +1025,8 @@ def test_autodoc_member_order(app): 'undoc-members': None, 'private-members': None, } - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.Class', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', # class methods ' .. py:method:: Class.moore(a, e, f) -> happiness', @@ -1275,8 +1056,8 @@ def test_autodoc_member_order(app): 'undoc-members': None, 'private-members': None, } - actual = do_autodoc(app, 'class', 'target.Class', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('class', 'target.Class', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:class:: Class(arg)', ' .. py:attribute:: Class._private_inst_attr', ' .. py:method:: Class.a_staticmeth()', @@ -1298,16 +1079,15 @@ def test_autodoc_member_order(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_module_member_order(app): +def test_autodoc_module_member_order() -> None: # case member-order='bysource' options = { 'members': 'foo, Bar, baz, qux, Quux, foobar', 'member-order': 'bysource', 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'target.sort_by_all', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('module', 'target.sort_by_all', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:module:: target.sort_by_all', '.. py:function:: baz()', '.. py:function:: foo()', @@ -1324,8 +1104,8 @@ def test_autodoc_module_member_order(app): 'undoc-members': None, 'ignore-module-all': None, } - actual = do_autodoc(app, 'module', 'target.sort_by_all', options) - assert list(filter(lambda l: '::' in l, actual)) == [ + actual = do_autodoc('module', 'target.sort_by_all', options=options) + assert [line for line in actual if '::' in line] == [ '.. py:module:: target.sort_by_all', '.. py:function:: foo()', '.. py:class:: Bar()', @@ -1336,11 +1116,13 @@ def test_autodoc_module_member_order(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_module_scope(app): - app.env.current_document.autodoc_module = 'target' - actual = do_autodoc(app, 'attribute', 'Class.mdocattr') - assert list(actual) == [ +def test_autodoc_module_scope() -> None: + current_document = _CurrentDocument(docname='index') + current_document.autodoc_module = 'target' + actual = do_autodoc( + 'attribute', 'Class.mdocattr', current_document=current_document + ) + assert actual == [ '', '.. py:attribute:: Class.mdocattr', ' :module: target', @@ -1351,12 +1133,12 @@ def test_autodoc_module_scope(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_class_scope(app): - app.env.current_document.autodoc_module = 'target' - app.env.current_document.autodoc_class = 'Class' - actual = do_autodoc(app, 'attribute', 'mdocattr') - assert list(actual) == [ +def test_autodoc_class_scope() -> None: + current_document = _CurrentDocument(docname='index') + current_document.autodoc_module = 'target' + current_document.autodoc_class = 'Class' + actual = do_autodoc('attribute', 'mdocattr', current_document=current_document) + assert actual == [ '', '.. py:attribute:: Class.mdocattr', ' :module: target', @@ -1367,14 +1149,13 @@ def test_autodoc_class_scope(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_class_attributes(app): +def test_class_attributes() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'class', 'target.AttCls', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.AttCls', options=options) + assert actual == [ '', '.. py:class:: AttCls()', ' :module: target', @@ -1392,11 +1173,11 @@ def test_class_attributes(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoclass_instance_attributes(app): +def test_autoclass_instance_attributes() -> None: + options: dict[str, Any] options = {'members': None} - actual = do_autodoc(app, 'class', 'target.InstAttCls', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.InstAttCls', options=options) + assert actual == [ '', '.. py:class:: InstAttCls()', ' :module: target', @@ -1440,11 +1221,9 @@ def test_autoclass_instance_attributes(app): ] # pick up arbitrary attributes - options = { - 'members': 'ca1,ia1', - } - actual = do_autodoc(app, 'class', 'target.InstAttCls', options) - assert list(actual) == [ + options = {'members': 'ca1,ia1'} + actual = do_autodoc('class', 'target.InstAttCls', options=options) + assert actual == [ '', '.. py:class:: InstAttCls()', ' :module: target', @@ -1468,10 +1247,9 @@ def test_autoclass_instance_attributes(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_instance_attributes(app): - actual = do_autodoc(app, 'attribute', 'target.InstAttCls.ia1') - assert list(actual) == [ +def test_autoattribute_instance_attributes() -> None: + actual = do_autodoc('attribute', 'target.InstAttCls.ia1') + assert actual == [ '', '.. py:attribute:: InstAttCls.ia1', ' :module: target', @@ -1481,14 +1259,13 @@ def test_autoattribute_instance_attributes(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_slots(app): +def test_slots() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'target.slots', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.slots', options=options) + assert actual == [ '', '.. py:module:: target.slots', '', @@ -1621,7 +1398,7 @@ def _preamble( return self._node('class', self.name, doc, args=args, indent=indent, **options) @staticmethod - def _preamble_args(functional_constructor: bool = False): + def _preamble_args(functional_constructor: bool = False) -> str: """EnumType.__call__() is a dual-purpose method: * Look an enum member (valid only if the enum has members) @@ -1643,12 +1420,10 @@ def _preamble_args(functional_constructor: bool = False): ) else: return '(*values)' - if sys.version_info[:2] >= (3, 12): - return ( - '(value, names=None, *values, module=None, ' - 'qualname=None, type=None, start=1, boundary=None)' - ) - return '(value)' + return ( + '(value, names=None, *values, module=None, ' + 'qualname=None, type=None, start=1, boundary=None)' + ) def method( self, @@ -1674,13 +1449,12 @@ def autodoc_enum_options() -> dict[str, object]: return {'members': None, 'undoc-members': None} -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_class(app, autodoc_enum_options): +def test_enum_class(autodoc_enum_options): fmt = _EnumFormatter('EnumCls') options = autodoc_enum_options | {'private-members': None} - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method( 'say_goodbye', 'a classmethod says good-bye to you.', 'classmethod' @@ -1695,8 +1469,10 @@ def test_enum_class(app, autodoc_enum_options): # Inherited members exclude the native Enum API (in particular # the 'name' and 'value' properties), unless they were explicitly # redefined by the user in one of the bases. - actual = do_autodoc(app, 'class', fmt.target, options | {'inherited-members': None}) - assert list(actual) == [ + actual = do_autodoc( + 'class', fmt.target, options=options | {'inherited-members': None} + ) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method( 'say_goodbye', 'a classmethod says good-bye to you.', 'classmethod' @@ -1709,16 +1485,15 @@ def test_enum_class(app, autodoc_enum_options): ] # checks for an attribute of EnumCls - actual = do_autodoc(app, 'attribute', fmt.subtarget('val1')) - assert list(actual) == fmt.member('val1', 12, 'doc for val1', indent=0) + actual = do_autodoc('attribute', fmt.subtarget('val1')) + assert actual == fmt.member('val1', 12, 'doc for val1', indent=0) -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_class_with_data_type(app, autodoc_enum_options): +def test_enum_class_with_data_type(autodoc_enum_options): fmt = _EnumFormatter('EnumClassWithDataType') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method('say_goodbye', 'docstring', 'classmethod'), *fmt.method('say_hello', 'docstring'), @@ -1726,8 +1501,8 @@ def test_enum_class_with_data_type(app, autodoc_enum_options): ] options = autodoc_enum_options | {'inherited-members': None} - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.entry('dtype', 'docstring', role='property'), *fmt.method('isupper', 'inherited'), @@ -1737,12 +1512,11 @@ def test_enum_class_with_data_type(app, autodoc_enum_options): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_class_with_mixin_type(app, autodoc_enum_options): +def test_enum_class_with_mixin_type(autodoc_enum_options): fmt = _EnumFormatter('EnumClassWithMixinType') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method('say_goodbye', 'docstring', 'classmethod'), *fmt.method('say_hello', 'docstring'), @@ -1750,8 +1524,8 @@ def test_enum_class_with_mixin_type(app, autodoc_enum_options): ] options = autodoc_enum_options | {'inherited-members': None} - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method('say_goodbye', 'docstring', 'classmethod'), *fmt.method('say_hello', 'docstring'), @@ -1760,19 +1534,18 @@ def test_enum_class_with_mixin_type(app, autodoc_enum_options): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_class_with_mixin_type_and_inheritence(app, autodoc_enum_options): +def test_enum_class_with_mixin_type_and_inheritence(autodoc_enum_options): fmt = _EnumFormatter('EnumClassWithMixinTypeInherit') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.member('x', 'X', ''), ] options = autodoc_enum_options | {'inherited-members': None} - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method('say_goodbye', 'inherited', 'classmethod'), *fmt.method('say_hello', 'inherited'), @@ -1781,12 +1554,11 @@ def test_enum_class_with_mixin_type_and_inheritence(app, autodoc_enum_options): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_class_with_mixin_enum_type(app, autodoc_enum_options): +def test_enum_class_with_mixin_enum_type(autodoc_enum_options): fmt = _EnumFormatter('EnumClassWithMixinEnumType') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), # override() is overridden at the class level so it should be rendered *fmt.method('override', 'overridden'), @@ -1795,8 +1567,8 @@ def test_enum_class_with_mixin_enum_type(app, autodoc_enum_options): ] options = autodoc_enum_options | {'inherited-members': None} - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method('override', 'overridden'), *fmt.method('say_goodbye', 'inherited', 'classmethod'), @@ -1805,12 +1577,11 @@ def test_enum_class_with_mixin_enum_type(app, autodoc_enum_options): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_class_with_mixin_and_data_type(app, autodoc_enum_options): +def test_enum_class_with_mixin_and_data_type(autodoc_enum_options): fmt = _EnumFormatter('EnumClassWithMixinAndDataType') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method('isupper', 'overridden'), *fmt.method('say_goodbye', 'overridden', 'classmethod'), @@ -1820,8 +1591,8 @@ def test_enum_class_with_mixin_and_data_type(app, autodoc_enum_options): # add the special member __str__ (but not the inherited members) options = autodoc_enum_options | {'special-members': '__str__'} - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method('__str__', 'overridden'), *fmt.method('isupper', 'overridden'), @@ -1831,8 +1602,8 @@ def test_enum_class_with_mixin_and_data_type(app, autodoc_enum_options): ] options = autodoc_enum_options | {'inherited-members': None} - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.entry('dtype', 'docstring', role='property'), *fmt.method('isupper', 'overridden'), @@ -1843,12 +1614,11 @@ def test_enum_class_with_mixin_and_data_type(app, autodoc_enum_options): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_with_parent_enum(app, autodoc_enum_options): +def test_enum_with_parent_enum(autodoc_enum_options): fmt = _EnumFormatter('EnumClassWithParentEnum') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method('isupper', 'overridden'), *fmt.member('x', 'X', ''), @@ -1856,8 +1626,8 @@ def test_enum_with_parent_enum(app, autodoc_enum_options): # add the special member __str__ (but not the inherited members) options = autodoc_enum_options | {'special-members': '__str__'} - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.method('__str__', 'overridden'), *fmt.method('isupper', 'overridden'), @@ -1865,8 +1635,8 @@ def test_enum_with_parent_enum(app, autodoc_enum_options): ] options = autodoc_enum_options | {'inherited-members': None} - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_lookup('this is enum class'), *fmt.entry('dtype', 'docstring', role='property'), *fmt.method('isupper', 'overridden'), @@ -1878,62 +1648,60 @@ def test_enum_with_parent_enum(app, autodoc_enum_options): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_sunder_method(app, autodoc_enum_options): +def test_enum_sunder_method(autodoc_enum_options): PRIVATE = {'private-members': None} # sunder methods are recognized as private fmt = _EnumFormatter('EnumSunderMissingInNonEnumMixin') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [*fmt.preamble_constructor('this is enum class')] - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options | PRIVATE) - assert list(actual) == [*fmt.preamble_constructor('this is enum class')] + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [*fmt.preamble_constructor('this is enum class')] + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options | PRIVATE) + assert actual == [*fmt.preamble_constructor('this is enum class')] fmt = _EnumFormatter('EnumSunderMissingInEnumMixin') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [*fmt.preamble_constructor('this is enum class')] - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options | PRIVATE) - assert list(actual) == [*fmt.preamble_constructor('this is enum class')] + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [*fmt.preamble_constructor('this is enum class')] + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options | PRIVATE) + assert actual == [*fmt.preamble_constructor('this is enum class')] fmt = _EnumFormatter('EnumSunderMissingInDataType') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [*fmt.preamble_constructor('this is enum class')] - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options | PRIVATE) - assert list(actual) == [*fmt.preamble_constructor('this is enum class')] + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [*fmt.preamble_constructor('this is enum class')] + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options | PRIVATE) + assert actual == [*fmt.preamble_constructor('this is enum class')] fmt = _EnumFormatter('EnumSunderMissingInClass') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [*fmt.preamble_constructor('this is enum class')] - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options | PRIVATE) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [*fmt.preamble_constructor('this is enum class')] + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options | PRIVATE) + assert actual == [ *fmt.preamble_constructor('this is enum class'), *fmt.method('_missing_', 'docstring', 'classmethod', args='(value)'), ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_inherited_sunder_method(app, autodoc_enum_options): +def test_enum_inherited_sunder_method(autodoc_enum_options): options = autodoc_enum_options | { 'private-members': None, 'inherited-members': None, } fmt = _EnumFormatter('EnumSunderMissingInNonEnumMixin') - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_constructor('this is enum class'), *fmt.method('_missing_', 'inherited', 'classmethod', args='(value)'), ] fmt = _EnumFormatter('EnumSunderMissingInEnumMixin') - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_constructor('this is enum class'), *fmt.method('_missing_', 'inherited', 'classmethod', args='(value)'), ] fmt = _EnumFormatter('EnumSunderMissingInDataType') - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_constructor('this is enum class'), *fmt.method('_missing_', 'inherited', 'classmethod', args='(value)'), *fmt.entry('dtype', 'docstring', role='property'), @@ -1941,56 +1709,54 @@ def test_enum_inherited_sunder_method(app, autodoc_enum_options): ] fmt = _EnumFormatter('EnumSunderMissingInClass') - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_constructor('this is enum class'), *fmt.method('_missing_', 'docstring', 'classmethod', args='(value)'), ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_custom_name_property(app, autodoc_enum_options): +def test_enum_custom_name_property(autodoc_enum_options): fmt = _EnumFormatter('EnumNamePropertyInNonEnumMixin') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [*fmt.preamble_constructor('this is enum class')] + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [*fmt.preamble_constructor('this is enum class')] fmt = _EnumFormatter('EnumNamePropertyInEnumMixin') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [*fmt.preamble_constructor('this is enum class')] + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [*fmt.preamble_constructor('this is enum class')] fmt = _EnumFormatter('EnumNamePropertyInDataType') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [*fmt.preamble_constructor('this is enum class')] + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [*fmt.preamble_constructor('this is enum class')] fmt = _EnumFormatter('EnumNamePropertyInClass') - actual = do_autodoc(app, 'class', fmt.target, autodoc_enum_options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=autodoc_enum_options) + assert actual == [ *fmt.preamble_constructor('this is enum class'), *fmt.entry('name', 'docstring', role='property'), ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_enum_inherited_custom_name_property(app, autodoc_enum_options): +def test_enum_inherited_custom_name_property(autodoc_enum_options): options = autodoc_enum_options | {'inherited-members': None} fmt = _EnumFormatter('EnumNamePropertyInNonEnumMixin') - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_constructor('this is enum class'), *fmt.entry('name', 'inherited', role='property'), ] fmt = _EnumFormatter('EnumNamePropertyInEnumMixin') - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_constructor('this is enum class'), *fmt.entry('name', 'inherited', role='property'), ] fmt = _EnumFormatter('EnumNamePropertyInDataType') - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_constructor('this is enum class'), *fmt.entry('dtype', 'docstring', role='property'), *fmt.method('isupper', 'inherited'), @@ -1998,20 +1764,17 @@ def test_enum_inherited_custom_name_property(app, autodoc_enum_options): ] fmt = _EnumFormatter('EnumNamePropertyInClass') - actual = do_autodoc(app, 'class', fmt.target, options) - assert list(actual) == [ + actual = do_autodoc('class', fmt.target, options=options) + assert actual == [ *fmt.preamble_constructor('this is enum class'), *fmt.entry('name', 'docstring', role='property'), ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_descriptor_class(app): - options = { - 'members': 'CustomDataDescriptor,CustomDataDescriptor2', - } - actual = do_autodoc(app, 'module', 'target.descriptor', options) - assert list(actual) == [ +def test_descriptor_class() -> None: + options = {'members': 'CustomDataDescriptor,CustomDataDescriptor2'} + actual = do_autodoc('module', 'target.descriptor', options=options) + assert actual == [ '', '.. py:module:: target.descriptor', '', @@ -2036,10 +1799,9 @@ def test_descriptor_class(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_automethod_for_builtin(app): - actual = do_autodoc(app, 'method', 'builtins.int.__add__') - assert list(actual) == [ +def test_automethod_for_builtin() -> None: + actual = do_autodoc('method', 'builtins.int.__add__') + assert actual == [ '', '.. py:method:: int.__add__(value, /)', ' :module: builtins', @@ -2049,10 +1811,9 @@ def test_automethod_for_builtin(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_automethod_for_decorated(app): - actual = do_autodoc(app, 'method', 'target.decorator.Bar.meth') - assert list(actual) == [ +def test_automethod_for_decorated() -> None: + actual = do_autodoc('method', 'target.decorator.Bar.meth') + assert actual == [ '', '.. py:method:: Bar.meth(name=None, age=None)', ' :module: target.decorator', @@ -2060,14 +1821,13 @@ def test_automethod_for_decorated(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_abstractmethods(app): +def test_abstractmethods() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'target.abstractmethods', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.abstractmethods', options=options) + assert actual == [ '', '.. py:module:: target.abstractmethods', '', @@ -2110,11 +1870,10 @@ def test_abstractmethods(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_partialfunction(app): +def test_partialfunction() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.partialfunction', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.partialfunction', options=options) + assert actual == [ '', '.. py:module:: target.partialfunction', '', @@ -2145,22 +1904,20 @@ def test_partialfunction(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_imported_partialfunction_should_not_shown_without_imported_members(app): +def test_imported_partialfunction_should_not_shown_without_imported_members() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.imported_members', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.imported_members', options=options) + assert actual == [ '', '.. py:module:: target.imported_members', '', ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_bound_method(app): +def test_bound_method() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.bound_method', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.bound_method', options=options) + assert actual == [ '', '.. py:module:: target.bound_method', '', @@ -2173,8 +1930,7 @@ def test_bound_method(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_partialmethod(app): +def test_partialmethod() -> None: expected = [ '', '.. py:class:: Cell()', @@ -2199,12 +1955,11 @@ def test_partialmethod(app): ] options = {'members': None} - actual = do_autodoc(app, 'class', 'target.partialmethod.Cell', options) - assert list(actual) == expected + actual = do_autodoc('class', 'target.partialmethod.Cell', options=options) + assert actual == expected -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_partialmethod_undoc_members(app): +def test_partialmethod_undoc_members() -> None: expected = [ '', '.. py:class:: Cell()', @@ -2236,18 +1991,22 @@ def test_partialmethod_undoc_members(app): 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'class', 'target.partialmethod.Cell', options) - assert list(actual) == expected + actual = do_autodoc('class', 'target.partialmethod.Cell', options=options) + assert actual == expected -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_typed_instance_variables(app): +def test_autodoc_typed_instance_variables() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'target.typed_vars', options) - assert list(actual) == [ + # First compute autodoc of a `Derived` member to verify that it + # doesn't result in inherited members in + # `Derived.__annotations__`. + # https://github.com/sphinx-doc/sphinx/issues/13934 + do_autodoc('attribute', 'target.typed_vars.Derived.attr2') + actual = do_autodoc('module', 'target.typed_vars', options=options) + assert actual == [ '', '.. py:module:: target.typed_vars', '', @@ -2340,15 +2099,14 @@ def test_autodoc_typed_instance_variables(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_typed_inherited_instance_variables(app): +def test_autodoc_typed_inherited_instance_variables() -> None: options = { 'members': None, 'undoc-members': None, 'inherited-members': None, } - actual = do_autodoc(app, 'class', 'target.typed_vars.Derived', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.typed_vars.Derived', options=options) + assert actual == [ '', '.. py:class:: Derived()', ' :module: target.typed_vars', @@ -2404,14 +2162,13 @@ def test_autodoc_typed_inherited_instance_variables(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_GenericAlias(app): +def test_autodoc_GenericAlias() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'target.genericalias', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.genericalias', options=options) + assert actual == [ '', '.. py:module:: target.genericalias', '', @@ -2447,14 +2204,154 @@ def test_autodoc_GenericAlias(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_TypeVar(app): +def test_autodoc_pep695_type_alias() -> None: + config = _AutodocConfig( + autodoc_type_aliases={ + 'buffer_like': 'buffer_like', + 'pathlike': 'pathlike', + 'Handler': 'Handler', + } + ) + options = { + 'members': None, + 'undoc-members': None, + } + actual = do_autodoc('module', 'target.pep695', config=config, options=options) + assert actual == [ + '', + '.. py:module:: target.pep695', + '', + '', + '.. py:class:: Bar', + ' :module: target.pep695', + '', + ' This is newtype of Pep695Alias.', + '', + ' alias of :py:type:`~target.pep695.Pep695Alias`', + '', + '', + '.. py:class:: Foo()', + ' :module: target.pep695', + '', + ' This is class Foo.', + '', + '', + '.. py:data:: Handler', + ' :module: target.pep695', + '', + ' A generic type alias', + '', + ' alias of :py:class:`type`\\ [:py:class:`Exception`]', + '', + '', + '.. py:type:: HandlerTypeAliasType', + ' :module: target.pep695', + ' :canonical: type[Exception]', + '', + ' This is an explicitly constructed generic alias typing.TypeAlias.', + '', + '', + '.. py:type:: Pep695Alias', + ' :module: target.pep695', + ' :canonical: ~target.pep695.Foo', + '', + ' This is PEP695 type alias.', + '', + '', + '.. py:type:: Pep695AliasC', + ' :module: target.pep695', + ' :canonical: dict[str, ~target.pep695.Foo]', + '', + ' This is PEP695 complex type alias with doc comment.', + '', + '', + '.. py:type:: Pep695AliasOfAlias', + ' :module: target.pep695', + ' :canonical: ~target.pep695.Pep695AliasC', + '', + ' This is PEP695 type alias of PEP695 alias.', + '', + '', + # Undocumented alias should not inherit any documentation + '.. py:type:: Pep695AliasUndocumented', + ' :module: target.pep695', + ' :canonical: ~target.pep695.Foo', + '', + '', + '.. py:type:: Pep695AliasUnion', + ' :module: target.pep695', + ' :canonical: str | int', + '', + ' This is PEP695 type alias for union.', + '', + '', + '.. py:type:: TypeAliasTypeExplicit', + ' :module: target.pep695', + ' :canonical: ~target.pep695.Foo', + '', + ' This is an explicitly constructed typing.TypeAlias.', + '', + '', + '.. py:type:: TypeAliasTypeExtension', + ' :module: target.pep695', + ' :canonical: ~target.pep695.Foo', + '', + ' This is an explicitly constructed typing_extensions.TypeAlias.', + '', + '', + '.. py:function:: buffer_len(data: buffer_like) -> int', + ' :module: target.pep695', + '', + ' Return length of a buffer-like object.', + '', + ' Tests Union type alias cross-reference resolution.', + '', + '', + '.. py:data:: buffer_like', + ' :module: target.pep695', + ' :value: bytes | bytearray | memoryview', + '', + ' Some buffer-like object', + '', + '', + '.. py:data:: pathlike', + ' :module: target.pep695', + f' :value: str | {pathlib.Path.__module__}.Path', + '', + ' Any type of path', + '', + '', + '.. py:function:: process_error(handler: Handler, other: ~target.pep695.HandlerTypeAliasType) -> str', + ' :module: target.pep695', + '', + ' Process an error with a custom handler type.', + '', + ' Tests generic type alias cross-reference resolution.', + '', + '', + '.. py:function:: read_file(path: pathlike) -> bytes', + ' :module: target.pep695', + '', + ' Read a file and return its contents.', + '', + ' Tests Union type alias cross-reference resolution.', + '', + '', + '.. py:function:: ret_pep695(a: ~target.pep695.Pep695Alias) -> ~target.pep695.Pep695Alias', + ' :module: target.pep695', + '', + ' This fn accepts and returns PEP695 alias.', + '', + ] + + +def test_autodoc_TypeVar() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'target.typevar', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.typevar', options=options) + assert actual == [ '', '.. py:module:: target.typevar', '', @@ -2529,14 +2426,13 @@ def test_autodoc_TypeVar(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_Annotated(app): +def test_autodoc_Annotated() -> None: options = { 'members': None, 'member-order': 'bysource', } - actual = do_autodoc(app, 'module', 'target.annotated', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.annotated', options=options) + assert actual == [ '', '.. py:module:: target.annotated', '', @@ -2593,14 +2489,13 @@ def test_autodoc_Annotated(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_TYPE_CHECKING(app): +def test_autodoc_TYPE_CHECKING() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'target.TYPE_CHECKING', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.TYPE_CHECKING', options=options) + assert actual == [ '', '.. py:module:: target.TYPE_CHECKING', '', @@ -2620,14 +2515,13 @@ def test_autodoc_TYPE_CHECKING(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_TYPE_CHECKING_circular_import(app): +def test_autodoc_TYPE_CHECKING_circular_import() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'circular_import', options) - assert list(actual) == [ + actual = do_autodoc('module', 'circular_import', options=options) + assert actual == [ '', '.. py:module:: circular_import', '', @@ -2635,11 +2529,10 @@ def test_autodoc_TYPE_CHECKING_circular_import(app): assert sys.modules['circular_import'].a is sys.modules['circular_import.a'] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_singledispatch(app): +def test_singledispatch() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.singledispatch', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.singledispatch', options=options) + assert actual == [ '', '.. py:module:: target.singledispatch', '', @@ -2656,11 +2549,10 @@ def test_singledispatch(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_singledispatchmethod(app): +def test_singledispatchmethod() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.singledispatchmethod', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.singledispatchmethod', options=options) + assert actual == [ '', '.. py:module:: target.singledispatchmethod', '', @@ -2683,11 +2575,9 @@ def test_singledispatchmethod(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_singledispatchmethod_automethod(app): - options = {} - actual = do_autodoc(app, 'method', 'target.singledispatchmethod.Foo.meth', options) - assert list(actual) == [ +def test_singledispatchmethod_automethod() -> None: + actual = do_autodoc('method', 'target.singledispatchmethod.Foo.meth') + assert actual == [ '', '.. py:method:: Foo.meth(arg, kwarg=None)', ' Foo.meth(arg: float, kwarg=None)', @@ -2701,14 +2591,12 @@ def test_singledispatchmethod_automethod(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_singledispatchmethod_classmethod(app): +def test_singledispatchmethod_classmethod() -> None: options = {'members': None} actual = do_autodoc( - app, 'module', 'target.singledispatchmethod_classmethod', options + 'module', 'target.singledispatchmethod_classmethod', options=options ) - - assert list(actual) == [ + assert actual == [ '', '.. py:module:: target.singledispatchmethod_classmethod', '', @@ -2732,14 +2620,11 @@ def test_singledispatchmethod_classmethod(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_singledispatchmethod_classmethod_automethod(app): - options = {} +def test_singledispatchmethod_classmethod_automethod() -> None: actual = do_autodoc( - app, 'method', 'target.singledispatchmethod_classmethod.Foo.class_meth', options + 'method', 'target.singledispatchmethod_classmethod.Foo.class_meth' ) - - assert list(actual) == [ + assert actual == [ '', '.. py:method:: Foo.class_meth(arg, kwarg=None)', ' Foo.class_meth(arg: float, kwarg=None)', @@ -2759,14 +2644,13 @@ def test_singledispatchmethod_classmethod_automethod(app): reason='Cython does not support Python 3.13 yet.', ) @pytest.mark.skipif(pyximport is None, reason='cython is not installed') -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_cython(app): +def test_cython() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'target.cython', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.cython', options=options) + assert actual == [ '', '.. py:module:: target.cython', '', @@ -2791,11 +2675,10 @@ def test_cython(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_final(app): +def test_final() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.final', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.final', options=options) + assert actual == [ '', '.. py:module:: target.final', '', @@ -2819,14 +2702,27 @@ def test_final(app): '', ' docstring', '', + '', + ' .. py:method:: Class.meth3()', + ' :module: target.final', + ' :final:', + '', + ' docstring', + '', + '', + ' .. py:method:: Class.meth4()', + ' :module: target.final', + ' :final:', + '', + ' docstring', + '', ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_overload(app): +def test_overload() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.overload', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.overload', options=options) + assert actual == [ '', '.. py:module:: target.overload', '', @@ -2876,11 +2772,10 @@ def test_overload(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_overload2(app): +def test_overload2() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.overload2', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.overload2', options=options) + assert actual == [ '', '.. py:module:: target.overload2', '', @@ -2892,11 +2787,29 @@ def test_overload2(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_pymodule_for_ModuleLevelDocumenter(app): - app.env.ref_context['py:module'] = 'target.classes' - actual = do_autodoc(app, 'class', 'Foo') - assert list(actual) == [ +def test_overload3() -> None: + options = {'members': None} + actual = do_autodoc('module', 'target.overload3', options=options) + assert actual == [ + '', + '.. py:module:: target.overload3', + '', + '', + '.. py:function:: test(x: int) -> int', + ' test(x: list[int]) -> list[int]', + ' test(x: str) -> str', + ' test(x: float) -> float', + ' :module: target.overload3', + '', + ' Documentation.', + '', + ] + + +def test_pymodule_for_ModuleLevelDocumenter() -> None: + ref_context: dict[str, Any] = {'py:module': 'target.classes'} + actual = do_autodoc('class', 'Foo', ref_context=ref_context) + assert actual == [ '', '.. py:class:: Foo()', ' :module: target.classes', @@ -2904,11 +2817,10 @@ def test_pymodule_for_ModuleLevelDocumenter(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_pymodule_for_ClassLevelDocumenter(app): - app.env.ref_context['py:module'] = 'target.methods' - actual = do_autodoc(app, 'method', 'Base.meth') - assert list(actual) == [ +def test_pymodule_for_ClassLevelDocumenter() -> None: + ref_context: dict[str, Any] = {'py:module': 'target.methods'} + actual = do_autodoc('method', 'Base.meth', ref_context=ref_context) + assert actual == [ '', '.. py:method:: Base.meth()', ' :module: target.methods', @@ -2916,12 +2828,10 @@ def test_pymodule_for_ClassLevelDocumenter(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_pyclass_for_ClassLevelDocumenter(app): - app.env.ref_context['py:module'] = 'target.methods' - app.env.ref_context['py:class'] = 'Base' - actual = do_autodoc(app, 'method', 'meth') - assert list(actual) == [ +def test_pyclass_for_ClassLevelDocumenter() -> None: + ref_context: dict[str, Any] = {'py:module': 'target.methods', 'py:class': 'Base'} + actual = do_autodoc('method', 'meth', ref_context=ref_context) + assert actual == [ '', '.. py:method:: Base.meth()', ' :module: target.methods', @@ -2929,32 +2839,55 @@ def test_pyclass_for_ClassLevelDocumenter(app): ] -@pytest.mark.sphinx('dummy', testroot='ext-autodoc') -def test_autodoc(app): - app.build(force_all=True) +def test_autodoc(caplog: pytest.LogCaptureFixture) -> None: + # work around sphinx.util.logging.setup() + logger = logging.getLogger('sphinx') + logger.handlers[:] = [caplog.handler] + caplog.set_level(logging.WARNING) - content = app.env.get_doctree('index') - assert isinstance(content[3], addnodes.desc) - assert content[3][0].astext() == 'autodoc_dummy_module.test()' - assert content[3][1].astext() == 'Dummy function using dummy.*' + config = _AutodocConfig(autodoc_mock_imports=['dummy']) + options = {'members': None} + actual = do_autodoc( + 'module', 'autodoc_dummy_module', config=config, options=options + ) + assert actual == [ + '', + '.. py:module:: autodoc_dummy_module', + '', + '', + '.. py:function:: test()', + ' :module: autodoc_dummy_module', + '', + ' Dummy function using dummy.*', + '', + ] # See: https://github.com/sphinx-doc/sphinx/issues/2437 - assert content[11][-1].astext() == ( - """Dummy class Bar with alias. - - - -my_name + do_autodoc('module', 'bug2437.autodoc_dummy_foo', options=options) + actual = do_autodoc('module', 'autodoc_dummy_bar', options=options) + assert actual == [ + '', + '.. py:module:: autodoc_dummy_bar', + '', + '', + '.. py:class:: Bar()', + ' :module: autodoc_dummy_bar', + '', + ' Dummy class Bar with alias.', + '', + '', + ' .. py:attribute:: Bar.my_name', + ' :module: autodoc_dummy_bar', + '', + ' alias of :py:class:`~bug2437.autodoc_dummy_foo.Foo`', + ] -alias of Foo""" - ) - assert app.warning.getvalue() == '' + assert not caplog.records -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_name_conflict(app): - actual = do_autodoc(app, 'class', 'target.name_conflict.foo') - assert list(actual) == [ +def test_name_conflict() -> None: + actual = do_autodoc('class', 'target.name_conflict.foo') + assert actual == [ '', '.. py:class:: foo()', ' :module: target.name_conflict', @@ -2963,8 +2896,8 @@ def test_name_conflict(app): '', ] - actual = do_autodoc(app, 'class', 'target.name_conflict.foo.bar') - assert list(actual) == [ + actual = do_autodoc('class', 'target.name_conflict.foo.bar') + assert actual == [ '', '.. py:class:: bar()', ' :module: target.name_conflict.foo', @@ -2974,15 +2907,14 @@ def test_name_conflict(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_name_mangling(app): +def test_name_mangling() -> None: options = { 'members': None, 'undoc-members': None, 'private-members': None, } - actual = do_autodoc(app, 'module', 'target.name_mangling', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.name_mangling', options=options) + assert actual == [ '', '.. py:module:: target.name_mangling', '', @@ -3021,11 +2953,10 @@ def test_name_mangling(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_type_union_operator(app): +def test_type_union_operator() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.pep604', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.pep604', options=options) + assert actual == [ '', '.. py:module:: target.pep604', '', @@ -3064,11 +2995,10 @@ def test_type_union_operator(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_hide_value(app): +def test_hide_value() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.hide_value', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.hide_value', options=options) + assert actual == [ '', '.. py:module:: target.hide_value', '', @@ -3109,14 +3039,13 @@ def test_hide_value(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_canonical(app): +def test_canonical() -> None: options = { 'members': None, 'imported-members': None, } - actual = do_autodoc(app, 'module', 'target.canonical', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.canonical', options=options) + assert actual == [ '', '.. py:module:: target.canonical', '', @@ -3166,8 +3095,9 @@ def function_rst(name, sig): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc', freshenv=True) -def test_literal_render(app): +def test_literal_render() -> None: + config = _AutodocConfig(autodoc_typehints_format='short') + # autodoc_typehints_format can take 'short' or 'fully-qualified' values # and this will be interpreted as 'smart' or 'fully-qualified-except-typing' by restify() # and 'smart' or 'fully-qualified' by stringify_annotation(). @@ -3176,9 +3106,8 @@ def test_literal_render(app): 'members': None, 'exclude-members': 'MyEnum', } - app.config.autodoc_typehints_format = 'short' - actual = do_autodoc(app, 'module', 'target.literal', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.literal', config=config, options=options) + assert actual == [ '', '.. py:module:: target.literal', '', @@ -3195,9 +3124,9 @@ def test_literal_render(app): # restify() assumes that 'fully-qualified' is 'fully-qualified-except-typing' # because it is more likely that a user wants to suppress 'typing.*' - app.config.autodoc_typehints_format = 'fully-qualified' - actual = do_autodoc(app, 'module', 'target.literal', options) - assert list(actual) == [ + config = _AutodocConfig(autodoc_typehints_format='fully-qualified') + actual = do_autodoc('module', 'target.literal', config=config, options=options) + assert actual == [ '', '.. py:module:: target.literal', '', @@ -3216,20 +3145,17 @@ def test_literal_render(app): ] -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - freshenv=True, - confoverrides={'python_display_short_literal_types': True}, -) -def test_literal_render_pep604(app): +def test_literal_render_pep604() -> None: + config = _AutodocConfig( + python_display_short_literal_types=True, + autodoc_typehints_format='short', + ) options = { 'members': None, 'exclude-members': 'MyEnum', } - app.config.autodoc_typehints_format = 'short' - actual = do_autodoc(app, 'module', 'target.literal', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.literal', config=config, options=options) + assert actual == [ '', '.. py:module:: target.literal', '', @@ -3246,9 +3172,12 @@ def test_literal_render_pep604(app): # restify() assumes that 'fully-qualified' is 'fully-qualified-except-typing' # because it is more likely that a user wants to suppress 'typing.*' - app.config.autodoc_typehints_format = 'fully-qualified' - actual = do_autodoc(app, 'module', 'target.literal', options) - assert list(actual) == [ + config = _AutodocConfig( + python_display_short_literal_types=True, + autodoc_typehints_format='fully-qualified', + ) + actual = do_autodoc('module', 'target.literal', config=config, options=options) + assert actual == [ '', '.. py:module:: target.literal', '', @@ -3264,30 +3193,29 @@ def test_literal_render_pep604(app): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_no_index_entry(app): +def test_no_index_entry() -> None: # modules can use no-index-entry options = {'no-index-entry': None} - actual = do_autodoc(app, 'module', 'target.module', options) - assert ' :no-index-entry:' in list(actual) + actual = do_autodoc('module', 'target.module', options=options) + assert ' :no-index-entry:' in actual # classes can use no-index-entry - actual = do_autodoc(app, 'class', 'target.classes.Foo', options) - assert ' :no-index-entry:' in list(actual) + actual = do_autodoc('class', 'target.classes.Foo', options=options) + assert ' :no-index-entry:' in actual # functions can use no-index-entry - actual = do_autodoc(app, 'function', 'target.functions.func', options) - assert ' :no-index-entry:' in list(actual) + actual = do_autodoc('function', 'target.functions.func', options=options) + assert ' :no-index-entry:' in actual # modules respect no-index-entry in autodoc_default_options - app.config.autodoc_default_options = {'no-index-entry': True} - actual = do_autodoc(app, 'module', 'target.module') - assert ' :no-index-entry:' in list(actual) + config = _AutodocConfig(autodoc_default_options={'no-index-entry': True}) + actual = do_autodoc('module', 'target.module', config=config) + assert ' :no-index-entry:' in actual # classes respect config-level no-index-entry - actual = do_autodoc(app, 'class', 'target.classes.Foo') - assert ' :no-index-entry:' in list(actual) + actual = do_autodoc('class', 'target.classes.Foo', config=config) + assert ' :no-index-entry:' in actual # functions respect config-level no-index-entry - actual = do_autodoc(app, 'function', 'target.functions.func') - assert ' :no-index-entry:' in list(actual) + actual = do_autodoc('function', 'target.functions.func', config=config) + assert ' :no-index-entry:' in actual diff --git a/tests/test_ext_autodoc/test_ext_autodoc_autoattribute.py b/tests/test_ext_autodoc/test_ext_autodoc_autoattribute.py new file mode 100644 index 00000000000..ba45fd52b7c --- /dev/null +++ b/tests/test_ext_autodoc/test_ext_autodoc_autoattribute.py @@ -0,0 +1,168 @@ +"""Test the autodoc extension. + +This tests mainly the Documenters; the auto directives are tested in a test +source file translated by test_build. +""" + +from __future__ import annotations + +import pytest + +from tests.test_ext_autodoc.autodoc_util import do_autodoc + +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') + + +def test_autoattribute() -> None: + actual = do_autodoc('attribute', 'target.Class.attr') + assert actual == [ + '', + '.. py:attribute:: Class.attr', + ' :module: target', + " :value: 'bar'", + '', + ' should be documented -- süß', + '', + ] + + +def test_autoattribute_novalue() -> None: + options = {'no-value': None} + actual = do_autodoc('attribute', 'target.Class.attr', options=options) + assert actual == [ + '', + '.. py:attribute:: Class.attr', + ' :module: target', + '', + ' should be documented -- süß', + '', + ] + + +def test_autoattribute_typed_variable() -> None: + actual = do_autodoc('attribute', 'target.typed_vars.Class.attr2') + assert actual == [ + '', + '.. py:attribute:: Class.attr2', + ' :module: target.typed_vars', + ' :type: int', + '', + ] + + +def test_autoattribute_typed_variable_in_alias() -> None: + actual = do_autodoc('attribute', 'target.typed_vars.Alias.attr2') + assert actual == [ + '', + '.. py:attribute:: Alias.attr2', + ' :module: target.typed_vars', + ' :type: int', + '', + ] + + +def test_autoattribute_instance_variable() -> None: + actual = do_autodoc('attribute', 'target.typed_vars.Class.attr4') + assert actual == [ + '', + '.. py:attribute:: Class.attr4', + ' :module: target.typed_vars', + ' :type: int', + '', + ' attr4', + '', + ] + + +def test_autoattribute_instance_variable_in_alias() -> None: + actual = do_autodoc('attribute', 'target.typed_vars.Alias.attr4') + assert actual == [ + '', + '.. py:attribute:: Alias.attr4', + ' :module: target.typed_vars', + ' :type: int', + '', + ' attr4', + '', + ] + + +def test_autoattribute_instance_variable_without_comment() -> None: + actual = do_autodoc('attribute', 'target.instance_variable.Bar.attr4') + assert actual == [ + '', + '.. py:attribute:: Bar.attr4', + ' :module: target.instance_variable', + '', + ] + + +def test_autoattribute_slots_variable_list() -> None: + actual = do_autodoc('attribute', 'target.slots.Foo.attr') + assert actual == [ + '', + '.. py:attribute:: Foo.attr', + ' :module: target.slots', + '', + ] + + +def test_autoattribute_slots_variable_dict() -> None: + actual = do_autodoc('attribute', 'target.slots.Bar.attr1') + assert actual == [ + '', + '.. py:attribute:: Bar.attr1', + ' :module: target.slots', + ' :type: int', + '', + ' docstring of attr1', + '', + ] + + +def test_autoattribute_slots_variable_str() -> None: + actual = do_autodoc('attribute', 'target.slots.Baz.attr') + assert actual == [ + '', + '.. py:attribute:: Baz.attr', + ' :module: target.slots', + '', + ] + + +def test_autoattribute_GenericAlias() -> None: + actual = do_autodoc('attribute', 'target.genericalias.Class.T') + assert actual == [ + '', + '.. py:attribute:: Class.T', + ' :module: target.genericalias', + '', + ' A list of int', + '', + ' alias of :py:class:`~typing.List`\\ [:py:class:`int`]', + '', + ] + + +def test_autoattribute_hide_value() -> None: + actual = do_autodoc('attribute', 'target.hide_value.Foo.SENTINEL1') + assert actual == [ + '', + '.. py:attribute:: Foo.SENTINEL1', + ' :module: target.hide_value', + '', + ' docstring', + '', + ' :meta hide-value:', + '', + ] + + actual = do_autodoc('attribute', 'target.hide_value.Foo.SENTINEL2') + assert actual == [ + '', + '.. py:attribute:: Foo.SENTINEL2', + ' :module: target.hide_value', + '', + ' :meta hide-value:', + '', + ] diff --git a/tests/test_extensions/test_ext_autodoc_autoclass.py b/tests/test_ext_autodoc/test_ext_autodoc_autoclass.py similarity index 61% rename from tests/test_extensions/test_ext_autodoc_autoclass.py rename to tests/test_ext_autodoc/test_ext_autodoc_autoclass.py index 04499efd183..01049098d18 100644 --- a/tests/test_extensions/test_ext_autodoc_autoclass.py +++ b/tests/test_ext_autodoc/test_ext_autodoc_autoclass.py @@ -6,44 +6,49 @@ from __future__ import annotations +import sys import typing import pytest -from tests.test_extensions.autodoc_util import do_autodoc +from tests.test_ext_autodoc.autodoc_util import FakeEvents, do_autodoc -if typing.TYPE_CHECKING: - from sphinx.testing.util import SphinxTestApp +TYPE_CHECKING = False +if TYPE_CHECKING: + from typing import Any + from sphinx.application import Sphinx -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_classes(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.classes.Foo') - assert list(actual) == [ +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') + + +def test_classes() -> None: + actual = do_autodoc('function', 'target.classes.Foo') + assert actual == [ '', '.. py:function:: Foo()', ' :module: target.classes', '', ] - actual = do_autodoc(app, 'function', 'target.classes.Bar') - assert list(actual) == [ + actual = do_autodoc('function', 'target.classes.Bar') + assert actual == [ '', '.. py:function:: Bar(x, y)', ' :module: target.classes', '', ] - actual = do_autodoc(app, 'function', 'target.classes.Baz') - assert list(actual) == [ + actual = do_autodoc('function', 'target.classes.Baz') + assert actual == [ '', '.. py:function:: Baz(x, y)', ' :module: target.classes', '', ] - actual = do_autodoc(app, 'function', 'target.classes.Qux') - assert list(actual) == [ + actual = do_autodoc('function', 'target.classes.Qux') + assert actual == [ '', '.. py:function:: Qux(foo, bar)', ' :module: target.classes', @@ -51,11 +56,10 @@ def test_classes(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_instance_variable(app: SphinxTestApp) -> None: +def test_instance_variable() -> None: options = {'members': None} - actual = do_autodoc(app, 'class', 'target.instance_variable.Bar', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.instance_variable.Bar', options=options) + assert actual == [ '', '.. py:class:: Bar()', ' :module: target.instance_variable', @@ -75,14 +79,13 @@ def test_instance_variable(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_inherited_instance_variable(app: SphinxTestApp) -> None: +def test_inherited_instance_variable() -> None: options = { 'members': None, 'inherited-members': None, } - actual = do_autodoc(app, 'class', 'target.instance_variable.Bar', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.instance_variable.Bar', options=options) + assert actual == [ '', '.. py:class:: Bar()', ' :module: target.instance_variable', @@ -108,16 +111,15 @@ def test_inherited_instance_variable(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_uninitialized_attributes(app: SphinxTestApp) -> None: +def test_uninitialized_attributes() -> None: options = { 'members': None, 'inherited-members': None, } actual = do_autodoc( - app, 'class', 'target.uninitialized_attributes.Derived', options + 'class', 'target.uninitialized_attributes.Derived', options=options ) - assert list(actual) == [ + assert actual == [ '', '.. py:class:: Derived()', ' :module: target.uninitialized_attributes', @@ -139,17 +141,16 @@ def test_uninitialized_attributes(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_undocumented_uninitialized_attributes(app: SphinxTestApp) -> None: +def test_undocumented_uninitialized_attributes() -> None: options = { 'members': None, 'inherited-members': None, 'undoc-members': None, } actual = do_autodoc( - app, 'class', 'target.uninitialized_attributes.Derived', options + 'class', 'target.uninitialized_attributes.Derived', options=options ) - assert list(actual) == [ + assert actual == [ '', '.. py:class:: Derived()', ' :module: target.uninitialized_attributes', @@ -181,26 +182,25 @@ def test_undocumented_uninitialized_attributes(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_decorators(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'class', 'target.decorator.Baz') - assert list(actual) == [ +def test_decorators() -> None: + actual = do_autodoc('class', 'target.decorator.Baz') + assert actual == [ '', '.. py:class:: Baz(name=None, age=None)', ' :module: target.decorator', '', ] - actual = do_autodoc(app, 'class', 'target.decorator.Qux') - assert list(actual) == [ + actual = do_autodoc('class', 'target.decorator.Qux') + assert actual == [ '', '.. py:class:: Qux(name=None, age=None)', ' :module: target.decorator', '', ] - actual = do_autodoc(app, 'class', 'target.decorator.Quux') - assert list(actual) == [ + actual = do_autodoc('class', 'target.decorator.Quux') + assert actual == [ '', '.. py:class:: Quux(name=None, age=None)', ' :module: target.decorator', @@ -208,11 +208,15 @@ def test_decorators(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_properties(app: SphinxTestApp) -> None: +def test_properties() -> None: + if sys.version_info[:2] >= (3, 14): + type_checking_only_name = 'TypeCheckingOnlyName' + else: + type_checking_only_name = 'int' + options = {'members': None} - actual = do_autodoc(app, 'class', 'target.properties.Foo', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.properties.Foo', options=options) + assert actual == [ '', '.. py:class:: Foo()', ' :module: target.properties', @@ -249,14 +253,20 @@ def test_properties(app: SphinxTestApp) -> None: '', ' docstring', '', + '', + ' .. py:property:: Foo.prop3_with_undefined_anotation', + ' :module: target.properties', + f' :type: {type_checking_only_name}', + '', + ' docstring', + '', ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_slots_attribute(app: SphinxTestApp) -> None: +def test_slots_attribute() -> None: options = {'members': None} - actual = do_autodoc(app, 'class', 'target.slots.Bar', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.slots.Bar', options=options) + assert actual == [ '', '.. py:class:: Bar()', ' :module: target.slots', @@ -279,11 +289,10 @@ def test_slots_attribute(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_show_inheritance_for_subclass_of_generic_type(app: SphinxTestApp) -> None: +def test_show_inheritance_for_subclass_of_generic_type() -> None: options = {'show-inheritance': None} - actual = do_autodoc(app, 'class', 'target.classes.Quux', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.classes.Quux', options=options) + assert actual == [ '', '.. py:class:: Quux(iterable=(), /)', ' :module: target.classes', @@ -295,11 +304,10 @@ def test_show_inheritance_for_subclass_of_generic_type(app: SphinxTestApp) -> No ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_show_inheritance_for_decendants_of_generic_type(app: SphinxTestApp) -> None: +def test_show_inheritance_for_decendants_of_generic_type() -> None: options = {'show-inheritance': None} - actual = do_autodoc(app, 'class', 'target.classes.Corge', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.classes.Corge', options=options) + assert actual == [ '', '.. py:class:: Corge(iterable=(), /)', ' :module: target.classes', @@ -309,23 +317,26 @@ def test_show_inheritance_for_decendants_of_generic_type(app: SphinxTestApp) -> ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_process_bases(app: SphinxTestApp) -> None: - def autodoc_process_bases(app, name, obj, options, bases): - assert name == 'target.classes.Quux' - assert obj.__module__ == 'target.classes' - assert obj.__name__ == 'Quux' - assert options == {'show-inheritance': True, 'members': []} - assert bases == [typing.List[typing.Union[int, float]]] # NoQA: UP006, UP007 +def _autodoc_process_bases( + app: Sphinx, name: str, obj: Any, options: Any, bases: list[type] +) -> None: + assert name == 'target.classes.Quux' + assert obj.__module__ == 'target.classes' + assert obj.__name__ == 'Quux' + assert vars(options) == {} + assert bases == [typing.List[typing.Union[int, float]]] # NoQA: UP006, UP007 + + bases.pop() + bases.extend([int, str]) - bases.pop() - bases.extend([int, str]) - app.connect('autodoc-process-bases', autodoc_process_bases) +def test_autodoc_process_bases() -> None: + events = FakeEvents() + events.connect('autodoc-process-bases', _autodoc_process_bases) options = {'show-inheritance': None} - actual = do_autodoc(app, 'class', 'target.classes.Quux', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.classes.Quux', events=events, options=options) + assert actual == [ '', '.. py:class:: Quux(iterable=(), /)', ' :module: target.classes', @@ -337,14 +348,13 @@ def autodoc_process_bases(app, name, obj, options, bases): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_class_doc_from_class(app: SphinxTestApp) -> None: +def test_class_doc_from_class() -> None: options = { 'members': None, 'class-doc-from': 'class', } - actual = do_autodoc(app, 'class', 'target.autoclass_content.C', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.autoclass_content.C', options=options) + assert actual == [ '', '.. py:class:: C()', ' :module: target.autoclass_content', @@ -354,14 +364,13 @@ def test_class_doc_from_class(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_class_doc_from_init(app: SphinxTestApp) -> None: +def test_class_doc_from_init() -> None: options = { 'members': None, 'class-doc-from': 'init', } - actual = do_autodoc(app, 'class', 'target.autoclass_content.C', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.autoclass_content.C', options=options) + assert actual == [ '', '.. py:class:: C()', ' :module: target.autoclass_content', @@ -371,14 +380,13 @@ def test_class_doc_from_init(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_class_doc_from_both(app: SphinxTestApp) -> None: +def test_class_doc_from_both() -> None: options = { 'members': None, 'class-doc-from': 'both', } - actual = do_autodoc(app, 'class', 'target.autoclass_content.C', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.autoclass_content.C', options=options) + assert actual == [ '', '.. py:class:: C()', ' :module: target.autoclass_content', @@ -390,17 +398,17 @@ def test_class_doc_from_both(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_class_alias(app: SphinxTestApp) -> None: - def autodoc_process_docstring(*args): +def test_class_alias() -> None: + def autodoc_process_docstring(*args: Any) -> None: """A handler always raises an error. This confirms this handler is never called for class aliases. """ raise RuntimeError - app.connect('autodoc-process-docstring', autodoc_process_docstring) - actual = do_autodoc(app, 'class', 'target.classes.Alias') - assert list(actual) == [ + events = FakeEvents() + events.connect('autodoc-process-docstring', autodoc_process_docstring) + actual = do_autodoc('class', 'target.classes.Alias', events=events) + assert actual == [ '', '.. py:attribute:: Alias', ' :module: target.classes', @@ -409,10 +417,9 @@ def autodoc_process_docstring(*args): ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_class_alias_having_doccomment(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'class', 'target.classes.OtherAlias') - assert list(actual) == [ +def test_class_alias_having_doccomment() -> None: + actual = do_autodoc('class', 'target.classes.OtherAlias') + assert actual == [ '', '.. py:attribute:: OtherAlias', ' :module: target.classes', @@ -422,10 +429,9 @@ def test_class_alias_having_doccomment(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_class_alias_for_imported_object_having_doccomment(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'class', 'target.classes.IntAlias') - assert list(actual) == [ +def test_class_alias_for_imported_object_having_doccomment() -> None: + actual = do_autodoc('class', 'target.classes.IntAlias') + assert actual == [ '', '.. py:attribute:: IntAlias', ' :module: target.classes', @@ -435,11 +441,10 @@ def test_class_alias_for_imported_object_having_doccomment(app: SphinxTestApp) - ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_coroutine(app: SphinxTestApp) -> None: +def test_coroutine() -> None: options = {'members': None} - actual = do_autodoc(app, 'class', 'target.coroutine.AsyncClass', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.coroutine.AsyncClass', options=options) + assert actual == [ '', '.. py:class:: AsyncClass()', ' :module: target.coroutine', @@ -477,10 +482,9 @@ def test_coroutine(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodata_NewType_module_level(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'class', 'target.typevar.T6') - assert list(actual) == [ +def test_autodata_NewType_module_level() -> None: + actual = do_autodoc('class', 'target.typevar.T6') + assert actual == [ '', '.. py:class:: T6', ' :module: target.typevar', @@ -492,10 +496,9 @@ def test_autodata_NewType_module_level(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_NewType_class_level(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'class', 'target.typevar.Class.T6') - assert list(actual) == [ +def test_autoattribute_NewType_class_level() -> None: + actual = do_autodoc('class', 'target.typevar.Class.T6') + assert actual == [ '', '.. py:class:: Class.T6', ' :module: target.typevar', @@ -507,10 +510,9 @@ def test_autoattribute_NewType_class_level(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodata_TypeVar_class_level(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'class', 'target.typevar.T1') - assert list(actual) == [ +def test_autodata_TypeVar_class_level() -> None: + actual = do_autodoc('class', 'target.typevar.T1') + assert actual == [ '', '.. py:class:: T1', ' :module: target.typevar', @@ -522,10 +524,9 @@ def test_autodata_TypeVar_class_level(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_TypeVar_module_level(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'class', 'target.typevar.Class.T1') - assert list(actual) == [ +def test_autoattribute_TypeVar_module_level() -> None: + actual = do_autodoc('class', 'target.typevar.Class.T1') + assert actual == [ '', '.. py:class:: Class.T1', ' :module: target.typevar', @@ -537,16 +538,15 @@ def test_autoattribute_TypeVar_module_level(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_inherited_instance_variable_with_annotations(app: SphinxTestApp) -> None: +def test_inherited_instance_variable_with_annotations() -> None: options = { 'members': None, 'inherited-members': None, } actual = do_autodoc( - app, 'class', 'target.inherited_annotations.NoTypeAnnotation', options + 'class', 'target.inherited_annotations.NoTypeAnnotation', options=options ) - assert list(actual) == [ + assert actual == [ '', '.. py:class:: NoTypeAnnotation()', ' :module: target.inherited_annotations', @@ -568,13 +568,12 @@ def test_inherited_instance_variable_with_annotations(app: SphinxTestApp) -> Non ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_no_inherited_instance_variable_with_annotations(app: SphinxTestApp) -> None: +def test_no_inherited_instance_variable_with_annotations() -> None: options = {'members': None} actual = do_autodoc( - app, 'class', 'target.inherited_annotations.NoTypeAnnotation2', options + 'class', 'target.inherited_annotations.NoTypeAnnotation2', options=options ) - assert list(actual) == [ + assert actual == [ '', '.. py:class:: NoTypeAnnotation2()', ' :module: target.inherited_annotations', diff --git a/tests/test_ext_autodoc/test_ext_autodoc_autodata.py b/tests/test_ext_autodoc/test_ext_autodoc_autodata.py new file mode 100644 index 00000000000..853d6dcdc28 --- /dev/null +++ b/tests/test_ext_autodoc/test_ext_autodoc_autodata.py @@ -0,0 +1,104 @@ +"""Test the autodoc extension. + +This tests mainly the Documenters; the auto directives are tested in a test +source file translated by test_build. +""" + +from __future__ import annotations + +import pytest + +from tests.test_ext_autodoc.autodoc_util import do_autodoc + +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') + + +def test_autodata() -> None: + actual = do_autodoc('data', 'target.integer') + assert actual == [ + '', + '.. py:data:: integer', + ' :module: target', + ' :value: 1', + '', + ' documentation for the integer', + '', + ] + + +def test_autodata_novalue() -> None: + options = {'no-value': None} + actual = do_autodoc('data', 'target.integer', options=options) + assert actual == [ + '', + '.. py:data:: integer', + ' :module: target', + '', + ' documentation for the integer', + '', + ] + + +def test_autodata_typed_variable() -> None: + actual = do_autodoc('data', 'target.typed_vars.attr2') + assert actual == [ + '', + '.. py:data:: attr2', + ' :module: target.typed_vars', + ' :type: str', + '', + ' attr2', + '', + ] + + +def test_autodata_type_comment() -> None: + actual = do_autodoc('data', 'target.typed_vars.attr3') + assert actual == [ + '', + '.. py:data:: attr3', + ' :module: target.typed_vars', + ' :type: str', + " :value: ''", + '', + ' attr3', + '', + ] + + +def test_autodata_GenericAlias() -> None: + actual = do_autodoc('data', 'target.genericalias.T') + assert actual == [ + '', + '.. py:data:: T', + ' :module: target.genericalias', + '', + ' A list of int', + '', + ' alias of :py:class:`~typing.List`\\ [:py:class:`int`]', + '', + ] + + +def test_autodata_hide_value() -> None: + actual = do_autodoc('data', 'target.hide_value.SENTINEL1') + assert actual == [ + '', + '.. py:data:: SENTINEL1', + ' :module: target.hide_value', + '', + ' docstring', + '', + ' :meta hide-value:', + '', + ] + + actual = do_autodoc('data', 'target.hide_value.SENTINEL2') + assert actual == [ + '', + '.. py:data:: SENTINEL2', + ' :module: target.hide_value', + '', + ' :meta hide-value:', + '', + ] diff --git a/tests/test_ext_autodoc/test_ext_autodoc_autofunction.py b/tests/test_ext_autodoc/test_ext_autodoc_autofunction.py new file mode 100644 index 00000000000..485329ebb37 --- /dev/null +++ b/tests/test_ext_autodoc/test_ext_autodoc_autofunction.py @@ -0,0 +1,201 @@ +"""Test the autodoc extension. + +This tests mainly the Documenters; the auto directives are tested in a test +source file translated by test_build. +""" + +from __future__ import annotations + +import pytest + +from tests.test_ext_autodoc.autodoc_util import do_autodoc + +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') + + +def test_classes() -> None: + actual = do_autodoc('function', 'target.classes.Foo') + assert actual == [ + '', + '.. py:function:: Foo()', + ' :module: target.classes', + '', + ] + + actual = do_autodoc('function', 'target.classes.Bar') + assert actual == [ + '', + '.. py:function:: Bar(x, y)', + ' :module: target.classes', + '', + ] + + actual = do_autodoc('function', 'target.classes.Baz') + assert actual == [ + '', + '.. py:function:: Baz(x, y)', + ' :module: target.classes', + '', + ] + + actual = do_autodoc('function', 'target.classes.Qux') + assert actual == [ + '', + '.. py:function:: Qux(foo, bar)', + ' :module: target.classes', + '', + ] + + +def test_callable() -> None: + actual = do_autodoc('function', 'target.callable.function') + assert actual == [ + '', + '.. py:function:: function(arg1, arg2, **kwargs)', + ' :module: target.callable', + '', + ' A callable object that behaves like a function.', + '', + ] + + +def test_method() -> None: + actual = do_autodoc('function', 'target.callable.method') + assert actual == [ + '', + '.. py:function:: method(arg1, arg2)', + ' :module: target.callable', + '', + ' docstring of Callable.method().', + '', + ] + + +def test_builtin_function() -> None: + actual = do_autodoc('function', 'os.umask') + assert actual == [ + '', + '.. py:function:: umask(mask, /)', + ' :module: os', + '', + ' Set the current numeric umask and return the previous umask.', + '', + ] + + +def test_methoddescriptor() -> None: + actual = do_autodoc('function', 'builtins.int.__add__') + assert actual == [ + '', + '.. py:function:: __add__(self, value, /)', + ' :module: builtins.int', + '', + ' Return self+value.', + '', + ] + + +def test_decorated() -> None: + actual = do_autodoc('function', 'target.decorator.foo') + assert actual == [ + '', + '.. py:function:: foo(name=None, age=None)', + ' :module: target.decorator', + '', + ] + + +def test_singledispatch() -> None: + actual = do_autodoc('function', 'target.singledispatch.func') + assert actual == [ + '', + '.. py:function:: func(arg, kwarg=None)', + ' func(arg: float, kwarg=None)', + ' func(arg: int, kwarg=None)', + ' func(arg: str, kwarg=None)', + ' func(arg: dict, kwarg=None)', + ' :module: target.singledispatch', + '', + ' A function for general use.', + '', + ] + + +def test_cfunction() -> None: + actual = do_autodoc('function', 'time.asctime') + assert actual == [ + '', + '.. py:function:: asctime([tuple]) -> string', + ' :module: time', + '', + " Convert a time tuple to a string, e.g. 'Sat Jun 06 16:26:11 1998'.", + ' When the time tuple is not present, current time as returned by localtime()', + ' is used.', + '', + ] + + +def test_wrapped_function() -> None: + actual = do_autodoc('function', 'target.wrappedfunction.slow_function') + assert actual == [ + '', + '.. py:function:: slow_function(message, timeout)', + ' :module: target.wrappedfunction', + '', + ' This function is slow.', + '', + ] + + +def test_wrapped_function_contextmanager() -> None: + actual = do_autodoc('function', 'target.wrappedfunction.feeling_good') + assert actual == [ + '', + '.. py:function:: feeling_good(x: int, y: int) -> ~typing.Generator', + ' :module: target.wrappedfunction', + '', + " You'll feel better in this context!", + '', + ] + + +def test_coroutine() -> None: + actual = do_autodoc('function', 'target.functions.coroutinefunc') + assert actual == [ + '', + '.. py:function:: coroutinefunc()', + ' :module: target.functions', + ' :async:', + '', + ] + + +def test_synchronized_coroutine() -> None: + actual = do_autodoc('function', 'target.coroutine.sync_func') + assert actual == [ + '', + '.. py:function:: sync_func()', + ' :module: target.coroutine', + '', + ] + + +def test_async_generator() -> None: + actual = do_autodoc('function', 'target.functions.asyncgenerator') + assert actual == [ + '', + '.. py:function:: asyncgenerator()', + ' :module: target.functions', + ' :async:', + '', + ] + + +def test_slice_function_arg() -> None: + actual = do_autodoc('function', 'target.functions.slice_arg_func') + assert actual == [ + '', + '.. py:function:: slice_arg_func(arg: float64[:, :])', + ' :module: target.functions', + '', + ] diff --git a/tests/test_extensions/test_ext_autodoc_automodule.py b/tests/test_ext_autodoc/test_ext_autodoc_automodule.py similarity index 75% rename from tests/test_extensions/test_ext_autodoc_automodule.py rename to tests/test_ext_autodoc/test_ext_autodoc_automodule.py index 9404e01b730..6fad349a134 100644 --- a/tests/test_extensions/test_ext_autodoc_automodule.py +++ b/tests/test_ext_autodoc/test_ext_autodoc_automodule.py @@ -12,17 +12,18 @@ import pytest -from tests.test_extensions.autodoc_util import do_autodoc +from sphinx.ext.autodoc._dynamic._mock import _MockObject +from sphinx.ext.autodoc._shared import _AutodocConfig -if typing.TYPE_CHECKING: - from sphinx.testing.util import SphinxTestApp +from tests.test_ext_autodoc.autodoc_util import do_autodoc +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_empty_all(app: SphinxTestApp) -> None: + +def test_empty_all() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.empty_all', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.empty_all', options=options) + assert actual == [ '', '.. py:module:: target.empty_all', '', @@ -31,11 +32,10 @@ def test_empty_all(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_automodule(app: SphinxTestApp) -> None: +def test_automodule() -> None: options = {'members': None} - actual = do_autodoc(app, 'module', 'target.module', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.module', options=options) + assert actual == [ '', '.. py:module:: target.module', '', @@ -56,14 +56,13 @@ def test_automodule(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_automodule_undoc_members(app: SphinxTestApp) -> None: +def test_automodule_undoc_members() -> None: options = { 'members': None, 'undoc-members': None, } - actual = do_autodoc(app, 'module', 'target.module', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.module', options=options) + assert actual == [ '', '.. py:module:: target.module', '', @@ -89,14 +88,13 @@ def test_automodule_undoc_members(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_automodule_special_members(app: SphinxTestApp) -> None: +def test_automodule_special_members() -> None: options = { 'members': None, 'special-members': None, } - actual = do_autodoc(app, 'module', 'target.module', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.module', options=options) + assert actual == [ '', '.. py:module:: target.module', '', @@ -124,15 +122,14 @@ def test_automodule_special_members(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_automodule_inherited_members(app: SphinxTestApp) -> None: +def test_automodule_inherited_members() -> None: options = { 'members': None, 'undoc-members': None, 'inherited-members': 'Base, list', } - actual = do_autodoc(app, 'module', 'target.inheritance', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.inheritance', options=options) + assert actual == [ '', '.. py:module:: target.inheritance', '', @@ -206,29 +203,26 @@ def test_automodule_inherited_members(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - confoverrides={ - 'autodoc_mock_imports': [ +@pytest.mark.usefixtures('rollback_sysmodules') +def test_subclass_of_mocked_object() -> None: + config = _AutodocConfig( + autodoc_mock_imports=[ 'missing_module', 'missing_package1', 'missing_package2', 'missing_package3', 'sphinx.missing_module4', ] - }, -) -@pytest.mark.usefixtures('rollback_sysmodules') -def test_subclass_of_mocked_object(app: SphinxTestApp) -> None: - from sphinx.ext.autodoc.mock import _MockObject + ) sys.modules.pop('target', None) # unload target module to clear the module cache options = {'members': None} - actual = do_autodoc(app, 'module', 'target.need_mocks', options) + actual = do_autodoc('module', 'target.need_mocks', config=config, options=options) # ``typing.Any`` is not available at runtime on ``_MockObject.__new__`` - assert '.. py:class:: Inherited(*args: Any, **kwargs: Any)' in actual + assert actual[10:11] == [ + '.. py:class:: Inherited(*args: Any, **kwargs: Any)', + ] # make ``typing.Any`` available at runtime on ``_MockObject.__new__`` sig = inspect.signature(_MockObject.__new__) @@ -239,7 +233,7 @@ def test_subclass_of_mocked_object(app: SphinxTestApp) -> None: _MockObject.__new__.__signature__ = sig # type: ignore[attr-defined] options = {'members': None} - actual = do_autodoc(app, 'module', 'target.need_mocks', options) - assert ( - '.. py:class:: Inherited(*args: ~typing.Any, **kwargs: ~typing.Any)' - ) in actual + actual = do_autodoc('module', 'target.need_mocks', config=config, options=options) + assert actual[10:11] == [ + '.. py:class:: Inherited(*args: ~typing.Any, **kwargs: ~typing.Any)', + ] diff --git a/tests/test_ext_autodoc/test_ext_autodoc_autoproperty.py b/tests/test_ext_autodoc/test_ext_autodoc_autoproperty.py new file mode 100644 index 00000000000..8042a1ff310 --- /dev/null +++ b/tests/test_ext_autodoc/test_ext_autodoc_autoproperty.py @@ -0,0 +1,111 @@ +"""Test the autodoc extension. + +This tests mainly the Documenters; the auto directives are tested in a test +source file translated by test_build. +""" + +from __future__ import annotations + +import sys + +import pytest + +from tests.test_ext_autodoc.autodoc_util import do_autodoc + +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') + + +def test_properties() -> None: + actual = do_autodoc('property', 'target.properties.Foo.prop1') + assert actual == [ + '', + '.. py:property:: Foo.prop1', + ' :module: target.properties', + ' :type: int', + '', + ' docstring', + '', + ] + + +def test_class_properties() -> None: + actual = do_autodoc('property', 'target.properties.Foo.prop2') + assert actual == [ + '', + '.. py:property:: Foo.prop2', + ' :module: target.properties', + ' :classmethod:', + ' :type: int', + '', + ' docstring', + '', + ] + + +def test_properties_with_type_comment() -> None: + actual = do_autodoc('property', 'target.properties.Foo.prop1_with_type_comment') + assert actual == [ + '', + '.. py:property:: Foo.prop1_with_type_comment', + ' :module: target.properties', + ' :type: int', + '', + ' docstring', + '', + ] + + +def test_class_properties_with_type_comment() -> None: + actual = do_autodoc('property', 'target.properties.Foo.prop2_with_type_comment') + assert actual == [ + '', + '.. py:property:: Foo.prop2_with_type_comment', + ' :module: target.properties', + ' :classmethod:', + ' :type: int', + '', + ' docstring', + '', + ] + + +def test_cached_properties() -> None: + actual = do_autodoc('property', 'target.cached_property.Foo.prop') + assert actual == [ + '', + '.. py:property:: Foo.prop', + ' :module: target.cached_property', + ' :type: int', + '', + ] + + +def test_cached_properties_with_type_comment() -> None: + actual = do_autodoc('property', 'target.cached_property.Foo.prop_with_type_comment') + assert actual == [ + '', + '.. py:property:: Foo.prop_with_type_comment', + ' :module: target.cached_property', + ' :type: int', + '', + ] + + +def test_property_with_undefined_annotation() -> None: + if sys.version_info[:2] >= (3, 14): + type_checking_only_name = 'TypeCheckingOnlyName' + else: + type_checking_only_name = 'int' + + actual = do_autodoc( + 'property', 'target.properties.Foo.prop3_with_undefined_anotation' + ) + assert actual == [ + '', + '.. py:property:: Foo.prop3_with_undefined_anotation', + ' :module: target.properties', + f' :type: {type_checking_only_name}', + '', + ' docstring', + '', + ] diff --git a/tests/test_ext_autodoc/test_ext_autodoc_configs.py b/tests/test_ext_autodoc/test_ext_autodoc_configs.py new file mode 100644 index 00000000000..e3b80857772 --- /dev/null +++ b/tests/test_ext_autodoc/test_ext_autodoc_configs.py @@ -0,0 +1,1009 @@ +"""Test the autodoc extension. This tests mainly for config variables""" + +from __future__ import annotations + +import logging +import platform +import sys + +import pytest + +from sphinx.ext.autodoc._shared import _AutodocConfig + +from tests.test_ext_autodoc.autodoc_util import do_autodoc + +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') + +IS_PYPY = platform.python_implementation() == 'PyPy' + + +def test_autoclass_content_class() -> None: + config = _AutodocConfig(autoclass_content='class') + options = {'members': None} + actual = do_autodoc( + 'module', 'target.autoclass_content', config=config, options=options + ) + assert actual == [ + '', + '.. py:module:: target.autoclass_content', + '', + '', + '.. py:class:: A()', + ' :module: target.autoclass_content', + '', + ' A class having no __init__, no __new__', + '', + '', + '.. py:class:: B()', + ' :module: target.autoclass_content', + '', + ' A class having __init__(no docstring), no __new__', + '', + '', + '.. py:class:: C()', + ' :module: target.autoclass_content', + '', + ' A class having __init__, no __new__', + '', + '', + '.. py:class:: D()', + ' :module: target.autoclass_content', + '', + ' A class having no __init__, __new__(no docstring)', + '', + '', + '.. py:class:: E()', + ' :module: target.autoclass_content', + '', + ' A class having no __init__, __new__', + '', + '', + '.. py:class:: F()', + ' :module: target.autoclass_content', + '', + ' A class having both __init__ and __new__', + '', + '', + '.. py:class:: G()', + ' :module: target.autoclass_content', + '', + ' A class inherits __init__ without docstring.', + '', + '', + '.. py:class:: H()', + ' :module: target.autoclass_content', + '', + ' A class inherits __new__ without docstring.', + '', + ] + + +def test_autoclass_content_init() -> None: + config = _AutodocConfig(autoclass_content='init') + options = {'members': None} + actual = do_autodoc( + 'module', 'target.autoclass_content', config=config, options=options + ) + assert actual == [ + '', + '.. py:module:: target.autoclass_content', + '', + '', + '.. py:class:: A()', + ' :module: target.autoclass_content', + '', + ' A class having no __init__, no __new__', + '', + '', + '.. py:class:: B()', + ' :module: target.autoclass_content', + '', + ' A class having __init__(no docstring), no __new__', + '', + '', + '.. py:class:: C()', + ' :module: target.autoclass_content', + '', + ' __init__ docstring', + '', + '', + '.. py:class:: D()', + ' :module: target.autoclass_content', + '', + ' A class having no __init__, __new__(no docstring)', + '', + '', + '.. py:class:: E()', + ' :module: target.autoclass_content', + '', + ' __new__ docstring', + '', + '', + '.. py:class:: F()', + ' :module: target.autoclass_content', + '', + ' __init__ docstring', + '', + '', + '.. py:class:: G()', + ' :module: target.autoclass_content', + '', + ' __init__ docstring', + '', + '', + '.. py:class:: H()', + ' :module: target.autoclass_content', + '', + ' __new__ docstring', + '', + ] + + +def test_autodoc_class_signature_mixed() -> None: + config = _AutodocConfig(autodoc_class_signature='mixed') + options = { + 'members': None, + 'undoc-members': None, + } + actual = do_autodoc('class', 'target.classes.Bar', config=config, options=options) + assert actual == [ + '', + '.. py:class:: Bar(x, y)', + ' :module: target.classes', + '', + ] + + +def test_autodoc_class_signature_separated_init() -> None: + config = _AutodocConfig(autodoc_class_signature='separated') + options = { + 'members': None, + 'undoc-members': None, + } + actual = do_autodoc('class', 'target.classes.Bar', config=config, options=options) + assert actual == [ + '', + '.. py:class:: Bar', + ' :module: target.classes', + '', + '', + ' .. py:method:: Bar.__init__(x, y)', + ' :module: target.classes', + '', + ] + + +def test_autodoc_class_signature_separated_new() -> None: + config = _AutodocConfig(autodoc_class_signature='separated') + options = { + 'members': None, + 'undoc-members': None, + } + actual = do_autodoc('class', 'target.classes.Baz', config=config, options=options) + assert actual == [ + '', + '.. py:class:: Baz', + ' :module: target.classes', + '', + '', + ' .. py:method:: Baz.__new__(cls, x, y)', + ' :module: target.classes', + ' :staticmethod:', + '', + ] + + +def test_autoclass_content_both() -> None: + config = _AutodocConfig(autoclass_content='both') + options = {'members': None} + actual = do_autodoc( + 'module', 'target.autoclass_content', config=config, options=options + ) + assert actual == [ + '', + '.. py:module:: target.autoclass_content', + '', + '', + '.. py:class:: A()', + ' :module: target.autoclass_content', + '', + ' A class having no __init__, no __new__', + '', + '', + '.. py:class:: B()', + ' :module: target.autoclass_content', + '', + ' A class having __init__(no docstring), no __new__', + '', + '', + '.. py:class:: C()', + ' :module: target.autoclass_content', + '', + ' A class having __init__, no __new__', + '', + ' __init__ docstring', + '', + '', + '.. py:class:: D()', + ' :module: target.autoclass_content', + '', + ' A class having no __init__, __new__(no docstring)', + '', + '', + '.. py:class:: E()', + ' :module: target.autoclass_content', + '', + ' A class having no __init__, __new__', + '', + ' __new__ docstring', + '', + '', + '.. py:class:: F()', + ' :module: target.autoclass_content', + '', + ' A class having both __init__ and __new__', + '', + ' __init__ docstring', + '', + '', + '.. py:class:: G()', + ' :module: target.autoclass_content', + '', + ' A class inherits __init__ without docstring.', + '', + ' __init__ docstring', + '', + '', + '.. py:class:: H()', + ' :module: target.autoclass_content', + '', + ' A class inherits __new__ without docstring.', + '', + ' __new__ docstring', + '', + ] + + +def test_autodoc_inherit_docstrings() -> None: + config = _AutodocConfig() + assert config.autodoc_inherit_docstrings is True # default + actual = do_autodoc( + 'method', 'target.inheritance.Derived.inheritedmeth', config=config + ) + assert actual == [ + '', + '.. py:method:: Derived.inheritedmeth()', + ' :module: target.inheritance', + '', + ' Inherited function.', + '', + ] + + # disable autodoc_inherit_docstrings + config = _AutodocConfig(autodoc_inherit_docstrings=False) + actual = do_autodoc( + 'method', 'target.inheritance.Derived.inheritedmeth', config=config + ) + assert actual == [ + '', + '.. py:method:: Derived.inheritedmeth()', + ' :module: target.inheritance', + '', + ] + + +def test_autodoc_inherit_docstrings_for_inherited_members() -> None: + config = _AutodocConfig() + options = { + 'members': None, + 'inherited-members': None, + } + + assert config.autodoc_inherit_docstrings is True # default + actual = do_autodoc( + 'class', 'target.inheritance.Derived', config=config, options=options + ) + assert actual == [ + '', + '.. py:class:: Derived()', + ' :module: target.inheritance', + '', + '', + ' .. py:method:: Derived.another_inheritedmeth()', + ' :module: target.inheritance', + '', + ' Another inherited function.', + '', + '', + ' .. py:attribute:: Derived.inheritedattr', + ' :module: target.inheritance', + ' :value: None', + '', + ' docstring', + '', + '', + ' .. py:method:: Derived.inheritedclassmeth()', + ' :module: target.inheritance', + ' :classmethod:', + '', + ' Inherited class method.', + '', + '', + ' .. py:method:: Derived.inheritedmeth()', + ' :module: target.inheritance', + '', + ' Inherited function.', + '', + '', + ' .. py:method:: Derived.inheritedstaticmeth(cls)', + ' :module: target.inheritance', + ' :staticmethod:', + '', + ' Inherited static method.', + '', + ] + + # disable autodoc_inherit_docstrings + config = _AutodocConfig(autodoc_inherit_docstrings=False) + actual = do_autodoc( + 'class', 'target.inheritance.Derived', config=config, options=options + ) + assert actual == [ + '', + '.. py:class:: Derived()', + ' :module: target.inheritance', + '', + '', + ' .. py:method:: Derived.another_inheritedmeth()', + ' :module: target.inheritance', + '', + ' Another inherited function.', + '', + '', + ' .. py:method:: Derived.inheritedclassmeth()', + ' :module: target.inheritance', + ' :classmethod:', + '', + ' Inherited class method.', + '', + '', + ' .. py:method:: Derived.inheritedstaticmeth(cls)', + ' :module: target.inheritance', + ' :staticmethod:', + '', + ' Inherited static method.', + '', + ] + + +def test_autodoc_docstring_signature() -> None: + options = { + 'members': None, + 'special-members': '__init__, __new__', + } + actual = do_autodoc('class', 'target.DocstringSig', options=options) + assert actual == [ + '', + # FIXME: Ideally this would instead be: `DocstringSig(d, e=1)` but + # currently `ClassDocumenter` does not apply the docstring signature + # logic when extracting a signature from a __new__ or __init__ method. + '.. py:class:: DocstringSig(*new_args, **new_kwargs)', + ' :module: target', + '', + '', + ' .. py:method:: DocstringSig.__init__(self, a, b=1) -> None', + ' :module: target', + '', + ' First line of docstring', + '', + ' rest of docstring', + '', + '', + ' .. py:method:: DocstringSig.__new__(cls, d, e=1) -> DocstringSig', + ' :module: target', + ' :staticmethod:', + '', + ' First line of docstring', + '', + ' rest of docstring', + '', + '', + ' .. py:method:: DocstringSig.meth(FOO, BAR=1) -> BAZ', + ' :module: target', + '', + ' First line of docstring', + '', + ' rest of docstring', + '', + '', + ' .. py:method:: DocstringSig.meth2()', + ' :module: target', + '', + ' First line, no signature', + ' Second line followed by indentation::', + '', + ' indented line', + '', + '', + ' .. py:property:: DocstringSig.prop1', + ' :module: target', + '', + ' First line of docstring', + '', + '', + ' .. py:property:: DocstringSig.prop2', + ' :module: target', + '', + ' First line of docstring', + ' Second line of docstring', + '', + ] + + # disable autodoc_docstring_signature + config = _AutodocConfig(autodoc_docstring_signature=False) + actual = do_autodoc('class', 'target.DocstringSig', config=config, options=options) + assert actual == [ + '', + '.. py:class:: DocstringSig(*new_args, **new_kwargs)', + ' :module: target', + '', + '', + ' .. py:method:: DocstringSig.__init__(*init_args, **init_kwargs)', + ' :module: target', + '', + ' __init__(self, a, b=1) -> None', + ' First line of docstring', + '', + ' rest of docstring', + '', + '', + ' .. py:method:: DocstringSig.__new__(cls, *new_args, **new_kwargs)', + ' :module: target', + ' :staticmethod:', + '', + ' __new__(cls, d, e=1) -> DocstringSig', + ' First line of docstring', + '', + ' rest of docstring', + '', + '', + ' .. py:method:: DocstringSig.meth()', + ' :module: target', + '', + ' meth(FOO, BAR=1) -> BAZ', + ' First line of docstring', + '', + ' rest of docstring', + '', + '', + ' .. py:method:: DocstringSig.meth2()', + ' :module: target', + '', + ' First line, no signature', + ' Second line followed by indentation::', + '', + ' indented line', + '', + '', + ' .. py:property:: DocstringSig.prop1', + ' :module: target', + '', + ' DocstringSig.prop1(self)', + ' First line of docstring', + '', + '', + ' .. py:property:: DocstringSig.prop2', + ' :module: target', + '', + ' First line of docstring', + ' Second line of docstring', + '', + ] + + +def test_autoclass_content_and_docstring_signature_class() -> None: + config = _AutodocConfig(autoclass_content='class') + options = { + 'members': None, + 'undoc-members': None, + } + actual = do_autodoc( + 'module', 'target.docstring_signature', config=config, options=options + ) + assert actual == [ + '', + '.. py:module:: target.docstring_signature', + '', + '', + '.. py:class:: A(foo, bar)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: B(foo, bar)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: C(foo, bar)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: D()', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: E()', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: F()', + ' :module: target.docstring_signature', + '', + ] + + +def test_autoclass_content_and_docstring_signature_init() -> None: + config = _AutodocConfig(autoclass_content='init') + options = { + 'members': None, + 'undoc-members': None, + } + actual = do_autodoc( + 'module', 'target.docstring_signature', config=config, options=options + ) + assert actual == [ + '', + '.. py:module:: target.docstring_signature', + '', + '', + '.. py:class:: A(foo, bar)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: B(foo, bar, baz)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: C(foo, bar, baz)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: D(foo, bar, baz)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: E(foo: int, bar: int, baz: int)', + ' E(foo: str, bar: str, baz: str)', + ' E(foo: float, bar: float, baz: float)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: F(foo: int, bar: int, baz: int)', + ' F(foo: str, bar: str, baz: str)', + ' F(foo: float, bar: float, baz: float)', + ' :module: target.docstring_signature', + '', + ] + + +def test_autoclass_content_and_docstring_signature_both() -> None: + config = _AutodocConfig(autoclass_content='both') + options = { + 'members': None, + 'undoc-members': None, + } + actual = do_autodoc( + 'module', 'target.docstring_signature', config=config, options=options + ) + assert actual == [ + '', + '.. py:module:: target.docstring_signature', + '', + '', + '.. py:class:: A(foo, bar)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: B(foo, bar)', + ' :module: target.docstring_signature', + '', + ' B(foo, bar, baz)', + '', + '', + '.. py:class:: C(foo, bar)', + ' :module: target.docstring_signature', + '', + ' C(foo, bar, baz)', + '', + '', + '.. py:class:: D(foo, bar, baz)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: E(foo: int, bar: int, baz: int)', + ' E(foo: str, bar: str, baz: str)', + ' E(foo: float, bar: float, baz: float)', + ' :module: target.docstring_signature', + '', + '', + '.. py:class:: F(foo: int, bar: int, baz: int)', + ' F(foo: str, bar: str, baz: str)', + ' F(foo: float, bar: float, baz: float)', + ' :module: target.docstring_signature', + '', + ] + + +@pytest.mark.usefixtures('rollback_sysmodules') +def test_mocked_module_imports(caplog: pytest.LogCaptureFixture) -> None: + # work around sphinx.util.logging.setup() + logger = logging.getLogger('sphinx') + logger.handlers[:] = [caplog.handler] + caplog.set_level(logging.WARNING) + + sys.modules.pop('target', None) # unload target module to clear the module cache + + # no autodoc_mock_imports + options = {'members': 'TestAutodoc,decorated_function,func,Alias'} + actual = do_autodoc( + 'module', 'target.need_mocks', expect_import_error=True, options=options + ) + assert actual == [] + assert len(set(caplog.messages)) == 1 + assert "autodoc: failed to import 'need_mocks'" in caplog.messages[0] + + # with autodoc_mock_imports + config = _AutodocConfig( + autodoc_mock_imports=[ + 'missing_module', + 'missing_package1', + 'missing_package2', + 'missing_package3', + 'sphinx.missing_module4', + ] + ) + + caplog.clear() + actual = do_autodoc('module', 'target.need_mocks', config=config, options=options) + assert actual == [ + '', + '.. py:module:: target.need_mocks', + '', + '', + '.. py:data:: Alias', + ' :module: target.need_mocks', + '', + ' docstring', + '', + '', + '.. py:class:: TestAutodoc()', + ' :module: target.need_mocks', + '', + ' TestAutodoc docstring.', + '', + '', + ' .. py:attribute:: TestAutodoc.Alias', + ' :module: target.need_mocks', + '', + ' docstring', + '', + '', + ' .. py:method:: TestAutodoc.decorated_method()', + ' :module: target.need_mocks', + '', + ' TestAutodoc::decorated_method docstring', + '', + '', + '.. py:function:: decorated_function()', + ' :module: target.need_mocks', + '', + ' decorated_function docstring', + '', + '', + '.. py:function:: func(arg: missing_module.Class)', + ' :module: target.need_mocks', + '', + ' a function takes mocked object as an argument', + '', + ] + assert len(caplog.records) == 0 + + +def test_autodoc_type_aliases() -> None: + # default + options = {'members': None} + actual = do_autodoc('module', 'target.autodoc_type_aliases', options=options) + assert actual == [ + '', + '.. py:module:: target.autodoc_type_aliases', + '', + '', + '.. py:class:: Foo()', + ' :module: target.autodoc_type_aliases', + '', + ' docstring', + '', + '', + ' .. py:attribute:: Foo.attr1', + ' :module: target.autodoc_type_aliases', + ' :type: int', + '', + ' docstring', + '', + '', + ' .. py:attribute:: Foo.attr2', + ' :module: target.autodoc_type_aliases', + ' :type: int', + '', + ' docstring', + '', + '', + '.. py:function:: mult(x: int, y: int) -> int', + ' mult(x: float, y: float) -> float', + ' :module: target.autodoc_type_aliases', + '', + ' docstring', + '', + '', + '.. py:function:: read(r: ~io.BytesIO) -> ~io.StringIO', + ' :module: target.autodoc_type_aliases', + '', + ' docstring', + '', + '', + '.. py:function:: sum(x: int, y: int) -> int', + ' :module: target.autodoc_type_aliases', + '', + ' docstring', + '', + '', + '.. py:data:: variable', + ' :module: target.autodoc_type_aliases', + ' :type: int', + '', + ' docstring', + '', + '', + '.. py:data:: variable2', + ' :module: target.autodoc_type_aliases', + ' :type: int', + ' :value: None', + '', + ' docstring', + '', + '', + '.. py:data:: variable3', + ' :module: target.autodoc_type_aliases', + ' :type: int | None', + '', + ' docstring', + '', + ] + + # define aliases + config = _AutodocConfig( + autodoc_type_aliases={ + 'myint': 'myint', + 'io.StringIO': 'my.module.StringIO', + } + ) + actual = do_autodoc( + 'module', 'target.autodoc_type_aliases', config=config, options=options + ) + assert actual == [ + '', + '.. py:module:: target.autodoc_type_aliases', + '', + '', + '.. py:class:: Foo()', + ' :module: target.autodoc_type_aliases', + '', + ' docstring', + '', + '', + ' .. py:attribute:: Foo.attr1', + ' :module: target.autodoc_type_aliases', + ' :type: myint', + '', + ' docstring', + '', + '', + ' .. py:attribute:: Foo.attr2', + ' :module: target.autodoc_type_aliases', + ' :type: myint', + '', + ' docstring', + '', + '', + '.. py:function:: mult(x: myint, y: myint) -> myint', + ' mult(x: float, y: float) -> float', + ' :module: target.autodoc_type_aliases', + '', + ' docstring', + '', + '', + '.. py:function:: read(r: ~io.BytesIO) -> my.module.StringIO', + ' :module: target.autodoc_type_aliases', + '', + ' docstring', + '', + '', + '.. py:function:: sum(x: myint, y: myint) -> myint', + ' :module: target.autodoc_type_aliases', + '', + ' docstring', + '', + '', + '.. py:data:: variable', + ' :module: target.autodoc_type_aliases', + ' :type: myint', + '', + ' docstring', + '', + '', + '.. py:data:: variable2', + ' :module: target.autodoc_type_aliases', + ' :type: myint', + ' :value: None', + '', + ' docstring', + '', + '', + '.. py:data:: variable3', + ' :module: target.autodoc_type_aliases', + ' :type: myint | None', + '', + ' docstring', + '', + ] + + +def test_autodoc_default_options() -> None: + if sys.version_info[:3] >= (3, 12, 1): + list_of_weak_references = ' list of weak references to the object' + else: + list_of_weak_references = ' list of weak references to the object (if defined)' # fmt: skip + + # no settings + actual = do_autodoc('class', 'target.enums.EnumCls') + assert ' .. py:attribute:: EnumCls.val1' not in actual + assert ' .. py:attribute:: EnumCls.val4' not in actual + actual = do_autodoc('class', 'target.CustomIter') + assert ' .. py:method:: target.CustomIter' not in actual + actual = do_autodoc('module', 'target') + assert '.. py:function:: function_to_be_imported(app)' not in actual + + # with :members: + config = _AutodocConfig(autodoc_default_options={'members': True}) + actual = do_autodoc('class', 'target.enums.EnumCls', config=config) + assert ' .. py:attribute:: EnumCls.val1' in actual + assert ' .. py:attribute:: EnumCls.val4' not in actual + + # with :members: = True + config = _AutodocConfig(autodoc_default_options={'members': True}) + actual = do_autodoc('class', 'target.enums.EnumCls', config=config) + assert ' .. py:attribute:: EnumCls.val1' in actual + assert ' .. py:attribute:: EnumCls.val4' not in actual + + # with :members: and :undoc-members: + config = _AutodocConfig( + autodoc_default_options={'members': True, 'undoc-members': True} + ) + actual = do_autodoc('class', 'target.enums.EnumCls', config=config) + assert ' .. py:attribute:: EnumCls.val1' in actual + assert ' .. py:attribute:: EnumCls.val4' in actual + + # with :special-members: + # Note that :members: must be *on* for :special-members: to work. + config = _AutodocConfig( + autodoc_default_options={'members': True, 'special-members': True} + ) + actual = do_autodoc('class', 'target.CustomIter', config=config) + assert ' .. py:method:: CustomIter.__init__()' in actual + assert ' Create a new `CustomIter`.' in actual + assert ' .. py:method:: CustomIter.__iter__()' in actual + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' in actual + assert list_of_weak_references in actual + + # :exclude-members: None - has no effect. Unlike :members:, + # :special-members:, etc. where None == "include all", here None means + # "no/false/off". + config = _AutodocConfig( + autodoc_default_options={'members': True, 'exclude-members': True} + ) + actual = do_autodoc('class', 'target.enums.EnumCls', config=config) + assert ' .. py:attribute:: EnumCls.val1' in actual + assert ' .. py:attribute:: EnumCls.val4' not in actual + config = _AutodocConfig( + autodoc_default_options={ + 'members': True, + 'special-members': True, + 'exclude-members': True, + } + ) + actual = do_autodoc('class', 'target.CustomIter', config=config) + assert ' .. py:method:: CustomIter.__init__()' in actual + assert ' Create a new `CustomIter`.' in actual + assert ' .. py:method:: CustomIter.__iter__()' in actual + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' in actual + assert list_of_weak_references in actual + assert ' .. py:method:: CustomIter.snafucate()' in actual + assert ' Makes this snafucated.' in actual + + +def test_autodoc_default_options_with_values() -> None: + if sys.version_info[:3] >= (3, 12, 1): + list_of_weak_references = ' list of weak references to the object' + else: + list_of_weak_references = ' list of weak references to the object (if defined)' # fmt: skip + + # with :members: + config = _AutodocConfig(autodoc_default_options={'members': 'val1,val2'}) + actual = do_autodoc('class', 'target.enums.EnumCls', config=config) + assert ' .. py:attribute:: EnumCls.val1' in actual + assert ' .. py:attribute:: EnumCls.val2' in actual + assert ' .. py:attribute:: EnumCls.val3' not in actual + assert ' .. py:attribute:: EnumCls.val4' not in actual + + # with :member-order: + config = _AutodocConfig( + autodoc_default_options={'members': True, 'member-order': 'bysource'} + ) + actual = do_autodoc('class', 'target.Class', config=config) + assert [line for line in actual if '::' in line] == [ + '.. py:class:: Class(arg)', + ' .. py:method:: Class.meth()', + ' .. py:method:: Class.skipmeth()', + ' .. py:method:: Class.excludemeth()', + ' .. py:attribute:: Class.attr', + ' .. py:attribute:: Class.docattr', + ' .. py:attribute:: Class.udocattr', + ' .. py:attribute:: Class.mdocattr', + ' .. py:method:: Class.moore(a, e, f) -> happiness', + ' .. py:attribute:: Class.inst_attr_inline', + ' .. py:attribute:: Class.inst_attr_comment', + ' .. py:attribute:: Class.inst_attr_string', + ] + + # with :special-members: + config = _AutodocConfig( + autodoc_default_options={'special-members': '__init__,__iter__'} + ) + actual = do_autodoc('class', 'target.CustomIter', config=config) + assert ' .. py:method:: CustomIter.__init__()' in actual + assert ' Create a new `CustomIter`.' in actual + assert ' .. py:method:: CustomIter.__iter__()' in actual + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' not in actual + assert list_of_weak_references not in actual + + # with :exclude-members: + config = _AutodocConfig( + autodoc_default_options={'members': True, 'exclude-members': 'val1'} + ) + actual = do_autodoc('class', 'target.enums.EnumCls', config=config) + assert ' .. py:attribute:: EnumCls.val1' not in actual + assert ' .. py:attribute:: EnumCls.val2' in actual + assert ' .. py:attribute:: EnumCls.val3' in actual + assert ' .. py:attribute:: EnumCls.val4' not in actual + config = _AutodocConfig( + autodoc_default_options={ + 'members': True, + 'special-members': True, + 'exclude-members': '__weakref__,snafucate', + } + ) + actual = do_autodoc('class', 'target.CustomIter', config=config) + assert ' .. py:method:: CustomIter.__init__()' in actual + assert ' Create a new `CustomIter`.' in actual + assert ' .. py:method:: CustomIter.__iter__()' in actual + assert ' Iterate squares of each value.' in actual + if not IS_PYPY: + assert ' .. py:attribute:: CustomIter.__weakref__' not in actual + assert list_of_weak_references not in actual + assert ' .. py:method:: CustomIter.snafucate()' not in actual + assert ' Makes this snafucated.' not in actual diff --git a/tests/test_ext_autodoc/test_ext_autodoc_events.py b/tests/test_ext_autodoc/test_ext_autodoc_events.py new file mode 100644 index 00000000000..7b6b6e679df --- /dev/null +++ b/tests/test_ext_autodoc/test_ext_autodoc_events.py @@ -0,0 +1,171 @@ +"""Test the autodoc extension. This tests mainly for autodoc events""" + +from __future__ import annotations + +from typing import TYPE_CHECKING + +import pytest + +from sphinx.ext.autodoc import between, cut_lines + +from tests.test_ext_autodoc.autodoc_util import FakeEvents, do_autodoc + +if TYPE_CHECKING: + from typing import Any + + from sphinx.application import Sphinx + from sphinx.ext.autodoc._property_types import _AutodocObjType + +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') + + +def test_process_docstring() -> None: + def on_process_docstring( + app: Sphinx, + what: _AutodocObjType, + name: str, + obj: Any, + options: Any, + lines: list[str], + ) -> None: + lines.clear() + lines.append('my docstring') + + events = FakeEvents() + events.connect('autodoc-process-docstring', on_process_docstring) + + actual = do_autodoc('function', 'target.process_docstring.func', events=events) + assert actual == [ + '', + '.. py:function:: func()', + ' :module: target.process_docstring', + '', + ' my docstring', + '', + ] + + +def test_process_docstring_for_nondatadescriptor() -> None: + def on_process_docstring( + app: Sphinx, + what: _AutodocObjType, + name: str, + obj: Any, + options: Any, + lines: list[str], + ) -> None: + raise RuntimeError + + events = FakeEvents() + events.connect('autodoc-process-docstring', on_process_docstring) + + actual = do_autodoc('attribute', 'target.AttCls.a1', events=events) + assert actual == [ + '', + '.. py:attribute:: AttCls.a1', + ' :module: target', + ' :value: hello world', + '', + ] + + +def test_cut_lines() -> None: + events = FakeEvents() + events.connect('autodoc-process-docstring', cut_lines(2, 2, ['function'])) + + actual = do_autodoc('function', 'target.process_docstring.func', events=events) + assert actual == [ + '', + '.. py:function:: func()', + ' :module: target.process_docstring', + '', + ' second line', + '', + ] + + +def test_cut_lines_no_objtype() -> None: + docstring_lines = [ + 'first line', + '---', + 'second line', + '---', + 'third line ', + '', + ] + process = cut_lines(2) + + process(None, 'function', 'func', None, {}, docstring_lines) # type: ignore[arg-type] + assert docstring_lines == [ + 'second line', + '---', + 'third line ', + '', + ] + + +def test_between() -> None: + events = FakeEvents() + events.connect('autodoc-process-docstring', between('---', ['function'])) + + actual = do_autodoc('function', 'target.process_docstring.func', events=events) + assert actual == [ + '', + '.. py:function:: func()', + ' :module: target.process_docstring', + '', + ' second line', + '', + ] + + +def test_between_exclude() -> None: + events = FakeEvents() + events.connect( + 'autodoc-process-docstring', between('---', ['function'], exclude=True) + ) + + actual = do_autodoc('function', 'target.process_docstring.func', events=events) + assert actual == [ + '', + '.. py:function:: func()', + ' :module: target.process_docstring', + '', + ' first line', + ' third line', + '', + ] + + +def test_skip_module_member() -> None: + def autodoc_skip_member( + app: Sphinx, + what: _AutodocObjType, + name: str, + obj: Any, + skip: bool, + options: Any, + ) -> bool | None: + if name == 'Class': + return True # Skip "Class" class in __all__ + elif name == 'raises': + return False # Show "raises()" function (not in __all__) + return None + + events = FakeEvents() + events.connect('autodoc-skip-member', autodoc_skip_member) + + options = {'members': None} + actual = do_autodoc('module', 'target', events=events, options=options) + assert actual == [ + '', + '.. py:module:: target', + '', + # TODO: consider. + # '', + # '.. py:function:: raises(exc, func, *args, **kwds)', + # ' :module: target', + # '', + # ' Raise AssertionError if ``func(*args, **kwds)`` does not raise *exc*.', + # '', + ] diff --git a/tests/test_extensions/test_ext_autodoc_importer.py b/tests/test_ext_autodoc/test_ext_autodoc_importer.py similarity index 83% rename from tests/test_extensions/test_ext_autodoc_importer.py rename to tests/test_ext_autodoc/test_ext_autodoc_importer.py index f14b8256c14..8142af0282d 100644 --- a/tests/test_extensions/test_ext_autodoc_importer.py +++ b/tests/test_ext_autodoc/test_ext_autodoc_importer.py @@ -3,7 +3,7 @@ import sys from pathlib import Path -from sphinx.ext.autodoc.importer import import_module +from sphinx.ext.autodoc._dynamic._importer import _import_module def test_import_native_module_stubs(rootdir: Path) -> None: @@ -11,7 +11,7 @@ def test_import_native_module_stubs(rootdir: Path) -> None: sys_path = list(sys.path) sys.path.insert(0, str(fish_licence_root)) - halibut = import_module('fish_licence.halibut') + halibut = _import_module('fish_licence.halibut') sys.path[:] = sys_path assert halibut.__file__.endswith('halibut.pyi') diff --git a/tests/test_extensions/test_ext_autodoc_mock.py b/tests/test_ext_autodoc/test_ext_autodoc_mock.py similarity index 70% rename from tests/test_extensions/test_ext_autodoc_mock.py rename to tests/test_ext_autodoc/test_ext_autodoc_mock.py index b2a0e917bee..f7264e6fbf0 100644 --- a/tests/test_extensions/test_ext_autodoc_mock.py +++ b/tests/test_ext_autodoc/test_ext_autodoc_mock.py @@ -5,11 +5,17 @@ import abc import sys from importlib import import_module -from typing import TypeVar +from typing import Generic, TypeVar import pytest -from sphinx.ext.autodoc.mock import _MockModule, _MockObject, ismock, mock, undecorate +from sphinx.ext.autodoc._dynamic._mock import ( + _MockModule, + _MockObject, + ismock, + mock, + undecorate, +) def test_MockModule() -> None: @@ -27,7 +33,7 @@ def test_MockModule() -> None: assert repr(mock) == 'mocked_module' -def test_MockObject(): +def test_MockObject() -> None: mock = _MockObject() assert isinstance(mock.some_attr, _MockObject) assert isinstance(mock.some_method, _MockObject) @@ -35,7 +41,7 @@ def test_MockObject(): assert isinstance(mock.attr1.attr2.meth(), _MockObject) # subclassing - class SubClass(mock.SomeClass): + class SubClass(mock.SomeClass): # type: ignore[misc,name-defined] """docstring of SubClass""" def method(self): @@ -50,14 +56,45 @@ def method(self): # parametrized type T = TypeVar('T') - class SubClass2(mock.SomeClass[T]): + class SubClass2(mock.SomeClass[T]): # type: ignore[misc,name-defined] """docstring of SubClass""" - obj2 = SubClass2() + obj2 = SubClass2() # type: ignore[var-annotated] assert SubClass2.__doc__ == 'docstring of SubClass' assert isinstance(obj2, SubClass2) +def test_MockObject_generic() -> None: + mock = _MockObject() + + # parametrized type + T = TypeVar('T') + + # test subclass with typing.Generic + # Creating this class would raise an error on Python 3.11+ + # as mock objects are detected as typevars if hasattr(__typing_subst__) is True. + + assert not hasattr(mock.SomeClass, '__typing_subst__') + S = TypeVar('S') + + class GenericClass(mock.SomeClass, Generic[T, S]): # type: ignore[misc,name-defined] + """docstring of GenericSubclass""" + + obj3 = GenericClass() # type: ignore[var-annotated] + assert isinstance(obj3, _MockObject) + assert isinstance(obj3.some_attr, _MockObject) + assert isinstance(obj3.some_method(), _MockObject) + assert isinstance(obj3.attr1.attr2, _MockObject) + assert isinstance(obj3.attr1.attr2.meth(), _MockObject) + + # check that Generic Subscriptions still works + + class GenericSubclass(GenericClass[mock.MockedClass, S]): # type: ignore[name-defined] + """docstring of GenericSubclass""" + + assert issubclass(GenericSubclass, GenericClass) + + def test_mock() -> None: modname = 'sphinx.unknown' submodule = modname + '.submodule' @@ -94,7 +131,7 @@ class Base: def __init__(self): pass - class Derived(Base, mock.SubClass): + class Derived(Base, mock.SubClass): # ty: ignore[unsupported-base] pass obj = Derived() diff --git a/tests/test_ext_autodoc/test_ext_autodoc_names.py b/tests/test_ext_autodoc/test_ext_autodoc_names.py new file mode 100644 index 00000000000..e2ac9316c84 --- /dev/null +++ b/tests/test_ext_autodoc/test_ext_autodoc_names.py @@ -0,0 +1,100 @@ +"""Test the autodoc extension. This mainly tests name resolution & parsing.""" + +from __future__ import annotations + +import logging + +from sphinx.environment import _CurrentDocument +from sphinx.ext.autodoc._names import _parse_name + +TYPE_CHECKING = False +if TYPE_CHECKING: + from collections.abc import Mapping + from typing import Any + + import pytest + + from sphinx.ext.autodoc._property_types import _AutodocObjType + + +def parse_name( + objtype: _AutodocObjType, + name: str, + *, + current_document: _CurrentDocument | None = None, + ref_context: Mapping[str, str | None] | None = None, +) -> tuple[str, list[str], str | None, str | None] | None: + if current_document is None: + current_document = _CurrentDocument() + if ref_context is None: + ref_context = {} + + parsed = _parse_name( + name=name, + objtype=objtype, + current_document=current_document, + ref_context=ref_context, + ) + if parsed is None: + return None + module_name, parts, args, retann = parsed + return module_name, list(parts), args, retann + + +def test_parse_module_names(caplog: pytest.LogCaptureFixture) -> None: + # work around sphinx.util.logging.setup() + logger = logging.getLogger('sphinx') + logger.handlers[:] = [caplog.handler] + caplog.set_level(logging.WARNING) + + parsed = parse_name('module', 'test_ext_autodoc') + assert parsed == ('test_ext_autodoc', [], None, None) + parsed = parse_name('module', 'test.test_ext_autodoc') + assert parsed == ('test.test_ext_autodoc', [], None, None) + parsed = parse_name('module', 'test(arg)') + assert parsed is None + assert 'signature arguments given for automodule' in caplog.messages[0] + + +def test_parse_function_names() -> None: + parsed = parse_name('function', 'test_ext_autodoc.raises') + assert parsed == ('test_ext_autodoc', ['raises'], None, None) + parsed = parse_name('function', 'test_ext_autodoc.raises(exc) -> None') + assert parsed == ('test_ext_autodoc', ['raises'], '(exc)', 'None') + + +def test_parse_function_names_current_document() -> None: + current_document = _CurrentDocument() + current_document.autodoc_module = 'test_ext_autodoc' + parsed = parse_name('function', 'raises', current_document=current_document) + assert parsed == ('test_ext_autodoc', ['raises'], None, None) + + +def test_parse_function_names_ref_context() -> None: + ref_context: dict[str, Any] = {'py:module': 'test_ext_autodoc'} + parsed = parse_name('function', 'raises', ref_context=ref_context) + assert parsed == ('test_ext_autodoc', ['raises'], None, None) + parsed = parse_name('class', 'Base', ref_context=ref_context) + assert parsed == ('test_ext_autodoc', ['Base'], None, None) + + +def test_parse_name_members() -> None: + # for members + ref_context: dict[str, Any] = {'py:module': 'sphinx.testing.util'} + parsed = parse_name('method', 'SphinxTestApp.cleanup', ref_context=ref_context) + assert parsed == ('sphinx.testing.util', ['SphinxTestApp', 'cleanup'], None, None) + + current_document = _CurrentDocument() + current_document.autodoc_class = 'SphinxTestApp' + ref_context['py:class'] = 'Foo' + parsed = parse_name( + 'method', 'cleanup', current_document=current_document, ref_context=ref_context + ) + assert parsed == ('sphinx.testing.util', ['SphinxTestApp', 'cleanup'], None, None) + parsed = parse_name( + 'method', + 'SphinxTestApp.cleanup', + current_document=current_document, + ref_context=ref_context, + ) + assert parsed == ('sphinx.testing.util', ['SphinxTestApp', 'cleanup'], None, None) diff --git a/tests/test_extensions/test_ext_autodoc_preserve_defaults.py b/tests/test_ext_autodoc/test_ext_autodoc_preserve_defaults.py similarity index 88% rename from tests/test_extensions/test_ext_autodoc_preserve_defaults.py rename to tests/test_ext_autodoc/test_ext_autodoc_preserve_defaults.py index 8fdc7de79d3..6246d6bf2ea 100644 --- a/tests/test_extensions/test_ext_autodoc_preserve_defaults.py +++ b/tests/test_ext_autodoc/test_ext_autodoc_preserve_defaults.py @@ -2,27 +2,25 @@ from __future__ import annotations -from typing import TYPE_CHECKING - import pytest -from tests.test_extensions.autodoc_util import do_autodoc +from sphinx.ext.autodoc._shared import _AutodocConfig + +from tests.test_ext_autodoc.autodoc_util import do_autodoc -if TYPE_CHECKING: - from sphinx.testing.util import SphinxTestApp +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - confoverrides={'autodoc_preserve_defaults': True}, -) -def test_preserve_defaults(app: SphinxTestApp) -> None: +def test_preserve_defaults() -> None: + config = _AutodocConfig(autodoc_preserve_defaults=True) + color = '0xFFFFFF' options = {'members': None} - actual = do_autodoc(app, 'module', 'target.preserve_defaults', options) - assert list(actual) == [ + actual = do_autodoc( + 'module', 'target.preserve_defaults', config=config, options=options + ) + assert actual == [ '', '.. py:module:: target.preserve_defaults', '', @@ -102,15 +100,15 @@ def test_preserve_defaults(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - confoverrides={'autodoc_preserve_defaults': True}, -) -def test_preserve_defaults_special_constructs(app: SphinxTestApp) -> None: +def test_preserve_defaults_special_constructs() -> None: + config = _AutodocConfig(autodoc_preserve_defaults=True) + options = {'members': None} actual = do_autodoc( - app, 'module', 'target.preserve_defaults_special_constructs', options + 'module', + 'target.preserve_defaults_special_constructs', + config=config, + options=options, ) # * dataclasses.dataclass: @@ -127,8 +125,7 @@ def test_preserve_defaults_special_constructs(app: SphinxTestApp) -> None: # In the future, it might be possible to find some additional default # values by parsing the source code of the annotations but the task is # rather complex. - - assert list(actual) == [ + assert actual == [ '', '.. py:module:: target.preserve_defaults_special_constructs', '', diff --git a/tests/test_extensions/test_ext_autodoc_private_members.py b/tests/test_ext_autodoc/test_ext_autodoc_private_members.py similarity index 69% rename from tests/test_extensions/test_ext_autodoc_private_members.py rename to tests/test_ext_autodoc/test_ext_autodoc_private_members.py index 9c144ea40af..b4deb25f60f 100644 --- a/tests/test_extensions/test_ext_autodoc_private_members.py +++ b/tests/test_ext_autodoc/test_ext_autodoc_private_members.py @@ -2,22 +2,20 @@ from __future__ import annotations -from typing import TYPE_CHECKING - import pytest -from tests.test_extensions.autodoc_util import do_autodoc +from sphinx.ext.autodoc._shared import _AutodocConfig + +from tests.test_ext_autodoc.autodoc_util import do_autodoc -if TYPE_CHECKING: - from sphinx.testing.util import SphinxTestApp +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_private_field(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'class' +def test_private_field() -> None: + config = _AutodocConfig(autoclass_content='class') options = {'members': None} - actual = do_autodoc(app, 'module', 'target.private', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.private', config=config, options=options) + assert actual == [ '', '.. py:module:: target.private', '', @@ -39,15 +37,14 @@ def test_private_field(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_private_field_and_private_members(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'class' +def test_private_field_and_private_members() -> None: + config = _AutodocConfig(autoclass_content='class') options = { 'members': None, 'private-members': None, } - actual = do_autodoc(app, 'module', 'target.private', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.private', config=config, options=options) + assert actual == [ '', '.. py:module:: target.private', '', @@ -84,15 +81,14 @@ def test_private_field_and_private_members(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_private_members(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'class' +def test_private_members() -> None: + config = _AutodocConfig(autoclass_content='class') options = { 'members': None, 'private-members': '_PUBLIC_CONSTANT,_public_function', } - actual = do_autodoc(app, 'module', 'target.private', options) - assert list(actual) == [ + actual = do_autodoc('module', 'target.private', config=config, options=options) + assert actual == [ '', '.. py:module:: target.private', '', @@ -114,12 +110,11 @@ def test_private_members(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_private_attributes(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'class' +def test_private_attributes() -> None: + config = _AutodocConfig(autoclass_content='class') options = {'members': None} - actual = do_autodoc(app, 'class', 'target.private.Foo', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.private.Foo', config=config, options=options) + assert actual == [ '', '.. py:class:: Foo()', ' :module: target.private', @@ -136,15 +131,14 @@ def test_private_attributes(app: SphinxTestApp) -> None: ] -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_private_attributes_and_private_members(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'class' +def test_private_attributes_and_private_members() -> None: + config = _AutodocConfig(autoclass_content='class') options = { 'members': None, 'private-members': None, } - actual = do_autodoc(app, 'class', 'target.private.Foo', options) - assert list(actual) == [ + actual = do_autodoc('class', 'target.private.Foo', config=config, options=options) + assert actual == [ '', '.. py:class:: Foo()', ' :module: target.private', diff --git a/tests/test_ext_autodoc/test_ext_autodoc_signatures.py b/tests/test_ext_autodoc/test_ext_autodoc_signatures.py new file mode 100644 index 00000000000..f3f87e4d38a --- /dev/null +++ b/tests/test_ext_autodoc/test_ext_autodoc_signatures.py @@ -0,0 +1,357 @@ +"""Test the autodoc extension. This mainly tests the signature utilities.""" + +from __future__ import annotations + +from typing import Generic, TypeVar + +import pytest + +from sphinx.ext.autodoc._directive_options import _AutoDocumenterOptions +from sphinx.ext.autodoc._dynamic._docstrings import _get_docstring_lines +from sphinx.ext.autodoc._dynamic._signatures import _format_signatures +from sphinx.ext.autodoc._property_types import ( + _ClassDefProperties, + _FunctionDefProperties, +) +from sphinx.ext.autodoc._shared import _AutodocConfig +from sphinx.util.inspect import safe_getattr + +from tests.test_ext_autodoc.autodoc_util import FakeEvents + +TYPE_CHECKING = False +if TYPE_CHECKING: + from typing import Any + + from sphinx.application import Sphinx + from sphinx.events import EventManager + from sphinx.ext.autodoc._property_types import _AutodocObjType + +processed_signatures = [] + + +def format_sig( + obj_type: _AutodocObjType, + name: str, + obj: Any, + *, + config: _AutodocConfig | None = None, + events: EventManager | None = None, + args: str | None = None, + retann: str | None = None, +) -> tuple[str, str] | tuple[()]: + if config is None: + config = _AutodocConfig() + if events is None: + events = FakeEvents() + options = _AutoDocumenterOptions() + + parent = object # dummy + props = _ClassDefProperties( + obj_type=obj_type, # type: ignore[arg-type] + module_name='', + parts=(name,), + docstring_lines=(), + bases=getattr(obj, '__bases__', None), + _obj=obj, + _obj___module__=getattr(obj, '__module__', None), + _obj___qualname__=getattr(obj, '__qualname__', None), + _obj___name__=name, + _obj_bases=(), + _obj_is_new_type=False, + _obj_is_typevar=False, + ) + docstrings = _get_docstring_lines( + props, + class_doc_from=config.autoclass_content, + get_attr=safe_getattr, + inherit_docstrings=config.autodoc_inherit_docstrings, + parent=parent, + tab_width=8, + ) + signatures = _format_signatures( + autodoc_annotations={}, + config=config, + docstrings=docstrings, + events=events, + get_attr=safe_getattr, + options=options, + parent=parent, + props=props, + args=args, + retann=retann, + ) + if not signatures: + return () + assert len(signatures) == 1 + return signatures[0] + + +def _process_signature( + _app: Sphinx, + what: str, + name: str, + _obj: Any, + _options: Any, + _args: str, + _retann: str, +) -> tuple[str | None, str | None] | None: + processed_signatures.append((what, name)) + if name == '.bar': + return '42', None + return None + + +def test_format_module_signatures() -> None: + # no signatures for modules + assert format_sig('module', 'test', None) == () + + +def test_format_function_signatures() -> None: + # test for functions + def f(a, b, c=1, **d): # type: ignore[no-untyped-def] + pass + + def g(a='\n'): # type: ignore[no-untyped-def] + pass + + assert format_sig('function', 'f', f) == ('(a, b, c=1, **d)', '') + assert format_sig('function', 'f', f, args='(a, b, c, d)') == ('(a, b, c, d)', '') + assert format_sig('function', 'g', g) == (r"(a='\n')", '') + + +@pytest.mark.parametrize( + ('params', 'expect'), + [ + ('(a=1)', '(a=1)'), + ('(a: int=1)', '(a: int = 1)'), # auto whitespace formatting + ('(a:list[T] =[], b=None)', '(a: list[T] = [], b=None)'), # idem + ], +) +def test_format_function_signatures_pep695(params: str, expect: str) -> None: + ns: dict[str, Any] = {} + exec(f'def f[T]{params}: pass', ns) # NoQA: S102 + f = ns['f'] + assert format_sig('function', 'f', f) == (expect, '') + assert format_sig('function', 'f', f, args='(...)') == ('(...)', '') + assert format_sig('function', 'f', f, args='(...)', retann='...') == ( + '(...)', + '...', + ) + + exec(f'def f[T]{params} -> list[T]: return []', ns) # NoQA: S102 + f = ns['f'] + assert format_sig('function', 'f', f) == (expect, 'list[T]') + assert format_sig('function', 'f', f, args='(...)') == ('(...)', '') + assert format_sig('function', 'f', f, args='(...)', retann='...') == ( + '(...)', + '...', + ) + + # TODO(picnixz): add more test cases for PEP-695 classes as well (though + # complex cases are less likely to appear and are painful to test). + + +def test_format_class_signatures() -> None: + # test for classes + class D: + pass + + class E: + def __init__(self): # type: ignore[no-untyped-def] + pass + + # an empty init and no init are the same + for C in (D, E): + assert format_sig('class', 'D', C) == ('()', '') + + class SomeMeta(type): + def __call__(cls, a, b=None): # type: ignore[no-untyped-def] + return type.__call__(cls, a, b) + + # these three are all equivalent + class F: + def __init__(self, a, b=None): # type: ignore[no-untyped-def] + pass + + class FNew: + def __new__(cls, a, b=None): # type: ignore[no-untyped-def] # NoQA: ARG004 + return super().__new__(cls) + + class FMeta(metaclass=SomeMeta): + pass + + # and subclasses should always inherit + class G(F): + pass + + class GNew(FNew): + pass + + class GMeta(FMeta): + pass + + # subclasses inherit + assert format_sig('class', 'C', F) == ('(a, b=None)', '') + assert format_sig('class', 'C', FNew) == ('(a, b=None)', '') + assert format_sig('class', 'C', FMeta) == ('(a, b=None)', '') + assert format_sig('class', 'C', G) == ('(a, b=None)', '') + assert format_sig('class', 'C', GNew) == ('(a, b=None)', '') + assert format_sig('class', 'C', GMeta) == ('(a, b=None)', '') + assert format_sig('class', 'C', D, args='(a, b)', retann='X') == ('(a, b)', 'X') + + +def test_format_class_signatures_text_signature() -> None: + class ListSubclass(list): # type: ignore[type-arg] # NoQA: FURB189 + pass + + # only supported if the python implementation decides to document it + if getattr(list, '__text_signature__', None) is not None: + assert format_sig('class', 'C', ListSubclass) == ('(iterable=(), /)', '') + else: + assert format_sig('class', 'C', ListSubclass) == () + + +def test_format_class_signatures_no_text_signature() -> None: + class ExceptionSubclass(Exception): + pass + + # Exception has no __text_signature__ as at Python 3.14 + if getattr(Exception, '__text_signature__', None) is not None: + pytest.xfail('Exception.__text_signature__ exists!') + assert format_sig('class', 'C', ExceptionSubclass) == () + + +def test_format_class_signatures_init_both() -> None: + # __init__ have signature at first line of docstring + config = _AutodocConfig(autoclass_content='both') + + class F2: + """some docstring for F2.""" + + def __init__(self, *args, **kw): # type: ignore[no-untyped-def] + """ + __init__(a1, a2, kw1=True, kw2=False) + + some docstring for __init__. + """ # NoQA: D212 + + class G2(F2): + pass + + assert format_sig('class', 'F2', F2, config=config) == ( + '(a1, a2, kw1=True, kw2=False)', + '', + ) + assert format_sig('class', 'G2', G2, config=config) == ( + '(a1, a2, kw1=True, kw2=False)', + '', + ) + + +def test_format_method_signatures() -> None: + # test for methods + class H: + def foo1(self, b, *c): # type: ignore[no-untyped-def] + pass + + def foo2(b, *c): # type: ignore[no-untyped-def] # NoQA: N805 + pass + + def foo3(self, d='\n'): # type: ignore[no-untyped-def] + pass + + assert format_sig('method', 'H.foo', H.foo1) == ('(b, *c)', '') + assert format_sig('method', 'H.foo', H.foo1, args='(a)') == ('(a)', '') + assert format_sig('method', 'H.foo', H.foo2) == ('(*c)', '') + assert format_sig('method', 'H.foo', H.foo3) == (r"(d='\n')", '') + + # test bound methods interpreted as functions + assert format_sig('function', 'foo', H().foo1) == ('(b, *c)', '') + assert format_sig('function', 'foo', H().foo2) == ('(*c)', '') + assert format_sig('function', 'foo', H().foo3) == (r"(d='\n')", '') + + +def test_format_method_signatures_error_handling() -> None: + # test exception handling (exception is caught and args is '') + config = _AutodocConfig(autodoc_docstring_signature=False) + assert format_sig('function', 'int', int, config=config) == () + + +def test_format_signatures_event_handler() -> None: + events = FakeEvents() + events.connect('autodoc-process-signature', _process_signature) + + class H: + def foo1(self, b, *c): # type: ignore[no-untyped-def] + pass + + # test processing by event handler + assert format_sig('method', 'bar', H.foo1, events=events) == ('42', '') + + +def test_format_functools_partial_signatures() -> None: + # test functions created via functools.partial + from functools import partial + + curried1 = partial(lambda a, b, c: None, 'A') + assert format_sig('function', 'curried1', curried1) == ('(b, c)', '') + curried2 = partial(lambda a, b, c=42: None, 'A') + assert format_sig('function', 'curried2', curried2) == ('(b, c=42)', '') + curried3 = partial(lambda a, b, *c: None, 'A') + assert format_sig('function', 'curried3', curried3) == ('(b, *c)', '') + curried4 = partial(lambda a, b, c=42, *d, **e: None, 'A') + assert format_sig('function', 'curried4', curried4) == ('(b, c=42, *d, **e)', '') + + +def test_autodoc_process_signature_typing_generic() -> None: + T = TypeVar('T') + + class A(Generic[T]): + def __init__(self, a, b=None): # type: ignore[no-untyped-def] + pass + + # Test that typing.Generic's __new__ method does not mask + # the class's __init__ signature. + assert format_sig('class', 'A', A) == ('(a, b=None)', '') + + +def test_autodoc_process_signature_typehints() -> None: + captured = [] + + def process_signature(*args: Any) -> None: + captured.append(args) + + events = FakeEvents() + events.connect('autodoc-process-signature', process_signature) + + def func(x: int, y: int) -> int: # type: ignore[empty-body] + pass + + props = _FunctionDefProperties( + obj_type='function', + module_name='', + parts=('func',), + docstring_lines=(), + _obj=func, + _obj___module__=None, + _obj___qualname__=None, + _obj___name__=None, + properties=frozenset(), + ) + + options = _AutoDocumenterOptions() + _format_signatures( + autodoc_annotations={}, + config=_AutodocConfig(), + docstrings=None, + events=events, + get_attr=safe_getattr, + options=options, + parent=None, + props=props, + ) + + app = events._app + assert captured == [ + (app, 'function', '.func', func, options, '(x: int, y: int)', 'int') + ] diff --git a/tests/test_ext_autodoc/test_ext_autodoc_typehints.py b/tests/test_ext_autodoc/test_ext_autodoc_typehints.py new file mode 100644 index 00000000000..c1d7a7e401b --- /dev/null +++ b/tests/test_ext_autodoc/test_ext_autodoc_typehints.py @@ -0,0 +1,842 @@ +"""Test the autodoc extension.""" + +from __future__ import annotations + +from contextlib import contextmanager +from typing import TYPE_CHECKING + +import pytest + +from sphinx.ext.autodoc._shared import _AutodocConfig +from sphinx.testing import restructuredtext + +from tests.test_ext_autodoc.autodoc_util import do_autodoc + +if TYPE_CHECKING: + from collections.abc import Iterator + from pathlib import Path + + from sphinx.testing.util import SphinxTestApp + +pytestmark = pytest.mark.usefixtures('inject_autodoc_root_into_sys_path') + + +@contextmanager +def overwrite_file(path: Path, content: str) -> Iterator[None]: + current_content = path.read_bytes() if path.exists() else None + try: + path.write_text(content, encoding='utf-8') + yield + finally: + if current_content is not None: + path.write_bytes(current_content) + else: + path.unlink() + + +def test_autodoc_typehints_signature() -> None: + config = _AutodocConfig(autodoc_typehints='signature') + + options = { + 'members': None, + 'undoc-members': None, + } + actual = do_autodoc('module', 'target.typehints', config=config, options=options) + assert actual == [ + '', + '.. py:module:: target.typehints', + '', + '', + '.. py:data:: CONST1', + ' :module: target.typehints', + ' :type: int', + '', + '', + '.. py:data:: CONST2', + ' :module: target.typehints', + ' :type: int', + ' :value: 1', + '', + ' docstring', + '', + '', + '.. py:data:: CONST3', + ' :module: target.typehints', + ' :type: ~pathlib.PurePosixPath', + " :value: PurePosixPath('/a/b/c')", + '', + ' docstring', + '', + '', + '.. py:class:: Math(s: str, o: ~typing.Any = None)', + ' :module: target.typehints', + '', + '', + ' .. py:attribute:: Math.CONST1', + ' :module: target.typehints', + ' :type: int', + '', + '', + ' .. py:attribute:: Math.CONST2', + ' :module: target.typehints', + ' :type: int', + ' :value: 1', + '', + '', + ' .. py:attribute:: Math.CONST3', + ' :module: target.typehints', + ' :type: ~pathlib.PurePosixPath', + " :value: PurePosixPath('/a/b/c')", + '', + '', + ' .. py:method:: Math.decr(a: int, b: int = 1) -> int', + ' :module: target.typehints', + '', + '', + ' .. py:method:: Math.horse(a: str, b: int) -> None', + ' :module: target.typehints', + '', + '', + ' .. py:method:: Math.incr(a: int, b: int = 1) -> int', + ' :module: target.typehints', + '', + '', + ' .. py:method:: Math.nothing() -> None', + ' :module: target.typehints', + '', + '', + ' .. py:property:: Math.path', + ' :module: target.typehints', + ' :type: ~pathlib.PurePosixPath', + '', + '', + ' .. py:property:: Math.prop', + ' :module: target.typehints', + ' :type: int', + '', + '', + '.. py:class:: NewAnnotation(i: int)', + ' :module: target.typehints', + '', + '', + '.. py:class:: NewComment(i: int)', + ' :module: target.typehints', + '', + '', + '.. py:class:: SignatureFromMetaclass(a: int)', + ' :module: target.typehints', + '', + '', + '.. py:class:: T', + ' :module: target.typehints', + '', + ' docstring', + '', + " alias of TypeVar('T', bound=\\ :py:class:`~pathlib.PurePosixPath`)", + '', + '', + '.. py:function:: complex_func(arg1: str, arg2: List[int], arg3: Tuple[int, ' + 'Union[str, Unknown]] = None, *args: str, **kwargs: str) -> None', + ' :module: target.typehints', + '', + '', + '.. py:function:: decr(a: int, b: int = 1) -> int', + ' :module: target.typehints', + '', + '', + '.. py:function:: incr(a: int, b: int = 1) -> int', + ' :module: target.typehints', + '', + '', + '.. py:function:: missing_attr(c, a: str, b: Optional[str] = None) -> str', + ' :module: target.typehints', + '', + '', + '.. py:function:: tuple_args(x: tuple[int, int | str]) -> tuple[int, int]', + ' :module: target.typehints', + '', + ] + + +def test_autodoc_typehints_none() -> None: + config = _AutodocConfig(autodoc_typehints='none') + + options = { + 'members': None, + 'undoc-members': None, + } + actual = do_autodoc('module', 'target.typehints', config=config, options=options) + assert actual == [ + '', + '.. py:module:: target.typehints', + '', + '', + '.. py:data:: CONST1', + ' :module: target.typehints', + '', + '', + '.. py:data:: CONST2', + ' :module: target.typehints', + ' :value: 1', + '', + ' docstring', + '', + '', + '.. py:data:: CONST3', + ' :module: target.typehints', + " :value: PurePosixPath('/a/b/c')", + '', + ' docstring', + '', + '', + '.. py:class:: Math(s, o=None)', + ' :module: target.typehints', + '', + '', + ' .. py:attribute:: Math.CONST1', + ' :module: target.typehints', + '', + '', + ' .. py:attribute:: Math.CONST2', + ' :module: target.typehints', + ' :value: 1', + '', + '', + ' .. py:attribute:: Math.CONST3', + ' :module: target.typehints', + " :value: PurePosixPath('/a/b/c')", + '', + '', + ' .. py:method:: Math.decr(a, b=1)', + ' :module: target.typehints', + '', + '', + ' .. py:method:: Math.horse(a, b)', + ' :module: target.typehints', + '', + '', + ' .. py:method:: Math.incr(a, b=1)', + ' :module: target.typehints', + '', + '', + ' .. py:method:: Math.nothing()', + ' :module: target.typehints', + '', + '', + ' .. py:property:: Math.path', + ' :module: target.typehints', + '', + '', + ' .. py:property:: Math.prop', + ' :module: target.typehints', + '', + '', + '.. py:class:: NewAnnotation(i)', + ' :module: target.typehints', + '', + '', + '.. py:class:: NewComment(i)', + ' :module: target.typehints', + '', + '', + '.. py:class:: SignatureFromMetaclass(a)', + ' :module: target.typehints', + '', + '', + '.. py:class:: T', + ' :module: target.typehints', + '', + ' docstring', + '', + " alias of TypeVar('T', bound=\\ :py:class:`~pathlib.PurePosixPath`)", + '', + '', + '.. py:function:: complex_func(arg1, arg2, arg3=None, *args, **kwargs)', + ' :module: target.typehints', + '', + '', + '.. py:function:: decr(a, b=1)', + ' :module: target.typehints', + '', + '', + '.. py:function:: incr(a, b=1)', + ' :module: target.typehints', + '', + '', + '.. py:function:: missing_attr(c, a, b=None)', + ' :module: target.typehints', + '', + '', + '.. py:function:: tuple_args(x)', + ' :module: target.typehints', + '', + ] + + +def test_autodoc_typehints_none_for_overload() -> None: + config = _AutodocConfig(autodoc_typehints='none') + + options = {'members': None} + actual = do_autodoc('module', 'target.overload', config=config, options=options) + assert actual == [ + '', + '.. py:module:: target.overload', + '', + '', + '.. py:class:: Bar(x, y)', + ' :module: target.overload', + '', + ' docstring', + '', + '', + '.. py:class:: Baz(x, y)', + ' :module: target.overload', + '', + ' docstring', + '', + '', + '.. py:class:: Foo(x, y)', + ' :module: target.overload', + '', + ' docstring', + '', + '', + '.. py:class:: Math()', + ' :module: target.overload', + '', + ' docstring', + '', + '', + ' .. py:method:: Math.sum(x, y=None)', + ' :module: target.overload', + '', + ' docstring', + '', + '', + '.. py:function:: sum(x, y=None)', + ' :module: target.overload', + '', + ' docstring', + '', + ] + + +@pytest.mark.sphinx('text', testroot='ext-autodoc', freshenv=True) +def test_autodoc_typehints_description(app: SphinxTestApp) -> None: + app.config.autodoc_typehints = 'description' + + app.build() + context = (app.outdir / 'index.txt').read_text(encoding='utf8') + expect = '\n'.join(( # NoQA: FLY002 + 'target.typehints.incr(a, b=1)', + '', + ' Parameters:', + ' * **a** (*int*)', + '', + ' * **b** (*int*)', + '', + ' Return type:', + ' int', + '', + )) + assert expect in context + expect = '\n'.join(( # NoQA: FLY002 + 'target.typehints.tuple_args(x)', + '', + ' Parameters:', + ' **x** (*tuple**[**int**, **int** | **str**]*)', + '', + ' Return type:', + ' tuple[int, int]', + '', + )) + assert expect in context + + # Overloads still get displayed in the signature + expect = '\n'.join(( # NoQA: FLY002 + 'target.overload.sum(x: int, y: int = 0) -> int', + 'target.overload.sum(x: float, y: float = 0.0) -> float', + 'target.overload.sum(x: str, y: str = None) -> str', + '', + ' docstring', + '', + )) + assert expect in context + + +@pytest.mark.sphinx('text', testroot='ext-autodoc', copy_test_root=True) +def test_autodoc_typehints_description_no_undoc(app: SphinxTestApp) -> None: + app.config.autodoc_typehints = 'description' + app.config.autodoc_typehints_description_target = 'documented' + + # No :type: or :rtype: will be injected for `incr`, which does not have + # a description for its parameters or its return. `tuple_args` does + # describe them, so :type: and :rtype: will be added. + with overwrite_file( + app.srcdir / 'index.rst', + '.. autofunction:: target.typehints.incr\n' + '\n' + '.. autofunction:: target.typehints.decr\n' + '\n' + ' :returns: decremented number\n' + '\n' + '.. autofunction:: target.typehints.tuple_args\n' + '\n' + ' :param x: arg\n' + ' :return: another tuple\n', + ): + app.build() + # Restore the original content of the file + context = (app.outdir / 'index.txt').read_text(encoding='utf8') + expect = '\n'.join(( # NoQA: FLY002 + 'target.typehints.incr(a, b=1)', + '', + 'target.typehints.decr(a, b=1)', + '', + ' Returns:', + ' decremented number', + '', + ' Return type:', + ' int', + '', + 'target.typehints.tuple_args(x)', + '', + ' Parameters:', + ' **x** (*tuple**[**int**, **int** | **str**]*) -- arg', + '', + ' Returns:', + ' another tuple', + '', + ' Return type:', + ' tuple[int, int]', + '', + )) + assert expect in context + + +@pytest.mark.sphinx('text', testroot='ext-autodoc', copy_test_root=True) +def test_autodoc_typehints_description_no_undoc_doc_rtype(app: SphinxTestApp) -> None: + app.config.autodoc_typehints = 'description' + app.config.autodoc_typehints_description_target = 'documented_params' + + # No :type: will be injected for `incr`, which does not have a description + # for its parameters or its return, just :rtype: will be injected due to + # autodoc_typehints_description_target. `tuple_args` does describe both, so + # :type: and :rtype: will be added. `nothing` has no parameters but a return + # type of None, which will be added. + with overwrite_file( + app.srcdir / 'index.rst', + '.. autofunction:: target.typehints.incr\n' + '\n' + '.. autofunction:: target.typehints.decr\n' + '\n' + ' :returns: decremented number\n' + '\n' + '.. autofunction:: target.typehints.tuple_args\n' + '\n' + ' :param x: arg\n' + ' :return: another tuple\n' + '\n' + '.. autofunction:: target.typehints.Math.nothing\n' + '\n' + '.. autofunction:: target.typehints.Math.horse\n' + '\n' + ' :return: nothing\n', + ): + app.build() + context = (app.outdir / 'index.txt').read_text(encoding='utf8') + assert context == ( + 'target.typehints.incr(a, b=1)\n' + '\n' + ' Return type:\n' + ' int\n' + '\n' + 'target.typehints.decr(a, b=1)\n' + '\n' + ' Returns:\n' + ' decremented number\n' + '\n' + ' Return type:\n' + ' int\n' + '\n' + 'target.typehints.tuple_args(x)\n' + '\n' + ' Parameters:\n' + ' **x** (*tuple**[**int**, **int** | **str**]*) -- arg\n' + '\n' + ' Returns:\n' + ' another tuple\n' + '\n' + ' Return type:\n' + ' tuple[int, int]\n' + '\n' + 'target.typehints.Math.nothing(self)\n' + '\n' + 'target.typehints.Math.horse(self, a, b)\n' + '\n' + ' Returns:\n' + ' nothing\n' + '\n' + ' Return type:\n' + ' None\n' + ) + + +@pytest.mark.sphinx('text', testroot='ext-autodoc', copy_test_root=True) +def test_autodoc_typehints_description_with_documented_init(app: SphinxTestApp) -> None: + app.config.autodoc_typehints = 'description' + + with overwrite_file( + app.srcdir / 'index.rst', + '.. autoclass:: target.typehints._ClassWithDocumentedInit\n' + ' :special-members: __init__\n', + ): + app.build() + context = (app.outdir / 'index.txt').read_text(encoding='utf8') + assert context == ( + 'class target.typehints._ClassWithDocumentedInit(x, *args, **kwargs)\n' + '\n' + ' Class docstring.\n' + '\n' + ' Parameters:\n' + ' * **x** (*int*)\n' + '\n' + ' * **args** (*int*)\n' + '\n' + ' * **kwargs** (*int*)\n' + '\n' + ' __init__(x, *args, **kwargs)\n' + '\n' + ' Init docstring.\n' + '\n' + ' Parameters:\n' + ' * **x** (*int*) -- Some integer\n' + '\n' + ' * **args** (*int*) -- Some integer\n' + '\n' + ' * **kwargs** (*int*) -- Some integer\n' + '\n' + ' Return type:\n' + ' None\n' + ) + + +@pytest.mark.sphinx('text', testroot='ext-autodoc', copy_test_root=True) +def test_autodoc_typehints_description_with_documented_init_no_undoc( + app: SphinxTestApp, +) -> None: + app.config.autodoc_typehints = 'description' + app.config.autodoc_typehints_description_target = 'documented' + + with overwrite_file( + app.srcdir / 'index.rst', + '.. autoclass:: target.typehints._ClassWithDocumentedInit\n' + ' :special-members: __init__\n', + ): + app.build() + context = (app.outdir / 'index.txt').read_text(encoding='utf8') + assert context == ( + 'class target.typehints._ClassWithDocumentedInit(x, *args, **kwargs)\n' + '\n' + ' Class docstring.\n' + '\n' + ' __init__(x, *args, **kwargs)\n' + '\n' + ' Init docstring.\n' + '\n' + ' Parameters:\n' + ' * **x** (*int*) -- Some integer\n' + '\n' + ' * **args** (*int*) -- Some integer\n' + '\n' + ' * **kwargs** (*int*) -- Some integer\n' + ) + + +@pytest.mark.sphinx('text', testroot='ext-autodoc', copy_test_root=True) +def test_autodoc_typehints_description_with_documented_init_no_undoc_doc_rtype( + app: SphinxTestApp, +) -> None: + app.config.autodoc_typehints = 'description' + app.config.autodoc_typehints_description_target = 'documented_params' + + # see test_autodoc_typehints_description_with_documented_init_no_undoc + # returnvalue_and_documented_params should not change class or method + # docstring. + with overwrite_file( + app.srcdir / 'index.rst', + '.. autoclass:: target.typehints._ClassWithDocumentedInit\n' + ' :special-members: __init__\n', + ): + app.build() + context = (app.outdir / 'index.txt').read_text(encoding='utf8') + assert context == ( + 'class target.typehints._ClassWithDocumentedInit(x, *args, **kwargs)\n' + '\n' + ' Class docstring.\n' + '\n' + ' __init__(x, *args, **kwargs)\n' + '\n' + ' Init docstring.\n' + '\n' + ' Parameters:\n' + ' * **x** (*int*) -- Some integer\n' + '\n' + ' * **args** (*int*) -- Some integer\n' + '\n' + ' * **kwargs** (*int*) -- Some integer\n' + ) + + +@pytest.mark.sphinx('text', testroot='ext-autodoc') +def test_autodoc_typehints_description_for_invalid_node(app: SphinxTestApp) -> None: + app.config.autodoc_typehints = 'description' + + text = '.. py:function:: hello; world' + restructuredtext.parse(app, text) # raises no error + + +@pytest.mark.sphinx('text', testroot='ext-autodoc', copy_test_root=True) +def test_autodoc_typehints_both(app: SphinxTestApp) -> None: + app.config.autodoc_typehints = 'both' + + with overwrite_file( + app.srcdir / 'index.rst', + '.. autofunction:: target.typehints.incr\n' + '\n' + '.. autofunction:: target.typehints.tuple_args\n' + '\n' + '.. autofunction:: target.overload.sum\n', + ): + app.build() + context = (app.outdir / 'index.txt').read_text(encoding='utf8') + expect = '\n'.join(( # NoQA: FLY002 + 'target.typehints.incr(a: int, b: int = 1) -> int', + '', + ' Parameters:', + ' * **a** (*int*)', + '', + ' * **b** (*int*)', + '', + ' Return type:', + ' int', + '', + )) + assert expect in context + expect = '\n'.join(( # NoQA: FLY002 + 'target.typehints.tuple_args(x: tuple[int, int | str]) -> tuple[int, int]', + '', + ' Parameters:', + ' **x** (*tuple**[**int**, **int** | **str**]*)', + '', + ' Return type:', + ' tuple[int, int]', + '', + )) + assert expect in context + + # Overloads still get displayed in the signature + expect = '\n'.join(( # NoQA: FLY002 + 'target.overload.sum(x: int, y: int = 0) -> int', + 'target.overload.sum(x: float, y: float = 0.0) -> float', + 'target.overload.sum(x: str, y: str = None) -> str', + '', + ' docstring', + '', + )) + assert expect in context + + +@pytest.mark.sphinx('text', testroot='ext-autodoc', copy_test_root=True) +def test_autodoc_typehints_description_and_type_aliases(app: SphinxTestApp) -> None: + app.config.autodoc_typehints = 'description' + app.config.autodoc_type_aliases = {'myint': 'myint'} + + with overwrite_file( + app.srcdir / 'autodoc_type_aliases.rst', + '.. autofunction:: target.autodoc_type_aliases.sum', + ): + app.build() + context = (app.outdir / 'autodoc_type_aliases.txt').read_text(encoding='utf8') + assert context == ( + 'target.autodoc_type_aliases.sum(x, y)\n' + '\n' + ' docstring\n' + '\n' + ' Parameters:\n' + ' * **x** (*myint*)\n' + '\n' + ' * **y** (*myint*)\n' + '\n' + ' Return type:\n' + ' myint\n' + ) + + +def test_autodoc_typehints_format_fully_qualified() -> None: + config = _AutodocConfig(autodoc_typehints_format='fully-qualified') + + options = { + 'members': None, + 'undoc-members': None, + } + actual = do_autodoc('module', 'target.typehints', config=config, options=options) + assert actual == [ + '', + '.. py:module:: target.typehints', + '', + '', + '.. py:data:: CONST1', + ' :module: target.typehints', + ' :type: int', + '', + '', + '.. py:data:: CONST2', + ' :module: target.typehints', + ' :type: int', + ' :value: 1', + '', + ' docstring', + '', + '', + '.. py:data:: CONST3', + ' :module: target.typehints', + ' :type: pathlib.PurePosixPath', + " :value: PurePosixPath('/a/b/c')", + '', + ' docstring', + '', + '', + '.. py:class:: Math(s: str, o: typing.Any = None)', + ' :module: target.typehints', + '', + '', + ' .. py:attribute:: Math.CONST1', + ' :module: target.typehints', + ' :type: int', + '', + '', + ' .. py:attribute:: Math.CONST2', + ' :module: target.typehints', + ' :type: int', + ' :value: 1', + '', + '', + ' .. py:attribute:: Math.CONST3', + ' :module: target.typehints', + ' :type: pathlib.PurePosixPath', + " :value: PurePosixPath('/a/b/c')", + '', + '', + ' .. py:method:: Math.decr(a: int, b: int = 1) -> int', + ' :module: target.typehints', + '', + '', + ' .. py:method:: Math.horse(a: str, b: int) -> None', + ' :module: target.typehints', + '', + '', + ' .. py:method:: Math.incr(a: int, b: int = 1) -> int', + ' :module: target.typehints', + '', + '', + ' .. py:method:: Math.nothing() -> None', + ' :module: target.typehints', + '', + '', + ' .. py:property:: Math.path', + ' :module: target.typehints', + ' :type: pathlib.PurePosixPath', + '', + '', + ' .. py:property:: Math.prop', + ' :module: target.typehints', + ' :type: int', + '', + '', + '.. py:class:: NewAnnotation(i: int)', + ' :module: target.typehints', + '', + '', + '.. py:class:: NewComment(i: int)', + ' :module: target.typehints', + '', + '', + '.. py:class:: SignatureFromMetaclass(a: int)', + ' :module: target.typehints', + '', + '', + '.. py:class:: T', + ' :module: target.typehints', + '', + ' docstring', + '', + " alias of TypeVar('T', bound=\\ :py:class:`pathlib.PurePosixPath`)", + '', + '', + '.. py:function:: complex_func(arg1: str, arg2: List[int], arg3: Tuple[int, ' + 'Union[str, Unknown]] = None, *args: str, **kwargs: str) -> None', + ' :module: target.typehints', + '', + '', + '.. py:function:: decr(a: int, b: int = 1) -> int', + ' :module: target.typehints', + '', + '', + '.. py:function:: incr(a: int, b: int = 1) -> int', + ' :module: target.typehints', + '', + '', + '.. py:function:: missing_attr(c, a: str, b: Optional[str] = None) -> str', + ' :module: target.typehints', + '', + '', + '.. py:function:: tuple_args(x: tuple[int, int | str]) -> tuple[int, int]', + ' :module: target.typehints', + '', + ] + + +def test_autodoc_typehints_format_fully_qualified_for_class_alias() -> None: + config = _AutodocConfig(autodoc_typehints_format='fully-qualified') + + actual = do_autodoc('class', 'target.classes.Alias', config=config) + assert actual == [ + '', + '.. py:attribute:: Alias', + ' :module: target.classes', + '', + ' alias of :py:class:`target.classes.Foo`', + ] + + +def test_autodoc_typehints_format_fully_qualified_for_generic_alias() -> None: + config = _AutodocConfig(autodoc_typehints_format='fully-qualified') + + actual = do_autodoc('data', 'target.genericalias.L', config=config) + assert actual == [ + '', + '.. py:data:: L', + ' :module: target.genericalias', + '', + ' A list of Class', + '', + ' alias of :py:class:`~typing.List`\\ [:py:class:`target.genericalias.Class`]', + '', + ] + + +def test_autodoc_typehints_format_fully_qualified_for_newtype_alias() -> None: + config = _AutodocConfig(autodoc_typehints_format='fully-qualified') + + actual = do_autodoc('class', 'target.typevar.T6', config=config) + assert actual == [ + '', + '.. py:class:: T6', + ' :module: target.typevar', + '', + ' T6', + '', + ' alias of :py:class:`datetime.date`', + '', + ] diff --git a/tests/test_ext_autosummary/__init__.py b/tests/test_ext_autosummary/__init__.py new file mode 100644 index 00000000000..e69de29bb2d diff --git a/tests/test_extensions/test_ext_autosummary.py b/tests/test_ext_autosummary/test_ext_autosummary.py similarity index 94% rename from tests/test_extensions/test_ext_autosummary.py rename to tests/test_ext_autosummary/test_ext_autosummary.py index c807ddba3d1..af4ce87c22f 100644 --- a/tests/test_extensions/test_ext_autosummary.py +++ b/tests/test_ext_autosummary/test_ext_autosummary.py @@ -26,7 +26,8 @@ ) from sphinx.ext.autosummary.generate import main as autogen_main from sphinx.testing.util import assert_node, etree_parse -from sphinx.util.docutils import new_document + +from tests.utils import extract_node if TYPE_CHECKING: from xml.etree.ElementTree import Element @@ -86,7 +87,6 @@ def test_extract_summary(capsys): pep_reference=False, rfc_reference=False, ) - document = new_document('', settings) # normal case doc = [ @@ -95,52 +95,52 @@ def test_extract_summary(capsys): '', 'Second block is here', ] - assert extract_summary(doc, document) == 'This is a first sentence.' + assert extract_summary(doc, settings) == 'This is a first sentence.' # inliner case doc = [ 'This sentence contains *emphasis text having dots.*,', 'it does not break sentence.', ] - assert extract_summary(doc, document) == ' '.join(doc) + assert extract_summary(doc, settings) == ' '.join(doc) # abbreviations doc = ['Blabla, i.e. bla.'] - assert extract_summary(doc, document) == ' '.join(doc) + assert extract_summary(doc, settings) == ' '.join(doc) doc = ['Blabla, (i.e. bla).'] - assert extract_summary(doc, document) == ' '.join(doc) + assert extract_summary(doc, settings) == ' '.join(doc) doc = ['Blabla, e.g. bla.'] - assert extract_summary(doc, document) == ' '.join(doc) + assert extract_summary(doc, settings) == ' '.join(doc) doc = ['Blabla, (e.g. bla).'] - assert extract_summary(doc, document) == ' '.join(doc) + assert extract_summary(doc, settings) == ' '.join(doc) doc = ['Blabla, et al. bla.'] - assert extract_summary(doc, document) == ' '.join(doc) + assert extract_summary(doc, settings) == ' '.join(doc) # literal doc = ['blah blah::'] - assert extract_summary(doc, document) == 'blah blah.' + assert extract_summary(doc, settings) == 'blah blah.' # heading doc = [ 'blah blah', '=========', ] - assert extract_summary(doc, document) == 'blah blah' + assert extract_summary(doc, settings) == 'blah blah' doc = [ '=========', 'blah blah', '=========', ] - assert extract_summary(doc, document) == 'blah blah' + assert extract_summary(doc, settings) == 'blah blah' # hyperlink target doc = ['Do `this `_ and that. blah blah blah.'] - extracted = extract_summary(doc, document) + extracted = extract_summary(doc, settings) assert extracted == 'Do `this `_ and that.' _, err = capsys.readouterr() @@ -155,11 +155,9 @@ def test_extract_summary(capsys): ) def test_get_items_summary(make_app, app_params): import sphinx.ext.autosummary - import sphinx.ext.autosummary.generate args, kwargs = app_params app = make_app(*args, **kwargs) - sphinx.ext.autosummary.generate.setup_documenters(app) # monkey-patch Autosummary.get_items so we can easily get access to it's # results.. orig_get_items = sphinx.ext.autosummary.Autosummary.get_items @@ -257,7 +255,6 @@ def test_autosummary_generate_content_for_module(app): {}, config=app.config, events=app.events, - registry=app.registry, ) assert template.render.call_args[0][0] == 'module' @@ -304,7 +301,7 @@ def test_autosummary_generate_content_for_module(app): @pytest.mark.sphinx('html', testroot='ext-autosummary', copy_test_root=True) def test_autosummary_generate_content_for_module___all__(app): - import autosummary_dummy_module + import autosummary_dummy_module # ty: ignore[unresolved-import] template = Mock() app.config.autosummary_ignore_module_all = False @@ -320,7 +317,6 @@ def test_autosummary_generate_content_for_module___all__(app): {}, config=app.config, events=app.events, - registry=app.registry, ) assert template.render.call_args[0][0] == 'module' @@ -351,7 +347,7 @@ def test_autosummary_generate_content_for_module___all__(app): @pytest.mark.sphinx('html', testroot='ext-autosummary', copy_test_root=True) def test_autosummary_generate_content_for_module_skipped(app): - import autosummary_dummy_module + import autosummary_dummy_module # ty: ignore[unresolved-import] template = Mock() @@ -372,7 +368,6 @@ def skip_member(app, what, name, obj, skip, options): {}, config=app.config, events=app.events, - registry=app.registry, ) context = template.render.call_args[0][1] assert context['members'] == [ @@ -399,7 +394,7 @@ def skip_member(app, what, name, obj, skip, options): @pytest.mark.sphinx('html', testroot='ext-autosummary', copy_test_root=True) def test_autosummary_generate_content_for_module_imported_members(app): - import autosummary_dummy_module + import autosummary_dummy_module # ty: ignore[unresolved-import] template = Mock() @@ -414,7 +409,6 @@ def test_autosummary_generate_content_for_module_imported_members(app): {}, config=app.config, events=app.events, - registry=app.registry, ) assert template.render.call_args[0][0] == 'module' @@ -486,7 +480,6 @@ def test_autosummary_generate_content_for_module_imported_members_inherited_modu {}, config=app.config, events=app.events, - registry=app.registry, ) assert template.render.call_args[0][0] == 'module' @@ -557,23 +550,31 @@ def test_autosummary_generate(app): ), ], ) - assert_node(doctree[4][0], addnodes.toctree, caption='An autosummary') + assert_node(extract_node(doctree, 4, 0), addnodes.toctree, caption='An autosummary') - assert len(doctree[3][0][0][2]) == 8 - assert doctree[3][0][0][2][0].astext() == 'autosummary_dummy_module\n\n' - assert doctree[3][0][0][2][1].astext() == 'autosummary_dummy_module.Foo()\n\n' - assert doctree[3][0][0][2][2].astext() == 'autosummary_dummy_module.Foo.Bar()\n\n' - assert doctree[3][0][0][2][3].astext() == ( + assert len(extract_node(doctree, 3, 0, 0, 2)) == 8 + assert extract_node(doctree, 3, 0, 0, 2, 0).astext() == ( + 'autosummary_dummy_module\n\n' + ) + assert extract_node(doctree, 3, 0, 0, 2, 1).astext() == ( + 'autosummary_dummy_module.Foo()\n\n' + ) + assert extract_node(doctree, 3, 0, 0, 2, 2).astext() == ( + 'autosummary_dummy_module.Foo.Bar()\n\n' + ) + assert extract_node(doctree, 3, 0, 0, 2, 3).astext() == ( 'autosummary_dummy_module.Foo.value\n\ndocstring' ) - assert doctree[3][0][0][2][4].astext() == 'autosummary_dummy_module.bar(x[, y])\n\n' - assert doctree[3][0][0][2][5].astext() == ( + assert extract_node(doctree, 3, 0, 0, 2, 4).astext() == ( + 'autosummary_dummy_module.bar(x[, y])\n\n' + ) + assert extract_node(doctree, 3, 0, 0, 2, 5).astext() == ( 'autosummary_dummy_module.qux\n\na module-level attribute' ) - assert doctree[3][0][0][2][6].astext() == ( + assert extract_node(doctree, 3, 0, 0, 2, 6).astext() == ( 'autosummary_dummy_inherited_module.InheritedAttrClass()\n\n' ) - assert doctree[3][0][0][2][7].astext() == ( + assert extract_node(doctree, 3, 0, 0, 2, 7).astext() == ( 'autosummary_dummy_inherited_module.InheritedAttrClass.subclassattr\n\nother docstring' ) diff --git a/tests/test_extensions/test_ext_autosummary_imports.py b/tests/test_ext_autosummary/test_ext_autosummary_imports.py similarity index 91% rename from tests/test_extensions/test_ext_autosummary_imports.py rename to tests/test_ext_autosummary/test_ext_autosummary_imports.py index 29a738f2e1b..7999e71e137 100644 --- a/tests/test_extensions/test_ext_autosummary_imports.py +++ b/tests/test_ext_autosummary/test_ext_autosummary_imports.py @@ -11,13 +11,15 @@ from sphinx.ext.autosummary import autosummary_table from sphinx.testing.util import assert_node +from tests.utils import extract_node + if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp @pytest.mark.sphinx('dummy', testroot='ext-autosummary-import_cycle') @pytest.mark.usefixtures('rollback_sysmodules') -def test_autosummary_import_cycle(app): +def test_autosummary_import_cycle(app: SphinxTestApp) -> None: app.build() doctree = app.env.get_doctree('index') @@ -47,11 +49,11 @@ def test_autosummary_import_cycle(app): ), ) assert_node( - doctree[4][0][0][2][0], + extract_node(doctree, 4, 0, 0, 2, 0), ([nodes.entry, nodes.paragraph, (nodes.reference, nodes.Text)], nodes.entry), ) assert_node( - doctree[4][0][0][2][0][0][0][0], + extract_node(doctree, 4, 0, 0, 2, 0, 0, 0, 0), nodes.reference, refid='spam.eggs.Ham', reftitle='spam.eggs.Ham', diff --git a/tests/test_ext_imgconverter/__init__.py b/tests/test_ext_imgconverter/__init__.py new file mode 100644 index 00000000000..e69de29bb2d diff --git a/tests/test_extensions/test_ext_imgconverter.py b/tests/test_ext_imgconverter/test_ext_imgconverter.py similarity index 96% rename from tests/test_extensions/test_ext_imgconverter.py rename to tests/test_ext_imgconverter/test_ext_imgconverter.py index a2078f9fe11..c39f885e97e 100644 --- a/tests/test_extensions/test_ext_imgconverter.py +++ b/tests/test_ext_imgconverter/test_ext_imgconverter.py @@ -12,7 +12,7 @@ @pytest.fixture -def _if_converter_found(app): +def _if_converter_found(app: SphinxTestApp) -> None: image_converter = getattr(app.config, 'image_converter', '') try: if image_converter: diff --git a/tests/test_extensions/test_ext_imgmockconverter.py b/tests/test_ext_imgconverter/test_ext_imgmockconverter.py similarity index 100% rename from tests/test_extensions/test_ext_imgmockconverter.py rename to tests/test_ext_imgconverter/test_ext_imgmockconverter.py diff --git a/tests/test_ext_intersphinx/__init__.py b/tests/test_ext_intersphinx/__init__.py new file mode 100644 index 00000000000..e69de29bb2d diff --git a/tests/test_extensions/test_ext_intersphinx.py b/tests/test_ext_intersphinx/test_ext_intersphinx.py similarity index 91% rename from tests/test_extensions/test_ext_intersphinx.py rename to tests/test_ext_intersphinx/test_ext_intersphinx.py index c2b17d36a78..5fcfe4d9260 100644 --- a/tests/test_extensions/test_ext_intersphinx.py +++ b/tests/test_ext_intersphinx/test_ext_intersphinx.py @@ -18,10 +18,12 @@ from sphinx.ext.intersphinx import setup as intersphinx_setup from sphinx.ext.intersphinx._cli import inspect_main from sphinx.ext.intersphinx._load import ( - _fetch_inventory, + _display_failures, + _fetch_inventory_data, _fetch_inventory_group, _get_safe_url, _InvConfig, + _load_inventory, _strip_basic_auth, load_mappings, validate_intersphinx_mapping, @@ -34,6 +36,7 @@ INVENTORY_V2, INVENTORY_V2_AMBIGUOUS_TERMS, INVENTORY_V2_NO_VERSION, + INVENTORY_V2_TEXT_VERSION, ) from tests.utils import http_server @@ -85,12 +88,15 @@ def test_fetch_inventory_redirection(get_request, InventoryFile, app): # same uri and inv, not redirected mocked_get.url = 'https://hostname/' + INVENTORY_FILENAME - _fetch_inventory( - target_uri='https://hostname/', + target_uri = 'https://hostname/' + raw_data, target_uri = _fetch_inventory_data( + target_uri=target_uri, inv_location='https://hostname/' + INVENTORY_FILENAME, config=_InvConfig.from_config(app.config), srcdir=app.srcdir, + cache_path=None, ) + _load_inventory(raw_data, target_uri=target_uri) assert 'intersphinx inventory has moved' not in app.status.getvalue() assert InventoryFile.loads.call_args[1]['uri'] == 'https://hostname/' @@ -99,12 +105,15 @@ def test_fetch_inventory_redirection(get_request, InventoryFile, app): app.status.truncate(0) mocked_get.url = 'https://hostname/new/' + INVENTORY_FILENAME - _fetch_inventory( - target_uri='https://hostname/', + target_uri = 'https://hostname/' + raw_data, target_uri = _fetch_inventory_data( + target_uri=target_uri, inv_location='https://hostname/' + INVENTORY_FILENAME, config=_InvConfig.from_config(app.config), srcdir=app.srcdir, + cache_path=None, ) + _load_inventory(raw_data, target_uri=target_uri) assert app.status.getvalue() == ( 'intersphinx inventory has moved: ' 'https://hostname/%s -> https://hostname/new/%s\n' @@ -117,12 +126,15 @@ def test_fetch_inventory_redirection(get_request, InventoryFile, app): app.status.truncate(0) mocked_get.url = 'https://hostname/new/' + INVENTORY_FILENAME - _fetch_inventory( - target_uri='https://hostname/', + target_uri = 'https://hostname/' + raw_data, target_uri = _fetch_inventory_data( + target_uri=target_uri, inv_location='https://hostname/new/' + INVENTORY_FILENAME, config=_InvConfig.from_config(app.config), srcdir=app.srcdir, + cache_path=None, ) + _load_inventory(raw_data, target_uri=target_uri) assert 'intersphinx inventory has moved' not in app.status.getvalue() assert InventoryFile.loads.call_args[1]['uri'] == 'https://hostname/' @@ -131,12 +143,15 @@ def test_fetch_inventory_redirection(get_request, InventoryFile, app): app.status.truncate(0) mocked_get.url = 'https://hostname/other/' + INVENTORY_FILENAME - _fetch_inventory( - target_uri='https://hostname/', + target_uri = 'https://hostname/' + raw_data, target_uri = _fetch_inventory_data( + target_uri=target_uri, inv_location='https://hostname/new/' + INVENTORY_FILENAME, config=_InvConfig.from_config(app.config), srcdir=app.srcdir, + cache_path=None, ) + _load_inventory(raw_data, target_uri=target_uri) assert app.status.getvalue() == ( 'intersphinx inventory has moved: ' 'https://hostname/new/%s -> https://hostname/other/%s\n' @@ -774,13 +789,16 @@ def test_intersphinx_cache_limit(app, monkeypatch, cache_limit, expected_expired now = 2 * 86400 monkeypatch.setattr('time.time', lambda: now) - # `_fetch_inventory_group` calls `_fetch_inventory`. + # `_fetch_inventory_group` calls `_fetch_inventory_data`. # We replace it with a mock to test whether it has been called. # If it has been called, it means the cache had expired. - mock_fake_inventory = _Inventory({}) # must be truthy - mock_fetch_inventory = mock.Mock(return_value=mock_fake_inventory) monkeypatch.setattr( - 'sphinx.ext.intersphinx._load._fetch_inventory', mock_fetch_inventory + 'sphinx.ext.intersphinx._load._fetch_inventory_data', + mock.Mock(return_value=(b'', '')), + ) + mock_fetch_inventory = mock.Mock(return_value=_Inventory({})) + monkeypatch.setattr( + 'sphinx.ext.intersphinx._load._load_inventory', mock_fetch_inventory ) for name, (uri, locations) in app.config.intersphinx_mapping.values(): @@ -791,8 +809,9 @@ def test_intersphinx_cache_limit(app, monkeypatch, cache_limit, expected_expired now=now, config=_InvConfig.from_config(app.config), srcdir=app.srcdir, + cache_dir=None, ) - # If we hadn't mocked `_fetch_inventory`, it would've made + # If we hadn't mocked `_fetch_inventory_data`, it would've made # a request to `https://example.org/` and found no inventory # file. That would've been an error, and `updated` would've been # False even if the cache had expired. The mock makes it behave @@ -826,8 +845,14 @@ def log_message(*args, **kwargs): } now = int(time.time()) - # we can use 'srcdir=None' since we are raising in _fetch_inventory - kwds = {'cache': {}, 'now': now, 'config': config, 'srcdir': None} + # we can use 'srcdir=None' since we are raising in _fetch_inventory_data + kwds = { + 'cache': {}, + 'now': now, + 'config': config, + 'srcdir': None, + 'cache_dir': None, + } # We need an exception with its 'args' attribute set (see error # handling in sphinx.ext.intersphinx._load._fetch_inventory_group). side_effect = ValueError('') @@ -836,7 +861,8 @@ def log_message(*args, **kwargs): name='1', target_uri=url1, locations=(url1, None) ) with mock.patch( - 'sphinx.ext.intersphinx._load._fetch_inventory', side_effect=side_effect + 'sphinx.ext.intersphinx._load._fetch_inventory_data', + side_effect=side_effect, ) as mockfn: assert not _fetch_inventory_group(project=project1, **kwds) mockfn.assert_any_call( @@ -844,19 +870,22 @@ def log_message(*args, **kwargs): inv_location=url1, config=config, srcdir=None, + cache_path=None, ) mockfn.assert_any_call( target_uri=url1, inv_location=url1 + '/' + INVENTORY_FILENAME, config=config, srcdir=None, + cache_path=None, ) project2 = _IntersphinxProject( name='2', target_uri=url2, locations=(url2, None) ) with mock.patch( - 'sphinx.ext.intersphinx._load._fetch_inventory', side_effect=side_effect + 'sphinx.ext.intersphinx._load._fetch_inventory_data', + side_effect=side_effect, ) as mockfn: assert not _fetch_inventory_group(project=project2, **kwds) mockfn.assert_any_call( @@ -864,10 +893,53 @@ def log_message(*args, **kwargs): inv_location=url2, config=config, srcdir=None, + cache_path=None, ) mockfn.assert_any_call( target_uri=url2, inv_location=url2 + INVENTORY_FILENAME, config=config, srcdir=None, + cache_path=None, ) + + +@pytest.mark.sphinx('html', testroot='root') +def test_inventory_text_version(tmp_path, app): + inv_file = tmp_path / 'inventory' + inv_file.write_bytes(INVENTORY_V2_TEXT_VERSION) + set_config( + app, + { + 'python': ('https://docs.python.org/', str(inv_file)), + }, + ) + + # load the inventory and check if non-numeric version is handled correctly + validate_intersphinx_mapping(app, app.config) + load_mappings(app) + + rn = reference_check(app, 'py', 'mod', 'module1', 'foo') + assert isinstance(rn, nodes.reference) + assert rn['refuri'] == 'https://docs.python.org/foo.html#module-module1' + assert rn['reftitle'] == '(in foo stable)' + assert rn[0].astext() == 'Long Module desc' + + +def test_display_failures(): + failures_args = [ + ('Failed to fetch %s from %s', 'inventory', 'http://example.com'), + ('Timeout after %d seconds',), # Only one argument + ( + 'intersphinx inventory has moved:', + 'http://example.com', + 'http://proxyhost.net', + ), # No '%' + ] + issues = _display_failures(failures_args) + assert 'Failed to fetch inventory from http://example.com' in issues + assert 'Timeout after %d seconds' in issues + assert ( + 'intersphinx inventory has moved: - http://example.com - http://proxyhost.net' + in issues + ) diff --git a/tests/test_extensions/test_ext_intersphinx_cache.py b/tests/test_ext_intersphinx/test_ext_intersphinx_cache.py similarity index 93% rename from tests/test_extensions/test_ext_intersphinx_cache.py rename to tests/test_ext_intersphinx/test_ext_intersphinx_cache.py index b2e52a5b180..72fb35148b3 100644 --- a/tests/test_extensions/test_ext_intersphinx_cache.py +++ b/tests/test_ext_intersphinx/test_ext_intersphinx_cache.py @@ -4,6 +4,7 @@ import posixpath import re +import shutil import zlib from http.server import BaseHTTPRequestHandler from io import BytesIO @@ -17,8 +18,8 @@ if TYPE_CHECKING: from collections.abc import Iterable - from typing import BinaryIO - + from pathlib import Path + from typing import Any, BinaryIO BASE_CONFIG = { 'extensions': ['sphinx.ext.intersphinx'], @@ -197,7 +198,7 @@ def make_inventory_handler( assert all(p.port == port for p in projects) class InventoryHandler(BaseHTTPRequestHandler): - def do_GET(self): + def do_GET(self) -> None: self.send_response(200, 'OK') data = b'' @@ -212,7 +213,7 @@ def do_GET(self): self.end_headers() self.wfile.write(data) - def log_message(*args, **kwargs): + def log_message(*args: Any, **kwargs: Any) -> None: pass return InventoryHandler @@ -224,7 +225,7 @@ def test_intersphinx_project_fixture() -> None: assert project.url == 'http://localhost:9341/route' -def test_load_mappings_cache(tmp_path): +def test_load_mappings_cache(tmp_path: Path) -> None: tmp_path.joinpath('conf.py').touch() tmp_path.joinpath('index.rst').touch() project = SingleEntryProject(1, 'a') @@ -242,13 +243,13 @@ def test_load_mappings_cache(tmp_path): item = dict((project.normalise(entry),)) inventories = InventoryAdapter(app.env) assert list(inventories.cache) == ['http://localhost:9341/a'] - e_name, e_time, e_inv = inventories.cache['http://localhost:9341/a'] + e_name, _e_time, e_inv = inventories.cache['http://localhost:9341/a'] assert e_name == 'spam' assert e_inv == {'py:module': item} assert inventories.named_inventory == {'spam': {'py:module': item}} -def test_load_mappings_cache_update(tmp_path): +def test_load_mappings_cache_update(tmp_path: Path) -> None: tmp_path.joinpath('conf.py').touch() tmp_path.joinpath('index.rst').touch() old_project = SingleEntryProject(1337, 'old') @@ -261,25 +262,27 @@ def test_load_mappings_cache_update(tmp_path): app1 = SphinxTestApp('dummy', srcdir=tmp_path, confoverrides=confoverrides1) app1.build() app1.cleanup() + shutil.rmtree(app1.doctreedir / '__intersphinx_cache__', ignore_errors=True) # switch to new url and assert that the old URL is no more stored confoverrides2 = BASE_CONFIG | {'intersphinx_mapping': new_project.record} app2 = SphinxTestApp('dummy', srcdir=tmp_path, confoverrides=confoverrides2) app2.build() app2.cleanup() + shutil.rmtree(app2.doctreedir / '__intersphinx_cache__', ignore_errors=True) entry = new_project.make_entry() item = dict((new_project.normalise(entry),)) inventories = InventoryAdapter(app2.env) # check that the URLs were changed accordingly assert list(inventories.cache) == ['http://localhost:9341/new'] - e_name, e_time, e_inv = inventories.cache['http://localhost:9341/new'] + e_name, _e_time, e_inv = inventories.cache['http://localhost:9341/new'] assert e_name == 'spam' assert e_inv == {'py:module': item} assert inventories.named_inventory == {'spam': {'py:module': item}} -def test_load_mappings_cache_revert_update(tmp_path): +def test_load_mappings_cache_revert_update(tmp_path: Path) -> None: tmp_path.joinpath('conf.py').touch() tmp_path.joinpath('index.rst').touch() old_project = SingleEntryProject(1337, 'old') @@ -310,7 +313,7 @@ def test_load_mappings_cache_revert_update(tmp_path): inventories = InventoryAdapter(app3.env) # check that the URLs were changed accordingly assert list(inventories.cache) == ['http://localhost:9341/old'] - e_name, e_time, e_inv = inventories.cache['http://localhost:9341/old'] + e_name, _e_time, e_inv = inventories.cache['http://localhost:9341/old'] assert e_name == 'spam' assert e_inv == {'py:module': item} assert inventories.named_inventory == {'spam': {'py:module': item}} diff --git a/tests/test_ext_napoleon/__init__.py b/tests/test_ext_napoleon/__init__.py new file mode 100644 index 00000000000..e69de29bb2d diff --git a/tests/test_extensions/ext_napoleon_pep526_data_google.py b/tests/test_ext_napoleon/pep526_data_google.py similarity index 100% rename from tests/test_extensions/ext_napoleon_pep526_data_google.py rename to tests/test_ext_napoleon/pep526_data_google.py diff --git a/tests/test_extensions/ext_napoleon_pep526_data_numpy.py b/tests/test_ext_napoleon/pep526_data_numpy.py similarity index 100% rename from tests/test_extensions/ext_napoleon_pep526_data_numpy.py rename to tests/test_ext_napoleon/pep526_data_numpy.py diff --git a/tests/test_extensions/test_ext_napoleon.py b/tests/test_ext_napoleon/test_ext_napoleon.py similarity index 79% rename from tests/test_extensions/test_ext_napoleon.py rename to tests/test_ext_napoleon/test_ext_napoleon.py index 87a8bf5a9ef..8e609137b52 100644 --- a/tests/test_extensions/test_ext_napoleon.py +++ b/tests/test_ext_napoleon/test_ext_napoleon.py @@ -11,69 +11,75 @@ from sphinx.application import Sphinx from sphinx.ext.napoleon import Config, _process_docstring, _skip_member, setup +TYPE_CHECKING = False +if TYPE_CHECKING: + from collections.abc import Callable -def simple_decorator(f): + from sphinx.ext.autodoc._property_types import _AutodocObjType + + +def simple_decorator[**P, R](f: Callable[P, R]) -> Callable[P, R]: """A simple decorator that does nothing, for tests to use.""" @functools.wraps(f) - def wrapper(*args, **kwargs): + def wrapper(*args: P.args, **kwargs: P.kwargs) -> R: return f(*args, **kwargs) return wrapper -def _private_doc(): +def _private_doc() -> None: """module._private_doc.DOCSTRING""" pass -def _private_undoc(): +def _private_undoc() -> None: pass -def __special_doc__(): # NoQA: N807 +def __special_doc__() -> None: # NoQA: N807 """module.__special_doc__.DOCSTRING""" pass -def __special_undoc__(): # NoQA: N807 +def __special_undoc__() -> None: # NoQA: N807 pass class SampleClass: - def _private_doc(self): + def _private_doc(self) -> None: """SampleClass._private_doc.DOCSTRING""" pass - def _private_undoc(self): + def _private_undoc(self) -> None: pass - def __special_doc__(self): # NoQA: PLW3201 + def __special_doc__(self) -> None: # NoQA: PLW3201 """SampleClass.__special_doc__.DOCSTRING""" pass - def __special_undoc__(self): # NoQA: PLW3201 + def __special_undoc__(self) -> None: # NoQA: PLW3201 pass @simple_decorator - def __decorated_func__(self): # NoQA: PLW3201 + def __decorated_func__(self) -> None: # NoQA: PLW3201 """Doc""" pass class SampleError(Exception): - def _private_doc(self): + def _private_doc(self) -> None: """SampleError._private_doc.DOCSTRING""" pass - def _private_undoc(self): + def _private_undoc(self) -> None: pass - def __special_doc__(self): # NoQA: PLW3201 + def __special_doc__(self) -> None: # NoQA: PLW3201 """SampleError.__special_doc__.DOCSTRING""" pass - def __special_undoc__(self): # NoQA: PLW3201 + def __special_undoc__(self) -> None: # NoQA: PLW3201 pass @@ -81,7 +87,7 @@ def __special_undoc__(self): # NoQA: PLW3201 class TestProcessDocstring: - def test_modify_in_place(self): + def test_modify_in_place(self) -> None: lines = [ 'Summary line.', '', @@ -109,10 +115,10 @@ def test_modify_in_place(self): class TestSetup: - def test_unknown_app_type(self): + def test_unknown_app_type(self) -> None: setup(object()) # type: ignore[arg-type] - def test_add_config_values(self): + def test_add_config_values(self) -> None: app = mock.Mock(Sphinx) setup(app) for name, _default, _rebuild, _types in Config._config_values: @@ -143,7 +149,7 @@ def test_add_config_values(self): class TestSkipMember: def assert_skip( self, - what: str, + what: _AutodocObjType, member: str, obj: object, expect_default_skip: bool, @@ -160,7 +166,7 @@ def assert_skip( setattr(app.config, config_name, False) assert None is _skip_member(app, what, member, obj, skip, mock.Mock()) - def test_namedtuple(self): + def test_namedtuple(self) -> None: # Since python 3.7, namedtuple._asdict() has not been documented # because there is no way to check the method is a member of the # namedtuple class. This testcase confirms only it does not @@ -174,7 +180,7 @@ def test_namedtuple(self): 'napoleon_include_private_with_doc', ) - def test_class_private_doc(self): + def test_class_private_doc(self) -> None: self.assert_skip( 'class', '_private_doc', @@ -183,7 +189,7 @@ def test_class_private_doc(self): 'napoleon_include_private_with_doc', ) - def test_class_private_undoc(self): + def test_class_private_undoc(self) -> None: self.assert_skip( 'class', '_private_undoc', @@ -192,7 +198,7 @@ def test_class_private_undoc(self): 'napoleon_include_private_with_doc', ) - def test_class_special_doc(self): + def test_class_special_doc(self) -> None: self.assert_skip( 'class', '__special_doc__', @@ -201,7 +207,7 @@ def test_class_special_doc(self): 'napoleon_include_special_with_doc', ) - def test_class_special_undoc(self): + def test_class_special_undoc(self) -> None: self.assert_skip( 'class', '__special_undoc__', @@ -210,7 +216,7 @@ def test_class_special_undoc(self): 'napoleon_include_special_with_doc', ) - def test_class_decorated_doc(self): + def test_class_decorated_doc(self) -> None: self.assert_skip( 'class', '__decorated_func__', @@ -219,7 +225,7 @@ def test_class_decorated_doc(self): 'napoleon_include_special_with_doc', ) - def test_exception_private_doc(self): + def test_exception_private_doc(self) -> None: self.assert_skip( 'exception', '_private_doc', @@ -228,7 +234,7 @@ def test_exception_private_doc(self): 'napoleon_include_private_with_doc', ) - def test_exception_private_undoc(self): + def test_exception_private_undoc(self) -> None: self.assert_skip( 'exception', '_private_undoc', @@ -237,7 +243,7 @@ def test_exception_private_undoc(self): 'napoleon_include_private_with_doc', ) - def test_exception_special_doc(self): + def test_exception_special_doc(self) -> None: self.assert_skip( 'exception', '__special_doc__', @@ -246,7 +252,7 @@ def test_exception_special_doc(self): 'napoleon_include_special_with_doc', ) - def test_exception_special_undoc(self): + def test_exception_special_undoc(self) -> None: self.assert_skip( 'exception', '__special_undoc__', @@ -255,7 +261,7 @@ def test_exception_special_undoc(self): 'napoleon_include_special_with_doc', ) - def test_module_private_doc(self): + def test_module_private_doc(self) -> None: self.assert_skip( 'module', '_private_doc', @@ -264,7 +270,7 @@ def test_module_private_doc(self): 'napoleon_include_private_with_doc', ) - def test_module_private_undoc(self): + def test_module_private_undoc(self) -> None: self.assert_skip( 'module', '_private_undoc', @@ -273,7 +279,7 @@ def test_module_private_undoc(self): 'napoleon_include_private_with_doc', ) - def test_module_special_doc(self): + def test_module_special_doc(self) -> None: self.assert_skip( 'module', '__special_doc__', @@ -282,7 +288,7 @@ def test_module_special_doc(self): 'napoleon_include_special_with_doc', ) - def test_module_special_undoc(self): + def test_module_special_undoc(self) -> None: self.assert_skip( 'module', '__special_undoc__', diff --git a/tests/test_extensions/test_ext_napoleon_docstring.py b/tests/test_ext_napoleon/test_ext_napoleon_docstring.py similarity index 99% rename from tests/test_extensions/test_ext_napoleon_docstring.py rename to tests/test_ext_napoleon/test_ext_napoleon_docstring.py index a6e9820e5c9..f894be526df 100644 --- a/tests/test_extensions/test_ext_napoleon_docstring.py +++ b/tests/test_ext_napoleon/test_ext_napoleon_docstring.py @@ -8,6 +8,7 @@ from inspect import cleandoc from itertools import product from textwrap import dedent +from types import SimpleNamespace from typing import TYPE_CHECKING from unittest import mock @@ -25,8 +26,8 @@ ) from sphinx.testing.util import etree_parse -from tests.test_extensions.ext_napoleon_pep526_data_google import PEP526GoogleClass -from tests.test_extensions.ext_napoleon_pep526_data_numpy import PEP526NumpyClass +from tests.test_ext_napoleon.pep526_data_google import PEP526GoogleClass +from tests.test_ext_napoleon.pep526_data_numpy import PEP526NumpyClass if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp @@ -1238,7 +1239,7 @@ def test_custom_generic_sections(self): actual = GoogleDocstring(docstring, test_config) assert str(actual) == expected - def test_noindex(self): + def test_no_index(self): docstring = """ Attributes: arg @@ -1267,7 +1268,7 @@ def test_noindex(self): config=config, app=None, what='module', - options={'no-index': True}, + options=SimpleNamespace(no_index=True), ) assert str(actual) == expected @@ -1861,7 +1862,7 @@ def test_underscore_in_attribute_strip_signature_backslash(self): """ config = Config(napoleon_use_ivar=True) - config.strip_signature_backslash = True + config.strip_signature_backslash = True # ty: ignore[unresolved-attribute] app = mock.Mock() actual = NumpyDocstring(docstring, config, app, 'class') diff --git a/tests/test_extensions/autodoc_util.py b/tests/test_extensions/autodoc_util.py deleted file mode 100644 index 3d08c739300..00000000000 --- a/tests/test_extensions/autodoc_util.py +++ /dev/null @@ -1,34 +0,0 @@ -from __future__ import annotations - -from typing import TYPE_CHECKING -from unittest.mock import Mock - -# NEVER import those objects from sphinx.ext.autodoc directly -from sphinx.ext.autodoc.directive import DocumenterBridge, process_documenter_options -from sphinx.util.docutils import LoggingReporter - -if TYPE_CHECKING: - from typing import Any - - from docutils.statemachine import StringList - - from sphinx.application import Sphinx - - -def do_autodoc( - app: Sphinx, - objtype: str, - name: str, - options: dict[str, Any] | None = None, -) -> StringList: - options = {} if options is None else options.copy() - if not app.env.current_document.docname: - app.env.current_document.docname = 'index' # set dummy docname - doccls = app.registry.documenters[objtype] - docoptions = process_documenter_options(doccls, app.config, options) - state = Mock() - state.document.settings.tab_width = 8 - bridge = DocumenterBridge(app.env, LoggingReporter(''), docoptions, 1, state) - documenter = doccls(bridge, name) - documenter.generate() - return bridge.result diff --git a/tests/test_extensions/test_ext_apidoc.py b/tests/test_extensions/test_ext_apidoc.py index a9742337013..0052a4740bb 100644 --- a/tests/test_extensions/test_ext_apidoc.py +++ b/tests/test_extensions/test_ext_apidoc.py @@ -752,7 +752,7 @@ def test_no_duplicates(rootdir, tmp_path): sphinx.ext.apidoc._generate.PY_SUFFIXES = original_suffixes -def test_remove_old_files(tmp_path: Path): +def test_remove_old_files(tmp_path: Path) -> None: """Test that old files are removed when using the -r option. Also ensure that pre-existing files are not re-written, if unchanged. diff --git a/tests/test_extensions/test_ext_autodoc_autoattribute.py b/tests/test_extensions/test_ext_autodoc_autoattribute.py deleted file mode 100644 index 878f5b6e31b..00000000000 --- a/tests/test_extensions/test_ext_autodoc_autoattribute.py +++ /dev/null @@ -1,183 +0,0 @@ -"""Test the autodoc extension. - -This tests mainly the Documenters; the auto directives are tested in a test -source file translated by test_build. -""" - -from __future__ import annotations - -from typing import TYPE_CHECKING - -import pytest - -from tests.test_extensions.autodoc_util import do_autodoc - -if TYPE_CHECKING: - from sphinx.testing.util import SphinxTestApp - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.Class.attr') - assert list(actual) == [ - '', - '.. py:attribute:: Class.attr', - ' :module: target', - " :value: 'bar'", - '', - ' should be documented -- süß', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_novalue(app: SphinxTestApp) -> None: - options = {'no-value': None} - actual = do_autodoc(app, 'attribute', 'target.Class.attr', options) - assert list(actual) == [ - '', - '.. py:attribute:: Class.attr', - ' :module: target', - '', - ' should be documented -- süß', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_typed_variable(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.typed_vars.Class.attr2') - assert list(actual) == [ - '', - '.. py:attribute:: Class.attr2', - ' :module: target.typed_vars', - ' :type: int', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_typed_variable_in_alias(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.typed_vars.Alias.attr2') - assert list(actual) == [ - '', - '.. py:attribute:: Alias.attr2', - ' :module: target.typed_vars', - ' :type: int', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_instance_variable(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.typed_vars.Class.attr4') - assert list(actual) == [ - '', - '.. py:attribute:: Class.attr4', - ' :module: target.typed_vars', - ' :type: int', - '', - ' attr4', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_instance_variable_in_alias(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.typed_vars.Alias.attr4') - assert list(actual) == [ - '', - '.. py:attribute:: Alias.attr4', - ' :module: target.typed_vars', - ' :type: int', - '', - ' attr4', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_instance_variable_without_comment(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.instance_variable.Bar.attr4') - assert list(actual) == [ - '', - '.. py:attribute:: Bar.attr4', - ' :module: target.instance_variable', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_slots_variable_list(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.slots.Foo.attr') - assert list(actual) == [ - '', - '.. py:attribute:: Foo.attr', - ' :module: target.slots', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_slots_variable_dict(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.slots.Bar.attr1') - assert list(actual) == [ - '', - '.. py:attribute:: Bar.attr1', - ' :module: target.slots', - ' :type: int', - '', - ' docstring of attr1', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_slots_variable_str(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.slots.Baz.attr') - assert list(actual) == [ - '', - '.. py:attribute:: Baz.attr', - ' :module: target.slots', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_GenericAlias(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.genericalias.Class.T') - assert list(actual) == [ - '', - '.. py:attribute:: Class.T', - ' :module: target.genericalias', - '', - ' A list of int', - '', - ' alias of :py:class:`~typing.List`\\ [:py:class:`int`]', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoattribute_hide_value(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'attribute', 'target.hide_value.Foo.SENTINEL1') - assert list(actual) == [ - '', - '.. py:attribute:: Foo.SENTINEL1', - ' :module: target.hide_value', - '', - ' docstring', - '', - ' :meta hide-value:', - '', - ] - - actual = do_autodoc(app, 'attribute', 'target.hide_value.Foo.SENTINEL2') - assert list(actual) == [ - '', - '.. py:attribute:: Foo.SENTINEL2', - ' :module: target.hide_value', - '', - ' :meta hide-value:', - '', - ] diff --git a/tests/test_extensions/test_ext_autodoc_autodata.py b/tests/test_extensions/test_ext_autodoc_autodata.py deleted file mode 100644 index 1474d70dc56..00000000000 --- a/tests/test_extensions/test_ext_autodoc_autodata.py +++ /dev/null @@ -1,115 +0,0 @@ -"""Test the autodoc extension. - -This tests mainly the Documenters; the auto directives are tested in a test -source file translated by test_build. -""" - -from __future__ import annotations - -from typing import TYPE_CHECKING - -import pytest - -from sphinx.testing.util import SphinxTestApp - -from tests.test_extensions.autodoc_util import do_autodoc - -if TYPE_CHECKING: - from sphinx.testing.util import SphinxTestApp - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodata(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'data', 'target.integer') - assert list(actual) == [ - '', - '.. py:data:: integer', - ' :module: target', - ' :value: 1', - '', - ' documentation for the integer', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodata_novalue(app: SphinxTestApp) -> None: - options = {'no-value': None} - actual = do_autodoc(app, 'data', 'target.integer', options) - assert list(actual) == [ - '', - '.. py:data:: integer', - ' :module: target', - '', - ' documentation for the integer', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodata_typed_variable(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'data', 'target.typed_vars.attr2') - assert list(actual) == [ - '', - '.. py:data:: attr2', - ' :module: target.typed_vars', - ' :type: str', - '', - ' attr2', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodata_type_comment(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'data', 'target.typed_vars.attr3') - assert list(actual) == [ - '', - '.. py:data:: attr3', - ' :module: target.typed_vars', - ' :type: str', - " :value: ''", - '', - ' attr3', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodata_GenericAlias(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'data', 'target.genericalias.T') - assert list(actual) == [ - '', - '.. py:data:: T', - ' :module: target.genericalias', - '', - ' A list of int', - '', - ' alias of :py:class:`~typing.List`\\ [:py:class:`int`]', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodata_hide_value(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'data', 'target.hide_value.SENTINEL1') - assert list(actual) == [ - '', - '.. py:data:: SENTINEL1', - ' :module: target.hide_value', - '', - ' docstring', - '', - ' :meta hide-value:', - '', - ] - - actual = do_autodoc(app, 'data', 'target.hide_value.SENTINEL2') - assert list(actual) == [ - '', - '.. py:data:: SENTINEL2', - ' :module: target.hide_value', - '', - ' :meta hide-value:', - '', - ] diff --git a/tests/test_extensions/test_ext_autodoc_autofunction.py b/tests/test_extensions/test_ext_autodoc_autofunction.py deleted file mode 100644 index 946d051d570..00000000000 --- a/tests/test_extensions/test_ext_autodoc_autofunction.py +++ /dev/null @@ -1,221 +0,0 @@ -"""Test the autodoc extension. - -This tests mainly the Documenters; the auto directives are tested in a test -source file translated by test_build. -""" - -from __future__ import annotations - -from typing import TYPE_CHECKING - -if TYPE_CHECKING: - from typing import Any - - from sphinx.testing.util import SphinxTestApp - -import pytest - -from tests.test_extensions.autodoc_util import do_autodoc - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_classes(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.classes.Foo') - assert list(actual) == [ - '', - '.. py:function:: Foo()', - ' :module: target.classes', - '', - ] - - actual = do_autodoc(app, 'function', 'target.classes.Bar') - assert list(actual) == [ - '', - '.. py:function:: Bar(x, y)', - ' :module: target.classes', - '', - ] - - actual = do_autodoc(app, 'function', 'target.classes.Baz') - assert list(actual) == [ - '', - '.. py:function:: Baz(x, y)', - ' :module: target.classes', - '', - ] - - actual = do_autodoc(app, 'function', 'target.classes.Qux') - assert list(actual) == [ - '', - '.. py:function:: Qux(foo, bar)', - ' :module: target.classes', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_callable(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.callable.function') - assert list(actual) == [ - '', - '.. py:function:: function(arg1, arg2, **kwargs)', - ' :module: target.callable', - '', - ' A callable object that behaves like a function.', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_method(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.callable.method') - assert list(actual) == [ - '', - '.. py:function:: method(arg1, arg2)', - ' :module: target.callable', - '', - ' docstring of Callable.method().', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_builtin_function(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'os.umask') - assert list(actual) == [ - '', - '.. py:function:: umask(mask, /)', - ' :module: os', - '', - ' Set the current numeric umask and return the previous umask.', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_methoddescriptor(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'builtins.int.__add__') - assert list(actual) == [ - '', - '.. py:function:: __add__(self, value, /)', - ' :module: builtins.int', - '', - ' Return self+value.', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_decorated(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.decorator.foo') - assert list(actual) == [ - '', - '.. py:function:: foo(name=None, age=None)', - ' :module: target.decorator', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_singledispatch(app: SphinxTestApp) -> None: - options: dict[str, Any] = {} - actual = do_autodoc(app, 'function', 'target.singledispatch.func', options) - assert list(actual) == [ - '', - '.. py:function:: func(arg, kwarg=None)', - ' func(arg: float, kwarg=None)', - ' func(arg: int, kwarg=None)', - ' func(arg: str, kwarg=None)', - ' func(arg: dict, kwarg=None)', - ' :module: target.singledispatch', - '', - ' A function for general use.', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_cfunction(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'time.asctime') - assert list(actual) == [ - '', - '.. py:function:: asctime([tuple]) -> string', - ' :module: time', - '', - " Convert a time tuple to a string, e.g. 'Sat Jun 06 16:26:11 1998'.", - ' When the time tuple is not present, current time as returned by localtime()', - ' is used.', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_wrapped_function(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.wrappedfunction.slow_function') - assert list(actual) == [ - '', - '.. py:function:: slow_function(message, timeout)', - ' :module: target.wrappedfunction', - '', - ' This function is slow.', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_wrapped_function_contextmanager(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.wrappedfunction.feeling_good') - assert list(actual) == [ - '', - '.. py:function:: feeling_good(x: int, y: int) -> ~typing.Generator', - ' :module: target.wrappedfunction', - '', - " You'll feel better in this context!", - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_coroutine(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.functions.coroutinefunc') - assert list(actual) == [ - '', - '.. py:function:: coroutinefunc()', - ' :module: target.functions', - ' :async:', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_synchronized_coroutine(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.coroutine.sync_func') - assert list(actual) == [ - '', - '.. py:function:: sync_func()', - ' :module: target.coroutine', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_async_generator(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.functions.asyncgenerator') - assert list(actual) == [ - '', - '.. py:function:: asyncgenerator()', - ' :module: target.functions', - ' :async:', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_slice_function_arg(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'function', 'target.functions.slice_arg_func') - assert list(actual) == [ - '', - '.. py:function:: slice_arg_func(arg: float64[:, :])', - ' :module: target.functions', - '', - ] diff --git a/tests/test_extensions/test_ext_autodoc_autoproperty.py b/tests/test_extensions/test_ext_autodoc_autoproperty.py deleted file mode 100644 index 6698d4c8fc2..00000000000 --- a/tests/test_extensions/test_ext_autodoc_autoproperty.py +++ /dev/null @@ -1,104 +0,0 @@ -"""Test the autodoc extension. - -This tests mainly the Documenters; the auto directives are tested in a test -source file translated by test_build. -""" - -from __future__ import annotations - -from typing import TYPE_CHECKING - -import pytest - -from tests.test_extensions.autodoc_util import do_autodoc - -if TYPE_CHECKING: - from sphinx.testing.util import SphinxTestApp - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_properties(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'property', 'target.properties.Foo.prop1') - assert list(actual) == [ - '', - '.. py:property:: Foo.prop1', - ' :module: target.properties', - ' :type: int', - '', - ' docstring', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_class_properties(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'property', 'target.properties.Foo.prop2') - assert list(actual) == [ - '', - '.. py:property:: Foo.prop2', - ' :module: target.properties', - ' :classmethod:', - ' :type: int', - '', - ' docstring', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_properties_with_type_comment(app: SphinxTestApp) -> None: - actual = do_autodoc( - app, 'property', 'target.properties.Foo.prop1_with_type_comment' - ) - assert list(actual) == [ - '', - '.. py:property:: Foo.prop1_with_type_comment', - ' :module: target.properties', - ' :type: int', - '', - ' docstring', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_class_properties_with_type_comment(app: SphinxTestApp) -> None: - actual = do_autodoc( - app, 'property', 'target.properties.Foo.prop2_with_type_comment' - ) - assert list(actual) == [ - '', - '.. py:property:: Foo.prop2_with_type_comment', - ' :module: target.properties', - ' :classmethod:', - ' :type: int', - '', - ' docstring', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_cached_properties(app: SphinxTestApp) -> None: - actual = do_autodoc(app, 'property', 'target.cached_property.Foo.prop') - assert list(actual) == [ - '', - '.. py:property:: Foo.prop', - ' :module: target.cached_property', - ' :type: int', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_cached_properties_with_type_comment(app: SphinxTestApp) -> None: - actual = do_autodoc( - app, 'property', 'target.cached_property.Foo.prop_with_type_comment' - ) - assert list(actual) == [ - '', - '.. py:property:: Foo.prop_with_type_comment', - ' :module: target.cached_property', - ' :type: int', - '', - ] diff --git a/tests/test_extensions/test_ext_autodoc_configs.py b/tests/test_extensions/test_ext_autodoc_configs.py deleted file mode 100644 index ab7539190e0..00000000000 --- a/tests/test_extensions/test_ext_autodoc_configs.py +++ /dev/null @@ -1,1862 +0,0 @@ -"""Test the autodoc extension. This tests mainly for config variables""" - -from __future__ import annotations - -import platform -import sys -from contextlib import contextmanager -from typing import TYPE_CHECKING - -import pytest - -from sphinx.testing import restructuredtext - -from tests.test_extensions.autodoc_util import do_autodoc - -if TYPE_CHECKING: - from collections.abc import Iterator - from pathlib import Path - - from sphinx.testing.util import SphinxTestApp - -IS_PYPY = platform.python_implementation() == 'PyPy' - - -@contextmanager -def overwrite_file(path: Path, content: str) -> Iterator[None]: - current_content = path.read_bytes() if path.exists() else None - try: - path.write_text(content, encoding='utf-8') - yield - finally: - if current_content is not None: - path.write_bytes(current_content) - else: - path.unlink() - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoclass_content_class(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'class' - options = {'members': None} - actual = do_autodoc(app, 'module', 'target.autoclass_content', options) - assert list(actual) == [ - '', - '.. py:module:: target.autoclass_content', - '', - '', - '.. py:class:: A()', - ' :module: target.autoclass_content', - '', - ' A class having no __init__, no __new__', - '', - '', - '.. py:class:: B()', - ' :module: target.autoclass_content', - '', - ' A class having __init__(no docstring), no __new__', - '', - '', - '.. py:class:: C()', - ' :module: target.autoclass_content', - '', - ' A class having __init__, no __new__', - '', - '', - '.. py:class:: D()', - ' :module: target.autoclass_content', - '', - ' A class having no __init__, __new__(no docstring)', - '', - '', - '.. py:class:: E()', - ' :module: target.autoclass_content', - '', - ' A class having no __init__, __new__', - '', - '', - '.. py:class:: F()', - ' :module: target.autoclass_content', - '', - ' A class having both __init__ and __new__', - '', - '', - '.. py:class:: G()', - ' :module: target.autoclass_content', - '', - ' A class inherits __init__ without docstring.', - '', - '', - '.. py:class:: H()', - ' :module: target.autoclass_content', - '', - ' A class inherits __new__ without docstring.', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoclass_content_init(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'init' - options = {'members': None} - actual = do_autodoc(app, 'module', 'target.autoclass_content', options) - assert list(actual) == [ - '', - '.. py:module:: target.autoclass_content', - '', - '', - '.. py:class:: A()', - ' :module: target.autoclass_content', - '', - ' A class having no __init__, no __new__', - '', - '', - '.. py:class:: B()', - ' :module: target.autoclass_content', - '', - ' A class having __init__(no docstring), no __new__', - '', - '', - '.. py:class:: C()', - ' :module: target.autoclass_content', - '', - ' __init__ docstring', - '', - '', - '.. py:class:: D()', - ' :module: target.autoclass_content', - '', - ' A class having no __init__, __new__(no docstring)', - '', - '', - '.. py:class:: E()', - ' :module: target.autoclass_content', - '', - ' __new__ docstring', - '', - '', - '.. py:class:: F()', - ' :module: target.autoclass_content', - '', - ' __init__ docstring', - '', - '', - '.. py:class:: G()', - ' :module: target.autoclass_content', - '', - ' __init__ docstring', - '', - '', - '.. py:class:: H()', - ' :module: target.autoclass_content', - '', - ' __new__ docstring', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_class_signature_mixed(app: SphinxTestApp) -> None: - app.config.autodoc_class_signature = 'mixed' - options = { - 'members': None, - 'undoc-members': None, - } - actual = do_autodoc(app, 'class', 'target.classes.Bar', options) - assert list(actual) == [ - '', - '.. py:class:: Bar(x, y)', - ' :module: target.classes', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_class_signature_separated_init(app: SphinxTestApp) -> None: - app.config.autodoc_class_signature = 'separated' - options = { - 'members': None, - 'undoc-members': None, - } - actual = do_autodoc(app, 'class', 'target.classes.Bar', options) - assert list(actual) == [ - '', - '.. py:class:: Bar', - ' :module: target.classes', - '', - '', - ' .. py:method:: Bar.__init__(x, y)', - ' :module: target.classes', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_class_signature_separated_new(app: SphinxTestApp) -> None: - app.config.autodoc_class_signature = 'separated' - options = { - 'members': None, - 'undoc-members': None, - } - actual = do_autodoc(app, 'class', 'target.classes.Baz', options) - assert list(actual) == [ - '', - '.. py:class:: Baz', - ' :module: target.classes', - '', - '', - ' .. py:method:: Baz.__new__(cls, x, y)', - ' :module: target.classes', - ' :staticmethod:', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoclass_content_both(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'both' - options = {'members': None} - actual = do_autodoc(app, 'module', 'target.autoclass_content', options) - assert list(actual) == [ - '', - '.. py:module:: target.autoclass_content', - '', - '', - '.. py:class:: A()', - ' :module: target.autoclass_content', - '', - ' A class having no __init__, no __new__', - '', - '', - '.. py:class:: B()', - ' :module: target.autoclass_content', - '', - ' A class having __init__(no docstring), no __new__', - '', - '', - '.. py:class:: C()', - ' :module: target.autoclass_content', - '', - ' A class having __init__, no __new__', - '', - ' __init__ docstring', - '', - '', - '.. py:class:: D()', - ' :module: target.autoclass_content', - '', - ' A class having no __init__, __new__(no docstring)', - '', - '', - '.. py:class:: E()', - ' :module: target.autoclass_content', - '', - ' A class having no __init__, __new__', - '', - ' __new__ docstring', - '', - '', - '.. py:class:: F()', - ' :module: target.autoclass_content', - '', - ' A class having both __init__ and __new__', - '', - ' __init__ docstring', - '', - '', - '.. py:class:: G()', - ' :module: target.autoclass_content', - '', - ' A class inherits __init__ without docstring.', - '', - ' __init__ docstring', - '', - '', - '.. py:class:: H()', - ' :module: target.autoclass_content', - '', - ' A class inherits __new__ without docstring.', - '', - ' __new__ docstring', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_inherit_docstrings(app: SphinxTestApp) -> None: - assert app.config.autodoc_inherit_docstrings is True # default - actual = do_autodoc(app, 'method', 'target.inheritance.Derived.inheritedmeth') - assert list(actual) == [ - '', - '.. py:method:: Derived.inheritedmeth()', - ' :module: target.inheritance', - '', - ' Inherited function.', - '', - ] - - # disable autodoc_inherit_docstrings - app.config.autodoc_inherit_docstrings = False - actual = do_autodoc(app, 'method', 'target.inheritance.Derived.inheritedmeth') - assert list(actual) == [ - '', - '.. py:method:: Derived.inheritedmeth()', - ' :module: target.inheritance', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_inherit_docstrings_for_inherited_members(app: SphinxTestApp) -> None: - options = { - 'members': None, - 'inherited-members': None, - } - - assert app.config.autodoc_inherit_docstrings is True # default - actual = do_autodoc(app, 'class', 'target.inheritance.Derived', options) - assert list(actual) == [ - '', - '.. py:class:: Derived()', - ' :module: target.inheritance', - '', - '', - ' .. py:method:: Derived.another_inheritedmeth()', - ' :module: target.inheritance', - '', - ' Another inherited function.', - '', - '', - ' .. py:attribute:: Derived.inheritedattr', - ' :module: target.inheritance', - ' :value: None', - '', - ' docstring', - '', - '', - ' .. py:method:: Derived.inheritedclassmeth()', - ' :module: target.inheritance', - ' :classmethod:', - '', - ' Inherited class method.', - '', - '', - ' .. py:method:: Derived.inheritedmeth()', - ' :module: target.inheritance', - '', - ' Inherited function.', - '', - '', - ' .. py:method:: Derived.inheritedstaticmeth(cls)', - ' :module: target.inheritance', - ' :staticmethod:', - '', - ' Inherited static method.', - '', - ] - - # disable autodoc_inherit_docstrings - app.config.autodoc_inherit_docstrings = False - actual = do_autodoc(app, 'class', 'target.inheritance.Derived', options) - assert list(actual) == [ - '', - '.. py:class:: Derived()', - ' :module: target.inheritance', - '', - '', - ' .. py:method:: Derived.another_inheritedmeth()', - ' :module: target.inheritance', - '', - ' Another inherited function.', - '', - '', - ' .. py:method:: Derived.inheritedclassmeth()', - ' :module: target.inheritance', - ' :classmethod:', - '', - ' Inherited class method.', - '', - '', - ' .. py:method:: Derived.inheritedstaticmeth(cls)', - ' :module: target.inheritance', - ' :staticmethod:', - '', - ' Inherited static method.', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_docstring_signature(app: SphinxTestApp) -> None: - options = {'members': None, 'special-members': '__init__, __new__'} - actual = do_autodoc(app, 'class', 'target.DocstringSig', options) - assert list(actual) == [ - '', - # FIXME: Ideally this would instead be: `DocstringSig(d, e=1)` but - # currently `ClassDocumenter` does not apply the docstring signature - # logic when extracting a signature from a __new__ or __init__ method. - '.. py:class:: DocstringSig(*new_args, **new_kwargs)', - ' :module: target', - '', - '', - ' .. py:method:: DocstringSig.__init__(self, a, b=1) -> None', - ' :module: target', - '', - ' First line of docstring', - '', - ' rest of docstring', - '', - '', - ' .. py:method:: DocstringSig.__new__(cls, d, e=1) -> DocstringSig', - ' :module: target', - ' :staticmethod:', - '', - ' First line of docstring', - '', - ' rest of docstring', - '', - '', - ' .. py:method:: DocstringSig.meth(FOO, BAR=1) -> BAZ', - ' :module: target', - '', - ' First line of docstring', - '', - ' rest of docstring', - '', - '', - ' .. py:method:: DocstringSig.meth2()', - ' :module: target', - '', - ' First line, no signature', - ' Second line followed by indentation::', - '', - ' indented line', - '', - '', - ' .. py:property:: DocstringSig.prop1', - ' :module: target', - '', - ' First line of docstring', - '', - '', - ' .. py:property:: DocstringSig.prop2', - ' :module: target', - '', - ' First line of docstring', - ' Second line of docstring', - '', - ] - - # disable autodoc_docstring_signature - app.config.autodoc_docstring_signature = False - actual = do_autodoc(app, 'class', 'target.DocstringSig', options) - assert list(actual) == [ - '', - '.. py:class:: DocstringSig(*new_args, **new_kwargs)', - ' :module: target', - '', - '', - ' .. py:method:: DocstringSig.__init__(*init_args, **init_kwargs)', - ' :module: target', - '', - ' __init__(self, a, b=1) -> None', - ' First line of docstring', - '', - ' rest of docstring', - '', - '', - ' .. py:method:: DocstringSig.__new__(cls, *new_args, **new_kwargs)', - ' :module: target', - ' :staticmethod:', - '', - ' __new__(cls, d, e=1) -> DocstringSig', - ' First line of docstring', - '', - ' rest of docstring', - '', - '', - ' .. py:method:: DocstringSig.meth()', - ' :module: target', - '', - ' meth(FOO, BAR=1) -> BAZ', - ' First line of docstring', - '', - ' rest of docstring', - '', - '', - ' .. py:method:: DocstringSig.meth2()', - ' :module: target', - '', - ' First line, no signature', - ' Second line followed by indentation::', - '', - ' indented line', - '', - '', - ' .. py:property:: DocstringSig.prop1', - ' :module: target', - '', - ' DocstringSig.prop1(self)', - ' First line of docstring', - '', - '', - ' .. py:property:: DocstringSig.prop2', - ' :module: target', - '', - ' First line of docstring', - ' Second line of docstring', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoclass_content_and_docstring_signature_class(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'class' - options = { - 'members': None, - 'undoc-members': None, - } - actual = do_autodoc(app, 'module', 'target.docstring_signature', options) - assert list(actual) == [ - '', - '.. py:module:: target.docstring_signature', - '', - '', - '.. py:class:: A(foo, bar)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: B(foo, bar)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: C(foo, bar)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: D()', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: E()', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: F()', - ' :module: target.docstring_signature', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoclass_content_and_docstring_signature_init(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'init' - options = { - 'members': None, - 'undoc-members': None, - } - actual = do_autodoc(app, 'module', 'target.docstring_signature', options) - assert list(actual) == [ - '', - '.. py:module:: target.docstring_signature', - '', - '', - '.. py:class:: A(foo, bar)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: B(foo, bar, baz)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: C(foo, bar, baz)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: D(foo, bar, baz)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: E(foo: int, bar: int, baz: int)', - ' E(foo: str, bar: str, baz: str)', - ' E(foo: float, bar: float, baz: float)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: F(foo: int, bar: int, baz: int)', - ' F(foo: str, bar: str, baz: str)', - ' F(foo: float, bar: float, baz: float)', - ' :module: target.docstring_signature', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autoclass_content_and_docstring_signature_both(app: SphinxTestApp) -> None: - app.config.autoclass_content = 'both' - options = { - 'members': None, - 'undoc-members': None, - } - actual = do_autodoc(app, 'module', 'target.docstring_signature', options) - assert list(actual) == [ - '', - '.. py:module:: target.docstring_signature', - '', - '', - '.. py:class:: A(foo, bar)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: B(foo, bar)', - ' :module: target.docstring_signature', - '', - ' B(foo, bar, baz)', - '', - '', - '.. py:class:: C(foo, bar)', - ' :module: target.docstring_signature', - '', - ' C(foo, bar, baz)', - '', - '', - '.. py:class:: D(foo, bar, baz)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: E(foo: int, bar: int, baz: int)', - ' E(foo: str, bar: str, baz: str)', - ' E(foo: float, bar: float, baz: float)', - ' :module: target.docstring_signature', - '', - '', - '.. py:class:: F(foo: int, bar: int, baz: int)', - ' F(foo: str, bar: str, baz: str)', - ' F(foo: float, bar: float, baz: float)', - ' :module: target.docstring_signature', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -@pytest.mark.usefixtures('rollback_sysmodules') -def test_mocked_module_imports(app: SphinxTestApp) -> None: - sys.modules.pop('target', None) # unload target module to clear the module cache - - # no autodoc_mock_imports - options = {'members': 'TestAutodoc,decorated_function,func,Alias'} - actual = do_autodoc(app, 'module', 'target.need_mocks', options) - assert list(actual) == [] - assert "autodoc: failed to import module 'need_mocks'" in app.warning.getvalue() - - # with autodoc_mock_imports - app.config.autodoc_mock_imports = [ - 'missing_module', - 'missing_package1', - 'missing_package2', - 'missing_package3', - 'sphinx.missing_module4', - ] - - app.warning.truncate(0) - actual = do_autodoc(app, 'module', 'target.need_mocks', options) - assert list(actual) == [ - '', - '.. py:module:: target.need_mocks', - '', - '', - '.. py:data:: Alias', - ' :module: target.need_mocks', - '', - ' docstring', - '', - '', - '.. py:class:: TestAutodoc()', - ' :module: target.need_mocks', - '', - ' TestAutodoc docstring.', - '', - '', - ' .. py:attribute:: TestAutodoc.Alias', - ' :module: target.need_mocks', - '', - ' docstring', - '', - '', - ' .. py:method:: TestAutodoc.decorated_method()', - ' :module: target.need_mocks', - '', - ' TestAutodoc::decorated_method docstring', - '', - '', - '.. py:function:: decorated_function()', - ' :module: target.need_mocks', - '', - ' decorated_function docstring', - '', - '', - '.. py:function:: func(arg: missing_module.Class)', - ' :module: target.need_mocks', - '', - ' a function takes mocked object as an argument', - '', - ] - assert app.warning.getvalue() == '' - - -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints': 'signature'}, -) -def test_autodoc_typehints_signature(app: SphinxTestApp) -> None: - options = { - 'members': None, - 'undoc-members': None, - } - actual = do_autodoc(app, 'module', 'target.typehints', options) - assert list(actual) == [ - '', - '.. py:module:: target.typehints', - '', - '', - '.. py:data:: CONST1', - ' :module: target.typehints', - ' :type: int', - '', - '', - '.. py:data:: CONST2', - ' :module: target.typehints', - ' :type: int', - ' :value: 1', - '', - ' docstring', - '', - '', - '.. py:data:: CONST3', - ' :module: target.typehints', - ' :type: ~pathlib.PurePosixPath', - " :value: PurePosixPath('/a/b/c')", - '', - ' docstring', - '', - '', - '.. py:class:: Math(s: str, o: ~typing.Any = None)', - ' :module: target.typehints', - '', - '', - ' .. py:attribute:: Math.CONST1', - ' :module: target.typehints', - ' :type: int', - '', - '', - ' .. py:attribute:: Math.CONST2', - ' :module: target.typehints', - ' :type: int', - ' :value: 1', - '', - '', - ' .. py:attribute:: Math.CONST3', - ' :module: target.typehints', - ' :type: ~pathlib.PurePosixPath', - " :value: PurePosixPath('/a/b/c')", - '', - '', - ' .. py:method:: Math.decr(a: int, b: int = 1) -> int', - ' :module: target.typehints', - '', - '', - ' .. py:method:: Math.horse(a: str, b: int) -> None', - ' :module: target.typehints', - '', - '', - ' .. py:method:: Math.incr(a: int, b: int = 1) -> int', - ' :module: target.typehints', - '', - '', - ' .. py:method:: Math.nothing() -> None', - ' :module: target.typehints', - '', - '', - ' .. py:property:: Math.path', - ' :module: target.typehints', - ' :type: ~pathlib.PurePosixPath', - '', - '', - ' .. py:property:: Math.prop', - ' :module: target.typehints', - ' :type: int', - '', - '', - '.. py:class:: NewAnnotation(i: int)', - ' :module: target.typehints', - '', - '', - '.. py:class:: NewComment(i: int)', - ' :module: target.typehints', - '', - '', - '.. py:class:: SignatureFromMetaclass(a: int)', - ' :module: target.typehints', - '', - '', - '.. py:class:: T', - ' :module: target.typehints', - '', - ' docstring', - '', - " alias of TypeVar('T', bound=\\ :py:class:`~pathlib.PurePosixPath`)", - '', - '', - '.. py:function:: complex_func(arg1: str, arg2: List[int], arg3: Tuple[int, ' - 'Union[str, Unknown]] = None, *args: str, **kwargs: str) -> None', - ' :module: target.typehints', - '', - '', - '.. py:function:: decr(a: int, b: int = 1) -> int', - ' :module: target.typehints', - '', - '', - '.. py:function:: incr(a: int, b: int = 1) -> int', - ' :module: target.typehints', - '', - '', - '.. py:function:: missing_attr(c, a: str, b: Optional[str] = None) -> str', - ' :module: target.typehints', - '', - '', - '.. py:function:: tuple_args(x: tuple[int, int | str]) -> tuple[int, int]', - ' :module: target.typehints', - '', - ] - - -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints': 'none'}, -) -def test_autodoc_typehints_none(app: SphinxTestApp) -> None: - options = { - 'members': None, - 'undoc-members': None, - } - actual = do_autodoc(app, 'module', 'target.typehints', options) - assert list(actual) == [ - '', - '.. py:module:: target.typehints', - '', - '', - '.. py:data:: CONST1', - ' :module: target.typehints', - '', - '', - '.. py:data:: CONST2', - ' :module: target.typehints', - ' :value: 1', - '', - ' docstring', - '', - '', - '.. py:data:: CONST3', - ' :module: target.typehints', - " :value: PurePosixPath('/a/b/c')", - '', - ' docstring', - '', - '', - '.. py:class:: Math(s, o=None)', - ' :module: target.typehints', - '', - '', - ' .. py:attribute:: Math.CONST1', - ' :module: target.typehints', - '', - '', - ' .. py:attribute:: Math.CONST2', - ' :module: target.typehints', - ' :value: 1', - '', - '', - ' .. py:attribute:: Math.CONST3', - ' :module: target.typehints', - " :value: PurePosixPath('/a/b/c')", - '', - '', - ' .. py:method:: Math.decr(a, b=1)', - ' :module: target.typehints', - '', - '', - ' .. py:method:: Math.horse(a, b)', - ' :module: target.typehints', - '', - '', - ' .. py:method:: Math.incr(a, b=1)', - ' :module: target.typehints', - '', - '', - ' .. py:method:: Math.nothing()', - ' :module: target.typehints', - '', - '', - ' .. py:property:: Math.path', - ' :module: target.typehints', - '', - '', - ' .. py:property:: Math.prop', - ' :module: target.typehints', - '', - '', - '.. py:class:: NewAnnotation(i)', - ' :module: target.typehints', - '', - '', - '.. py:class:: NewComment(i)', - ' :module: target.typehints', - '', - '', - '.. py:class:: SignatureFromMetaclass(a)', - ' :module: target.typehints', - '', - '', - '.. py:class:: T', - ' :module: target.typehints', - '', - ' docstring', - '', - " alias of TypeVar('T', bound=\\ :py:class:`~pathlib.PurePosixPath`)", - '', - '', - '.. py:function:: complex_func(arg1, arg2, arg3=None, *args, **kwargs)', - ' :module: target.typehints', - '', - '', - '.. py:function:: decr(a, b=1)', - ' :module: target.typehints', - '', - '', - '.. py:function:: incr(a, b=1)', - ' :module: target.typehints', - '', - '', - '.. py:function:: missing_attr(c, a, b=None)', - ' :module: target.typehints', - '', - '', - '.. py:function:: tuple_args(x)', - ' :module: target.typehints', - '', - ] - - -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints': 'none'}, -) -def test_autodoc_typehints_none_for_overload(app: SphinxTestApp) -> None: - options = {'members': None} - actual = do_autodoc(app, 'module', 'target.overload', options) - assert list(actual) == [ - '', - '.. py:module:: target.overload', - '', - '', - '.. py:class:: Bar(x, y)', - ' :module: target.overload', - '', - ' docstring', - '', - '', - '.. py:class:: Baz(x, y)', - ' :module: target.overload', - '', - ' docstring', - '', - '', - '.. py:class:: Foo(x, y)', - ' :module: target.overload', - '', - ' docstring', - '', - '', - '.. py:class:: Math()', - ' :module: target.overload', - '', - ' docstring', - '', - '', - ' .. py:method:: Math.sum(x, y=None)', - ' :module: target.overload', - '', - ' docstring', - '', - '', - '.. py:function:: sum(x, y=None)', - ' :module: target.overload', - '', - ' docstring', - '', - ] - - -@pytest.mark.sphinx( - 'text', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints': 'description'}, - freshenv=True, -) -def test_autodoc_typehints_description(app: SphinxTestApp) -> None: - app.build() - context = (app.outdir / 'index.txt').read_text(encoding='utf8') - assert ( - 'target.typehints.incr(a, b=1)\n' - '\n' - ' Parameters:\n' - ' * **a** (*int*)\n' - '\n' - ' * **b** (*int*)\n' - '\n' - ' Return type:\n' - ' int\n' - ) in context - assert ( - 'target.typehints.tuple_args(x)\n' - '\n' - ' Parameters:\n' - ' **x** (*tuple**[**int**, **int** | **str**]*)\n' - '\n' - ' Return type:\n' - ' tuple[int, int]\n' - ) in context - - # Overloads still get displayed in the signature - assert ( - 'target.overload.sum(x: int, y: int = 0) -> int\n' - 'target.overload.sum(x: float, y: float = 0.0) -> float\n' - 'target.overload.sum(x: str, y: str = None) -> str\n' - '\n' - ' docstring\n' - ) in context - - -@pytest.mark.sphinx( - 'text', - testroot='ext-autodoc', - confoverrides={ - 'autodoc_typehints': 'description', - 'autodoc_typehints_description_target': 'documented', - }, - copy_test_root=True, -) -def test_autodoc_typehints_description_no_undoc(app: SphinxTestApp) -> None: - # No :type: or :rtype: will be injected for `incr`, which does not have - # a description for its parameters or its return. `tuple_args` does - # describe them, so :type: and :rtype: will be added. - with overwrite_file( - app.srcdir / 'index.rst', - '.. autofunction:: target.typehints.incr\n' - '\n' - '.. autofunction:: target.typehints.decr\n' - '\n' - ' :returns: decremented number\n' - '\n' - '.. autofunction:: target.typehints.tuple_args\n' - '\n' - ' :param x: arg\n' - ' :return: another tuple\n', - ): - app.build() - # Restore the original content of the file - context = (app.outdir / 'index.txt').read_text(encoding='utf8') - assert ( - 'target.typehints.incr(a, b=1)\n' - '\n' - 'target.typehints.decr(a, b=1)\n' - '\n' - ' Returns:\n' - ' decremented number\n' - '\n' - ' Return type:\n' - ' int\n' - '\n' - 'target.typehints.tuple_args(x)\n' - '\n' - ' Parameters:\n' - ' **x** (*tuple**[**int**, **int** | **str**]*) -- arg\n' - '\n' - ' Returns:\n' - ' another tuple\n' - '\n' - ' Return type:\n' - ' tuple[int, int]\n' - ) in context - - -@pytest.mark.sphinx( - 'text', - testroot='ext-autodoc', - confoverrides={ - 'autodoc_typehints': 'description', - 'autodoc_typehints_description_target': 'documented_params', - }, - copy_test_root=True, -) -def test_autodoc_typehints_description_no_undoc_doc_rtype(app: SphinxTestApp) -> None: - # No :type: will be injected for `incr`, which does not have a description - # for its parameters or its return, just :rtype: will be injected due to - # autodoc_typehints_description_target. `tuple_args` does describe both, so - # :type: and :rtype: will be added. `nothing` has no parameters but a return - # type of None, which will be added. - with overwrite_file( - app.srcdir / 'index.rst', - '.. autofunction:: target.typehints.incr\n' - '\n' - '.. autofunction:: target.typehints.decr\n' - '\n' - ' :returns: decremented number\n' - '\n' - '.. autofunction:: target.typehints.tuple_args\n' - '\n' - ' :param x: arg\n' - ' :return: another tuple\n' - '\n' - '.. autofunction:: target.typehints.Math.nothing\n' - '\n' - '.. autofunction:: target.typehints.Math.horse\n' - '\n' - ' :return: nothing\n', - ): - app.build() - context = (app.outdir / 'index.txt').read_text(encoding='utf8') - assert context == ( - 'target.typehints.incr(a, b=1)\n' - '\n' - ' Return type:\n' - ' int\n' - '\n' - 'target.typehints.decr(a, b=1)\n' - '\n' - ' Returns:\n' - ' decremented number\n' - '\n' - ' Return type:\n' - ' int\n' - '\n' - 'target.typehints.tuple_args(x)\n' - '\n' - ' Parameters:\n' - ' **x** (*tuple**[**int**, **int** | **str**]*) -- arg\n' - '\n' - ' Returns:\n' - ' another tuple\n' - '\n' - ' Return type:\n' - ' tuple[int, int]\n' - '\n' - 'target.typehints.Math.nothing(self)\n' - '\n' - 'target.typehints.Math.horse(self, a, b)\n' - '\n' - ' Returns:\n' - ' nothing\n' - '\n' - ' Return type:\n' - ' None\n' - ) - - -@pytest.mark.sphinx( - 'text', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints': 'description'}, - copy_test_root=True, -) -def test_autodoc_typehints_description_with_documented_init(app: SphinxTestApp) -> None: - with overwrite_file( - app.srcdir / 'index.rst', - '.. autoclass:: target.typehints._ClassWithDocumentedInit\n' - ' :special-members: __init__\n', - ): - app.build() - context = (app.outdir / 'index.txt').read_text(encoding='utf8') - assert context == ( - 'class target.typehints._ClassWithDocumentedInit(x, *args, **kwargs)\n' - '\n' - ' Class docstring.\n' - '\n' - ' Parameters:\n' - ' * **x** (*int*)\n' - '\n' - ' * **args** (*int*)\n' - '\n' - ' * **kwargs** (*int*)\n' - '\n' - ' __init__(x, *args, **kwargs)\n' - '\n' - ' Init docstring.\n' - '\n' - ' Parameters:\n' - ' * **x** (*int*) -- Some integer\n' - '\n' - ' * **args** (*int*) -- Some integer\n' - '\n' - ' * **kwargs** (*int*) -- Some integer\n' - '\n' - ' Return type:\n' - ' None\n' - ) - - -@pytest.mark.sphinx( - 'text', - testroot='ext-autodoc', - confoverrides={ - 'autodoc_typehints': 'description', - 'autodoc_typehints_description_target': 'documented', - }, - copy_test_root=True, -) -def test_autodoc_typehints_description_with_documented_init_no_undoc( - app: SphinxTestApp, -) -> None: - with overwrite_file( - app.srcdir / 'index.rst', - '.. autoclass:: target.typehints._ClassWithDocumentedInit\n' - ' :special-members: __init__\n', - ): - app.build() - context = (app.outdir / 'index.txt').read_text(encoding='utf8') - assert context == ( - 'class target.typehints._ClassWithDocumentedInit(x, *args, **kwargs)\n' - '\n' - ' Class docstring.\n' - '\n' - ' __init__(x, *args, **kwargs)\n' - '\n' - ' Init docstring.\n' - '\n' - ' Parameters:\n' - ' * **x** (*int*) -- Some integer\n' - '\n' - ' * **args** (*int*) -- Some integer\n' - '\n' - ' * **kwargs** (*int*) -- Some integer\n' - ) - - -@pytest.mark.sphinx( - 'text', - testroot='ext-autodoc', - confoverrides={ - 'autodoc_typehints': 'description', - 'autodoc_typehints_description_target': 'documented_params', - }, - copy_test_root=True, -) -def test_autodoc_typehints_description_with_documented_init_no_undoc_doc_rtype( - app: SphinxTestApp, -) -> None: - # see test_autodoc_typehints_description_with_documented_init_no_undoc - # returnvalue_and_documented_params should not change class or method - # docstring. - with overwrite_file( - app.srcdir / 'index.rst', - '.. autoclass:: target.typehints._ClassWithDocumentedInit\n' - ' :special-members: __init__\n', - ): - app.build() - context = (app.outdir / 'index.txt').read_text(encoding='utf8') - assert context == ( - 'class target.typehints._ClassWithDocumentedInit(x, *args, **kwargs)\n' - '\n' - ' Class docstring.\n' - '\n' - ' __init__(x, *args, **kwargs)\n' - '\n' - ' Init docstring.\n' - '\n' - ' Parameters:\n' - ' * **x** (*int*) -- Some integer\n' - '\n' - ' * **args** (*int*) -- Some integer\n' - '\n' - ' * **kwargs** (*int*) -- Some integer\n' - ) - - -@pytest.mark.sphinx( - 'text', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints': 'description'}, -) -def test_autodoc_typehints_description_for_invalid_node(app: SphinxTestApp) -> None: - text = '.. py:function:: hello; world' - restructuredtext.parse(app, text) # raises no error - - -@pytest.mark.sphinx( - 'text', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints': 'both'}, - copy_test_root=True, -) -def test_autodoc_typehints_both(app: SphinxTestApp) -> None: - with overwrite_file( - app.srcdir / 'index.rst', - '.. autofunction:: target.typehints.incr\n' - '\n' - '.. autofunction:: target.typehints.tuple_args\n' - '\n' - '.. autofunction:: target.overload.sum\n', - ): - app.build() - context = (app.outdir / 'index.txt').read_text(encoding='utf8') - assert ( - 'target.typehints.incr(a: int, b: int = 1) -> int\n' - '\n' - ' Parameters:\n' - ' * **a** (*int*)\n' - '\n' - ' * **b** (*int*)\n' - '\n' - ' Return type:\n' - ' int\n' - ) in context - assert ( - 'target.typehints.tuple_args(x: tuple[int, int | str]) -> tuple[int, int]\n' - '\n' - ' Parameters:\n' - ' **x** (*tuple**[**int**, **int** | **str**]*)\n' - '\n' - ' Return type:\n' - ' tuple[int, int]\n' - ) in context - - # Overloads still get displayed in the signature - assert ( - 'target.overload.sum(x: int, y: int = 0) -> int\n' - 'target.overload.sum(x: float, y: float = 0.0) -> float\n' - 'target.overload.sum(x: str, y: str = None) -> str\n' - '\n' - ' docstring\n' - ) in context - - -@pytest.mark.sphinx('text', testroot='ext-autodoc') -def test_autodoc_type_aliases(app: SphinxTestApp) -> None: - # default - options = {'members': None} - actual = do_autodoc(app, 'module', 'target.autodoc_type_aliases', options) - assert list(actual) == [ - '', - '.. py:module:: target.autodoc_type_aliases', - '', - '', - '.. py:class:: Foo()', - ' :module: target.autodoc_type_aliases', - '', - ' docstring', - '', - '', - ' .. py:attribute:: Foo.attr1', - ' :module: target.autodoc_type_aliases', - ' :type: int', - '', - ' docstring', - '', - '', - ' .. py:attribute:: Foo.attr2', - ' :module: target.autodoc_type_aliases', - ' :type: int', - '', - ' docstring', - '', - '', - '.. py:function:: mult(x: int, y: int) -> int', - ' mult(x: float, y: float) -> float', - ' :module: target.autodoc_type_aliases', - '', - ' docstring', - '', - '', - '.. py:function:: read(r: ~io.BytesIO) -> ~io.StringIO', - ' :module: target.autodoc_type_aliases', - '', - ' docstring', - '', - '', - '.. py:function:: sum(x: int, y: int) -> int', - ' :module: target.autodoc_type_aliases', - '', - ' docstring', - '', - '', - '.. py:data:: variable', - ' :module: target.autodoc_type_aliases', - ' :type: int', - '', - ' docstring', - '', - '', - '.. py:data:: variable2', - ' :module: target.autodoc_type_aliases', - ' :type: int', - ' :value: None', - '', - ' docstring', - '', - '', - '.. py:data:: variable3', - ' :module: target.autodoc_type_aliases', - ' :type: int | None', - '', - ' docstring', - '', - ] - - # define aliases - app.config.autodoc_type_aliases = { - 'myint': 'myint', - 'io.StringIO': 'my.module.StringIO', - } - actual = do_autodoc(app, 'module', 'target.autodoc_type_aliases', options) - assert list(actual) == [ - '', - '.. py:module:: target.autodoc_type_aliases', - '', - '', - '.. py:class:: Foo()', - ' :module: target.autodoc_type_aliases', - '', - ' docstring', - '', - '', - ' .. py:attribute:: Foo.attr1', - ' :module: target.autodoc_type_aliases', - ' :type: myint', - '', - ' docstring', - '', - '', - ' .. py:attribute:: Foo.attr2', - ' :module: target.autodoc_type_aliases', - ' :type: myint', - '', - ' docstring', - '', - '', - '.. py:function:: mult(x: myint, y: myint) -> myint', - ' mult(x: float, y: float) -> float', - ' :module: target.autodoc_type_aliases', - '', - ' docstring', - '', - '', - '.. py:function:: read(r: ~io.BytesIO) -> my.module.StringIO', - ' :module: target.autodoc_type_aliases', - '', - ' docstring', - '', - '', - '.. py:function:: sum(x: myint, y: myint) -> myint', - ' :module: target.autodoc_type_aliases', - '', - ' docstring', - '', - '', - '.. py:data:: variable', - ' :module: target.autodoc_type_aliases', - ' :type: myint', - '', - ' docstring', - '', - '', - '.. py:data:: variable2', - ' :module: target.autodoc_type_aliases', - ' :type: myint', - ' :value: None', - '', - ' docstring', - '', - '', - '.. py:data:: variable3', - ' :module: target.autodoc_type_aliases', - ' :type: myint | None', - '', - ' docstring', - '', - ] - - -@pytest.mark.sphinx( - 'text', - testroot='ext-autodoc', - srcdir='autodoc_typehints_description_and_type_aliases', - confoverrides={ - 'autodoc_typehints': 'description', - 'autodoc_type_aliases': {'myint': 'myint'}, - }, -) -def test_autodoc_typehints_description_and_type_aliases(app: SphinxTestApp) -> None: - with overwrite_file( - app.srcdir / 'autodoc_type_aliases.rst', - '.. autofunction:: target.autodoc_type_aliases.sum', - ): - app.build() - context = (app.outdir / 'autodoc_type_aliases.txt').read_text(encoding='utf8') - assert context == ( - 'target.autodoc_type_aliases.sum(x, y)\n' - '\n' - ' docstring\n' - '\n' - ' Parameters:\n' - ' * **x** (*myint*)\n' - '\n' - ' * **y** (*myint*)\n' - '\n' - ' Return type:\n' - ' myint\n' - ) - - -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints_format': 'fully-qualified'}, -) -def test_autodoc_typehints_format_fully_qualified(app: SphinxTestApp) -> None: - options = { - 'members': None, - 'undoc-members': None, - } - actual = do_autodoc(app, 'module', 'target.typehints', options) - assert list(actual) == [ - '', - '.. py:module:: target.typehints', - '', - '', - '.. py:data:: CONST1', - ' :module: target.typehints', - ' :type: int', - '', - '', - '.. py:data:: CONST2', - ' :module: target.typehints', - ' :type: int', - ' :value: 1', - '', - ' docstring', - '', - '', - '.. py:data:: CONST3', - ' :module: target.typehints', - ' :type: pathlib.PurePosixPath', - " :value: PurePosixPath('/a/b/c')", - '', - ' docstring', - '', - '', - '.. py:class:: Math(s: str, o: typing.Any = None)', - ' :module: target.typehints', - '', - '', - ' .. py:attribute:: Math.CONST1', - ' :module: target.typehints', - ' :type: int', - '', - '', - ' .. py:attribute:: Math.CONST2', - ' :module: target.typehints', - ' :type: int', - ' :value: 1', - '', - '', - ' .. py:attribute:: Math.CONST3', - ' :module: target.typehints', - ' :type: pathlib.PurePosixPath', - " :value: PurePosixPath('/a/b/c')", - '', - '', - ' .. py:method:: Math.decr(a: int, b: int = 1) -> int', - ' :module: target.typehints', - '', - '', - ' .. py:method:: Math.horse(a: str, b: int) -> None', - ' :module: target.typehints', - '', - '', - ' .. py:method:: Math.incr(a: int, b: int = 1) -> int', - ' :module: target.typehints', - '', - '', - ' .. py:method:: Math.nothing() -> None', - ' :module: target.typehints', - '', - '', - ' .. py:property:: Math.path', - ' :module: target.typehints', - ' :type: pathlib.PurePosixPath', - '', - '', - ' .. py:property:: Math.prop', - ' :module: target.typehints', - ' :type: int', - '', - '', - '.. py:class:: NewAnnotation(i: int)', - ' :module: target.typehints', - '', - '', - '.. py:class:: NewComment(i: int)', - ' :module: target.typehints', - '', - '', - '.. py:class:: SignatureFromMetaclass(a: int)', - ' :module: target.typehints', - '', - '', - '.. py:class:: T', - ' :module: target.typehints', - '', - ' docstring', - '', - " alias of TypeVar('T', bound=\\ :py:class:`pathlib.PurePosixPath`)", - '', - '', - '.. py:function:: complex_func(arg1: str, arg2: List[int], arg3: Tuple[int, ' - 'Union[str, Unknown]] = None, *args: str, **kwargs: str) -> None', - ' :module: target.typehints', - '', - '', - '.. py:function:: decr(a: int, b: int = 1) -> int', - ' :module: target.typehints', - '', - '', - '.. py:function:: incr(a: int, b: int = 1) -> int', - ' :module: target.typehints', - '', - '', - '.. py:function:: missing_attr(c, a: str, b: Optional[str] = None) -> str', - ' :module: target.typehints', - '', - '', - '.. py:function:: tuple_args(x: tuple[int, int | str]) -> tuple[int, int]', - ' :module: target.typehints', - '', - ] - - -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints_format': 'fully-qualified'}, -) -def test_autodoc_typehints_format_fully_qualified_for_class_alias( - app: SphinxTestApp, -) -> None: - actual = do_autodoc(app, 'class', 'target.classes.Alias') - assert list(actual) == [ - '', - '.. py:attribute:: Alias', - ' :module: target.classes', - '', - ' alias of :py:class:`target.classes.Foo`', - ] - - -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints_format': 'fully-qualified'}, -) -def test_autodoc_typehints_format_fully_qualified_for_generic_alias( - app: SphinxTestApp, -) -> None: - actual = do_autodoc(app, 'data', 'target.genericalias.L') - assert list(actual) == [ - '', - '.. py:data:: L', - ' :module: target.genericalias', - '', - ' A list of Class', - '', - ' alias of :py:class:`~typing.List`\\ [:py:class:`target.genericalias.Class`]', - '', - ] - - -@pytest.mark.sphinx( - 'html', - testroot='ext-autodoc', - confoverrides={'autodoc_typehints_format': 'fully-qualified'}, -) -def test_autodoc_typehints_format_fully_qualified_for_newtype_alias( - app: SphinxTestApp, -) -> None: - actual = do_autodoc(app, 'class', 'target.typevar.T6') - assert list(actual) == [ - '', - '.. py:class:: T6', - ' :module: target.typevar', - '', - ' T6', - '', - ' alias of :py:class:`datetime.date`', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_default_options(app: SphinxTestApp) -> None: - if (3, 11, 7) <= sys.version_info < (3, 12) or sys.version_info >= (3, 12, 1): - list_of_weak_references = ' list of weak references to the object' - else: - list_of_weak_references = ' list of weak references to the object (if defined)' # fmt: skip - - # no settings - actual = do_autodoc(app, 'class', 'target.enums.EnumCls') - assert ' .. py:attribute:: EnumCls.val1' not in actual - assert ' .. py:attribute:: EnumCls.val4' not in actual - actual = do_autodoc(app, 'class', 'target.CustomIter') - assert ' .. py:method:: target.CustomIter' not in actual - actual = do_autodoc(app, 'module', 'target') - assert '.. py:function:: function_to_be_imported(app)' not in actual - - # with :members: - app.config.autodoc_default_options = {'members': None} - actual = do_autodoc(app, 'class', 'target.enums.EnumCls') - assert ' .. py:attribute:: EnumCls.val1' in actual - assert ' .. py:attribute:: EnumCls.val4' not in actual - - # with :members: = True - app.config.autodoc_default_options = {'members': None} - actual = do_autodoc(app, 'class', 'target.enums.EnumCls') - assert ' .. py:attribute:: EnumCls.val1' in actual - assert ' .. py:attribute:: EnumCls.val4' not in actual - - # with :members: and :undoc-members: - app.config.autodoc_default_options = { - 'members': None, - 'undoc-members': None, - } - actual = do_autodoc(app, 'class', 'target.enums.EnumCls') - assert ' .. py:attribute:: EnumCls.val1' in actual - assert ' .. py:attribute:: EnumCls.val4' in actual - - # with :special-members: - # Note that :members: must be *on* for :special-members: to work. - app.config.autodoc_default_options = { - 'members': None, - 'special-members': None, - } - actual = do_autodoc(app, 'class', 'target.CustomIter') - assert ' .. py:method:: CustomIter.__init__()' in actual - assert ' Create a new `CustomIter`.' in actual - assert ' .. py:method:: CustomIter.__iter__()' in actual - assert ' Iterate squares of each value.' in actual - if not IS_PYPY: - assert ' .. py:attribute:: CustomIter.__weakref__' in actual - assert list_of_weak_references in actual - - # :exclude-members: None - has no effect. Unlike :members:, - # :special-members:, etc. where None == "include all", here None means - # "no/false/off". - app.config.autodoc_default_options = { - 'members': None, - 'exclude-members': None, - } - actual = do_autodoc(app, 'class', 'target.enums.EnumCls') - assert ' .. py:attribute:: EnumCls.val1' in actual - assert ' .. py:attribute:: EnumCls.val4' not in actual - app.config.autodoc_default_options = { - 'members': None, - 'special-members': None, - 'exclude-members': None, - } - actual = do_autodoc(app, 'class', 'target.CustomIter') - assert ' .. py:method:: CustomIter.__init__()' in actual - assert ' Create a new `CustomIter`.' in actual - assert ' .. py:method:: CustomIter.__iter__()' in actual - assert ' Iterate squares of each value.' in actual - if not IS_PYPY: - assert ' .. py:attribute:: CustomIter.__weakref__' in actual - assert list_of_weak_references in actual - assert ' .. py:method:: CustomIter.snafucate()' in actual - assert ' Makes this snafucated.' in actual - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_autodoc_default_options_with_values(app: SphinxTestApp) -> None: - if (3, 11, 7) <= sys.version_info < (3, 12) or sys.version_info >= (3, 12, 1): - list_of_weak_references = ' list of weak references to the object' - else: - list_of_weak_references = ' list of weak references to the object (if defined)' # fmt: skip - - # with :members: - app.config.autodoc_default_options = {'members': 'val1,val2'} - actual = do_autodoc(app, 'class', 'target.enums.EnumCls') - assert ' .. py:attribute:: EnumCls.val1' in actual - assert ' .. py:attribute:: EnumCls.val2' in actual - assert ' .. py:attribute:: EnumCls.val3' not in actual - assert ' .. py:attribute:: EnumCls.val4' not in actual - - # with :member-order: - app.config.autodoc_default_options = { - 'members': None, - 'member-order': 'bysource', - } - actual = do_autodoc(app, 'class', 'target.Class') - assert list(filter(lambda l: '::' in l, actual)) == [ - '.. py:class:: Class(arg)', - ' .. py:method:: Class.meth()', - ' .. py:method:: Class.skipmeth()', - ' .. py:method:: Class.excludemeth()', - ' .. py:attribute:: Class.attr', - ' .. py:attribute:: Class.docattr', - ' .. py:attribute:: Class.udocattr', - ' .. py:attribute:: Class.mdocattr', - ' .. py:method:: Class.moore(a, e, f) -> happiness', - ' .. py:attribute:: Class.inst_attr_inline', - ' .. py:attribute:: Class.inst_attr_comment', - ' .. py:attribute:: Class.inst_attr_string', - ] - - # with :special-members: - app.config.autodoc_default_options = { - 'special-members': '__init__,__iter__', - } - actual = do_autodoc(app, 'class', 'target.CustomIter') - assert ' .. py:method:: CustomIter.__init__()' in actual - assert ' Create a new `CustomIter`.' in actual - assert ' .. py:method:: CustomIter.__iter__()' in actual - assert ' Iterate squares of each value.' in actual - if not IS_PYPY: - assert ' .. py:attribute:: CustomIter.__weakref__' not in actual - assert list_of_weak_references not in actual - - # with :exclude-members: - app.config.autodoc_default_options = { - 'members': None, - 'exclude-members': 'val1', - } - actual = do_autodoc(app, 'class', 'target.enums.EnumCls') - assert ' .. py:attribute:: EnumCls.val1' not in actual - assert ' .. py:attribute:: EnumCls.val2' in actual - assert ' .. py:attribute:: EnumCls.val3' in actual - assert ' .. py:attribute:: EnumCls.val4' not in actual - app.config.autodoc_default_options = { - 'members': None, - 'special-members': None, - 'exclude-members': '__weakref__,snafucate', - } - actual = do_autodoc(app, 'class', 'target.CustomIter') - assert ' .. py:method:: CustomIter.__init__()' in actual - assert ' Create a new `CustomIter`.' in actual - assert ' .. py:method:: CustomIter.__iter__()' in actual - assert ' Iterate squares of each value.' in actual - if not IS_PYPY: - assert ' .. py:attribute:: CustomIter.__weakref__' not in actual - assert list_of_weak_references not in actual - assert ' .. py:method:: CustomIter.snafucate()' not in actual - assert ' Makes this snafucated.' not in actual diff --git a/tests/test_extensions/test_ext_autodoc_events.py b/tests/test_extensions/test_ext_autodoc_events.py deleted file mode 100644 index ddc00476ad0..00000000000 --- a/tests/test_extensions/test_ext_autodoc_events.py +++ /dev/null @@ -1,142 +0,0 @@ -"""Test the autodoc extension. This tests mainly for autodoc events""" - -from __future__ import annotations - -from typing import TYPE_CHECKING - -import pytest - -from sphinx.ext.autodoc import between, cut_lines - -from tests.test_extensions.autodoc_util import do_autodoc - -if TYPE_CHECKING: - from sphinx.testing.util import SphinxTestApp - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_process_docstring(app: SphinxTestApp) -> None: - def on_process_docstring(app, what, name, obj, options, lines): - lines.clear() - lines.append('my docstring') - - app.connect('autodoc-process-docstring', on_process_docstring) - - actual = do_autodoc(app, 'function', 'target.process_docstring.func') - assert list(actual) == [ - '', - '.. py:function:: func()', - ' :module: target.process_docstring', - '', - ' my docstring', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_process_docstring_for_nondatadescriptor(app: SphinxTestApp) -> None: - def on_process_docstring(app, what, name, obj, options, lines): - raise RuntimeError - - app.connect('autodoc-process-docstring', on_process_docstring) - - actual = do_autodoc(app, 'attribute', 'target.AttCls.a1') - assert list(actual) == [ - '', - '.. py:attribute:: AttCls.a1', - ' :module: target', - ' :value: hello world', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_cut_lines(app: SphinxTestApp) -> None: - app.connect('autodoc-process-docstring', cut_lines(2, 2, ['function'])) - - actual = do_autodoc(app, 'function', 'target.process_docstring.func') - assert list(actual) == [ - '', - '.. py:function:: func()', - ' :module: target.process_docstring', - '', - ' second line', - '', - ] - - -def test_cut_lines_no_objtype(): - docstring_lines = [ - 'first line', - '---', - 'second line', - '---', - 'third line ', - '', - ] - process = cut_lines(2) - - process(None, 'function', 'func', None, {}, docstring_lines) - assert docstring_lines == [ - 'second line', - '---', - 'third line ', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_between(app: SphinxTestApp) -> None: - app.connect('autodoc-process-docstring', between('---', ['function'])) - - actual = do_autodoc(app, 'function', 'target.process_docstring.func') - assert list(actual) == [ - '', - '.. py:function:: func()', - ' :module: target.process_docstring', - '', - ' second line', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_between_exclude(app: SphinxTestApp) -> None: - app.connect('autodoc-process-docstring', between('---', ['function'], exclude=True)) - - actual = do_autodoc(app, 'function', 'target.process_docstring.func') - assert list(actual) == [ - '', - '.. py:function:: func()', - ' :module: target.process_docstring', - '', - ' first line', - ' third line', - '', - ] - - -@pytest.mark.sphinx('html', testroot='ext-autodoc') -def test_skip_module_member(app: SphinxTestApp) -> None: - def autodoc_skip_member(app, what, name, obj, skip, options): - if name == 'Class': - return True # Skip "Class" class in __all__ - elif name == 'raises': - return False # Show "raises()" function (not in __all__) - return None - - app.connect('autodoc-skip-member', autodoc_skip_member) - - options = {'members': None} - actual = do_autodoc(app, 'module', 'target', options) - assert list(actual) == [ - '', - '.. py:module:: target', - '', - '', - '.. py:function:: raises(exc, func, *args, **kwds)', - ' :module: target', - '', - ' Raise AssertionError if ``func(*args, **kwds)`` does not raise *exc*.', - '', - ] diff --git a/tests/test_extensions/test_ext_coverage.py b/tests/test_extensions/test_ext_coverage.py index 3c40d3dfaea..32fc2dba2d7 100644 --- a/tests/test_extensions/test_ext_coverage.py +++ b/tests/test_extensions/test_ext_coverage.py @@ -38,7 +38,7 @@ def test_build(app: SphinxTestApp) -> None: assert 'api.h' in c_undoc assert ' * Py_SphinxTest' in c_undoc - undoc_py, undoc_c, py_undocumented, py_documented = pickle.loads( + undoc_py, undoc_c, _py_undocumented, _py_documented = pickle.loads( (app.outdir / 'undoc.pickle').read_bytes() ) assert len(undoc_c) == 1 @@ -117,7 +117,7 @@ def test_show_missing_items(app: SphinxTestApp) -> None: 'coverage', testroot='root', confoverrides={'coverage_show_missing_items': True} ) def test_show_missing_items_quiet(app: SphinxTestApp) -> None: - app.quiet = True + app.config._verbosity = -1 # mimics status=None / app.quiet = True app.build(force_all=True) assert ( diff --git a/tests/test_extensions/test_ext_doctest.py b/tests/test_extensions/test_ext_doctest.py index cb540fda7ec..c8a12c24de8 100644 --- a/tests/test_extensions/test_ext_doctest.py +++ b/tests/test_extensions/test_ext_doctest.py @@ -11,7 +11,7 @@ from packaging.specifiers import InvalidSpecifier from packaging.version import InvalidVersion -from sphinx.ext.doctest import is_allowed_version +from sphinx.ext.doctest import DocTestBuilder, is_allowed_version if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp @@ -74,12 +74,12 @@ def test_is_allowed_version() -> None: is_allowed_version('>3.4', 'Sphinx') -def cleanup_call(): +def cleanup_call() -> None: global cleanup_called # NoQA: PLW0603 cleanup_called += 1 -recorded_calls: Counter[tuple[str, str, int]] = Counter() +recorded_calls: Counter[tuple[str, str, bool]] = Counter() @pytest.mark.sphinx('doctest', testroot='ext-doctest-skipif') @@ -125,16 +125,17 @@ def test_skipif(app: SphinxTestApp) -> None: } -def record(directive, part, should_skip): +def record(directive: str, part: str, should_skip: bool) -> str: recorded_calls[directive, part, should_skip] += 1 return f'Recorded {directive} {part} {should_skip}' @pytest.mark.sphinx('doctest', testroot='ext-doctest-with-autodoc') -def test_reporting_with_autodoc(app, capfd): +def test_reporting_with_autodoc(app: SphinxTestApp) -> None: # Patch builder to get a copy of the output - written = [] - app.builder._warn_out = written.append + written: list[str] = [] + assert isinstance(app.builder, DocTestBuilder) + app.builder._warn_out = written.append # type: ignore[method-assign] app.build(force_all=True) failures = [ @@ -147,3 +148,56 @@ def test_reporting_with_autodoc(app, capfd): assert 'File "dir/bar.py", line ?, in default' in failures assert 'File "foo.py", line ?, in default' in failures assert 'File "index.rst", line 4, in default' in failures + + +@pytest.mark.sphinx('doctest', testroot='ext-doctest-fail-fast') +@pytest.mark.parametrize('fail_fast', [False, True, None]) +def test_fail_fast(app: SphinxTestApp, fail_fast: bool | None) -> None: + if fail_fast is not None: + app.config.doctest_fail_fast = fail_fast + # Patch builder to get a copy of the output + written: list[str] = [] + assert isinstance(app.builder, DocTestBuilder) + app.builder._out = written.append # type: ignore[method-assign] + app.build(force_all=True) + assert app.statuscode + + written = ''.join(written).split('\n') + if fail_fast: + assert written[10] == 'Doctest summary (exiting after first failed test)' + assert written[13] == ' 1 failure in tests' + else: + assert written[10] == 'Doctest summary' + assert written[13] == ' 2 failures in tests' + + +@pytest.mark.sphinx('doctest', testroot='ext-doctest-with-autodoc') +@pytest.mark.parametrize( + ('test_doctest_blocks', 'group_name'), + [ + (None, 'default'), + ('CustomGroupName', 'CustomGroupName'), + ], +) +def test_doctest_block_group_name( + app: SphinxTestApp, test_doctest_blocks: str | None, group_name: str +) -> None: + if test_doctest_blocks is not None: + app.config.doctest_test_doctest_blocks = test_doctest_blocks + + # Patch builder to get a copy of the output + written: list[str] = [] + assert isinstance(app.builder, DocTestBuilder) + app.builder._warn_out = written.append # type: ignore[method-assign] + app.build(force_all=True) + + failures = [ + line.replace(os.sep, '/') + for line in '\n'.join(written).splitlines() + if line.startswith('File') + ] + + assert f'File "dir/inner.rst", line 1, in {group_name}' in failures + assert f'File "dir/bar.py", line ?, in {group_name}' in failures + assert f'File "foo.py", line ?, in {group_name}' in failures + assert f'File "index.rst", line 4, in {group_name}' in failures diff --git a/tests/test_extensions/test_ext_duration.py b/tests/test_extensions/test_ext_duration.py index 2e48e8fe5e5..6f432662051 100644 --- a/tests/test_extensions/test_ext_duration.py +++ b/tests/test_extensions/test_ext_duration.py @@ -2,7 +2,9 @@ from __future__ import annotations +import json import re +from pathlib import Path from typing import TYPE_CHECKING import pytest @@ -15,9 +17,146 @@ 'dummy', testroot='basic', confoverrides={'extensions': ['sphinx.ext.duration']}, + freshenv=True, ) -def test_githubpages(app: SphinxTestApp) -> None: +def test_duration(app: SphinxTestApp) -> None: app.build() assert 'slowest reading durations' in app.status.getvalue() - assert re.search('\\d+\\.\\d{3} index\n', app.status.getvalue()) + assert re.search('\\d+\\.\\d{3}s index\n', app.status.getvalue()) + + assert 'total reading duration' in app.status.getvalue() + assert 'Total time reading 1 file: ' in app.status.getvalue() + assert re.search( + r'Total time reading 1 file: \d+m \d+\.\d{3}s', app.status.getvalue() + ) + + fname = app.outdir / 'sphinx-reading-durations.json' + assert fname.is_file() + + data = json.loads(fname.read_bytes()) + keys = list(data.keys()) + values = list(data.values()) + assert keys == ['index'] + assert len(values) == 1 + assert isinstance(values[0], float) + + +@pytest.mark.sphinx( + 'dummy', + testroot='root', + confoverrides={'extensions': ['sphinx.ext.duration'], 'duration_n_slowest': 2}, + freshenv=True, +) +def test_n_slowest_value(app: SphinxTestApp) -> None: + app.build() + + matches = re.findall(r'\d+\.\d{3}s\s+[A-Za-z0-9/]+\n', app.status.getvalue()) + assert len(matches) == 2 + + +@pytest.mark.sphinx( + 'dummy', + testroot='basic', + confoverrides={'extensions': ['sphinx.ext.duration'], 'duration_n_slowest': 0}, + freshenv=True, +) +def test_n_slowest_all(app: SphinxTestApp) -> None: + app.build() + + assert 'slowest reading durations' in app.status.getvalue() + matches = re.findall(r'\d+\.\d{3}s\s+[A-Za-z0-9/]+\n', app.status.getvalue()) + assert len(matches) > 0 + + +@pytest.mark.sphinx( + 'dummy', + testroot='basic', + confoverrides={ + 'extensions': ['sphinx.ext.duration'], + 'duration_print_slowest': False, + }, + freshenv=True, +) +def test_print_slowest_false(app: SphinxTestApp) -> None: + app.build() + + assert 'slowest reading durations' not in app.status.getvalue() + + +@pytest.mark.sphinx( + 'dummy', + testroot='basic', + confoverrides={ + 'extensions': ['sphinx.ext.duration'], + 'duration_print_total': False, + }, + freshenv=True, +) +def test_print_total_false(app: SphinxTestApp) -> None: + app.build() + + assert 'total reading duration' not in app.status.getvalue() + + +@pytest.mark.parametrize('write_json', [True, False]) +@pytest.mark.sphinx( + 'dummy', + testroot='basic', + confoverrides={'extensions': ['sphinx.ext.duration']}, + freshenv=True, +) +def test_write_json(app: SphinxTestApp, write_json: bool) -> None: + if not write_json: + app.config.duration_write_json = None + app.build() + + expected = Path(app.outdir) / 'sphinx-reading-durations.json' + assert expected.is_file() == write_json + expected.unlink(missing_ok=not write_json) + + +@pytest.mark.sphinx( + 'dummy', + testroot='basic', + confoverrides={'extensions': ['sphinx.ext.duration']}, + freshenv=True, +) +def test_write_json_path(app: SphinxTestApp) -> None: + parent_name = 'durations' + file_name = 'durations.json' + app.config.duration_write_json = str(Path(parent_name, file_name)) + app.build() + + expected_path = app.outdir / parent_name / file_name + assert expected_path.parent.is_dir() + assert expected_path.is_file() + assert expected_path.parent.name == parent_name + assert expected_path.name == file_name + + +@pytest.mark.parametrize( + ('duration_limit', 'expect_warning'), [(0.0, True), (1.0, False)] +) +@pytest.mark.sphinx( + 'dummy', + testroot='basic', + confoverrides={'extensions': ['sphinx.ext.duration']}, + freshenv=True, +) +def test_duration_limit( + app: SphinxTestApp, duration_limit: float, expect_warning: bool +) -> None: + app.config.duration_limit = duration_limit + app.build() + + match = re.search( + r'index\.rst: WARNING: ' + r'Reading duration \d+\.\d{3}s exceeded the duration limit 0\.000s ' + r'\[duration\]', + app.warning.getvalue(), + ) + if expect_warning: + assert match is not None + else: + assert match is None diff --git a/tests/test_extensions/test_ext_inheritance_diagram.py b/tests/test_extensions/test_ext_inheritance_diagram.py index 4153113d12e..ea43cea7443 100644 --- a/tests/test_extensions/test_ext_inheritance_diagram.py +++ b/tests/test_extensions/test_ext_inheritance_diagram.py @@ -9,6 +9,7 @@ from typing import TYPE_CHECKING import pytest +from docutils import nodes from sphinx.ext.inheritance_diagram import ( InheritanceDiagram, @@ -32,6 +33,7 @@ def test_inheritance_diagram(app: SphinxTestApp) -> None: def new_run(self): result = orig_run(self) node = result[0] + assert isinstance(node.document, nodes.document) source = Path(node.document.current_source).stem graphs[source] = node['graph'] return result @@ -293,7 +295,7 @@ def test_inheritance_diagram_latex_alias(app): app.config.inheritance_alias = {'test.Foo': 'alias.Foo'} app.build(force_all=True) - doc = app.env.get_and_resolve_doctree('index', app) + doc = app.env.get_and_resolve_doctree('index', app.builder, tags=app.tags) aliased_graph = doc.children[0].children[3]['graph'].class_info assert len(aliased_graph) == 4 assert ( diff --git a/tests/test_extensions/test_ext_math.py b/tests/test_extensions/test_ext_math.py index 02d215bef01..cd865597aae 100644 --- a/tests/test_extensions/test_ext_math.py +++ b/tests/test_extensions/test_ext_math.py @@ -14,9 +14,13 @@ from sphinx.ext.mathjax import MATHJAX_URL from sphinx.testing.util import assert_node +from tests.utils import extract_node + if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp +FAKE_MATHJAX_URL = 'https://example.org/fake-mathjax.js' + def has_binary(binary: str) -> bool: try: @@ -124,8 +128,8 @@ def test_mathjax_options(app: SphinxTestApp) -> None: content = (app.outdir / 'index.html').read_text(encoding='utf8') shutil.rmtree(app.outdir) assert ( - '' ) in content @@ -320,11 +324,10 @@ def test_imgmath_numfig_html(app: SphinxTestApp) -> None: @pytest.mark.sphinx('dummy', testroot='ext-math-compat') -def test_math_compat(app): +def test_math_compat(app: SphinxTestApp) -> None: with warnings.catch_warnings(record=True): app.build(force_all=True) - doctree = app.env.get_and_resolve_doctree('index', app.builder) - + doctree = app.env.get_and_resolve_doctree('index', app.builder, tags=app.tags) assert_node( doctree, [ @@ -338,7 +341,7 @@ def test_math_compat(app): ], ) assert_node( - doctree[0][1][1], + extract_node(doctree, 0, 1, 1), ( 'Inline: ', [nodes.math, 'E=mc^2'], @@ -347,7 +350,7 @@ def test_math_compat(app): ), ) assert_node( - doctree[0][2], + extract_node(doctree, 0, 2), ( [nodes.title, 'block'], [nodes.math_block, 'a^2+b^2=c^2\n\n'], @@ -364,10 +367,10 @@ def test_math_compat(app): testroot='ext-math', confoverrides={ 'extensions': ['sphinx.ext.mathjax'], - 'mathjax3_config': {'extensions': ['tex2jax.js']}, + 'mathjax4_config': {'extensions': ['tex2jax.js']}, }, ) -def test_mathjax3_config(app: SphinxTestApp) -> None: +def test_mathjax4_config(app: SphinxTestApp) -> None: app.build(force_all=True) content = (app.outdir / 'index.html').read_text(encoding='utf8') @@ -376,19 +379,57 @@ def test_mathjax3_config(app: SphinxTestApp) -> None: assert '' in content +@pytest.mark.sphinx( + 'html', + testroot='ext-math', + confoverrides={ + 'extensions': ['sphinx.ext.mathjax'], + 'mathjax3_config': {'extensions': ['tex2jax.js']}, + 'mathjax_path': FAKE_MATHJAX_URL, + }, +) +def test_mathjax3_config(app: SphinxTestApp) -> None: + app.build(force_all=True) + + content = (app.outdir / 'index.html').read_text(encoding='utf8') + assert FAKE_MATHJAX_URL in content + assert f'' in content + + +@pytest.mark.sphinx( + 'html', + testroot='ext-math', + confoverrides={ + 'extensions': ['sphinx.ext.mathjax'], + 'mathjax_config_path': '_static/custom_mathjax_config.js', + }, +) +def test_mathjax_config_path_config(app: SphinxTestApp) -> None: + app.build(force_all=True) + + content = (app.outdir / 'index.html').read_text(encoding='utf8') + assert MATHJAX_URL in content + assert f'' + ) in content + + @pytest.mark.sphinx( 'html', testroot='ext-math', confoverrides={ 'extensions': ['sphinx.ext.mathjax'], 'mathjax2_config': {'extensions': ['tex2jax.js']}, + 'mathjax_path': FAKE_MATHJAX_URL, }, ) def test_mathjax2_config(app: SphinxTestApp) -> None: app.build(force_all=True) content = (app.outdir / 'index.html').read_text(encoding='utf8') - assert '' in content + assert '' in content @pytest.mark.sphinx( @@ -457,7 +498,7 @@ def test_mathjax_path_config(app: SphinxTestApp) -> None: content = (app.outdir / 'index.html').read_text(encoding='utf8') assert ( - '' + '' ) in content @@ -486,6 +527,7 @@ def test_mathjax_is_not_installed_if_no_equations(app: SphinxTestApp) -> None: content = (app.outdir / 'index.html').read_text(encoding='utf8') assert 'MathJax.js' not in content + assert MATHJAX_URL not in content @pytest.mark.sphinx( @@ -552,6 +594,7 @@ def test_mathjax_is_not_installed_if_no_equations_singlehtml( content = (app.outdir / 'index.html').read_text(encoding='utf8') assert 'MathJax.js' not in content + assert MATHJAX_URL not in content @pytest.mark.sphinx( @@ -566,3 +609,19 @@ def test_mathjax_is_installed_if_included_file_has_equations_singlehtml( content = (app.outdir / 'index.html').read_text(encoding='utf8') assert MATHJAX_URL in content + + +@pytest.mark.sphinx( + 'html', + testroot='ext-math-duplicate-label', + confoverrides={'extensions': ['sphinx.ext.mathjax'], 'show_warning_types': True}, +) +def test_duplicate_equation_label_warning_type(app: SphinxTestApp) -> None: + """Test that duplicate equation labels emit warnings with type ref.equation.""" + app.build(force_all=True) + + from sphinx._cli.util.errors import strip_escape_sequences + + warnings = strip_escape_sequences(app.warning.getvalue()) + assert 'WARNING: duplicate label of equation duplicated' in warnings + assert '[ref.equation]' in warnings diff --git a/tests/test_extensions/test_ext_todo.py b/tests/test_extensions/test_ext_todo.py index a19c880b47b..38a6f81e16b 100644 --- a/tests/test_extensions/test_ext_todo.py +++ b/tests/test_extensions/test_ext_todo.py @@ -8,6 +8,8 @@ import pytest if TYPE_CHECKING: + from sphinx.application import Sphinx + from sphinx.ext.todo import todo_node from sphinx.testing.util import SphinxTestApp @@ -20,7 +22,7 @@ def test_todo(app: SphinxTestApp) -> None: todos = [] - def on_todo_defined(app, node): + def on_todo_defined(app: Sphinx, node: todo_node) -> None: todos.append(node) app.connect('todo-defined', on_todo_defined) @@ -62,7 +64,7 @@ def on_todo_defined(app, node): def test_todo_not_included(app: SphinxTestApp) -> None: todos = [] - def on_todo_defined(app, node): + def on_todo_defined(app: Sphinx, node: todo_node) -> None: todos.append(node) app.connect('todo-defined', on_todo_defined) diff --git a/tests/test_extensions/test_ext_viewcode.py b/tests/test_extensions/test_ext_viewcode.py index eb8b5b141d5..03493dda4ff 100644 --- a/tests/test_extensions/test_ext_viewcode.py +++ b/tests/test_extensions/test_ext_viewcode.py @@ -9,9 +9,8 @@ import pygments import pytest -from sphinx.testing.util import SphinxTestApp - if TYPE_CHECKING: + from sphinx.application import Sphinx from sphinx.testing.util import SphinxTestApp @@ -130,7 +129,9 @@ def test_linkcode(app: SphinxTestApp) -> None: @pytest.mark.sphinx('html', testroot='ext-viewcode-find', freshenv=True) def test_local_source_files(app: SphinxTestApp) -> None: - def find_source(app, modname): + def find_source( + app: Sphinx, modname: str + ) -> tuple[str, dict[str, tuple[str, int, int]]]: if modname == 'not_a_package': source = app.srcdir / 'not_a_package/__init__.py' tags = { @@ -174,7 +175,7 @@ def find_source(app, modname): @pytest.mark.sphinx('html', testroot='ext-viewcode-find-package', freshenv=True) -def test_find_local_package_import_path(app, status, warning): +def test_find_local_package_import_path(app: Sphinx) -> None: app.build(force_all=True) result = (app.outdir / 'index.html').read_text(encoding='utf8') diff --git a/tests/test_highlighting.py b/tests/test_highlighting.py index 5b7ee2c8def..41dd8395f90 100644 --- a/tests/test_highlighting.py +++ b/tests/test_highlighting.py @@ -14,6 +14,11 @@ from sphinx.highlighting import PygmentsBridge if TYPE_CHECKING: + from collections.abc import Iterable + from typing import TextIO + + from pygments.token import _TokenType + from sphinx.testing.util import SphinxTestApp if tuple(map(int, pygments.__version__.split('.')[:2])) < (2, 18): @@ -34,14 +39,12 @@ class MyLexer(RegexLexer): class MyFormatter(HtmlFormatter[str]): - def format(self, tokensource, outfile): - for tok in tokensource: - outfile.write(tok[1]) - - -class ComplainOnUnhighlighted(PygmentsBridge): - def unhighlighted(self, source): - raise AssertionError('should highlight %r' % source) + def format( + self, + tokensource: Iterable[tuple[_TokenType, str]], + outfile: TextIO, + ) -> None: + outfile.writelines(tok[1] for tok in tokensource) @pytest.mark.sphinx('html', testroot='root') @@ -54,7 +57,7 @@ def test_add_lexer(app: SphinxTestApp) -> None: def test_detect_interactive() -> None: - bridge = ComplainOnUnhighlighted('html') + bridge = PygmentsBridge('html') blocks = [ """ >>> testing() @@ -83,7 +86,7 @@ def test_set_formatter() -> None: @mock.patch('sphinx.highlighting.logger') -def test_default_highlight(logger): +def test_default_highlight(logger: mock.Mock) -> None: bridge = PygmentsBridge('html') # default: highlights as python3 diff --git a/tests/test_intl/test_catalogs.py b/tests/test_intl/test_catalogs.py index 022d5c6a64f..200e8d95286 100644 --- a/tests/test_intl/test_catalogs.py +++ b/tests/test_intl/test_catalogs.py @@ -9,11 +9,14 @@ import pytest if TYPE_CHECKING: + from collections.abc import Iterator + + from sphinx.testing.fixtures import _app_params from sphinx.testing.util import SphinxTestApp @pytest.fixture -def _setup_test(app_params): +def _setup_test(app_params: _app_params) -> Iterator[None]: assert isinstance(app_params.kwargs['srcdir'], Path) srcdir = app_params.kwargs['srcdir'] src_locale_dir = srcdir / 'xx' / 'LC_MESSAGES' diff --git a/tests/test_intl/test_intl.py b/tests/test_intl/test_intl.py index d43c029d4d6..c823a6a3b44 100644 --- a/tests/test_intl/test_intl.py +++ b/tests/test_intl/test_intl.py @@ -22,11 +22,17 @@ from sphinx.testing.util import assert_node, etree_parse from sphinx.util.nodes import NodeMatcher +from tests.utils import extract_element, extract_node + if TYPE_CHECKING: - from collections.abc import Iterator + import xml.etree.ElementTree as ET + from collections.abc import Callable, Iterator from io import StringIO from pathlib import Path + from sphinx.testing.fixtures import _app_params + from sphinx.testing.util import SphinxTestApp + _CATALOG_LOCALE = 'xx' sphinx_intl = pytest.mark.sphinx( @@ -39,14 +45,14 @@ ) -def read_po(pathname): +def read_po(pathname: Path) -> Catalog: with open(pathname, encoding='utf-8') as f: return pofile.read_po(f) -def write_mo(pathname, po): +def write_mo(pathname: Path, po: Catalog) -> None: with open(pathname, 'wb') as f: - return mofile.write_mo(f, po) + mofile.write_mo(f, po) def _set_mtime_ns(target: Path, value: int) -> int: @@ -54,33 +60,39 @@ def _set_mtime_ns(target: Path, value: int) -> int: return target.stat().st_mtime_ns -def _get_bom_intl_path(app): - basedir = app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' +def _get_bom_intl_path(srcdir: Path) -> tuple[Path, Path]: + basedir = srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' return basedir / 'bom.po', basedir / 'bom.mo' -def _get_update_targets(app): +def _get_update_targets(app: SphinxTestApp) -> tuple[set[str], set[str], set[str]]: app.env.find_files(app.config, app.builder) added, changed, removed = app.env.get_outdated_files(config_changed=False) return added, changed, removed @pytest.fixture(autouse=True) -def _info(app): +def _info(app: SphinxTestApp) -> Iterator[None]: yield - print('# language:', app.config.language) - print('# locale_dirs:', app.config.locale_dirs) + print(f'# language: {app.config.language}') + print(f'# locale_dirs: {app.config.locale_dirs}') -def elem_gettexts(elem): +def elem_gettexts(elem: ET.Element) -> list[str]: return list(filter(None, map(str.strip, elem.itertext()))) -def elem_getref(elem): +def elem_getref(elem: ET.Element) -> str | None: return elem.attrib.get('refid') or elem.attrib.get('refuri') -def assert_elem(elem, texts=None, refs=None, names=None): +def assert_elem( + elem: ET.Element, + *, + texts: list[str] | None = None, + refs: list[str] | None = None, + names: list[str] | None = None, +) -> None: if texts is not None: _texts = elem_gettexts(elem) assert _texts == texts @@ -88,11 +100,11 @@ def assert_elem(elem, texts=None, refs=None, names=None): _refs = [elem_getref(x) for x in elem.findall('reference')] assert _refs == refs if names is not None: - _names = elem.attrib.get('names').split() + _names = elem.attrib['names'].split() assert _names == names -def assert_count(expected_expr, result, count): +def assert_count(expected_expr: str, result: str, count: int) -> None: find_pair = (expected_expr, result) assert len(re.findall(*find_pair)) == count, find_pair @@ -100,7 +112,7 @@ def assert_count(expected_expr, result, count): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_emit_warnings(app): +def test_text_emit_warnings(app: SphinxTestApp) -> None: app.build() # test warnings in translation warnings = getwarning(app.warning) @@ -116,7 +128,7 @@ def test_text_emit_warnings(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_warning_node(app): +def test_text_warning_node(app: SphinxTestApp) -> None: app.build() # test warnings in translation result = (app.outdir / 'warnings.txt').read_text(encoding='utf8') @@ -131,7 +143,7 @@ def test_text_warning_node(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_title_underline(app): +def test_text_title_underline(app: SphinxTestApp) -> None: app.build() # --- simple translation; check title underlines result = (app.outdir / 'bom.txt').read_text(encoding='utf8') @@ -146,7 +158,7 @@ def test_text_title_underline(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_subdirs(app): +def test_text_subdirs(app: SphinxTestApp) -> None: app.build() # --- check translation in subdirs result = (app.outdir / 'subdir' / 'index.txt').read_text(encoding='utf8') @@ -156,7 +168,7 @@ def test_text_subdirs(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_inconsistency_warnings(app): +def test_text_inconsistency_warnings(app: SphinxTestApp) -> None: app.build() # --- check warnings for inconsistency in number of references result = (app.outdir / 'refs_inconsistency.txt').read_text(encoding='utf8') @@ -166,9 +178,13 @@ def test_text_inconsistency_warnings(app): '\n* FOR CITATION [ref3].\n' '\n* reference FOR reference.\n' '\n* ORPHAN REFERENCE: I18N WITH REFS INCONSISTENCY.\n' + '\n* the [refs] [translations] [order] is ignored.\n' '\n[1] THIS IS A AUTO NUMBERED FOOTNOTE.\n' '\n[ref2] THIS IS A CITATION.\n' '\n[100] THIS IS A NUMBERED FOOTNOTE.\n' + '\n[order] order\n' + '\n[refs] references\n' + '\n[translations] translations\n' ) assert result == expect @@ -192,6 +208,12 @@ def test_text_inconsistency_warnings(app): 'translated': '\\[\\]', } + warning_fmt + % { + 'reftype': 'citation references', + 'original': "\\['\\[ref2\\]_'\\]", + 'translated': "\\['\\[ref3\\]_'\\]", + } + + warning_fmt % { 'reftype': 'references', 'original': "\\['reference_'\\]", @@ -224,7 +246,7 @@ def test_text_inconsistency_warnings(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_noqa(app): +def test_noqa(app: SphinxTestApp) -> None: app.build() result = (app.outdir / 'noqa.txt').read_text(encoding='utf8') expect = r"""FIRST SECTION @@ -250,7 +272,7 @@ def test_noqa(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_literalblock_warnings(app): +def test_text_literalblock_warnings(app: SphinxTestApp) -> None: app.build() # --- check warning for literal block result = (app.outdir / 'literalblock.txt').read_text(encoding='utf8') @@ -277,7 +299,7 @@ def test_text_literalblock_warnings(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_definition_terms(app): +def test_text_definition_terms(app: SphinxTestApp) -> None: app.build() # --- definition terms: regression test for # https://github.com/sphinx-doc/sphinx/issues/975, @@ -302,7 +324,7 @@ def test_text_definition_terms(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_glossary_term(app): +def test_text_glossary_term(app: SphinxTestApp) -> None: app.build() # --- glossary terms: regression test for # https://github.com/sphinx-doc/sphinx/issues/1090 @@ -338,7 +360,7 @@ def test_text_glossary_term(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_glossary_term_inconsistencies(app): +def test_text_glossary_term_inconsistencies(app: SphinxTestApp) -> None: app.build() # --- glossary term inconsistencies: regression test for # https://github.com/sphinx-doc/sphinx/issues/1090 @@ -372,10 +394,29 @@ def test_text_glossary_term_inconsistencies(app): ) +@sphinx_intl +@pytest.mark.sphinx('text', testroot='intl') +@pytest.mark.test_params(shared_result='test_intl_basic') +def test_text_refs_reordered_no_warning(app: SphinxTestApp) -> None: + app.build() + # --- refs_reordered: verify no inconsistency warnings + result = (app.outdir / 'refs_reordered.txt').read_text(encoding='utf8') + # Verify the translation was applied + assert 'MULTIPLE REFS REORDERED' in result + assert 'SINGLE REF WITH TRANSLATED DISPLAY TEXT' in result + + warnings = getwarning(app.warning) + # Should NOT have any inconsistent_references warnings for refs_reordered.txt + unexpected_warning_expr = '.*/refs_reordered.txt.*inconsistent.*references' + assert not re.search(unexpected_warning_expr, warnings), ( + f'Unexpected warning found: {warnings!r}' + ) + + @sphinx_intl @pytest.mark.sphinx('gettext', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_gettext') -def test_gettext_section(app): +def test_gettext_section(app: SphinxTestApp) -> None: app.build() # --- section expect = read_po(app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' / 'section.po') @@ -388,19 +429,22 @@ def test_gettext_section(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_section(app): +def test_text_section(app: SphinxTestApp) -> None: app.build() # --- section result = (app.outdir / 'section.txt').read_text(encoding='utf8') expect = read_po(app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' / 'section.po') - for expect_msg in (msg for msg in expect if msg.id): + for expect_msg in expect: + if not expect_msg.id: + continue + assert isinstance(expect_msg.string, str) assert expect_msg.string in result @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_seealso(app): +def test_text_seealso(app: SphinxTestApp) -> None: app.build() # --- seealso result = (app.outdir / 'seealso.txt').read_text(encoding='utf8') @@ -419,7 +463,7 @@ def test_text_seealso(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_figure_captions(app): +def test_text_figure_captions(app: SphinxTestApp) -> None: app.build() # --- figure captions: regression test for # https://github.com/sphinx-doc/sphinx/issues/940 @@ -466,7 +510,7 @@ def test_text_figure_captions(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_rubric(app): +def test_text_rubric(app: SphinxTestApp) -> None: app.build() # --- rubric: regression test for pull request # https://github.com/sphinx-doc/sphinx/issues/190 @@ -487,7 +531,7 @@ def test_text_rubric(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_docfields(app): +def test_text_docfields(app: SphinxTestApp) -> None: app.build() # --- docfields result = (app.outdir / 'docfields.txt').read_text(encoding='utf8') @@ -518,7 +562,7 @@ def test_text_docfields(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_admonitions(app): +def test_text_admonitions(app: SphinxTestApp) -> None: app.build() # --- admonitions # https://github.com/sphinx-doc/sphinx/issues/1206: @@ -549,7 +593,7 @@ def test_text_admonitions(app): @sphinx_intl @pytest.mark.sphinx('gettext', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_gettext') -def test_gettext_toctree(app): +def test_gettext_toctree(app: SphinxTestApp) -> None: app.build() # --- toctree (index.rst) expect = read_po(app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' / 'index.po') @@ -568,7 +612,7 @@ def test_gettext_toctree(app): @sphinx_intl @pytest.mark.sphinx('gettext', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_gettext') -def test_gettext_table(app): +def test_gettext_table(app: SphinxTestApp) -> None: app.build() # --- toctree expect = read_po(app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' / 'table.po') @@ -581,19 +625,22 @@ def test_gettext_table(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_table(app): +def test_text_table(app: SphinxTestApp) -> None: app.build() # --- toctree result = (app.outdir / 'table.txt').read_text(encoding='utf8') expect = read_po(app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' / 'table.po') - for expect_msg in (msg for msg in expect if msg.id): + for expect_msg in expect: + if not expect_msg.id: + continue + assert isinstance(expect_msg.string, str) assert expect_msg.string in result @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_toctree(app): +def test_text_toctree(app: SphinxTestApp) -> None: app.build() # --- toctree (index.rst) # Note: index.rst contains contents that is not shown in text. @@ -603,14 +650,17 @@ def test_text_toctree(app): # --- toctree (toctree.rst) result = (app.outdir / 'toctree.txt').read_text(encoding='utf8') expect = read_po(app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' / 'toctree.po') - for expect_msg in (m for m in expect if m.id): + for expect_msg in expect: + if not expect_msg.id: + continue + assert isinstance(expect_msg.string, str) assert expect_msg.string in result @sphinx_intl @pytest.mark.sphinx('gettext', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_gettext') -def test_gettext_topic(app): +def test_gettext_topic(app: SphinxTestApp) -> None: app.build() # --- topic expect = read_po(app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' / 'topic.po') @@ -623,19 +673,22 @@ def test_gettext_topic(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_topic(app): +def test_text_topic(app: SphinxTestApp) -> None: app.build() # --- topic result = (app.outdir / 'topic.txt').read_text(encoding='utf8') expect = read_po(app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' / 'topic.po') - for expect_msg in (msg for msg in expect if msg.id): + for expect_msg in expect: + if not expect_msg.id: + continue + assert isinstance(expect_msg.string, str) assert expect_msg.string in result @sphinx_intl @pytest.mark.sphinx('gettext', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_gettext') -def test_gettext_definition_terms(app): +def test_gettext_definition_terms(app: SphinxTestApp) -> None: app.build() # --- definition terms: regression test for # https://github.com/sphinx-doc/sphinx/issues/2198, @@ -652,7 +705,7 @@ def test_gettext_definition_terms(app): @sphinx_intl @pytest.mark.sphinx('gettext', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_gettext') -def test_gettext_glossary_terms(app): +def test_gettext_glossary_terms(app: SphinxTestApp) -> None: app.build() # --- glossary terms: regression test for # https://github.com/sphinx-doc/sphinx/issues/1090 @@ -668,7 +721,7 @@ def test_gettext_glossary_terms(app): @sphinx_intl @pytest.mark.sphinx('gettext', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_gettext') -def test_gettext_glossary_term_inconsistencies(app): +def test_gettext_glossary_term_inconsistencies(app: SphinxTestApp) -> None: app.build() # --- glossary term inconsistencies: regression test for # https://github.com/sphinx-doc/sphinx/issues/1090 @@ -684,13 +737,16 @@ def test_gettext_glossary_term_inconsistencies(app): @sphinx_intl @pytest.mark.sphinx('gettext', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_gettext') -def test_gettext_literalblock(app): +def test_gettext_literalblock(app: SphinxTestApp) -> None: app.build() # --- gettext builder always ignores ``only`` directive expect = read_po(app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' / 'literalblock.po') actual = read_po(app.outdir / 'literalblock.pot') actual_msg_ids = {msg.id for msg in actual if msg.id} # pyright: ignore[reportUnhashable] - for expect_msg in (msg for msg in expect if msg.id): + for expect_msg in expect: + if not expect_msg.id: + continue + assert isinstance(expect_msg.id, str) if len(expect_msg.id.splitlines()) == 1: # compare translations only labels assert expect_msg.id in actual_msg_ids @@ -701,7 +757,7 @@ def test_gettext_literalblock(app): @sphinx_intl @pytest.mark.sphinx('gettext', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_gettext') -def test_gettext_buildr_ignores_only_directive(app): +def test_gettext_buildr_ignores_only_directive(app: SphinxTestApp) -> None: app.build() # --- gettext builder always ignores ``only`` directive expect = read_po(app.srcdir / _CATALOG_LOCALE / 'LC_MESSAGES' / 'only.po') @@ -713,7 +769,7 @@ def test_gettext_buildr_ignores_only_directive(app): @sphinx_intl @pytest.mark.sphinx('html', testroot='intl', copy_test_root=True) -def test_node_translated_attribute(app): +def test_node_translated_attribute(app: SphinxTestApp) -> None: app.build(filenames=[app.srcdir / 'translation_progress.txt']) doctree = app.env.get_doctree('translation_progress') @@ -727,12 +783,13 @@ def test_node_translated_attribute(app): @sphinx_intl @pytest.mark.sphinx('html', testroot='intl', copy_test_root=True) -def test_translation_progress_substitution(app): +def test_translation_progress_substitution(app: SphinxTestApp) -> None: app.build(filenames=[app.srcdir / 'translation_progress.txt']) doctree = app.env.get_doctree('translation_progress') - assert doctree[0][19][0] == '68.75%' # 11 out of 16 lines are translated + # 11 out of 16 lines are translated + assert extract_node(doctree, 0, 19, 0) == '68.75%' @pytest.mark.sphinx( @@ -747,47 +804,48 @@ def test_translation_progress_substitution(app): }, copy_test_root=True, ) -def test_translation_progress_classes_true(app): +def test_translation_progress_classes_true(app: SphinxTestApp) -> None: app.build(filenames=[app.srcdir / 'translation_progress.txt']) doctree = app.env.get_doctree('translation_progress') # title - assert 'translated' in doctree[0][0]['classes'] + assert 'translated' in extract_element(doctree, 0, 0)['classes'] # translated lines - assert 'translated' in doctree[0][1]['classes'] - assert 'translated' in doctree[0][2]['classes'] - assert 'translated' in doctree[0][3]['classes'] - assert 'translated' in doctree[0][4]['classes'] - assert 'translated' in doctree[0][5]['classes'] - assert 'translated' in doctree[0][6]['classes'] - assert 'translated' in doctree[0][7]['classes'] - assert 'translated' in doctree[0][8]['classes'] + assert 'translated' in extract_element(doctree, 0, 1)['classes'] + assert 'translated' in extract_element(doctree, 0, 2)['classes'] + assert 'translated' in extract_element(doctree, 0, 3)['classes'] + assert 'translated' in extract_element(doctree, 0, 4)['classes'] + assert 'translated' in extract_element(doctree, 0, 5)['classes'] + assert 'translated' in extract_element(doctree, 0, 6)['classes'] + assert 'translated' in extract_element(doctree, 0, 7)['classes'] + assert 'translated' in extract_element(doctree, 0, 8)['classes'] - assert doctree[0][9]['classes'] == [] # comment node + assert extract_element(doctree, 0, 9)['classes'] == [] # comment node # idempotent - assert 'translated' in doctree[0][10]['classes'] - assert 'translated' in doctree[0][11]['classes'] + assert 'translated' in extract_element(doctree, 0, 10)['classes'] + assert 'translated' in extract_element(doctree, 0, 11)['classes'] - assert doctree[0][12]['classes'] == [] # comment node + assert extract_element(doctree, 0, 12)['classes'] == [] # comment node # untranslated - assert 'untranslated' in doctree[0][13]['classes'] - assert 'untranslated' in doctree[0][14]['classes'] + assert 'untranslated' in extract_element(doctree, 0, 13)['classes'] + assert 'untranslated' in extract_element(doctree, 0, 14)['classes'] - assert doctree[0][15]['classes'] == [] # comment node + assert extract_element(doctree, 0, 15)['classes'] == [] # comment node # missing - assert 'untranslated' in doctree[0][16]['classes'] - assert 'untranslated' in doctree[0][17]['classes'] + assert 'untranslated' in extract_element(doctree, 0, 16)['classes'] + assert 'untranslated' in extract_element(doctree, 0, 17)['classes'] - assert doctree[0][18]['classes'] == [] # comment node + assert extract_element(doctree, 0, 18)['classes'] == [] # comment node # substitution reference - assert 'untranslated' in doctree[0][19]['classes'] + assert 'untranslated' in extract_element(doctree, 0, 19)['classes'] + assert isinstance(doctree[0], nodes.Element) assert len(doctree[0]) == 20 @@ -846,13 +904,14 @@ def mock_time_and_i18n() -> Iterator[tuple[pytest.MonkeyPatch, _MockClock]]: # save the 'original' definition catalog_write_mo = CatalogInfo.write_mo - def mock_write_mo(self, locale, use_fuzzy=False): + def mock_write_mo(self: CatalogInfo, locale: str, use_fuzzy: bool = False) -> None: catalog_write_mo(self, locale, use_fuzzy) # ensure that the .mo file being written has a correct fake timestamp _set_mtime_ns(self.mo_path, time.time_ns()) # see: https://github.com/pytest-dev/pytest/issues/363 - with pytest.MonkeyPatch.context() as mock: + # see: https://github.com/astral-sh/ty/issues/1787 + with pytest.MonkeyPatch.context() as mock: # ty: ignore[missing-argument] clock: _MockClock if os.name == 'posix': clock = _MockUnixClock() @@ -878,13 +937,17 @@ def mock_write_mo(self, locale, use_fuzzy=False): freshenv=True, copy_test_root=True, ) -def test_dummy_should_rebuild_mo(mock_time_and_i18n, make_app, app_params): +def test_dummy_should_rebuild_mo( + mock_time_and_i18n: tuple[pytest.MonkeyPatch, _MockClock], + make_app: Callable[..., SphinxTestApp], + app_params: _app_params, +) -> None: mock, clock = mock_time_and_i18n assert os.name == 'posix' or clock.time() == 0 args, kwargs = app_params app = make_app(*args, **kwargs) - po_path, mo_path = _get_bom_intl_path(app) + po_path, mo_path = _get_bom_intl_path(app.srcdir) # creation time of the those files (order does not matter) bom_rst = app.srcdir / 'bom.rst' @@ -941,7 +1004,9 @@ def test_dummy_should_rebuild_mo(mock_time_and_i18n, make_app, app_params): freshenv=True, copy_test_root=True, ) -def test_gettext_dont_rebuild_mo(mock_time_and_i18n, app): +def test_gettext_dont_rebuild_mo( + mock_time_and_i18n: tuple[pytest.MonkeyPatch, _MockClock], app: SphinxTestApp +) -> None: mock, clock = mock_time_and_i18n assert os.name == 'posix' or clock.time() == 0 @@ -957,7 +1022,7 @@ def test_gettext_dont_rebuild_mo(mock_time_and_i18n, app): assert _set_mtime_ns(index_rst, index_rst_time) == index_rst_time # phase 1: create fake MO file in the src directory - po_path, mo_path = _get_bom_intl_path(app) + po_path, mo_path = _get_bom_intl_path(app.srcdir) write_mo(mo_path, read_po(po_path)) po_time = time.time_ns() assert _set_mtime_ns(po_path, po_time) == po_time @@ -987,7 +1052,7 @@ def test_gettext_dont_rebuild_mo(mock_time_and_i18n, app): @sphinx_intl @pytest.mark.sphinx('html', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_html_meta(app): +def test_html_meta(app: SphinxTestApp) -> None: app.build() # --- test for meta result = (app.outdir / 'index.html').read_text(encoding='utf8') @@ -1006,7 +1071,7 @@ def test_html_meta(app): @sphinx_intl @pytest.mark.sphinx('html', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_html_footnotes(app): +def test_html_footnotes(app: SphinxTestApp) -> None: app.build() # --- test for # https://github.com/sphinx-doc/sphinx/issues/955 @@ -1018,7 +1083,7 @@ def test_html_footnotes(app): @sphinx_intl @pytest.mark.sphinx('html', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_html_undefined_refs(app): +def test_html_undefined_refs(app: SphinxTestApp) -> None: app.build() # --- links to undefined reference result = (app.outdir / 'refs_inconsistency.html').read_text(encoding='utf8') @@ -1042,20 +1107,20 @@ def test_html_undefined_refs(app): @sphinx_intl @pytest.mark.sphinx('html', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_html_index_entries(app): +def test_html_index_entries(app: SphinxTestApp) -> None: app.build() # --- index entries: regression test for # https://github.com/sphinx-doc/sphinx/issues/976 result = (app.outdir / 'genindex.html').read_text(encoding='utf8') - def wrap(tag, keyword): + def wrap(tag: str, keyword: str) -> str: start_tag = '<%s[^>]*>' % tag end_tag = '' % tag return rf'{start_tag}\s*{keyword}\s*{end_tag}' - def wrap_nest(parenttag, childtag, keyword): - start_tag1 = '<%s[^>]*>' % parenttag - start_tag2 = '<%s[^>]*>' % childtag + def wrap_nest(parenttag: str, childtag: str, keyword: str) -> str: + start_tag1 = f'<{parenttag}[^>]*>' + start_tag2 = f'<{childtag}[^>]*>' return rf'{start_tag1}\s*{keyword}\s*{start_tag2}' expected_exprs = [ @@ -1087,43 +1152,42 @@ def wrap_nest(parenttag, childtag, keyword): @sphinx_intl @pytest.mark.sphinx('html', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_html_versionchanges(app): +def test_html_versionchanges(app: SphinxTestApp) -> None: app.build() # --- versionchanges result = (app.outdir / 'versionchange.html').read_text(encoding='utf8') - def get_content(result, name): - matched = re.search(r'
          \n*(.*?)
          ' % name, result, re.DOTALL) + def get_content(result: str, name: str) -> str: + matched = re.search(rf'
          \n*(.*?)
          ', result, re.DOTALL) if matched: return matched.group(1) - else: - return '' + return '' expect1 = ( """

          Deprecated since version 1.0: """ - """THIS IS THE FIRST PARAGRAPH OF DEPRECATED.

          \n""" - """

          THIS IS THE SECOND PARAGRAPH OF DEPRECATED.

          \n""" + """THIS IS THE FIRST PARAGRAPH OF VERSION-DEPRECATED.

          \n""" + """

          THIS IS THE SECOND PARAGRAPH OF VERSION-DEPRECATED.

          \n""" ) matched_content = get_content(result, 'deprecated') assert matched_content == expect1 expect2 = ( """

          Added in version 1.0: """ - """THIS IS THE FIRST PARAGRAPH OF VERSIONADDED.

          \n""" + """THIS IS THE FIRST PARAGRAPH OF VERSION-ADDED.

          \n""" ) matched_content = get_content(result, 'versionadded') assert matched_content == expect2 expect3 = ( """

          Changed in version 1.0: """ - """THIS IS THE FIRST PARAGRAPH OF VERSIONCHANGED.

          \n""" + """THIS IS THE FIRST PARAGRAPH OF VERSION-CHANGED.

          \n""" ) matched_content = get_content(result, 'versionchanged') assert matched_content == expect3 expect4 = ( """

          Removed in version 1.0: """ - """THIS IS THE FIRST PARAGRAPH OF VERSIONREMOVED.

          \n""" + """THIS IS THE FIRST PARAGRAPH OF VERSION-REMOVED.

          \n""" ) matched_content = get_content(result, 'versionremoved') assert matched_content == expect4 @@ -1132,7 +1196,7 @@ def get_content(result, name): @sphinx_intl @pytest.mark.sphinx('html', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_html_docfields(app): +def test_html_docfields(app: SphinxTestApp) -> None: app.build() # --- docfields # expect no error by build @@ -1142,7 +1206,7 @@ def test_html_docfields(app): @sphinx_intl @pytest.mark.sphinx('html', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_html_template(app): +def test_html_template(app: SphinxTestApp) -> None: app.build() # --- gettext template result = (app.outdir / 'contents.html').read_text(encoding='utf8') @@ -1153,14 +1217,14 @@ def test_html_template(app): @sphinx_intl @pytest.mark.sphinx('html', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_html_rebuild_mo(app): +def test_html_rebuild_mo(app: SphinxTestApp) -> None: app.build() # --- rebuild by .mo mtime app.build() _, updated, _ = _get_update_targets(app) assert updated == set() - _, bom_file = _get_bom_intl_path(app) + _, bom_file = _get_bom_intl_path(app.srcdir) old_mtime = bom_file.stat().st_mtime new_mtime = old_mtime + (dt := 5) os.utime(bom_file, (new_mtime, new_mtime)) @@ -1172,7 +1236,7 @@ def test_html_rebuild_mo(app): @sphinx_intl @pytest.mark.sphinx('xml', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_xml_footnotes(app): +def test_xml_footnotes(app: SphinxTestApp) -> None: app.build() # --- footnotes: regression test for fix # https://github.com/sphinx-doc/sphinx/issues/955, @@ -1183,7 +1247,7 @@ def test_xml_footnotes(app): para0 = secs[0].findall('paragraph') assert_elem( para0[0], - [ + texts=[ 'I18N WITH FOOTNOTE', 'INCLUDE THIS CONTENTS', '2', @@ -1195,7 +1259,7 @@ def test_xml_footnotes(app): '100', '.', ], - ['i18n-with-footnote', 'ref'], + refs=['i18n-with-footnote', 'ref'], ) # check node_id for footnote_references which refer same footnote @@ -1204,15 +1268,38 @@ def test_xml_footnotes(app): assert para0[0][4].attrib['ids'] != para0[0][6].attrib['ids'] footnote0 = secs[0].findall('footnote') - assert_elem(footnote0[0], ['1', 'THIS IS A AUTO NUMBERED FOOTNOTE.'], None, ['1']) - assert_elem(footnote0[1], ['100', 'THIS IS A NUMBERED FOOTNOTE.'], None, ['100']) assert_elem( - footnote0[2], ['2', 'THIS IS A AUTO NUMBERED NAMED FOOTNOTE.'], None, ['named'] + footnote0[0], + texts=['1', 'THIS IS A AUTO NUMBERED FOOTNOTE.'], + refs=None, + names=['1'], + ) + assert_elem( + footnote0[1], + texts=['100', 'THIS IS A NUMBERED FOOTNOTE.'], + refs=None, + names=['100'], + ) + assert_elem( + footnote0[2], + texts=['2', 'THIS IS A AUTO NUMBERED NAMED FOOTNOTE.'], + refs=None, + names=['named'], + ) + assert_elem( + footnote0[3], + texts=['*', 'THIS IS A AUTO SYMBOL FOOTNOTE.'], + refs=None, + names=None, ) - assert_elem(footnote0[3], ['*', 'THIS IS A AUTO SYMBOL FOOTNOTE.'], None, None) citation0 = secs[0].findall('citation') - assert_elem(citation0[0], ['ref', 'THIS IS A NAMED FOOTNOTE.'], None, ['ref']) + assert_elem( + citation0[0], + texts=['ref', 'THIS IS A NAMED FOOTNOTE.'], + refs=None, + names=['ref'], + ) warnings = getwarning(app.warning) warning_expr = '.*/footnote.xml:\\d*: SEVERE: Duplicate ID: ".*".\n' @@ -1224,7 +1311,7 @@ def test_xml_footnotes(app): @sphinx_intl @pytest.mark.sphinx('xml', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_xml_footnote_backlinks(app): +def test_xml_footnote_backlinks(app: SphinxTestApp) -> None: app.build() # --- footnote backlinks: i18n test for # https://github.com/sphinx-doc/sphinx/issues/1058 @@ -1238,14 +1325,14 @@ def test_xml_footnote_backlinks(app): footnote0 = secs[0].findall('footnote') for footnote in footnote0: ids = footnote.attrib.get('ids') - backrefs = footnote.attrib.get('backrefs').split() + backrefs = footnote.attrib['backrefs'].split() assert refid2id[ids] in backrefs @sphinx_intl @pytest.mark.sphinx('xml', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_xml_refs_in_python_domain(app): +def test_xml_refs_in_python_domain(app: SphinxTestApp) -> None: app.build() # --- refs in the Python domain et = etree_parse(app.outdir / 'refs_python_domain.xml') @@ -1256,15 +1343,15 @@ def test_xml_refs_in_python_domain(app): para0 = secs[0].findall('paragraph') assert_elem( para0[0], - ['SEE THIS DECORATOR:', 'sensitive_variables()', '.'], - ['sensitive.sensitive_variables'], + texts=['SEE THIS DECORATOR:', 'sensitive_variables()', '.'], + refs=['sensitive.sensitive_variables'], ) @sphinx_intl @pytest.mark.sphinx('xml', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_xml_keep_external_links(app): +def test_xml_keep_external_links(app: SphinxTestApp) -> None: app.build() # --- keep external links: regression test for # https://github.com/sphinx-doc/sphinx/issues/1044 @@ -1274,40 +1361,50 @@ def test_xml_keep_external_links(app): para0 = secs[0].findall('paragraph') # external link check assert_elem( - para0[0], ['EXTERNAL LINK TO', 'Python', '.'], ['https://python.org/index.html'] + para0[0], + texts=['EXTERNAL LINK TO', 'Python', '.'], + refs=['https://python.org/index.html'], ) # internal link check assert_elem( - para0[1], ['EXTERNAL LINKS', 'IS INTERNAL LINK.'], ['i18n-with-external-links'] + para0[1], + texts=['EXTERNAL LINKS', 'IS INTERNAL LINK.'], + refs=['i18n-with-external-links'], ) # inline link check assert_elem( - para0[2], ['INLINE LINK BY', 'THE SPHINX SITE', '.'], ['https://sphinx-doc.org'] + para0[2], + texts=['INLINE LINK BY', 'THE SPHINX SITE', '.'], + refs=['https://sphinx-doc.org'], ) # unnamed link check - assert_elem(para0[3], ['UNNAMED', 'LINK', '.'], ['https://google.com']) + assert_elem( + para0[3], + texts=['UNNAMED', 'LINK', '.'], + refs=['https://google.com'], + ) # link target swapped translation para1 = secs[1].findall('paragraph') assert_elem( para1[0], - ['LINK TO', 'external2', 'AND', 'external1', '.'], - ['https://www.google.com/external2', 'https://www.google.com/external1'], + texts=['LINK TO', 'external2', 'AND', 'external1', '.'], + refs=['https://www.google.com/external2', 'https://www.google.com/external1'], ) assert_elem( para1[1], - ['LINK TO', 'THE PYTHON SITE', 'AND', 'THE SPHINX SITE', '.'], - ['https://python.org', 'https://sphinx-doc.org'], + texts=['LINK TO', 'THE PYTHON SITE', 'AND', 'THE SPHINX SITE', '.'], + refs=['https://python.org', 'https://sphinx-doc.org'], ) # multiple references in the same line para2 = secs[2].findall('paragraph') assert_elem( para2[0], - [ + texts=[ 'LINK TO', 'EXTERNAL LINKS', ',', @@ -1320,7 +1417,7 @@ def test_xml_keep_external_links(app): 'THE PYTHON SITE', '.', ], - [ + refs=[ 'i18n-with-external-links', 'https://python.org/index.html', 'https://sphinx-doc.org', @@ -1333,7 +1430,7 @@ def test_xml_keep_external_links(app): @sphinx_intl @pytest.mark.sphinx('xml', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_xml_role_xref(app): +def test_xml_role_xref(app: SphinxTestApp) -> None: app.build() # --- role xref: regression test for # https://github.com/sphinx-doc/sphinx/issues/1090, @@ -1344,7 +1441,7 @@ def test_xml_role_xref(app): (para1,) = sec1.findall('paragraph') assert_elem( para1, - [ + texts=[ 'LINK TO', "I18N ROCK'N ROLE XREF", ',', @@ -1353,14 +1450,14 @@ def test_xml_role_xref(app): 'SOME NEW TERM', '.', ], - ['i18n-role-xref', 'index', 'glossary_terms#term-Some-term'], + refs=['i18n-role-xref', 'index', 'glossary_terms#term-Some-term'], ) (sec1_1,) = sec1.findall('section') (title,) = sec1_1.findall('title') assert_elem( title, - [ + texts=[ 'LINK TO', "I18N ROCK'N ROLE XREF", ',', @@ -1369,48 +1466,60 @@ def test_xml_role_xref(app): 'SOME NEW TERM', '.', ], - ['i18n-role-xref', 'index', 'glossary_terms#term-Some-term'], + refs=['i18n-role-xref', 'index', 'glossary_terms#term-Some-term'], ) para2 = sec2.findall('paragraph') assert_elem( para2[0], - ['LINK TO', 'SOME OTHER NEW TERM', 'AND', 'SOME NEW TERM', '.'], - ['glossary_terms#term-Some-other-term', 'glossary_terms#term-Some-term'], + texts=['LINK TO', 'SOME OTHER NEW TERM', 'AND', 'SOME NEW TERM', '.'], + refs=['glossary_terms#term-Some-other-term', 'glossary_terms#term-Some-term'], ) assert_elem( para2[1], - ['LINK TO', 'LABEL', 'AND', 'SAME TYPE LINKS', 'AND', 'SAME TYPE LINKS', '.'], - ['i18n-role-xref', 'same-type-links', 'same-type-links'], + texts=[ + 'LINK TO', + 'LABEL', + 'AND', + 'SAME TYPE LINKS', + 'AND', + 'SAME TYPE LINKS', + '.', + ], + refs=['i18n-role-xref', 'same-type-links', 'same-type-links'], ) assert_elem( para2[2], - ['LINK TO', 'I18N WITH GLOSSARY TERMS', 'AND', 'CONTENTS', '.'], - ['glossary_terms', 'index'], + texts=['LINK TO', 'I18N WITH GLOSSARY TERMS', 'AND', 'CONTENTS', '.'], + refs=['glossary_terms', 'index'], ) assert_elem( para2[3], - ['LINK TO', '--module', 'AND', '-m', '.'], - ['cmdoption-module', 'cmdoption-m'], + texts=['LINK TO', '--module', 'AND', '-m', '.'], + refs=['cmdoption-module', 'cmdoption-m'], ) assert_elem( para2[4], - ['LINK TO', 'env2', 'AND', 'env1', '.'], - ['envvar-env2', 'envvar-env1'], + texts=['LINK TO', 'env2', 'AND', 'env1', '.'], + refs=['envvar-env2', 'envvar-env1'], ) # TODO: how do I link token role to productionlist? - assert_elem(para2[5], ['LINK TO', 'token2', 'AND', 'token1', '.'], []) + assert_elem( + para2[5], + texts=['LINK TO', 'token2', 'AND', 'token1', '.'], + refs=[], + ) assert_elem( para2[6], - ['LINK TO', 'same-type-links', 'AND', 'i18n-role-xref', '.'], - ['same-type-links', 'i18n-role-xref'], + texts=['LINK TO', 'same-type-links', 'AND', 'i18n-role-xref', '.'], + refs=['same-type-links', 'i18n-role-xref'], ) @sphinx_intl @pytest.mark.sphinx('xml', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_xml_warnings(app): +def test_xml_warnings(app: SphinxTestApp) -> None: app.build() # warnings warnings = getwarning(app.warning) @@ -1422,7 +1531,7 @@ def test_xml_warnings(app): @sphinx_intl @pytest.mark.sphinx('xml', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_xml_label_targets(app): +def test_xml_label_targets(app: SphinxTestApp) -> None: app.build() # --- label targets: regression test for # https://github.com/sphinx-doc/sphinx/issues/1193, @@ -1433,7 +1542,7 @@ def test_xml_label_targets(app): para0 = secs[0].findall('paragraph') assert_elem( para0[0], - [ + texts=[ 'X SECTION AND LABEL', 'POINT TO', 'implicit-target', @@ -1443,13 +1552,13 @@ def test_xml_label_targets(app): 'section-and-label', '.', ], - ['implicit-target', 'section-and-label'], + refs=['implicit-target', 'section-and-label'], ) para1 = secs[1].findall('paragraph') assert_elem( para1[0], - [ + texts=[ 'X EXPLICIT-TARGET', 'POINT TO', 'explicit-target', @@ -1459,34 +1568,38 @@ def test_xml_label_targets(app): 'id1', '.', ], - ['explicit-target', 'id1'], + refs=['explicit-target', 'id1'], ) para2 = secs[2].findall('paragraph') assert_elem( para2[0], - ['X IMPLICIT SECTION NAME', 'POINT TO', 'implicit-section-name', '.'], - ['implicit-section-name'], + texts=['X IMPLICIT SECTION NAME', 'POINT TO', 'implicit-section-name', '.'], + refs=['implicit-section-name'], ) sec2 = secs[2].findall('section') para2_0 = sec2[0].findall('paragraph') - assert_elem(para2_0[0], ['`X DUPLICATED SUB SECTION`_', 'IS BROKEN LINK.'], []) + assert_elem( + para2_0[0], + texts=['`X DUPLICATED SUB SECTION`_', 'IS BROKEN LINK.'], + refs=[], + ) para3 = secs[3].findall('paragraph') assert_elem( para3[0], - [ + texts=[ 'X', 'bridge label', 'IS NOT TRANSLATABLE BUT LINKED TO TRANSLATED SECTION TITLE.', ], - ['label-bridged-target-section'], + refs=['label-bridged-target-section'], ) assert_elem( para3[1], - [ + texts=[ 'X', 'bridge label', 'POINT TO', @@ -1499,27 +1612,27 @@ def test_xml_label_targets(app): 'bridge label2', 'POINT TO CORRECT TARGET.', ], - ['label-bridged-target-section', 'section-and-label', 'section-and-label'], + refs=['label-bridged-target-section', 'section-and-label', 'section-and-label'], ) @sphinx_intl @pytest.mark.sphinx('xml', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_xml_strange_markup(app): +def test_xml_strange_markup(app: SphinxTestApp) -> None: app.build() et = etree_parse(app.outdir / 'markup.xml') secs = et.findall('section') (subsec1,) = secs[0].findall('section') (title1,) = subsec1.findall('title') - assert_elem(title1, ['1. TITLE STARTING WITH 1.']) + assert_elem(title1, texts=['1. TITLE STARTING WITH 1.']) @sphinx_intl @pytest.mark.sphinx('html', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_additional_targets_should_not_be_translated(app): +def test_additional_targets_should_not_be_translated(app: SphinxTestApp) -> None: if tuple(map(int, pygments.__version__.split('.')[:2])) >= (2, 19): sp = ' ' else: @@ -1607,7 +1720,7 @@ def test_additional_targets_should_not_be_translated(app): ], }, ) -def test_additional_targets_should_be_translated(app): +def test_additional_targets_should_be_translated(app: SphinxTestApp) -> None: if tuple(map(int, pygments.__version__.split('.')[:2])) >= (2, 19): sp = ' ' else: @@ -1708,7 +1821,9 @@ def test_additional_targets_should_be_translated(app): }, copy_test_root=True, ) -def test_additional_targets_should_be_translated_substitution_definitions(app): +def test_additional_targets_should_be_translated_substitution_definitions( + app: SphinxTestApp, +) -> None: app.build(force_all=True) # [prolog_epilog_substitution.txt] @@ -1727,7 +1842,7 @@ def test_additional_targets_should_be_translated_substitution_definitions(app): @sphinx_intl @pytest.mark.sphinx('text', testroot='intl') @pytest.mark.test_params(shared_result='test_intl_basic') -def test_text_references(app): +def test_text_references(app: SphinxTestApp) -> None: app.build(filenames=[app.srcdir / 'refs.txt']) warnings = app.warning.getvalue().replace(os.sep, '/') @@ -1745,7 +1860,7 @@ def test_text_references(app): }, copy_test_root=True, ) -def test_text_prolog_epilog_substitution(app): +def test_text_prolog_epilog_substitution(app: SphinxTestApp) -> None: app.build() result = (app.outdir / 'prolog_epilog_substitution.txt').read_text(encoding='utf8') @@ -1773,25 +1888,28 @@ def test_text_prolog_epilog_substitution(app): srcdir='test_intl_images', confoverrides={'language': _CATALOG_LOCALE}, ) -def test_image_glob_intl(app): +def test_image_glob_intl(app: SphinxTestApp) -> None: app.build() # index.rst doctree = app.env.get_doctree('index') assert_node( - doctree[0][1], nodes.image, uri='rimg.xx.png', candidates={'*': 'rimg.xx.png'} + extract_node(doctree, 0, 1), + nodes.image, + uri='rimg.xx.png', + candidates={'*': 'rimg.xx.png'}, ) - assert isinstance(doctree[0][2], nodes.figure) + assert isinstance(extract_node(doctree, 0, 2), nodes.figure) assert_node( - doctree[0][2][0], + extract_node(doctree, 0, 2, 0), nodes.image, uri='rimg.xx.png', candidates={'*': 'rimg.xx.png'}, ) assert_node( - doctree[0][3], + extract_node(doctree, 0, 3), nodes.image, uri='img.*', candidates={ @@ -1801,9 +1919,9 @@ def test_image_glob_intl(app): }, ) - assert isinstance(doctree[0][4], nodes.figure) + assert isinstance(extract_node(doctree, 0, 4), nodes.figure) assert_node( - doctree[0][4][0], + extract_node(doctree, 0, 4, 0), nodes.image, uri='img.*', candidates={ @@ -1816,14 +1934,14 @@ def test_image_glob_intl(app): # subdir/index.rst doctree = app.env.get_doctree('subdir/index') assert_node( - doctree[0][1], + extract_node(doctree, 0, 1), nodes.image, uri='subdir/rimg.xx.png', candidates={'*': 'subdir/rimg.xx.png'}, ) assert_node( - doctree[0][2], + extract_node(doctree, 0, 2), nodes.image, uri='subdir/svgimg.*', candidates={ @@ -1832,9 +1950,9 @@ def test_image_glob_intl(app): }, ) - assert isinstance(doctree[0][3], nodes.figure) + assert isinstance(extract_node(doctree, 0, 3), nodes.figure) assert_node( - doctree[0][3][0], + extract_node(doctree, 0, 3, 0), nodes.image, uri='subdir/svgimg.*', candidates={ @@ -1854,25 +1972,28 @@ def test_image_glob_intl(app): 'figure_language_filename': '{root}{ext}.{language}', }, ) -def test_image_glob_intl_using_figure_language_filename(app): +def test_image_glob_intl_using_figure_language_filename(app: SphinxTestApp) -> None: app.build() # index.rst doctree = app.env.get_doctree('index') assert_node( - doctree[0][1], nodes.image, uri='rimg.png.xx', candidates={'*': 'rimg.png.xx'} + extract_node(doctree, 0, 1), + nodes.image, + uri='rimg.png.xx', + candidates={'*': 'rimg.png.xx'}, ) - assert isinstance(doctree[0][2], nodes.figure) + assert isinstance(extract_node(doctree, 0, 2), nodes.figure) assert_node( - doctree[0][2][0], + extract_node(doctree, 0, 2, 0), nodes.image, uri='rimg.png.xx', candidates={'*': 'rimg.png.xx'}, ) assert_node( - doctree[0][3], + extract_node(doctree, 0, 3), nodes.image, uri='img.*', candidates={ @@ -1882,9 +2003,9 @@ def test_image_glob_intl_using_figure_language_filename(app): }, ) - assert isinstance(doctree[0][4], nodes.figure) + assert isinstance(extract_node(doctree, 0, 4), nodes.figure) assert_node( - doctree[0][4][0], + extract_node(doctree, 0, 4, 0), nodes.image, uri='img.*', candidates={ @@ -1897,14 +2018,14 @@ def test_image_glob_intl_using_figure_language_filename(app): # subdir/index.rst doctree = app.env.get_doctree('subdir/index') assert_node( - doctree[0][1], + extract_node(doctree, 0, 1), nodes.image, uri='subdir/rimg.png', candidates={'*': 'subdir/rimg.png'}, ) assert_node( - doctree[0][2], + extract_node(doctree, 0, 2), nodes.image, uri='subdir/svgimg.*', candidates={ @@ -1913,9 +2034,9 @@ def test_image_glob_intl_using_figure_language_filename(app): }, ) - assert isinstance(doctree[0][3], nodes.figure) + assert isinstance(extract_node(doctree, 0, 3), nodes.figure) assert_node( - doctree[0][3][0], + extract_node(doctree, 0, 3, 0), nodes.image, uri='subdir/svgimg.*', candidates={ @@ -1938,7 +2059,7 @@ def getwarning(warnings: StringIO) -> str: 'gettext_allow_fuzzy_translations': True, }, ) -def test_gettext_allow_fuzzy_translations(app): +def test_gettext_allow_fuzzy_translations(app: SphinxTestApp) -> None: locale_dir = app.srcdir / 'locales' / 'de' / 'LC_MESSAGES' locale_dir.mkdir(parents=True, exist_ok=True) with (locale_dir / 'index.po').open('wb') as f: @@ -1960,7 +2081,7 @@ def test_gettext_allow_fuzzy_translations(app): 'gettext_allow_fuzzy_translations': False, }, ) -def test_gettext_disallow_fuzzy_translations(app): +def test_gettext_disallow_fuzzy_translations(app: SphinxTestApp) -> None: locale_dir = app.srcdir / 'locales' / 'de' / 'LC_MESSAGES' locale_dir.mkdir(parents=True, exist_ok=True) with (locale_dir / 'index.po').open('wb') as f: @@ -1979,7 +2100,9 @@ def test_gettext_disallow_fuzzy_translations(app): confoverrides={'language': 'de', 'html_sidebars': {'**': ['searchbox.html']}}, copy_test_root=True, ) -def test_customize_system_message(make_app, app_params): +def test_customize_system_message( + make_app: Callable[..., SphinxTestApp], app_params: _app_params +) -> None: try: # clear translators cache locale.translators.clear() @@ -2010,7 +2133,9 @@ def test_customize_system_message(make_app, app_params): testroot='intl', confoverrides={'today_fmt': '%Y-%m-%d'}, ) -def test_customize_today_date_format(app, monkeypatch): +def test_customize_today_date_format( + app: SphinxTestApp, monkeypatch: pytest.MonkeyPatch +) -> None: with monkeypatch.context() as m: m.setenv('SOURCE_DATE_EPOCH', '1439131307') app.build() diff --git a/tests/test_intl/test_locale.py b/tests/test_intl/test_locale.py index c85c9f7078e..2addbfbfa24 100644 --- a/tests/test_intl/test_locale.py +++ b/tests/test_intl/test_locale.py @@ -9,17 +9,19 @@ from sphinx import locale if TYPE_CHECKING: - from collections.abc import Callable + from collections.abc import Callable, Iterator from pathlib import Path + from sphinx.testing.util import SphinxTestApp + @pytest.fixture(autouse=True) -def _cleanup_translations(): +def _cleanup_translations() -> Iterator[None]: yield locale.translators.clear() -def test_init(rootdir): +def test_init(rootdir: Path) -> None: # not initialized yet _ = locale.get_translation('myext') assert _('Hello world') == 'Hello world' @@ -48,7 +50,7 @@ def test_init(rootdir): assert _('Hello reST') == 'Hello reST' -def test_init_with_unknown_language(rootdir): +def test_init_with_unknown_language(rootdir: Path) -> None: locale.init([rootdir / 'test-locale' / 'locale1'], 'unknown', 'myext') _ = locale.get_translation('myext') assert _('Hello world') == 'Hello world' @@ -57,7 +59,7 @@ def test_init_with_unknown_language(rootdir): @pytest.mark.sphinx('html', testroot='root') -def test_add_message_catalog(app, rootdir): +def test_add_message_catalog(app: SphinxTestApp, rootdir: Path) -> None: app.config.language = 'en' app.add_message_catalog('myext', rootdir / 'test-locale' / 'locale1') _ = locale.get_translation('myext') @@ -73,7 +75,9 @@ def _empty_language_translation(rootdir: Path) -> Callable[[str], str]: return locale.get_translation(catalog) -def test_init_environment_language(rootdir, monkeypatch): +def test_init_environment_language( + rootdir: Path, monkeypatch: pytest.MonkeyPatch +) -> None: with monkeypatch.context() as m: m.setenv('LANGUAGE', 'en_US:en') _ = _empty_language_translation(rootdir) diff --git a/tests/test_markup/test_markup.py b/tests/test_markup/test_markup.py index 3a370ee46ad..4889ed6daa8 100644 --- a/tests/test_markup/test_markup.py +++ b/tests/test_markup/test_markup.py @@ -3,11 +3,10 @@ from __future__ import annotations import re -import warnings from types import SimpleNamespace import pytest -from docutils import frontend, nodes, utils +from docutils import nodes, utils from docutils.parsers.rst import Parser as RstParser from sphinx import addnodes @@ -17,73 +16,69 @@ from sphinx.testing.util import assert_node from sphinx.transforms import SphinxSmartQuotes from sphinx.util import texescape -from sphinx.util.docutils import sphinx_domains +from sphinx.util.docutils import _get_settings, sphinx_domains from sphinx.writers.html import HTMLWriter from sphinx.writers.html5 import HTML5Translator from sphinx.writers.latex import LaTeXTranslator, LaTeXWriter +from tests.utils import extract_node -@pytest.fixture -def settings(app): - env = app.env +TYPE_CHECKING = False +if TYPE_CHECKING: + from sphinx.environment import BuildEnvironment + from sphinx.testing.util import SphinxTestApp + from sphinx.util.docutils import _DocutilsSettings + + +def new_settings(env: BuildEnvironment) -> _DocutilsSettings: texescape.init() # otherwise done by the latex builder - with warnings.catch_warnings(): - warnings.filterwarnings('ignore', category=DeprecationWarning) - # DeprecationWarning: The frontend.OptionParser class will be replaced - # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later. - optparser = frontend.OptionParser( - components=(RstParser, HTMLWriter, LaTeXWriter), - defaults=default_settings, - ) - settings = optparser.get_default_values() + settings = _get_settings( + RstParser, HTMLWriter, LaTeXWriter, defaults=default_settings + ) settings.smart_quotes = True settings.env = env settings.env.current_document.docname = 'dummy' settings.contentsname = 'dummy' - domain_context = sphinx_domains(env) - domain_context.enable() - yield settings - domain_context.disable() + return settings -@pytest.fixture -def new_document(settings): - def create(): - document = utils.new_document('test data', settings) - document['file'] = 'dummy' - return document +def new_document(env: BuildEnvironment) -> nodes.document: + settings = new_settings(env) + document = utils.new_document('test data', settings) + document['file'] = 'dummy' + return document - return create +def new_inliner(env: BuildEnvironment) -> SimpleNamespace: + document = new_document(env) -@pytest.fixture -def inliner(new_document): - document = new_document() - document.reporter.get_source_and_line = lambda line=1: ('dummy.rst', line) - return SimpleNamespace(document=document, reporter=document.reporter) + def _get_source_and_line(line: int | None = 1) -> tuple[str, int | None]: + return 'dummy.rst', line + document.reporter.get_source_and_line = _get_source_and_line + return SimpleNamespace(document=document, reporter=document.reporter) -@pytest.fixture -def parse(new_document): - def parse_(rst): - document = new_document() - parser = RstParser() - parser.parse(rst, document) - SphinxSmartQuotes(document, startnode=None).apply() # type: ignore[no-untyped-call] - for msg in list(document.findall(nodes.system_message)): - if msg['level'] == 1: - msg.replace_self([]) - return document - return parse_ +def parse_rst(rst: str, *, env: BuildEnvironment) -> nodes.document: + document = new_document(env) + parser = RstParser() + domain_context = sphinx_domains(env) + domain_context.enable() + parser.parse(rst, document) + domain_context.disable() + SphinxSmartQuotes(document, startnode=None).apply() + for msg in list(document.findall(nodes.system_message)): + if msg['level'] == 1: + msg.replace_self([]) + return document # since we're not resolving the markup afterwards, these nodes may remain class ForgivingTranslator: - def visit_pending_xref(self, node): + def visit_pending_xref(self, node: nodes.Element) -> None: pass - def depart_pending_xref(self, node): + def depart_pending_xref(self, node: nodes.Element) -> None: pass @@ -95,67 +90,31 @@ class ForgivingLaTeXTranslator(LaTeXTranslator, ForgivingTranslator): pass -@pytest.fixture -def verify_re_html(app, parse): - def verify(rst, html_expected): - document = parse(rst) - html_translator = ForgivingHTMLTranslator(document, app.builder) - document.walkabout(html_translator) - html_translated = ''.join(html_translator.fragment).strip() - assert re.match(html_expected, html_translated), 'from ' + rst - - return verify - - -@pytest.fixture -def verify_re_latex(app, parse): - def verify(rst, latex_expected): - document = parse(rst) - app.builder = LaTeXBuilder(app, app.env) - app.builder.init() - theme = app.builder.themes.get('manual') - latex_translator = ForgivingLaTeXTranslator(document, app.builder, theme) - latex_translator.first_document = -1 # don't write \begin{document} - document.walkabout(latex_translator) - latex_translated = ''.join(latex_translator.body).strip() - assert re.match(latex_expected, latex_translated), 'from ' + repr(rst) - - return verify - - -@pytest.fixture -def verify_re(verify_re_html, verify_re_latex): - def verify_re_(rst, html_expected, latex_expected): - if html_expected: - verify_re_html(rst, html_expected) - if latex_expected: - verify_re_latex(rst, latex_expected) - - return verify_re_ - - -@pytest.fixture -def verify(verify_re_html, verify_re_latex): - def verify_(rst, html_expected, latex_expected): - if html_expected: - verify_re_html(rst, re.escape(html_expected) + '$') - if latex_expected: - verify_re_latex(rst, re.escape(latex_expected) + '$') - - return verify_ +def rst_to_html(rst: str, *, app: SphinxTestApp) -> str: + document = parse_rst(rst, env=app.env) + html_translator = ForgivingHTMLTranslator(document, app.builder) + document.walkabout(html_translator) + html_translated = ''.join(html_translator.fragment).strip() + return html_translated -@pytest.fixture -def get_verifier(verify, verify_re): - return {'verify': verify, 'verify_re': verify_re}.__getitem__ +def rst_to_latex(rst: str, *, app: SphinxTestApp) -> str: + document = parse_rst(rst, env=app.env) + app.builder = LaTeXBuilder(app, app.env) + app.builder.init() + theme = app.builder.themes.get('manual') + latex_translator = ForgivingLaTeXTranslator(document, app.builder, theme) + latex_translator.first_document = -1 # don't write \begin{document} + document.walkabout(latex_translator) + latex_translated = ''.join(latex_translator.body).strip() + return latex_translated @pytest.mark.parametrize( - ('type', 'rst', 'html_expected', 'latex_expected'), + ('rst', 'html_expected', 'latex_expected'), [ ( # cve role - 'verify', ':cve:`2020-10735`', ( '

          ' - 'code   sample

          ' - ), - r'\\sphinxAtStartPar\n\\sphinxcode{\\sphinxupquote{code sample}}', - ), ( # interpolation of arrows in menuselection - 'verify', ':menuselection:`a --> b`', '

          a \N{TRIANGULAR BULLET} b

          ', '\\sphinxAtStartPar\n\\sphinxmenuselection{a \\(\\rightarrow\\) b}', ), ( # interpolation of ampersands in menuselection - 'verify', ':menuselection:`&Foo -&&- &Bar`', ( '

          Foo ' @@ -317,7 +257,6 @@ def get_verifier(verify, verify_re): ), ( # interpolation of ampersands in guilabel - 'verify', ':guilabel:`&Foo -&&- &Bar`', ( '

          Foo ' @@ -330,21 +269,18 @@ def get_verifier(verify, verify_re): ), ( # no ampersands in guilabel - 'verify', ':guilabel:`Foo`', '

          Foo

          ', '\\sphinxAtStartPar\n\\sphinxguilabel{Foo}', ), ( # kbd role - 'verify', ':kbd:`space`', '

          space

          ', '\\sphinxAtStartPar\n\\sphinxkeyboard{\\sphinxupquote{space}}', ), ( # kbd role - 'verify', ':kbd:`Control+X`', ( '

          ' @@ -362,7 +298,6 @@ def get_verifier(verify, verify_re): ), ( # kbd role - 'verify', ':kbd:`Alt+^`', ( '

          ' @@ -380,7 +315,6 @@ def get_verifier(verify, verify_re): ), ( # kbd role - 'verify', ':kbd:`M-x M-s`', ( '

          ' @@ -406,28 +340,24 @@ def get_verifier(verify, verify_re): ), ( # kbd role - 'verify', ':kbd:`-`', '

          -

          ', '\\sphinxAtStartPar\n\\sphinxkeyboard{\\sphinxupquote{\\sphinxhyphen{}}}', ), ( # kbd role - 'verify', ':kbd:`Caps Lock`', '

          Caps Lock

          ', '\\sphinxAtStartPar\n\\sphinxkeyboard{\\sphinxupquote{Caps Lock}}', ), ( # kbd role - 'verify', ':kbd:`sys rq`', '

          sys rq

          ', '\\sphinxAtStartPar\n\\sphinxkeyboard{\\sphinxupquote{sys rq}}', ), ( # kbd role - 'verify', ':kbd:`⌘+⇧+M`', ( '

          ' @@ -447,29 +377,14 @@ def get_verifier(verify, verify_re): '\\sphinxkeyboard{\\sphinxupquote{M}}' ), ), - ( - # non-interpolation of dashes in option role - 'verify_re', - ':option:`--with-option`', - ( - '

          ' - '--with-option

          $' - ), - ( - r'\\sphinxAtStartPar\n' - r'\\sphinxcode{\\sphinxupquote{\\sphinxhyphen{}\\sphinxhyphen{}with\\sphinxhyphen{}option}}$' - ), - ), ( # verify smarty-pants quotes - 'verify', '"John"', '

          “John”

          ', '\\sphinxAtStartPar\n“John”', ), ( # ... but not in literal text - 'verify', '``"John"``', ( '

          ' @@ -479,21 +394,18 @@ def get_verifier(verify, verify_re): ), ( # verify classes for inline roles - 'verify', ':manpage:`mp(1)`', '

          mp(1)

          ', '\\sphinxAtStartPar\n\\sphinxstyleliteralemphasis{\\sphinxupquote{mp(1)}}', ), ( # correct escaping in normal mode - 'verify', 'Γ\\\\∞$', None, '\\sphinxAtStartPar\nΓ\\textbackslash{}\\(\\infty\\)\\$', ), ( # in verbatim code fragments - 'verify', '::\n\n @Γ\\∞${}', None, ( @@ -502,23 +414,14 @@ def get_verifier(verify, verify_re): '\\end{sphinxVerbatim}' ), ), - ( - # in URIs - 'verify_re', - '`test `_', - None, - r'\\sphinxAtStartPar\n\\sphinxhref{https://www.google.com/~me/}{test}.*', - ), ( # description list: simple - 'verify', 'term\n description', '
          \n
          term

          description

          \n
          \n
          ', None, ), ( # description list: with classifiers - 'verify', 'term : class1 : class2\n description', ( '
          \n
          termclass1' @@ -528,7 +431,6 @@ def get_verifier(verify, verify_re): ), ( # glossary (description list): multiple terms - 'verify', '.. glossary::\n\n term1\n term2\n description', ( '
          \n' @@ -540,40 +442,81 @@ def get_verifier(verify, verify_re): ), None, ), + ( + # backslash escaping (docutils 0.16) + r'4 backslashes \\\\', + r'

          4 backslashes \\

          ', + None, + ), ], ) -@pytest.mark.sphinx('html', testroot='root') -def test_inline(get_verifier, type, rst, html_expected, latex_expected): - verifier = get_verifier(type) - verifier(rst, html_expected, latex_expected) +@pytest.mark.sphinx('html', testroot='_blank') +def test_inline( + app: SphinxTestApp, rst: str, html_expected: str, latex_expected: str +) -> None: + if html_expected: + html_translated = rst_to_html(rst, app=app) + assert html_expected == html_translated, f'from {rst!r}' + if latex_expected: + latex_translated = rst_to_latex(rst, app=app) + assert latex_expected == latex_translated, f'from {rst!r}' @pytest.mark.parametrize( - ('type', 'rst', 'html_expected', 'latex_expected'), + ('rst', 'html_expected', 'latex_expected'), [ ( - 'verify', - r'4 backslashes \\\\', - r'

          4 backslashes \\

          ', + # correct interpretation of code with whitespace + '``code sample``', + ( + '

          ' + 'code   sample

          ' + ), + r'\\sphinxAtStartPar\n\\sphinxcode{\\sphinxupquote{code sample}}', + ), + ( + # non-interpolation of dashes in option role + ':option:`--with-option`', + ( + '

          ' + '--with-option

          $' + ), + ( + r'\\sphinxAtStartPar\n' + r'\\sphinxcode{\\sphinxupquote{\\sphinxhyphen{}\\sphinxhyphen{}with\\sphinxhyphen{}option}}$' + ), + ), + ( + # in URIs + '`test `_', None, + r'\\sphinxAtStartPar\n\\sphinxhref{https://www.google.com/~me/}{test}.*', ), ], ) -@pytest.mark.sphinx('html', testroot='root') -def test_inline_docutils16(get_verifier, type, rst, html_expected, latex_expected): - verifier = get_verifier(type) - verifier(rst, html_expected, latex_expected) +@pytest.mark.sphinx('html', testroot='_blank') +def test_inline_regex( + app: SphinxTestApp, rst: str, html_expected: str, latex_expected: str +) -> None: + if html_expected: + html_translated = rst_to_html(rst, app=app) + assert re.match(html_expected, html_translated), f'from {rst!r}' + if latex_expected: + latex_translated = rst_to_latex(rst, app=app) + assert re.match(latex_expected, latex_translated), f'from {rst!r}' -@pytest.mark.sphinx('html', testroot='root', confoverrides={'latex_engine': 'xelatex'}) +@pytest.mark.sphinx( + 'dummy', + testroot='_blank', + confoverrides={'latex_engine': 'xelatex'}, +) @pytest.mark.parametrize( - ('type', 'rst', 'html_expected', 'latex_expected'), + ('rst', 'latex_expected'), [ ( # in verbatim code fragments - 'verify', '::\n\n @Γ\\∞${}', - None, ( '\\begin{sphinxVerbatim}[commandchars=\\\\\\{\\}]\n' '@Γ\\PYGZbs{}∞\\PYGZdl{}\\PYGZob{}\\PYGZcb{}\n' @@ -583,23 +526,23 @@ def test_inline_docutils16(get_verifier, type, rst, html_expected, latex_expecte ], ) def test_inline_for_unicode_latex_engine( - get_verifier, type, rst, html_expected, latex_expected -): - verifier = get_verifier(type) - verifier(rst, html_expected, latex_expected) + app: SphinxTestApp, rst: str, latex_expected: str +) -> None: + latex_translated = rst_to_latex(rst, app=app) + assert latex_expected == latex_translated, f'from {rst!r}' -@pytest.mark.sphinx('html', testroot='root') -def test_samp_role(parse): +@pytest.mark.sphinx('dummy', testroot='_blank') +def test_samp_role(app: SphinxTestApp) -> None: # no braces text = ':samp:`a{b}c`' - doctree = parse(text) + doctree = parse_rst(text, env=app.env) assert_node( doctree[0], [nodes.paragraph, nodes.literal, ('a', [nodes.emphasis, 'b'], 'c')] ) # nested braces text = ':samp:`a{{b}}c`' - doctree = parse(text) + doctree = parse_rst(text, env=app.env) assert_node( doctree[0], [nodes.paragraph, nodes.literal, ('a', [nodes.emphasis, '{b'], '}c')], @@ -607,31 +550,31 @@ def test_samp_role(parse): # half-opened braces text = ':samp:`a{bc`' - doctree = parse(text) + doctree = parse_rst(text, env=app.env) assert_node(doctree[0], [nodes.paragraph, nodes.literal, 'a{bc']) # escaped braces text = ':samp:`a\\\\{b}c`' - doctree = parse(text) + doctree = parse_rst(text, env=app.env) assert_node(doctree[0], [nodes.paragraph, nodes.literal, 'a{b}c']) # no braces (whitespaces are keeped as is) text = ':samp:`code sample`' - doctree = parse(text) + doctree = parse_rst(text, env=app.env) assert_node(doctree[0], [nodes.paragraph, nodes.literal, 'code sample']) -@pytest.mark.sphinx('html', testroot='root') -def test_download_role(parse): +@pytest.mark.sphinx('dummy', testroot='_blank') +def test_download_role(app: SphinxTestApp) -> None: # implicit text = ':download:`sphinx.rst`' - doctree = parse(text) + doctree = parse_rst(text, env=app.env) assert_node( doctree[0], [nodes.paragraph, addnodes.download_reference, nodes.literal, 'sphinx.rst'], ) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), refdoc='dummy', refdomain='', reftype='download', @@ -639,17 +582,17 @@ def test_download_role(parse): reftarget='sphinx.rst', refwarn=False, ) - assert_node(doctree[0][0][0], classes=['xref', 'download']) + assert_node(extract_node(doctree, 0, 0, 0), classes=['xref', 'download']) # explicit text = ':download:`reftitle `' - doctree = parse(text) + doctree = parse_rst(text, env=app.env) assert_node( doctree[0], [nodes.paragraph, addnodes.download_reference, nodes.literal, 'reftitle'], ) assert_node( - doctree[0][0], + extract_node(doctree, 0, 0), refdoc='dummy', refdomain='', reftype='download', @@ -657,15 +600,16 @@ def test_download_role(parse): reftarget='sphinx.rst', refwarn=False, ) - assert_node(doctree[0][0][0], classes=['xref', 'download']) + assert_node(extract_node(doctree, 0, 0, 0), classes=['xref', 'download']) -@pytest.mark.sphinx('html', testroot='root') -def test_XRefRole(inliner): +@pytest.mark.sphinx('dummy', testroot='_blank') +def test_XRefRole(app: SphinxTestApp) -> None: + inliner = new_inliner(app.env) role = XRefRole() # implicit - doctrees, errors = role('ref', 'rawtext', 'text', 5, inliner, {}, []) + doctrees, errors = role('ref', 'rawtext', 'text', 5, inliner, {}, []) # type: ignore[arg-type] assert len(doctrees) == 1 assert_node(doctrees[0], [addnodes.pending_xref, nodes.literal, 'text']) assert_node( @@ -680,7 +624,7 @@ def test_XRefRole(inliner): assert errors == [] # explicit - doctrees, errors = role('ref', 'rawtext', 'title ', 5, inliner, {}, []) + doctrees, errors = role('ref', 'rawtext', 'title ', 5, inliner, {}, []) # type: ignore[arg-type] assert_node(doctrees[0], [addnodes.pending_xref, nodes.literal, 'title']) assert_node( doctrees[0], @@ -693,11 +637,11 @@ def test_XRefRole(inliner): ) # bang - doctrees, errors = role('ref', 'rawtext', '!title ', 5, inliner, {}, []) + doctrees, errors = role('ref', 'rawtext', '!title ', 5, inliner, {}, []) # type: ignore[arg-type] assert_node(doctrees[0], [nodes.literal, 'title ']) # refdomain - doctrees, errors = role('test:doc', 'rawtext', 'text', 5, inliner, {}, []) + doctrees, errors = role('test:doc', 'rawtext', 'text', 5, inliner, {}, []) # type: ignore[arg-type] assert_node(doctrees[0], [addnodes.pending_xref, nodes.literal, 'text']) assert_node( doctrees[0], @@ -711,7 +655,7 @@ def test_XRefRole(inliner): # fix_parens role = XRefRole(fix_parens=True) - doctrees, errors = role('ref', 'rawtext', 'text()', 5, inliner, {}, []) + doctrees, errors = role('ref', 'rawtext', 'text()', 5, inliner, {}, []) # type: ignore[arg-type] assert_node(doctrees[0], [addnodes.pending_xref, nodes.literal, 'text()']) assert_node( doctrees[0], @@ -725,7 +669,7 @@ def test_XRefRole(inliner): # lowercase role = XRefRole(lowercase=True) - doctrees, errors = role('ref', 'rawtext', 'TEXT', 5, inliner, {}, []) + doctrees, errors = role('ref', 'rawtext', 'TEXT', 5, inliner, {}, []) # type: ignore[arg-type] assert_node(doctrees[0], [addnodes.pending_xref, nodes.literal, 'TEXT']) assert_node( doctrees[0], @@ -739,23 +683,23 @@ def test_XRefRole(inliner): @pytest.mark.sphinx('dummy', testroot='prolog') -def test_rst_prolog(app): +def test_rst_prolog(app: SphinxTestApp) -> None: app.build(force_all=True) rst = app.env.get_doctree('restructuredtext') md = app.env.get_doctree('markdown') # rst_prolog - assert_node(rst[0], nodes.paragraph) - assert_node(rst[0][0], nodes.emphasis) - assert_node(rst[0][0][0], nodes.Text) - assert rst[0][0][0] == 'Hello world' + assert isinstance(rst[0], nodes.paragraph) + assert_node(extract_node(rst, 0, 0), nodes.emphasis) + assert_node(extract_node(rst, 0, 0, 0), nodes.Text) + assert extract_node(rst, 0, 0, 0) == 'Hello world' # rst_epilog - assert_node(rst[-1], nodes.section) - assert_node(rst[-1][-1], nodes.paragraph) - assert_node(rst[-1][-1][0], nodes.emphasis) - assert_node(rst[-1][-1][0][0], nodes.Text) - assert rst[-1][-1][0][0] == 'Good-bye world' + assert isinstance(rst[-1], nodes.section) + assert_node(extract_node(rst, -1, -1), nodes.paragraph) + assert_node(extract_node(rst, -1, -1, 0), nodes.emphasis) + assert_node(extract_node(rst, -1, -1, 0, 0), nodes.Text) + assert extract_node(rst, -1, -1, 0, 0) == 'Good-bye world' # rst_prolog & rst_epilog on exlucding reST parser assert not md.rawsource.startswith('*Hello world*.') @@ -763,12 +707,12 @@ def test_rst_prolog(app): @pytest.mark.sphinx('dummy', testroot='keep_warnings') -def test_keep_warnings_is_True(app): +def test_keep_warnings_is_True(app: SphinxTestApp) -> None: app.build(force_all=True) doctree = app.env.get_doctree('index') - assert_node(doctree[0], nodes.section) + assert isinstance(doctree[0], nodes.section) assert len(doctree[0]) == 2 - assert_node(doctree[0][1], nodes.system_message) + assert_node(extract_node(doctree, 0, 1), nodes.system_message) @pytest.mark.sphinx( @@ -776,49 +720,49 @@ def test_keep_warnings_is_True(app): testroot='keep_warnings', confoverrides={'keep_warnings': False}, ) -def test_keep_warnings_is_False(app): +def test_keep_warnings_is_False(app: SphinxTestApp) -> None: app.build(force_all=True) doctree = app.env.get_doctree('index') - assert_node(doctree[0], nodes.section) + assert isinstance(doctree[0], nodes.section) assert len(doctree[0]) == 1 @pytest.mark.sphinx('dummy', testroot='refonly_bullet_list') -def test_compact_refonly_bullet_list(app): +def test_compact_refonly_bullet_list(app: SphinxTestApp) -> None: app.build(force_all=True) doctree = app.env.get_doctree('index') - assert_node(doctree[0], nodes.section) + assert isinstance(doctree[0], nodes.section) assert len(doctree[0]) == 5 - assert doctree[0][1].astext() == 'List A:' - assert_node(doctree[0][2], nodes.bullet_list) - assert_node(doctree[0][2][0][0], addnodes.compact_paragraph) - assert doctree[0][2][0][0].astext() == 'genindex' + assert extract_node(doctree, 0, 1).astext() == 'List A:' + assert_node(extract_node(doctree, 0, 2), nodes.bullet_list) + assert_node(extract_node(doctree, 0, 2, 0, 0), addnodes.compact_paragraph) + assert extract_node(doctree, 0, 2, 0, 0).astext() == 'genindex' - assert doctree[0][3].astext() == 'List B:' - assert_node(doctree[0][4], nodes.bullet_list) - assert_node(doctree[0][4][0][0], nodes.paragraph) - assert doctree[0][4][0][0].astext() == 'Hello' + assert extract_node(doctree, 0, 3).astext() == 'List B:' + assert_node(extract_node(doctree, 0, 4), nodes.bullet_list) + assert_node(extract_node(doctree, 0, 4, 0, 0), nodes.paragraph) + assert extract_node(doctree, 0, 4, 0, 0).astext() == 'Hello' @pytest.mark.sphinx('dummy', testroot='default_role') -def test_default_role1(app): +def test_default_role1(app: SphinxTestApp) -> None: app.build(force_all=True) # default-role: pep doctree = app.env.get_doctree('index') - assert_node(doctree[0], nodes.section) - assert_node(doctree[0][1], nodes.paragraph) - assert_node(doctree[0][1][0], addnodes.index) - assert_node(doctree[0][1][1], nodes.target) - assert_node(doctree[0][1][2], nodes.reference, classes=['pep']) + assert isinstance(doctree[0], nodes.section) + assert_node(extract_node(doctree, 0, 1), nodes.paragraph) + assert_node(extract_node(doctree, 0, 1, 0), addnodes.index) + assert_node(extract_node(doctree, 0, 1, 1), nodes.target) + assert_node(extract_node(doctree, 0, 1, 2), nodes.reference, classes=['pep']) # no default-role doctree = app.env.get_doctree('foo') - assert_node(doctree[0], nodes.section) - assert_node(doctree[0][1], nodes.paragraph) - assert_node(doctree[0][1][0], nodes.title_reference) - assert_node(doctree[0][1][1], nodes.Text) + assert isinstance(doctree[0], nodes.section) + assert_node(extract_node(doctree, 0, 1), nodes.paragraph) + assert_node(extract_node(doctree, 0, 1, 0), nodes.title_reference) + assert_node(extract_node(doctree, 0, 1, 1), nodes.Text) @pytest.mark.sphinx( @@ -826,20 +770,20 @@ def test_default_role1(app): testroot='default_role', confoverrides={'default_role': 'guilabel'}, ) -def test_default_role2(app): +def test_default_role2(app: SphinxTestApp) -> None: app.build(force_all=True) # default-role directive is stronger than configratuion doctree = app.env.get_doctree('index') - assert_node(doctree[0], nodes.section) - assert_node(doctree[0][1], nodes.paragraph) - assert_node(doctree[0][1][0], addnodes.index) - assert_node(doctree[0][1][1], nodes.target) - assert_node(doctree[0][1][2], nodes.reference, classes=['pep']) + assert isinstance(doctree[0], nodes.section) + assert_node(extract_node(doctree, 0, 1), nodes.paragraph) + assert_node(extract_node(doctree, 0, 1, 0), addnodes.index) + assert_node(extract_node(doctree, 0, 1, 1), nodes.target) + assert_node(extract_node(doctree, 0, 1, 2), nodes.reference, classes=['pep']) # default_role changes the default behavior doctree = app.env.get_doctree('foo') - assert_node(doctree[0], nodes.section) - assert_node(doctree[0][1], nodes.paragraph) - assert_node(doctree[0][1][0], nodes.inline, classes=['guilabel']) - assert_node(doctree[0][1][1], nodes.Text) + assert isinstance(doctree[0], nodes.section) + assert_node(extract_node(doctree, 0, 1), nodes.paragraph) + assert_node(extract_node(doctree, 0, 1, 0), nodes.inline, classes=['guilabel']) + assert_node(extract_node(doctree, 0, 1, 1), nodes.Text) diff --git a/tests/test_markup/test_parser.py b/tests/test_markup/test_parser.py index eb8ccf24f1d..215fdf04dd6 100644 --- a/tests/test_markup/test_parser.py +++ b/tests/test_markup/test_parser.py @@ -2,6 +2,7 @@ from __future__ import annotations +from typing import TYPE_CHECKING from unittest.mock import Mock, patch import pytest @@ -9,14 +10,18 @@ from sphinx.parsers import RSTParser from sphinx.util.docutils import new_document +if TYPE_CHECKING: + from sphinx.testing.util import SphinxTestApp + @pytest.mark.sphinx('html', testroot='basic') @patch('docutils.parsers.rst.states.RSTStateMachine') -def test_RSTParser_prolog_epilog(RSTStateMachine, app): +def test_RSTParser_prolog_epilog(RSTStateMachine: Mock, app: SphinxTestApp) -> None: document = new_document('dummy.rst') document.settings = Mock(tab_width=8, language_code='') parser = RSTParser() - parser.set_application(app) + parser._config = app.config + parser._env = app.env # normal case text = 'hello Sphinx world\nSphinx is a document generator' @@ -33,8 +38,8 @@ def test_RSTParser_prolog_epilog(RSTStateMachine, app): parser.parse(text, document) (content, _), _ = RSTStateMachine().run.call_args assert list(content.xitems()) == [ - ('', 0, 'this is rst_prolog'), - ('', 1, 'hello reST!'), + ('', 0, 'this is rst_prolog'), + ('', 1, 'hello reST!'), ('', 0, ''), ('dummy.rst', 0, 'hello Sphinx world'), ('dummy.rst', 1, 'Sphinx is a document generator'), @@ -49,8 +54,8 @@ def test_RSTParser_prolog_epilog(RSTStateMachine, app): ('dummy.rst', 0, 'hello Sphinx world'), ('dummy.rst', 1, 'Sphinx is a document generator'), ('dummy.rst', 2, ''), - ('', 0, 'this is rst_epilog'), - ('', 1, 'good-bye reST!'), + ('', 0, 'this is rst_epilog'), + ('', 1, 'good-bye reST!'), ] # expandtabs / convert whitespaces diff --git a/tests/test_project.py b/tests/test_project.py index 5c4fb5cbafb..6d638265ff9 100644 --- a/tests/test_project.py +++ b/tests/test_project.py @@ -32,13 +32,13 @@ SUBDIR_DOCNAMES = {'subdir/excluded', 'subdir/images', 'subdir/includes'} -def test_project_discover_basic(rootdir): +def test_project_discover_basic(rootdir: Path) -> None: # basic case project = Project(rootdir / 'test-root', ['.txt']) assert project.discover() == DOCNAMES -def test_project_discover_exclude_patterns(rootdir): +def test_project_discover_exclude_patterns(rootdir: Path) -> None: project = Project(rootdir / 'test-root', ['.txt']) # exclude_paths option @@ -46,19 +46,19 @@ def test_project_discover_exclude_patterns(rootdir): assert project.discover(['.txt', 'subdir/*']) == DOCNAMES - SUBDIR_DOCNAMES -def test_project_discover_multiple_suffixes(rootdir): +def test_project_discover_multiple_suffixes(rootdir: Path) -> None: # multiple source_suffixes project = Project(rootdir / 'test-root', ['.txt', '.foo']) assert project.discover() == DOCNAMES | {'otherext'} -def test_project_discover_complicated_suffix(rootdir): +def test_project_discover_complicated_suffix(rootdir: Path) -> None: # complicated source_suffix project = Project(rootdir / 'test-root', ['.foo.png']) assert project.discover() == {'img'} -def test_project_discover_templates_path(rootdir): +def test_project_discover_templates_path(rootdir: Path) -> None: # templates_path project = Project(rootdir / 'test-root', ['.html']) assert project.discover() == { @@ -70,7 +70,7 @@ def test_project_discover_templates_path(rootdir): assert project.discover(['_templates']) == set() -def test_project_path2doc(rootdir): +def test_project_path2doc(rootdir: Path) -> None: project = Project(rootdir / 'test-basic', {'.rst': 'restructuredtext'}) assert project.path2doc('index.rst') == 'index' assert project.path2doc('index.foo') is None # unknown extension diff --git a/tests/test_pycode/test_pycode.py b/tests/test_pycode/test_pycode.py index 51b525f7b5b..4caf5019b94 100644 --- a/tests/test_pycode/test_pycode.py +++ b/tests/test_pycode/test_pycode.py @@ -41,7 +41,7 @@ def test_ModuleAnalyzer_for_file() -> None: assert analyzer.srcname == str(SPHINX_MODULE_PATH) -def test_ModuleAnalyzer_for_module(rootdir): +def test_ModuleAnalyzer_for_module(rootdir: Path) -> None: analyzer = ModuleAnalyzer.for_module('sphinx') assert analyzer.modname == 'sphinx' assert analyzer.srcname == str(SPHINX_MODULE_PATH) diff --git a/tests/test_pycode/test_pycode_ast.py b/tests/test_pycode/test_pycode_ast.py index 6ebc1a91099..9dd8c8f5d17 100644 --- a/tests/test_pycode/test_pycode_ast.py +++ b/tests/test_pycode/test_pycode_ast.py @@ -62,11 +62,13 @@ 'x[:, np.newaxis, :, :]'), # Index, Subscript, numpy extended syntax ('y[:, 1:3][np.array([0, 2, 4]), :]', 'y[:, 1:3][np.array([0, 2, 4]), :]'), # Index, 2x Subscript, numpy extended syntax + ('*tuple[str, int]', '*tuple[str, int]'), # Starred ], ) # fmt: skip -def test_unparse(source, expected): - module = ast.parse(source) - assert ast_unparse(module.body[0].value, source) == expected +def test_unparse(source: str, expected: str) -> None: + expr = ast.parse(source).body[0] + assert isinstance(expr, ast.Expr) + assert ast_unparse(expr.value, source) == expected def test_unparse_None() -> None: diff --git a/tests/test_quickstart.py b/tests/test_quickstart.py index a66b7c58128..3688984d9c2 100644 --- a/tests/test_quickstart.py +++ b/tests/test_quickstart.py @@ -20,7 +20,7 @@ warnfile = StringIO() -def setup_module(): +def setup_module() -> None: disable_colour() @@ -48,7 +48,7 @@ def input_(prompt: str) -> str: real_input: Callable[[str], str] = input -def teardown_module(): +def teardown_module() -> None: qs.term_input = real_input enable_colour() @@ -61,7 +61,7 @@ def test_do_prompt() -> None: 'Q5': 'no', 'Q6': 'foo', } - qs.term_input = mock_input(answers) # type: ignore[assignment] + qs.term_input = mock_input(answers) assert qs.do_prompt('Q1', default='v1') == 'v1' assert qs.do_prompt('Q3', default='v3_default') == 'v3' @@ -79,7 +79,7 @@ def test_do_prompt_inputstrip() -> None: 'Q3': 'N', 'Q4': 'N ', } - qs.term_input = mock_input(answers) # type: ignore[assignment] + qs.term_input = mock_input(answers) assert qs.do_prompt('Q1') == 'Y' assert qs.do_prompt('Q2') == 'Yes' @@ -91,12 +91,12 @@ def test_do_prompt_with_nonascii() -> None: answers = { 'Q1': '\u30c9\u30a4\u30c4', } - qs.term_input = mock_input(answers) # type: ignore[assignment] + qs.term_input = mock_input(answers) result = qs.do_prompt('Q1', default='\u65e5\u672c') assert result == '\u30c9\u30a4\u30c4' -def test_quickstart_defaults(tmp_path): +def test_quickstart_defaults(tmp_path: Path) -> None: answers = { 'Root path': str(tmp_path), 'Project name': 'Sphinx Test', @@ -127,7 +127,7 @@ def test_quickstart_defaults(tmp_path): assert (tmp_path / 'make.bat').is_file() -def test_quickstart_all_answers(tmp_path): +def test_quickstart_all_answers(tmp_path: Path) -> None: answers = { 'Root path': str(tmp_path), 'Separate source and build': 'y', @@ -185,7 +185,7 @@ def test_quickstart_all_answers(tmp_path): assert (tmp_path / 'source' / 'contents.txt').is_file() -def test_generated_files_eol(tmp_path): +def test_generated_files_eol(tmp_path: Path) -> None: answers = { 'Root path': str(tmp_path), 'Project name': 'Sphinx Test', @@ -205,7 +205,7 @@ def assert_eol(filename: Path, eol: str) -> None: assert_eol(tmp_path / 'Makefile', '\n') -def test_quickstart_and_build(tmp_path): +def test_quickstart_and_build(tmp_path: Path) -> None: answers = { 'Root path': str(tmp_path), 'Project name': 'Fullwidth characters: \u30c9\u30a4\u30c4', @@ -224,7 +224,7 @@ def test_quickstart_and_build(tmp_path): assert not warnings -def test_default_filename(tmp_path): +def test_default_filename(tmp_path: Path) -> None: answers = { 'Root path': str(tmp_path), 'Project name': '\u30c9\u30a4\u30c4', # Fullwidth characters only @@ -242,7 +242,7 @@ def test_default_filename(tmp_path): exec(conffile.read_text(encoding='utf8'), ns) # NoQA: S102 -def test_extensions(tmp_path): +def test_extensions(tmp_path: Path) -> None: qs.main([ '-q', '-p', @@ -261,7 +261,7 @@ def test_extensions(tmp_path): assert ns['extensions'] == ['foo', 'bar', 'baz'] -def test_exits_when_existing_confpy(monkeypatch): +def test_exits_when_existing_confpy(monkeypatch: pytest.MonkeyPatch) -> None: # The code detects existing conf.py with path.is_file() # so we mock it as True with pytest's monkeypatch monkeypatch.setattr('os.path.isfile', lambda path: True) diff --git a/tests/test_search.py b/tests/test_search.py index 22fa6ab7616..f94ae987bb7 100644 --- a/tests/test_search.py +++ b/tests/test_search.py @@ -3,7 +3,6 @@ from __future__ import annotations import json -import warnings from io import BytesIO from typing import TYPE_CHECKING @@ -44,7 +43,7 @@ def __init__(self, version: str, domains: DummyDomainsContainer) -> None: self.version = version self.domains = domains - def __getattr__(self, name: str): + def __getattr__(self, name: str) -> Any: if name.startswith('_search_index_'): setattr(self, name, {}) return getattr(self, name, {}) @@ -107,7 +106,7 @@ def test_meta_keys_are_handled_for_language_en(app: SphinxTestApp) -> None: searchindex = load_searchindex(app.outdir / 'searchindex.js') assert not is_registered_term(searchindex, 'thisnoteith') assert is_registered_term(searchindex, 'thisonetoo') - assert is_registered_term(searchindex, 'findthiskei') + assert is_registered_term(searchindex, 'findthiskey') assert is_registered_term(searchindex, 'thistoo') assert not is_registered_term(searchindex, 'onlygerman') assert is_registered_term(searchindex, 'notgerman') @@ -125,7 +124,7 @@ def test_meta_keys_are_handled_for_language_de(app: SphinxTestApp) -> None: searchindex = load_searchindex(app.outdir / 'searchindex.js') assert not is_registered_term(searchindex, 'thisnoteith') assert is_registered_term(searchindex, 'thisonetoo') - assert not is_registered_term(searchindex, 'findthiskei') + assert not is_registered_term(searchindex, 'findthiskey') assert not is_registered_term(searchindex, 'thistoo') assert is_registered_term(searchindex, 'onlygerman') assert not is_registered_term(searchindex, 'notgerman') @@ -144,7 +143,7 @@ def test_stemmer(app: SphinxTestApp) -> None: app.build(force_all=True) searchindex = load_searchindex(app.outdir / 'searchindex.js') print(searchindex) - assert is_registered_term(searchindex, 'findthisstemmedkei') + assert is_registered_term(searchindex, 'findthisstemmedkey') assert is_registered_term(searchindex, 'intern') @@ -155,8 +154,17 @@ def test_term_in_heading_and_section(app: SphinxTestApp) -> None: # if search term is in the title of one doc and in the text of another # both documents should be a hit in the search index as a title, # respectively text hit - assert '"textinhead":2' in searchindex - assert '"textinhead":0' in searchindex + assert '"textinhead":3' in searchindex + assert '"textinhead":1' in searchindex + + +@pytest.mark.sphinx('html', testroot='search') +def test_escaped_title(app: SphinxTestApp) -> None: + app.build(force_all=True) + searchindex = load_searchindex(app.outdir / 'searchindex.js') + print(searchindex) + assert 'escapedtitle' in searchindex['docnames'] + assert 'escaped title with < and > in it' in searchindex['titles'] @pytest.mark.sphinx('html', testroot='search') @@ -169,12 +177,7 @@ def test_term_in_raw_directive(app: SphinxTestApp) -> None: def test_IndexBuilder(): - with warnings.catch_warnings(): - warnings.filterwarnings('ignore', category=DeprecationWarning) - # DeprecationWarning: The frontend.OptionParser class will be replaced - # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later. - optparser = frontend.OptionParser(components=(rst.Parser,)) - settings = optparser.get_default_values() + settings = frontend.get_default_settings(rst.Parser) parser = rst.Parser() domain1 = DummyDomain( @@ -219,7 +222,6 @@ def test_IndexBuilder(): # dictionaries below may be iterated in arbitrary order by Python at # runtime. assert index._mapping == { - 'ar': {'docname1_1', 'docname1_2', 'docname2_1', 'docname2_2'}, 'fermion': {'docname1_1', 'docname1_2', 'docname2_1', 'docname2_2'}, 'comment': {'docname1_1', 'docname1_2', 'docname2_1', 'docname2_2'}, 'non': {'docname1_1', 'docname1_2', 'docname2_1', 'docname2_2'}, @@ -250,7 +252,6 @@ def test_IndexBuilder(): }, 'objtypes': {0: 'dummy1:objtype1', 1: 'dummy2:objtype1'}, 'terms': { - 'ar': [0, 1, 2, 3], 'comment': [0, 1, 2, 3], 'fermion': [0, 1, 2, 3], 'index': [0, 1, 2, 3], @@ -309,7 +310,6 @@ def test_IndexBuilder(): 'docname2_2': 'filename2_2', } assert index._mapping == { - 'ar': {'docname1_2', 'docname2_2'}, 'fermion': {'docname1_2', 'docname2_2'}, 'comment': {'docname1_2', 'docname2_2'}, 'non': {'docname1_2', 'docname2_2'}, @@ -338,7 +338,6 @@ def test_IndexBuilder(): }, 'objtypes': {0: 'dummy1:objtype1', 1: 'dummy2:objtype1'}, 'terms': { - 'ar': [0, 1], 'comment': [0, 1], 'fermion': [0, 1], 'index': [0, 1], @@ -398,7 +397,7 @@ def test_search_index_gen_zh(app: SphinxTestApp) -> None: def test_nosearch(app: SphinxTestApp) -> None: app.build() index = load_searchindex(app.outdir / 'searchindex.js') - assert index['docnames'] == ['index', 'nosearch', 'tocitem'] + assert index['docnames'] == ['escapedtitle', 'index', 'nosearch', 'tocitem'] # latex is in 'nosearch.rst', and nowhere else assert 'latex' not in index['terms'] # cat is in 'index.rst' but is marked with the 'no-search' class @@ -406,7 +405,7 @@ def test_nosearch(app: SphinxTestApp) -> None: # bat is indexed from 'index.rst' and 'tocitem.rst' (document IDs 0, 2), and # not from 'nosearch.rst' (document ID 1) assert 'bat' in index['terms'] - assert index['terms']['bat'] == [0, 2] + assert index['terms']['bat'] == [1, 3] @pytest.mark.sphinx( @@ -418,7 +417,7 @@ def test_nosearch(app: SphinxTestApp) -> None: def test_parallel(app: SphinxTestApp) -> None: app.build() index = load_searchindex(app.outdir / 'searchindex.js') - assert index['docnames'] == ['index', 'nosearch', 'tocitem'] + assert index['docnames'] == ['escapedtitle', 'index', 'nosearch', 'tocitem'] @pytest.mark.sphinx('html', testroot='search') @@ -466,7 +465,7 @@ def assert_is_sorted( assert_is_sorted(child, f'{path}[{i}]') -@pytest.mark.parametrize('directory', JAVASCRIPT_TEST_ROOTS) +@pytest.mark.parametrize('directory', JAVASCRIPT_TEST_ROOTS, ids=lambda p: p.name) def test_check_js_search_indexes(make_app, sphinx_test_tempdir, directory): app = make_app( 'html', diff --git a/tests/test_theming/test_templating.py b/tests/test_theming/test_templating.py index b2d6f0d6eae..4468c7e3aba 100644 --- a/tests/test_theming/test_templating.py +++ b/tests/test_theming/test_templating.py @@ -2,16 +2,23 @@ from __future__ import annotations +from typing import TYPE_CHECKING + import pytest -from sphinx.ext.autosummary.generate import setup_documenters +if TYPE_CHECKING: + from collections.abc import Callable + + from sphinx.testing.fixtures import _app_params + from sphinx.testing.util import SphinxTestApp @pytest.mark.sphinx('html', testroot='templating', copy_test_root=True) -def test_layout_overloading(make_app, app_params): +def test_layout_overloading( + make_app: Callable[..., SphinxTestApp], app_params: _app_params +) -> None: args, kwargs = app_params app = make_app(*args, **kwargs) - setup_documenters(app) app.build() result = (app.outdir / 'index.html').read_text(encoding='utf8') @@ -19,10 +26,11 @@ def test_layout_overloading(make_app, app_params): @pytest.mark.sphinx('html', testroot='templating', copy_test_root=True) -def test_autosummary_class_template_overloading(make_app, app_params): +def test_autosummary_class_template_overloading( + make_app: Callable[..., SphinxTestApp], app_params: _app_params +) -> None: args, kwargs = app_params app = make_app(*args, **kwargs) - setup_documenters(app) app.build() result = ( @@ -38,10 +46,11 @@ def test_autosummary_class_template_overloading(make_app, app_params): confoverrides={'autosummary_context': {'sentence': 'foobar'}}, copy_test_root=True, ) -def test_autosummary_context(make_app, app_params): +def test_autosummary_context( + make_app: Callable[..., SphinxTestApp], app_params: _app_params +) -> None: args, kwargs = app_params app = make_app(*args, **kwargs) - setup_documenters(app) app.build() result = ( diff --git a/tests/test_theming/test_theming.py b/tests/test_theming/test_theming.py index 173e0c9c64b..0237f5abb59 100644 --- a/tests/test_theming/test_theming.py +++ b/tests/test_theming/test_theming.py @@ -23,6 +23,8 @@ ) if TYPE_CHECKING: + from collections.abc import Callable + from sphinx.testing.util import SphinxTestApp HERE = Path(__file__).resolve().parent @@ -98,7 +100,7 @@ def test_theme_api(app: SphinxTestApp) -> None: assert not any(p.exists() for p in theme._tmp_dirs) -def test_nonexistent_theme_settings(tmp_path): +def test_nonexistent_theme_settings(tmp_path: Path) -> None: # Check that error occurs with a non-existent theme.toml or theme.conf # https://github.com/sphinx-doc/sphinx/issues/11668 with pytest.raises(ThemeError): @@ -150,21 +152,23 @@ def test_staticfiles(app: SphinxTestApp) -> None: testroot='theming', confoverrides={'html_theme': 'test-theme'}, ) -def test_dark_style(app, monkeypatch): +def test_dark_style(app: SphinxTestApp, monkeypatch: pytest.MonkeyPatch) -> None: monkeypatch.setattr(sphinx.builders.html, '_file_checksum', lambda o, f: '') - style = app.builder.dark_highlighter.formatter_args.get('style') + assert isinstance(app.builder, StandaloneHTMLBuilder) + assert app.builder.dark_highlighter is not None + style = app.builder.dark_highlighter.formatter_args['style'] assert style.__name__ == 'MonokaiStyle' app.build() assert (app.outdir / '_static' / 'pygments_dark.css').exists() - css_file, properties = app.registry.css_files[0] - assert css_file == 'pygments_dark.css' - assert 'media' in properties - assert properties['media'] == '(prefers-color-scheme: dark)' + css_file = app.builder._css_files[1] + assert css_file.filename == '_static/pygments_dark.css' + assert 'media' in css_file.attributes + assert css_file.attributes['media'] == '(prefers-color-scheme: dark)' - assert sorted(f.filename for f in app.builder._css_files) == [ + assert sorted(str(f.filename) for f in app.builder._css_files) == [ '_static/classic.css', '_static/pygments.css', '_static/pygments_dark.css', @@ -212,7 +216,12 @@ def test_theme_sidebars(app: SphinxTestApp) -> None: 'traditional', ], ) -def test_theme_builds(make_app, rootdir, sphinx_test_tempdir, theme_name): +def test_theme_builds( + make_app: Callable[..., SphinxTestApp], + rootdir: Path, + sphinx_test_tempdir: Path, + theme_name: str, +) -> None: """Test all the themes included with Sphinx build a simple project and produce valid XML.""" testroot_path = rootdir / 'test-basic' srcdir = sphinx_test_tempdir / f'test-theme-{theme_name}' diff --git a/tests/test_transforms/test_transforms_move_module_targets.py b/tests/test_transforms/test_transforms_move_module_targets.py index f64b7d6a500..839eb615adc 100644 --- a/tests/test_transforms/test_transforms_move_module_targets.py +++ b/tests/test_transforms/test_transforms_move_module_targets.py @@ -1,5 +1,7 @@ from __future__ import annotations +from typing import TYPE_CHECKING + import pytest from docutils import nodes @@ -7,6 +9,9 @@ from sphinx.testing.util import SphinxTestApp from sphinx.transforms import MoveModuleTargets +if TYPE_CHECKING: + from pathlib import Path + CONTENT_PY = """\ move-module-targets =================== @@ -29,7 +34,7 @@ ], ) @pytest.mark.usefixtures('rollback_sysmodules') -def test_move_module_targets(tmp_path, content): +def test_move_module_targets(tmp_path: Path, content: str) -> None: # Test for the MoveModuleTargets transform tmp_path.joinpath('conf.py').touch() tmp_path.joinpath('index.rst').write_text(content, encoding='utf-8') @@ -48,7 +53,7 @@ def test_move_module_targets(tmp_path, content): @pytest.mark.usefixtures('rollback_sysmodules') -def test_move_module_targets_no_section(tmp_path): +def test_move_module_targets_no_section(tmp_path: Path) -> None: # Test for the MoveModuleTargets transform tmp_path.joinpath('conf.py').touch() tmp_path.joinpath('index.rst').write_text( @@ -63,7 +68,7 @@ def test_move_module_targets_no_section(tmp_path): @pytest.mark.usefixtures('rollback_sysmodules') -def test_move_module_targets_disabled(tmp_path): +def test_move_module_targets_disabled(tmp_path: Path) -> None: # Test for the MoveModuleTargets transform tmp_path.joinpath('conf.py').touch() tmp_path.joinpath('index.rst').write_text(CONTENT_PY, encoding='utf-8') diff --git a/tests/test_transforms/test_transforms_post_transforms.py b/tests/test_transforms/test_transforms_post_transforms.py index 57c6beb6c96..2b839af336b 100644 --- a/tests/test_transforms/test_transforms_post_transforms.py +++ b/tests/test_transforms/test_transforms_post_transforms.py @@ -19,6 +19,9 @@ from _pytest.fixtures import SubRequest + from sphinx.application import Sphinx + from sphinx.builders import Builder + from sphinx.environment import BuildEnvironment from sphinx.testing.util import SphinxTestApp @@ -42,7 +45,12 @@ def test_nitpicky_warning(app: SphinxTestApp) -> None: freshenv=True, ) def test_missing_reference(app: SphinxTestApp) -> None: - def missing_reference(app_, env_, node_, contnode_): + def missing_reference( + app_: Sphinx, + env_: BuildEnvironment, + node_: addnodes.pending_xref, + contnode_: nodes.Node, + ) -> nodes.inline: assert app_ is app assert env_ is app.env assert node_['reftarget'] == 'io.StringIO' @@ -65,7 +73,12 @@ def missing_reference(app_, env_, node_, contnode_): freshenv=True, ) def test_missing_reference_conditional_pending_xref(app: SphinxTestApp) -> None: - def missing_reference(_app, _env, _node, contnode): + def missing_reference( + _app: Sphinx, + _env: BuildEnvironment, + _node: addnodes.pending_xref, + contnode: nodes.Node, + ) -> nodes.Node: return contnode app.warning.truncate(0) @@ -140,11 +153,13 @@ def translator_class(self, request: SubRequest) -> type[nodes.NodeVisitor]: class BaseCustomTranslatorClass(nodes.NodeVisitor): """Base class for a custom translator class, orthogonal to ``SphinxTranslator``.""" - def __init__(self, document, *_a): + def __init__( + self, document: nodes.document, _builder: Builder | None = None + ) -> None: super().__init__(document) # ignore other arguments - def dispatch_visit(self, node): + def dispatch_visit(self, node: nodes.Node) -> None: for node_class in node.__class__.__mro__: if method := getattr(self, f'visit_{node_class.__name__}', None): method(node) @@ -153,11 +168,11 @@ def dispatch_visit(self, node): logger.info('generic visit: %r', node.__class__.__name__) super().dispatch_visit(node) - def unknown_visit(self, node): + def unknown_visit(self, node: nodes.Node) -> None: logger.warning('unknown visit: %r', node.__class__.__name__) raise nodes.SkipDeparture # ignore unknown departure - def visit_document(self, node): + def visit_document(self, node: nodes.document) -> None: raise nodes.SkipDeparture # ignore departure def mark_node(self, node: nodes.Node) -> NoReturn: @@ -173,7 +188,7 @@ def mark_node(self, node: nodes.Node) -> NoReturn: visitor_methods = {f'visit_{tp.__name__}' for tp in desc_sig_elements_list} visitor_methods.update(f'visit_{name}' for name in add_visitor_method_for) class_dict = dict.fromkeys(visitor_methods, BaseCustomTranslatorClass.mark_node) - return type('CustomTranslatorClass', (BaseCustomTranslatorClass,), class_dict) + return type('CustomTranslatorClass', (BaseCustomTranslatorClass,), class_dict) # ty: ignore[invalid-return-type] @pytest.mark.parametrize( 'add_visitor_method_for', diff --git a/tests/test_transforms/test_transforms_post_transforms_images.py b/tests/test_transforms/test_transforms_post_transforms_images.py index 800fb3b986b..6a0e4e9ae8b 100644 --- a/tests/test_transforms/test_transforms_post_transforms_images.py +++ b/tests/test_transforms/test_transforms_post_transforms_images.py @@ -1,12 +1,16 @@ from __future__ import annotations from types import SimpleNamespace +from typing import TYPE_CHECKING from docutils import nodes from sphinx.transforms.post_transforms.images import ImageConverter from sphinx.util.docutils import new_document +if TYPE_CHECKING: + from pathlib import Path + WEBP_DATA = ( b'RIFF\xa8\x01\x00\x00WEBPVP8X\n\x00\x00\x00' b"\x10\x00\x00\x00\x0f\x00\x00\x0f\x00\x00ALPH\xc3\x00\x00\x00\x01'" @@ -33,9 +37,9 @@ ) -def test_guess_mimetype_webp(tmp_path): +def test_guess_mimetype_webp(tmp_path: Path) -> None: document = new_document('') - document.settings.env = SimpleNamespace(app=SimpleNamespace(srcdir=tmp_path)) + document.settings.env = SimpleNamespace(srcdir=tmp_path) converter = ImageConverter(document) file_webp = 'webp-image.webp' diff --git a/tests/test_transforms/test_transforms_reorder_nodes.py b/tests/test_transforms/test_transforms_reorder_nodes.py index aa9bee43d04..b81a47f5b86 100644 --- a/tests/test_transforms/test_transforms_reorder_nodes.py +++ b/tests/test_transforms/test_transforms_reorder_nodes.py @@ -56,8 +56,8 @@ def test_transforms_reorder_consecutive_target_and_index_nodes_preserve_order( @pytest.mark.sphinx('html', testroot='_blank') def test_transforms_reorder_consecutive_target_and_index_nodes_no_merge_across_other_nodes( - app, -): + app: SphinxTestApp, +) -> None: text = ( '.. index:: abc\n' '.. index:: def\n' diff --git a/tests/test_util/intersphinx_data.py b/tests/test_util/intersphinx_data.py index 2b3489da465..24fcc4ae311 100644 --- a/tests/test_util/intersphinx_data.py +++ b/tests/test_util/intersphinx_data.py @@ -62,3 +62,12 @@ b term std:term -1 document.html#id5 - B term std:term -1 document.html#B - """) + +INVENTORY_V2_TEXT_VERSION: Final[bytes] = b"""\ +# Sphinx inventory version 2 +# Project: foo +# Version: stable +# The remainder of this file is compressed with zlib. +""" + zlib.compress(b"""\ +module1 py:module 0 foo.html#module-module1 Long Module desc +""") diff --git a/tests/test_util/test_util.py b/tests/test_util/test_util.py index e4881764680..05e481b1c0c 100644 --- a/tests/test_util/test_util.py +++ b/tests/test_util/test_util.py @@ -2,17 +2,17 @@ from __future__ import annotations +from typing import TYPE_CHECKING + import pytest import sphinx.util from sphinx._cli.util.errors import strip_escape_sequences -from sphinx.deprecation import RemovedInSphinx10Warning, RemovedInSphinx90Warning -from sphinx.errors import ExtensionError +from sphinx.deprecation import RemovedInSphinx10Warning from sphinx.util._files import DownloadFiles, FilenameUniqDict from sphinx.util._importer import import_object from sphinx.util._lines import parse_line_num_spec from sphinx.util._uri import encode_uri, is_url -from sphinx.util.index_entries import _split_into, split_index_msg from sphinx.util.matching import patfilter from sphinx.util.nodes import ( caption_ref_re, @@ -29,8 +29,11 @@ relative_uri, ) +if TYPE_CHECKING: + from pathlib import Path + -def test_ensuredir(tmp_path): +def test_ensuredir(tmp_path: Path) -> None: # Does not raise an exception for an existing directory. ensuredir(tmp_path) @@ -40,30 +43,6 @@ def test_ensuredir(tmp_path): def test_exported_attributes() -> None: - # RemovedInSphinx90Warning - with pytest.warns( - RemovedInSphinx90Warning, - match=r"deprecated, use 'sphinx.util.index_entries.split_index_msg' instead.", - ): - assert sphinx.util.split_index_msg is split_index_msg - with pytest.warns(RemovedInSphinx90Warning, match=r'deprecated.'): - assert sphinx.util.split_into is _split_into - with pytest.warns( - RemovedInSphinx90Warning, - match=r"deprecated, use 'sphinx.errors.ExtensionError' instead.", - ): - assert sphinx.util.ExtensionError is ExtensionError - with pytest.warns( - RemovedInSphinx90Warning, - match=r"deprecated, use 'hashlib.md5' instead.", - ): - _ = sphinx.util.md5 - with pytest.warns( - RemovedInSphinx90Warning, - match=r"deprecated, use 'hashlib.sha1' instead.", - ): - _ = sphinx.util.sha1 - # RemovedInSphinx10Warning with pytest.warns(RemovedInSphinx10Warning, match=r'deprecated.'): assert sphinx.util.FilenameUniqDict is FilenameUniqDict diff --git a/tests/test_util/test_util_display.py b/tests/test_util/test_util_display.py index a3dda71b999..f4fa9c997ca 100644 --- a/tests/test_util/test_util_display.py +++ b/tests/test_util/test_util_display.py @@ -41,7 +41,9 @@ def test_status_iterator_length_0(app: SphinxTestApp) -> None: @pytest.mark.sphinx('dummy', testroot='root') -def test_status_iterator_verbosity_0(app, monkeypatch): +def test_status_iterator_verbosity_0( + app: SphinxTestApp, monkeypatch: pytest.MonkeyPatch +) -> None: monkeypatch.setenv('FORCE_COLOR', '1') logging.setup(app, app.status, app.warning) @@ -59,7 +61,9 @@ def test_status_iterator_verbosity_0(app, monkeypatch): @pytest.mark.sphinx('dummy', testroot='root') -def test_status_iterator_verbosity_1(app, monkeypatch): +def test_status_iterator_verbosity_1( + app: SphinxTestApp, monkeypatch: pytest.MonkeyPatch +) -> None: monkeypatch.setenv('FORCE_COLOR', '1') logging.setup(app, app.status, app.warning) @@ -107,7 +111,7 @@ def test_progress_message(app: SphinxTestApp) -> None: # decorator @progress_message('testing') - def func(): + def func() -> None: logger.info('in func ', nonl=True) func() diff --git a/tests/test_util/test_util_docutils.py b/tests/test_util/test_util_docutils.py index e44d508bfaa..ef281c1852a 100644 --- a/tests/test_util/test_util_docutils.py +++ b/tests/test_util/test_util_docutils.py @@ -17,6 +17,8 @@ ) if TYPE_CHECKING: + from pathlib import Path + from sphinx.builders import Builder from sphinx.testing.util import SphinxTestApp @@ -41,7 +43,7 @@ class custom_node(nodes.Element): assert not hasattr(nodes.SparseNodeVisitor, 'depart_custom_node') -def test_SphinxFileOutput(tmp_path): +def test_SphinxFileOutput(tmp_path: Path) -> None: content = 'Hello Sphinx World' # write test.txt at first @@ -79,16 +81,16 @@ def __init__(self, document: nodes.document, builder: Builder): self.called: list[str] = [] super().__init__(document, builder) - def visit_document(self, node): + def visit_document(self, node: nodes.document) -> None: pass - def depart_document(self, node): + def depart_document(self, node: nodes.document) -> None: pass - def visit_inline(self, node): + def visit_inline(self, node: nodes.inline) -> None: self.called.append('visit_inline') - def depart_inline(self, node): + def depart_inline(self, node: nodes.inline) -> None: self.called.append('depart_inline') document = new_document('') diff --git a/tests/test_util/test_util_docutils_sphinx_directive.py b/tests/test_util/test_util_docutils_sphinx_directive.py index ecfcab0b489..4934b265104 100644 --- a/tests/test_util/test_util_docutils_sphinx_directive.py +++ b/tests/test_util/test_util_docutils_sphinx_directive.py @@ -3,7 +3,7 @@ from types import SimpleNamespace from docutils import nodes -from docutils.parsers.rst.languages import en as english # type: ignore[attr-defined] +from docutils.parsers.rst.languages import en as english from docutils.parsers.rst.states import ( Inliner, RSTState, @@ -11,6 +11,7 @@ state_classes, ) from docutils.statemachine import StringList +from docutils.utils import Reporter from sphinx.util.docutils import SphinxDirective, new_document @@ -26,26 +27,27 @@ def make_directive_and_state( *, env: SimpleNamespace, input_lines: StringList | None = None ) -> tuple[RSTState, SphinxDirective]: sm = RSTStateMachine(state_classes, initial_state='Body') - sm.reporter = object() + sm.reporter = Reporter(source='', report_level=0, halt_level=0) if input_lines is not None: sm.input_lines = input_lines state = RSTState(sm) - state.document = new_document('') - state.document.settings.env = env - state.document.settings.tab_width = 4 - state.document.settings.pep_references = None - state.document.settings.rfc_references = None + document = state.document = new_document('') + document.settings.env = env + document.settings.tab_width = 4 + document.settings.pep_references = None + document.settings.rfc_references = None inliner = Inliner() - inliner.init_customizations(state.document.settings) + inliner.init_customizations(document.settings) state.inliner = inliner - state.parent = None + state.parent = document state.memo = SimpleNamespace( - document=state.document, + document=document, + reporter=document.reporter, language=english, - inliner=state.inliner, - reporter=state.document.reporter, - section_level=0, title_styles=[], + section_level=0, + section_bubble_up_kludge=False, + inliner=inliner, ) directive = SphinxDirective( name='test_directive', @@ -56,7 +58,7 @@ def make_directive_and_state( content_offset=0, block_text='', state=state, - state_machine=state.state_machine, + state_machine=sm, ) return state, directive diff --git a/tests/test_util/test_util_fileutil.py b/tests/test_util/test_util_fileutil.py index 26b75d82e05..9311be58153 100644 --- a/tests/test_util/test_util_fileutil.py +++ b/tests/test_util/test_util_fileutil.py @@ -12,12 +12,13 @@ from sphinx._cli.util.errors import strip_escape_sequences from sphinx.jinja2glue import BuiltinTemplateLoader from sphinx.util.fileutil import _template_basename, copy_asset, copy_asset_file +from sphinx.util.template import BaseRenderer if TYPE_CHECKING: from sphinx.testing.util import SphinxTestApp -class DummyTemplateLoader(BuiltinTemplateLoader): +class DummyTemplateLoader(BuiltinTemplateLoader, BaseRenderer): def __init__(self) -> None: super().__init__() builder = mock.Mock() @@ -26,7 +27,7 @@ def __init__(self) -> None: self.init(builder) -def test_copy_asset_file(tmp_path): +def test_copy_asset_file(tmp_path: Path) -> None: renderer = DummyTemplateLoader() # copy normal file @@ -69,7 +70,7 @@ def test_copy_asset_file(tmp_path): assert (subdir2 / 'asset.txt.jinja').read_text(encoding='utf8') == '# {{var1}} data' -def test_copy_asset(tmp_path): +def test_copy_asset(tmp_path: Path) -> None: renderer = DummyTemplateLoader() # prepare source files @@ -113,7 +114,7 @@ def test_copy_asset(tmp_path): assert sidebar == 'sidebar: baz' # copy with exclusion - def excluded(path): + def excluded(path: str) -> bool: return 'sidebar.html' in path or 'basic.css' in path destdir = tmp_path / 'test3' diff --git a/tests/test_util/test_util_i18n.py b/tests/test_util/test_util_i18n.py index 4326b4382dd..7aeeace369f 100644 --- a/tests/test_util/test_util_i18n.py +++ b/tests/test_util/test_util_i18n.py @@ -4,12 +4,10 @@ import datetime import os -import sys import time from pathlib import Path from typing import TYPE_CHECKING -import babel import pytest from babel.messages.mofile import read_mo @@ -36,7 +34,7 @@ def test_catalog_info_for_sub_domain_file_and_path() -> None: assert cat.mo_path == Path('path', 'sub', 'domain.mo') -def test_catalog_outdated(tmp_path): +def test_catalog_outdated(tmp_path: Path) -> None: (tmp_path / 'test.po').write_text('#', encoding='utf8') cat = i18n.CatalogInfo(tmp_path, 'test', 'utf-8') assert cat.is_outdated() # if mo is not exist @@ -50,7 +48,7 @@ def test_catalog_outdated(tmp_path): assert cat.is_outdated() # if mo is exist and older than po -def test_catalog_write_mo(tmp_path): +def test_catalog_write_mo(tmp_path: Path) -> None: (tmp_path / 'test.po').write_text('#', encoding='utf8') cat = i18n.CatalogInfo(tmp_path, 'test', 'utf-8') cat.write_mo('en') @@ -60,13 +58,8 @@ def test_catalog_write_mo(tmp_path): assert read_mo(f) is not None -# https://github.com/python-babel/babel/issues/1183 -@pytest.mark.xfail( - sys.platform == 'win32' and babel.__version__ == '2.17.0', - reason='Windows tests fail with Babel 2.17', -) -def test_format_date(): - date = datetime.date(2016, 2, 7) +def test_format_date() -> None: + date = datetime.datetime(2016, 2, 7, 5, 11, 17, 0) # NoQA: DTZ001 # strftime format format = '%B %d, %Y' @@ -82,28 +75,25 @@ def test_format_date(): assert i18n.format_date(format, date=date, language='en') == format format = '%B %d, %Y, %H:%M:%S %I %p' - datet = datetime.datetime(2016, 2, 7, 5, 11, 17, 0) # NoQA: DTZ001 - formatted = i18n.format_date(format, date=datet, language='en') + formatted = i18n.format_date(format, date=date, language='en') assert formatted == 'February 07, 2016, 05:11:17 05 AM' format = '%B %-d, %Y, %-H:%-M:%-S %-I %p' - formatted = i18n.format_date(format, date=datet, language='en') + formatted = i18n.format_date(format, date=date, language='en') assert formatted == 'February 7, 2016, 5:11:17 5 AM' format = '%x' - assert i18n.format_date(format, date=datet, language='en') == 'Feb 7, 2016' - format = '%X' - assert i18n.format_date(format, date=datet, language='en') == '5:11:17\u202fAM' assert i18n.format_date(format, date=date, language='en') == 'Feb 7, 2016' + format = '%X' + assert i18n.format_date(format, date=date, language='en') == '5:11:17\u202fAM' format = '%c' - formatted = i18n.format_date(format, date=datet, language='en') + formatted = i18n.format_date(format, date=date, language='en') assert formatted == 'Feb 7, 2016, 5:11:17\u202fAM' - assert i18n.format_date(format, date=date, language='en') == 'Feb 7, 2016' # timezone format = '%Z' - assert i18n.format_date(format, date=datet, language='en') == 'UTC' + assert i18n.format_date(format, date=date, language='en') == 'UTC' format = '%z' - assert i18n.format_date(format, date=datet, language='en') == '+0000' + assert i18n.format_date(format, date=date, language='en') == '+0000' def test_format_date_timezone() -> None: @@ -170,7 +160,7 @@ def test_get_filename_for_language(app: SphinxTestApp) -> None: assert get_filename('foo.png', app.env) == '/subdir/en/foo.png' -def test_CatalogRepository(tmp_path): +def test_CatalogRepository(tmp_path: Path) -> None: for po_file in ( (tmp_path / 'loc1' / 'xx' / 'LC_MESSAGES' / 'test1.po'), (tmp_path / 'loc1' / 'xx' / 'LC_MESSAGES' / 'test2.po'), diff --git a/tests/test_util/test_util_images.py b/tests/test_util/test_util_images.py index b56d68c1083..c4832ce224c 100644 --- a/tests/test_util/test_util_images.py +++ b/tests/test_util/test_util_images.py @@ -11,13 +11,17 @@ parse_data_uri, ) +TYPE_CHECKING = False +if TYPE_CHECKING: + from pathlib import Path + GIF_FILENAME = 'img.gif' PNG_FILENAME = 'img.png' PDF_FILENAME = 'img.pdf' TXT_FILENAME = 'index.txt' -def test_get_image_size(rootdir): +def test_get_image_size(rootdir: Path) -> None: assert get_image_size(rootdir / 'test-root' / GIF_FILENAME) == (200, 181) assert get_image_size(rootdir / 'test-root' / PNG_FILENAME) == (200, 181) assert get_image_size(rootdir / 'test-root' / PDF_FILENAME) is None @@ -80,8 +84,17 @@ def test_parse_data_uri() -> None: 'data:iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4' '//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==' ) - with pytest.raises( - ValueError, - match=r'not enough values to unpack \(expected 2, got 1\)', - ): + with pytest.raises(ValueError, match=r'malformed data URI'): parse_data_uri(uri) + + # not base64 + uri = ( + 'data:image/svg+xml,%3Csvg%20width%3D%22100%22%20height%3D%22100%22%20' + 'xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%3E%3Ccircle%20cx' + '%3D%2250%22%20cy%3D%2250%22%20r%3D%2240%22%20fill%3D%22blue%22%2F%3E' + '%3C%2Fsvg%3E' + ) + image = parse_data_uri(uri) + assert image is not None + assert image.mimetype == 'image/svg+xml' + assert b'%' not in image.data diff --git a/tests/test_util/test_util_inspect.py b/tests/test_util/test_util_inspect.py index 2ff37091fd2..4018a9632a0 100644 --- a/tests/test_util/test_util_inspect.py +++ b/tests/test_util/test_util_inspect.py @@ -106,6 +106,14 @@ def wrapper(): return wrapper +def forward_reference_in_args(x: Foo) -> None: # type: ignore[name-defined] # noqa: F821 + pass + + +def forward_reference_in_return() -> Foo: # type: ignore[name-defined] # noqa: F821 + pass + + def test_TypeAliasForwardRef(): alias = TypeAliasForwardRef('example') sig_str = stringify_annotation(alias, 'fully-qualified-except-typing') @@ -115,6 +123,14 @@ def test_TypeAliasForwardRef(): sig_str = stringify_annotation(alias, 'fully-qualified-except-typing') assert sig_str == "TypeAliasForwardRef('example') | None" + alias = alias | None + sig_str = stringify_annotation(alias, 'fully-qualified-except-typing') + assert sig_str == "TypeAliasForwardRef('example') | None" + + alias = None | alias # NoQA: RUF036 + sig_str = stringify_annotation(alias, 'fully-qualified-except-typing') + assert sig_str == "None | TypeAliasForwardRef('example')" + def test_TypeAliasNamespace() -> None: import logging.config @@ -164,6 +180,13 @@ def func(a, b, c=1, d=2, *e, **f): sig = inspect.stringify_signature(inspect.signature(func)) assert sig == '(a, b, c=1, d=2, *e, **f)' + # forward references + sig = inspect.stringify_signature(inspect.signature(forward_reference_in_args)) + assert sig == '(x: Foo) -> None' + + sig = inspect.stringify_signature(inspect.signature(forward_reference_in_return)) + assert sig == '() -> Foo' + def test_signature_partial() -> None: def fun(a, b, c=1, d=2): @@ -976,7 +999,7 @@ def meth(self): def test_is_builtin_class_method() -> None: class MyInt(int): - def my_method(self): + def my_method(self) -> None: pass assert inspect.is_builtin_class_method(MyInt, 'to_bytes') diff --git a/tests/test_util/test_util_inspect_py314.py b/tests/test_util/test_util_inspect_py314.py new file mode 100644 index 00000000000..dbda82a53b2 --- /dev/null +++ b/tests/test_util/test_util_inspect_py314.py @@ -0,0 +1,52 @@ +# noqa: I002 as 'from __future__ import annotations' prevents Python 3.14 +# forward references from causing issues, so we must skip it here. + +import pytest + +from sphinx.util import inspect +from sphinx.util.typing import stringify_annotation + +try: + from annotationlib import ForwardRef # type: ignore[import-not-found] +except ImportError: + pytest.skip('Requires annotationlib (Python 3.14+).', allow_module_level=True) + + +def forward_reference_in_args(x: Foo) -> None: # type: ignore[name-defined] # noqa: F821 + pass + + +def forward_reference_in_return() -> Foo: # type: ignore[name-defined] # noqa: F821 + pass + + +def test_signature_forwardref_in_args() -> None: + sig = inspect.signature(forward_reference_in_args) + + assert sig.return_annotation is None + + assert len(sig.parameters) + assert 'x' in sig.parameters + param = sig.parameters['x'] + + ann = param.annotation + assert isinstance(ann, ForwardRef) + assert ann.__arg__ == 'Foo' + assert ann.__forward_is_class__ is False + assert ann.__forward_module__ is None + assert ann.__owner__ is not None + assert stringify_annotation(ann) == 'Foo' + + +def test_signature_forwardref_in_return() -> None: + sig = inspect.signature(forward_reference_in_return) + + assert sig.parameters == {} + + ann = sig.return_annotation + assert isinstance(ann, ForwardRef) + assert ann.__arg__ == 'Foo' + assert ann.__forward_is_class__ is False + assert ann.__forward_module__ is None + assert ann.__owner__ is not None + assert stringify_annotation(ann) == 'Foo' diff --git a/tests/test_util/test_util_inventory.py b/tests/test_util/test_util_inventory.py index 0cab37d7904..5432d8cc5ca 100644 --- a/tests/test_util/test_util_inventory.py +++ b/tests/test_util/test_util_inventory.py @@ -107,7 +107,7 @@ def _build_inventory(srcdir: Path) -> Path: return app.outdir / 'objects.inv' -def test_inventory_localization(tmp_path): +def test_inventory_localization(tmp_path: Path) -> None: # Build an app using Estonian (EE) locale srcdir_et = _write_appconfig(tmp_path, 'et') inventory_et = _build_inventory(srcdir_et) diff --git a/tests/test_util/test_util_logging.py b/tests/test_util/test_util_logging.py index a9ef7f6c4c7..cd2a2eb90be 100644 --- a/tests/test_util/test_util_logging.py +++ b/tests/test_util/test_util_logging.py @@ -2,7 +2,6 @@ from __future__ import annotations -import codecs import os from contextlib import contextmanager from pathlib import Path @@ -18,16 +17,18 @@ from sphinx.util.logging import is_suppressed_warning, prefixed_warnings from sphinx.util.parallel import ParallelTasks -from tests.utils import TESTS_ROOT +from tests.utils import TEST_ROOTS_DIR if TYPE_CHECKING: + import io + from collections.abc import Iterator + from sphinx.testing.util import SphinxTestApp @pytest.mark.sphinx('html', testroot='root') def test_info_and_warning(app: SphinxTestApp) -> None: - app.verbosity = 2 - logging.setup(app, app.status, app.warning) + logging.setup(app, app.status, app.warning, verbosity=2) logger = logging.getLogger(__name__) logger.debug('message1') @@ -61,8 +62,7 @@ def test_Exception(app: SphinxTestApp) -> None: @pytest.mark.sphinx('html', testroot='root') def test_verbosity_filter(app: SphinxTestApp) -> None: # verbosity = 0: INFO - app.verbosity = 0 - logging.setup(app, app.status, app.warning) + logging.setup(app, app.status, app.warning, verbosity=0) logger = logging.getLogger(__name__) logger.info('message1') @@ -75,8 +75,7 @@ def test_verbosity_filter(app: SphinxTestApp) -> None: assert 'message4' not in app.status.getvalue() # verbosity = 1: VERBOSE - app.verbosity = 1 - logging.setup(app, app.status, app.warning) + logging.setup(app, app.status, app.warning, verbosity=1) logger = logging.getLogger(__name__) logger.info('message1') @@ -89,8 +88,7 @@ def test_verbosity_filter(app: SphinxTestApp) -> None: assert 'message4' not in app.status.getvalue() # verbosity = 2: DEBUG - app.verbosity = 2 - logging.setup(app, app.status, app.warning) + logging.setup(app, app.status, app.warning, verbosity=2) logger = logging.getLogger(__name__) logger.info('message1') @@ -128,16 +126,16 @@ def test_once_warning_log(app: SphinxTestApp) -> None: assert 'WARNING: message: 1\nWARNING: message: 2\n' in warnings -def test_is_suppressed_warning(): +def test_is_suppressed_warning() -> None: suppress_warnings = ['ref', 'files.*', 'rest.duplicated_labels'] - assert is_suppressed_warning(None, None, suppress_warnings) is False - assert is_suppressed_warning('ref', None, suppress_warnings) is True + assert is_suppressed_warning(None, None, suppress_warnings) is False # type: ignore[arg-type] + assert is_suppressed_warning('ref', None, suppress_warnings) is True # type: ignore[arg-type] assert is_suppressed_warning('ref', 'numref', suppress_warnings) is True assert is_suppressed_warning('ref', 'option', suppress_warnings) is True assert is_suppressed_warning('files', 'image', suppress_warnings) is True assert is_suppressed_warning('files', 'stylesheet', suppress_warnings) is True - assert is_suppressed_warning('rest', None, suppress_warnings) is False + assert is_suppressed_warning('rest', None, suppress_warnings) is False # type: ignore[arg-type] assert is_suppressed_warning('rest', 'syntax', suppress_warnings) is False assert is_suppressed_warning('rest', 'duplicated_labels', suppress_warnings) is True @@ -285,7 +283,7 @@ def test_pending_warnings(app: SphinxTestApp) -> None: @contextmanager -def force_colors(): +def force_colors() -> Iterator[None]: forcecolor = os.environ.get('FORCE_COLOR', None) try: @@ -298,10 +296,10 @@ def force_colors(): os.environ['FORCE_COLOR'] = forcecolor -def test_log_no_ansi_colors(tmp_path): +def test_log_no_ansi_colors(tmp_path: Path) -> None: with force_colors(): wfile = tmp_path / 'warnings.txt' - srcdir = TESTS_ROOT / 'roots' / 'test-nitpicky-warnings' + srcdir = TEST_ROOTS_DIR / 'test-nitpicky-warnings' argv = list(map(str, ['-b', 'html', srcdir, tmp_path, '-n', '-w', wfile])) retcode = build_main(argv) assert retcode == 0 @@ -312,8 +310,7 @@ def test_log_no_ansi_colors(tmp_path): @pytest.mark.sphinx('html', testroot='root') def test_colored_logs(app: SphinxTestApp) -> None: - app.verbosity = 2 - logging.setup(app, app.status, app.warning) + logging.setup(app, app.status, app.warning, verbosity=2) logger = logging.getLogger(__name__) # default colors @@ -346,7 +343,7 @@ def test_logging_in_ParallelTasks(app: SphinxTestApp) -> None: logging.setup(app, app.status, app.warning) logger = logging.getLogger(__name__) - def child_process(): + def child_process() -> None: logger.info('message1') logger.warning('message2', location='index') @@ -358,12 +355,15 @@ def child_process(): @pytest.mark.sphinx('html', testroot='root') -def test_output_with_unencodable_char(app): - class StreamWriter(codecs.StreamWriter): - def write(self, object): +def test_output_with_unencodable_char(app: SphinxTestApp) -> None: + class StreamWriter: + def __init__(self, stream: io.StringIO) -> None: + self.stream = stream + + def write(self, object: str) -> None: self.stream.write(object.encode('cp1252').decode('cp1252')) - logging.setup(app, StreamWriter(app.status), app.warning) + logging.setup(app, StreamWriter(app.status), app.warning, verbosity=0) # type: ignore[arg-type] logger = logging.getLogger(__name__) # info with UnicodeEncodeError @@ -393,7 +393,7 @@ def test_prefixed_warnings(app: SphinxTestApp) -> None: assert 'WARNING: message5' in app.warning.getvalue() -def test_get_node_location_abspath(): +def test_get_node_location_abspath() -> None: # Ensure that node locations are reported as an absolute path, # even if the source attribute is a relative path. diff --git a/tests/test_util/test_util_matching.py b/tests/test_util/test_util_matching.py index 0c17280aa6e..a2ad1ff5ba6 100644 --- a/tests/test_util/test_util_matching.py +++ b/tests/test_util/test_util_matching.py @@ -2,8 +2,13 @@ from __future__ import annotations +from typing import TYPE_CHECKING + from sphinx.util.matching import Matcher, compile_matchers, get_matching_files +if TYPE_CHECKING: + from pathlib import Path + def test_compile_matchers() -> None: # exact matching @@ -85,7 +90,7 @@ def test_Matcher() -> None: assert matcher('subdir/world.py') -def test_get_matching_files_all(rootdir): +def test_get_matching_files_all(rootdir: Path) -> None: files = get_matching_files(rootdir / 'test-root') assert sorted(files) == [ 'Makefile', @@ -133,7 +138,7 @@ def test_get_matching_files_all(rootdir): ] -def test_get_matching_files_all_exclude_single(rootdir): +def test_get_matching_files_all_exclude_single(rootdir: Path) -> None: files = get_matching_files(rootdir / 'test-root', exclude_patterns=['**.html']) assert sorted(files) == [ 'Makefile', @@ -178,7 +183,7 @@ def test_get_matching_files_all_exclude_single(rootdir): ] -def test_get_matching_files_all_exclude_multiple(rootdir): +def test_get_matching_files_all_exclude_multiple(rootdir: Path) -> None: files = get_matching_files( rootdir / 'test-root', exclude_patterns=['**.html', '**.inc'] ) @@ -218,7 +223,7 @@ def test_get_matching_files_all_exclude_multiple(rootdir): ] -def test_get_matching_files_all_exclude_nonexistent(rootdir): +def test_get_matching_files_all_exclude_nonexistent(rootdir: Path) -> None: files = get_matching_files(rootdir / 'test-root', exclude_patterns=['halibut/**']) assert sorted(files) == [ 'Makefile', @@ -266,7 +271,7 @@ def test_get_matching_files_all_exclude_nonexistent(rootdir): ] -def test_get_matching_files_all_include_single(rootdir): +def test_get_matching_files_all_include_single(rootdir: Path) -> None: files = get_matching_files(rootdir / 'test-root', include_patterns=['subdir/**']) assert sorted(files) == [ 'subdir/excluded.txt', @@ -278,7 +283,7 @@ def test_get_matching_files_all_include_single(rootdir): ] -def test_get_matching_files_all_include_multiple(rootdir): +def test_get_matching_files_all_include_multiple(rootdir: Path) -> None: files = get_matching_files( rootdir / 'test-root', include_patterns=['special/**', 'subdir/**'] ) @@ -294,12 +299,12 @@ def test_get_matching_files_all_include_multiple(rootdir): ] -def test_get_matching_files_all_include_nonexistent(rootdir): +def test_get_matching_files_all_include_nonexistent(rootdir: Path) -> None: files = get_matching_files(rootdir / 'test-root', include_patterns=['halibut/**']) assert sorted(files) == [] -def test_get_matching_files_all_include_prefix(rootdir): +def test_get_matching_files_all_include_prefix(rootdir: Path) -> None: files = get_matching_files(rootdir / 'test-root', include_patterns=['autodoc*']) assert sorted(files) == [ 'autodoc.txt', @@ -307,7 +312,7 @@ def test_get_matching_files_all_include_prefix(rootdir): ] -def test_get_matching_files_all_include_question_mark(rootdir): +def test_get_matching_files_all_include_question_mark(rootdir: Path) -> None: files = get_matching_files(rootdir / 'test-root', include_patterns=['img.???']) assert sorted(files) == [ 'img.gif', diff --git a/tests/test_util/test_util_nodes.py b/tests/test_util/test_util_nodes.py index 61342efdb1b..7588fcbbbc1 100644 --- a/tests/test_util/test_util_nodes.py +++ b/tests/test_util/test_util_nodes.py @@ -2,7 +2,6 @@ from __future__ import annotations -import warnings from textwrap import dedent from typing import TYPE_CHECKING, Any @@ -22,19 +21,19 @@ ) if TYPE_CHECKING: + from collections.abc import Iterable + from docutils.nodes import document -def _transform(doctree) -> None: +def _transform(doctree: nodes.document) -> None: ApplySourceWorkaround(doctree).apply() def create_new_document() -> document: - with warnings.catch_warnings(): - warnings.filterwarnings('ignore', category=DeprecationWarning) - # DeprecationWarning: The frontend.OptionParser class will be replaced - # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later. - settings = frontend.OptionParser(components=(rst.Parser,)).get_default_values() + # TODO: TYPING: Upstream docutils should accept both instances and subclasses + # of SettingsSpec here. + settings = frontend.get_default_settings(rst.Parser) # type: ignore[arg-type] settings.id_prefix = 'id' document = new_document('dummy.txt', settings) return document @@ -47,7 +46,11 @@ def _get_doctree(text): return document -def assert_node_count(messages, node_type, expect_count) -> None: +def assert_node_count( + messages: Iterable[tuple[nodes.Element, str]], + node_type: type[nodes.Node], + expect_count: int, +) -> None: count = 0 node_list = [node for node, msg in messages] for node in node_list: @@ -155,7 +158,7 @@ def test_NodeMatcher(): ), ], ) -def test_extract_messages(rst, node_cls, count): +def test_extract_messages(rst: str, node_cls: type[nodes.Element], count: int) -> None: msg = extract_messages(_get_doctree(dedent(rst))) assert_node_count(msg, node_cls, count) @@ -182,7 +185,8 @@ def test_extract_messages_without_rawsource() -> None: assert next(m for n, m in extract_messages(document)), 'text sentence' -def test_clean_astext(): +def test_clean_astext() -> None: + node: nodes.Element node = nodes.paragraph(text='hello world') assert clean_astext(node) == 'hello world' @@ -247,7 +251,7 @@ def test_make_id_sequential(app): ('hello ', (True, 'hello ', 'sphinx')), ], ) -def test_split_explicit_target(title, expected): +def test_split_explicit_target(title: str, expected: tuple[bool, str, str]) -> None: assert split_explicit_title(title) == expected diff --git a/tests/test_util/test_util_rst.py b/tests/test_util/test_util_rst.py index d8fcf8d12d0..41854c2aecc 100644 --- a/tests/test_util/test_util_rst.py +++ b/tests/test_util/test_util_rst.py @@ -5,7 +5,13 @@ from docutils.statemachine import StringList from jinja2 import Environment -from sphinx.util.rst import append_epilog, escape, heading, prepend_prolog, textwidth +from sphinx.util.rst import ( + _append_epilogue, + _prepend_prologue, + escape, + heading, + textwidth, +) def test_escape() -> None: @@ -15,25 +21,25 @@ def test_escape() -> None: assert escape('.. toctree::') == r'\.. toctree\:\:' -def test_append_epilog() -> None: +def test_append_epilogue() -> None: epilog = 'this is rst_epilog\ngood-bye reST!' content = StringList( ['hello Sphinx world', 'Sphinx is a document generator'], 'dummy.rst', ) - append_epilog(content, epilog) + _append_epilogue(content, epilog) assert list(content.xitems()) == [ ('dummy.rst', 0, 'hello Sphinx world'), ('dummy.rst', 1, 'Sphinx is a document generator'), ('dummy.rst', 2, ''), - ('', 0, 'this is rst_epilog'), - ('', 1, 'good-bye reST!'), + ('', 0, 'this is rst_epilog'), + ('', 1, 'good-bye reST!'), ] -def test_prepend_prolog() -> None: - prolog = 'this is rst_prolog\nhello reST!' +def test_prepend_prologue() -> None: + prologue = 'this is rst_prolog\nhello reST!' content = StringList( [ ':title: test of SphinxFileInput', @@ -44,14 +50,14 @@ def test_prepend_prolog() -> None: ], 'dummy.rst', ) - prepend_prolog(content, prolog) + _prepend_prologue(content, prologue) assert list(content.xitems()) == [ ('dummy.rst', 0, ':title: test of SphinxFileInput'), ('dummy.rst', 1, ':author: Sphinx team'), ('', 0, ''), - ('', 0, 'this is rst_prolog'), - ('', 1, 'hello reST!'), + ('', 0, 'this is rst_prolog'), + ('', 1, 'hello reST!'), ('', 0, ''), ('dummy.rst', 2, ''), ('dummy.rst', 3, 'hello Sphinx world'), @@ -60,17 +66,17 @@ def test_prepend_prolog() -> None: def test_prepend_prolog_with_CR() -> None: - # prolog having CR at tail - prolog = 'this is rst_prolog\nhello reST!\n' + # prologue having CR at tail + prologue = 'this is rst_prolog\nhello reST!\n' content = StringList( ['hello Sphinx world', 'Sphinx is a document generator'], 'dummy.rst', ) - prepend_prolog(content, prolog) + _prepend_prologue(content, prologue) assert list(content.xitems()) == [ - ('', 0, 'this is rst_prolog'), - ('', 1, 'hello reST!'), + ('', 0, 'this is rst_prolog'), + ('', 1, 'hello reST!'), ('', 0, ''), ('dummy.rst', 0, 'hello Sphinx world'), ('dummy.rst', 1, 'Sphinx is a document generator'), @@ -78,17 +84,17 @@ def test_prepend_prolog_with_CR() -> None: def test_prepend_prolog_without_CR() -> None: - # prolog not having CR at tail - prolog = 'this is rst_prolog\nhello reST!' + # prologue not having CR at tail + prologue = 'this is rst_prolog\nhello reST!' content = StringList( ['hello Sphinx world', 'Sphinx is a document generator'], 'dummy.rst', ) - prepend_prolog(content, prolog) + _prepend_prologue(content, prologue) assert list(content.xitems()) == [ - ('', 0, 'this is rst_prolog'), - ('', 1, 'hello reST!'), + ('', 0, 'this is rst_prolog'), + ('', 1, 'hello reST!'), ('', 0, ''), ('dummy.rst', 0, 'hello Sphinx world'), ('dummy.rst', 1, 'Sphinx is a document generator'), @@ -96,7 +102,7 @@ def test_prepend_prolog_without_CR() -> None: def test_prepend_prolog_with_roles_in_sections() -> None: - prolog = 'this is rst_prolog\nhello reST!' + prologue = 'this is rst_prolog\nhello reST!' content = StringList( [ ':title: test of SphinxFileInput', @@ -109,14 +115,14 @@ def test_prepend_prolog_with_roles_in_sections() -> None: ], 'dummy.rst', ) - prepend_prolog(content, prolog) + _prepend_prologue(content, prologue) assert list(content.xitems()) == [ ('dummy.rst', 0, ':title: test of SphinxFileInput'), ('dummy.rst', 1, ':author: Sphinx team'), ('', 0, ''), - ('', 0, 'this is rst_prolog'), - ('', 1, 'hello reST!'), + ('', 0, 'this is rst_prolog'), + ('', 1, 'hello reST!'), ('', 0, ''), ('dummy.rst', 2, ''), ('dummy.rst', 3, ':mod:`foo`'), @@ -128,13 +134,13 @@ def test_prepend_prolog_with_roles_in_sections() -> None: def test_prepend_prolog_with_roles_in_sections_with_newline() -> None: # prologue with trailing line break - prolog = 'this is rst_prolog\nhello reST!\n' + prologue = 'this is rst_prolog\nhello reST!\n' content = StringList([':mod:`foo`', '-' * 10, '', 'hello'], 'dummy.rst') - prepend_prolog(content, prolog) + _prepend_prologue(content, prologue) assert list(content.xitems()) == [ - ('', 0, 'this is rst_prolog'), - ('', 1, 'hello reST!'), + ('', 0, 'this is rst_prolog'), + ('', 1, 'hello reST!'), ('', 0, ''), ('dummy.rst', 0, ':mod:`foo`'), ('dummy.rst', 1, '----------'), @@ -145,13 +151,13 @@ def test_prepend_prolog_with_roles_in_sections_with_newline() -> None: def test_prepend_prolog_with_roles_in_sections_without_newline() -> None: # prologue with no trailing line break - prolog = 'this is rst_prolog\nhello reST!' + prologue = 'this is rst_prolog\nhello reST!' content = StringList([':mod:`foo`', '-' * 10, '', 'hello'], 'dummy.rst') - prepend_prolog(content, prolog) + _prepend_prologue(content, prologue) assert list(content.xitems()) == [ - ('', 0, 'this is rst_prolog'), - ('', 1, 'hello reST!'), + ('', 0, 'this is rst_prolog'), + ('', 1, 'hello reST!'), ('', 0, ''), ('dummy.rst', 0, ':mod:`foo`'), ('dummy.rst', 1, '----------'), diff --git a/tests/test_util/test_util_typing.py b/tests/test_util/test_util_typing.py index 35ee240f7b8..d5fd2b1092d 100644 --- a/tests/test_util/test_util_typing.py +++ b/tests/test_util/test_util_typing.py @@ -75,7 +75,7 @@ ) from weakref import WeakSet -from sphinx.ext.autodoc.mock import mock +from sphinx.ext.autodoc._dynamic._mock import mock from sphinx.util.typing import _INVALID_BUILTIN_CLASSES, restify, stringify_annotation @@ -198,14 +198,11 @@ def test_is_invalid_builtin_class() -> None: WrapperDescriptorType, # weakref WeakSet, + # zipfile + zipfile.Path, + zipfile.CompleteDirs, ) - if sys.version_info[:2] >= (3, 12): - invalid_types += ( - # zipfile - zipfile.Path, - zipfile.CompleteDirs, - ) - if sys.version_info[:2] >= (3, 13): + if sys.version_info[:2] == (3, 13): invalid_types += ( # pathlib Path, @@ -217,7 +214,7 @@ def test_is_invalid_builtin_class() -> None: ) invalid_names = {(cls.__module__, cls.__qualname__) for cls in invalid_types} - if sys.version_info[:2] < (3, 13): + if sys.version_info[:2] != (3, 13): invalid_names |= { ('pathlib._local', 'Path'), ('pathlib._local', 'PosixPath'), @@ -226,12 +223,7 @@ def test_is_invalid_builtin_class() -> None: ('pathlib._local', 'PureWindowsPath'), ('pathlib._local', 'WindowsPath'), } - if sys.version_info[:2] < (3, 12): - invalid_names |= { - ('zipfile._path', 'Path'), - ('zipfile._path', 'CompleteDirs'), - } - assert _INVALID_BUILTIN_CLASSES.keys() == invalid_names + assert set(_INVALID_BUILTIN_CLASSES) == invalid_names def test_restify_type_hints_containers(): @@ -424,10 +416,10 @@ def test_restify_type_ForwardRef(): assert restify(ForwardRef('MyInt')) == ':py:class:`MyInt`' assert ( - restify(list[ForwardRef('MyInt')]) == ':py:class:`list`\\ [:py:class:`MyInt`]' + restify(list[ForwardRef('MyInt')]) == ':py:class:`list`\\ [:py:class:`MyInt`]' # ty: ignore[invalid-type-form] ) - ann_rst = restify(Tuple[dict[ForwardRef('MyInt'), str], list[List[int]]]) + ann_rst = restify(Tuple[dict[ForwardRef('MyInt'), str], list[List[int]]]) # ty: ignore[invalid-type-form] assert ann_rst == ( ':py:class:`~typing.Tuple`\\ [:py:class:`dict`\\ [:py:class:`MyInt`, :py:class:`str`], :py:class:`list`\\ [:py:class:`~typing.List`\\ [:py:class:`int`]]]' ) @@ -488,14 +480,9 @@ class X(t.TypedDict): label: str # Unpack is considered as typing special form so we always have '~' - if sys.version_info[:2] >= (3, 12): - expect = r':py:obj:`~typing.Unpack`\ [:py:class:`X`]' - assert restify(UnpackCompat['X'], 'fully-qualified-except-typing') == expect - assert restify(UnpackCompat['X'], 'smart') == expect - else: - expect = r':py:obj:`~typing_extensions.Unpack`\ [:py:class:`X`]' - assert restify(UnpackCompat['X'], 'fully-qualified-except-typing') == expect - assert restify(UnpackCompat['X'], 'smart') == expect + expect = r':py:obj:`~typing.Unpack`\ [:py:class:`X`]' + assert restify(UnpackCompat['X'], 'fully-qualified-except-typing') == expect + assert restify(UnpackCompat['X'], 'smart') == expect expect = r':py:obj:`~typing.Unpack`\ [:py:class:`X`]' assert restify(t.Unpack['X'], 'fully-qualified-except-typing') == expect @@ -991,7 +978,7 @@ def test_stringify_broken_type_hints() -> None: def test_stringify_mock() -> None: with mock(['unknown']): - import unknown + import unknown # ty: ignore[unresolved-import] ann_str = stringify_annotation(unknown, 'fully-qualified-except-typing') assert ann_str == 'unknown' @@ -1007,20 +994,21 @@ def test_stringify_type_ForwardRef(): assert stringify_annotation(ForwardRef('MyInt')) == 'MyInt' assert stringify_annotation(ForwardRef('MyInt'), 'smart') == 'MyInt' - assert stringify_annotation(list[ForwardRef('MyInt')]) == 'list[MyInt]' - assert stringify_annotation(list[ForwardRef('MyInt')], 'smart') == 'list[MyInt]' + assert stringify_annotation(list[ForwardRef('MyInt')]) == 'list[MyInt]' # ty: ignore[invalid-type-form] + assert stringify_annotation(list[ForwardRef('MyInt')], 'smart') == 'list[MyInt]' # ty: ignore[invalid-type-form] ann_str = stringify_annotation( - Tuple[dict[ForwardRef('MyInt'), str], list[List[int]]] + Tuple[dict[ForwardRef('MyInt'), str], list[List[int]]] # ty: ignore[invalid-type-form] ) assert ann_str == 'Tuple[dict[MyInt, str], list[List[int]]]' ann_str = stringify_annotation( - Tuple[dict[ForwardRef('MyInt'), str], list[List[int]]], + Tuple[dict[ForwardRef('MyInt'), str], list[List[int]]], # ty: ignore[invalid-type-form] 'fully-qualified-except-typing', ) assert ann_str == 'Tuple[dict[MyInt, str], list[List[int]]]' ann_str = stringify_annotation( - Tuple[dict[ForwardRef('MyInt'), str], list[List[int]]], 'smart' + Tuple[dict[ForwardRef('MyInt'), str], list[List[int]]], # ty: ignore[invalid-type-form] + 'smart', ) assert ann_str == '~typing.Tuple[dict[MyInt, str], list[~typing.List[int]]]' diff --git a/tests/test_util/typing_test_data.py b/tests/test_util/typing_test_data.py index 5b34111c02d..d7ca4cf1c54 100644 --- a/tests/test_util/typing_test_data.py +++ b/tests/test_util/typing_test_data.py @@ -16,7 +16,7 @@ def f1(x: list[int]) -> List[int]: T_contra = TypeVar('T_contra', contravariant=True) -def f2(x: List[T], y: List[T_co], z: T) -> List[T_contra]: +def f2(x: List[T], y: List[T_co], z: T) -> List[T_contra]: # pyright: ignore[reportInvalidTypeVarUse] pass @@ -39,7 +39,7 @@ def f6(x: int, *args, y: str, z: str) -> None: pass -def f7(x: int = None, y: dict = {}) -> None: # NoQA: B006,RUF013 +def f7(x: int = None, y: dict = {}) -> None: # NoQA: B006,RUF013 # ty: ignore[invalid-parameter-default] pass diff --git a/tests/test_versioning.py b/tests/test_versioning.py index 58e3b224c58..03d5e00750c 100644 --- a/tests/test_versioning.py +++ b/tests/test_versioning.py @@ -6,21 +6,32 @@ import shutil import pytest +from docutils.utils import DependencyList from sphinx.testing.util import SphinxTestApp from sphinx.versioning import add_uids, get_ratio, merge_doctrees -original = original_uids = None +TYPE_CHECKING = False +if TYPE_CHECKING: + from collections.abc import Iterator + from pathlib import Path + + from docutils import nodes + + from sphinx.application import Sphinx + +original: nodes.document +original_uids: list[str] @pytest.fixture(scope='module', autouse=True) -def _setup_module(rootdir, sphinx_test_tempdir): +def _setup_module(rootdir: Path, sphinx_test_tempdir: Path) -> Iterator[None]: global original, original_uids # NoQA: PLW0603 srcdir = sphinx_test_tempdir / 'test-versioning' if not srcdir.exists(): shutil.copytree(rootdir / 'test-versioning', srcdir) app = SphinxTestApp(srcdir=srcdir) - app.builder.env.app = app + app.builder.env._app = app app.connect('doctree-resolved', on_doctree_resolved) app.build() original = doctrees['original'] @@ -32,11 +43,11 @@ def _setup_module(rootdir, sphinx_test_tempdir): doctrees = {} -def on_doctree_resolved(app, doctree, docname): +def on_doctree_resolved(app: Sphinx, doctree: nodes.document, docname: str) -> None: doctrees[docname] = doctree -def is_paragraph(node): +def is_paragraph(node: nodes.Node) -> bool: return node.__class__.__name__ == 'paragraph' @@ -52,11 +63,11 @@ def test_add_uids() -> None: def test_pickleablility() -> None: # we have to modify the doctree so we can pickle it copy = original.copy() - copy.reporter = None - copy.transformer = None + copy.reporter = None # type: ignore[assignment] + copy.transformer = None # type: ignore[assignment] copy.settings.warning_stream = None copy.settings.env = None - copy.settings.record_dependencies = None + copy.settings.record_dependencies = DependencyList() loaded = pickle.loads(pickle.dumps(copy, pickle.HIGHEST_PROTOCOL)) assert all(getattr(n, 'uid', False) for n in loaded.findall(is_paragraph)) @@ -64,7 +75,7 @@ def test_pickleablility() -> None: def test_modified() -> None: modified = doctrees['modified'] new_nodes = list(merge_doctrees(original, modified, is_paragraph)) - uids = [n.uid for n in modified.findall(is_paragraph)] + uids = [n.uid for n in modified.findall(is_paragraph)] # type: ignore[attr-defined] assert not new_nodes assert original_uids == uids @@ -72,7 +83,7 @@ def test_modified() -> None: def test_added() -> None: added = doctrees['added'] new_nodes = list(merge_doctrees(original, added, is_paragraph)) - uids = [n.uid for n in added.findall(is_paragraph)] + uids = [n.uid for n in added.findall(is_paragraph)] # type: ignore[attr-defined] assert len(new_nodes) == 1 assert original_uids == uids[:-1] @@ -80,7 +91,7 @@ def test_added() -> None: def test_deleted() -> None: deleted = doctrees['deleted'] new_nodes = list(merge_doctrees(original, deleted, is_paragraph)) - uids = [n.uid for n in deleted.findall(is_paragraph)] + uids = [n.uid for n in deleted.findall(is_paragraph)] # type: ignore[attr-defined] assert not new_nodes assert original_uids[::2] == uids @@ -88,7 +99,7 @@ def test_deleted() -> None: def test_deleted_end() -> None: deleted_end = doctrees['deleted_end'] new_nodes = list(merge_doctrees(original, deleted_end, is_paragraph)) - uids = [n.uid for n in deleted_end.findall(is_paragraph)] + uids = [n.uid for n in deleted_end.findall(is_paragraph)] # type: ignore[attr-defined] assert not new_nodes assert original_uids[:-1] == uids @@ -96,7 +107,7 @@ def test_deleted_end() -> None: def test_insert() -> None: insert = doctrees['insert'] new_nodes = list(merge_doctrees(original, insert, is_paragraph)) - uids = [n.uid for n in insert.findall(is_paragraph)] + uids = [n.uid for n in insert.findall(is_paragraph)] # type: ignore[attr-defined] assert len(new_nodes) == 1 assert original_uids[0] == uids[0] assert original_uids[1:] == uids[2:] @@ -105,7 +116,7 @@ def test_insert() -> None: def test_insert_beginning() -> None: insert_beginning = doctrees['insert_beginning'] new_nodes = list(merge_doctrees(original, insert_beginning, is_paragraph)) - uids = [n.uid for n in insert_beginning.findall(is_paragraph)] + uids = [n.uid for n in insert_beginning.findall(is_paragraph)] # type: ignore[attr-defined] assert len(new_nodes) == 1 assert len(uids) == 4 assert original_uids == uids[1:] @@ -115,7 +126,7 @@ def test_insert_beginning() -> None: def test_insert_similar() -> None: insert_similar = doctrees['insert_similar'] new_nodes = list(merge_doctrees(original, insert_similar, is_paragraph)) - uids = [n.uid for n in insert_similar.findall(is_paragraph)] + uids = [n.uid for n in insert_similar.findall(is_paragraph)] # type: ignore[attr-defined] assert len(new_nodes) == 1 assert new_nodes[0].rawsource == 'Anyway I need more' # type: ignore[attr-defined] assert original_uids[0] == uids[0] diff --git a/tests/test_writers/test_docutilsconf.py b/tests/test_writers/test_docutilsconf.py index 32e9d13343c..1d321bdcbc8 100644 --- a/tests/test_writers/test_docutilsconf.py +++ b/tests/test_writers/test_docutilsconf.py @@ -2,25 +2,32 @@ from __future__ import annotations +from typing import TYPE_CHECKING + import pytest from docutils import nodes from sphinx.testing.util import assert_node from sphinx.util.docutils import patch_docutils +if TYPE_CHECKING: + from sphinx.application import Sphinx + @pytest.mark.sphinx( 'dummy', testroot='docutilsconf', freshenv=True, ) -def test_html_with_default_docutilsconf(app): +def test_html_with_default_docutilsconf(app: Sphinx) -> None: with patch_docutils(app.confdir): app.build() doctree = app.env.get_doctree('index') + section = doctree[0] + assert isinstance(section, nodes.Element) assert_node( - doctree[0][1], [nodes.paragraph, ('Sphinx ', [nodes.footnote_reference, '1'])] + section[1], [nodes.paragraph, ('Sphinx ', [nodes.footnote_reference, '1'])] ) @@ -31,11 +38,13 @@ def test_html_with_default_docutilsconf(app): docutils_conf='[restructuredtext parser]\ntrim_footnote_reference_space: true\n', copy_test_root=True, ) -def test_html_with_docutilsconf(app): +def test_html_with_docutilsconf(app: Sphinx) -> None: with patch_docutils(app.confdir): app.build() doctree = app.env.get_doctree('index') + section = doctree[0] + assert isinstance(section, nodes.Element) assert_node( - doctree[0][1], [nodes.paragraph, ('Sphinx', [nodes.footnote_reference, '1'])] + section[1], [nodes.paragraph, ('Sphinx', [nodes.footnote_reference, '1'])] ) diff --git a/tests/test_writers/test_writer_text.py b/tests/test_writers/test_writer_text.py new file mode 100644 index 00000000000..66eb4f95f4e --- /dev/null +++ b/tests/test_writers/test_writer_text.py @@ -0,0 +1,183 @@ +"""Test the LaTeX writer""" + +from __future__ import annotations + +import pytest +from docutils.utils import column_width + +from sphinx.writers.text import TextWrapper + +find_break_end = TextWrapper._find_break_end + + +@pytest.mark.parametrize( + # glyph of column width 0 + 'glyph', + ['', '\N{COMBINING TILDE}'], +) +def test_text_wrapper_break_phantom_symbol(glyph: str) -> None: + assert column_width(glyph) == 0 + glyph_length = len(glyph) + + for n in range(1, 5): + # Since the glyph has length 0 and column width 0, + # we can always take the entire glpyh. + assert find_break_end(glyph, n) == glyph_length + for m in range(1, 5): + # The multiplied glyph may have non-zero length + # but its column width will always be 0, so we + # take the entire glyph again. + assert find_break_end(m * glyph, n) == m * glyph_length + + +@pytest.mark.parametrize( + ('text', 'colwidth'), + [ + # Glyph of length 1 and column width 1 + ('X', 1), + # Glyph of length 1 and column width 2 + ('\N{CJK UNIFIED IDEOGRAPH-65E5}', 2), + # Glyph of length 2 and column width 1 + ('\N{COMBINING TILDE}X', 1), + # Glyph of length 2 and column width 2 + ('\N{COMBINING TILDE}\N{CJK UNIFIED IDEOGRAPH-65E5}', 2), + # Glyph of length 3 and column width 1 + ('\N{COMBINING TILDE}\N{COMBINING BREVE}X', 1), + ], +) +def test_text_wrapper_break_visible_symbol(text: str, colwidth: int) -> None: + assert column_width(text) == colwidth + for n in range(1, 5): + end = find_break_end(text, n) + assert column_width(text[:end]) <= n + for m in range(2, 5): + m_text = m * text + end = find_break_end(m_text, n) + assert column_width(m_text[:end]) <= n + assert end == m * len(text) or column_width(m_text[: end + 1]) > n + + +def test_text_wrapper_break_stop_after_combining_symbols() -> None: + tilde = '\N{COMBINING TILDE}' + multi = '\N{CJK UNIFIED IDEOGRAPH-65E5}' + + head = tilde + tilde + '....' + tail = multi + tilde + tilde + text = head + tail + assert find_break_end(head + tail, column_width(head)) == len(head) + + +@pytest.mark.parametrize( + ('text', 'results'), + [ + ('Hello', {1: list('Hello'), 2: ['He', 'll', 'o']}), + ( + 'Hello a\N{CJK UNIFIED IDEOGRAPH-65E5}ab!', + { + 1: list('Helloa\N{CJK UNIFIED IDEOGRAPH-65E5}ab!'), + 2: ['He', 'll', 'o', 'a', '\N{CJK UNIFIED IDEOGRAPH-65E5}', 'ab', '!'], + 3: ['Hel', 'lo', 'a\N{CJK UNIFIED IDEOGRAPH-65E5}', 'ab!'], + }, + ), + ( + 'ab c\N{COMBINING TILDE}def', + { + 1: ['a', 'b', 'c\N{COMBINING TILDE}', 'd', 'e', 'f'], + 2: ['ab', 'c\N{COMBINING TILDE}d', 'ef'], + 3: ['ab ', 'c\N{COMBINING TILDE}de', 'f'], + }, + ), + ( + 'abc\N{COMBINING TILDE}\N{CJK UNIFIED IDEOGRAPH-65E5}def', + { + 1: [ + 'a', + 'b', + 'c\N{COMBINING TILDE}', + '\N{CJK UNIFIED IDEOGRAPH-65E5}', + 'd', + 'e', + 'f', + ], + 2: [ + 'ab', + 'c\N{COMBINING TILDE}', + '\N{CJK UNIFIED IDEOGRAPH-65E5}', + 'de', + 'f', + ], + 3: ['abc\N{COMBINING TILDE}', '\N{CJK UNIFIED IDEOGRAPH-65E5}', 'def'], + }, + ), + ( + 'abc\N{COMBINING TILDE}\N{COMBINING BREVE}def', + { + 1: ['a', 'b', 'c\N{COMBINING TILDE}\N{COMBINING BREVE}', 'd', 'e', 'f'], + 2: ['ab', 'c\N{COMBINING TILDE}\N{COMBINING BREVE}d', 'ef'], + 3: ['abc\N{COMBINING TILDE}\N{COMBINING BREVE}', 'def'], + }, + ), + ], +) +def test_text_wrapper(text: str, results: dict[int, list[str]]) -> None: + for width, expected in results.items(): + w = TextWrapper(width=width, drop_whitespace=True) + assert w.wrap(text) == expected + + +@pytest.mark.parametrize( + ('text', 'results'), + [ + ('Hello', {1: list('Hello'), 2: ['He', 'll', 'o']}), + ( + 'Hello a\N{CJK UNIFIED IDEOGRAPH-65E5}ab!', + { + 1: list('Hello a\N{CJK UNIFIED IDEOGRAPH-65E5}ab!'), + 2: ['He', 'll', 'o ', 'a', '\N{CJK UNIFIED IDEOGRAPH-65E5}', 'ab', '!'], + 3: ['Hel', 'lo ', 'a\N{CJK UNIFIED IDEOGRAPH-65E5}', 'ab!'], + }, + ), + ( + 'ab c\N{COMBINING TILDE}def', + { + 1: ['a', 'b', ' ', 'c\N{COMBINING TILDE}', 'd', 'e', 'f'], + 2: ['ab', ' c\N{COMBINING TILDE}', 'de', 'f'], + 3: ['ab ', 'c\N{COMBINING TILDE}de', 'f'], + }, + ), + ( + 'abc\N{COMBINING TILDE}\N{CJK UNIFIED IDEOGRAPH-65E5}def', + { + 1: [ + 'a', + 'b', + 'c\N{COMBINING TILDE}', + '\N{CJK UNIFIED IDEOGRAPH-65E5}', + 'd', + 'e', + 'f', + ], + 2: [ + 'ab', + 'c\N{COMBINING TILDE}', + '\N{CJK UNIFIED IDEOGRAPH-65E5}', + 'de', + 'f', + ], + 3: ['abc\N{COMBINING TILDE}', '\N{CJK UNIFIED IDEOGRAPH-65E5}', 'def'], + }, + ), + ( + 'abc\N{COMBINING TILDE}\N{COMBINING BREVE}def', + { + 1: ['a', 'b', 'c\N{COMBINING TILDE}\N{COMBINING BREVE}', 'd', 'e', 'f'], + 2: ['ab', 'c\N{COMBINING TILDE}\N{COMBINING BREVE}d', 'ef'], + 3: ['abc\N{COMBINING TILDE}\N{COMBINING BREVE}', 'def'], + }, + ), + ], +) +def test_text_wrapper_drop_ws(text: str, results: dict[int, list[str]]) -> None: + for width, expected in results.items(): + w = TextWrapper(width=width, drop_whitespace=False) + assert w.wrap(text) == expected diff --git a/tests/utils.py b/tests/utils.py index 59757edbd99..db34b51727e 100644 --- a/tests/utils.py +++ b/tests/utils.py @@ -1,7 +1,12 @@ from __future__ import annotations -__all__ = ('http_server',) +__all__ = ( + 'http_server', + 'extract_node', + 'extract_element', +) +import os import socket from contextlib import contextmanager from http.server import ThreadingHTTPServer @@ -11,18 +16,28 @@ from typing import TYPE_CHECKING from urllib.parse import urlparse +from docutils import nodes + if TYPE_CHECKING: from collections.abc import Iterator from http.server import HTTPServer from socketserver import BaseRequestHandler from typing import Final + from docutils.nodes import Element, Node + from sphinx.application import Sphinx +TESTS_ROOT: Final[Path] = Path(__file__).resolve().parent +TEST_ROOTS_DIR: Final[Path] = TESTS_ROOT / ( + 'roots-read-only' + if 'CI' in os.environ and (TESTS_ROOT / 'roots-read-only').is_dir() + else 'roots' +) + # Generated with: # $ openssl req -new -x509 -days 3650 -nodes -out cert.pem \ # -keyout cert.pem -addext "subjectAltName = DNS:localhost" -TESTS_ROOT: Final[Path] = Path(__file__).resolve().parent CERT_FILE: Final[str] = str(TESTS_ROOT / 'certs' / 'cert.pem') @@ -123,3 +138,50 @@ def serve_application( rewrite_hyperlinks(app, server), ): yield f'localhost:{server.server_port}' + + +def extract_node(node: Node, /, *indices: int) -> Node: + """Walk down a docutils node tree by repeatedly indexing children. + + Returns a Node (could be Element, Text, etc.) + + Example:: + + extract_node(doc, 0, 2, 1) == doc[0][2][1] + """ + current: Node = node + + for depth, i in enumerate(indices): + path = ''.join(f'[{i}]' for i in indices[:depth]) + assert isinstance(current, nodes.Element), ( + f'Expected node{path} (at depth {depth}) to be an Element ' + f'before indexing with [{i}], got {type(current).__name__!r}' + ) + try: + current = current[i] + except IndexError as exc: + msg = ( + f'Index {i} out of range for node{path} (at depth {depth}) ' + f'for {type(current).__name__!r}' + ) + raise AssertionError(msg) from exc + + return current + + +def extract_element(node: Node, /, *indices: int) -> Element: + """Walk down a docutils node tree and return an Element. + + Asserts the final result is an Element (for attribute/dict access). + + Example:: + + node = extract_node(doc, 0, 2, 1) + node['uri'] # Safe: guaranteed to be docutils.nodes.Element + """ + result = extract_node(node, *indices) + if isinstance(result, nodes.Element): + return result + path = ''.join(f'[{i}]' for i in indices) + msg = f'Expected node{path} to be an Element, got {type(result).__name__!r}' + raise AssertionError(msg) diff --git a/tox.ini b/tox.ini index 674013fdc08..4862739a2bd 100644 --- a/tox.ini +++ b/tox.ini @@ -1,6 +1,6 @@ [tox] minversion = 4.2.0 -envlist = py{311,312,313,314} +envlist = py{312,313,314,315} [testenv] usedevelop = True @@ -19,8 +19,8 @@ passenv = BUILDER READTHEDOCS description = - py{311,312,313,314}: Run unit tests against {envname}. -extras = + py{312,313,314,315}: Run unit tests against {envname}. +dependency_groups = test setenv = PYTHONWARNINGS = error @@ -31,8 +31,9 @@ commands= [testenv:lint] description = Run linters. -extras = +dependency_groups = lint + types # If you update any of these commands, don't forget to update the equivalent # GitHub Workflow step commands = @@ -43,7 +44,7 @@ commands = [testenv:docs] description = Build documentation. -extras = +dependency_groups = docs commands = python -c "import shutil; shutil.rmtree('./build/sphinx', ignore_errors=True) if '{env:CLEAN:}' else None" @@ -52,7 +53,7 @@ commands = [testenv:docs-live] description = Build documentation. -extras = +dependency_groups = docs deps = sphinx-autobuild @@ -70,7 +71,7 @@ commands = [testenv:ruff] description = Run ruff formatting and linting. -extras = +dependency_groups = lint commands = ruff format . @@ -79,8 +80,13 @@ commands = [testenv:mypy] description = Run mypy type checking. -extras = - lint - test +dependency_groups = + types commands = mypy {posargs} + +[testenv:prettier] +description = + Run the Prettier JavaScript formatter. +commands = + npx prettier@3.5 --write "sphinx/themes/**/*.js" "!sphinx/themes/bizstyle/static/css3-mediaqueries*.js" "tests/js/**/*.{js,mjs}" "!tests/js/fixtures/**" diff --git a/ty.toml b/ty.toml new file mode 100644 index 00000000000..6a5c8bf1fe7 --- /dev/null +++ b/ty.toml @@ -0,0 +1,26 @@ +# Configuration file for Ty_. +# n.b. Ty is early in development. +# Sphinx's current primary/reference type-checker is mypy. +# +# .. _Ty: https://docs.astral.sh/ty/ + +[src] +include = [ + "doc/conf.py", + "doc/development/tutorials/examples/autodoc_intenum.py", + "doc/development/tutorials/examples/helloworld.py", + "sphinx", + "tests", + "utils", +] +exclude = [ + "tests/roots", + "tests/test_util/typing_test_data.py", +] + +[rules] +invalid-argument-type = "ignore" +invalid-assignment = "ignore" +invalid-method-override = "ignore" +non-subscriptable = "ignore" +possibly-missing-attribute = "ignore" diff --git a/utils/babel_runner.py b/utils/babel_runner.py index 82bf79fd5b3..63fe8ab13e8 100644 --- a/utils/babel_runner.py +++ b/utils/babel_runner.py @@ -233,7 +233,7 @@ def run_compile() -> None: for x in message.locations ): msgid = message.id - if isinstance(msgid, list | tuple): + if isinstance(msgid, (list, tuple)): msgid = msgid[0] js_catalogue[msgid] = message.string diff --git a/utils/convert_attestations.py b/utils/convert_attestations.py index 7e227c21358..9a755dc895e 100644 --- a/utils/convert_attestations.py +++ b/utils/convert_attestations.py @@ -3,12 +3,10 @@ See https://github.com/trailofbits/pypi-attestations. """ -# resolution fails without betterproto and protobuf-specs # /// script -# requires-python = ">=3.11" +# requires-python = ">=3.12" # dependencies = [ -# "pypi-attestations==0.0.21", -# "betterproto==2.0.0b6", +# "pypi-attestations==0.0.28", # ] # /// diff --git a/utils/generate_snowball.py b/utils/generate_snowball.py new file mode 100755 index 00000000000..12c10622d86 --- /dev/null +++ b/utils/generate_snowball.py @@ -0,0 +1,138 @@ +#!/usr/bin/env python3 + +"""Refresh and update language stemming data from the Snowball project.""" + +# /// script +# requires-python = ">=3.12" +# dependencies = [ +# "requests>=2.30", +# ] +# /// + +from __future__ import annotations + +import hashlib +import shutil +import subprocess +import sys +import tarfile +import tempfile +from io import BytesIO +from pathlib import Path + +import requests + +SNOWBALL_VERSION = '3.0.1' +SNOWBALL_URL = f'https://github.com/snowballstem/snowball/archive/refs/tags/v{SNOWBALL_VERSION}.tar.gz' +SNOWBALL_SHA256 = '80ac10ce40dc4fcfbfed8d085c457b5613da0e86a73611a3d5527d044a142d60' + +ROOT = Path(__file__).resolve().parent.parent +SEARCH_DIR = ROOT / 'sphinx' / 'search' +STOPWORDS_DIR = SEARCH_DIR / '_stopwords' +NON_MINIFIED_JS_DIR = SEARCH_DIR / 'non-minified-js' + +STOPWORD_URLS = ( + ('da', 'danish', 'https://snowballstem.org/algorithms/danish/stop.txt'), + ('de', 'german', 'https://snowballstem.org/algorithms/german/stop.txt'), + ('en', 'english', 'https://snowballstem.org/algorithms/english/stop.txt'), + ('es', 'spanish', 'https://snowballstem.org/algorithms/spanish/stop.txt'), + ('fi', 'finnish', 'https://snowballstem.org/algorithms/finnish/stop.txt'), + ('fr', 'french', 'https://snowballstem.org/algorithms/french/stop.txt'), + ('hu', 'hungarian', 'https://snowballstem.org/algorithms/hungarian/stop.txt'), + ('it', 'italian', 'https://snowballstem.org/algorithms/italian/stop.txt'), + ('nl', 'dutch', 'https://snowballstem.org/algorithms/dutch/stop.txt'), + ('no', 'norwegian', 'https://snowballstem.org/algorithms/norwegian/stop.txt'), + ('pt', 'portuguese', 'https://snowballstem.org/algorithms/portuguese/stop.txt'), + # ('ro', 'romanian', ''), + ('ru', 'russian', 'https://snowballstem.org/algorithms/russian/stop.txt'), + ('sv', 'swedish', 'https://snowballstem.org/algorithms/swedish/stop.txt'), + # ('tr', 'turkish', ''), +) + + +def regenerate_stopwords() -> None: + STOPWORDS_DIR.mkdir(parents=True, exist_ok=True) + STOPWORDS_DIR.joinpath('__init__.py').touch() + + for lang_code, lang_name, url in STOPWORD_URLS: + content = requests.get(url, timeout=5).content + try: + data = content.decode('utf-8') + except UnicodeDecodeError: + if lang_code == 'ru': + data = content.decode('koi8-r') + else: + data = content.decode('latin-1') + + # record the original source of the stopwords list + txt_path = STOPWORDS_DIR / f'{lang_code}.txt' + txt_path.write_text(data.rstrip() + '\n', encoding='utf-8') + + # generate the Python stopwords set + stopwords = parse_stop_word(data) + with (STOPWORDS_DIR / f'{lang_code}.py').open('w', encoding='utf-8') as f: + f.write('# automatically generated by utils/generate-snowball.py\n') + f.write(f'# from {url}\n\n') + f.write('from __future__ import annotations\n\n') + f.write(f'{lang_name.upper()}_STOPWORDS = frozenset(') + if stopwords: + f.write('{\n') + for word in sorted(stopwords, key=str.casefold): + f.write(f' {word!r},\n') + f.write('}') + f.write(')\n') + + +def parse_stop_word(source: str) -> frozenset[str]: + """Collect the stopwords from a snowball style word list: + + .. code:: text + + list of space separated stop words | optional comment + """ + stop_words: set[str] = set() + for line in source.splitlines(): + stop_words.update(line.partition('|')[0].split()) # remove comment + return frozenset(stop_words) + + +def regenerate_javascript() -> None: + tmp_root = Path(tempfile.mkdtemp()) + + # Download and verify the snowball release + archive = requests.get(SNOWBALL_URL, timeout=60).content + digest = hashlib.sha256(archive).hexdigest() + if digest != SNOWBALL_SHA256: + msg = ( + f'data does not match expected checksum ' + f'(expected {SNOWBALL_SHA256}, saw {digest}).' + ) + raise RuntimeError(msg) + + # Extract the release archive + with tarfile.TarFile.gzopen( + 'snowball.tar.gz', mode='r', fileobj=BytesIO(archive) + ) as tar: + tar.extractall(tmp_root, filter='data') + snowball_root = tmp_root / f'snowball-{SNOWBALL_VERSION}' + snowball_dist = snowball_root / 'dist' + + # Generate JS stemmer files + cmd = ('make', '--jobs=8', 'dist_libstemmer_js') + subprocess.run(cmd, check=True, cwd=snowball_root) + with tarfile.open(snowball_dist / f'jsstemmer-{SNOWBALL_VERSION}.tar.gz') as tar: + tar.extractall(snowball_dist, filter='data') + + # Copy generated JS to sphinx/search/ + NON_MINIFIED_JS_DIR.mkdir(exist_ok=True) + js_dir = snowball_dist / f'jsstemmer-{SNOWBALL_VERSION}' / 'javascript' + shutil.copytree(js_dir, NON_MINIFIED_JS_DIR, dirs_exist_ok=True) + + # Clean up + shutil.rmtree(snowball_root) + + +if __name__ == '__main__': + regenerate_stopwords() + if sys.platform != 'win32': + regenerate_javascript() diff --git a/uv.lock b/uv.lock new file mode 100644 index 00000000000..e0d5c5cc922 --- /dev/null +++ b/uv.lock @@ -0,0 +1,1635 @@ +version = 1 +revision = 3 +requires-python = ">=3.12" + +[[package]] +name = "alabaster" +version = "1.0.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/a6/f8/d9c74d0daf3f742840fd818d69cfae176fa332022fd44e3469487d5a9420/alabaster-1.0.0.tar.gz", hash = "sha256:c00dca57bca26fa62a6d7d0a9fcce65f3e026e9bfe33e9c538fd3fbb2144fd9e", size = 24210, upload-time = "2024-07-26T18:15:03.762Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/7e/b3/6b4067be973ae96ba0d615946e314c5ae35f9f993eca561b356540bb0c2b/alabaster-1.0.0-py3-none-any.whl", hash = "sha256:fc6786402dc3fcb2de3cabd5fe455a2db534b371124f1f21de8731783dec828b", size = 13929, upload-time = "2024-07-26T18:15:02.05Z" }, +] + +[[package]] +name = "annotated-types" +version = "0.7.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" }, +] + +[[package]] +name = "babel" +version = "2.17.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/7d/6b/d52e42361e1aa00709585ecc30b3f9684b3ab62530771402248b1b1d6240/babel-2.17.0.tar.gz", hash = "sha256:0c54cffb19f690cdcc52a3b50bcbf71e07a808d1c80d549f2459b9d2cf0afb9d", size = 9951852, upload-time = "2025-02-01T15:17:41.026Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b7/b8/3fe70c75fe32afc4bb507f75563d39bc5642255d1d94f1f23604725780bf/babel-2.17.0-py3-none-any.whl", hash = "sha256:4d0b53093fdfb4b21c92b5213dba5a1b23885afa8383709427046b21c366e5f2", size = 10182537, upload-time = "2025-02-01T15:17:37.39Z" }, +] + +[[package]] +name = "build" +version = "1.3.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "colorama", marker = "os_name == 'nt'" }, + { name = "packaging" }, + { name = "pyproject-hooks" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/25/1c/23e33405a7c9eac261dff640926b8b5adaed6a6eb3e1767d441ed611d0c0/build-1.3.0.tar.gz", hash = "sha256:698edd0ea270bde950f53aed21f3a0135672206f3911e0176261a31e0e07b397", size = 48544, upload-time = "2025-08-01T21:27:09.268Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cb/8c/2b30c12155ad8de0cf641d76a8b396a16d2c36bc6d50b621a62b7c4567c1/build-1.3.0-py3-none-any.whl", hash = "sha256:7145f0b5061ba90a1500d60bd1b13ca0a8a4cebdd0cc16ed8adf1c0e739f43b4", size = 23382, upload-time = "2025-08-01T21:27:07.844Z" }, +] + +[[package]] +name = "certifi" +version = "2025.11.12" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/a2/8c/58f469717fa48465e4a50c014a0400602d3c437d7c0c468e17ada824da3a/certifi-2025.11.12.tar.gz", hash = "sha256:d8ab5478f2ecd78af242878415affce761ca6bc54a22a27e026d7c25357c3316", size = 160538, upload-time = "2025-11-12T02:54:51.517Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/70/7d/9bc192684cea499815ff478dfcdc13835ddf401365057044fb721ec6bddb/certifi-2025.11.12-py3-none-any.whl", hash = "sha256:97de8790030bbd5c2d96b7ec782fc2f7820ef8dba6db909ccf95449f2d062d4b", size = 159438, upload-time = "2025-11-12T02:54:49.735Z" }, +] + +[[package]] +name = "cffi" +version = "2.0.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "pycparser", marker = "implementation_name != 'PyPy'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/eb/56/b1ba7935a17738ae8453301356628e8147c79dbb825bcbc73dc7401f9846/cffi-2.0.0.tar.gz", hash = "sha256:44d1b5909021139fe36001ae048dbdde8214afa20200eda0f64c068cac5d5529", size = 523588, upload-time = "2025-09-08T23:24:04.541Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ea/47/4f61023ea636104d4f16ab488e268b93008c3d0bb76893b1b31db1f96802/cffi-2.0.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6d02d6655b0e54f54c4ef0b94eb6be0607b70853c45ce98bd278dc7de718be5d", size = 185271, upload-time = "2025-09-08T23:22:44.795Z" }, + { url = "https://files.pythonhosted.org/packages/df/a2/781b623f57358e360d62cdd7a8c681f074a71d445418a776eef0aadb4ab4/cffi-2.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8eca2a813c1cb7ad4fb74d368c2ffbbb4789d377ee5bb8df98373c2cc0dee76c", size = 181048, upload-time = "2025-09-08T23:22:45.938Z" }, + { url = "https://files.pythonhosted.org/packages/ff/df/a4f0fbd47331ceeba3d37c2e51e9dfc9722498becbeec2bd8bc856c9538a/cffi-2.0.0-cp312-cp312-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:21d1152871b019407d8ac3985f6775c079416c282e431a4da6afe7aefd2bccbe", size = 212529, upload-time = "2025-09-08T23:22:47.349Z" }, + { url = "https://files.pythonhosted.org/packages/d5/72/12b5f8d3865bf0f87cf1404d8c374e7487dcf097a1c91c436e72e6badd83/cffi-2.0.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b21e08af67b8a103c71a250401c78d5e0893beff75e28c53c98f4de42f774062", size = 220097, upload-time = "2025-09-08T23:22:48.677Z" }, + { url = "https://files.pythonhosted.org/packages/c2/95/7a135d52a50dfa7c882ab0ac17e8dc11cec9d55d2c18dda414c051c5e69e/cffi-2.0.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:1e3a615586f05fc4065a8b22b8152f0c1b00cdbc60596d187c2a74f9e3036e4e", size = 207983, upload-time = "2025-09-08T23:22:50.06Z" }, + { url = "https://files.pythonhosted.org/packages/3a/c8/15cb9ada8895957ea171c62dc78ff3e99159ee7adb13c0123c001a2546c1/cffi-2.0.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:81afed14892743bbe14dacb9e36d9e0e504cd204e0b165062c488942b9718037", size = 206519, upload-time = "2025-09-08T23:22:51.364Z" }, + { url = "https://files.pythonhosted.org/packages/78/2d/7fa73dfa841b5ac06c7b8855cfc18622132e365f5b81d02230333ff26e9e/cffi-2.0.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3e17ed538242334bf70832644a32a7aae3d83b57567f9fd60a26257e992b79ba", size = 219572, upload-time = "2025-09-08T23:22:52.902Z" }, + { url = "https://files.pythonhosted.org/packages/07/e0/267e57e387b4ca276b90f0434ff88b2c2241ad72b16d31836adddfd6031b/cffi-2.0.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3925dd22fa2b7699ed2617149842d2e6adde22b262fcbfada50e3d195e4b3a94", size = 222963, upload-time = "2025-09-08T23:22:54.518Z" }, + { url = "https://files.pythonhosted.org/packages/b6/75/1f2747525e06f53efbd878f4d03bac5b859cbc11c633d0fb81432d98a795/cffi-2.0.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:2c8f814d84194c9ea681642fd164267891702542f028a15fc97d4674b6206187", size = 221361, upload-time = "2025-09-08T23:22:55.867Z" }, + { url = "https://files.pythonhosted.org/packages/7b/2b/2b6435f76bfeb6bbf055596976da087377ede68df465419d192acf00c437/cffi-2.0.0-cp312-cp312-win32.whl", hash = "sha256:da902562c3e9c550df360bfa53c035b2f241fed6d9aef119048073680ace4a18", size = 172932, upload-time = "2025-09-08T23:22:57.188Z" }, + { url = "https://files.pythonhosted.org/packages/f8/ed/13bd4418627013bec4ed6e54283b1959cf6db888048c7cf4b4c3b5b36002/cffi-2.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:da68248800ad6320861f129cd9c1bf96ca849a2771a59e0344e88681905916f5", size = 183557, upload-time = "2025-09-08T23:22:58.351Z" }, + { url = "https://files.pythonhosted.org/packages/95/31/9f7f93ad2f8eff1dbc1c3656d7ca5bfd8fb52c9d786b4dcf19b2d02217fa/cffi-2.0.0-cp312-cp312-win_arm64.whl", hash = "sha256:4671d9dd5ec934cb9a73e7ee9676f9362aba54f7f34910956b84d727b0d73fb6", size = 177762, upload-time = "2025-09-08T23:22:59.668Z" }, + { url = "https://files.pythonhosted.org/packages/4b/8d/a0a47a0c9e413a658623d014e91e74a50cdd2c423f7ccfd44086ef767f90/cffi-2.0.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:00bdf7acc5f795150faa6957054fbbca2439db2f775ce831222b66f192f03beb", size = 185230, upload-time = "2025-09-08T23:23:00.879Z" }, + { url = "https://files.pythonhosted.org/packages/4a/d2/a6c0296814556c68ee32009d9c2ad4f85f2707cdecfd7727951ec228005d/cffi-2.0.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:45d5e886156860dc35862657e1494b9bae8dfa63bf56796f2fb56e1679fc0bca", size = 181043, upload-time = "2025-09-08T23:23:02.231Z" }, + { url = "https://files.pythonhosted.org/packages/b0/1e/d22cc63332bd59b06481ceaac49d6c507598642e2230f201649058a7e704/cffi-2.0.0-cp313-cp313-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:07b271772c100085dd28b74fa0cd81c8fb1a3ba18b21e03d7c27f3436a10606b", size = 212446, upload-time = "2025-09-08T23:23:03.472Z" }, + { url = "https://files.pythonhosted.org/packages/a9/f5/a2c23eb03b61a0b8747f211eb716446c826ad66818ddc7810cc2cc19b3f2/cffi-2.0.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d48a880098c96020b02d5a1f7d9251308510ce8858940e6fa99ece33f610838b", size = 220101, upload-time = "2025-09-08T23:23:04.792Z" }, + { url = "https://files.pythonhosted.org/packages/f2/7f/e6647792fc5850d634695bc0e6ab4111ae88e89981d35ac269956605feba/cffi-2.0.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:f93fd8e5c8c0a4aa1f424d6173f14a892044054871c771f8566e4008eaa359d2", size = 207948, upload-time = "2025-09-08T23:23:06.127Z" }, + { url = "https://files.pythonhosted.org/packages/cb/1e/a5a1bd6f1fb30f22573f76533de12a00bf274abcdc55c8edab639078abb6/cffi-2.0.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:dd4f05f54a52fb558f1ba9f528228066954fee3ebe629fc1660d874d040ae5a3", size = 206422, upload-time = "2025-09-08T23:23:07.753Z" }, + { url = "https://files.pythonhosted.org/packages/98/df/0a1755e750013a2081e863e7cd37e0cdd02664372c754e5560099eb7aa44/cffi-2.0.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c8d3b5532fc71b7a77c09192b4a5a200ea992702734a2e9279a37f2478236f26", size = 219499, upload-time = "2025-09-08T23:23:09.648Z" }, + { url = "https://files.pythonhosted.org/packages/50/e1/a969e687fcf9ea58e6e2a928ad5e2dd88cc12f6f0ab477e9971f2309b57c/cffi-2.0.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d9b29c1f0ae438d5ee9acb31cadee00a58c46cc9c0b2f9038c6b0b3470877a8c", size = 222928, upload-time = "2025-09-08T23:23:10.928Z" }, + { url = "https://files.pythonhosted.org/packages/36/54/0362578dd2c9e557a28ac77698ed67323ed5b9775ca9d3fe73fe191bb5d8/cffi-2.0.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6d50360be4546678fc1b79ffe7a66265e28667840010348dd69a314145807a1b", size = 221302, upload-time = "2025-09-08T23:23:12.42Z" }, + { url = "https://files.pythonhosted.org/packages/eb/6d/bf9bda840d5f1dfdbf0feca87fbdb64a918a69bca42cfa0ba7b137c48cb8/cffi-2.0.0-cp313-cp313-win32.whl", hash = "sha256:74a03b9698e198d47562765773b4a8309919089150a0bb17d829ad7b44b60d27", size = 172909, upload-time = "2025-09-08T23:23:14.32Z" }, + { url = "https://files.pythonhosted.org/packages/37/18/6519e1ee6f5a1e579e04b9ddb6f1676c17368a7aba48299c3759bbc3c8b3/cffi-2.0.0-cp313-cp313-win_amd64.whl", hash = "sha256:19f705ada2530c1167abacb171925dd886168931e0a7b78f5bffcae5c6b5be75", size = 183402, upload-time = "2025-09-08T23:23:15.535Z" }, + { url = "https://files.pythonhosted.org/packages/cb/0e/02ceeec9a7d6ee63bb596121c2c8e9b3a9e150936f4fbef6ca1943e6137c/cffi-2.0.0-cp313-cp313-win_arm64.whl", hash = "sha256:256f80b80ca3853f90c21b23ee78cd008713787b1b1e93eae9f3d6a7134abd91", size = 177780, upload-time = "2025-09-08T23:23:16.761Z" }, + { url = "https://files.pythonhosted.org/packages/92/c4/3ce07396253a83250ee98564f8d7e9789fab8e58858f35d07a9a2c78de9f/cffi-2.0.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:fc33c5141b55ed366cfaad382df24fe7dcbc686de5be719b207bb248e3053dc5", size = 185320, upload-time = "2025-09-08T23:23:18.087Z" }, + { url = "https://files.pythonhosted.org/packages/59/dd/27e9fa567a23931c838c6b02d0764611c62290062a6d4e8ff7863daf9730/cffi-2.0.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c654de545946e0db659b3400168c9ad31b5d29593291482c43e3564effbcee13", size = 181487, upload-time = "2025-09-08T23:23:19.622Z" }, + { url = "https://files.pythonhosted.org/packages/d6/43/0e822876f87ea8a4ef95442c3d766a06a51fc5298823f884ef87aaad168c/cffi-2.0.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:24b6f81f1983e6df8db3adc38562c83f7d4a0c36162885ec7f7b77c7dcbec97b", size = 220049, upload-time = "2025-09-08T23:23:20.853Z" }, + { url = "https://files.pythonhosted.org/packages/b4/89/76799151d9c2d2d1ead63c2429da9ea9d7aac304603de0c6e8764e6e8e70/cffi-2.0.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:12873ca6cb9b0f0d3a0da705d6086fe911591737a59f28b7936bdfed27c0d47c", size = 207793, upload-time = "2025-09-08T23:23:22.08Z" }, + { url = "https://files.pythonhosted.org/packages/bb/dd/3465b14bb9e24ee24cb88c9e3730f6de63111fffe513492bf8c808a3547e/cffi-2.0.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:d9b97165e8aed9272a6bb17c01e3cc5871a594a446ebedc996e2397a1c1ea8ef", size = 206300, upload-time = "2025-09-08T23:23:23.314Z" }, + { url = "https://files.pythonhosted.org/packages/47/d9/d83e293854571c877a92da46fdec39158f8d7e68da75bf73581225d28e90/cffi-2.0.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:afb8db5439b81cf9c9d0c80404b60c3cc9c3add93e114dcae767f1477cb53775", size = 219244, upload-time = "2025-09-08T23:23:24.541Z" }, + { url = "https://files.pythonhosted.org/packages/2b/0f/1f177e3683aead2bb00f7679a16451d302c436b5cbf2505f0ea8146ef59e/cffi-2.0.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:737fe7d37e1a1bffe70bd5754ea763a62a066dc5913ca57e957824b72a85e205", size = 222828, upload-time = "2025-09-08T23:23:26.143Z" }, + { url = "https://files.pythonhosted.org/packages/c6/0f/cafacebd4b040e3119dcb32fed8bdef8dfe94da653155f9d0b9dc660166e/cffi-2.0.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:38100abb9d1b1435bc4cc340bb4489635dc2f0da7456590877030c9b3d40b0c1", size = 220926, upload-time = "2025-09-08T23:23:27.873Z" }, + { url = "https://files.pythonhosted.org/packages/3e/aa/df335faa45b395396fcbc03de2dfcab242cd61a9900e914fe682a59170b1/cffi-2.0.0-cp314-cp314-win32.whl", hash = "sha256:087067fa8953339c723661eda6b54bc98c5625757ea62e95eb4898ad5e776e9f", size = 175328, upload-time = "2025-09-08T23:23:44.61Z" }, + { url = "https://files.pythonhosted.org/packages/bb/92/882c2d30831744296ce713f0feb4c1cd30f346ef747b530b5318715cc367/cffi-2.0.0-cp314-cp314-win_amd64.whl", hash = "sha256:203a48d1fb583fc7d78a4c6655692963b860a417c0528492a6bc21f1aaefab25", size = 185650, upload-time = "2025-09-08T23:23:45.848Z" }, + { url = "https://files.pythonhosted.org/packages/9f/2c/98ece204b9d35a7366b5b2c6539c350313ca13932143e79dc133ba757104/cffi-2.0.0-cp314-cp314-win_arm64.whl", hash = "sha256:dbd5c7a25a7cb98f5ca55d258b103a2054f859a46ae11aaf23134f9cc0d356ad", size = 180687, upload-time = "2025-09-08T23:23:47.105Z" }, + { url = "https://files.pythonhosted.org/packages/3e/61/c768e4d548bfa607abcda77423448df8c471f25dbe64fb2ef6d555eae006/cffi-2.0.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:9a67fc9e8eb39039280526379fb3a70023d77caec1852002b4da7e8b270c4dd9", size = 188773, upload-time = "2025-09-08T23:23:29.347Z" }, + { url = "https://files.pythonhosted.org/packages/2c/ea/5f76bce7cf6fcd0ab1a1058b5af899bfbef198bea4d5686da88471ea0336/cffi-2.0.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7a66c7204d8869299919db4d5069a82f1561581af12b11b3c9f48c584eb8743d", size = 185013, upload-time = "2025-09-08T23:23:30.63Z" }, + { url = "https://files.pythonhosted.org/packages/be/b4/c56878d0d1755cf9caa54ba71e5d049479c52f9e4afc230f06822162ab2f/cffi-2.0.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:7cc09976e8b56f8cebd752f7113ad07752461f48a58cbba644139015ac24954c", size = 221593, upload-time = "2025-09-08T23:23:31.91Z" }, + { url = "https://files.pythonhosted.org/packages/e0/0d/eb704606dfe8033e7128df5e90fee946bbcb64a04fcdaa97321309004000/cffi-2.0.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:92b68146a71df78564e4ef48af17551a5ddd142e5190cdf2c5624d0c3ff5b2e8", size = 209354, upload-time = "2025-09-08T23:23:33.214Z" }, + { url = "https://files.pythonhosted.org/packages/d8/19/3c435d727b368ca475fb8742ab97c9cb13a0de600ce86f62eab7fa3eea60/cffi-2.0.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:b1e74d11748e7e98e2f426ab176d4ed720a64412b6a15054378afdb71e0f37dc", size = 208480, upload-time = "2025-09-08T23:23:34.495Z" }, + { url = "https://files.pythonhosted.org/packages/d0/44/681604464ed9541673e486521497406fadcc15b5217c3e326b061696899a/cffi-2.0.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:28a3a209b96630bca57cce802da70c266eb08c6e97e5afd61a75611ee6c64592", size = 221584, upload-time = "2025-09-08T23:23:36.096Z" }, + { url = "https://files.pythonhosted.org/packages/25/8e/342a504ff018a2825d395d44d63a767dd8ebc927ebda557fecdaca3ac33a/cffi-2.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:7553fb2090d71822f02c629afe6042c299edf91ba1bf94951165613553984512", size = 224443, upload-time = "2025-09-08T23:23:37.328Z" }, + { url = "https://files.pythonhosted.org/packages/e1/5e/b666bacbbc60fbf415ba9988324a132c9a7a0448a9a8f125074671c0f2c3/cffi-2.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6c6c373cfc5c83a975506110d17457138c8c63016b563cc9ed6e056a82f13ce4", size = 223437, upload-time = "2025-09-08T23:23:38.945Z" }, + { url = "https://files.pythonhosted.org/packages/a0/1d/ec1a60bd1a10daa292d3cd6bb0b359a81607154fb8165f3ec95fe003b85c/cffi-2.0.0-cp314-cp314t-win32.whl", hash = "sha256:1fc9ea04857caf665289b7a75923f2c6ed559b8298a1b8c49e59f7dd95c8481e", size = 180487, upload-time = "2025-09-08T23:23:40.423Z" }, + { url = "https://files.pythonhosted.org/packages/bf/41/4c1168c74fac325c0c8156f04b6749c8b6a8f405bbf91413ba088359f60d/cffi-2.0.0-cp314-cp314t-win_amd64.whl", hash = "sha256:d68b6cef7827e8641e8ef16f4494edda8b36104d79773a334beaa1e3521430f6", size = 191726, upload-time = "2025-09-08T23:23:41.742Z" }, + { url = "https://files.pythonhosted.org/packages/ae/3a/dbeec9d1ee0844c679f6bb5d6ad4e9f198b1224f4e7a32825f47f6192b0c/cffi-2.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0a1527a803f0a659de1af2e1fd700213caba79377e27e4693648c2923da066f9", size = 184195, upload-time = "2025-09-08T23:23:43.004Z" }, +] + +[[package]] +name = "charset-normalizer" +version = "3.4.4" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/13/69/33ddede1939fdd074bce5434295f38fae7136463422fe4fd3e0e89b98062/charset_normalizer-3.4.4.tar.gz", hash = "sha256:94537985111c35f28720e43603b8e7b43a6ecfb2ce1d3058bbe955b73404e21a", size = 129418, upload-time = "2025-10-14T04:42:32.879Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/f3/85/1637cd4af66fa687396e757dec650f28025f2a2f5a5531a3208dc0ec43f2/charset_normalizer-3.4.4-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:0a98e6759f854bd25a58a73fa88833fba3b7c491169f86ce1180c948ab3fd394", size = 208425, upload-time = "2025-10-14T04:40:53.353Z" }, + { url = "https://files.pythonhosted.org/packages/9d/6a/04130023fef2a0d9c62d0bae2649b69f7b7d8d24ea5536feef50551029df/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b5b290ccc2a263e8d185130284f8501e3e36c5e02750fc6b6bdeb2e9e96f1e25", size = 148162, upload-time = "2025-10-14T04:40:54.558Z" }, + { url = "https://files.pythonhosted.org/packages/78/29/62328d79aa60da22c9e0b9a66539feae06ca0f5a4171ac4f7dc285b83688/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74bb723680f9f7a6234dcf67aea57e708ec1fbdf5699fb91dfd6f511b0a320ef", size = 144558, upload-time = "2025-10-14T04:40:55.677Z" }, + { url = "https://files.pythonhosted.org/packages/86/bb/b32194a4bf15b88403537c2e120b817c61cd4ecffa9b6876e941c3ee38fe/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f1e34719c6ed0b92f418c7c780480b26b5d9c50349e9a9af7d76bf757530350d", size = 161497, upload-time = "2025-10-14T04:40:57.217Z" }, + { url = "https://files.pythonhosted.org/packages/19/89/a54c82b253d5b9b111dc74aca196ba5ccfcca8242d0fb64146d4d3183ff1/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2437418e20515acec67d86e12bf70056a33abdacb5cb1655042f6538d6b085a8", size = 159240, upload-time = "2025-10-14T04:40:58.358Z" }, + { url = "https://files.pythonhosted.org/packages/c0/10/d20b513afe03acc89ec33948320a5544d31f21b05368436d580dec4e234d/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:11d694519d7f29d6cd09f6ac70028dba10f92f6cdd059096db198c283794ac86", size = 153471, upload-time = "2025-10-14T04:40:59.468Z" }, + { url = "https://files.pythonhosted.org/packages/61/fa/fbf177b55bdd727010f9c0a3c49eefa1d10f960e5f09d1d887bf93c2e698/charset_normalizer-3.4.4-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ac1c4a689edcc530fc9d9aa11f5774b9e2f33f9a0c6a57864e90908f5208d30a", size = 150864, upload-time = "2025-10-14T04:41:00.623Z" }, + { url = "https://files.pythonhosted.org/packages/05/12/9fbc6a4d39c0198adeebbde20b619790e9236557ca59fc40e0e3cebe6f40/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:21d142cc6c0ec30d2efee5068ca36c128a30b0f2c53c1c07bd78cb6bc1d3be5f", size = 150647, upload-time = "2025-10-14T04:41:01.754Z" }, + { url = "https://files.pythonhosted.org/packages/ad/1f/6a9a593d52e3e8c5d2b167daf8c6b968808efb57ef4c210acb907c365bc4/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:5dbe56a36425d26d6cfb40ce79c314a2e4dd6211d51d6d2191c00bed34f354cc", size = 145110, upload-time = "2025-10-14T04:41:03.231Z" }, + { url = "https://files.pythonhosted.org/packages/30/42/9a52c609e72471b0fc54386dc63c3781a387bb4fe61c20231a4ebcd58bdd/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:5bfbb1b9acf3334612667b61bd3002196fe2a1eb4dd74d247e0f2a4d50ec9bbf", size = 162839, upload-time = "2025-10-14T04:41:04.715Z" }, + { url = "https://files.pythonhosted.org/packages/c4/5b/c0682bbf9f11597073052628ddd38344a3d673fda35a36773f7d19344b23/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:d055ec1e26e441f6187acf818b73564e6e6282709e9bcb5b63f5b23068356a15", size = 150667, upload-time = "2025-10-14T04:41:05.827Z" }, + { url = "https://files.pythonhosted.org/packages/e4/24/a41afeab6f990cf2daf6cb8c67419b63b48cf518e4f56022230840c9bfb2/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:af2d8c67d8e573d6de5bc30cdb27e9b95e49115cd9baad5ddbd1a6207aaa82a9", size = 160535, upload-time = "2025-10-14T04:41:06.938Z" }, + { url = "https://files.pythonhosted.org/packages/2a/e5/6a4ce77ed243c4a50a1fecca6aaaab419628c818a49434be428fe24c9957/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:780236ac706e66881f3b7f2f32dfe90507a09e67d1d454c762cf642e6e1586e0", size = 154816, upload-time = "2025-10-14T04:41:08.101Z" }, + { url = "https://files.pythonhosted.org/packages/a8/ef/89297262b8092b312d29cdb2517cb1237e51db8ecef2e9af5edbe7b683b1/charset_normalizer-3.4.4-cp312-cp312-win32.whl", hash = "sha256:5833d2c39d8896e4e19b689ffc198f08ea58116bee26dea51e362ecc7cd3ed26", size = 99694, upload-time = "2025-10-14T04:41:09.23Z" }, + { url = "https://files.pythonhosted.org/packages/3d/2d/1e5ed9dd3b3803994c155cd9aacb60c82c331bad84daf75bcb9c91b3295e/charset_normalizer-3.4.4-cp312-cp312-win_amd64.whl", hash = "sha256:a79cfe37875f822425b89a82333404539ae63dbdddf97f84dcbc3d339aae9525", size = 107131, upload-time = "2025-10-14T04:41:10.467Z" }, + { url = "https://files.pythonhosted.org/packages/d0/d9/0ed4c7098a861482a7b6a95603edce4c0d9db2311af23da1fb2b75ec26fc/charset_normalizer-3.4.4-cp312-cp312-win_arm64.whl", hash = "sha256:376bec83a63b8021bb5c8ea75e21c4ccb86e7e45ca4eb81146091b56599b80c3", size = 100390, upload-time = "2025-10-14T04:41:11.915Z" }, + { url = "https://files.pythonhosted.org/packages/97/45/4b3a1239bbacd321068ea6e7ac28875b03ab8bc0aa0966452db17cd36714/charset_normalizer-3.4.4-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:e1f185f86a6f3403aa2420e815904c67b2f9ebc443f045edd0de921108345794", size = 208091, upload-time = "2025-10-14T04:41:13.346Z" }, + { url = "https://files.pythonhosted.org/packages/7d/62/73a6d7450829655a35bb88a88fca7d736f9882a27eacdca2c6d505b57e2e/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b39f987ae8ccdf0d2642338faf2abb1862340facc796048b604ef14919e55ed", size = 147936, upload-time = "2025-10-14T04:41:14.461Z" }, + { url = "https://files.pythonhosted.org/packages/89/c5/adb8c8b3d6625bef6d88b251bbb0d95f8205831b987631ab0c8bb5d937c2/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3162d5d8ce1bb98dd51af660f2121c55d0fa541b46dff7bb9b9f86ea1d87de72", size = 144180, upload-time = "2025-10-14T04:41:15.588Z" }, + { url = "https://files.pythonhosted.org/packages/91/ed/9706e4070682d1cc219050b6048bfd293ccf67b3d4f5a4f39207453d4b99/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:81d5eb2a312700f4ecaa977a8235b634ce853200e828fbadf3a9c50bab278328", size = 161346, upload-time = "2025-10-14T04:41:16.738Z" }, + { url = "https://files.pythonhosted.org/packages/d5/0d/031f0d95e4972901a2f6f09ef055751805ff541511dc1252ba3ca1f80cf5/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5bd2293095d766545ec1a8f612559f6b40abc0eb18bb2f5d1171872d34036ede", size = 158874, upload-time = "2025-10-14T04:41:17.923Z" }, + { url = "https://files.pythonhosted.org/packages/f5/83/6ab5883f57c9c801ce5e5677242328aa45592be8a00644310a008d04f922/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a8a8b89589086a25749f471e6a900d3f662d1d3b6e2e59dcecf787b1cc3a1894", size = 153076, upload-time = "2025-10-14T04:41:19.106Z" }, + { url = "https://files.pythonhosted.org/packages/75/1e/5ff781ddf5260e387d6419959ee89ef13878229732732ee73cdae01800f2/charset_normalizer-3.4.4-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc7637e2f80d8530ee4a78e878bce464f70087ce73cf7c1caf142416923b98f1", size = 150601, upload-time = "2025-10-14T04:41:20.245Z" }, + { url = "https://files.pythonhosted.org/packages/d7/57/71be810965493d3510a6ca79b90c19e48696fb1ff964da319334b12677f0/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f8bf04158c6b607d747e93949aa60618b61312fe647a6369f88ce2ff16043490", size = 150376, upload-time = "2025-10-14T04:41:21.398Z" }, + { url = "https://files.pythonhosted.org/packages/e5/d5/c3d057a78c181d007014feb7e9f2e65905a6c4ef182c0ddf0de2924edd65/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:554af85e960429cf30784dd47447d5125aaa3b99a6f0683589dbd27e2f45da44", size = 144825, upload-time = "2025-10-14T04:41:22.583Z" }, + { url = "https://files.pythonhosted.org/packages/e6/8c/d0406294828d4976f275ffbe66f00266c4b3136b7506941d87c00cab5272/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:74018750915ee7ad843a774364e13a3db91682f26142baddf775342c3f5b1133", size = 162583, upload-time = "2025-10-14T04:41:23.754Z" }, + { url = "https://files.pythonhosted.org/packages/d7/24/e2aa1f18c8f15c4c0e932d9287b8609dd30ad56dbe41d926bd846e22fb8d/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c0463276121fdee9c49b98908b3a89c39be45d86d1dbaa22957e38f6321d4ce3", size = 150366, upload-time = "2025-10-14T04:41:25.27Z" }, + { url = "https://files.pythonhosted.org/packages/e4/5b/1e6160c7739aad1e2df054300cc618b06bf784a7a164b0f238360721ab86/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:362d61fd13843997c1c446760ef36f240cf81d3ebf74ac62652aebaf7838561e", size = 160300, upload-time = "2025-10-14T04:41:26.725Z" }, + { url = "https://files.pythonhosted.org/packages/7a/10/f882167cd207fbdd743e55534d5d9620e095089d176d55cb22d5322f2afd/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9a26f18905b8dd5d685d6d07b0cdf98a79f3c7a918906af7cc143ea2e164c8bc", size = 154465, upload-time = "2025-10-14T04:41:28.322Z" }, + { url = "https://files.pythonhosted.org/packages/89/66/c7a9e1b7429be72123441bfdbaf2bc13faab3f90b933f664db506dea5915/charset_normalizer-3.4.4-cp313-cp313-win32.whl", hash = "sha256:9b35f4c90079ff2e2edc5b26c0c77925e5d2d255c42c74fdb70fb49b172726ac", size = 99404, upload-time = "2025-10-14T04:41:29.95Z" }, + { url = "https://files.pythonhosted.org/packages/c4/26/b9924fa27db384bdcd97ab83b4f0a8058d96ad9626ead570674d5e737d90/charset_normalizer-3.4.4-cp313-cp313-win_amd64.whl", hash = "sha256:b435cba5f4f750aa6c0a0d92c541fb79f69a387c91e61f1795227e4ed9cece14", size = 107092, upload-time = "2025-10-14T04:41:31.188Z" }, + { url = "https://files.pythonhosted.org/packages/af/8f/3ed4bfa0c0c72a7ca17f0380cd9e4dd842b09f664e780c13cff1dcf2ef1b/charset_normalizer-3.4.4-cp313-cp313-win_arm64.whl", hash = "sha256:542d2cee80be6f80247095cc36c418f7bddd14f4a6de45af91dfad36d817bba2", size = 100408, upload-time = "2025-10-14T04:41:32.624Z" }, + { url = "https://files.pythonhosted.org/packages/2a/35/7051599bd493e62411d6ede36fd5af83a38f37c4767b92884df7301db25d/charset_normalizer-3.4.4-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:da3326d9e65ef63a817ecbcc0df6e94463713b754fe293eaa03da99befb9a5bd", size = 207746, upload-time = "2025-10-14T04:41:33.773Z" }, + { url = "https://files.pythonhosted.org/packages/10/9a/97c8d48ef10d6cd4fcead2415523221624bf58bcf68a802721a6bc807c8f/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8af65f14dc14a79b924524b1e7fffe304517b2bff5a58bf64f30b98bbc5079eb", size = 147889, upload-time = "2025-10-14T04:41:34.897Z" }, + { url = "https://files.pythonhosted.org/packages/10/bf/979224a919a1b606c82bd2c5fa49b5c6d5727aa47b4312bb27b1734f53cd/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74664978bb272435107de04e36db5a9735e78232b85b77d45cfb38f758efd33e", size = 143641, upload-time = "2025-10-14T04:41:36.116Z" }, + { url = "https://files.pythonhosted.org/packages/ba/33/0ad65587441fc730dc7bd90e9716b30b4702dc7b617e6ba4997dc8651495/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:752944c7ffbfdd10c074dc58ec2d5a8a4cd9493b314d367c14d24c17684ddd14", size = 160779, upload-time = "2025-10-14T04:41:37.229Z" }, + { url = "https://files.pythonhosted.org/packages/67/ed/331d6b249259ee71ddea93f6f2f0a56cfebd46938bde6fcc6f7b9a3d0e09/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d1f13550535ad8cff21b8d757a3257963e951d96e20ec82ab44bc64aeb62a191", size = 159035, upload-time = "2025-10-14T04:41:38.368Z" }, + { url = "https://files.pythonhosted.org/packages/67/ff/f6b948ca32e4f2a4576aa129d8bed61f2e0543bf9f5f2b7fc3758ed005c9/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ecaae4149d99b1c9e7b88bb03e3221956f68fd6d50be2ef061b2381b61d20838", size = 152542, upload-time = "2025-10-14T04:41:39.862Z" }, + { url = "https://files.pythonhosted.org/packages/16/85/276033dcbcc369eb176594de22728541a925b2632f9716428c851b149e83/charset_normalizer-3.4.4-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:cb6254dc36b47a990e59e1068afacdcd02958bdcce30bb50cc1700a8b9d624a6", size = 149524, upload-time = "2025-10-14T04:41:41.319Z" }, + { url = "https://files.pythonhosted.org/packages/9e/f2/6a2a1f722b6aba37050e626530a46a68f74e63683947a8acff92569f979a/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c8ae8a0f02f57a6e61203a31428fa1d677cbe50c93622b4149d5c0f319c1d19e", size = 150395, upload-time = "2025-10-14T04:41:42.539Z" }, + { url = "https://files.pythonhosted.org/packages/60/bb/2186cb2f2bbaea6338cad15ce23a67f9b0672929744381e28b0592676824/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:47cc91b2f4dd2833fddaedd2893006b0106129d4b94fdb6af1f4ce5a9965577c", size = 143680, upload-time = "2025-10-14T04:41:43.661Z" }, + { url = "https://files.pythonhosted.org/packages/7d/a5/bf6f13b772fbb2a90360eb620d52ed8f796f3c5caee8398c3b2eb7b1c60d/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:82004af6c302b5d3ab2cfc4cc5f29db16123b1a8417f2e25f9066f91d4411090", size = 162045, upload-time = "2025-10-14T04:41:44.821Z" }, + { url = "https://files.pythonhosted.org/packages/df/c5/d1be898bf0dc3ef9030c3825e5d3b83f2c528d207d246cbabe245966808d/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:2b7d8f6c26245217bd2ad053761201e9f9680f8ce52f0fcd8d0755aeae5b2152", size = 149687, upload-time = "2025-10-14T04:41:46.442Z" }, + { url = "https://files.pythonhosted.org/packages/a5/42/90c1f7b9341eef50c8a1cb3f098ac43b0508413f33affd762855f67a410e/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:799a7a5e4fb2d5898c60b640fd4981d6a25f1c11790935a44ce38c54e985f828", size = 160014, upload-time = "2025-10-14T04:41:47.631Z" }, + { url = "https://files.pythonhosted.org/packages/76/be/4d3ee471e8145d12795ab655ece37baed0929462a86e72372fd25859047c/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:99ae2cffebb06e6c22bdc25801d7b30f503cc87dbd283479e7b606f70aff57ec", size = 154044, upload-time = "2025-10-14T04:41:48.81Z" }, + { url = "https://files.pythonhosted.org/packages/b0/6f/8f7af07237c34a1defe7defc565a9bc1807762f672c0fde711a4b22bf9c0/charset_normalizer-3.4.4-cp314-cp314-win32.whl", hash = "sha256:f9d332f8c2a2fcbffe1378594431458ddbef721c1769d78e2cbc06280d8155f9", size = 99940, upload-time = "2025-10-14T04:41:49.946Z" }, + { url = "https://files.pythonhosted.org/packages/4b/51/8ade005e5ca5b0d80fb4aff72a3775b325bdc3d27408c8113811a7cbe640/charset_normalizer-3.4.4-cp314-cp314-win_amd64.whl", hash = "sha256:8a6562c3700cce886c5be75ade4a5db4214fda19fede41d9792d100288d8f94c", size = 107104, upload-time = "2025-10-14T04:41:51.051Z" }, + { url = "https://files.pythonhosted.org/packages/da/5f/6b8f83a55bb8278772c5ae54a577f3099025f9ade59d0136ac24a0df4bde/charset_normalizer-3.4.4-cp314-cp314-win_arm64.whl", hash = "sha256:de00632ca48df9daf77a2c65a484531649261ec9f25489917f09e455cb09ddb2", size = 100743, upload-time = "2025-10-14T04:41:52.122Z" }, + { url = "https://files.pythonhosted.org/packages/0a/4c/925909008ed5a988ccbb72dcc897407e5d6d3bd72410d69e051fc0c14647/charset_normalizer-3.4.4-py3-none-any.whl", hash = "sha256:7a32c560861a02ff789ad905a2fe94e3f840803362c84fecf1851cb4cf3dc37f", size = 53402, upload-time = "2025-10-14T04:42:31.76Z" }, +] + +[[package]] +name = "colorama" +version = "0.4.6" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" }, +] + +[[package]] +name = "cryptography" +version = "46.0.3" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "cffi", marker = "platform_python_implementation != 'PyPy'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/9f/33/c00162f49c0e2fe8064a62cb92b93e50c74a72bc370ab92f86112b33ff62/cryptography-46.0.3.tar.gz", hash = "sha256:a8b17438104fed022ce745b362294d9ce35b4c2e45c1d958ad4a4b019285f4a1", size = 749258, upload-time = "2025-10-15T23:18:31.74Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/1d/42/9c391dd801d6cf0d561b5890549d4b27bafcc53b39c31a817e69d87c625b/cryptography-46.0.3-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:109d4ddfadf17e8e7779c39f9b18111a09efb969a301a31e987416a0191ed93a", size = 7225004, upload-time = "2025-10-15T23:16:52.239Z" }, + { url = "https://files.pythonhosted.org/packages/1c/67/38769ca6b65f07461eb200e85fc1639b438bdc667be02cf7f2cd6a64601c/cryptography-46.0.3-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:09859af8466b69bc3c27bdf4f5d84a665e0f7ab5088412e9e2ec49758eca5cbc", size = 4296667, upload-time = "2025-10-15T23:16:54.369Z" }, + { url = "https://files.pythonhosted.org/packages/5c/49/498c86566a1d80e978b42f0d702795f69887005548c041636df6ae1ca64c/cryptography-46.0.3-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:01ca9ff2885f3acc98c29f1860552e37f6d7c7d013d7334ff2a9de43a449315d", size = 4450807, upload-time = "2025-10-15T23:16:56.414Z" }, + { url = "https://files.pythonhosted.org/packages/4b/0a/863a3604112174c8624a2ac3c038662d9e59970c7f926acdcfaed8d61142/cryptography-46.0.3-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:6eae65d4c3d33da080cff9c4ab1f711b15c1d9760809dad6ea763f3812d254cb", size = 4299615, upload-time = "2025-10-15T23:16:58.442Z" }, + { url = "https://files.pythonhosted.org/packages/64/02/b73a533f6b64a69f3cd3872acb6ebc12aef924d8d103133bb3ea750dc703/cryptography-46.0.3-cp311-abi3-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:e5bf0ed4490068a2e72ac03d786693adeb909981cc596425d09032d372bcc849", size = 4016800, upload-time = "2025-10-15T23:17:00.378Z" }, + { url = "https://files.pythonhosted.org/packages/25/d5/16e41afbfa450cde85a3b7ec599bebefaef16b5c6ba4ec49a3532336ed72/cryptography-46.0.3-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:5ecfccd2329e37e9b7112a888e76d9feca2347f12f37918facbb893d7bb88ee8", size = 4984707, upload-time = "2025-10-15T23:17:01.98Z" }, + { url = "https://files.pythonhosted.org/packages/c9/56/e7e69b427c3878352c2fb9b450bd0e19ed552753491d39d7d0a2f5226d41/cryptography-46.0.3-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:a2c0cd47381a3229c403062f764160d57d4d175e022c1df84e168c6251a22eec", size = 4482541, upload-time = "2025-10-15T23:17:04.078Z" }, + { url = "https://files.pythonhosted.org/packages/78/f6/50736d40d97e8483172f1bb6e698895b92a223dba513b0ca6f06b2365339/cryptography-46.0.3-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:549e234ff32571b1f4076ac269fcce7a808d3bf98b76c8dd560e42dbc66d7d91", size = 4299464, upload-time = "2025-10-15T23:17:05.483Z" }, + { url = "https://files.pythonhosted.org/packages/00/de/d8e26b1a855f19d9994a19c702fa2e93b0456beccbcfe437eda00e0701f2/cryptography-46.0.3-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:c0a7bb1a68a5d3471880e264621346c48665b3bf1c3759d682fc0864c540bd9e", size = 4950838, upload-time = "2025-10-15T23:17:07.425Z" }, + { url = "https://files.pythonhosted.org/packages/8f/29/798fc4ec461a1c9e9f735f2fc58741b0daae30688f41b2497dcbc9ed1355/cryptography-46.0.3-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:10b01676fc208c3e6feeb25a8b83d81767e8059e1fe86e1dc62d10a3018fa926", size = 4481596, upload-time = "2025-10-15T23:17:09.343Z" }, + { url = "https://files.pythonhosted.org/packages/15/8d/03cd48b20a573adfff7652b76271078e3045b9f49387920e7f1f631d125e/cryptography-46.0.3-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:0abf1ffd6e57c67e92af68330d05760b7b7efb243aab8377e583284dbab72c71", size = 4426782, upload-time = "2025-10-15T23:17:11.22Z" }, + { url = "https://files.pythonhosted.org/packages/fa/b1/ebacbfe53317d55cf33165bda24c86523497a6881f339f9aae5c2e13e57b/cryptography-46.0.3-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:a04bee9ab6a4da801eb9b51f1b708a1b5b5c9eb48c03f74198464c66f0d344ac", size = 4698381, upload-time = "2025-10-15T23:17:12.829Z" }, + { url = "https://files.pythonhosted.org/packages/96/92/8a6a9525893325fc057a01f654d7efc2c64b9de90413adcf605a85744ff4/cryptography-46.0.3-cp311-abi3-win32.whl", hash = "sha256:f260d0d41e9b4da1ed1e0f1ce571f97fe370b152ab18778e9e8f67d6af432018", size = 3055988, upload-time = "2025-10-15T23:17:14.65Z" }, + { url = "https://files.pythonhosted.org/packages/7e/bf/80fbf45253ea585a1e492a6a17efcb93467701fa79e71550a430c5e60df0/cryptography-46.0.3-cp311-abi3-win_amd64.whl", hash = "sha256:a9a3008438615669153eb86b26b61e09993921ebdd75385ddd748702c5adfddb", size = 3514451, upload-time = "2025-10-15T23:17:16.142Z" }, + { url = "https://files.pythonhosted.org/packages/2e/af/9b302da4c87b0beb9db4e756386a7c6c5b8003cd0e742277888d352ae91d/cryptography-46.0.3-cp311-abi3-win_arm64.whl", hash = "sha256:5d7f93296ee28f68447397bf5198428c9aeeab45705a55d53a6343455dcb2c3c", size = 2928007, upload-time = "2025-10-15T23:17:18.04Z" }, + { url = "https://files.pythonhosted.org/packages/f5/e2/a510aa736755bffa9d2f75029c229111a1d02f8ecd5de03078f4c18d91a3/cryptography-46.0.3-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:00a5e7e87938e5ff9ff5447ab086a5706a957137e6e433841e9d24f38a065217", size = 7158012, upload-time = "2025-10-15T23:17:19.982Z" }, + { url = "https://files.pythonhosted.org/packages/73/dc/9aa866fbdbb95b02e7f9d086f1fccfeebf8953509b87e3f28fff927ff8a0/cryptography-46.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:c8daeb2d2174beb4575b77482320303f3d39b8e81153da4f0fb08eb5fe86a6c5", size = 4288728, upload-time = "2025-10-15T23:17:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/c5/fd/bc1daf8230eaa075184cbbf5f8cd00ba9db4fd32d63fb83da4671b72ed8a/cryptography-46.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:39b6755623145ad5eff1dab323f4eae2a32a77a7abef2c5089a04a3d04366715", size = 4435078, upload-time = "2025-10-15T23:17:23.042Z" }, + { url = "https://files.pythonhosted.org/packages/82/98/d3bd5407ce4c60017f8ff9e63ffee4200ab3e23fe05b765cab805a7db008/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:db391fa7c66df6762ee3f00c95a89e6d428f4d60e7abc8328f4fe155b5ac6e54", size = 4293460, upload-time = "2025-10-15T23:17:24.885Z" }, + { url = "https://files.pythonhosted.org/packages/26/e9/e23e7900983c2b8af7a08098db406cf989d7f09caea7897e347598d4cd5b/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:78a97cf6a8839a48c49271cdcbd5cf37ca2c1d6b7fdd86cc864f302b5e9bf459", size = 3995237, upload-time = "2025-10-15T23:17:26.449Z" }, + { url = "https://files.pythonhosted.org/packages/91/15/af68c509d4a138cfe299d0d7ddb14afba15233223ebd933b4bbdbc7155d3/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:dfb781ff7eaa91a6f7fd41776ec37c5853c795d3b358d4896fdbb5df168af422", size = 4967344, upload-time = "2025-10-15T23:17:28.06Z" }, + { url = "https://files.pythonhosted.org/packages/ca/e3/8643d077c53868b681af077edf6b3cb58288b5423610f21c62aadcbe99f4/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:6f61efb26e76c45c4a227835ddeae96d83624fb0d29eb5df5b96e14ed1a0afb7", size = 4466564, upload-time = "2025-10-15T23:17:29.665Z" }, + { url = "https://files.pythonhosted.org/packages/0e/43/c1e8726fa59c236ff477ff2b5dc071e54b21e5a1e51aa2cee1676f1c986f/cryptography-46.0.3-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:23b1a8f26e43f47ceb6d6a43115f33a5a37d57df4ea0ca295b780ae8546e8044", size = 4292415, upload-time = "2025-10-15T23:17:31.686Z" }, + { url = "https://files.pythonhosted.org/packages/42/f9/2f8fefdb1aee8a8e3256a0568cffc4e6d517b256a2fe97a029b3f1b9fe7e/cryptography-46.0.3-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:b419ae593c86b87014b9be7396b385491ad7f320bde96826d0dd174459e54665", size = 4931457, upload-time = "2025-10-15T23:17:33.478Z" }, + { url = "https://files.pythonhosted.org/packages/79/30/9b54127a9a778ccd6d27c3da7563e9f2d341826075ceab89ae3b41bf5be2/cryptography-46.0.3-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:50fc3343ac490c6b08c0cf0d704e881d0d660be923fd3076db3e932007e726e3", size = 4466074, upload-time = "2025-10-15T23:17:35.158Z" }, + { url = "https://files.pythonhosted.org/packages/ac/68/b4f4a10928e26c941b1b6a179143af9f4d27d88fe84a6a3c53592d2e76bf/cryptography-46.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:22d7e97932f511d6b0b04f2bfd818d73dcd5928db509460aaf48384778eb6d20", size = 4420569, upload-time = "2025-10-15T23:17:37.188Z" }, + { url = "https://files.pythonhosted.org/packages/a3/49/3746dab4c0d1979888f125226357d3262a6dd40e114ac29e3d2abdf1ec55/cryptography-46.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:d55f3dffadd674514ad19451161118fd010988540cee43d8bc20675e775925de", size = 4681941, upload-time = "2025-10-15T23:17:39.236Z" }, + { url = "https://files.pythonhosted.org/packages/fd/30/27654c1dbaf7e4a3531fa1fc77986d04aefa4d6d78259a62c9dc13d7ad36/cryptography-46.0.3-cp314-cp314t-win32.whl", hash = "sha256:8a6e050cb6164d3f830453754094c086ff2d0b2f3a897a1d9820f6139a1f0914", size = 3022339, upload-time = "2025-10-15T23:17:40.888Z" }, + { url = "https://files.pythonhosted.org/packages/f6/30/640f34ccd4d2a1bc88367b54b926b781b5a018d65f404d409aba76a84b1c/cryptography-46.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:760f83faa07f8b64e9c33fc963d790a2edb24efb479e3520c14a45741cd9b2db", size = 3494315, upload-time = "2025-10-15T23:17:42.769Z" }, + { url = "https://files.pythonhosted.org/packages/ba/8b/88cc7e3bd0a8e7b861f26981f7b820e1f46aa9d26cc482d0feba0ecb4919/cryptography-46.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:516ea134e703e9fe26bcd1277a4b59ad30586ea90c365a87781d7887a646fe21", size = 2919331, upload-time = "2025-10-15T23:17:44.468Z" }, + { url = "https://files.pythonhosted.org/packages/fd/23/45fe7f376a7df8daf6da3556603b36f53475a99ce4faacb6ba2cf3d82021/cryptography-46.0.3-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:cb3d760a6117f621261d662bccc8ef5bc32ca673e037c83fbe565324f5c46936", size = 7218248, upload-time = "2025-10-15T23:17:46.294Z" }, + { url = "https://files.pythonhosted.org/packages/27/32/b68d27471372737054cbd34c84981f9edbc24fe67ca225d389799614e27f/cryptography-46.0.3-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:4b7387121ac7d15e550f5cb4a43aef2559ed759c35df7336c402bb8275ac9683", size = 4294089, upload-time = "2025-10-15T23:17:48.269Z" }, + { url = "https://files.pythonhosted.org/packages/26/42/fa8389d4478368743e24e61eea78846a0006caffaf72ea24a15159215a14/cryptography-46.0.3-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:15ab9b093e8f09daab0f2159bb7e47532596075139dd74365da52ecc9cb46c5d", size = 4440029, upload-time = "2025-10-15T23:17:49.837Z" }, + { url = "https://files.pythonhosted.org/packages/5f/eb/f483db0ec5ac040824f269e93dd2bd8a21ecd1027e77ad7bdf6914f2fd80/cryptography-46.0.3-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:46acf53b40ea38f9c6c229599a4a13f0d46a6c3fa9ef19fc1a124d62e338dfa0", size = 4297222, upload-time = "2025-10-15T23:17:51.357Z" }, + { url = "https://files.pythonhosted.org/packages/fd/cf/da9502c4e1912cb1da3807ea3618a6829bee8207456fbbeebc361ec38ba3/cryptography-46.0.3-cp38-abi3-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:10ca84c4668d066a9878890047f03546f3ae0a6b8b39b697457b7757aaf18dbc", size = 4012280, upload-time = "2025-10-15T23:17:52.964Z" }, + { url = "https://files.pythonhosted.org/packages/6b/8f/9adb86b93330e0df8b3dcf03eae67c33ba89958fc2e03862ef1ac2b42465/cryptography-46.0.3-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:36e627112085bb3b81b19fed209c05ce2a52ee8b15d161b7c643a7d5a88491f3", size = 4978958, upload-time = "2025-10-15T23:17:54.965Z" }, + { url = "https://files.pythonhosted.org/packages/d1/a0/5fa77988289c34bdb9f913f5606ecc9ada1adb5ae870bd0d1054a7021cc4/cryptography-46.0.3-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:1000713389b75c449a6e979ffc7dcc8ac90b437048766cef052d4d30b8220971", size = 4473714, upload-time = "2025-10-15T23:17:56.754Z" }, + { url = "https://files.pythonhosted.org/packages/14/e5/fc82d72a58d41c393697aa18c9abe5ae1214ff6f2a5c18ac470f92777895/cryptography-46.0.3-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:b02cf04496f6576afffef5ddd04a0cb7d49cf6be16a9059d793a30b035f6b6ac", size = 4296970, upload-time = "2025-10-15T23:17:58.588Z" }, + { url = "https://files.pythonhosted.org/packages/78/06/5663ed35438d0b09056973994f1aec467492b33bd31da36e468b01ec1097/cryptography-46.0.3-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:71e842ec9bc7abf543b47cf86b9a743baa95f4677d22baa4c7d5c69e49e9bc04", size = 4940236, upload-time = "2025-10-15T23:18:00.897Z" }, + { url = "https://files.pythonhosted.org/packages/fc/59/873633f3f2dcd8a053b8dd1d38f783043b5fce589c0f6988bf55ef57e43e/cryptography-46.0.3-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:402b58fc32614f00980b66d6e56a5b4118e6cb362ae8f3fda141ba4689bd4506", size = 4472642, upload-time = "2025-10-15T23:18:02.749Z" }, + { url = "https://files.pythonhosted.org/packages/3d/39/8e71f3930e40f6877737d6f69248cf74d4e34b886a3967d32f919cc50d3b/cryptography-46.0.3-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:ef639cb3372f69ec44915fafcd6698b6cc78fbe0c2ea41be867f6ed612811963", size = 4423126, upload-time = "2025-10-15T23:18:04.85Z" }, + { url = "https://files.pythonhosted.org/packages/cd/c7/f65027c2810e14c3e7268353b1681932b87e5a48e65505d8cc17c99e36ae/cryptography-46.0.3-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:3b51b8ca4f1c6453d8829e1eb7299499ca7f313900dd4d89a24b8b87c0a780d4", size = 4686573, upload-time = "2025-10-15T23:18:06.908Z" }, + { url = "https://files.pythonhosted.org/packages/0a/6e/1c8331ddf91ca4730ab3086a0f1be19c65510a33b5a441cb334e7a2d2560/cryptography-46.0.3-cp38-abi3-win32.whl", hash = "sha256:6276eb85ef938dc035d59b87c8a7dc559a232f954962520137529d77b18ff1df", size = 3036695, upload-time = "2025-10-15T23:18:08.672Z" }, + { url = "https://files.pythonhosted.org/packages/90/45/b0d691df20633eff80955a0fc7695ff9051ffce8b69741444bd9ed7bd0db/cryptography-46.0.3-cp38-abi3-win_amd64.whl", hash = "sha256:416260257577718c05135c55958b674000baef9a1c7d9e8f306ec60d71db850f", size = 3501720, upload-time = "2025-10-15T23:18:10.632Z" }, + { url = "https://files.pythonhosted.org/packages/e8/cb/2da4cc83f5edb9c3257d09e1e7ab7b23f049c7962cae8d842bbef0a9cec9/cryptography-46.0.3-cp38-abi3-win_arm64.whl", hash = "sha256:d89c3468de4cdc4f08a57e214384d0471911a3830fcdaf7a8cc587e42a866372", size = 2918740, upload-time = "2025-10-15T23:18:12.277Z" }, +] + +[[package]] +name = "cython" +version = "3.2.2" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/29/17/55fc687ba986f2210298fa2f60fec265fa3004c3f9a1e958ea1fe2d4e061/cython-3.2.2.tar.gz", hash = "sha256:c3add3d483acc73129a61d105389344d792c17e7c1cee24863f16416bd071634", size = 3275797, upload-time = "2025-11-30T12:48:20.942Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/57/0f/6fd78dc581373722bb9dedfc90c35b59ba88af988756315af227a877c7a2/cython-3.2.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:692a41c8fe06fb2dc55ca2c8d71c80c469fd16fe69486ed99f3b3cbb2d3af83f", size = 2968037, upload-time = "2025-11-30T12:48:47.279Z" }, + { url = "https://files.pythonhosted.org/packages/b0/52/50b6263c2fbad73aae8911ce54641ee1739d430a0592d3b3510591d7842b/cython-3.2.2-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:098590c1dc309f8a0406ade031963a95a87714296b425539f9920aebf924560d", size = 3223137, upload-time = "2025-11-30T12:48:48.951Z" }, + { url = "https://files.pythonhosted.org/packages/d6/44/4e34d161674c9162c6eb9ddef0cd69d41d92ae7e6dee3945fed3a6871ebe/cython-3.2.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a3898c076e9c458bcb3e4936187919fda5f5365fe4c567d35d2b003444b6f3fe", size = 3390943, upload-time = "2025-11-30T12:48:51.125Z" }, + { url = "https://files.pythonhosted.org/packages/62/8a/ffc2df024c1341737008fbaf0fbea51ef983a7146b43b84a239f197cf005/cython-3.2.2-cp312-cp312-win_amd64.whl", hash = "sha256:2b910b89a2a71004064c5e890b9512a251eda63fae252caa0feb9835057035f9", size = 2756403, upload-time = "2025-11-30T12:48:52.929Z" }, + { url = "https://files.pythonhosted.org/packages/a2/4f/b5355918962ec28b376eb8e357c718d58baf32d6df7017be8d147dd4ba29/cython-3.2.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:aa24cd0bdab27ca099b2467806c684404add597c1108e07ddf7b6471653c85d7", size = 2958578, upload-time = "2025-11-30T12:48:55.354Z" }, + { url = "https://files.pythonhosted.org/packages/46/21/a8038c8253e7a5241ed1db6d031bac586f7a502d92f487124abbc3f3e94f/cython-3.2.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:60f4aa425e1ff98abf8d965ae7020f06dd2cbc01dbd945137d2f9cca4ff0524a", size = 3212479, upload-time = "2025-11-30T12:48:57.567Z" }, + { url = "https://files.pythonhosted.org/packages/57/c1/76928c07176a4402c74d5b304936ad8ee167dd04a07cf7dca545e8c25f9b/cython-3.2.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a473df474ba89e9fee81ee82b31062a267f9e598096b222783477e56d02ad12c", size = 3374773, upload-time = "2025-11-30T12:48:59.318Z" }, + { url = "https://files.pythonhosted.org/packages/fa/cb/ce641e07ba9c0cde8468e83e0214fb87020b74ba34dbb9dfe8d250a327f5/cython-3.2.2-cp313-cp313-win_amd64.whl", hash = "sha256:b4df52101209817fde7284cf779156f79142fb639b1d7840f11680ff4bb30604", size = 2754492, upload-time = "2025-11-30T12:49:01.029Z" }, + { url = "https://files.pythonhosted.org/packages/c0/f2/cd60f639f0fde38b71319d7b6808e1ff17a6fd7f3feaff475b866a5c0aef/cython-3.2.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:177faf4d61e9f2d4d2db61194ac9ec16d3fe3041c1b6830f871a01935319eeb3", size = 2969023, upload-time = "2025-11-30T12:49:02.734Z" }, + { url = "https://files.pythonhosted.org/packages/5d/45/6f155a9ad125536d8f30716c4d7571caae73ec811039d3ae33f9b535090d/cython-3.2.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8db28aef793c81dc69383b619ca508668998aaf099cd839d3cbae85184cce744", size = 3258270, upload-time = "2025-11-30T12:49:04.878Z" }, + { url = "https://files.pythonhosted.org/packages/af/7e/022c25886fdc3ff6a005b6ae4a1c3d8522006bb738367aa5bd6c2590130b/cython-3.2.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3de43a5786033a27fae1c882feb5ff0d023c38b83356e6800c1be0bcd6cf9f11", size = 3384504, upload-time = "2025-11-30T12:49:07.078Z" }, + { url = "https://files.pythonhosted.org/packages/b6/07/1e3e4faf6f785d5ba053e9d6320b3f338162dc122c27a7c540b49615fc39/cython-3.2.2-cp314-cp314-win_amd64.whl", hash = "sha256:fed44d0ab2d36f1b0301c770b0dafec23bcb9700d58e7769cd6d9136b3304c11", size = 2791504, upload-time = "2025-11-30T12:49:08.729Z" }, + { url = "https://files.pythonhosted.org/packages/f4/69/5430879d35235ec3d5ffd778862173b6419390509ae4e37a72bdd45d9e86/cython-3.2.2-cp39-abi3-macosx_10_9_x86_64.whl", hash = "sha256:a6387e3ad31342443916db9a419509935fddd8d4cbac34aab9c895ae55326a56", size = 2874031, upload-time = "2025-11-30T12:49:18.34Z" }, + { url = "https://files.pythonhosted.org/packages/51/fa/584f4b56b35b3e7a43dc16603dd722cb5528484da67c27136534b782827b/cython-3.2.2-cp39-abi3-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:436eb562d0affbc0b959f62f3f9c1ed251b9499e4f29c1d19514ae859894b6bf", size = 3210813, upload-time = "2025-11-30T12:49:20.55Z" }, + { url = "https://files.pythonhosted.org/packages/d1/d4/063c34a34d9ef54836a5dafb100b8f4fdbdaa63942913fe93f9eb93a11a2/cython-3.2.2-cp39-abi3-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:f560ff3aea5b5df93853ec7bf1a1e9623d6d511f4192f197559aca18fca43392", size = 2855611, upload-time = "2025-11-30T12:49:22.303Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/c0b8854e0bf6d444c88cc2050f550d964596daea20eaf1bc592fcfde2782/cython-3.2.2-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:d8c93fe128b58942832b1fcac96e48f93c2c69b569eff0d38d30fb5995fecfa0", size = 2992824, upload-time = "2025-11-30T12:49:24.02Z" }, + { url = "https://files.pythonhosted.org/packages/90/6f/741186935c52de99acf4d7fad5c3dcf28d980b4c95d171d9618f9c399316/cython-3.2.2-cp39-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:b4fe499eed7cd70b2aa4e096b9ce2588f5e6fdf049b46d40a5e55efcde6e4904", size = 2890389, upload-time = "2025-11-30T12:49:25.783Z" }, + { url = "https://files.pythonhosted.org/packages/5c/79/3e487876addd0d69c148a529f3973c1942498ad39cede1e63565676064ed/cython-3.2.2-cp39-abi3-musllinux_1_2_i686.whl", hash = "sha256:14432d7f207245a3c35556155873f494784169297b28978a6204f1c60d31553e", size = 3224881, upload-time = "2025-11-30T12:49:27.484Z" }, + { url = "https://files.pythonhosted.org/packages/15/b9/d9a103feb74d04579c6bde7b0cad6d5f45c002d843ca70788a5758707b68/cython-3.2.2-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:820c4a99dbf6b3e6c0300be42b4040b501eff0e1feeb80cfa52c48a346fb0df2", size = 3114308, upload-time = "2025-11-30T12:49:29.292Z" }, + { url = "https://files.pythonhosted.org/packages/18/56/90445707cff62ab72136857a0134c5e50f9c73920c1a3af5218dfdae1c19/cython-3.2.2-cp39-abi3-win32.whl", hash = "sha256:826cad0ad43ab05a26e873b5d625f64d458dc739ec6fdeecab848b60a91c4252", size = 2435212, upload-time = "2025-11-30T12:49:32.179Z" }, + { url = "https://files.pythonhosted.org/packages/44/54/25a98c2731521ac9fc18e17d79a0e7d58164d4db398f09e1bd24cdd27ed1/cython-3.2.2-cp39-abi3-win_arm64.whl", hash = "sha256:5f818d40bbcf17e2089e2de7840f0de1c0ca527acf9b044aba79d5f5d8a5bdba", size = 2440536, upload-time = "2025-11-30T12:49:34.109Z" }, + { url = "https://files.pythonhosted.org/packages/76/f2/98fd8d0b514622a789fd2824b59bd6041b799aaeeba14a8d92d52f6654dd/cython-3.2.2-py3-none-any.whl", hash = "sha256:13b99ecb9482aff6a6c12d1ca6feef6940c507af909914b49f568de74fa965fb", size = 1255106, upload-time = "2025-11-30T12:48:18.454Z" }, +] + +[[package]] +name = "defusedxml" +version = "0.7.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/0f/d5/c66da9b79e5bdb124974bfe172b4daf3c984ebd9c2a06e2b8a4dc7331c72/defusedxml-0.7.1.tar.gz", hash = "sha256:1bb3032db185915b62d7c6209c5a8792be6a32ab2fedacc84e01b52c51aa3e69", size = 75520, upload-time = "2021-03-08T10:59:26.269Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/07/6c/aa3f2f849e01cb6a001cd8554a88d4c77c5c1a31c95bdf1cf9301e6d9ef4/defusedxml-0.7.1-py2.py3-none-any.whl", hash = "sha256:a352e7e428770286cc899e2542b6cdaedb2b4953ff269a210103ec58f6198a61", size = 25604, upload-time = "2021-03-08T10:59:24.45Z" }, +] + +[[package]] +name = "dnspython" +version = "2.8.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/8c/8b/57666417c0f90f08bcafa776861060426765fdb422eb10212086fb811d26/dnspython-2.8.0.tar.gz", hash = "sha256:181d3c6996452cb1189c4046c61599b84a5a86e099562ffde77d26984ff26d0f", size = 368251, upload-time = "2025-09-07T18:58:00.022Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ba/5a/18ad964b0086c6e62e2e7500f7edc89e3faa45033c71c1893d34eed2b2de/dnspython-2.8.0-py3-none-any.whl", hash = "sha256:01d9bbc4a2d76bf0db7c1f729812ded6d912bd318d3b1cf81d30c0f845dbf3af", size = 331094, upload-time = "2025-09-07T18:57:58.071Z" }, +] + +[[package]] +name = "docutils" +version = "0.22.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/d9/02/111134bfeb6e6c7ac4c74594e39a59f6c0195dc4846afbeac3cba60f1927/docutils-0.22.3.tar.gz", hash = "sha256:21486ae730e4ca9f622677b1412b879af1791efcfba517e4c6f60be543fc8cdd", size = 2290153, upload-time = "2025-11-06T02:35:55.655Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/11/a8/c6a4b901d17399c77cd81fb001ce8961e9f5e04d3daf27e8925cb012e163/docutils-0.22.3-py3-none-any.whl", hash = "sha256:bd772e4aca73aff037958d44f2be5229ded4c09927fcf8690c577b66234d6ceb", size = 633032, upload-time = "2025-11-06T02:35:52.391Z" }, +] + +[[package]] +name = "email-validator" +version = "2.3.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "dnspython" }, + { name = "idna" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/f5/22/900cb125c76b7aaa450ce02fd727f452243f2e91a61af068b40adba60ea9/email_validator-2.3.0.tar.gz", hash = "sha256:9fc05c37f2f6cf439ff414f8fc46d917929974a82244c20eb10231ba60c54426", size = 51238, upload-time = "2025-08-26T13:09:06.831Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/de/15/545e2b6cf2e3be84bc1ed85613edd75b8aea69807a71c26f4ca6a9258e82/email_validator-2.3.0-py3-none-any.whl", hash = "sha256:80f13f623413e6b197ae73bb10bf4eb0908faf509ad8362c5edeb0be7fd450b4", size = 35604, upload-time = "2025-08-26T13:09:05.858Z" }, +] + +[[package]] +name = "execnet" +version = "2.1.2" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/bf/89/780e11f9588d9e7128a3f87788354c7946a9cbb1401ad38a48c4db9a4f07/execnet-2.1.2.tar.gz", hash = "sha256:63d83bfdd9a23e35b9c6a3261412324f964c2ec8dcd8d3c6916ee9373e0befcd", size = 166622, upload-time = "2025-11-12T09:56:37.75Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ab/84/02fc1827e8cdded4aa65baef11296a9bbe595c474f0d6d758af082d849fd/execnet-2.1.2-py3-none-any.whl", hash = "sha256:67fba928dd5a544b783f6056f449e5e3931a5c378b128bc18501f7ea79e296ec", size = 40708, upload-time = "2025-11-12T09:56:36.333Z" }, +] + +[[package]] +name = "id" +version = "1.5.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "requests" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/22/11/102da08f88412d875fa2f1a9a469ff7ad4c874b0ca6fed0048fe385bdb3d/id-1.5.0.tar.gz", hash = "sha256:292cb8a49eacbbdbce97244f47a97b4c62540169c976552e497fd57df0734c1d", size = 15237, upload-time = "2024-12-04T19:53:05.575Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/9f/cb/18326d2d89ad3b0dd143da971e77afd1e6ca6674f1b1c3df4b6bec6279fc/id-1.5.0-py3-none-any.whl", hash = "sha256:f1434e1cef91f2cbb8a4ec64663d5a23b9ed43ef44c4c957d02583d61714c658", size = 13611, upload-time = "2024-12-04T19:53:03.02Z" }, +] + +[[package]] +name = "idna" +version = "3.11" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" }, +] + +[[package]] +name = "imagesize" +version = "1.4.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/a7/84/62473fb57d61e31fef6e36d64a179c8781605429fd927b5dd608c997be31/imagesize-1.4.1.tar.gz", hash = "sha256:69150444affb9cb0d5cc5a92b3676f0b2fb7cd9ae39e947a5e11a36b4497cd4a", size = 1280026, upload-time = "2022-07-01T12:21:05.687Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ff/62/85c4c919272577931d407be5ba5d71c20f0b616d31a0befe0ae45bb79abd/imagesize-1.4.1-py2.py3-none-any.whl", hash = "sha256:0d8d18d08f840c19d0ee7ca1fd82490fdc3729b7ac93f49870406ddde8ef8d8b", size = 8769, upload-time = "2022-07-01T12:21:02.467Z" }, +] + +[[package]] +name = "iniconfig" +version = "2.3.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" }, +] + +[[package]] +name = "jaraco-classes" +version = "3.4.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "more-itertools" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/06/c0/ed4a27bc5571b99e3cff68f8a9fa5b56ff7df1c2251cc715a652ddd26402/jaraco.classes-3.4.0.tar.gz", hash = "sha256:47a024b51d0239c0dd8c8540c6c7f484be3b8fcf0b2d85c13825780d3b3f3acd", size = 11780, upload-time = "2024-03-31T07:27:36.643Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/7f/66/b15ce62552d84bbfcec9a4873ab79d993a1dd4edb922cbfccae192bd5b5f/jaraco.classes-3.4.0-py3-none-any.whl", hash = "sha256:f662826b6bed8cace05e7ff873ce0f9283b5c924470fe664fff1c2f00f581790", size = 6777, upload-time = "2024-03-31T07:27:34.792Z" }, +] + +[[package]] +name = "jaraco-context" +version = "6.0.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/df/ad/f3777b81bf0b6e7bc7514a1656d3e637b2e8e15fab2ce3235730b3e7a4e6/jaraco_context-6.0.1.tar.gz", hash = "sha256:9bae4ea555cf0b14938dc0aee7c9f32ed303aa20a3b73e7dc80111628792d1b3", size = 13912, upload-time = "2024-08-20T03:39:27.358Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ff/db/0c52c4cf5e4bd9f5d7135ec7669a3a767af21b3a308e1ed3674881e52b62/jaraco.context-6.0.1-py3-none-any.whl", hash = "sha256:f797fc481b490edb305122c9181830a3a5b76d84ef6d1aef2fb9b47ab956f9e4", size = 6825, upload-time = "2024-08-20T03:39:25.966Z" }, +] + +[[package]] +name = "jaraco-functools" +version = "4.3.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "more-itertools" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/f7/ed/1aa2d585304ec07262e1a83a9889880701079dde796ac7b1d1826f40c63d/jaraco_functools-4.3.0.tar.gz", hash = "sha256:cfd13ad0dd2c47a3600b439ef72d8615d482cedcff1632930d6f28924d92f294", size = 19755, upload-time = "2025-08-18T20:05:09.91Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b4/09/726f168acad366b11e420df31bf1c702a54d373a83f968d94141a8c3fde0/jaraco_functools-4.3.0-py3-none-any.whl", hash = "sha256:227ff8ed6f7b8f62c56deff101545fa7543cf2c8e7b82a7c2116e672f29c26e8", size = 10408, upload-time = "2025-08-18T20:05:08.69Z" }, +] + +[[package]] +name = "jeepney" +version = "0.9.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/7b/6f/357efd7602486741aa73ffc0617fb310a29b588ed0fd69c2399acbb85b0c/jeepney-0.9.0.tar.gz", hash = "sha256:cf0e9e845622b81e4a28df94c40345400256ec608d0e55bb8a3feaa9163f5732", size = 106758, upload-time = "2025-02-27T18:51:01.684Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, +] + +[[package]] +name = "jinja2" +version = "3.1.6" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "markupsafe" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/df/bf/f7da0350254c0ed7c72f3e33cef02e048281fec7ecec5f032d4aac52226b/jinja2-3.1.6.tar.gz", hash = "sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d", size = 245115, upload-time = "2025-03-05T20:05:02.478Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/62/a1/3d680cbfd5f4b8f15abc1d571870c5fc3e594bb582bc3b64ea099db13e56/jinja2-3.1.6-py3-none-any.whl", hash = "sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67", size = 134899, upload-time = "2025-03-05T20:05:00.369Z" }, +] + +[[package]] +name = "keyring" +version = "25.7.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "jaraco-classes" }, + { name = "jaraco-context" }, + { name = "jaraco-functools" }, + { name = "jeepney", marker = "sys_platform == 'linux'" }, + { name = "pywin32-ctypes", marker = "sys_platform == 'win32'" }, + { name = "secretstorage", marker = "sys_platform == 'linux'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/43/4b/674af6ef2f97d56f0ab5153bf0bfa28ccb6c3ed4d1babf4305449668807b/keyring-25.7.0.tar.gz", hash = "sha256:fe01bd85eb3f8fb3dd0405defdeac9a5b4f6f0439edbb3149577f244a2e8245b", size = 63516, upload-time = "2025-11-16T16:26:09.482Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/81/db/e655086b7f3a705df045bf0933bdd9c2f79bb3c97bfef1384598bb79a217/keyring-25.7.0-py3-none-any.whl", hash = "sha256:be4a0b195f149690c166e850609a477c532ddbfbaed96a404d4e43f8d5e2689f", size = 39160, upload-time = "2025-11-16T16:26:08.402Z" }, +] + +[[package]] +name = "librt" +version = "0.6.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/37/c3/cdff3c10e2e608490dc0a310ccf11ba777b3943ad4fcead2a2ade98c21e1/librt-0.6.3.tar.gz", hash = "sha256:c724a884e642aa2bbad52bb0203ea40406ad742368a5f90da1b220e970384aae", size = 54209, upload-time = "2025-11-29T14:01:56.058Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b4/2c/b59249c566f98fe90e178baf59e83f628d6c38fb8bc78319301fccda0b5e/librt-0.6.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:74418f718083009108dc9a42c21bf2e4802d49638a1249e13677585fcc9ca176", size = 27841, upload-time = "2025-11-29T14:00:58.925Z" }, + { url = "https://files.pythonhosted.org/packages/40/e8/9db01cafcd1a2872b76114c858f81cc29ce7ad606bc102020d6dabf470fb/librt-0.6.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:514f3f363d1ebc423357d36222c37e5c8e6674b6eae8d7195ac9a64903722057", size = 27844, upload-time = "2025-11-29T14:01:00.2Z" }, + { url = "https://files.pythonhosted.org/packages/59/4d/da449d3a7d83cc853af539dee42adc37b755d7eea4ad3880bacfd84b651d/librt-0.6.3-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:cf1115207a5049d1f4b7b4b72de0e52f228d6c696803d94843907111cbf80610", size = 84091, upload-time = "2025-11-29T14:01:01.118Z" }, + { url = "https://files.pythonhosted.org/packages/ea/6c/f90306906fb6cc6eaf4725870f0347115de05431e1f96d35114392d31fda/librt-0.6.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ad8ba80cdcea04bea7b78fcd4925bfbf408961e9d8397d2ee5d3ec121e20c08c", size = 88239, upload-time = "2025-11-29T14:01:02.11Z" }, + { url = "https://files.pythonhosted.org/packages/e7/ae/473ce7b423cfac2cb503851a89d9d2195bf615f534d5912bf86feeebbee7/librt-0.6.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4018904c83eab49c814e2494b4e22501a93cdb6c9f9425533fe693c3117126f9", size = 88815, upload-time = "2025-11-29T14:01:03.114Z" }, + { url = "https://files.pythonhosted.org/packages/c4/6d/934df738c87fb9617cabefe4891eece585a06abe6def25b4bca3b174429d/librt-0.6.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8983c5c06ac9c990eac5eb97a9f03fe41dc7e9d7993df74d9e8682a1056f596c", size = 90598, upload-time = "2025-11-29T14:01:04.071Z" }, + { url = "https://files.pythonhosted.org/packages/72/89/eeaa124f5e0f431c2b39119550378ae817a4b1a3c93fd7122f0639336fff/librt-0.6.3-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:d7769c579663a6f8dbf34878969ac71befa42067ce6bf78e6370bf0d1194997c", size = 88603, upload-time = "2025-11-29T14:01:05.02Z" }, + { url = "https://files.pythonhosted.org/packages/4d/ed/c60b3c1cfc27d709bc0288af428ce58543fcb5053cf3eadbc773c24257f5/librt-0.6.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:d3c9a07eafdc70556f8c220da4a538e715668c0c63cabcc436a026e4e89950bf", size = 92112, upload-time = "2025-11-29T14:01:06.304Z" }, + { url = "https://files.pythonhosted.org/packages/c1/ab/f56169be5f716ef4ab0277be70bcb1874b4effc262e655d85b505af4884d/librt-0.6.3-cp312-cp312-win32.whl", hash = "sha256:38320386a48a15033da295df276aea93a92dfa94a862e06893f75ea1d8bbe89d", size = 20127, upload-time = "2025-11-29T14:01:07.283Z" }, + { url = "https://files.pythonhosted.org/packages/ff/8d/222750ce82bf95125529eaab585ac7e2829df252f3cfc05d68792fb1dd2c/librt-0.6.3-cp312-cp312-win_amd64.whl", hash = "sha256:c0ecf4786ad0404b072196b5df774b1bb23c8aacdcacb6c10b4128bc7b00bd01", size = 21545, upload-time = "2025-11-29T14:01:08.184Z" }, + { url = "https://files.pythonhosted.org/packages/72/c9/f731ddcfb72f446a92a8674c6b8e1e2242773cce43a04f41549bd8b958ff/librt-0.6.3-cp312-cp312-win_arm64.whl", hash = "sha256:9f2a6623057989ebc469cd9cc8fe436c40117a0147627568d03f84aef7854c55", size = 20946, upload-time = "2025-11-29T14:01:09.384Z" }, + { url = "https://files.pythonhosted.org/packages/dd/aa/3055dd440f8b8b3b7e8624539a0749dd8e1913e978993bcca9ce7e306231/librt-0.6.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:9e716f9012148a81f02f46a04fc4c663420c6fbfeacfac0b5e128cf43b4413d3", size = 27874, upload-time = "2025-11-29T14:01:10.615Z" }, + { url = "https://files.pythonhosted.org/packages/ef/93/226d7dd455eaa4c26712b5ccb2dfcca12831baa7f898c8ffd3a831e29fda/librt-0.6.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:669ff2495728009a96339c5ad2612569c6d8be4474e68f3f3ac85d7c3261f5f5", size = 27852, upload-time = "2025-11-29T14:01:11.535Z" }, + { url = "https://files.pythonhosted.org/packages/4e/8b/db9d51191aef4e4cc06285250affe0bb0ad8b2ed815f7ca77951655e6f02/librt-0.6.3-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:349b6873ebccfc24c9efd244e49da9f8a5c10f60f07575e248921aae2123fc42", size = 84264, upload-time = "2025-11-29T14:01:12.461Z" }, + { url = "https://files.pythonhosted.org/packages/8d/53/297c96bda3b5a73bdaf748f1e3ae757edd29a0a41a956b9c10379f193417/librt-0.6.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0c74c26736008481c9f6d0adf1aedb5a52aff7361fea98276d1f965c0256ee70", size = 88432, upload-time = "2025-11-29T14:01:13.405Z" }, + { url = "https://files.pythonhosted.org/packages/54/3a/c005516071123278e340f22de72fa53d51e259d49215295c212da16c4dc2/librt-0.6.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:408a36ddc75e91918cb15b03460bdc8a015885025d67e68c6f78f08c3a88f522", size = 89014, upload-time = "2025-11-29T14:01:14.373Z" }, + { url = "https://files.pythonhosted.org/packages/8e/9b/ea715f818d926d17b94c80a12d81a79e95c44f52848e61e8ca1ff29bb9a9/librt-0.6.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e61ab234624c9ffca0248a707feffe6fac2343758a36725d8eb8a6efef0f8c30", size = 90807, upload-time = "2025-11-29T14:01:15.377Z" }, + { url = "https://files.pythonhosted.org/packages/f0/fc/4e2e4c87e002fa60917a8e474fd13c4bac9a759df82be3778573bb1ab954/librt-0.6.3-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:324462fe7e3896d592b967196512491ec60ca6e49c446fe59f40743d08c97917", size = 88890, upload-time = "2025-11-29T14:01:16.633Z" }, + { url = "https://files.pythonhosted.org/packages/70/7f/c7428734fbdfd4db3d5b9237fc3a857880b2ace66492836f6529fef25d92/librt-0.6.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:36b2ec8c15030002c7f688b4863e7be42820d7c62d9c6eece3db54a2400f0530", size = 92300, upload-time = "2025-11-29T14:01:17.658Z" }, + { url = "https://files.pythonhosted.org/packages/f9/0c/738c4824fdfe74dc0f95d5e90ef9e759d4ecf7fd5ba964d54a7703322251/librt-0.6.3-cp313-cp313-win32.whl", hash = "sha256:25b1b60cb059471c0c0c803e07d0dfdc79e41a0a122f288b819219ed162672a3", size = 20159, upload-time = "2025-11-29T14:01:18.61Z" }, + { url = "https://files.pythonhosted.org/packages/f2/95/93d0e61bc617306ecf4c54636b5cbde4947d872563565c4abdd9d07a39d3/librt-0.6.3-cp313-cp313-win_amd64.whl", hash = "sha256:10a95ad074e2a98c9e4abc7f5b7d40e5ecbfa84c04c6ab8a70fabf59bd429b88", size = 21484, upload-time = "2025-11-29T14:01:19.506Z" }, + { url = "https://files.pythonhosted.org/packages/10/23/abd7ace79ab54d1dbee265f13529266f686a7ce2d21ab59a992f989009b6/librt-0.6.3-cp313-cp313-win_arm64.whl", hash = "sha256:17000df14f552e86877d67e4ab7966912224efc9368e998c96a6974a8d609bf9", size = 20935, upload-time = "2025-11-29T14:01:20.415Z" }, + { url = "https://files.pythonhosted.org/packages/83/14/c06cb31152182798ed98be73f54932ab984894f5a8fccf9b73130897a938/librt-0.6.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8e695f25d1a425ad7a272902af8ab8c8d66c1998b177e4b5f5e7b4e215d0c88a", size = 27566, upload-time = "2025-11-29T14:01:21.609Z" }, + { url = "https://files.pythonhosted.org/packages/0c/b1/ce83ca7b057b06150519152f53a0b302d7c33c8692ce2f01f669b5a819d9/librt-0.6.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:3e84a4121a7ae360ca4da436548a9c1ca8ca134a5ced76c893cc5944426164bd", size = 27753, upload-time = "2025-11-29T14:01:22.558Z" }, + { url = "https://files.pythonhosted.org/packages/3b/ec/739a885ef0a2839b6c25f1b01c99149d2cb6a34e933ffc8c051fcd22012e/librt-0.6.3-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:05f385a414de3f950886ea0aad8f109650d4b712cf9cc14cc17f5f62a9ab240b", size = 83178, upload-time = "2025-11-29T14:01:23.555Z" }, + { url = "https://files.pythonhosted.org/packages/db/bd/dc18bb1489d48c0911b9f4d72eae2d304ea264e215ba80f1e6ba4a9fc41d/librt-0.6.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:36a8e337461150b05ca2c7bdedb9e591dfc262c5230422cea398e89d0c746cdc", size = 87266, upload-time = "2025-11-29T14:01:24.532Z" }, + { url = "https://files.pythonhosted.org/packages/94/f3/d0c5431b39eef15e48088b2d739ad84b17c2f1a22c0345c6d4c4a42b135e/librt-0.6.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:dcbe48f6a03979384f27086484dc2a14959be1613cb173458bd58f714f2c48f3", size = 87623, upload-time = "2025-11-29T14:01:25.798Z" }, + { url = "https://files.pythonhosted.org/packages/3b/15/9a52e90834e4bd6ee16cdbaf551cb32227cbaad27398391a189c489318bc/librt-0.6.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:4bca9e4c260233fba37b15c4ec2f78aa99c1a79fbf902d19dd4a763c5c3fb751", size = 89436, upload-time = "2025-11-29T14:01:26.769Z" }, + { url = "https://files.pythonhosted.org/packages/c3/8a/a7e78e46e8486e023c50f21758930ef4793999115229afd65de69e94c9cc/librt-0.6.3-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:760c25ed6ac968e24803eb5f7deb17ce026902d39865e83036bacbf5cf242aa8", size = 87540, upload-time = "2025-11-29T14:01:27.756Z" }, + { url = "https://files.pythonhosted.org/packages/49/01/93799044a1cccac31f1074b07c583e181829d240539657e7f305ae63ae2a/librt-0.6.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:4aa4a93a353ccff20df6e34fa855ae8fd788832c88f40a9070e3ddd3356a9f0e", size = 90597, upload-time = "2025-11-29T14:01:29.35Z" }, + { url = "https://files.pythonhosted.org/packages/a7/29/00c7f58b8f8eb1bad6529ffb6c9cdcc0890a27dac59ecda04f817ead5277/librt-0.6.3-cp314-cp314-win32.whl", hash = "sha256:cb92741c2b4ea63c09609b064b26f7f5d9032b61ae222558c55832ec3ad0bcaf", size = 18955, upload-time = "2025-11-29T14:01:30.325Z" }, + { url = "https://files.pythonhosted.org/packages/d7/13/2739e6e197a9f751375a37908a6a5b0bff637b81338497a1bcb5817394da/librt-0.6.3-cp314-cp314-win_amd64.whl", hash = "sha256:fdcd095b1b812d756fa5452aca93b962cf620694c0cadb192cec2bb77dcca9a2", size = 20263, upload-time = "2025-11-29T14:01:31.287Z" }, + { url = "https://files.pythonhosted.org/packages/e1/73/393868fc2158705ea003114a24e73bb10b03bda31e9ad7b5c5ec6575338b/librt-0.6.3-cp314-cp314-win_arm64.whl", hash = "sha256:822ca79e28720a76a935c228d37da6579edef048a17cd98d406a2484d10eda78", size = 19575, upload-time = "2025-11-29T14:01:32.229Z" }, + { url = "https://files.pythonhosted.org/packages/48/6d/3c8ff3dec21bf804a205286dd63fd28dcdbe00b8dd7eb7ccf2e21a40a0b0/librt-0.6.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:078cd77064d1640cb7b0650871a772956066174d92c8aeda188a489b58495179", size = 28732, upload-time = "2025-11-29T14:01:33.165Z" }, + { url = "https://files.pythonhosted.org/packages/f4/90/e214b8b4aa34ed3d3f1040719c06c4d22472c40c5ef81a922d5af7876eb4/librt-0.6.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:5cc22f7f5c0cc50ed69f4b15b9c51d602aabc4500b433aaa2ddd29e578f452f7", size = 29065, upload-time = "2025-11-29T14:01:34.088Z" }, + { url = "https://files.pythonhosted.org/packages/ab/90/ef61ed51f0a7770cc703422d907a757bbd8811ce820c333d3db2fd13542a/librt-0.6.3-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:14b345eb7afb61b9fdcdfda6738946bd11b8e0f6be258666b0646af3b9bb5916", size = 93703, upload-time = "2025-11-29T14:01:35.057Z" }, + { url = "https://files.pythonhosted.org/packages/a8/ae/c30bb119c35962cbe9a908a71da99c168056fc3f6e9bbcbc157d0b724d89/librt-0.6.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6d46aa46aa29b067f0b8b84f448fd9719aaf5f4c621cc279164d76a9dc9ab3e8", size = 98890, upload-time = "2025-11-29T14:01:36.031Z" }, + { url = "https://files.pythonhosted.org/packages/d1/96/47a4a78d252d36f072b79d592df10600d379a895c3880c8cbd2ac699f0ad/librt-0.6.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1b51ba7d9d5d9001494769eca8c0988adce25d0a970c3ba3f2eb9df9d08036fc", size = 98255, upload-time = "2025-11-29T14:01:37.058Z" }, + { url = "https://files.pythonhosted.org/packages/e5/28/779b5cc3cd9987683884eb5f5672e3251676bebaaae6b7da1cf366eb1da1/librt-0.6.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:ced0925a18fddcff289ef54386b2fc230c5af3c83b11558571124bfc485b8c07", size = 100769, upload-time = "2025-11-29T14:01:38.413Z" }, + { url = "https://files.pythonhosted.org/packages/28/d7/771755e57c375cb9d25a4e106f570607fd856e2cb91b02418db1db954796/librt-0.6.3-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:6bac97e51f66da2ca012adddbe9fd656b17f7368d439de30898f24b39512f40f", size = 98580, upload-time = "2025-11-29T14:01:39.459Z" }, + { url = "https://files.pythonhosted.org/packages/d0/ec/8b157eb8fbc066339a2f34b0aceb2028097d0ed6150a52e23284a311eafe/librt-0.6.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:b2922a0e8fa97395553c304edc3bd36168d8eeec26b92478e292e5d4445c1ef0", size = 101706, upload-time = "2025-11-29T14:01:40.474Z" }, + { url = "https://files.pythonhosted.org/packages/82/a8/4aaead9a06c795a318282aebf7d3e3e578fa889ff396e1b640c3be4c7806/librt-0.6.3-cp314-cp314t-win32.whl", hash = "sha256:f33462b19503ba68d80dac8a1354402675849259fb3ebf53b67de86421735a3a", size = 19465, upload-time = "2025-11-29T14:01:41.77Z" }, + { url = "https://files.pythonhosted.org/packages/3a/61/b7e6a02746c1731670c19ba07d86da90b1ae45d29e405c0b5615abf97cde/librt-0.6.3-cp314-cp314t-win_amd64.whl", hash = "sha256:04f8ce401d4f6380cfc42af0f4e67342bf34c820dae01343f58f472dbac75dcf", size = 21042, upload-time = "2025-11-29T14:01:42.865Z" }, + { url = "https://files.pythonhosted.org/packages/0e/3d/72cc9ec90bb80b5b1a65f0bb74a0f540195837baaf3b98c7fa4a7aa9718e/librt-0.6.3-cp314-cp314t-win_arm64.whl", hash = "sha256:afb39550205cc5e5c935762c6bf6a2bb34f7d21a68eadb25e2db7bf3593fecc0", size = 20246, upload-time = "2025-11-29T14:01:44.13Z" }, +] + +[[package]] +name = "markdown-it-py" +version = "4.0.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "mdurl" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" }, +] + +[[package]] +name = "markupsafe" +version = "3.0.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/7e/99/7690b6d4034fffd95959cbe0c02de8deb3098cc577c67bb6a24fe5d7caa7/markupsafe-3.0.3.tar.gz", hash = "sha256:722695808f4b6457b320fdc131280796bdceb04ab50fe1795cd540799ebe1698", size = 80313, upload-time = "2025-09-27T18:37:40.426Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/5a/72/147da192e38635ada20e0a2e1a51cf8823d2119ce8883f7053879c2199b5/markupsafe-3.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d53197da72cc091b024dd97249dfc7794d6a56530370992a5e1a08983ad9230e", size = 11615, upload-time = "2025-09-27T18:36:30.854Z" }, + { url = "https://files.pythonhosted.org/packages/9a/81/7e4e08678a1f98521201c3079f77db69fb552acd56067661f8c2f534a718/markupsafe-3.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1872df69a4de6aead3491198eaf13810b565bdbeec3ae2dc8780f14458ec73ce", size = 12020, upload-time = "2025-09-27T18:36:31.971Z" }, + { url = "https://files.pythonhosted.org/packages/1e/2c/799f4742efc39633a1b54a92eec4082e4f815314869865d876824c257c1e/markupsafe-3.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3a7e8ae81ae39e62a41ec302f972ba6ae23a5c5396c8e60113e9066ef893da0d", size = 24332, upload-time = "2025-09-27T18:36:32.813Z" }, + { url = "https://files.pythonhosted.org/packages/3c/2e/8d0c2ab90a8c1d9a24f0399058ab8519a3279d1bd4289511d74e909f060e/markupsafe-3.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d6dd0be5b5b189d31db7cda48b91d7e0a9795f31430b7f271219ab30f1d3ac9d", size = 22947, upload-time = "2025-09-27T18:36:33.86Z" }, + { url = "https://files.pythonhosted.org/packages/2c/54/887f3092a85238093a0b2154bd629c89444f395618842e8b0c41783898ea/markupsafe-3.0.3-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:94c6f0bb423f739146aec64595853541634bde58b2135f27f61c1ffd1cd4d16a", size = 21962, upload-time = "2025-09-27T18:36:35.099Z" }, + { url = "https://files.pythonhosted.org/packages/c9/2f/336b8c7b6f4a4d95e91119dc8521402461b74a485558d8f238a68312f11c/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:be8813b57049a7dc738189df53d69395eba14fb99345e0a5994914a3864c8a4b", size = 23760, upload-time = "2025-09-27T18:36:36.001Z" }, + { url = "https://files.pythonhosted.org/packages/32/43/67935f2b7e4982ffb50a4d169b724d74b62a3964bc1a9a527f5ac4f1ee2b/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:83891d0e9fb81a825d9a6d61e3f07550ca70a076484292a70fde82c4b807286f", size = 21529, upload-time = "2025-09-27T18:36:36.906Z" }, + { url = "https://files.pythonhosted.org/packages/89/e0/4486f11e51bbba8b0c041098859e869e304d1c261e59244baa3d295d47b7/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:77f0643abe7495da77fb436f50f8dab76dbc6e5fd25d39589a0f1fe6548bfa2b", size = 23015, upload-time = "2025-09-27T18:36:37.868Z" }, + { url = "https://files.pythonhosted.org/packages/2f/e1/78ee7a023dac597a5825441ebd17170785a9dab23de95d2c7508ade94e0e/markupsafe-3.0.3-cp312-cp312-win32.whl", hash = "sha256:d88b440e37a16e651bda4c7c2b930eb586fd15ca7406cb39e211fcff3bf3017d", size = 14540, upload-time = "2025-09-27T18:36:38.761Z" }, + { url = "https://files.pythonhosted.org/packages/aa/5b/bec5aa9bbbb2c946ca2733ef9c4ca91c91b6a24580193e891b5f7dbe8e1e/markupsafe-3.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:26a5784ded40c9e318cfc2bdb30fe164bdb8665ded9cd64d500a34fb42067b1c", size = 15105, upload-time = "2025-09-27T18:36:39.701Z" }, + { url = "https://files.pythonhosted.org/packages/e5/f1/216fc1bbfd74011693a4fd837e7026152e89c4bcf3e77b6692fba9923123/markupsafe-3.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:35add3b638a5d900e807944a078b51922212fb3dedb01633a8defc4b01a3c85f", size = 13906, upload-time = "2025-09-27T18:36:40.689Z" }, + { url = "https://files.pythonhosted.org/packages/38/2f/907b9c7bbba283e68f20259574b13d005c121a0fa4c175f9bed27c4597ff/markupsafe-3.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795", size = 11622, upload-time = "2025-09-27T18:36:41.777Z" }, + { url = "https://files.pythonhosted.org/packages/9c/d9/5f7756922cdd676869eca1c4e3c0cd0df60ed30199ffd775e319089cb3ed/markupsafe-3.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219", size = 12029, upload-time = "2025-09-27T18:36:43.257Z" }, + { url = "https://files.pythonhosted.org/packages/00/07/575a68c754943058c78f30db02ee03a64b3c638586fba6a6dd56830b30a3/markupsafe-3.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6", size = 24374, upload-time = "2025-09-27T18:36:44.508Z" }, + { url = "https://files.pythonhosted.org/packages/a9/21/9b05698b46f218fc0e118e1f8168395c65c8a2c750ae2bab54fc4bd4e0e8/markupsafe-3.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676", size = 22980, upload-time = "2025-09-27T18:36:45.385Z" }, + { url = "https://files.pythonhosted.org/packages/7f/71/544260864f893f18b6827315b988c146b559391e6e7e8f7252839b1b846a/markupsafe-3.0.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9", size = 21990, upload-time = "2025-09-27T18:36:46.916Z" }, + { url = "https://files.pythonhosted.org/packages/c2/28/b50fc2f74d1ad761af2f5dcce7492648b983d00a65b8c0e0cb457c82ebbe/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1", size = 23784, upload-time = "2025-09-27T18:36:47.884Z" }, + { url = "https://files.pythonhosted.org/packages/ed/76/104b2aa106a208da8b17a2fb72e033a5a9d7073c68f7e508b94916ed47a9/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc", size = 21588, upload-time = "2025-09-27T18:36:48.82Z" }, + { url = "https://files.pythonhosted.org/packages/b5/99/16a5eb2d140087ebd97180d95249b00a03aa87e29cc224056274f2e45fd6/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12", size = 23041, upload-time = "2025-09-27T18:36:49.797Z" }, + { url = "https://files.pythonhosted.org/packages/19/bc/e7140ed90c5d61d77cea142eed9f9c303f4c4806f60a1044c13e3f1471d0/markupsafe-3.0.3-cp313-cp313-win32.whl", hash = "sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed", size = 14543, upload-time = "2025-09-27T18:36:51.584Z" }, + { url = "https://files.pythonhosted.org/packages/05/73/c4abe620b841b6b791f2edc248f556900667a5a1cf023a6646967ae98335/markupsafe-3.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5", size = 15113, upload-time = "2025-09-27T18:36:52.537Z" }, + { url = "https://files.pythonhosted.org/packages/f0/3a/fa34a0f7cfef23cf9500d68cb7c32dd64ffd58a12b09225fb03dd37d5b80/markupsafe-3.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485", size = 13911, upload-time = "2025-09-27T18:36:53.513Z" }, + { url = "https://files.pythonhosted.org/packages/e4/d7/e05cd7efe43a88a17a37b3ae96e79a19e846f3f456fe79c57ca61356ef01/markupsafe-3.0.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73", size = 11658, upload-time = "2025-09-27T18:36:54.819Z" }, + { url = "https://files.pythonhosted.org/packages/99/9e/e412117548182ce2148bdeacdda3bb494260c0b0184360fe0d56389b523b/markupsafe-3.0.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37", size = 12066, upload-time = "2025-09-27T18:36:55.714Z" }, + { url = "https://files.pythonhosted.org/packages/bc/e6/fa0ffcda717ef64a5108eaa7b4f5ed28d56122c9a6d70ab8b72f9f715c80/markupsafe-3.0.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19", size = 25639, upload-time = "2025-09-27T18:36:56.908Z" }, + { url = "https://files.pythonhosted.org/packages/96/ec/2102e881fe9d25fc16cb4b25d5f5cde50970967ffa5dddafdb771237062d/markupsafe-3.0.3-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025", size = 23569, upload-time = "2025-09-27T18:36:57.913Z" }, + { url = "https://files.pythonhosted.org/packages/4b/30/6f2fce1f1f205fc9323255b216ca8a235b15860c34b6798f810f05828e32/markupsafe-3.0.3-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6", size = 23284, upload-time = "2025-09-27T18:36:58.833Z" }, + { url = "https://files.pythonhosted.org/packages/58/47/4a0ccea4ab9f5dcb6f79c0236d954acb382202721e704223a8aafa38b5c8/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f", size = 24801, upload-time = "2025-09-27T18:36:59.739Z" }, + { url = "https://files.pythonhosted.org/packages/6a/70/3780e9b72180b6fecb83a4814d84c3bf4b4ae4bf0b19c27196104149734c/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb", size = 22769, upload-time = "2025-09-27T18:37:00.719Z" }, + { url = "https://files.pythonhosted.org/packages/98/c5/c03c7f4125180fc215220c035beac6b9cb684bc7a067c84fc69414d315f5/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009", size = 23642, upload-time = "2025-09-27T18:37:01.673Z" }, + { url = "https://files.pythonhosted.org/packages/80/d6/2d1b89f6ca4bff1036499b1e29a1d02d282259f3681540e16563f27ebc23/markupsafe-3.0.3-cp313-cp313t-win32.whl", hash = "sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354", size = 14612, upload-time = "2025-09-27T18:37:02.639Z" }, + { url = "https://files.pythonhosted.org/packages/2b/98/e48a4bfba0a0ffcf9925fe2d69240bfaa19c6f7507b8cd09c70684a53c1e/markupsafe-3.0.3-cp313-cp313t-win_amd64.whl", hash = "sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218", size = 15200, upload-time = "2025-09-27T18:37:03.582Z" }, + { url = "https://files.pythonhosted.org/packages/0e/72/e3cc540f351f316e9ed0f092757459afbc595824ca724cbc5a5d4263713f/markupsafe-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287", size = 13973, upload-time = "2025-09-27T18:37:04.929Z" }, + { url = "https://files.pythonhosted.org/packages/33/8a/8e42d4838cd89b7dde187011e97fe6c3af66d8c044997d2183fbd6d31352/markupsafe-3.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:eaa9599de571d72e2daf60164784109f19978b327a3910d3e9de8c97b5b70cfe", size = 11619, upload-time = "2025-09-27T18:37:06.342Z" }, + { url = "https://files.pythonhosted.org/packages/b5/64/7660f8a4a8e53c924d0fa05dc3a55c9cee10bbd82b11c5afb27d44b096ce/markupsafe-3.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c47a551199eb8eb2121d4f0f15ae0f923d31350ab9280078d1e5f12b249e0026", size = 12029, upload-time = "2025-09-27T18:37:07.213Z" }, + { url = "https://files.pythonhosted.org/packages/da/ef/e648bfd021127bef5fa12e1720ffed0c6cbb8310c8d9bea7266337ff06de/markupsafe-3.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f34c41761022dd093b4b6896d4810782ffbabe30f2d443ff5f083e0cbbb8c737", size = 24408, upload-time = "2025-09-27T18:37:09.572Z" }, + { url = "https://files.pythonhosted.org/packages/41/3c/a36c2450754618e62008bf7435ccb0f88053e07592e6028a34776213d877/markupsafe-3.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:457a69a9577064c05a97c41f4e65148652db078a3a509039e64d3467b9e7ef97", size = 23005, upload-time = "2025-09-27T18:37:10.58Z" }, + { url = "https://files.pythonhosted.org/packages/bc/20/b7fdf89a8456b099837cd1dc21974632a02a999ec9bf7ca3e490aacd98e7/markupsafe-3.0.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e8afc3f2ccfa24215f8cb28dcf43f0113ac3c37c2f0f0806d8c70e4228c5cf4d", size = 22048, upload-time = "2025-09-27T18:37:11.547Z" }, + { url = "https://files.pythonhosted.org/packages/9a/a7/591f592afdc734f47db08a75793a55d7fbcc6902a723ae4cfbab61010cc5/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:ec15a59cf5af7be74194f7ab02d0f59a62bdcf1a537677ce67a2537c9b87fcda", size = 23821, upload-time = "2025-09-27T18:37:12.48Z" }, + { url = "https://files.pythonhosted.org/packages/7d/33/45b24e4f44195b26521bc6f1a82197118f74df348556594bd2262bda1038/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:0eb9ff8191e8498cca014656ae6b8d61f39da5f95b488805da4bb029cccbfbaf", size = 21606, upload-time = "2025-09-27T18:37:13.485Z" }, + { url = "https://files.pythonhosted.org/packages/ff/0e/53dfaca23a69fbfbbf17a4b64072090e70717344c52eaaaa9c5ddff1e5f0/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2713baf880df847f2bece4230d4d094280f4e67b1e813eec43b4c0e144a34ffe", size = 23043, upload-time = "2025-09-27T18:37:14.408Z" }, + { url = "https://files.pythonhosted.org/packages/46/11/f333a06fc16236d5238bfe74daccbca41459dcd8d1fa952e8fbd5dccfb70/markupsafe-3.0.3-cp314-cp314-win32.whl", hash = "sha256:729586769a26dbceff69f7a7dbbf59ab6572b99d94576a5592625d5b411576b9", size = 14747, upload-time = "2025-09-27T18:37:15.36Z" }, + { url = "https://files.pythonhosted.org/packages/28/52/182836104b33b444e400b14f797212f720cbc9ed6ba34c800639d154e821/markupsafe-3.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:bdc919ead48f234740ad807933cdf545180bfbe9342c2bb451556db2ed958581", size = 15341, upload-time = "2025-09-27T18:37:16.496Z" }, + { url = "https://files.pythonhosted.org/packages/6f/18/acf23e91bd94fd7b3031558b1f013adfa21a8e407a3fdb32745538730382/markupsafe-3.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:5a7d5dc5140555cf21a6fefbdbf8723f06fcd2f63ef108f2854de715e4422cb4", size = 14073, upload-time = "2025-09-27T18:37:17.476Z" }, + { url = "https://files.pythonhosted.org/packages/3c/f0/57689aa4076e1b43b15fdfa646b04653969d50cf30c32a102762be2485da/markupsafe-3.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:1353ef0c1b138e1907ae78e2f6c63ff67501122006b0f9abad68fda5f4ffc6ab", size = 11661, upload-time = "2025-09-27T18:37:18.453Z" }, + { url = "https://files.pythonhosted.org/packages/89/c3/2e67a7ca217c6912985ec766c6393b636fb0c2344443ff9d91404dc4c79f/markupsafe-3.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1085e7fbddd3be5f89cc898938f42c0b3c711fdcb37d75221de2666af647c175", size = 12069, upload-time = "2025-09-27T18:37:19.332Z" }, + { url = "https://files.pythonhosted.org/packages/f0/00/be561dce4e6ca66b15276e184ce4b8aec61fe83662cce2f7d72bd3249d28/markupsafe-3.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b52b4fb9df4eb9ae465f8d0c228a00624de2334f216f178a995ccdcf82c4634", size = 25670, upload-time = "2025-09-27T18:37:20.245Z" }, + { url = "https://files.pythonhosted.org/packages/50/09/c419f6f5a92e5fadde27efd190eca90f05e1261b10dbd8cbcb39cd8ea1dc/markupsafe-3.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fed51ac40f757d41b7c48425901843666a6677e3e8eb0abcff09e4ba6e664f50", size = 23598, upload-time = "2025-09-27T18:37:21.177Z" }, + { url = "https://files.pythonhosted.org/packages/22/44/a0681611106e0b2921b3033fc19bc53323e0b50bc70cffdd19f7d679bb66/markupsafe-3.0.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f190daf01f13c72eac4efd5c430a8de82489d9cff23c364c3ea822545032993e", size = 23261, upload-time = "2025-09-27T18:37:22.167Z" }, + { url = "https://files.pythonhosted.org/packages/5f/57/1b0b3f100259dc9fffe780cfb60d4be71375510e435efec3d116b6436d43/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e56b7d45a839a697b5eb268c82a71bd8c7f6c94d6fd50c3d577fa39a9f1409f5", size = 24835, upload-time = "2025-09-27T18:37:23.296Z" }, + { url = "https://files.pythonhosted.org/packages/26/6a/4bf6d0c97c4920f1597cc14dd720705eca0bf7c787aebc6bb4d1bead5388/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:f3e98bb3798ead92273dc0e5fd0f31ade220f59a266ffd8a4f6065e0a3ce0523", size = 22733, upload-time = "2025-09-27T18:37:24.237Z" }, + { url = "https://files.pythonhosted.org/packages/14/c7/ca723101509b518797fedc2fdf79ba57f886b4aca8a7d31857ba3ee8281f/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5678211cb9333a6468fb8d8be0305520aa073f50d17f089b5b4b477ea6e67fdc", size = 23672, upload-time = "2025-09-27T18:37:25.271Z" }, + { url = "https://files.pythonhosted.org/packages/fb/df/5bd7a48c256faecd1d36edc13133e51397e41b73bb77e1a69deab746ebac/markupsafe-3.0.3-cp314-cp314t-win32.whl", hash = "sha256:915c04ba3851909ce68ccc2b8e2cd691618c4dc4c4232fb7982bca3f41fd8c3d", size = 14819, upload-time = "2025-09-27T18:37:26.285Z" }, + { url = "https://files.pythonhosted.org/packages/1a/8a/0402ba61a2f16038b48b39bccca271134be00c5c9f0f623208399333c448/markupsafe-3.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4faffd047e07c38848ce017e8725090413cd80cbc23d86e55c587bf979e579c9", size = 15426, upload-time = "2025-09-27T18:37:27.316Z" }, + { url = "https://files.pythonhosted.org/packages/70/bc/6f1c2f612465f5fa89b95bead1f44dcb607670fd42891d8fdcd5d039f4f4/markupsafe-3.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:32001d6a8fc98c8cb5c947787c5d08b0a50663d139f1305bac5885d98d9b40fa", size = 14146, upload-time = "2025-09-27T18:37:28.327Z" }, +] + +[[package]] +name = "mdurl" +version = "0.1.2" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" }, +] + +[[package]] +name = "more-itertools" +version = "10.8.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ea/5d/38b681d3fce7a266dd9ab73c66959406d565b3e85f21d5e66e1181d93721/more_itertools-10.8.0.tar.gz", hash = "sha256:f638ddf8a1a0d134181275fb5d58b086ead7c6a72429ad725c67503f13ba30bd", size = 137431, upload-time = "2025-09-02T15:23:11.018Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a4/8e/469e5a4a2f5855992e425f3cb33804cc07bf18d48f2db061aec61ce50270/more_itertools-10.8.0-py3-none-any.whl", hash = "sha256:52d4362373dcf7c52546bc4af9a86ee7c4579df9a8dc268be0a2f949d376cc9b", size = 69667, upload-time = "2025-09-02T15:23:09.635Z" }, +] + +[[package]] +name = "mypy" +version = "1.19.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "librt" }, + { name = "mypy-extensions" }, + { name = "pathspec" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/f9/b5/b58cdc25fadd424552804bf410855d52324183112aa004f0732c5f6324cf/mypy-1.19.0.tar.gz", hash = "sha256:f6b874ca77f733222641e5c46e4711648c4037ea13646fd0cdc814c2eaec2528", size = 3579025, upload-time = "2025-11-28T15:49:01.26Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/11/7e/1afa8fb188b876abeaa14460dc4983f909aaacaa4bf5718c00b2c7e0b3d5/mypy-1.19.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:0fb3115cb8fa7c5f887c8a8d81ccdcb94cff334684980d847e5a62e926910e1d", size = 13207728, upload-time = "2025-11-28T15:46:26.463Z" }, + { url = "https://files.pythonhosted.org/packages/b2/13/f103d04962bcbefb1644f5ccb235998b32c337d6c13145ea390b9da47f3e/mypy-1.19.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:f3e19e3b897562276bb331074d64c076dbdd3e79213f36eed4e592272dabd760", size = 12202945, upload-time = "2025-11-28T15:48:49.143Z" }, + { url = "https://files.pythonhosted.org/packages/e4/93/a86a5608f74a22284a8ccea8592f6e270b61f95b8588951110ad797c2ddd/mypy-1.19.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b9d491295825182fba01b6ffe2c6fe4e5a49dbf4e2bb4d1217b6ced3b4797bc6", size = 12718673, upload-time = "2025-11-28T15:47:37.193Z" }, + { url = "https://files.pythonhosted.org/packages/3d/58/cf08fff9ced0423b858f2a7495001fda28dc058136818ee9dffc31534ea9/mypy-1.19.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6016c52ab209919b46169651b362068f632efcd5eb8ef9d1735f6f86da7853b2", size = 13608336, upload-time = "2025-11-28T15:48:32.625Z" }, + { url = "https://files.pythonhosted.org/packages/64/ed/9c509105c5a6d4b73bb08733102a3ea62c25bc02c51bca85e3134bf912d3/mypy-1.19.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:f188dcf16483b3e59f9278c4ed939ec0254aa8a60e8fc100648d9ab5ee95a431", size = 13833174, upload-time = "2025-11-28T15:45:48.091Z" }, + { url = "https://files.pythonhosted.org/packages/cd/71/01939b66e35c6f8cb3e6fdf0b657f0fd24de2f8ba5e523625c8e72328208/mypy-1.19.0-cp312-cp312-win_amd64.whl", hash = "sha256:0e3c3d1e1d62e678c339e7ade72746a9e0325de42cd2cccc51616c7b2ed1a018", size = 10112208, upload-time = "2025-11-28T15:46:41.702Z" }, + { url = "https://files.pythonhosted.org/packages/cb/0d/a1357e6bb49e37ce26fcf7e3cc55679ce9f4ebee0cd8b6ee3a0e301a9210/mypy-1.19.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:7686ed65dbabd24d20066f3115018d2dce030d8fa9db01aa9f0a59b6813e9f9e", size = 13191993, upload-time = "2025-11-28T15:47:22.336Z" }, + { url = "https://files.pythonhosted.org/packages/5d/75/8e5d492a879ec4490e6ba664b5154e48c46c85b5ac9785792a5ec6a4d58f/mypy-1.19.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:fd4a985b2e32f23bead72e2fb4bbe5d6aceee176be471243bd831d5b2644672d", size = 12174411, upload-time = "2025-11-28T15:44:55.492Z" }, + { url = "https://files.pythonhosted.org/packages/71/31/ad5dcee9bfe226e8eaba777e9d9d251c292650130f0450a280aec3485370/mypy-1.19.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fc51a5b864f73a3a182584b1ac75c404396a17eced54341629d8bdcb644a5bba", size = 12727751, upload-time = "2025-11-28T15:44:14.169Z" }, + { url = "https://files.pythonhosted.org/packages/77/06/b6b8994ce07405f6039701f4b66e9d23f499d0b41c6dd46ec28f96d57ec3/mypy-1.19.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:37af5166f9475872034b56c5efdcf65ee25394e9e1d172907b84577120714364", size = 13593323, upload-time = "2025-11-28T15:46:34.699Z" }, + { url = "https://files.pythonhosted.org/packages/68/b1/126e274484cccdf099a8e328d4fda1c7bdb98a5e888fa6010b00e1bbf330/mypy-1.19.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:510c014b722308c9bd377993bcbf9a07d7e0692e5fa8fc70e639c1eb19fc6bee", size = 13818032, upload-time = "2025-11-28T15:46:18.286Z" }, + { url = "https://files.pythonhosted.org/packages/f8/56/53a8f70f562dfc466c766469133a8a4909f6c0012d83993143f2a9d48d2d/mypy-1.19.0-cp313-cp313-win_amd64.whl", hash = "sha256:cabbee74f29aa9cd3b444ec2f1e4fa5a9d0d746ce7567a6a609e224429781f53", size = 10120644, upload-time = "2025-11-28T15:47:43.99Z" }, + { url = "https://files.pythonhosted.org/packages/b0/f4/7751f32f56916f7f8c229fe902cbdba3e4dd3f3ea9e8b872be97e7fc546d/mypy-1.19.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:f2e36bed3c6d9b5f35d28b63ca4b727cb0228e480826ffc8953d1892ddc8999d", size = 13185236, upload-time = "2025-11-28T15:45:20.696Z" }, + { url = "https://files.pythonhosted.org/packages/35/31/871a9531f09e78e8d145032355890384f8a5b38c95a2c7732d226b93242e/mypy-1.19.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:a18d8abdda14035c5718acb748faec09571432811af129bf0d9e7b2d6699bf18", size = 12213902, upload-time = "2025-11-28T15:46:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/58/b8/af221910dd40eeefa2077a59107e611550167b9994693fc5926a0b0f87c0/mypy-1.19.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f75e60aca3723a23511948539b0d7ed514dda194bc3755eae0bfc7a6b4887aa7", size = 12738600, upload-time = "2025-11-28T15:44:22.521Z" }, + { url = "https://files.pythonhosted.org/packages/11/9f/c39e89a3e319c1d9c734dedec1183b2cc3aefbab066ec611619002abb932/mypy-1.19.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8f44f2ae3c58421ee05fe609160343c25f70e3967f6e32792b5a78006a9d850f", size = 13592639, upload-time = "2025-11-28T15:48:08.55Z" }, + { url = "https://files.pythonhosted.org/packages/97/6d/ffaf5f01f5e284d9033de1267e6c1b8f3783f2cf784465378a86122e884b/mypy-1.19.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:63ea6a00e4bd6822adbfc75b02ab3653a17c02c4347f5bb0cf1d5b9df3a05835", size = 13799132, upload-time = "2025-11-28T15:47:06.032Z" }, + { url = "https://files.pythonhosted.org/packages/fe/b0/c33921e73aaa0106224e5a34822411bea38046188eb781637f5a5b07e269/mypy-1.19.0-cp314-cp314-win_amd64.whl", hash = "sha256:3ad925b14a0bb99821ff6f734553294aa6a3440a8cb082fe1f5b84dfb662afb1", size = 10269832, upload-time = "2025-11-28T15:47:29.392Z" }, + { url = "https://files.pythonhosted.org/packages/09/0e/fe228ed5aeab470c6f4eb82481837fadb642a5aa95cc8215fd2214822c10/mypy-1.19.0-py3-none-any.whl", hash = "sha256:0c01c99d626380752e527d5ce8e69ffbba2046eb8a060db0329690849cf9b6f9", size = 2469714, upload-time = "2025-11-28T15:45:33.22Z" }, +] + +[[package]] +name = "mypy-extensions" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/a2/6e/371856a3fb9d31ca8dac321cda606860fa4548858c0cc45d9d1d4ca2628b/mypy_extensions-1.1.0.tar.gz", hash = "sha256:52e68efc3284861e772bbcd66823fde5ae21fd2fdb51c62a211403730b916558", size = 6343, upload-time = "2025-04-22T14:54:24.164Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/79/7b/2c79738432f5c924bef5071f933bcc9efd0473bac3b4aa584a6f7c1c8df8/mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505", size = 4963, upload-time = "2025-04-22T14:54:22.983Z" }, +] + +[[package]] +name = "nh3" +version = "0.3.2" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ca/a5/34c26015d3a434409f4d2a1cd8821a06c05238703f49283ffeb937bef093/nh3-0.3.2.tar.gz", hash = "sha256:f394759a06df8b685a4ebfb1874fb67a9cbfd58c64fc5ed587a663c0e63ec376", size = 19288, upload-time = "2025-10-30T11:17:45.948Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/5b/01/a1eda067c0ba823e5e2bb033864ae4854549e49fb6f3407d2da949106bfb/nh3-0.3.2-cp314-cp314t-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:d18957a90806d943d141cc5e4a0fefa1d77cf0d7a156878bf9a66eed52c9cc7d", size = 1419839, upload-time = "2025-10-30T11:17:09.956Z" }, + { url = "https://files.pythonhosted.org/packages/30/57/07826ff65d59e7e9cc789ef1dc405f660cabd7458a1864ab58aefa17411b/nh3-0.3.2-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:45c953e57028c31d473d6b648552d9cab1efe20a42ad139d78e11d8f42a36130", size = 791183, upload-time = "2025-10-30T11:17:11.99Z" }, + { url = "https://files.pythonhosted.org/packages/af/2f/e8a86f861ad83f3bb5455f596d5c802e34fcdb8c53a489083a70fd301333/nh3-0.3.2-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2c9850041b77a9147d6bbd6dbbf13eeec7009eb60b44e83f07fcb2910075bf9b", size = 829127, upload-time = "2025-10-30T11:17:13.192Z" }, + { url = "https://files.pythonhosted.org/packages/d8/97/77aef4daf0479754e8e90c7f8f48f3b7b8725a3b8c0df45f2258017a6895/nh3-0.3.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:403c11563e50b915d0efdb622866d1d9e4506bce590ef7da57789bf71dd148b5", size = 997131, upload-time = "2025-10-30T11:17:14.677Z" }, + { url = "https://files.pythonhosted.org/packages/41/ee/fd8140e4df9d52143e89951dd0d797f5546004c6043285289fbbe3112293/nh3-0.3.2-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:0dca4365db62b2d71ff1620ee4f800c4729849906c5dd504ee1a7b2389558e31", size = 1068783, upload-time = "2025-10-30T11:17:15.861Z" }, + { url = "https://files.pythonhosted.org/packages/87/64/bdd9631779e2d588b08391f7555828f352e7f6427889daf2fa424bfc90c9/nh3-0.3.2-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:0fe7ee035dd7b2290715baf29cb27167dddd2ff70ea7d052c958dbd80d323c99", size = 994732, upload-time = "2025-10-30T11:17:17.155Z" }, + { url = "https://files.pythonhosted.org/packages/79/66/90190033654f1f28ca98e3d76b8be1194505583f9426b0dcde782a3970a2/nh3-0.3.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:a40202fd58e49129764f025bbaae77028e420f1d5b3c8e6f6fd3a6490d513868", size = 975997, upload-time = "2025-10-30T11:17:18.77Z" }, + { url = "https://files.pythonhosted.org/packages/34/30/ebf8e2e8d71fdb5a5d5d8836207177aed1682df819cbde7f42f16898946c/nh3-0.3.2-cp314-cp314t-win32.whl", hash = "sha256:1f9ba555a797dbdcd844b89523f29cdc90973d8bd2e836ea6b962cf567cadd93", size = 583364, upload-time = "2025-10-30T11:17:20.286Z" }, + { url = "https://files.pythonhosted.org/packages/94/ae/95c52b5a75da429f11ca8902c2128f64daafdc77758d370e4cc310ecda55/nh3-0.3.2-cp314-cp314t-win_amd64.whl", hash = "sha256:dce4248edc427c9b79261f3e6e2b3ecbdd9b88c267012168b4a7b3fc6fd41d13", size = 589982, upload-time = "2025-10-30T11:17:21.384Z" }, + { url = "https://files.pythonhosted.org/packages/b4/bd/c7d862a4381b95f2469704de32c0ad419def0f4a84b7a138a79532238114/nh3-0.3.2-cp314-cp314t-win_arm64.whl", hash = "sha256:019ecbd007536b67fdf76fab411b648fb64e2257ca3262ec80c3425c24028c80", size = 577126, upload-time = "2025-10-30T11:17:22.755Z" }, + { url = "https://files.pythonhosted.org/packages/b6/3e/f5a5cc2885c24be13e9b937441bd16a012ac34a657fe05e58927e8af8b7a/nh3-0.3.2-cp38-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:7064ccf5ace75825bd7bf57859daaaf16ed28660c1c6b306b649a9eda4b54b1e", size = 1431980, upload-time = "2025-10-30T11:17:25.457Z" }, + { url = "https://files.pythonhosted.org/packages/7f/f7/529a99324d7ef055de88b690858f4189379708abae92ace799365a797b7f/nh3-0.3.2-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c8745454cdd28bbbc90861b80a0111a195b0e3961b9fa2e672be89eb199fa5d8", size = 820805, upload-time = "2025-10-30T11:17:26.98Z" }, + { url = "https://files.pythonhosted.org/packages/3d/62/19b7c50ccd1fa7d0764822d2cea8f2a320f2fd77474c7a1805cb22cf69b0/nh3-0.3.2-cp38-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:72d67c25a84579f4a432c065e8b4274e53b7cf1df8f792cf846abfe2c3090866", size = 803527, upload-time = "2025-10-30T11:17:28.284Z" }, + { url = "https://files.pythonhosted.org/packages/4a/ca/f022273bab5440abff6302731a49410c5ef66b1a9502ba3fbb2df998d9ff/nh3-0.3.2-cp38-abi3-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:13398e676a14d6233f372c75f52d5ae74f98210172991f7a3142a736bd92b131", size = 1051674, upload-time = "2025-10-30T11:17:29.909Z" }, + { url = "https://files.pythonhosted.org/packages/fa/f7/5728e3b32a11daf5bd21cf71d91c463f74305938bc3eb9e0ac1ce141646e/nh3-0.3.2-cp38-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:03d617e5c8aa7331bd2659c654e021caf9bba704b109e7b2b28b039a00949fe5", size = 1004737, upload-time = "2025-10-30T11:17:31.205Z" }, + { url = "https://files.pythonhosted.org/packages/53/7f/f17e0dba0a99cee29e6cee6d4d52340ef9cb1f8a06946d3a01eb7ec2fb01/nh3-0.3.2-cp38-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f2f55c4d2d5a207e74eefe4d828067bbb01300e06e2a7436142f915c5928de07", size = 911745, upload-time = "2025-10-30T11:17:32.945Z" }, + { url = "https://files.pythonhosted.org/packages/42/0f/c76bf3dba22c73c38e9b1113b017cf163f7696f50e003404ec5ecdb1e8a6/nh3-0.3.2-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7bb18403f02b655a1bbe4e3a4696c2ae1d6ae8f5991f7cacb684b1ae27e6c9f7", size = 797184, upload-time = "2025-10-30T11:17:34.226Z" }, + { url = "https://files.pythonhosted.org/packages/08/a1/73d8250f888fb0ddf1b119b139c382f8903d8bb0c5bd1f64afc7e38dad1d/nh3-0.3.2-cp38-abi3-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6d66f41672eb4060cf87c037f760bdbc6847852ca9ef8e9c5a5da18f090abf87", size = 838556, upload-time = "2025-10-30T11:17:35.875Z" }, + { url = "https://files.pythonhosted.org/packages/d1/09/deb57f1fb656a7a5192497f4a287b0ade5a2ff6b5d5de4736d13ef6d2c1f/nh3-0.3.2-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:f97f8b25cb2681d25e2338148159447e4d689aafdccfcf19e61ff7db3905768a", size = 1006695, upload-time = "2025-10-30T11:17:37.071Z" }, + { url = "https://files.pythonhosted.org/packages/b6/61/8f4d41c4ccdac30e4b1a4fa7be4b0f9914d8314a5058472f84c8e101a418/nh3-0.3.2-cp38-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:2ab70e8c6c7d2ce953d2a58102eefa90c2d0a5ed7aa40c7e29a487bc5e613131", size = 1075471, upload-time = "2025-10-30T11:17:38.225Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c6/966aec0cb4705e69f6c3580422c239205d5d4d0e50fac380b21e87b6cf1b/nh3-0.3.2-cp38-abi3-musllinux_1_2_i686.whl", hash = "sha256:1710f3901cd6440ca92494ba2eb6dc260f829fa8d9196b659fa10de825610ce0", size = 1002439, upload-time = "2025-10-30T11:17:39.553Z" }, + { url = "https://files.pythonhosted.org/packages/e2/c8/97a2d5f7a314cce2c5c49f30c6f161b7f3617960ade4bfc2fd1ee092cb20/nh3-0.3.2-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:91e9b001101fb4500a2aafe3e7c92928d85242d38bf5ac0aba0b7480da0a4cd6", size = 987439, upload-time = "2025-10-30T11:17:40.81Z" }, + { url = "https://files.pythonhosted.org/packages/0d/95/2d6fc6461687d7a171f087995247dec33e8749a562bfadd85fb5dbf37a11/nh3-0.3.2-cp38-abi3-win32.whl", hash = "sha256:169db03df90da63286e0560ea0efa9b6f3b59844a9735514a1d47e6bb2c8c61b", size = 589826, upload-time = "2025-10-30T11:17:42.239Z" }, + { url = "https://files.pythonhosted.org/packages/64/9a/1a1c154f10a575d20dd634e5697805e589bbdb7673a0ad00e8da90044ba7/nh3-0.3.2-cp38-abi3-win_amd64.whl", hash = "sha256:562da3dca7a17f9077593214a9781a94b8d76de4f158f8c895e62f09573945fe", size = 596406, upload-time = "2025-10-30T11:17:43.773Z" }, + { url = "https://files.pythonhosted.org/packages/9e/7e/a96255f63b7aef032cbee8fc4d6e37def72e3aaedc1f72759235e8f13cb1/nh3-0.3.2-cp38-abi3-win_arm64.whl", hash = "sha256:cf5964d54edd405e68583114a7cba929468bcd7db5e676ae38ee954de1cfc104", size = 584162, upload-time = "2025-10-30T11:17:44.96Z" }, +] + +[[package]] +name = "nodeenv" +version = "1.9.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/43/16/fc88b08840de0e0a72a2f9d8c6bae36be573e475a6326ae854bcc549fc45/nodeenv-1.9.1.tar.gz", hash = "sha256:6ec12890a2dab7946721edbfbcd91f3319c6ccc9aec47be7c7e6b7011ee6645f", size = 47437, upload-time = "2024-06-04T18:44:11.171Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/d2/1d/1b658dbd2b9fa9c4c9f32accbfc0205d532c8c6194dc0f2a4c0428e7128a/nodeenv-1.9.1-py2.py3-none-any.whl", hash = "sha256:ba11c9782d29c27c70ffbdda2d7415098754709be8a7056d79a737cd901155c9", size = 22314, upload-time = "2024-06-04T18:44:08.352Z" }, +] + +[[package]] +name = "packaging" +version = "25.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/a1/d4/1fc4078c65507b51b96ca8f8c3ba19e6a61c8253c72794544580a7b6c24d/packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f", size = 165727, upload-time = "2025-04-19T11:48:59.673Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484", size = 66469, upload-time = "2025-04-19T11:48:57.875Z" }, +] + +[[package]] +name = "pathspec" +version = "0.12.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ca/bc/f35b8446f4531a7cb215605d100cd88b7ac6f44ab3fc94870c120ab3adbf/pathspec-0.12.1.tar.gz", hash = "sha256:a482d51503a1ab33b1c67a6c3813a26953dbdc71c31dacaef9a838c4e29f5712", size = 51043, upload-time = "2023-12-10T22:30:45Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cc/20/ff623b09d963f88bfde16306a54e12ee5ea43e9b597108672ff3a408aad6/pathspec-0.12.1-py3-none-any.whl", hash = "sha256:a0d503e138a4c123b27490a4f7beda6a01c6f288df0e4a8b79c7eb0dc7b4cc08", size = 31191, upload-time = "2023-12-10T22:30:43.14Z" }, +] + +[[package]] +name = "platformdirs" +version = "4.5.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/61/33/9611380c2bdb1225fdef633e2a9610622310fed35ab11dac9620972ee088/platformdirs-4.5.0.tar.gz", hash = "sha256:70ddccdd7c99fc5942e9fc25636a8b34d04c24b335100223152c2803e4063312", size = 21632, upload-time = "2025-10-08T17:44:48.791Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/73/cb/ac7874b3e5d58441674fb70742e6c374b28b0c7cb988d37d991cde47166c/platformdirs-4.5.0-py3-none-any.whl", hash = "sha256:e578a81bb873cbb89a41fcc904c7ef523cc18284b7e3b3ccf06aca1403b7ebd3", size = 18651, upload-time = "2025-10-08T17:44:47.223Z" }, +] + +[[package]] +name = "pluggy" +version = "1.6.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" }, +] + +[[package]] +name = "polib" +version = "1.2.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/10/9a/79b1067d27e38ddf84fe7da6ec516f1743f31f752c6122193e7bce38bdbf/polib-1.2.0.tar.gz", hash = "sha256:f3ef94aefed6e183e342a8a269ae1fc4742ba193186ad76f175938621dbfc26b", size = 161658, upload-time = "2023-02-23T17:53:56.873Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/6b/99/45bb1f9926efe370c6dbe324741c749658e44cb060124f28dad201202274/polib-1.2.0-py2.py3-none-any.whl", hash = "sha256:1c77ee1b81feb31df9bca258cbc58db1bbb32d10214b173882452c73af06d62d", size = 20634, upload-time = "2023-02-23T17:53:59.919Z" }, +] + +[[package]] +name = "psutil" +version = "7.1.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/e1/88/bdd0a41e5857d5d703287598cbf08dad90aed56774ea52ae071bae9071b6/psutil-7.1.3.tar.gz", hash = "sha256:6c86281738d77335af7aec228328e944b30930899ea760ecf33a4dba66be5e74", size = 489059, upload-time = "2025-11-02T12:25:54.619Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/bd/93/0c49e776b8734fef56ec9c5c57f923922f2cf0497d62e0f419465f28f3d0/psutil-7.1.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:0005da714eee687b4b8decd3d6cc7c6db36215c9e74e5ad2264b90c3df7d92dc", size = 239751, upload-time = "2025-11-02T12:25:58.161Z" }, + { url = "https://files.pythonhosted.org/packages/6f/8d/b31e39c769e70780f007969815195a55c81a63efebdd4dbe9e7a113adb2f/psutil-7.1.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:19644c85dcb987e35eeeaefdc3915d059dac7bd1167cdcdbf27e0ce2df0c08c0", size = 240368, upload-time = "2025-11-02T12:26:00.491Z" }, + { url = "https://files.pythonhosted.org/packages/62/61/23fd4acc3c9eebbf6b6c78bcd89e5d020cfde4acf0a9233e9d4e3fa698b4/psutil-7.1.3-cp313-cp313t-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:95ef04cf2e5ba0ab9eaafc4a11eaae91b44f4ef5541acd2ee91d9108d00d59a7", size = 287134, upload-time = "2025-11-02T12:26:02.613Z" }, + { url = "https://files.pythonhosted.org/packages/30/1c/f921a009ea9ceb51aa355cb0cc118f68d354db36eae18174bab63affb3e6/psutil-7.1.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1068c303be3a72f8e18e412c5b2a8f6d31750fb152f9cb106b54090296c9d251", size = 289904, upload-time = "2025-11-02T12:26:05.207Z" }, + { url = "https://files.pythonhosted.org/packages/a6/82/62d68066e13e46a5116df187d319d1724b3f437ddd0f958756fc052677f4/psutil-7.1.3-cp313-cp313t-win_amd64.whl", hash = "sha256:18349c5c24b06ac5612c0428ec2a0331c26443d259e2a0144a9b24b4395b58fa", size = 249642, upload-time = "2025-11-02T12:26:07.447Z" }, + { url = "https://files.pythonhosted.org/packages/df/ad/c1cd5fe965c14a0392112f68362cfceb5230819dbb5b1888950d18a11d9f/psutil-7.1.3-cp313-cp313t-win_arm64.whl", hash = "sha256:c525ffa774fe4496282fb0b1187725793de3e7c6b29e41562733cae9ada151ee", size = 245518, upload-time = "2025-11-02T12:26:09.719Z" }, + { url = "https://files.pythonhosted.org/packages/2e/bb/6670bded3e3236eb4287c7bcdc167e9fae6e1e9286e437f7111caed2f909/psutil-7.1.3-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:b403da1df4d6d43973dc004d19cee3b848e998ae3154cc8097d139b77156c353", size = 239843, upload-time = "2025-11-02T12:26:11.968Z" }, + { url = "https://files.pythonhosted.org/packages/b8/66/853d50e75a38c9a7370ddbeefabdd3d3116b9c31ef94dc92c6729bc36bec/psutil-7.1.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:ad81425efc5e75da3f39b3e636293360ad8d0b49bed7df824c79764fb4ba9b8b", size = 240369, upload-time = "2025-11-02T12:26:14.358Z" }, + { url = "https://files.pythonhosted.org/packages/41/bd/313aba97cb5bfb26916dc29cf0646cbe4dd6a89ca69e8c6edce654876d39/psutil-7.1.3-cp314-cp314t-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8f33a3702e167783a9213db10ad29650ebf383946e91bc77f28a5eb083496bc9", size = 288210, upload-time = "2025-11-02T12:26:16.699Z" }, + { url = "https://files.pythonhosted.org/packages/c2/fa/76e3c06e760927a0cfb5705eb38164254de34e9bd86db656d4dbaa228b04/psutil-7.1.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fac9cd332c67f4422504297889da5ab7e05fd11e3c4392140f7370f4208ded1f", size = 291182, upload-time = "2025-11-02T12:26:18.848Z" }, + { url = "https://files.pythonhosted.org/packages/0f/1d/5774a91607035ee5078b8fd747686ebec28a962f178712de100d00b78a32/psutil-7.1.3-cp314-cp314t-win_amd64.whl", hash = "sha256:3792983e23b69843aea49c8f5b8f115572c5ab64c153bada5270086a2123c7e7", size = 250466, upload-time = "2025-11-02T12:26:21.183Z" }, + { url = "https://files.pythonhosted.org/packages/00/ca/e426584bacb43a5cb1ac91fae1937f478cd8fbe5e4ff96574e698a2c77cd/psutil-7.1.3-cp314-cp314t-win_arm64.whl", hash = "sha256:31d77fcedb7529f27bb3a0472bea9334349f9a04160e8e6e5020f22c59893264", size = 245756, upload-time = "2025-11-02T12:26:23.148Z" }, + { url = "https://files.pythonhosted.org/packages/ef/94/46b9154a800253e7ecff5aaacdf8ebf43db99de4a2dfa18575b02548654e/psutil-7.1.3-cp36-abi3-macosx_10_9_x86_64.whl", hash = "sha256:2bdbcd0e58ca14996a42adf3621a6244f1bb2e2e528886959c72cf1e326677ab", size = 238359, upload-time = "2025-11-02T12:26:25.284Z" }, + { url = "https://files.pythonhosted.org/packages/68/3a/9f93cff5c025029a36d9a92fef47220ab4692ee7f2be0fba9f92813d0cb8/psutil-7.1.3-cp36-abi3-macosx_11_0_arm64.whl", hash = "sha256:bc31fa00f1fbc3c3802141eede66f3a2d51d89716a194bf2cd6fc68310a19880", size = 239171, upload-time = "2025-11-02T12:26:27.23Z" }, + { url = "https://files.pythonhosted.org/packages/ce/b1/5f49af514f76431ba4eea935b8ad3725cdeb397e9245ab919dbc1d1dc20f/psutil-7.1.3-cp36-abi3-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3bb428f9f05c1225a558f53e30ccbad9930b11c3fc206836242de1091d3e7dd3", size = 263261, upload-time = "2025-11-02T12:26:29.48Z" }, + { url = "https://files.pythonhosted.org/packages/e0/95/992c8816a74016eb095e73585d747e0a8ea21a061ed3689474fabb29a395/psutil-7.1.3-cp36-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:56d974e02ca2c8eb4812c3f76c30e28836fffc311d55d979f1465c1feeb2b68b", size = 264635, upload-time = "2025-11-02T12:26:31.74Z" }, + { url = "https://files.pythonhosted.org/packages/55/4c/c3ed1a622b6ae2fd3c945a366e64eb35247a31e4db16cf5095e269e8eb3c/psutil-7.1.3-cp37-abi3-win_amd64.whl", hash = "sha256:f39c2c19fe824b47484b96f9692932248a54c43799a84282cfe58d05a6449efd", size = 247633, upload-time = "2025-11-02T12:26:33.887Z" }, + { url = "https://files.pythonhosted.org/packages/c9/ad/33b2ccec09bf96c2b2ef3f9a6f66baac8253d7565d8839e024a6b905d45d/psutil-7.1.3-cp37-abi3-win_arm64.whl", hash = "sha256:bd0d69cee829226a761e92f28140bec9a5ee9d5b4fb4b0cc589068dbfff559b1", size = 244608, upload-time = "2025-11-02T12:26:36.136Z" }, +] + +[[package]] +name = "pyasn1" +version = "0.6.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ba/e9/01f1a64245b89f039897cb0130016d79f77d52669aae6ee7b159a6c4c018/pyasn1-0.6.1.tar.gz", hash = "sha256:6f580d2bdd84365380830acf45550f2511469f673cb4a5ae3857a3170128b034", size = 145322, upload-time = "2024-09-10T22:41:42.55Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/c8/f1/d6a797abb14f6283c0ddff96bbdd46937f64122b8c925cab503dd37f8214/pyasn1-0.6.1-py3-none-any.whl", hash = "sha256:0d632f46f2ba09143da3a8afe9e33fb6f92fa2320ab7e886e2d0f7672af84629", size = 83135, upload-time = "2024-09-11T16:00:36.122Z" }, +] + +[[package]] +name = "pycparser" +version = "2.23" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/fe/cf/d2d3b9f5699fb1e4615c8e32ff220203e43b248e1dfcc6736ad9057731ca/pycparser-2.23.tar.gz", hash = "sha256:78816d4f24add8f10a06d6f05b4d424ad9e96cfebf68a4ddc99c65c0720d00c2", size = 173734, upload-time = "2025-09-09T13:23:47.91Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a0/e3/59cd50310fc9b59512193629e1984c1f95e5c8ae6e5d8c69532ccc65a7fe/pycparser-2.23-py3-none-any.whl", hash = "sha256:e5c6e8d3fbad53479cab09ac03729e0a9faf2bee3db8208a550daf5af81a5934", size = 118140, upload-time = "2025-09-09T13:23:46.651Z" }, +] + +[[package]] +name = "pydantic" +version = "2.12.5" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "annotated-types" }, + { name = "pydantic-core" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/5a/87/b70ad306ebb6f9b585f114d0ac2137d792b48be34d732d60e597c2f8465a/pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d", size = 463580, upload-time = "2025-11-26T15:11:44.605Z" }, +] + +[package.optional-dependencies] +email = [ + { name = "email-validator" }, +] + +[[package]] +name = "pydantic-core" +version = "2.41.5" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/5f/5d/5f6c63eebb5afee93bcaae4ce9a898f3373ca23df3ccaef086d0233a35a7/pydantic_core-2.41.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f41a7489d32336dbf2199c8c0a215390a751c5b014c2c1c5366e817202e9cdf7", size = 2110990, upload-time = "2025-11-04T13:39:58.079Z" }, + { url = "https://files.pythonhosted.org/packages/aa/32/9c2e8ccb57c01111e0fd091f236c7b371c1bccea0fa85247ac55b1e2b6b6/pydantic_core-2.41.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:070259a8818988b9a84a449a2a7337c7f430a22acc0859c6b110aa7212a6d9c0", size = 1896003, upload-time = "2025-11-04T13:39:59.956Z" }, + { url = "https://files.pythonhosted.org/packages/68/b8/a01b53cb0e59139fbc9e4fda3e9724ede8de279097179be4ff31f1abb65a/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e96cea19e34778f8d59fe40775a7a574d95816eb150850a85a7a4c8f4b94ac69", size = 1919200, upload-time = "2025-11-04T13:40:02.241Z" }, + { url = "https://files.pythonhosted.org/packages/38/de/8c36b5198a29bdaade07b5985e80a233a5ac27137846f3bc2d3b40a47360/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed2e99c456e3fadd05c991f8f437ef902e00eedf34320ba2b0842bd1c3ca3a75", size = 2052578, upload-time = "2025-11-04T13:40:04.401Z" }, + { url = "https://files.pythonhosted.org/packages/00/b5/0e8e4b5b081eac6cb3dbb7e60a65907549a1ce035a724368c330112adfdd/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:65840751b72fbfd82c3c640cff9284545342a4f1eb1586ad0636955b261b0b05", size = 2208504, upload-time = "2025-11-04T13:40:06.072Z" }, + { url = "https://files.pythonhosted.org/packages/77/56/87a61aad59c7c5b9dc8caad5a41a5545cba3810c3e828708b3d7404f6cef/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e536c98a7626a98feb2d3eaf75944ef6f3dbee447e1f841eae16f2f0a72d8ddc", size = 2335816, upload-time = "2025-11-04T13:40:07.835Z" }, + { url = "https://files.pythonhosted.org/packages/0d/76/941cc9f73529988688a665a5c0ecff1112b3d95ab48f81db5f7606f522d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eceb81a8d74f9267ef4081e246ffd6d129da5d87e37a77c9bde550cb04870c1c", size = 2075366, upload-time = "2025-11-04T13:40:09.804Z" }, + { url = "https://files.pythonhosted.org/packages/d3/43/ebef01f69baa07a482844faaa0a591bad1ef129253ffd0cdaa9d8a7f72d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d38548150c39b74aeeb0ce8ee1d8e82696f4a4e16ddc6de7b1d8823f7de4b9b5", size = 2171698, upload-time = "2025-11-04T13:40:12.004Z" }, + { url = "https://files.pythonhosted.org/packages/b1/87/41f3202e4193e3bacfc2c065fab7706ebe81af46a83d3e27605029c1f5a6/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c23e27686783f60290e36827f9c626e63154b82b116d7fe9adba1fda36da706c", size = 2132603, upload-time = "2025-11-04T13:40:13.868Z" }, + { url = "https://files.pythonhosted.org/packages/49/7d/4c00df99cb12070b6bccdef4a195255e6020a550d572768d92cc54dba91a/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:482c982f814460eabe1d3bb0adfdc583387bd4691ef00b90575ca0d2b6fe2294", size = 2329591, upload-time = "2025-11-04T13:40:15.672Z" }, + { url = "https://files.pythonhosted.org/packages/cc/6a/ebf4b1d65d458f3cda6a7335d141305dfa19bdc61140a884d165a8a1bbc7/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:bfea2a5f0b4d8d43adf9d7b8bf019fb46fdd10a2e5cde477fbcb9d1fa08c68e1", size = 2319068, upload-time = "2025-11-04T13:40:17.532Z" }, + { url = "https://files.pythonhosted.org/packages/49/3b/774f2b5cd4192d5ab75870ce4381fd89cf218af999515baf07e7206753f0/pydantic_core-2.41.5-cp312-cp312-win32.whl", hash = "sha256:b74557b16e390ec12dca509bce9264c3bbd128f8a2c376eaa68003d7f327276d", size = 1985908, upload-time = "2025-11-04T13:40:19.309Z" }, + { url = "https://files.pythonhosted.org/packages/86/45/00173a033c801cacf67c190fef088789394feaf88a98a7035b0e40d53dc9/pydantic_core-2.41.5-cp312-cp312-win_amd64.whl", hash = "sha256:1962293292865bca8e54702b08a4f26da73adc83dd1fcf26fbc875b35d81c815", size = 2020145, upload-time = "2025-11-04T13:40:21.548Z" }, + { url = "https://files.pythonhosted.org/packages/f9/22/91fbc821fa6d261b376a3f73809f907cec5ca6025642c463d3488aad22fb/pydantic_core-2.41.5-cp312-cp312-win_arm64.whl", hash = "sha256:1746d4a3d9a794cacae06a5eaaccb4b8643a131d45fbc9af23e353dc0a5ba5c3", size = 1976179, upload-time = "2025-11-04T13:40:23.393Z" }, + { url = "https://files.pythonhosted.org/packages/87/06/8806241ff1f70d9939f9af039c6c35f2360cf16e93c2ca76f184e76b1564/pydantic_core-2.41.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:941103c9be18ac8daf7b7adca8228f8ed6bb7a1849020f643b3a14d15b1924d9", size = 2120403, upload-time = "2025-11-04T13:40:25.248Z" }, + { url = "https://files.pythonhosted.org/packages/94/02/abfa0e0bda67faa65fef1c84971c7e45928e108fe24333c81f3bfe35d5f5/pydantic_core-2.41.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:112e305c3314f40c93998e567879e887a3160bb8689ef3d2c04b6cc62c33ac34", size = 1896206, upload-time = "2025-11-04T13:40:27.099Z" }, + { url = "https://files.pythonhosted.org/packages/15/df/a4c740c0943e93e6500f9eb23f4ca7ec9bf71b19e608ae5b579678c8d02f/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cbaad15cb0c90aa221d43c00e77bb33c93e8d36e0bf74760cd00e732d10a6a0", size = 1919307, upload-time = "2025-11-04T13:40:29.806Z" }, + { url = "https://files.pythonhosted.org/packages/9a/e3/6324802931ae1d123528988e0e86587c2072ac2e5394b4bc2bc34b61ff6e/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:03ca43e12fab6023fc79d28ca6b39b05f794ad08ec2feccc59a339b02f2b3d33", size = 2063258, upload-time = "2025-11-04T13:40:33.544Z" }, + { url = "https://files.pythonhosted.org/packages/c9/d4/2230d7151d4957dd79c3044ea26346c148c98fbf0ee6ebd41056f2d62ab5/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc799088c08fa04e43144b164feb0c13f9a0bc40503f8df3e9fde58a3c0c101e", size = 2214917, upload-time = "2025-11-04T13:40:35.479Z" }, + { url = "https://files.pythonhosted.org/packages/e6/9f/eaac5df17a3672fef0081b6c1bb0b82b33ee89aa5cec0d7b05f52fd4a1fa/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:97aeba56665b4c3235a0e52b2c2f5ae9cd071b8a8310ad27bddb3f7fb30e9aa2", size = 2332186, upload-time = "2025-11-04T13:40:37.436Z" }, + { url = "https://files.pythonhosted.org/packages/cf/4e/35a80cae583a37cf15604b44240e45c05e04e86f9cfd766623149297e971/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:406bf18d345822d6c21366031003612b9c77b3e29ffdb0f612367352aab7d586", size = 2073164, upload-time = "2025-11-04T13:40:40.289Z" }, + { url = "https://files.pythonhosted.org/packages/bf/e3/f6e262673c6140dd3305d144d032f7bd5f7497d3871c1428521f19f9efa2/pydantic_core-2.41.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b93590ae81f7010dbe380cdeab6f515902ebcbefe0b9327cc4804d74e93ae69d", size = 2179146, upload-time = "2025-11-04T13:40:42.809Z" }, + { url = "https://files.pythonhosted.org/packages/75/c7/20bd7fc05f0c6ea2056a4565c6f36f8968c0924f19b7d97bbfea55780e73/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:01a3d0ab748ee531f4ea6c3e48ad9dac84ddba4b0d82291f87248f2f9de8d740", size = 2137788, upload-time = "2025-11-04T13:40:44.752Z" }, + { url = "https://files.pythonhosted.org/packages/3a/8d/34318ef985c45196e004bc46c6eab2eda437e744c124ef0dbe1ff2c9d06b/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:6561e94ba9dacc9c61bce40e2d6bdc3bfaa0259d3ff36ace3b1e6901936d2e3e", size = 2340133, upload-time = "2025-11-04T13:40:46.66Z" }, + { url = "https://files.pythonhosted.org/packages/9c/59/013626bf8c78a5a5d9350d12e7697d3d4de951a75565496abd40ccd46bee/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:915c3d10f81bec3a74fbd4faebe8391013ba61e5a1a8d48c4455b923bdda7858", size = 2324852, upload-time = "2025-11-04T13:40:48.575Z" }, + { url = "https://files.pythonhosted.org/packages/1a/d9/c248c103856f807ef70c18a4f986693a46a8ffe1602e5d361485da502d20/pydantic_core-2.41.5-cp313-cp313-win32.whl", hash = "sha256:650ae77860b45cfa6e2cdafc42618ceafab3a2d9a3811fcfbd3bbf8ac3c40d36", size = 1994679, upload-time = "2025-11-04T13:40:50.619Z" }, + { url = "https://files.pythonhosted.org/packages/9e/8b/341991b158ddab181cff136acd2552c9f35bd30380422a639c0671e99a91/pydantic_core-2.41.5-cp313-cp313-win_amd64.whl", hash = "sha256:79ec52ec461e99e13791ec6508c722742ad745571f234ea6255bed38c6480f11", size = 2019766, upload-time = "2025-11-04T13:40:52.631Z" }, + { url = "https://files.pythonhosted.org/packages/73/7d/f2f9db34af103bea3e09735bb40b021788a5e834c81eedb541991badf8f5/pydantic_core-2.41.5-cp313-cp313-win_arm64.whl", hash = "sha256:3f84d5c1b4ab906093bdc1ff10484838aca54ef08de4afa9de0f5f14d69639cd", size = 1981005, upload-time = "2025-11-04T13:40:54.734Z" }, + { url = "https://files.pythonhosted.org/packages/ea/28/46b7c5c9635ae96ea0fbb779e271a38129df2550f763937659ee6c5dbc65/pydantic_core-2.41.5-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:3f37a19d7ebcdd20b96485056ba9e8b304e27d9904d233d7b1015db320e51f0a", size = 2119622, upload-time = "2025-11-04T13:40:56.68Z" }, + { url = "https://files.pythonhosted.org/packages/74/1a/145646e5687e8d9a1e8d09acb278c8535ebe9e972e1f162ed338a622f193/pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14", size = 1891725, upload-time = "2025-11-04T13:40:58.807Z" }, + { url = "https://files.pythonhosted.org/packages/23/04/e89c29e267b8060b40dca97bfc64a19b2a3cf99018167ea1677d96368273/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25e1c2af0fce638d5f1988b686f3b3ea8cd7de5f244ca147c777769e798a9cd1", size = 1915040, upload-time = "2025-11-04T13:41:00.853Z" }, + { url = "https://files.pythonhosted.org/packages/84/a3/15a82ac7bd97992a82257f777b3583d3e84bdb06ba6858f745daa2ec8a85/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:506d766a8727beef16b7adaeb8ee6217c64fc813646b424d0804d67c16eddb66", size = 2063691, upload-time = "2025-11-04T13:41:03.504Z" }, + { url = "https://files.pythonhosted.org/packages/74/9b/0046701313c6ef08c0c1cf0e028c67c770a4e1275ca73131563c5f2a310a/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4819fa52133c9aa3c387b3328f25c1facc356491e6135b459f1de698ff64d869", size = 2213897, upload-time = "2025-11-04T13:41:05.804Z" }, + { url = "https://files.pythonhosted.org/packages/8a/cd/6bac76ecd1b27e75a95ca3a9a559c643b3afcd2dd62086d4b7a32a18b169/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2b761d210c9ea91feda40d25b4efe82a1707da2ef62901466a42492c028553a2", size = 2333302, upload-time = "2025-11-04T13:41:07.809Z" }, + { url = "https://files.pythonhosted.org/packages/4c/d2/ef2074dc020dd6e109611a8be4449b98cd25e1b9b8a303c2f0fca2f2bcf7/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:22f0fb8c1c583a3b6f24df2470833b40207e907b90c928cc8d3594b76f874375", size = 2064877, upload-time = "2025-11-04T13:41:09.827Z" }, + { url = "https://files.pythonhosted.org/packages/18/66/e9db17a9a763d72f03de903883c057b2592c09509ccfe468187f2a2eef29/pydantic_core-2.41.5-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c870e99878c634505236d81e5443092fba820f0373997ff75f90f68cd553", size = 2180680, upload-time = "2025-11-04T13:41:12.379Z" }, + { url = "https://files.pythonhosted.org/packages/d3/9e/3ce66cebb929f3ced22be85d4c2399b8e85b622db77dad36b73c5387f8f8/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0177272f88ab8312479336e1d777f6b124537d47f2123f89cb37e0accea97f90", size = 2138960, upload-time = "2025-11-04T13:41:14.627Z" }, + { url = "https://files.pythonhosted.org/packages/a6/62/205a998f4327d2079326b01abee48e502ea739d174f0a89295c481a2272e/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:63510af5e38f8955b8ee5687740d6ebf7c2a0886d15a6d65c32814613681bc07", size = 2339102, upload-time = "2025-11-04T13:41:16.868Z" }, + { url = "https://files.pythonhosted.org/packages/3c/0d/f05e79471e889d74d3d88f5bd20d0ed189ad94c2423d81ff8d0000aab4ff/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:e56ba91f47764cc14f1daacd723e3e82d1a89d783f0f5afe9c364b8bb491ccdb", size = 2326039, upload-time = "2025-11-04T13:41:18.934Z" }, + { url = "https://files.pythonhosted.org/packages/ec/e1/e08a6208bb100da7e0c4b288eed624a703f4d129bde2da475721a80cab32/pydantic_core-2.41.5-cp314-cp314-win32.whl", hash = "sha256:aec5cf2fd867b4ff45b9959f8b20ea3993fc93e63c7363fe6851424c8a7e7c23", size = 1995126, upload-time = "2025-11-04T13:41:21.418Z" }, + { url = "https://files.pythonhosted.org/packages/48/5d/56ba7b24e9557f99c9237e29f5c09913c81eeb2f3217e40e922353668092/pydantic_core-2.41.5-cp314-cp314-win_amd64.whl", hash = "sha256:8e7c86f27c585ef37c35e56a96363ab8de4e549a95512445b85c96d3e2f7c1bf", size = 2015489, upload-time = "2025-11-04T13:41:24.076Z" }, + { url = "https://files.pythonhosted.org/packages/4e/bb/f7a190991ec9e3e0ba22e4993d8755bbc4a32925c0b5b42775c03e8148f9/pydantic_core-2.41.5-cp314-cp314-win_arm64.whl", hash = "sha256:e672ba74fbc2dc8eea59fb6d4aed6845e6905fc2a8afe93175d94a83ba2a01a0", size = 1977288, upload-time = "2025-11-04T13:41:26.33Z" }, + { url = "https://files.pythonhosted.org/packages/92/ed/77542d0c51538e32e15afe7899d79efce4b81eee631d99850edc2f5e9349/pydantic_core-2.41.5-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:8566def80554c3faa0e65ac30ab0932b9e3a5cd7f8323764303d468e5c37595a", size = 2120255, upload-time = "2025-11-04T13:41:28.569Z" }, + { url = "https://files.pythonhosted.org/packages/bb/3d/6913dde84d5be21e284439676168b28d8bbba5600d838b9dca99de0fad71/pydantic_core-2.41.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:b80aa5095cd3109962a298ce14110ae16b8c1aece8b72f9dafe81cf597ad80b3", size = 1863760, upload-time = "2025-11-04T13:41:31.055Z" }, + { url = "https://files.pythonhosted.org/packages/5a/f0/e5e6b99d4191da102f2b0eb9687aaa7f5bea5d9964071a84effc3e40f997/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3006c3dd9ba34b0c094c544c6006cc79e87d8612999f1a5d43b769b89181f23c", size = 1878092, upload-time = "2025-11-04T13:41:33.21Z" }, + { url = "https://files.pythonhosted.org/packages/71/48/36fb760642d568925953bcc8116455513d6e34c4beaa37544118c36aba6d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:72f6c8b11857a856bcfa48c86f5368439f74453563f951e473514579d44aa612", size = 2053385, upload-time = "2025-11-04T13:41:35.508Z" }, + { url = "https://files.pythonhosted.org/packages/20/25/92dc684dd8eb75a234bc1c764b4210cf2646479d54b47bf46061657292a8/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cb1b2f9742240e4bb26b652a5aeb840aa4b417c7748b6f8387927bc6e45e40d", size = 2218832, upload-time = "2025-11-04T13:41:37.732Z" }, + { url = "https://files.pythonhosted.org/packages/e2/09/f53e0b05023d3e30357d82eb35835d0f6340ca344720a4599cd663dca599/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bd3d54f38609ff308209bd43acea66061494157703364ae40c951f83ba99a1a9", size = 2327585, upload-time = "2025-11-04T13:41:40Z" }, + { url = "https://files.pythonhosted.org/packages/aa/4e/2ae1aa85d6af35a39b236b1b1641de73f5a6ac4d5a7509f77b814885760c/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ff4321e56e879ee8d2a879501c8e469414d948f4aba74a2d4593184eb326660", size = 2041078, upload-time = "2025-11-04T13:41:42.323Z" }, + { url = "https://files.pythonhosted.org/packages/cd/13/2e215f17f0ef326fc72afe94776edb77525142c693767fc347ed6288728d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d0d2568a8c11bf8225044aa94409e21da0cb09dcdafe9ecd10250b2baad531a9", size = 2173914, upload-time = "2025-11-04T13:41:45.221Z" }, + { url = "https://files.pythonhosted.org/packages/02/7a/f999a6dcbcd0e5660bc348a3991c8915ce6599f4f2c6ac22f01d7a10816c/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:a39455728aabd58ceabb03c90e12f71fd30fa69615760a075b9fec596456ccc3", size = 2129560, upload-time = "2025-11-04T13:41:47.474Z" }, + { url = "https://files.pythonhosted.org/packages/3a/b1/6c990ac65e3b4c079a4fb9f5b05f5b013afa0f4ed6780a3dd236d2cbdc64/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:239edca560d05757817c13dc17c50766136d21f7cd0fac50295499ae24f90fdf", size = 2329244, upload-time = "2025-11-04T13:41:49.992Z" }, + { url = "https://files.pythonhosted.org/packages/d9/02/3c562f3a51afd4d88fff8dffb1771b30cfdfd79befd9883ee094f5b6c0d8/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:2a5e06546e19f24c6a96a129142a75cee553cc018ffee48a460059b1185f4470", size = 2331955, upload-time = "2025-11-04T13:41:54.079Z" }, + { url = "https://files.pythonhosted.org/packages/5c/96/5fb7d8c3c17bc8c62fdb031c47d77a1af698f1d7a406b0f79aaa1338f9ad/pydantic_core-2.41.5-cp314-cp314t-win32.whl", hash = "sha256:b4ececa40ac28afa90871c2cc2b9ffd2ff0bf749380fbdf57d165fd23da353aa", size = 1988906, upload-time = "2025-11-04T13:41:56.606Z" }, + { url = "https://files.pythonhosted.org/packages/22/ed/182129d83032702912c2e2d8bbe33c036f342cc735737064668585dac28f/pydantic_core-2.41.5-cp314-cp314t-win_amd64.whl", hash = "sha256:80aa89cad80b32a912a65332f64a4450ed00966111b6615ca6816153d3585a8c", size = 1981607, upload-time = "2025-11-04T13:41:58.889Z" }, + { url = "https://files.pythonhosted.org/packages/9f/ed/068e41660b832bb0b1aa5b58011dea2a3fe0ba7861ff38c4d4904c1c1a99/pydantic_core-2.41.5-cp314-cp314t-win_arm64.whl", hash = "sha256:35b44f37a3199f771c3eaa53051bc8a70cd7b54f333531c59e29fd4db5d15008", size = 1974769, upload-time = "2025-11-04T13:42:01.186Z" }, + { url = "https://files.pythonhosted.org/packages/09/32/59b0c7e63e277fa7911c2fc70ccfb45ce4b98991e7ef37110663437005af/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:7da7087d756b19037bc2c06edc6c170eeef3c3bafcb8f532ff17d64dc427adfd", size = 2110495, upload-time = "2025-11-04T13:42:49.689Z" }, + { url = "https://files.pythonhosted.org/packages/aa/81/05e400037eaf55ad400bcd318c05bb345b57e708887f07ddb2d20e3f0e98/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:aabf5777b5c8ca26f7824cb4a120a740c9588ed58df9b2d196ce92fba42ff8dc", size = 1915388, upload-time = "2025-11-04T13:42:52.215Z" }, + { url = "https://files.pythonhosted.org/packages/6e/0d/e3549b2399f71d56476b77dbf3cf8937cec5cd70536bdc0e374a421d0599/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c007fe8a43d43b3969e8469004e9845944f1a80e6acd47c150856bb87f230c56", size = 1942879, upload-time = "2025-11-04T13:42:56.483Z" }, + { url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" }, +] + +[[package]] +name = "pygments" +version = "2.19.2" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" }, +] + +[[package]] +name = "pyjwt" +version = "2.10.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/e7/46/bd74733ff231675599650d3e47f361794b22ef3e3770998dda30d3b63726/pyjwt-2.10.1.tar.gz", hash = "sha256:3cc5772eb20009233caf06e9d8a0577824723b44e6648ee0a2aedb6cf9381953", size = 87785, upload-time = "2024-11-28T03:43:29.933Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/61/ad/689f02752eeec26aed679477e80e632ef1b682313be70793d798c1d5fc8f/PyJWT-2.10.1-py3-none-any.whl", hash = "sha256:dcdd193e30abefd5debf142f9adfcdd2b58004e644f25406ffaebd50bd98dacb", size = 22997, upload-time = "2024-11-28T03:43:27.893Z" }, +] + +[[package]] +name = "pyopenssl" +version = "25.3.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "cryptography" }, + { name = "typing-extensions", marker = "python_full_version < '3.13'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/80/be/97b83a464498a79103036bc74d1038df4a7ef0e402cfaf4d5e113fb14759/pyopenssl-25.3.0.tar.gz", hash = "sha256:c981cb0a3fd84e8602d7afc209522773b94c1c2446a3c710a75b06fe1beae329", size = 184073, upload-time = "2025-09-17T00:32:21.037Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/d1/81/ef2b1dfd1862567d573a4fdbc9f969067621764fbb74338496840a1d2977/pyopenssl-25.3.0-py3-none-any.whl", hash = "sha256:1fda6fc034d5e3d179d39e59c1895c9faeaf40a79de5fc4cbbfbe0d36f4a77b6", size = 57268, upload-time = "2025-09-17T00:32:19.474Z" }, +] + +[[package]] +name = "pypi-attestations" +version = "0.0.28" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "cryptography" }, + { name = "packaging" }, + { name = "pyasn1" }, + { name = "pydantic" }, + { name = "requests" }, + { name = "rfc3986" }, + { name = "sigstore" }, + { name = "sigstore-models" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/1e/c0/95f6d792189b89a77eedc2da300578e3415a5950cdedeafe7ae3d02fd6a6/pypi_attestations-0.0.28.tar.gz", hash = "sha256:e5e75beaddbb674c390ed1a43cb32b7274990da6be7190c812a530b18db6137f", size = 124805, upload-time = "2025-10-16T16:58:07.637Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/f7/0a/9b400d188f2b4983accabca5a9c9ce534d68dbe1b79c45ce87cf36f787c6/pypi_attestations-0.0.28-py3-none-any.whl", hash = "sha256:a7eebfb55f3b9848bb99e15a6c7ff462e0e7d9a1395690426e4d069fa0dd0158", size = 21910, upload-time = "2025-10-16T16:58:06.106Z" }, +] + +[[package]] +name = "pyproject-hooks" +version = "1.2.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/e7/82/28175b2414effca1cdac8dc99f76d660e7a4fb0ceefa4b4ab8f5f6742925/pyproject_hooks-1.2.0.tar.gz", hash = "sha256:1e859bd5c40fae9448642dd871adf459e5e2084186e8d2c2a79a824c970da1f8", size = 19228, upload-time = "2024-09-29T09:24:13.293Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/bd/24/12818598c362d7f300f18e74db45963dbcb85150324092410c8b49405e42/pyproject_hooks-1.2.0-py3-none-any.whl", hash = "sha256:9e5c6bfa8dcc30091c74b0cf803c81fdd29d94f01992a7707bc97babb1141913", size = 10216, upload-time = "2024-09-29T09:24:11.978Z" }, +] + +[[package]] +name = "pyrefly" +version = "0.44.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/49/b0/aae71033fd447b870972f87f915955402d6fd3bc64eba7fce73820a40e80/pyrefly-0.44.0.tar.gz", hash = "sha256:9564029e79ee5f6351009af2a4e8595f7a410d3181906bcae2e9d3ebc1069afd", size = 3932149, upload-time = "2025-12-02T21:41:28.573Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/78/b4/aa06d1f44dddbf7fa1f0dc7979924f8e1a62044d457f94c37aaa2c34d001/pyrefly-0.44.0-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:53a9d48329ce92880c6b8114ada9da315005cf051eacf1ff835cb7c05b48e08d", size = 9951095, upload-time = "2025-12-02T21:41:10.064Z" }, + { url = "https://files.pythonhosted.org/packages/bf/32/748706064cc0d49b2844ae798c6b79fc8c087e82d9fea8ccadb8b27e7ee5/pyrefly-0.44.0-py3-none-macosx_11_0_arm64.whl", hash = "sha256:6ac111f5543852f5c8a3acfbea956e1d877e1aa00824a74076488108ab0759f1", size = 9544843, upload-time = "2025-12-02T21:41:12.53Z" }, + { url = "https://files.pythonhosted.org/packages/80/cd/e8fc7e44b1b5290088dfbdd3cf8e54358f2300b204170497da6793aa32d3/pyrefly-0.44.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c2a980a1b88c19d442e0b6bec6c6959b9850aae2f4426a431525c5ca60e3faf1", size = 9789932, upload-time = "2025-12-02T21:41:15.137Z" }, + { url = "https://files.pythonhosted.org/packages/b5/e5/648ae1beb9ce8faeee79fe1bfb8a079bb36f7448bdb1c735214b0404ca4a/pyrefly-0.44.0-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e8502df6af249d27ad60ea11406bcb87228034711e726696ec5fd4e2e71ee78e", size = 10629460, upload-time = "2025-12-02T21:41:17.526Z" }, + { url = "https://files.pythonhosted.org/packages/97/59/30e52425086e50a5a4779bcf0b69da855a78d3add50d00da8bc59c5a47c1/pyrefly-0.44.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:96af22e5500ab3b8ad1176f0f19b25fe8452884fcb5b49ada76e9883f16e5ba5", size = 10263381, upload-time = "2025-12-02T21:41:19.543Z" }, + { url = "https://files.pythonhosted.org/packages/f3/0d/2dd649f999c4051ac618ceeecf5fa67d539dcca674636cf9217ef5203d79/pyrefly-0.44.0-py3-none-win32.whl", hash = "sha256:cce0225f2a9bf344861d657f3fb84a220c7cf503500594fc0c29a7af37c46f58", size = 9689625, upload-time = "2025-12-02T21:41:21.486Z" }, + { url = "https://files.pythonhosted.org/packages/bc/a0/5e5b3ea4a4cb5189624a5b85b8fb689fcd3d6d539d0eeac3daa71170a552/pyrefly-0.44.0-py3-none-win_amd64.whl", hash = "sha256:a4d822b3216fba8338c7674b3ebcc17b722e3bd9be037605c2130d56284f042f", size = 10348786, upload-time = "2025-12-02T21:41:23.846Z" }, + { url = "https://files.pythonhosted.org/packages/85/dd/f5d94cd1eaf5eb12e8b8bbc259141e342ccb5271df273bfeb56400d76828/pyrefly-0.44.0-py3-none-win_arm64.whl", hash = "sha256:87b937e4d77385baaaa5f9ffa3f9e4e37921dffb28636bbc07ed0f6b19b103f4", size = 9925772, upload-time = "2025-12-02T21:41:26.246Z" }, +] + +[[package]] +name = "pyright" +version = "1.1.407" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "nodeenv" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/a6/1b/0aa08ee42948b61745ac5b5b5ccaec4669e8884b53d31c8ec20b2fcd6b6f/pyright-1.1.407.tar.gz", hash = "sha256:099674dba5c10489832d4a4b2d302636152a9a42d317986c38474c76fe562262", size = 4122872, upload-time = "2025-10-24T23:17:15.145Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/dc/93/b69052907d032b00c40cb656d21438ec00b3a471733de137a3f65a49a0a0/pyright-1.1.407-py3-none-any.whl", hash = "sha256:6dd419f54fcc13f03b52285796d65e639786373f433e243f8b94cf93a7444d21", size = 5997008, upload-time = "2025-10-24T23:17:13.159Z" }, +] + +[[package]] +name = "pytest" +version = "9.0.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "colorama", marker = "sys_platform == 'win32'" }, + { name = "iniconfig" }, + { name = "packaging" }, + { name = "pluggy" }, + { name = "pygments" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/07/56/f013048ac4bc4c1d9be45afd4ab209ea62822fb1598f40687e6bf45dcea4/pytest-9.0.1.tar.gz", hash = "sha256:3e9c069ea73583e255c3b21cf46b8d3c56f6e3a1a8f6da94ccb0fcf57b9d73c8", size = 1564125, upload-time = "2025-11-12T13:05:09.333Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0b/8b/6300fb80f858cda1c51ffa17075df5d846757081d11ab4aa35cef9e6258b/pytest-9.0.1-py3-none-any.whl", hash = "sha256:67be0030d194df2dfa7b556f2e56fb3c3315bd5c8822c6951162b92b32ce7dad", size = 373668, upload-time = "2025-11-12T13:05:07.379Z" }, +] + +[[package]] +name = "pytest-xdist" +version = "3.8.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "execnet" }, + { name = "pytest" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/78/b4/439b179d1ff526791eb921115fca8e44e596a13efeda518b9d845a619450/pytest_xdist-3.8.0.tar.gz", hash = "sha256:7e578125ec9bc6050861aa93f2d59f1d8d085595d6551c2c90b6f4fad8d3a9f1", size = 88069, upload-time = "2025-07-01T13:30:59.346Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ca/31/d4e37e9e550c2b92a9cbc2e4d0b7420a27224968580b5a447f420847c975/pytest_xdist-3.8.0-py3-none-any.whl", hash = "sha256:202ca578cfeb7370784a8c33d6d05bc6e13b4f25b5053c30a152269fd10f0b88", size = 46396, upload-time = "2025-07-01T13:30:56.632Z" }, +] + +[package.optional-dependencies] +psutil = [ + { name = "psutil" }, +] + +[[package]] +name = "pywin32-ctypes" +version = "0.2.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/85/9f/01a1a99704853cb63f253eea009390c88e7131c67e66a0a02099a8c917cb/pywin32-ctypes-0.2.3.tar.gz", hash = "sha256:d162dc04946d704503b2edc4d55f3dba5c1d539ead017afa00142c38b9885755", size = 29471, upload-time = "2024-08-14T10:15:34.626Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/de/3d/8161f7711c017e01ac9f008dfddd9410dff3674334c233bde66e7ba65bbf/pywin32_ctypes-0.2.3-py3-none-any.whl", hash = "sha256:8a1513379d709975552d202d942d9837758905c8d01eb82b8bcc30918929e7b8", size = 30756, upload-time = "2024-08-14T10:15:33.187Z" }, +] + +[[package]] +name = "readme-renderer" +version = "44.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "docutils" }, + { name = "nh3" }, + { name = "pygments" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/5a/a9/104ec9234c8448c4379768221ea6df01260cd6c2ce13182d4eac531c8342/readme_renderer-44.0.tar.gz", hash = "sha256:8712034eabbfa6805cacf1402b4eeb2a73028f72d1166d6f5cb7f9c047c5d1e1", size = 32056, upload-time = "2024-07-08T15:00:57.805Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/e1/67/921ec3024056483db83953ae8e48079ad62b92db7880013ca77632921dd0/readme_renderer-44.0-py3-none-any.whl", hash = "sha256:2fbca89b81a08526aadf1357a8c2ae889ec05fb03f5da67f9769c9a592166151", size = 13310, upload-time = "2024-07-08T15:00:56.577Z" }, +] + +[[package]] +name = "regex" +version = "2025.11.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/cc/a9/546676f25e573a4cf00fe8e119b78a37b6a8fe2dc95cda877b30889c9c45/regex-2025.11.3.tar.gz", hash = "sha256:1fedc720f9bb2494ce31a58a1631f9c82df6a09b49c19517ea5cc280b4541e01", size = 414669, upload-time = "2025-11-03T21:34:22.089Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/e8/74/18f04cb53e58e3fb107439699bd8375cf5a835eec81084e0bddbd122e4c2/regex-2025.11.3-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:bc8ab71e2e31b16e40868a40a69007bc305e1109bd4658eb6cad007e0bf67c41", size = 489312, upload-time = "2025-11-03T21:31:34.343Z" }, + { url = "https://files.pythonhosted.org/packages/78/3f/37fcdd0d2b1e78909108a876580485ea37c91e1acf66d3bb8e736348f441/regex-2025.11.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:22b29dda7e1f7062a52359fca6e58e548e28c6686f205e780b02ad8ef710de36", size = 291256, upload-time = "2025-11-03T21:31:35.675Z" }, + { url = "https://files.pythonhosted.org/packages/bf/26/0a575f58eb23b7ebd67a45fccbc02ac030b737b896b7e7a909ffe43ffd6a/regex-2025.11.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:3a91e4a29938bc1a082cc28fdea44be420bf2bebe2665343029723892eb073e1", size = 288921, upload-time = "2025-11-03T21:31:37.07Z" }, + { url = "https://files.pythonhosted.org/packages/ea/98/6a8dff667d1af907150432cf5abc05a17ccd32c72a3615410d5365ac167a/regex-2025.11.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:08b884f4226602ad40c5d55f52bf91a9df30f513864e0054bad40c0e9cf1afb7", size = 798568, upload-time = "2025-11-03T21:31:38.784Z" }, + { url = "https://files.pythonhosted.org/packages/64/15/92c1db4fa4e12733dd5a526c2dd2b6edcbfe13257e135fc0f6c57f34c173/regex-2025.11.3-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:3e0b11b2b2433d1c39c7c7a30e3f3d0aeeea44c2a8d0bae28f6b95f639927a69", size = 864165, upload-time = "2025-11-03T21:31:40.559Z" }, + { url = "https://files.pythonhosted.org/packages/f9/e7/3ad7da8cdee1ce66c7cd37ab5ab05c463a86ffeb52b1a25fe7bd9293b36c/regex-2025.11.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:87eb52a81ef58c7ba4d45c3ca74e12aa4b4e77816f72ca25258a85b3ea96cb48", size = 912182, upload-time = "2025-11-03T21:31:42.002Z" }, + { url = "https://files.pythonhosted.org/packages/84/bd/9ce9f629fcb714ffc2c3faf62b6766ecb7a585e1e885eb699bcf130a5209/regex-2025.11.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a12ab1f5c29b4e93db518f5e3872116b7e9b1646c9f9f426f777b50d44a09e8c", size = 803501, upload-time = "2025-11-03T21:31:43.815Z" }, + { url = "https://files.pythonhosted.org/packages/7c/0f/8dc2e4349d8e877283e6edd6c12bdcebc20f03744e86f197ab6e4492bf08/regex-2025.11.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:7521684c8c7c4f6e88e35ec89680ee1aa8358d3f09d27dfbdf62c446f5d4c695", size = 787842, upload-time = "2025-11-03T21:31:45.353Z" }, + { url = "https://files.pythonhosted.org/packages/f9/73/cff02702960bc185164d5619c0c62a2f598a6abff6695d391b096237d4ab/regex-2025.11.3-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:7fe6e5440584e94cc4b3f5f4d98a25e29ca12dccf8873679a635638349831b98", size = 858519, upload-time = "2025-11-03T21:31:46.814Z" }, + { url = "https://files.pythonhosted.org/packages/61/83/0e8d1ae71e15bc1dc36231c90b46ee35f9d52fab2e226b0e039e7ea9c10a/regex-2025.11.3-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:8e026094aa12b43f4fd74576714e987803a315c76edb6b098b9809db5de58f74", size = 850611, upload-time = "2025-11-03T21:31:48.289Z" }, + { url = "https://files.pythonhosted.org/packages/c8/f5/70a5cdd781dcfaa12556f2955bf170cd603cb1c96a1827479f8faea2df97/regex-2025.11.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:435bbad13e57eb5606a68443af62bed3556de2f46deb9f7d4237bc2f1c9fb3a0", size = 789759, upload-time = "2025-11-03T21:31:49.759Z" }, + { url = "https://files.pythonhosted.org/packages/59/9b/7c29be7903c318488983e7d97abcf8ebd3830e4c956c4c540005fcfb0462/regex-2025.11.3-cp312-cp312-win32.whl", hash = "sha256:3839967cf4dc4b985e1570fd8d91078f0c519f30491c60f9ac42a8db039be204", size = 266194, upload-time = "2025-11-03T21:31:51.53Z" }, + { url = "https://files.pythonhosted.org/packages/1a/67/3b92df89f179d7c367be654ab5626ae311cb28f7d5c237b6bb976cd5fbbb/regex-2025.11.3-cp312-cp312-win_amd64.whl", hash = "sha256:e721d1b46e25c481dc5ded6f4b3f66c897c58d2e8cfdf77bbced84339108b0b9", size = 277069, upload-time = "2025-11-03T21:31:53.151Z" }, + { url = "https://files.pythonhosted.org/packages/d7/55/85ba4c066fe5094d35b249c3ce8df0ba623cfd35afb22d6764f23a52a1c5/regex-2025.11.3-cp312-cp312-win_arm64.whl", hash = "sha256:64350685ff08b1d3a6fff33f45a9ca183dc1d58bbfe4981604e70ec9801bbc26", size = 270330, upload-time = "2025-11-03T21:31:54.514Z" }, + { url = "https://files.pythonhosted.org/packages/e1/a7/dda24ebd49da46a197436ad96378f17df30ceb40e52e859fc42cac45b850/regex-2025.11.3-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:c1e448051717a334891f2b9a620fe36776ebf3dd8ec46a0b877c8ae69575feb4", size = 489081, upload-time = "2025-11-03T21:31:55.9Z" }, + { url = "https://files.pythonhosted.org/packages/19/22/af2dc751aacf88089836aa088a1a11c4f21a04707eb1b0478e8e8fb32847/regex-2025.11.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:9b5aca4d5dfd7fbfbfbdaf44850fcc7709a01146a797536a8f84952e940cca76", size = 291123, upload-time = "2025-11-03T21:31:57.758Z" }, + { url = "https://files.pythonhosted.org/packages/a3/88/1a3ea5672f4b0a84802ee9891b86743438e7c04eb0b8f8c4e16a42375327/regex-2025.11.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:04d2765516395cf7dda331a244a3282c0f5ae96075f728629287dfa6f76ba70a", size = 288814, upload-time = "2025-11-03T21:32:01.12Z" }, + { url = "https://files.pythonhosted.org/packages/fb/8c/f5987895bf42b8ddeea1b315c9fedcfe07cadee28b9c98cf50d00adcb14d/regex-2025.11.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5d9903ca42bfeec4cebedba8022a7c97ad2aab22e09573ce9976ba01b65e4361", size = 798592, upload-time = "2025-11-03T21:32:03.006Z" }, + { url = "https://files.pythonhosted.org/packages/99/2a/6591ebeede78203fa77ee46a1c36649e02df9eaa77a033d1ccdf2fcd5d4e/regex-2025.11.3-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:639431bdc89d6429f6721625e8129413980ccd62e9d3f496be618a41d205f160", size = 864122, upload-time = "2025-11-03T21:32:04.553Z" }, + { url = "https://files.pythonhosted.org/packages/94/d6/be32a87cf28cf8ed064ff281cfbd49aefd90242a83e4b08b5a86b38e8eb4/regex-2025.11.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f117efad42068f9715677c8523ed2be1518116d1c49b1dd17987716695181efe", size = 912272, upload-time = "2025-11-03T21:32:06.148Z" }, + { url = "https://files.pythonhosted.org/packages/62/11/9bcef2d1445665b180ac7f230406ad80671f0fc2a6ffb93493b5dd8cd64c/regex-2025.11.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4aecb6f461316adf9f1f0f6a4a1a3d79e045f9b71ec76055a791affa3b285850", size = 803497, upload-time = "2025-11-03T21:32:08.162Z" }, + { url = "https://files.pythonhosted.org/packages/e5/a7/da0dc273d57f560399aa16d8a68ae7f9b57679476fc7ace46501d455fe84/regex-2025.11.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:3b3a5f320136873cc5561098dfab677eea139521cb9a9e8db98b7e64aef44cbc", size = 787892, upload-time = "2025-11-03T21:32:09.769Z" }, + { url = "https://files.pythonhosted.org/packages/da/4b/732a0c5a9736a0b8d6d720d4945a2f1e6f38f87f48f3173559f53e8d5d82/regex-2025.11.3-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:75fa6f0056e7efb1f42a1c34e58be24072cb9e61a601340cc1196ae92326a4f9", size = 858462, upload-time = "2025-11-03T21:32:11.769Z" }, + { url = "https://files.pythonhosted.org/packages/0c/f5/a2a03df27dc4c2d0c769220f5110ba8c4084b0bfa9ab0f9b4fcfa3d2b0fc/regex-2025.11.3-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:dbe6095001465294f13f1adcd3311e50dd84e5a71525f20a10bd16689c61ce0b", size = 850528, upload-time = "2025-11-03T21:32:13.906Z" }, + { url = "https://files.pythonhosted.org/packages/d6/09/e1cd5bee3841c7f6eb37d95ca91cdee7100b8f88b81e41c2ef426910891a/regex-2025.11.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:454d9b4ae7881afbc25015b8627c16d88a597479b9dea82b8c6e7e2e07240dc7", size = 789866, upload-time = "2025-11-03T21:32:15.748Z" }, + { url = "https://files.pythonhosted.org/packages/eb/51/702f5ea74e2a9c13d855a6a85b7f80c30f9e72a95493260193c07f3f8d74/regex-2025.11.3-cp313-cp313-win32.whl", hash = "sha256:28ba4d69171fc6e9896337d4fc63a43660002b7da53fc15ac992abcf3410917c", size = 266189, upload-time = "2025-11-03T21:32:17.493Z" }, + { url = "https://files.pythonhosted.org/packages/8b/00/6e29bb314e271a743170e53649db0fdb8e8ff0b64b4f425f5602f4eb9014/regex-2025.11.3-cp313-cp313-win_amd64.whl", hash = "sha256:bac4200befe50c670c405dc33af26dad5a3b6b255dd6c000d92fe4629f9ed6a5", size = 277054, upload-time = "2025-11-03T21:32:19.042Z" }, + { url = "https://files.pythonhosted.org/packages/25/f1/b156ff9f2ec9ac441710764dda95e4edaf5f36aca48246d1eea3f1fd96ec/regex-2025.11.3-cp313-cp313-win_arm64.whl", hash = "sha256:2292cd5a90dab247f9abe892ac584cb24f0f54680c73fcb4a7493c66c2bf2467", size = 270325, upload-time = "2025-11-03T21:32:21.338Z" }, + { url = "https://files.pythonhosted.org/packages/20/28/fd0c63357caefe5680b8ea052131acbd7f456893b69cc2a90cc3e0dc90d4/regex-2025.11.3-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:1eb1ebf6822b756c723e09f5186473d93236c06c579d2cc0671a722d2ab14281", size = 491984, upload-time = "2025-11-03T21:32:23.466Z" }, + { url = "https://files.pythonhosted.org/packages/df/ec/7014c15626ab46b902b3bcc4b28a7bae46d8f281fc7ea9c95e22fcaaa917/regex-2025.11.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:1e00ec2970aab10dc5db34af535f21fcf32b4a31d99e34963419636e2f85ae39", size = 292673, upload-time = "2025-11-03T21:32:25.034Z" }, + { url = "https://files.pythonhosted.org/packages/23/ab/3b952ff7239f20d05f1f99e9e20188513905f218c81d52fb5e78d2bf7634/regex-2025.11.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:a4cb042b615245d5ff9b3794f56be4138b5adc35a4166014d31d1814744148c7", size = 291029, upload-time = "2025-11-03T21:32:26.528Z" }, + { url = "https://files.pythonhosted.org/packages/21/7e/3dc2749fc684f455f162dcafb8a187b559e2614f3826877d3844a131f37b/regex-2025.11.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:44f264d4bf02f3176467d90b294d59bf1db9fe53c141ff772f27a8b456b2a9ed", size = 807437, upload-time = "2025-11-03T21:32:28.363Z" }, + { url = "https://files.pythonhosted.org/packages/1b/0b/d529a85ab349c6a25d1ca783235b6e3eedf187247eab536797021f7126c6/regex-2025.11.3-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:7be0277469bf3bd7a34a9c57c1b6a724532a0d235cd0dc4e7f4316f982c28b19", size = 873368, upload-time = "2025-11-03T21:32:30.4Z" }, + { url = "https://files.pythonhosted.org/packages/7d/18/2d868155f8c9e3e9d8f9e10c64e9a9f496bb8f7e037a88a8bed26b435af6/regex-2025.11.3-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:0d31e08426ff4b5b650f68839f5af51a92a5b51abd8554a60c2fbc7c71f25d0b", size = 914921, upload-time = "2025-11-03T21:32:32.123Z" }, + { url = "https://files.pythonhosted.org/packages/2d/71/9d72ff0f354fa783fe2ba913c8734c3b433b86406117a8db4ea2bf1c7a2f/regex-2025.11.3-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e43586ce5bd28f9f285a6e729466841368c4a0353f6fd08d4ce4630843d3648a", size = 812708, upload-time = "2025-11-03T21:32:34.305Z" }, + { url = "https://files.pythonhosted.org/packages/e7/19/ce4bf7f5575c97f82b6e804ffb5c4e940c62609ab2a0d9538d47a7fdf7d4/regex-2025.11.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:0f9397d561a4c16829d4e6ff75202c1c08b68a3bdbfe29dbfcdb31c9830907c6", size = 795472, upload-time = "2025-11-03T21:32:36.364Z" }, + { url = "https://files.pythonhosted.org/packages/03/86/fd1063a176ffb7b2315f9a1b08d17b18118b28d9df163132615b835a26ee/regex-2025.11.3-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:dd16e78eb18ffdb25ee33a0682d17912e8cc8a770e885aeee95020046128f1ce", size = 868341, upload-time = "2025-11-03T21:32:38.042Z" }, + { url = "https://files.pythonhosted.org/packages/12/43/103fb2e9811205e7386366501bc866a164a0430c79dd59eac886a2822950/regex-2025.11.3-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:ffcca5b9efe948ba0661e9df0fa50d2bc4b097c70b9810212d6b62f05d83b2dd", size = 854666, upload-time = "2025-11-03T21:32:40.079Z" }, + { url = "https://files.pythonhosted.org/packages/7d/22/e392e53f3869b75804762c7c848bd2dd2abf2b70fb0e526f58724638bd35/regex-2025.11.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:c56b4d162ca2b43318ac671c65bd4d563e841a694ac70e1a976ac38fcf4ca1d2", size = 799473, upload-time = "2025-11-03T21:32:42.148Z" }, + { url = "https://files.pythonhosted.org/packages/4f/f9/8bd6b656592f925b6845fcbb4d57603a3ac2fb2373344ffa1ed70aa6820a/regex-2025.11.3-cp313-cp313t-win32.whl", hash = "sha256:9ddc42e68114e161e51e272f667d640f97e84a2b9ef14b7477c53aac20c2d59a", size = 268792, upload-time = "2025-11-03T21:32:44.13Z" }, + { url = "https://files.pythonhosted.org/packages/e5/87/0e7d603467775ff65cd2aeabf1b5b50cc1c3708556a8b849a2fa4dd1542b/regex-2025.11.3-cp313-cp313t-win_amd64.whl", hash = "sha256:7a7c7fdf755032ffdd72c77e3d8096bdcb0eb92e89e17571a196f03d88b11b3c", size = 280214, upload-time = "2025-11-03T21:32:45.853Z" }, + { url = "https://files.pythonhosted.org/packages/8d/d0/2afc6f8e94e2b64bfb738a7c2b6387ac1699f09f032d363ed9447fd2bb57/regex-2025.11.3-cp313-cp313t-win_arm64.whl", hash = "sha256:df9eb838c44f570283712e7cff14c16329a9f0fb19ca492d21d4b7528ee6821e", size = 271469, upload-time = "2025-11-03T21:32:48.026Z" }, + { url = "https://files.pythonhosted.org/packages/31/e9/f6e13de7e0983837f7b6d238ad9458800a874bf37c264f7923e63409944c/regex-2025.11.3-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:9697a52e57576c83139d7c6f213d64485d3df5bf84807c35fa409e6c970801c6", size = 489089, upload-time = "2025-11-03T21:32:50.027Z" }, + { url = "https://files.pythonhosted.org/packages/a3/5c/261f4a262f1fa65141c1b74b255988bd2fa020cc599e53b080667d591cfc/regex-2025.11.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:e18bc3f73bd41243c9b38a6d9f2366cd0e0137a9aebe2d8ff76c5b67d4c0a3f4", size = 291059, upload-time = "2025-11-03T21:32:51.682Z" }, + { url = "https://files.pythonhosted.org/packages/8e/57/f14eeb7f072b0e9a5a090d1712741fd8f214ec193dba773cf5410108bb7d/regex-2025.11.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:61a08bcb0ec14ff4e0ed2044aad948d0659604f824cbd50b55e30b0ec6f09c73", size = 288900, upload-time = "2025-11-03T21:32:53.569Z" }, + { url = "https://files.pythonhosted.org/packages/3c/6b/1d650c45e99a9b327586739d926a1cd4e94666b1bd4af90428b36af66dc7/regex-2025.11.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c9c30003b9347c24bcc210958c5d167b9e4f9be786cb380a7d32f14f9b84674f", size = 799010, upload-time = "2025-11-03T21:32:55.222Z" }, + { url = "https://files.pythonhosted.org/packages/99/ee/d66dcbc6b628ce4e3f7f0cbbb84603aa2fc0ffc878babc857726b8aab2e9/regex-2025.11.3-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:4e1e592789704459900728d88d41a46fe3969b82ab62945560a31732ffc19a6d", size = 864893, upload-time = "2025-11-03T21:32:57.239Z" }, + { url = "https://files.pythonhosted.org/packages/bf/2d/f238229f1caba7ac87a6c4153d79947fb0261415827ae0f77c304260c7d3/regex-2025.11.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:6538241f45eb5a25aa575dbba1069ad786f68a4f2773a29a2bd3dd1f9de787be", size = 911522, upload-time = "2025-11-03T21:32:59.274Z" }, + { url = "https://files.pythonhosted.org/packages/bd/3d/22a4eaba214a917c80e04f6025d26143690f0419511e0116508e24b11c9b/regex-2025.11.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bce22519c989bb72a7e6b36a199384c53db7722fe669ba891da75907fe3587db", size = 803272, upload-time = "2025-11-03T21:33:01.393Z" }, + { url = "https://files.pythonhosted.org/packages/84/b1/03188f634a409353a84b5ef49754b97dbcc0c0f6fd6c8ede505a8960a0a4/regex-2025.11.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:66d559b21d3640203ab9075797a55165d79017520685fb407b9234d72ab63c62", size = 787958, upload-time = "2025-11-03T21:33:03.379Z" }, + { url = "https://files.pythonhosted.org/packages/99/6a/27d072f7fbf6fadd59c64d210305e1ff865cc3b78b526fd147db768c553b/regex-2025.11.3-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:669dcfb2e38f9e8c69507bace46f4889e3abbfd9b0c29719202883c0a603598f", size = 859289, upload-time = "2025-11-03T21:33:05.374Z" }, + { url = "https://files.pythonhosted.org/packages/9a/70/1b3878f648e0b6abe023172dacb02157e685564853cc363d9961bcccde4e/regex-2025.11.3-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:32f74f35ff0f25a5021373ac61442edcb150731fbaa28286bbc8bb1582c89d02", size = 850026, upload-time = "2025-11-03T21:33:07.131Z" }, + { url = "https://files.pythonhosted.org/packages/dd/d5/68e25559b526b8baab8e66839304ede68ff6727237a47727d240006bd0ff/regex-2025.11.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:e6c7a21dffba883234baefe91bc3388e629779582038f75d2a5be918e250f0ed", size = 789499, upload-time = "2025-11-03T21:33:09.141Z" }, + { url = "https://files.pythonhosted.org/packages/fc/df/43971264857140a350910d4e33df725e8c94dd9dee8d2e4729fa0d63d49e/regex-2025.11.3-cp314-cp314-win32.whl", hash = "sha256:795ea137b1d809eb6836b43748b12634291c0ed55ad50a7d72d21edf1cd565c4", size = 271604, upload-time = "2025-11-03T21:33:10.9Z" }, + { url = "https://files.pythonhosted.org/packages/01/6f/9711b57dc6894a55faf80a4c1b5aa4f8649805cb9c7aef46f7d27e2b9206/regex-2025.11.3-cp314-cp314-win_amd64.whl", hash = "sha256:9f95fbaa0ee1610ec0fc6b26668e9917a582ba80c52cc6d9ada15e30aa9ab9ad", size = 280320, upload-time = "2025-11-03T21:33:12.572Z" }, + { url = "https://files.pythonhosted.org/packages/f1/7e/f6eaa207d4377481f5e1775cdeb5a443b5a59b392d0065f3417d31d80f87/regex-2025.11.3-cp314-cp314-win_arm64.whl", hash = "sha256:dfec44d532be4c07088c3de2876130ff0fbeeacaa89a137decbbb5f665855a0f", size = 273372, upload-time = "2025-11-03T21:33:14.219Z" }, + { url = "https://files.pythonhosted.org/packages/c3/06/49b198550ee0f5e4184271cee87ba4dfd9692c91ec55289e6282f0f86ccf/regex-2025.11.3-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:ba0d8a5d7f04f73ee7d01d974d47c5834f8a1b0224390e4fe7c12a3a92a78ecc", size = 491985, upload-time = "2025-11-03T21:33:16.555Z" }, + { url = "https://files.pythonhosted.org/packages/ce/bf/abdafade008f0b1c9da10d934034cb670432d6cf6cbe38bbb53a1cfd6cf8/regex-2025.11.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:442d86cf1cfe4faabf97db7d901ef58347efd004934da045c745e7b5bd57ac49", size = 292669, upload-time = "2025-11-03T21:33:18.32Z" }, + { url = "https://files.pythonhosted.org/packages/f9/ef/0c357bb8edbd2ad8e273fcb9e1761bc37b8acbc6e1be050bebd6475f19c1/regex-2025.11.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:fd0a5e563c756de210bb964789b5abe4f114dacae9104a47e1a649b910361536", size = 291030, upload-time = "2025-11-03T21:33:20.048Z" }, + { url = "https://files.pythonhosted.org/packages/79/06/edbb67257596649b8fb088d6aeacbcb248ac195714b18a65e018bf4c0b50/regex-2025.11.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:bf3490bcbb985a1ae97b2ce9ad1c0f06a852d5b19dde9b07bdf25bf224248c95", size = 807674, upload-time = "2025-11-03T21:33:21.797Z" }, + { url = "https://files.pythonhosted.org/packages/f4/d9/ad4deccfce0ea336296bd087f1a191543bb99ee1c53093dcd4c64d951d00/regex-2025.11.3-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:3809988f0a8b8c9dcc0f92478d6501fac7200b9ec56aecf0ec21f4a2ec4b6009", size = 873451, upload-time = "2025-11-03T21:33:23.741Z" }, + { url = "https://files.pythonhosted.org/packages/13/75/a55a4724c56ef13e3e04acaab29df26582f6978c000ac9cd6810ad1f341f/regex-2025.11.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f4ff94e58e84aedb9c9fce66d4ef9f27a190285b451420f297c9a09f2b9abee9", size = 914980, upload-time = "2025-11-03T21:33:25.999Z" }, + { url = "https://files.pythonhosted.org/packages/67/1e/a1657ee15bd9116f70d4a530c736983eed997b361e20ecd8f5ca3759d5c5/regex-2025.11.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7eb542fd347ce61e1321b0a6b945d5701528dca0cd9759c2e3bb8bd57e47964d", size = 812852, upload-time = "2025-11-03T21:33:27.852Z" }, + { url = "https://files.pythonhosted.org/packages/b8/6f/f7516dde5506a588a561d296b2d0044839de06035bb486b326065b4c101e/regex-2025.11.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:d6c2d5919075a1f2e413c00b056ea0c2f065b3f5fe83c3d07d325ab92dce51d6", size = 795566, upload-time = "2025-11-03T21:33:32.364Z" }, + { url = "https://files.pythonhosted.org/packages/d9/dd/3d10b9e170cc16fb34cb2cef91513cf3df65f440b3366030631b2984a264/regex-2025.11.3-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:3f8bf11a4827cc7ce5a53d4ef6cddd5ad25595d3c1435ef08f76825851343154", size = 868463, upload-time = "2025-11-03T21:33:34.459Z" }, + { url = "https://files.pythonhosted.org/packages/f5/8e/935e6beff1695aa9085ff83195daccd72acc82c81793df480f34569330de/regex-2025.11.3-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:22c12d837298651e5550ac1d964e4ff57c3f56965fc1812c90c9fb2028eaf267", size = 854694, upload-time = "2025-11-03T21:33:36.793Z" }, + { url = "https://files.pythonhosted.org/packages/92/12/10650181a040978b2f5720a6a74d44f841371a3d984c2083fc1752e4acf6/regex-2025.11.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:62ba394a3dda9ad41c7c780f60f6e4a70988741415ae96f6d1bf6c239cf01379", size = 799691, upload-time = "2025-11-03T21:33:39.079Z" }, + { url = "https://files.pythonhosted.org/packages/67/90/8f37138181c9a7690e7e4cb388debbd389342db3c7381d636d2875940752/regex-2025.11.3-cp314-cp314t-win32.whl", hash = "sha256:4bf146dca15cdd53224a1bf46d628bd7590e4a07fbb69e720d561aea43a32b38", size = 274583, upload-time = "2025-11-03T21:33:41.302Z" }, + { url = "https://files.pythonhosted.org/packages/8f/cd/867f5ec442d56beb56f5f854f40abcfc75e11d10b11fdb1869dd39c63aaf/regex-2025.11.3-cp314-cp314t-win_amd64.whl", hash = "sha256:adad1a1bcf1c9e76346e091d22d23ac54ef28e1365117d99521631078dfec9de", size = 284286, upload-time = "2025-11-03T21:33:43.324Z" }, + { url = "https://files.pythonhosted.org/packages/20/31/32c0c4610cbc070362bf1d2e4ea86d1ea29014d400a6d6c2486fcfd57766/regex-2025.11.3-cp314-cp314t-win_arm64.whl", hash = "sha256:c54f768482cef41e219720013cd05933b6f971d9562544d691c68699bf2b6801", size = 274741, upload-time = "2025-11-03T21:33:45.557Z" }, +] + +[[package]] +name = "requests" +version = "2.32.5" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "certifi" }, + { name = "charset-normalizer" }, + { name = "idna" }, + { name = "urllib3" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c9/74/b3ff8e6c8446842c3f5c837e9c3dfcfe2018ea6ecef224c710c85ef728f4/requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf", size = 134517, upload-time = "2025-08-18T20:46:02.573Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" }, +] + +[[package]] +name = "requests-toolbelt" +version = "1.0.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "requests" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/f3/61/d7545dafb7ac2230c70d38d31cbfe4cc64f7144dc41f6e4e4b78ecd9f5bb/requests-toolbelt-1.0.0.tar.gz", hash = "sha256:7681a0a3d047012b5bdc0ee37d7f8f07ebe76ab08caeccfc3921ce23c88d5bc6", size = 206888, upload-time = "2023-05-01T04:11:33.229Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/3f/51/d4db610ef29373b879047326cbf6fa98b6c1969d6f6dc423279de2b1be2c/requests_toolbelt-1.0.0-py2.py3-none-any.whl", hash = "sha256:cccfdd665f0a24fcf4726e690f65639d272bb0637b9b92dfd91a5568ccf6bd06", size = 54481, upload-time = "2023-05-01T04:11:28.427Z" }, +] + +[[package]] +name = "rfc3161-client" +version = "1.0.5" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "cryptography" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/85/19/c04a07f9926943b6a6945ae6972dc2c3c79b7f02e2be6346e3010a48d5f5/rfc3161_client-1.0.5.tar.gz", hash = "sha256:f1a2e32e2a053455cee1ff9b325b88dbc7c66c8882dde60962add92f572df5c5", size = 60966, upload-time = "2025-09-23T10:47:15.906Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/f3/11/96bc76086113b8d24291f7f72826739d4fc8d8e83683e27125b8966d0cea/rfc3161_client-1.0.5-cp39-abi3-macosx_10_12_x86_64.whl", hash = "sha256:8a54fdb2f9e64481272b89137a7b71403cf1d30f5505c2e0c15a47a1cc100264", size = 473872, upload-time = "2025-09-23T10:46:56.987Z" }, + { url = "https://files.pythonhosted.org/packages/80/45/19224e046d76f214d056c40a2086d9147afb0bcadc0c823c2c8bd54d62aa/rfc3161_client-1.0.5-cp39-abi3-macosx_11_0_arm64.whl", hash = "sha256:d9ed8e597d0ee7387da1945e1583c4516b26f133770b3956e079606e2d90b69c", size = 458218, upload-time = "2025-09-23T10:46:58.485Z" }, + { url = "https://files.pythonhosted.org/packages/27/d7/0511f1423f1658b708cfa27043a21b06699ba7c2aef37ba465379b81c24d/rfc3161_client-1.0.5-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:61c04b4953453e5c26a1949c20adac415b65cd062dab0960574d6c36240222d2", size = 2396335, upload-time = "2025-09-23T10:47:00.111Z" }, + { url = "https://files.pythonhosted.org/packages/bc/d3/f93d1af5d9a1fed348ef543d39418aff02b0badf019b772f128c3483321c/rfc3161_client-1.0.5-cp39-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:31b6ee79f15b93d90952efd0395bb3f5ebf07941469c5c6eb32f9b64312cda6e", size = 1805162, upload-time = "2025-09-23T10:47:01.912Z" }, + { url = "https://files.pythonhosted.org/packages/69/51/0b30e3542fdf7adeb9f6afac1f095c543328a1a28c9d220f4e2207c6b845/rfc3161_client-1.0.5-cp39-abi3-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9c53a6711bab0c3f77dc9cf1e2fd750da475ff7abbc40ffe0333d8c518a8a9c8", size = 2115530, upload-time = "2025-09-23T10:47:03.816Z" }, + { url = "https://files.pythonhosted.org/packages/2e/b9/4da9f80da4ac30b9645c9a3455e71c4f6652ed886f20e11bfb9a01bcacd0/rfc3161_client-1.0.5-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:09c47582ecea2ca4a3debf8a1eda775cc3d5ae1379da40272cc065d32e639a7a", size = 2124925, upload-time = "2025-09-23T10:47:05.386Z" }, + { url = "https://files.pythonhosted.org/packages/46/ed/f173556ddbd667e9f4642f8f7eb0f920e3e3be4b7459ec98c73a5029200d/rfc3161_client-1.0.5-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:d31d30e354d2349ae8483ce811ef61498a3780daf8622c0b79d8cd44d271b46b", size = 2695972, upload-time = "2025-09-23T10:47:07.272Z" }, + { url = "https://files.pythonhosted.org/packages/84/97/2ca7bdbb2d84b75fad7f572264a45c0b54446a7a65735172275c09293bd6/rfc3161_client-1.0.5-cp39-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:ae440461a310ae097417afe536d9d22fd71c95fbc9d21db3561b2707bed0aff0", size = 2096478, upload-time = "2025-09-23T10:47:08.736Z" }, + { url = "https://files.pythonhosted.org/packages/da/94/9e16134e04a45347eaad5680f8f52b0388664b45be09a0877daa196e1157/rfc3161_client-1.0.5-cp39-abi3-musllinux_1_2_i686.whl", hash = "sha256:8fb34470e867a29cc15dc4987ea14f19d3bd25c863e132b6f75dca583e2cc67e", size = 2243602, upload-time = "2025-09-23T10:47:10.196Z" }, + { url = "https://files.pythonhosted.org/packages/c2/13/85b6a5b5247f79dfa75d80a2e8f8d415472ff7fd72b31d152e00f71198b9/rfc3161_client-1.0.5-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:3106f3361a5a36789f43d2700e5678c847a9d3460a23f455f4c20cd39314c557", size = 2296304, upload-time = "2025-09-23T10:47:11.594Z" }, + { url = "https://files.pythonhosted.org/packages/e7/0a/f7991ff6158a00ed79d6e151ede63ae50bef650cf49436cea7226a0457dc/rfc3161_client-1.0.5-cp39-abi3-win32.whl", hash = "sha256:078e4bbf0770ddc472e2ca96cf1e23efd0c313e6682b4c2c9765e1fdf09f55a3", size = 1917793, upload-time = "2025-09-23T10:47:12.92Z" }, + { url = "https://files.pythonhosted.org/packages/47/28/140516906a2117e15c37505d54968e9cc9a8275d042b195728f5ffc2ad02/rfc3161_client-1.0.5-cp39-abi3-win_amd64.whl", hash = "sha256:e904430e27e75a5a379fc4aac09bd60ba5f4b48054f0481b2fb417297e404047", size = 2313057, upload-time = "2025-09-23T10:47:14.243Z" }, +] + +[[package]] +name = "rfc3986" +version = "2.0.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/85/40/1520d68bfa07ab5a6f065a186815fb6610c86fe957bc065754e47f7b0840/rfc3986-2.0.0.tar.gz", hash = "sha256:97aacf9dbd4bfd829baad6e6309fa6573aaf1be3f6fa735c8ab05e46cecb261c", size = 49026, upload-time = "2022-01-10T00:52:30.832Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ff/9a/9afaade874b2fa6c752c36f1548f718b5b83af81ed9b76628329dab81c1b/rfc3986-2.0.0-py2.py3-none-any.whl", hash = "sha256:50b1502b60e289cb37883f3dfd34532b8873c7de9f49bb546641ce9cbd256ebd", size = 31326, upload-time = "2022-01-10T00:52:29.594Z" }, +] + +[[package]] +name = "rfc8785" +version = "0.1.4" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ef/2f/fa1d2e740c490191b572d33dbca5daa180cb423c24396b856f5886371d8b/rfc8785-0.1.4.tar.gz", hash = "sha256:e545841329fe0eee4f6a3b44e7034343100c12b4ec566dc06ca9735681deb4da", size = 14321, upload-time = "2024-09-27T16:33:31.206Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/4d/78/119878110660b2ad709888c8a1614fce7e2fab39080ab960656dc8605bf6/rfc8785-0.1.4-py3-none-any.whl", hash = "sha256:520d690b448ecf0703691c76e1a34a24ddcd4fc5bc41d589cb7c58ec651bcd48", size = 9240, upload-time = "2024-09-27T16:33:29.683Z" }, +] + +[[package]] +name = "rich" +version = "14.2.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "markdown-it-py" }, + { name = "pygments" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/fb/d2/8920e102050a0de7bfabeb4c4614a49248cf8d5d7a8d01885fbb24dc767a/rich-14.2.0.tar.gz", hash = "sha256:73ff50c7c0c1c77c8243079283f4edb376f0f6442433aecb8ce7e6d0b92d1fe4", size = 219990, upload-time = "2025-10-09T14:16:53.064Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/25/7a/b0178788f8dc6cafce37a212c99565fa1fe7872c70c6c9c1e1a372d9d88f/rich-14.2.0-py3-none-any.whl", hash = "sha256:76bc51fe2e57d2b1be1f96c524b890b816e334ab4c1e45888799bfaab0021edd", size = 243393, upload-time = "2025-10-09T14:16:51.245Z" }, +] + +[[package]] +name = "roman-numerals" +version = "3.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/57/5b/1bcda2c6a8acec5b310dd70f732400827b96f05d815834f0f112b91b3539/roman_numerals-3.1.0.tar.gz", hash = "sha256:384e36fc1e8d4bd361bdb3672841faae7a345b3f708aae9895d074c878332551", size = 9069, upload-time = "2025-03-12T00:41:08.837Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/82/1d/7356f115a0e5faf8dc59894a3e9fc8b1821ab949163458b0072db0a12a68/roman_numerals-3.1.0-py3-none-any.whl", hash = "sha256:842ae5fd12912d62720c9aad8cab706e8c692556d01a38443e051ee6cc158d90", size = 7709, upload-time = "2025-03-12T00:41:07.626Z" }, +] + +[[package]] +name = "ruff" +version = "0.14.7" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/b7/5b/dd7406afa6c95e3d8fa9d652b6d6dd17dd4a6bf63cb477014e8ccd3dcd46/ruff-0.14.7.tar.gz", hash = "sha256:3417deb75d23bd14a722b57b0a1435561db65f0ad97435b4cf9f85ffcef34ae5", size = 5727324, upload-time = "2025-11-28T20:55:10.525Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/8c/b1/7ea5647aaf90106f6d102230e5df874613da43d1089864da1553b899ba5e/ruff-0.14.7-py3-none-linux_armv6l.whl", hash = "sha256:b9d5cb5a176c7236892ad7224bc1e63902e4842c460a0b5210701b13e3de4fca", size = 13414475, upload-time = "2025-11-28T20:54:54.569Z" }, + { url = "https://files.pythonhosted.org/packages/af/19/fddb4cd532299db9cdaf0efdc20f5c573ce9952a11cb532d3b859d6d9871/ruff-0.14.7-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:3f64fe375aefaf36ca7d7250292141e39b4cea8250427482ae779a2aa5d90015", size = 13634613, upload-time = "2025-11-28T20:55:17.54Z" }, + { url = "https://files.pythonhosted.org/packages/40/2b/469a66e821d4f3de0440676ed3e04b8e2a1dc7575cf6fa3ba6d55e3c8557/ruff-0.14.7-py3-none-macosx_11_0_arm64.whl", hash = "sha256:93e83bd3a9e1a3bda64cb771c0d47cda0e0d148165013ae2d3554d718632d554", size = 12765458, upload-time = "2025-11-28T20:55:26.128Z" }, + { url = "https://files.pythonhosted.org/packages/f1/05/0b001f734fe550bcfde4ce845948ac620ff908ab7241a39a1b39bb3c5f49/ruff-0.14.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3838948e3facc59a6070795de2ae16e5786861850f78d5914a03f12659e88f94", size = 13236412, upload-time = "2025-11-28T20:55:28.602Z" }, + { url = "https://files.pythonhosted.org/packages/11/36/8ed15d243f011b4e5da75cd56d6131c6766f55334d14ba31cce5461f28aa/ruff-0.14.7-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:24c8487194d38b6d71cd0fd17a5b6715cda29f59baca1defe1e3a03240f851d1", size = 13182949, upload-time = "2025-11-28T20:55:33.265Z" }, + { url = "https://files.pythonhosted.org/packages/3b/cf/fcb0b5a195455729834f2a6eadfe2e4519d8ca08c74f6d2b564a4f18f553/ruff-0.14.7-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:79c73db6833f058a4be8ffe4a0913b6d4ad41f6324745179bd2aa09275b01d0b", size = 13816470, upload-time = "2025-11-28T20:55:08.203Z" }, + { url = "https://files.pythonhosted.org/packages/7f/5d/34a4748577ff7a5ed2f2471456740f02e86d1568a18c9faccfc73bd9ca3f/ruff-0.14.7-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:12eb7014fccff10fc62d15c79d8a6be4d0c2d60fe3f8e4d169a0d2def75f5dad", size = 15289621, upload-time = "2025-11-28T20:55:30.837Z" }, + { url = "https://files.pythonhosted.org/packages/53/53/0a9385f047a858ba133d96f3f8e3c9c66a31cc7c4b445368ef88ebeac209/ruff-0.14.7-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6c623bbdc902de7ff715a93fa3bb377a4e42dd696937bf95669118773dbf0c50", size = 14975817, upload-time = "2025-11-28T20:55:24.107Z" }, + { url = "https://files.pythonhosted.org/packages/a8/d7/2f1c32af54c3b46e7fadbf8006d8b9bcfbea535c316b0bd8813d6fb25e5d/ruff-0.14.7-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f53accc02ed2d200fa621593cdb3c1ae06aa9b2c3cae70bc96f72f0000ae97a9", size = 14284549, upload-time = "2025-11-28T20:55:06.08Z" }, + { url = "https://files.pythonhosted.org/packages/92/05/434ddd86becd64629c25fb6b4ce7637dd52a45cc4a4415a3008fe61c27b9/ruff-0.14.7-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:281f0e61a23fcdcffca210591f0f53aafaa15f9025b5b3f9706879aaa8683bc4", size = 14071389, upload-time = "2025-11-28T20:55:35.617Z" }, + { url = "https://files.pythonhosted.org/packages/ff/50/fdf89d4d80f7f9d4f420d26089a79b3bb1538fe44586b148451bc2ba8d9c/ruff-0.14.7-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:dbbaa5e14148965b91cb090236931182ee522a5fac9bc5575bafc5c07b9f9682", size = 14202679, upload-time = "2025-11-28T20:55:01.472Z" }, + { url = "https://files.pythonhosted.org/packages/77/54/87b34988984555425ce967f08a36df0ebd339bb5d9d0e92a47e41151eafc/ruff-0.14.7-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:1464b6e54880c0fe2f2d6eaefb6db15373331414eddf89d6b903767ae2458143", size = 13147677, upload-time = "2025-11-28T20:55:19.933Z" }, + { url = "https://files.pythonhosted.org/packages/67/29/f55e4d44edfe053918a16a3299e758e1c18eef216b7a7092550d7a9ec51c/ruff-0.14.7-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:f217ed871e4621ea6128460df57b19ce0580606c23aeab50f5de425d05226784", size = 13151392, upload-time = "2025-11-28T20:55:21.967Z" }, + { url = "https://files.pythonhosted.org/packages/36/69/47aae6dbd4f1d9b4f7085f4d9dcc84e04561ee7ad067bf52e0f9b02e3209/ruff-0.14.7-py3-none-musllinux_1_2_i686.whl", hash = "sha256:6be02e849440ed3602d2eb478ff7ff07d53e3758f7948a2a598829660988619e", size = 13412230, upload-time = "2025-11-28T20:55:12.749Z" }, + { url = "https://files.pythonhosted.org/packages/b7/4b/6e96cb6ba297f2ba502a231cd732ed7c3de98b1a896671b932a5eefa3804/ruff-0.14.7-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:19a0f116ee5e2b468dfe80c41c84e2bbd6b74f7b719bee86c2ecde0a34563bcc", size = 14195397, upload-time = "2025-11-28T20:54:56.896Z" }, + { url = "https://files.pythonhosted.org/packages/69/82/251d5f1aa4dcad30aed491b4657cecd9fb4274214da6960ffec144c260f7/ruff-0.14.7-py3-none-win32.whl", hash = "sha256:e33052c9199b347c8937937163b9b149ef6ab2e4bb37b042e593da2e6f6cccfa", size = 13126751, upload-time = "2025-11-28T20:55:03.47Z" }, + { url = "https://files.pythonhosted.org/packages/a8/b5/d0b7d145963136b564806f6584647af45ab98946660d399ec4da79cae036/ruff-0.14.7-py3-none-win_amd64.whl", hash = "sha256:e17a20ad0d3fad47a326d773a042b924d3ac31c6ca6deb6c72e9e6b5f661a7c6", size = 14531726, upload-time = "2025-11-28T20:54:59.121Z" }, + { url = "https://files.pythonhosted.org/packages/1d/d2/1637f4360ada6a368d3265bf39f2cf737a0aaab15ab520fc005903e883f8/ruff-0.14.7-py3-none-win_arm64.whl", hash = "sha256:be4d653d3bea1b19742fcc6502354e32f65cd61ff2fbdb365803ef2c2aec6228", size = 13609215, upload-time = "2025-11-28T20:55:15.375Z" }, +] + +[[package]] +name = "secretstorage" +version = "3.5.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "cryptography" }, + { name = "jeepney" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/1c/03/e834bcd866f2f8a49a85eaff47340affa3bfa391ee9912a952a1faa68c7b/secretstorage-3.5.0.tar.gz", hash = "sha256:f04b8e4689cbce351744d5537bf6b1329c6fc68f91fa666f60a380edddcd11be", size = 19884, upload-time = "2025-11-23T19:02:53.191Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b7/46/f5af3402b579fd5e11573ce652019a67074317e18c1935cc0b4ba9b35552/secretstorage-3.5.0-py3-none-any.whl", hash = "sha256:0ce65888c0725fcb2c5bc0fdb8e5438eece02c523557ea40ce0703c266248137", size = 15554, upload-time = "2025-11-23T19:02:51.545Z" }, +] + +[[package]] +name = "securesystemslib" +version = "1.3.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/c2/dd/d1828dce0db18aa8d34f82aee4dbcf49b0f0303cad123a1c716bb1f3bf83/securesystemslib-1.3.1.tar.gz", hash = "sha256:ca915f4b88209bb5450ac05426b859d74b7cd1421cafcf73b8dd3418a0b17486", size = 934782, upload-time = "2025-09-26T13:36:56.79Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/bd/29/1c560f46b3a95d8c508e1bd8c6d0bbf53c42d412ee7d19ec2a89ceced5b9/securesystemslib-1.3.1-py3-none-any.whl", hash = "sha256:2e5414bbdde33155a91805b295cbedc4ae3f12b48dccc63e1089093537f43c81", size = 871380, upload-time = "2025-09-26T13:36:54.851Z" }, +] + +[[package]] +name = "setuptools" +version = "80.9.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/18/5d/3bf57dcd21979b887f014ea83c24ae194cfcd12b9e0fda66b957c69d1fca/setuptools-80.9.0.tar.gz", hash = "sha256:f36b47402ecde768dbfafc46e8e4207b4360c654f1f3bb84475f0a28628fb19c", size = 1319958, upload-time = "2025-05-27T00:56:51.443Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a3/dc/17031897dae0efacfea57dfd3a82fdd2a2aeb58e0ff71b77b87e44edc772/setuptools-80.9.0-py3-none-any.whl", hash = "sha256:062d34222ad13e0cc312a4c02d73f059e86a4acbfbdea8f8f76b28c99f306922", size = 1201486, upload-time = "2025-05-27T00:56:49.664Z" }, +] + +[[package]] +name = "sigstore" +version = "4.1.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "cryptography" }, + { name = "id" }, + { name = "platformdirs" }, + { name = "pyasn1" }, + { name = "pydantic" }, + { name = "pyjwt" }, + { name = "pyopenssl" }, + { name = "requests" }, + { name = "rfc3161-client" }, + { name = "rfc8785" }, + { name = "rich" }, + { name = "sigstore-models" }, + { name = "sigstore-rekor-types" }, + { name = "tuf" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/64/1e/8c115a155b67254b52780730bc86edf90d108d172377e526ce91e42ba9de/sigstore-4.1.0.tar.gz", hash = "sha256:312f7f73fe27127784245f523b86b6334978c555fe4ba7831be5602c089807c1", size = 87928, upload-time = "2025-10-11T12:48:14.541Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/d9/02/126842beb9ce3d66f86203cdf94d99805df040cf693501a36bd6d0319cdf/sigstore-4.1.0-py3-none-any.whl", hash = "sha256:ec3ed0d92bf53ffb23261245a78d4ad3da5af5cc9af889c86461a7d02407249a", size = 109014, upload-time = "2025-10-11T12:48:12.827Z" }, +] + +[[package]] +name = "sigstore-models" +version = "0.0.5" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "pydantic" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/ac/13/f67a87e8d8c97b9a47d4971263ca6afbd5250315a55b8056358061fc07da/sigstore_models-0.0.5.tar.gz", hash = "sha256:8eda90fe16ef3e4e624edd029f4cbbc9832a192dc5c8f66011d94ec4253f9f3f", size = 7037, upload-time = "2025-07-23T17:22:30.173Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/61/f6/619d9b21df2688d54e61bdb181fa2be32697def742ec7dbbd34c462778ed/sigstore_models-0.0.5-py3-none-any.whl", hash = "sha256:ac3ca1554d5dd509a6710699d83a035a09ba112d1fa180959cbfcdd5d97633b7", size = 13253, upload-time = "2025-07-23T17:22:29.259Z" }, +] + +[[package]] +name = "sigstore-rekor-types" +version = "0.0.18" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "pydantic", extra = ["email"] }, +] +sdist = { url = "https://files.pythonhosted.org/packages/b4/54/102e772445c5e849b826fbdcd44eb9ad7b3d10fda17b08964658ec7027dc/sigstore_rekor_types-0.0.18.tar.gz", hash = "sha256:19aef25433218ebf9975a1e8b523cc84aaf3cd395ad39a30523b083ea7917ec5", size = 15687, upload-time = "2024-11-22T13:59:54.009Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/45/7c/f0b4e19fd424df4cc964f5d454e1d814fd2dc3b386342e6040441024318f/sigstore_rekor_types-0.0.18-py3-none-any.whl", hash = "sha256:b62bf38c5b1a62bc0d7fe0ee51a0709e49311d137c7880c329882a8f4b2d1d78", size = 20610, upload-time = "2024-11-22T13:59:52.684Z" }, +] + +[[package]] +name = "snowballstemmer" +version = "3.0.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/75/a7/9810d872919697c9d01295633f5d574fb416d47e535f258272ca1f01f447/snowballstemmer-3.0.1.tar.gz", hash = "sha256:6d5eeeec8e9f84d4d56b847692bacf79bc2c8e90c7f80ca4444ff8b6f2e52895", size = 105575, upload-time = "2025-05-09T16:34:51.843Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/c8/78/3565d011c61f5a43488987ee32b6f3f656e7f107ac2782dd57bdd7d91d9a/snowballstemmer-3.0.1-py3-none-any.whl", hash = "sha256:6cd7b3897da8d6c9ffb968a6781fa6532dce9c3618a4b127d920dab764a19064", size = 103274, upload-time = "2025-05-09T16:34:50.371Z" }, +] + +[[package]] +name = "sphinx" +source = { editable = "." } +dependencies = [ + { name = "alabaster" }, + { name = "babel" }, + { name = "colorama", marker = "sys_platform == 'win32'" }, + { name = "docutils" }, + { name = "imagesize" }, + { name = "jinja2" }, + { name = "packaging" }, + { name = "pygments" }, + { name = "requests" }, + { name = "roman-numerals" }, + { name = "snowballstemmer" }, + { name = "sphinxcontrib-applehelp" }, + { name = "sphinxcontrib-devhelp" }, + { name = "sphinxcontrib-htmlhelp" }, + { name = "sphinxcontrib-jsmath" }, + { name = "sphinxcontrib-qthelp" }, + { name = "sphinxcontrib-serializinghtml" }, +] + +[package.dev-dependencies] +docs = [ + { name = "sphinxcontrib-websupport" }, +] +lint = [ + { name = "ruff" }, + { name = "sphinx-lint" }, +] +package = [ + { name = "build" }, + { name = "pypi-attestations" }, + { name = "twine" }, +] +test = [ + { name = "cython" }, + { name = "defusedxml" }, + { name = "pytest" }, + { name = "pytest-xdist", extra = ["psutil"] }, + { name = "setuptools" }, + { name = "typing-extensions" }, +] +translations = [ + { name = "babel" }, + { name = "jinja2" }, +] +type-stubs = [ + { name = "types-colorama" }, + { name = "types-defusedxml" }, + { name = "types-docutils" }, + { name = "types-pillow" }, + { name = "types-pygments" }, + { name = "types-requests" }, + { name = "types-urllib3" }, +] +types = [ + { name = "mypy" }, + { name = "pyrefly" }, + { name = "pyright" }, + { name = "ty" }, + { name = "types-colorama" }, + { name = "types-defusedxml" }, + { name = "types-docutils" }, + { name = "types-pillow" }, + { name = "types-pygments" }, + { name = "types-requests" }, + { name = "types-urllib3" }, +] + +[package.metadata] +requires-dist = [ + { name = "alabaster", specifier = ">=0.7.14" }, + { name = "babel", specifier = ">=2.13" }, + { name = "colorama", marker = "sys_platform == 'win32'", specifier = ">=0.4.6" }, + { name = "docutils", specifier = ">=0.21,<0.23" }, + { name = "imagesize", specifier = ">=1.3" }, + { name = "jinja2", specifier = ">=3.1" }, + { name = "packaging", specifier = ">=23.0" }, + { name = "pygments", specifier = ">=2.17" }, + { name = "requests", specifier = ">=2.30.0" }, + { name = "roman-numerals", specifier = ">=1.0.0" }, + { name = "snowballstemmer", specifier = ">=2.2" }, + { name = "sphinxcontrib-applehelp", specifier = ">=1.0.7" }, + { name = "sphinxcontrib-devhelp", specifier = ">=1.0.6" }, + { name = "sphinxcontrib-htmlhelp", specifier = ">=2.0.6" }, + { name = "sphinxcontrib-jsmath", specifier = ">=1.0.1" }, + { name = "sphinxcontrib-qthelp", specifier = ">=1.0.6" }, + { name = "sphinxcontrib-serializinghtml", specifier = ">=1.1.9" }, +] + +[package.metadata.requires-dev] +docs = [{ name = "sphinxcontrib-websupport" }] +lint = [ + { name = "ruff", specifier = "==0.14.7" }, + { name = "sphinx-lint", specifier = ">=0.9" }, +] +package = [ + { name = "build" }, + { name = "pypi-attestations", specifier = "==0.0.28" }, + { name = "twine", specifier = ">=6.1" }, +] +test = [ + { name = "cython", specifier = ">=3.0" }, + { name = "defusedxml", specifier = ">=0.7.1" }, + { name = "pytest", specifier = ">=9.0" }, + { name = "pytest-xdist", extras = ["psutil"], specifier = ">=3.4" }, + { name = "setuptools", specifier = ">=70.0" }, + { name = "typing-extensions", specifier = ">=4.9" }, +] +translations = [ + { name = "babel", specifier = ">=2.13" }, + { name = "jinja2", specifier = ">=3.1" }, +] +type-stubs = [ + { name = "types-colorama", specifier = "==0.4.15.20250801" }, + { name = "types-defusedxml", specifier = "==0.7.0.20250822" }, + { name = "types-docutils", specifier = "==0.22.3.20251115" }, + { name = "types-pillow", specifier = "==10.2.0.20240822" }, + { name = "types-pygments", specifier = "==2.19.0.20251121" }, + { name = "types-requests", specifier = "==2.32.4.20250913" }, + { name = "types-urllib3", specifier = "==1.26.25.14" }, +] +types = [ + { name = "mypy", specifier = "==1.19.0" }, + { name = "pyrefly" }, + { name = "pyright", specifier = "==1.1.407" }, + { name = "ty" }, + { name = "types-colorama", specifier = "==0.4.15.20250801" }, + { name = "types-defusedxml", specifier = "==0.7.0.20250822" }, + { name = "types-docutils", specifier = "==0.22.3.20251115" }, + { name = "types-pillow", specifier = "==10.2.0.20240822" }, + { name = "types-pygments", specifier = "==2.19.0.20251121" }, + { name = "types-requests", specifier = "==2.32.4.20250913" }, + { name = "types-urllib3", specifier = "==1.26.25.14" }, +] + +[[package]] +name = "sphinx-lint" +version = "1.0.2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "polib" }, + { name = "regex" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/8a/19/9258497fee6e2a0bdb93e8ecea6ef6864afb5d83e996a1606a853f96c658/sphinx_lint-1.0.2.tar.gz", hash = "sha256:4e7fc12f44f750b0006eaad237d7db9b1d8aba92adda9c838af891654b371d35", size = 36870, upload-time = "2025-11-19T08:28:12.269Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/c0/62/f29a2988ff706ac01d3c63d0b4cc4ed62d2c83b447916e0317790ca156cf/sphinx_lint-1.0.2-py3-none-any.whl", hash = "sha256:edcd0fa4d916386c5a3ef7ef0f5136f0bb4a15feefc83c1068ba15bc16eec652", size = 20670, upload-time = "2025-11-19T08:28:10.656Z" }, +] + +[[package]] +name = "sphinxcontrib-applehelp" +version = "2.0.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ba/6e/b837e84a1a704953c62ef8776d45c3e8d759876b4a84fe14eba2859106fe/sphinxcontrib_applehelp-2.0.0.tar.gz", hash = "sha256:2f29ef331735ce958efa4734873f084941970894c6090408b079c61b2e1c06d1", size = 20053, upload-time = "2024-07-29T01:09:00.465Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/5d/85/9ebeae2f76e9e77b952f4b274c27238156eae7979c5421fba91a28f4970d/sphinxcontrib_applehelp-2.0.0-py3-none-any.whl", hash = "sha256:4cd3f0ec4ac5dd9c17ec65e9ab272c9b867ea77425228e68ecf08d6b28ddbdb5", size = 119300, upload-time = "2024-07-29T01:08:58.99Z" }, +] + +[[package]] +name = "sphinxcontrib-devhelp" +version = "2.0.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/f6/d2/5beee64d3e4e747f316bae86b55943f51e82bb86ecd325883ef65741e7da/sphinxcontrib_devhelp-2.0.0.tar.gz", hash = "sha256:411f5d96d445d1d73bb5d52133377b4248ec79db5c793ce7dbe59e074b4dd1ad", size = 12967, upload-time = "2024-07-29T01:09:23.417Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/35/7a/987e583882f985fe4d7323774889ec58049171828b58c2217e7f79cdf44e/sphinxcontrib_devhelp-2.0.0-py3-none-any.whl", hash = "sha256:aefb8b83854e4b0998877524d1029fd3e6879210422ee3780459e28a1f03a8a2", size = 82530, upload-time = "2024-07-29T01:09:21.945Z" }, +] + +[[package]] +name = "sphinxcontrib-htmlhelp" +version = "2.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/43/93/983afd9aa001e5201eab16b5a444ed5b9b0a7a010541e0ddfbbfd0b2470c/sphinxcontrib_htmlhelp-2.1.0.tar.gz", hash = "sha256:c9e2916ace8aad64cc13a0d233ee22317f2b9025b9cf3295249fa985cc7082e9", size = 22617, upload-time = "2024-07-29T01:09:37.889Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0a/7b/18a8c0bcec9182c05a0b3ec2a776bba4ead82750a55ff798e8d406dae604/sphinxcontrib_htmlhelp-2.1.0-py3-none-any.whl", hash = "sha256:166759820b47002d22914d64a075ce08f4c46818e17cfc9470a9786b759b19f8", size = 98705, upload-time = "2024-07-29T01:09:36.407Z" }, +] + +[[package]] +name = "sphinxcontrib-jsmath" +version = "1.0.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/b2/e8/9ed3830aeed71f17c026a07a5097edcf44b692850ef215b161b8ad875729/sphinxcontrib-jsmath-1.0.1.tar.gz", hash = "sha256:a9925e4a4587247ed2191a22df5f6970656cb8ca2bd6284309578f2153e0c4b8", size = 5787, upload-time = "2019-01-21T16:10:16.347Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/c2/42/4c8646762ee83602e3fb3fbe774c2fac12f317deb0b5dbeeedd2d3ba4b77/sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl", hash = "sha256:2ec2eaebfb78f3f2078e73666b1415417a116cc848b72e5172e596c871103178", size = 5071, upload-time = "2019-01-21T16:10:14.333Z" }, +] + +[[package]] +name = "sphinxcontrib-qthelp" +version = "2.0.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/68/bc/9104308fc285eb3e0b31b67688235db556cd5b0ef31d96f30e45f2e51cae/sphinxcontrib_qthelp-2.0.0.tar.gz", hash = "sha256:4fe7d0ac8fc171045be623aba3e2a8f613f8682731f9153bb2e40ece16b9bbab", size = 17165, upload-time = "2024-07-29T01:09:56.435Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/27/83/859ecdd180cacc13b1f7e857abf8582a64552ea7a061057a6c716e790fce/sphinxcontrib_qthelp-2.0.0-py3-none-any.whl", hash = "sha256:b18a828cdba941ccd6ee8445dbe72ffa3ef8cbe7505d8cd1fa0d42d3f2d5f3eb", size = 88743, upload-time = "2024-07-29T01:09:54.885Z" }, +] + +[[package]] +name = "sphinxcontrib-serializinghtml" +version = "2.0.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/3b/44/6716b257b0aa6bfd51a1b31665d1c205fb12cb5ad56de752dfa15657de2f/sphinxcontrib_serializinghtml-2.0.0.tar.gz", hash = "sha256:e9d912827f872c029017a53f0ef2180b327c3f7fd23c87229f7a8e8b70031d4d", size = 16080, upload-time = "2024-07-29T01:10:09.332Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/52/a7/d2782e4e3f77c8450f727ba74a8f12756d5ba823d81b941f1b04da9d033a/sphinxcontrib_serializinghtml-2.0.0-py3-none-any.whl", hash = "sha256:6e2cb0eef194e10c27ec0023bfeb25badbbb5868244cf5bc5bdc04e4464bf331", size = 92072, upload-time = "2024-07-29T01:10:08.203Z" }, +] + +[[package]] +name = "sphinxcontrib-websupport" +version = "2.0.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "jinja2" }, + { name = "sphinx" }, + { name = "sphinxcontrib-serializinghtml" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/87/ed/11167ae7c3eb80e7c67823bceea24207bb7b886aefde6c367b4a571c05de/sphinxcontrib_websupport-2.0.0.tar.gz", hash = "sha256:0b7367d3bac6454b1f97e42aa8c4d4d4a1b756d525fc726ebbe5571e033e79cd", size = 600125, upload-time = "2024-07-29T01:10:23.095Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/1a/c9/b9ce2eaacaf75d94a5ee5b809bb2be351f1c9cda5c14316cc53b1aea0650/sphinxcontrib_websupport-2.0.0-py3-none-any.whl", hash = "sha256:365b4da67e03cc163dc4752ed44b3c4bc334172c8198102135a7eb7945111229", size = 37069, upload-time = "2024-07-29T01:10:21.538Z" }, +] + +[[package]] +name = "tuf" +version = "6.0.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "securesystemslib" }, + { name = "urllib3" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/25/b5/377a566dfa8286b2ca27ddbc792ab1645de0b6c65dd5bf03027b3bf8cc8f/tuf-6.0.0.tar.gz", hash = "sha256:9eed0f7888c5fff45dc62164ff243a05d47fb8a3208035eb268974287e0aee8d", size = 271268, upload-time = "2025-03-11T10:48:45.489Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/6b/3d/161ab4fec446048707cb13e8ba22220e05a6c4a6587d3631feeb5715037e/tuf-6.0.0-py3-none-any.whl", hash = "sha256:458f663a233d95cc76dde0e1a3d01796516a05ce2781fefafebe037f7729601a", size = 54774, upload-time = "2025-03-11T10:48:44.188Z" }, +] + +[[package]] +name = "twine" +version = "6.2.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "id" }, + { name = "keyring", marker = "platform_machine != 'ppc64le' and platform_machine != 's390x'" }, + { name = "packaging" }, + { name = "readme-renderer" }, + { name = "requests" }, + { name = "requests-toolbelt" }, + { name = "rfc3986" }, + { name = "rich" }, + { name = "urllib3" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/e0/a8/949edebe3a82774c1ec34f637f5dd82d1cf22c25e963b7d63771083bbee5/twine-6.2.0.tar.gz", hash = "sha256:e5ed0d2fd70c9959770dce51c8f39c8945c574e18173a7b81802dab51b4b75cf", size = 172262, upload-time = "2025-09-04T15:43:17.255Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/3a/7a/882d99539b19b1490cac5d77c67338d126e4122c8276bf640e411650c830/twine-6.2.0-py3-none-any.whl", hash = "sha256:418ebf08ccda9a8caaebe414433b0ba5e25eb5e4a927667122fbe8f829f985d8", size = 42727, upload-time = "2025-09-04T15:43:15.994Z" }, +] + +[[package]] +name = "ty" +version = "0.0.1a30" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/6f/9c/6f2266347cd0f44c942590e1181cd64ce98e1aa6d49c0060547e6c4e0c25/ty-0.0.1a30.tar.gz", hash = "sha256:24467375575a3d6ac7fa4b2daaf29f1865e8846144b13ceaef99fd3d969efcff", size = 4645472, upload-time = "2025-12-03T13:45:22.601Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/7e/f3/bd6d52ca2a367ed1b276e092c55237e8b093bd1c0130fbbe5e978d8fa851/ty-0.0.1a30-py3-none-linux_armv6l.whl", hash = "sha256:08af64e524b329b9a930d8235762e757cf34f75daac4916b9dd5e1d43c9983cf", size = 9611831, upload-time = "2025-12-03T13:45:28.625Z" }, + { url = "https://files.pythonhosted.org/packages/3f/47/b89e574643d0abc1a8da3455541bde09c0d8b4fed256fefad7962e30ca65/ty-0.0.1a30-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:0f0151047b6e908a605f98adc39cb93a4f758ebd49c85f03cd6ea0096adc00b0", size = 9391955, upload-time = "2025-12-03T13:45:44.709Z" }, + { url = "https://files.pythonhosted.org/packages/a0/c1/4d70b38ef9456ab4ab90f700baec5f705d3a3137a82f7c3866c5f08169c4/ty-0.0.1a30-py3-none-macosx_11_0_arm64.whl", hash = "sha256:fe8ab3d0965a960ba6e9af97921b7ca0aae03bb7cb424b4930f1bdef2080625b", size = 8923688, upload-time = "2025-12-03T13:45:16.638Z" }, + { url = "https://files.pythonhosted.org/packages/56/2a/f457828219abf4e076f82bd82a81b1455a50ce2bf5da9a2dd55ccaeb9721/ty-0.0.1a30-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0ddf87453f7cd7c2f40f36bbc561719e3457d9ba3a7a1599f64e8d4a0d7302e3", size = 9194556, upload-time = "2025-12-03T13:45:13.845Z" }, + { url = "https://files.pythonhosted.org/packages/7e/37/357e805b55bb7f3131edba92ab208151d5936d3d47556404ab6a431a5be7/ty-0.0.1a30-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5dff89b79bf73f9ff8b74d0e9ea374693e94124f0b4cf8672c46ae6e7ad25342", size = 9404048, upload-time = "2025-12-03T13:45:24.562Z" }, + { url = "https://files.pythonhosted.org/packages/93/a5/9c2847751621c27c2573c267940b29927d064a3131d60e074e7179ab838c/ty-0.0.1a30-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6dc3e5ddfb8fb9501848dc1e6c15ba8ee9d8671cfb801b8c00638d547011cce0", size = 9781465, upload-time = "2025-12-03T13:45:20.877Z" }, + { url = "https://files.pythonhosted.org/packages/2b/83/a0094aca241bc362dfa1fd690b7d77d185b5057e06722f4d503451812b4b/ty-0.0.1a30-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:702d0310bcc6e4b2e535db082a5d8791ba1808a8de6c2c3eeae0e210ab3b509a", size = 10428334, upload-time = "2025-12-03T13:45:18.906Z" }, + { url = "https://files.pythonhosted.org/packages/57/0d/22d9e50baa81beac0bc911c46fce0334a201e7a9a9d1b09cdeab57645e7b/ty-0.0.1a30-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:2aa86bb3a49b705d561e15f3c5ad0aa3371054ac231a7e8505e0ad1282b37170", size = 10160761, upload-time = "2025-12-03T13:45:42.445Z" }, + { url = "https://files.pythonhosted.org/packages/7c/1c/9f0a6f9c8ab8545fe920926dd3407700556da089e823802ace957e0866d4/ty-0.0.1a30-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f1a03f367565c8bb2c47f7c27effe4491df4908deb3e218bc8824ef2797cc8f0", size = 10186345, upload-time = "2025-12-03T13:45:40.352Z" }, + { url = "https://files.pythonhosted.org/packages/d9/02/6944528886eb0466b5553c8dc8e5d0ebc156e0f5406848eacbbe91eda06a/ty-0.0.1a30-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e172601687eeb2c4166da4491e51adb0dc797ca595359e266ef1d9da405ac5e5", size = 9705028, upload-time = "2025-12-03T13:45:26.402Z" }, + { url = "https://files.pythonhosted.org/packages/fa/fb/4660ca5ca5cbafc963923460f694bde81744a06e39a01f3b97c2488006ff/ty-0.0.1a30-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:ce13f91928bac48cd3ddb94107c27a653e18aec3da94ce6229bb92e1bfd25421", size = 9172022, upload-time = "2025-12-03T13:45:38.315Z" }, + { url = "https://files.pythonhosted.org/packages/94/42/e68ae7c6e64addc0951f4909543f143ce7294687800f6a8b3b1dd3d42c42/ty-0.0.1a30-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:85eb5233a859b509aec07ee0c09dd46039b5165b7c736ceba9baa5ccea213a19", size = 9442685, upload-time = "2025-12-03T13:45:30.527Z" }, + { url = "https://files.pythonhosted.org/packages/c3/8e/d4d979518879518c948510d03c2f5e96535f4139bb275b023f8b5b757384/ty-0.0.1a30-py3-none-musllinux_1_2_i686.whl", hash = "sha256:b69e02f02a0a0c5816943e8c0d43b0b10857e57f15ec25358fad3f5746f64e86", size = 9531562, upload-time = "2025-12-03T13:45:32.696Z" }, + { url = "https://files.pythonhosted.org/packages/9b/ee/18e0977dab64bdf633773e8b2b311ca21c0f68443fb7b8257f2905ad2468/ty-0.0.1a30-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:fcb8a4c27965e8665ba79538e0349827208bace5c05672e247bff9cfafd6b26f", size = 9829842, upload-time = "2025-12-03T13:45:09.276Z" }, + { url = "https://files.pythonhosted.org/packages/a7/ce/69eb03ac5fa29932e540b295f405157341cc0036165f1cc1600bbcf0c2a4/ty-0.0.1a30-py3-none-win32.whl", hash = "sha256:ff262281a3c5221d024f3bd5c907bf22f44b0a77eb67504db2e941a6e4068ef2", size = 9008044, upload-time = "2025-12-03T13:45:34.511Z" }, + { url = "https://files.pythonhosted.org/packages/c5/ca/343936f91d2e6cf78cb8bcf6892a8e9ed65663d7c029a7f8e22c63bd6d4d/ty-0.0.1a30-py3-none-win_amd64.whl", hash = "sha256:54fa97ff320ef4e576262fb27d8df643cb09bb10356890e4a1851fdba49cc9ec", size = 9862769, upload-time = "2025-12-03T13:45:11.838Z" }, + { url = "https://files.pythonhosted.org/packages/3e/1a/bac874fe11b153df0fc01a63eb3a27fc25a0d2d71cbd4e58fbe793db304d/ty-0.0.1a30-py3-none-win_arm64.whl", hash = "sha256:cd14d2625b26795de5bdaefc814d3e5a36a2f5084dfc5cabafb8b02ffd554158", size = 9351089, upload-time = "2025-12-03T13:45:36.335Z" }, +] + +[[package]] +name = "types-colorama" +version = "0.4.15.20250801" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/99/37/af713e7d73ca44738c68814cbacf7a655aa40ddd2e8513d431ba78ace7b3/types_colorama-0.4.15.20250801.tar.gz", hash = "sha256:02565d13d68963d12237d3f330f5ecd622a3179f7b5b14ee7f16146270c357f5", size = 10437, upload-time = "2025-08-01T03:48:22.605Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/95/3a/44ccbbfef6235aeea84c74041dc6dfee6c17ff3ddba782a0250e41687ec7/types_colorama-0.4.15.20250801-py3-none-any.whl", hash = "sha256:b6e89bd3b250fdad13a8b6a465c933f4a5afe485ea2e2f104d739be50b13eea9", size = 10743, upload-time = "2025-08-01T03:48:21.774Z" }, +] + +[[package]] +name = "types-defusedxml" +version = "0.7.0.20250822" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/7d/4a/5b997ae87bf301d1796f72637baa4e0e10d7db17704a8a71878a9f77f0c0/types_defusedxml-0.7.0.20250822.tar.gz", hash = "sha256:ba6c395105f800c973bba8a25e41b215483e55ec79c8ca82b6fe90ba0bc3f8b2", size = 10590, upload-time = "2025-08-22T03:02:59.547Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/13/73/8a36998cee9d7c9702ed64a31f0866c7f192ecffc22771d44dbcc7878f18/types_defusedxml-0.7.0.20250822-py3-none-any.whl", hash = "sha256:5ee219f8a9a79c184773599ad216123aedc62a969533ec36737ec98601f20dcf", size = 13430, upload-time = "2025-08-22T03:02:58.466Z" }, +] + +[[package]] +name = "types-docutils" +version = "0.22.3.20251115" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/eb/d7/576ec24bf61a280f571e1f22284793adc321610b9bcfba1bf468cf7b334f/types_docutils-0.22.3.20251115.tar.gz", hash = "sha256:0f79ea6a7bd4d12d56c9f824a0090ffae0ea4204203eb0006392906850913e16", size = 56828, upload-time = "2025-11-15T02:59:57.371Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/9c/01/61ac9eb38f1f978b47443dc6fd2e0a3b0f647c2da741ddad30771f1b2b6f/types_docutils-0.22.3.20251115-py3-none-any.whl", hash = "sha256:c6e53715b65395d00a75a3a8a74e352c669bc63959e65a207dffaa22f4a2ad6e", size = 91951, upload-time = "2025-11-15T02:59:56.413Z" }, +] + +[[package]] +name = "types-pillow" +version = "10.2.0.20240822" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/18/4a/4495264dddaa600d65d68bcedb64dcccf9d9da61adff51f7d2ffd8e4c9ce/types-Pillow-10.2.0.20240822.tar.gz", hash = "sha256:559fb52a2ef991c326e4a0d20accb3bb63a7ba8d40eb493e0ecb0310ba52f0d3", size = 35389, upload-time = "2024-08-22T02:32:48.15Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/66/23/e81a5354859831fcf54d488d33b80ba6133ea84f874a9c0ec40a4881e133/types_Pillow-10.2.0.20240822-py3-none-any.whl", hash = "sha256:d9dab025aba07aeb12fd50a6799d4eac52a9603488eca09d7662543983f16c5d", size = 54354, upload-time = "2024-08-22T02:32:46.664Z" }, +] + +[[package]] +name = "types-pygments" +version = "2.19.0.20251121" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "types-docutils" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/90/3b/cd650700ce9e26b56bd1a6aa4af397bbbc1784e22a03971cb633cdb0b601/types_pygments-2.19.0.20251121.tar.gz", hash = "sha256:eef114fde2ef6265365522045eac0f8354978a566852f69e75c531f0553822b1", size = 18590, upload-time = "2025-11-21T03:03:46.623Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/99/8a/9244b21f1d60dcc62e261435d76b02f1853b4771663d7ec7d287e47a9ba9/types_pygments-2.19.0.20251121-py3-none-any.whl", hash = "sha256:cb3bfde34eb75b984c98fb733ce4f795213bd3378f855c32e75b49318371bb25", size = 25674, upload-time = "2025-11-21T03:03:45.72Z" }, +] + +[[package]] +name = "types-requests" +version = "2.32.4.20250913" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "urllib3" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/36/27/489922f4505975b11de2b5ad07b4fe1dca0bca9be81a703f26c5f3acfce5/types_requests-2.32.4.20250913.tar.gz", hash = "sha256:abd6d4f9ce3a9383f269775a9835a4c24e5cd6b9f647d64f88aa4613c33def5d", size = 23113, upload-time = "2025-09-13T02:40:02.309Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/2a/20/9a227ea57c1285986c4cf78400d0a91615d25b24e257fd9e2969606bdfae/types_requests-2.32.4.20250913-py3-none-any.whl", hash = "sha256:78c9c1fffebbe0fa487a418e0fa5252017e9c60d1a2da394077f1780f655d7e1", size = 20658, upload-time = "2025-09-13T02:40:01.115Z" }, +] + +[[package]] +name = "types-urllib3" +version = "1.26.25.14" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/73/de/b9d7a68ad39092368fb21dd6194b362b98a1daeea5dcfef5e1adb5031c7e/types-urllib3-1.26.25.14.tar.gz", hash = "sha256:229b7f577c951b8c1b92c1bc2b2fdb0b49847bd2af6d1cc2a2e3dd340f3bda8f", size = 11239, upload-time = "2023-07-20T15:19:31.307Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/11/7b/3fc711b2efea5e85a7a0bbfe269ea944aa767bbba5ec52f9ee45d362ccf3/types_urllib3-1.26.25.14-py3-none-any.whl", hash = "sha256:9683bbb7fb72e32bfe9d2be6e04875fbe1b3eeec3cbb4ea231435aa7fd6b4f0e", size = 15377, upload-time = "2023-07-20T15:19:30.379Z" }, +] + +[[package]] +name = "typing-extensions" +version = "4.15.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" }, +] + +[[package]] +name = "typing-inspection" +version = "0.4.2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" }, +] + +[[package]] +name = "urllib3" +version = "2.5.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/15/22/9ee70a2574a4f4599c47dd506532914ce044817c7752a79b6a51286319bc/urllib3-2.5.0.tar.gz", hash = "sha256:3fc47733c7e419d4bc3f6b3dc2b4f890bb743906a30d56ba4a5bfa4bbff92760", size = 393185, upload-time = "2025-06-18T14:07:41.644Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/c2/fe1e52489ae3122415c51f387e221dd0773709bad6c6cdaa599e8a2c5185/urllib3-2.5.0-py3-none-any.whl", hash = "sha256:e6b01673c0fa6a13e374b50871808eb3bf7046c4b125b216f6bf1cc604cff0dc", size = 129795, upload-time = "2025-06-18T14:07:40.39Z" }, +]